website: re-generate commons

README.md

@@ -3,7 +3,7 @@
 
 # The xPack Build Box
 
-The environment used to build the xPack Binary Development Tools.
+The environment used to build the xPack Binary Development Tools
 
 ## Project documentation
 
@@ -13,11 +13,9 @@ please refer to the
 
 ## Project source
 
-
 The source code is available on
 [GitHub](https://github.com/xpack-dev-tools/xpack-build-box/).
 
-
 ## License
 
 Unless otherwise stated, the original content is released under the terms of the

website/docs/getting-started/index.mdx

@@ -17,14 +17,15 @@ date: 2024-10-24 18:58:00 +0300
 
 import Link from '@docusaurus/Link';
 
-import UserDeveloperMaintainer from './_common/_user-developer-maintainer.mdx';
+import MoreCredits from './_more-credits.mdx'
 
 
 
+import UserDeveloperMaintainer from './_common/_user-developer-maintainer.mdx';
+
 import Overview from './_overview.mdx'
 import Compatibility from './_compatibility.mdx'
 import Status from './_status.mdx'
-import MoreCredits from './_more-credits.mdx'
 
 {/* ------------------------------------------------------------------------ */}
 

website/docs/maintainer/index.mdx

@@ -23,7 +23,7 @@ import CustomMaintainer from './_custom-maintainer.mdx'
 
 {/* ------------------------------------------------------------------------ */}
 
-# How to make new xPack Build Box releases
+# Maintainer's Guide
 
 <CustomMaintainer />
 

website/docs/test/index.mdx

@@ -16,11 +16,10 @@ something: "Some text"
 
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
+import Heading from '@theme/Heading';
 
 import CodeBlock from '@theme/CodeBlock';
 
-import Heading from '@theme/Heading';
-
 export const world = 'World'
 export const version = '11.2.1'
 export const xpackSubversion = '1.2'
@@ -184,7 +183,27 @@ const visit = require('unist-util-visit');
 
 </Tabs>
 
+## Headers in tabs
+
 To display headings not showing in the TOC:
 
 <Heading as="h3">My Heading</Heading>
 
+## Conditional markdown
+
+```
+### Edit the {props.doReconstruct === "true" ? (`LICENSE-XPACK`) : (`LICENSE`)} file
+```
+
+or
+
+```
+<ul>
+<li>select the `master` branch</li>
+<li>create a new `xpack` branch</li>
+<li>switch to it</li>
+{props.doReconstruct === "true" ? (<li>rename <code>LICENSE</code> to <code>LICENSE-XPACK</code>.</li>) : (<></>)}
+{props.doReconstruct === "true" ? (<li>rename <code>README.md</code> to <code>README-XPACK.md</code>.</li>) : (<></>)}
+<li>Push the `xpack` branch</li>
+</ul>
+```

website/docusaurus.config.ts

@@ -75,9 +75,12 @@ const config: Config = {
   organizationName: 'xpack-dev-tools', // Usually your GitHub org/user name.
   projectName: 'xpack-build-box', // Usually your repo name.
 
+  onBrokenAnchors: 'throw',
   onBrokenLinks: 'throw',
   onBrokenMarkdownLinks: 'throw',
 
+  onDuplicateRoutes: 'throw',
+
   // Useful for the sitemap.xml, to avoid redirects, since
   // GitHub redirects all to trailing slash.
   trailingSlash: true,

website/package.json

@@ -20,7 +20,9 @@
     "npm-link-helper": "npm link @xpack/docusaurus-template-liquid @xpack/npm-packages-helper",
     "generate-website-commons": "bash node_modules/@xpack/docusaurus-template-liquid/maintenance-scripts/generate-commons.sh",
     "import-website-releases": "bash node_modules/@xpack/docusaurus-template-liquid/maintenance-scripts/website-import-releases.sh",
-    "generate-website-blog-post": "bash node_modules/@xpack/docusaurus-template-liquid/maintenance-scripts/generate-blog-post.sh"
+    "generate-website-blog-post": "bash node_modules/@xpack/docusaurus-template-liquid/maintenance-scripts/generate-blog-post.sh",
+    "deep-clean": "del-cli .docusaurus build node_modules package-lock.json",
+    "generate-dependencies-details": "bash node_modules/@xpack/docusaurus-template-liquid/maintenance-scripts/generate-dependencies-details.sh"
   },
   "dependencies": {
     "@docusaurus/core": "3.6.3",
@@ -31,7 +33,8 @@
     "clsx": "^2.1.1",
     "prism-react-renderer": "^2.4.0",
     "react": "^18.0.0",
-    "react-dom": "^18.0.0"
+    "react-dom": "^18.0.0",
+    "del-cli": "^6.0.0"
   },
   "devDependencies": {
     "@docusaurus/module-type-aliases": "3.6.3",

website/sidebars.ts

@@ -23,7 +23,6 @@ const sidebars: SidebarsConfig = {
       id: 'getting-started/index',
       label: 'Getting Started'
     },
-
     userSidebarCategory,
     {
       type: 'doc',

website/src/css/custom.css

@@ -56,6 +56,10 @@ hr.hero__hr2 {
   height: 2px;
 }
 
+hr.hero__hr2_margin {
+  margin: calc(var(--ifm-hr-margin-vertical) / 2);
+}
+
 /* Reduce size of blog titles (H2 is 2rem) */
 .title_f1Hy {
   font-size: 2.5rem; /* 3rem; */