Skip to content

Build your personal knowledge base with Trilium Notes

docs: show inline icons on text editor and Note Revisions pages

Claudecffc4d3c0e95
diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/Notes/Note Revisions.md b/docs/User Guide/User Guide/Basic Concepts and Features/Notes/Note Revisions.md
index 31d9ea5b00..045b7a4f87 100644
--- a/docs/User Guide/User Guide/Basic Concepts and Features/Notes/Note Revisions.md
+++ b/docs/User Guide/User Guide/Basic Concepts and Features/Notes/Note Revisions.md
@@ -3,7 +3,7 @@
Trilium supports seamless versioning of notes by storing snapshots ("revisions") of notes at regular intervals.
-To display the revisions, press the <a class="reference-link" href="../UI%20Elements/Note%20menu.md">Note menu</a> and select _Note revisions…_
+To display the revisions, press the <a class="reference-link" href="../UI%20Elements/Note%20menu.md">Note menu</a> and select _Note revisions…_ (<span class="tn-icon bx bx-history"></span>).
## Interaction
@@ -14,16 +14,16 @@ To display the revisions, press the <a class="reference-link" href="../UI%20Ele
* The revisions are grouped by the date the revision was taken.
* This list does not contain the _current state_ of the note, so it is possible to have notes with no revisions/snapshots saved.
* The icon of a revision indicates the _source_ of that revision (e.g. a <span class="tn-icon bx bx-save"></span> icon for a manually saved revision).
-* Pressing the \[…\] on the top-right of the dialog displays multiple options, including:
- * Saving a new revision now.
+* Pressing the <span class="tn-icon bx bx-dots-horizontal-rounded"></span> button on the top-right of the dialog displays multiple options, including:
+ * <span class="tn-icon bx bx-save"></span> Saving a new revision now.
* Checking the interval and limit for this note (see below).
- * Deleting all the revisions of this note.
+ * <span class="tn-icon bx bx-trash"></span> Deleting all the revisions of this note.
* For supported notes (text, code), changes are highlighted. This behavior can be toggled via the _Highlight changes_ at the top of the dialog.
* The highlighted changes are relative to the **current state of the note**, not to the revision prior to this one.
* For any given revision, the buttons on the top-right allow operating on it:
- * Deleting the revision.
- * Downloading the revision locally.
- * Restoring the revision, which replaces the current content of the note with the one from the revision. Another revision is saved containing the current content of the note.
+ * <span class="tn-icon bx bx-trash"></span> Deleting the revision.
+ * <span class="tn-icon bx bx-download"></span> Downloading the revision locally.
+ * <span class="tn-icon bx bx-history"></span> Restoring the revision, which replaces the current content of the note with the one from the revision. Another revision is saved containing the current content of the note.
## Named revisions
@@ -32,11 +32,11 @@ Named revisions are a new feature of Trilium v0.103.0 which allows adding a shor
In the list of note revisions:
* The name of the revision is displayed underneath the time of the revision in the sidebar, as well as at the top of the dialog where it is displayed in full.
-* Clicking on the edit button near the name of the revision allows it to be changed.
+* Clicking on the <span class="tn-icon bx bx-edit-alt"></span> edit button near the name of the revision allows it to be changed.
To create a named revision, either:
-* Go to the <a class="reference-link" href="../UI%20Elements/Note%20menu.md">Note menu</a>, select _Save named revision…_, enter the name of revision and confirm.
+* Go to the <a class="reference-link" href="../UI%20Elements/Note%20menu.md">Note menu</a>, select _Save named revision…_ (<span class="tn-icon bx bx-purchase-tag"></span>), enter the name of revision and confirm.
* Use the corresponding [keyboard shortcut](../Keyboard%20Shortcuts.md) or the <a class="reference-link" href="../Navigation/Jump%20to%20%26%20command%20palette.md">Jump to &amp; command palette</a> command with the same name.
* Save a revision normally, and adjust the name afterwards from the note revision list.
@@ -46,15 +46,15 @@ Revisions are saved:
* Automatically at a fixed interval. This behavior can be configured (see below).
* Manually, by:
- * Going to the press the [note context menu](../UI%20Elements/Note%20menu.md) and select _Save revision._
+ * Going to the <a class="reference-link" href="../UI%20Elements/Note%20menu.md">Note menu</a> and selecting _Save revision_ (<span class="tn-icon bx bx-save"></span>).
* Using the _Force Save Revision_ [keyboard shortcut](../Keyboard%20Shortcuts.md).
- * In the _Revisions_ dialog, pressing the \[…\] button in the top-right and selecting _Save a revision now_.
+ * In the _Note Revisions_ dialog, pressing the <span class="tn-icon bx bx-dots-horizontal-rounded"></span> button in the top-right and selecting _Save a revision now_.
Additionally, revisions can also come from somewhere else, and this is indicated via the icon of the revision:
-* Generated externally, by <a class="reference-link" href="../../Advanced%20Usage/ETAPI%20(REST%20API).md">ETAPI (REST API)</a>.
-* A modification created by <a class="reference-link" href="../../AI.md">AI</a>.
-* A revision is restored, causing the existing note content to be saved as a revision to prevent potential data loss.
+* <span class="tn-icon bx bx-code-alt"></span> Generated externally, by <a class="reference-link" href="../../Advanced%20Usage/ETAPI%20(REST%20API).md">ETAPI (REST API)</a>.
+* <span class="tn-icon bx bx-bot"></span> A modification created by <a class="reference-link" href="../../AI.md">AI</a>.
+* <span class="tn-icon bx bx-history"></span> A revision is restored, causing the existing note content to be saved as a revision to prevent potential data loss.
#### Snapshot interval
@@ -68,4 +68,4 @@ The limit on the number of note snapshots can be configured in the Options → O
The note limit will not take effect immediately; it will only apply when the note is modified.
-You can click the _Erase excess revision snapshots now_ button to apply the changes immediately.
\ No newline at end of file
+You can click the _Erase now_ button under _Erase excess revision snapshots_ to apply the changes immediately.
\ No newline at end of file
diff --git a/docs/User Guide/User Guide/Note Types/Text/Anchors.md b/docs/User Guide/User Guide/Note Types/Text/Anchors.md
index bc37c3f25b..32714dd4ec 100644
--- a/docs/User Guide/User Guide/Note Types/Text/Anchors.md
+++ b/docs/User Guide/User Guide/Note Types/Text/Anchors.md
@@ -39,7 +39,7 @@ Clicking on a reference link pointing to a anchor will automatically scroll to t
1. Create an anchor in the target note using the same process as described above.
2. Click on the anchor to reveal the anchor's floating toolbar.
-3. Click on the _Copy anchor reference link_ button.
+3. Click on the <span class="tn-icon cke cke-trilium-copy"></span> _Copy anchor reference link_ button.
4. Go to the note where to insert the link and press <kbd>Ctrl</kbd>+<kbd>V</kbd>.
> [!NOTE]
diff --git a/docs/User Guide/User Guide/Note Types/Text/Block references.md b/docs/User Guide/User Guide/Note Types/Text/Block references.md
index 1c3f1a9826..bef82dfc54 100644
--- a/docs/User Guide/User Guide/Note Types/Text/Block references.md
+++ b/docs/User Guide/User Guide/Note Types/Text/Block references.md
@@ -29,7 +29,7 @@ Clicking a block reference opens the note, scrolls to the referenced blocks and
To show the referenced blocks inside another note, right-click the link in a note being edited and select _Convert link to note excerpt_, or paste the copied reference with _Paste_ → _Paste reference as an excerpt_. The include shows only the referenced blocks, not the rest of the note, and marks them with an _Excerpt_ badge in its title. It starts at the _Full_ box size, so all the referenced blocks are visible. To see the whole note, press the <span class="tn-icon bx bx-link-external"></span> button in the same title, which opens the note in a new tab. Converting the include back to a link keeps the reference.
-To edit the referenced blocks without leaving the note, press the <span class="tn-icon bx bx-pencil"></span> _Edit excerpt_ button in the title of the include, or turn on _Editable_ in its toolbar, as for any <a class="reference-link" href="Include%20Note.md">Include Note</a>. Press the button again to stop editing. The changes are saved to the referenced blocks, and the rest of the note stays as it is. The button is grayed out where the blocks cannot be edited, such as in a read-only note. An excerpt has no _Fullscreen_ button.
+To edit the referenced blocks without leaving the note, press the <span class="tn-icon bx bx-pencil"></span> _Edit excerpt_ button in the title of the include, or turn on _Editable_ (<span class="tn-icon bx bx-edit-alt"></span>) in its toolbar, as for any <a class="reference-link" href="Include%20Note.md">Include Note</a>. Press the button again to stop editing. The changes are saved to the referenced blocks, and the rest of the note stays as it is. The button is grayed out where the blocks cannot be edited, such as in a read-only note. An excerpt has no _Fullscreen_ button.
If a referenced block was deleted, the include shows _Broken reference_.
diff --git a/docs/User Guide/User Guide/Note Types/Text/Content tabs.md b/docs/User Guide/User Guide/Note Types/Text/Content tabs.md
index 1e83b5d794..508bf4afe3 100644
--- a/docs/User Guide/User Guide/Note Types/Text/Content tabs.md
+++ b/docs/User Guide/User Guide/Note Types/Text/Content tabs.md
@@ -45,7 +45,7 @@ In read-only notes, a title too long for its tab fades out where it is cut off.
A link can point to a single tab, much like a link to a block (see <a class="reference-link" href="Block%20references.md">Block references</a>):
1. Place the cursor in the tab, either in its title or in its panel.
-2. Press _Copy link to tab_ in the toolbar of the tabs block. Alternatively, right-click the text and select _Copy_ → _Copy link to this tab_. The tab flashes briefly.
+2. Press _Copy link to tab_ (<span class="tn-icon cke cke-link"></span>) in the toolbar of the tabs block. Alternatively, right-click the text and select _Copy_ → _Copy link to this tab_. The tab flashes briefly.
3. Go to the note where to insert the link and press <kbd>Ctrl</kbd>+<kbd>V</kbd>.
The link shows the title of the note, followed by the title of the tab. Clicking it opens the note, shows the tab and flashes it. As with any block reference, the link can be turned into an <a class="reference-link" href="Include%20Note.md">Include Note</a> that shows only that tab.
diff --git a/docs/User Guide/User Guide/Note Types/Text/Format Painter.md b/docs/User Guide/User Guide/Note Types/Text/Format Painter.md
index 8231289c96..e397a98715 100644
--- a/docs/User Guide/User Guide/Note Types/Text/Format Painter.md
+++ b/docs/User Guide/User Guide/Note Types/Text/Format Painter.md
@@ -5,9 +5,9 @@ The Format Painter is a feature in text notes that allows users to copy the form
## Usage Instructions
-Click the text that you want to copy the formatting from and use the paint formatting toolbar button (<span class="tn-icon cke cke-paint-roller"></span>) to copy the style. Then select the target text with your mouse to apply the formatting.
+Click the text that you want to copy the formatting from and use the _Copy formatting_ toolbar button (<span class="tn-icon cke cke-paint-roller"></span>) to copy the style. Then select the target text with your mouse to apply the formatting.
-* **To copy the formatting**: Place the cursor inside text with some formatting and click the paint formatting toolbar button. The mouse cursor changes to indicate the painter is armed.
+* **To copy the formatting**: Place the cursor inside text with some formatting and click the _Copy formatting_ toolbar button. The mouse cursor changes to indicate the painter is armed.
* **To paint with the copied formatting**: Select the target text with your mouse. The formatting is applied when you release the button, and the painter disarms — the cursor returns to normal.
* **To cancel without painting**: Click the toolbar button again or press <kbd>Escape</kbd>.
diff --git a/docs/User Guide/User Guide/Note Types/Text/General formatting.md b/docs/User Guide/User Guide/Note Types/Text/General formatting.md
index ecc8cbb0a8..e12d45d371 100644
--- a/docs/User Guide/User Guide/Note Types/Text/General formatting.md
+++ b/docs/User Guide/User Guide/Note Types/Text/General formatting.md
@@ -23,7 +23,7 @@ Apart from using the UI, it is also possible to quickly insert headings using th
One way to highlight a portion of text is to increase the size of the font.
-To do so, select some text and choose an option from the _Font size_ selector (as pictured to the right).
+To do so, select some text and choose an option from the _Font size_ (<span class="tn-icon cke cke-font-size"></span>) selector (as pictured to the right).
Unlike other text editors such as Microsoft Word, the font size is relative (i.e. “Tiny”, “Small” instead of a number like 12).
@@ -33,9 +33,9 @@ Avoid using this feature just to simply make all text bigger. In that case it's
<figure class="image image-style-align-right"><img style="aspect-ratio:215/71;" src="3_General formatting_image.png" width="215" height="71"></figure>
-Text can be formatted as **Bold,** _Italic,_ Underline or ~~Strike-through~~ via the dedicated buttons in the formatting toolbar.
+Text can be formatted as **Bold,** _Italic,_ Underline or ~~Strike-through~~ via the dedicated buttons (<span class="tn-icon cke cke-bold"></span>, <span class="tn-icon cke cke-italic"></span>, <span class="tn-icon cke cke-underline"></span>, <span class="tn-icon cke cke-strikethrough"></span>) in the formatting toolbar.
-This formatting can be easily removed using the _Remove formatting_ item.
+This formatting can be easily removed using the _Remove formatting_ (<span class="tn-icon cke cke-remove-format"></span>) item.
The following keyboard shortcuts can be used here:
@@ -61,7 +61,7 @@ For mathematical formulas, prefer the <a class="reference-link" href="Math%20Eq
<figure class="image image-style-align-right"><img style="aspect-ratio:167/204;" src="1_General formatting_image.png" width="167" height="204"></figure>
-Selected text can be colored with one of the predefined colors from a palette or any color can be selected using the color picker.
+Selected text can be colored with one of the predefined colors from a palette or any color can be selected using the color picker (<span class="tn-icon cke cke-color-palette"></span>).
Once there is at least one color defined in the document, it will appear in the list for easy reuse.
@@ -85,7 +85,7 @@ The following formatting is preserved:
Colors are preserved when pasting from Word, Google Docs or another note.
-To remove either the background or foreground color of a text, select the corresponding formatting button and press _Remove color_ or use the _Remove formatting_ toolbar item.
+To remove either the background or foreground color of a text, select the corresponding formatting button (<span class="tn-icon cke cke-font-color"></span> or <span class="tn-icon cke cke-font-background"></span>) and press _Remove color_ (<span class="tn-icon cke cke-eraser"></span>) or use the _Remove formatting_ (<span class="tn-icon cke cke-remove-format"></span>) toolbar item.
## Remove formatting
diff --git a/docs/User Guide/User Guide/Note Types/Text/Images.md b/docs/User Guide/User Guide/Note Types/Text/Images.md
index 66ac643605..db3088444b 100644
--- a/docs/User Guide/User Guide/Note Types/Text/Images.md
+++ b/docs/User Guide/User Guide/Note Types/Text/Images.md
@@ -8,7 +8,7 @@ An image can be uploaded in the form of note's [attachment](../../Basic%20Concep
To add an image to the note:
* Simply drag it from file explorer onto the note editor inside Trilium and the image will be uploaded.
-* Alternatively, from the <a class="reference-link" href="Formatting%20toolbar.md">Formatting toolbar</a> look for the _Insert image_ icon.
+* Alternatively, from the <a class="reference-link" href="Formatting%20toolbar.md">Formatting toolbar</a> look for the <span class="tn-icon cke cke-image-upload"></span> _Upload image from computer_ button.
* You can also copy and paste an image from web (see section below).
> [!TIP]
diff --git a/docs/User Guide/User Guide/Note Types/Text/In-editor AI assistant.md b/docs/User Guide/User Guide/Note Types/Text/In-editor AI assistant.md
index 7f18ea7545..28c0e35fae 100644
--- a/docs/User Guide/User Guide/Note Types/Text/In-editor AI assistant.md
+++ b/docs/User Guide/User Guide/Note Types/Text/In-editor AI assistant.md
@@ -40,19 +40,19 @@ Actions that need something to work on are greyed out when there is nothing to w
## Asking for something specific
-Choosing _Ask AI…_ opens a prompt where you can describe the change in your own words, for example: "make this less formal", "add a row for 2024", "write an intro paragraph for this section". Press <kbd>Enter</kbd> or the send button to run it.
+Choosing _Ask AI…_ (<span class="tn-icon bx bx-message-square-dots"></span>) opens a prompt where you can describe the change in your own words, for example: "make this less formal", "add a row for 2024", "write an intro paragraph for this section". Press <kbd>Enter</kbd> or the <span class="tn-icon cke cke-arrow-up"></span> send button to run it.
Once a response arrives you can keep going in the same prompt, and the assistant treats it as a conversation rather than as a fresh request: after _Translate this to German_, asking for _make it shorter_ shortens the German, not the original.
## Reviewing the result
-The response streams in as it is generated, and can be interrupted at any point by pressing the _Stop_ button; whatever arrived before that stays usable.
+The response streams in as it is generated, and can be interrupted at any point by pressing the _Stop_ (<span class="tn-icon cke cke-stop"></span>) button; whatever arrived before that stays usable.
Nothing is written into the note until you say so. The review offers:
* _Result_, which displays the response as it will be inserted.
* _Changes_, which displays an inline diff against the original, with insertions and deletions marked. When the model rewrote the passage rather than editing it, the review opens on _Result_ instead: a diff of two texts with little in common is harder to read than the answer itself.
-* _Try again_, to re-run the same instruction.
+* _Try again_ (<span class="tn-icon cke cke-refresh"></span>), to re-run the same instruction.
* _Replace_, which substitutes the original passage
* _Insert below_, which keeps the original and adds the response after it.
diff --git a/docs/User Guide/User Guide/Note Types/Text/In-editor AI assistant/Custom AI quick actions.md b/docs/User Guide/User Guide/Note Types/Text/In-editor AI assistant/Custom AI quick actions.md
index d40f698dc2..5abc92ba9f 100644
--- a/docs/User Guide/User Guide/Note Types/Text/In-editor AI assistant/Custom AI quick actions.md
+++ b/docs/User Guide/User Guide/Note Types/Text/In-editor AI assistant/Custom AI quick actions.md
@@ -21,4 +21,4 @@ Of note:
## Using a quick action
-Once a quick action is defined, the actoin will appear under the _Quick Actions_ dropdown in a group called _Custom_.
\ No newline at end of file
+Once a quick action is defined, the action will appear under the _Quick Actions_ dropdown in a group called _Custom_.
\ No newline at end of file
diff --git a/docs/User Guide/User Guide/Note Types/Text/Link Previews.md b/docs/User Guide/User Guide/Note Types/Text/Link Previews.md
index e1a0a253f4..360b98ae40 100644
--- a/docs/User Guide/User Guide/Note Types/Text/Link Previews.md
+++ b/docs/User Guide/User Guide/Note Types/Text/Link Previews.md
@@ -51,7 +51,7 @@ If the link is not accessible to the Trilium server (or the network request fail
### 2\. By using the "Link preview" toolbar button
-Click _Link preview_ in the formatting toolbar to open the _Link preview_ popup. Paste the URL and choose the type of preview.
+Click _Link preview_ (<span class="tn-icon cke cke-trilium-link-preview"></span>) in the formatting toolbar to open the _Link preview_ popup. Paste the URL and choose the type of preview.
### 3\. By saving browser tabs from the Web Clipper