This guide is for editors and community members who want to add or update content on sbolstandard.org. You do not need to know Hugo, SCSS, or any programming language — all content is written in plain Markdown with a short block of structured data at the top.
- A GitHub account
- Basic familiarity with editing files on GitHub (or cloning a repo locally)
Installing Hugo and running the site locally allows you to preview changes before submitting. See the main README for local setup instructions.
- Fork the repository on GitHub.
- Create a branch for your change (e.g.
add-pysbol-library). - Edit or add files following the relevant guide below.
- Open a Pull Request against
master. An editor will review and merge it.
If you spot a problem but don't want to fix it yourself, open an issue instead.
Each guide below covers one type of content, with step-by-step instructions and a real example from the repo.
| What you want to add or change | Guide |
|---|---|
| News announcement or event notice | Announcements |
| Blog post | Blog Posts |
| Software library | Libraries |
| Application or tool | Applications |
| GenAI tool or AI resource | GenAI Tools |
| Image in the Visual Gallery | Visual Gallery |
| Person on the Leadership page | Leadership |
| Publication | Publications |
- Never put HTML, CSS, or JavaScript inside Markdown files. All content files should contain only front matter (the
---block at the top) and plain Markdown text. Styling and layout are handled by the templates. - Follow the folder structure exactly. Each content type lives in a specific place; the guides show you where.
- Use the existing entries as your template. Every guide links to a real example in the repo.
- Images go in the same folder as the content file — not in
static/or anywhere else.
Ask on Slack or open a GitHub issue.