Replace "Implicit Figures" with Shortcode (#1545)

Author: bash

.github/newsletter-issue-template.md

@@ -115,8 +115,10 @@ Please use these templates as a starting point:
 ```md
 ### [Game name]
 
-![alt text](img)
-_optional image label_
+{{ image_figure(
+    alt="alt text"
+    src="img"
+    caption="optional image label") }}
 
 [Game name] ([GitHub], [Discord], [Twitter]) by [@nickname]
 is... {short project description in one sentence}.
@@ -133,8 +135,10 @@ _Discussions: [/r/rust_gamedev](link), [Twitter](link), [etc](link)_
 ```md
 ### [Article name]
 
-![alt text](img)
-_optional image label_
+{{ image_figure(
+    alt="alt text"
+    src="img"
+    caption="optional image label") }}
 
 [@nickname] published an [article] about...
 {overview what the resource is about}.

.github/newsletter-template.md

@@ -50,8 +50,10 @@ Ideal section structure is:
 ```
 ### [Title]
 
-![image/GIF description](image link)
-_image caption_
+{{ image_figure(
+    alt="image/GIF description"
+    src="image link"
+    caption="image caption") }}
 
 A paragraph or two with a summary and [useful links].
 

.markdownlint.json

@@ -11,6 +11,7 @@
     "no-hard-tabs": false,
     "hr-style": false,
     "strong-style": false,
+    "no-bare-urls": false,
     "emphasis-style": false,
     "no-inline-html": {
         "allowed_elements": [

CONTRIBUTING.md

@@ -53,8 +53,10 @@ your GitHub notifications for any further review comments from the editors.
 ```md
 ### [Game name]
 
-![alt text](img)
-_optional image label_
+{{ image_figure(
+    alt="alt text"
+    src="img"
+    caption="optional image label") }}
 
 [Game name] ([GitHub], [Discord], [Twitter]) by [@nickname]
 is... {short project description in one sentence}.
@@ -71,8 +73,10 @@ _Discussions: [/r/rust_gamedev](link), [Twitter](link), [etc](link)_
 ```md
 ### [Article name]
 
-![alt text](img)
-_optional image label_
+{{ image_figure(
+    alt="alt text"
+    src="img"
+    caption="optional image label") }}
 
 [@nickname] published an [article] about...
 {overview what the resource is about}.

content/news/001/index.md

@@ -115,8 +115,11 @@ Also, check out
 
 ### Way of Rhea [Trailer][rhea trailer] and [Steam Wishlist][rhea steam] Announced
 
-[![Part of the trailer](way-of-rhea.gif)][rhea trailer]
-_click on the GIF to see [the full trailer][rhea trailer]_
+{{ image_figure(
+    alt="Part of the trailer"
+    src="way-of-rhea.gif"
+    caption="click on the GIF to see [the full trailer](https://youtube.com/watch?v=VIzqlI-gbAY)",
+    link="https://youtube.com/watch?v=VIzqlI-gbAY") }}
 
 [A new trailer][rhea trailer] and the [Steam wishlist][rhea steam]
 were published for "Way of Rhea" by [Anthropic Studios].
@@ -520,8 +523,11 @@ by [Michael Fairley] was released:
 > Clear a path to get to the hole, eat some eggs along the way,
 > and make sure to press all the buttons.
 
-[![Part of A snake's Tail's trailer](a-snakes-tail.gif)][snake trailer]
-_click on the GIF to see [the full release trailer][snake trailer]_
+{{ image_figure(
+    alt="Part of A snake's Tail's trailer"
+    src="a-snakes-tail.gif"
+    caption="click on the GIF to see [the full release trailer](https://www.youtube.com/watch?v=23pQmEuueNw)",
+    link="https://www.youtube.com/watch?v=23pQmEuueNw") }}
 
 A few posts about the game and how it was developed:
 

content/news/003/index.md

@@ -523,8 +523,10 @@ Also, see this GameDev WG tracker/complaint issue:
 
 ### [RLSL][rlsl]: a Rust to SPIR-V Compiler
 
-![RLSL code sample](rlsl-example.png)
-_a simple fragment shader that renders a red circle (temporary syntax)_
+{{ image_figure(
+    alt="RLSL code sample"
+    src="rlsl-example.png"
+    caption="a simple fragment shader that renders a red circle (temporary syntax)") }}
 
 This month, [@MaikKlein_DEV] gave a talk at
 [The Khronos Group](https://www.khronos.org)'s meetup in Munich
@@ -557,8 +559,10 @@ _Discussions:
 
 ### [gfx-rs v0.4][gfx-v0-4]
 
-![sailor screenshot: vector terrain map and some basic UI](sailor.png)
-_a screenshot from [Yatekii/sailor] - a wgpu-based sailing navigation application_
+{{ image_figure(
+    alt="sailor screenshot: vector terrain map and some basic UI"
+    src="sailor.png"
+    caption="a screenshot from [Yatekii/sailor](https://github.com/Yatekii/sailor) - a wgpu-based sailing navigation application") }}
 
 [gfx-rs v0.4 was released](https://reddit.com/r/rust/comments/dm89t2/gfxhal_version_04_release):
 major changes were described in [the last blog post](https://gfx-rs.github.io/2019/10/01/update.html),
@@ -683,8 +687,11 @@ _Discussions:
 
 ### [cyclone-physics-rs]
 
-[![cyclone physics demo](cyclone-physics-demo.gif)][cyclone-video-demo]
-_a little demo of "particle" simulation_
+{{ image_figure(
+    alt="cyclone physics demo",
+    src="cyclone-physics-demo.gif",
+    caption='a little demo of "particle" simulation',
+    link="https://twitter.com/heyrutvik/status/1180072669250834432") }}
 
 [cyclone-physics-rs] by [@heyrutvik] a new WIP game physics engine
 based on the ["Game Physics Engine Development" book][cyclone-physics-book].

content/news/004/index.md

@@ -201,8 +201,11 @@ about the implementation of a drop table system to handle monster loot.
 
 ### [Recall Singularity: November Progress][recall-s-nov-text]
 
-[![Demo of the basic ship collision](recall-sing.gif)][recall-s-nov-video]
-_Demo of the basic ship collision._
+{{ image_figure(
+    alt="Demo of the basic ship collision"
+    src="recall-sing.gif"
+    caption="Demo of the basic ship collision.",
+    link="https://youtube.com/watch?v=AoPSAoqmTCk") }}
 
 [Tom Leys] is working on a "The Recall Singularity" game
 about designing autonomous factory ships and stations
@@ -777,8 +780,11 @@ and highlight events from the past. -->
 
 Just an interesting Rust gamedev link from the past. :)
 
-[![Pascal Penguin logo](penguin.png)][penguin-video]
-_click to see the [release trailer][penguin-video]_
+{{ image_figure(
+    alt="Pascal Penguin logo"
+    src="penguin.png"
+    caption="click to see the [release trailer](https://youtube.com/watch?v=EgFr73AUwps)",
+    link="https://youtube.com/watch?v=EgFr73AUwps") }}
 
 ["Adventures of Pascal Penguin"][penguin-about]
 by [Matthew Michelotti](http://luduminis.com)

content/news/005/index.md

@@ -258,8 +258,11 @@ _Discussions:
 
 ### [Garden Devlog: December][garden-dec]
 
-[![Playing with dirt](garden.gif)][garden-video]
-_new smooth soil editing demo_
+{{ image_figure(
+    alt="Playing with dirt"
+    src="garden.gif"
+    caption="new smooth soil editing demo",
+    link="https://youtube.com/watch?v=xU93FGrk1d8") }}
 
 [Garden][garden] is an upcoming game centered around growing realistic plants.
 
@@ -855,8 +858,11 @@ and highlight events from the past. -->
 
 Just an interesting Rust gamedev link from the past. :)
 
-[![Modulator video](modulator_youtube.gif)][modulator-video]
-_click to see [the tutorial video][modulator-video]_
+{{ image_figure(
+    alt="Modulator video"
+    src="modulator_youtube.gif"
+    caption="click to see [the tutorial video][modulator-video]",
+    link="modulator-video") }}
 
 In the November of 2018,
 [@AndreaPessino] (Founder/CTO of [Ready At Dawn] Studios)

content/news/006/index.md

@@ -838,8 +838,10 @@ Btw, [@resinten] continues working on a luminance-based game:
 
 ### [SPIR-Q][spir-q] v0.4.1
 
-![Example walking an entry point of a SPIR-V file](spir-q.png)
-_Example walking an entry point of a SPIR-V file_
+{{ image_figure(
+    alt="Example walking an entry point of a SPIR-V file"
+    src="spir-q.png"
+    caption="Example walking an entry point of a SPIR-V file") }}
 
 [SPIR-Q][spir-q] is a lightweight [SPIR-V] query library.
 This month v0.2..v0.4.1 versions were released:

content/news/007/index.md

@@ -177,8 +177,10 @@ This month an alpha version was published on itch: [check it out here][colony-it
 
 ### [Veloren][veloren]
 
-![Rolling mountain landscape](veloren1.png)
-_Rolling mountain landscape_
+{{ image_figure(
+    alt="Rolling mountain landscape"
+    src="veloren1.png"
+    caption="Rolling mountain landscape") }}
 
 [Veloren][veloren] is an open world, open-source voxel RPG
 inspired by Dwarf Fortress and Cube World.
@@ -214,8 +216,11 @@ Here is the February changelog:
 - Added music system
 ```
 
-[![veloren development](veloren3.gif)](https://youtube.com/watch?v=1ldHQfxCT24)
-_1 year of Veloren development. Click for the full video!_
+{{ image_figure(
+    alt="veloren development"
+    src="veloren3.gif"
+    caption="1 year of Veloren development. Click for the full video!"
+    link="https://youtube.com/watch?v=1ldHQfxCT24") }}
 
 You can read more about some specific topics:
 
@@ -243,8 +248,11 @@ February's full weekly devlogs: "This Week In Veloren...":
 
 ### [Oxidator][oxidator]
 
-[![Gameplay demo: two giant tank armies clashing](oxidator-play.gif)][oxidator-video-play]
-_gameplay demo (35000 units)_
+{{ image_figure(
+    alt="Gameplay demo: two giant tank armies clashing"
+    src="oxidator-play.gif"
+    caption="gameplay demo (35000 units)",
+    link="https://streamable.com/499j0") }}
 
 [Oxidator][oxidator] by [@Ruddle] is a real-time strategy game/engine
 written with Rust and WebGPU.
@@ -270,11 +278,17 @@ Some of the current features:
 - Unit editor: basic editor with joint & mesh selection and parameter editing
   (speed, turn rate, health, etc);
 
-[![Unit editor demo: move agent's parts](oxidator-unit-editor.gif)][oxidator-video-unit-editor]
-_Demo of the unit editor_
+{{ image_figure(
+    alt="Unit editor demo: move agent's parts"
+    src="oxidator-unit-editor.gif"
+    caption="Demo of the unit editor",
+    link="https://streamable.com/ywr44") }}
 
-[![Map editor demo: use pencil tool to instantly create a lake and mountains](oxidator-map-editor.gif)][oxidator-video-map-editor]
-_Demo of the map editor_
+{{ image_figure(
+    alt="Map editor demo: use pencil tool to instantly create a lake and mountains"
+    src="oxidator-map-editor.gif"
+    caption="Demo of the map editor",
+    link="https://github.com/Ruddle/oxidator/blob/be4863e74/etc/map_editor.gif") }}
 
 [oxidator]: https://github.com/Ruddle/oxidator
 [@Ruddle]: https://github.com/Ruddle
@@ -485,9 +499,11 @@ Tetra itself also received two small updates recently:
 
 ### [Akigi][akigi]
 
-![High detail terrain chunk with PRR](akigi.png)
-_Sampling a heightmap in the vertex shader and also computing the normal,
-tangent and bitangent vectors in the vertex shader._
+{{ image_figure(
+    alt="High detail terrain chunk with PRR"
+    src="akigi.png"
+    caption="Sampling a heightmap in the vertex shader and also computing the normal,
+tangent and bitangent vectors in the vertex shader.") }}
 
 [Akigi][akigi] is a multiplayer online world where most believe that humans are inferior.
 
@@ -590,8 +606,10 @@ Check them out in the [latest winter devlog][grumpy_visitors].
 
 ### [Make China Great Again][china-great]
 
-![cities, planes and keys](china.png)
-_Turn back planes to the port, by clicking right keys to the virus beat._
+{{ image_figure(
+    alt="cities, planes and keys"
+    src="china.png"
+    caption="Turn back planes to the port, by clicking right keys to the virus beat.") }}
 
 [Make China Great Again][china-great] ([source][china-great-src])
 by [@PsichiX] is a GlobalGameJam game written using [Oxygengine].
@@ -633,8 +651,10 @@ dependency updates, bugfixes and performance optimizations.
 
 ### [Recall Singularity: February Progress][recall-s-feb]
 
-![Harvesting and refining some Gold](recall-singularity.png)
-_Harvesting and refining some Gold._
+{{ image_figure(
+    alt="Harvesting and refining some Gold"
+    src="recall-singularity.png"
+    caption="Harvesting and refining some Gold.") }}
 
 [Tom Leys] is working on a "The Recall Singularity" game
 about designing autonomous factory ships and stations.
@@ -905,8 +925,10 @@ A showcase game is [being developed](https://github.com/lcnr/akari) with crow.
 
 ### miniquad: ["Rust 2D Engine 2020 Roadmap"][fedor-road]
 
-![mainloop async/await experiment in macroquad](miniquad-sample.png)
-_mainloop async/await experiment in macroquad_
+{{ image_figure(
+    alt="mainloop async/await experiment in macroquad"
+    src="miniquad-sample.png"
+    caption="mainloop async/await experiment in macroquad") }}
 
 [miniquad] by [@fedor_games] is a safe cross-platform rendering library
 focused on portability and low-end platforms support.