fix(docs): missing image in geomap

This commit is contained in:
Elian Doran 2025-04-03 20:53:54 +03:00
parent 0b82489ea0
commit 38ed8b6592
No known key found for this signature in database
4 changed files with 222 additions and 213 deletions

View File

@ -17,8 +17,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 ![](15_Geo%20map_image.png)button on the top-right of the map.  <br> <br>If the button is not visible, make sure the button section is visible by pressing the chevron button ( ![](2_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 ![](15_Geo%20map_image.png)button on the top-right of the map.   <br> <br>If the button is not visible, make sure the button section is visible by pressing the chevron button ( ![](2_Geo%20map_image.png)) in the top-right of the map. |
| 2 | ![](3_Geo%20map_image.png) | 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 | ![](3_Geo%20map_image.png) | 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 | ![](9_Geo%20map_image.png) | Enter the name of the marker/note to be created. | | 3 | ![](9_Geo%20map_image.png) | Enter the name of the marker/note to be created. |
| 4 | ![](16_Geo%20map_image.png) | Once confirmed, the marker will show up on the map and it will also be displayed as a child note of the map. | | 4 | ![](16_Geo%20map_image.png) | Once confirmed, the marker will show up on the map and it will also be displayed as a child note of the map. |
@ -50,7 +50,7 @@ If moved by mistake, there is currently no way to undo the change. If the mouse
## Icon and color of the markers ## Icon and color of the markers
!\[image\](8\_Geo map\_image.png) ![image](Geo%20map_image.jpg)
The markers will have the same icon as the note. The markers will have the same icon as the note.
@ -66,7 +66,7 @@ The value of the attribute is made up of the latitude and longitude separated by
| | | | | | | |
| --- | --- | --- | | --- | --- | --- |
| 1 | ![](12_Geo%20map_image.png) | 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 | ![](12_Geo%20map_image.png) | 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 | ![](5_Geo%20map_image.png) | In Trilium, create a child note under the map. | | 2 | ![](5_Geo%20map_image.png) | In Trilium, create a child note under the map. |
| 3 | ![](11_Geo%20map_image.png) | 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 | ![](11_Geo%20map_image.png) | 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. |
@ -77,7 +77,7 @@ Similarly to the Google Maps approach:
| | | | | | | |
| --- | --- | --- | | --- | --- | --- |
| 1 | ![](1_Geo%20map_image.png) | Go to any location on openstreetmap.org and right click to bring up the context menu. Select the “Show address” item. | | 1 | ![](1_Geo%20map_image.png) | Go to any location on openstreetmap.org and right click to bring up the context menu. Select the “Show address” item. |
| 2 | ![](Geo%20map_image.png) | 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 | ![](Geo%20map_image.png) | 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 | ![](6_Geo%20map_image.png) | 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 | ![](6_Geo%20map_image.png) | 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)
@ -88,7 +88,7 @@ Trilium has basic support for displaying GPS tracks on the geo map.
| --- | --- | --- | | --- | --- | --- |
| 1 | ![](4_Geo%20map_image.png) | To add a track, simply drag & drop a .gpx file inside the geo map in the note tree. | | 1 | ![](4_Geo%20map_image.png) | To add a track, simply drag & drop a .gpx file inside the geo map in the note tree. |
| 2 | ![](14_Geo%20map_image.png) | 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 | ![](14_Geo%20map_image.png) | 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 | ![](7_Geo%20map_image.png) | 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 | ![](7_Geo%20map_image.png) | 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. |
## Troubleshooting ## Troubleshooting

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB

View File

@ -14,33 +14,34 @@
<div class="ck-content"> <div class="ck-content">
<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>
<img src="8_Geo map_image.png"> <td>
</td> <img src="8_Geo map_image.png">
<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>
<img src="10_Geo map_image.png"> <td>
</td> <img src="10_Geo map_image.png">
<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>
<h2>Repositioning the map</h2> </figure>
<h2>Repositioning the map</h2>
<ul> <ul>
<li>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>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
@ -49,56 +50,57 @@
<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>
<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> <td>1</td>
<td>To create a marker, first navigate to the desired point on the map. Then <td>&nbsp;</td>
press the <td>To create a marker, first navigate to the desired point on the map. Then
<img src="15_Geo map_image.png">button on the top-right of the map.&nbsp; press the
<br> <img src="15_Geo map_image.png">button on the top-right of the map.&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="2_Geo map_image.png">) in the top-right of the map.</td> by pressing the chevron button (
</tr> <img src="2_Geo map_image.png">) in the top-right of the map.</td>
<tr> </tr>
<td>2</td> <tr>
<td> <td>2</td>
<img src="3_Geo map_image.png"> <td>
</td> <img src="3_Geo map_image.png">
<td>Once pressed, the map will enter in the insert mode, as illustrated by </td>
the notification.&nbsp; <td>Once pressed, the map will enter in the insert mode, as illustrated by
<br> the notification.&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 src="9_Geo map_image.png"> <td>
</td> <img src="9_Geo map_image.png">
<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 src="16_Geo map_image.png"> <td>
</td> <img src="16_Geo map_image.png">
<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>
<h2>How the location of the markers is stored</h2> </figure>
<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> <p>
@ -135,7 +137,10 @@
</li> </li>
</ul> </ul>
<h2>Icon and color of the markers</h2> <h2>Icon and color of the markers</h2>
<p>![image](8_Geo map_image.png)</p> <figure class="image image-style-align-center">
<img style="aspect-ratio:523/295;" src="Geo map_image.jpg" alt="image"
width="523" height="295">
</figure>
<p>The markers will have the same icon as the note.</p> <p>The markers will have the same icon as the note.</p>
<p>It's possible to add a custom color to a marker by assigning them a <code>#color</code> attribute <p>It's possible to add a custom color to a marker by assigning them a <code>#color</code> attribute
such as <code>#color=green</code>.</p> such as <code>#color=green</code>.</p>
@ -145,137 +150,141 @@
<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>
<img src="12_Geo map_image.png"> <td>
</td> <img src="12_Geo map_image.png">
<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; <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;
<br>Simply click on the first item displaying the coordinates and they will <br>
be copied to clipboard.&nbsp; <br>Simply click on the first item displaying the coordinates and they will
<br> be copied to clipboard.&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>
<img src="5_Geo map_image.png"> <td>
</td> <img src="5_Geo map_image.png">
<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>
<img src="11_Geo map_image.png"> <td>
</td> <img src="11_Geo map_image.png">
<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>
<h3>Adding from OpenStreetMap</h3> </figure>
<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 src="1_Geo map_image.png"> <td>
</td> <img src="1_Geo map_image.png">
<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 src="Geo map_image.png"> <td>
</td> <img src="Geo map_image.png">
<td>The address will be visible in the top-left of the screen, in the place </td>
of the search bar.&nbsp; <td>The address will be visible in the top-left of the screen, in the place
<br> of the search bar.&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 src="6_Geo map_image.png"> <td>
</td> <img src="6_Geo map_image.png">
<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>
<h2>Adding GPS tracks (.gpx)</h2> </figure>
<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>
<img src="4_Geo map_image.png"> <td>1</td>
</td> <td>
<td>To add a track, simply drag &amp; drop a .gpx file inside the geo map <img src="4_Geo map_image.png">
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>
<img src="14_Geo map_image.png"> <td>2</td>
</td> <td>
<td>In order for the file to be recognized as a GPS track, it needs to show <img src="14_Geo map_image.png">
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>
<img src="7_Geo map_image.png"> <td>3</td>
</td> <td>
<td>When going back to the map, the track should now be visible.&nbsp; <img src="7_Geo map_image.png">
<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;
</tr> <br>
</tbody> <br>The start and end points of the track are indicated by the two blue markers.</td>
</table> </tr>
</tbody>
<h2>Troubleshooting</h2> </table>
<p> </figure>
<img src="13_Geo map_image.png"> <h2>Troubleshooting</h2>
</p> <p>
<h3>Grid-like artifacts on the map</h3> <img src="13_Geo map_image.png">
<p>This occurs if the application is not at 100% zoom which causes the pixels </p>
of the map to not render correctly due to fractional scaling. The only <h3>Grid-like artifacts on the map</h3>
possible solution is to set the UI zoom at 100% (default keyboard shortcut <p>This occurs if the application is not at 100% zoom which causes the pixels
is <kbd>Ctrl</kbd>+<kbd>0</kbd>).</p> 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
is <kbd>Ctrl</kbd>+<kbd>0</kbd>).</p>
</div> </div>
</div> </div>
</body> </body>

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB