mirror of
https://github.com/TriliumNext/Notes.git
synced 2025-07-29 11:02:28 +08:00
feat(docs): document admonitions
This commit is contained in:
Elian Doran
parent
ba96806fab
commit
79c82b16ce
@ -2798,6 +2798,51 @@
|
|||||||
],
|
],
|
||||||
"dirFileName": "Text",
|
"dirFileName": "Text",
|
||||||
"children": [
|
"children": [
|
||||||
|
{
|
||||||
|
"isClone": false,
|
||||||
|
"noteId": "NwBbFdNZ9h7O",
|
||||||
|
"notePath": [
|
||||||
|
"pOsGYCXsbNQG",
|
||||||
|
"KSZ04uQ2D1St",
|
||||||
|
"iPIMuisry3hd",
|
||||||
|
"NwBbFdNZ9h7O"
|
||||||
|
],
|
||||||
|
"title": "Admonitions",
|
||||||
|
"notePosition": 10,
|
||||||
|
"prefix": null,
|
||||||
|
"isExpanded": false,
|
||||||
|
"type": "text",
|
||||||
|
"mime": "text/html",
|
||||||
|
"attributes": [
|
||||||
|
{
|
||||||
|
"type": "label",
|
||||||
|
"name": "iconClass",
|
||||||
|
"value": "bx bx-info-circle",
|
||||||
|
"isInheritable": false,
|
||||||
|
"position": 10
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"format": "markdown",
|
||||||
|
"dataFileName": "Admonitions.md",
|
||||||
|
"attachments": [
|
||||||
|
{
|
||||||
|
"attachmentId": "do36b54XpmIC",
|
||||||
|
"title": "image.png",
|
||||||
|
"role": "image",
|
||||||
|
"mime": "image/png",
|
||||||
|
"position": 10,
|
||||||
|
"dataFileName": "Admonitions_image.png"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"attachmentId": "hUwfwkRSDeLJ",
|
||||||
|
"title": "image.png",
|
||||||
|
"role": "image",
|
||||||
|
"mime": "image/png",
|
||||||
|
"position": 10,
|
||||||
|
"dataFileName": "1_Admonitions_image.png"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
{
|
{
|
||||||
"isClone": false,
|
"isClone": false,
|
||||||
"noteId": "QxEyIjRBizuC",
|
"noteId": "QxEyIjRBizuC",
|
||||||
@ -2808,7 +2853,7 @@
|
|||||||
"QxEyIjRBizuC"
|
"QxEyIjRBizuC"
|
||||||
],
|
],
|
||||||
"title": "Code blocks",
|
"title": "Code blocks",
|
||||||
"notePosition": 10,
|
"notePosition": 20,
|
||||||
"prefix": null,
|
"prefix": null,
|
||||||
"isExpanded": false,
|
"isExpanded": false,
|
||||||
"type": "text",
|
"type": "text",
|
||||||
@ -2889,7 +2934,7 @@
|
|||||||
"veGu4faJErEM"
|
"veGu4faJErEM"
|
||||||
],
|
],
|
||||||
"title": "Content language & Right-to-left support",
|
"title": "Content language & Right-to-left support",
|
||||||
"notePosition": 20,
|
"notePosition": 30,
|
||||||
"prefix": null,
|
"prefix": null,
|
||||||
"isExpanded": false,
|
"isExpanded": false,
|
||||||
"type": "text",
|
"type": "text",
|
||||||
@ -2926,7 +2971,7 @@
|
|||||||
"UYuUB1ZekNQU"
|
"UYuUB1ZekNQU"
|
||||||
],
|
],
|
||||||
"title": "Formatting",
|
"title": "Formatting",
|
||||||
"notePosition": 30,
|
"notePosition": 40,
|
||||||
"prefix": null,
|
"prefix": null,
|
||||||
"isExpanded": false,
|
"isExpanded": false,
|
||||||
"type": "text",
|
"type": "text",
|
||||||
@ -2979,7 +3024,7 @@
|
|||||||
"nRhnJkTT8cPs"
|
"nRhnJkTT8cPs"
|
||||||
],
|
],
|
||||||
"title": "Formatting toolbar",
|
"title": "Formatting toolbar",
|
||||||
"notePosition": 40,
|
"notePosition": 50,
|
||||||
"prefix": null,
|
"prefix": null,
|
||||||
"isExpanded": false,
|
"isExpanded": false,
|
||||||
"type": "text",
|
"type": "text",
|
||||||
@ -3054,7 +3099,7 @@
|
|||||||
"mT0HEkOsz6i1"
|
"mT0HEkOsz6i1"
|
||||||
],
|
],
|
||||||
"title": "Images",
|
"title": "Images",
|
||||||
"notePosition": 50,
|
"notePosition": 60,
|
||||||
"prefix": null,
|
"prefix": null,
|
||||||
"isExpanded": false,
|
"isExpanded": false,
|
||||||
"type": "text",
|
"type": "text",
|
||||||
@ -3192,7 +3237,7 @@
|
|||||||
"QEAPj01N5f7w"
|
"QEAPj01N5f7w"
|
||||||
],
|
],
|
||||||
"title": "Links",
|
"title": "Links",
|
||||||
"notePosition": 60,
|
"notePosition": 70,
|
||||||
"prefix": null,
|
"prefix": null,
|
||||||
"isExpanded": false,
|
"isExpanded": false,
|
||||||
"type": "text",
|
"type": "text",
|
||||||
@ -3248,7 +3293,7 @@
|
|||||||
"S6Xx8QIWTV66"
|
"S6Xx8QIWTV66"
|
||||||
],
|
],
|
||||||
"title": "Lists",
|
"title": "Lists",
|
||||||
"notePosition": 70,
|
"notePosition": 80,
|
||||||
"prefix": null,
|
"prefix": null,
|
||||||
"isExpanded": false,
|
"isExpanded": false,
|
||||||
"type": "text",
|
"type": "text",
|
||||||
|
|||||||
Binary file not shown.
|
After Width: | Height: | Size: 27 KiB |
63
docs/User Guide/User Guide/Note Types/Text/Admonitions.md
Normal file
63
docs/User Guide/User Guide/Note Types/Text/Admonitions.md
Normal file
@ -0,0 +1,63 @@
|
|||||||
|
# Admonitions
|
||||||
|
|
||||||
|
|
||||||
|
Admonitions are a way to highlight information to the reader. Other names for it include _call-outs_ and _info/warning/alert boxes_.
|
||||||
|
|
||||||
|
## Inserting a new admonition
|
||||||
|
|
||||||
|
### From the UI
|
||||||
|
|
||||||
|
In the Formatting toolbar:
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
### Via the keyboard
|
||||||
|
|
||||||
|
It's possible to insert an admonition simply by typing:
|
||||||
|
|
||||||
|
* `!!! note`
|
||||||
|
* `!!! tip`
|
||||||
|
* `!!! important`
|
||||||
|
* `!!! caution`
|
||||||
|
* `!!! warning`
|
||||||
|
|
||||||
|
In addition to that, it's also possible to type `!!!` followed by any text, case in which a default admonition type will appear (note) with the entered text inside it.
|
||||||
|
|
||||||
|
## Interaction
|
||||||
|
|
||||||
|
By design, admonitions act very similar to block quotes.
|
||||||
|
|
||||||
|
* Selecting a text and pressing the admonition button will turn that text into an admonition.
|
||||||
|
* If selecting multiple admonitions, pressing the admonition button will automatically merge them into one.
|
||||||
|
|
||||||
|
Inside an admonition:
|
||||||
|
|
||||||
|
* Pressing <kbd>Backspace</kbd> while the admonition is empty will remove it.
|
||||||
|
* Pressing <kbd>Enter</kbd> will start a new paragraph. Pressing it twice will exit out of the admonition.
|
||||||
|
* Headings and other block content including tables can be inserted inside the admonition.
|
||||||
|
|
||||||
|
## Types of admonitions
|
||||||
|
|
||||||
|
There are currently five types of admonitions: _Note_, _Tip_, _Important_, _Caution_, _Warning_.
|
||||||
|
|
||||||
|
These types were inspired by GitHub's support for this feature and there are currently no plans for adjusting it or allowing the user to customize them.
|
||||||
|
|
||||||
|
## Markdown support
|
||||||
|
|
||||||
|
The Markdown syntax for admonitions as supported by Trilium is the one that GitHub uses, which is as follows:
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
> [!NOTE]
|
||||||
|
> This is a note.
|
||||||
|
|
||||||
|
> [!TIP]
|
||||||
|
> This is a tip.
|
||||||
|
|
||||||
|
> [!IMPORTANT]
|
||||||
|
> This is a very important information.
|
||||||
|
|
||||||
|
> [!CAUTION]
|
||||||
|
> This is a caution.
|
||||||
|
```
|
||||||
|
|
||||||
|
There are currently no plans of supporting alternative admonition syntaxes such as `!!! note`.
|
||||||
BIN
docs/User Guide/User Guide/Note Types/Text/Admonitions_image.png
Normal file
BIN
docs/User Guide/User Guide/Note Types/Text/Admonitions_image.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 7.0 KiB |
63
src/public/app/doc_notes/en/User Guide/!!!meta.json
generated
63
src/public/app/doc_notes/en/User Guide/!!!meta.json
generated
@ -2681,7 +2681,7 @@
|
|||||||
"title": "Note Types",
|
"title": "Note Types",
|
||||||
"notePosition": 100,
|
"notePosition": 100,
|
||||||
"prefix": null,
|
"prefix": null,
|
||||||
"isExpanded": false,
|
"isExpanded": true,
|
||||||
"type": "text",
|
"type": "text",
|
||||||
"mime": "text/html",
|
"mime": "text/html",
|
||||||
"attributes": [
|
"attributes": [
|
||||||
@ -2708,7 +2708,7 @@
|
|||||||
"title": "Text",
|
"title": "Text",
|
||||||
"notePosition": 10,
|
"notePosition": 10,
|
||||||
"prefix": null,
|
"prefix": null,
|
||||||
"isExpanded": false,
|
"isExpanded": true,
|
||||||
"type": "text",
|
"type": "text",
|
||||||
"mime": "text/markdown",
|
"mime": "text/markdown",
|
||||||
"attributes": [
|
"attributes": [
|
||||||
@ -2798,6 +2798,51 @@
|
|||||||
],
|
],
|
||||||
"dirFileName": "Text",
|
"dirFileName": "Text",
|
||||||
"children": [
|
"children": [
|
||||||
|
{
|
||||||
|
"isClone": false,
|
||||||
|
"noteId": "NwBbFdNZ9h7O",
|
||||||
|
"notePath": [
|
||||||
|
"pOsGYCXsbNQG",
|
||||||
|
"KSZ04uQ2D1St",
|
||||||
|
"iPIMuisry3hd",
|
||||||
|
"NwBbFdNZ9h7O"
|
||||||
|
],
|
||||||
|
"title": "Admonitions",
|
||||||
|
"notePosition": 10,
|
||||||
|
"prefix": null,
|
||||||
|
"isExpanded": false,
|
||||||
|
"type": "text",
|
||||||
|
"mime": "text/html",
|
||||||
|
"attributes": [
|
||||||
|
{
|
||||||
|
"type": "label",
|
||||||
|
"name": "iconClass",
|
||||||
|
"value": "bx bx-info-circle",
|
||||||
|
"isInheritable": false,
|
||||||
|
"position": 10
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"format": "html",
|
||||||
|
"dataFileName": "Admonitions.html",
|
||||||
|
"attachments": [
|
||||||
|
{
|
||||||
|
"attachmentId": "do36b54XpmIC",
|
||||||
|
"title": "image.png",
|
||||||
|
"role": "image",
|
||||||
|
"mime": "image/png",
|
||||||
|
"position": 10,
|
||||||
|
"dataFileName": "Admonitions_image.png"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"attachmentId": "hUwfwkRSDeLJ",
|
||||||
|
"title": "image.png",
|
||||||
|
"role": "image",
|
||||||
|
"mime": "image/png",
|
||||||
|
"position": 10,
|
||||||
|
"dataFileName": "1_Admonitions_image.png"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
{
|
{
|
||||||
"isClone": false,
|
"isClone": false,
|
||||||
"noteId": "QxEyIjRBizuC",
|
"noteId": "QxEyIjRBizuC",
|
||||||
@ -2808,7 +2853,7 @@
|
|||||||
"QxEyIjRBizuC"
|
"QxEyIjRBizuC"
|
||||||
],
|
],
|
||||||
"title": "Code blocks",
|
"title": "Code blocks",
|
||||||
"notePosition": 10,
|
"notePosition": 20,
|
||||||
"prefix": null,
|
"prefix": null,
|
||||||
"isExpanded": false,
|
"isExpanded": false,
|
||||||
"type": "text",
|
"type": "text",
|
||||||
@ -2889,7 +2934,7 @@
|
|||||||
"veGu4faJErEM"
|
"veGu4faJErEM"
|
||||||
],
|
],
|
||||||
"title": "Content language & Right-to-left support",
|
"title": "Content language & Right-to-left support",
|
||||||
"notePosition": 20,
|
"notePosition": 30,
|
||||||
"prefix": null,
|
"prefix": null,
|
||||||
"isExpanded": false,
|
"isExpanded": false,
|
||||||
"type": "text",
|
"type": "text",
|
||||||
@ -2926,7 +2971,7 @@
|
|||||||
"UYuUB1ZekNQU"
|
"UYuUB1ZekNQU"
|
||||||
],
|
],
|
||||||
"title": "Formatting",
|
"title": "Formatting",
|
||||||
"notePosition": 30,
|
"notePosition": 40,
|
||||||
"prefix": null,
|
"prefix": null,
|
||||||
"isExpanded": false,
|
"isExpanded": false,
|
||||||
"type": "text",
|
"type": "text",
|
||||||
@ -2979,7 +3024,7 @@
|
|||||||
"nRhnJkTT8cPs"
|
"nRhnJkTT8cPs"
|
||||||
],
|
],
|
||||||
"title": "Formatting toolbar",
|
"title": "Formatting toolbar",
|
||||||
"notePosition": 40,
|
"notePosition": 50,
|
||||||
"prefix": null,
|
"prefix": null,
|
||||||
"isExpanded": false,
|
"isExpanded": false,
|
||||||
"type": "text",
|
"type": "text",
|
||||||
@ -3054,7 +3099,7 @@
|
|||||||
"mT0HEkOsz6i1"
|
"mT0HEkOsz6i1"
|
||||||
],
|
],
|
||||||
"title": "Images",
|
"title": "Images",
|
||||||
"notePosition": 50,
|
"notePosition": 60,
|
||||||
"prefix": null,
|
"prefix": null,
|
||||||
"isExpanded": false,
|
"isExpanded": false,
|
||||||
"type": "text",
|
"type": "text",
|
||||||
@ -3192,7 +3237,7 @@
|
|||||||
"QEAPj01N5f7w"
|
"QEAPj01N5f7w"
|
||||||
],
|
],
|
||||||
"title": "Links",
|
"title": "Links",
|
||||||
"notePosition": 60,
|
"notePosition": 70,
|
||||||
"prefix": null,
|
"prefix": null,
|
||||||
"isExpanded": false,
|
"isExpanded": false,
|
||||||
"type": "text",
|
"type": "text",
|
||||||
@ -3248,7 +3293,7 @@
|
|||||||
"S6Xx8QIWTV66"
|
"S6Xx8QIWTV66"
|
||||||
],
|
],
|
||||||
"title": "Lists",
|
"title": "Lists",
|
||||||
"notePosition": 70,
|
"notePosition": 80,
|
||||||
"prefix": null,
|
"prefix": null,
|
||||||
"isExpanded": false,
|
"isExpanded": false,
|
||||||
"type": "text",
|
"type": "text",
|
||||||
|
|||||||
BIN
src/public/app/doc_notes/en/User Guide/User Guide/Note Types/Text/1_Admonitions_image.png
generated
Normal file
BIN
src/public/app/doc_notes/en/User Guide/User Guide/Note Types/Text/1_Admonitions_image.png
generated
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 27 KiB |
90
src/public/app/doc_notes/en/User Guide/User Guide/Note Types/Text/Admonitions.html
generated
Normal file
90
src/public/app/doc_notes/en/User Guide/User Guide/Note Types/Text/Admonitions.html
generated
Normal file
@ -0,0 +1,90 @@
|
|||||||
|
<html>
|
||||||
|
|
||||||
|
<head>
|
||||||
|
<meta charset="utf-8">
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||||
|
<link rel="stylesheet" href="../../../style.css">
|
||||||
|
<base target="_parent">
|
||||||
|
<title data-trilium-title>Admonitions</title>
|
||||||
|
</head>
|
||||||
|
|
||||||
|
<body>
|
||||||
|
<div class="content">
|
||||||
|
<h1 data-trilium-h1>Admonitions</h1>
|
||||||
|
|
||||||
|
<div class="ck-content">
|
||||||
|
<div>
|
||||||
|
<div>
|
||||||
|
<figure class="image">
|
||||||
|
<img style="aspect-ratio:959/547;" src="1_Admonitions_image.png" width="959"
|
||||||
|
height="547">
|
||||||
|
</figure>
|
||||||
|
<p>Admonitions are a way to highlight information to the reader. Other names
|
||||||
|
for it include <em>call-outs</em> and <em>info/warning/alert boxes</em>.</p>
|
||||||
|
<h2>Inserting a new admonition</h2>
|
||||||
|
<h3>From the UI</h3>
|
||||||
|
<p>In the Formatting toolbar:</p>
|
||||||
|
<p>
|
||||||
|
<img src="Admonitions_image.png" width="202" height="194">
|
||||||
|
</p>
|
||||||
|
<h3>Via the keyboard</h3>
|
||||||
|
<p>It's possible to insert an admonition simply by typing:</p>
|
||||||
|
<ul>
|
||||||
|
<li><code>!!! note</code>
|
||||||
|
</li>
|
||||||
|
<li><code>!!! tip</code>
|
||||||
|
</li>
|
||||||
|
<li><code>!!! important</code>
|
||||||
|
</li>
|
||||||
|
<li><code>!!! caution</code>
|
||||||
|
</li>
|
||||||
|
<li><code>!!! warning</code>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
<p>In addition to that, it's also possible to type <code>!!! </code> followed
|
||||||
|
by any text, case in which a default admonition type will appear (note)
|
||||||
|
with the entered text inside it.</p>
|
||||||
|
<h2>Interaction</h2>
|
||||||
|
<p>By design, admonitions act very similar to block quotes.</p>
|
||||||
|
<ul>
|
||||||
|
<li>Selecting a text and pressing the admonition button will turn that text
|
||||||
|
into an admonition.</li>
|
||||||
|
<li>If selecting multiple admonitions, pressing the admonition button will
|
||||||
|
automatically merge them into one.</li>
|
||||||
|
</ul>
|
||||||
|
<p>Inside an admonition:</p>
|
||||||
|
<ul>
|
||||||
|
<li>Pressing <kbd>Backspace</kbd> while the admonition is empty will remove
|
||||||
|
it.</li>
|
||||||
|
<li>Pressing <kbd>Enter</kbd> will start a new paragraph. Pressing it twice
|
||||||
|
will exit out of the admonition.</li>
|
||||||
|
<li>Headings and other block content including tables can be inserted inside
|
||||||
|
the admonition.</li>
|
||||||
|
</ul>
|
||||||
|
<h2>Types of admonitions</h2>
|
||||||
|
<p>There are currently five types of admonitions: <em>Note</em>, <em>Tip</em>, <em>Important</em>, <em>Caution</em>, <em>Warning</em>.</p>
|
||||||
|
<p>These types were inspired by GitHub's support for this feature and there
|
||||||
|
are currently no plans for adjusting it or allowing the user to customize
|
||||||
|
them.</p>
|
||||||
|
<h2>Markdown support</h2>
|
||||||
|
<p>The Markdown syntax for admonitions as supported by Trilium is the one
|
||||||
|
that GitHub uses, which is as follows:</p><pre><code class="language-text-x-markdown">> [!NOTE]
|
||||||
|
> This is a note.
|
||||||
|
|
||||||
|
> [!TIP]
|
||||||
|
> This is a tip.
|
||||||
|
|
||||||
|
> [!IMPORTANT]
|
||||||
|
> This is a very important information.
|
||||||
|
|
||||||
|
> [!CAUTION]
|
||||||
|
> This is a caution.</code></pre>
|
||||||
|
<p>There are currently no plans of supporting alternative admonition syntaxes
|
||||||
|
such as <code>!!! note</code>.</p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</body>
|
||||||
|
|
||||||
|
</html>
|
||||||
BIN
src/public/app/doc_notes/en/User Guide/User Guide/Note Types/Text/Admonitions_image.png
generated
Normal file
BIN
src/public/app/doc_notes/en/User Guide/User Guide/Note Types/Text/Admonitions_image.png
generated
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 7.0 KiB |
@ -172,6 +172,8 @@
|
|||||||
<ul>
|
<ul>
|
||||||
<li><a href="User%20Guide/Note%20Types/Text.html" target="detail">Text</a>
|
<li><a href="User%20Guide/Note%20Types/Text.html" target="detail">Text</a>
|
||||||
<ul>
|
<ul>
|
||||||
|
<li><a href="User%20Guide/Note%20Types/Text/Admonitions.html" target="detail">Admonitions</a>
|
||||||
|
</li>
|
||||||
<li><a href="User%20Guide/Note%20Types/Text/Code%20blocks.html" target="detail">Code blocks</a>
|
<li><a href="User%20Guide/Note%20Types/Text/Code%20blocks.html" target="detail">Code blocks</a>
|
||||||
</li>
|
</li>
|
||||||
<li><a href="User%20Guide/Note%20Types/Text/Content%20language%20%26%20Right-to-le.html"
|
<li><a href="User%20Guide/Note%20Types/Text/Content%20language%20%26%20Right-to-le.html"
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user