The project has a new web site

ilg@livius.net (Liviu Ionescu (ilg)) — Fri, 15 Nov 2024 13:21:00 GMT

After some experimentation with modern site generators, the xPack Project has a new web site.

The migration was completed by the end of December 2024.

MDX

The new kid on the block is MDX, that is a solution to integrate JSX with markdown.

The result is a static site (kind of), enhanced with lots of JavaScript code, specific to React components.

The tool used to generate the site is Docusaurus, a highly successful open source project.

The content of the README.md file was migrated to the Getting Started page

ilg@livius.net (Liviu Ionescu (ilg)) — Thu, 18 Jul 2019 17:36:00 GMT

After several re-branding iterations, the xPack Project, available from GitHub, has a new web site.

The site continues to use GitHub Pages, which is the GitHub solution for providing documentation sites to hosted projects

GitHub Pages use Jekyll to generate static web sites, and the most convenient input format for Jekyll is markdown.

The new site uses the standard GitHub setup, which automatically runs the Jekyll generator; thus an external build step is no longer needed.

The initial location of the new site was the xpack/preview.git project.

Content from the old site was migrated to the new site, with updates.

Switching fom the external builder to GitHub required some changes:

there is no automatic detection of last modified date, so the last_updated: was added to posts
the kramdown markdown parser does not have the autolink option, so links must be explicit