docs(views/geomap): update user manual to reflect newly added features

apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note List/Geo Map View.html

@@ -1,5 +1,11 @@
+<aside class="admonition important">
+  <p>Starting with Trilium v0.97.0, the geo map has been converted from a standalone
+    <a
+    href="#root/pOsGYCXsbNQG/_help_KSZ04uQ2D1St">note type</a>to a type of view for the&nbsp;<a class="reference-link"
+      href="#root/pOsGYCXsbNQG/gh7bpGYxajRS/BFs8mudNFgCS/_help_0ESUbbAxVnoK">Note List</a>.&nbsp;</p>
+</aside>
 <figure class="image image-style-align-center">
-  <img style="aspect-ratio:892/675;" src="10_Geo Map_image.png" width="892"
+  <img style="aspect-ratio:892/675;" src="9_Geo Map View_image.png" width="892"
   height="675">
 </figure>
 <p>This note type displays the children notes on a geographical map, based
@@ -19,9 +25,9 @@
       <tr>
         <td>1</td>
         <td>
-          <figure class="image image-style-align-center image_resized" style="width:51.25%;">
-            <img style="aspect-ratio:1256/1044;" src="7_Geo Map_image.png" width="1256"
-            height="1044">
+          <figure class="image">
+            <img style="aspect-ratio:483/413;" src="15_Geo Map View_image.png" width="483"
+            height="413">
           </figure>
         </td>
         <td>Right click on any note on the note tree and select <em>Insert child note</em> → <em>Geo Map (beta)</em>.</td>
@@ -30,7 +36,7 @@
         <td>2</td>
         <td>
           <figure class="image image-style-align-center image_resized" style="width:53.44%;">
-            <img style="aspect-ratio:1720/1396;" src="9_Geo Map_image.png" width="1720"
+            <img style="aspect-ratio:1720/1396;" src="8_Geo Map View_image.png" width="1720"
             height="1396">
           </figure>
         </td>
@@ -39,7 +45,6 @@
     </tbody>
   </table>
 </figure>
-
 <h2>Repositioning the map</h2>
 <ul>
   <li>Click and drag the map in order to move across the map.</li>
@@ -49,6 +54,7 @@
 <p>The position on the map and the zoom are saved inside the map note and
   restored when visiting again the note.</p>
 <h2>Adding a marker using the map</h2>
+<h3>Adding a new note using the plus button</h3>
 <figure class="table">
   <table>
     <thead>
@@ -63,18 +69,18 @@
         <td>1</td>
         <td>To create a marker, first navigate to the desired point on the map. Then
           press the
-          <img src="11_Geo Map_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;
           <br>
           <br>If the button is not visible, make sure the button section is visible
           by pressing the chevron button (
-          <img src="17_Geo Map_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>&nbsp;</td>
       </tr>
       <tr>
         <td>2</td>
         <td>
-          <img class="image_resized" style="aspect-ratio:1730/416;width:100%;" src="2_Geo Map_image.png"
+          <img class="image_resized" style="aspect-ratio:1730/416;width:100%;" src="2_Geo Map View_image.png"
           width="1730" height="416">
         </td>
         <td>Once pressed, the map will enter in the insert mode, as illustrated by
@@ -86,7 +92,7 @@
       <tr>
         <td>3</td>
         <td>
-          <img class="image_resized" style="aspect-ratio:1586/404;width:100%;" src="8_Geo Map_image.png"
+          <img class="image_resized" style="aspect-ratio:1586/404;width:100%;" src="7_Geo Map View_image.png"
           width="1586" height="404">
         </td>
         <td>Enter the name of the marker/note to be created.</td>
@@ -94,7 +100,7 @@
       <tr>
         <td>4</td>
         <td>
-          <img class="image_resized" style="aspect-ratio:1696/608;width:100%;" src="16_Geo Map_image.png"
+          <img class="image_resized" style="aspect-ratio:1696/608;width:100%;" src="16_Geo Map View_image.png"
           width="1696" height="608">
         </td>
         <td>Once confirmed, the marker will show up on the map and it will also be
@@ -103,11 +109,34 @@
     </tbody>
   </table>
 </figure>
-
+<h3>Adding a new note using the contextual menu</h3>
+<ol>
+  <li>Right click anywhere on the map, where to place the newly created marker
+    (and corresponding note).</li>
+  <li>Select <em>Add a marker at this location</em>.</li>
+  <li>Enter the name of the newly created note.</li>
+  <li>The map should be updated with the new marker.</li>
+</ol>
+<h3>Adding an existing note on note from the note tree</h3>
+<ol>
+  <li>Select the desired note in the&nbsp;<a class="reference-link" href="#root/pOsGYCXsbNQG/gh7bpGYxajRS/Vc8PjrjAGuOp/_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>The map should be updated with the new marker.</li>
+</ol>
+<p>This works for:</p>
+<ul>
+  <li>Notes that are not part of the geo map, case in which a <a href="#root/pOsGYCXsbNQG/gh7bpGYxajRS/BFs8mudNFgCS/_help_IakOLONlIfGI">clone</a> will
+    be created.</li>
+  <li>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
+    the marker will be relocated to the new position.</li>
+</ul>
 <h2>How the location of the markers is stored</h2>
 <p>The location of a marker is stored in the <code>#geolocation</code> attribute
   of the child notes:</p>
-<img src="18_Geo Map_image.png" width="1288" height="278">
+<p>
+  <img src="18_Geo Map View_image.png" width="1288" height="278">
+</p>
 <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>
 <h2>Repositioning markers</h2>
@@ -129,18 +158,40 @@
   <li>Middle-clicking the marker will open the note in a new tab.</li>
   <li>Right-clicking the marker will open a contextual menu allowing:
     <ul>
-      <li>Opening the note in a new tab, split or window.</li>
-      <li>Opening the location using an external application (if the operating system
-        supports it).</li>
-      <li>Removing 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
-        added back in.</li>
+      <li>&nbsp;</li>
     </ul>
   </li>
 </ul>
+<h2>Contextual menu</h2>
+<p>It's possible to press the right mouse button to display a contextual
+  menu.</p>
+<ol>
+  <li>If right-clicking an empty section of the map (not on a marker), it allows
+    to:
+    <ol>
+      <li>Displays the latitude and longitude. Clicking this option will copy them
+        to the clipboard.</li>
+      <li>Open the location using an external application (if the operating system
+        supports it).</li>
+      <li>Adding a new marker at that location.</li>
+    </ol>
+  </li>
+  <li>If right-clicking on a marker, it allows to:
+    <ol>
+      <li>Displays the latitude and longitude. Clicking this option will copy them
+        to the clipboard.</li>
+      <li>Open the location using an external application (if the operating system
+        supports it).</li>
+      <li>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
+        of the note. To add it back again, the coordinates have to be manually
+        added back in.</li>
+    </ol>
+  </li>
+</ol>
 <h2>Icon and color of the markers</h2>
 <figure class="image image-style-align-center">
-  <img style="aspect-ratio:523/295;" src="Geo Map_image.jpg" alt="image"
+  <img style="aspect-ratio:523/295;" src="Geo Map View_image.jpg" alt="image"
   width="523" height="295">
 </figure>
 <p>The markers will have the same icon as the note.</p>
@@ -171,7 +222,7 @@
         <td>1</td>
         <td>
           <figure class="image image-style-align-center image_resized" style="width:56.84%;">
-            <img style="aspect-ratio:732/918;" src="13_Geo Map_image.png" width="732"
+            <img style="aspect-ratio:732/918;" src="12_Geo Map View_image.png" width="732"
             height="918">
           </figure>
         </td>
@@ -188,7 +239,7 @@
         <td>2</td>
         <td>
           <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"
+            <img style="aspect-ratio:518/84;" src="4_Geo Map View_image.png" width="518"
             height="84">
           </figure>
         </td>
@@ -198,7 +249,7 @@
         <td>3</td>
         <td>
           <figure class="image image-style-align-center image_resized" style="width:100%;">
-            <img style="aspect-ratio:1074/276;" src="12_Geo Map_image.png" width="1074"
+            <img style="aspect-ratio:1074/276;" src="11_Geo Map View_image.png" width="1074"
             height="276">
           </figure>
         </td>
@@ -210,7 +261,6 @@
     </tbody>
   </table>
 </figure>
-
 <h3>Adding from OpenStreetMap</h3>
 <p>Similarly to the Google Maps approach:</p>
 <figure class="table" style="width:100%;">
@@ -231,7 +281,7 @@
       <tr>
         <td>1</td>
         <td>
-          <img class="image_resized" style="aspect-ratio:562/454;width:100%;" src="1_Geo Map_image.png"
+          <img class="image_resized" style="aspect-ratio:562/454;width:100%;" src="1_Geo Map View_image.png"
           width="562" height="454">
         </td>
         <td>Go to any location on openstreetmap.org and right click to bring up the
@@ -240,7 +290,7 @@
       <tr>
         <td>2</td>
         <td>
-          <img class="image_resized" style="aspect-ratio:696/480;width:100%;" src="Geo Map_image.png"
+          <img class="image_resized" style="aspect-ratio:696/480;width:100%;" src="Geo Map View_image.png"
           width="696" height="480">
         </td>
         <td>The address will be visible in the top-left of the screen, in the place
@@ -251,7 +301,7 @@
       <tr>
         <td>3</td>
         <td>
-          <img class="image_resized" style="aspect-ratio:640/276;width:100%;" src="5_Geo Map_image.png"
+          <img class="image_resized" style="aspect-ratio:640/276;width:100%;" src="5_Geo Map View_image.png"
           width="640" height="276">
         </td>
         <td>Simply paste the value inside the text box into the <code>#geolocation</code> attribute
@@ -260,7 +310,6 @@
     </tbody>
   </table>
 </figure>
-
 <h2>Adding GPS tracks (.gpx)</h2>
 <p>Trilium has basic support for displaying GPS tracks on the geo map.</p>
 <figure
@@ -283,7 +332,7 @@ class="table" style="width:100%;">
         <td>1</td>
         <td>
           <figure class="image image-style-align-center">
-            <img style="aspect-ratio:226/74;" src="3_Geo Map_image.png" width="226"
+            <img style="aspect-ratio:226/74;" src="3_Geo Map View_image.png" width="226"
             height="74">
           </figure>
         </td>
@@ -294,7 +343,7 @@ class="table" style="width:100%;">
         <td>2</td>
         <td>
           <figure class="image image-style-align-center">
-            <img style="aspect-ratio:322/222;" src="15_Geo Map_image.png" width="322"
+            <img style="aspect-ratio:322/222;" src="14_Geo Map View_image.png" width="322"
             height="222">
           </figure>
         </td>
@@ -305,7 +354,7 @@ class="table" style="width:100%;">
         <td>3</td>
         <td>
           <figure class="image image-style-align-center">
-            <img style="aspect-ratio:620/530;" src="6_Geo Map_image.png" width="620"
+            <img style="aspect-ratio:620/530;" src="6_Geo Map View_image.png" width="620"
             height="530">
           </figure>
         </td>
@@ -324,13 +373,23 @@ class="table" style="width:100%;">
     <p>If the GPX contains waypoints, they will also be displayed. If they have
       a name, it is displayed when hovering over it with the mouse.</p>
   </aside>
+  <h2>Read-only mode</h2>
+  <p>When a map is in read-only all editing features will be disabled such
+    as:</p>
+  <ul>
+    <li>The add button in the&nbsp;<a class="reference-link" href="#root/pOsGYCXsbNQG/gh7bpGYxajRS/Vc8PjrjAGuOp/_help_XpOYSgsLkTJy">Floating buttons</a>.</li>
+    <li>Dragging markers.</li>
+    <li>Editing from the contextual menu (removing locations or adding new items).</li>
+  </ul>
+  <p>To enable read-only mode simply press the <em>Lock</em> icon from the&nbsp;
+    <a
+    class="reference-link" href="#root/pOsGYCXsbNQG/gh7bpGYxajRS/Vc8PjrjAGuOp/_help_XpOYSgsLkTJy">Floating buttons</a>. To disable it, press the button again.</p>
   <h2>Troubleshooting</h2>
   <figure class="image image-style-align-right image_resized" style="width:34.06%;">
-    <img style="aspect-ratio:678/499;" src="14_Geo Map_image.png" width="678"
+    <img style="aspect-ratio:678/499;" src="13_Geo Map View_image.png" width="678"
     height="499">
   </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
     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

apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note List/Table View.html

@@ -1,25 +1,25 @@
 <figure class="image">
-  <img style="aspect-ratio:1050/259;" src="Table_image.png" width="1050"
+  <img style="aspect-ratio:1050/259;" src="Table View_image.png" width="1050"
   height="259">
 </figure>
 <p>The table view displays information in a grid, where the rows are individual
-  notes and the columns are&nbsp;<a class="reference-link" href="#root/pOsGYCXsbNQG/tC7s2alapj8V/zEY4DaJG4YT5/_help_OFXdgB2nNk1F">Promoted Attributes</a>.
+  notes and the columns are&nbsp;<a class="reference-link" href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>.
   In addition, values are editable.</p>
 <h2>Interaction</h2>
 <h3>Creating a new table</h3>
-<p>Right click the&nbsp;<a class="reference-link" href="#root/pOsGYCXsbNQG/gh7bpGYxajRS/Vc8PjrjAGuOp/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;and
+<p>Right click the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;and
   select <em>Insert child note</em> and look for the <em>Table item</em>.</p>
 <h3>Adding columns</h3>
-<p>Each column is a <a href="#root/pOsGYCXsbNQG/tC7s2alapj8V/zEY4DaJG4YT5/_help_OFXdgB2nNk1F">promoted attribute</a> that
+<p>Each column is a <a href="#root/_help_OFXdgB2nNk1F">promoted attribute</a> that
   is defined on the Book note. Ideally, the promoted attributes need to be
   inheritable in order to show up in the child notes.</p>
-<p>To create a new column, simply press <em>Add new column </em>at the bottom
+<p>To create a new column, simply press <em>Add new column</em> at the bottom
   of the table.</p>
 <p>There are also a few predefined columns:</p>
 <ul>
   <li>The current item number, identified by the <code>#</code> symbol. This simply
     counts the note and is affected by sorting.</li>
-  <li><a class="reference-link" href="#root/pOsGYCXsbNQG/tC7s2alapj8V/_help_m1lbrzyKDaRB">Note ID</a>,
+  <li><a class="reference-link" href="#root/_help_m1lbrzyKDaRB">Note ID</a>,
     representing the unique ID used internally by Trilium</li>
   <li>The title of the note.</li>
 </ul>
@@ -28,9 +28,7 @@
 <p>To create a new note, press <em>Add new row</em> at the bottom of the table.
   By default it will try to edit the title of the newly created note.</p>
 <p>Alternatively, the note can be created from the<a class="reference-link"
-  href="#root/pOsGYCXsbNQG/gh7bpGYxajRS/Vc8PjrjAGuOp/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;or
-  <a
-  href="#root/pOsGYCXsbNQG/_help_CdNpE2pqjmI6">scripting</a>.</p>
+  href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;or <a href="#root/_help_CdNpE2pqjmI6">scripting</a>.</p>
 <h3>Editing data</h3>
 <p>Simply click on a cell within a row to change its value. The change will
   not only reflect in the table, but also as an attribute of the corresponding
@@ -58,7 +56,7 @@
 </ul>
 <h3>Reordering rows</h3>
 <p>Notes can be dragged around to change their order. This will also change
-  the order of the note in the&nbsp;<a class="reference-link" href="#root/pOsGYCXsbNQG/gh7bpGYxajRS/Vc8PjrjAGuOp/_help_oPVyFC7WL2Lp">Note Tree</a>.</p>
+  the order of the note in the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>.</p>
 <p>Currently, it's possible to reorder notes even if sorting is used, but
   the result might be inconsistent.</p>
 <h2>Limitations</h2>
@@ -67,7 +65,7 @@
 <ol>
   <li>As mentioned previously, the columns of the table are defined as&nbsp;
     <a
-    class="reference-link" href="#root/pOsGYCXsbNQG/tC7s2alapj8V/zEY4DaJG4YT5/_help_OFXdgB2nNk1F">Promoted Attributes</a>.
+    class="reference-link" href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>.
       <ol>
         <li>But only the promoted attributes that are defined at the level of the
           Book note are actually taken into consideration.</li>
@@ -77,22 +75,23 @@
   <li>Hierarchy is not yet supported, so the table will only show the items
     that are direct children of the <em>Book</em> note.</li>
   <li>Multiple labels and relations are not supported. If a&nbsp;<a class="reference-link"
-    href="#root/pOsGYCXsbNQG/tC7s2alapj8V/zEY4DaJG4YT5/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;is
-    defined with a <em>Multi value</em> specificity, they will be ignored.</li>
+    href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;is defined
+    with a <em>Multi value</em> specificity, they will be ignored.</li>
 </ol>
 <h2>Use in search</h2>
-<p>The table view can be used in a&nbsp;<a class="reference-link" href="#root/pOsGYCXsbNQG/KSZ04uQ2D1St/_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>
 <p>Unlike when used in a book, saved searches are not limited to the sub-hierarchy
   of a note and allows for advanced queries thanks to the power of the&nbsp;
   <a
-  class="reference-link" href="#root/pOsGYCXsbNQG/gh7bpGYxajRS/wArbEsdSae6g/_help_eIg8jdvaoNNd">Search</a>.</p>
+  class="reference-link" href="#root/_help_eIg8jdvaoNNd">Search</a>.</p>
 <p>However, there are also some limitations:</p>
 <ul>
   <li>It's not possible to reorder notes.</li>
   <li>It's not possible to add a new row.</li>
 </ul>
 <p>Columns are supported, by being defined as&nbsp;<a class="reference-link"
-  href="#root/pOsGYCXsbNQG/tC7s2alapj8V/zEY4DaJG4YT5/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;to
-  the&nbsp;<a class="reference-link" href="#root/pOsGYCXsbNQG/KSZ04uQ2D1St/_help_m523cpzocqaD">Saved Search</a>&nbsp;note.</p>
+  href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;to the&nbsp;
+  <a
+  class="reference-link" href="#root/_help_m523cpzocqaD">Saved Search</a>&nbsp;note.</p>
 <p>Editing is also supported.</p>

apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Read-Only Notes.html

@@ -54,4 +54,7 @@
     hide the Mermaid source code and display the diagram preview in full-size.
     In this case, the read-only mode can be easily toggled on or off via a
     dedicated button in the&nbsp;<a class="reference-link" href="#root/_help_XpOYSgsLkTJy">Floating buttons</a>&nbsp;area.</li>
+  <li><a class="reference-link" href="#root/pOsGYCXsbNQG/gh7bpGYxajRS/BFs8mudNFgCS/0ESUbbAxVnoK/_help_81SGnPGMk7Xc">Geo Map View</a>&nbsp;will
+    disallow all interaction that would otherwise change the map (dragging
+    notes, adding new items).</li>
 </ul>