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

GitHub Pages

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

Jekyll & markdown

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.

Content migration

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