Repository navigation
0.24.0
Eight features: filled shapes and dashed or dotted lines, joining of broken strokes, a context-ordered actions sheet, explanations on long press of an icon, tag suggestions, an adaptive page navigator, global bookmarks across notebooks and a hand-in dialog. The notebook format moves to version 22 (filled shapes and dashed or dotted lines): the migration from version 21 is automatic, and 0.23 and older open a v22 notebook read-only and never overwrite it. Two independent review rounds are folded in (see Review fixes).
Filled shapes, dashed lines and document format 22
- Filled shapes and dashed or dotted lines (#37) and document format 22. The shape tool's options have a Fill (none, solid, or a translucent tint, in the colour of the line or a palette colour) for the rectangle and the ellipse and a Line style (solid, dashed, dotted) for every shape; the selection bar restyles both for the selected shapes as one undo step (freehand ink is never touched, groups and locks are respected). Fill and dashes are drawn on the page, in the live preview, in the PNG, SVG, PDF and HTML exports, the written-area export and the thumbnails; tapping inside a filled shape picks it with the eyedropper.
- Document format v22. Three optional stroke fields, only on shape strokes:
fill,fillTint,dash. The v21 to v22 migration is the identity plus the version; a bad value is dropped and counted when reading and refused when writing; older readers open a v22 notebook read-only.docs/schema/notebook-v21.schema.jsonis nownotebook-v22.schema.json;docs/format.mdanddocs/architecture.mddescribe the fields. Old documents render exactly as before. - Code. Pure geometry in
src/ink/shape-style.ts(dash runs by arc length, scaled by the line width; closed-shape test; fill polygon), the selection restyle insrc/ink/shape-restyle.ts, one row builder for the options and the bar insrc/view/shape-style-row.ts; English and Italian.
Join broken strokes
- Join broken strokes (#313). When the pen briefly loses contact in the middle of a line, the line is saved as two strokes. Select the ink and tap Join broken strokes (second row of the selection bar, All actions sheet, command Join broken strokes in the selection): each pair that is one gesture split by a dropout becomes one stroke, in one undo step, with a notice that counts the joints. A chain of several fragments becomes one stroke.
- Conservative on purpose. Two strokes are joined only when they are neighbours in the page order, in the same style (tool, colour, width, nib, render version, slide) and the same group, both are real lines (a dot is never a fragment), the end of the first and the start of the second are a few points apart (a small multiple of the pen width and of the point spacing, and a small share of the shorter piece), the direction is continuous (no sharp turn: the corner of an L, a V and a dash pattern stay apart) and the pressure does not jump. Words, letters, the dot of an i, dashes and intentional pen lifts are never joined. Highlighter and marker strokes are not touched.
- Safe. The joined stroke keeps the id, style, group and nib of the first piece and the points of all pieces unchanged (still
[x, y, pressure]in page coordinates); the page order and the page times do not move; a locked page refuses it; the ink a collapsed sticky note keeps hidden, and strokes of a group that would shrink to one member or that holds a locked element, are skipped. Nothing is joined while writing and Clean up strokes does not join (they stay two separate actions). No setting, no document format change. - Code. Pure, Node-tested module
src/ink/stroke-join.ts(noobsidianimport); the action insrc/view/selection-actions.ts(joinBroken) and the registry (selection-join); English and Italian.
Actions ordered by context
- Actions ordered by context (#424). Obsidian does not let a plugin reorder its own command palette, so the plugin's All actions sheet does it: it opens with a short For this page section (up to five actions that fit what is in front of you: the selection, a PDF page, the lasso in hand, a lecture, the side pane, presentation mode), and the search ranks matching actions by designed importance, recent use and fit to the context. Library-level and diagnostic actions step back while a notebook is open. Commands that act on a notebook were already hidden from Obsidian's palette when no notebook view is active (
checkCallback); that is unchanged. No format change. English and Italian.
Explanation on long press of an icon
- Explanation on long press of an icon (#429). Hold a finger on a toolbar tool, the undo and redo buttons, the pen chip, a button of the selection or contextual bar, or a Home header icon: after about half a second a small bubble anchored to the icon says its name and, in one line, what it does (the tools also say that a second tap opens their options). The button is not pressed, and the bubble goes a moment after you lift, or at once when you tap elsewhere. A swipe, a quick tap, the mouse (it keeps its hover tooltip) and the pen (S Pen button rules and writing are untouched) never show it, and buttons with their own long press (the quick actions that pin, the page indicator quick tab) keep it. Settings > Appearance > Explain icons on long press turns it off. English and Italian; one shared helper (
src/ui/long-press-help.ts) with pure timing and placement logic (src/ui/long-press-logic.ts).
Tags suggested from context
- Tags suggested from context (#411). When you edit the tags of a notebook, or of a page, up to six suggestion chips appear: the course of the class linked to the notebook or its folder (timetable), tags that other notebooks in the same folder use, frequent words of the typed text and titles (English and Italian stop-words ignored), and what is on the page (questions, homework, definitions, theorems...). One tap adds the tag through the same path as before (notebook tags and page tags are still undo steps in the notebook). Computed on the device from what is already there: no AI, no network. New setting Suggest tags (Integration). The document format is unchanged.
Adaptive page navigator
- Adaptive page navigator (#414). The page panel now fits the notebook. When most pages have a PDF or picture background (an annotated PDF, slides) it shows large thumbnails in a wider panel; when most pages are written it shows a compact list (page number, title, the time the page was written, tags, and a small thumbnail); a mix keeps the usual layout. The title is the bookmark's title, else the first line of the topmost typed text on the page. A button in the panel header cycles Auto, Thumbnails and List; the choice is remembered per notebook on this device only (bounded local storage, never in the notebook or the vault). Thumbnails stay cached per page and width and are drawn lazily; the list is built in chunks and offscreen rows are skipped by the browser, so a 500-page notebook opens at once. No format change. English and Italian. Tests:
tests/nav-adapt.test.ts; harnessnavadapt.
Global bookmarks
- Global bookmarks (#265): pages from different notebooks in one list. Bookmark in the global list (page sheet and command, a toggle) adds the page in view to one list that covers every notebook; the same action removes it. Global bookmarks (command, page sheet, and a Bookmarks chip on Home once the list has something) opens the list in a dialog: tap a row to open the notebook at that page, rename a row, move it up or down, or remove it. A page that was deleted, or a notebook that cannot be found, is shown dashed with a Missing badge and can still be removed. The list is not part of any notebook: no format change, nothing is written into notebook files.
- Where it lives. One file per device,
_meta/bookmarks-<device>.json(the same sidecar pattern as quick tabs: a device writes only its own file, the latest change wins, a removal is kept as a tombstone for 90 days, entries and fields it does not know are kept, a file that cannot be read or is still empty from a sync is never overwritten). It names the notebook by path and by its own id and the page by page id, so it follows a notebook that is renamed or moved (a folder rename too) and finds again one that was moved where no rename was seen. The library check does not count it as holding any asset.
Hand in…
- Hand in… (#334). A dialog (notebook menu, Export & share sheet, command palette) that exports chosen pages as one PDF with a generated cover page first: your name (remembered on this device only), the course (prefilled from the timetable class linked to the notebook), the assignment title and the date. A grid of page pictures with checkboxes chooses the pages (the page in view at first; All / None). Below it a live pre-flight lists blank pages among the chosen ones and what is still open: gaps, questions and homework not done, unticked checkboxes, notes that say TODO and empty template boxes. Each row jumps to its page; Leave out the blank pages unticks them; the main button turns into Export anyway while anything is open. The PDF is the ordinary export, saved next to the notebook as
<notebook> hand-in.pdf(never over an existing file), recorded as plugin-written, and offered to the share sheet when the device has one. No format change.
Review fixes
- Long-press help never presses the button. The click that ends a long press is swallowed by a one-shot guard armed when the bubble shows, not by a clock from that moment: a finger held for two seconds on Delete, Cut or Clear page no longer runs it when lifted, and a quick tap on the same button right after is never swallowed.
- Join broken strokes. Ink bound to a graph is never joined with ink bound to another graph or with free ink (the joined stroke would be clipped to, or leave, the graph frame).
- Shape style. Redo restyles the stroke as it is now, so a change made by background upkeep (slide relink, margin refresh) is not reverted; filling an outline whose ends are only close closes it exactly, so the fill survives scaling; the version comparison counts a fill, dash or nib change as a change.
- Global bookmarks. The file at a bookmark's path is trusted only when it has the same notebook id; looking at the list never moves a bookmark (a notebook that has not synced yet keeps its bookmarks), a bookmark follows a moved notebook only on a tap and only when one notebook has that id, and the notebooks are read once per dialog. A copy of a notebook (same id) is not mistaken for the original. Every unknown field of the file and of an entry survives a rewrite, including values this version only shows shortened or rounded. The same page bookmarked on two devices is one row and is removed everywhere.
- Global bookmarks, round 2. Following a moved notebook moves only the bookmarks of that notebook's id, never those of another notebook that now sits at the old path (no ping-pong of synced writes, no duplicates when toggling). A page counts as already bookmarked when the file at the bookmark's path is known to carry another notebook id. Moving or renaming a row that is the same page bookmarked on two devices acts on every twin, so the row never jumps back.
- Long-press help, round 2. A second finger, the palm or the pen landing while the first finger still holds the button no longer lets the first finger's lift press it.
- Tag suggestions. A suggested page tag never contains a comma, a semicolon or a hash, so one tap adds exactly one tag.
- Page panel. The thumbnail cache is bounded (least recently used first, 200 thumbnails), stale widths of a changed page are dropped and everything is released when the notebook closes; the per-notebook layout choices are stored as ordered pairs, so the oldest are forgotten correctly (the earlier object format is still read).
- Explanations on long press for the global bookmarks chip and actions, the page panel layout button, Hand in, Join broken strokes and the Fill and Line controls of the shape style row, in English and Italian.
- Tests. New cases in
tests/long-press-help.test.ts,tests/stroke-join.test.ts,tests/model-v22.test.ts,tests/version-diff.test.ts,tests/tag-suggest.test.ts,tests/nav-adapt.test.ts,tests/context-rank.test.tsand the newtests/bookmarks-review.test.ts.