mirror/trilium
1
0
Fork 0
mirror of https://github.com/zadam/trilium.git synced 2025-12-21 05:49:35 -06:00
Code Issues Packages Projects Releases Wiki Activity

feat(docs): improve link docs organization (#8057)

Browse Source
This commit is contained in:
Elian Doran
2025-12-19 00:26:09 +02:00
committed by GitHub
parent 9ef4ab9983 55649c3750
commit 0a2d4131d7
7 changed files with 85 additions and 83 deletions
Download Patch File Download Diff File Expand all files Collapse all files

26
apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links.html generated vendored
View File

@@ -5,30 +5,6 @@
<li><a class="reference-link" href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a>&nbsp;for
links to other notes within Trilium.</li>
</ul>
<h2>Pasting links</h2>
<ul>
<li>For internal links (links to notes in Trilium), press Ctrl+C in the&nbsp;
<a
class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>:
<ul>
<li>Pasting directly in a text note will create a reference link (with an
icon to the note and the actual note title).</li>
<li>Pasting over an existing text will create a traditional link.</li>
</ul>
</li>
<li>For external links:
<ul>
<li>Paste the raw URL directly and press space to turn it into a link.</li>
<li>Select a text and paste the URL over it to turn that text into a link.</li>
<li>If you are pasting a formatted link (e.g. from the a webpage in a browser),
simply paste it and it will keep the original text and URL.</li>
</ul>
</li>
</ul>
<h2>In-place linking</h2>
<p>Trilium also provides "inline" linking - type <code>@</code> and you'll
see an autocomplete, just type few characters from the desired note title,
press enter and you have a link.</p>
<h2>Note map</h2>
<p>Trilium provides a visualisation of incoming and outgoing links for a
<p>Trilium provides a visualization of incoming and outgoing links for a
particular note. See <a href="#root/_help_BCkXAVs63Ttv">note map</a> for details.</p>

BIN
apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/1_Internal (reference) links.png generated vendored Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 178 B

62
apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/Internal (reference) links.html generated vendored
View File

@@ -1,33 +1,51 @@
<p>Unlike external notes, internal links (links to other notes) can be created
at the current position by :</p>
<p>Internal links are links to other notes within Trilium.</p>
<p>You can open an internal link by clicking it. You can also see a read-only
preview of an internal link's contents by hovering over it.</p>
<h2>Inserting internal links</h2>
<p>Internal links can be created at the current position in a text note by:</p>
<ol>
<li>Pressing <kbd>Ctrl</kbd> + <kbd>L</kbd> or the
<li data-list-item-id="e655e303285d12486178b60e5252b02fb">Pressing <kbd>Ctrl</kbd> + <kbd>L</kbd> or the
<img src="Internal (reference) links.png"
width="20" height="17">button from the&nbsp;<a class="reference-link" href="#root/_help_nRhnJkTT8cPs">Formatting toolbar</a>.</li>
<li>Filling in the desired note to link. It's also possible to create notes
from this dialog by typing a non-existing note title and selecting <em>Create and link child note</em>.</li>
width="20" height="17">button underneath the
<img src="1_Internal (reference) links.png"
width="34" height="16">menu in the&nbsp;<a class="reference-link" href="#root/_help_nRhnJkTT8cPs">Formatting toolbar</a>.</li>
<li
data-list-item-id="ec4d17a840f8ad96ad9a1344fae1b08aa">Searching for the title of the desired note to link. It's also possible
to create new notes from this dialog by typing a non-existing note title
and selecting <em>Create and link child note</em>.</li>
</ol>
<p>There are two link types, adjustable when creating the link to the note:</p>
<p>There are two link types which you can select when creating the link to
the note:</p>
<ol>
<li><em>link title mirrors the note's current title</em>
<li class="ck-list-marker-italic" data-list-item-id="e4941d85321cae8b9c8ca4fb3f9b5391f"><em>Link title mirrors the note's current title</em>
<ol>
<li>This is sometimes also called "reference link".</li>
<li>Title of such links cannot be changed, instead it is always mirroring
the title of linked note.</li>
<li>The icon of the note is also displayed.</li>
<li>The link title will automatically update if the title of the note is changed.</li>
<li data-list-item-id="e831f442edca1e269b6c9282ba6c1731f">This is sometimes also called "reference link".</li>
<li data-list-item-id="e4c7d8126b4309f53f8e525e251253c6e">The title of this link cannot be changed. Instead, it will always show
the current title of the linked note.</li>
<li data-list-item-id="ec99e391c88123c302a411912aa997be1">The icon of the linked note will also be displayed.</li>
</ol>
</li>
<li><em>link title can be changed arbitrarily</em>
<li class="ck-list-marker-italic" data-list-item-id="ebfbfebd9681b2e42f2859d75b95455c4"><em>Link title can be changed arbitrarily</em>
<ol>
<li>This is the traditional hyperlink, where the text of the link can be different
to the note title.</li>
<li data-list-item-id="eb2e9aac2e539d6ff4d1300f83ce15e4d">This will create a traditional hyperlink, where the text of the link can
be different from the note title.</li>
</ol>
</li>
</ol>
<p>Once an internal link is created:</p>
<ul>
<li>You can follow the note link by double clicking it.</li>
<li>Alternatively if you only wish to quickly preview the content, you can
hover over the link and will see read only preview.</li>
</ul>
<h2>In-place linking</h2>
<p>You can also insert internal links “inline” by using the <code spellcheck="false">@</code> symbol:</p>
<ol>
<li data-list-item-id="e31c9d32997316a3bac436e1bbb8a225a">Type <code spellcheck="false">@</code> in a text note, which will open the
note search menu.</li>
<li data-list-item-id="ef74c22124bc8cfdd214b70095ecb4836">Search for the desired note's title by typing a few characters. Use <kbd>Up</kbd> and <kbd>Down</kbd> to
select the correct note, and press <kbd>Enter</kbd> or <kbd>Tab</kbd> to create
the link. It's also possible to create new notes with this method by typing
a non-existing note title and selecting <em>Create and link child note</em>.</li>
</ol>
<h2>Pasting internal links</h2>
<p>You can also insert internal links by copying a note from the note tree.</p>
<ol>
<li data-list-item-id="e4f9f8b8c477975d3ed3919c384916a94">In the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>,
select a note and press <kbd>Ctrl</kbd> + <kbd>C</kbd>.</li>
<li data-list-item-id="e1ec19e8d37170ee05aee28228c4fae6e">In a text note, paste the link by pressing <kbd>Ctrl</kbd> + <kbd>V</kbd>.</li>
</ol>

24
docs/User Guide/!!!meta.json vendored
View File

@@ -7929,19 +7929,12 @@
"isInheritable": false,
"position": 20
},
{
"type": "relation",
"name": "internalLink",
"value": "oPVyFC7WL2Lp",
"isInheritable": false,
"position": 30
},
{
"type": "relation",
"name": "internalLink",
"value": "BCkXAVs63Ttv",
"isInheritable": false,
"position": 40
"position": 30
},
{
"type": "label",
@@ -8055,6 +8048,13 @@
"isInheritable": false,
"position": 10
},
{
"type": "relation",
"name": "internalLink",
"value": "oPVyFC7WL2Lp",
"isInheritable": false,
"position": 20
},
{
"type": "label",
"name": "iconClass",
@@ -8080,6 +8080,14 @@
"mime": "image/png",
"position": 10,
"dataFileName": "Internal (reference) links.png"
},
{
"attachmentId": "VWmqBZtLxTJH",
"title": "image.png",
"role": "image",
"mime": "image/png",
"position": 10,
"dataFileName": "1_Internal (reference) links.png"
}
]
}

16
docs/User Guide/User Guide/Note Types/Text/Links.md vendored
View File

@@ -4,20 +4,6 @@ There are two types of links:
* <a class="reference-link" href="Links/External%20links.md">External links</a>, for standard hyperlinks to websites or other resources.
* <a class="reference-link" href="Links/Internal%20(reference)%20links.md">Internal (reference) links</a> for links to other notes within Trilium.
## Pasting links
* For internal links (links to notes in Trilium), press Ctrl+C in the <a class="reference-link" href="../../Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tree.md">Note Tree</a>:
* Pasting directly in a text note will create a reference link (with an icon to the note and the actual note title).
* Pasting over an existing text will create a traditional link.
* For external links:
* Paste the raw URL directly and press space to turn it into a link.
* Select a text and paste the URL over it to turn that text into a link.
* If you are pasting a formatted link (e.g. from the a webpage in a browser), simply paste it and it will keep the original text and URL.
## In-place linking
Trilium also provides "inline" linking - type `@` and you'll see an autocomplete, just type few characters from the desired note title, press enter and you have a link.
## Note map
Trilium provides a visualisation of incoming and outgoing links for a particular note. See [note map](../../Advanced%20Usage/Note%20Map%20\(Link%20map%2C%20Tree%20map\).md) for details.
Trilium provides a visualization of incoming and outgoing links for a particular note. See [note map](../../Advanced%20Usage/Note%20Map%20\(Link%20map%2C%20Tree%20map\).md) for details.

BIN
docs/User Guide/User Guide/Note Types/Text/Links/1_Internal (reference) links.png vendored Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 178 B

40
docs/User Guide/User Guide/Note Types/Text/Links/Internal (reference) links.md vendored
View File

@@ -1,20 +1,34 @@
# Internal (reference) links
Unlike external notes, internal links (links to other notes) can be created at the current position by :
Internal links are links to other notes within Trilium.
1. Pressing <kbd>Ctrl</kbd> + <kbd>L</kbd> or the <img src="Internal (reference) links.png" width="20" height="17"> button from the <a class="reference-link" href="../Formatting%20toolbar.md">Formatting toolbar</a>.
2. Filling in the desired note to link. It's also possible to create notes from this dialog by typing a non-existing note title and selecting _Create and link child note_.
You can open an internal link by clicking it. You can also see a read-only preview of an internal link's contents by hovering over it.
There are two link types, adjustable when creating the link to the note:
## Inserting internal links
1. _link title mirrors the note's current title_
Internal links can be created at the current position in a text note by:
1. Pressing <kbd>Ctrl</kbd> + <kbd>L</kbd> or the <img src="Internal (reference) links.png" width="20" height="17"> button underneath the <img src="1_Internal (reference) links.png" width="34" height="16"> menu in the <a class="reference-link" href="../Formatting%20toolbar.md">Formatting toolbar</a>.
2. Searching for the title of the desired note to link. It's also possible to create new notes from this dialog by typing a non-existing note title and selecting _Create and link child note_.
There are two link types which you can select when creating the link to the note:
1. _Link title mirrors the note's current title_
1. This is sometimes also called "reference link".
2. Title of such links cannot be changed, instead it is always mirroring the title of linked note.
3. The icon of the note is also displayed.
4. The link title will automatically update if the title of the note is changed.
2. _link title can be changed arbitrarily_
1. This is the traditional hyperlink, where the text of the link can be different to the note title.
2. The title of this link cannot be changed. Instead, it will always show the current title of the linked note.
3. The icon of the linked note will also be displayed.
2. _Link title can be changed arbitrarily_
1. This will create a traditional hyperlink, where the text of the link can be different from the note title.
Once an internal link is created:
## In-place linking
* You can follow the note link by double clicking it.
* Alternatively if you only wish to quickly preview the content, you can hover over the link and will see read only preview.
You can also insert internal links “inline” by using the `@` symbol:
1. Type `@` in a text note, which will open the note search menu.
2. Search for the desired note's title by typing a few characters. Use <kbd>Up</kbd> and <kbd>Down</kbd> to select the correct note, and press <kbd>Enter</kbd> or <kbd>Tab</kbd> to create the link. It's also possible to create new notes with this method by typing a non-existing note title and selecting _Create and link child note_.
## Pasting internal links
You can also insert internal links by copying a note from the note tree.
1. In the <a class="reference-link" href="../../../Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tree.md">Note Tree</a>, select a note and press <kbd>Ctrl</kbd> + <kbd>C</kbd>.
2. In a text note, paste the link by pressing <kbd>Ctrl</kbd> + <kbd>V</kbd>.