Skip to content

Build your personal knowledge base with Trilium Notes

docs: show inline icons on Geo Map, scripting and bulk actions pages

Claude5f1cd90da685
diff --git a/docs/User Guide/User Guide/Advanced Usage/Bulk Actions.md b/docs/User Guide/User Guide/Advanced Usage/Bulk Actions.md
index c11e58dc3b..167487b76a 100644
--- a/docs/User Guide/User Guide/Advanced Usage/Bulk Actions.md
+++ b/docs/User Guide/User Guide/Advanced Usage/Bulk Actions.md
@@ -10,11 +10,11 @@ The _Bulk Actions_ dialog makes it easy to apply changes to multiple notes at on
* Multiple notes. See <a class="reference-link" href="../Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tree/Multiple%20selection.md">Multiple selection</a> on how to do so.
* Right click in the <a class="reference-link" href="../Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tree.md">Note Tree</a> and select _Advanced_ → _Apply bulk actions_.
* The _Selected notes_ section at the top of the dialog lists the notes the actions apply to. When many notes are selected, only the first few are shown; click _+N more_ to show the rest.
- * To leave a note out without changing the selection in the note tree, press the X button on its entry. The last remaining note cannot be removed.
+ * To leave a note out without changing the selection in the note tree, press the <span class="tn-icon bx bx-x"></span> button on its entry. The last remaining note cannot be removed.
* By default, only the selected notes will be affected. To also include all the descendants of the notes, turn on _Include descendants of the selected notes_. The number of affected notes, shown below that option, updates to reflect the change.
-* To add an action, click _Add action_ at the bottom of the _Chosen actions_ section and pick one from the menu. Hovering over an entry shows a short description of what it does; a detailed description of each is available in the next section.
+* To add an action, click _Add action_ (<span class="tn-icon bx bx-plus"></span>) at the bottom of the _Chosen actions_ section and pick one from the menu. Hovering over an entry shows a short description of what it does; a detailed description of each is available in the next section.
* Each chosen action appears as an entry in the _Chosen actions_ section, with its own configuration.
- * To remove an action, simply press the X button to the right of it.
+ * To remove an action, simply press the <span class="tn-icon bx bx-x"></span> button to the right of it.
* It is possible to apply multiple actions of the same type, such as adding multiple types.
* The fields for a label or relation name suggest the names already used in the database as you type, marking the ones Trilium itself attaches a meaning to.
* The value field of _Add label_ and _Update label value_ suggests the values the named label already has in the database.
diff --git a/docs/User Guide/User Guide/Collections/Geo Map.md b/docs/User Guide/User Guide/Collections/Geo Map.md
index 68d017951f..4fb85f1146 100644
--- a/docs/User Guide/User Guide/Collections/Geo Map.md
+++ b/docs/User Guide/User Guide/Collections/Geo Map.md
@@ -23,14 +23,14 @@ The button that shows your location is offered only when Trilium is reached over
## Interaction
-* At the top-left there is the search bar. It searches the notes already on the map, and it can also search for places online when you ask it to. While you move through the results of a search, a counter with previous and next buttons appears under it.
-* At the bottom-center there is a central toolbar which provides editing features: adding new markers on the map and importing GPX tracks.
+* At the top-left there is the search bar. It searches the notes already on the map, and it can also search for places online when you ask it to. While you move through the results of a search, a counter with previous (<span class="tn-icon bx bx-chevron-left"></span>) and next (<span class="tn-icon bx bx-chevron-right"></span>) buttons appears under it.
+* At the bottom-center there is a central toolbar which provides editing features: adding new markers on the map (<span class="tn-icon bx bx-pin"></span>) and importing GPX tracks (<span class="tn-icon bx bx-trip"></span>).
* At the bottom-right there are the viewport items:
- * Zoom in/out
+ * Zoom in/out (<span class="tn-icon bx bx-plus-circle"></span> / <span class="tn-icon bx bx-minus-circle"></span>)
* On mobile these are hidden, use pinch to zoom instead.
* On desktop, alternatively use the scroll wheel to adjust the zoom.
- * A button that shows your location on the map and follows it (see _Going to your location_ below).
- * Full screen button which focuses the entire map onto the screen, while still allowing for edits.
+ * A <span class="tn-icon bx bx-current-location"></span> button that shows your location on the map and follows it (see _Going to your location_ below).
+ * <span class="tn-icon bx bx-fullscreen"></span> Full screen button which focuses the entire map onto the screen, while still allowing for edits.
* At the top-center (on desktop, or left-center on mobile and in split views) there are the drawing tools such as paths, areas, rectangles and circles.
* When the map is read-only, the toolbar is not shown.
@@ -53,7 +53,7 @@ In practice this applies to maps whose markers were added externally, by a scrip
## Going to your location
-Press the _Show your location_ button at the bottom-right of the map, beside the zoom buttons. The first time, the browser or the operating system asks whether Trilium may know where the device is. In the desktop application the operating system's location settings decide.
+Press the _Show your location_ (<span class="tn-icon bx bx-current-location"></span>) button at the bottom-right of the map, beside the zoom buttons. The first time, the browser or the operating system asks whether Trilium may know where the device is. In the desktop application the operating system's location settings decide.
The map then moves to where the device is and marks it with a blue dot. A lighter circle around the dot shows how accurate the position is: a phone with GPS gives a dot on the street, while a computer located through its network connection can give a circle that covers a neighbourhood. The map follows the dot as it moves, and the button stays pressed while it does.
@@ -125,20 +125,20 @@ Press the panel's close button, or the Escape key, to send the place away withou
### Stepping through the results
-Once you select a result, a counter appears under the search bar, with a previous and a next button. These buttons move through everything the search offered, in the order it was listed. You can therefore compare several results without opening the list again. Pressing the counter itself moves the map back to the current result, which is useful after you have moved the map away from it.
+Once you select a result, a counter appears under the search bar, with a previous (<span class="tn-icon bx bx-chevron-left"></span>) and a next (<span class="tn-icon bx bx-chevron-right"></span>) button. These buttons move through everything the search offered, in the order it was listed. You can therefore compare several results without opening the list again. Pressing the counter itself moves the map back to the current result, which is useful after you have moved the map away from it.
### The keyboard
* <kbd>Enter</kbd> runs the online search when its row is the one selected, and otherwise moves to the highlighted result. Pressed after a result has been taken, it brings the list back.
* <kbd>Escape</kbd> closes the result list, and closes the place panel.
* Returning to the search bar reopens the list it was showing.
-* The **X** at the end of the bar empties it, which also takes a searched place, its pin and its panel off the map.
+* The <span class="tn-icon bx bx-x"></span> button at the end of the bar empties it, which also takes a searched place, its pin and its panel off the map.
## Adding a marker using the map
-### Adding a new note using the plus button
+### Adding a new note using the _Add marker_ button
-1. To create a marker, first navigate to the desired point on the map. Then press the _Add marker_ button at the center-bottom of the map.
+1. To create a marker, first navigate to the desired point on the map. Then press the _Add marker_ (<span class="tn-icon bx bx-pin"></span>) button at the center-bottom of the map.
2. Once pressed, the map will enter in the insert mode, as illustrated by the notification. Additionally, a preview of the marker will be shown at the cursor position.
Simply click the point on the map where to place the marker. To cancel, press either the  Escape key or press again the _Add marker_ button.
@@ -147,7 +147,7 @@ Once you select a result, a counter appears under the search bar, with a previou
### Adding a new note using the contextual menu
1. Right click anywhere on the map, where to place the newly created marker (and corresponding note).
-2. Select _Add a marker at this location_.
+2. Select _Add a marker at this location_ (<span class="tn-icon bx bx-pin"></span>).
3. Once clicked on a position on the map, the marker will show up on the map and a popup will show to the right with the title already selected to be changed.
### Adding an existing note from the note tree
@@ -195,8 +195,8 @@ On an image map, the position is stored in `#mapPosition` instead (see <a class
Once a marker is set, it can be repositioned using one of the two ways:
-* By right clicking the marker and selecting _Move to another location_.
-* By clicking the marker to open the popup and selecting the _Move to another location_ button underneath the title bar.
+* By right clicking the marker and selecting _Move to another location_ (<span class="tn-icon bx bx-move"></span>).
+* By clicking the marker to open the popup and selecting the _Move to another location_ (<span class="tn-icon bx bx-move"></span>) button underneath the title bar.
After clicking the button to move the marker, click at the desired position on the map to replace it. To cancel the operation, press Escape.
@@ -215,14 +215,14 @@ After clicking the button to move the marker, click at the desired position on t
When a marker, a [shape](Geo%20Map/Drawing%20shapes.md), or track is clicked, a popup will open to the right which contains the following information:
* The title and icon of the marker, both editable.
-* An indicator for the coordinates; clicking it will copy the coordinates to clipboard.
-* A button to maximize the popup.
+* An indicator for the coordinates (<span class="tn-icon bx bx-crosshair"></span>); clicking it will copy the coordinates to clipboard.
+* A <span class="tn-icon bx bx-expand-alt"></span> button to maximize the popup.
* Buttons to interact with the current item:
- * Open the marker in the same pane, new tab, etc.
- * A button to open the location in a dedicated application (e.g. Google Maps on mobile).
- * Color picker to change the color of the marker.
- * Markers can also be moved, unlike tracks or shapes (which need to be redrawn).
- * Button to remove the marker from the map, which can optionally delete its corresponding note.
+ * <span class="tn-icon bx bx-log-in"></span> Open the marker in the same pane, or use <span class="tn-icon bx bx-dots-horizontal-rounded"></span> to open it in a new tab, split, etc.
+ * A <span class="tn-icon bx bx-map-alt"></span> button to open the location in a dedicated application (e.g. Google Maps on mobile).
+ * <span class="tn-icon bx bx-palette"></span> Color picker to change the color of the marker.
+ * <span class="tn-icon bx bx-move"></span> Markers can also be moved, unlike tracks or shapes (which need to be redrawn).
+ * <span class="tn-icon bx bx-trash"></span> Button to remove the marker from the map, which can optionally delete its corresponding note.
* Removing a marker without deleting the note will only remove its `#geolocation` attribute (case in which the coordinates have to be manually added back in in order to get the note to show on the map again).
* Similarly, removing a shape will remove its `#geoShape` attribute.
* The <a class="reference-link" href="../Advanced%20Usage/Attributes/Promoted%20Attributes.md">Promoted Attributes</a> of the marker, if any.
@@ -245,14 +245,15 @@ Markers can have <a class="reference-link" href="../Note%20Types/Text/Links/Int
It's possible to press the right mouse button to display a contextual menu.
1. If right-clicking an empty section of the map (not on a marker), it allows to:
- 1. Displays the latitude and longitude. Clicking this option will copy them to the clipboard.
- 2. Open the location using an external application (if the operating system supports it).
- 3. Adding a new marker at that location.
+ 1. <span class="tn-icon bx bx-crosshair"></span> Displays the latitude and longitude. Clicking this option will copy them to the clipboard.
+ 2. <span class="tn-icon bx bx-map-alt"></span> Open the location using an external application (if the operating system supports it).
+ 3. <span class="tn-icon bx bx-pin"></span> Adding a new marker at that location.
2. If right-clicking on a marker, it allows to:
- 1. Displays the latitude and longitude. Clicking this option will copy them to the clipboard.
- 2. Open the location using an external application (if the operating system supports it).
+ 1. <span class="tn-icon bx bx-crosshair"></span> Displays the latitude and longitude. Clicking this option will copy them to the clipboard.
+ 2. <span class="tn-icon bx bx-map-alt"></span> Open the location using an external application (if the operating system supports it).
3. Open the note in a new tab, split or window.
- 4. Button to remove the marker from the map, which can optionally delete its corresponding note. Removing a marker without deleting the note will only remove its `#geolocation` attribute (case in which the coordinates have to be manually added back in in order to get the note to show on the map again).
+ 4. <span class="tn-icon bx bx-move"></span> Move the marker to another location.
+ 5. <span class="tn-icon bx bx-trash"></span> Button to remove the marker from the map, which can optionally delete its corresponding note. Removing a marker without deleting the note will only remove its `#geolocation` attribute (case in which the coordinates have to be manually added back in in order to get the note to show on the map again).
3. Shapes can also be right-clicked and the menu is similar to markers except they cannot be moved.
### Icon and color
@@ -310,7 +311,7 @@ To add a track, either:
1. Drag & drop a `.gpx` file inside the geo map in the note tree.
1. In order for the file to be recognized as a GPS track, it needs to show up as `application/gpx+xml` in the _File type_ field.
-2. Press the _Add a GPS track from a GPX file_ which will directly prompt for a GPX file and import it as a subnote of the collection.
+2. Press the _Add a GPS track from a GPX file_ (<span class="tn-icon bx bx-trip"></span>) button which will directly prompt for a GPX file and import it as a subnote of the collection.
When going back to the map, the track should now be visible.
@@ -328,7 +329,7 @@ When clicking on the markers of a track (whether it's the start or stop builtin
When a map is [read-only](../Basic%20Concepts%20and%20Features/Notes/Read-Only%20Notes.md) all editing features will be disabled such as:
-* The add button at the bottom of the map.
+* The _Add marker_ (<span class="tn-icon bx bx-pin"></span>) button at the bottom of the map.
* Repositioning markers.
* Editing from the contextual menu (removing locations or adding new items).
* Keeping a place as a marker, whether you found it by searching or clicked it on the map. You can still search and click, and you can still look at a place and copy its coordinates.
@@ -362,7 +363,7 @@ The default theme is Versatiles Colorful (vector).
<figure class="image"><img style="aspect-ratio:2727/1642;" src="2_Geo Map_image.png" width="2727" height="1642"></figure>
-Trilium v0.105.0 introduces a 3D view, courtesy of MapLibre GL. To enter 3D mode, simply press the corresponding button at the bottom-right of the map or press Ctrl and drag across the map.
+Trilium v0.105.0 introduces a 3D view, courtesy of MapLibre GL. To enter 3D mode, simply press the _3D_ button at the bottom-right of the map or press Ctrl and drag across the map.
The buildings will only appear from zoom 14 onwards to avoid lag.
@@ -396,7 +397,7 @@ Custom vector map support is planned, but not yet implemented.
### Other options
-The following options can be configured either via the <a class="reference-link" href="Collection%20Properties.md">Collection Properties</a>, by clicking on the settings (Gear icon). Alternatively, each of these options also have a corresponding [label](../Advanced%20Usage/Attributes/Labels.md) that can be set manually.
+The following options can be configured either via the <a class="reference-link" href="Collection%20Properties.md">Collection Properties</a>, by clicking on the settings (<span class="tn-icon bx bx-cog"></span>) button. Alternatively, each of these options also have a corresponding [label](../Advanced%20Usage/Attributes/Labels.md) that can be set manually.
* Scale, which illustrates the scale of the map in either kilometers or miles in the bottom-left of the map.
* The unit is determined by the _Formatting locale_ option in _Language & Region_.
diff --git a/docs/User Guide/User Guide/Collections/Geo Map/Drawing shapes.md b/docs/User Guide/User Guide/Collections/Geo Map/Drawing shapes.md
index 3280e4e6db..66196702ee 100644
--- a/docs/User Guide/User Guide/Collections/Geo Map/Drawing shapes.md
+++ b/docs/User Guide/User Guide/Collections/Geo Map/Drawing shapes.md
@@ -13,13 +13,13 @@ Once a shape is drawn, it cannot be moved or modified. To do so, simply remove t
### Drawing a path or an area
-1. Press the _Draw a path on the map_ or _Draw an area on the map_ button. The button stays held down while the tool is armed, and a notification describes what to do.
+1. Press the _Draw a path on the map_ (<span class="tn-icon bx bx-vector"></span>) or _Draw an area on the map_ (<span class="tn-icon bx bx-shape-polygon"></span>) button. The button stays held down while the tool is armed, and a notification describes what to do.
2. Click on the map once for each point. The shape is previewed as it grows.
3. Finish it by pressing <kbd>Enter</kbd>. A path can also be finished by clicking its last point again, and an area by clicking the corner it started from. A path needs at least two points and an area at least three.
### Drawing a rectangle or a circle
-1. Press the _Draw a rectangle on the map_ or _Draw a circle on the map_ button.
+1. Press the _Draw a rectangle on the map_ (<span class="tn-icon bx bx-shape-square"></span>) or _Draw a circle on the map_ (<span class="tn-icon bx bx-shape-circle"></span>) button.
2. Click once to set the first corner, or the center of the circle. Click a second time at the opposite corner, or at the distance the circle should reach.
3. Instead of two clicks you can drag from one to the other. This also works on mobile and other touch-based apps.
diff --git a/docs/User Guide/User Guide/Scripting.md b/docs/User Guide/User Guide/Scripting.md
index 84eb8c5200..ae7e74a1db 100644
--- a/docs/User Guide/User Guide/Scripting.md
+++ b/docs/User Guide/User Guide/Scripting.md
@@ -20,17 +20,17 @@ Saving the note to the database is backend's responsibility, so we immediately p
## Script execution
-So we have a script which will add the button to the toolbar. But how can we execute it? One possibility is to click on "play" icon (marked by red circle). The problem with this is that this UI change is time bound by Trilium runtime so when we restart Trilium, button won't be there.
+So we have a script which will add the button to the toolbar. But how can we execute it? One possibility is to click on the <span class="tn-icon bx bx-play"></span> _Execute script_ button. The problem with this is that this UI change is time bound by Trilium runtime so when we restart Trilium, button won't be there.
We need to execute it every time Trilium starts up, but we probably don't want to have to manually click on play button on every start up.
-The solution is marked by red circle at the bottom - this note has [label](Advanced%20Usage/Attributes.md) `#run=frontendStartup` - this is one of the "system" labels which Trilium understands. As you might guess, this will cause all such labeled script notes to be executed once Trilium frontend starts up.
+The solution is to give the note the [label](Advanced%20Usage/Attributes.md) `#run=frontendStartup` - this is one of the "system" labels which Trilium understands. As you might guess, this will cause all such labeled script notes to be executed once Trilium frontend starts up.
(`#run=frontendStartup` does not work for [Mobile frontend](Installation%20%26%20Setup/Mobile%20Frontend.md) - if you want to have scripts running there, give the script `#run=mobileStartup` label).
### Execute button
-Runnable code notes (frontend or backend) and saved SQL consoles can optionally have a dedicated execute button alongside a description.
+Runnable code notes (frontend or backend) and saved SQL consoles can optionally have a dedicated <span class="tn-icon bx bx-play"></span> execute button alongside a description.
To do so, apply the following [labels](Advanced%20Usage/Attributes/Labels.md):
diff --git a/docs/User Guide/User Guide/Scripting/Breaking changes/v0.107.0 Removal of the old layout.md b/docs/User Guide/User Guide/Scripting/Breaking changes/v0.107.0 Removal of the old layout.md
index b11eecaa90..dc8bff80f0 100644
--- a/docs/User Guide/User Guide/Scripting/Breaking changes/v0.107.0 Removal of the old layout.md
+++ b/docs/User Guide/User Guide/Scripting/Breaking changes/v0.107.0 Removal of the old layout.md
@@ -39,9 +39,9 @@ Here's how all the different tabs that were once part of the ribbon are availabl
* Search definition tab
* Moved underneath the title under a collapsible area.
* Expanded by default for new searches, collapsed for saved searches.
-* The Note map is now in the Note actions menu.
+* The Note map is now in the <span class="tn-icon bx bx-dots-horizontal-rounded"></span> Note actions menu.
* Instead of opening into a panel in the ribbon, the note map now opens in the sidebar, in the <a class="reference-link" href="../../Basic%20Concepts%20and%20Features/UI%20Elements/Right%20Sidebar/Connections%20tab.md">Connections tab</a> where it can also be maximized.
-* “Note info” tab was moved to a small (i) icon in the status bar.
+* “Note info” tab was moved to a small <span class="tn-icon bx bx-info-circle"></span> icon in the status bar.
* “Similar notes” tab
* Instead of opening into a panel in the ribbon, the similar notes are now shown in the sidebar, in the <a class="reference-link" href="../../Basic%20Concepts%20and%20Features/UI%20Elements/Right%20Sidebar/Connections%20tab.md">Connections tab</a>.
* `similarNotesWidgetDisabled` no longer has any effect.
@@ -50,7 +50,7 @@ Here's how all the different tabs that were once part of the ribbon are availabl
* Individual settings for the current view in a submenu.
* Some smaller ribbon tabs were converted to badges that appear near the note title in the breadcrumb section:
* Original URL indicator for clipped web pages (`#pageUrl`).
- * SQL and script execute buttons.
+ * SQL and script <span class="tn-icon bx bx-play"></span> execute buttons.
> [!NOTE]
> The ribbon keyboard shortcuts (e.g. `toggleRibbonTabClassicEditor`) have been repurposed and renamed (_Focus Formatting Toolbar_, _Toggle Owned Attributes_, _Show Note Map_, etc.) to work on the new layout, where they will toggle the appropriate panel.
@@ -59,7 +59,7 @@ Here's how all the different tabs that were once part of the ribbon are availabl
Most of the buttons were relocated to the right of the note title, in the <a class="reference-link" href="../../Basic%20Concepts%20and%20Features/UI%20Elements/Note%20menu.md">Note menu</a> area, with the exception of:
-* The Edit button is displayed near the note title, as a badge.
+* The Edit button is replaced by the <span class="tn-icon bx bx-lock-alt"></span> _Read-only_ badge near the note title, which makes the note temporarily editable when clicked.
* _Backlinks_ are now displayed in the sidebar, in the <a class="reference-link" href="../../Basic%20Concepts%20and%20Features/UI%20Elements/Right%20Sidebar/Connections%20tab.md">Connections tab</a>.
* Alternatively, the backlinks count is displayed in the status bar and when clicked the sidebar opens at the right section.
* Relation map zoom buttons are now part of the relation map itself.
@@ -82,12 +82,12 @@ As such:
* The _Table of Contents_ card in Text Notes options (minimum number of headings) is gone. The  shows the table of contents whatever the number of headings.
* `#toc` / `#toc=show` / `#toc=hide` no longer have any effect.
-* `#hideHighlightWidget` no longer has any effect. The highlight categories are still set globally, from the gear menu or Text Notes options, but they can't be hidden for a single note.
+* `#hideHighlightWidget` no longer has any effect. The highlight categories are still set globally, from the <span class="tn-icon bx bx-cog"></span> menu of the Highlights list or Text Notes options, but they can't be hidden for a single note.
-In order to toggle the sidebar, there is a new button on the top-right side of the screen, near the window buttons (on Windows and Linux).
+In order to toggle the sidebar, there is a new <span class="tn-icon bx bx-sidebar bx-flip-horizontal"></span> button on the top-right side of the screen, near the window buttons (on Windows and Linux).
Now each section of the sidebar (e.g. “Table of Contents”, “Highlights list”) is individually collapsible and will remember whether it was collapsed.
-Some sidebar items also have a contextual menu, indicated by the three dots on the title. For example, the highlights filter can be adjusted directly from that menu. 
+Some sidebar items also have their own menu in the title. For example, the highlights filter can be adjusted directly from the <span class="tn-icon bx bx-cog"></span> menu of the Highlights list. 
-Custom widgets are still supported. For custom scripts, the three dots menu allows quick navigation to the corresponding script note.
\ No newline at end of file
+Custom widgets are still supported. For custom scripts, the <span class="tn-icon bx bx-dots-vertical-rounded"></span> menu allows quick navigation to the corresponding script note.
\ No newline at end of file
diff --git a/docs/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/Widget Basics.md b/docs/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/Widget Basics.md
index 2cac717a0a..52eecc0325 100644
--- a/docs/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/Widget Basics.md
+++ b/docs/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/Widget Basics.md
@@ -51,7 +51,7 @@ After making this change, reload Trilium. You should now see a button in the top
### Step 3: Styling the Widget
-To make the button more visually appealing and position it correctly, we'll apply some custom styling. Trilium includes [Box Icons](https://boxicons.com), which we'll use to replace the button text with an icon. For example the `bx bxs-magic-wand` icon.
+To make the button more visually appealing and position it correctly, we'll apply some custom styling. Trilium includes [Box Icons](https://boxicons.com), which we'll use to replace the button text with an icon. For example the <span class="tn-icon bx bxs-magic-wand"></span> `bx bxs-magic-wand` icon.
Here's the updated template: