website: re-generate commons

Author: ilg-ul

website/blog/2025-10-02-realpath-v9-8-0-1-released.mdx

@@ -1,6 +1,6 @@
 ---
 
-title: xPack xPack GNU realpath v9.8.0-1 released
+title: xPack GNU realpath v9.8.0-1 released
 seo_title: Version 9.8.0-1 released
 description: Version 9.8.0-1 is a new release.
 keywords:
@@ -31,6 +31,10 @@ download_url: https://github.com/xpack-dev-tools/realpath-xpack/releases/tag/v9.
 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';
@@ -54,8 +58,8 @@ and **GNU/Linux** (x64 and arm64).
 :::note Raspberry Pi
 
 The main targets for the GNU/Linux Arm
-binaries are the **Raspberry Pi** class devices (aarch64;
-armv6 and armv7l are not supported).
+binaries are the **Raspberry Pi** class devices (aarch64 only;
+armv6 and armv7l are no longer supported).
 
 :::
 
@@ -73,7 +77,7 @@ The easiest way to install this specific version, is by using **xpm**:
 `xpm install @xpack-dev-tools/realpath@${frontMatter.version}.${frontMatter.npm_subversion} -verbose
 `} </CodeBlock>
 
-Comprehensive instructions for installing **xPack xPack GNU realpath** on different platforms
+Comprehensive instructions for installing **xPack GNU realpath** on different platforms
 can be found in the [Install Guide](/docs/install/).
 
 ## Compliance
@@ -150,6 +154,49 @@ xpack-realpath-9.8.0-1-linux-x64.tar.gz
 
 ```
 
+## Folders hierarchy
+
+After install, the package creates a hierarchy of folders like the following
+(only the first two depth levels are shown):
+
+<Tabs groupId="operating-systems">
+
+<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
+│   ├── greadlink
+│   └── grealpath
+└── distro-info
+    └── licenses
+
+4 directories, 3 files
+`} </CodeBlock>
+
+</TabItem>
+
+<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
+│   ├── greadlink
+│   └── grealpath
+└── distro-info
+    └── licenses
+
+3 directories, 3 files
+`} </CodeBlock>
+
+</TabItem>
+
+</Tabs>
+
 <DeprecationNotices/>
 
 <DownloadAnalytics version={frontMatter.version}/>

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

@@ -2,7 +2,7 @@
 
 title: xPack {{packageConfig.descriptiveName}} v{{xpackVersion}} released
 seo_title: Version {{xpackVersion}} released
-description: Version {{xpackVersion}} is a TODO new/maintenance release.
+description: Version {{xpackVersion}} is a TODO maintenance/new release.
 keywords:
   - xpack
   - {{packageConfig.permalinkName}}
@@ -31,6 +31,10 @@ download_url: https://github.com/xpack-dev-tools/realpath-xpack/releases/tag/v{{
 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';
@@ -58,8 +62,8 @@ and **GNU/Linux** (x64 and arm64).
 :::note Raspberry Pi
 
 The main targets for the GNU/Linux Arm
-binaries are the **Raspberry Pi** class devices (aarch64;
-armv6 and armv7l are not supported).
+binaries are the **Raspberry Pi** class devices (aarch64 only;
+armv6 and armv7l are no longer supported).
 
 :::
 

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/_common/_build-website-locally.mdx

@@ -8,7 +8,7 @@
 Validate the website content by performing a local build using the npm **build** script:
 
 ```sh
-npm run build -C website
+npm run build -C ~/Work/xpack-dev-tools/realpath-xpack.git/website
 ```
 
 Resolve any broken links that may be identified during the build process.

website/docs/_common/_generate-top-commons.mdx

@@ -9,10 +9,10 @@ Execute the top **generate-top-commons** npm script to update the
 `build-assets/package.json` and the GitHub workflow files.
 
 ```sh
-(cd ~/Work/xpack-dev-tools/realpath-xpack.git; npm run generate-top-commons)
+npm run generate-top-commons -C ~/Work/xpack-dev-tools/realpath-xpack.git
 ```
 
 ### Commit the top changes
 
 - Stage GitHub workflows and `package.json` files (top and from `build-assets`)
-- **Commit** with the message _**re-generate top commons to bump deps**_
+- **Commit** with the message _**re-generate top commons**_

website/docs/_common/_generate-website-commons.mdx

@@ -3,11 +3,16 @@
 
 {/* ------------------------------------------------------------------------ */}
 
-### Update the website commons
+### Generate the website commons
 
 Execute the **generate-website-commons** npm script from `website/package.json`
 within the project folder.
 
 ```sh
-npm run generate-website-commons -C website
+npm run generate-website-commons -C ~/Work/xpack-dev-tools/realpath-xpack.git/website
 ```
+
+### Commit the website changes
+
+- Stage the `website` folder and top `README.md`
+- **Commit** with the message _**re-generate website commons**_

website/docs/_common/_prepare-website.mdx

@@ -12,6 +12,6 @@ published on the project
 - Switch to the `xpack-development` branch
 - Execute the **website-generate-commons** npm script in the `website/package.json`
   ```sh
-  npm run website-generate-commons -C website
+  npm run website-generate-commons -C ~/Work/xpack-dev-tools/realpath-xpack.git/website
   ```
 - **Commit** all changes

website/docs/_common/_publish-website.mdx

@@ -10,16 +10,16 @@ The website deployment is performed automatically when pushing to the
 [GitHub Actions](https://github.com/xpack-dev-tools/realpath-xpack/actions/workflows/publish-github-pages.yml).
 
 - Open https://xpack-dev-tools.github.io/realpath-xpack/docs/maintainer/#publish-the-website in a separate window
-- Stop the local web server
+- **Stop** the local web server
 - Switch to the `website` branch
 - **Merge** the `xpack-development` branch into the `website` branch
 - **Push** the `website` branch to GitHub
   :::info
   At this point, an automated GitHub Action will generate and publish the website.
   :::
 - Check out the `xpack-development` branch
-- Wait for the publication to complete
-- Refresh the web page
+- **Wait** for the publication to complete
+- **Refresh** the web page
 - The new release blog post is available
 at https://xpack-dev-tools.github.io/realpath-xpack/blog/
 - Record the post URL, as it must be used to update the release page

website/docs/_common/_start-local-web-server.mdx

@@ -9,8 +9,8 @@ Execute the npm script **clear** followed by **start** in the website sub-projec
 or execute the following within the project folder:
 
 ```sh
-npm run clear -C website
-npm run start -C website
+npm run clear -C ~/Work/xpack-dev-tools/realpath-xpack.git/website
+npm run start -C ~/Work/xpack-dev-tools/realpath-xpack.git/website
 ```
 
 Navigate to the **Maintainer Info** page,

website/docs/_common/_update-top-commons.mdx

@@ -0,0 +1,13 @@
+{/* DO NOT EDIT! */}
+{/* Automatically generated from docusaurus-template-liquid/templates/docusaurus. */}
+
+{/* ------------------------------------------------------------------------ */}
+
+### Update the top commons
+
+Execute the top **generate-top-commons** npm script to update the
+`build-assets/package.json` and the GitHub workflow files.
+
+```sh
+npm run generate-top-commons -C ~/Work/xpack-dev-tools/realpath-xpack.git
+```