diff --git a/docs/User Guide/!!!meta.json b/docs/User Guide/!!!meta.json index b46f05990..c565494c5 100644 --- a/docs/User Guide/!!!meta.json +++ b/docs/User Guide/!!!meta.json @@ -2432,20 +2432,6 @@ "isInheritable": false, "position": 10 }, - { - "type": "relation", - "name": "internalLink", - "value": "iPIMuisry3hd", - "isInheritable": false, - "position": 20 - }, - { - "type": "relation", - "name": "internalLink", - "value": "6f9hih2hXXZk", - "isInheritable": false, - "position": 30 - }, { "type": "label", "name": "shareAlias", @@ -2459,11 +2445,55 @@ "value": "bx bx-edit-alt", "isInheritable": false, "position": 40 + }, + { + "type": "relation", + "name": "internalLink", + "value": "iPIMuisry3hd", + "isInheritable": false, + "position": 50 + }, + { + "type": "relation", + "name": "internalLink", + "value": "6f9hih2hXXZk", + "isInheritable": false, + "position": 60 + }, + { + "type": "relation", + "name": "internalLink", + "value": "BlN9DFI679QC", + "isInheritable": false, + "position": 70 + }, + { + "type": "relation", + "name": "internalLink", + "value": "XpOYSgsLkTJy", + "isInheritable": false, + "position": 80 + }, + { + "type": "relation", + "name": "internalLink", + "value": "4TIF1oA4VQRO", + "isInheritable": false, + "position": 100 } ], "format": "markdown", "dataFileName": "Read-Only Notes.md", - "attachments": [] + "attachments": [ + { + "attachmentId": "dUmc6vYfoQgZ", + "title": "image.png", + "role": "image", + "mime": "image/png", + "position": 10, + "dataFileName": "Read-Only Notes_image.png" + } + ] } ] }, @@ -3718,13 +3748,6 @@ "isInheritable": false, "position": 20 }, - { - "type": "relation", - "name": "internalLink", - "value": "zEY4DaJG4YT5", - "isInheritable": false, - "position": 30 - }, { "type": "relation", "name": "internalLink", @@ -5480,7 +5503,7 @@ "dataFileName": "1_Geo Map_image.png" }, { - "attachmentId": "6wUkw5RWE39e", + "attachmentId": "aCSNn9QlgHFi", "title": "image.png", "role": "image", "mime": "image/png", @@ -5488,7 +5511,7 @@ "dataFileName": "2_Geo Map_image.png" }, { - "attachmentId": "aCSNn9QlgHFi", + "attachmentId": "aCuXZY7WV4li", "title": "image.png", "role": "image", "mime": "image/png", @@ -5496,7 +5519,7 @@ "dataFileName": "3_Geo Map_image.png" }, { - "attachmentId": "aCuXZY7WV4li", + "attachmentId": "agH6yREFgsoU", "title": "image.png", "role": "image", "mime": "image/png", @@ -5504,7 +5527,7 @@ "dataFileName": "4_Geo Map_image.png" }, { - "attachmentId": "agH6yREFgsoU", + "attachmentId": "AHyDUM6R5HeG", "title": "image.png", "role": "image", "mime": "image/png", @@ -5512,7 +5535,7 @@ "dataFileName": "5_Geo Map_image.png" }, { - "attachmentId": "AHyDUM6R5HeG", + "attachmentId": "CcjWLhE3KKfv", "title": "image.png", "role": "image", "mime": "image/png", @@ -5520,7 +5543,7 @@ "dataFileName": "6_Geo Map_image.png" }, { - "attachmentId": "CcjWLhE3KKfv", + "attachmentId": "DapDey8gMiFc", "title": "image.png", "role": "image", "mime": "image/png", @@ -5528,7 +5551,7 @@ "dataFileName": "7_Geo Map_image.png" }, { - "attachmentId": "DapDey8gMiFc", + "attachmentId": "fQy8R1vxKhwN", "title": "image.png", "role": "image", "mime": "image/png", @@ -5536,28 +5559,20 @@ "dataFileName": "8_Geo Map_image.png" }, { - "attachmentId": "fQy8R1vxKhwN", + "attachmentId": "gJ4Yz80jxcbn", "title": "image.png", "role": "image", "mime": "image/png", "position": 10, "dataFileName": "9_Geo Map_image.png" }, - { - "attachmentId": "gJ4Yz80jxcbn", - "title": "image.png", - "role": "image", - "mime": "image/png", - "position": 10, - "dataFileName": "10_Geo Map_image.png" - }, { "attachmentId": "I39BinT2gsN9", "title": "image.png", "role": "image", "mime": "image/png", "position": 10, - "dataFileName": "11_Geo Map_image.png" + "dataFileName": "10_Geo Map_image.png" }, { "attachmentId": "IeXU8SLZU7Oz", @@ -5573,7 +5588,7 @@ "role": "image", "mime": "image/png", "position": 10, - "dataFileName": "12_Geo Map_image.png" + "dataFileName": "11_Geo Map_image.png" }, { "attachmentId": "Mx2xwNIk76ZS", @@ -5581,7 +5596,7 @@ "role": "image", "mime": "image/png", "position": 10, - "dataFileName": "13_Geo Map_image.png" + "dataFileName": "12_Geo Map_image.png" }, { "attachmentId": "oaahbsMRbqd2", @@ -5589,7 +5604,7 @@ "role": "image", "mime": "image/png", "position": 10, - "dataFileName": "14_Geo Map_image.png" + "dataFileName": "13_Geo Map_image.png" }, { "attachmentId": "pGf1p74KKGU4", @@ -5597,7 +5612,7 @@ "role": "image", "mime": "image/jpg", "position": 10, - "dataFileName": "15_Geo Map_image.png" + "dataFileName": "14_Geo Map_image.png" }, { "attachmentId": "tfa1TRUatWEh", @@ -5605,15 +5620,7 @@ "role": "image", "mime": "image/png", "position": 10, - "dataFileName": "16_Geo Map_image.png" - }, - { - "attachmentId": "USbvJ38T4AKA", - "title": "image.png", - "role": "image", - "mime": "image/png", - "position": 10, - "dataFileName": "17_Geo Map_image.png" + "dataFileName": "15_Geo Map_image.png" }, { "attachmentId": "x6yBLIsY2LSv", @@ -5621,7 +5628,7 @@ "role": "image", "mime": "image/png", "position": 10, - "dataFileName": "18_Geo Map_image.png" + "dataFileName": "16_Geo Map_image.png" }, { "attachmentId": "yJMyBRYA3Kwi", @@ -5629,7 +5636,7 @@ "role": "image", "mime": "image/png", "position": 10, - "dataFileName": "19_Geo Map_image.png" + "dataFileName": "17_Geo Map_image.png" }, { "attachmentId": "ZvTlu9WMd37z", @@ -5637,7 +5644,7 @@ "role": "image", "mime": "image/png", "position": 10, - "dataFileName": "20_Geo Map_image.png" + "dataFileName": "18_Geo Map_image.png" } ] } diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/Notes/Read-Only Notes.md b/docs/User Guide/User Guide/Basic Concepts and Features/Notes/Read-Only Notes.md index 60491d724..87c55d5d8 100644 --- a/docs/User Guide/User Guide/Basic Concepts and Features/Notes/Read-Only Notes.md +++ b/docs/User Guide/User Guide/Basic Concepts and Features/Notes/Read-Only Notes.md @@ -1,12 +1,44 @@ # Read-Only Notes -Both [text](../../Note%20Types/Text.md) and [code](../../Note%20Types/Code.md) notes in Trilium can be set to read-only. When a note is in read-only mode, it is presented to the user in a non-editable view, with the option to switch to editing mode if needed. +Some note types such as [Text](../../Note%20Types/Text.md) and [Code](../../Note%20Types/Code.md) notes in Trilium can be set to read-only. When a note is in read-only mode, it is presented to the user in a non-editable view, with the option to switch to editing mode if needed. -## Setting Read-Only Mode with a Label - -To set a note as read-only, add the `readOnly` [label](../../Advanced%20Usage/Attributes.md) to the note. - -## Automatic Read-Only Mode +## Automatic read-only mode For optimization purposes, Trilium will automatically set very large notes to read-only. Displaying such lengthy notes in editing mode can slow down performance, especially when editing is unnecessary. -If you want to ensure that a specific note remains editable regardless of its size, you can add the `autoReadOnlyDisabled` [label](../../Advanced%20Usage/Attributes.md) to the note. \ No newline at end of file +This behavior can be disabled on a per-note basis, by following the instructions of the next section. + +In addition, it's possible to change the number of characters at which the automatic read-only mode will trigger in [Options](../UI%20Elements/Options.md) by going to the options for [Text](../../Note%20Types/Text.md) and [Code](../../Note%20Types/Code.md) notes. + +## Changing a note's read-only behavior + +Via the [Ribbon](../UI%20Elements/Ribbon.md), by going to the _Basic Properties_ tab and looking for the _Editable_ selection. The following options are possible: + +* **Auto** + This is the default behavior in which the note will be editable by default, unless it becomes large enough to trigger read-only mode. + +* **Read-only** + The note will be always marked as read-only, regardless of its size. Nevertheless, it's still possible to temporarily edit the note if needed. This is generally useful for notes that are not prone to change. + +* **Always Editable** + This option will bypass the automatic read-only activation for this particular note. It's useful for large notes that are frequently edited. + +If the _Editable_ section is missing from the ribbon, then the note type does not support read-only mode. + +### Manually setting the options + +Apart from using the ribbon as previously mentioned, it's also possible to use [labels](../../Advanced%20Usage/Attributes.md) to change the behavior: + +* To set as read-only, apply the `readOnly` label to the note. +* To disable automatic read-only (always editable), apply the `autoReadOnlyDisabled` label. + +## Temporarily editing a read-only note + +When accessing a read-only note, it's possible to temporarily edit it by using the ![](Read-Only%20Notes_image.png) button in the [Floating buttons](../UI%20Elements/Floating%20buttons.md) area. + +When pressed, the note will become editable but will become read-only again after navigating to a different note. + +## Special read-only behavior + +Some note types have a special behavior based on whether the read-only mode is enabled: + +* [Mermaid Diagrams](#root/rswjxUmAz64R/aOI0RYfC3wic/ObWG9tSNscDb) will 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 [Floating buttons](../UI%20Elements/Floating%20buttons.md) area. \ No newline at end of file diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/Notes/Read-Only Notes_image.png b/docs/User Guide/User Guide/Basic Concepts and Features/Notes/Read-Only Notes_image.png new file mode 100644 index 000000000..86d2efa85 Binary files /dev/null and b/docs/User Guide/User Guide/Basic Concepts and Features/Notes/Read-Only Notes_image.png differ diff --git a/docs/User Guide/User Guide/Note Types/10_Geo Map_image.png b/docs/User Guide/User Guide/Note Types/10_Geo Map_image.png index f76abe4a4..0c818c354 100644 Binary files a/docs/User Guide/User Guide/Note Types/10_Geo Map_image.png and b/docs/User Guide/User Guide/Note Types/10_Geo Map_image.png differ diff --git a/docs/User Guide/User Guide/Note Types/11_Geo Map_image.png b/docs/User Guide/User Guide/Note Types/11_Geo Map_image.png index 0c818c354..cf1451822 100644 Binary files a/docs/User Guide/User Guide/Note Types/11_Geo Map_image.png and b/docs/User Guide/User Guide/Note Types/11_Geo Map_image.png differ diff --git a/docs/User Guide/User Guide/Note Types/12_Geo Map_image.png b/docs/User Guide/User Guide/Note Types/12_Geo Map_image.png index cf1451822..5982cc31c 100644 Binary files a/docs/User Guide/User Guide/Note Types/12_Geo Map_image.png and b/docs/User Guide/User Guide/Note Types/12_Geo Map_image.png differ diff --git a/docs/User Guide/User Guide/Note Types/13_Geo Map_image.png b/docs/User Guide/User Guide/Note Types/13_Geo Map_image.png index 5982cc31c..9292d9bb9 100644 Binary files a/docs/User Guide/User Guide/Note Types/13_Geo Map_image.png and b/docs/User Guide/User Guide/Note Types/13_Geo Map_image.png differ diff --git a/docs/User Guide/User Guide/Note Types/14_Geo Map_image.png b/docs/User Guide/User Guide/Note Types/14_Geo Map_image.png index 9292d9bb9..0c1519f2c 100644 Binary files a/docs/User Guide/User Guide/Note Types/14_Geo Map_image.png and b/docs/User Guide/User Guide/Note Types/14_Geo Map_image.png differ diff --git a/docs/User Guide/User Guide/Note Types/15_Geo Map_image.png b/docs/User Guide/User Guide/Note Types/15_Geo Map_image.png index 0c1519f2c..debb47ce3 100644 Binary files a/docs/User Guide/User Guide/Note Types/15_Geo Map_image.png and b/docs/User Guide/User Guide/Note Types/15_Geo Map_image.png differ diff --git a/docs/User Guide/User Guide/Note Types/16_Geo Map_image.png b/docs/User Guide/User Guide/Note Types/16_Geo Map_image.png index debb47ce3..9bb397516 100644 Binary files a/docs/User Guide/User Guide/Note Types/16_Geo Map_image.png and b/docs/User Guide/User Guide/Note Types/16_Geo Map_image.png differ diff --git a/docs/User Guide/User Guide/Note Types/17_Geo Map_image.png b/docs/User Guide/User Guide/Note Types/17_Geo Map_image.png index 23209e0ad..e77c1aff8 100644 Binary files a/docs/User Guide/User Guide/Note Types/17_Geo Map_image.png and b/docs/User Guide/User Guide/Note Types/17_Geo Map_image.png differ diff --git a/docs/User Guide/User Guide/Note Types/18_Geo Map_image.png b/docs/User Guide/User Guide/Note Types/18_Geo Map_image.png index 9bb397516..4e32110f8 100644 Binary files a/docs/User Guide/User Guide/Note Types/18_Geo Map_image.png and b/docs/User Guide/User Guide/Note Types/18_Geo Map_image.png differ diff --git a/docs/User Guide/User Guide/Note Types/19_Geo Map_image.png b/docs/User Guide/User Guide/Note Types/19_Geo Map_image.png deleted file mode 100644 index e77c1aff8..000000000 Binary files a/docs/User Guide/User Guide/Note Types/19_Geo Map_image.png and /dev/null differ diff --git a/docs/User Guide/User Guide/Note Types/20_Geo Map_image.png b/docs/User Guide/User Guide/Note Types/20_Geo Map_image.png deleted file mode 100644 index 4e32110f8..000000000 Binary files a/docs/User Guide/User Guide/Note Types/20_Geo Map_image.png and /dev/null differ diff --git a/docs/User Guide/User Guide/Note Types/2_Geo Map_image.png b/docs/User Guide/User Guide/Note Types/2_Geo Map_image.png index 97879b76a..1b88e14e6 100644 Binary files a/docs/User Guide/User Guide/Note Types/2_Geo Map_image.png and b/docs/User Guide/User Guide/Note Types/2_Geo Map_image.png differ diff --git a/docs/User Guide/User Guide/Note Types/3_Geo Map_image.png b/docs/User Guide/User Guide/Note Types/3_Geo Map_image.png index 1b88e14e6..59d0cbbac 100644 Binary files a/docs/User Guide/User Guide/Note Types/3_Geo Map_image.png and b/docs/User Guide/User Guide/Note Types/3_Geo Map_image.png differ diff --git a/docs/User Guide/User Guide/Note Types/4_Geo Map_image.png b/docs/User Guide/User Guide/Note Types/4_Geo Map_image.png index 59d0cbbac..128e1df79 100644 Binary files a/docs/User Guide/User Guide/Note Types/4_Geo Map_image.png and b/docs/User Guide/User Guide/Note Types/4_Geo Map_image.png differ diff --git a/docs/User Guide/User Guide/Note Types/5_Geo Map_image.png b/docs/User Guide/User Guide/Note Types/5_Geo Map_image.png index 128e1df79..e97de57e4 100644 Binary files a/docs/User Guide/User Guide/Note Types/5_Geo Map_image.png and b/docs/User Guide/User Guide/Note Types/5_Geo Map_image.png differ diff --git a/docs/User Guide/User Guide/Note Types/6_Geo Map_image.png b/docs/User Guide/User Guide/Note Types/6_Geo Map_image.png index e97de57e4..adec6e898 100644 Binary files a/docs/User Guide/User Guide/Note Types/6_Geo Map_image.png and b/docs/User Guide/User Guide/Note Types/6_Geo Map_image.png differ diff --git a/docs/User Guide/User Guide/Note Types/7_Geo Map_image.png b/docs/User Guide/User Guide/Note Types/7_Geo Map_image.png index adec6e898..c7bb7f704 100644 Binary files a/docs/User Guide/User Guide/Note Types/7_Geo Map_image.png and b/docs/User Guide/User Guide/Note Types/7_Geo Map_image.png differ diff --git a/docs/User Guide/User Guide/Note Types/8_Geo Map_image.png b/docs/User Guide/User Guide/Note Types/8_Geo Map_image.png index c7bb7f704..4552aaf59 100644 Binary files a/docs/User Guide/User Guide/Note Types/8_Geo Map_image.png and b/docs/User Guide/User Guide/Note Types/8_Geo Map_image.png differ diff --git a/docs/User Guide/User Guide/Note Types/9_Geo Map_image.png b/docs/User Guide/User Guide/Note Types/9_Geo Map_image.png index 4552aaf59..f76abe4a4 100644 Binary files a/docs/User Guide/User Guide/Note Types/9_Geo Map_image.png and b/docs/User Guide/User Guide/Note Types/9_Geo Map_image.png differ 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 b2dad9c0b..4301227e2 100644 --- a/docs/User Guide/User Guide/Note Types/Geo Map.md +++ b/docs/User Guide/User Guide/Note Types/Geo Map.md @@ -1,5 +1,5 @@ # Geo Map -![](11_Geo%20Map_image.png) +![](10_Geo%20Map_image.png) This note type displays the children notes on a geographical map, based on an attribute. It is also possible to add new notes at a specific location using the built-in interface. @@ -7,8 +7,8 @@ This note type displays the children notes on a geographical map, based on an at | | | | | --- | --- | --- | -| 1 | ![](8_Geo%20Map_image.png) | Right click on any note on the note tree and select _Insert child note_ → _Geo Map (beta)_. | -| 2 | ![](10_Geo%20Map_image.png) | By default the map will be empty and will show the entire world. | +| 1 | ![](7_Geo%20Map_image.png) | Right click on any note on the note tree and select _Insert child note_ → _Geo Map (beta)_. | +| 2 | ![](9_Geo%20Map_image.png) | By default the map will be empty and will show the entire world. | ## Repositioning the map @@ -21,16 +21,16 @@ 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 ![](12_Geo%20Map_image.png) button in the [Floating buttons](../Basic%20Concepts%20and%20Features/UI%20Elements/Floating%20buttons.md) (top-right) area.

If the button is not visible, make sure the button section is visible by pressing the chevron button (![](19_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.   

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. | -| 4 | ![](18_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. | +| 1 | To create a marker, first navigate to the desired point on the map. Then press the ![](11_Geo%20Map_image.png) button in the [Floating buttons](../Basic%20Concepts%20and%20Features/UI%20Elements/Floating%20buttons.md) (top-right) area.

If the button is not visible, make sure the button section is visible by pressing the chevron button (![](17_Geo%20Map_image.png)) in the top-right of the map. | | +| 2 | ![](2_Geo%20Map_image.png) | Once pressed, the map will enter in the insert mode, as illustrated by the notification.   

Simply click the point on the map where to place the marker, or the Escape key to cancel. | +| 3 | ![](8_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. | ## How the location of the markers is stored The location of a marker is stored in the `#geolocation` attribute of the child notes: -![](20_Geo%20Map_image.png) +![](18_Geo%20Map_image.png) 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. @@ -70,9 +70,9 @@ The value of the attribute is made up of the latitude and longitude separated by | | | | | --- | --- | --- | -| 1 | ![](14_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.   

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 | ![](5_Geo%20Map_image.png) | In Trilium, create a child note under the map. | -| 3 | ![](13_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. | +| 1 | ![](13_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.   

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 | ![](4_Geo%20Map_image.png) | In Trilium, create a child note under the map. | +| 3 | ![](12_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. | ### Adding from OpenStreetMap @@ -82,7 +82,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. | | 2 | ![](Geo%20Map_image.png) | The address will be visible in the top-left of the screen, in the place of the search bar.   

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 | ![](5_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) @@ -90,13 +90,13 @@ 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. | -| 2 | ![](16_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.   

The start and end points of the track are indicated by the two blue markers. | +| 1 | ![](3_Geo%20Map_image.png) | To add a track, simply drag & drop a .gpx file inside the geo map in the note tree. | +| 2 | ![](15_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 | ![](6_Geo%20Map_image.png) | 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. | ## Troubleshooting -![](15_Geo%20Map_image.png) +![](14_Geo%20Map_image.png) ### Grid-like artifacts on the map diff --git a/docs/User Guide/User Guide/Note Types/Text.md b/docs/User Guide/User Guide/Note Types/Text.md index 628d9d911..5295c590b 100644 --- a/docs/User Guide/User Guide/Note Types/Text.md +++ b/docs/User Guide/User Guide/Note Types/Text.md @@ -13,14 +13,7 @@ The Trilium text note interface does not display toolbars or formatting options ## Read-Only vs. Editing Mode -Text notes are usually opened in edit mode. However, they may open in read-only mode under the following circumstances: - -* The note is long and would take time to load, so it is opened in read-only mode by default for quicker access. -* The note has a `readOnly` [label](../Advanced%20Usage/Attributes.md). - -In both cases, it is possible to switch back to editable mode using the ![](Text_bx-edit-alt.svg)button at top right of page. - -For more information, see [Read-Only Notes](../Basic%20Concepts%20and%20Features/Notes/Read-Only%20Notes.md). +Text notes are usually opened in edit mode. However, they may open in read-only mode if the note is too big or the note is explicitly marked as read-only. For more information, see [Read-Only Notes](../Basic%20Concepts%20and%20Features/Notes/Read-Only%20Notes.md). ## General Formatting diff --git a/src/public/app/doc_notes/en/User Guide/!!!meta.json b/src/public/app/doc_notes/en/User Guide/!!!meta.json index 233c9ece1..7f4560e7c 100644 --- a/src/public/app/doc_notes/en/User Guide/!!!meta.json +++ b/src/public/app/doc_notes/en/User Guide/!!!meta.json @@ -2432,20 +2432,6 @@ "isInheritable": false, "position": 10 }, - { - "type": "relation", - "name": "internalLink", - "value": "iPIMuisry3hd", - "isInheritable": false, - "position": 20 - }, - { - "type": "relation", - "name": "internalLink", - "value": "6f9hih2hXXZk", - "isInheritable": false, - "position": 30 - }, { "type": "label", "name": "shareAlias", @@ -2459,11 +2445,55 @@ "value": "bx bx-edit-alt", "isInheritable": false, "position": 40 + }, + { + "type": "relation", + "name": "internalLink", + "value": "iPIMuisry3hd", + "isInheritable": false, + "position": 50 + }, + { + "type": "relation", + "name": "internalLink", + "value": "6f9hih2hXXZk", + "isInheritable": false, + "position": 60 + }, + { + "type": "relation", + "name": "internalLink", + "value": "BlN9DFI679QC", + "isInheritable": false, + "position": 70 + }, + { + "type": "relation", + "name": "internalLink", + "value": "XpOYSgsLkTJy", + "isInheritable": false, + "position": 80 + }, + { + "type": "relation", + "name": "internalLink", + "value": "4TIF1oA4VQRO", + "isInheritable": false, + "position": 100 } ], "format": "html", "dataFileName": "Read-Only Notes.html", - "attachments": [] + "attachments": [ + { + "attachmentId": "dUmc6vYfoQgZ", + "title": "image.png", + "role": "image", + "mime": "image/png", + "position": 10, + "dataFileName": "Read-Only Notes_image.png" + } + ] } ] }, @@ -3718,13 +3748,6 @@ "isInheritable": false, "position": 20 }, - { - "type": "relation", - "name": "internalLink", - "value": "zEY4DaJG4YT5", - "isInheritable": false, - "position": 30 - }, { "type": "relation", "name": "internalLink", @@ -5480,7 +5503,7 @@ "dataFileName": "1_Geo Map_image.png" }, { - "attachmentId": "6wUkw5RWE39e", + "attachmentId": "aCSNn9QlgHFi", "title": "image.png", "role": "image", "mime": "image/png", @@ -5488,7 +5511,7 @@ "dataFileName": "2_Geo Map_image.png" }, { - "attachmentId": "aCSNn9QlgHFi", + "attachmentId": "aCuXZY7WV4li", "title": "image.png", "role": "image", "mime": "image/png", @@ -5496,7 +5519,7 @@ "dataFileName": "3_Geo Map_image.png" }, { - "attachmentId": "aCuXZY7WV4li", + "attachmentId": "agH6yREFgsoU", "title": "image.png", "role": "image", "mime": "image/png", @@ -5504,7 +5527,7 @@ "dataFileName": "4_Geo Map_image.png" }, { - "attachmentId": "agH6yREFgsoU", + "attachmentId": "AHyDUM6R5HeG", "title": "image.png", "role": "image", "mime": "image/png", @@ -5512,7 +5535,7 @@ "dataFileName": "5_Geo Map_image.png" }, { - "attachmentId": "AHyDUM6R5HeG", + "attachmentId": "CcjWLhE3KKfv", "title": "image.png", "role": "image", "mime": "image/png", @@ -5520,7 +5543,7 @@ "dataFileName": "6_Geo Map_image.png" }, { - "attachmentId": "CcjWLhE3KKfv", + "attachmentId": "DapDey8gMiFc", "title": "image.png", "role": "image", "mime": "image/png", @@ -5528,7 +5551,7 @@ "dataFileName": "7_Geo Map_image.png" }, { - "attachmentId": "DapDey8gMiFc", + "attachmentId": "fQy8R1vxKhwN", "title": "image.png", "role": "image", "mime": "image/png", @@ -5536,28 +5559,20 @@ "dataFileName": "8_Geo Map_image.png" }, { - "attachmentId": "fQy8R1vxKhwN", + "attachmentId": "gJ4Yz80jxcbn", "title": "image.png", "role": "image", "mime": "image/png", "position": 10, "dataFileName": "9_Geo Map_image.png" }, - { - "attachmentId": "gJ4Yz80jxcbn", - "title": "image.png", - "role": "image", - "mime": "image/png", - "position": 10, - "dataFileName": "10_Geo Map_image.png" - }, { "attachmentId": "I39BinT2gsN9", "title": "image.png", "role": "image", "mime": "image/png", "position": 10, - "dataFileName": "11_Geo Map_image.png" + "dataFileName": "10_Geo Map_image.png" }, { "attachmentId": "IeXU8SLZU7Oz", @@ -5573,7 +5588,7 @@ "role": "image", "mime": "image/png", "position": 10, - "dataFileName": "12_Geo Map_image.png" + "dataFileName": "11_Geo Map_image.png" }, { "attachmentId": "Mx2xwNIk76ZS", @@ -5581,7 +5596,7 @@ "role": "image", "mime": "image/png", "position": 10, - "dataFileName": "13_Geo Map_image.png" + "dataFileName": "12_Geo Map_image.png" }, { "attachmentId": "oaahbsMRbqd2", @@ -5589,7 +5604,7 @@ "role": "image", "mime": "image/png", "position": 10, - "dataFileName": "14_Geo Map_image.png" + "dataFileName": "13_Geo Map_image.png" }, { "attachmentId": "pGf1p74KKGU4", @@ -5597,7 +5612,7 @@ "role": "image", "mime": "image/jpg", "position": 10, - "dataFileName": "15_Geo Map_image.png" + "dataFileName": "14_Geo Map_image.png" }, { "attachmentId": "tfa1TRUatWEh", @@ -5605,15 +5620,7 @@ "role": "image", "mime": "image/png", "position": 10, - "dataFileName": "16_Geo Map_image.png" - }, - { - "attachmentId": "USbvJ38T4AKA", - "title": "image.png", - "role": "image", - "mime": "image/png", - "position": 10, - "dataFileName": "17_Geo Map_image.png" + "dataFileName": "15_Geo Map_image.png" }, { "attachmentId": "x6yBLIsY2LSv", @@ -5621,7 +5628,7 @@ "role": "image", "mime": "image/png", "position": 10, - "dataFileName": "18_Geo Map_image.png" + "dataFileName": "16_Geo Map_image.png" }, { "attachmentId": "yJMyBRYA3Kwi", @@ -5629,7 +5636,7 @@ "role": "image", "mime": "image/png", "position": 10, - "dataFileName": "19_Geo Map_image.png" + "dataFileName": "17_Geo Map_image.png" }, { "attachmentId": "ZvTlu9WMd37z", @@ -5637,7 +5644,7 @@ "role": "image", "mime": "image/png", "position": 10, - "dataFileName": "20_Geo Map_image.png" + "dataFileName": "18_Geo Map_image.png" } ] } diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Read-Only Notes.html b/src/public/app/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Read-Only Notes.html index 96104eda0..adc002623 100644 --- a/src/public/app/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Read-Only Notes.html +++ b/src/public/app/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Read-Only Notes.html @@ -13,20 +13,70 @@

Read-Only Notes

-

Both text and code notes - in Trilium can be set to read-only. When a note is in read-only mode, it - is presented to the user in a non-editable view, with the option to switch - to editing mode if needed.

-

Setting Read-Only Mode with a Label

-

To set a note as read-only, add the readOnly label to - the note.

-

Automatic Read-Only Mode

+

Some note types such as Text and  + Code notes in Trilium can be set to read-only. When a note is + in read-only mode, it is presented to the user in a non-editable view, + with the option to switch to editing mode if needed.

+

Automatic read-only mode

For optimization purposes, Trilium will automatically set very large notes to read-only. Displaying such lengthy notes in editing mode can slow down performance, especially when editing is unnecessary.

-

If you want to ensure that a specific note remains editable regardless - of its size, you can add the autoReadOnlyDisabled label to - the note.

+

This behavior can be disabled on a per-note basis, by following the instructions + of the next section.

+

In addition, it's possible to change the number of characters at which + the automatic read-only mode will trigger in Options by going to the options + for Text and  + Code notes.

+

Changing a note's read-only behavior

+

Via the Ribbon, + by going to the Basic Properties tab and looking for the Editable selection. + The following options are possible:

+ +

If the Editable section is missing from the ribbon, then the note + type does not support read-only mode.

+

Manually setting the options

+

Apart from using the ribbon as previously mentioned, it's also possible + to use labels to change + the behavior:

+ +

Temporarily editing a read-only note

+

When accessing a read-only note, it's possible to temporarily edit it + by using the + button in the Floating buttons area.

+

When pressed, the note will become editable but will become read-only + again after navigating to a different note.

+

Special read-only behavior

+

Some note types have a special behavior based on whether the read-only + mode is enabled:

+
diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Read-Only Notes_image.png b/src/public/app/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Read-Only Notes_image.png new file mode 100644 index 000000000..86d2efa85 Binary files /dev/null and b/src/public/app/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Read-Only Notes_image.png differ diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/10_Geo Map_image.png b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/10_Geo Map_image.png index f76abe4a4..0c818c354 100644 Binary files a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/10_Geo Map_image.png and b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/10_Geo Map_image.png differ diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/11_Geo Map_image.png b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/11_Geo Map_image.png index 0c818c354..cf1451822 100644 Binary files a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/11_Geo Map_image.png and b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/11_Geo Map_image.png differ diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/12_Geo Map_image.png b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/12_Geo Map_image.png index cf1451822..5982cc31c 100644 Binary files a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/12_Geo Map_image.png and b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/12_Geo Map_image.png differ diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/13_Geo Map_image.png b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/13_Geo Map_image.png index 5982cc31c..9292d9bb9 100644 Binary files a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/13_Geo Map_image.png and b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/13_Geo Map_image.png differ diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/14_Geo Map_image.png b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/14_Geo Map_image.png index 9292d9bb9..0c1519f2c 100644 Binary files a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/14_Geo Map_image.png and b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/14_Geo Map_image.png differ diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/15_Geo Map_image.png b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/15_Geo Map_image.png index 0c1519f2c..debb47ce3 100644 Binary files a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/15_Geo Map_image.png and b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/15_Geo Map_image.png differ diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/16_Geo Map_image.png b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/16_Geo Map_image.png index debb47ce3..9bb397516 100644 Binary files a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/16_Geo Map_image.png and b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/16_Geo Map_image.png differ diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/17_Geo Map_image.png b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/17_Geo Map_image.png index 23209e0ad..e77c1aff8 100644 Binary files a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/17_Geo Map_image.png and b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/17_Geo Map_image.png differ diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/18_Geo Map_image.png b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/18_Geo Map_image.png index 9bb397516..4e32110f8 100644 Binary files a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/18_Geo Map_image.png and b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/18_Geo Map_image.png differ diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/19_Geo Map_image.png b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/19_Geo Map_image.png deleted file mode 100644 index e77c1aff8..000000000 Binary files a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/19_Geo Map_image.png and /dev/null differ diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/20_Geo Map_image.png b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/20_Geo Map_image.png deleted file mode 100644 index 4e32110f8..000000000 Binary files a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/20_Geo Map_image.png and /dev/null differ diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/2_Geo Map_image.png b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/2_Geo Map_image.png index 97879b76a..1b88e14e6 100644 Binary files a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/2_Geo Map_image.png and b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/2_Geo Map_image.png differ diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/3_Geo Map_image.png b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/3_Geo Map_image.png index 1b88e14e6..59d0cbbac 100644 Binary files a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/3_Geo Map_image.png and b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/3_Geo Map_image.png differ diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/4_Geo Map_image.png b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/4_Geo Map_image.png index 59d0cbbac..128e1df79 100644 Binary files a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/4_Geo Map_image.png and b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/4_Geo Map_image.png differ diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/5_Geo Map_image.png b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/5_Geo Map_image.png index 128e1df79..e97de57e4 100644 Binary files a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/5_Geo Map_image.png and b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/5_Geo Map_image.png differ diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/6_Geo Map_image.png b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/6_Geo Map_image.png index e97de57e4..adec6e898 100644 Binary files a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/6_Geo Map_image.png and b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/6_Geo Map_image.png differ diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/7_Geo Map_image.png b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/7_Geo Map_image.png index adec6e898..c7bb7f704 100644 Binary files a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/7_Geo Map_image.png and b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/7_Geo Map_image.png differ diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/8_Geo Map_image.png b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/8_Geo Map_image.png index c7bb7f704..4552aaf59 100644 Binary files a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/8_Geo Map_image.png and b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/8_Geo Map_image.png differ diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/9_Geo Map_image.png b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/9_Geo Map_image.png index 4552aaf59..f76abe4a4 100644 Binary files a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/9_Geo Map_image.png and b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/9_Geo Map_image.png differ diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/Geo Map.html b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/Geo Map.html index 632bbb8d1..8bc263eae 100644 --- a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/Geo Map.html +++ b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/Geo Map.html @@ -14,7 +14,7 @@
-

This note type displays the children notes on a geographical map, based @@ -34,14 +34,14 @@ 1 - + Right click on any note on the note tree and select Insert child noteGeo Map (beta). 2 - + By default the map will be empty and will show the entire world. @@ -76,18 +76,18 @@ 1 To create a marker, first navigate to the desired point on the map. Then press the - button in the Floating buttons (top-right) + button in the Floating buttons (top-right) area.

If the button is not visible, make sure the button section is visible by pressing the chevron button ( - ) in the top-right of the map. 2 - Once pressed, the map will enter in the insert mode, as illustrated by @@ -99,7 +99,7 @@ 3 - Enter the name of the marker/note to be created. @@ -108,7 +108,7 @@ 4 + src="16_Geo Map_image.png" width="1696" height="608"> Once confirmed, the marker will show up on the map and it will also be displayed as a child note of the map. @@ -120,7 +120,7 @@

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.

@@ -178,7 +178,7 @@ 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.    @@ -192,14 +192,14 @@ 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. @@ -242,7 +242,7 @@ 3 - + 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. @@ -266,7 +266,7 @@ 1 - + To add a track, simply drag & drop a .gpx file inside the geo map in the note tree. @@ -274,7 +274,7 @@ 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. @@ -282,7 +282,7 @@ 3 - + When going back to the map, the track should now be visible.   
@@ -293,7 +293,7 @@

Troubleshooting

- +

Grid-like artifacts on the map

This occurs if the application is not at 100% zoom which causes the pixels diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/Text.html b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/Text.html index 49ec739a4..04bb5aae5 100644 --- a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/Text.html +++ b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/Text.html @@ -28,16 +28,8 @@ formating note block2. Clicking on the block toolbar.

Read-Only vs. Editing Mode

Text notes are usually opened in edit mode. However, they may open in - read-only mode under the following circumstances:

- -

In both cases, it is possible to switch back to editable mode using the - button at top right of page.

-

For more information, see Read-Only Notes.

+ read-only mode if the note is too big or the note is explicitly marked + as read-only. For more information, see Read-Only Notes.

General Formatting

Since Trilium uses CKEditor, all of its formatting options are available here. You may use the graphical toolbar shown above, or enter formatting @@ -47,7 +39,7 @@

  • Italic: Type *text* or _text_
  • -
  • Strikethrough: Type ~~text~~ +
  • Strikethrough: Type ~~text~~
  • Lists