Modernize site build, model catalog, and content structure - #24
Merged
Conversation
Upgrade Hugo and Docsy, migrate GitHub Pages to artifact deployment, unify containerized local and CI builds, and add BibTeX preprocessing. Clean up obsolete dependencies, configuration, and documentation.
Replace the Hugo module integration with the official Docsy npm package and remove obsolete Go, Python, bibliography, and build shims. Streamline local and CI rendering while preserving site output. Co-authored-by: OpenCode <noreply@opencode.ai>
render the canonical BibTeX collection as a model bibliography and publish it for download. Validate DOI and citation-key synchronization against the coordination model list during builds and development. normalize documentation directories to lowercase kebab-case for consistency and cross-platform compatibility without changing published URLs. Co-authored-by: OpenCode <noreply@opencode.ai>
- redesign navigation, catalog tables, search, and accessibility - lock and validate coordination data before rendering - automate model catalog lock update proposals - support subpath deployments and local frontend dependencies - add taxonomy metadata and a FAIR management plan
Replace the broken custom mermaid.js bundle (js.Build mangled the renderMermaid export) with Docsy's CDN-based mermaid loader pinned to 11.16.1, using securityLevel "loose" so the flowchart click directives work. Remove the now-unused mermaid npm devDependency. Replace the about page stock cover image with the CC BY-SA 4.0 Network Visualization by Martin Grandjean and add the required attribution. Strengthen the cover overlay (darker gradient, radial scrim over the title zone) and add text-shadow on the cover h1 and lead so the title stays readable over the image's bright nodes. Add a lead sentence to the about hero to match the front page and align the image anchor. Make "Responsible computational science practices" a btn-outline-light button on the front page for visual consistency with the other hero actions. Add --renderToMemory --noHTTPCache to the docker-compose hugo server command for faster local dev rebuilds.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Comprehensive refresh of the Making Models FAIR site: modernizes the Hugo/Docsy build pipeline, introduces a synchronized model publication bibliography with catalog lockfile, reorganizes content sections, and overhauls styling, layouts, and accessibility.
Changes
Build & tooling
@docsy/theme) with pinned Hugo version and Docker toolchainMakefiletargets (shell,build,render,bibliography-check) anddocker-composeworkflowModel catalog & bibliography
model-catalog.lock.jsonas immutable coordination source with checksumassets/bibliographies/publications.biband generateddata/publications.jsondata/model_domains.yamlwith reviewed SKOS mappingsContent reorganization
docs/Models/*→docs/models/*(cooperation, crowd-dynamics, ecological-processes, land-use, publications)docs/Process/*→docs/process/*(assessment, how-to)docs/getting-involved/checklistStyling & layouts
_styles_project.scsswith design tokens, card/table/accessibility styles, responsive mermaid sizing_variables_project.scssfor MMF color palettemodel-process(Mermaid FAIR process diagram),model-table,imgproc,featureblockhead.html,head-end.html,taxonomy_terms_cloud, publications list, model-table cellsFAIR stewardship
artifacts/fair/fair-management-plan.mdcanonical stewardship planAGENTS.md,README.md,HUGO_VERSION,.gitignore,.dockerignoreFixes
text-wrap:wraponnode/learnclassDefs) so long labels fit inside boxesValidation
make renderbuilds cleanlymake bibliography-check