nixos-config/docs/website
2024-09-04 19:46:49 +08:00
..
assets
config/_default docs/website: fix Hugo config 2024-09-04 19:46:49 +08:00
content/en
layouts
static
.gitignore
Gemfile
Gemfile.lock
gemset.nix
go.mod
go.sum
LICENSE
Makefile docs/website: add subproject tasks with Makefile 2024-09-04 19:14:42 +08:00
package.nix docs/website: create package definition 2024-09-04 19:14:14 +08:00
README.adoc
shell.nix docs/website: fix Hugo config 2024-09-04 19:46:49 +08:00

Its the documentation for my project rendered with Hugo and written with Asciidoctor format. There are some things you need to be aware of.

  • This is basically an extended theme using my website. It is built on top of it so every single change will have to be adapted to it including the assets (especially).

  • This heavily uses my own set of Asciidoctor extensions.

  • This uses my custom Asciidoctor templates. Unfortunately, this is not doable with Hugo so it is done primarily with a hack that shadows the original asciidoctor executable with a custom script of the same name.

  • This also uses nixpkgs with their Ruby packaging infrastructure. You can see more details about developing and maintaining them in the respective manual.