Build
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.
GitHub Pages
To deploy to GitHub Pages, the steps are:
$ JEKYLL_ENV=production bundle exec jekyll build
$ cd _site
$ git init # you only need to do this once
$ git remote add origin <github_remote_url> # you only need to do this once
$ git add .
$ git commit -m "Build"
$ git push origin master:<remote_branch>
$ cd ..
github_remote_url
- Find this on your repository’s GitHub page.
remote_branch
- Either
master
for “user or organization pages”, orgh-pages
for “project pages”
More on user, organization, and project pages.
Building locally 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 or tag. However, the results are still pretty “unrelated”. To provide better results, Jekyll supports latent semantic analysis via classifier-reborn
’s Latent Semantic Indexer
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.
GitHub Pages
To deploy to GitHub Pages, the steps are:
$ JEKYLL_ENV=production bundle exec jekyll build --lsi
$ cd _site
$ git init # you only need to do this once
$ git remote add origin <github_remote_url> # you only need to do this once
$ git add .
$ git commit -m "Build"
$ git push origin master:<remote_branch>
$ cd ..
github_remote_url
- Find this on your repository’s GitHub page.
remote_branch
- Either
master
for “user or organization pages”, orgh-pages
for “project pages”
More on user, organization, and project pages.
Continue with Advanced