Repository navigation
Tropa starts on a vault you already have and keeps review in check: links suggested from your notes, a map from a pasted list, a daily limit and a pause for reviews, a tropa block for any note, the status bar and page previews of the map's nodes. Requires Obsidian 1.13.0 or later, as before. Update Tropa on every device that shares the vault: a device still on 0.4 does not see a pause and ignores the moves that spread reviews, so its review dates may differ by up to three days until it is updated. The new strings are machine translations into all 33 languages and wait for review by native speakers, especially Arabic, Persian, Hebrew, Bengali and Thai. No new dependencies.
Added
- Suggested links. The command Suggest links from your notes, a button on the empty map and an item in the file menu of a folder or a note read the links your notes already have and offer them as
requiresandrecommends: consecutive items of a list of at least three linked notes (each needs the one before it, ticked), a link in the text that is not returned (the linked note is needed first) and links both ways (recommended). Pairs the map already links, materials, notes with anothertype, notes out of the map's scope and embeds are left out. - A preview lists them by where they were found; each row reads "A needs B", with a box and the kind to change. A needed link that would close a loop, with the map or with the other ticked rows, is refused and the loop is shown; it can still be added as recommended. Up to 500 suggestions at once.
- Add links writes the batch, one write per note, and gives a note that is not a concept yet
type: concept. Undo in the notice and the command Undo the last suggested links put back each property the batch changed, except in notes changed since. - Reviews a day. Today's queue keeps to a daily limit (Settings → Review, 20 by default, or no limit): the concepts easiest to forget come first, and at the same chance to recall, those the goals lead through. The rest wait for the next days, and the head of Review today says how many of all are shown (
20 of 37). Reviews already done today count, so the queue does not refill as it empties. A concept over the limit has no badge on the map and keeps its ratings behind Review now. - Spread reviews evenly (on by default). A rating may move the next review by up to 5% of the interval, three days at most, to the least busy day nearby. The move is written into the review line as
shift=N, so every device replays the same day; it changes only the due date, never what FSRS knows, and is ignored once it no longer fits the interval. - Pause review with the day it comes back, from the head of Review today or the command, and Resume review. Both go to the journal (
pause - until=YYYY-MM-DD,resume -), so every device pauses. While paused nothing is due; afterwards what came due meanwhile is spread over as many days as the pause lasted, two weeks at most. - Map from a list. The command Create a map from a list and a button on the empty map take a pasted Markdown list (nesting by indentation), headings (by level) or a book's table of contents (by
1.2.3numbers, page numbers dropped) and make a concept of each line. An item uses a note already in the vault when its line links to one or a concept or note has its name, case and accents aside; repeated names are one note; characters a file name cannot have are left out of the file name, and a missing note the map links to keeps its spelling. - Nesting gives
requireseither way, a topic needing what is under it (default) or the reverse; neighbours of one level can need the one before them (off by default). The preview lists the new notes, the notes already in the vault and the links, with the same loop refusal as suggested links. Create makes the notes withtype: conceptand writes the links; Undo and the command Undo the last map from a list move the new notes to the trash and put back the other notes' properties, except notes changed since. The pasted list is kept until it is used. - The notice after a map from a list also offers Set … as goal for the first item at the top: it adds the goal like Add as goal, with its journal line, and an undo of the map takes that goal back.
- The
tropablock. A code block in any note shows the route (show: route, the default), today's review queue (show: review) or the next step alone (show: next), to the active goal or togoal: [[…]](withshow: review, only today's reviews on the way to that goal: the goal and what it requires, transitively, filtered after the daily limit, with those of the goal over the limit counted as waiting),limitrows at most (10 by default, up to 100). Rows are links that open and preview like any link; a box marks a step mastered (offering a self-check first) or asks how well a review went, with an undo. The block follows the progress and the queue, and says what is wrong with its options instead of failing. - The status bar (desktop) shows how many concepts are due today and the next step, or the day a paused review comes back; a click opens the queue or the next step. Settings → Status bar turns it off.
- Page preview of the map's nodes. Hovering a node with Ctrl or Cmd shows its note, through the core Page preview plugin, where Tropa is listed as a source.
Changed
- A concept mastered away from the map, from a command or a
tropablock, gets a notice with Undo, as other changes made there already did. The notice is left to the map only while the map is in sight. - Review today lists the concepts easiest to forget first, instead of the longest overdue first.
- Update Tropa on every device that shares the vault. A device still on 0.4 skips the
pauseandresumelines and ignoresshift=N: it does not see the pause, and its review dates may differ by up to three days. Nothing breaks, and the dates agree again once all devices run 0.5. - The layout benchmark moved from
benchtoscripts/bench. It is not part of the plugin.
Layout engine WebAssembly (inlined in main.js), sha256 a88682595bad6ac1378b5cd6017b37b0d1d93591b11d2f50eb48a1126214d4cc. Rebuild it from the source of this tag with npm run build:wasm.