Skip to content

Add structured publications rendering pipeline#498

Open
tati-micheletti wants to merge 5 commits into
openmodelingfoundation:developfrom
tati-micheletti:feature/publications-bibliography
Open

Add structured publications rendering pipeline#498
tati-micheletti wants to merge 5 commits into
openmodelingfoundation:developfrom
tati-micheletti:feature/publications-bibliography

Conversation

@tati-micheletti
Copy link
Copy Markdown

This PR introduces a lightweight structured publications workflow for OMF resources.

Key changes:

Adds publications.bib as the canonical bibliography source
Adds CSL-JSON export for Hugo-compatible structured rendering
Adds reusable Hugo partial for publication rendering
Dynamically injects publications into the Awesome Modeling Practices page
Provides downloadable bibliography source for reuse in reference managers

The implementation intentionally keeps scope minimal:

no CSL citation styling engine
no search/filtering
no advanced bibliography infrastructure

This follows the architecture direction discussed in the previous review conversation while avoiding duplicated maintenance across repositories.

@cmbarton
Copy link
Copy Markdown
Contributor

Once this is merged and I can see it formatted, I'll see if I should add anything.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds a lightweight, structured publications workflow to the Hugo site by introducing a canonical bibliography source, a CSL-JSON data export for rendering, and Hugo templates/partials to display publications (including intended injection into the “Awesome Modeling Practices” page).

Changes:

  • Adds a new Publications page layout and a reusable publications-list partial to render entries from data/publications.json.
  • Updates the Awesome Modeling Practices rendering pipeline to (intended) inject a publications list via a placeholder token.
  • Adds bibliography source files: assets/publications/publications.bib (BibTeX) and data/publications.json (CSL-JSON).

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
layouts/resources/publications.html New Publications page template with a download link and list rendering
layouts/partials/publications-list.html New partial to render CSL-JSON publications into HTML
layouts/docs/awesome-list.html Attempts to inject rendered publications list into remote-rendered Awesome list content
data/publications.json Adds CSL-JSON publication records consumed by Hugo site.Data
content/en/resources/publications.md Switches Publications content to use the new publications layout and dynamic messaging
assets/publications/publications.bib Adds BibTeX bibliography source intended for download/reuse

Comment thread layouts/docs/publications.html
Comment thread layouts/docs/awesome-list.html Outdated
{{ $html := $content | markdownify }}

{{ $pubs := partial "publications-list.html" . }}
{{ $content = replace $content "<p>OMF_PUBLICATIONS_LIST</p>" $pubs }}
@alee alee force-pushed the feature/publications-bibliography branch from a7b3129 to ea618d5 Compare May 22, 2026 07:24
Copy link
Copy Markdown
Member

@alee alee left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thanks for pushing this forward @tati-micheletti !

tati-micheletti and others added 5 commits May 22, 2026 12:47
- Setup Hugo parsing for CSL-JSON fields
- fix missing index from code `{{ index . "container-title" }}`
simplify awesome-list.html and extract hairy regex rewrites and
sanitization into the `render-remote-readme` partial
@alee alee force-pushed the feature/publications-bibliography branch from 6e83dbe to 388bebb Compare May 22, 2026 19:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants