Skip to content

Commit

Permalink
Merge branch 'main' into brian-learn-move
Browse files Browse the repository at this point in the history
  • Loading branch information
bsmth authored Dec 11, 2024
2 parents ed24d11 + a3fa3aa commit 16e9cf3
Show file tree
Hide file tree
Showing 17 changed files with 89 additions and 172 deletions.
2 changes: 1 addition & 1 deletion files/en-us/mdn/writing_guidelines/howto/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,4 +11,4 @@ This section of MDN Web Docs writing guidelines contains all the step-by-step in
> [!NOTE]
> All the way through this section, we assume that you've read the contribution guidelines, are familiar with the `mdn/content` repository, and know how to use git and GitHub.
{{LandingPageListSubpages}}
{{SubpagesWithSummaries}}
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ page-type: landing-page
Throughout MDN there are document structures that are used to provide consistent presentation of information in MDN articles.
This page lists articles describing these structures so that you can modify page content appropriately for the documents you write, edit, or translate.

{{LandingPageListSubPages}}
{{SubpagesWithSummaries}}

## See also

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ MDN provides numerous macros to create always up-to-date links to MDN content. I

MDN provides macros that create a list of links:

- [`\{{LandingPageListSubPages}}`](https://github.com/mdn/yari/blob/main/kumascript/macros/LandingPageListSubpages.ejs)
- [`\{{SubpagesWithSummaries}}`](https://github.com/mdn/yari/blob/main/kumascript/macros/SubpagesWithSummaries.ejs)

- : Inserts a definition list ({{HTMLElement("dl")}}) of the subpages of the current page, with each page's title as the {{HTMLElement("dt")}} term and its first paragraph as the {{HTMLElement("dd")}} term.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -21,9 +21,8 @@ We have an assortment of macros that can be used to automatically generate the c
#### Lists of subpages

- [`ListSubpages`](https://github.com/mdn/yari/blob/main/kumascript/macros/ListSubpages.ejs) generates an unordered list of links to all the immediate children of the current page; useful for automatically generating tables of contents for sets of documentation.
- [`LandingPageListSubpages`](https://github.com/mdn/yari/blob/main/kumascript/macros/LandingPageListSubpages.ejs) outputs a two-column definition list of all immediate subpages of the current page, with their titles as the {{HTMLElement("dt")}} and their SEO summary as the {{HTMLElement("dd")}}. This makes it easy to automatically generate reasonably attractive landing pages.
- [`SubpagesWithSummaries`](https://github.com/mdn/yari/blob/main/kumascript/macros/SubpagesWithSummaries.ejs) constructs a definition list of all the immediate children of the current page, with their titles as the {{HTMLElement("dt")}} and their SEO summary as the {{HTMLElement("dd")}}. This makes it easy to automatically generate reasonably attractive landing pages.
- [`APIListAlpha`](https://github.com/mdn/yari/blob/main/kumascript/macros/APIListAlpha.ejs) builds a list of the current page's subpages, formatted as a list of API terms, divided up by first letter. There are three parameters. The first is 0 if you want to include all top-level subpages or 1 to leave out subpages with "." in their names. The second and third let you add text to display as part of the name in each link. This can be used to add "<" and ">" for element links, or to add "()" at the end of lists of method names.
- [`SubpagesWithSummaries`](https://github.com/mdn/yari/blob/main/kumascript/macros/SubpagesWithSummaries.ejs) constructs a definition list of all the immediate children of the current page. There is no other formatting done. You can get a two-column list ready for use as a multi-column landing page using [`LandingPageListSubpages`](https://github.com/mdn/yari/blob/main/kumascript/macros/LandingPageListSubpages.ejs).

### Lists of links

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -233,7 +233,7 @@ A **landing page** serves as a menu, of sorts, for its subpages, and is therefor
A landing page layout is typically used for the root page of a tree of pages about a particular topic.
It opens with a brief summary of the topic, then presents a structured list of links to its subpages, and optionally, additional material that be useful to the reader.

The list of subpages can be generated automatically using the templates [`SubpagesWithSummaries`](https://github.com/mdn/yari/blob/main/kumascript/macros/SubpagesWithSummaries.ejs), and [`LandingPageListSubpages`](https://github.com/mdn/yari/blob/main/kumascript/macros/LandingPageListSubpages.ejs). However, in more complex cases, the list may need to be created (and maintained!) by hand.
The list of subpages can be generated automatically using the [`SubpagesWithSummaries`](https://github.com/mdn/yari/blob/main/kumascript/macros/SubpagesWithSummaries.ejs) template. However, in more complex cases, the list may need to be created (and maintained) by hand.

### Examples

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/mozilla/add-ons/webextensions/api/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,4 +57,4 @@ For example, here is the first code example on this page running in the Toolbox

See below for a complete list of JavaScript APIs:

{{LandingPageListSubpages}}
{{SubpagesWithSummaries}}
83 changes: 1 addition & 82 deletions files/en-us/mozilla/firefox/experimental_features/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -218,7 +218,6 @@ This feature renders control characters (Unicode category Cc) other than _tab_ (
<tr>
<th>Preference name</th>
<td colspan="2">
<code>layout.css.control-characters.enabled</code> or
<code>layout.css.control-characters.visible</code>
</td>
</tr>
Expand Down Expand Up @@ -945,47 +944,7 @@ The {{CSSXRef(":has-slotted")}} [pseudo-class](/en-US/docs/Web/CSS/Pseudo-classe

## SVG

### SVGPathSeg APIs

The SVGPathSeg APIs are being unshipped, and have been placed behind a preference.
This includes: `SVGPathSegList`, [SVGPathElement.getPathSegAtLength()](/en-US/docs/Web/API/SVGPathElement), `SVGAnimatedPathData`.
(See [Firefox bug 1388931](https://bugzil.la/1388931) for more details.)

<table>
<thead>
<tr>
<th>Release channel</th>
<th>Version removed</th>
<th>Enabled by default?</th>
</tr>
</thead>
<tbody>
<tr>
<th>Nightly</th>
<td>97</td>
<td>No</td>
</tr>
<tr>
<th>Developer Edition</th>
<td>97</td>
<td>No</td>
</tr>
<tr>
<th>Beta</th>
<td>97</td>
<td>No</td>
</tr>
<tr>
<th>Release</th>
<td>97</td>
<td>No</td>
</tr>
<tr>
<th>Preference name</th>
<td colspan="2"><code>dom.svg.pathSeg.enabled</code></td>
</tr>
</tbody>
</table>
None.

## JavaScript

Expand Down Expand Up @@ -1210,46 +1169,6 @@ This subset of the API has been implemented:

### Graphics: Canvas, WebGL, and WebGPU

#### Hit regions

Whether the mouse coordinates are within a particular area on the canvas is a common problem to solve. The hit region API allows you to define an area of your canvas and provides another possibility to expose interactive content on a canvas to accessibility tools.

<table>
<thead>
<tr>
<th>Release channel</th>
<th>Version added</th>
<th>Enabled by default?</th>
</tr>
</thead>
<tbody>
<tr>
<th>Nightly</th>
<td>30</td>
<td>No</td>
</tr>
<tr>
<th>Developer Edition</th>
<td>30</td>
<td>No</td>
</tr>
<tr>
<th>Beta</th>
<td>30</td>
<td>No</td>
</tr>
<tr>
<th>Release</th>
<td>30</td>
<td>No</td>
</tr>
<tr>
<th>Preference name</th>
<td colspan="2"><code>canvas.hitregions.enabled</code></td>
</tr>
</tbody>
</table>

#### WebGL: Draft extensions

When this preference is enabled, any WebGL extensions currently in "draft" status which are being tested are enabled for use. Currently, there are no WebGL extensions being tested by Firefox.
Expand Down
2 changes: 1 addition & 1 deletion files/en-us/mozilla/firefox/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ Firefox ESR is the long-term support edition of Firefox for desktop for use by o

## Contents

{{LandingPageListSubpages}}
{{SubpagesWithSummaries}}

## See also

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/mozilla/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,4 +8,4 @@ page-type: landing-page

The articles below include content about downloading and building Mozilla code. In addition, you'll find helpful articles about how the code works, how to build add-ons for Mozilla applications and the like.

{{LandingPageListSubpages}}
{{SubpagesWithSummaries}}
2 changes: 1 addition & 1 deletion files/en-us/web/api/web_audio_api/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -186,7 +186,7 @@ It is possible to process/render an audio graph very quickly in the background

## Guides and tutorials

{{LandingPageListSubpages}}
{{SubpagesWithSummaries}}

## Examples

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/web/css/@document/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ browser-compat: css.at-rules.document

{{CSSRef}}{{Deprecated_header}}{{Non-standard_header}}

The **`@document`** [CSS](/en-US/docs/Web/CSS) [at-rule](/en-US/docs/Web/CSS/At-rule) restricts the style rules contained within it based on the URL of the document. It is designed primarily for user-defined style sheets, though it can be used on author-defined style sheets, too.
The **`@document`** [CSS](/en-US/docs/Web/CSS) [at-rule](/en-US/docs/Web/CSS/At-rule) restricts the style rules contained within it based on the URL of the document. It is designed primarily for user-defined style sheets (see [userchrome.org](https://www.userchrome.org/) for more information), though it can be used on author-defined style sheets, too.

```css
@document url("https://www.example.com/")
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -112,7 +112,7 @@ Note that the implication of the above is that, contrary to popular misinformati

### Assignment with destructuring

The left-hand side of can also be an assignment pattern. This allows assigning to multiple variables at once.
The left-hand side can also be an assignment pattern. This allows assigning to multiple variables at once.

```js
const result = /(a+)(b+)(c+)/.exec("aaabcc");
Expand Down
2 changes: 1 addition & 1 deletion files/en-us/web/performance/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ There are tools, APIs, and best practices that help us measure and improve web p

## Key performance guides

{{LandingPageListSubpages}}
{{SubpagesWithSummaries}}

## Beginner's tutorials

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/web/xml/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,4 +8,4 @@ page-type: landing-page

The **Extensible Markup Language** is a strict serialization of the [Document Object Model](/en-US/docs/Web/API/Document_Object_Model).

{{LandingPageListSubpages}}
{{SubpagesWithSummaries}}
Loading

0 comments on commit 16e9cf3

Please sign in to comment.