Skip to content

0.29.0

Choose a tag to compare

@github-actions github-actions released this 10 Nov 12:26
· 72 commits to main since this release

Seven roadmap features: study tape (#10), charts from table data (#244), figure captions and numbering (#248), an advanced calculator (#182), strike-through as logical deletion (#96), Zettelkasten card templates (Z9) and Zettelkasten hygiene (Z10), plus table statistics (part of #295, still partial: no chart regression line) and redaction hardening for undo and redo, page geometry and merges. The notebook format moves to version 27 (study tape): the migration from version 26 is automatic, and Notebook 0.28 and older open a v27 notebook read-only and never overwrite it. Four review rounds are folded in (see Review fixes).

studytape

  • Study tape (#10) and document format 27. Study tape (All actions, command palette) turns on a mode where a drag with the pen, the mouse or a drawing finger lays an opaque strip over part of the page (one undo step), in the colour chosen in Settings > Study > Study tape colour (mint, sky, rose, sand or slate). Tap a tape to reveal what it covers (only a faint tint and a dashed outline stay), tap again to cover it. This works with the mode off too: with the pen, with a finger that pans, and on a read-only notebook.
  • Reveal is for this screen only. Whether a tape is revealed is never saved, synced or undone: every tape is covered again when the notebook opens. Reveal all study tapes and Hide all study tapes act on every tape of the notebook.
  • Nothing hides behind a tape by accident. A pen stroke that starts on a hidden tape writes nothing; the erasers leave the ink and objects a hidden tape covers alone (see Review fixes). Tapes select, move, resize, turn a quarter turn, group, lock and delete like other elements; a locked page takes no new tape but its tapes still reveal.
  • Exports. PDF, PNG, SVG, interactive HTML, thumbnails and Copy as image draw every tape covering, as the notebook opens. A clean copy and Hand in leave the tapes out. Redaction cuts a tape around a black box, so nothing redacted can show and the box is never under a tape.
  • Document format v27. One more element type, tape (x, y, width, height 4 to 20000 pt, color; the usual group/locked/lockAt). Migration 26 → 27 is the identity plus the version (a v26 file holding a tape is refused, like any element type before its version); older plugins open a v27 notebook read-only. JSON Schema docs/schema/notebook-v27.schema.json.
  • Code. src/model/tape.ts (geometry, reveal state), src/ink/tape-render.ts (look), src/ink/tape-guard.ts (what the erasers leave alone), src/view/tape-tools.ts (the mode and the taps). Tests tests/model-v27.test.ts; harness doc=studytape.

figcaptions

  • Figure captions and references that update themselves (#248). Select a picture (or a figure cut-out) and choose Caption figure… in All actions: a text box under it reads "Fig. 3 — your words". Numbers follow the reading order of the whole notebook (page order, then top to bottom, left to right) and renumber at once when a captioned figure is added, removed or moved, or pages are reordered. Figure reference… puts a "Fig. 3" text box on the page that always shows the figure's current number; tapping it (finger tap, Ctrl/Cmd+click or Open link) goes to the figure. A reference to a deleted figure (or one that lost its caption) reads "Fig. ?", dimmed and dashed. The Figures gallery shows each captioned figure's number and offers Caption… and Insert reference on its card.
  • No format change. A caption is a text box starting with {{figcap:<picture id>}}, a reference holds {{figref:<picture id>}}; the number is resolved when the text is shown (like a wikilink's label) on the page, in thumbnails, in the PDF, SVG, PNG and print exports, the Markdown export, the companion note and the API's PDF. The stored text never changes. It uses the existing add and replace commands, so history, per-page undo and the history panel need nothing new.
  • Code. src/ink/figure-text.ts (markers and the registry of number sources), src/model/figure-captions.ts (pure numbering and the boxes the actions build), src/view/figure-captions.ts (the cached numbers of an open notebook, the caption dialog and the picker); shownText in src/ink/wikilink.ts is the single place that resolves markers. English and Italian texts, long-press help, context ranking. Tests tests/figure-captions.test.ts; harness doc=figcaptions. Not verified on Android hardware.

strikedelete

  • Strike-through as logical deletion (#96). A roughly horizontal line drawn through the middle of a handwritten word marks that word as deleted. By default nothing changes: the word stays on the page, readable and struck through. Hide struck words (Settings > Reading, the All actions sheet, the command palette) hides the struck words and their lines in the view; switch it off and they are back.
  • Nothing is stored, nothing is deleted. The struck state is derived from the geometry of the ink every time (no change to the document format): undo of the line un-strikes the word, erasing the line brings the word back. A line under or over a word, the bar of a t or an A, a hyphen, a diagonal, a scribble and a line across a different line of text do not count; a long line over several words of one line strikes them all; a crossed-out single letter counts. Highlighter, marker, shape and invisible ink are never strike lines.
  • Hidden means out of reach, not erased. While hidden, struck ink is not drawn and the eraser, the lasso and the other ink tools skip it, so touching empty paper never deletes it. It is still in the file, in undo and in the page counts.
  • Exports. Leave out struck-out words in the export dialog (off by default, with or without Clean copy; the setting Leave out struck-out words from exports decides where it starts, and the share sheet follows the setting) goes through the clean export filter, so PDF, SVG, HTML, PNG images and print all honour it. The notebook is not changed.
  • Cheap. Detection runs only while the setting is on, a moment after a change, one page per idle slice and never while the pen writes; the renderer only reads a per-page cache. A page without a long straight stroke costs one pass over its points. Searches and the heading index do not ignore struck words yet.
  • Code. Pure src/ink/strikethrough.ts (reads strokes with segmentText, StrikeCache), src/view/strike-hide.ts, CleanExportOptions.struck, Renderer.setStruckInk, settings hideStruck and exportHideStruck, the action toggle-hide-struck. 19 new unit tests; harness doc=strikedelete.

charts

  • Charts from table data (#244). Select a hand-drawn table (alone, or together with the text boxes in its cells) and choose Chart from table in All actions (or the command Chart: make from the selected table). The dialog asks for bars, a line or a pie, an optional title, the first colour of the palette and the size, shows a picture of the chart and what it read, and draws the chart beside the table (below it, else to the right, else above) as ONE undo step. A chart is ordinary content: vector shape strokes (frame, grid lines, filled bars and wedges, lines, dots) and text boxes (title, axis labels, legend) of one group, so every render and export path draws it, and it moves, resizes, restyles, copies and erases like any group. No change to the document format.
  • What is read. The first column names the rows, every other column is a series (bars and lines: up to eight; a pie: the first one); the first row is the names of the series when none of its cells is a number. Cells are the text boxes (and typeset equations that are just a number) whose anchor lies in a cell. Handwriting is not read: the plugin has no handwriting recognition, so the numbers are typed in text boxes. A decimal comma, thousands separators, a minus sign, percent and currency signs are understood; empty and non-numeric cells are left out (and counted in the dialog); a pie ignores zero and negative values and joins the smallest slices beyond twelve.
  • Update chart. With a chart selected, Update chart reads its table again and redraws the chart in the same place, in ONE undo step, keeping the type, the colour, the position and size and an edited title. It says so when nothing changed, and is refused (with a reason) on a locked page, for locked or drawing-state parts, when the table is gone or holds no numbers. The link to the table is the chart's group id (nbc1.<type><colour><titled>.<table group>.<random>, read leniently), so nothing is stored outside the page; a copied chart gets a fresh group id and is a plain picture. The update is explicit, not automatic.
  • Code. src/math/chart-layout.ts (number parsing, data from cells, axis ticks, pie slices, layout; pure), src/ink/table-data.ts (text in the cells of a table), src/ink/chart.ts (strokes and text boxes, group id, insert and update plans), src/view/chart-dialog.ts, chart-logic.ts, chart-tools.ts. Only existing History commands are used (one Batch per step), so nothing new to classify for per-page undo. Tests: tests/chart-layout.test.ts, tests/chart.test.ts, tests/chart-actions.test.ts; harness doc=charts.

stats

  • Statistics from a table (#295). With a hand-drawn table selected, Table statistics (All actions) opens a card with the count, mean, median, standard deviation, minimum, maximum and sum of a column and, with a second column chosen, the fitted line (slope, intercept, R squared). Insert as text adds a text box beside the table (or under it when the page is narrow) as one undo step; Copy puts the same text on the clipboard. Numbers are read from the text boxes written in the cells (decimal point or comma, a header row is recognised); cells that are not numbers are skipped and counted, handwriting is not read. No format change. Code: src/math/stats.ts, src/ink/table-numbers.ts, src/ink/table-report.ts, src/view/table-stats.ts.

calculator

  • Advanced calculator (#182). All actions › Insert › Calculator (command Open the calculator) opens a dialog on the shared modal shell: an expression line, a large answer, a 5 × 5 pad of big keys (48 px and more, pen and finger), tabs of function, unit, constant, list/matrix and "more" keys, a tape of the lines worked out and the variables as chips. A selected text box loads its first line. The maths is pure and offline (src/math/calc*.ts): the same hand-written, eval-free approach as the graph parser (no eval, no Function, no property access by name; a step and time budget per line; bounded sizes).
  • Exact numbers. Integers and fractions are exact (BigInt, at most about 450 digits): 1/3 + 1/6 is 1/2 with ≈ 0.5 beside it, decimals typed are exact too (0.1 + 0.2 is 0.3, not 0.30000000000000004), 20! and 2^100 show every digit, perfect roots stay exact. Anything transcendental is a double shown to 12 significant figures.
  • Units. 3 km/h to m/s, 3 km + 200 m, 2 kg * 9.8 m/s^2 (shown as 19.6 N), SI prefixes, length, mass, time, area, volume, pressure, energy, power, speed, temperature (degC, degF), angles (deg, rad, grad, turn); a mismatch (3 m + 2 s, 3 m to s) is refused with both unit names. Constants by name (c, g, h, hbar, G, NA, kB, R, qe, me, mp, mn, eps0, mu0, a0…) carry their units; the table (calc-constants.ts) is the one the reference sheets (#181) will read. After a number g and h read as gram and hour; alone they are the constants (m * g, 5 kg * g).
  • Variables and functions. a = 3.2, then a * 2; f(x) = a * x, then f(5); ans is the last answer. Kept per notebook, on this device only (device local storage, bounded: 64 names, 30 notebooks), read back leniently. Nothing is written into the notebook file, so there is no format change; "persist on the page" is therefore per notebook, not per page.
  • Complex numbers, matrices, statistics, solver. (1 + 2i) * (3 - i), sqrt(-4), ln(-1); matrices and vectors [1, 2; 3, 4] with + - *, powers, det, inv (exact), transpose, trace, dot, cross, norm, linsolve; lists with mean, median, mode, std, var, quantile, corr, slope, intercept, sort, seq; solve(x^2 = 2, x[, a, b]), integrate(f, x, a, b), diff(f, x, at) (numeric, run on = only).
  • Display. Degrees or radians; notation auto, scientific or engineering; 3 to 15 significant figures or auto; fractions exact or decimal; all kept per device. A value with a unit such as 30 deg never depends on the angle mode.
  • To the page. Insert as text (a text box expression = result), Insert as formula (an equation element with the typeset expression and its result; a failed typeset falls back to text) and Draw as graph (sin(x) or f(x) = x^2 - 3 in a graph element; your variables become its sliders, degrees follow the calculator). Each is an ordinary AddElement, one undo step; a locked page refuses. Copy puts the answer on the clipboard.
  • Code. src/math/calc-number.ts, calc-units.ts, calc-constants.ts, calc-parse.ts, calc.ts, calc-format.ts, calc-state.ts, calc-graph.ts; src/ui/calc-store.ts, calc-keys.ts; src/view/calculator.ts. Registry action calculator (All actions, command, long-press help, context ranking: it comes first under For this page when a text box, equation or graph is selected). English and Italian texts. Tests tests/calc.test.ts, tests/calc-ui.test.ts; harness doc=calculator. Not verified on Android hardware.

hygiene

  • Zettelkasten system hygiene (Z10). The command Check Zettelkasten hygiene opens a report with three lists: cards nothing links to and that link to nothing (links in the card property or in any note, both directions), likely duplicates (same title, the same page and region, or nearly the same text) and cards without a typed title. Each row has Open. Reading and scanning write nothing; the scan runs in idle slices with a progress line, so a large vault stays responsive, and at most 100 rows per list are drawn.
  • Fixes always ask first. Add title… (the same writer as Set card title), Link… (pick a card, confirm, both notes get the link) and Move to trash (confirmation naming the note; fileManager.trashFile, the notebook page is untouched). No format change. Code: src/zettel/hygiene.ts (pure detection), hygiene-view.ts.

cardtemplates

  • Card templates (Z9). The New card dialog has a Template row: Blank, Concept, Question, Quote and Definition, then your own. A template starts the card's note with labelled areas under the ink (one Markdown heading each, in the plugin language), suggests the card type and adds its tags (question, quote, definition) to yours. The choice also works from the Inbox. The note gets a card-template property; nothing in the notebook or its format changes, and a blank card is exactly as before.
  • Your own templates. Settings → Study → Zettelkasten → Card templates opens a manager built on the shared dialog: copy a built-in template to change it, or add one; a name, a suggested type, tags and one area per line ({{date}} is filled in when the card is made). Changes save as you leave a field; deleting asks for a second tap. Stored in the plugin settings, read leniently (bad entries dropped, unknown fields kept).

Review fixes

  • Study tape.
    • The stroke, segment, area and scribble erasers never remove any part of ink, text, images or areas under a covered tape: anything a covered tape reaches over, even in part and across several tapes, is left alone, and a short notice says to reveal the tape first.
    • The lasso, double tap, groups and Ink follows objects now take covered ink with the rest, so moving, cutting or copying a block carries its covered answers and what is saved never depends on which tapes are revealed. While selected or moved, covered ink stays under its tape (the selection and the space-tool preview draw the tapes on top).
    • Tapes are a visual study aid, not redaction: nothing is removed from exports. The Study tape help, the export dialog (when the notebook has tapes) and the docs say: "Study tapes only cover content visually; text under them can still be found in exported files. Use Redact to remove content from exports."
    • Reading mode with the annotations hidden keeps the tapes over a PDF page; heading pictures (outline, semantic zoom, companion note) draw the tapes over the heading ink.
    • A tap with the lasso picks what is under a revealed tape before the tape.
    • Redaction keeps tape slivers of any thickness next to a black box; Hand in counts a page with only tapes as blank; repairing an older-labelled file that holds a tape drops only the tape, not the page and its ink.
    • Round 2 (R1): the pen delete gesture (a scratch-out in gesture mode) spares ink a covered tape reaches over, like the scribble eraser, and says so.
    • Round 2 (R2): Add row / Add column on a hand-drawn table push covered answers and hidden struck words with the visible ink of their cells, so a taped answer column stays lined up with its rows; chart Update is no longer refused as "gone" when a tape lies over the chart. The checkbox-label offer still reads only what is visible.
    • Round 2 (R3): Delete and Cut of a selection that holds ink or objects under a covered tape ask first ("This selection includes content hidden under study tapes. Delete it anyway?", English and Italian); the offer to delete the ink written on deleted objects counts only visible ink.
    • Round 2 (R4, R5): a tap with the text tool on a covered tape starts a new text box (under the tape, like pen ink) instead of opening the text box it hides; Insert space moves the ink a tape reaches over with the tape, so a tape straddling the line never leaves its answers on the other side.
    • Round 3 (Z4): a tap with the text tool on a covered tape no longer starts a text box that would be saved, invisible, under the tape: a short notice (English and Italian) says to reveal the tape first.
    • Round 3 (Z5): Insert space also moves text boxes, pictures and checkboxes under a tape with the tape; the tape's centre decides the side, and each item keeps its own extent too, so Remove space never pulls ink over the rest of a long stroke that only touches a tape.
    • Round 3 (Z6): Add row / Add column on a hand-drawn table move the tapes over the answers they push (in the same step, with the same edge and redaction checks), so each answer stays covered and no tape ends up over the answer of the row before. A locked tape never moves, so an insert that would push an answer out from under a locked tape is refused with a notice (English and Italian) asking to unlock the tape first (round 4, Y8).
  • Undo and Redo keep redaction boxes covering what they were drawn over (review R3-1, fail closed). An Undo or a Redo that would move writing out from under a redaction box of its page, or under one, is now refused with a notice (English and Italian), and the step stays in the history exactly where it was: remove or redo the boxes on that page, then try again. Before, undoing a Reorder lines drop, an Add row / Add column or a lasso move after a box was drawn over the moved writing slid it back out, and the next export showed it in clear. Every way a step is taken is covered: Undo / Redo, per-page undo (a refused step taken out of order stays in place), macros (one group, one refusal) and history-panel jumps (the jump stops at the refused step). What counts as a move: a stroke with the same id and number of points at other coordinates, an element whose position or size changed, an item that leaves a page where it touched a box for another page. Ink that only appears or goes (an erase or a stroke undone), a restyle, a text edit and a reshape (a trimmed hook) are not moves. When the stored boxes cannot be read, any undo or redo that moves ink is refused.
  • A table row or column insert no longer pushes writing of a drawing with states (review R3-2). When ink the insert would push belongs to a part of a drawing with states, the insert is refused with the existing notice (its text now says so): moving it would leave the part's pivot behind and change its poses.
  • Excerpts in other notebooks and the reading position after a PDF page turn or crop (review R2-3): documented, not changed. An excerpt stores no record of the turn and crop its region was taken on, so without a format change a page turned after the excerpt was made cannot be told from one that was already turned; such an excerpt keeps drawing its saved picture (always the right content) and only its jump back may outline the old region. The reading position is captured from the live view after every page change, so a turn made in this view is followed; one made elsewhere leaves a scroll hint on the right page. See docs/architecture.md.
  • Code. History.setStepCheck (StepCheck, a check the history runs before and after each undo and redo; a refusal takes the step back with its own inverse and keeps it in its stack), pure src/ink/redact-step.ts (captureForStep, stepMovesUnderRedaction, redactStepCheck, reusing movesUnderRedaction), wired by NotebookView.redactStepCheck; planTableEdit refuses pushed state-part ink. No format change. Tests tests/redact-undo.test.ts.
  • Review U1: margin comments are checked too. Undoing or redoing a Move line, a margin change, a PDF turn or crop or a page restore that moves a margin comment out from under a box (or under one) is refused: the export drops a comment whose region a box touches, with its replies, so sliding it out would print them.
  • Review U2: unreadable redaction storage gets its own notice. When the stored boxes cannot be read, a step that moves writing is still refused (fail closed), but the notice now says the boxes cannot be read and points to Export… › Redact… › Reset redaction storage (or drawing this notebook's boxes again), instead of asking to remove a box that does not exist (English and Italian). Only the pages the step names are copied for the check, not every page of the notebook.
  • Review U3, U5: what counts as a move follows the export. An element moves when its area as the export measures it (redactBounds: a text box by its font size and text, a checkbox by its size) changes and does not hold the old one, so undoing a larger font size can no longer uncover a boxed text box; an element that only grew is allowed. A stroke with another number of points counts as moved when its bounds shifted beyond the reach of its pen and neither bounds holds the other (a resample that moved it); a trimmed hook, a join or a piece left by an area erase is not.
  • Review U4: a refused step whose inverse fails is never left half done. The document is put back from a snapshot and the step goes like any step that failed: dropped when it was the next one, kept in place when per-page undo took it out of order, and said; the history never rethrows with the step in neither stack.
  • Review U6: moves across pages. Writing that leaves a page the step removes, and writing that arrives from another page onto a box, are checked too.
  • Review U7: one read of the redaction store per history-panel jump. The stored boxes are read and parsed once per run of steps (History.runSteps hands the check a run token, StepInfo), not once per step.
  • Round-2 review fixes.
    • A left margin never slides a page out from under its boxes (H1, fail closed). Page margins… refuses a new left margin on a page with redaction boxes (or while the boxes cannot be read), with a notice in the dialog (English and Italian); the right and bottom margins stay free. The same refusal covers any other step run on the view that changes a left margin (a merge that widens a page, a page size that drops the margins). Undo and Redo now also compare the background of a page with boxes: a step that moves, resizes or changes it (a margin, a page size, another PDF page, a turn or a crop) is refused and stays in the history, also on a scanned page with no ink at all.
    • Struck words left out no longer switch the checkbox label rule off (H2). The typed label of a checkbox is dropped when a box touches its handwritten label measured on the ink as it is on the page, before Leave out struck-out words removes anything, so a box over struck handwriting still keeps the label out of the Markdown export, the export dialog, the share sheet and every PDF.
    • Struck words alone keep the study tapes (H3) in the export dialog and the share sheet too, like every other writer.
    • Notices (H4). The "not done" notice of a refused Undo or Redo appears only once the step is back in the history; when taking the step back fails, only the dropped-step notice appears. A check that fails (a bug) refuses the step with its own short notice instead of a silent refusal.
    • Comments on duplicated pages (H5). A margin comment removed from a page with a box is no longer taken for a move because a duplicated page holds a comment with the same id: no more false refusals.
    • Navigator Export pages PDF (H6) resolves figure captions against this notebook's frozen numbers, like every other writer.
    • Code: backgroundShifts, PageShot.background / backgroundKey in src/ink/redact-step.ts; StepVerdict and setStepCheck(check, failed) in src/model/history.ts; sourceInk and STRUCK_ONLY in src/model/clean-export.ts. Tests tests/redact-review-r2.test.ts.
  • Round-3 review fixes (fail closed, no format change).
    • Merges are checked like a margin change (Z1). A merge (conflicted copy, newer version) that would widen the left margin of a page with redaction boxes is refused; the conflict dialog says why in its own words ("Merge failed: it would move or stretch the background of a page with redaction boxes…") instead of "not editable".
    • Every box knows where its background was (Z2). A box drawn (or confirmed with Done) now also records the geometry of its page's background: where the PDF page or picture is drawn on the page and what it shows. An export refuses a page whose background has since moved, grown, shrunk or changed, whatever did it: a page size or orientation, an infinite page that grew, Update PDF, a page restore, a merge, or a copy synced from another device. The stale notice now says "turned, cropped or resized, or its background was moved or replaced". Page size, Landscape/Portrait, the navigator's size command, Update PDF and page restores are refused up front on a page with boxes (same notice as the margin refusal, now worded for all of them). An Undo that puts the background back where the boxes were drawn is allowed (it was refused before). A background removed, or added to a plain page, does not count: nothing a box covered can show. Boxes stored before 0.29 are checked on their turn and crop as before and adopt their page's geometry once, when the notebook is opened or the Redact dialog is confirmed (a box already stale by its turn or crop does not).
    • Undo of writing on an infinite PDF page with boxes (Z3, final form in round 4). An infinite page grows exactly as in 0.28 on every path (writing, Insert space, a board shot, a merge). The Undo and Redo of writing that only grew an infinite page (same PDF page or picture, same turn and crop, only taller or shorter) are no longer refused on a page with boxes, and a merge of a longer copy into such a page is no longer refused either. The export still checks: when the page's background no longer matches where its boxes were drawn, the export is refused until the boxes are redrawn.
    • One message in the margins dialog (Z7). A refused left margin is explained in the dialog only, not also in a notice.
    • Code: backgroundGeometry, adoptGeometry, RedactBox.geo in src/model/redact.ts (stored per device in src/ui/redact-store.ts, read leniently: an older version drops the field); backgroundShifts unwraps inner and covers SetPageSize, SetPageBackground and ReplacePage. Tests tests/redact-review-r3.test.ts.
  • Round-4 review fixes (fail closed, no format change).
    • Boxes from before 0.29 (Y4). They adopt their page's background geometry only when their turn and crop still match the page. A change made before that first adoption that 0.28 could not see (Update PDF switching the slide, a page size) is not detected: such boxes keep 0.28-level protection until they are confirmed again in the Redact dialog (documented in docs/architecture.md).
    • Update PDF writes nothing when it is refused (Y5). The update is checked against the redaction boxes before the new PDF is stored, so a refused update leaves no file behind in _assets/.
    • One correct notice on restores and merges (Y6). A page restore (from a version, or in the version comparison) refused for redaction boxes shows only the redaction notice, no longer followed by "cannot be edited"; when the stored boxes cannot be read, the restore, the merge and every other refused change say so (English and Italian) instead of naming a page with boxes.
    • Batches are checked in order (Y7). Each change in a merge or another batch is judged on the page as the changes before it left it, so a merge that adds a right margin and then grows the page is no longer refused by mistake.
    • Code: grownOnly, PageShot.infinite and the in-order walk of backgroundShifts in src/ink/redact-step.ts; NotebookView.redactRefusal ("boxes" / "unreadable"); republishRefused and PdfActionHost.redactRefused in src/view/pdf-actions.ts; TableEditRefusal tapeLocked. Tests tests/redact-review-r4.test.ts.
  • Figure captions.
    • Numbers never leak between notebooks (F1). A notebook's renderer, thumbnails and every export (PDF, SVG, PNG, print, HTML, Markdown, the area and note pictures, the automatic PDF copy) resolve captions and references against the figure numbers of THAT notebook only, taken as a frozen snapshot when the export starts. A figure the notebook does not know is "Fig. ?", never the number another open notebook (for example a file-manager copy with the same picture ids) gives it. The companion note, the Markdown text and the API PDF depend on the document alone, so they are byte-identical on every device whatever else is open. (Pictures of another page drawn inside an excerpt still use the most recently opened notebook's numbers; the reference window and the PDF reference pane number the captions of the notebook they show, review R6.)
    • Copies follow their pictures (F2). Duplicating pages, copying or pasting a captioned figure (and moving a selection), making a notebook from a template and moving pages to another notebook rewrite the ids inside {{figcap:…}} / {{figref:…}} to the copy of the picture when that picture is copied in the same operation (across pages too); a marker that names a picture that was not copied keeps naming the original.
    • Long exports keep their numbers (F3) across the pauses of a long PDF build: edits or closing the view during the export change nothing in the file. Redaction measures the caption as it will be drawn (F4), in the same figure scope as the writer, also in the API PDF.
    • The reference picker's note reads "1 reference shows…" / "N references show…" (English and Italian).
  • Charts. Update chart keeps the chart's place in the z-order (ink written over it stays over it), a locked text box of a chart gives the "locked" refusal instead of "gone", and a deleted title box no longer turns an axis label into the title.
  • Strike-through (S1 to S5). (S1) Scribble to erase and the pen "delete" gesture never delete hidden struck words: they are left out of the candidates, like the stroke eraser does. (S2) The setting Leave out struck-out words from exports now covers every writer that goes through the redaction step: the quick Export PDF command, the page-range and single-page PDF, the API exportPdf, the Markdown export, hand-in, HTML, SVG, PNG and print (the export dialog and the share sheet keep deciding on their own, starting from the setting). Pictures of a selection put into notes, copies and the digests are not covered, and the setting text (en + it) says so. (S3) A strike line only strikes ink written before it (earlier in the page's stroke order): a new word written on the empty place of a hidden struck word stays visible and is kept in exports. (S4) A group touched by a selection comes whole with its hidden struck members, so a move, cut or delete never splits it. (S5) A page with more than 6000 strokes is not looked at for the view (its words stay shown) so one dense page cannot hold the main thread; exports still leave its struck words out. Known limit: a move or tidy of visible ink leaves ungrouped hidden struck words where they were.