This is a website for scverse.org based on Hugo.

Most of the times, only the content has to be modified. Content is stored as TOML in .md files in /content. To modify the contents of the tutorials page, for example, one has to look inside /content/learn/_index.md.

For style sheets, SCSS is used. Modify /assets/main.scss to change styles.

Modifying layout is only required when pages have to be restuctured or new pages are to be added. Look inside /layout for that. Hugo Templating is used to work with content from /content.

To build the website (with hot reload), install Hugo and Dart Sass (the sass executable must be on your PATH), and run

hugo server -D

Site search is powered by Pagefind, which indexes the built HTML rather than the content files, so hugo server alone has no index and the search dialog will say so. To search on the dev server, build the index into static/ (gitignored, and stale until you rebuild it):

hugo -d /tmp/pagefind-build && npx pagefind --site /tmp/pagefind-build --output-path static/pagefind

Stop hugo server first — a hugo build takes the build lock out from under it.