gaschz/trilium
1
0
Fork 0
mirror of https://github.com/zadam/trilium.git synced 2025-11-17 05:54:31 +01:00
Code Issues Actions 13 Packages Projects Releases Wiki Activity

docs(user): working with the note tree in board

Browse Source
This commit is contained in:
Elian Doran 2025-11-15 13:41:48 +02:00
parent d2184682e5
commit 88c1aa163e
No known key found for this signature in database
5 changed files with 379 additions and 320 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

643
apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Geo Map.html generated vendored
View File

@ -12,121 +12,127 @@
on an attribute. It is also possible to add new notes at a specific location on an attribute. It is also possible to add new notes at a specific location
using the built-in interface.</p> using the built-in interface.</p>
<h2>Creating a new geo map</h2> <h2>Creating a new geo map</h2>
<table> <figure class="table">
<thead> <table>
<tr> <thead>
<th></th> <tr>
<th></th> <th>&nbsp;</th>
<th></th> <th>&nbsp;</th>
</tr> <th>&nbsp;</th>
</thead> </tr>
<tbody> </thead>
<tr> <tbody>
<td>1</td> <tr>
<td> <td>1</td>
<figure class="image"> <td>
<img style="aspect-ratio:483/413;" src="15_Geo Map_image.png" <figure class="image">
width="483" height="413"> <img style="aspect-ratio:483/413;" src="15_Geo Map_image.png"
</figure> width="483" height="413">
</td> </figure>
<td>Right click on any note on the note tree and select <em>Insert child note</em> → <em>Geo Map (beta)</em>.</td> </td>
</tr> <td>Right click on any note on the note tree and select <em>Insert child note</em> → <em>Geo Map (beta)</em>.</td>
<tr> </tr>
<td>2</td> <tr>
<td> <td>2</td>
<figure class="image image-style-align-center image_resized" style="width:53.44%;"> <td>
<img style="aspect-ratio:1720/1396;" src="8_Geo Map_image.png" <figure class="image image-style-align-center image_resized" style="width:53.44%;">
width="1720" height="1396"> <img style="aspect-ratio:1720/1396;" src="8_Geo Map_image.png"
</figure> width="1720" height="1396">
</td> </figure>
<td>By default the map will be empty and will show the entire world.</td> </td>
</tr> <td>By default the map will be empty and will show the entire world.</td>
</tbody> </tr>
</table> </tbody>
</table>
</figure>
<h2>Repositioning the map</h2> <h2>Repositioning the map</h2>
<ul> <ul>
<li>Click and drag the map in order to move across the map.</li> <li data-list-item-id="ec3df228f80922b4531e2dd1a977d81b8">Click and drag the map in order to move across the map.</li>
<li>Use the mouse wheel, two-finger gesture on a touchpad or the +/- buttons <li data-list-item-id="ee505c643c5bacffffc42119cc2f19c60">Use the mouse wheel, two-finger gesture on a touchpad or the +/- buttons
on the top-left to adjust the zoom.</li> on the top-left to adjust the zoom.</li>
</ul> </ul>
<p>The position on the map and the zoom are saved inside the map note and <p>The position on the map and the zoom are saved inside the map note and
restored when visiting again the note.</p> restored when visiting again the note.</p>
<h2>Adding a marker using the map</h2> <h2>Adding a marker using the map</h2>
<h3>Adding a new note using the plus button</h3> <h3>Adding a new note using the plus button</h3>
<table> <figure class="table">
<thead> <table>
<tr> <thead>
<th></th> <tr>
<th></th> <th>&nbsp;</th>
<th></th> <th>&nbsp;</th>
</tr> <th>&nbsp;</th>
</thead> </tr>
<tbody> </thead>
<tr> <tbody>
<td>1</td> <tr>
<td>To create a marker, first navigate to the desired point on the map. Then <td>1</td>
press the <td>To create a marker, first navigate to the desired point on the map. Then
<img src="10_Geo Map_image.png">button in the&nbsp;<a href="#root/_help_XpOYSgsLkTJy">Floating buttons</a>&nbsp;(top-right) press the
area.&nbsp;&nbsp;&nbsp; <img src="10_Geo Map_image.png">button in the&nbsp;<a href="#root/_help_XpOYSgsLkTJy">Floating buttons</a>&nbsp;(top-right)
<br> area.&nbsp;&nbsp;&nbsp;&nbsp;
<br>If the button is not visible, make sure the button section is visible <br>
by pressing the chevron button ( <br>If the button is not visible, make sure the button section is visible
<img src="17_Geo Map_image.png">) in the top-right of the map.</td> by pressing the chevron button (
<td></td> <img src="17_Geo Map_image.png">) in the top-right of the map.</td>
</tr> <td>&nbsp;</td>
<tr> </tr>
<td>2</td> <tr>
<td> <td>2</td>
<img class="image_resized" style="aspect-ratio:1730/416;width:100%;" src="2_Geo Map_image.png" <td>
width="1730" height="416"> <img class="image_resized" style="aspect-ratio:1730/416;width:100%;" src="2_Geo Map_image.png"
</td> width="1730" height="416">
<td>Once pressed, the map will enter in the insert mode, as illustrated by </td>
the notification.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <td>Once pressed, the map will enter in the insert mode, as illustrated by
<br> the notification.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<br>Simply click the point on the map where to place the marker, or the Escape <br>
key to cancel.</td> <br>Simply click the point on the map where to place the marker, or the Escape
</tr> key to cancel.</td>
<tr> </tr>
<td>3</td> <tr>
<td> <td>3</td>
<img class="image_resized" style="aspect-ratio:1586/404;width:100%;" src="7_Geo Map_image.png" <td>
width="1586" height="404"> <img class="image_resized" style="aspect-ratio:1586/404;width:100%;" src="7_Geo Map_image.png"
</td> width="1586" height="404">
<td>Enter the name of the marker/note to be created.</td> </td>
</tr> <td>Enter the name of the marker/note to be created.</td>
<tr> </tr>
<td>4</td> <tr>
<td> <td>4</td>
<img class="image_resized" style="aspect-ratio:1696/608;width:100%;" src="16_Geo Map_image.png" <td>
width="1696" height="608"> <img class="image_resized" style="aspect-ratio:1696/608;width:100%;" src="16_Geo Map_image.png"
</td> width="1696" height="608">
<td>Once confirmed, the marker will show up on the map and it will also be </td>
displayed as a child note of the map.</td> <td>Once confirmed, the marker will show up on the map and it will also be
</tr> displayed as a child note of the map.</td>
</tbody> </tr>
</table> </tbody>
</table>
</figure>
<h3>Adding a new note using the contextual menu</h3> <h3>Adding a new note using the contextual menu</h3>
<ol> <ol>
<li>Right click anywhere on the map, where to place the newly created marker <li data-list-item-id="ea014287557d9fbca07dd30b32405f92a">Right click anywhere on the map, where to place the newly created marker
(and corresponding note).</li> (and corresponding note).</li>
<li>Select <em>Add a marker at this location</em>.</li> <li data-list-item-id="ef758bd1a52c2ced75e402fd68e3d1e67">Select <em>Add a marker at this location</em>.</li>
<li>Enter the name of the newly created note.</li> <li data-list-item-id="e6f1d66e9d872ac4908a7c11b401a9d80">Enter the name of the ne<a class="reference-link" href="#root/pOsGYCXsbNQG/gh7bpGYxajRS/Vc8PjrjAGuOp/_help_oPVyFC7WL2Lp">Note Tree</a>wly
<li>The map should be updated with the new marker.</li> created note.</li>
<li data-list-item-id="eed9a3fbe500d61c76729f6147ceed925">The map should be updated with the new marker.</li>
</ol> </ol>
<h3>Adding an existing note on note from the note tree</h3> <h3>Adding an existing note on note from the note tree</h3>
<ol> <ol>
<li>Select the desired note in the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>.</li> <li data-list-item-id="ecba60e77600a1660e947ce54c633df04">Select the desired note in the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>.</li>
<li>Hold the mouse on the note and drag it to the map to the desired location.</li> <li
<li>The map should be updated with the new marker.</li> data-list-item-id="e00bb8f41cf79fef2b5ce215bc678f808">Hold the mouse on the note and drag it to the map to the desired location.</li>
<li
data-list-item-id="e3fc69dc9e44db125872274e68223cd4e">The map should be updated with the new marker.</li>
</ol> </ol>
<p>This works for:</p> <p>This works for:</p>
<ul> <ul>
<li>Notes that are not part of the geo map, case in which a <a href="#root/_help_IakOLONlIfGI">clone</a> will <li data-list-item-id="e0821dbcf20fa4a83a9cfada4bea95521">Notes that are not part of the geo map, case in which a <a href="#root/_help_IakOLONlIfGI">clone</a> will
be created.</li> be created.</li>
<li>Notes that are a child of the geo map but not yet positioned on the map.</li> <li data-list-item-id="e859aa76bcb592afd7414cccb60cdd3ed">Notes that are a child of the geo map but not yet positioned on the map.</li>
<li>Notes that are a child of the geo map and also positioned, case in which <li
data-list-item-id="e74fb2b74919aba44e1a457a5f8aec6b8">Notes that are a child of the geo map and also positioned, case in which
the marker will be relocated to the new position.</li> the marker will be relocated to the new position.</li>
</ul> </ul>
<aside class="admonition note"> <aside class="admonition note">
@ -136,8 +142,10 @@
<h2>How the location of the markers is stored</h2> <h2>How the location of the markers is stored</h2>
<p>The location of a marker is stored in the <code>#geolocation</code> attribute <p>The location of a marker is stored in the <code>#geolocation</code> attribute
of the child notes:</p> of the child notes:</p>
<img src="18_Geo Map_image.png" <p>
width="1288" height="278"> <img src="18_Geo Map_image.png" width="1288"
height="278">
</p>
<p>This value can be added manually if needed. The value of the attribute <p>This value can be added manually if needed. The value of the attribute
is made up of the latitude and longitude separated by a comma.</p> is made up of the latitude and longitude separated by a comma.</p>
<h2>Repositioning markers</h2> <h2>Repositioning markers</h2>
@ -149,16 +157,17 @@ width="1288" height="278">
page (<kbd>Ctrl</kbd>+<kbd>R</kbd> ) to cancel it.</p> page (<kbd>Ctrl</kbd>+<kbd>R</kbd> ) to cancel it.</p>
<h2>Interaction with the markers</h2> <h2>Interaction with the markers</h2>
<ul> <ul>
<li>Hovering over a marker will display a&nbsp;<a class="reference-link" href="#root/_help_lgKX7r3aL30x">Note Tooltip</a>&nbsp;with <li data-list-item-id="e953e0022167e10d476bbf438b71029ee">Hovering over a marker will display a&nbsp;<a class="reference-link" href="#root/_help_lgKX7r3aL30x">Note Tooltip</a>&nbsp;with
the content of the note it belongs to. the content of the note it belongs to.
<ul> <ul>
<li>Clicking on the note title in the tooltip will navigate to the note in <li data-list-item-id="e24f6ec1307f470fc8a9c0681282dd424">Clicking on the note title in the tooltip will navigate to the note in
the current view.</li> the current view.</li>
</ul> </ul>
</li> </li>
<li>Middle-clicking the marker will open the note in a new tab.</li> <li data-list-item-id="ea6f9b375776db475c00f3d308f170cb1">Middle-clicking the marker will open the note in a new tab.</li>
<li>Right-clicking the marker will open a contextual menu (as described below).</li> <li data-list-item-id="e26942774d668ca9d49e1cfc797801516">Right-clicking the marker will open a contextual menu (as described below).</li>
<li>If the map is in read-only mode, clicking on a marker will open a&nbsp; <li
data-list-item-id="edcf8a4a4e252ae3757303fc28c6e549e">If the map is in read-only mode, clicking on a marker will open a&nbsp;
<a <a
class="reference-link" href="#root/_help_ZjLYv08Rp3qC">Quick edit</a>&nbsp;popup for the corresponding note.</li> class="reference-link" href="#root/_help_ZjLYv08Rp3qC">Quick edit</a>&nbsp;popup for the corresponding note.</li>
</ul> </ul>
@ -166,24 +175,24 @@ width="1288" height="278">
<p>It's possible to press the right mouse button to display a contextual <p>It's possible to press the right mouse button to display a contextual
menu.</p> menu.</p>
<ol> <ol>
<li>If right-clicking an empty section of the map (not on a marker), it allows <li data-list-item-id="e529cc53e555215e949135d9998ac4d06">If right-clicking an empty section of the map (not on a marker), it allows
to: to:
<ol> <ol>
<li>Displays the latitude and longitude. Clicking this option will copy them <li data-list-item-id="e18b27ec2d655ca2e29328c6cc899cccf">Displays the latitude and longitude. Clicking this option will copy them
to the clipboard.</li> to the clipboard.</li>
<li>Open the location using an external application (if the operating system <li data-list-item-id="ebecfc3495ce94589ebdaa3479e70a8ea">Open the location using an external application (if the operating system
supports it).</li> supports it).</li>
<li>Adding a new marker at that location.</li> <li data-list-item-id="e1e1e816904064ed2457553dbcf58f373">Adding a new marker at that location.</li>
</ol> </ol>
</li> </li>
<li>If right-clicking on a marker, it allows to: <li data-list-item-id="eadf4de9e1e967bfcbf7274b8e7613c8e">If right-clicking on a marker, it allows to:
<ol> <ol>
<li>Displays the latitude and longitude. Clicking this option will copy them <li data-list-item-id="ebd32992e411b3a755008b1036448f7e9">Displays the latitude and longitude. Clicking this option will copy them
to the clipboard.</li> to the clipboard.</li>
<li>Open the location using an external application (if the operating system <li data-list-item-id="e5e8bf64b872e1bf32a53459b05d05263">Open the location using an external application (if the operating system
supports it).</li> supports it).</li>
<li>Open the note in a new tab, split or window.</li> <li data-list-item-id="ec83b4469031db305a1d3f9a4d36b395d">Open the note in a new tab, split or window.</li>
<li>Remove the marker from the map, which will remove the <code>#geolocation</code> attribute <li data-list-item-id="e49f6d549515bec0d6bd8bccf3d34d269">Remove the marker from the map, which will remove the <code>#geolocation</code> attribute
of the note. To add it back again, the coordinates have to be manually of the note. To add it back again, the coordinates have to be manually
added back in.</li> added back in.</li>
</ol> </ol>
@ -203,209 +212,215 @@ width="1288" height="278">
<p>The value of the attribute is made up of the latitude and longitude separated <p>The value of the attribute is made up of the latitude and longitude separated
by a comma.</p> by a comma.</p>
<h3>Adding from Google Maps</h3> <h3>Adding from Google Maps</h3>
<table> <figure class="table">
<thead> <table>
<tr> <thead>
<th></th> <tr>
<th></th> <th>&nbsp;</th>
<th></th> <th>&nbsp;</th>
</tr> <th>&nbsp;</th>
</thead> </tr>
<tbody> </thead>
<tr> <tbody>
<td>1</td> <tr>
<td> <td>1</td>
<figure class="image image-style-align-center image_resized" style="width:56.84%;"> <td>
<img style="aspect-ratio:732/918;" src="12_Geo Map_image.png" <figure class="image image-style-align-center image_resized" style="width:56.84%;">
width="732" height="918"> <img style="aspect-ratio:732/918;" src="12_Geo Map_image.png"
</figure> width="732" height="918">
</td> </figure>
<td>Go to Google Maps on the web and look for a desired location, right click </td>
on it and a context menu will show up.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <td>Go to Google Maps on the web and look for a desired location, right click
<br> on it and a context menu will show up.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<br>Simply click on the first item displaying the coordinates and they will <br>
be copied to clipboard.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <br>Simply click on the first item displaying the coordinates and they will
<br> be copied to clipboard.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<br>Then paste the value inside the text box into the <code>#geolocation</code> attribute <br>
of a child note of the map (don't forget to surround the value with a <code>"</code> character).</td> <br>Then paste the value inside the text box into the <code>#geolocation</code> attribute
</tr> of a child note of the map (don't forget to surround the value with a <code>"</code> character).</td>
<tr> </tr>
<td>2</td> <tr>
<td> <td>2</td>
<figure class="image image-style-align-center image_resized" style="width:100%;"> <td>
<img style="aspect-ratio:518/84;" src="4_Geo Map_image.png" <figure class="image image-style-align-center image_resized" style="width:100%;">
width="518" height="84"> <img style="aspect-ratio:518/84;" src="4_Geo Map_image.png"
</figure> width="518" height="84">
</td> </figure>
<td>In Trilium, create a child note under the map.</td> </td>
</tr> <td>In Trilium, create a child note under the map.</td>
<tr> </tr>
<td>3</td> <tr>
<td> <td>3</td>
<figure class="image image-style-align-center image_resized" style="width:100%;"> <td>
<img style="aspect-ratio:1074/276;" src="11_Geo Map_image.png" <figure class="image image-style-align-center image_resized" style="width:100%;">
width="1074" height="276"> <img style="aspect-ratio:1074/276;" src="11_Geo Map_image.png"
</figure> width="1074" height="276">
</td> </figure>
<td>And then go to Owned Attributes and type <code>#geolocation="</code>, then </td>
paste from the clipboard as-is and then add the ending <code>"</code> character. <td>And then go to Owned Attributes and type <code>#geolocation="</code>, then
Press Enter to confirm and the map should now be updated to contain the paste from the clipboard as-is and then add the ending <code>"</code> character.
new note.</td> Press Enter to confirm and the map should now be updated to contain the
</tr> new note.</td>
</tbody> </tr>
</table> </tbody>
</table>
</figure>
<h3>Adding from OpenStreetMap</h3> <h3>Adding from OpenStreetMap</h3>
<p>Similarly to the Google Maps approach:</p> <p>Similarly to the Google Maps approach:</p>
<table> <figure class="table">
<thead> <table>
<tr> <thead>
<th></th> <tr>
<th></th> <th>&nbsp;</th>
<th></th> <th>&nbsp;</th>
</tr> <th>&nbsp;</th>
</thead> </tr>
<tbody> </thead>
<tr> <tbody>
<td>1</td> <tr>
<td> <td>1</td>
<img class="image_resized" style="aspect-ratio:562/454;width:100%;" src="1_Geo Map_image.png" <td>
width="562" height="454"> <img class="image_resized" style="aspect-ratio:562/454;width:100%;" src="1_Geo Map_image.png"
</td> width="562" height="454">
<td>Go to any location on openstreetmap.org and right click to bring up the </td>
context menu. Select the “Show address” item.</td> <td>Go to any location on openstreetmap.org and right click to bring up the
</tr> context menu. Select the “Show address” item.</td>
<tr> </tr>
<td>2</td> <tr>
<td> <td>2</td>
<img class="image_resized" style="aspect-ratio:696/480;width:100%;" src="Geo Map_image.png" <td>
width="696" height="480"> <img class="image_resized" style="aspect-ratio:696/480;width:100%;" src="Geo Map_image.png"
</td> width="696" height="480">
<td>The address will be visible in the top-left of the screen, in the place </td>
of the search bar.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <td>The address will be visible in the top-left of the screen, in the place
<br> of the search bar.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<br>Select the coordinates and copy them into the clipboard.</td> <br>
</tr> <br>Select the coordinates and copy them into the clipboard.</td>
<tr> </tr>
<td>3</td> <tr>
<td> <td>3</td>
<img class="image_resized" style="aspect-ratio:640/276;width:100%;" src="5_Geo Map_image.png" <td>
width="640" height="276"> <img class="image_resized" style="aspect-ratio:640/276;width:100%;" src="5_Geo Map_image.png"
</td> width="640" height="276">
<td>Simply paste the value inside the text box into the <code>#geolocation</code> attribute </td>
of a child note of the map and then it should be displayed on the map.</td> <td>Simply paste the value inside the text box into the <code>#geolocation</code> attribute
</tr> of a child note of the map and then it should be displayed on the map.</td>
</tbody> </tr>
</table> </tbody>
</table>
</figure>
<h2>Adding GPS tracks (.gpx)</h2> <h2>Adding GPS tracks (.gpx)</h2>
<p>Trilium has basic support for displaying GPS tracks on the geo map.</p> <p>Trilium has basic support for displaying GPS tracks on the geo map.</p>
<table> <figure
<thead> class="table">
<tr> <table>
<th></th> <thead>
<th></th> <tr>
<th></th> <th>&nbsp;</th>
</tr> <th>&nbsp;</th>
</thead> <th>&nbsp;</th>
<tbody> </tr>
<tr> </thead>
<td>1</td> <tbody>
<td> <tr>
<figure class="image image-style-align-center"> <td>1</td>
<img style="aspect-ratio:226/74;" src="3_Geo Map_image.png" <td>
width="226" height="74"> <figure class="image image-style-align-center">
</figure> <img style="aspect-ratio:226/74;" src="3_Geo Map_image.png"
</td> width="226" height="74">
<td>To add a track, simply drag &amp; drop a .gpx file inside the geo map </figure>
in the note tree.</td> </td>
</tr> <td>To add a track, simply drag &amp; drop a .gpx file inside the geo map
<tr> in the note tree.</td>
<td>2</td> </tr>
<td> <tr>
<figure class="image image-style-align-center"> <td>2</td>
<img style="aspect-ratio:322/222;" src="14_Geo Map_image.png" <td>
width="322" height="222"> <figure class="image image-style-align-center">
</figure> <img style="aspect-ratio:322/222;" src="14_Geo Map_image.png"
</td> width="322" height="222">
<td>In order for the file to be recognized as a GPS track, it needs to show </figure>
up as <code>application/gpx+xml</code> in the <em>File type</em> field.</td> </td>
</tr> <td>In order for the file to be recognized as a GPS track, it needs to show
<tr> up as <code>application/gpx+xml</code> in the <em>File type</em> field.</td>
<td>3</td> </tr>
<td> <tr>
<figure class="image image-style-align-center"> <td>3</td>
<img style="aspect-ratio:620/530;" src="6_Geo Map_image.png" <td>
width="620" height="530"> <figure class="image image-style-align-center">
</figure> <img style="aspect-ratio:620/530;" src="6_Geo Map_image.png"
</td> width="620" height="530">
<td>When going back to the map, the track should now be visible.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </figure>
<br> </td>
<br>The start and end points of the track are indicated by the two blue markers.</td> <td>When going back to the map, the track should now be visible.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</tr> <br>
</tbody> <br>The start and end points of the track are indicated by the two blue markers.</td>
</table> </tr>
<aside class="admonition note"> </tbody>
<p>The starting point of the track will be displayed as a marker, with the </table>
name of the note underneath. The start marker will also respect the icon </figure>
and the <code>color</code> of the note. The end marker is displayed with <aside class="admonition note">
a distinct icon.</p> <p>The starting point of the track will be displayed as a marker, with the
<p>If the GPX contains waypoints, they will also be displayed. If they have name of the note underneath. The start marker will also respect the icon
a name, it is displayed when hovering over it with the mouse.</p> and the <code>color</code> of the note. The end marker is displayed with
</aside> a distinct icon.</p>
<h2>Read-only mode</h2> <p>If the GPX contains waypoints, they will also be displayed. If they have
<p>When a map is in read-only all editing features will be disabled such a name, it is displayed when hovering over it with the mouse.</p>
as:</p> </aside>
<ul> <h2>Read-only mode</h2>
<li>The add button in the&nbsp;<a class="reference-link" href="#root/_help_XpOYSgsLkTJy">Floating buttons</a>.</li> <p>When a map is in read-only all editing features will be disabled such
<li>Dragging markers.</li> as:</p>
<li>Editing from the contextual menu (removing locations or adding new items).</li> <ul>
</ul> <li data-list-item-id="e78bca8f945a953c13efaf287001d0edb">The add button in the&nbsp;<a class="reference-link" href="#root/_help_XpOYSgsLkTJy">Floating buttons</a>.</li>
<p>To enable read-only mode simply press the <em>Lock</em> icon from the&nbsp; <li
<a data-list-item-id="e022d4fc44c13cf5f529ea18729df3897">Dragging markers.</li>
class="reference-link" href="#root/_help_XpOYSgsLkTJy">Floating buttons</a>. To disable it, press the button again.</p> <li data-list-item-id="e0d024b930867c0253e98c322d3bea021">Editing from the contextual menu (removing locations or adding new items).</li>
<h2>Configuration</h2> </ul>
<h3>Map Style</h3> <p>To enable read-only mode simply press the <em>Lock</em> icon from the&nbsp;
<p>The styling of the map can be adjusted in the <em>Collection Properties</em> tab <a
in the&nbsp;<a class="reference-link" href="#root/_help_BlN9DFI679QC">Ribbon</a>&nbsp;or class="reference-link" href="#root/_help_XpOYSgsLkTJy">Floating buttons</a>. To disable it, press the button again.</p>
manually via the <code>#map:style</code> attribute.</p> <h2>Configuration</h2>
<p>The geo map comes with two different types of styles:</p> <h3>Map Style</h3>
<ul> <p>The styling of the map can be adjusted in the <em>Collection Properties</em> tab
<li>Raster styles in the&nbsp;<a class="reference-link" href="#root/_help_BlN9DFI679QC">Ribbon</a>&nbsp;or
<ul> manually via the <code>#map:style</code> attribute.</p>
<li>For these styles the map is represented as a grid of images at different <p>The geo map comes with two different types of styles:</p>
zoom levels. This is the traditional way OpenStreetMap used to work.</li> <ul>
<li>Zoom is slightly restricted.</li> <li data-list-item-id="ee111daf471290ce8f16adb8ff6255e78">Raster styles
<li>Currently, the only raster theme is the original OpenStreetMap style.</li> <ul>
<li data-list-item-id="ebecb845ceda41068a106693c5a1244e3">For these styles the map is represented as a grid of images at different
zoom levels. This is the traditional way OpenStreetMap used to work.</li>
<li
data-list-item-id="e60a827a1f29105ea8321184d4fb4f0a2">Zoom is slightly restricted.</li>
<li data-list-item-id="e2eb8282db9496f32beeddd53a72fea2a">Currently, the only raster theme is the original OpenStreetMap style.</li>
</ul> </ul>
</li> </li>
<li>Vector styles <li data-list-item-id="e01494841aec47f71245855fe95ad4adb">Vector styles
<ul> <ul>
<li>Vector styles are not represented as images, but as geometrical shapes. <li data-list-item-id="e87e7f879a4c7475769e73f1cfa1bc1b8">Vector styles are not represented as images, but as geometrical shapes.
This makes the rendering much smoother, especially when zooming and looking This makes the rendering much smoother, especially when zooming and looking
at the building edges, for example.</li> at the building edges, for example.</li>
<li>The map can be zoomed in much further.</li> <li data-list-item-id="ef95260bc6fcb49e63ff708077929b263">The map can be zoomed in much further.</li>
<li>These come both in a light and a dark version.</li> <li data-list-item-id="e339157e4fdacc1b59f6c44cf29711032">These come both in a light and a dark version.</li>
<li>The vector styles come from <a href="https://versatiles.org/">VersaTiles</a>, <li data-list-item-id="e9be34d3c44b5dc1ecaa8c856642fc610">The vector styles come from <a href="https://versatiles.org/">VersaTiles</a>,
a free and open-source project providing map tiles based on OpenStreetMap.</li> a free and open-source project providing map tiles based on OpenStreetMap.</li>
</ul> </ul>
</li> </li>
</ul> </ul>
<aside class="admonition note"> <aside class="admonition note">
<p>Currently it is not possible to use a custom map style.</p> <p>Currently it is not possible to use a custom map style.</p>
</aside> </aside>
<h3>Scale</h3> <h3>Scale</h3>
<p>Activating this option via the&nbsp;<a class="reference-link" href="#root/_help_BlN9DFI679QC">Ribbon</a>&nbsp;or <p>Activating this option via the&nbsp;<a class="reference-link" href="#root/_help_BlN9DFI679QC">Ribbon</a>&nbsp;or
manually via <code>#map:scale</code> will display an indicator in the bottom-left manually via <code>#map:scale</code> will display an indicator in the bottom-left
of the scale of the map.</p> of the scale of the map.</p>
<h2>Troubleshooting</h2> <h2>Troubleshooting</h2>
<figure class="image image-style-align-right image_resized" style="width:34.06%;"> <figure class="image image-style-align-right image_resized" style="width:34.06%;">
<img style="aspect-ratio:678/499;" src="13_Geo Map_image.png" <img style="aspect-ratio:678/499;" src="13_Geo Map_image.png"
width="678" height="499"> width="678" height="499">
</figure> </figure>
<h3>Grid-like artifacts on the map</h3>
<h3>Grid-like artifacts on the map</h3> <p>This occurs if the application is not at 100% zoom which causes the pixels
<p>This occurs if the application is not at 100% zoom which causes the pixels of the map to not render correctly due to fractional scaling. The only
of the map to not render correctly due to fractional scaling. The only possible solution is to set the UI zoom at 100% (default keyboard shortcut
possible solution is to set the UI zoom at 100% (default keyboard shortcut is <kbd>Ctrl</kbd>+<kbd>0</kbd>).</p>
is <kbd>Ctrl</kbd>+<kbd>0</kbd>).</p>

17
apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Kanban Board.html generated vendored
View File

@ -71,6 +71,23 @@
<li data-list-item-id="e1d6b1303eb3567b51fec1174993dcb71">If there are many notes within the column, move the mouse over the column <li data-list-item-id="e1d6b1303eb3567b51fec1174993dcb71">If there are many notes within the column, move the mouse over the column
and use the mouse wheel to scroll.</li> and use the mouse wheel to scroll.</li>
</ul> </ul>
<h3>Working with the note tree</h3>
<p>It's also possible to add items on the board using the&nbsp;<a class="reference-link"
href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>.</p>
<ol>
<li data-list-item-id="ef31c436ab587f75725f224880891c063">Select the desired note in the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>.</li>
<li
data-list-item-id="e4e3b01f6a772fe9f5ea2bbb91f2b1f6d">Hold the mouse on the note and drag it to the to the desired column.</li>
</ol>
<p>This works for:</p>
<ul>
<li data-list-item-id="e4b395d82d6e6220afbacdca93b80bea3">Notes that are not children of the board, case in which a <a href="#root/_help_IakOLONlIfGI">clone</a> will
be created.</li>
<li data-list-item-id="ef1eeff2b993c6285ed33440520254f7f">Notes that are children of the board, but not yet assigned on the board.</li>
<li
data-list-item-id="ee4610f6d74645e030570bfa9420dad61">Notes that are children of the board, case in which they will be moved
to the new column.</li>
</ul>
<h3>Keyboard interaction</h3> <h3>Keyboard interaction</h3>
<p>The board view has mild support for keyboard-based navigation:</p> <p>The board view has mild support for keyboard-based navigation:</p>
<ul> <ul>

14
docs/User Guide/!!!meta.json vendored
View File

@ -9905,6 +9905,20 @@
"value": "bdUJEHsAPYQR", "value": "bdUJEHsAPYQR",
"isInheritable": false, "isInheritable": false,
"position": 50 "position": 50
},
{
"type": "relation",
"name": "internalLink",
"value": "oPVyFC7WL2Lp",
"isInheritable": false,
"position": 60
},
{
"type": "relation",
"name": "internalLink",
"value": "IakOLONlIfGI",
"isInheritable": false,
"position": 70
} }
], ],
"format": "markdown", "format": "markdown",

12
docs/User Guide/User Guide/Collections/Geo Map.md vendored
View File

@ -26,8 +26,8 @@ The position on the map and the zoom are saved inside the map note and restored
| | | | | | | |
| --- | --- | --- | | --- | --- | --- |
| 1 | To create a marker, first navigate to the desired point on the map. Then press the ![](10_Geo%20Map_image.png) button in the [Floating buttons](../Basic%20Concepts%20and%20Features/UI%20Elements/Floating%20buttons.md) (top-right) area.    <br> <br>If the button is not visible, make sure the button section is visible by pressing the chevron button (![](17_Geo%20Map_image.png)) in the top-right of the map. | | | 1 | To create a marker, first navigate to the desired point on the map. Then press the ![](10_Geo%20Map_image.png) button in the [Floating buttons](../Basic%20Concepts%20and%20Features/UI%20Elements/Floating%20buttons.md) (top-right) area.     <br> <br>If the button is not visible, make sure the button section is visible by pressing the chevron button (![](17_Geo%20Map_image.png)) in the top-right of the map. | |
| 2 | <img class="image_resized" style="aspect-ratio:1730/416;width:100%;" src="2_Geo Map_image.png" width="1730" height="416"> | Once pressed, the map will enter in the insert mode, as illustrated by the notification.       <br> <br>Simply click the point on the map where to place the marker, or the Escape key to cancel. | | 2 | <img class="image_resized" style="aspect-ratio:1730/416;width:100%;" src="2_Geo Map_image.png" width="1730" height="416"> | Once pressed, the map will enter in the insert mode, as illustrated by the notification.        <br> <br>Simply click the point on the map where to place the marker, or the Escape key to cancel. |
| 3 | <img class="image_resized" style="aspect-ratio:1586/404;width:100%;" src="7_Geo Map_image.png" width="1586" height="404"> | Enter the name of the marker/note to be created. | | 3 | <img class="image_resized" style="aspect-ratio:1586/404;width:100%;" src="7_Geo Map_image.png" width="1586" height="404"> | Enter the name of the marker/note to be created. |
| 4 | <img class="image_resized" style="aspect-ratio:1696/608;width:100%;" src="16_Geo Map_image.png" width="1696" height="608"> | Once confirmed, the marker will show up on the map and it will also be displayed as a child note of the map. | | 4 | <img class="image_resized" style="aspect-ratio:1696/608;width:100%;" src="16_Geo Map_image.png" width="1696" height="608"> | Once confirmed, the marker will show up on the map and it will also be displayed as a child note of the map. |
@ -35,7 +35,7 @@ The position on the map and the zoom are saved inside the map note and restored
1. Right click anywhere on the map, where to place the newly created marker (and corresponding note). 1. Right click anywhere on the map, where to place the newly created marker (and corresponding note).
2. Select _Add a marker at this location_. 2. Select _Add a marker at this location_.
3. Enter the name of the newly created note. 3. Enter the name of the ne<a class="reference-link" href="../Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tree.md">Note Tree</a>wly created note.
4. The map should be updated with the new marker. 4. The map should be updated with the new marker.
### Adding an existing note on note from the note tree ### Adding an existing note on note from the note tree
@ -109,7 +109,7 @@ The value of the attribute is made up of the latitude and longitude separated by
| | | | | | | |
| --- | --- | --- | | --- | --- | --- |
| 1 | <figure class="image image-style-align-center image_resized" style="width:56.84%;"><img style="aspect-ratio:732/918;" src="12_Geo Map_image.png" width="732" height="918"></figure> | Go to Google Maps on the web and look for a desired location, right click on it and a context menu will show up.       <br> <br>Simply click on the first item displaying the coordinates and they will be copied to clipboard.       <br> <br>Then paste the value inside the text box into the `#geolocation` attribute of a child note of the map (don't forget to surround the value with a `"` character). | | 1 | <figure class="image image-style-align-center image_resized" style="width:56.84%;"><img style="aspect-ratio:732/918;" src="12_Geo Map_image.png" width="732" height="918"></figure> | Go to Google Maps on the web and look for a desired location, right click on it and a context menu will show up.        <br> <br>Simply click on the first item displaying the coordinates and they will be copied to clipboard.        <br> <br>Then paste the value inside the text box into the `#geolocation` attribute of a child note of the map (don't forget to surround the value with a `"` character). |
| 2 | <figure class="image image-style-align-center image_resized" style="width:100%;"><img style="aspect-ratio:518/84;" src="4_Geo Map_image.png" width="518" height="84"></figure> | In Trilium, create a child note under the map. | | 2 | <figure class="image image-style-align-center image_resized" style="width:100%;"><img style="aspect-ratio:518/84;" src="4_Geo Map_image.png" width="518" height="84"></figure> | In Trilium, create a child note under the map. |
| 3 | <figure class="image image-style-align-center image_resized" style="width:100%;"><img style="aspect-ratio:1074/276;" src="11_Geo Map_image.png" width="1074" height="276"></figure> | And then go to Owned Attributes and type `#geolocation="`, then paste from the clipboard as-is and then add the ending `"` character. Press Enter to confirm and the map should now be updated to contain the new note. | | 3 | <figure class="image image-style-align-center image_resized" style="width:100%;"><img style="aspect-ratio:1074/276;" src="11_Geo Map_image.png" width="1074" height="276"></figure> | And then go to Owned Attributes and type `#geolocation="`, then paste from the clipboard as-is and then add the ending `"` character. Press Enter to confirm and the map should now be updated to contain the new note. |
@ -120,7 +120,7 @@ Similarly to the Google Maps approach:
| | | | | | | |
| --- | --- | --- | | --- | --- | --- |
| 1 | <img class="image_resized" style="aspect-ratio:562/454;width:100%;" src="1_Geo Map_image.png" width="562" height="454"> | Go to any location on openstreetmap.org and right click to bring up the context menu. Select the “Show address” item. | | 1 | <img class="image_resized" style="aspect-ratio:562/454;width:100%;" src="1_Geo Map_image.png" width="562" height="454"> | Go to any location on openstreetmap.org and right click to bring up the context menu. Select the “Show address” item. |
| 2 | <img class="image_resized" style="aspect-ratio:696/480;width:100%;" src="Geo Map_image.png" width="696" height="480"> | The address will be visible in the top-left of the screen, in the place of the search bar.       <br> <br>Select the coordinates and copy them into the clipboard. | | 2 | <img class="image_resized" style="aspect-ratio:696/480;width:100%;" src="Geo Map_image.png" width="696" height="480"> | The address will be visible in the top-left of the screen, in the place of the search bar.        <br> <br>Select the coordinates and copy them into the clipboard. |
| 3 | <img class="image_resized" style="aspect-ratio:640/276;width:100%;" src="5_Geo Map_image.png" width="640" height="276"> | Simply paste the value inside the text box into the `#geolocation` attribute of a child note of the map and then it should be displayed on the map. | | 3 | <img class="image_resized" style="aspect-ratio:640/276;width:100%;" src="5_Geo Map_image.png" width="640" height="276"> | Simply paste the value inside the text box into the `#geolocation` attribute of a child note of the map and then it should be displayed on the map. |
## Adding GPS tracks (.gpx) ## Adding GPS tracks (.gpx)
@ -131,7 +131,7 @@ Trilium has basic support for displaying GPS tracks on the geo map.
| --- | --- | --- | | --- | --- | --- |
| 1 | <figure class="image image-style-align-center"><img style="aspect-ratio:226/74;" src="3_Geo Map_image.png" width="226" height="74"></figure> | To add a track, simply drag & drop a .gpx file inside the geo map in the note tree. | | 1 | <figure class="image image-style-align-center"><img style="aspect-ratio:226/74;" src="3_Geo Map_image.png" width="226" height="74"></figure> | To add a track, simply drag & drop a .gpx file inside the geo map in the note tree. |
| 2 | <figure class="image image-style-align-center"><img style="aspect-ratio:322/222;" src="14_Geo Map_image.png" width="322" height="222"></figure> | In order for the file to be recognized as a GPS track, it needs to show up as `application/gpx+xml` in the _File type_ field. | | 2 | <figure class="image image-style-align-center"><img style="aspect-ratio:322/222;" src="14_Geo Map_image.png" width="322" height="222"></figure> | In order for the file to be recognized as a GPS track, it needs to show up as `application/gpx+xml` in the _File type_ field. |
| 3 | <figure class="image image-style-align-center"><img style="aspect-ratio:620/530;" src="6_Geo Map_image.png" width="620" height="530"></figure> | When going back to the map, the track should now be visible.       <br> <br>The start and end points of the track are indicated by the two blue markers. | | 3 | <figure class="image image-style-align-center"><img style="aspect-ratio:620/530;" src="6_Geo Map_image.png" width="620" height="530"></figure> | When going back to the map, the track should now be visible.        <br> <br>The start and end points of the track are indicated by the two blue markers. |
> [!NOTE] > [!NOTE]
> The starting point of the track will be displayed as a marker, with the name of the note underneath. The start marker will also respect the icon and the `color` of the note. The end marker is displayed with a distinct icon. > The starting point of the track will be displayed as a marker, with the name of the note underneath. The start marker will also respect the icon and the `color` of the note. The end marker is displayed with a distinct icon.

13
docs/User Guide/User Guide/Collections/Kanban Board.md vendored
View File

@ -41,6 +41,19 @@ Notes are displayed recursively, so even the child notes of the child notes will
* Delete the current note. * Delete the current note.
* If there are many notes within the column, move the mouse over the column and use the mouse wheel to scroll. * If there are many notes within the column, move the mouse over the column and use the mouse wheel to scroll.
### Working with the note tree
It's also possible to add items on the board using the <a class="reference-link" href="../Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tree.md">Note Tree</a>.
1. Select the desired note in the <a class="reference-link" href="../Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tree.md">Note Tree</a>.
2. Hold the mouse on the note and drag it to the to the desired column.
This works for:
* Notes that are not children of the board, case in which a [clone](../Basic%20Concepts%20and%20Features/Notes/Cloning%20Notes.md) will be created.
* Notes that are children of the board, but not yet assigned on the board.
* Notes that are children of the board, case in which they will be moved to the new column.
### Keyboard interaction ### Keyboard interaction
The board view has mild support for keyboard-based navigation: The board view has mild support for keyboard-based navigation: