gaschz/trilium
1
0
Fork 0
mirror of https://github.com/zadam/trilium.git synced 2025-10-19 22:58:52 +02:00
Code Issues Actions 119 Packages Projects Releases Wiki Activity

docs(guide): board view

Browse Source
This commit is contained in:
Elian Doran 2025-07-25 17:55:13 +03:00
parent e851701a9e
commit 06672e439e
No known key found for this signature in database
19 changed files with 631 additions and 441 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
apps/client/src/widgets/floating_buttons/help_button.ts
View File

@ -36,7 +36,7 @@ export const byBookType: Record<ViewTypeOptions, string | null> = {
calendar: "xWbu3jpNWapp", calendar: "xWbu3jpNWapp",
table: "2FvYrpmOXm29", table: "2FvYrpmOXm29",
geoMap: "81SGnPGMk7Xc", geoMap: "81SGnPGMk7Xc",
board: null board: "CtBQqbwXDx1w"
}; };
export default class ContextualHelpButton extends NoteContextAwareWidget { export default class ContextualHelpButton extends NoteContextAwareWidget {

2
apps/server/src/assets/doc_notes/en/User Guide/!!!meta.json generated vendored
View File

File diff suppressed because one or more lines are too long

20
apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Collections.html generated vendored
View File

@ -4,27 +4,31 @@
child notes into one continuous view. This makes it ideal for reading extensive child notes into one continuous view. This makes it ideal for reading extensive
information broken into smaller, manageable segments.</p> information broken into smaller, manageable segments.</p>
<ul> <ul>
<li><a class="reference-link" href="#root/_help_8QqnMzx393bx">Grid View</a>&nbsp;which <li data-list-item-id="e7f3117635b8c3e905c71f2839e331942"><a class="reference-link" href="#root/_help_8QqnMzx393bx">Grid View</a>&nbsp;which
is the default presentation method for child notes (see&nbsp;<a class="reference-link" is the default presentation method for child notes (see&nbsp;<a class="reference-link"
href="#root/_help_0ESUbbAxVnoK">Note List</a>), where the notes are displayed href="#root/_help_0ESUbbAxVnoK">Note List</a>), where the notes are displayed
as tiles with their title and content being visible.</li> as tiles with their title and content being visible.</li>
<li><a class="reference-link" href="#root/_help_mULW0Q3VojwY">List View</a>&nbsp;is <li data-list-item-id="e27a2ec6976e44512c9c52ba8d7a2ef76"><a class="reference-link" href="#root/_help_mULW0Q3VojwY">List View</a>&nbsp;is
similar to&nbsp;<a class="reference-link" href="#root/_help_8QqnMzx393bx">Grid View</a>, similar to&nbsp;<a class="reference-link" href="#root/_help_8QqnMzx393bx">Grid View</a>,
but it displays the notes one under the other with the content being expandable/collapsible, but it displays the notes one under the other with the content being expandable/collapsible,
but also works recursively.</li> but also works recursively.</li>
</ul> </ul>
<p>More specialized collections were introduced, such as the:</p> <p>More specialized collections were introduced, such as the:</p>
<ul> <ul>
<li><a class="reference-link" href="#root/_help_xWbu3jpNWapp">Calendar View</a>&nbsp;which <li data-list-item-id="eae5c2f56f9a75e7ed813fe419d4a05a4"><a class="reference-link" href="#root/_help_xWbu3jpNWapp">Calendar View</a>&nbsp;which
displays a week, month or year calendar with the notes being shown as events. displays a week, month or year calendar with the notes being shown as events.
New events can be added easily by dragging across the calendar.</li> New events can be added easily by dragging across the calendar.</li>
<li><a class="reference-link" href="#root/_help_81SGnPGMk7Xc">Geo Map View</a>&nbsp;which <li
data-list-item-id="e24642a7a4c2443497fd814d78f1ca784"><a class="reference-link" href="#root/_help_81SGnPGMk7Xc">Geo Map View</a>&nbsp;which
displays a geographical map in which the notes are represented as markers/pins displays a geographical map in which the notes are represented as markers/pins
on the map. New events can be easily added by pointing on the map.</li> on the map. New events can be easily added by pointing on the map.</li>
<li><a class="reference-link" href="#root/_help_2FvYrpmOXm29">Table View</a>&nbsp;displays <li
each note as a row in a table, with&nbsp;<a class="reference-link" href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;being data-list-item-id="eaa80d024c07145aa8f4443d86b01295e"><a class="reference-link" href="#root/_help_2FvYrpmOXm29">Table View</a>&nbsp;displays
shown as well. This makes it easy to visualize attributes of notes, as each note as a row in a table, with&nbsp;<a class="reference-link" href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;being
well as making them easily editable.</li> shown as well. This makes it easy to visualize attributes of notes, as
well as making them easily editable.</li>
<li data-list-item-id="ec7243729048b57d173e3f7dfb232adca"><a class="reference-link" href="#root/pOsGYCXsbNQG/KSZ04uQ2D1St/GTwFsgaA0lCt/_help_CtBQqbwXDx1w">Board View</a>&nbsp;(Kanban)
displays notes in columns, grouped by the value of a label.</li>
</ul> </ul>
<p>For a quick presentation of all the supported view types, see the child <p>For a quick presentation of all the supported view types, see the child
notes of this help page, including screenshots.</p> notes of this help page, including screenshots.</p>

84
apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Collections/Board View.html generated vendored Normal file
View File

@ -0,0 +1,84 @@
<figure class="image">
<img style="aspect-ratio:918/248;" src="Board View_image.png" width="918"
height="248">
</figure>
<p>The Board view presents sub-notes in columns for a Kanban-like experience.
Each column represents a possible value for a status label, which can be
adjusted.</p>
<h2>How it works</h2>
<p>When first creating a collection of <em>Board</em> type, a few subnotes
will be created, each having a <code>#status</code> label set. The board
then groups each note by the value of the status attribute.</p>
<p>Notes are displayed recursively, so even the child notes of the child
notes will be displayed. However, unlike the&nbsp;<a class="reference-link"
href="#root/pOsGYCXsbNQG/KSZ04uQ2D1St/GTwFsgaA0lCt/_help_2FvYrpmOXm29">Table View</a>,
the notes are not displayed in a hierarchy.</p>
<h2>Interaction with columns</h2>
<ul>
<li data-list-item-id="e6753be6b26c46c035671af86289cf196">Create a new column by pressing <em>Add Column</em> near the last column.
<ul>
<li data-list-item-id="ea187c3f44d40774c710edf7d741a236c">Once pressed, a text box will be displayed to set the name of the column.
Press Enter to confirm.</li>
</ul>
</li>
<li data-list-item-id="e71e0e606cc30bcaac9c20ac2dd03a8a5">To reorder a column, simply hold the mouse over the title and drag it
to the desired position.</li>
<li data-list-item-id="eacc6f67c9dc1d0a1e7ac4ee510f7ed25">To delete a column, right click on its title and select <em>Delete column</em>.</li>
<li
data-list-item-id="e37fbd5727f5291bdec059d3fd4867ac6">To rename a column, click on the note title.
<ul>
<li data-list-item-id="e1bfd26a676d955394313f50331408495">Press Enter to confirm.</li>
<li data-list-item-id="ec1c42fc21c88b816843f64edd695fde5">Upon renaming a column, the corresponding status attribute of all its
notes will be changed in bulk.</li>
</ul>
</li>
<li data-list-item-id="eb357e9f42fcf948eca6212aeb209a5a1">If there are many columns, use the mouse wheel to scroll.</li>
</ul>
<h2>Interaction with notes</h2>
<ul>
<li data-list-item-id="e3acf3f583b9ed1a7e71bfe6cc9e1f3c1">Create a new note in any column by pressing <em>New item</em>
<ul>
<li data-list-item-id="eb77dd064c0073c486b6532937eb7d277">Enter the name of the note and press <em>Enter</em>.</li>
<li data-list-item-id="e114392d875aa7259c6a4d49de817e659">Doing so will create a new note. The new note will have an attribute (<code>status</code> label
by default) set to the name of the column.</li>
</ul>
</li>
<li data-list-item-id="e18de462534a4514576912310181a6c5b">To change the state of a note, simply drag a note from one column to the
other to change its state.</li>
<li data-list-item-id="eea36d097a82322804e0878e09b83d5dc">The order of the notes in each column corresponds to their position in
the tree.
<ul>
<li data-list-item-id="ea374f8fd30bfbdeb07b98b8bb56c8565">It's possible to reorder notes simply by dragging them to the desired
position within the same columns.</li>
<li data-list-item-id="ea65032b5bb4a4ace6b551877bf695831">It's also possible to drag notes across columns, at the desired position.</li>
</ul>
</li>
<li data-list-item-id="e17382c245068b6f396d96240628efeaa">For more options, right click on a note to display a context menu with
the following options:
<ul>
<li data-list-item-id="eae617b894b3dad9d9efa0637eeae3a58">Open the note in a new tab/split/window or quick edit.</li>
<li data-list-item-id="e2d699e050e30c9b5f7b105fe613df26d">Move the note to any column.</li>
<li data-list-item-id="e10c62ae541b53d1dc224c57cdde27ace">Insert a new note above/below the current one.</li>
<li data-list-item-id="e2a66bb1230add7d14d1e7f90507bd138">Delete the current note.</li>
</ul>
</li>
<li data-list-item-id="e8f9888bf5fcb78fd22511a5d6402e313">If there are many notes within the column, move the mouse over the column
and use the mouse wheel to scroll.</li>
</ul>
<h2>Configuration</h2>
<h3>Grouping by another attribute</h3>
<p>By default, the label used to group the notes is <code>#status</code>.
It is possible to use a different label if needed by defining a label named <code>#board:groupBy</code> with
the value being the attribute to use (without <code>#</code> attribute prefix).</p>
<aside
class="admonition note">
<p>It's currently not possible to set a relation as the grouping criteria.
There are plans to add support for it.</p>
</aside>
<h2>Interaction</h2>
<h2>Limitations</h2>
<ul>
<li data-list-item-id="eadd96ee9c3bfbf8fd1ba282fffa0c5f1">It is not possible yet to use group by a relation, only by label.</li>
</ul>
<p>&nbsp;</p>
<p>&nbsp;</p>

BIN
apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Collections/Board View_image.png generated vendored Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 18 KiB

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

@ -12,134 +12,128 @@
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>
<figure class="table"> <table>
<table> <thead>
<thead> <tr>
<tr> <th></th>
<th>&nbsp;</th> <th></th>
<th>&nbsp;</th> <th></th>
<th>&nbsp;</th> </tr>
</tr> </thead>
</thead> <tbody>
<tbody> <tr>
<tr> <td>1</td>
<td>1</td> <td>
<td> <figure class="image">
<figure class="image"> <img style="aspect-ratio:483/413;" src="15_Geo Map View_image.png" width="483"
<img style="aspect-ratio:483/413;" src="15_Geo Map View_image.png" width="483" height="413">
height="413"> </figure>
</figure> </td>
</td> <td>Right click on any note on the note tree and select <em>Insert child note</em> → <em>Geo Map (beta)</em>.</td>
<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> <tr>
<tr> <td>2</td>
<td>2</td> <td>
<td> <figure class="image image-style-align-center image_resized" style="width:53.44%;">
<figure class="image image-style-align-center image_resized" style="width:53.44%;"> <img style="aspect-ratio:1720/1396;" src="8_Geo Map View_image.png" width="1720"
<img style="aspect-ratio:1720/1396;" src="8_Geo Map View_image.png" width="1720" height="1396">
height="1396"> </figure>
</figure> </td>
</td> <td>By default the map will be empty and will show the entire world.</td>
<td>By default the map will be empty and will show the entire world.</td> </tr>
</tr> </tbody>
</tbody> </table>
</table>
</figure>
<h2>Repositioning the map</h2> <h2>Repositioning the map</h2>
<ul> <ul>
<li data-list-item-id="eae523b73dba005f71d5f01802606f2e3">Click and drag the map in order to move across the map.</li> <li>Click and drag the map in order to move across the map.</li>
<li data-list-item-id="e0c1c00d4d2bc4457e552677e7f4a5548">Use the mouse wheel, two-finger gesture on a touchpad or the +/- buttons <li>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>
<figure class="table"> <table>
<table> <thead>
<thead> <tr>
<tr> <th></th>
<th>&nbsp;</th> <th></th>
<th>&nbsp;</th> <th></th>
<th>&nbsp;</th> </tr>
</tr> </thead>
</thead> <tbody>
<tbody> <tr>
<tr> <td>1</td>
<td>1</td> <td>To create a marker, first navigate to the desired point on the map. Then
<td>To create a marker, first navigate to the desired point on the map. Then press the
press the <img src="10_Geo Map View_image.png">button in the&nbsp;<a href="#root/_help_XpOYSgsLkTJy">Floating buttons</a>&nbsp;(top-right)
<img src="10_Geo Map View_image.png">button in the&nbsp;<a href="#root/_help_XpOYSgsLkTJy">Floating buttons</a>&nbsp;(top-right) area.&nbsp;&nbsp;
area.&nbsp;&nbsp; <br>
<br> <br>If the button is not visible, make sure the button section is visible
<br>If the button is not visible, make sure the button section is visible by pressing the chevron button (
by pressing the chevron button ( <img src="17_Geo Map View_image.png">) in the top-right of the map.</td>
<img src="17_Geo Map View_image.png">) in the top-right of the map.</td> <td></td>
<td>&nbsp;</td> </tr>
</tr> <tr>
<tr> <td>2</td>
<td>2</td> <td>
<td> <img class="image_resized" style="aspect-ratio:1730/416;width:100%;" src="2_Geo Map View_image.png"
<img class="image_resized" style="aspect-ratio:1730/416;width:100%;" src="2_Geo Map View_image.png" width="1730" height="416">
width="1730" height="416"> </td>
</td> <td>Once pressed, the map will enter in the insert mode, as illustrated by
<td>Once pressed, the map will enter in the insert mode, as illustrated by the notification.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
the notification.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <br>
<br> <br>Simply click the point on the map where to place the marker, or the Escape
<br>Simply click the point on the map where to place the marker, or the Escape key to cancel.</td>
key to cancel.</td> </tr>
</tr> <tr>
<tr> <td>3</td>
<td>3</td> <td>
<td> <img class="image_resized" style="aspect-ratio:1586/404;width:100%;" src="7_Geo Map View_image.png"
<img class="image_resized" style="aspect-ratio:1586/404;width:100%;" src="7_Geo Map View_image.png" width="1586" height="404">
width="1586" height="404"> </td>
</td> <td>Enter the name of the marker/note to be created.</td>
<td>Enter the name of the marker/note to be created.</td> </tr>
</tr> <tr>
<tr> <td>4</td>
<td>4</td> <td>
<td> <img class="image_resized" style="aspect-ratio:1696/608;width:100%;" src="16_Geo Map View_image.png"
<img class="image_resized" style="aspect-ratio:1696/608;width:100%;" src="16_Geo Map View_image.png" width="1696" height="608">
width="1696" height="608"> </td>
</td> <td>Once confirmed, the marker will show up on the map and it will also be
<td>Once confirmed, the marker will show up on the map and it will also be displayed as a child note of the map.</td>
displayed as a child note of the map.</td> </tr>
</tr> </tbody>
</tbody> </table>
</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 data-list-item-id="e28f1a2fee5b0ecc42bfe35b472bf6e9d">Right click anywhere on the map, where to place the newly created marker <li>Right click anywhere on the map, where to place the newly created marker
(and corresponding note).</li> (and corresponding note).</li>
<li data-list-item-id="e12f1d02eab30eff35d80d30881242432">Select <em>Add a marker at this location</em>.</li> <li>Select <em>Add a marker at this location</em>.</li>
<li data-list-item-id="e81f2c0a3e9385c326b222e95bbfb3fcf">Enter the name of the newly created note.</li> <li>Enter the name of the newly created note.</li>
<li data-list-item-id="e1965e61f563e3e73a88cba0c0a9882ea">The map should be updated with the new marker.</li> <li>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 data-list-item-id="eec9c431281172d5e8459f6bdacd38b9f">Select the desired note in the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>.</li> <li>Select the desired note in the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>.</li>
<li <li>Hold the mouse on the note and drag it to the map to the desired location.</li>
data-list-item-id="ef5e95092daa5b6e5f6f09301a4a6f775">Hold the mouse on the note and drag it to the map to the desired location.</li> <li>The map should be updated with the new marker.</li>
<li
data-list-item-id="e5bec34d97bab10d0171a3bf086887066">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 data-list-item-id="e711a557c1554195062d8d3757b22a3af">Notes that are not part of the geo map, case in which a <a href="#root/_help_IakOLONlIfGI">clone</a> will <li>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 data-list-item-id="e4ea55f941135a2cccc00bf5238ff17f3">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 but not yet positioned on the map.</li>
<li <li>Notes that are a child of the geo map and also positioned, case in which
data-list-item-id="ebb44a6eb75da8c01f66967bacba6c44b">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>
<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>
<p> <img src="18_Geo Map View_image.png" width="1288"
<img src="18_Geo Map View_image.png" width="1288" height="278"> 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>
@ -151,17 +145,16 @@
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 data-list-item-id="e2c684ec660b82d51e613eb2259503f24">Hovering over a marker will display a&nbsp;<a class="reference-link" href="#root/_help_lgKX7r3aL30x">Note Tooltip</a>&nbsp;with <li>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 data-list-item-id="e7d2862e8cc2f9c0abfc7a787c2d592e5">Clicking on the note title in the tooltip will navigate to the note in <li>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 data-list-item-id="e128abb7b7e86bab6a078bbcc036cf18e">Middle-clicking the marker will open the note in a new tab.</li> <li>Middle-clicking the marker will open the note in a new tab.</li>
<li data-list-item-id="e4ab8d71d03964d1d6f78176b8c52ba55">Right-clicking the marker will open a contextual menu (as described below).</li> <li>Right-clicking the marker will open a contextual menu (as described below).</li>
<li <li>If the map is in read-only mode, clicking on a marker will open a&nbsp;
data-list-item-id="e7b9935143dde811ab1a815390b74dc6c">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>
@ -169,24 +162,24 @@
<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 data-list-item-id="e3d9089e1842a44c6c4350e2302ae4c44">If right-clicking an empty section of the map (not on a marker), it allows <li>If right-clicking an empty section of the map (not on a marker), it allows
to: to:
<ol> <ol>
<li data-list-item-id="ed2632173c9e684258ad6695f90c34b52">Displays the latitude and longitude. Clicking this option will copy them <li>Displays the latitude and longitude. Clicking this option will copy them
to the clipboard.</li> to the clipboard.</li>
<li data-list-item-id="e5c8b63fcebf2d89ca789ca2412cb45f6">Open the location using an external application (if the operating system <li>Open the location using an external application (if the operating system
supports it).</li> supports it).</li>
<li data-list-item-id="ee3db8aec5bce0c696fd9110599b35356">Adding a new marker at that location.</li> <li>Adding a new marker at that location.</li>
</ol> </ol>
</li> </li>
<li data-list-item-id="ea9dce579893bc84079ea809e943a60da">If right-clicking on a marker, it allows to: <li>If right-clicking on a marker, it allows to:
<ol> <ol>
<li data-list-item-id="ecf1bd157850305904f6aa173667c8d7e">Displays the latitude and longitude. Clicking this option will copy them <li>Displays the latitude and longitude. Clicking this option will copy them
to the clipboard.</li> to the clipboard.</li>
<li data-list-item-id="ead7e348313cfad21d3555d997c349f3e">Open the location using an external application (if the operating system <li>Open the location using an external application (if the operating system
supports it).</li> supports it).</li>
<li data-list-item-id="e9d0282d185ea5672a81722ece761050f">Open the note in a new tab, split or window.</li> <li>Open the note in a new tab, split or window.</li>
<li data-list-item-id="ed589d9e12ebb69788430f3fda290cc6a">Remove the marker from the map, which will remove the <code>#geolocation</code> attribute <li>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>
@ -206,215 +199,209 @@
<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>
<figure class="table"> <table>
<table> <thead>
<thead> <tr>
<tr> <th></th>
<th>&nbsp;</th> <th></th>
<th>&nbsp;</th> <th></th>
<th>&nbsp;</th> </tr>
</tr> </thead>
</thead> <tbody>
<tbody> <tr>
<tr> <td>1</td>
<td>1</td> <td>
<td> <figure class="image image-style-align-center image_resized" style="width:56.84%;">
<figure class="image image-style-align-center image_resized" style="width:56.84%;"> <img style="aspect-ratio:732/918;" src="12_Geo Map View_image.png" width="732"
<img style="aspect-ratio:732/918;" src="12_Geo Map View_image.png" width="732" height="918">
height="918"> </figure>
</figure> </td>
</td> <td>Go to Google Maps on the web and look for a desired location, right click
<td>Go to Google Maps on the web and look for a desired location, right click on it and a context menu will show up.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
on it and a context menu will show up.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <br>
<br> <br>Simply click on the first item displaying the coordinates and they will
<br>Simply click on the first item displaying the coordinates and they will be copied to clipboard.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
be copied to clipboard.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <br>
<br> <br>Then paste the value inside the text box into the <code>#geolocation</code> attribute
<br>Then paste the value inside the text box into the <code>#geolocation</code> attribute of a child note of the map (don't forget to surround the value with a <code>"</code> character).</td>
of a child note of the map (don't forget to surround the value with a <code>"</code> character).</td> </tr>
</tr> <tr>
<tr> <td>2</td>
<td>2</td> <td>
<td> <figure class="image image-style-align-center image_resized" style="width:100%;">
<figure class="image image-style-align-center image_resized" style="width:100%;"> <img style="aspect-ratio:518/84;" src="4_Geo Map View_image.png" width="518"
<img style="aspect-ratio:518/84;" src="4_Geo Map View_image.png" width="518" height="84">
height="84"> </figure>
</figure> </td>
</td> <td>In Trilium, create a child note under the map.</td>
<td>In Trilium, create a child note under the map.</td> </tr>
</tr> <tr>
<tr> <td>3</td>
<td>3</td> <td>
<td> <figure class="image image-style-align-center image_resized" style="width:100%;">
<figure class="image image-style-align-center image_resized" style="width:100%;"> <img style="aspect-ratio:1074/276;" src="11_Geo Map View_image.png" width="1074"
<img style="aspect-ratio:1074/276;" src="11_Geo Map View_image.png" width="1074" height="276">
height="276"> </figure>
</figure> </td>
</td> <td>And then go to Owned Attributes and type <code>#geolocation="</code>, then
<td>And then go to Owned Attributes and type <code>#geolocation="</code>, then paste from the clipboard as-is and then add the ending <code>"</code> character.
paste from the clipboard as-is and then add the ending <code>"</code> character. Press Enter to confirm and the map should now be updated to contain the
Press Enter to confirm and the map should now be updated to contain the new note.</td>
new note.</td> </tr>
</tr> </tbody>
</tbody> </table>
</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>
<figure class="table"> <table>
<table> <thead>
<thead> <tr>
<tr> <th></th>
<th>&nbsp;</th> <th></th>
<th>&nbsp;</th> <th></th>
<th>&nbsp;</th> </tr>
</tr> </thead>
</thead> <tbody>
<tbody> <tr>
<tr> <td>1</td>
<td>1</td> <td>
<td> <img class="image_resized" style="aspect-ratio:562/454;width:100%;" src="1_Geo Map View_image.png"
<img class="image_resized" style="aspect-ratio:562/454;width:100%;" src="1_Geo Map View_image.png" width="562" height="454">
width="562" height="454"> </td>
</td> <td>Go to any location on openstreetmap.org and right click to bring up the
<td>Go to any location on openstreetmap.org and right click to bring up the context menu. Select the “Show address” item.</td>
context menu. Select the “Show address” item.</td> </tr>
</tr> <tr>
<tr> <td>2</td>
<td>2</td> <td>
<td> <img class="image_resized" style="aspect-ratio:696/480;width:100%;" src="Geo Map View_image.png"
<img class="image_resized" style="aspect-ratio:696/480;width:100%;" src="Geo Map View_image.png" width="696" height="480">
width="696" height="480"> </td>
</td> <td>The address will be visible in the top-left of the screen, in the place
<td>The address will be visible in the top-left of the screen, in the place of the search bar.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
of the search bar.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <br>
<br> <br>Select the coordinates and copy them into the clipboard.</td>
<br>Select the coordinates and copy them into the clipboard.</td> </tr>
</tr> <tr>
<tr> <td>3</td>
<td>3</td> <td>
<td> <img class="image_resized" style="aspect-ratio:640/276;width:100%;" src="5_Geo Map View_image.png"
<img class="image_resized" style="aspect-ratio:640/276;width:100%;" src="5_Geo Map View_image.png" width="640" height="276">
width="640" height="276"> </td>
</td> <td>Simply paste the value inside the text box into the <code>#geolocation</code> attribute
<td>Simply paste the value inside the text box into the <code>#geolocation</code> attribute of a child note of the map and then it should be displayed on the map.</td>
of a child note of the map and then it should be displayed on the map.</td> </tr>
</tr> </tbody>
</tbody> </table>
</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>
<figure <table>
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">
<td> <img style="aspect-ratio:226/74;" src="3_Geo Map View_image.png" width="226"
<figure class="image image-style-align-center"> height="74">
<img style="aspect-ratio:226/74;" src="3_Geo Map View_image.png" width="226" </figure>
height="74"> </td>
</figure> <td>To add a track, simply drag &amp; drop a .gpx file inside the geo map
</td> in the note tree.</td>
<td>To add a track, simply drag &amp; drop a .gpx file inside the geo map </tr>
in the note tree.</td> <tr>
</tr> <td>2</td>
<tr> <td>
<td>2</td> <figure class="image image-style-align-center">
<td> <img style="aspect-ratio:322/222;" src="14_Geo Map View_image.png" width="322"
<figure class="image image-style-align-center"> height="222">
<img style="aspect-ratio:322/222;" src="14_Geo Map View_image.png" width="322" </figure>
height="222"> </td>
</figure> <td>In order for the file to be recognized as a GPS track, it needs to show
</td> up as <code>application/gpx+xml</code> in the <em>File type</em> field.</td>
<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> <tr>
</tr> <td>3</td>
<tr> <td>
<td>3</td> <figure class="image image-style-align-center">
<td> <img style="aspect-ratio:620/530;" src="6_Geo Map View_image.png" width="620"
<figure class="image image-style-align-center"> height="530">
<img style="aspect-ratio:620/530;" src="6_Geo Map View_image.png" width="620" </figure>
height="530"> </td>
</figure> <td>When going back to the map, the track should now be visible.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</td> <br>
<td>When going back to the map, the track should now be visible.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <br>The start and end points of the track are indicated by the two blue markers.</td>
<br> </tr>
<br>The start and end points of the track are indicated by the two blue markers.</td> </tbody>
</tr> </table>
</tbody> <aside class="admonition note">
</table> <p>The starting point of the track will be displayed as a marker, with the
</figure> name of the note underneath. The start marker will also respect the icon
<aside class="admonition note"> and the <code>color</code> of the note. The end marker is displayed with
<p>The starting point of the track will be displayed as a marker, with the a distinct icon.</p>
name of the note underneath. The start marker will also respect the icon <p>If the GPX contains waypoints, they will also be displayed. If they have
and the <code>color</code> of the note. The end marker is displayed with a name, it is displayed when hovering over it with the mouse.</p>
a distinct icon.</p> </aside>
<p>If the GPX contains waypoints, they will also be displayed. If they have <h2>Read-only mode</h2>
a name, it is displayed when hovering over it with the mouse.</p> <p>When a map is in read-only all editing features will be disabled such
</aside> as:</p>
<h2>Read-only mode</h2> <ul>
<p>When a map is in read-only all editing features will be disabled such <li>The add button in the&nbsp;<a class="reference-link" href="#root/_help_XpOYSgsLkTJy">Floating buttons</a>.</li>
as:</p> <li>Dragging markers.</li>
<ul> <li>Editing from the contextual menu (removing locations or adding new items).</li>
<li data-list-item-id="e259bf29df58132f4068a0123b405560b">The add button in the&nbsp;<a class="reference-link" href="#root/_help_XpOYSgsLkTJy">Floating buttons</a>.</li> </ul>
<li <p>To enable read-only mode simply press the <em>Lock</em> icon from the&nbsp;
data-list-item-id="e476b0dc0202a017bcae0696997253965">Dragging markers.</li> <a
<li data-list-item-id="e617fa22b5a9f273586c20a6aec6f3661">Editing from the contextual menu (removing locations or adding new items).</li> class="reference-link" href="#root/_help_XpOYSgsLkTJy">Floating buttons</a>. To disable it, press the button again.</p>
</ul> <h2>Configuration</h2>
<p>To enable read-only mode simply press the <em>Lock</em> icon from the&nbsp; <h3>Map Style</h3>
<a <p>The styling of the map can be adjusted in the <em>Collection Properties</em> tab
class="reference-link" href="#root/_help_XpOYSgsLkTJy">Floating buttons</a>. To disable it, press the button again.</p> in the&nbsp;<a class="reference-link" href="#root/_help_BlN9DFI679QC">Ribbon</a>&nbsp;or
<h2>Configuration</h2> manually via the <code>#map:style</code> attribute.</p>
<h3>Map Style</h3> <p>The geo map comes with two different types of styles:</p>
<p>The styling of the map can be adjusted in the <em>Collection Properties</em> tab <ul>
in the&nbsp;<a class="reference-link" href="#root/pOsGYCXsbNQG/gh7bpGYxajRS/Vc8PjrjAGuOp/_help_BlN9DFI679QC">Ribbon</a>&nbsp;or <li>Raster styles
manually via the <code>#map:style</code> attribute.</p> <ul>
<p>The geo map comes with two different types of styles:</p> <li>For these styles the map is represented as a grid of images at different
<ul> zoom levels. This is the traditional way OpenStreetMap used to work.</li>
<li data-list-item-id="e9906c5e3a729a3640f5e287feab31b72">Raster styles <li>Zoom is slightly restricted.</li>
<ul> <li>Currently, the only raster theme is the original OpenStreetMap style.</li>
<li data-list-item-id="e97f71804efddd3853b507512ea4a40af">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="e00813cf013a220a699bb6b23567db695">Zoom is slightly restricted.</li>
<li data-list-item-id="ef1855c52e9c051a5cb6f4fff26d5f618">Currently, the only raster theme is the original OpenStreetMap style.</li>
</ul> </ul>
</li> </li>
<li data-list-item-id="e725de962ba0d3f2e76ee990288862433">Vector styles <li>Vector styles
<ul> <ul>
<li data-list-item-id="ed3092e999b7bf7123c8b7b0bbc30277a">Vector styles are not represented as images, but as geometrical shapes. <li>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 data-list-item-id="eefa12c0b39d004da202f5ec1ab03fc9d">The map can be zoomed in much further.</li> <li>The map can be zoomed in much further.</li>
<li data-list-item-id="e5c257789123aa1c9b934bcfdbef60931">These come both in a light and a dark version.</li> <li>These come both in a light and a dark version.</li>
<li data-list-item-id="e6669e513e76501556470599f09c43f4a">The vector styles come from <a href="https://versatiles.org/">VersaTiles</a>, <li>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/pOsGYCXsbNQG/gh7bpGYxajRS/Vc8PjrjAGuOp/_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 View_image.png" width="678" <img style="aspect-ratio:678/499;" src="13_Geo Map View_image.png" width="678"
height="499"> height="499">
</figure> </figure>
<h3>Grid-like artifacts on the map</h3>
<p>This occurs if the application is not at 100% zoom which causes the pixels <h3>Grid-like artifacts on the map</h3>
of the map to not render correctly due to fractional scaling. The only <p>This occurs if the application is not at 100% zoom which causes the pixels
possible solution is to set the UI zoom at 100% (default keyboard shortcut of the map to not render correctly due to fractional scaling. The only
is <kbd>Ctrl</kbd>+<kbd>0</kbd>).</p> possible solution is to set the UI zoom at 100% (default keyboard shortcut
is <kbd>Ctrl</kbd>+<kbd>0</kbd>).</p>

132
apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Collections/Table View.html generated vendored
View File

@ -8,31 +8,31 @@
<h2>How it works</h2> <h2>How it works</h2>
<p>The tabular structure is represented as such:</p> <p>The tabular structure is represented as such:</p>
<ul> <ul>
<li>Each child note is a row in the table.</li> <li data-list-item-id="ea0418f143b93a19ec996f3e66444c23a">Each child note is a row in the table.</li>
<li>If child rows also have children, they will be displayed under an expander <li data-list-item-id="e37df536f3b11b4294297e7b6134428f9">If child rows also have children, they will be displayed under an expander
(nested notes).</li> (nested notes).</li>
<li>Each column is a <a href="#root/_help_OFXdgB2nNk1F">promoted attribute</a> that <li data-list-item-id="ebd16c84c37c2d3782567cf4d23701354">Each column is a <a href="#root/_help_OFXdgB2nNk1F">promoted attribute</a> that
is defined on the Collection note. is defined on the Collection note.
<ul> <ul>
<li>Actually, both promoted and unpromoted attributes are supported, but it's <li data-list-item-id="ea05f5ec1c0c315b37f05bbb3a045583a">Actually, both promoted and unpromoted attributes are supported, but it's
a requirement to use a label/relation definition.</li> a requirement to use a label/relation definition.</li>
<li>The promoted attributes are usually defined as inheritable in order to <li data-list-item-id="e2ef130cc4d15f788e50daf210847cbbb">The promoted attributes are usually defined as inheritable in order to
show up in the child notes, but it's not a requirement.</li> show up in the child notes, but it's not a requirement.</li>
</ul> </ul>
</li> </li>
<li>If there are multiple attribute definitions with the same <code>name</code>, <li data-list-item-id="e1cb6afc55de7e7d038e5dc2592604e7d">If there are multiple attribute definitions with the same <code>name</code>,
only one will be displayed.</li> only one will be displayed.</li>
</ul> </ul>
<p>There are also a few predefined columns:</p> <p>There are also a few predefined columns:</p>
<ul> <ul>
<li>The current item number, identified by the <code>#</code> symbol. <li data-list-item-id="e0ee40aa88c6ec67050cf582e1de2a511">The current item number, identified by the <code>#</code> symbol.
<ul> <ul>
<li>This simply counts the note and is affected by sorting.</li> <li data-list-item-id="e0658c976040c3dd7d7d516f3e81b5dd6">This simply counts the note and is affected by sorting.</li>
</ul> </ul>
</li> </li>
<li><a class="reference-link" href="#root/_help_m1lbrzyKDaRB">Note ID</a>, <li data-list-item-id="ee40b5cf3b77d956abee6bbed0781c1aa"><a class="reference-link" href="#root/_help_m1lbrzyKDaRB">Note ID</a>,
representing the unique ID used internally by Trilium</li> representing the unique ID used internally by Trilium</li>
<li>The title of the note.</li> <li data-list-item-id="e4e24776fc43d49b40924a55037bae164">The title of the note.</li>
</ul> </ul>
<h2>Interaction</h2> <h2>Interaction</h2>
<h3>Creating a new table</h3> <h3>Creating a new table</h3>
@ -43,17 +43,18 @@
is defined on the Collection note.</p> is defined on the Collection note.</p>
<p>To create a new column, either:</p> <p>To create a new column, either:</p>
<ul> <ul>
<li>Press <em>Add new column</em> at the bottom of the table.</li> <li data-list-item-id="e9d4c7b075e3f2fe9f6df45cd06a3a2b2">Press <em>Add new column</em> at the bottom of the table.</li>
<li>Right click on an existing column and select Add column to the left/right.</li> <li data-list-item-id="ef66e5ebb0af38d4db86743365f6ec3a7">Right click on an existing column and select Add column to the left/right.</li>
<li>Right click on the empty space of the column header and select <em>Label</em> or <em>Relation</em> in <li
data-list-item-id="ecd0e68e741ce8bb304a40d878e5745a0">Right click on the empty space of the column header and select <em>Label</em> or <em>Relation</em> in
the <em>New column</em> section.</li> the <em>New column</em> section.</li>
</ul> </ul>
<h3>Adding new rows</h3> <h3>Adding new rows</h3>
<p>Each row is actually a note that is a child of the Collection note.</p> <p>Each row is actually a note that is a child of the Collection note.</p>
<p>To create a new note, either:</p> <p>To create a new note, either:</p>
<ul> <ul>
<li>Press <em>Add new row</em> at the bottom of the table.</li> <li data-list-item-id="eba76a40653e728455961488b44e2c88a">Press <em>Add new row</em> at the bottom of the table.</li>
<li>Right click on an existing row and select <em>Insert row above, Insert child note</em> or <em>Insert row below</em>.</li> <li data-list-item-id="efcdd260648c64133366baaedbe9fae5e">Right click on an existing row and select <em>Insert row above, Insert child note</em> or <em>Insert row below</em>.</li>
</ul> </ul>
<p>By default it will try to edit the title of the newly created note.</p> <p>By default it will try to edit the title of the newly created note.</p>
<p>Alternatively, the note can be created from the&nbsp;<a class="reference-link" <p>Alternatively, the note can be created from the&nbsp;<a class="reference-link"
@ -61,27 +62,28 @@
<h3>Context menu</h3> <h3>Context menu</h3>
<p>There are multiple menus:</p> <p>There are multiple menus:</p>
<ul> <ul>
<li>Right clicking on a column, allows: <li data-list-item-id="e10284169a0dc36c347245a6fc5a4a0d2">Right clicking on a column, allows:
<ul> <ul>
<li>Sorting by the selected column and resetting the sort.</li> <li data-list-item-id="e959d44a502767362e7fc02e5eadae03e">Sorting by the selected column and resetting the sort.</li>
<li>Hiding the selected column or adjusting the visibility of every column.</li> <li data-list-item-id="e457f7bc4d135083c2b4c6b4faaabc7fe">Hiding the selected column or adjusting the visibility of every column.</li>
<li>Adding new columns to the left or the right of the column.</li> <li
<li>Editing the current column.</li> data-list-item-id="e64b21e19754d7d2e4b1c4f4099b3bacc">Adding new columns to the left or the right of the column.</li>
<li>Deleting the current column.</li> <li data-list-item-id="edde6b9b4713d8c7c0892be2f1165bde6">Editing the current column.</li>
<li data-list-item-id="edd1a26953073beefb0c103c57b513a08">Deleting the current column.</li>
</ul>
</li>
<li data-list-item-id="eb1288eb3e94b2bf5cd6b400039717edf">Right clicking on the space to the right of the columns, allows:
<ul>
<li data-list-item-id="ee3ff68651c4c766b15470344a2648860">Adjusting the visibility of every column.</li>
<li data-list-item-id="e00cc86778fa0fa85734fc01b74e25279">Adding new columns.</li>
</ul> </ul>
</li> </li>
<li>Right clicking on the space to the right of the columns, allows: <li data-list-item-id="e913b95accaf874e109db9905b5b6f3b5">Right clicking on a row, allows:
<ul> <ul>
<li>Adjusting the visibility of every column.</li> <li data-list-item-id="e4e7e38228abfb58c37ffc68616a8da6e">Opening the corresponding note of the row in a new tab, split, window
<li>Adding new columns.</li>
</ul>
</li>
<li>Right clicking on a row, allows:
<ul>
<li>Opening the corresponding note of the row in a new tab, split, window
or quick editing it.</li> or quick editing it.</li>
<li>Inserting rows above, below or as a child note.</li> <li data-list-item-id="ea949a04a7a9c9f5d7979140684218298">Inserting rows above, below or as a child note.</li>
<li>Deleting the row.</li> <li data-list-item-id="e8d2f38f590deb56dce4bd880da02e2fa">Deleting the row.</li>
</ul> </ul>
</li> </li>
</ul> </ul>
@ -90,17 +92,18 @@
not only reflect in the table, but also as an attribute of the corresponding not only reflect in the table, but also as an attribute of the corresponding
note.</p> note.</p>
<ul> <ul>
<li>The editing will respect the type of the promoted attribute, by presenting <li data-list-item-id="ef5625b0a34c060243caf9297a2c959d8">The editing will respect the type of the promoted attribute, by presenting
a normal text box, a number selector or a date selector for example.</li> a normal text box, a number selector or a date selector for example.</li>
<li>It also possible to change the title of a note.</li> <li
<li>Editing relations is also possible data-list-item-id="eccf0c928672039b793c4566d54ec8419">It also possible to change the title of a note.</li>
<ul> <li data-list-item-id="e50644ab190ff6911af490ca1ad732a53">Editing relations is also possible
<li>Simply click on a relation and it will become editable. Enter the text <ul>
to look for a note and click on it.</li> <li data-list-item-id="e6853711436a0f878786636d984df73e4">Simply click on a relation and it will become editable. Enter the text
<li>To remove a relation, remove the title of the note from the text box and to look for a note and click on it.</li>
click outside the cell.</li> <li data-list-item-id="e8d9cc912c0025ea78931b15979cbcfc6">To remove a relation, remove the title of the note from the text box and
</ul> click outside the cell.</li>
</li> </ul>
</li>
</ul> </ul>
<h3>Editing columns</h3> <h3>Editing columns</h3>
<p>It is possible to edit a column by right clicking it and selecting <em>Edit column.</em> This <p>It is possible to edit a column by right clicking it and selecting <em>Edit column.</em> This
@ -114,18 +117,19 @@
href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>. However, it is possible href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>. However, it is possible
to sort the data by the values of a column:</p> to sort the data by the values of a column:</p>
<ul> <ul>
<li>To do so, simply click on a column.</li> <li data-list-item-id="e9866b3e8697d3c7d480bb32d2df2fe4f">To do so, simply click on a column.</li>
<li>To switch between ascending or descending sort, simply click again on <li data-list-item-id="e1315c18a23aabbdcc9c36641c4d22ed8">To switch between ascending or descending sort, simply click again on
the same column. The arrow next to the column will indicate the direction the same column. The arrow next to the column will indicate the direction
of the sort.</li> of the sort.</li>
<li>To disable sorting and fall back to the original order, right click any <li data-list-item-id="e8de6519ff78c55846e8ad949efdb1749">To disable sorting and fall back to the original order, right click any
column on the header and select <em>Clear sorting.</em> column on the header and select <em>Clear sorting.</em>
</li> </li>
</ul> </ul>
<h3>Reordering and hiding columns</h3> <h3>Reordering and hiding columns</h3>
<ul> <ul>
<li>Columns can be reordered by dragging the header of the columns.</li> <li data-list-item-id="e9db498cf4b735211bfab6d8a897f0614">Columns can be reordered by dragging the header of the columns.</li>
<li>Columns can be hidden or shown by right clicking on a column and clicking <li
data-list-item-id="ec435139e49644765cc9fa36dee3f28ce">Columns can be hidden or shown by right clicking on a column and clicking
the item corresponding to the column.</li> the item corresponding to the column.</li>
</ul> </ul>
<h3>Reordering rows</h3> <h3>Reordering rows</h3>
@ -136,10 +140,12 @@
href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>.</p> href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>.</p>
<p>Reordering does have some limitations:</p> <p>Reordering does have some limitations:</p>
<ul> <ul>
<li>If the parent note has <code>#sorted</code>, reordering will be disabled.</li> <li data-list-item-id="e3ecbfd2eb395e49cf755279ed1ce96bc">If the parent note has <code>#sorted</code>, reordering will be disabled.</li>
<li>If using nested tables, then reordering will also be disabled.</li> <li
<li>Currently, it's possible to reorder notes even if column sorting is used, data-list-item-id="e74f74d42cf30cf51d548b25e68397e33">If using nested tables, then reordering will also be disabled.</li>
but the result might be inconsistent.</li> <li
data-list-item-id="e750f0e2ba77e7123a1a0390bb6138e51">Currently, it's possible to reorder notes even if column sorting is used,
but the result might be inconsistent.</li>
</ul> </ul>
<h3>Nested trees</h3> <h3>Nested trees</h3>
<p>If the child notes of the collection also have their own child notes, <p>If the child notes of the collection also have their own child notes,
@ -150,25 +156,29 @@
to a certain number of levels or even disable it completely. To do so, to a certain number of levels or even disable it completely. To do so,
either:</p> either:</p>
<ul> <ul>
<li>Go to <em>Collection Properties</em> in the&nbsp;<a class="reference-link" <li data-list-item-id="e48a95d7d971cadd6f1b53e25d567be7e">Go to <em>Collection Properties</em> in the&nbsp;<a class="reference-link"
href="#root/_help_BlN9DFI679QC">Ribbon</a>&nbsp;and look for the <em>Max nesting depth</em> section. href="#root/_help_BlN9DFI679QC">Ribbon</a>&nbsp;and look for the <em>Max nesting depth</em> section.
<ul> <ul>
<li>To disable nesting, type 0 and press Enter.</li> <li data-list-item-id="e18de613a0eb1a49d8c1629ea99602d22">To disable nesting, type 0 and press Enter.</li>
<li>To limit to a certain depth, type in the desired number (e.g. 2 to only <li data-list-item-id="e5d184ff1aa8a060900fd5a8e3cb78c56">To limit to a certain depth, type in the desired number (e.g. 2 to only
display children and sub-children).</li> display children and sub-children).</li>
<li>To re-enable unlimited nesting, remove the number and press Enter.</li> <li data-list-item-id="e9e083d9f55b6658e88651bc005d3519f">To re-enable unlimited nesting, remove the number and press Enter.</li>
</ul> </ul>
</li> </li>
<li>Manually set <code>maxNestingDepth</code> to the desired value.</li> <li data-list-item-id="e6a4e204e9145abbceebcc96787a61183">Manually set <code>maxNestingDepth</code> to the desired value.</li>
</ul> </ul>
<p>Limitations:</p> <p>Limitations:</p>
<ul> <ul>
<li>While in this mode, it's not possible to reorder notes.</li> <li data-list-item-id="ea837ad3a83df0a8939a2cc0d586cf58f">While in this mode, it's not possible to reorder notes.</li>
</ul> </ul>
<h2>Limitations</h2> <h2>Limitations</h2>
<p>Multi-value labels and relations are not supported. If a&nbsp;<a class="reference-link" <ul>
href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;is defined <li data-list-item-id="efcbcbbae267cd2ed3ddac4d512a6c5a1">Multi-value labels and relations are not supported. If a&nbsp;<a class="reference-link"
with a <em>Multi value</em> specificity, they will be ignored.</p> href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;is defined
with a <em>Multi value</em> specificity, they will be ignored.</li>
<li data-list-item-id="e8eb7e91706b56513d6f85828a7afa02f">There is no support to filter the rows by a certain criteria. Consider
using the table view in search for that use case.</li>
</ul>
<h2>Use in search</h2> <h2>Use in search</h2>
<p>The table view can be used in a&nbsp;<a class="reference-link" href="#root/_help_m523cpzocqaD">Saved Search</a>&nbsp;by <p>The table view can be used in a&nbsp;<a class="reference-link" href="#root/_help_m523cpzocqaD">Saved Search</a>&nbsp;by
adding the <code>#viewType=table</code> attribute.</p> adding the <code>#viewType=table</code> attribute.</p>
@ -177,8 +187,8 @@
of the&nbsp;<a class="reference-link" href="#root/_help_eIg8jdvaoNNd">Search</a>.</p> of the&nbsp;<a class="reference-link" href="#root/_help_eIg8jdvaoNNd">Search</a>.</p>
<p>However, there are also some limitations:</p> <p>However, there are also some limitations:</p>
<ul> <ul>
<li>It's not possible to reorder notes.</li> <li data-list-item-id="ee0798fde43ca865be18aef52b5a4adf4">It's not possible to reorder notes.</li>
<li>It's not possible to add a new row.</li> <li data-list-item-id="e9a31c753b79285e3db51c4f71764a8ba">It's not possible to add a new row.</li>
</ul> </ul>
<p>Columns are supported, by being defined as&nbsp;<a class="reference-link" <p>Columns are supported, by being defined as&nbsp;<a class="reference-link"
href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;to the&nbsp; href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;to the&nbsp;

2
docs/Developer Guide/Developer Guide/Development and architecture/Database/entity_changes.md vendored
View File

@ -7,7 +7,7 @@
| `hash` | Text | Nullable (\*) | | TODO: Describe how the hash is calculated | | `hash` | Text | Nullable (\*) | | TODO: Describe how the hash is calculated |
| `isErased` | Integer (1 or 0) | Nullable (\*) | | TODO: What does this do? | | `isErased` | Integer (1 or 0) | Nullable (\*) | | TODO: What does this do? |
| `changeId` | Text | Nullable (\*) | | TODO: What does this do? | | `changeId` | Text | Nullable (\*) | | TODO: What does this do? |
| `componentId` | Text | Nullable (\*) | | The ID of the UI component that caused this change.<br><br>Examples: `date-note`, `F-PoZMI0vc`, `NA` (catch all) | | `componentId` | Text | Nullable (\*) | | The ID of the UI component that caused this change. <br> <br>Examples: `date-note`, `F-PoZMI0vc`, `NA` (catch all) |
| `instanceId` | Text | Nullable (\*) | | The ID of the [instance](#root/pOsGYCXsbNQG/tC7s2alapj8V/Gzjqa934BdH4/c5xB8m4g2IY6) that created this change. | | `instanceId` | Text | Nullable (\*) | | The ID of the [instance](#root/pOsGYCXsbNQG/tC7s2alapj8V/Gzjqa934BdH4/c5xB8m4g2IY6) that created this change. |
| `isSynced` | Integer (1 or 0) | Non-null | | TODO: What does this do? | | `isSynced` | Integer (1 or 0) | Non-null | | TODO: What does this do? |
| `utcDateChanged` | Text | Non-null | | Date of the entity change in UTC format (e.g. `2023-11-08 16:43:44.204Z`) | | `utcDateChanged` | Text | Non-null | | Date of the entity change in UTC format (e.g. `2023-11-08 16:43:44.204Z`) |

2
docs/Developer Guide/Developer Guide/Development and architecture/Icons/Icons on Mac/Adaptive icon.md vendored
View File

@ -1,6 +1,6 @@
# Adaptive icon # Adaptive icon
| | | | | |
| --- | --- | | --- | --- |
| Before | <figure class="image"><img src="1_Adaptive icon_image.png"></figure> | | Before | <figure class="image"><img src="1_Adaptive icon_image.png"></figure> |
| After | <figure class="image"><img src="6_Adaptive icon_image.png"></figure> | | After | <figure class="image"><img src="6_Adaptive icon_image.png"></figure> |
| With new scale | <figure class="image"><img src="4_Adaptive icon_image.png"></figure> | | With new scale | <figure class="image"><img src="4_Adaptive icon_image.png"></figure> |

12
docs/Developer Guide/Developer Guide/Development and architecture/Icons/Removed icons.md vendored
View File

@ -17,11 +17,11 @@ These are stored in `images`:
| Name | Resolution | Description | | Name | Resolution | Description |
| --- | --- | --- | | --- | --- | --- |
| `png/16x16-bw.png` | 16x16 | Do not appear to be used. | | `png/16x16-bw.png` | 16x16 | Do not appear to be used. |
| `png/16x16.png` | | `png/16x16.png` | | |
| `png/24x24.png` | 24x24 | | `png/24x24.png` | 24x24 | |
| `png/32x32.png` | 32x32 | | `png/32x32.png` | 32x32 | |
| `png/48x48.png` | 48x48 | | `png/48x48.png` | 48x48 | |
| `png/64x64.png` | 64x64 | | `png/64x64.png` | 64x64 | |
| `png/96x96.png` | 96x96 | | `png/96x96.png` | 96x96 | |
| `png/512x512.png` | 512x512 | Does not appear to be used. | | `png/512x512.png` | 512x512 | Does not appear to be used. |
| `win/setup-banner.xcf` | | GIMP source for `win/setup-banner.gif`. Provided only for future editing. | | `win/setup-banner.xcf` | | GIMP source for `win/setup-banner.gif`. Provided only for future editing. |

4
docs/Developer Guide/Developer Guide/Old documentation/Build deliveries locally.md vendored
View File

@ -4,9 +4,9 @@ In the project root:
| Platform | Architecture | Application | Build command | | Platform | Architecture | Application | Build command |
| --- | --- | --- | --- | | --- | --- | --- | --- |
| macOS | x86\_64 | Desktop / Electron app | `./bin/build-mac-x64.sh` | | macOS | x86\_64 | Desktop / Electron app | `./bin/build-mac-x64.sh` |
| ARM 64 | Desktop / Electron app | `./bin/build-mac-arm64.sh` | | ARM 64 | Desktop / Electron app | `./bin/build-mac-arm64.sh` | |
| Linux | x86\_64 | Desktop / Electron app | `./bin/build-linux-x64.sh` | | Linux | x86\_64 | Desktop / Electron app | `./bin/build-linux-x64.sh` |
| Server | `./bin/build-server.sh` | | Server | `./bin/build-server.sh` | | |
| Windows | x86\_64 | Desktop / Electron app | `./bin/build-win-x64.sh` | | Windows | x86\_64 | Desktop / Electron app | `./bin/build-win-x64.sh` |
Under NixOS the following `nix-shell` is needed: Under NixOS the following `nix-shell` is needed:

46
docs/Developer Guide/Developer Guide/Old documentation/Project maintenance/Updating dependencies/Node.js, Electron and `better-.md vendored
View File

@ -6,31 +6,31 @@
Trilium Next started with version [8.4.0](https://github.com/WiseLibs/better-sqlite3/releases/tag/v8.4.0) for `better-sqlite3` Trilium Next started with version [8.4.0](https://github.com/WiseLibs/better-sqlite3/releases/tag/v8.4.0) for `better-sqlite3`
| | | | | | | | | |
| --- | --- | --- | --- | | --- | --- | --- | --- |
| `better-sqlite3` version | SQLite version | Node.js prebuilds | Electron.js prebuilds | | `better-sqlite3` version | SQLite version | Node.js prebuilds | Electron.js prebuilds |
| 8.4.0 | <3.43.0 | v20 | ??? | | 8.4.0 | <3.43.0 | v20 | ??? |
| 8.5.0 | v20 | v25 | | 8.5.0 | v20 | v25 | |
| 8.5.1 | | v26 | | 8.5.1 | | v26 | |
| 8.5.2 | v20 (macOS + arm64) | | 8.5.2 | v20 (macOS + arm64) | | |
| 8.6.0 | 3.43.0 | | | 8.6.0 | 3.43.0 | | |
| 8.7.0 | 3.43.1 | | | 8.7.0 | 3.43.1 | | |
| 9.0.0 | 3.43.2 | | v27 | | 9.0.0 | 3.43.2 | | v27 |
| 9.1.0 | 3.44.0 | | | 9.1.0 | 3.44.0 | | |
| 9.1.1 | macOS + Alpine | | 9.1.1 | macOS + Alpine | | |
| 9.2.0 | 3.44.2 | | | 9.2.0 | 3.44.2 | | |
| 9.2.1 / 9.2.2 | | v28 | | 9.2.1 / 9.2.2 | | v28 | |
| 9.3.0 | 3.45.0 | | | 9.3.0 | 3.45.0 | | |
| 9.4.0 | 3.45.1 | | | 9.4.0 | 3.45.1 | | |
| 9.4.1 | Windows arm, arm64 | | 9.4.1 | Windows arm, arm64 | | |
| 9.4.2 | | <v29 | | 9.4.2 | | <v29 | |
| 9.4.3 | | <v29 | | 9.4.3 | | <v29 | |
| 9.4.4 | | v29 | | 9.4.4 | | v29 | |
| 9.4.5 | Better prebuilds | | 9.4.5 | Better prebuilds | | |
| 9.5.0 | 3.45.2 | | | 9.5.0 | 3.45.2 | | |
| 9.6.0 | 3.45.3 | | v30 | | 9.6.0 | 3.45.3 | | v30 |
| 10.0.0 | v22 | | 10.0.0 | v22 | | |
| 10.1.0 | 3.46.0 | | | 10.1.0 | 3.46.0 | | |
| 11.0.0 | \>21 | | 11.0.0 | \>21 | | |
| 11.1.0 (prerelease) | | | v31 | | 11.1.0 (prerelease) | | | v31 |
| 11.1.1 | | | | 11.1.1 | | | |
| 11.1.2 | | | | 11.1.2 | | | |

2
docs/Developer Guide/Developer Guide/Old documentation/Sub-projects/CKEditor/Differences from upstream.md vendored
View File

@ -6,7 +6,7 @@
| Affected file | Affected method | Changed in | Reason for change | | Affected file | Affected method | Changed in | Reason for change |
| --- | --- | --- | --- | | --- | --- | --- | --- |
| `packages/ckeditor5-mention/src/mentionui.ts` | `createRegExp()` | `6db05043be24bacf9bd51ea46408232b01a1b232` (added back) | Allows triggering the autocomplete for labels and attributes in the attribute editor. | | `packages/ckeditor5-mention/src/mentionui.ts` | `createRegExp()` | `6db05043be24bacf9bd51ea46408232b01a1b232` (added back) | Allows triggering the autocomplete for labels and attributes in the attribute editor. |
| `init()` | `55a63a1934efb9a520fcc2d69f3ce55ac22aca39` | Allows dismissing @-mention permanently after pressing ESC, otherwise it would automatically show up as soon as a space was entered. | | `init()` | `55a63a1934efb9a520fcc2d69f3ce55ac22aca39` | Allows dismissing @-mention permanently after pressing ESC, otherwise it would automatically show up as soon as a space was entered. | |
## Checking the old repo ## Checking the old repo

2
docs/Developer Guide/Developer Guide/Old documentation/Sub-projects/CKEditor/Versions and external plugins.md vendored
View File

@ -2,7 +2,7 @@
## External plugins ## External plugins
| | | | | | | |
| --- | --- | --- | | --- | --- | --- |
| trilium-ckeditor5 | 43.2.0 | | | trilium-ckeditor5 | 43.2.0 | |
| `ckeditor5-math` | | See <a class="reference-link" href="../ckeditor5-math.md">ckeditor5-math</a>. | | `ckeditor5-math` | | See <a class="reference-link" href="../ckeditor5-math.md">ckeditor5-math</a>. |
| | | | | | | |

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

@ -7907,6 +7907,13 @@
"value": "bx bx-book", "value": "bx bx-book",
"isInheritable": false, "isInheritable": false,
"position": 20 "position": 20
},
{
"type": "relation",
"name": "internalLink",
"value": "CtBQqbwXDx1w",
"isInheritable": false,
"position": 120
} }
], ],
"format": "markdown", "format": "markdown",
@ -8118,19 +8125,19 @@
"isInheritable": false, "isInheritable": false,
"position": 70 "position": 70
}, },
{
"type": "label",
"name": "iconClass",
"value": "bx bx-map-alt",
"isInheritable": false,
"position": 10
},
{ {
"type": "relation", "type": "relation",
"name": "internalLink", "name": "internalLink",
"value": "BlN9DFI679QC", "value": "BlN9DFI679QC",
"isInheritable": false, "isInheritable": false,
"position": 80 "position": 80
},
{
"type": "label",
"name": "iconClass",
"value": "bx bx-map-alt",
"isInheritable": false,
"position": 10
} }
], ],
"format": "markdown", "format": "markdown",
@ -8499,6 +8506,50 @@
"dataFileName": "Table View_image.png" "dataFileName": "Table View_image.png"
} }
] ]
},
{
"isClone": false,
"noteId": "CtBQqbwXDx1w",
"notePath": [
"pOsGYCXsbNQG",
"KSZ04uQ2D1St",
"GTwFsgaA0lCt",
"CtBQqbwXDx1w"
],
"title": "Board View",
"notePosition": 60,
"prefix": null,
"isExpanded": false,
"type": "text",
"mime": "text/html",
"attributes": [
{
"type": "label",
"name": "iconClass",
"value": "bx bx-columns",
"isInheritable": false,
"position": 10
},
{
"type": "relation",
"name": "internalLink",
"value": "2FvYrpmOXm29",
"isInheritable": false,
"position": 20
}
],
"format": "markdown",
"dataFileName": "Board View.md",
"attachments": [
{
"attachmentId": "usSSa0WI6dDK",
"title": "image.png",
"role": "image",
"mime": "image/png",
"position": 10,
"dataFileName": "Board View_image.png"
}
]
} }
] ]
}, },

1
docs/User Guide/User Guide/Note Types/Collections.md vendored
View File

@ -11,6 +11,7 @@ More specialized collections were introduced, such as the:
* <a class="reference-link" href="Collections/Calendar%20View.md">Calendar View</a> which displays a week, month or year calendar with the notes being shown as events. New events can be added easily by dragging across the calendar. * <a class="reference-link" href="Collections/Calendar%20View.md">Calendar View</a> which displays a week, month or year calendar with the notes being shown as events. New events can be added easily by dragging across the calendar.
* <a class="reference-link" href="Collections/Geo%20Map%20View.md">Geo Map View</a> which displays a geographical map in which the notes are represented as markers/pins on the map. New events can be easily added by pointing on the map. * <a class="reference-link" href="Collections/Geo%20Map%20View.md">Geo Map View</a> which displays a geographical map in which the notes are represented as markers/pins on the map. New events can be easily added by pointing on the map.
* <a class="reference-link" href="Collections/Table%20View.md">Table View</a> displays each note as a row in a table, with <a class="reference-link" href="../Advanced%20Usage/Attributes/Promoted%20Attributes.md">Promoted Attributes</a> being shown as well. This makes it easy to visualize attributes of notes, as well as making them easily editable. * <a class="reference-link" href="Collections/Table%20View.md">Table View</a> displays each note as a row in a table, with <a class="reference-link" href="../Advanced%20Usage/Attributes/Promoted%20Attributes.md">Promoted Attributes</a> being shown as well. This makes it easy to visualize attributes of notes, as well as making them easily editable.
* <a class="reference-link" href="Collections/Board%20View.md">Board View</a> (Kanban) displays notes in columns, grouped by the value of a label.
For a quick presentation of all the supported view types, see the child notes of this help page, including screenshots. For a quick presentation of all the supported view types, see the child notes of this help page, including screenshots.

52
docs/User Guide/User Guide/Note Types/Collections/Board View.md vendored Normal file
View File

@ -0,0 +1,52 @@
# Board View
<figure class="image"><img style="aspect-ratio:918/248;" src="Board View_image.png" width="918" height="248"></figure>
The Board view presents sub-notes in columns for a Kanban-like experience. Each column represents a possible value for a status label, which can be adjusted.
## How it works
When first creating a collection of _Board_ type, a few subnotes will be created, each having a `#status` label set. The board then groups each note by the value of the status attribute.
Notes are displayed recursively, so even the child notes of the child notes will be displayed. However, unlike the <a class="reference-link" href="Table%20View.md">Table View</a>, the notes are not displayed in a hierarchy.
## Interaction with columns
* Create a new column by pressing _Add Column_ near the last column.
* Once pressed, a text box will be displayed to set the name of the column. Press Enter to confirm.
* To reorder a column, simply hold the mouse over the title and drag it to the desired position.
* To delete a column, right click on its title and select _Delete column_.
* To rename a column, click on the note title.
* Press Enter to confirm.
* Upon renaming a column, the corresponding status attribute of all its notes will be changed in bulk.
* If there are many columns, use the mouse wheel to scroll.
## Interaction with notes
* Create a new note in any column by pressing _New item_
* Enter the name of the note and press _Enter_.
* Doing so will create a new note. The new note will have an attribute (`status` label by default) set to the name of the column.
* To change the state of a note, simply drag a note from one column to the other to change its state.
* The order of the notes in each column corresponds to their position in the tree.
* It's possible to reorder notes simply by dragging them to the desired position within the same columns.
* It's also possible to drag notes across columns, at the desired position.
* For more options, right click on a note to display a context menu with the following options:
* Open the note in a new tab/split/window or quick edit.
* Move the note to any column.
* Insert a new note above/below the current one.
* 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.
## Configuration
### Grouping by another attribute
By default, the label used to group the notes is `#status`. It is possible to use a different label if needed by defining a label named `#board:groupBy` with the value being the attribute to use (without `#` attribute prefix).
> [!NOTE]
> It's currently not possible to set a relation as the grouping criteria. There are plans to add support for it.
## Interaction
## Limitations
* It is not possible yet to use group by a relation, only by label.

BIN
docs/User Guide/User Guide/Note Types/Collections/Board View_image.png vendored Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 18 KiB

3
docs/User Guide/User Guide/Note Types/Collections/Table View.md vendored
View File

@ -131,7 +131,8 @@ Limitations:
## Limitations ## Limitations
Multi-value labels and relations are not supported. If a <a class="reference-link" href="../../Advanced%20Usage/Attributes/Promoted%20Attributes.md">Promoted Attributes</a> is defined with a _Multi value_ specificity, they will be ignored. * Multi-value labels and relations are not supported. If a <a class="reference-link" href="../../Advanced%20Usage/Attributes/Promoted%20Attributes.md">Promoted Attributes</a> is defined with a _Multi value_ specificity, they will be ignored.
* There is no support to filter the rows by a certain criteria. Consider using the table view in search for that use case.
## Use in search ## Use in search