Hiccup is a minimalistic and elegant Jekyll theme created by Ashwin. This tutorial will guide you through the steps of installing Hiccup on NixOS Latest.
The first step is to install Git, as it will be used to clone the Hiccup repository.
sudo nix-env -iA nixos.git
The next step is to clone the Hiccup repository to your local system.
git clone https://github.com/ashwinvis/hiccup.git
After cloning the repository, copy the contents of the _layouts
and _includes
directories to your Jekyll project.
sudo cp -r hiccup/_layouts/* /path/to/your/jekyll/project/_layouts/
sudo cp -r hiccup/_includes/* /path/to/your/jekyll/project/_includes/
Next, you need to modify your Jekyll _config.yml
file to use the Hiccup layouts.
# _config.yml
theme: "hiccup"
# Add the following lines to use the Hiccup layouts
permalink: /:year/:month/:day/:title/
paginate_path: /page:num/
plugins:
- jekyll-paginate-v2
exclude:
- vendor
Finally, build your Jekyll project to generate the static site using the Hiccup theme.
cd /path/to/your/jekyll/project/
bundle exec jekyll build
Congratulations! You have successfully installed the Hiccup theme on NixOS Latest. You can now view your Jekyll site using the Hiccup theme by navigating to the /_site
directory in your project and opening the index.html
file in your web browser.
If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!