Tutorial: Installing Hiccup on NixOS Latest

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.

Prerequisites

• A running instance of NixOS Latest.
• Root access to the system.
• A basic understanding of the command line interface.

Step 1: Install Git

The first step is to install Git, as it will be used to clone the Hiccup repository.

sudo nix-env -iA nixos.git

Step 2: Clone the Hiccup repository

The next step is to clone the Hiccup repository to your local system.

git clone https://github.com/ashwinvis/hiccup.git

Step 3: Copy the Hiccup files to your Jekyll project

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/

Step 4: Modify your Jekyll _config.yml file

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

Step 5: Build your Jekyll project

Finally, build your Jekyll project to generate the static site using the Hiccup theme.

cd /path/to/your/jekyll/project/
bundle exec jekyll build

Conclusion

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.