tonybtw.com

About

This is the source for tonybtw.com, a Hugo-based static site. The repository includes a flake.nix so you can get a reproducible Hugo environment with Nix.

Contributing

There is a /community/ section where people can share Linux tutorials, tips, or rices.

1. Copy example.md from content/community/ and rename it to your own article, e.g. my-guide.md.
2. Edit the front matter and body to fit your content. Keep the same structure for consistency.
   • Minimal front matter example:

     ---
     title: "My Cool Setup"
     author: "Your Name"
     date: 2025-09-15
     description: "A short blurb about your contribution."
     image: "/img/community/your-name/screenshot.png"
     ---
             

3. Place any screenshots in your own folder under static/img/community/<your-name>.
   • Example: static/img/community/alice/my-screenshot.png
   • In your Markdown, reference them as /img/community/alice/my-screenshot.png.
4. Submit a pull request with your Markdown file and images.

This way, everyone’s contributions stay organized and easy to render.

Requirements

• Nix installed
• Flakes enabled (nix-command flakes)

Usage

Clone the repo and enter the development shell:

git clone https://github.com/tonybanters/tonybtw.com
cd tonybtw.com
nix develop

Inside the shell, run Hugo:

hugo serve

This starts the development server at http://localhost:1313.

Alternate dev shell

If you prefer nix to start the server automatically:

nix develop .#serve

This launches hugo serve right away.

Building for production

To generate the static site in public/:

nix develop --command hugo

Installing Nix and enabling flakes

NixOS

1. On NixOS, Nix is already installed.
2. Enable flakes system-wide by adding to /etc/nixos/configuration.nix (or wherever your configuarion.nix is defined):

   experimental-features = nix-command flakes
       

3. Rebuild your system if you use flakes for your config, or just restart shells for it to take effect.

Arch Linux

1. Install Nix from the official repos:

   sudo pacman -S nix
       

2. Enable the Nix daemon:

   sudo systemctl enable --now nix-daemon.service
       

3. Add flake support to ~/.config/nix/nix.conf:

   experimental-features = nix-command flakes
       

Gentoo

1. Enable the overlay and emerge Nix:

   sudo emerge --ask app-misc/nix
       

2. Enable the Nix daemon:

   sudo rc-update add nix-daemon default
   sudo rc-service nix-daemon start
       

3. Add flake support to ~/.config/nix/nix.conf:

   experimental-features = nix-command flakes
       

macOS

1. Install Nix using the official script (don’t use Homebrew):

   curl -L https://nixos.org/nix/install | sh
       

2. Enable flakes by editing ~/.config/nix/nix.conf and adding:

   experimental-features = nix-command flakes