Source for https://camml.science/, built with Hugo and the Blowfish theme.
Every push to main rebuilds and publishes the site automatically (see .github/workflows/hugo.yml).
You can make all of the edits below directly in the GitHub web interface.
- Copy an existing folder in
content/members/(e.g.content/members/mattia-ragni/) and rename it tofirstname-lastname. - Edit
index.mdin the new folder: name, role, links and a short bio. The fields are explained inarchetypes/members/index.md. - Add a photo named
photo.jpg(or.png) to the same folder, ideally square and under 1 MB. It's cropped to a circle; if your head gets cut off, setphoto_anchor: "Top". Without a photo, your initials are shown.
When someone leaves, set status: "alumni", fill in end: (year) and optionally now: (where they went). They move to the Alumni list automatically.
Add an entry to data/collaborators.yaml with their name and affiliation, and optionally a one-sentence description and a url. They appear in the Collaborators section of the People page, in the order listed.
- Copy
content/codes/tensorial/to a new folder named after the code, e.g.content/codes/mycode/. - Edit
index.md: name, one-sentencesummary(shown on the Codes page),tags,installcommand, licence and links, then a longer description below the---. The fields are explained inarchetypes/codes/index.md. - Optionally add a square logo named
logo.svg(or.png). Without one, the first letter of the name is shown.
The Publications page is currently hidden. To publish it, delete the draft: true line in content/publications/_index.md and uncomment the Publications entry in config/_default/menus.en.toml.
Add an entry to data/publications.yaml (the format is described at the top of that file). Papers are grouped by year, and names that match a member page are shown in bold.
- Home page:
content/_index.md - Research:
content/research/_index.md - Menu:
config/_default/menus.en.toml - Colours and custom styles:
assets/css/custom.css - Logo:
assets/img/camml-logo.svg(web version). The editable Inkscape original is indesign/. If you change it, re-export withinkscape design/camml-logo.inkscape.svg --export-plain-svg --export-text-to-path --export-filename=assets/img/camml-logo.svgafter deleting the hidden tracing image layer. Favicons instatic/are made fromdesign/camml-icon.svg.
git clone --recurse-submodules https://github.com/camml-lab/camml-lab.github.io.git
cd camml-lab.github.io
hugo server # then open http://localhost:1313Needs Hugo extended between 0.164 and 0.167 (the range supported by Blowfish v3.9; the site is built with 0.167.0).
Ubuntu's packaged Hugo is usually too old: install the .deb from the Hugo releases page instead.
With a local Hugo you can also run hugo new members/jane-doe to create a new member folder from the template.
Every push and pull request runs .github/workflows/checks.yml, which checks member pages, code pages and data/publications.yaml
for common mistakes (wrong status, malformed DOIs, oversized photos...) and builds the site with warnings treated as errors.
To run the same checks on your machine before each commit:
pipx install pre-commit # or: uv tool install pre-commit
pre-commit install # once per clone
pre-commit run --all-files # run everything by handUpgrade them together: Blowfish declares which Hugo versions it supports in themes/blowfish/config.toml ([module.hugoVersion]).
cd themes/blowfish && git fetch --tags && git checkout vX.Y.Z && cd ../..Then set HUGO_VERSION in both .github/workflows/hugo.yml and checks.yml, and run pre-commit run --all-files.
GitHub Actions versions are kept up to date by Dependabot.