tonybtw.com

#+TITLE: tonybtw.com

* About

This is the source for [[https://tonybtw.com][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:

     #+BEGIN_SRC yaml

     ---

     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"

     ---

     #+END_SRC

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

- [[https://nixos.org/download.html][Nix]] installed  

- Flakes enabled (=nix-command flakes=)

* Usage

Clone the repo and enter the development shell:

#+BEGIN_SRC sh

git clone https://github.com/tonybanters/tonybtw.com

cd tonybtw.com

nix develop

#+END_SRC

Inside the shell, run Hugo:

#+BEGIN_SRC sh

hugo serve

#+END_SRC

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

* Alternate dev shell

If you prefer =nix= to start the server automatically:

#+BEGIN_SRC sh

nix develop .#serve

#+END_SRC

This launches =hugo serve= right away.

* Building for production

To generate the static site in =public/=:

#+BEGIN_SRC sh

nix develop --command hugo

#+END_SRC

* 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):  

   #+BEGIN_EXAMPLE

   experimental-features = nix-command flakes

   #+END_EXAMPLE

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:

   #+BEGIN_SRC sh

   sudo pacman -S nix

   #+END_SRC

2. Enable the Nix daemon:

   #+BEGIN_SRC sh

   sudo systemctl enable --now nix-daemon.service

   #+END_SRC

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

   #+BEGIN_EXAMPLE

   experimental-features = nix-command flakes

   #+END_EXAMPLE

** Gentoo

1. Enable the overlay and emerge Nix:

   #+BEGIN_SRC sh

   sudo emerge --ask app-misc/nix

   #+END_SRC

2. Enable the Nix daemon:

   #+BEGIN_SRC sh

   sudo rc-update add nix-daemon default

   sudo rc-service nix-daemon start

   #+END_SRC

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

   #+BEGIN_EXAMPLE

   experimental-features = nix-command flakes

   #+END_EXAMPLE

** macOS

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

   #+BEGIN_SRC sh

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

   #+END_SRC

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

   #+BEGIN_EXAMPLE

   experimental-features = nix-command flakes

   #+END_EXAMPLE