Repository navigation
0.25.0
Seven features and a first part of the history: an area highlighter, a panel of the actions you took, align to baseline, lecture and study writing profiles, copy as image, a toolbar that fades while you write, a suggested paper for a new page and a page navigator view of marked pages only. The notebook format moves to version 23 (the area highlighter): the migration from version 22 is automatic, and 0.24 and older open a v23 notebook read-only and never overwrite it. Two independent review rounds are folded in (see Review fixes).
Area highlighter and document format 23
- Area highlighter (#99) and document format 23. The highlighter's options have Stroke | Area. In Area a drag from corner to corner puts a translucent rectangle on the page, in the highlighter colour, above the page background (a scanned PDF or a picture) and below all your ink and typed text, so what it covers stays readable. It looks exactly like highlighter ink (the same translucency, multiplied over the page; screened at night) and is dimmed by the colour-meaning filter like highlighter ink. It can be selected, moved, resized (the corner handle scales it in proportion; a quarter turn turns it, any other turn only moves it round, so it stays upright), recoloured with the highlighter colours in the selection bar, grouped, locked, copied, deleted and undone; the whole-stroke and segment eraser remove a whole area when they touch it and the same stroke of the pen has erased no ink (rubbing out a letter written on top of an area keeps the area; the Pen eraser filter spares it, the Highlighter filter always takes it) and the area eraser removes the ones inside its outline. A drag under 2 pt adds nothing. The action Area highlighter is in the all-actions sheet, ranked first while the highlighter is in hand and on PDF pages, with a long-press explanation.
- Everywhere you see the page. The canvas, the live drag preview, PNG, SVG (and so the interactive HTML and the written-area export), PDF, library cards, the page navigator and the hand-in PDF draw areas with the same look and order.
- Document format v23. One more element type,
area(x,y,width,height,color, plus the usualgroup,locked,lockAt). The v22 to v23 migration is the identity plus the version; lenient reading drops and counts an area with an invalid rectangle or colour, strict writing refuses it; repair keeps a valid one; older plugins open a v23 notebook read-only.docs/schema/notebook-v22.schema.jsonis nownotebook-v23.schema.json;docs/format.md, the architecture notes (why an element rather than a stroke flag) andtests/format-schema.test.tsare updated. The stroke pipeline and the golden render hashes are untouched. - Code.
src/model/area.ts(geometry),src/ink/area-render.ts(the one description of the look),src/ink/area-erase.ts; the drag reuses the shape tool's drag insrc/view/notebook-view.ts; tests intests/model-v23.test.ts.
Action history panel
- Action history panel (#84, panel only). Action history… (all-actions sheet, notebook menu, command palette) lists the steps of the open notebook newest first: a readable title per step ("Stroke written", "Added: text box", "Selection moved or transformed", "Erased"…), its page, how long ago, and how many items it touched. The point the document is at is highlighted (Now); undone steps are listed dimmed above it, and Start of the history is the last row. Tapping a step goes back, or forward, to the point just after it: every step is an ordinary History Undo or Redo, so the guards apply to each one (a locked page, a change the writer would reject, read-only mode); when a step is refused the jump stops there and a notice says how far it got. Long-press help in English and Italian; ranked higher in the actions sheet once steps were undone.
- Code.
Historyrecords the time of each step and exposesentries(),depth()andstepsTo()(no change of behaviour); the pure titles are insrc/model/history-describe.ts(every command class, every label the code uses, a generic fallback for an unknown command), the jump insrc/model/history-jump.ts, the list model insrc/view/history-panel-logic.ts, the dialog on the modal shell insrc/view/history-panel.ts. No document format change. - Not in this release: undo that survives reopening. The history is still emptied when the notebook is closed. Commands hold element objects by identity and private apply state, so saving them safely needs a serialiser per command class, re-linking to the freshly read notebook and a verified dry run, and the history would have to be saved at idle saves because Android can end the app without a close event. Roadmap #84 stays open.
Align to baseline
- Align to baseline (#93). Select handwriting and tap Align to baseline (second row of the selection bar on tablet widths, the All actions sheet everywhere, command Align the words of the selection to a common baseline): the words of each line are moved straight up or down onto one common baseline, in one undo step, with a notice that counts the words. On ruled paper the words go onto the ruled line instead. A line that is clearly written uphill or downhill keeps its slope and loses only the wobble.
- How it reads the writing. Words are found from the gaps between strokes (the dot of an i, a comma or a full stop go with their word), lines from the baselines, and the baseline of a word is where most letters sit, not the lowest ink: a g, p, y or q keeps its tail below the line, and the bar of a T or an f does not pull the baseline up. Everything is relative to the size of the hand, so large and small writing work alike.
- Safe. Strokes only translate in y (same x, pressure, width, style, id and layer; nothing is rotated, scaled or redrawn). Underlines, drawings, shapes, the highlighter and the marker, invisible ink, ink bound to a graph and the ink a collapsed sticky note keeps hidden are left where they are. A group moves as one unit, and a group that is not wholly selected or that holds a locked element stays put. A word that would have to move more than twice the height of the writing is left alone (it is another line). A move under a quarter of a point is not made, so a second run does nothing. The page times do not move (it is a move, not writing); a locked page refuses it.
- Code. Pure, Node-tested module
src/ink/baseline.ts(noobsidianimport; reusesapplyPlacement); the action insrc/view/selection-actions.ts(alignBaseline) and the registry (selection-baseline), with a long-press explanation, a context-ranking rule (higher on ruled paper) and English and Italian texts. No format change. On a phone-width bar (five places) the older actions keep their places and this one is in the sheet. - Tests.
tests/baseline.test.ts(synthetic words with descenders, punctuation, two lines, ruled paper, slopes, groups, locks, pinned ink, undo, page times, a 20-line page), and new cases intests/selection-arrange.test.ts,tests/context-rank.test.tsandtests/long-press-help.test.ts.
Lecture and study profiles
- Writing profiles (#219). A chip on the pen options (and the commands "Writing profile: Lecture / Study / next", also in All actions) switches the pens on the strip, the stabilization and the paper that new notebooks start on in one tap. Lecture has thin fast pens, light smoothing and ruled paper; Study has fountain pens, strong smoothing and grid paper. "Save current setup as a profile" keeps your own (up to 12; update or delete from the same menu). A pen set can be referenced by a profile; otherwise its pens become a normal pen set. The chip shows the profile only while the smoothing and paper still match it. A setting under Writing switches to Lecture when lecture mode starts (off by default). Switching changes tools and defaults only: no stroke, page or document is touched; no format change. English and Italian; long-press help and context ranking (Lecture first during a class). Not done: the optional toolbar density per profile.
Copy as image
- Copy as image (#277). Copy as image puts the selection, or the written area of the page, on the system clipboard as a picture to paste into messaging, mail and other apps. It is the last button of the selection bar's second row (from tablet width; on a phone bar it is in the All actions sheet) and Copy written area as image is in the page menu and the sheet. The picture is the transparent area export drawn at 2x, with a pixel cap for very large areas, painted onto white by default (new setting Background of copied pictures: White or Transparent, for apps that show transparency as black).
- Never silent. Where the WebView has no image clipboard the PNG goes to the system share sheet; where that is missing too, a PNG is saved next to the notebook (recorded as written by the plugin). Every outcome shows a notice, and closing the share sheet is not an error. No format change.
- Code. Pure decisions (size cap, routes, fallback order) in
src/ink/clip-image.ts; drawing and delivery insrc/view/copy-image.ts, reusing the area export's plan and renderer; English and Italian; long-press help; harnessdoc=clipimage.
Toolbar fades while writing
- Toolbar fades while writing and returns on the first touch (#399). Settings > Appearance > Toolbar while writing > Fade while writing (default: always shown, so nothing moves for anyone who did not ask): once the pen has been writing for the Fade delay (1 to 6 s, default 2), the toolbar, the contextual bar and the floating pills (recent symbols, back-to-page, referenced-on, welcome-back, lecture header) dim to 15% and come back that many seconds after the last stroke. A finger touch outside the page, a pen hovering over a bar or a press on a bar brings them back at once; the first finger touch on a dimmed bar only restores it and does not press the button (switch First touch only brings the bars back off to press at once). A long press on a dimmed bar restores it and shows the icon help. A selection, the lasso or an open dialog never lets the bars fade. Opacity transition only (no layout shift, the bars stay hit-testable), none under reduced motion; one class is toggled by the existing stroke start and end events, with one timer and no per-frame work. Pure state machine in
src/ui/tool-fade.ts(tests/tool-fade.test.ts), DOM part insrc/view/tool-fade.ts; English and Italian.
Suggested paper for a new page
- Suggested paper for a new page (#409). The + strip highlights the paper the notebook and the course point to, with a short reason on the chip: Like the last 5 pages (a run of one paper), Like most of the last 6 pages, Alternating, like the last pages (ruled, grid, ruled, grid), Usual for Analysis (what was added while that class was in progress, kept on this device), Usual in this notebook. If the suggested paper is not among the usual chips it takes the place of the weakest one; the same-paper chip and the slide chip stay. It never adds anything by itself and never replaces your choice. New setting Suggest a paper for new pages (Pages), on by default.
- Code. Pure, Node-tested ranker
src/model/paper-suggest.ts(noobsidianimport): a list of candidates with a score and a structured reason, with anextrainput so another feature (a profile paper, scorePROFILE_SCORE) outranks history. The course habit is a bounded per-device value in local storage. No format change; notebooks are only read. English and Italian.
Marked pages view
- Marked pages only in the page navigator (#419). A flag button in the panel header switches between all pages and Marked pages only: pages with a bookmark, a global bookmark, a marker (gap, question, homework, importance), ink in a colour with a meaning, an open checkbox or a page tag. Each page keeps its number and shows why it is marked; a menu picks which kinds count; works in thumbnails, the large layout and the compact list; an empty result says so quietly. The choice is remembered per notebook on this device (bounded local storage). Read-only: no format change; long-press help in English and Italian.
Review fixes
- Erasing writing no longer takes the area highlighter under it. The whole-stroke and the segment eraser now remove an area highlighter only when the same stroke of the pen has erased no ink: rubbing out a letter you wrote on top of an area keeps the area, scrubbing an empty area still removes it, and the Highlighter eraser filter always takes it. An area the pen passed over before it reached ink comes back at once, so one Undo never holds both. The area eraser (by outline) is unchanged.
- An area in a file older than format 23 is refused. Like every earlier element type (excerpts before 10, sticky notes before 15, checkboxes before 17), an
areain a file of an older format was not written by this plugin, so the file is refused and left untouched instead of being read as if it were new, both in the normal and in the staged loading of large files. - Hand-in pre-flight. A template box that holds only an area highlighter is no longer reported as an empty box.
- Going far back in the history panel no longer freezes the page. A jump of hundreds of steps on a large notebook (every step checks the whole document, as an Undo does) now runs in short slices of about 60 ms with the panel showing Going to that step: N of M, takes no tap or edit until it ends, and ends with the same notice and the same stop at a refused step as before. A short jump is still taken in one go. The steps of one jump also stop repeating the check before each step (they reuse the answer the step before ended with), which roughly halves the time; every step still checks the document after it. New benchmark
tests/history-jump.perf.ts(npm run bench): 500 steps take about 0.7 s on 2,000 strokes, 2.5 s on 10,000 and 9 s on 40,000 strokes, in slices of at most about 80 ms. - Copy as image never saves a file you did not ask for. When the share sheet refuses because the tap is too old, one notice asks you to tap Copy as image again and nothing is written to the vault. Every outcome now shows exactly one notice (the saved copy used to show two success notices and two working notices).
- Writing profiles. A saved profile gets an id that is never reused, so a new profile can no longer show the pens of a deleted one. Deleting a profile deletes the pen set it made (it used to pile up against the limit of 24); if a notebook, a folder or another profile still uses that set it is kept and the notice says so. When the pen set list is full, switching to a profile says that the pens did not change (the smoothing and the paper did) instead of claiming a switch. Strokes, pages and notebooks are never touched.
- A long history jump is a change like an Undo. Every slice marks the notebook changed and the notebook counts as busy until the jump ends, so a file change that arrives meanwhile is kept against and the other version is backed up (it can no longer reload over the steps just taken), and closing the notebook mid-jump saves the steps already taken.
- A jump stopped by a reload or by switching to another file leaves the new notebook alone. It writes nothing into the replacement and says the jump was interrupted (not that a step was refused).
- A failing slice no longer leaves the notebook locked. Whatever happens inside a long jump, the edit lock is released and the steps taken are saved.
- Copy as image cannot ask for a new tap forever. The picture drawn for a share that asked for a new tap is kept for a minute and shared at once on the next tap; if the share still needs a tap with the picture ready, the saved copy is made instead, with one notice.
- Deleting a profile keeps a pen set that another open notebook is showing (the notice says so). The strip of the notebook you delete it from falls back to your favourite pens, as before.