httk Spacegroup Data Explorer (Hugo)

This repository is a Hugo site that replaces the old static website.

Prerequisites

• Hugo (extended version recommended)

Run locally

Start a local development server with live reload:

make serve

Then open http://localhost:1313.

Build the site

Generate the content pages and production-ready static site:

make build

By default, Hugo writes the generated files to public/.

Run make ci to build and check all Hall and point-group pages, retained subgroup embeddings, exact setting maps, local links, and redirect aliases against the copied datasets. These checks use only the Python standard library. The deployment workflow runs the same content checks after its Hugo build.

With Playwright and its Firefox browser installed, run python3 scripts/check_browser.py http://localhost:1313 against make serve to check interactive navigation, both data-loading paths, symbols, and URL state.

Project layout

• static/data/symmetry_basics.json.gz: current space-group and point-group basics dataset
• static/data/transformations_hm_entry.json.gz: H-M-entry keyed transformations used by the detail pages
• static/data/transformations_std.json.gz: IT-standard transformations provided as a download; detail pages use the setting-specific file above
• static/data/spacegroup_index.json.gz: generated lightweight browser index derived from symmetry_basics.json.gz
• static/data/pointgroup_index.json.gz: generated lightweight browser index derived from symmetry_basics.json.gz
• content/_index.md: homepage content
• content/hall/*.md: generated content file per Hall setting (detail pages)
• layouts/: Hugo templates for list/detail rendering
• static/: JS/CSS assets copied directly into the generated site