From 68d094d11986215bcf25fa9efa182d507a123a24 Mon Sep 17 00:00:00 2001 From: Elian Doran Date: Sun, 1 Jun 2025 15:52:03 +0300 Subject: [PATCH] docs(guide): mention geo map updates --- .../User Guide/Note Types/Geo Map.html | 32 +++++++++++-------- docs/Release Notes/Release Notes/v0.94.0.md | 3 ++ .../User Guide/Note Types/Geo Map.md | 9 ++++-- 3 files changed, 28 insertions(+), 16 deletions(-) diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Geo Map.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Geo Map.html index 4a5860659..674422cad 100644 --- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Geo Map.html +++ b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Geo Map.html @@ -19,7 +19,7 @@ 1 -
+
@@ -29,7 +29,7 @@ 2 -
+
@@ -39,7 +39,6 @@
-

Repositioning the map

-

How the location of the markers is stored

The location of a marker is stored in the #geolocation attribute of the child notes:

- +

+ +

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.

Repositioning markers

@@ -170,7 +170,7 @@ 1 -
+
@@ -187,7 +187,7 @@ 2 -
+
@@ -197,7 +197,7 @@ 3 -
+
@@ -210,7 +210,6 @@
-

Adding from OpenStreetMap

Similarly to the Google Maps approach:

@@ -260,7 +259,6 @@
-

Adding GPS tracks (.gpx)

Trilium has basic support for displaying GPS tracks on the geo map.

- -

Troubleshooting

+ +

Troubleshooting

- -

Grid-like artifacts on the map

+

Grid-like artifacts on the map

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 diff --git a/docs/Release Notes/Release Notes/v0.94.0.md b/docs/Release Notes/Release Notes/v0.94.0.md index ebefb5954..81e86b293 100644 --- a/docs/Release Notes/Release Notes/v0.94.0.md +++ b/docs/Release Notes/Release Notes/v0.94.0.md @@ -62,6 +62,9 @@ * [improve tab scroll UX by switching from instant to smooth behavior](https://github.com/TriliumNext/Notes/pull/2030) by @SiriusXT * Calendar view: display calendar view if `#viewType=calendar` is set. * [Mind map: add search support](https://github.com/TriliumNext/Notes/pull/2055) by @SiriusXT +* Geo map: + * The name, icon and color of the track note are displayed as the starting point. + * Added a distinct icon for the end marker. ## 📖 Documentation diff --git a/docs/User Guide/User Guide/Note Types/Geo Map.md b/docs/User Guide/User Guide/Note Types/Geo Map.md index 718cca506..78237cad3 100644 --- a/docs/User Guide/User Guide/Note Types/Geo Map.md +++ b/docs/User Guide/User Guide/Note Types/Geo Map.md @@ -5,7 +5,7 @@ This note type displays the children notes on a geographical map, based on an at ## Creating a new geo map -

   
1
Right click on any note on the note tree and select Insert child note → Geo Map (beta).
2
By default the map will be empty and will show the entire world.
+
   
1
Right click on any note on the note tree and select Insert child note → Geo Map (beta).
2
By default the map will be empty and will show the entire world.
## Repositioning the map @@ -60,7 +60,7 @@ The value of the attribute is made up of the latitude and longitude separated by ### Adding from Google Maps -
   
1
Go to Google Maps on the web and look for a desired location, right click on it and a context menu will show up.    

Simply click on the first item displaying the coordinates and they will be copied to clipboard.    

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
In Trilium, create a child note under the map.
3
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.
+
   
1
Go to Google Maps on the web and look for a desired location, right click on it and a context menu will show up.    

Simply click on the first item displaying the coordinates and they will be copied to clipboard.    

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
In Trilium, create a child note under the map.
3
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.
### Adding from OpenStreetMap @@ -74,6 +74,11 @@ Trilium has basic support for displaying GPS tracks on the geo map.
   
1
To add a track, simply drag & drop a .gpx file inside the geo map in the note tree.
2
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
When going back to the map, the track should now be visible.    

The start and end points of the track are indicated by the two blue markers.
+> [!NOTE] +> The starting point of the track will be displayed as a marker, with the name of the note underneath. The start marker will also respect the icon and the `color` of the note. The end marker is displayed with a distinct icon. +> +> 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. + ## Troubleshooting