Merge branch 'develop' into calendar

.github/actions/report-size/action.yml

@@ -44,7 +44,7 @@ runs:
   steps:
     # Checkout branch to compare to [required]
     - name: Checkout base branch
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
       with:
         ref: ${{ inputs.branch }}
         path: br-base

.github/workflows/dev.yml

@@ -110,8 +110,9 @@ jobs:
       - test_dev
     steps:
       - uses: actions/checkout@v4
+      - name: Install dependencies
+        run: npm ci
       - name: Update build info
-        shell: ${{ inputs.shell }}
         run: npm run chore:update-build-info
       - uses: docker/setup-buildx-action@v3
       - uses: docker/build-push-action@v6
@@ -133,8 +134,10 @@ jobs:
       - name: Checkout the repository
         uses: actions/checkout@v4
 
+      - name: Install dependencies
+        run: npm ci
+
       - name: Update build info
-        shell: ${{ inputs.shell }}
         run: npm run chore:update-build-info
 
       - name: Set IMAGE_NAME to lowercase

.github/workflows/main-docker.yml

@@ -132,8 +132,10 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v4
 
+      - name: Install dependencies
+        run: npm ci
+
       - name: Update build info
-        shell: ${{ inputs.shell }}
         run: npm run chore:update-build-info
 
       - name: Docker meta

.gitignore

@@ -45,3 +45,6 @@ data-docs/log
 data-docs/session
 data-docs/session_secret.txt
 data-docs/document.*
+
+# Webpack
+webpack-stats.json

demo/!!!meta.json

@@ -147,7 +147,7 @@
 							"title": "Inbox",
 							"notePosition": 10,
 							"prefix": null,
-							"isExpanded": false,
+							"isExpanded": true,
 							"type": "text",
 							"mime": "text/html",
 							"attributes": [
@@ -219,7 +219,22 @@
 									"isExpanded": false,
 									"type": "text",
 									"mime": "text/html",
-									"attributes": [],
+									"attributes": [
+										{
+											"type": "relation",
+											"name": "includeNoteLink",
+											"value": "ZWCYra81yOFO",
+											"isInheritable": false,
+											"position": 10
+										},
+										{
+											"type": "relation",
+											"name": "internalLink",
+											"value": "_help_nBAXQFj20hS1",
+											"isInheritable": false,
+											"position": 20
+										}
+									],
 									"format": "html",
 									"dataFileName": "The Last Question.html",
 									"attachments": [],

demo/root/Trilium Demo.html

@@ -18,22 +18,28 @@
           height="150">
         </figure>
         <p><strong>Welcome to TriliumNext Notes!</strong>
+
         </p>
         <p>This is initial "demo" document provided by TriliumNext by default to
           showcase some of its features and also give you some ideas how you might
           structure your notes. You can play with it, modify note content and tree
           structure as you wish.</p>
         <p>If you need any help, visit TriliumNext website: <a href="https://github.com/TriliumNext">https://github.com/TriliumNext</a>
+
         </p>
          <h3>Cleanup</h3>
+
         <p>Once you're finished with experimenting and want to cleanup these pages,
           you can simply delete them all.</p>
          <h3>Formatting</h3>
+
         <p>TriliumNext supports classic formatting like <em>italic</em>, <strong>bold</strong>, <em><strong>bold and italic</strong></em>.
           Of course you can add links like this one pointing to <a href="http://www.google.com">google.com</a>
+
         </p>
         <p>Lists</p>
         <p><strong>Ordered:</strong>
+
         </p>
         <ol>
           <li>First Item</li>
@@ -48,6 +54,7 @@
           </li>
         </ol>
         <p><strong>Unordered:</strong>
+
         </p>
         <ul>
           <li>Item</li>

demo/root/Trilium Demo/Formatting examples/Checkbox lists.html

@@ -18,21 +18,25 @@
           <li>
             <label class="todo-list__label">
               <input type="checkbox" disabled="disabled"><span class="todo-list__label__description">buy milk&nbsp;&nbsp;</span>
+
             </label>
           </li>
           <li>
             <label class="todo-list__label">
               <input type="checkbox" checked="checked" disabled="disabled"><span class="todo-list__label__description">do the laundry&nbsp;&nbsp;</span>
+
             </label>
           </li>
           <li>
             <label class="todo-list__label">
               <input type="checkbox" checked="checked" disabled="disabled"><span class="todo-list__label__description">watch TV&nbsp;&nbsp;</span>
+
             </label>
           </li>
           <li>
             <label class="todo-list__label">
               <input type="checkbox" disabled="disabled"><span class="todo-list__label__description">eat ice cream&nbsp;&nbsp;</span>
+
             </label>
           </li>
         </ul>

demo/root/Trilium Demo/Formatting examples/Math.html

@@ -15,7 +15,9 @@
       <div class="ck-content">
         <p><span class="math-tex">\(% \f is defined as #1f(#2) using the macro \f\relax{x} = \int_{-\infty}^\infty &nbsp; &nbsp; \f\hat\xi\,e^{2 \pi i \xi x} &nbsp; &nbsp; \,d\xi\)</span>Some
           math examples:</p><span class="math-tex">\[\displaystyle \frac{1}{\Bigl(\sqrt{\phi \sqrt{5}}-\phi\Bigr) e^{\frac25 \pi}} = 1+\frac{e^{-2\pi}} {1+\frac{e^{-4\pi}} {1+\frac{e^{-6\pi}} {1+\frac{e^{-8\pi}} {1+\cdots} } } }\]</span>
+
         <p>Another:</p><span class="math-tex">\[\displaystyle \left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)\]</span>
+
         <p>Inline math is also possible:&nbsp;<span class="math-tex">\(c^2 = a^2 + b^2\)</span>&nbsp;</p>
         <p>&nbsp;</p>
       </div>

demo/root/Trilium Demo/Inbox/The Last Question.html

@@ -21,8 +21,7 @@
         class="include-note" data-note-id="ZWCYra81yOFO" data-box-size="medium">&nbsp;</section>
           <p>This page demonstrates two things:</p>
           <ul>
-            <li>possibility to <a href="https://github.com/zadam/trilium/wiki/Text-editor#include-note">include one note into another</a>
-
+            <li>possibility to <a href="#root/_hidden/_help/_help_KSZ04uQ2D1St/_help_iPIMuisry3hd/_help_nBAXQFj20hS1">include one note into another</a>
             </li>
             <li>PDF preview - you can read PDFs directly in Trilium!</li>
           </ul>

demo/root/Trilium Demo/Journal.html

@@ -14,6 +14,7 @@
 
       <div class="ck-content">
         <p>You can read some explanation on how this journal works here: <a href="https://github.com/zadam/trilium/wiki/Day-notes">https://github.com/zadam/trilium/wiki/Day-notes</a>
+
         </p>
       </div>
     </div>

demo/root/Trilium Demo/Note Types/Geo Map (The Seven Wonders of the World)/Chichén Itzá, Mexico.html

@@ -24,14 +24,17 @@
           <span
           class="footnote-reference" data-footnote-reference="" data-footnote-index="1"
           data-footnote-id="6qz4pm021mi" role="doc-noteref" id="fnref6qz4pm021mi"><sup><a href="#fn6qz4pm021mi">[1]</a></sup>
+
             </span>
         </p>
         <ol class="footnote-section footnotes" data-footnote-section="" role="doc-endnotes">
           <li class="footnote-item" data-footnote-item="" data-footnote-index="1"
           data-footnote-id="6qz4pm021mi" role="doc-endnote" id="fn6qz4pm021mi"><span class="footnote-back-link" data-footnote-back-link="" data-footnote-id="6qz4pm021mi"><sup><strong><a href="#fnref6qz4pm021mi">^</a></strong></sup></span>
+
             <div
             class="footnote-content" data-footnote-content="">
               <p><a href="https://www.thecollector.com/what-are-the-seven-wonders-of-the-world/">What Are the 7 Wonders of the World? (with HD Images) | TheCollector</a>
+
               </p>
       </div>
       </li>

demo/root/Trilium Demo/Note Types/Geo Map (The Seven Wonders of the World)/Christ the Redeemer, Brazil.html

@@ -26,13 +26,16 @@
           been brought to its knees.<span class="footnote-reference" data-footnote-reference=""
           data-footnote-index="1" data-footnote-id="o6g991vkrwj" role="doc-noteref"
           id="fnrefo6g991vkrwj"><sup><a href="#fno6g991vkrwj">[1]</a></sup></span>
+
         </p>
         <ol class="footnote-section footnotes" data-footnote-section="" role="doc-endnotes">
           <li class="footnote-item" data-footnote-item="" data-footnote-index="1"
           data-footnote-id="o6g991vkrwj" role="doc-endnote" id="fno6g991vkrwj"><span class="footnote-back-link" data-footnote-back-link="" data-footnote-id="o6g991vkrwj"><sup><strong><a href="#fnrefo6g991vkrwj">^</a></strong></sup></span>
+
             <div
             class="footnote-content" data-footnote-content="">
               <p><a href="https://www.thecollector.com/what-are-the-seven-wonders-of-the-world/">What Are the 7 Wonders of the World? (with HD Images) | TheCollector</a>
+
               </p>
       </div>
       </li>

demo/root/Trilium Demo/Note Types/Geo Map (The Seven Wonders of the World)/Machu Picchu, Peru.html

@@ -22,13 +22,16 @@
           around 1450 in polished drystone walls.<span class="footnote-reference"
           data-footnote-reference="" data-footnote-index="1" data-footnote-id="4prjheuho88"
           role="doc-noteref" id="fnref4prjheuho88"><sup><a href="#fn4prjheuho88">[1]</a></sup></span>
+
         </p>
         <ol class="footnote-section footnotes" data-footnote-section="" role="doc-endnotes">
           <li class="footnote-item" data-footnote-item="" data-footnote-index="1"
           data-footnote-id="4prjheuho88" role="doc-endnote" id="fn4prjheuho88"><span class="footnote-back-link" data-footnote-back-link="" data-footnote-id="4prjheuho88"><sup><strong><a href="#fnref4prjheuho88">^</a></strong></sup></span>
+
             <div
             class="footnote-content" data-footnote-content="">
               <p><a href="https://www.thecollector.com/what-are-the-seven-wonders-of-the-world/">What Are the 7 Wonders of the World? (with HD Images) | TheCollector</a>
+
               </p>
       </div>
       </li>

demo/root/Trilium Demo/Note Types/Geo Map (The Seven Wonders of the World)/Petra, Jordan.html

@@ -23,13 +23,16 @@
           by earthquakes.<span class="footnote-reference" data-footnote-reference=""
           data-footnote-index="1" data-footnote-id="ej5sd0bakne" role="doc-noteref"
           id="fnrefej5sd0bakne"><sup><a href="#fnej5sd0bakne">[1]</a></sup></span>
+
         </p>
         <ol class="footnote-section footnotes" data-footnote-section="" role="doc-endnotes">
           <li class="footnote-item" data-footnote-item="" data-footnote-index="1"
           data-footnote-id="ej5sd0bakne" role="doc-endnote" id="fnej5sd0bakne"><span class="footnote-back-link" data-footnote-back-link="" data-footnote-id="ej5sd0bakne"><sup><strong><a href="#fnrefej5sd0bakne">^</a></strong></sup></span>
+
             <div
             class="footnote-content" data-footnote-content="">
               <p><a href="https://www.thecollector.com/what-are-the-seven-wonders-of-the-world/">What Are the 7 Wonders of the World? (with HD Images) | TheCollector</a>
+
               </p>
       </div>
       </li>

demo/root/Trilium Demo/Note Types/Geo Map (The Seven Wonders of the World)/The Colosseum, Rome, Italy.html

@@ -26,14 +26,17 @@
           <span
           class="footnote-reference" data-footnote-reference="" data-footnote-index="1"
           data-footnote-id="4kitkusvyi3" role="doc-noteref" id="fnref4kitkusvyi3"><sup><a href="#fn4kitkusvyi3">[1]</a></sup>
+
             </span>
         </p>
         <ol class="footnote-section footnotes" data-footnote-section="" role="doc-endnotes">
           <li class="footnote-item" data-footnote-item="" data-footnote-index="1"
           data-footnote-id="4kitkusvyi3" role="doc-endnote" id="fn4kitkusvyi3"><span class="footnote-back-link" data-footnote-back-link="" data-footnote-id="4kitkusvyi3"><sup><strong><a href="#fnref4kitkusvyi3">^</a></strong></sup></span>
+
             <div
             class="footnote-content" data-footnote-content="">
               <p><a href="https://www.thecollector.com/what-are-the-seven-wonders-of-the-world/">What Are the 7 Wonders of the World? (with HD Images) | TheCollector</a>
+
               </p>
       </div>
       </li>

demo/root/Trilium Demo/Note Types/Geo Map (The Seven Wonders of the World)/The Great Wall of China.html

@@ -23,14 +23,17 @@
           <span
           class="footnote-reference" data-footnote-reference="" data-footnote-index="1"
           data-footnote-id="o0o2das7ljm" role="doc-noteref" id="fnrefo0o2das7ljm"><sup><a href="#fno0o2das7ljm">[1]</a></sup>
+
             </span>
         </p>
         <ol class="footnote-section footnotes" data-footnote-section="" role="doc-endnotes">
           <li class="footnote-item" data-footnote-item="" data-footnote-index="1"
           data-footnote-id="o0o2das7ljm" role="doc-endnote" id="fno0o2das7ljm"><span class="footnote-back-link" data-footnote-back-link="" data-footnote-id="o0o2das7ljm"><sup><strong><a href="#fnrefo0o2das7ljm">^</a></strong></sup></span>
+
             <div
             class="footnote-content" data-footnote-content="">
               <p><a href="https://www.thecollector.com/what-are-the-seven-wonders-of-the-world/">What Are the 7 Wonders of the World? (with HD Images) | TheCollector</a>
+
               </p>
       </div>
       </li>

demo/root/Trilium Demo/Note Types/Geo Map (The Seven Wonders of the World)/The Taj Mahal, India.html

@@ -23,13 +23,16 @@
           the complex.<span class="footnote-reference" data-footnote-reference=""
           data-footnote-index="1" data-footnote-id="zzzjn52iwk" role="doc-noteref"
           id="fnrefzzzjn52iwk"><sup><a href="#fnzzzjn52iwk">[1]</a></sup></span>
+
         </p>
         <ol class="footnote-section footnotes" data-footnote-section="" role="doc-endnotes">
           <li class="footnote-item" data-footnote-item="" data-footnote-index="1"
           data-footnote-id="zzzjn52iwk" role="doc-endnote" id="fnzzzjn52iwk"><span class="footnote-back-link" data-footnote-back-link="" data-footnote-id="zzzjn52iwk"><sup><strong><a href="#fnrefzzzjn52iwk">^</a></strong></sup></span>
+
             <div
             class="footnote-content" data-footnote-content="">
               <p><a href="https://www.thecollector.com/what-are-the-seven-wonders-of-the-world/">What Are the 7 Wonders of the World? (with HD Images) | TheCollector</a>
+
               </p>
       </div>
       </li>

demo/root/Trilium Demo/Scripting examples/Task manager/Done/Buy a board game for Alice.html

@@ -18,6 +18,7 @@
           width="209" height="300">
         </figure>
         <p>Maybe CodeNames? <a href="https://boardgamegeek.com/boardgame/178900/codenames">https://boardgamegeek.com/boardgame/178900/codenames</a>
+
         </p>
       </div>
     </div>

demo/root/Trilium Demo/Tech/Node.js/Overview/Platform architecture.html

@@ -20,6 +20,7 @@
             href="https://en.wikipedia.org/wiki/Node.js#cite_note-b1-31">[31]</a>Developers can create scalable servers without using <a href="https://en.wikipedia.org/wiki/Thread_(computing)">threading</a>,
               by using a simplified model of <a href="https://en.wikipedia.org/wiki/Event-driven_programming">event-driven programming</a> that
               uses callbacks to signal the completion of a task.<a href="https://en.wikipedia.org/wiki/Node.js#cite_note-b1-31">[31]</a>
+
         </p>
       </div>
     </div>

docs/User Guide/User Guide/Advanced Usage/Advanced Showcases.md

@@ -1,5 +1,5 @@
 # Advanced Showcases
-Trilium offers advanced functionality through [Scripts](../Note%20Types/Code/Scripts.md) and [Promoted Attributes](Attributes/Promoted%20Attributes.md). To illustrate these features, we've prepared several showcases available in the [demo notes](Database.md):
+Trilium offers advanced functionality through [Scripts](../Note%20Types/Code/Scripting.md) and [Promoted Attributes](Attributes/Promoted%20Attributes.md). To illustrate these features, we've prepared several showcases available in the [demo notes](Database.md):
 
 *   [Relation Map](../Note%20Types/Relation%20Map.md)
 *   [Day Notes](Advanced%20Showcases/Day%20Notes.md)

docs/User Guide/User Guide/Advanced Usage/Advanced Showcases/Task Manager.md

@@ -1,5 +1,5 @@
 # Task Manager
-Task Manager is a [promoted attributes](../Attributes/Promoted%20Attributes.md) and [scripts](../../Note%20Types/Code/Scripts.md)showcase present in the [demo notes](../Database.md).
+Task Manager is a [promoted attributes](../Attributes/Promoted%20Attributes.md) and [scripts](../../Note%20Types/Code/Scripting.md)showcase present in the [demo notes](../Database.md).
 
 ## Demo
 
@@ -15,7 +15,7 @@ New tasks are created in the TODO note which has `~child:template` [relation](..
 
 ### Attributes
 
-Task template defines several [promoted attributes](../Attributes/Promoted%20Attributes.md) - todoDate, doneDate, tags, location. Importantly it also defines `~runOnAttributeChange` relation - [event](../../Note%20Types/Code/Events.md) handler which is run on attribute change. This [script](../../Note%20Types/Code/Scripts.md) handles when e.g. we fill out the doneDate attribute - meaning the task is done and should be moved to "Done" note and removed from TODO, locations and tags.
+Task template defines several [promoted attributes](../Attributes/Promoted%20Attributes.md) - todoDate, doneDate, tags, location. Importantly it also defines `~runOnAttributeChange` relation - [event](../../Note%20Types/Code/Events.md) handler which is run on attribute change. This [script](../../Note%20Types/Code/Scripting.md) handles when e.g. we fill out the doneDate attribute - meaning the task is done and should be moved to "Done" note and removed from TODO, locations and tags.
 
 ### New task button
 

docs/User Guide/User Guide/Advanced Usage/Advanced Showcases/Weight Tracker.md

@@ -7,7 +7,7 @@ By adding `weight` as a [promoted attribute](../Attributes/Promoted%20Attributes
 
 ## Implementation
 
-The `Weight Tracker` note in the screenshot above is of the type `Render Note`. That type of note doesn't have any useful content itself. Instead it is a placeholder where a [script](../../Note%20Types/Code/Scripts.md) can render its output.
+The `Weight Tracker` note in the screenshot above is of the type `Render Note`. That type of note doesn't have any useful content itself. Instead it is a placeholder where a [script](../../Note%20Types/Code/Scripting.md) can render its output.
 
 Scripts for `Render Notes` are defined in a [relation](../Attributes.md) called `~renderNote`. In this example, it's the `Weight Tracker`'s child `Implementation`. The Implementation consists of two [code notes](../../Note%20Types/Code.md) that contain some HTML and JavaScript respectively, which load all the notes with a `weight` attribute and display their values in a chart.
 

docs/User Guide/User Guide/Advanced Usage/Attributes.md

@@ -14,46 +14,46 @@ Labels in Trilium can be used for a variety of purposes:
 
 *   **Metadata**: Assign labels with optional values for categorization, such as `#year=1999`, `#genre="sci-fi"`, or `#author="Neal Stephenson"`
 *   **Configuration**: Labels can configure advanced features or settings
-*   **Scripts and Plugins**: Used to tag notes with special metadata, such as the "weight" attribute in the [Weight Tracker](Advanced%20Showcases/Weight%20Tracker.md)
+*   **Scripts and Plugins**: Used to tag notes with special metadata, such as the "weight" attribute in the <a class="reference-link" href="Advanced%20Showcases/Weight%20Tracker.md">Weight Tracker</a>.
 
 Labels are also searchable, enhancing note retrieval.
 
 ### Common Labels for Advanced Configuration
 
-*   `**disableVersioning**`: Disables automatic versioning, ideal for large, unimportant notes like script libraries
-*   `**versioningLimit**`: Used to limit the number of revisions for a single note
-*   `**calendarRoot**`: Marks the note as the root for [day notes](Advanced%20Showcases/Day%20Notes.md). Only one note should carry this label
-*   `**archived**`: Hides notes from default search results and dialogs
-*   `**excludeFromExport**`: Excludes notes and their subtrees from export operations
-*   `**run**`: Specifies events to trigger scripts (e.g., `frontendStartup`, `hourly`)
-*   `**runAtHour**`: Defines specific hours for scripts to run, used with `#run=hourly`
-*   `**disableInclusion**`: Prevents a script from being included in parent script executions
-*   `**sorted**`: Automatically sorts child notes alphabetically by title
-*   `**top**`: Keeps the note at the top of its parent's list, useful with `sorted`
-*   `**hidePromotedAttributes**`: Hides certain attributes in the note's display
-*   `**readOnly**`: Sets the note to read-only mode, applicable to text and code notes
-*   `**autoReadOnlyDisabled**`: Disables automatic read-only mode for large notes
-*   `**appCss**`: Marks CSS notes used to modify Trilium’s appearance
-*   `**appTheme**`: Marks full CSS themes available in Trilium's options
-*   `**cssClass**`: Adds a CSS class to the note's representation in the tree
-*   `**iconClass**`: Adds a CSS class to the note's icon, useful for distinguishing notes visually. See [note icons](../Basic%20Concepts%20and%20Features/Notes/Note%20Icons.md)
-*   `**pageSize**`: Specifies the number of items per page in note listings
-*   `**customRequestHandler**` **and** `**customResourceProvider**`: Refer to [Custom request handler](Custom%20Request%20Handler.md)
-*   `**widget**`: Marks a note as a custom widget, added to Trilium's component tree
-*   `**workspace**` **and related attributes**: See [Workspace](../Basic%20Concepts%20and%20Features/Navigation/Workspace.md) for more details
-*   `**searchHome**`: Specifies the parent for new search notes
-*   `**inbox**`: Designates a default location for new notes created via the sidebar
-*   `**sqlConsoleHome**`: Default location for SQL console notes
-*   `**bookmarked**` **and** `**bookmarkFolder**`: See [Bookmarks](../Basic%20Concepts%20and%20Features/Navigation/Bookmarks.md)
-*   `**shareXXX**`: See [Sharing](Sharing.md)
-*   `**keyboardShortcut**`: Assigns a keyboard shortcut to open the note
-*   `**displayRelations**` **and** `**hideRelations**`: Manages the display of note relations
-*   `**titleTemplate**`: See [Default note title](Default%20Note%20Title.md)
-*   `**template**`: Makes the note available as a template
-*   `**toc**`: Controls the visibility of the table of contents
-*   `**color**`: Defines the color of the note in the tree and links
-*   `**hideChildrenOverview**`: Hides child notes in the parent note's editor
-*   `**viewType**`: Sets the view of child notes (grid or list)
+*   `disableVersioning`: Disables automatic versioning, ideal for large, unimportant notes like script libraries
+*   `versioningLimit`: Used to limit the number of revisions for a single note
+*   `calendarRoot`: Marks the note as the root for [day notes](Advanced%20Showcases/Day%20Notes.md). Only one note should carry this label
+*   `archived`: Hides notes from default search results and dialogs
+*   `excludeFromExport`: Excludes notes and their subtrees from export operations
+*   `run`: Specifies events to trigger scripts (e.g., `frontendStartup`, `hourly`)
+*   `runAtHour`: Defines specific hours for scripts to run, used with `#run=hourly`
+*   `disableInclusion`: Prevents a script from being included in parent script executions
+*   `sorted`: Automatically sorts child notes alphabetically by title
+*   `top`: Keeps the note at the top of its parent's list, useful with `sorted`
+*   `hidePromotedAttributes`: Hides certain attributes in the note's display
+*   `readOnly`: Sets the note to read-only mode, applicable to text and code notes
+*   `autoReadOnlyDisabled`: Disables automatic read-only mode for large notes
+*   `appCss`: Marks CSS notes used to modify Trilium’s appearance
+*   `appTheme`: Marks full CSS themes available in Trilium's options
+*   `cssClass`: Adds a CSS class to the note's representation in the tree
+*   `iconClass`: Adds a CSS class to the note's icon, useful for distinguishing notes visually. See <a class="reference-link" href="../Basic%20Concepts%20and%20Features/Notes/Note%20Icons.md">Note Icons</a>.
+*   `pageSize`: Specifies the number of items per page in note listings
+*   `customRequestHandler` **and** `customResourceProvider`: Refer to <a class="reference-link" href="Custom%20Request%20Handler.md">Custom Request Handler</a>
+*   `widget`: Marks a note as a custom widget, added to Trilium's component tree
+*   `workspace` **and related attributes**: See <a class="reference-link" href="../Basic%20Concepts%20and%20Features/Navigation/Workspace.md">Workspace</a> for more details
+*   `searchHome`: Specifies the parent for new search notes
+*   `inbox`: Designates a default location for new notes created via the sidebar
+*   `sqlConsoleHome`: Default location for SQL console notes
+*   `bookmarked` **and** `bookmarkFolder`: See <a class="reference-link" href="../Basic%20Concepts%20and%20Features/Navigation/Bookmarks.md">Bookmarks</a>
+*   `share:[…]`: See <a class="reference-link" href="Sharing.md">Sharing</a>
+*   `keyboardShortcut`: Assigns a keyboard shortcut to open the note
+*   `displayRelations` **and** `hideRelations`: Manages the display of note relations
+*   `titleTemplate`: See <a class="reference-link" href="Default%20Note%20Title.md">Default Note Title</a>
+*   `template`: Makes the note available as a template
+*   `toc`: Controls the visibility of the table of contents
+*   `color`: Defines the color of the note in the tree and links
+*   `hideChildrenOverview`: Hides child notes in the parent note's editor
+*   `viewType`: Sets the view of child notes (grid or list)
 
 ## Relations
 
@@ -75,8 +75,8 @@ Attributes in Trilium can be "multivalued", meaning multiple attributes with the
 
 ## Attribute Definitions and Promoted Attributes
 
-Special labels create "label/attribute" definitions, enhancing the organization and management of attributes. For more details, see [Promoted attributes](Attributes/Promoted%20Attributes.md).
+Special labels create "label/attribute" definitions, enhancing the organization and management of attributes. For more details, see <a class="reference-link" href="Attributes/Promoted%20Attributes.md">Promoted Attributes</a>.
 
 ## Attribute Inheritance
 
-Trilium supports attribute inheritance, allowing child notes to inherit attributes from their parents. For more information, see [Attribute inheritance](Attributes/Attribute%20Inheritance.md).
+Trilium supports attribute inheritance, allowing child notes to inherit attributes from their parents. For more information, see <a class="reference-link" href="Attributes/Attribute%20Inheritance.md">Attribute Inheritance</a>.

docs/User Guide/User Guide/Advanced Usage/Custom Request Handler.md

@@ -1,5 +1,5 @@
 # Custom Request Handler
-Trilium provides a mechanism for [scripts](../Note%20Types/Code/Scripts.md) to open a public REST endpoint. This opens a way for various integrations with other services - a simple example would be creating new note from Slack by issuing a slash command (e.g. `/trilium buy milk`).
+Trilium provides a mechanism for [scripts](../Note%20Types/Code/Scripting.md) to open a public REST endpoint. This opens a way for various integrations with other services - a simple example would be creating new note from Slack by issuing a slash command (e.g. `/trilium buy milk`).
 
 ## Create note from outside Trilium
 

docs/User Guide/User Guide/Advanced Usage/Note ID.md

@@ -0,0 +1,16 @@
+# Note ID
+Whereas some applications use file names to uniquely identify notes, Trilium uses the concept of Note ID.
+
+Generally, the Note ID is a 12-character long alphanumeric sequence (including both lower and upper case letter) that is randomly generated for each new note.
+
+## How does the import/export affect the note IDs
+
+When notes are exported, their note ID is kept in the metadata of the export. However when they are imported back in, a new note ID is generated for all the notes. This also includes other entities that are part of the import/export process such as <a class="reference-link" href="../Basic%20Concepts%20and%20Features/Notes/Attachments.md">Attachments</a>.
+
+## Note collisions
+
+Since the Note ID is a fixed-width randomly generated number, due to the [pigeonhole principle](https://en.wikipedia.org/wiki/Pigeonhole_principle), there is a possibility that a newly created note will have the same ID as an existing note.
+
+Since the note ID is alphanumeric and the length is 12 we have $62^{12}$ unique IDs. However since we are generating them randomly, we can use a collision calculator such as the one for [Nano ID](https://alex7kom.github.io/nano-nanoid-cc/?alphabet=0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz&size=12&speed=1000&speedUnit=hour) to determine that we'd need to create 1000 notes per hour every hour for 9 centuries in order to have at least 1% probability of a note collision.
+
+As such, Trilium does not take any explicit action against potential note collisions, similar to other software that makes uses of unique hashes such as [Git](https://stackoverflow.com/questions/10434326/hash-collision-in-git). If one would theoretically occur, what would most likely happen is that the existing note will be replaced by the new one.

docs/User Guide/User Guide/Advanced Usage/Note source.md

@@ -1,17 +1,17 @@
 # Note source
 ## Understanding the source code of the different notes
 
-Internally, the structure of the content of each note is different based on the [Note Types](../Note%20Types).
+Internally, the structure of the content of each note is different based on the <a class="reference-link" href="../Note%20Types.md">Note Types</a>.
 
 For example:
 
-*   [Text Notes](#root/_hidden/_options/_optionsTextNotes) are represented internally as HTML, using the [CKEditor](Technologies%20used/CKEditor.md) representation. Note that due to the custom plugins, some HTML elements are specific to Trilium only, for example the admonitions.
-*   [Code Notes](#root/_hidden/_options/_optionsCodeNotes) are plain text and are represented internally as-is.
-*   [Geo map](../Note%20Types/Geo%20map.md) notes contain only minimal information (viewport, zoom) as a JSON.
-*   [Canvas](../Note%20Types/Canvas.md) notes are represented as JSON, with Trilium's own information alongside with [Excalidraw](Technologies%20used/Excalidraw.md)'s internal JSON representation format.
-*   [Mind Map](../Note%20Types/Mind%20Map.md) notes are represented as JSON, with the internal format of [MindElixir](Technologies%20used/MindElixir.md).
+*   <a class="reference-link" href="../Note%20Types/Text.md">Text</a> notes are represented internally as HTML, using the <a class="reference-link" href="Technologies%20used/CKEditor.md">CKEditor</a> representation. Note that due to the custom plugins, some HTML elements are specific to Trilium only, for example the admonitions.
+*   <a class="reference-link" href="../Note%20Types/Code.md">Code</a> notes are plain text and are represented internally as-is.
+*   <a class="reference-link" href="../Note%20Types/Geo%20Map.md">Geo Map</a> notes contain only minimal information (viewport, zoom) as a JSON.
+*   <a class="reference-link" href="../Note%20Types/Canvas.md">Canvas</a> notes are represented as JSON, with Trilium's own information alongside with <a class="reference-link" href="Technologies%20used/Excalidraw.md">Excalidraw</a>'s internal JSON representation format.
+*   <a class="reference-link" href="../Note%20Types/Mind%20Map.md">Mind Map</a> notes are represented as JSON, with the internal format of <a class="reference-link" href="Technologies%20used/MindElixir.md">MindElixir</a>.
 
-Note that some information is also stored as [Attachments](../Attachments). For example [Canvas](../Note%20Types/Canvas.md) notes use the attachments feature to store the custom libraries, and alongside with [Mind Map](../Note%20Types/Mind%20Map.md) and other similar note types it stores an SVG representation of the content for use in other features such as including in other notes, shared notes, etc.
+Note that some information is also stored as <a class="reference-link" href="../Basic%20Concepts%20and%20Features/Notes/Attachments.md">Attachments</a>. For example <a class="reference-link" href="../Note%20Types/Canvas.md">Canvas</a> notes use the attachments feature to store the custom libraries, and alongside with <a class="reference-link" href="../Note%20Types/Mind%20Map.md">Mind Map</a> and other similar note types it stores an SVG representation of the content for use in other features such as including in other notes, shared notes, etc.
 
 Here's part of the HTML representation of this note, as it's stored in the database (but prettified).
 
@@ -21,7 +21,7 @@ Here's part of the HTML representation of this note, as it's stored in the datab
 </h2>
 <p>
 	Internally, the structure of the content of each note is different based on the&nbsp;
-	<a class="reference-link" href="../Note%20Types">
+	<a class="reference-link" href="../Note%20Types.md">
 		Note Types
 	</a>
 	.
@@ -30,7 +30,7 @@ Here's part of the HTML representation of this note, as it's stored in the datab
 
 ## Viewing the source code
 
-It is possible to view the source code of a note by pressing the contextual menu in [Note buttons](../Basic%20Concepts%20and%20Features/UI%20Elements/Note%20buttons.md) and selecting _Note source_.
+It is possible to view the source code of a note by pressing the contextual menu in <a class="reference-link" href="../Basic%20Concepts%20and%20Features/UI%20Elements/Note%20buttons.md">Note buttons</a> and selecting _Note source_.
 
 ![](Note%20source_image.png)
 

docs/User Guide/User Guide/Advanced Usage/Technologies used.md

@@ -1,4 +1,4 @@
 # Technologies used
-One core aspect of Trilium that allows it to have support for multiple [Note Types](../Note%20Types) is the fact that it makes use of various off-the-shelf or reusable libraries.
+One core aspect of Trilium that allows it to have support for multiple [Note Types](../Note%20Types.md) is the fact that it makes use of various off-the-shelf or reusable libraries.
 
 The sub-pages showcase some of the technologies used, for a better understanding of how Trilium works but also to credit the developers of that particular technology.

docs/User Guide/User Guide/Advanced Usage/Technologies used/Leaflet.md

@@ -1,5 +1,5 @@
 # Leaflet
-Leaflet is the library behind [Geo map](../../Note%20Types/Geo%20map.md) notes.
+Leaflet is the library behind [Geo map](../../Note%20Types/Geo%20Map.md) notes.
 
 ## Plugins
 

docs/User Guide/User Guide/Basic Concepts and Features/Navigation/Jump to Note.md

@@ -0,0 +1,15 @@
+# Jump to Note
+<figure class="image image-style-align-center"><img style="aspect-ratio:991/403;" src="Jump to Note_image.png" width="991" height="403"></figure>
+
+The _Jump to Note_ function allows easy navigation between notes by searching for their title. In addition to that, it can also trigger a full search or create notes.
+
+## Entering jump to note
+
+*   In the <a class="reference-link" href="../UI%20Elements/Launch%20Bar.md">Launch Bar</a>, press ![](1_Jump%20to%20Note_image.png) button.
+*   Using the keyboard, press <kbd>Ctrl</kbd> + <kbd>J</kbd>.
+
+## Interaction
+
+*   By default, when there is no text entered it will display the most recent notes (see <a class="reference-link" href="Note%20Navigation.md">Note Navigation</a>).
+*   Using the keyboard, use the up or down arrow keys to navigate between items. Press <kbd>Enter</kbd> to open the desired note.
+*   If the note doesn't exist, it's possible to create it by typing the desired note title and selecting the _Create and link child note_ option.

docs/User Guide/User Guide/Basic Concepts and Features/Navigation/Quick search.md

@@ -0,0 +1,15 @@
+# Quick search
+<figure class="image image-style-align-center"><img style="aspect-ratio:659/256;" src="Quick search_image.png" width="659" height="256"></figure>
+
+The _Quick search_ function does a full-text search (that is, it searches through the content of notes and not just the title of a note) and displays the result in an easy-to-access manner.
+
+The alternative to the quick search is the <a class="reference-link" href="Search.md">Search</a> function, which opens in a dedicated tab and has support for advanced queries.
+
+For even faster navigation, it's possible to use <a class="reference-link" href="Jump%20to%20Note.md">Jump to Note</a> which will only search through the note titles instead of the content.
+
+## Layout
+
+Based on the <a class="reference-link" href="../UI%20Elements/Vertical%20and%20horizontal%20layout.md">Vertical and horizontal layout</a>, the quick search is placed:
+
+*   On the vertical layout, it is displayed right above the <a class="reference-link" href="../UI%20Elements/Note%20Tree.md">Note Tree</a>.
+*   On the horizontal layout, it is displayed in the <a class="reference-link" href="../UI%20Elements/Launch%20Bar.md">Launch Bar</a>, where it can be positioned just like any other icon.

docs/User Guide/User Guide/Basic Concepts and Features/Navigation/Similar Notes.md

@@ -0,0 +1,12 @@
+# Similar Notes
+<figure class="image image-style-align-center"><img style="aspect-ratio:1626/540;" src="Similar Notes_image.png" width="1626" height="540"></figure>
+
+The Similar Notes feature tries to identify notes that relate to the current note by looking at the content of the notes, their relationships, as well as the date they were created.
+
+To access the list of similar notes, press the “Similar Notes” tab in the <a class="reference-link" href="../UI%20Elements/Ribbon.md">Ribbon</a>.
+
+## Interaction
+
+*   Hover over a note to see a short preview of the note.
+*   Click over a note to open it in the current view.
+*   <kbd>Ctrl</kbd> + click a note to open it in a separate tab.

docs/User Guide/User Guide/Basic Concepts and Features/Notes.md

@@ -3,16 +3,9 @@ Note is a central entity in Trilium. Main attributes of note are title and conte
 
 ### Note types
 
-*   [text note](../Note%20Types/Text.md) - this is default note type which allows you to put rich text, images etc.
-*   [code note](../Note%20Types/Code.md) - some kind of formal code, typically programming language (e.g. JavaScript) or data structure (e.g. JSON)
-*   [image note](https://github.com/TriliumNext/Notes/wiki/Images) - represents single image
-*   file note - represents uploaded file (e.g. docx MS Word document).
-*   render HTML note - this works as an output screen of attached [scripts](../Note%20Types/Code/Scripts.md)
-*   [saved search](../Note%20Types/Saved%20Search.md) note - contains saved search query and dynamically displays result of the search as its sub-notes
-*   [relation map](../Note%20Types/Relation%20Map.md) note - visualizes notes and their relations
-*   [book note](../Note%20Types/Book.md) - displays its children notes, useful for reading many short notes
-*   mermaid - create diagrams and flowcharts using [mermaid.js ↗](https://github.com/mermaid-js/mermaid)
-*   [canvas note](#root/fKYGY3OOo5d1) - allows hand drawn notes and basic diagraming on an infinite canvas using [excalidraw ↗](https://github.com/excalidraw/excalidraw)
+The main note type is a rich-text note type called <a class="reference-link" href="../Note%20Types/Text.md">Text</a>. For diagrams and drawing there is <a class="reference-link" href="../Note%20Types/Canvas.md">Canvas</a> and <a class="reference-link" href="../Note%20Types/Mermaid%20Diagrams.md">Mermaid Diagrams</a>.
+
+There are also more complex note types such as <a class="reference-link" href="../Note%20Types/Saved%20Search.md">Saved Search</a>, <a class="reference-link" href="../Note%20Types/Render%20Note.md">Render Note</a> that usually go hand-in-hand with <a class="reference-link" href="../Note%20Types/Code/Scripting.md">Scripting</a>.
 
 In Trilium there's no specific "folder" note type. Any note can have children and thus be a folder.
 
@@ -22,7 +15,7 @@ There's one special note called "root note" which is root of the note tree. All
 
 ### Tree structure
 
-Importantly, note itself doesn't carry information on its placement in note tree. See [cloning](Notes/Cloning%20Notes.md) for details.
+Importantly, note itself doesn't carry information on its placement in note tree. See <a class="reference-link" href="Notes/Cloning%20Notes.md">Cloning Notes</a> for details.
 
 Tree structure of notes can resemble file system - but compared to that notes in Trilium can act as both file and directory - meaning that note can both have its own content and have children. "Leaf note" is a note which doesn't have any children.
 
@@ -36,7 +29,7 @@ Clicking an undelete will recover the note, it's content and attributes - note s
 
 To be able to undelete a note, it is necessary that deleted note's parent must be undeleted (otherwise there's no place where we can undelete it to). This might become a problem when you delete more notes in succession - the solution is then undelete in the reverse order of your deletion.
 
-After the 7 days (configurable) the notes will be "erased" - their title, content, revisions and attributes will be erased, and it will not be possible anymore to recover them (unless you restore [backup](../Installation%20%26%20Setup/Backup.md)).
+After the 7 days (configurable) the notes will be "erased" - their title, content, revisions and attributes will be erased, and it will not be possible anymore to recover them (unless you restore a <a class="reference-link" href="../Installation%20%26%20Setup/Backup.md">Backup</a>).
 
 ## See also
 

docs/User Guide/User Guide/Basic Concepts and Features/Notes/Attachments.md

@@ -1,8 +1,12 @@
 # Attachments
 A [note](../Notes.md) in Trilium can _own_ one or more attachments, which can be either images or files. These attachments can be displayed or linked within the note that owns them.
 
-This can be especially useful to include dependencies for your [scripts](../../Note%20Types/Code/Scripts.md). The [Weight Tracker](../../Advanced%20Usage/Advanced%20Showcases/Weight%20Tracker.md) shows how to use [chartjs](https://chartjs.org/) which is attached to the [script note](#root/HcUYTojFohtb).
+This can be especially useful to include dependencies for your [scripts](../../Note%20Types/Code/Scripting.md). The <a class="reference-link" href="../../Advanced%20Usage/Advanced%20Showcases/Weight%20Tracker.md">Weight Tracker</a> shows how to use [chartjs](https://chartjs.org/) which is attached to the script note.
 
 Each note exclusively owns its attachments, meaning attachments cannot be shared or linked from one note to another. If an attachment link is copied to a different note, the attachment itself is duplicated, and the copies are managed independently thereafter.
 
 Attachments, especially image files, are the recommended method for embedding visuals in notes. It is important to link image attachments within the text of the owning note; otherwise, they will be automatically deleted after a configurable timeout period if not referenced.
+
+## Attachment previews
+
+Attachments share the same content preview for images, videos, PDFs, etc. as the <a class="reference-link" href="../../Note%20Types/File.md">File</a> note type.

docs/User Guide/User Guide/Basic Concepts and Features/Notes/Export as PDF.md

@@ -5,15 +5,29 @@ Screenshot of the note contextual menu indicating the “Export as PDF” option
 
 On the desktop application of Trilium it is possible to export a note as PDF. On the server or PWA (mobile), the option is not available due to technical constraints and it will be hidden.
 
-To print a note, select the ![](1_Export%20as%20PDF_image.png)button to the right of the note and select _Export as PDF_.
+To print a note, select the ![](1_Export%20as%20PDF_image.png) button to the right of the note and select _Export as PDF_.
 
-Afterwards you will be prompted to select where to save the PDF file. Upon confirmation, the resulting PDF will be opened automatically using the default/system application configured for PDFs.
+Afterwards you will be prompted to select where to save the PDF file.
 
-Should you encounter any visual issues in the resulting PDF file (e.g. a table does not fit properly, there is cut off text, etc.) feel free to [report the issue](#root/OeKBfN6JbMIq/jRV1MPt4mNSP/hrC6xn7hnDq5). In this case, it's best to offer a sample note (click on the ![](1_Export%20as%20PDF_image.png)button, select Export note → This note and all of its descendants → HTML in ZIP archive). Make sure not to accidentally leak any personal information.
+## Automatic opening of the file
+
+When the PDF is exported, it is automatically opened with the system default application for easy preview.
+
+Note that if you are using Linux with the GNOME desktop environment, sometimes the default application might seem incorrect (such as opening in GIMP). This is because it uses Gnome's “Recommended applications” list.
+
+To solve this, you can change the recommended application for PDFs via this command line. First, list the available applications via `gio mime application/pdf` and then set the desired one. For example to use GNOME's Evince:
+
+```
+gio mime application/pdf
+```
+
+## Reporting issues with the rendering
+
+Should you encounter any visual issues in the resulting PDF file (e.g. a table does not fit properly, there is cut off text, etc.) feel free to [report the issue](../../Troubleshooting/Reporting%20issues.md). In this case, it's best to offer a sample note (click on the ![](1_Export%20as%20PDF_image.png) button, select Export note → This note and all of its descendants → HTML in ZIP archive). Make sure not to accidentally leak any personal information.
 
 ## Landscape mode
 
-When exporting to PDF, there are no customizable settings such as page orientation, size, etc. However, it is possible to specify a given note to be printed as a PDF in landscape mode by adding the `#printLandscape` attribute to it (see [\[missing note\]](#root/9QRytp0ZYFIf/PnO38wN0ffOA)).
+When exporting to PDF, there are no customizable settings such as page orientation, size, etc. However, it is possible to specify a given note to be printed as a PDF in landscape mode by adding the `#printLandscape` attribute to it (see <a class="reference-link" href="../../Advanced%20Usage/Attributes.md">Attributes</a>).
 
 ## Page size
 
@@ -21,4 +35,4 @@ By default, the resulting PDF will be in Letter format. It is possible to adjust
 
 ## Keyboard shortcut
 
-It's possible to trigger the export to PDF from the keyboard by going to _Keyboard shortcuts_ and assigning a key combination for the `exportAsPdf` action.
+It's possible to trigger the export to PDF from the keyboard by going to _Keyboard shortcuts_ in <a class="reference-link" href="../UI%20Elements/Options.md">Options</a> and assigning a key combination for the `exportAsPdf` action.

docs/User Guide/User Guide/Basic Concepts and Features/Notes/Note List.md

@@ -0,0 +1,34 @@
+# Note List
+When a note has one or more child notes, they will be listed at the end of the note for easy navigation.
+
+## View types
+
+By default, the notes will be displayed in a grid, however there are also some other view types available.
+
+> [!TIP]
+> Generally the view type can only be changed in a <a class="reference-link" href="../../Note%20Types/Book.md">Book</a> note from the <a class="reference-link" href="../UI%20Elements/Ribbon.md">Ribbon</a>, but it can also be changed manually on any type of note using the `#viewType` attribute.
+
+### Grid view
+
+<figure class="image image-style-align-center"><img style="aspect-ratio:1025/655;" src="1_Note List_image.png" width="1025" height="655"></figure>
+
+This view presents the child notes in a grid format, allowing for a more visual navigation experience.
+
+*   For <a class="reference-link" href="../../Note%20Types/Text.md">Text</a> notes, the text can be slighly scrollable via the mouse wheel to reveal more context.
+*   For <a class="reference-link" href="../../Note%20Types/Code.md">Code</a> notes, syntax highlighting is applied.
+*   For <a class="reference-link" href="../../Note%20Types/File.md">File</a> notes, a preview is made available for audio, video and PDF notes.
+*   If the note does not have a content, a list of its child notes will be displayed instead.
+
+This is the default view type.
+
+### List view
+
+<figure class="image image-style-align-center"><img style="aspect-ratio:1013/526;" src="Note List_image.png" width="1013" height="526"></figure>
+
+In the list view mode, each note is displayed in a single row with only the title and the icon of the note being visible by the default. By pressing the expand button it's possible to view the content of the note, as well as the children of the note (recursively).
+
+### Calendar view
+
+<figure class="image image-style-align-center"><img style="aspect-ratio:1090/598;" src="2_Note List_image.png" width="1090" height="598"></figure>
+
+In the calendar view, child notes are represented as events, with a start date and optionally an end date. The view also has interaction support such as moving or creating new events. See <a class="reference-link" href="Note%20List/Calendar%20View.md">Calendar View</a> for more information.

docs/User Guide/User Guide/Basic Concepts and Features/Notes/Note List/Calendar View.md

@@ -0,0 +1,102 @@
+# Calendar View
+<figure class="image image-style-align-center"><img style="aspect-ratio:767/606;" src="4_Calendar View_image.png" width="767" height="606"></figure>
+
+The Calendar view of Book notes will display each child note in a calendar that has a start date and optionally an end date, as an event.
+
+The Calendar view has multiple display modes:
+
+*   Week view, where all the 7 days of the week (or 5 if the weekends are hidden) are displayed in columns. This mode allows entering and displaying time-specific events, not just all-day events.
+*   Month view, where the entire month is displayed and all-day events can be inserted. Both time-specific events and all-day events are listed.
+*   Year view, which displays the entire year for quick reference.
+*   List view, which displays all the events of a given month in sequence.
+
+Unlike other Book view types, the Calendar view also allows some kind of interaction, such as moving events around as well as creating new ones.
+
+## Creating a calendar
+
+<figure class="table"><table><thead><tr><th>&nbsp;</th><th>&nbsp;</th><th>&nbsp;</th></tr></thead><tbody><tr><td>1</td><td><img src="2_Calendar View_image.png"></td><td>The Calendar View works only for Book note types. To create a new note, right click on the note tree on the left and select Insert note after, or Insert child note and then select <em>Book</em>.</td></tr><tr><td>2</td><td><img src="3_Calendar View_image.png"></td><td>Once created, the “View type” of the Book needs changed to “Calendar”, by selecting the “Book Properties” tab in the ribbon.</td></tr></tbody></table></figure>
+
+## Creating a new event/note
+
+*   Clicking on a day will create a new child note and assign it to that particular day.
+    *   You will be asked for the name of the new note. If the popup is dismissed by pressing the close button or escape, then the note will not be created.
+*   It's possible to drag across multiple days to set both the start and end date of a particular note.  
+    ![](Calendar%20View_image.png)
+*   Creating new notes from the calendar will respect the `~child:template` relation if set on the book note.
+
+## Interacting with events
+
+*   Hovering the mouse over an event will display information about the note.  
+    ![](7_Calendar%20View_image.png)
+*   Left clicking the event will go to that note. Middle clicking will open the note in a new tab and right click will offer more options including opening the note in a new split or window.
+*   Drag and drop an event on the calendar to move it to another day.
+*   The length of an event can be changed by placing the mouse to the right edge of the event and dragging the mouse around.
+
+## Configuring the calendar
+
+The following attributes can be added to the book type:
+
+<figure class="table"><table><thead><tr><th>Name</th><th>Description</th></tr></thead><tbody><tr><td><code>#calendar:hideWeekends</code></td><td>When present (regardless of value), it will hide Saturday and Sundays from the calendar.</td></tr><tr><td><code>#calendar:weekNumbers</code></td><td>When present (regardless of value), it will show the number of the week on the calendar.</td></tr><tr><td><code>#calendar:view</code></td><td><p>Which view to display in the calendar:</p><ul><li><code>timeGridWeek</code> for the <em>week</em> view;</li><li><code>dayGridMonth</code> for the <em>month</em> view;</li><li><code>multiMonthYear</code> for the <em>year</em> view;</li><li><code>listMonth</code> for the <em>list</em> view.</li></ul><p>Any other value will be dismissed and the default view (month) will be used instead.</p><p>The value of this label is automatically updated when changing the view using the UI buttons.</p></td></tr><tr><td><code>~child:template</code></td><td>Defines the template for newly created notes in the calendar (via dragging or clicking).</td></tr></tbody></table></figure>
+
+In addition, the first day of the week can be either Sunday or Monday and can be adjusted from the application settings.
+
+## Configuring the calendar events
+
+For each note of the calendar, the following attributes can be used:
+
+<figure class="table"><table><thead><tr><th>Name</th><th>Description</th></tr></thead><tbody><tr><td><code>#startDate</code></td><td>The date the event starts, which will display it in the calendar. The format is <code>YYYY-MM-DD</code> (year, month and day separated by a minus sign).</td></tr><tr><td><code>#endDate</code></td><td>Similar to <code>startDate</code>, mentions the end date if the event spans across multiple days. The date is inclusive, so the end day is also considered. The attribute can be missing for single-day events.</td></tr><tr><td><code>#startTime</code></td><td>The time the event starts at. If this value is missing, then the event is considered a full-day event. The format is <code>HH:MM</code> (hours in 24-hour format and minutes).</td></tr><tr><td><code>#endTime</code></td><td>Similar to <code>startTime</code>, it mentions the time at which the event ends (in relation with <code>endDate</code> if present, or <code>startDate</code>).</td></tr><tr><td><code>#color</code></td><td>Displays the event with a specified color (named such as <code>red</code>, <code>gray</code> or hex such as <code>#FF0000</code>). This will also change the color of the note in other places such as the note tree.</td></tr><tr><td><code>#calendar:color</code></td><td>Similar to <code>#color</code>, but applies the color only for the event in the calendar and not for other places such as the note tree.</td></tr><tr><td><code>#iconClass</code></td><td>If present, the icon of the note will be displayed to the left of the event title.</td></tr><tr><td><code>#calendar:title</code></td><td>Changes the title of an event to point to an attribute of the note other than the title, can either a label or a relation (without the <code>#</code> or <code>~</code> symbol). See <em>Use-cases</em> for more information.</td></tr><tr><td><code>#calendar:displayedAttributes</code></td><td>Allows displaying the value of one or more attributes in the calendar like this:&nbsp;&nbsp;&nbsp;&nbsp;<br><br><img src="9_Calendar View_image.png"> &nbsp;&nbsp;<br><br><code>#weight="70" #Mood="Good" #calendar:displayedAttributes="weight,Mood"</code>&nbsp;&nbsp;<br><br>It can also be used with relations, case in which it will display the title of the target note:&nbsp;&nbsp;&nbsp;<br><br><code>~assignee=@My assignee #calendar:displayedAttributes="assignee"</code></td></tr><tr><td><code>#calendar:startDate</code></td><td>Allows using a different label to represent the start date, other than <code>startDate</code> (e.g. <code>expiryDate</code>). The label name <strong>must not be</strong> prefixed with <code>#</code>. If the label is not defined for a note, the default will be used instead.</td></tr><tr><td><code>#calendar:endDate</code></td><td>Similar to <code>#calendar:startDate</code>, allows changing the attribute which is being used to read the end date.</td></tr><tr><td><code>#calendar:startTime</code></td><td>Similar to <code>#calendar:startDate</code>, allows changing the attribute which is being used to read the start time.</td></tr><tr><td><code>#calendar:endTime</code></td><td>Similar to <code>#calendar:startDate</code>, allows changing the attribute which is being used to read the end time.</td></tr></tbody></table></figure>
+
+## How the calendar works
+
+![](11_Calendar%20View_image.png)
+
+The calendar displays all the child notes of the book that have a `#startDate`. An `#endDate` can optionally be added.
+
+If editing the start date and end date from the note itself is desirable, the following attributes can be added to the book note:
+
+```
+#viewType=calendar #label:startDate(inheritable)="promoted,alias=Start Date,single,date"
+#label:endDate(inheritable)="promoted,alias=End Date,single,date"
+#hidePromotedAttributes 
+```
+
+This will result in:
+
+![](10_Calendar%20View_image.png)
+
+When not used in a Journal, the calendar is recursive. That is, it will look for events not just in its child notes but also in the children of these child notes.
+
+## Use-cases
+
+### Using with the Journal / calendar
+
+It is possible to integrate the calendar view into the Journal with day notes. In order to do so change the note type of the Journal note (calendar root) to Book and then select the Calendar View.
+
+Based on the `#calendarRoot` (or `#workspaceCalendarRoot`) attribute, the calendar will know that it's in a calendar and apply the following:
+
+*   The calendar events are now rendered based on their `dateNote` attribute rather than `startDate`.
+*   Interactive editing such as dragging over an empty era or resizing an event is no longer possible.
+*   Clicking on the empty space on a date will automatically open that day's note or create it if it does not exist.
+*   Direct children of a day note will be displayed on the calendar despite not having a `dateNote` attribute. Children of the child notes will not be displayed.
+
+<img src="8_Calendar View_image.png" width="1217" height="724">
+
+### Using a different attribute as event title
+
+By default, events are displayed on the calendar by their note title. However, it is possible to configure a different attribute to be displayed instead.
+
+To do so, assign `#calendar:title` to the child note (not the calendar/book note), with the value being `name` where `name` can be any label (make not to add the `#` prefix). The attribute can also come through inheritance such as a template attribute. If the note does not have the requested label, the title of the note will be used instead.
+
+<figure class="table" style="width:100%;"><table><thead><tr><th>&nbsp;</th><th>&nbsp;</th></tr></thead><tbody><tr><td><pre><code class="language-text-x-trilium-auto">#startDate=2025-02-11 #endDate=2025-02-13 #name="My vacation" #calendar:title="name"</code></pre></td><td><p>&nbsp;</p><figure class="image image-style-align-center"><img style="aspect-ratio:445/124;" src="5_Calendar View_image.png" width="445" height="124"></figure></td></tr></tbody></table></figure>
+
+### Using a relation attribute as event title
+
+Similarly to using an attribute, use `#calendar:title` and set it to `name` where `name` is the name of the relation to use.
+
+Moreover, if there are more relations of the same name, they will be displayed as multiple events coming from the same note.
+
+<figure class="table" style="width:100%;"><table><thead><tr><th>&nbsp;</th><th>&nbsp;</th></tr></thead><tbody><tr><td><pre><code class="language-text-x-trilium-auto">#startDate=2025-02-14 #endDate=2025-02-15 ~for=@John Smith ~for=@Jane Doe #calendar:title="for"</code></pre></td><td><img src="6_Calendar View_image.png" width="294" height="151"></td></tr></tbody></table></figure>
+
+Note that it's even possible to have a `#calendar:title` on the target note (e.g. “John Smith”) which will try to render an attribute of it. Note that it's not possible to use a relation here as well for safety reasons (an accidental recursion  of attributes could cause the application to loop infinitely).
+
+<figure class="table" style="width:100%;"><table><thead><tr><th>&nbsp;</th><th>&nbsp;</th></tr></thead><tbody><tr><td><pre><code class="language-text-x-trilium-auto">#calendar:title="shortName" #shortName="John S."</code></pre></td><td><figure class="image image-style-align-center"><img style="aspect-ratio:296/150;" src="1_Calendar View_image.png" width="296" height="150"></figure></td></tr></tbody></table></figure>

docs/User Guide/User Guide/Basic Concepts and Features/Notes/Read-Only Notes.md

@@ -1,12 +1,44 @@
 # Read-Only Notes
-Both [text](../../Note%20Types/Text.md) and [code](../../Note%20Types/Code.md) notes in Trilium can be set to read-only. When a note is in read-only mode, it is presented to the user in a non-editable view, with the option to switch to editing mode if needed.
+Some note types such as <a class="reference-link" href="../../Note%20Types/Text.md">Text</a> and <a class="reference-link" href="../../Note%20Types/Code.md">Code</a> notes in Trilium can be set to read-only. When a note is in read-only mode, it is presented to the user in a non-editable view, with the option to switch to editing mode if needed.
 
-## Setting Read-Only Mode with a Label
-
-To set a note as read-only, add the `readOnly` [label](../../Advanced%20Usage/Attributes.md) to the note.
-
-## Automatic Read-Only Mode
+## Automatic read-only mode
 
 For optimization purposes, Trilium will automatically set very large notes to read-only. Displaying such lengthy notes in editing mode can slow down performance, especially when editing is unnecessary.
 
-If you want to ensure that a specific note remains editable regardless of its size, you can add the `autoReadOnlyDisabled` [label](../../Advanced%20Usage/Attributes.md) to the note.
+This behavior can be disabled on a per-note basis, by following the instructions of the next section.
+
+In addition, it's possible to change the number of characters at which the automatic read-only mode will trigger in <a class="reference-link" href="../UI%20Elements/Options.md">Options</a> by going to the options for <a class="reference-link" href="#root/_hidden/_options/_optionsTextNotes">Text Notes</a> and <a class="reference-link" href="#root/_hidden/_options/_optionsCodeNotes">Code Notes</a>.
+
+## Changing a note's read-only behavior
+
+Via the <a class="reference-link" href="../UI%20Elements/Ribbon.md">Ribbon</a>, by going to the _Basic Properties_ tab and looking for the _Editable_ selection. The following options are possible:
+
+*   **Auto**  
+    This is the default behavior in which the note will be editable by default, unless it becomes large enough to trigger read-only mode.  
+     
+*   **Read-only**  
+    The note will be always marked as read-only, regardless of its size. Nevertheless, it's still possible to temporarily edit the note if needed. This is generally useful for notes that are not prone to change.  
+     
+*   **Always Editable**  
+    This option will bypass the automatic read-only activation for this particular note. It's useful for large notes that are frequently edited.
+
+If the _Editable_ section is missing from the ribbon, then the note type does not support read-only mode.
+
+### Manually setting the options
+
+Apart from using the ribbon as previously mentioned, it's also possible to use [labels](../../Advanced%20Usage/Attributes.md) to change the behavior:
+
+*   To set as read-only, apply the `readOnly` label to the note.
+*   To disable automatic read-only (always editable), apply the `autoReadOnlyDisabled` label.
+
+## Temporarily editing a read-only note
+
+When accessing a read-only note, it's possible to temporarily edit it by using the ![](Read-Only%20Notes_image.png) button in the <a class="reference-link" href="../UI%20Elements/Floating%20buttons.md">Floating buttons</a> area.
+
+When pressed, the note will become editable but will become read-only again after navigating to a different note.
+
+## Special read-only behavior
+
+Some note types have a special behavior based on whether the read-only mode is enabled:
+
+*   <a class="reference-link" href="../../Note%20Types/Mermaid%20Diagrams.md">Mermaid Diagrams</a> will hide the Mermaid source code and display the diagram preview in full-size. In this case, the read-only mode can be easily toggled on or off via a dedicated button in the <a class="reference-link" href="../UI%20Elements/Floating%20buttons.md">Floating buttons</a> area.

docs/User Guide/User Guide/Basic Concepts and Features/Themes.md

@@ -10,7 +10,7 @@ Trilium comes with a couple pre-installed color themes, with the default being a
 Trilium supports custom user themes, allowing you to personalize the application's appearance. To create a custom theme, follow these steps:
 
 1.  **Create a CSS Code Note**: Start by creating a new [code note](../Note%20Types/Code.md) with the `CSS` type.
-2.  **Annotate with** `**#appTheme**`: Add the [attribute](../Advanced%20Usage/Attributes.md) `#appTheme=my-theme-name` to your note, where `my-theme-name` is the name of your custom theme.
+2.  **Annotate with** `#appTheme`: Add the [attribute](../Advanced%20Usage/Attributes.md) `#appTheme=my-theme-name` to your note, where `my-theme-name` is the name of your custom theme.
 3.  **Define Your Styles**: Write your custom CSS within the note. Below is an example of a custom theme:
 
 ```
@@ -83,7 +83,7 @@ If you make changes to your theme, press <kbd>Ctrl</kbd> + <kbd>R</kbd> to reloa
 
 Custom themes can be exported as `.tar` archives, which can be shared with other users. However, be cautious when importing themes from untrusted sources, as they may contain executable scripts that could pose security risks.
 
-An example user theme, _Steel Blue_, is available in the [demo document](#root/xjSsCcvVZf6H).
+An example user theme, _Steel Blue_, is available in the demo document.
 
 ![Steel Blue Theme](../Attachments/steel-blue.png)
 
@@ -95,8 +95,8 @@ In addition to full themes, Trilium allows for custom CSS that isn't tied to a t
 
 To use custom CSS:
 
-1.  **Create a CSS Code Note**: Create a new [code note](../Note%20Types/Code.md) with the `CSS` type.
-2.  **Add the** `**appCss**` **Label**: Annotate the note with the `#appCss` [label](../Advanced%20Usage/Attributes.md).
+1.  **Create a CSS Code Note**: Create a new <a class="reference-link" href="../Note%20Types/Code.md">Code</a> note with the `CSS` type.
+2.  **Add the** `appCss` **Label**: Annotate the note with the `#appCss` [label](../Advanced%20Usage/Attributes.md).
 3.  **Write Your CSS**: Add your custom CSS rules to the note.
 
 For example:
@@ -118,14 +118,14 @@ After making changes, press <kbd>Ctrl</kbd> + <kbd>R</kbd> to reload the fronten
 
 To apply specific styles to certain notes in the tree:
 
-*   **Use the** `**cssClass**` **Attribute**: Add the `cssClass` [attribute](../Advanced%20Usage/Attributes.md) to a note, and assign it a value representing the desired CSS class.
-*   **Define an** `**iconClass**`: You can also define a custom icon for a note using the `iconClass` attribute, selecting from [Box Icons](https://boxicons.com) or your own custom classes.
+*   **Use the** `cssClass` **Attribute**: Add the `cssClass` [attribute](../Advanced%20Usage/Attributes.md) to a note, and assign it a value representing the desired CSS class.
+*   **Define an** `iconClass`: You can also define a custom icon for a note using the `iconClass` attribute, selecting from [Box Icons](https://boxicons.com) or your own custom classes.
 
 For example, if you want to style notes of a specific type, such as notes containing PNG images, you can target them with classes like `type-image mime-image-png`.
 
 ### User-Provided Themes
 
-A gallery of user-created themes is available, showcasing the variety of customizations that the Trilium community has developed. For more information, visit the [Theme Gallery](Themes/Theme%20Gallery.md).
+A gallery of user-created themes is available, showcasing the variety of customizations that the Trilium community has developed. For more information, check the <a class="reference-link" href="Themes/Theme%20Gallery.md">Theme Gallery</a>.
 
 ### Asset Path Management
 

docs/User Guide/User Guide/Basic Concepts and Features/Themes/Theme Gallery.md

@@ -5,25 +5,7 @@ These are user-created themes which were made publicly available:
 
 These themes may or may not be compatible with the latest versions of TriliumNext and are based on the original/legacy theme.
 
-| Theme | Author |
-| --- | --- |
-| [Midnight](https://github.com/tobealive/trilium-midnight-theme) | [tobealive](https://github.com/tobealive) |
-| [EOTE](https://github.com/tobealive/trilum-eote-theme) | [tobealive](https://github.com/tobealive) |
-| [Trilium Themes](https://github.com/Abourass/TriliumThemes) | [Abourass](https://github.com/Abourass) |
-| [MaterialDark](https://github.com/ZMonk91/Material-Dark-Trilium) | [ZMonk91](https://github.com/ZMonk91) |
-| [lightslategray](https://github.com/jaroet/trilium-theme-lightslategray) | [jaroet](https://github.com/jaroet) |
-| [melon-4](https://github.com/raphwriter/trilium-theme-melon) | [raphwriter](https://github.com/raphwriter) |
-| [Neon\_Dark](https://github.com/Engr-AllanG/trilium-themes) | [Engr-AllanG](https://github.com/Engr-AllanG) |
-| [Coder\_Dark](https://github.com/Engr-AllanG/trilium-themes) | [Engr-AllanG](https://github.com/Engr-AllanG) |
-| [velvet](https://github.com/idelem/trilium-theme-velvet) | [idelem](https://github.com/idelem) |
-| [Dark Plus](https://github.com/SADAVA/trilium-notes-theme-dark-plus) | [SADAVA](https://github.com/SADAVA) |
-| [Solarized](https://github.com/WKSu/trilium-solarized-theme) | [WKSu](https://github.com/WKSu) |
-| [Nord](https://github.com/en3r0/Trilium-Nord-Theme) | [en3r0](https://github.com/en3r0) |
-| [Bear Note Light](https://github.com/AllanZyne/trilium-bear-theme) | [AllanZyne](https://github.com/AllanZyne) |
-| [Bear Note Dark](https://github.com/AllanZyne/trilium-bear-theme) | [AllanZyne](https://github.com/AllanZyne) |
-| [Miku Hatsune](https://github.com/Sebiann/miku-hatsune-trilium-theme) | [Sebiann](https://github.com/Sebiann) |
-| [Midnight](https://github.com/cwilliams5/Midnight-Trilium-Dark-Mode) | [cwilliams5](https://github.com/cwilliams5) |
-| [Blue](https://github.com/SiriusXT/trilium-theme-blue) (light) | [SiriusXT](https://github.com/SiriusXT) |
-| [Blue](https://github.com/SiriusXT/trilium-theme-blue) (dark) | [SiriusXT](https://github.com/SiriusXT) |
+<figure class="table"><table><thead><tr><th>Theme</th><th>Author</th></tr></thead><tbody><tr><td><a href="https://github.com/tobealive/trilium-midnight-theme">Midnight</a></td><td><a href="https://github.com/tobealive">tobealive</a></td></tr><tr><td><a href="https://github.com/tobealive/trilum-eote-theme">EOTE</a></td><td><a href="https://github.com/tobealive">tobealive</a></td></tr><tr><td><a href="https://github.com/Abourass/TriliumThemes">Trilium Themes</a></td><td><a href="https://github.com/Abourass">Abourass</a></td></tr><tr><td><a href="https://github.com/ZMonk91/Material-Dark-Trilium">MaterialDark</a></td><td><a href="https://github.com/ZMonk91">ZMonk91</a></td></tr><tr><td><a href="https://github.com/jaroet/trilium-theme-lightslategray">lightslategray</a></td><td><a href="https://github.com/jaroet">jaroet</a></td></tr><tr><td><a href="https://github.com/raphwriter/trilium-theme-melon">melon-4</a></td><td><a href="https://github.com/raphwriter">raphwriter</a></td></tr><tr><td><a href="https://github.com/Engr-AllanG/trilium-themes">Neon_Dark</a></td><td><a href="https://github.com/Engr-AllanG">Engr-AllanG</a></td></tr><tr><td><a href="https://github.com/Engr-AllanG/trilium-themes">Coder_Dark</a></td><td><a href="https://github.com/Engr-AllanG">Engr-AllanG</a></td></tr><tr><td><a href="https://github.com/idelem/trilium-theme-velvet">velvet</a></td><td><a href="https://github.com/idelem">idelem</a></td></tr><tr><td><a href="https://github.com/SADAVA/trilium-notes-theme-dark-plus">Dark Plus</a></td><td><a href="https://github.com/SADAVA">SADAVA</a></td></tr><tr><td><a href="https://github.com/WKSu/trilium-solarized-theme">Solarized</a></td><td><a href="https://github.com/WKSu">WKSu</a></td></tr><tr><td><a href="https://github.com/en3r0/Trilium-Nord-Theme">Nord</a></td><td><a href="https://github.com/en3r0">en3r0</a></td></tr><tr><td><a href="https://github.com/AllanZyne/trilium-bear-theme">Bear Note Light</a></td><td><a href="https://github.com/AllanZyne">AllanZyne</a></td></tr><tr><td><a href="https://github.com/AllanZyne/trilium-bear-theme">Bear Note Dark</a></td><td><a href="https://github.com/AllanZyne">AllanZyne</a></td></tr><tr><td><a href="https://github.com/Sebiann/miku-hatsune-trilium-theme">Miku Hatsune</a></td><td><a href="https://github.com/Sebiann">Sebiann</a></td></tr><tr><td><a href="https://github.com/cwilliams5/Midnight-Trilium-Dark-Mode">Midnight</a></td><td><a href="https://github.com/cwilliams5">cwilliams5</a></td></tr><tr><td><a href="https://github.com/SiriusXT/trilium-theme-blue">Blue</a> (light)</td><td><a href="https://github.com/SiriusXT">SiriusXT</a></td></tr><tr><td><a href="https://github.com/SiriusXT/trilium-theme-blue">Blue</a> (dark)</td><td><a href="https://github.com/SiriusXT">SiriusXT</a></td></tr></tbody></table></figure>
 
-If you would like to add your theme to this gallery, write a new post in [👐 Show and tell](https://github.com/TriliumNext/Notes/discussions/categories/show-and-tell).
+> [!TIP]
+> If you would like to add your theme to this gallery, write a new post in [👐 Show and tell](https://github.com/TriliumNext/Notes/discussions/categories/show-and-tell).

docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Floating buttons.md

@@ -0,0 +1,13 @@
+# Floating buttons
+<figure class="image image-style-align-center"><img style="aspect-ratio:893/144;" src="Floating buttons_image.png" width="893" height="144"></figure>
+
+Depending on the current note, a panel will appear near the top-right of the note, right underneath the <a class="reference-link" href="Ribbon.md">Ribbon</a>. These buttons offer additional interaction that is specific to that particular note.
+
+For example:
+
+*   For <a class="reference-link" href="../../Note%20Types/Mermaid%20Diagrams.md">Mermaid Diagrams</a> and <a class="reference-link" href="../../Note%20Types/Canvas.md">Canvas</a>, there are buttons to download the SVG representation of the note, or to copy a reference to the note for pasting it a <a class="reference-link" href="../../Note%20Types/Text.md">Text</a> note.
+*   For [read-only notes](../Notes/Read-Only%20Notes.md), there is a button to temporarily edit the note for quick modifications.
+
+## Interaction
+
+The floating button area can be collapsed by pressing the two right arrows at the end of the section.

docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Launch Bar.md

@@ -50,7 +50,7 @@ Right click either the _Available launchers_ or _Visible launchers_ sections and
     2.  Optionally, set `hoistedNote` to hoist a particular note. See [Note Hoisting](../Navigation/Note%20Hoisting.md) for more information.
     3.  Optionally, set a `keyboardShortcut` to trigger the launcher.
 2.  **Script Launcher**  
-    An advanced launcher which will run a script upon pressing. See [Scripts](../../Note%20Types/Code/Scripts.md) for more information.
+    An advanced launcher which will run a script upon pressing. See [Scripts](../../Note%20Types/Code/Scripting.md) for more information.
     
     1.  Set `script` to point to the desired script to run.
     2.  Optionally, set a `keyboardShortcut` to trigger the launcher.

docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Options.md

@@ -0,0 +1,25 @@
+# Options
+<figure class="image image-style-align-center"><img style="aspect-ratio:1189/709;" src="Options_image.png" width="1189" height="709"></figure>
+
+The Options section allows the configuration of the TriliumNext client and server.
+
+## Entering options
+
+The Options can be accessed via:
+
+*   The [Global menu](Global%20menu.md), by selecting the _Options_ item.
+*   The ![](1_Options_image.png) button in the [Launch Bar](Launch%20Bar.md) which can optionally be hidden if not desirable.
+*   Optionally, a keyboard shortcut can be defined, but it is not assigned by default.
+*   By clicking on this link: <a class="reference-link" href="#root/_hidden/_options">Options</a>.
+
+Once in the options section, simply select one of the option categories using the <a class="reference-link" href="Note%20Tree.md">Note Tree</a>.
+
+## Exiting options
+
+When entering the options, they are opened in a new [tab](Tabs.md). To close them, simply close the tab.
+
+## Options when using sync
+
+When using <a class="reference-link" href="../../Installation%20%26%20Setup/Synchronization.md">Synchronization</a>, some of the options will be kept in sync across all the devices while others can be changed independently.
+
+Generally, the options that relate to appearance are intentionally kept not synced in order to allow per-client customization (layout orientation, theme, vertical/horizontal layout, code block themes).

docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Ribbon.md

@@ -6,3 +6,59 @@ The ribbon allows changing options, attributes and viewing information about the
 ## Settings
 
 It is possible to change whether some ribbon items will be automatically open when navigating to a new note. To do so, in [Settings](Options.md), go to _Appearance_ and look for the _Ribbon widgets_ section.
+
+## Formatting
+
+If you are using the _Fixed_ formatting toolbar, all the formatting buttons for text notes will appear here. See [Formatting toolbar](../../Note%20Types/Text/Formatting%20toolbar.md) for more information.
+
+## Tabs
+
+### Basic Properties
+
+*   _**Note type**_ allows changing the [note type](../../Note%20Types.md) of a note.
+    *   Generally this is desirable only if the note is empty.
+    *   As a more advanced use, it's possible to change the note type in order to modify the [source code](../../Advanced%20Usage/Note%20source.md) of a note.
+*   _**Protect the note**_ toggles whether the current note is encrypted and accessible only by entering the protected session. See [Protected Notes](../Notes/Protected%20Notes.md) for more information.
+*   _**Editable**_ changes whether the current note:
+    *   Enters [read-only mode](../Notes/Read-Only%20Notes.md) automatically if the note is too big (default behaviour).
+    *   Is always in read-only mode (however it can still be edited temporarily).
+    *   Is always editable, regardless of its size.
+*   _**Bookmark**_ toggles the display of the current note into the [Launch Bar](Launch%20Bar.md) for easy access. See [Bookmarks](../Navigation/Bookmarks.md) for more information.
+*   _**Shared**_ toggles whether the current note is publicly accessible if you have a [server instance](../../Installation%20%26%20Setup/Server%20Installation.md) set up. See [Sharing](../../Advanced%20Usage/Sharing.md) for more information.
+*   _**Template**_ toggles whether the current note is considered a template and can be used to easily create notes with the same content. See [Template](../../Advanced%20Usage/Attributes/Template.md) for more information.
+*   _**Language**_ changes the main language of the current note, mostly useful for spell checking or right-to-left support. See [Content language & Right-to-left support](../../Note%20Types/Text/Content%20language%20%26%20Right-to-le.md) for more information.
+
+### Owned Attributes
+
+This section allows editing the labels and relations of a note. For more information, see [Attributes](../../Advanced%20Usage/Attributes.md).
+
+The plus button to the right offers a simplified way to insert labels and relations, via a graphical input. From this menu, it's also possible to define label and relation definitions (see [Promoted Attributes](../../Advanced%20Usage/Attributes/Promoted%20Attributes.md)).
+
+### Inherited Attributes
+
+This section displays the attributes which are applied to this note via [Attribute Inheritance](../../Advanced%20Usage/Attributes/Attribute%20Inheritance.md). It is not possible to alter the attributes from this section.
+
+### Note Paths
+
+This section displays all the places where the current note has been cloned to. Here the current note can also be cloned to a new location (similar to the [Note Tree](Note%20Tree.md)) See [Cloning Notes](../Notes/Cloning%20Notes.md) for more information.
+
+### Note Map
+
+The note map displays all the relations of the current note to other notes, as well as the subtree structure. See [Note Tree](Note%20Tree.md) for more information.
+
+### Similar Notes
+
+This section lists all the notes that are similar to the current one. See [Similar Notes](../Navigation/Similar%20Notes.md) for more information.
+
+### Note Info
+
+This section displays information about the current note:
+
+*   The [internal ID](../../Advanced%20Usage/Note%20ID.md) of the note.
+*   The [type of the note](../../Note%20Types.md), as well as its MIME type (used mostly for exporting notes).
+*   The created and modification dates.
+*   The estimated size of the note in the [Database](../../Advanced%20Usage/Database.md), as well as its children count and size.
+
+### Edited notes
+
+This section pops automatically when entering a [day note](../../Advanced%20Usage/Advanced%20Showcases/Day%20Notes.md) and shows the notes that were edited that day.

docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Split View.md

@@ -0,0 +1,24 @@
+# Split View
+In Trilium, is possible to work with two or more notes side-by-side.
+
+<figure class="image image-style-align-center"><img style="aspect-ratio:1398/1015;" src="Split View_2_Split View_im.png" width="1398" height="1015"></figure>
+
+## **Interactions**
+
+*   Press the ![](Split%20View_Split%20View_imag.png) button to the right of a note's title to open a new split to the right of it.
+    *   It is possible to have as many splits as desired, simply press again the button.
+    *   Only horizontal splits are possible, vertical or drag & dropping is not supported.
+*   When at least one split is open, press the ![](Split%20View_3_Split%20View_im.png) button next to it to close it.
+*   Use the ![](Split%20View_4_Split%20View_im.png) or the ![](Split%20View_1_Split%20View_im.png) button to move around the splits.
+*   Each [tab](Tabs.md) has its own split view configuration (e.g. one tab can have two notes in a split view, whereas the others are one-note views).
+    *   The tab will indicate only the title of the main note (the first one in the list).
+
+## Splits and the note tree & hoisting
+
+Clicking on the content of a split will focus that split. While focused, the <a class="reference-link" href="Note%20Tree.md">Note Tree</a> will also indicate the note that is being edited.
+
+It is possible for each of the splits to have their own <a class="reference-link" href="../Navigation/Note%20Hoisting.md">Note Hoisting</a>.
+
+When a new split is created, it will share the same note hoisting as the previous one. An easy solution to this is to simply hoist the notes after the split is created.
+
+This is generally quite useful for reorganizing notes from one place to the other, by hoisting the old place in the first split and hoisting the new place to the second one. This will allow easy cut and paste without the tree jumping around from switching between notes.

docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Tabs.md

@@ -0,0 +1,30 @@
+# Tabs
+<figure class="image image-style-align-center"><img style="aspect-ratio:1119/43;" src="2_Tabs_image.png" width="1119" height="43"></figure>
+
+In Trilium, tabs allow easy switching between notes.
+
+## Layout
+
+Depending on the <a class="reference-link" href="Vertical%20and%20horizontal%20layout.md">Vertical and horizontal layout</a>:
+
+*   For the vertical layout, the tabs will be placed at the top but to the right of the <a class="reference-link" href="Note%20Tree.md">Note Tree</a>.
+*   For the horizontal layout, the tabs will be placed at the top in full-width, above the [note tree](Note%20Tree.md), allowing for more tabs to be comfortably displayed.
+
+## Interaction
+
+*   To create a new tab, press the ![](1_Tabs_image.png) button that is to the right of the last tab.
+*   To close a tab, press the corresponding ![](Tabs_image.png) button.
+*   For multitasking, tabs can be used alongside <a class="reference-link" href="Split%20View.md">Split View</a>. Each tab can have one or more notes, displayed horizontally.
+*   Tabs can be reordered by drag-and-dropping it into a new position.
+*   An existing tab can be displayed in a new window by dragging the tab upwards or downwards. It is not possible to combine tabs back into another window.
+
+## Keyboard interaction
+
+Since tabs are a commonly used feature, there are multiple keyboard shortcuts that can be used:
+
+*   <kbd>Ctrl</kbd>+<kbd>T</kbd> to open a new tab.
+*   <kbd>Ctrl</kbd>+<kbd>W</kbd> to close the current tab.
+*   <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>T</kbd> to reopen the last closed tab.
+*   <kbd>Ctrl</kbd>+<kbd>Tab</kbd> and <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Tab</kbd> to go to the next or previous tab.
+*   <kbd>Ctrl</kbd>+<kbd>1</kbd>, <kbd>Ctrl</kbd>+<kbd>2</kbd>, up to <kbd>Ctrl</kbd>+<kbd>9</kbd> to activate the first, second and up til ninth tab.
+*   There is also a shortcut to go to the last tab, but it is not assigned a key by default.

docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Vertical and horizontal layout.md

@@ -7,11 +7,11 @@ Trilium supports two different layouts, based on your preference.
 
 The vertical layout is Trilium's original layout:
 
-*   The [Launcher Bar](Launch%20Bar.md) is positioned on the left side of the screen, with buttons being laid out vertically.
-*   The tab bar is at the top, but to the right of the [Note Tree](Note%20Tree.md).
-*   The [Quick search](Quick%20search.md) is at the top of the [Note Tree](Note%20Tree.md).
-*   The [Note Tree](Note%20Tree.md) can be collapsed by pressing the ![](5_Vertical%20and%20horizontal%20la.png) button at the bottom of the [Launcher Bar](Launch%20Bar.md).
-*   The [Global menu](Global%20menu.md) can be accessed via the ![](4_Vertical%20and%20horizontal%20la.png) icon at the top of the [Launcher Bar](Launch%20Bar.md).
+*   The <a class="reference-link" href="Launch%20Bar.md">Launch Bar</a> is positioned on the left side of the screen, with buttons being laid out vertically.
+*   The tab bar is at the top, but to the right of the <a class="reference-link" href="Note%20Tree.md">Note Tree</a>.
+*   The <a class="reference-link" href="../Navigation/Quick%20search.md">Quick search</a> is at the top of the <a class="reference-link" href="Note%20Tree.md">Note Tree</a>.
+*   The <a class="reference-link" href="Note%20Tree.md">Note Tree</a> can be collapsed by pressing the ![](5_Vertical%20and%20horizontal%20la.png) button at the bottom of the <a class="reference-link" href="Launch%20Bar.md">Launch Bar</a>.
+*   The <a class="reference-link" href="Global%20menu.md">Global menu</a> can be accessed via the ![](4_Vertical%20and%20horizontal%20la.png) icon at the top of the <a class="reference-link" href="Launch%20Bar.md">Launch Bar</a>.
 
 ![](3_Vertical%20and%20horizontal%20la.png)
 
@@ -19,16 +19,16 @@ The vertical layout is Trilium's original layout:
 
 The horizontal layout is a more traditional layout, since it bears similarity with other applications. In this mode:
 
-*   The [Launcher Bar](Launch%20Bar.md) is at the top of the screen, with the buttons laid horizontally.
+*   The <a class="reference-link" href="Launch%20Bar.md">Launch Bar</a> is at the top of the screen, with the buttons laid horizontally.
 *   The tab bar is at the top of the screen, but now covers the entirety of the width, allowing for more tabs to be displayed at once.
-*   The [Quick search](Quick%20search.md) is now part of the [Launcher Bar](Launch%20Bar.md). It can be moved around according to preference and even removed if needed.
-*   The [Note Tree](Note%20Tree.md) can be collapsed by pressing the small ![](1_Vertical%20and%20horizontal%20la.png) button to the left of the first tab.
-*   The [Global menu](Global%20menu.md) can be accessed via the ![](Vertical%20and%20horizontal%20la.png) button at the end of the [Launcher Bar](Launch%20Bar.md).
+*   The <a class="reference-link" href="../Navigation/Quick%20search.md">Quick search</a> is now part of the <a class="reference-link" href="Launch%20Bar.md">Launch Bar</a>. It can be moved around according to preference and even removed if needed.
+*   The <a class="reference-link" href="Note%20Tree.md">Note Tree</a> can be collapsed by pressing the small ![](1_Vertical%20and%20horizontal%20la.png) button to the left of the first tab.
+*   The <a class="reference-link" href="Global%20menu.md">Global menu</a> can be accessed via the ![](Vertical%20and%20horizontal%20la.png) button at the end of the <a class="reference-link" href="Launch%20Bar.md">Launch Bar</a>.
 
 ![](2_Vertical%20and%20horizontal%20la.png)
 
 ## Changing the layout
 
-Go to [Settings](#root/_hidden/_lbRoot/_lbVisibleLaunchers/_lbSettings) and look for the _Appearance_ option on the left. Then look for the _Layout_ section, where there is the possibility to switch between the two available layouts.
+Go to <a class="reference-link" href="Options.md">Options</a> and look for the _Appearance_ option on the left. Then look for the _Layout_ section, where there is the possibility to switch between the two available layouts.
 
 Selecting an option will immediately apply the new layout by reloading the window.

docs/User Guide/User Guide/FAQ.md

@@ -17,7 +17,7 @@ Common request is to allow multiple users collaborate, share notes etc. So far I
 
 *   it's a huge feature, or rather a Pandora's box of collaboration features like user management, permissions, conflict resolution, real-time editing of a note by multiple people etc. This would be a huge amount of work. Trilium Notes is project made mostly by one person in free time and that's unlikely to change in the future.
 *   given its size it would probably pivot the attention away from my main focus which is a personal note-taking
-*   the assumption that only single person has access to the app simplifies many things, or just outright makes them possible. In multi-user app, our [scripting](Note%20Types/Code/Scripts.md)support would be a XSS security hole, while with the single user assumption it's an endless customizable tool.
+*   the assumption that only single person has access to the app simplifies many things, or just outright makes them possible. In multi-user app, our [scripting](Note%20Types/Code/Scripting.md)support would be a XSS security hole, while with the single user assumption it's an endless customizable tool.
 
 ## How to open multiple documents in one Trilium instance
 

docs/User Guide/User Guide/Installation & Setup/Backup.md

@@ -1,5 +1,5 @@
 # Backup
-Trilium supports simple backup scheme where it saves copy of the [document](#root/xjSsCcvVZf6H) on these events:
+Trilium supports simple backup scheme where it saves copy of the <a class="reference-link" href="../Advanced%20Usage/Database.md">Database</a> on these events:
 
 *   once a day
 *   once a week
@@ -8,9 +8,9 @@ Trilium supports simple backup scheme where it saves copy of the [document](#roo
 
 So in total you'll have at most 4 backups from different points in time which should protect you from various problems. These backups are stored by default in `backup` directory placed in the [data directory](Data%20directory.md).
 
-This is only very basic backup solution, and you're encouraged to add some better backup solution - e.g. backing up the [document](#root/xjSsCcvVZf6H) to cloud / different computer etc.
+This is only very basic backup solution, and you're encouraged to add some better backup solution - e.g. backing up the <a class="reference-link" href="../Advanced%20Usage/Database.md">Database</a> to cloud / different computer etc.
 
-Note that [synchronization](Synchronization.md) provides also some backup capabilities by its nature of distributing the data to other computers.
+Note that <a class="reference-link" href="Synchronization.md">Synchronization</a> provides also some backup capabilities by its nature of distributing the data to other computers.
 
 ## Restoring backup
 
@@ -18,7 +18,7 @@ Let's assume you want to restore the weekly backup, here's how to do it:
 
 *   find [data directory](Data%20directory.md) Trilium uses - easy way is to open "About Trilium Notes" from "Menu" in upper left corner and looking at "data directory"
     *   I'll refer to `~/trilium-data` as data directory from now on
-*   find `~/trilium-data/backup/backup-weekly.db` - this is the [document](#root/xjSsCcvVZf6H) backup
+*   find `~/trilium-data/backup/backup-weekly.db` - this is the <a class="reference-link" href="../Advanced%20Usage/Database.md">Database</a> backup
 *   at this point stop/kill Trilium
 *   delete `~/trilium-data/document.db`, `~/trilium-data/document.db-wal` and `~/trilium-data/document.db-shm` (latter two files are auto generated)
 *   copy and rename this `~/trilium-data/backup/backup-weekly.db` to `~/trilium-data/document.db`

docs/User Guide/User Guide/Installation & Setup/Desktop Installation.md

@@ -9,11 +9,11 @@ To install Trilium on your desktop, follow these steps:
 
 Trilium offers various startup scripts to customize your experience:
 
-*   `**trilium-no-cert-check**`: Starts Trilium without validating [TLS certificates](Server%20Installation/TLS%20Configuration.md), useful if connecting to a server with a self-signed certificate.
+*   `trilium-no-cert-check`: Starts Trilium without validating [TLS certificates](Server%20Installation/TLS%20Configuration.md), useful if connecting to a server with a self-signed certificate.
     *   Alternatively, set the `NODE_TLS_REJECT_UNAUTHORIZED=0` environment variable before starting Trilium.
-*   `**trilium-portable**`: Launches Trilium in portable mode, where the [data directory](Data%20directory.md) is created within the application's directory, making it easy to move the entire setup.
-*   `**trilium-safe-mode**`: Boots Trilium in "safe mode," disabling any startup scripts that might cause the application to crash.
+*   `trilium-portable`: Launches Trilium in portable mode, where the [data directory](Data%20directory.md) is created within the application's directory, making it easy to move the entire setup.
+*   `trilium-safe-mode`: Boots Trilium in "safe mode," disabling any startup scripts that might cause the application to crash.
 
 ## Synchronization
 
-For Trilium desktp users who wish to synchronize their data with a server instance, refer to the [Synchronization Guide](Synchronization.md) for detailed instructions.
+For Trilium desktp users who wish to synchronize their data with a server instance, refer to the <a class="reference-link" href="Synchronization.md">Synchronization</a> guide for detailed instructions.

docs/User Guide/User Guide/Installation & Setup/Mobile Frontend.md

@@ -31,4 +31,4 @@ Trilium decides automatically whether to use mobile or desktop frontend. If this
 
 ## Scripting
 
-You can alter the behavior with [scripts](../Note%20Types/Code/Scripts.md) just like for normal frontend. For script notes to be executed, they need to have labeled `#run=mobileStartup`.
+You can alter the behavior with [scripts](../Note%20Types/Code/Scripting.md) just like for normal frontend. For script notes to be executed, they need to have labeled `#run=mobileStartup`.

docs/User Guide/User Guide/Installation & Setup/Server Installation/1. Installing the server/Manual server installation.md

@@ -27,7 +27,7 @@ sudo apt install libpng16-16 libpng-dev pkg-config autoconf libtool build-essent
 
 You can either download source code zip/tar from [https://github.com/TriliumNext/Notes/releases/latest](https://github.com/TriliumNext/Notes/releases/latest).
 
-For the latest version including betas, clone Git repository **from** `**master**` **branch** with:
+For the latest version including betas, clone Git repository **from** `master` **branch** with:
 
 ```
 git clone -b master https://github.com/triliumnext/notes.git

docs/User Guide/User Guide/Note Types.md

@@ -0,0 +1,28 @@
+# Note Types
+One core features of Trilium is that it supports multiple types of notes, depending on the need.
+
+## Creating a new note with a different type via the note tree
+
+The default note type in Trilium (e.g. when creating a new note) is <a class="reference-link" href="Note%20Types/Text.md">Text</a>, since it's for general use.
+
+To create a new note of a different type, head to the <a class="reference-link" href="Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tree.md">Note Tree</a> and right click an existing note where to place the new one and select:
+
+*   _Insert note after_, to put the new note underneath the one selected.
+*   _Insert child note_, to insert the note as a child of the selected note.
+
+![](Note%20Types_image.png)
+
+## Creating a new note of a different type via add link or new tab
+
+*   When adding a [link](Note%20Types/Text/Links.md) in a <a class="reference-link" href="Note%20Types/Text.md">Text</a> note, type the desired title of the new note and press Enter. Afterwards the type of the note will be asked.
+*   Similarly, when creating a new tab, type the desired title and press Enter.
+
+## Changing the type of a note
+
+It is possible to change the type of a note after it has been created via the _Basic Properties_ tab in the <a class="reference-link" href="Basic%20Concepts%20and%20Features/UI%20Elements/Ribbon.md">Ribbon</a>. Note that it's generally a good idea to change the note type only if the note is empty. Can also be used to edit the [source of a note](Advanced%20Usage/Note%20source.md).
+
+## Supported note types
+
+The following note types are supported by Trilium:
+
+<figure class="table" style="width:100%;"><table class="ck-table-resized"><colgroup><col style="width:29.42%;"><col style="width:70.58%;"></colgroup><thead><tr><th>Note Type</th><th>Description</th></tr></thead><tbody><tr><td><a class="reference-link" href="Note%20Types/Text.md">Text</a></td><td>The default note type, which allows for rich text formatting, images, admonitions and right-to-left support.</td></tr><tr><td><a class="reference-link" href="Note%20Types/Code.md">Code</a></td><td>Uses a mono-space font and can be used to store larger chunks of code or plain text than a text note, and has better syntax highlighting.</td></tr><tr><td><a class="reference-link" href="Note%20Types/Saved%20Search.md">Saved Search</a></td><td>Stores the information about a search (the search text, criteria, etc.) for later use. Can be used for quick filtering of a large amount of notes, for example. The search can easily be triggered.</td></tr><tr><td><a class="reference-link" href="Note%20Types/Relation%20Map.md">Relation Map</a></td><td>Allows easy creation of notes and relations between them. Can be used for mainly relational data such as a family tree.</td></tr><tr><td><a class="reference-link" href="Note%20Types/Note%20Map.md">Note Map</a></td><td>Displays the relationships between the notes, whether via relations or their hierarchical structure.</td></tr><tr><td><a class="reference-link" href="Note%20Types/Render%20Note.md">Render Note</a></td><td>Used in&nbsp;<a class="reference-link" href="Note%20Types/Code/Scripting.md">Scripting</a>, it displays the HTML content of another note. This allows displaying any kind of content, provided there is a script behind it to generate it.</td></tr><tr><td><a class="reference-link" href="Note%20Types/Book.md">Book</a></td><td><p>Displays the children of the note either as a grid, a list, or for a more specialized case: a calendar.</p><p>Generally useful for easy reading of short notes.</p></td></tr><tr><td><a class="reference-link" href="Note%20Types/Mermaid%20Diagrams.md">Mermaid Diagrams</a></td><td>Displays diagrams such as bar charts, flow charts, state diagrams, etc. Requires a bit of technical knowledge since the diagrams are written in a specialized format.</td></tr><tr><td><a class="reference-link" href="Note%20Types/Canvas.md">Canvas</a></td><td>Allows easy drawing of sketches, diagrams, handwritten content. Uses the same technology behind <a href="https://excalidraw.com">excalidraw.com</a>.</td></tr><tr><td><a class="reference-link" href="Note%20Types/Web%20View.md">Web View</a></td><td>Displays the content of an external web page, similar to a browser.</td></tr><tr><td><a class="reference-link" href="Note%20Types/Mind%20Map.md">Mind Map</a></td><td>Easy for brainstorming ideas, by placing them in a hierarchical layout.</td></tr><tr><td><a class="reference-link" href="Note%20Types/Geo%20Map.md">Geo Map</a></td><td>Displays the children of the note as a geographical map, one use-case would be to plan vacations. It even has basic support for tracks. Notes can also be created from it.</td></tr><tr><td><a class="reference-link" href="Note%20Types/File.md">File</a></td><td>Represents an uploaded file such as PDFs, images, video or audio files.</td></tr></tbody></table></figure>