Reading / Citations & references

Sources

Point at a source from the text with a number, and list the sources where the reader can find them.

Basic usage

Preview

Published an eight-chapter book on expressing states and transitions as Rust types, and took two fixes to async-graphql upstream.1 2 3

Typesafe State in Rust (preview)Zenn Books · 2022.03.08 · An eight-chapter public book on states and transitions as types
async-graphql / PR #1018GitHub PR · 2022.08.18 · Fixes request data lost in resolvers
async-graphql / PR #1049GitHub PR · 2022.09.06 · Primitive type support for CursorType

HTML

<p class="note">Published an eight-chapter book on expressing states and transitions as Rust types, and took two fixes to async-graphql upstream.<a class="cite" href="#src-1">1</a><a class="cite" href="#src-2">2</a><a class="cite" href="#src-3">3</a></p>
<ol class="sources">
  <li id="src-1"><a href="https://zenn.dev/kinzal/books/aa109c0c428089">Typesafe State in Rust (preview)</a><span class="source-meta">Zenn Books · 2022.03.08 · An eight-chapter public book on states and transitions as types</span></li>
  <li id="src-2"><a href="https://github.com/async-graphql/async-graphql/pull/1018">async-graphql / PR #1018</a><span class="source-meta">GitHub PR · 2022.08.18 · Fixes request data lost in resolvers</span></li>
  <li id="src-3"><a href="https://github.com/async-graphql/async-graphql/pull/1049">async-graphql / PR #1049</a><span class="source-meta">GitHub PR · 2022.09.06 · Primitive type support for CursorType</span></li>
</ol>

Printing the addresses once

HTML

<html lang="en" data-dd-paper="a4" data-dd-print-urls="sources">

Classes & attributes

Class / attribute	Purpose
`.cite`	A bracketed number in the running text that links to a source. Write the same number the list shows.
`.sources`	An ordered list of sources, numbered by the list itself. start and value attributes are respected.
`.source-meta`	Where and when: the venue, the date, and a short description under the title.
`--dd-sources-gutter`	Width of the number column. Default 3.25em; widen it for a list past a hundred entries.
`data-dd-print-urls="sources"`	On the root element: print addresses only in the sources list, not after every link in the text. none prints no addresses.

Usage notes

Give each entry an id and link the title to the original. Titles keep the language they were published in; mark it with lang. On paper, each entry spells out its address on a line of its own, so the running text can keep to citation numbers.

Examples follow your system color scheme. Use ◐ in the header to try automatic, light, and dark themes.

Explore variations in Storybook ↗All components →