Writing for print

#The printed document

An internote can be saved as a printed document from its editor. The text of every scene is set in order, one after another, and each scene's canvas follows its text as a figure. Nothing is written twice: the same source makes the screen and the page.

#Designs

A printed internote is set in one of these designs:

• Academic article — serif, justified, numbered sections and figures, and an abstract under the title.
• Academic report — a title page, then the academic article's text.
• Basic article — sans, left-aligned, the title heading the first page.
• Basic report — a title page, then the basic article's text.
• Organisation article and Organisation report — the organisation's mark, with the title and headings in its site's accent.

The organisation designs are offered for an internote an organisation authored; without a site, they carry the mark and no colour. The document header's title and description open the document: the description is set as an abstract in the academic designs and as a standfirst in the others.

#The narrative on the page

Every block of the narrative prints, the text of every step included: on the page, a scene is read whole. The headings are numbered 1, 1.1, 1.1.1 where the design numbers them, and definitions, theorems and the other callouts keep their numbers. A {{…}} expression prints its value as the finished canvas has it.

#What is left out

• A question or a quiz does not print: on paper there is nothing to answer it with.
• An internote block does not print, and an inline !internote prints as the referenced internote's title, in italics.
• A canvas prints still: a slider is drawn at its starting value, and nothing on a figure can be hovered or opened.

#Canvases as figures

A scene's canvas prints after its text, the width of the text and at the same scale as every other figure, so a graph's labels sit at the size of the words around them.

#The finished picture

Unless the scene says otherwise, a figure is the canvas finished: every cue in, nothing dimmed by a cue.spotlight or marked by a !cue.highlight, and every !cue.to at the value it ends on.

#A chosen moment with print-at

Where the point of a scene is a moment part way through — a value before it moves, a picture before its last mark arrives — the scene's print-at attribute names it, as an anchor is written. The figure is then the canvas as a reader would see it at that moment, cues and emphasis included.

scene{
    The parabola crosses zero at the square root of two.

    ===

    A first guess at 1.5 draws its tangent, and the tangent's root is the next guess.

    ===

    The tangent lands at 1.4167, already within a few thousandths of the root.
}[
    graph{
        curve(expression: x^2 - 2; colour: blue)
        cue{
            curve(expression: 3 * x - 4.25; colour: orange)
        }(
            in: 2
        )
    }
](
    print-at: 2 + 1s
)

#Captions from titles

A figure's caption is its canvas's title: the title of a lone environment or table is moved out of the drawing and set under it, in the page's type. The academic designs number the captions Figure 1, Figure 2. A canvas with no title prints without words under it.

#Citations, footnotes and references

Each !cite prints in the chosen citation style — Internote's numbers, or Harvard's and APA's author and year — and the sources are listed in that style under References at the end. Each !footnote becomes a numbered note, and the notes are listed together under Notes, before the references.

#Pages, contents and the foot

Pages break where the text runs out, and also, as chosen, before every scene, before every Heading 1, or before every Heading 1 and Heading 2; the reports start at every Heading 1. A heading is never left at the foot of a page, and a figure or a callout is never split across two.

A table of contents lists the headings, to the depth chosen, each with its page; a report gives it a page of its own after the title page, and an article sets it under the title. Every page's foot can carry the title, the authors, the date and the page number, and a watermark — Draft, For review, Confidential and others — can be set across every page.

#Writing for screen and page

• Give each canvas a title that says what it shows. On the page it is the caption, and the only words a reader has for the figure.
• Write prose that holds without the motion. A sentence that leans on something arriving — “watch the curve bend” — reads oddly beside a still figure; one that names what the canvas shows reads the same both ways.
• Use print-at wherever the finished canvas would say something other than the scene's text: a figure that shows every stage at once, or a value the text describes before it moves.
• Write headings a reader can find their way by. On the page they are the table of contents and, under a report's page breaks, where each page starts.
• Keep what a question teaches in the prose around it. The question does not print, so a point made only in its feedback is lost on paper.