Build your personal knowledge base with Trilium Notes
TypeScript electronelectron-appknowledge-baseknowledge-graphknowledge-managementknowledge-management-graphlocal-firstnote-managmentnote-takernote-takingnotebooknotesnotes-apppersonal-knowledge-basepersonal-wikiscriptableself-hostedself-hostingwiki
docs(user): sync after the multi-level sort
BeatLink028e0d7f0bcf
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/AI/Providers.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/AI/Providers.htmlindex a1945c3083..f2d124e2c0 100644--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/AI/Providers.html+++ b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/AI/Providers.html@@ -111,10 +111,11 @@<p>This allows you to set the base URL to an OpenAI-compatible API, withan optional API key if required by the service.</p><p>Enter the base URL exactly as the service documents it, including its- version path, such as <code spellcheck="false">https://api.groq.com/openai/v1</code>- or <code spellcheck="false">https://open.bigmodel.cn/api/paas/v4</code>. Only- a bare host such as <code spellcheck="false">http://localhost:8080</code> is- completed with <code spellcheck="false">/v1</code>.</p>+ version path, such as <code spellcheck="false">https://api.groq.com/openai/v1</code> or+ <code+ spellcheck="false">https://open.bigmodel.cn/api/paas/v4</code>. Only a bare host such as+ <code+ spellcheck="false">http://localhost:8080</code>is completed with <code spellcheck="false">/v1</code>.</p><p>For custom endpoints, the pricing of the models is not known so the costof a conversation will not be displayed; this is especially relevant forhosted providers.</p>\ No newline at end of filediff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Jump to & command palette.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Jump to & command palette.htmlindex 6253b7262a..defe662a4f 100644--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Jump to & command palette.html+++ b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Jump to & command palette.html@@ -25,14 +25,14 @@note title and selecting one of two options:<ul><li><em>Create note</em> places it in the <a class="reference-link" href="#root/_help_S0Fos78ZfcY7">Note Inbox</a>:- the note labelled <code spellcheck="false">#inbox</code>, today's <a class="reference-link"- href="#root/_help_l0tKav7yLHGF">Day Notes</a> if there is none, or the- top level if there is no journal either. While hoisted into a <a class="reference-link"- href="#root/_help_9sRHySam5fXb">Workspaces</a>, the workspace's own inbox- is used, falling back to the workspace root itself. The option names the- destination, so it is always visible before the note is created.</li>- <li><em>Create child note</em> places it under the note that is currently- open.</li>+ the note labelled <code spellcheck="false">#inbox</code>, today's + <a+ class="reference-link" href="#root/_help_l0tKav7yLHGF">Day Notes</a> if there is none, or the top level if there is no journal+ either. While hoisted into a <a class="reference-link" href="#root/_help_9sRHySam5fXb">Workspaces</a>,+ the workspace's own inbox is used, falling back to the workspace root itself.+ The option names the destination, so it is always visible before the note+ is created.</li>+ <li><em>Create child note</em> places it under the note that is currently open.</li></ul></li></ul>diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Search.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Search.htmlindex e7ffd6a34b..3f6142059c 100644--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Search.html+++ b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Search.html@@ -13,9 +13,7 @@look for the dedicated search button.</li><li>To limit the search to a note and its children, select <em>Search from subtree</em> fromthe <a class="reference-link" href="#root/_help_YtSN43OrfzaA">Note tree contextual menu</a> or- press <kbd spellcheck="false">Ctrl</kbd>+<kbd spellcheck="false">Shift</kbd>+- <kbd- spellcheck="false">S</kbd>.</li>+ press <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>S</kbd>.</li></ul><h2>Interaction</h2><p>To search for notes, click on the magnifying glass icon on the toolbardiff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note Inbox.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note Inbox.htmlindex b5c6809f0a..33f6dd3d85 100644--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note Inbox.html+++ b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note Inbox.html@@ -7,9 +7,10 @@<li>The global <em>Create note into inbox</em> shortcut (default <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>P</kbd>).</li><li>The <em>New note</em> action in the <a href="#root/_help_7iwde4lsKc6O">tray icon menu</a>.</li><li>The <a class="reference-link" href="#root/_help_MtPxeAWVAzMg">Web Clipper</a> extension.</li>- <li>The <em>Create note</em> option offered when a search finds no match, in <a class="reference-link"- href="#root/_help_F1r9QtzQLZqm">Jump to & command palette</a>, in an empty- tab and in the <code spellcheck="false">@</code> completion of a text note.</li>+ <li>The <em>Create note</em> option offered when a search finds no match, in + <a+ class="reference-link" href="#root/_help_F1r9QtzQLZqm">Jump to & command palette</a>, in an empty tab and in the <code spellcheck="false">@</code> completion+ of a text note.</li></ul><h2>Setting a note inbox</h2><p>To create a note inbox, apply the <code spellcheck="false">#inbox</code>diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Sorting Notes.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Sorting Notes.htmlindex 3d0dedb1a4..6a5ca66edf 100644--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Sorting Notes.html+++ b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Sorting Notes.html@@ -5,8 +5,10 @@sort future notes added to this parent note.</p><p>The sorting dialog allows:</p><ul>- <li>Sorting by title, creation or modification date.</li>- <li>Changing sorting direction can also be adjusted (ascending or descending).</li>+ <li>Sorting by title, creation or modification date, or by the value of a+ label on the child notes.</li>+ <li>Sorting by several such criteria in turn, each ascending or descending:+ the next level only decides between notes the previous ones left equal.</li><li>Ensuring folders are displayed at the top.</li><li>Natural sort, based on the sorting rules of a particular language.</li></ul>@@ -27,9 +29,17 @@</td><td><p>Keeps child notes sorted by title alphabetically.</p>- <p>When given a value, it will sort by the value of another label instead.- If one of the child notes doesn't have the specified label, the title will- be used for them instead.</p>+ <p>When given a value, it will sort by other criteria instead: a comma-separated+ list of levels, each <code spellcheck="false">title</code>, <code spellcheck="false">dateCreated</code>,+ <code+ spellcheck="false">dateModified</code>or the name of a label on the child notes, optionally+ followed by <code spellcheck="false">:asc</code> or <code spellcheck="false">:desc</code>.+ For example <code spellcheck="false">#sorted="priority:desc,dueDate"</code> sorts+ by priority, highest first, and notes of equal priority by due date. A+ child note without a level's label comes after every note that has it,+ in either direction; when neither note has it, the next level decides.+ A misspelt direction such as <code spellcheck="false">dueDate:acs</code> is+ read as a label name, which no note has, so that level changes nothing.</p></td></tr><tr>@@ -42,6 +52,9 @@<li><code spellcheck="false">ASC</code>, ascending (default)</li><li><code spellcheck="false">DESC</code>, descending</li></ul>+ <p>A level of <code spellcheck="false">sorted</code> with its own <code spellcheck="false">:asc</code> or+ <code+ spellcheck="false">:desc</code>keeps that direction regardless.</p></td></tr><tr>@@ -103,6 +116,15 @@spellcheck="false">#sorted=myOrder</code>on the parent note and using <code spellcheck="false">#myOrder=001</code>,<codespellcheck="false">#myOrder=002</code>, etc., on child notes.</li>+ <li><strong>Multi-Level Sorting</strong>: Several of the above can be combined,+ separated by commas; each level is applied only where the previous ones+ are equal. Every level can carry its own direction with <code spellcheck="false">:asc</code> or+ <code+ spellcheck="false">:desc</code>, otherwise it follows <code spellcheck="false">#sortDirection</code>.+ For example <code spellcheck="false">#sorted="priority:desc,area,dateCreated"</code> sorts+ by priority, highest first, then by area, then by creation date. A note+ missing a level's label sorts after the notes that have it, whatever the+ direction; two notes both missing it are left to the next level.</li></ul></li><li><strong>Alphabetical Sorting</strong>: Used as a last resort when otherdiff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Geo Map.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Geo Map.htmlindex f5c95e035b..f40e9eb53e 100644--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Geo Map.html+++ b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Geo Map.html@@ -24,8 +24,8 @@an error message will appear instead of the map (<em>This map can't be drawn because WebGL isn't available…</em>).</p><p>The button that shows your location is offered only when Trilium is reachedover HTTPS, in the desktop application or in the mobile application. Browsers- refuse to share the location of a device with a page served over plain HTTP,- so on such a server the button does not appear.</p>+ refuse to share the location of a device with a page served over plain+ HTTP, so on such a server the button does not appear.</p><h2>Interaction</h2><ul><li>At the top-left there is the search bar. It searches the notes already@@ -68,10 +68,10 @@When you add markers yourself you have already moved the map to reach theplace you are marking, and that movement saves a position.</p><h2>Going to your location</h2>-<p>Press the <em>Show your location</em> 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.</p>+<p>Press the <em>Show your location</em> 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.</p><p>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 phonewith GPS gives a dot on the street, while a computer located through its@@ -80,20 +80,20 @@<p>Dragging the map stops it from following. The dot stays and keeps moving,and pressing the button again brings the map back to it. Pressing the buttonwhile the map is following turns the dot off.</p>-<p>Click the dot to see its coordinates in the panel a searched place is shown- in. From there the position can be kept as a marker (see <em>Keeping a place as a marker</em>).+<p>Click the dot to see its coordinates in the panel a searched place is+ shown in. From there the position can be kept as a marker (see <em>Keeping a place as a marker</em>).Clicking the lighter circle around the dot is a click on the map.</p><p>If the position cannot be found, a message says so and the button keeps- waiting for one; press it again to stop. If you refuse the permission, the- button is disabled until the map is opened again. To allow it after all,- change the permission for Trilium in the browser or in the system's location- settings.</p>+ waiting for one; press it again to stop. If you refuse the permission,+ the button is disabled until the map is opened again. To allow it after+ all, change the permission for Trilium in the browser or in the system's+ location settings.</p><p>Your position is not stored in the note, and Trilium does not send itanywhere on its own. Moving the map there does what any other pan or zoom- does: the tile provider behind the map's style sees the coordinates of the- area now on screen. The map does remember where you left it, as it does- after any other movement, so a map you have taken to your location opens- there the next time.</p>+ does: the tile provider behind the map's style sees the coordinates of+ the area now on screen. The map does remember where you left it, as it+ does after any other movement, so a map you have taken to your location+ opens there the next time.</p><h2>Searching the map</h2><p>The search bar at the top-left of the map searches in two places. It alwayssearches the notes that are already on the map. It can also search fordiff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/Internal (reference) links.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/Internal (reference) links.htmlindex 1309890e21..c70683bbb1 100644--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/Internal (reference) links.html+++ b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/Internal (reference) links.html@@ -11,10 +11,11 @@width="34" height="16">menu in the <a class="reference-link" href="#root/_help_nRhnJkTT8cPs">Formatting toolbar</a>.</li><li>Searching for the title of the desired note to link. It's also possibleto create new notes from this dialog by typing a non-existing note title- and selecting either <em>Create note</em>, which places it in the <a class="reference-link"- href="#root/_help_S0Fos78ZfcY7">Note Inbox</a> (today's day note, or the- top level, when no inbox is set), or <em>Create child note</em>, which places- it under the note being edited.</li>+ and selecting either <em>Create note</em>, which places it in the + <a+ class="reference-link" href="#root/_help_S0Fos78ZfcY7">Note Inbox</a> (today's day note, or the top level, when no inbox+ is set), or <em>Create child note</em>, which places it under the note being+ edited.</li></ol><p>There are two link types which you can select when creating the link tothe note:</p>diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets.htmlindex ea9350bde2..4609bab38a 100644--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets.html+++ b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets.html@@ -142,6 +142,39 @@ class="table"><codespellcheck="false">right-pane</code>have special requirements that need to be accounted for(see the table above).</p>+ <h2>Multiple widgets in a single note</h2>+ <p>A widget note usually returns one widget, but it can also return an array+ of them. This is useful when several widgets share code or state, since+ they can all live in the same note instead of being split across notes+ that need a shared module.</p>+ <p>Each widget of the array is registered on its own, so they can have different+ parents and positions. A widget that is missing its <code spellcheck="false">parentWidget</code> (or+ <code+ spellcheck="false">parent</code>for Preact) is reported as an error without affecting the+ other widgets of the note.</p>+ <h3>Legacy version (jQuery)</h3><pre><code class="language-text-x-trilium-auto">class TreeWidget extends api.BasicWidget {+ get parentWidget() { return "left-pane"; }+ doRender() { this.$widget = $("<span>Left pane</span>"); }+}++class SidebarWidget extends api.BasicWidget {+ get parentWidget() { return "right-pane"; }+ doRender() { this.$widget = $("<span>Right pane</span>"); }+}++module.exports = [ new TreeWidget(), new SidebarWidget() ];</code></pre>+ <h3>Preact version</h3><pre><code class="language-text-x-trilium-auto">import { defineWidget } from "trilium:preact";++export default [+ defineWidget({+ parent: "left-pane",+ render: () => <span>Left pane from Preact.</span>+ }),+ defineWidget({+ parent: "right-pane",+ render: () => <span>Right pane from Preact.</span>+ })+];</code></pre><h2>Launch bar widgets</h2><p>Launch bar widgets are similar to <em>Custom widgets</em> but are specificto the <a class="reference-link" href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>.diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/Navigation/Search.md b/docs/User Guide/User Guide/Basic Concepts and Features/Navigation/Search.mdindex f8031c9981..93c418ae9e 100644--- a/docs/User Guide/User Guide/Basic Concepts and Features/Navigation/Search.md+++ b/docs/User Guide/User Guide/Basic Concepts and Features/Navigation/Search.md@@ -6,7 +6,7 @@ Note search enables you to find notes by searching for text in the title, conten## Accessing the search* From the <a class="reference-link" href="../UI%20Elements/Launch%20Bar.md">Launch Bar</a>, look for the dedicated search button.-* To limit the search to a note and its children, select _Search from subtree_ from the <a class="reference-link" href="../UI%20Elements/Note%20Tree/Note%20tree%20contextual%20menu.md">Note tree contextual menu</a> or press <kbd spellcheck="false">Ctrl</kbd>+<kbd spellcheck="false">Shift</kbd>+<kbd spellcheck="false">S</kbd>.+* To limit the search to a note and its children, select _Search from subtree_ from the <a class="reference-link" href="../UI%20Elements/Note%20Tree/Note%20tree%20contextual%20menu.md">Note tree contextual menu</a> or press <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>S</kbd>.## Interactiondiff --git a/docs/User Guide/User Guide/Basic Concepts and Features/Notes/Note Inbox.md b/docs/User Guide/User Guide/Basic Concepts and Features/Notes/Note Inbox.mdindex d9ac3b4622..07e5ca020a 100644--- a/docs/User Guide/User Guide/Basic Concepts and Features/Notes/Note Inbox.md+++ b/docs/User Guide/User Guide/Basic Concepts and Features/Notes/Note Inbox.md@@ -7,7 +7,7 @@ The inbox is the default destination for quickly captured notes. When a note is* The global _Create note into inbox_ shortcut (default <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>P</kbd>).* The _New note_ action in the [tray icon menu](../../Installation%20%26%20Setup/Desktop%20Installation/Tray%20icon%20%26%20automatic%20startup.md).* The <a class="reference-link" href="../../Installation%20%26%20Setup/Web%20Clipper.md">Web Clipper</a> extension.-* The _Create note_ option offered when a search finds no match, in <a class="reference-link" href="../Navigation/Jump%20to%20%26%20command%20palette.md">Jump to & command palette</a>, in an empty tab and in the `@` completion of a text note.+* The _Create note_ option offered when a search finds no match, in <a class="reference-link" href="../Navigation/Jump%20to%20%26%20command%20palette.md">Jump to & command palette</a>, in an empty tab and in the `@` completion of a text note.## Setting a note inbox