Official code for utilitarianism.net and its translations:

To add a translation, please reach out to us and then follow the recommended instructions.

We are using Hugo to build the base website and a few npm packages and scripts to generate PDFs, add search functionality, etc.

If you're new to coding, see the detailed instructions.

First time:

• Install Hugo (current version is 0.152.2 extended edition)

Any time after:

hugo serve

First time:

• install Node
• install just
• run npm install¹

Any time after:

npm run build

The /public folder now contains all the static files. The /dist folder now has the zip of them all: upload to your webhost, unzip, and you are done 🤩

For more details see instructions/README.md

See instructions/README.md for more useful information about getting started with or working on this project.

A huge thank you to the numerous creators and contributors that make building new things possible, easier, and a pleasure.

Thank you to the libraries without which our website would not be possible or would be less than it is now:

• hugo for building the website HTML
• pagefind for generating the search index
• website2pdf for generating PDFs

Thank you to supporting libraries that make the process of building better:

• theme/ananke for being the starting theme of this Hugo project
• just for handling building scripts
• fdir for the fastest way to crawl a directory
• bestzip for zipping the finished files into one
• serve for previewing the final build
• hugo-cite for making citations easy to work with

This is not a complete list, there are too many others to list 🙇‍♂️