website: updates

website/blog/2024-09-18-web-site.md

@@ -0,0 +1,35 @@
+---
+title:  The project has a new web site
+
+date:   2024-09-18 13:21:00 +0300
+
+authors: ilg-ul
+
+tags:
+  - web
+
+---
+
+After some experimentation with modern site generators,
+the **xPack GNU realpath** project has a new web site.
+
+<!--truncate-->
+
+## MDX
+
+The _new kid on the block_ is [MDX](https://mdxjs.com), that is a solution
+to integrate [JSX](https://react.dev/learn/writing-markup-with-jsx) with
+markdown.
+
+The result is a static site (kind of), enhanced with lots of JavaScript
+code, specific to [React](https://react.dev) components.
+
+## Docusaurus
+
+The tool used to generate the site is [Docusaurus](https://docusaurus.io),
+a highly successful open source project.
+
+## Minimal README
+
+The content of the `README.md` file was migrated to the
+[Getting Started](/docs/getting-started/) page

website/docusaurus.config.ts

@@ -61,6 +61,13 @@ function getCustomFields() {
     upstreamVersion = xpackSemver;
   }
 
+  const websiteFilePath = path.join(path.dirname(path.dirname(pwd)), 'website', 'package.json');
+  // logger.info(filePath);
+  const websiteFileContent = fs.readFileSync(websiteFilePath);
+  const websitePackageJson = JSON.parse(websiteFileContent.toString());
+
+  const docusaurusVersion = websitePackageJson.dependencies['@docusaurus/core'].replace ('^', '');
+
   return {
     appName: rootPackageJson.xpack.properties.appName,
     appLcName: rootPackageJson.xpack.properties.appLcName,
@@ -70,6 +77,7 @@ function getCustomFields() {
     xpackSubversion,
     npmSubversion,
     upstreamVersion,
+    docusaurusVersion,
     ...customFields,
   }
 }