monograph

A scholarly monograph — sustained, single-author argument on a focused topic with a working citation system. Royal-octavo trim, classical typography (EB Garamond by default with Garamond and Georgia fall-backs), three-deep TOC, roman-numeralled front matter, inline [@key] cites, and a back-matter bibliography formatted by citestyle in any of nine styles. Same @unipress/book foundation as the book and report templates, configured for academic press conventions.

Scaffold

unipress create my-monograph --template monograph --title "On X" --author "Jane Doe"
cd my-monograph
unipress compile . --format pdf --out my-monograph.pdf

The starter ships a small Victorian-naturalist bibliography (nine entries — Darwin, Wallace, Lyell, Mendel, Huxley, Hooker, Spencer) and a chapter that exercises every inline-cite shape. Compile out of the box and read the result alongside the markdown source to see what each shape produces.

What you get

my-monograph/
├── document.yml              pinned to @unipress/book@<version>; royal-octavo, EB Garamond
├── records/
│   └── bibliography/
│       └── refs.bib          BibTeX file — every @entry is one record
├── content/
│   ├── 01-preface.md         type: BackMatter
│   ├── 02-introduction.md    type: Chapter
│   ├── 03-chapter-one.md     type: Chapter (worked cite example)
│   └── 99-bibliography.md    type: Bibliography (back-matter list)
└── README.md

When to pick monograph over book

• You need cited bibliographic references in your prose.
• You want section numbering deeper than two levels (default tocDepth: 3).
• You want classical book typography (EB Garamond) rather than the foundation's default sans/serif fall-back.
• You want a slightly larger page (royal-octavo, 6.14×9.21in) common in academic hardcovers.

For trade-paperback fiction or non-fiction prose, use book instead. For a technical report with tables and code, use report.

Citations

The citation system has three pieces: a style declared in document.yml, a query over bibliography records, and inline cites in the prose that reference those records by key.

Pick a style

Set book.citationStyle: in document.yml. Nine styles ship statically wired — switch the document's whole bibliographic apparatus by changing one value:

Numbered styles (IEEE, Vancouver, Nature, Science, AMA) reuse the same numbering across inline cites and the back-matter list — [1] inline matches [1] in the back-matter.

Optional sort: book.bibliography.sortBy: — author (default), year, or collection-order.

Author bibliography entries

Drop a .bib file into records/bibliography/. Every @entry{key, ...} becomes one record; the BibTeX cite key is the entry id you reference from prose with [@key]. Standard BibTeX entry types work (@article, @book, @incollection, @inproceedings, @phdthesis, @techreport, @misc, etc.); LaTeX accents (\"u, \'e, \v{c}) are converted to Unicode automatically.

% records/bibliography/refs.bib

@book{darwin1859,
  author    = {Darwin, Charles},
  title     = {On the Origin of Species},
  publisher = {John Murray},
  address   = {London},
  year      = {1859}
}

@article{wallace1858,
  author  = {Wallace, Alfred Russel},
  title   = {On the Tendency of Varieties to Depart Indefinitely from the Original Type},
  journal = {Journal of the Proceedings of the Linnean Society of London. Zoology},
  volume  = {3},
  number  = {9},
  pages   = {53--62},
  year    = {1858}
}

If a record needs a CSL field BibTeX can't carry — multi-script titles, fine-grained date parts, fielded notes — drop a hand-written YAML file (CSL-JSON shape) into the same folder. The loader merges every .bib, .yml, and .json it finds, so authors can mix the format their reference manager exports with one-off hand-edited entries.

# records/bibliography/wallace1858.yml — full CSL-JSON, overrides if a duplicate
# cite key exists in any .bib file in the same folder.
id: wallace1858
type: article-journal
author:
  - family: Wallace
    given: Alfred Russel
title: "On the Tendency of Varieties to Depart Indefinitely from the Original Type"
container-title: "Journal of the Proceedings of the Linnean Society of London. Zoology"
volume: 3
issue: 9
page: 53-62
issued:
  date-parts: [[1858]]

Common entry types

The full CSL 1.0.2 type list is at docs.citationstyles.org. The foundation passes type: through to citestyle unchanged; any valid CSL type works.

Common fields

Cite in prose

Inline citations use a Pandoc-style sugar that compiles to an inline inset. Five shapes cover the full range:

The locator can be page=42, chapter=3, section=2.1, paragraph=12, etc. Set label=<kind> to label it explicitly: [@darwin1859]{locator=2 label=chapter} renders as (Darwin 1859, chap. 2) in styles that abbreviate the label.

Multi-cite clusters collapse per the active style's rules. In chicago-author-date, two cites by the same author share the author and join their years with a comma: [@darwin1859; @darwin1871] renders as (Darwin 1859, 1871).

The [@key] shorthand desugars to [@key](@Cite){k=v} — the framework's textual inline-inset form. You can also call other inline insets directly with the same [text](@Component){k=v} syntax (see the foundation README).

The back-matter bibliography

content/99-bibliography.md is a one-line back-matter section that lists every record from the collection in style-correct order:

---
type: Bibliography
title: References
query: bibliography
---

query: bibliography fetches the query of that name declared under queries: in document.yml, and the section receives its records as content.data.bibliography. For numbered styles the entries appear in citation-encounter order; for author-date styles they're alphabetical by author then year.

For collections of references that don't all need to ride together — say, a list of "further reading" separate from the main bibliography — declare a second query in document.yml and bind it to a second Bibliography section with fetch: { query: <other-name>, as: bibliography } and an optional style: <override>.

document.yml fields

Same shape as book (see book). The defaults differ:

Common customizations

• Switch citation style by changing one line: book.citationStyle: ieee (or any of the nine styles above). Re-compile; every cite and the back-matter list re-formats to match.
• Add a "further reading" section by declaring a second query in document.yml (further-reading: under queries:, its records in records/further-reading/) and a second Bibliography content file with fetch: { query: further-reading, as: bibliography }.
• Drop the citations entirely by deleting 99-bibliography.md, the records/bibliography/ directory, the queries: block, and the book.citationStyle: block. The remaining template behaves like a citation-free book with monograph typography.

Foundation reference

@unipress/book — see foundations/book/README.md for the full list of foundation knobs and foundations/book/CHANGELOG.md for the version history.