Build

Hydejack supports building locally and on GitHub pages. However, when building on GitHub Pages, providing better related posts via the LSI is not available.

Table of Contents

Building locally

When building Hydejack it is important to set the environment variable JEKYLL_ENV to production. Otherwise the output will not be minified. Building itself happens via Jekyll’s build command.

$ JEKYLL_ENV=production bundle exec jekyll build

This will generate the finished static files in _site which can be deployed using the methods outlined in the Jekyll Documentation.

With latent semantic analysis

By default, related posts are simply the most recent posts. Hydejack modifies this a bit, by showing the most recent posts of the same category/tag. However, the results are still pretty “unrelated”. To provide better results, Jekyll supports latent semantic analysis via classifier-reborn’s Latent Semantic Indexer (LSI).

To use the LSI, you first have to disable Hydejack’s default behaviour, by setting use_lsi: true in _config.yml

use_lsi: true

Then, you have to run jekyll build with the --lsi flag:

$ JEKYLL_ENV=production bundle exec jekyll build --lsi

This will generate the finished static files in _site which can be deployed using the methods outlined in the Jekyll Documentation.

Building on GitHub Pages

If you are using the “PRO” version of Hydejack, this method is discouraged because it will publish the source code on GitHub 😢

GitHub Pages offers the possibility to upload your site’s Jekyll source directly. Then, GitHub will run the build process in the cloud, provided you site only uses certain plugins. Hydejack supports GitHub Pages out of the box.

However, when using this method, the LSI is not available (see above), so make sure use_lsi is set to false in _config.yml.

use_lsi: false

Builds on GitHub run in the production environment, so no further steps are necessary. For the deployment process, see Jekyll’s documentation on GitHub Pages as well as GitHub Help.


Continue with Advanced »


Actions Speak Louder Than Words!

Powered by Jekyll and Hydejack v7.3.0