Documentation

    Hosted installer: at launch

    The elements gallery

    Type, pictures, players and every block, working together on one page.

    Charts have their own long scrolling gallery. Here you can inspect everything around them: type, photographs, tables, metrics, callouts, audio, video, embeds and scrollytelling. The examples are live below. The block tour source and local files let you reuse the complete bundle.

    Typography in each style

    Each sample is a real report rendered in a builtin style. Open it to read the complete hierarchy, body text, numbers and elements in that treatment. The report keeps its own fonts inside the preview.

    Reading text, code and mathematics

    An explanation can use strong emphasis, italics, a source link, literal code and footnotes.1 Use headings to express the argument, a short list for parallel points and a quotation when the speaker matters.

    That’s one small step for man, one giant leap for mankind.

    — Neil Armstrong, Apollo 11, 21 July 1969 UTC; NASA Historical Sounds.

    An equation can name an estimate, p^, and keep the assumptions beside it. The standard-error example at the end of this gallery shows a complete formula.

    Credited header pictures and image blocks

    The report gallery uses credited Unsplash header photographs in every style. The same credit mapping works in an image block. This photograph is a hotlink; the box, alt text and credit stay when the network is unavailable.

    Golden grain in a field
    Golden grain in a field, photographed by Sarah Mason.

    Photo by Sarah Mason on Unsplash

    Every rich block

    The following report uses Nightingale’s historical observations, her original public-domain diagram and NASA Apollo 11 audio and video. The source keeps captions and a transcript beside the players. External embeds remain dependent on their destination.

    A report can place the observations beside their interpretation, an original document and a recording. Here the local media travels with the exported HTML; the external embed keeps its own availability.

    Make the evidence inspectable

    8.4
    Annualized deaths per 1,000, April 1854

    Mortality varied through the first three recorded months

    Source: Nightingale’s mortality record, April–June 1854; each displayed annualized rate sums the causes for that month.

    The rates behind the chart, 1854
    MonthAnnualized deaths per 1,000
    Apr8.4
    May10.8
    Jun7.2

    Source: Florence Nightingale’s Crimean War mortality record, via HistData. The displayed rates sum preventable disease, wounds and other causes in each of the first three months. They are annualized rates, not monthly death counts. The April metric is authored from the same observations.

    The original document

    Florence Nightingale's 1858 diagram, with two circles of monthly mortality wedges and an explanatory legend.
    Florence Nightingale, Diagram of the causes of mortality in the army in the East, 1858. Public domain; David Rumsey Map Collection, via Wikimedia Commons.

    The Areas of the blue, red, & black wedges are each measured from the centre as the common vertex.

    — Florence Nightingale, the diagram’s legend (1858), original image and credits.

    A recording gives a primary source a voice

    Apollo 11, 21 July 1969 UTC. NASA Historical Sounds; public-domain mission recording.
    Transcript

    Neil Armstrong, Apollo 11, 21 July 1969 UTC: “That’s one small step for man, one giant leap for mankind.” Source: NASA Historical Sounds, https://www.nasa.gov/historical-sounds/. The intended article “a” is not clearly audible in the recording.

    Audio · Apollo 11, 21 July 1969 UTC. NASA Historical Sounds; public-domain mission recording. · gallery/blocks/media/apollo-step.mp3

    A 12-second silent excerpt from NASA's Apollo 11 television archive. QuickTime digitization credited to Gerald Megason; public domain.
    Transcript

    Silent archival excerpt: a television view of Neil Armstrong beside the Apollo 11 lunar module ladder on the Moon. The image is grainy and high contrast. This 12-second excerpt begins 37 seconds into NASA’s a11.v1092338.mov; its soundtrack is omitted. NASA Apollo Lunar Surface Journal lists the video as public domain, with QuickTime digitization credited to Gerald Megason. Source: https://www.nasa.gov/wp-content/uploads/static/history/alsj/a11/video11.html.

    Beside the lunar module ladder
    A 12-second silent excerpt from NASA's Apollo 11 television archive. QuickTime digitization credited to Gerald Megason; public domain.

    Video · gallery/blocks/media/apollo-step.mp4

    Transcript

    Silent archival excerpt: a television view of Neil Armstrong beside the Apollo 11 lunar module ladder on the Moon. The image is grainy and high contrast. This 12-second excerpt begins 37 seconds into NASA’s a11.v1092338.mov; its soundtrack is omitted. NASA Apollo Lunar Surface Journal lists the video as public domain, with QuickTime digitization credited to Gerald Megason. Source: https://www.nasa.gov/wp-content/uploads/static/history/alsj/a11/video11.html.

    The NASA audio collection supplies the recording; the Apollo Lunar Surface Journal video library supplies the film and its public-domain notice. The silent film excerpt starts 37 seconds into a11.v1092338.mov; its original soundtrack is omitted. Captions describe the silent scene; the audio player has its own transcript.

    An external embed

    Big Buck Bunny, Blender Foundation (2008), CC BY 3.0. The external player remains network-dependent.

    www.youtube-nocookie.com

    Open www.youtube-nocookie.com

    Embedded page · Big Buck Bunny, Blender Foundation (2008), CC BY 3.0. The external player remains network-dependent. · https://www.youtube-nocookie.com/embed/aqz-KE-bpKQ

    Guide attention across the original diagram

    Nightingale's original two-period mortality diagram.
    1. Nightingale's original two-period mortality diagram.

      Two periods, one unit

      Begin with both circles. Each compares causes of mortality through an April-to-March year.

    2. Nightingale's original two-period mortality diagram.

      The first winter

      Focus on the larger right-hand diagram. Its blue area records deaths from preventable disease; the printed legend explains that the wedges encode area.

    A formula needs its assumptions

    For an independent Bernoulli sample, the estimated standard error of a sample proportion is

    SE(p^)=p^(1-p^)n

    Here n is the sample size and p^ the observed proportion. It is an estimate under a sampling model, not a formula for Nightingale’s annualized rates.

    Notes

    1. A footnote keeps a useful qualification within reach.
    Was this page useful? Suggest an edit