dmsimonov / haozeke.github.io

My org-mode site for quick write-ups

About

• This is a standard landing page and blog for my miscellaneous thoughts and essentially links out to all my other work.
• The theme is based off this theme
• The rest of the site is configured to work well with doom-emacs, so it uses ox-hugo

Running Locally

This site uses modular Hugo themes so:

git submodule update --init

After the dependencies are set up below the site can be built and served with rake tasks. Hugo is also expected.

$ rake --tasks
rake clean            # Clean the generated content
rake getPandoc        # Install pandoc
rake hugoBuild        # Build site with Hugo
rake hugoServe[port]  # Serve site with Hugo
rake md               # Orgmode to markdown with Emacs

With Nix

Enter the shell with nix-shell and use a rake task!

Updating Expressions

This typically involves the following:

# Optional, in ~/.config/nix/nix.conf or darwin-configuration.nix
  nix.package = pkgs.nixUnstable;
  nix.extraOptions = ''
    experimental-features = nix-command flakes
  '';

Updating the ruby packages:

# Wit nix shell (v2.4 and up)
nix shell nixpkgs#bundix -c bundix -l
# Without
nix-shell -p bundix --run "bundix -l"

Similarly, the node packages are to be generated with:

nix shell nixpkgs#nodePackages.node2nix -c node2nix -c node.nix

With the updates done globally:

npm install -g npm-check-updates
ncu -u # Might break!

Without Nix

Conda Environments

Most of the dependencies can be setup via micromamba or another equivalent. The exceptions are:

• Hugo (the extended release)
• Dart Sass
• Emacs (28.2)

Ruby

Track the ruby dependencies with rbenv and ruby-build:

git clone https://github.com/rbenv/rbenv.git ~/.rbenv
cd ~/.rbenv && src/configure && make -C src
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.zshrc

Then use them:

rbenv install 3.2.2
eval "$(rbenv init -)"
gem install bundler
bundle

Fix snippets not being part of the sitemap