Skip to content

Commit

Permalink
Merge branch 'main' into move-a11y-in-css-page-templates
Browse files Browse the repository at this point in the history
  • Loading branch information
mcaskill committed Jul 30, 2024
2 parents beb7caf + 06927ab commit fae9cb6
Show file tree
Hide file tree
Showing 4,307 changed files with 16,909 additions and 9,565 deletions.
The diff you're trying to view is too large. We only load the first 3000 changed files.
13 changes: 13 additions & 0 deletions .markdownlint.jsonc
Original file line number Diff line number Diff line change
Expand Up @@ -212,6 +212,19 @@
"searchPattern": "/(\\[[^\\]]*?\\]\\(([^\\)\\n]|\\([^\\)\\n]\\)|\\s[\"'])+?)(\\n|\\s|[,:][\\s\\n])/gm",
"searchScope": "text",
},
{
"name": "text-code-fence",
"message": "Use 'plain' tag",
"searchPattern": "/(^ *`{3,})(text|none|unix)/gm",
"replace": "$1plain",
"searchScope": "text",
},
{
"name": "gfm-blockquote",
"message": "Use the GFM syntax: https://developer.mozilla.org/en-US/docs/MDN/Writing_guidelines/Howto/Markdown_in_MDN#notes_warnings_and_callouts",
"searchPattern": "/^ *> \\*\\*(Note|Warning|Callout):\\*\\*(?! [[{`_*])/gm",
"searchScope": "text",
},
],
},
}
21 changes: 10 additions & 11 deletions files/en-us/_redirects.txt
Original file line number Diff line number Diff line change
Expand Up @@ -2235,7 +2235,7 @@
/en-US/docs/DOM/window.setInterval /en-US/docs/Web/API/setInterval
/en-US/docs/DOM/window.setTimeout /en-US/docs/Web/API/setTimeout
/en-US/docs/DOM/window.showModalDialog /en-US/docs/Web/API/Window/showModalDialog
/en-US/docs/DOM/window.sidebar /en-US/docs/Web/API/Window/sidebar
/en-US/docs/DOM/window.sidebar /en-US/docs/Web/API/Window/external
/en-US/docs/DOM/window.sizeToContent /en-US/docs/Web/API/Window/sizeToContent
/en-US/docs/DOM/window.status /en-US/docs/Web/API/Window/status
/en-US/docs/DOM/window.statusbar /en-US/docs/Web/API/Window/statusbar
Expand Down Expand Up @@ -2657,7 +2657,7 @@
/en-US/docs/DOM:window.setInterval /en-US/docs/Web/API/setInterval
/en-US/docs/DOM:window.setTimeout /en-US/docs/Web/API/setTimeout
/en-US/docs/DOM:window.showModalDialog /en-US/docs/Web/API/Window/showModalDialog
/en-US/docs/DOM:window.sidebar /en-US/docs/Web/API/Window/sidebar
/en-US/docs/DOM:window.sidebar /en-US/docs/Web/API/Window/external
/en-US/docs/DOM:window.sizeToContent /en-US/docs/Web/API/Window/sizeToContent
/en-US/docs/DOM:window.status /en-US/docs/Web/API/Window/status
/en-US/docs/DOM:window.statusbar /en-US/docs/Web/API/Window/statusbar
Expand Down Expand Up @@ -3376,7 +3376,7 @@
/en-US/docs/Document_Object_Model_(DOM)/window.setInterval /en-US/docs/Web/API/setInterval
/en-US/docs/Document_Object_Model_(DOM)/window.setTimeout /en-US/docs/Web/API/setTimeout
/en-US/docs/Document_Object_Model_(DOM)/window.showModalDialog /en-US/docs/Web/API/Window/showModalDialog
/en-US/docs/Document_Object_Model_(DOM)/window.sidebar /en-US/docs/Web/API/Window/sidebar
/en-US/docs/Document_Object_Model_(DOM)/window.sidebar /en-US/docs/Web/API/Window/external
/en-US/docs/Document_Object_Model_(DOM)/window.sizeToContent /en-US/docs/Web/API/Window/sizeToContent
/en-US/docs/Document_Object_Model_(DOM)/window.status /en-US/docs/Web/API/Window/status
/en-US/docs/Document_Object_Model_(DOM)/window.statusbar /en-US/docs/Web/API/Window/statusbar
Expand Down Expand Up @@ -3512,6 +3512,7 @@
/en-US/docs/Games/Techniques/Publishing_games/Game_promotion /en-US/docs/Games/Publishing_games/Game_promotion
/en-US/docs/Games/Techniques/Tilemaps/SquareTiles /en-US/docs/Games/Techniques/Tilemaps
/en-US/docs/Games/Techniques/Tilemaps/SquareTiles/Square_tilemaps_implementation:_Static_maps /en-US/docs/Games/Techniques/Tilemaps/Square_tilemaps_implementation:_Static_maps
/en-US/docs/Games/Tutorials/Touch_Event_Horizon /en-US/docs/Games/Tutorials
/en-US/docs/Games/WebRTC_data_channels /en-US/docs/Games/Techniques/WebRTC_data_channels
/en-US/docs/Games/Workflows /en-US/docs/Games/Tutorials
/en-US/docs/Games/Workflows/2D_Breakout_game_pure_JavaScript /en-US/docs/Games/Tutorials/2D_Breakout_game_pure_JavaScript
Expand Down Expand Up @@ -3554,7 +3555,7 @@
/en-US/docs/Games/Workflows/Breakout_game_from_scratch/Paddle_and_keyboard_controls /en-US/docs/Games/Tutorials/2D_Breakout_game_pure_JavaScript/Paddle_and_keyboard_controls
/en-US/docs/Games/Workflows/Breakout_game_from_scratch/Track_the_score_and_win /en-US/docs/Games/Tutorials/2D_Breakout_game_pure_JavaScript/Track_the_score_and_win
/en-US/docs/Games/Workflows/HTML5_Gamedev_Phaser_Device_Orientation /en-US/docs/Games/Tutorials/HTML5_Gamedev_Phaser_Device_Orientation
/en-US/docs/Games/Workflows/Touch_Event_Horizon /en-US/docs/Games/Tutorials/Touch_Event_Horizon
/en-US/docs/Games/Workflows/Touch_Event_Horizon /en-US/docs/Games/Tutorials
/en-US/docs/Games/visual_typescript_game_engine /en-US/docs/Games
/en-US/docs/Getting_Started_With_NSS https://firefox-source-docs.mozilla.org/security/nss/index.html
/en-US/docs/Getting_started_on_MDN /en-US/docs/MDN/Community/Contributing/Getting_started
Expand Down Expand Up @@ -3602,6 +3603,7 @@
/en-US/docs/Glossary/Rendering_engine /en-US/docs/Glossary/Engine/Rendering
/en-US/docs/Glossary/Responsive_design /en-US/docs/Glossary/Responsive_web_design
/en-US/docs/Glossary/Round_Trip_Time_(RTT) /en-US/docs/Glossary/Round_Trip_Time
/en-US/docs/Glossary/Routers /en-US/docs/Glossary/Router
/en-US/docs/Glossary/SRTP /en-US/docs/Glossary/RTP
/en-US/docs/Glossary/SSL_Glossary /en-US/docs/Glossary/SSL
/en-US/docs/Glossary/Scrollport /en-US/docs/Glossary/Scroll_container
Expand Down Expand Up @@ -3972,7 +3974,6 @@
/en-US/docs/HTMLSpanElement /en-US/docs/Web/API/HTMLSpanElement
/en-US/docs/HTMLSpanElement_interface /en-US/docs/Web/API/HTMLSpanElement
/en-US/docs/HTML_Intro2 /en-US/docs/Learn/HTML/Introduction_to_HTML
/en-US/docs/HTML_Santizer_API /en-US/docs/Web/API/HTML_Sanitizer_API
/en-US/docs/HTML_in_XMLHttpRequest /en-US/docs/Web/API/XMLHttpRequest_API/HTML_in_XMLHttpRequest
/en-US/docs/HTML_intro /en-US/docs/Learn/HTML/Introduction_to_HTML
/en-US/docs/HTTP /en-US/docs/Web/HTTP
Expand Down Expand Up @@ -8627,7 +8628,6 @@
/en-US/docs/Web/API/HTMLVideoElement/onleavepictureinpicture /en-US/docs/Web/API/HTMLVideoElement/leavepictureinpicture_event
/en-US/docs/Web/API/HTMLVideoElement/requestPictureInPicture() /en-US/docs/Web/API/HTMLVideoElement/requestPictureInPicture
/en-US/docs/Web/API/HTML_DOM /en-US/docs/Web/API/HTML_DOM_API
/en-US/docs/Web/API/HTML_Santizer_API /en-US/docs/Web/API/HTML_Sanitizer_API
/en-US/docs/Web/API/HashChangeEvent/HashChangeEvent.oldURL /en-US/docs/Web/API/HashChangeEvent/oldURL
/en-US/docs/Web/API/Headers/getAll /en-US/docs/Web/API/Headers/get
/en-US/docs/Web/API/History.length /en-US/docs/Web/API/History/length
Expand Down Expand Up @@ -9649,7 +9649,6 @@
/en-US/docs/Web/API/SVGPathElement/pathLength /en-US/docs/Web/API/SVGGeometryElement/pathLength
/en-US/docs/Web/API/SVGStylable /en-US/docs/Web/API/SVGElement
/en-US/docs/Web/API/SVGURIReference /en-US/docs/Web/SVG/Attribute/href
/en-US/docs/Web/API/Sanitizer/sanitizeFor /en-US/docs/Web/API/Sanitizer
/en-US/docs/Web/API/Screen.availHeight /en-US/docs/Web/API/Screen/availHeight
/en-US/docs/Web/API/Screen.availLeft /en-US/docs/Web/API/ScreenDetailed/availLeft
/en-US/docs/Web/API/Screen.availTop /en-US/docs/Web/API/ScreenDetailed/availTop
Expand Down Expand Up @@ -10217,6 +10216,7 @@
/en-US/docs/Web/API/Window/restore /en-US/docs/Web/API/Window/moveTo
/en-US/docs/Web/API/Window/setInterval /en-US/docs/Web/API/setInterval
/en-US/docs/Web/API/Window/setTimeout /en-US/docs/Web/API/setTimeout
/en-US/docs/Web/API/Window/sidebar /en-US/docs/Web/API/Window/external
/en-US/docs/Web/API/Window/sidebar/Adding_search_engines_from_Web_pages /en-US/docs/Web/OpenSearch
/en-US/docs/Web/API/Window/transitioncancel_event /en-US/docs/Web/API/Element/transitioncancel_event
/en-US/docs/Web/API/Window/transitionend_event /en-US/docs/Web/API/Element/transitionend_event
Expand Down Expand Up @@ -10938,7 +10938,7 @@
/en-US/docs/Web/API/window.setInterval /en-US/docs/Web/API/setInterval
/en-US/docs/Web/API/window.setTimeout /en-US/docs/Web/API/setTimeout
/en-US/docs/Web/API/window.showModalDialog /en-US/docs/Web/API/Window/showModalDialog
/en-US/docs/Web/API/window.sidebar /en-US/docs/Web/API/Window/sidebar
/en-US/docs/Web/API/window.sidebar /en-US/docs/Web/API/Window/external
/en-US/docs/Web/API/window.sizeToContent /en-US/docs/Web/API/Window/sizeToContent
/en-US/docs/Web/API/window.status /en-US/docs/Web/API/Window/status
/en-US/docs/Web/API/window.statusbar /en-US/docs/Web/API/Window/statusbar
Expand All @@ -10951,7 +10951,7 @@
/en-US/docs/Web/API/window/onscroll /en-US/docs/Web/API/Element/scroll_event
/en-US/docs/Web/API/window/onscroll-temp /en-US/docs/Web/API/Element/scroll_event
/en-US/docs/Web/API/x-ms-aria-flowfrom /en-US/docs/Web/Accessibility/ARIA
/en-US/docs/Web/APIWwindow.sidebar /en-US/docs/Web/API/Window/sidebar
/en-US/docs/Web/APIWwindow.sidebar /en-US/docs/Web/API/Window/external
/en-US/docs/Web/APIr /en-US/docs/Web/API/Document/dir
/en-US/docs/Web/Accessibility/ARIA/ARIA_Examples /en-US/docs/Web/Accessibility/ARIA
/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Complementary_role /en-US/docs/Web/Accessibility/ARIA/Roles/Complementary_role
Expand Down Expand Up @@ -12317,7 +12317,6 @@
/en-US/docs/Web/HTTP/Headers/Feature-Policy/accelerometer /en-US/docs/Web/HTTP/Headers/Permissions-Policy/accelerometer
/en-US/docs/Web/HTTP/Headers/Feature-Policy/ambient-light-sensor /en-US/docs/Web/HTTP/Headers/Permissions-Policy/ambient-light-sensor
/en-US/docs/Web/HTTP/Headers/Feature-Policy/autoplay /en-US/docs/Web/HTTP/Headers/Permissions-Policy/autoplay
/en-US/docs/Web/HTTP/Headers/Feature-Policy/battery /en-US/docs/Web/HTTP/Headers/Permissions-Policy/battery
/en-US/docs/Web/HTTP/Headers/Feature-Policy/camera /en-US/docs/Web/HTTP/Headers/Permissions-Policy/camera
/en-US/docs/Web/HTTP/Headers/Feature-Policy/display-capture /en-US/docs/Web/HTTP/Headers/Permissions-Policy/display-capture
/en-US/docs/Web/HTTP/Headers/Feature-Policy/document-domain /en-US/docs/Web/HTTP/Headers/Permissions-Policy/document-domain
Expand Down Expand Up @@ -13804,7 +13803,7 @@
/en-US/docs/window.scrollbars /en-US/docs/Web/API/Window/scrollbars
/en-US/docs/window.setInterval /en-US/docs/Web/API/setInterval
/en-US/docs/window.setTimeout /en-US/docs/Web/API/setTimeout
/en-US/docs/window.sidebar /en-US/docs/Web/API/Window/sidebar
/en-US/docs/window.sidebar /en-US/docs/Web/API/Window/external
/en-US/docs/window.sizeToContent /en-US/docs/Web/API/Window/sizeToContent
/en-US/docs/window.status /en-US/docs/Web/API/Window/status
/en-US/docs/window.statusbar /en-US/docs/Web/API/Window/statusbar
Expand Down
58 changes: 0 additions & 58 deletions files/en-us/_wikihistory.json
Original file line number Diff line number Diff line change
Expand Up @@ -832,21 +832,6 @@
"roryokane"
]
},
"Games/Tutorials/Touch_Event_Horizon": {
"modified": "2020-10-27T19:53:30.191Z",
"contributors": [
"escattone",
"wbamberg",
"chrisdavidmills",
"rolfedh",
"dkocho4",
"nithinsudarsan",
"fscholz",
"Werebgle",
"aamiryan23",
"franciov"
]
},
"Glossary": {
"modified": "2020-12-14T11:30:09.332Z",
"contributors": [
Expand Down Expand Up @@ -41793,10 +41778,6 @@
"Enn"
]
},
"Web/API/HTML_Sanitizer_API": {
"modified": "2020-12-13T12:18:13.088Z",
"contributors": ["Rumyra"]
},
"Web/API/HashChangeEvent": {
"modified": "2020-10-15T21:29:11.207Z",
"contributors": [
Expand Down Expand Up @@ -57401,18 +57382,6 @@
"Jeremie"
]
},
"Web/API/Sanitizer": {
"modified": "2020-12-13T12:17:05.573Z",
"contributors": ["Rumyra"]
},
"Web/API/Sanitizer/Sanitizer": {
"modified": "2020-12-13T12:21:15.482Z",
"contributors": ["Rumyra"]
},
"Web/API/Sanitizer/sanitize": {
"modified": "2020-12-13T12:25:31.511Z",
"contributors": ["Rumyra"]
},
"Web/API/Screen": {
"modified": "2020-10-15T21:29:41.001Z",
"contributors": [
Expand Down Expand Up @@ -68910,29 +68879,6 @@
"modified": "2020-12-12T15:24:20.525Z",
"contributors": ["Rumyra"]
},
"Web/API/Window/sidebar": {
"modified": "2020-10-15T21:13:22.168Z",
"contributors": [
"wbamberg",
"mfuji09",
"chrisdavidmills",
"connorshea",
"IsaacSchemm",
"teoli",
"fscholz",
"iamanupmenon",
"kohei.yoshino",
"Sheppy",
"ethertank",
"Mnyromyr",
"Deltab",
"Mgjbot",
"Jabez",
"Nickolay",
"Dria",
"JesseW"
]
},
"Web/API/Window/sizeToContent": {
"modified": "2020-12-03T06:15:03.807Z",
"contributors": [
Expand Down Expand Up @@ -100101,10 +100047,6 @@
"modified": "2020-10-15T22:10:28.577Z",
"contributors": ["bershanskiy", "Sheppy", "fscholz"]
},
"Web/HTTP/Headers/Permissions-Policy/battery": {
"modified": "2020-10-15T22:24:54.886Z",
"contributors": ["mfuji09", "Malvoz", "bershanskiy"]
},
"Web/HTTP/Headers/Permissions-Policy/camera": {
"modified": "2020-10-15T22:10:24.420Z",
"contributors": ["bershanskiy", "Sheppy", "fscholz"]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -93,7 +93,7 @@ After you've covered Steam, there's plenty of buzz around initiatives like [Humb

## Packaging games

The web is the first and the best choice for HTML games, but if you want to reach a broader audience and distribute your game in a closed ecosystem, you still can do that by packaging it. The good thing is that you don't need a few separate teams working on the same game for different platforms — you can build it once and use tools like [Phonegap](https://phonegap.com/) or [CocoonIO](http://cocoon.io/) to package the game for native stores. The resulting packages are usually pretty reliable, but you should still test them and be on the lookout for small issues or bugs to fix.
The web is the first and the best choice for HTML games, but if you want to reach a broader audience and distribute your game in a closed ecosystem, you still can do that by packaging it. The good thing is that you don't need a few separate teams working on the same game for different platforms — you can build it once and use tools like [Phonegap](https://phonegap.com/) to package the game for native stores. The resulting packages are usually pretty reliable, but you should still test them and be on the lookout for small issues or bugs to fix.

### Available tools

Expand Down
8 changes: 2 additions & 6 deletions files/en-us/games/techniques/2d_collision_detection/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,9 +52,7 @@ rect2.bind("EnterFrame", function () {

{{ EmbedLiveSample('Axis-Aligned_Bounding_Box', '700', '300') }}

> [!NOTE]
>
> [Another example without Canvas or external libraries](https://jsfiddle.net/jlr7245/217jrozd/3/).
> **Note:** [Another example without Canvas or external libraries](https://jsfiddle.net/jlr7245/217jrozd/3/).
## Circle Collision

Expand Down Expand Up @@ -129,9 +127,7 @@ circle2.bind("EnterFrame", function () {

{{ EmbedLiveSample('Circle_Collision', '700', '300') }}

> [!NOTE]
>
> [Here is another example without Canvas or external libraries.](https://jsfiddle.net/jlr7245/teb4znk0/20/)
> **Note:** [Here is another example without Canvas or external libraries.](https://jsfiddle.net/jlr7245/teb4znk0/20/)
## Separating Axis Theorem

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,8 @@ slug: Games/Techniques/3D_on_the_web/Building_up_a_basic_demo_with_PlayCanvas/ed
page-type: guide
---

{{GamesSidebar}}

Instead of coding everything from scratch you can also use the online **PlayCanvas editor**. This can be a more pleasant working environment if you are not someone who likes to code.

## Creating an account
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ Now, when we have our mobile controls in place and the game is playable on touch
It's also easier to test control-independent features like gameplay on desktop if you develop it there, so you don't have to push the files to a mobile device every time you make a change in the source code.

> [!NOTE]
> the [Captain Rogers: Battle at Andromeda](https://rogers2.enclavegames.com/demo/) is built with Phaser and managing the controls is Phaser-based, but it could also be done in pure JavaScript. The good thing about using Phaser is that it offers helper variables and functions for easier and faster development, but it's totally up to you which approach you chose.
> The [Captain Rogers: Battle at Andromeda](https://rogers2.enclavegames.com/demo/) is built with Phaser and managing the controls is Phaser-based, but it could also be done in pure JavaScript. The good thing about using Phaser is that it offers helper variables and functions for easier and faster development, but it's totally up to you which approach you chose.
## Pure JavaScript approach

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -291,7 +291,8 @@ document.getElementById("runButton").addEventListener("click", function () {

{{embedlivesample("compare_your_code", 600, 360)}}

> **Note:**: Try changing the number of lives and the angle the ball bounces off the paddle.
> [!NOTE]
> Try changing the number of lives and the angle the ball bounces off the paddle.
## Game over - for now!

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -34,8 +34,7 @@ All the lessons — and the different versions of the [MDN Breakout game](https:
Starting with pure JavaScript is the best way to get a solid knowledge of web game development. After that, you can pick any framework you like and use it for your projects. Frameworks are just tools built with the JavaScript language; so even if you plan on working with them, it's good to learn about the language itself first to know what exactly is going on under the hood. Frameworks speed up development time and help take care of boring parts of the game, but if something is not working as expected, you can always try to debug that or just write your own solutions in pure JavaScript.

> [!NOTE]
>
> > This series of articles can be used as material for hands-on game development workshops. You can also make use of the [Gamedev Canvas Content Kit](https://github.com/end3r/Gamedev-Canvas-Content-Kit) based on this tutorial if you want to give a talk about game development in general.
> This series of articles can be used as material for hands-on game development workshops. You can also make use of the [Gamedev Canvas Content Kit](https://github.com/end3r/Gamedev-Canvas-Content-Kit) based on this tutorial if you want to give a talk about game development in general.
>
> If you are interested in using a game library for learning about 2D web game development, see this series' counterpart, [2D breakout game using Phaser](/en-US/docs/Games/Tutorials/2D_breakout_game_Phaser).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ page-type: guide

{{GamesSidebar}}

In this tutorial we'll go through the process of building an HTML mobile game that uses the [Device Orientation](/en-US/docs/Web/Apps/Fundamentals/gather_and_modify_data/responding_to_device_orientation_changes) and [Vibration](/en-US/docs/Web/API/Vibration_API) **APIs** to enhance the gameplay and is built using the [Phaser](https://phaser.io/) framework. Basic JavaScript knowledge is recommended to get the most from this tutorial.
In this tutorial we'll go through the process of building an HTML mobile game that uses the [Device Orientation](/en-US/docs/Web/API/Device_orientation_events) and [Vibration](/en-US/docs/Web/API/Vibration_API) **APIs** to enhance the gameplay and is built using the [Phaser](https://phaser.io/) framework. Basic JavaScript knowledge is recommended to get the most from this tutorial.

## Example game

Expand Down Expand Up @@ -325,9 +325,6 @@ The more you tilt the device, the more force is applied to the ball, therefore t

![An explanation of the X, Y and Z axes of a Flame mobile device with the Cyber Orb game demo on the screen.](cyber-orb-flame-orientation.png)

> [!NOTE]
> To find out more about implementing device orientation and what raw code would look like, read [Keep it level: responding to device orientation changes](/en-US/docs/Web/Apps/Fundamentals/gather_and_modify_data/responding_to_device_orientation_changes).
#### Adding the hole

The main objective in the game is to move the ball from the starting position to the ending position: a hole in the ground. Implementation looks very similar to the part where we created the ball, and it's also added in the `create()` function of our `Game` state:
Expand Down
39 changes: 0 additions & 39 deletions files/en-us/games/tutorials/touch_event_horizon/index.md

This file was deleted.

Binary file not shown.
Binary file not shown.
Loading

0 comments on commit fae9cb6

Please sign in to comment.