website: re-generate commons

Author: ilg-ul

website/blog/_templates/blog-post-release-part-1-liquid.mdx

@@ -34,6 +34,10 @@ download_url: https://github.com/xpack-dev-tools/riscv-none-elf-gcc-xpack/releas
 import {PageMetadata} from '@docusaurus/theme-common';
 import Image from '@theme/IdealImage';
 import CodeBlock from '@theme/CodeBlock';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+import customField from '@site/src/libs/customField';
 
 import Prerequisites from './_common/_prerequisites-glib-2.28.mdx';
 import DeprecationNotices from './_common/_deprecation-notices-glib-2.28.mdx';

website/blog/_templates/blog-post-release-part-2-liquid.mdx

@@ -1,4 +1,78 @@
 
+## Folders hierarchy
+
+After install, the package creates a hierarchy of folders like the following
+(only the first two depth levels are shown):
+
+{%- assign platforms_array = platforms | split: "," %}
+
+{%- assign names_array = "" | split: "" %}
+
+{%- for platform in platforms_array %}
+{%- case platform %}
+{%- when "win32-x64" %}
+{%- assign names_array = names_array | concat: "Windows" %}
+{%- when "darwin-x64", "darwin-arm64" %}
+{%- assign names_array = names_array | concat: "macOS" %}
+{%- when "linux-x64", "linux-arm64", "linux-arm" %}
+{%- assign names_array = names_array | concat: "GNU/Linux" %}
+{%- endcase %}
+{%- endfor %}
+
+{%- assign names_array = names_array | uniq %}
+
+<Tabs groupId="operating-systems">
+
+{%- for name in names_array %}
+{%- case name %}
+{%- when "Windows" %}
+
+<TabItem value="windows" label="Windows" default>
+
+<CodeBlock language="console"> {
+`C:\> tree /f %USERPROFILE%\\AppData\\Roaming\\xPacks\\@{{packageScope}}\\{{packageName}}\\${frontMatter.version}.${frontMatter.npm_subversion}\\.content
+Folder PATH listing
+Volume serial number is B02D-925C
+├── README.md
+├── bin
+TODO
+`} </CodeBlock>
+
+</TabItem>
+
+{%- when "macOS" %}
+
+<TabItem value="macos" label="macOS">
+
+<CodeBlock language="console"> {
+`$ tree -L 2 ~/Library/xPacks/\{{packageScopedName}}/${frontMatter.version}.${frontMatter.npm_subversion}/.content/
+/Users/ilg/Library/xPacks/\{{packageScopedName}}/${frontMatter.version}.${frontMatter.npm_subversion}/.content/
+├── README.md
+├── bin
+TODO
+`} </CodeBlock>
+
+</TabItem>
+
+{%- when "GNU/Linux" %}
+
+<TabItem value="linux" label="GNU/Linux">
+
+<CodeBlock language="console"> {
+`$ tree -L 2 ~/.local/xPacks/\{{packageScopedName}}/${frontMatter.version}.${frontMatter.npm_subversion}/.content/
+/home/ilg/.local/xPacks/\{{packageScopedName}}/${frontMatter.version}.${frontMatter.npm_subversion}/.content/
+├── README.md
+├── bin
+TODO
+`} </CodeBlock>
+
+</TabItem>
+
+{%- endcase %}
+{%- endfor %}
+
+</Tabs>
+
 <DeprecationNotices/>
 
 <DownloadAnalytics version={frontMatter.version}/>

website/docs/maintainer/_common/_content.mdx

@@ -610,13 +610,6 @@ watching the riscv-none-elf-gcc-xpack project.
 
 <CommonPrepareNewBlogPost />
 
-### Update the web install page
-
-- Check and possibly update the output of the `--version` runs in
-  - `website/docs/install/_project/_automatic-install-quick-test.mdx`
-  - `website/docs/install/_project/_manual-install-quick-test.mdx`
-- **Commit** with the message _**website: update quick tests**_
-
 ### Check the list of links in top package.json
 
 - Open the top `package.json` file

website/docs/maintainer/_common/_prepare-new-blog-post.mdx

@@ -10,11 +10,11 @@
   ```sh
   npm run generate-website-blog-post -C ~/Work/xpack-dev-tools/riscv-none-elf-gcc-xpack.git/website
   ```
-- Edit the front matter properties (the `description` property)
-- Select the correct summary (maintenance vs. new release)
+- Fix the TODO in the front matter `description` property (select maintenance vs. new release)
+- Fix the TODO in the summary (select maintenance vs. new release)
 - Add entries in the **Bug fixes**; utilise the following syntax
   ```
   - [[#N](https://github.com/xpack-dev-tools/riscv-none-elf-gcc-xpack/issues/N)]:
   ```
-- Copy/paste the folder structures from the installation guide
+- Copy/paste the **folder hierarchies** from the `website/docs/_project/_folders-hierarchies-*.mdx` files
 - **Commit** with the message _**website: blog post release 14.2.0-3.1 published**_

website/docusaurus.config.ts

@@ -47,7 +47,6 @@ const config: Config = {
 
   onBrokenAnchors: 'throw',
   onBrokenLinks: 'throw',
-  onBrokenMarkdownLinks: 'throw',
 
   onDuplicateRoutes: 'throw',
 
@@ -64,7 +63,10 @@ const config: Config = {
   },
 
   markdown: {
-    format: 'detect'
+    format: 'detect',
+    hooks: {
+        onBrokenMarkdownLinks: 'throw'
+    }
   },
 
   plugins: [