feat(docs): document advanced options in context menu

This commit is contained in:
Elian Doran 2025-04-08 21:44:22 +03:00
parent 5eb8e478b7
commit 5b34e8a327
No known key found for this signature in database
15 changed files with 405 additions and 26 deletions

View File

@ -1351,18 +1351,82 @@
"value": "eIg8jdvaoNNd",
"isInheritable": false,
"position": 120
},
{
"type": "relation",
"name": "internalLink",
"value": "ivYnonVFBxbQ",
"isInheritable": false,
"position": 130
},
{
"type": "relation",
"name": "internalLink",
"value": "TBwsyfadTA18",
"isInheritable": false,
"position": 140
},
{
"type": "relation",
"name": "internalLink",
"value": "0vhv7lsOLy82",
"isInheritable": false,
"position": 150
},
{
"type": "relation",
"name": "internalLink",
"value": "W8vYD3Q1zjCR",
"isInheritable": false,
"position": 160
},
{
"type": "relation",
"name": "internalLink",
"value": "aGlEvb9hyDhS",
"isInheritable": false,
"position": 170
},
{
"type": "relation",
"name": "internalLink",
"value": "zEY4DaJG4YT5",
"isInheritable": false,
"position": 180
},
{
"type": "relation",
"name": "internalLink",
"value": "QEAPj01N5f7w",
"isInheritable": false,
"position": 190
},
{
"type": "relation",
"name": "internalLink",
"value": "wArbEsdSae6g",
"isInheritable": false,
"position": 200
}
],
"format": "markdown",
"dataFileName": "Note tree contextual menu.md",
"attachments": [
{
"attachmentId": "GQv4tBf9VSON",
"attachmentId": "8DX1hysz3JRh",
"title": "image.png",
"role": "image",
"mime": "image/png",
"position": 10,
"dataFileName": "Note tree contextual menu_.png"
},
{
"attachmentId": "GQv4tBf9VSON",
"title": "image.png",
"role": "image",
"mime": "image/png",
"position": 10,
"dataFileName": "1_Note tree contextual menu_.png"
}
]
},
@ -2442,6 +2506,52 @@
"position": 10,
"dataFileName": "Cloning Notes_create-clone.gif"
}
],
"dirFileName": "Cloning Notes",
"children": [
{
"isClone": false,
"noteId": "TBwsyfadTA18",
"notePath": [
"pOsGYCXsbNQG",
"gh7bpGYxajRS",
"BFs8mudNFgCS",
"IakOLONlIfGI",
"TBwsyfadTA18"
],
"title": "Branch prefix",
"notePosition": 10,
"prefix": null,
"isExpanded": false,
"type": "text",
"mime": "text/html",
"attributes": [
{
"type": "label",
"name": "iconClass",
"value": "bx bx-rename",
"isInheritable": false,
"position": 10
},
{
"type": "relation",
"name": "internalLink",
"value": "oPVyFC7WL2Lp",
"isInheritable": false,
"position": 20
},
{
"type": "relation",
"name": "internalLink",
"value": "IakOLONlIfGI",
"isInheritable": false,
"position": 30
}
],
"format": "markdown",
"dataFileName": "Branch prefix.md",
"attachments": []
}
]
},
{
@ -2654,6 +2764,13 @@
"value": "bx bx-sort-up",
"isInheritable": false,
"position": 30
},
{
"type": "relation",
"name": "internalLink",
"value": "oPVyFC7WL2Lp",
"isInheritable": false,
"position": 40
}
],
"format": "markdown",

View File

@ -51,10 +51,6 @@ As seen in the demo, you can view the list of all available clones in the "Note
Titles of cloned notes in the tree view have an asterisk to the right to easily see that the note is also placed into some other location.
## Prefix
Since notes can be categorized into multiple places, it's recommended to choose a generalized name that fits into all locations instead of something more specific to avoid confusion. In some cases this isn't possible so Trilium provides "branch prefixes", which is shown before the note name in the tree and as such provides a specific kind of context. The prefix is location specific, so it's displayed only in the tree pane.
## Deleting notes/clones
With clones, it might not be immediately obvious how deleting works.

View File

@ -0,0 +1,6 @@
# Branch prefix
Since a single note can appear into multiple places in the <a class="reference-link" href="../../UI%20Elements/Note%20Tree.md">Note Tree</a> via a process called <a class="reference-link" href="../Cloning%20Notes.md">Cloning Notes</a>, it's recommended to choose a generalized name that fits into all locations instead of something more specific to avoid confusion.
In some cases this isn't possible so Trilium provides "branch prefixes", which is shown before the note name in the tree and as such provides a specific kind of context.
The prefix is location-specific, so it's displayed only in the note tree.

View File

@ -1,7 +1,14 @@
# Sorting Notes
## Sorting Notes
## Manual sorting
You can sort notes by right-clicking the parent note in the note tree and selecting Advanced -> Sort notes by ... This will sort existing notes, but will not automatically sort future notes added to this parent note
You can sort notes by right-clicking the parent note in the <a class="reference-link" href="../UI%20Elements/Note%20Tree.md">Note Tree</a> and selecting Advanced -> Sort notes by ... This will sort existing notes, but will not automatically sort future notes added to this parent note.
The sorting dialog allows:
* Sorting by title, creation or modification date.
* Changing sorting direction can also be adjusted (ascending or descending).
* Ensuring folders are displayed at the top.
* Natural sort, based on the sorting rules of a particular language.
## Automatic/Permanent Sorting

Binary file not shown.

After

Width:  |  Height:  |  Size: 94 KiB

View File

@ -1,5 +1,5 @@
# Note tree contextual menu
<figure class="image image-style-align-right"><img style="aspect-ratio:372/760;" src="Note tree contextual menu_.png" width="372" height="760"></figure>
<figure class="image image-style-align-right"><img style="aspect-ratio:372/760;" src="1_Note tree contextual menu_.png" width="372" height="760"></figure>
The _note tree menu_ can be accessed by right-clicking in the <a class="reference-link" href="../Note%20Tree.md">Note Tree</a>.
@ -62,4 +62,33 @@ The contextual menu can operate:
## Advanced options
To access this options, first look for the _Advanced_ option in the contextual menu to reveal a sub-menu with:
<figure class="image image-style-align-right"><img style="aspect-ratio:289/355;" src="Note tree contextual menu_.png" width="289" height="355"></figure>
The advanced options menu offers some of the less frequently used actions for notes.
To access these options, first look for the _Advanced_ option in the contextual menu to reveal a sub-menu with:
* **Apply bulk actions**
* Opens the <a class="reference-link" href="../../../Advanced%20Usage/Bulk%20Actions.md">Bulk Actions</a> dialog, to apply actions such as adding labels or moving notes to multiple notes at once (see <a class="reference-link" href="Multiple%20selection.md">Multiple selection</a>).
* **Edit branch prefix**
* Opens a dialog to assign a name to be able to distinguish [clones](../../Notes/Cloning%20Notes.md), see <a class="reference-link" href="../../Notes/Cloning%20Notes/Branch%20prefix.md">Branch prefix</a> for more information.
* **Convert to attachment**
* Converts the selected notes to <a class="reference-link" href="../../Notes/Attachments.md">Attachments</a> of their parent notes.
* This functional is most useful when dealing with image <a class="reference-link" href="../../../Note%20Types/File.md">File</a> notes that were imported from an external source or an older version of Trilium.
* **Duplicate subtree**
* Creates a copy of the note and its descendants.
* This process is different from <a class="reference-link" href="../../Notes/Cloning%20Notes.md">Cloning Notes</a> since the duplicated note can be edited independently from the original.
* An alternative to this, if done regularly, would be <a class="reference-link" href="../../../Advanced%20Usage/Templates.md">Templates</a>.
* **Expand subtree**
* Expands all the child notes in the <a class="reference-link" href="../Note%20Tree.md">Note Tree</a>.
* **Collapse subtree**
* Collapses all the child notes in the note tree.
* **Sort by…**
* Opens a dialog to sort all the child notes of the selected note.
* The sorting is done only once, there is an automatic sorting mechanism as well that can be set using <a class="reference-link" href="../../../Advanced%20Usage/Attributes.md">Attributes</a>.
* See <a class="reference-link" href="../../Notes/Sorting%20Notes.md">Sorting Notes</a> for more information.
* **Copy note path to clipboard**
* Copies a URL fragment representing the full path to this branch for a note, such as `#root/Hb2E70L7HPuf/4sRFgMZhYFts/2IVuShedRJ3U/LJVMvKXOFv7n`.
* The URL to manually create <a class="reference-link" href="../../../Note%20Types/Text/Links.md">Links</a> within notes, or for note <a class="reference-link" href="../../Navigation">Navigation</a>.
* **Recent changes in subtree**
* This will open <a class="reference-link" href="../Recent%20Changes.md">Recent Changes</a>, but filtered to only the changes related to this note or one of its descendants.

Binary file not shown.

Before

Width:  |  Height:  |  Size: 94 KiB

After

Width:  |  Height:  |  Size: 32 KiB

View File

@ -1351,18 +1351,82 @@
"value": "eIg8jdvaoNNd",
"isInheritable": false,
"position": 120
},
{
"type": "relation",
"name": "internalLink",
"value": "ivYnonVFBxbQ",
"isInheritable": false,
"position": 130
},
{
"type": "relation",
"name": "internalLink",
"value": "TBwsyfadTA18",
"isInheritable": false,
"position": 140
},
{
"type": "relation",
"name": "internalLink",
"value": "0vhv7lsOLy82",
"isInheritable": false,
"position": 150
},
{
"type": "relation",
"name": "internalLink",
"value": "W8vYD3Q1zjCR",
"isInheritable": false,
"position": 160
},
{
"type": "relation",
"name": "internalLink",
"value": "aGlEvb9hyDhS",
"isInheritable": false,
"position": 170
},
{
"type": "relation",
"name": "internalLink",
"value": "zEY4DaJG4YT5",
"isInheritable": false,
"position": 180
},
{
"type": "relation",
"name": "internalLink",
"value": "QEAPj01N5f7w",
"isInheritable": false,
"position": 190
},
{
"type": "relation",
"name": "internalLink",
"value": "wArbEsdSae6g",
"isInheritable": false,
"position": 200
}
],
"format": "html",
"dataFileName": "Note tree contextual menu.html",
"attachments": [
{
"attachmentId": "GQv4tBf9VSON",
"attachmentId": "8DX1hysz3JRh",
"title": "image.png",
"role": "image",
"mime": "image/png",
"position": 10,
"dataFileName": "Note tree contextual menu_.png"
},
{
"attachmentId": "GQv4tBf9VSON",
"title": "image.png",
"role": "image",
"mime": "image/png",
"position": 10,
"dataFileName": "1_Note tree contextual menu_.png"
}
]
},
@ -2442,6 +2506,52 @@
"position": 10,
"dataFileName": "Cloning Notes_create-clone.gif"
}
],
"dirFileName": "Cloning Notes",
"children": [
{
"isClone": false,
"noteId": "TBwsyfadTA18",
"notePath": [
"pOsGYCXsbNQG",
"gh7bpGYxajRS",
"BFs8mudNFgCS",
"IakOLONlIfGI",
"TBwsyfadTA18"
],
"title": "Branch prefix",
"notePosition": 10,
"prefix": null,
"isExpanded": false,
"type": "text",
"mime": "text/html",
"attributes": [
{
"type": "label",
"name": "iconClass",
"value": "bx bx-rename",
"isInheritable": false,
"position": 10
},
{
"type": "relation",
"name": "internalLink",
"value": "oPVyFC7WL2Lp",
"isInheritable": false,
"position": 20
},
{
"type": "relation",
"name": "internalLink",
"value": "IakOLONlIfGI",
"isInheritable": false,
"position": 30
}
],
"format": "html",
"dataFileName": "Branch prefix.html",
"attachments": []
}
]
},
{
@ -2654,6 +2764,13 @@
"value": "bx bx-sort-up",
"isInheritable": false,
"position": 30
},
{
"type": "relation",
"name": "internalLink",
"value": "oPVyFC7WL2Lp",
"isInheritable": false,
"position": 40
}
],
"format": "html",

View File

@ -103,13 +103,7 @@
the "Note Paths" tab in the Ribbon toolbar.</p>
<p>Titles of cloned notes in the tree view have an asterisk to the right
to easily see that the note is also placed into some other location.</p>
<h2>Prefix</h2>
<p>Since notes can be categorized into multiple places, it's recommended
to choose a generalized name that fits into all locations instead of something
more specific to avoid confusion. In some cases this isn't possible so
Trilium provides "branch prefixes", which is shown before the note name
in the tree and as such provides a specific kind of context. The prefix
is location specific, so it's displayed only in the tree pane.</p>
<p>&nbsp;</p>
<h2>Deleting notes/clones</h2>
<p>With clones, it might not be immediately obvious how deleting works.</p>
<p>If you try to delete a note, it works like this:</p>

View File

@ -0,0 +1,29 @@
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="stylesheet" href="../../../../style.css">
<base target="_parent">
<title data-trilium-title>Branch prefix</title>
</head>
<body>
<div class="content">
<h1 data-trilium-h1>Branch prefix</h1>
<div class="ck-content">
<p>Since a single note can appear into multiple places in the&nbsp;<a class="reference-link"
href="../../UI%20Elements/Note%20Tree.html">Note Tree</a>&nbsp;via a process
called&nbsp;<a class="reference-link" href="../Cloning%20Notes.html">Cloning Notes</a>,
it's recommended to choose a generalized name that fits into all locations
instead of something more specific to avoid confusion.</p>
<p>In some cases this isn't possible so Trilium provides "branch prefixes",
which is shown before the note name in the tree and as such provides a
specific kind of context.</p>
<p>The prefix is location-specific, so it's displayed only in the note tree.</p>
</div>
</div>
</body>
</html>

View File

@ -13,11 +13,18 @@
<h1 data-trilium-h1>Sorting Notes</h1>
<div class="ck-content">
<h2>Sorting Notes</h2>
<p>You can sort notes by right-clicking the parent note in the note tree
and selecting Advanced -&gt; Sort notes by ... This will sort existing
notes, but will not automatically sort future notes added to this parent
note</p>
<h2>Manual sorting</h2>
<p>You can sort notes by right-clicking the parent note in the&nbsp;<a class="reference-link"
href="../UI%20Elements/Note%20Tree.html">Note Tree</a>&nbsp;and selecting
Advanced -&gt; Sort notes by ... This will sort existing notes, but will
not automatically sort future notes added to this parent note.</p>
<p>The sorting dialog allows:</p>
<ul>
<li>Sorting by title, creation or modification date.</li>
<li>Changing sorting direction can also be adjusted (ascending or descending).</li>
<li>Ensuring folders are displayed at the top.</li>
<li>Natural sort, based on the sorting rules of a particular language.</li>
</ul>
<h2>Automatic/Permanent Sorting</h2>
<p>Child notes can be automatically sorted by attaching specific <a href="../../Advanced%20Usage/Attributes.html">labels</a> to
the parent note:</p>

View File

@ -14,7 +14,7 @@
<div class="ck-content">
<figure class="image image-style-align-right">
<img style="aspect-ratio:372/760;" src="Note tree contextual menu_.png"
<img style="aspect-ratio:372/760;" src="1_Note tree contextual menu_.png"
width="372" height="760">
</figure>
<p>The <em>note tree menu</em> can be accessed by right-clicking in the&nbsp;
@ -161,9 +161,81 @@
</li>
</ul>
<h2>Advanced options</h2>
<p>To access this options, first look for the <em>Advanced</em> option in the
contextual menu to reveal a sub-menu with:</p>
<p>&nbsp;</p>
<figure class="image image-style-align-right">
<img style="aspect-ratio:289/355;" src="Note tree contextual menu_.png"
width="289" height="355">
</figure>
<p>The advanced options menu offers some of the less frequently used actions
for notes.</p>
<p>To access these options, first look for the <em>Advanced</em> option in
the contextual menu to reveal a sub-menu with:</p>
<ul>
<li><strong>Apply bulk actions</strong>
<ul>
<li>Opens the&nbsp;<a class="reference-link" href="../../../Advanced%20Usage/Bulk%20Actions.html">Bulk Actions</a>&nbsp;dialog,
to apply actions such as adding labels or moving notes to multiple notes
at once (see&nbsp;<a class="reference-link" href="Multiple%20selection.html">Multiple selection</a>).</li>
</ul>
</li>
<li><strong>Edit branch prefix</strong>
<ul>
<li>Opens a dialog to assign a name to be able to distinguish <a href="../../Notes/Cloning%20Notes.html">clones</a>,
see&nbsp;<a class="reference-link" href="../../Notes/Cloning%20Notes/Branch%20prefix.html">Branch prefix</a>&nbsp;for
more information.</li>
</ul>
</li>
<li><strong>Convert to attachment</strong>
<ul>
<li>Converts the selected notes to&nbsp;<a class="reference-link" href="../../Notes/Attachments.html">Attachments</a>&nbsp;of
their parent notes.</li>
<li>This functional is most useful when dealing with image&nbsp;<a class="reference-link"
href="../../../Note%20Types/File.html">File</a>&nbsp;notes that were imported
from an external source or an older version of Trilium.</li>
</ul>
</li>
<li><strong>Duplicate subtree</strong>
<ul>
<li>Creates a copy of the note and its descendants.</li>
<li>This process is different from&nbsp;<a class="reference-link" href="../../Notes/Cloning%20Notes.html">Cloning Notes</a>&nbsp;since
the duplicated note can be edited independently from the original.</li>
<li>An alternative to this, if done regularly, would be&nbsp;<a class="reference-link"
href="../../../Advanced%20Usage/Templates.html">Templates</a>.</li>
</ul>
</li>
<li><strong>Expand subtree</strong>
<ul>
<li>Expands all the child notes in the&nbsp;<a class="reference-link" href="../Note%20Tree.html">Note Tree</a>.</li>
</ul>
</li>
<li><strong>Collapse subtree</strong>
<ul>
<li>Collapses all the child notes in the note tree.</li>
</ul>
</li>
<li><strong>Sort by…</strong>
<ul>
<li>Opens a dialog to sort all the child notes of the selected note.</li>
<li>The sorting is done only once, there is an automatic sorting mechanism
as well that can be set using&nbsp;<a class="reference-link" href="../../../Advanced%20Usage/Attributes.html">Attributes</a>.</li>
<li>See&nbsp;<a class="reference-link" href="../../Notes/Sorting%20Notes.html">Sorting Notes</a>&nbsp;for
more information.</li>
</ul>
</li>
<li><strong>Copy note path to clipboard</strong>
<ul>
<li>Copies a URL fragment representing the full path to this branch for a
note, such as <code>#root/Hb2E70L7HPuf/4sRFgMZhYFts/2IVuShedRJ3U/LJVMvKXOFv7n</code>.</li>
<li>The URL to manually create&nbsp;<a class="reference-link" href="../../../Note%20Types/Text/Links.html">Links</a>&nbsp;within
notes, or for note&nbsp;<a class="reference-link" href="../../Navigation">Navigation</a>.</li>
</ul>
</li>
<li><strong>Recent changes in subtree</strong>
<ul>
<li>This will open&nbsp;<a class="reference-link" href="../Recent%20Changes.html">Recent Changes</a>,
but filtered to only the changes related to this note or one of its descendants.</li>
</ul>
</li>
</ul>
</div>
</div>
</body>

Binary file not shown.

Before

Width:  |  Height:  |  Size: 94 KiB

After

Width:  |  Height:  |  Size: 32 KiB

View File

@ -132,6 +132,11 @@
</li>
<li><a href="User%20Guide/Basic%20Concepts%20and%20Features/Notes/Cloning%20Notes.html"
target="detail">Cloning Notes</a>
<ul>
<li><a href="User%20Guide/Basic%20Concepts%20and%20Features/Notes/Cloning%20Notes/Branch%20prefix.html"
target="detail">Branch prefix</a>
</li>
</ul>
</li>
<li><a href="User%20Guide/Basic%20Concepts%20and%20Features/Notes/Protected%20Notes.html"
target="detail">Protected Notes</a>