References and Print Metadata

Hugo References And Print Metadata

References, citations, equations, figures, tables, and print metadata share one principle: Hugo emits the semantic identity before browser preview or PDF export code consumes it.

Citation And Bibliography

Citation rendering starts in Hugo partials and bibliography helpers. Browser editors may preview citations, but they should round-trip the canonical Markdown form and preserve Hugo’s numbering/reference model.

Bibliography rendering and grouping live under layouts/partials/bibliography and related BibLaTeX helpers.

Object References

Local object references such as equations, figures, tables, and sections flow through reference resolution partials. The render hooks emit IDs, labels, and metadata that can be used in normal pages, editor surfaces, TeX output, and browser PDF export.

layouts/partials/print/object-attrs.html centralizes data-ql-print-* attributes for print/export consumers. These attributes should be text-only payloads; rendered caption HTML can contain quotes, KaTeX, citations, or nested markup that does not belong in raw HTML attributes.

Browser PDF and book export code should consume these Hugo-emitted attributes before falling back to DOM inference.

Files To Read

  • layouts/partials/cite.html
  • layouts/partials/ref/resolve.html
  • layouts/partials/print/object-attrs.html
  • layouts/partials/bibliography/*
  • layouts/_default/_markup/render-passthrough.html
  • layouts/_default/_markup/render-image.html
  • layouts/_default/_markup/render-table.html