Rookery - Footnotes

Footnotes

^ This idea’s own first footnote. The idea below has one too, also numbered 1.
^ Ideas carry their footnotes everywhere they appear in the rookery—their hatching context, their standalone page 8, and their windows 9. The only exception to this is where a window on an idea carries a limit which truncates the content.
^ As this one is (Mädje 2022). Look for it in this idea’s References block below, rather than in the footnote itself.

References

Mädje, Laurenz. 2022. “A Programmable Markup Language for Typesetting.” Master's thesis.

A citation belongs to the idea in which you write it, just as footnotes do. Bibliographies, like footnotes, are produced at the end of an idea.

In contrast to footnotes, however, all citations in a rookery draw from a global bibliography that is configured once like so:

#show: rookery.with(bibliography: arguments(
  bytes(read("references.bib")),
  style: "chicago-author-date",
))

You must use bytes(read(...)) rather than a path to pass a reference file, but rookery bibliographies otherwise work the same as Typst bibliographies.

Once a rookery is configured with a bibliography, you can cite as you naturally would in Typst (Mädje 2022). Bibliographies will appear at the bottom of every idea with a citation under a ‘References’ heading.

Citation numbering is rookery-wide, which means that numeric styles will not be scoped to each idea. (An idea with one citation may show it as [7], for example, if it is the 7^th citation in the rookery.) For this reason we recommend using citation styles that don’t employ numbers, such as "author-date".

References

Mädje, Laurenz. 2022. “A Programmable Markup Language for Typesetting.” Master's thesis.

[idea:kodama-rookery]Kodama | Rookery

Kodama is another forester-inspired tool for authoring intellectual junkyards in Typst.

Rookery produces HTML, PDF, and/or EPUB, whereas Kodama renders only HTML.
Kodama does not explicitly support transclusion with windows, idea-scoped footnotes or citations, tags to organize ideas, mobile viewing, or standalone pages for each idea.
Kodama requires a separate binary to compile in addition to Typst, whereas rookery needs only the Typst toolchain (or Rheo as the preferred interface to it).
Kodama allows you to write your notes in either Markdown or Typst, whereas rookery is pure Typst.

[idea:class-reference]HTML class reference

You can also style more granularly with your own CSS using the classes below. A trailing * below stands for a family whose members are named in the description.

Class	What it is
`.idea-box`	An idea’s own block where it was written, carrying the left rule and the padding every rookery block nested inside it measures from.
`.idea-head`, `.idea-tab`	The heading group, and the short top rule the name straddles at the card’s corner.
`.idea`, `.idea-title`	The idea’s heading element—which carries the anchor an `@idea:etal` fragment resolves to—and the title text inside it.
`.idea-label`, `.idea-date`	The `[idea:etal]` permalink and the date beside it, in a heading, a window summary or prose, wherever either is shown.
`.idea-tag`, `.idea-tag-<tag>`	A tag pill in the hat, and one extra class per tag the idea carries. The second reaches every surface that names the tag—the idea’s heading, its box, its outline row, its pill, and a search result’s chip, which JavaScript builds in the browser—so a single rule of your own styles a tag everywhere it shows up.
`.idea-ref`	An `@idea:other` reference in prose. See referencing ideas.
`.idea-window`	A transclusion, wearing the same rule and indent as `.idea-box`; the second class `.idea-window-plain` opts a bare `#idea-body` out of that box.
`.idea-window-*`	The fold: `-details` the `<details>`, `-summary` the row you click, `-title` the name in that row, `-body` what folds away under it. The date beside the title is `.idea-date`, the same class it wears in a heading.
`.idea-window-more*`	The second fold a `limit:` makes inside the body: `.idea-window-more` its `<details>`, `-more-summary` the shown blocks you click to see the rest, and `.idea-window-ellipsis` the `…` at the end of them.
`.idea-outline*`	A page’s outline: `.idea-outline` the list at each level of nesting, `-title` its “Contents” label, `-row` one row per idea.
`.idea-footnote*`	An idea’s own footnotes, carried on every surface it appears on: `.idea-footnotes` the block, `-title` its label, `.idea-footnote-list` and `.idea-footnote` its entries.
`.idea-fn-*`	`-ref` the superscript mark in prose, `-backlink` the way back up to it from the entry.
`.idea-references`, `.idea-page-refs`	The bibliography an idea’s citations draw from, and the page’s own for citations written outside any idea.
`.idea-footer*`	On an idea page: `.idea-footer` the ruled-off apparatus under the note, `-title` the label on each of its sections.
`.idea-context`, `.idea-backlinks`	That footer’s two sections: where the note was written, and the notes pointing at it.
`.idea-page-list`, `.idea-page-row`	A list of pages in either section, and one row in it—a page cannot fold, so it wears a window’s shape without being one.
`.idea-row*`	One row of an `#idea-row` list: `.idea-row` the `<li>`, `-when` its date cell, `-title` the title, `-cell` each extra cell, `-badges` the chip strip at the end. `@rookery/search` and `@rookery/timeline` draw the same row, so a rule of yours here reaches all three.
`.idea-index-count`	The “n ideas” line on the minted index page.
`.idea-dup-warning`	The build-time notice shown when two ideas claim the same name.

Every one of those elements also carries a data-rookery attribute naming the same thing without the prefix—.idea-box is [data-rookery="box"], .idea-window-summary is [data-rookery="window-summary"]—and it is the attribute, not the class, that rookery’s own stylesheet selects on. The two say the same thing, so write whichever reads better in your CSS; the attribute is there because css-prefix moves the classes and nothing should have to follow them to find an element. .idea-window-plain is the one that does not repeat itself: a plain window is [data-rookery="window"] wearing data-rookery-plain besides.

Anything that names a tag—a card, a window, a pill, an outline row, an index row, a badge—carries one more, data-rookery-tags, listing those tag names, minus any made invisible by invisible-tags.

[idea:footnote-reference]#footnote

Rookery’s own #footnote, which shadows Typst’s and scopes a note to the idea it is written in. Import it alongside #idea and write footnotes exactly as before — the single positional argument is the footnote’s body. That import is needed in every file that writes a footnote, since Typst’s imports are per file; an idea body that reaches Typst’s own #footnote instead of rookery’s fails the build, with an error naming the import to add.

#import "@rookery/core:0.1.0": idea, footnote
#idea("etal")[A claim#footnote[The evidence.] worth qualifying.]

Inside an idea, the enclosing idea claims the note, numbers it against itself and lists it in its own Footnotes block — on every surface that idea appears on. Outside one, the rule #show: rookery installs falls back to Typst’s own footnote, so a note in ordinary page prose behaves as it always did. See footnotes for what idea-local numbering means for a page carrying several.