mirror of
				https://github.com/zadam/trilium.git
				synced 2025-10-31 02:16:05 +01:00 
			
		
		
		
	feat(docs): improve documentation on note map/relation map
This commit is contained in:
		| Before Width: | Height: | Size: 76 KiB After Width: | Height: | Size: 76 KiB | 
| @@ -1,7 +1,7 @@ | ||||
| # Advanced Showcases | ||||
| Trilium offers advanced functionality through [Scripts](../Note%20Types/Code/Scripts.md) and [Promoted Attributes](Attributes/Promoted%20Attributes.md). To illustrate these features, we've prepared several showcases available in the [demo notes](Database.md): | ||||
|  | ||||
| *   [Relation Map](Relation%20Map.md) | ||||
| *   [Relation Map](../Note%20Types/Relation%20Map.md) | ||||
| *   [Day Notes](Advanced%20Showcases/Day%20Notes.md) | ||||
| *   [Weight Tracker](Advanced%20Showcases/Weight%20Tracker.md) | ||||
| *   [Task Manager](Advanced%20Showcases/Task%20Manager.md) | ||||
|   | ||||
| @@ -31,6 +31,6 @@ Templates can also be added or changed after note creation by creating a `~templ | ||||
|  | ||||
| From a visual perspective, templates can define `#iconClass` and `#cssClass` attributes, allowing all instance notes (e.g., books) to display a specific icon and CSS style. | ||||
|  | ||||
| Explore the concept further in the [demo notes](../Database.md), including examples like the [Relation Map](../Relation%20Map.md), [Task Manager](../Advanced%20Showcases/Task%20Manager.md), and [Day Notes](../Advanced%20Showcases/Day%20Notes.md). | ||||
| Explore the concept further in the [demo notes](../Database.md), including examples like the [Relation Map](../../Note%20Types/Relation%20Map.md), [Task Manager](../Advanced%20Showcases/Task%20Manager.md), and [Day Notes](../Advanced%20Showcases/Day%20Notes.md). | ||||
|  | ||||
| Additionally, see [default note title](../Default%20Note%20Title.md) for creating title templates. Note templates and title templates can be combined by creating a `#titleTemplate` for a template note. | ||||
| @@ -5,7 +5,7 @@ Your Trilium data is stored in a [SQLite](https://www.sqlite.org) database which | ||||
|  | ||||
| When you run Trilium for the first time, it will generate a new database containing demo notes. These notes showcase its many features, such as: | ||||
|  | ||||
| *   [Relation Map](Relation%20Map.md) | ||||
| *   [Relation Map](../Note%20Types/Relation%20Map.md) | ||||
| *   [Day Notes](Advanced%20Showcases/Day%20Notes.md) | ||||
| *   [Weight Tracker](Advanced%20Showcases/Weight%20Tracker.md) | ||||
| *   [Task Manager](Advanced%20Showcases/Task%20Manager.md) | ||||
|   | ||||
| Before Width: | Height: | Size: 77 KiB After Width: | Height: | Size: 77 KiB | 
| @@ -0,0 +1,32 @@ | ||||
| # Note Map (Link map, Tree map) | ||||
| Note map is a visualisation of connections between notes. | ||||
|  | ||||
| This provides an insight into a structure ("web") of notes. | ||||
|  | ||||
| There are two types of note map: | ||||
|  | ||||
| *   Link Map, which shows relations between notes. | ||||
| *   Note Map, which shows the hierarchical tree structure. | ||||
|  | ||||
| ## Link Map | ||||
|  | ||||
| Shows [relations](Attributes.md) between notes: | ||||
|  | ||||
|  | ||||
|  | ||||
| ## Tree Map | ||||
|  | ||||
| Shows hierarchical map of notes: | ||||
|  | ||||
|  | ||||
|  | ||||
| ## Dedicated note type | ||||
|  | ||||
| Apart from the note map feature which can be accessed from any note, it is also possible to create a dedicated note which will display the relations in full screen. See [Note Map](../Note%20Types/Note%20Map.md) for more information. | ||||
|  | ||||
| ## See also | ||||
|  | ||||
| [Relation map](../Note%20Types/Relation%20Map.md) is a similar concept, with some differences: | ||||
|  | ||||
| *   note map is automatically generated while relation map must be created manually | ||||
| *   relation map is a type of note while a link map is just virtual visualization | ||||
| @@ -1,25 +0,0 @@ | ||||
| # Note Map | ||||
| Note map is a visualisation of connections between notes. | ||||
|  | ||||
| This provides an insight into a structure ("web") of notes. | ||||
|  | ||||
| There are two types of note map: | ||||
|  | ||||
| ## Link Map | ||||
|  | ||||
| Shows [relations](Attributes.md) between notes: | ||||
|  | ||||
|  | ||||
|  | ||||
| ## Tree Map | ||||
|  | ||||
| Shows hierarchical map of notes: | ||||
|  | ||||
|  | ||||
|  | ||||
| ## See also | ||||
|  | ||||
| [Relation map](Relation%20Map.md) is a similar concept, with some differences: | ||||
|  | ||||
| *   note map is automatically generated while relation map must be created manually | ||||
| *   relation map is a type of note while a link map is just virtual visualization | ||||
| @@ -1,49 +0,0 @@ | ||||
| # Relation Map | ||||
| Relation map is a type of [note](../Basic%20Concepts/Navigation/Tree%20Concepts.md) which visualizes notes and their [relations](Attributes.md). See an example: | ||||
|  | ||||
| ## Development process demo | ||||
|  | ||||
| This is a basic example how you can create simple diagram using relation maps: | ||||
|  | ||||
|  | ||||
|  | ||||
| And this is how you can create it: | ||||
|  | ||||
|  | ||||
|  | ||||
| We start completely from scratch by first creating new note called "Development process" and changing its type to "Relation map". After that we create new notes one by one and place them by clicking into the map. We also drag [relations](Attributes.md)between notes and name them. That's all! | ||||
|  | ||||
| Items on the map - "Specification", "Development", "Testing" and "Demo" are actually notes which have been created under "Development process" note - you can click on them and write some content. Connections between notes are called "[relations](Attributes.md)". | ||||
|  | ||||
| ## Family demo | ||||
|  | ||||
| This is more complicated demo using some advanced concepts. Resulting diagram is here: | ||||
|  | ||||
|  | ||||
|  | ||||
| This is how you get to it: | ||||
|  | ||||
|  | ||||
|  | ||||
| There are several steps here: | ||||
|  | ||||
| *   we start with empty relation map and two existing notes representing Prince Philip and Queen Elizabeth II. These two notes already have "isPartnerOf" [relations](Attributes.md)defined. | ||||
|     *   There are actually two "inverse" relations (one from Philip to Elizabeth and one from Elizabeth to Philip) | ||||
| *   we drag both notes to relation map and place to suitable position. Notice how the existing "isPartnerOf" relations are displayed. | ||||
| *   now we create new note - we name it "Prince Charles" and place it on the relation map by clicking on the desired position. The note is by default created under the relation map note (visible in the note tree on the left). | ||||
| *   we create two new relations "isChildOf" targeting both Philip and Elizabeth | ||||
|     *   now there's something unexpected - we can also see the relation to display another "hasChild" relation. This is because there's a [relation definition](Attributes/Promoted%20Attributes.md) which puts "isChildOf" as an "[inverse](Attributes/Promoted%20Attributes.md)" relation of "hasChildOf" (and vice versa) and thus it is created automatically. | ||||
| *   we create another note for Princess Diana and create "isPartnerOf" relation from Charles. Again notice how the relation has arrows both ways - this is because "isPartnerOf" definition specifies its inverse relation as again "isPartnerOf" so the opposite relation is created automatically. | ||||
| *   as the last step we pan & zoom the map to fit better to window dimensions. | ||||
|  | ||||
| Relation definitions mentioned above come from "Person template" note which is assigned to any child of "My Family Tree" relation note. You can play with the whole thing in the [demo notes](Database.md). | ||||
|  | ||||
| ## Details | ||||
|  | ||||
| You can specify which relations should be displayed with comma delimited names of relations in `displayRelations` label. | ||||
|  | ||||
| Alternatively, you can specify comma delimited list of relation names in `hideRelations` which will display all relations, except for the ones defined in the label. | ||||
|  | ||||
| ## See also | ||||
|  | ||||
| *   [Note map](Note%20Map.md) is a similar concept | ||||
										
											Binary file not shown.
										
									
								
							| Before Width: | Height: | Size: 1.3 MiB | 
		Reference in New Issue
	
	Block a user