Skip to content

Build your personal knowledge base with Trilium Notes

Merge branch 'main' of https://github.com/TriliumNext/Trilium into feat/text-editor-improvements-9

Adorian Doran70f63425bd2e
diff --git a/.claude/skills/in-app-help/SKILL.md b/.claude/skills/in-app-help/SKILL.md
new file mode 100644
index 0000000000..0e8c490777
--- /dev/null
+++ b/.claude/skills/in-app-help/SKILL.md
@@ -0,0 +1,96 @@
+---
+name: in-app-help
+description: Use when touching Trilium's in-app help (the `_help` subtree) — regenerating it after a docs change, changing how pages, links, images or attachments are produced or served, wiring a new platform to it, or debugging "help page is blank / images are broken / search finds nothing". Covers the markdown-to-artifacts pipeline, the four packaging paths that each need their own asset copy, and the verification recipe that catches the failures status codes hide.
+---
+
+# Trilium's in-app help
+
+The User Guide is authored as notes, exported **once** as markdown, and turned into two committed artifacts that every platform reads.
+
+```
+docs/User Guide/**.md authored source, exported by edit-docs (the only export)
+ └─ edit-docs
+ ├─ apps/server/src/assets/help/help_meta.json the note tree
+ └─ apps/server/src/assets/help/help_content.json each page rendered, keyed by note ID
+docs/User Guide/**.png|gif|dat images and attachments, committed only here
+```
+
+Both JSON files are **generated**. Never hand-edit them — run `pnpm edit-docs:edit-docs` and let the export rewrite them. If you need to regenerate without the Electron app (e.g. after changing a generator), call `buildHelpMeta` / `buildHelpBundle` directly against `docs/User Guide/!!!meta.json`; they are pure functions taking injected readers.
+
+Help pages are **virtual notes** — becca-only, never persisted or synced, read-only through an inheritable `readOnly` label on the `_help` root. See `packages/trilium-core/src/services/virtual_notes.ts`.
+
+## The pieces
+
+| Concern | Where |
+|---|---|
+| Tree generation | `apps/edit-docs/src/help_meta_generator.ts` |
+| Content generation, link + asset rewriting | `apps/edit-docs/src/help_bundle_generator.ts` |
+| Injection into becca | `packages/trilium-core/src/becca/becca_loader.ts` |
+| Provider contract, `{{helpAssets}}` substitution | `packages/trilium-core/src/services/in_app_help.ts` |
+| Blob POJO for virtual notes | `packages/trilium-core/src/services/blob.ts` |
+| Content search over virtual notes | `.../search/expressions/note_content_fulltext.ts` |
+| Assistant search | `packages/trilium-core/src/services/llm/tools/help_tools.ts` |
+| End-to-end guard | `apps/server/spec/in_app_help.spec.ts` |
+
+`HelpMetaItem.source` is the page's markdown file; `dir` is set for folder notes, which have no file and are linked by directory. Links become `#root/_help_<noteId>`; assets become `{{helpAssets}}/<path from the export root>`, substituted per platform by `getHelpAssetBase()`.
+
+## Assets need a copy step per packaging path
+
+Images live **only** in `docs/User Guide/`. Four paths ship them, and missing one breaks only that one:
+
+- **server** — `getHelpAssetDir()` in `routes/assets.ts` (reads `docs/User Guide` when `isDev`); `apps/server/scripts/build.ts` copies for the package
+- **desktop** — runs the server, but its build copies `apps/server/src/assets`, which is *not* where these live, so `apps/desktop/scripts/build.ts` needs its own copy
+- **standalone** — `copyHelpAssetsPlugin` in `apps/standalone/vite.config.mts`, which must have **both** a `configureServer` middleware (dev) and a `closeBundle` copy (build)
+- **mobile** — inherits the standalone dist via `webDir`; every megabyte here lands in the APK/IPA
+
+## A 200 does not mean it works
+
+Both dev servers answer unknown paths under their asset prefixes with `index.html`. A missing route returns **200 `text/html`**, so `curl -w "%{http_code}"` and any status-only assertion pass while every image is broken. This has bitten twice.
+
+Always check the content type:
+
+```bash
+curl -s -D - -o /dev/null "http://localhost:8080/assets/v<version>/help/<path>" | grep -i content-type
+```
+
+Sweep every asset the bundle references — `<port>` is 8080 for `server:start`, 5173 for `standalone:start`:
+
+```bash
+node -e "const b=require('./apps/server/src/assets/help/help_content.json');
+ const u=[...new Set([...Object.values(b).join('').matchAll(/\{\{helpAssets\}\}\/([^\"]*)/g)].map(m=>m[1]))];
+ require('fs').writeFileSync(process.env.TEMP+'/asseturls.txt', u.join('\n')); console.log(u.length)"
+
+while IFS= read -r u; do
+ ct=$(curl -s -D - -o /dev/null "http://localhost:8080/assets/v0.104.1/help/$u" | grep -i "^content-type" | tr -d '\r')
+ case "$ct" in *image/*|*octet-stream*) ;; *) echo "BAD $ct <- $u";; esac
+done < "$TEMP/asseturls.txt"
+```
+
+For a build, resolve the same URLs against the output tree instead:
+
+```bash
+node -e "const fs=require('fs'),p=require('path');
+ const b=require('./apps/server/src/assets/help/help_content.json');
+ const u=[...new Set([...Object.values(b).join('').matchAll(/\{\{helpAssets\}\}\/([^\"]*)/g)].map(m=>m[1]))];
+ const root='apps/standalone/dist/server-assets/help';
+ console.log('missing:', u.filter(x=>!fs.existsSync(p.join(root, decodeURIComponent(x)))).length)"
+```
+
+Getting the copy *destination depth* wrong is easy and silent: the export root `docs/User Guide` itself contains a `User Guide/` directory, and asset paths are relative to that root — so the copy target is `…/help`, not `…/help/User Guide`.
+
+## Debugging a broken help page
+
+- **Blank page, no error** — the provider has no content: standalone's fetch failed (check the worker console) or `getHelpContent()` returned `{}`
+- **Error instead of a page** — the blob path: virtual notes have no `blobs` row, so `getBlobPojo` must take its virtual branch
+- **Broken images** — a copy step or a dev middleware is missing; run the sweep above rather than trusting a status code
+- **Dead cross-links** — links that didn't resolve stay as authored `.md` paths; the client spec `apps/client/src/services/in_app_help.spec.ts` checks every link in the markdown
+- **Search finds nothing** — two separate paths: the user-facing search matches virtual notes only via the pass in `note_content_fulltext.ts`, and only when the query includes hidden notes; the assistant's `search_help` builds its own index from `note.getContent()`
+
+## Tests to run
+
+```bash
+pnpm --filter edit-docs test --run # generators
+pnpm --filter server test --run spec/in_app_help.spec.ts # shipped artifacts, end to end
+pnpm --filter client test --run src/services/in_app_help.spec.ts
+pnpm --filter standalone test --run src/lightweight/in_app_help_provider.spec.ts
+```
diff --git a/.claude/skills/writing-documentation/SKILL.md b/.claude/skills/writing-documentation/SKILL.md
index 00453d1901..2a7da2bb9b 100644
--- a/.claude/skills/writing-documentation/SKILL.md
+++ b/.claude/skills/writing-documentation/SKILL.md
@@ -1,15 +1,16 @@
---
name: writing-documentation
-description: Use whenever a change is user-facing — a new feature, a moved or removed button, a label, a shortcut, an option, a default, a note type, a collection view, a dialog, an import format — or when asked to write, fix, restructure or audit Trilium's documentation ("document this", "update the User Guide", "add a page for X", "is X documented?", "which page describes X?", "the docs still say…", "rename/move this page", "add a screenshot", "which icon do I use?"). Covers the three docs trees (`docs/User Guide`, `docs/Developer Guide`, `docs/Release Notes`) and the generated in-app help they feed, the `!!!meta.json` note metadata (noteId, shareAlias, iconClass, attachments), the house style of the User Guide (register, page templates, reference-link pills, `<kbd>`, admonitions, figures, the `bx`/`cke`/`tn-brand` icon spans), and `docs.mjs`, which finds and shows pages, scaffolds a page with correct metadata, registers images, renames/moves/deletes pages, maps a code diff to the pages it affects, audits the trees, and regenerates the help HTML headless — so `!!!meta.json` and `apps/server/src/assets/doc_notes` never have to be read or hand-edited. A user-facing change is not finished until the User Guide describes it, in the same commit.
+description: Use whenever a change is user-facing — a new feature, a moved or removed button, a label, a shortcut, an option, a default, a note type, a collection view, a dialog, an import format — or when asked to write, fix, restructure or audit Trilium's documentation ("document this", "update the User Guide", "add a page for X", "is X documented?", "which page describes X?", "the docs still say…", "rename/move this page", "add a screenshot", "which icon do I use?"). Covers the three docs trees (`docs/User Guide`, `docs/Developer Guide`, `docs/Release Notes`) and the generated in-app help they feed, the `!!!meta.json` note metadata (noteId, shareAlias, iconClass, attachments), the house style of the User Guide (register, page templates, reference-link pills, `<kbd>`, admonitions, figures, the `bx`/`cke`/`tn-brand` icon spans), and `docs.mjs`, which finds and shows pages, scaffolds a page with correct metadata, registers images, renames/moves/deletes pages, maps a code diff to the pages it affects, audits the trees, and regenerates the in-app help headless — so `!!!meta.json` and `apps/server/src/assets/help` never have to be read or hand-edited. A user-facing change is not finished until the User Guide describes it, in the same commit.
---
# Writing Trilium's documentation
Trilium's User Guide is a tree of Trilium notes, exported to Markdown under `docs/User Guide/` and
described by `docs/User Guide/!!!meta.json`. From that Markdown the repo generates the **in-app help**
-(`apps/server/src/assets/doc_notes/en/User Guide/**/*.html` + a minified help meta, and
-`apps/standalone/src/assets/help_meta.json`) and the public site (docs.triliumnotes.org). The Markdown
-is the source; everything under `doc_notes` and `help_meta.json` is generated and never hand-edited.
+(`apps/server/src/assets/help/help_meta.json`, the tree, and `help_content.json`, each page's HTML)
+and the public site (docs.triliumnotes.org). The Markdown is the source; both help files are
+generated and never hand-edited. The help pages are virtual notes built from them at startup, not
+notes in the database.
Every mechanical step is [docs.mjs](docs.mjs):
@@ -23,7 +24,7 @@ node $D new Collections "Timeline" --icon bx-time-five --after Dashboard # sca
node $D image timeline shot.png # register a screenshot; prints the <figure> to paste
node $D icons quote --pack cke # icon classes for a toolbar button / app control
node $D rename timeline "Timeline view" # retitle; move <page> <parent>; delete <page>
-node $D sync # regenerate Markdown, help HTML and help metas headless
+node $D sync # regenerate Markdown and both help artifacts headless
node $D check # meta ↔ disk, links, images, icons, aliases, code refs, style
```
@@ -41,11 +42,11 @@ The workflow, every time:
for the names the diff cannot know. **Read every hit** — a page describing a control that moved,
a label that changed or a default that flipped is wrong until edited.
2. Edit the Markdown (below), or `new` a page for a feature no page covers.
-3. `node $D sync` — normalizes your Markdown the way the editor would and regenerates the help HTML
- and both help metas. Review `git diff -- docs` (what the round trip did to your text) and
- `git diff --stat -- apps/server/src/assets/doc_notes`.
+3. `node $D sync` — normalizes your Markdown the way the editor would and regenerates both help
+ artifacts. Review `git diff -- docs` (what the round trip did to your text) and
+ `git diff --word-diff -- apps/server/src/assets/help/help_content.json`.
4. `node $D check` — must report 0 errors (a handful are pre-existing, listed at the end).
-5. Commit the code, the Markdown, `!!!meta.json`, the `doc_notes` HTML and `help_meta.json` together.
+5. Commit the code, the Markdown, `!!!meta.json`, `help_meta.json` and `help_content.json` together.
Two traps `CLAUDE.md` names still apply: verify **where a control actually mounts** by grepping the
component, not by inference; and a widened **capability gate** (a note type added to a list a widget
@@ -95,13 +96,12 @@ paste into the parent page. Then write the body, `image` the screenshots, `sync`
- **Alias** defaults to the kebab-case title; pass `--alias` to shorten (`setup`, `docker`, `mfa`,
`and` for `&`). The public URL is the chain of ancestor aliases, so it only has to be unique among
- siblings; a page without one has no URL and is dropped from the standalone help. Once published, an
+ siblings; a page without one has no public URL and no `docUrl` in the in-app help. Once published, an
alias is an external link (README ×41, website, web clipper, about dialog) — `show` lists who uses it.
- **Icon**: the feature's own icon — a note type's `NOTE_TYPE_ICONS` entry, a collection's template
icon in `hidden_subtree_templates.ts`, otherwise `icons <query>`. Boxicons (`bx bx-…`) only for
`iconClass`.
-- **Title characters**: letters, digits, space, `_ - ( ) & . , \``. The in-app help refuses anything
- else (`doc_renderer.ts`), and `new` refuses too. `/`, `:` and `"` are dropped from the file name.
+- **Title characters**: `/ \ : * ? " < > |` are dropped from the file name.
- **Wire it into the app** when the page documents a surface with a help affordance: `<HelpButton
helpPage="<noteId>">` (settings panes, dialogs), `helpPageId` on a `Modal`, or the maps in
`apps/client/src/services/in_app_help.ts` (`byNoteType`, `byBookType`, sidebar sections). The app
diff --git a/.claude/skills/writing-documentation/docs.mjs b/.claude/skills/writing-documentation/docs.mjs
index 168538c548..ccbff45985 100644
--- a/.claude/skills/writing-documentation/docs.mjs
+++ b/.claude/skills/writing-documentation/docs.mjs
@@ -16,15 +16,15 @@
* icons <query...> [--pack bx|cke|tn-brand] search the icon fonts the docs can use
* impact [--diff [range]] [terms...] which pages a code change or a term touches
* check [--tree t] consistency + style audit of the trees
- * sync regenerate everything (help HTML, meta) headless
+ * sync regenerate everything (help meta + content) headless
*
* <page> a noteId, a shareAlias, or a unique title/path fragment. <parent> likewise.
* --tree user (default) | dev | release
*
- * The meta file is 6000+ lines and the HTML mirror is generated, so nothing here should ever
- * need either read by hand. `new`/`image`/`rename`/`move`/`delete` edit `!!!meta.json` through
- * the file's own layout (4-space indent, exporter key order); `sync` then makes the Markdown,
- * the help HTML and the standalone meta agree, the same way edit-docs does after an edit.
+ * The meta file is 6000+ lines and the in-app help artifacts are generated, so nothing here should
+ * ever need either read by hand. `new`/`image`/`rename`/`move`/`delete` edit `!!!meta.json`
+ * through the file's own layout (4-space indent, exporter key order); `sync` then makes the
+ * Markdown, `help_meta.json` and `help_content.json` agree, the same way edit-docs does after an edit.
*/
import { execFileSync, spawnSync } from "node:child_process";
import crypto from "node:crypto";
@@ -43,9 +43,8 @@ const TREES = {
user: {
dir: "docs/User Guide",
rootId: "pOsGYCXsbNQG",
- html: "apps/server/src/assets/doc_notes/en/User Guide",
- helpMeta: "apps/server/src/assets/doc_notes/en/User Guide/!!!meta.json",
- standaloneMeta: "apps/standalone/src/assets/help_meta.json"
+ helpMeta: "apps/server/src/assets/help/help_meta.json",
+ helpContent: "apps/server/src/assets/help/help_content.json"
},
dev: { dir: "docs/Developer Guide", rootId: "jdjRLhLV3TtI" },
release: { dir: "docs/Release Notes", rootId: "hD3V4hiu2VW4" }
@@ -65,9 +64,6 @@ const BUILT_ICON_PACKS = {
"tn-brand": { font: "brand-icons.woff2", missing: () => staleBrandIcons() }
};
-/** `apps/client/src/services/doc_renderer.ts` refuses any other character in a help page path. */
-const DOC_NAME_CHARS = /^[a-zA-Z0-9_/\- ()&.,`]+$/;
-
/** Where the app hard-codes help pages (by noteId) and public docs URLs (by alias path). */
const CODE_SCAN_DIRS = ["apps/client/src", "apps/server/src", "apps/desktop/src", "apps/standalone/src", "apps/website/src", "apps/web-clipper", "apps/edit-docs/demo", "packages/trilium-core/src", "packages/commons/src"];
const URL_SCAN_FILES = ["README.md", ...CODE_SCAN_DIRS];
@@ -131,9 +127,8 @@ function show() {
console.log(` path ${page.ancestors.map((a) => a.title).concat(page.title).join(" › ")}`);
console.log(` position ${page.entry.notePosition ?? "(clone)"} siblings: ${page.parent ? page.parent.entry.children.length : 0}`);
console.log(` type ${page.entry.type}${page.entry.mime ? ` (${page.entry.mime})` : ""}`);
- console.log(` alias ${page.alias ?? "(none — no docUrl, dropped from the standalone help)"}`);
+ console.log(` alias ${page.alias ?? "(none — no public URL, no docUrl in the in-app help)"}`);
console.log(` url ${page.url ?? "(none)"}`);
- if (page.treeName === "user") console.log(` docName ${page.docName ?? "(none)"}`);
console.log(` icon ${page.icon ?? "(none → bx bx-file / bx bx-folder)"}`);
const otherAttrs = (page.entry.attributes ?? []).filter((a) => !["shareAlias", "iconClass"].includes(a.name));
if (otherAttrs.length) console.log(` attributes ${otherAttrs.map((a) => `${a.type === "relation" ? "~" : "#"}${a.name}=${a.value}`).join(" ")}`);
@@ -162,8 +157,8 @@ function show() {
console.log(` referenced from code: ${refs.length ? "" : "none — safe to rename, move or delete"}`);
for (const r of refs) console.log(` ${r}`);
if (page.treeName === "user" && page.file) {
- const html = page.file.replace(/\.md$/, ".html").replace(TREES.user.dir, TREES.user.html);
- console.log(` help html ${fs.existsSync(path.join(ROOT, html)) ? html : "(missing — run sync)"}`);
+ const html = readHelpContent()[`_help_${page.noteId}`];
+ console.log(` help html ${html === undefined ? "(missing — run sync)" : `${html.length} chars in ${TREES.user.helpContent}`}`);
}
}
@@ -240,7 +235,7 @@ function newPage() {
console.log(`created ${filePath}`);
console.log(` noteId ${noteId} alias ${alias ?? "(none)"} icon ${icon ?? "(none)"} position ${entry.notePosition}`);
if (alias) console.log(` url ${computeUrl(parent, alias)}`);
- console.log(`\nWrite the page, then \`docs.mjs sync\` to normalize it and generate the help HTML.`);
+ console.log(`\nWrite the page, then \`docs.mjs sync\` to normalize it and regenerate the in-app help.`);
console.log(`Link it from its parent with:\n <a class="reference-link" href="${relativeHref(parent, { ...entry, file: filePath })}">${escapeHtml(title)}</a>`);
}
@@ -272,7 +267,7 @@ function image() {
} else {
console.log(` <img src="${src}">`);
}
- console.log(`Then \`docs.mjs sync\` copies it into the help HTML tree.`);
+ console.log(`Then \`docs.mjs sync\` rewrites its path in the in-app help.`);
}
function rename() {
@@ -394,7 +389,7 @@ function impact() {
const pagesFromCode = new Map(); // noteId → files
if (flags.diff !== undefined) {
const range = typeof flags.diff === "string" ? flags.diff : defaultDiffBase();
- const diff = git(["diff", range, "--", "apps", "packages", ":!apps/server/src/assets/doc_notes", ":!apps/standalone/src/assets/help_meta.json"]);
+ const diff = git(["diff", range, "--", "apps", "packages", `:!${TREES.user.helpMeta}`, `:!${TREES.user.helpContent}`]);
let file = "";
const touched = new Set();
for (const line of diff.split("\n")) {
@@ -456,7 +451,7 @@ function check() {
const index = loadTree(treeName);
checkStructure(index, errors, warnings);
checkContent(index, errors, warnings);
- if (treeName === "user") checkHtmlMirror(index, errors, warnings);
+ if (treeName === "user") checkHelpArtifacts(index, errors, warnings);
}
warnings.push(...staleIconFonts(Object.keys(BUILT_ICON_PACKS)));
if (trees.includes("user")) {
@@ -480,12 +475,11 @@ function sync() {
die("sync failed — the import rejects a tree whose !!!meta.json and files disagree; run `check`");
}
const after = gitStatusDocs();
- const groups = { "docs/ Markdown": [], "docs/ !!!meta.json": [], "help HTML (doc_notes)": [], "help meta": [], images: [] };
+ const groups = { "docs/ Markdown": [], "docs/ !!!meta.json": [], "help artifacts": [], images: [] };
for (const [status, file] of after) {
const bucket = /!!!meta\.json$/.test(file) && file.startsWith("docs/") ? "docs/ !!!meta.json"
- : /help_meta\.json$|doc_notes.*!!!meta\.json$/.test(file) ? "help meta"
: /\.(png|gif|webp|jpe?g|svg)$/i.test(file) ? "images"
- : file.startsWith("docs/") ? "docs/ Markdown" : "help HTML (doc_notes)";
+ : file.startsWith("docs/") ? "docs/ Markdown" : "help artifacts";
groups[bucket].push(`${status} ${file}`);
}
const changedBySync = after.filter(([, f]) => !before.some(([, g]) => g === f)).length;
@@ -496,7 +490,7 @@ function sync() {
for (const f of files.slice(0, 8)) console.log(` ${f}`);
if (files.length > 8) console.log(` … ${files.length - 8} more`);
}
- console.log(`\nReview with \`git diff -- docs\` (your Markdown, normalized) and \`git diff --stat -- apps/server/src/assets/doc_notes\`.`);
+ console.log(`\nReview with \`git diff -- docs\` (your Markdown, normalized) and \`git diff --word-diff -- ${TREES.user.helpContent}\`.`);
console.log(`Reflow, shifted &nbsp; and <li><p> churn in the HTML is expected; a changed href, a dropped <img> or lost text is not.`);
}
@@ -555,9 +549,8 @@ function checkStructure(index, errors, warnings) {
if (i > 0 && siblings[i - 1].notePosition > page.entry.notePosition) errors.push(`${where}: children are not in ascending notePosition order`);
else if (i > 0 && siblings[i - 1].notePosition === page.entry.notePosition) warnings.push(`${where}: shares notePosition ${page.entry.notePosition} with "${siblings[i - 1].title}"`);
}
- if (treeName === "user" && page.docName && !DOC_NAME_CHARS.test(page.docName)) errors.push(`${where}: title/folder has a character the in-app help refuses (allowed: letters, digits, _ - ( ) & . , \` and space)`);
if (page.entry.type === "text" && page.file && treeName !== "release") {
- if (!page.alias) warnings.push(`${where}: no shareAlias — no public URL, and dropped from the standalone help`);
+ if (!page.alias) warnings.push(`${where}: no shareAlias — no public URL`);
if (!page.icon && treeName === "user") warnings.push(`${where}: no iconClass`);
}
if (page.alias && !/^[a-z0-9]+([.-][a-z0-9]+)*$/.test(page.alias)) warnings.push(`${where}: shareAlias "${page.alias}" is not kebab-case`);
@@ -639,14 +632,16 @@ function checkContent(index, errors, warnings) {
}
}
-function checkHtmlMirror(index, errors, warnings) {
+function checkHelpArtifacts(index, errors, warnings) {
const status = gitStatusDocs();
const modifiedMd = status.filter(([, f]) => f.startsWith(`${TREES.user.dir}/`) && f.endsWith(".md")).map(([, f]) => f);
+ const content = readHelpContent();
for (const page of index.pages) {
- if (!page.file || page.depth === 0) continue;
- const html = page.file.replace(/\.md$/, ".html").replace(TREES.user.dir, TREES.user.html);
- if (page.file.endsWith(".md") && !fs.existsSync(path.join(ROOT, html))) { errors.push(`user: ${page.relPath} has no help HTML twin — run \`sync\``); continue; }
- if (modifiedMd.includes(page.file) && !status.some(([, f]) => f === html)) warnings.push(`user: ${page.relPath} is modified but its help HTML is not — run \`sync\``);
+ if (!page.file?.endsWith(".md") || page.depth === 0 || page.isClone) continue;
+ if (content[`_help_${page.noteId}`] === undefined) errors.push(`user: ${page.relPath} has no entry in ${TREES.user.helpContent} — run \`sync\``);
+ }
+ if (modifiedMd.length && !status.some(([, f]) => f === TREES.user.helpContent)) {
+ warnings.push(`user: ${modifiedMd.length} page(s) modified but ${TREES.user.helpContent} is not — run \`sync\``);
}
const helpMeta = JSON.parse(fs.readFileSync(path.join(ROOT, TREES.user.helpMeta), "utf-8"));
const helpIds = new Set();
@@ -703,7 +698,7 @@ function checkIconUsage(index) {
// Tree model
// ---------------------------------------------------------------------------------------------
-/** Reads a tree's `!!!meta.json` and indexes every entry with its path, URL and docName. */
+/** Reads a tree's `!!!meta.json` and indexes every entry with its path and URL. */
function loadTree(treeName) {
if (treeCache.has(treeName)) return treeCache.get(treeName);
const tree = TREES[treeName];
@@ -712,7 +707,7 @@ function loadTree(treeName) {
const raw = fs.readFileSync(metaPath, "utf-8");
const meta = JSON.parse(raw);
const index = { treeName, tree, meta, metaPath, raw, pages: [], byId: new Map(), root: null };
- const visit = (entry, parent, dir, parentUrl, docNameRoot) => {
+ const visit = (entry, parent, dir, parentUrl) => {
const alias = entry.attributes?.find((a) => a.type === "label" && a.name === "shareAlias")?.value;
const currentUrl = parentUrl && alias ? `${parentUrl}/${alias}` : parentUrl;
const page = {
@@ -726,15 +721,13 @@ function loadTree(treeName) {
children: []
};
page.relPath = page.file ?? path.join(dir, entry.dirFileName ?? entry.title);
- page.docName = treeName === "user" && entry.type === "text" && entry.dataFileName ? `${docNameRoot}/${path.basename(entry.dataFileName, ".md")}`.substring(1) : undefined;
index.pages.push(page);
if (!page.isClone) index.byId.set(entry.noteId, page);
const childDir = entry.dirFileName ? path.join(dir, entry.dirFileName) : dir;
- const childDocRoot = entry.dirFileName ? `${docNameRoot}/${entry.dirFileName}` : docNameRoot;
- for (const child of entry.children ?? []) page.children.push(visit(child, page, childDir, currentUrl, childDocRoot));
+ for (const child of entry.children ?? []) page.children.push(visit(child, page, childDir, currentUrl));
return page;
};
- index.root = visit(meta.files[0], null, tree.dir, BASE_URL, `/${meta.files[0].dirFileName ?? ""}`);
+ index.root = visit(meta.files[0], null, tree.dir, BASE_URL);
treeCache.set(treeName, index);
return index;
}
@@ -859,8 +852,6 @@ function otherTreesHave(id) {
function checkTitle(title, parent, self) {
if (!title.trim()) die("empty title");
- const docName = `${parent ? childrenDir(parent) : ""}/${sanitize(title)}`;
- if (parent && parent.treeName === "user" && !DOC_NAME_CHARS.test(docName.replace(/^docs\/User Guide\//, ""))) die(`the in-app help cannot open a page whose title has characters outside letters, digits, _ - ( ) & . , \` and space: "${title}"`);
const fileBase = sanitize(title).toLowerCase();
for (const c of parent?.entry.children ?? []) {
if (c === self?.entry) continue;
@@ -1011,7 +1002,7 @@ function unescapeHtml(s) {
function grep(pattern, paths) {
const existing = paths.filter((p) => fs.existsSync(path.join(ROOT, p)));
- const result = spawnSync("grep", ["-rnoE", "--include=*.ts", "--include=*.tsx", "--include=*.js", "--include=*.json", "--include=*.md", "--include=*.html", "--exclude-dir=node_modules", "--exclude-dir=dist", "--exclude-dir=doc_notes", "--exclude=help_meta.json", pattern, ...existing], { cwd: ROOT, encoding: "utf-8", maxBuffer: 64 * 1024 * 1024 });
+ const result = spawnSync("grep", ["-rnoE", "--include=*.ts", "--include=*.tsx", "--include=*.js", "--include=*.json", "--include=*.md", "--include=*.html", "--exclude-dir=node_modules", "--exclude-dir=dist", "--exclude=help_meta.json", "--exclude=help_content.json", pattern, ...existing], { cwd: ROOT, encoding: "utf-8", maxBuffer: 64 * 1024 * 1024 });
return (result.stdout ?? "").split("\n").filter(Boolean);
}
@@ -1019,8 +1010,12 @@ function git(argv) {
return execFileSync("git", argv, { cwd: ROOT, encoding: "utf-8", maxBuffer: 256 * 1024 * 1024 });
}
+function readHelpContent() {
+ return JSON.parse(fs.readFileSync(path.join(ROOT, TREES.user.helpContent), "utf-8"));
+}
+
function gitStatusDocs() {
- return git(["status", "--porcelain", "--", "docs", TREES.user.html, TREES.user.standaloneMeta]).split("\n").filter(Boolean).map((l) => [l.slice(0, 2).trim() || "M", l.slice(3).replace(/^"|"$/g, "").replace(/\\"/g, '"')]);
+ return git(["status", "--porcelain", "--", "docs", TREES.user.helpMeta, TREES.user.helpContent]).split("\n").filter(Boolean).map((l) => [l.slice(0, 2).trim() || "M", l.slice(3).replace(/^"|"$/g, "").replace(/\\"/g, '"')]);
}
function defaultDiffBase() {
diff --git a/.claude/skills/writing-documentation/references/pipeline.md b/.claude/skills/writing-documentation/references/pipeline.md
index 62759cebb5..1f9de0e106 100644
--- a/.claude/skills/writing-documentation/references/pipeline.md
+++ b/.claude/skills/writing-documentation/references/pipeline.md
@@ -4,7 +4,7 @@
| Tree | Root noteId | Source | Generated from it |
| --- | --- | --- | --- |
-| User Guide | `pOsGYCXsbNQG` | `docs/User Guide/` (Markdown + `!!!meta.json`) | `apps/server/src/assets/doc_notes/en/User Guide/**/*.html` + its minified `!!!meta.json`; `apps/standalone/src/assets/help_meta.json`; `site/user-guide` on the docs site |
+| User Guide | `pOsGYCXsbNQG` | `docs/User Guide/` (Markdown + `!!!meta.json`) | `apps/server/src/assets/help/help_meta.json` (the tree) + `help_content.json` (each page's HTML, keyed by `_help_<noteId>`); `site/user-guide` on the docs site |
| Developer Guide | `jdjRLhLV3TtI` | `docs/Developer Guide/` | `site/developer-guide` |
| Release Notes | `hD3V4hiu2VW4` | `docs/Release Notes/` | the GitHub release body (`scripts/release-notes-body.mts`, `release.yml`) |
@@ -16,14 +16,15 @@ headless sync read it.
`pnpm edit-docs:edit-docs` (`apps/edit-docs/src/edit-docs.ts`) zips every non-`exportOnly` mapping,
imports it into an in-memory database with `preserveIds: true`, opens an Electron window, and — 10 s
after any entity change — `rm -rf`s **every** mapping's directory and re-exports it from the
-database: Markdown for the three trees, HTML for the User Guide. Nothing exports on close, and an
+database as Markdown, then derives the two help artifacts from the User Guide's export (the
+`helpMeta` / `helpContent` keys of its mapping). Nothing exports on close, and an
untouched session writes nothing.
`pnpm edit-docs:sync-docs` (`apps/edit-docs/src/sync-docs.ts`, `docs.mjs sync`) is the same import
and the same export with no window: `apps/edit-docs/src/docs_pipeline.ts` holds the shared code.
Running it on a clean tree is byte-stable; running it after a hand edit normalizes the Markdown the
way the editor would (the import renders Markdown to HTML, the export turns it back) and regenerates
-the HTML and both help metas. ~7 s.
+both help artifacts. ~7 s.
Consequences:
@@ -37,7 +38,7 @@ Consequences:
first H1 and demotes a differing one.
- `internalLink` / `imageLink` relations are never in the meta — they are rebuilt from content.
- `pnpm docs:build` (`apps/build-docs`) is the **site** build: it imports `docs/` again and share-exports
- it to `site/`, ignoring `edit-docs-config.yaml`. It is not a way to regenerate `doc_notes`.
+ it to `site/`, ignoring `edit-docs-config.yaml`. It is not a way to regenerate the help artifacts.
## `!!!meta.json` (formatVersion 2)
@@ -67,29 +68,33 @@ attachments, dirFileName, children`. Types: `packages/trilium-core/src/meta.ts`;
## What the app reads
-- **In-app help** (`F1`, help buttons): `apps/server/src/in_app_help_provider.ts` loads
- `doc_notes/en/User Guide/!!!meta.json` — a minified `HiddenSubtreeItem[]` (not a NoteMetaFile)
- built by `apps/edit-docs/src/help_meta_generator.ts`: each page becomes `_help_<noteId>` of type
- `doc` with `#docName` (`User Guide/User Guide/<folders>/<title>`), `#docUrl` (the alias chain) and
- `#iconClass`. `checkHiddenSubtree()` materializes it under `_help`; `doc_renderer.ts` fetches
- `doc_notes/en/<docName>.html` and refuses a docName outside `[a-zA-Z0-9_/\- ()&.,\`]`.
-- **Standalone/mobile**: `apps/standalone/src/assets/help_meta.json` — the same tree as `webView`
- items pointing at `docUrl`; a page without an alias is dropped.
+- **In-app help** (`F1`, help buttons): `help_meta.json` is a `HiddenSubtreeItem[]` (not a
+ NoteMetaFile) built by `apps/edit-docs/src/help_meta_generator.ts`: each page becomes
+ `_help_<noteId>` with its own type, `#docUrl` (the alias chain, absent without a `shareAlias`)
+ and `#iconClass`. `help_content.json` (`help_bundle_generator.ts`) maps each ID to its HTML, with
+ links rewritten to `#root/_help_<noteId>` and assets to `{{helpAssets}}/<path>`. The pages are
+ **virtual notes**: `in_app_help.ts` in core registers a provider that builds the `_help` subtree
+ in becca on every load — never stored in the database, never synced, read-only. Server/desktop
+ read both files through `apps/server/src/in_app_help_provider.ts`, standalone/mobile through
+ `apps/standalone/src/lightweight/in_app_help_provider.ts`. Images stay in `docs/User Guide/`;
+ the `in-app-help` skill covers how each platform serves them.
- **Help buttons link by noteId** (`<HelpButton helpPage="…">` → `openInAppHelpFromUrl` →
`_help_<id>`; `Modal helpPageId`; `services/in_app_help.ts` maps note types, collection views and
sidebar sections). ~60 IDs are hard-coded in `apps/client/src`; `docs.mjs show` lists them per page
and `check` fails when one points nowhere. `apps/client/src/services/in_app_help.spec.ts` is the CI
- guard for the `in_app_help.ts` maps, the docName files and the `_help_` links inside the HTML.
+ guard for the `in_app_help.ts` maps against `help_meta.json`.
- **Public URL** = `https://docs.triliumnotes.org` + `/` + each ancestor's `shareAlias` (ancestors
without one contribute nothing). Unique as a full path, not globally (`troubleshooting` is used
three times). Hard-coded in `README.md` (mirrored to 40 translated READMEs by CI), `apps/website`,
`apps/web-clipper`, the about dialog; `check` resolves every literal against the alias chains.
- **Search docs examples**: `packages/trilium-core/src/services/search/docs_examples.spec.ts`
requires every query shown in `Navigation/Search.md` and `Quick search.md` to have a test.
-- **LLM tools** read the same `doc_notes` files (`apps/server/src/services/llm/tools/doc_notes.ts`).
+- **LLM tools** read the `_help` virtual notes through becca and search them with the application's
+ own search (`packages/trilium-core/src/services/llm/tools/help_tools.ts`).
-`doc_notes/cn/` holds nine legacy hand-written system snippets (launch-bar and hidden-note docs), no
-User Guide, and is frozen; the client always requests the User Guide in `en`.
+The few hand-written system snippets (launch-bar and hidden-note docs) are not part of the User
+Guide: `apps/client/src/services/doc_renderer.ts` renders them from the client catalogue's
+`doc_notes` keys, selected by a `#docName` label.
## What the site build reads
diff --git a/.gitattributes b/.gitattributes
index a416222b2a..732b8f4b4f 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -1,19 +1,17 @@
# Mark files as auto-generated to simplify reviews.
package-lock.json linguist-generated=true
**/package-lock.json linguist-generated=true
-apps/server/src/assets/doc_notes/en/User[[:space:]]Guide/** linguist-generated
+apps/server/src/assets/help/** linguist-generated=true
# Ignore from GitHub language stats.
-apps/server/src/assets/doc_notes/** linguist-vendored=true
apps/edit-docs/demo/** linguist-vendored=true
docs/** linguist-vendored=true
-# Normalize line endings. edit-docs writes the three generated trees with LF, so they have to
+# Normalize line endings. edit-docs writes the generated trees with LF, so they have to
# check out with LF too — otherwise every export leaves them looking modified on Windows.
# `text=auto` keeps the images and other binary attachments they contain out of the conversion.
patches/** eol=lf
docs/** text=auto eol=lf
-apps/server/src/assets/doc_notes/** text=auto eol=lf
apps/edit-docs/demo/** text=auto eol=lf
*.sh eol=lf
diff --git a/.vscode/settings.json b/.vscode/settings.json
index 94e4e3aae0..b6268418be 100644
--- a/.vscode/settings.json
+++ b/.vscode/settings.json
@@ -33,7 +33,6 @@
"**/node_modules": true,
"docs/**/*.html": true,
"docs/**/*.png": true,
- "apps/server/src/assets/doc_notes/**": true,
"apps/edit-docs/demo/**": true
},
"editor.codeActionsOnSave": {
diff --git a/CLAUDE.md b/CLAUDE.md
index d915bbd80e..3c0cf320cc 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -225,9 +225,13 @@ Use `note.getOwnedAttribute()` for direct, `note.getAttribute()` for inherited.
## Documentation
- Script API reference — Generated by `apps/build-docs` (TypeDoc) into the gitignored `site/script-api/{backend,frontend,electron}` and published to [docs.triliumnotes.org](https://docs.triliumnotes.org/). Not committed; never hand-edit — it's regenerated from the script API type definitions
-- `docs/User Guide/` — Markdown pages plus `!!!meta.json`; the in-app help under `apps/server/src/assets/doc_notes/` and `apps/standalone/src/assets/help_meta.json` are **generated from it and never hand-edited**. Edit the Markdown by hand or in the editor (`pnpm edit-docs:edit-docs`), then run `pnpm edit-docs:sync-docs` so the HTML and both help metas follow. A page's shape (a new page, an image, a rename, a move) is meta work — the **`writing-documentation` skill**'s `docs.mjs` does it (`new`, `image`, `rename`, `move`, `delete`) and audits the trees (`check`); load the skill before touching `docs/`
+- `docs/User Guide/` — Markdown pages plus `!!!meta.json`; the in-app help artifacts `apps/server/src/assets/help/help_meta.json` and `help_content.json` are **generated from it and never hand-edited**. Edit the Markdown by hand or in the editor (`pnpm edit-docs:edit-docs`), then run `pnpm edit-docs:sync-docs` so both artifacts follow. A page's shape (a new page, an image, a rename, a move) is meta work — the **`writing-documentation` skill**'s `docs.mjs` does it (`new`, `image`, `rename`, `move`, `delete`) and audits the trees (`check`); load the skill before touching `docs/`
- `docs/Developer Guide/` and `docs/Release Notes/` — Safe for direct Markdown editing (also normalized by `sync-docs`)
+### In-app help (the `_help` subtree)
+
+Help pages are **virtual notes** (`packages/trilium-core/src/services/virtual_notes.ts`): they exist only in becca, are never persisted or synced, and are read-only through an inheritable `readOnly` label on `_help`. `edit-docs` renders them from the Markdown into the two artifacts above; their images stay in `docs/User Guide/` and every packaging path (server, desktop, standalone) copies them itself. Load the **`in-app-help` skill** before touching the pipeline or its providers.
+
### A user-facing change is documented in the same change
Any change to what the user sees or does — a feature, a button moved or removed, a keyboard shortcut, a
@@ -266,6 +270,15 @@ Tools are `defineTools({...})` registries in `packages/trilium-core/src/services
### Server-Side Static Assets
Node-side assets (templates, translations, prompts) live in `apps/server/src/assets/` and are read via `RESOURCE_DIR` from `apps/server/src/services/resource_dir.ts` (`path.join(RESOURCE_DIR, "llm", "prompts", …)`); assets core itself reads (`schema.sql`, LLM skills) live in `packages/trilium-core/src/assets/`. **Never resolve paths with `import.meta.url`/`fileURLToPath` or `__dirname` + relative path** — the server bundles to `dist/main.mjs` plus lazy `chunks/`, so both point at the bundle (or at whichever chunk the module landed in), not the source tree.
+#### A new static route needs a dev path too, and a 200 does not mean it works
+
+In dev, Vite's middleware owns whole URL prefixes and answers anything it does not recognise with `index.html`. A missing static route therefore returns **200 with `text/html`**, not a 404 — so `curl -o /dev/null -w "%{http_code}"`, and any test that only checks the status, passes while every asset is broken. **Check `Content-Type` (or the body), never the status alone.**
+
+Two places apply the fallback, and both need the route added explicitly:
+
+- **server** — `apps/server/src/routes/assets.ts` mounts Vite on `/${assetUrlFragment}/` with an allowlist (`/images/`, `/doc_notes/`, `/help/`) of prefixes that fall through to the static mounts. A path not on that list is swallowed
+- **standalone** — `apps/standalone/vite.config.mts`; `viteStaticCopy` targets are served in dev, but anything copied by a custom plugin needs its own `configureServer` middleware (see `copyHelpAssetsPlugin` and `pdfjsServePlugin`). A plugin marked `apply: "build"` does nothing under `standalone:start`
+
## MCP Server
Trilium exposes an MCP server at `http://localhost:8080/mcp` (`.mcp.json`) — only while `pnpm server:start` is running, and only with an ETAPI token exported as `TRILIUM_ETAPI_TOKEN` before starting Claude Code (otherwise `401`; create one in Options → ETAPI). Use it to read/search/modify real note data when developing note-related features.
diff --git a/apps/client/src/components/note_context.spec.ts b/apps/client/src/components/note_context.spec.ts
index f762b21ac2..94be608a47 100644
--- a/apps/client/src/components/note_context.spec.ts
+++ b/apps/client/src/components/note_context.spec.ts
@@ -75,6 +75,19 @@ describe("NoteContext read-only capability", () => {
if (noteContext.viewScope) noteContext.viewScope.readOnlyTemporarilyDisabled = true;
expect(await noteContext.isReadOnly()).toBe(false);
});
+
+ it("keeps a note whose content cannot be saved read-only, even once editing is enabled", async () => {
+ const note = buildNote({ title: "Help page", type: "text" });
+ note.isContentWritable = false;
+ noteContext.noteId = note.noteId;
+ expect(await noteContext.isReadOnly()).toBe(true);
+
+ noteContext.resetViewScope();
+ const viewScope = noteContext.viewScope;
+ expect(viewScope).toBeTruthy();
+ if (viewScope) viewScope.readOnlyTemporarilyDisabled = true;
+ expect(await noteContext.isReadOnly()).toBe(true);
+ });
});
describe("NoteContext view scope", () => {
diff --git a/apps/client/src/components/note_context.ts b/apps/client/src/components/note_context.ts
index 3f0d336841..e5ac166ada 100644
--- a/apps/client/src/components/note_context.ts
+++ b/apps/client/src/components/note_context.ts
@@ -398,7 +398,7 @@ class NoteContext extends Component implements EventListener<"entitiesReloaded">
/** @returns {Promise<boolean>} */
async isReadOnly() {
- if (this?.viewScope?.readOnlyTemporarilyDisabled) {
+ if (this?.viewScope?.readOnlyTemporarilyDisabled && this.note?.isContentWritable !== false) {
return false;
}
@@ -416,7 +416,7 @@ class NoteContext extends Component implements EventListener<"entitiesReloaded">
return false;
}
- if (options.is("databaseReadonly")) {
+ if (options.is("databaseReadonly") || !this.note.isContentWritable) {
return true;
}
diff --git a/apps/client/src/components/root_command_executor.ts b/apps/client/src/components/root_command_executor.ts
index a8dc70c366..073ab1e6ab 100644
--- a/apps/client/src/components/root_command_executor.ts
+++ b/apps/client/src/components/root_command_executor.ts
@@ -12,7 +12,7 @@ import Component from "./component.js";
export default class RootCommandExecutor extends Component {
editReadOnlyNoteCommand() {
const noteContext = appContext.tabManager.getActiveContext();
- if (noteContext?.viewScope) {
+ if (noteContext?.viewScope && noteContext.note?.isContentWritable !== false) {
noteContext.viewScope.readOnlyTemporarilyDisabled = true;
appContext.triggerEvent("readOnlyTemporarilyDisabled", { noteContext });
}
diff --git a/apps/client/src/entities/fnote.ts b/apps/client/src/entities/fnote.ts
index 5a6279cdc9..0e01d37226 100644
--- a/apps/client/src/entities/fnote.ts
+++ b/apps/client/src/entities/fnote.ts
@@ -34,6 +34,8 @@ export interface FNoteRow {
type: NoteType;
mime: string;
blobId: string;
+ /** Sent only as `false`, for a virtual note whose provider cannot save content. */
+ isContentWritable?: boolean;
}
export interface NoteMetaData {
@@ -59,6 +61,8 @@ export default class FNote {
mime!: string;
// the main use case to keep this is to detect content change which should trigger refresh
blobId!: string;
+ /** `false` for a note that no editing mode can unlock, such as a page of the in-app help. */
+ isContentWritable!: boolean;
attributes: string[];
targetRelations: string[];
@@ -104,6 +108,7 @@ export default class FNote {
this.mime = row.mime ?? "";
this.blobId = row.blobId;
+ this.isContentWritable = row.isContentWritable ?? true;
}
addParent(parentNoteId: string, branchId: string, sort = true) {
diff --git a/apps/client/src/menus/tree_context_menu.spec.ts b/apps/client/src/menus/tree_context_menu.spec.ts
index ca1edf9d82..b1d8ed629b 100644
--- a/apps/client/src/menus/tree_context_menu.spec.ts
+++ b/apps/client/src/menus/tree_context_menu.spec.ts
@@ -85,6 +85,45 @@ describe("buildTreeContextMenuItems", () => {
});
});
+describe("buildTreeContextMenuItems on system notes", () => {
+ async function enabledState(parentId: string, childId: string) {
+ vi.spyOn(noteTypesService, "loadNoteTypeData")
+ .mockResolvedValue({ builtInTemplateNotes: [], userTemplateNotes: [], newTemplates: new Set() });
+ buildNote({ id: parentId, title: "Parent", children: [ { id: childId, title: "Child" } ] });
+ const child = froca.notes[childId];
+ const [ branch ] = child?.getParentBranches() ?? [];
+ if (!child || !branch) throw new Error("expected the child and its branch");
+
+ const items = await buildTreeContextMenuItems({
+ note: child, branch, notePath: `${parentId}/${childId}`, component: {} as Component
+ });
+ // The clipboard rows sit in an `actions` group of their own.
+ const rows = items.flatMap((item) => ("kind" in item && item.kind === "actions" ? item.items : [ item ]));
+ const enabled = (command: TreeCommandNames) => {
+ const item = rows.find((row) => "command" in row && row.command === command);
+ if (!item || "kind" in item) throw new Error(`expected a ${command} row`);
+ return item.enabled;
+ };
+ return {
+ exportNote: enabled("exportNote"),
+ importIntoNote: enabled("importIntoNote"),
+ branchCommands: (
+ [ "cutNotesToClipboard", "copyNotesToClipboard", "moveNotesTo", "cloneNotesTo" ] as const
+ ).map(enabled)
+ };
+ }
+
+ it("exports a help page, which cannot be imported into, and neither for an options page", async () => {
+ expect(await enabledState("_helpParent", "_helpPage")).toMatchObject({ exportNote: true, importIntoNote: false });
+ expect(await enabledState("_optionsParent", "_optionsPage")).toMatchObject({ exportNote: false, importIntoNote: false });
+ });
+
+ it("does not cut, clone or move a help page, which is virtual, but does an options page", async () => {
+ expect((await enabledState("_helpParent", "_helpPage")).branchCommands).toStrictEqual([ false, false, false, false ]);
+ expect((await enabledState("_optionsParent", "_optionsPage")).branchCommands).toStrictEqual([ true, true, true, true ]);
+ });
+});
+
describe("getDuplicateItems", () => {
it("offers the note-only copy as soon as one of the notes has children", () => {
const leaf = buildNote({ title: "Leaf" });
diff --git a/apps/client/src/menus/tree_context_menu.ts b/apps/client/src/menus/tree_context_menu.ts
index a5ea0d7a84..d261eee428 100644
--- a/apps/client/src/menus/tree_context_menu.ts
+++ b/apps/client/src/menus/tree_context_menu.ts
@@ -125,7 +125,10 @@ export async function buildTreeContextMenuItems(ctx: TreeContextMenuContext): Pr
const notSearch = note.type !== "search";
const hasSubtreeHidden = note.isLabelTruthy("subtreeHidden") ?? false;
- const notOptionsOrHelp = !note.noteId.startsWith("_options") && !note.noteId.startsWith("_help");
+ const notOptions = !note.noteId.startsWith("_options");
+ // Help pages are virtual notes, which the server never clones, moves or gives children.
+ const notHelp = !note.noteId.startsWith("_help");
+ const notOptionsOrHelp = notOptions && notHelp;
const parentNotSearch = !parentNote || parentNote.type !== "search";
const insertNoteAfterEnabled = isNotRoot && !isHoisted && parentNotSearch;
@@ -152,9 +155,9 @@ export async function buildTreeContextMenuItems(ctx: TreeContextMenuContext): Pr
command: "cutNotesToClipboard",
keyboardShortcut: "cutNotesToClipboard",
uiIcon: "bx bx-cut",
- enabled: isNotRoot && !isHoisted && parentNotSearch
+ enabled: isNotRoot && !isHoisted && parentNotSearch && notHelp
},
- { title: t("tree-context-menu.clone"), tooltip: t("tree-context-menu.clone-tooltip"), command: "copyNotesToClipboard", keyboardShortcut: "copyNotesToClipboard", uiIcon: "bx bx-copy", enabled: isNotRoot && !isHoisted },
+ { title: t("tree-context-menu.clone"), tooltip: t("tree-context-menu.clone-tooltip"), command: "copyNotesToClipboard", keyboardShortcut: "copyNotesToClipboard", uiIcon: "bx bx-copy", enabled: isNotRoot && !isHoisted && notHelp },
// Shown only while something is cut or copied, which is when they are looked for.
...(clipboard.isClipboardEmpty() ? [] : [
{
@@ -163,14 +166,14 @@ export async function buildTreeContextMenuItems(ctx: TreeContextMenuContext): Pr
keyboardShortcut: "pasteNotesFromClipboard",
uiIcon: "bx bx-clipboard",
uiIconBadge: "bx bx-subdirectory-right",
- enabled: notSearch && noSelectedNotes
+ enabled: notSearch && noSelectedNotes && notHelp
},
{
title: t("tree-context-menu.paste-after"),
command: "pasteNotesAfterFromClipboard",
uiIcon: "bx bx-clipboard",
uiIconBadge: "bx bx-down-arrow-alt",
- enabled: isNotRoot && !isHoisted && parentNotSearch && noSelectedNotes
+ enabled: isNotRoot && !isHoisted && parentNotSearch && noSelectedNotes && notHelp
}
] satisfies MenuCommandItem<TreeCommandNames>[]),
{
@@ -241,10 +244,10 @@ export async function buildTreeContextMenuItems(ctx: TreeContextMenuContext): Pr
command: "moveNotesTo",
keyboardShortcut: "moveNotesTo",
uiIcon: "bx bx-transfer",
- enabled: isNotRoot && !isHoisted && parentNotSearch
+ enabled: isNotRoot && !isHoisted && parentNotSearch && notHelp
},
- { title: t("tree-context-menu.clone-to"), command: "cloneNotesTo", keyboardShortcut: "cloneNotesTo", uiIcon: "bx bx-duplicate", enabled: isNotRoot && !isHoisted },
+ { title: t("tree-context-menu.clone-to"), command: "cloneNotesTo", keyboardShortcut: "cloneNotesTo", uiIcon: "bx bx-duplicate", enabled: isNotRoot && !isHoisted && notHelp },
{
title: t("tree-context-menu.duplicate"),
@@ -302,7 +305,7 @@ export async function buildTreeContextMenuItems(ctx: TreeContextMenuContext): Pr
{ title: t("tree-context-menu.import-into-note"), command: "importIntoNote", uiIcon: "bx bx-import", enabled: notSearch && noSelectedNotes && notOptionsOrHelp },
- { title: t("tree-context-menu.export"), command: "exportNote", uiIcon: "bx bx-export", enabled: notSearch && noSelectedNotes && notOptionsOrHelp },
+ { title: t("tree-context-menu.export"), command: "exportNote", uiIcon: "bx bx-export", enabled: notSearch && noSelectedNotes && notOptions },
{ kind: "separator" },
diff --git a/apps/client/src/services/doc_renderer.spec.ts b/apps/client/src/services/doc_renderer.spec.ts
index a90dc73b77..f6ba2276ca 100644
--- a/apps/client/src/services/doc_renderer.spec.ts
+++ b/apps/client/src/services/doc_renderer.spec.ts
@@ -1,8 +1,7 @@
-import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
-import $ from "jquery";
+import { beforeEach, describe, expect, it, vi } from "vitest";
vi.mock("./i18n.js", () => ({
- getCurrentLanguage: () => mockedLanguage
+ t: (key: string, options?: Record<string, unknown>) => translate(key, options)
}));
vi.mock("./syntax_highlight.js", () => ({
formatCodeBlocks: (arg: unknown) => formatCodeBlocksMock(arg)
@@ -11,172 +10,86 @@ vi.mock("../widgets/type_widgets/text/read_only_helper.js", () => ({
applyReferenceLinks: (arg: unknown) => applyReferenceLinksMock(arg)
}));
-import renderDoc, { isValidDocName } from "./doc_renderer.js";
+import en from "../translations/en/translation.json";
+import renderDoc, { isDocName } from "./doc_renderer.js";
-let mockedLanguage = "en";
const formatCodeBlocksMock = vi.fn((_arg?: unknown) => {});
const applyReferenceLinksMock = vi.fn(async (_arg?: unknown) => {});
+/** Resolves against the shipped English catalog, interpolating unescaped as the client's i18next does. */
+function translate(key: string, options?: Record<string, unknown>) {
+ const entry = (en.doc_notes as Record<string, string>)[key.replace("doc_notes.", "")] ?? key;
+ return entry.replaceAll(/\{\{(\w+)\}\}/g, (_match, name: string) => String(options?.[name] ?? ""));
+}
+
/** Builds a minimal FNote-like object with the given docName label. */
function fakeNote(docName: string | null) {
return { getLabelValue: (name: string) => (name === "docName" ? docName : null) } as any;
}
-/**
- * Overrides jQuery's `.load(url, cb)` so we can drive the callback deterministically.
- * The handler receives the requested url and the jQuery element so it can inject HTML.
- */
-function stubLoad(handler: (url: string, $el: JQuery<HTMLElement>) => { status?: string } | void) {
- return vi.spyOn($.fn, "load").mockImplementation(function (this: JQuery<HTMLElement>, url: any, cb?: any) {
- const result = handler(url, this) ?? {};
- const status = result.status ?? "success";
- // jQuery invokes the callback with (responseText, status, xhr).
- cb?.call(this, this.html(), status, {});
- return this;
- } as any);
-}
-
-describe("isValidDocName", () => {
- it("accepts valid docNames", () => {
- expect(isValidDocName("launchbar_intro")).toBe(true);
- expect(isValidDocName("User Guide/Quick Start")).toBe(true);
- expect(isValidDocName("User Guide/User Guide/Quick Start")).toBe(true);
- expect(isValidDocName("Quick Start Guide")).toBe(true);
- expect(isValidDocName("quick_start_guide")).toBe(true);
- expect(isValidDocName("quick-start-guide")).toBe(true);
- expect(isValidDocName("User Guide/User Guide/Advanced Usage/Text Extraction (OCR)")).toBe(true);
- expect(isValidDocName("User Guide/Basic Concepts and Features/Import & Export/Microsoft OneNote")).toBe(true);
- });
-
- // A docName is a path built out of page titles, so it carries whatever punctuation the titles do.
- // These are all real pages of the user guide.
- it("accepts the punctuation real page titles carry", () => {
- expect(isValidDocName("User Guide/User Guide/Advanced Usage/Note Map (Link map, Tree map)")).toBe(true);
- expect(isValidDocName("User Guide/User Guide/Advanced Usage/Configuration (config.ini or environment variables)")).toBe(true);
- expect(isValidDocName("User Guide/User Guide/Installation & Setup/Server Installation/1. Installing the server/Using Docker")).toBe(true);
- expect(isValidDocName("User Guide/User Guide/Scripting/Script API/Day.js")).toBe(true);
- expect(isValidDocName("User Guide/User Guide/Scripting/Breaking changes/v0.103.0 `cheerio` is now deprecated")).toBe(true);
+describe("isDocName", () => {
+ it("accepts every name the hidden subtree hands out", () => {
+ // The names in use, from hidden_subtree.ts, hidden_subtree_launcherbar.ts and task_states.ts.
+ for (const name of [
+ "hidden", "share", "user_hidden", "task_state", "task_states", "system_state",
+ "launchbar_intro", "launchbar_command_launcher", "launchbar_note_launcher",
+ "launchbar_script_launcher", "launchbar_spacer", "launchbar_widget_launcher",
+ "launchbar_quick_search", "launchbar_history_navigation"
+ ]) {
+ expect(isDocName(name), name).toBe(true);
+ }
});
- it("rejects path traversal attacks", () => {
- expect(isValidDocName("..")).toBe(false);
- expect(isValidDocName("../etc/passwd")).toBe(false);
- expect(isValidDocName("foo/../bar")).toBe(false);
- expect(isValidDocName("../../../../api/notes/_malicious/open")).toBe(false);
- expect(isValidDocName("..\\etc\\passwd")).toBe(false);
- expect(isValidDocName("foo\\bar")).toBe(false);
- // Dots are allowed within a segment (see above), so a segment made of nothing else — which is
- // what climbs out of the doc directory — has to be turned away in its own right.
- expect(isValidDocName("...")).toBe(false);
- expect(isValidDocName("foo/..")).toBe(false);
- expect(isValidDocName("foo/./bar")).toBe(false);
- expect(isValidDocName("Day.js/../../etc/passwd")).toBe(false);
+ it("rejects anything else, so a label cannot name a page that was never shipped", () => {
+ expect(isDocName("")).toBe(false);
+ expect(isDocName("User Guide/Quick Start")).toBe(false);
+ expect(isDocName("../etc/passwd")).toBe(false);
+ expect(isDocName("HIDDEN")).toBe(false);
});
+});
- it("rejects URL manipulation attacks", () => {
- expect(isValidDocName("../../../../api/notes/_malicious/open?x=")).toBe(false);
- expect(isValidDocName("foo#bar")).toBe(false);
- expect(isValidDocName("%2e%2e")).toBe(false);
- expect(isValidDocName("%2e%2e%2f%2e%2e%2fapi")).toBe(false);
+describe("every shipped name has text, and every text is shipped", () => {
+ it("matches the catalog exactly", () => {
+ const inCatalog = Object.keys(en.doc_notes).sort();
+ const inCode = inCatalog.filter(isDocName).sort();
+ expect(inCode).toEqual(inCatalog);
});
});
describe("renderDoc", () => {
beforeEach(() => {
- mockedLanguage = "en";
formatCodeBlocksMock.mockClear();
applyReferenceLinksMock.mockClear();
- (window as any).glob = { isStandalone: false, isDev: false, assetPath: "assets" };
- });
-
- afterEach(() => {
- vi.restoreAllMocks();
});
- it("resolves with an empty container when the note has no docName (load is never called)", async () => {
- const loadSpy = stubLoad(() => {});
+ it("resolves with an empty container when the note has no docName", async () => {
const $content = await renderDoc(fakeNote(null));
- expect($content.length).toBe(1);
- expect(loadSpy).not.toHaveBeenCalled();
+ expect($content.html()).toBe("");
+ expect(formatCodeBlocksMock).not.toHaveBeenCalled();
});
- it("resolves with an empty container and logs when the docName is invalid", async () => {
+ it("resolves with an empty container and logs when the docName is not one of ours", async () => {
const errorSpy = vi.spyOn(console, "error").mockImplementation(() => {});
- const loadSpy = stubLoad(() => {});
const $content = await renderDoc(fakeNote("../etc/passwd"));
- expect($content.length).toBe(1);
- expect(loadSpy).not.toHaveBeenCalled();
- expect(errorSpy).toHaveBeenCalledWith(expect.stringContaining("Invalid docName"));
+ expect($content.html()).toBe("");
+ expect(errorSpy).toHaveBeenCalledWith(expect.stringContaining("Unknown docName"));
+ errorSpy.mockRestore();
});
- it("loads the localized doc, rewrites relative image src, and runs post-processing", async () => {
- mockedLanguage = "de";
- const loadSpy = stubLoad((_url, $el) => {
- $el.html(`<img src="pic.png"><a class="reference-link">x</a>`);
- });
+ it("renders the page and runs post-processing", async () => {
+ const $content = await renderDoc(fakeNote("launchbar_quick_search"));
- const $content = await renderDoc(fakeNote("Quick Start"));
-
- // URL is base/doc_notes/<lang>/<docName with %20>.html
- expect(loadSpy.mock.calls[0][0]).toBe("assets/doc_notes/de/Quick%20Start.html");
- // The relative image src is rewritten to be prefixed with the doc directory.
- expect($content.find("img").attr("src")).toBe("assets/doc_notes/de/pic.png");
+ expect($content.find("a").first().attr("href")).toBe("#root/_help_Ms1nauBra7gq");
expect(formatCodeBlocksMock).toHaveBeenCalledTimes(1);
expect(applyReferenceLinksMock).toHaveBeenCalledTimes(1);
});
- it("forces English for User Guide docs regardless of the current language", async () => {
- mockedLanguage = "fr";
- const loadSpy = stubLoad(() => {});
- await renderDoc(fakeNote("User Guide/Quick Start"));
- expect(loadSpy.mock.calls[0][0]).toBe("assets/doc_notes/en/User%20Guide/Quick%20Start.html");
- });
-
- it("percent-encodes ampersands in the docName (e.g. \"Import & Export\")", async () => {
- const loadSpy = stubLoad(() => {});
- await renderDoc(fakeNote("User Guide/Basic Concepts and Features/Import & Export/Microsoft OneNote"));
- expect(loadSpy.mock.calls[0][0]).toBe("assets/doc_notes/en/User%20Guide/Basic%20Concepts%20and%20Features/Import%20%26%20Export/Microsoft%20OneNote.html");
- });
-
- it("leaves the rest of a title's punctuation to the browser's own URL encoding", async () => {
- const loadSpy = stubLoad(() => {});
- await renderDoc(fakeNote("User Guide/User Guide/Advanced Usage/Note Map (Link map, Tree map)"));
- expect(loadSpy.mock.calls[0][0]).toBe("assets/doc_notes/en/User%20Guide/User%20Guide/Advanced%20Usage/Note%20Map%20(Link%20map,%20Tree%20map).html");
- });
-
- it("falls back to the English doc when the localized load errors", async () => {
- mockedLanguage = "de";
- const requested: string[] = [];
- const loadSpy = stubLoad((url) => {
- requested.push(url);
- // First (German) request errors; the English fallback succeeds.
- return url.includes("/de/") ? { status: "error" } : {};
- });
-
- const $content = await renderDoc(fakeNote("Quick Start"));
-
- expect(requested).toEqual([
- "assets/doc_notes/de/Quick%20Start.html",
- "assets/doc_notes/en/Quick%20Start.html"
- ]);
- expect($content.length).toBe(1);
- expect(loadSpy).toHaveBeenCalledTimes(2);
- // processContent runs for the fallback url.
- expect(formatCodeBlocksMock).toHaveBeenCalledTimes(1);
- expect(applyReferenceLinksMock).toHaveBeenCalledTimes(1);
- });
-
- it("uses the server-assets base path in standalone mode", async () => {
- (window as any).glob = { isStandalone: true, isDev: false, assetPath: "assets" };
- const loadSpy = stubLoad(() => {});
- await renderDoc(fakeNote("Quick Start"));
- expect(loadSpy.mock.calls[0][0]).toBe("server-assets/doc_notes/en/Quick%20Start.html");
- });
+ it("interpolates a code example as text, so its markup is not parsed as markup", async () => {
+ const $content = await renderDoc(fakeNote("launchbar_widget_launcher"));
- it("uses the parent of assetPath in dev mode", async () => {
- (window as any).glob = { isStandalone: false, isDev: true, assetPath: "assets" };
- const loadSpy = stubLoad(() => {});
- await renderDoc(fakeNote("Quick Start"));
- expect(loadSpy.mock.calls[0][0]).toBe("assets/../doc_notes/en/Quick%20Start.html");
+ const $pre = $content.find("pre");
+ expect($pre.text()).toContain(`const TPL = \`<div style="height: 53px; width: 53px;"></div>\`;`);
+ // The example's own <div> must not have become an element of the page.
+ expect($pre.find("div").length).toBe(0);
});
});
diff --git a/apps/client/src/services/doc_renderer.ts b/apps/client/src/services/doc_renderer.ts
index 4c63a2d40a..b7d757d60d 100644
--- a/apps/client/src/services/doc_renderer.ts
+++ b/apps/client/src/services/doc_renderer.ts
@@ -1,100 +1,94 @@
import type FNote from "../entities/fnote.js";
import { applyReferenceLinks } from "../widgets/type_widgets/text/read_only_helper.js";
-import { getCurrentLanguage } from "./i18n.js";
+import { t } from "./i18n.js";
import { formatCodeBlocks } from "./syntax_highlight.js";
+import { escapeHtml } from "./utils.js";
/**
- * Validates a docName to prevent path traversal attacks.
- * Allows forward slashes for subdirectories (e.g., "User Guide/Quick Start")
- * but blocks traversal sequences and URL manipulation characters.
+ * The pages that ship with the application, named by the `docName` label that selects one. Their
+ * text lives in the translation catalog under `doc_notes`, so a name is only ever a key into this
+ * closed set — a label carrying anything else resolves to nothing at all.
*/
-export function isValidDocName(docName: string): boolean {
- // A docName is a path built out of page titles, so it has to carry the punctuation titles do:
- // dots ("Day.js", "1. Installing the server", "v0.103.0 ..."), commas ("Note Map (Link map, Tree
- // map)") and backticks ("`cheerio` is now deprecated"), on top of spaces, underscores, hyphens,
- // ampersands, brackets and the slashes that separate the segments.
- const validDocNameRegex = /^[a-zA-Z0-9_/\- ()&.,`]+$/;
- if (!validDocNameRegex.test(docName)) return false;
-
- // Dots being allowed above, the traversal they would spell has to be turned away in its own
- // right: a segment of nothing but dots is the one that climbs out of the doc directory, and no
- // page title is ever that.
- return !docName.split("/").some((segment) => /^\.+$/.test(segment));
-}
+const DOC_NAMES = [
+ "hidden",
+ "launchbar_command_launcher",
+ "launchbar_history_navigation",
+ "launchbar_intro",
+ "launchbar_note_launcher",
+ "launchbar_quick_search",
+ "launchbar_script_launcher",
+ "launchbar_spacer",
+ "launchbar_widget_launcher",
+ "share",
+ "system_state",
+ "task_state",
+ "task_states",
+ "user_hidden"
+] as const;
-export default function renderDoc(note: FNote) {
- return new Promise<JQuery<HTMLElement>>((resolve) => {
- const docName = note.getLabelValue("docName");
- const $content = $("<div>");
-
- // find doc based on language
- const url = getUrl(docName, getCurrentLanguage());
-
- if (url) {
- $content.load(url, async (response, status) => {
- // fallback to english doc if no translation available
- if (status === "error") {
- const fallbackUrl = getUrl(docName, "en");
-
- /* v8 ignore next 8 -- the else branch is unreachable: fallbackUrl only differs from the primary url by language, so if the primary url was valid (we got here from a successful .load call) the "en" fallback url is valid too and never null */
- if (fallbackUrl) {
- $content.load(fallbackUrl, async () => {
- await processContent(fallbackUrl, $content);
- resolve($content);
- });
- } else {
- resolve($content);
- }
- return;
- }
-
- await processContent(url, $content);
- resolve($content);
- });
- } else {
- resolve($content);
- }
- });
+export type DocName = (typeof DOC_NAMES)[number];
+
+export function isDocName(value: string): value is DocName {
+ return (DOC_NAMES as readonly string[]).includes(value);
}
-async function processContent(url: string, $content: JQuery<HTMLElement>) {
- const dir = url.substring(0, url.lastIndexOf("/"));
+export default async function renderDoc(note: FNote) {
+ const $content = $("<div>");
+ const docName = note.getLabelValue("docName");
- // Images are relative to the docnote but that will not work when rendered in the application since the path breaks.
- $content.find("img").each((_i, el) => {
- const $img = $(el);
- $img.attr("src", `${dir}/${$img.attr("src")}`);
- });
+ if (!docName) {
+ return $content;
+ }
+
+ if (!isDocName(docName)) {
+ console.error(`Unknown docName: ${docName}`);
+ return $content;
+ }
+
+ const sample = SAMPLES[docName];
+ $content.html(t(`doc_notes.${docName}`, { sample: sample && escapeHtml(sample) }));
formatCodeBlocks($content);
// Apply reference links.
await applyReferenceLinks($content[0]);
+
+ return $content;
}
-function getUrl(docNameValue: string | null, language: string) {
- if (!docNameValue) return;
+/**
+ * Code examples are not prose and have no business in the catalog, so the pages that carry one
+ * leave a `sample` placeholder for it. The client's i18next does not escape interpolations, so
+ * `renderDoc()` passes each sample through `escapeHtml()`.
+ */
+const SAMPLES: Partial<Record<DocName, string>> = {
+ launchbar_script_launcher: `api.showMessage("Current note is " + api.getActiveContextNote().title);`,
+ launchbar_widget_launcher: `const TPL = \`<div style="height: 53px; width: 53px;"></div>\`;
+
+class ExampleLaunchbarWidget extends api.NoteContextAwareWidget {
+ doRender() {
+ this.$widget = $(TPL);
+ }
- if (!isValidDocName(docNameValue)) {
- console.error(`Invalid docName: ${docNameValue}`);
- return null;
+ async refreshWithNote(note) {
+ this.$widget.css("background-color", this.stringToColor(note.title));
}
- // Cannot have spaces in the URL due to how JQuery.load works.
- docNameValue = docNameValue.replaceAll(" ", "%20");
- // Percent-encode ampersands (e.g. in "Import & Export") so they aren't misread when fetching the doc.
- docNameValue = docNameValue.replaceAll("&", "%26");
- // The user guide is available only in English, so make sure we are requesting correctly since 404s in standalone client are treated differently.
- if (docNameValue.includes("User%20Guide")) language = "en";
- return `${getBasePath()}/doc_notes/${language}/${docNameValue}.html`;
-}
+ stringToColor(str) {
+ let hash = 0;
+ for (let i = 0; i < str.length; i++) {
+ hash = str.charCodeAt(i) + ((hash << 5) - hash);
+ }
-function getBasePath() {
- if (window.glob.isStandalone) {
- return `server-assets`;
- }
- if (window.glob.isDev) {
- return `${window.glob.assetPath}/..`;
+ let color = '#';
+ for (let i = 0; i < 3; i++) {
+ const value = (hash >> (i * 8)) & 0xFF;
+ color += ('00' + value.toString(16)).substr(-2);
+ }
+
+ return color;
}
- return window.glob.assetPath;
}
+
+module.exports = new ExampleLaunchbarWidget();`
+};
diff --git a/apps/client/src/services/image_upload.spec.ts b/apps/client/src/services/image_upload.spec.ts
index 5abf518c62..72f38608ce 100644
--- a/apps/client/src/services/image_upload.spec.ts
+++ b/apps/client/src/services/image_upload.spec.ts
@@ -10,10 +10,11 @@ const serverUpload = vi.mocked(server.upload);
describe("parseImageDataUrl", () => {
it("splits a base64 data URL into its mime, raw base64 and extension", () => {
expect(parseImageDataUrl("data:image/png;base64,AAAA")).toEqual({ mime: "image/png", base64: "AAAA", ext: "png" });
- expect(parseImageDataUrl("data:image/jpeg;base64,BBBB")?.ext).toBe("jpeg");
});
it("names a format the way people write it", () => {
+ // ".jpg", not the ".jpeg" its subtype reads as — the same name a JPEG gets everywhere else.
+ expect(parseImageDataUrl("data:image/jpeg;base64,BBBB")?.ext).toBe("jpg");
expect(parseImageDataUrl("data:image/svg+xml;base64,Q0M=")?.ext).toBe("svg");
// A favicon used to be stored as "example.com.xicon", the subtype having had its
// punctuation stripped out rather than being recognised.
diff --git a/apps/client/src/services/in_app_help.spec.ts b/apps/client/src/services/in_app_help.spec.ts
index c11abdbefb..b2bedabffe 100644
--- a/apps/client/src/services/in_app_help.spec.ts
+++ b/apps/client/src/services/in_app_help.spec.ts
@@ -1,7 +1,7 @@
import { describe, expect, it } from "vitest";
import { byBookType, byNoteType, getHelpUrlForNote } from "./in_app_help.js";
import fs from "fs";
-import type { HiddenSubtreeItem } from "@triliumnext/commons";
+import type { HelpMetaItem, HiddenSubtreeItem } from "@triliumnext/commons";
import path from "path";
import { buildNote } from "../test/easy-froca.js";
import type FNote from "../entities/fnote.js";
@@ -27,9 +27,7 @@ describe("Help button", () => {
...Object.values(byBookType)
].filter((noteId) => noteId) as string[];
- const metaPath = path.resolve(path.join(__dirname, "../../../server/src/assets/doc_notes/en/User Guide/!!!meta.json"));
- const meta: HiddenSubtreeItem[] = JSON.parse(fs.readFileSync(metaPath, "utf-8"));
- const allNoteIds = new Set(getNoteIds(meta));
+ const allNoteIds = new Set(getNoteIds(readHelpMeta() as unknown as HiddenSubtreeItem[]));
for (const helpNote of allHelpNotes) {
if (!allNoteIds.has(`_help_${helpNote}`)) {
@@ -37,129 +35,12 @@ describe("Help button", () => {
}
}
});
-
- // The in-app help client (doc_renderer.ts) requests `doc_notes/<lang>/<docName>.html`, and the
- // server filesystem is case-sensitive. A doc whose title casing was changed on a case-insensitive
- // OS (Windows/macOS) can be committed with a stale-cased filename that git's core.ignorecase hides,
- // so the meta points at one casing while the file on disk has another → 404 in production.
- it("Every docName resolves to an on-disk file with exact casing", () => {
- const docNotesEnRoot = path.resolve(path.join(__dirname, "../../../server/src/assets/doc_notes/en"));
- const meta: HiddenSubtreeItem[] = JSON.parse(fs.readFileSync(path.join(docNotesEnRoot, "User Guide/!!!meta.json"), "utf-8"));
-
- const problems: string[] = [];
- for (const docName of collectDocNames(meta)) {
- if (!existsWithExactCase(docNotesEnRoot, `${docName}.html`)) {
- problems.push(docName);
- }
- }
-
- if (problems.length) {
- expect.fail(
- `The following help docNames do not resolve to an on-disk .html file with exact casing ` +
- `(the meta and the committed filename disagree — likely a case-only rename dropped by git core.ignorecase):\n` +
- problems.map((p) => ` - ${p}`).join("\n")
- );
- }
- });
-
- // Internal help links are `href="#root/<notePath>/_help_<noteId>"`. If the target `_help_` note is
- // not exported into the in-app help (e.g. a link into the Technical Guide subtree, which lives in
- // docs/ but is not shipped as doc_notes), the link dead-ends — the export renders it as
- // "[missing note]". Links whose last segment is NOT a `_help_` note (e.g. `#root/_hidden/_options/…`)
- // are intentional runtime deep-links to real system notes and are deliberately not validated here.
- it("Every internal help link points to an existing help note", () => {
- const docNotesEnRoot = path.resolve(path.join(__dirname, "../../../server/src/assets/doc_notes/en"));
- const meta: HiddenSubtreeItem[] = JSON.parse(fs.readFileSync(path.join(docNotesEnRoot, "User Guide/!!!meta.json"), "utf-8"));
- const definedIds = new Set(collectHelpIds(meta));
-
- const broken: string[] = [];
- for (const htmlFile of collectHtmlFiles(docNotesEnRoot)) {
- const html = fs.readFileSync(htmlFile, "utf-8");
- const relFile = path.relative(docNotesEnRoot, htmlFile);
- // Match anchors so the failure message can quote the link text (often "[missing note]").
- for (const match of html.matchAll(/<a\b[^>]*href="#root\/([^"]+)"[^>]*>(.*?)<\/a>/gs)) {
- const notePath = match[1].split(/[#?]/)[0];
- const target = notePath.split("/").pop() ?? "";
- if (target.startsWith("_help_") && !definedIds.has(target)) {
- broken.push(`${relFile}: "${match[2].trim()}" -> ${target}`);
- }
- }
- }
-
- if (broken.length) {
- expect.fail(
- `The following in-app help links point to notes that are not part of the in-app help ` +
- `(the target is not in !!!meta.json, so it renders as "[missing note]"). Either export the ` +
- `target page into the help tree or remove/repoint the link:\n` +
- broken.map((b) => ` - ${b}`).join("\n")
- );
- }
- });
});
-/** Collects every `_help_*` note id defined in the help meta tree. */
-function collectHelpIds(items: HiddenSubtreeItem[]): string[] {
- const ids: string[] = [];
- for (const item of items) {
- if (item.id) {
- ids.push(item.id);
- }
- if (item.children) {
- ids.push(...collectHelpIds(item.children as HiddenSubtreeItem[]));
- }
- }
- return ids;
-}
-
-/** Recursively lists every `.html` file under `dir`. */
-function collectHtmlFiles(dir: string): string[] {
- const files: string[] = [];
- for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
- const full = path.join(dir, entry.name);
- if (entry.isDirectory()) {
- files.push(...collectHtmlFiles(full));
- } else if (entry.name.endsWith(".html")) {
- files.push(full);
- }
- }
- return files;
-}
-
-/** Collects every `docName` label value from the help meta tree. */
-function collectDocNames(items: HiddenSubtreeItem[]): string[] {
- const docNames: string[] = [];
- for (const item of items) {
- const docName = item.attributes?.find((a) => a.name === "docName")?.value;
- if (docName) {
- docNames.push(docName);
- }
- if (item.children) {
- docNames.push(...collectDocNames(item.children as HiddenSubtreeItem[]));
- }
- }
- return docNames;
-}
-
-/**
- * Resolves `relativePath` under `rootDir` one segment at a time via `readdirSync`, which reports the
- * real on-disk names regardless of filesystem case sensitivity. `fs.existsSync` alone would wrongly
- * pass a mis-cased path on case-insensitive dev machines, so this makes the check meaningful everywhere.
- */
-function existsWithExactCase(rootDir: string, relativePath: string): boolean {
- let current = rootDir;
- for (const segment of relativePath.split("/")) {
- let entries: string[];
- try {
- entries = fs.readdirSync(current);
- } catch {
- return false;
- }
- if (!entries.includes(segment)) {
- return false;
- }
- current = path.join(current, segment);
- }
- return true;
+/** The help tree as `edit-docs` writes it. */
+function readHelpMeta(): HelpMetaItem[] {
+ const metaPath = path.resolve(path.join(__dirname, "../../../server/src/assets/help/help_meta.json"));
+ return JSON.parse(fs.readFileSync(metaPath, "utf-8"));
}
describe("getHelpUrlForNote", () => {
diff --git a/apps/client/src/stylesheets/style.css b/apps/client/src/stylesheets/style.css
index ee018c10d1..a5ea9e24ea 100644
--- a/apps/client/src/stylesheets/style.css
+++ b/apps/client/src/stylesheets/style.css
@@ -2029,6 +2029,13 @@ body.electron:not(.platform-darwin) .tab-row-container {
padding-inline-end: calc(100vw - env(titlebar-area-x, 0px) - env(titlebar-area-width, 100vw));
}
+@media (display-mode: window-controls-overlay) {
+ body:not(.electron) .tab-row-container {
+ padding-inline-start: env(titlebar-area-x, 0px);
+ padding-inline-end: calc(100vw - env(titlebar-area-x, 0px) - env(titlebar-area-width, 100vw));
+ }
+}
+
.tab-row-container .toggle-button {
background: transparent;
appearance: none;
diff --git a/apps/client/src/translations/cn/translation.json b/apps/client/src/translations/cn/translation.json
index 900fb93e6c..ec453fffe2 100644
--- a/apps/client/src/translations/cn/translation.json
+++ b/apps/client/src/translations/cn/translation.json
@@ -164,6 +164,18 @@
"format": "格式",
"format_html_name": "HTML"
},
+ "doc_notes": {
+ "hidden": "<p>隐藏树用于记录各种应用程序级数据,这些数据大部分时间可以对用户视图隐藏。</p><p>请确保您知道自己在做什么。此子树中的错误更改可能会导致应用程序崩溃。</p>",
+ "launchbar_command_launcher": "<p>此启动器操作的键盘快捷键可以在选项 -&gt; 快捷键中配置。</p>",
+ "launchbar_history_navigation": "<p>后退和前进按钮允许您在导航历史记录中移动。</p><p>这些启动器仅在桌面版本中有效,在服务器版本中将被忽略,您可以使用浏览器原生的导航按钮代替。</p>",
+ "launchbar_intro": "<p>欢迎使用启动栏配置。</p><p>您可以在这里执行以下操作:</p><ul><li>通过拖动将可用的启动器移动到可见列表(从而将它们放入启动栏)</li><li>通过拖动将可见的启动器移动到可用列表(从而将它们从启动栏中隐藏)</li><li>您可以通过拖动重新排序列表中的项目</li><li>您可以通过右键单击“可见启动器”文件夹来创建新的启动器</li><li>如果您想恢复默认设置,可以在上下文菜单中找到“重置”。</li></ul>",
+ "launchbar_note_launcher": "<p>您可以定义以下属性:</p><ol><li><code>target</code> - 激活启动器时应打开的笔记</li><li><code>hoistedNote</code> - 可选,将在打开目标笔记之前更改提升的笔记</li><li><code>keyboardShortcut</code> - 可选,按下键盘快捷键将打开笔记</li></ol><p>启动栏显示启动器的标题/图标,这不一定与目标笔记的标题/图标相同。</p>",
+ "launchbar_script_launcher": "<p>脚本启动器可以执行通过 <code>~script</code> 关系连接的脚本(代码笔记)。</p><ol><li><code>script</code> - 与激活启动器时应执行的脚本笔记的关系</li><li><code>keyboardShortcut</code> - 可选,按下键盘快捷键将激活启动器</li></ol><h4>示例脚本</h4><pre>{{sample}}</pre>",
+ "launchbar_spacer": "<p>间隔器允许您在视觉上将启动器分组。您可以在提升的属性中进行配置:</p><ul><li><code>baseSize</code> - 定义以像素为单位的大小(如果有足够的空间)</li><li><code>growthFactor</code> - 如果您希望间隔器保持恒定的 <code>baseSize</code>,则设置为 0;如果设置为正值,它将增长。</li></ul>",
+ "launchbar_widget_launcher": "<p>请在提升的属性中定义目标小部件笔记。该小部件将用于渲染启动栏图标。</p><h4>示例启动栏小部件</h4><pre>{{sample}}</pre>",
+ "share": "<p>在这里您可以找到所有分享的笔记。</p>",
+ "user_hidden": "<p>此笔记作为保留子树,用于存放用户脚本产生的数据,这些数据不应在隐藏子树中自由创建。</p>"
+ },
"help": {
"noteNavigation": "笔记导航",
"goUpDown": "在笔记列表中向上/向下移动",
diff --git a/apps/client/src/translations/en/translation.json b/apps/client/src/translations/en/translation.json
index 89f4229456..807ea6a36a 100644
--- a/apps/client/src/translations/en/translation.json
+++ b/apps/client/src/translations/en/translation.json
@@ -178,6 +178,22 @@
"export_finished_successfully": "Export finished successfully.",
"format_pdf": "PDF - for printing or sharing purposes."
},
+ "doc_notes": {
+ "hidden": "<p>Hidden tree is used to record various application-level data which can stay most of the time hidden from the user view.</p><p>Make sure you know what you're doing. Incorrect changes in this subtree might potentially crash the application.</p>",
+ "launchbar_command_launcher": "<p>Keyboard shortcut for this launcher action can be configured in Options -&gt; Shortcuts.</p>",
+ "launchbar_history_navigation": "<p>Back and Forward buttons allow you to move in the navigation history.</p><p>These launchers are active only in the desktop build and will be ignored in the server edition where you can use the native browser navigation buttons instead.</p>",
+ "launchbar_intro": "<p>Welcome to the Launchbar configuration.</p><p>You can do the following things here:</p><ul><li>Move available launchers to the visible list (thus putting them into the launchbar) by dragging them</li><li>Move visible launchers to the available list (thus hiding them from the launchbar) by dragging them</li><li>You can reorder the items in the lists by dragging</li><li>You can create new launchers by right-clicking on the \"Visible launchers\" folder</li><li>If you want to get back to the default setup, you can find \"reset\" in the context menu.</li></ul>",
+ "launchbar_note_launcher": "<p>You can define the following attributes:</p><ol><li><code>target</code> - note which should be opened upon activating the launcher</li><li><code>hoistedNote</code> - optional, will change the hoisted note before opening the target note</li><li><code>keyboardShortcut</code> - optional, pressing the keyboard shortcut will open the note</li></ol><p>Launchbar displays the title / icon from the launcher, which does not necessarily mirror those of the target note.</p>",
+ "launchbar_quick_search": "<p>The <a href=\"#root/_help_Ms1nauBra7gq\" target=\"_blank\">quick search bar</a> is displayed only on the horizontal layout, since it is already visible by default in the vertical layout.</p><p>For more information, see <a href=\"#root/_help_x0JgW8UqGXvq\" target=\"_blank\">Vertical and horizontal layout</a>.</p>",
+ "launchbar_script_launcher": "<p>Script launcher can execute a script (code note) connected via <code>~script</code> relation.</p><ol><li><code>script</code> - relation to the script note which should be executed upon launcher activation</li><li><code>keyboardShortcut</code> - optional, pressing the keyboard shortcut will activate the launcher</li></ol><h4>Example script</h4><pre>{{sample}}</pre>",
+ "launchbar_spacer": "<p>Spacer allows you to visually group launchers. You can configure it in the promoted attributes:</p><ul><li><code>baseSize</code> - defines size in pixels (if there's enough space)</li><li><code>growthFactor</code> - set to 0 if you want the spacer to be of constant <code>baseSize</code>, with positive value it will grow.</li></ul>",
+ "launchbar_widget_launcher": "<p>Please define the target widget note in the promoted attributes. The widget will be used to render the launchbar icon.</p><h4>Example launchbar widget</h4><pre>{{sample}}</pre>",
+ "share": "<p>Here you can find all shared notes.</p>",
+ "system_state": "<p>This is a built-in task state and cannot be edited or removed.</p><p>Only its position can be changed, which determines its order in the checkbox toolbar and the keyboard cycle.</p>",
+ "task_state": "<p>This note defines a to-do task state. The note's icon is displayed inside checkboxes to represent this state, and the note's title serves as its display name.</p><p>The state is configured through the following promoted attributes:</p><ul><li><code>Identifier</code> — required. The internal name stored as metadata within the note markup. Only letters, digits, <code>-</code> and <code>_</code> are permitted.<p class=\"admonition warning\">Prefix the identifiers of your custom task states with an underscore <code>_</code> or a hyphen <code>-</code> to avoid clashes with task states that may be introduced in future versions of Trilium.</p>Examples: <code>_postponed</code>, <code>_awaiting-feedback</code>, <code>_validated</code>.</li><li><code>Markdown symbol</code> — the single character used to represent the state when exporting to Markdown; for example, <code>/</code> produces <code>- [/]</code>.</li><li><code>Counts as completed</code> — when enabled, a task in this state is treated as completed.</li><li><code>Color</code> — the checkbox color for this state.</li><li><code>Hidden from toolbar</code> — when enabled, the state is excluded from the state list and the keyboard cycle. Notes already using it continue to render correctly.</li></ul><p class=\"admonition warning\">Changes take effect after the application is reloaded.</p>",
+ "task_states": "<p>This note contains the task states available for to-do checkboxes in the text editor. Each child note represents a single state.</p><p>States can be added, modified, reordered, or removed. To add a new state, create a child note and configure its promoted attributes.</p><p class=\"admonition warning\">Changes take effect after the application is reloaded.</p>",
+ "user_hidden": "<p>This note serves as a subtree reserved for data produced by user scripts which should otherwise not freely create data in the hidden subtree.</p>"
+ },
"help": {
"title": "Cheatsheet",
"editShortcuts": "Edit keyboard shortcuts",
@@ -840,7 +856,8 @@
"share_logo": "An image note used as the logo of the shared page. It has to sit inside the shared subtree.",
"share_open_graph_image_relation": "An image note served as the <code>og:image</code> of the shared page. Set the label of the same name instead to point at an address.",
"share_html": "An HTML note injected into the shared page, where <code>#shareHtmlLocation</code> on that note says. It has to sit inside the shared subtree.",
- "meeting_recording": "Marks a note created by the \"Transcribe meeting\" button in the launch bar, which holds the transcript of a meeting."
+ "meeting_recording": "Marks a note created by the \"Transcribe meeting\" button in the launch bar, which holds the transcript of a meeting.",
+ "template_title_template": "Set on a template note: default title of notes created from the template, used instead of the parent's <code>#titleTemplate</code>. Evaluated like <code>#titleTemplate</code>, with the injected <code>now</code> and <code>parentNote</code> variables, e.g. <code>Meeting ${now.format('YYYY-MM-DD')}</code>."
},
"attribute_editor": {
"help_text_body1": "To add label, just type e.g. <code>#rock</code> or if you want to add also value then e.g. <code>#year = 2020</code>",
@@ -3904,6 +3921,8 @@
"read_only_explicit_description": "This note has been manually set to read-only.\nClick to edit it temporarily.",
"read_only_auto": "Auto read-only",
"read_only_auto_description": "This note was set automatically to read-only mode for performance reasons. This automatic limit is adjustable from settings.\n\nClick to edit it temporarily.",
+ "read_only_locked": "Read-only",
+ "read_only_locked_description": "This note is provided by Trilium and cannot be edited.",
"read_only_temporarily_disabled": "Temporarily editable",
"read_only_temporarily_disabled_description": "This note is currently editable, but it is normally read-only. The note will go back to being read-only as soon as you navigate to another note.\n\nClick to re-enable read-only mode.",
"office_preview": "Preview",
diff --git a/apps/client/src/widgets/attribute_widgets/attr_help.ts b/apps/client/src/widgets/attribute_widgets/attr_help.ts
index 193ffdce8f..21e6d65c2d 100644
--- a/apps/client/src/widgets/attribute_widgets/attr_help.ts
+++ b/apps/client/src/widgets/attribute_widgets/attr_help.ts
@@ -59,6 +59,7 @@ export const ATTR_HELP: AttrHelpMap = {
displayRelations: t("attribute_detail.display_relations"),
hideRelations: t("attribute_detail.hide_relations"),
titleTemplate: t("attribute_detail.title_template"),
+ "template:titleTemplate": t("attribute_detail.template_title_template"),
template: t("attribute_detail.template"),
color: t("attribute_detail.color"),
keyboardShortcut: t("attribute_detail.keyboard_shortcut"),
diff --git a/apps/client/src/widgets/layout/NoteActions.spec.tsx b/apps/client/src/widgets/layout/NoteActions.spec.tsx
index cf698021ba..48e3917929 100644
--- a/apps/client/src/widgets/layout/NoteActions.spec.tsx
+++ b/apps/client/src/widgets/layout/NoteActions.spec.tsx
@@ -183,6 +183,33 @@ describe("NoteContextMenu", () => {
expect(await isPrintEnabled(buildNote({ title: "Disabled", type: "render", "~disabled:renderNote": script.noteId }))).toBe(false);
});
+ it("offers to export a help page, but not an options page", async () => {
+ const isExportEnabled = async (note: FNote) => {
+ const noteContext = new NoteContext("ntx-export");
+ noteContext.noteId = note.noteId;
+ noteContext.viewScope = { viewMode: "default" };
+ render((
+ <ParentComponent.Provider value={new Component()}>
+ <NoteContextContext.Provider value={noteContext}>
+ <NoteContextMenu note={note} noteContext={noteContext} />
+ </NoteContextContext.Provider>
+ </ParentComponent.Provider>
+ ), host);
+ host.querySelector<HTMLButtonElement>("button")?.click();
+ const exportItem = await vi.waitFor(() => {
+ const item = document.querySelector<HTMLElement>(".tn-popup li.dropdown-item:has(.bx-export)");
+ expect(item).toBeTruthy();
+ return item;
+ });
+ const enabled = !exportItem?.classList.contains("disabled");
+ render(null, host);
+ return enabled;
+ };
+
+ expect(await isExportEnabled(buildNote({ id: "_helpExportPage", title: "Help page" }))).toBe(true);
+ expect(await isExportEnabled(buildNote({ id: "_optionsExportPage", title: "Options page" }))).toBe(false);
+ });
+
it("opens on the Basic Properties shortcut only for its own note context", async () => {
const note = buildNote({ title: "Text", type: "text", content: "<p>Hi</p>" });
const noteContext = new NoteContext("ntx-split-2");
diff --git a/apps/client/src/widgets/layout/NoteActions.tsx b/apps/client/src/widgets/layout/NoteActions.tsx
index 09bc321e7c..2e17a487c5 100644
--- a/apps/client/src/widgets/layout/NoteActions.tsx
+++ b/apps/client/src/widgets/layout/NoteActions.tsx
@@ -91,7 +91,7 @@ export function NoteContextMenu({ note, noteContext, itemsAtStart, itemsNearNote
&& !note.hasLabel("calendarRoot") && !note.hasLabel("workspaceCalendarRoot");
const isHelpPage = note.noteId.startsWith("_help");
const [syncServerHost] = useTriliumOption("syncServerHost");
- const { isReadOnly, enableEditing } = useIsNoteReadOnly(note, noteContext);
+ const { isReadOnly, isLocked, enableEditing } = useIsNoteReadOnly(note, noteContext);
const isViewReadOnly = useEffectiveReadOnly(note, noteContext);
// The views other than the board open their properties dialog only while they are editable.
const hasCollectionProperties = isBoard
@@ -123,7 +123,7 @@ export function NoteContextMenu({ note, noteContext, itemsAtStart, itemsNearNote
{(note.type === "code" || note.noteId === "_backendLog") && <CodeProperties note={note} />}
- {isReadOnly && <>
+ {isReadOnly && !isLocked && <>
<CommandItem icon="bx bx-pencil" text={t("read-only-info.edit-note")}
command={() => enableEditing()} />
<FormDropdownDivider />
@@ -149,7 +149,7 @@ export function NoteContextMenu({ note, noteContext, itemsAtStart, itemsNearNote
disabled={isInOptionsOrHelp || note.type === "search"}
command={() => parentComponent?.triggerCommand("showImportDialog", { noteId: note.noteId })} />
<CommandItem icon="bx bx-export" text={t("note_actions.export_note")}
- disabled={isInOptionsOrHelp || note.noteId === "_backendLog"}
+ disabled={note.noteId.startsWith("_options") || note.noteId === "_backendLog"}
command={() => noteContext?.notePath && parentComponent?.triggerCommand("showExportDialog", {
notePath: noteContext.notePath,
defaultType: "single"
diff --git a/apps/client/src/widgets/layout/NoteBadges.spec.tsx b/apps/client/src/widgets/layout/NoteBadges.spec.tsx
index 8fb871c20b..616983357c 100644
--- a/apps/client/src/widgets/layout/NoteBadges.spec.tsx
+++ b/apps/client/src/widgets/layout/NoteBadges.spec.tsx
@@ -23,10 +23,23 @@ vi.mock("../../services/i18n", () => ({
import { buildNote } from "../../test/easy-froca";
import { renderInto } from "../../test/render";
-import { ClippedNoteBadge, ExecuteBadge, OfficePreviewBadge } from "./NoteBadges";
+import { ClippedNoteBadge, ExecuteBadge, OfficePreviewBadge, ReadOnlyBadge } from "./NoteBadges";
const DOCX_MIME = "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
+describe("ReadOnlyBadge", () => {
+ it("says a note that cannot be saved is read-only, without offering to edit it", () => {
+ const note = buildNote({ title: "Help page", type: "text" });
+ note.isContentWritable = false;
+ shownNote.current = note;
+ shownNote.viewScope = { viewMode: "default" };
+
+ const badge = renderInto(<ReadOnlyBadge />).querySelector(".read-only-badge");
+ expect(badge).toBeTruthy();
+ expect(badge?.textContent).toBe("breadcrumb_badges.read_only_locked");
+ });
+});
+
describe("OfficePreviewBadge", () => {
it("marks a file note that the office preview renders", () => {
const badge = renderBadge({ type: "file", mime: DOCX_MIME });
diff --git a/apps/client/src/widgets/layout/NoteBadges.tsx b/apps/client/src/widgets/layout/NoteBadges.tsx
index f2e9783b22..95ca6f32f9 100644
--- a/apps/client/src/widgets/layout/NoteBadges.tsx
+++ b/apps/client/src/widgets/layout/NoteBadges.tsx
@@ -43,12 +43,19 @@ export default function NoteBadges() {
);
}
-function ReadOnlyBadge() {
+export function ReadOnlyBadge() {
const { note, noteContext } = useNoteContext();
- const { isReadOnly, enableEditing, temporarilyEditable } = useIsNoteReadOnly(note, noteContext);
+ const { isReadOnly, isLocked, enableEditing, temporarilyEditable } = useIsNoteReadOnly(note, noteContext);
const isExplicitReadOnly = note?.isLabelTruthy("readOnly");
- if (temporarilyEditable) {
+ if (isLocked) {
+ return <Badge
+ icon="bx bx-lock-alt"
+ text={t("breadcrumb_badges.read_only_locked")}
+ tooltip={t("breadcrumb_badges.read_only_locked_description")}
+ className="read-only-badge"
+ />;
+ } else if (temporarilyEditable) {
return <Badge
icon="bx bx-lock-open-alt"
text={t("breadcrumb_badges.read_only_temporarily_disabled")}
diff --git a/apps/client/src/widgets/layout/StatusBar.spec.tsx b/apps/client/src/widgets/layout/StatusBar.spec.tsx
index e335075457..d84b278303 100644
--- a/apps/client/src/widgets/layout/StatusBar.spec.tsx
+++ b/apps/client/src/widgets/layout/StatusBar.spec.tsx
@@ -103,6 +103,14 @@ describe("StatusBar panels", () => {
expect(isShown(".attribute-list")).toBe(false);
});
+ it("offers no attributes panel for a note that cannot be edited, not even on the shortcut", () => {
+ renderBar(false);
+ expect(container.querySelector(".attributes-button")).toBeNull();
+
+ fire("addNewLabel");
+ expect(container.querySelector(".attribute-editor-stub")).toBeNull();
+ });
+
it("closes the similar notes panel from its own title bar", () => {
renderBar();
fire("toggleRibbonTabSimilarNotes");
@@ -116,8 +124,9 @@ describe("StatusBar panels", () => {
expect(container.querySelector(".similar-notes-pane")).toBeNull();
});
- function renderBar() {
+ function renderBar(isContentWritable = true) {
shownNote.current = buildNote({ id: "note1", title: "A note" });
+ shownNote.current.isContentWritable = isContentWritable;
eventHandlers = new Map();
const parent = {
componentId: "status-bar-cid",
diff --git a/apps/client/src/widgets/layout/StatusBar.tsx b/apps/client/src/widgets/layout/StatusBar.tsx
index 1bdbee944a..23bea437d8 100644
--- a/apps/client/src/widgets/layout/StatusBar.tsx
+++ b/apps/client/src/widgets/layout/StatusBar.tsx
@@ -66,10 +66,11 @@ export default function StatusBar() {
setSimilarNotesShown: (shown) => setActivePane(shown && "similar-notes")
};
const isHiddenNote = note?.isHiddenCompletely();
+ const canEditAttributes = note?.isContentWritable !== false;
return (
<div className={clsx("status-bar", {"status-bar-panel-open": !!activePane})}>
- {attributesContext && <AttributesPane {...attributesContext} />}
+ {attributesContext && canEditAttributes && <AttributesPane {...attributesContext} />}
{noteInfoContext && <SimilarNotesPane {...noteInfoContext} />}
<div className="status-bar-main-row">
@@ -81,7 +82,7 @@ export default function StatusBar() {
<TabWidthSwitcher {...context} />
<LanguageSwitcher {...context} />
{!isHiddenNote && <NotePaths {...context} />}
- <AttributesButton {...attributesContext} />
+ {canEditAttributes && <AttributesButton {...attributesContext} />}
<AttachmentCount {...context} />
<BacklinksBadge {...context} />
<NoteInfoBadge {...noteInfoContext} />
diff --git a/apps/client/src/widgets/note_icon.spec.tsx b/apps/client/src/widgets/note_icon.spec.tsx
index 6246f1f091..3db4ef6651 100644
--- a/apps/client/src/widgets/note_icon.spec.tsx
+++ b/apps/client/src/widgets/note_icon.spec.tsx
@@ -12,13 +12,22 @@ vi.mock("bootstrap", () => ({
Tooltip: class {}
}));
+// i18next is not initialized under test, where t() answers with nothing; echoing the key back keeps
+// the assertions about whether there is a tooltip at all.
+vi.mock("i18next", async (importOriginal) => ({
+ ...(await importOriginal<typeof import("i18next")>()),
+ t: (key: string) => key
+}));
+
const noteContext = vi.hoisted(() => ({
initialNote: undefined as FNote | undefined,
setNote: undefined as ((note: FNote) => void) | undefined
}));
const tooltipStub = vi.hoisted(() => ({ showTooltip: vi.fn(), hideTooltip: vi.fn() }));
+const tooltipConfig = vi.hoisted(() => ({ current: undefined as { title?: unknown } | undefined }));
const iconPickerProps = vi.hoisted(() => ({
current: undefined as undefined | {
+ disabled?: boolean;
onSelect(icon: string): void;
onReset?: () => void;
}
@@ -33,7 +42,10 @@ vi.mock("./react/hooks", async (importOriginal) => ({
},
useNoteLabel: () => [ undefined ],
useStaticTooltip: () => {},
- useTooltip: () => tooltipStub
+ useTooltip: (_ref: unknown, config: { title?: unknown }) => {
+ tooltipConfig.current = config;
+ return tooltipStub;
+ }
}));
vi.mock("../services/server", () => ({
@@ -99,6 +111,17 @@ describe("NoteIcon", () => {
expect(attributes.setLabel).toHaveBeenLastCalledWith("note-b", "workspaceIconClass", "bx-moon");
});
+ it("offers no tooltip to change the icon of a note whose icon cannot be changed", () => {
+ noteContext.initialNote = buildNote("note-a");
+ renderInto(<NoteIcon />);
+ expect(tooltipConfig.current?.title).toBe("note_icon.change_note_icon");
+
+ noteContext.initialNote = { ...buildNote("_help_page"), isMetadataReadOnly: true } as FNote;
+ renderInto(<NoteIcon />);
+ expect(iconPickerProps.current?.disabled).toBe(true);
+ expect(tooltipConfig.current?.title).toBe("");
+ });
+
it("stays in the legacy widget tree when the active note changes", () => {
glob.iconRegistry = { sources: [] };
noteContext.initialNote = buildNote("note-a");
diff --git a/apps/client/src/widgets/note_tree.ts b/apps/client/src/widgets/note_tree.ts
index db3754d96f..11dda7134a 100644
--- a/apps/client/src/widgets/note_tree.ts
+++ b/apps/client/src/widgets/note_tree.ts
@@ -528,7 +528,7 @@ export default class NoteTreeWidget extends NoteContextAwareWidget {
return false;
} else if (node.data.noteId === "_lbRoot") {
return false;
- } else if (node.data.noteId.startsWith("_options")) {
+ } else if (node.data.noteId.startsWith("_options") || node.data.noteId.startsWith("_help")) {
return false;
} else if (node.data.noteId === hoistedNoteService.getHoistedNoteId()) {
// The hoisted note is the tree root, so it has no visible siblings to drop before/after.
@@ -581,6 +581,12 @@ export default class NoteTreeWidget extends NoteContextAwareWidget {
return;
}
+ // Help pages are virtual notes, which the server never moves.
+ if (notes.some((note) => note.noteId?.startsWith("_help"))) {
+ toastService.showError(t("note_tree.dropping-not-allowed"));
+ return;
+ }
+
// This function MUST be defined to enable dropping of items on the tree.
// data.hitMode is 'before', 'after', or 'over'.
diff --git a/apps/client/src/widgets/note_types.tsx b/apps/client/src/widgets/note_types.tsx
index b298c05cb6..1f23b04777 100644
--- a/apps/client/src/widgets/note_types.tsx
+++ b/apps/client/src/widgets/note_types.tsx
@@ -113,7 +113,8 @@ export const TYPE_MAPPINGS: Record<ExtendedNoteType, NoteTypeMapping> = {
},
readOnlyText: {
view: () => import("./type_widgets/text/ReadOnlyText"),
- className: "note-detail-readonly-text"
+ className: "note-detail-readonly-text",
+ printable: true
},
editableText: {
view: () => import("./type_widgets/text/EditableText"),
diff --git a/apps/client/src/widgets/react/IconPicker.tsx b/apps/client/src/widgets/react/IconPicker.tsx
index 5aa842c82b..6c2446aa2e 100644
--- a/apps/client/src/widgets/react/IconPicker.tsx
+++ b/apps/client/src/widgets/react/IconPicker.tsx
@@ -175,7 +175,7 @@ function IconPickerDropdownButton({
// picker's own stylesheet reach through it.
className={clsx("note-icon-widget", className)}
buttonClassName={`note-icon tn-focusable-button ${icon}`}
- title={title}
+ title={disabled ? undefined : title}
disabled={disabled}
dropdownRef={dropdownRef}
autoClose="outside"
diff --git a/apps/client/src/widgets/react/hooks.tsx b/apps/client/src/widgets/react/hooks.tsx
index e7e7b40008..b01963051f 100644
--- a/apps/client/src/widgets/react/hooks.tsx
+++ b/apps/client/src/widgets/react/hooks.tsx
@@ -1928,21 +1928,23 @@ export function useGlobalShortcut(keyboardShortcut: string | null | undefined, h
/**
* Indicates that the current note is in read-only mode, while an editing mode is available,
- * and provides a way to switch to editing mode.
+ * and provides a way to switch to editing mode. `isLocked` marks a note that no editing mode can
+ * unlock, as its content cannot be saved; `enableEditing` does nothing for it.
*/
export function useIsNoteReadOnly(note: FNote | null | undefined, noteContext: NoteContext | undefined) {
const [ isReadOnly, setIsReadOnly ] = useState<boolean | undefined>(undefined);
const [ readOnlyAttr ] = useNoteLabelBoolean(note, "readOnly");
const [ autoReadOnlyDisabledAttr ] = useNoteLabelBoolean(note, "autoReadOnlyDisabled");
const [ temporarilyEditable, setTemporarilyEditable ] = useState(false);
+ const isLocked = note?.isContentWritable === false;
const enableEditing = useCallback((enabled = true) => {
- if (noteContext?.viewScope) {
+ if (noteContext?.viewScope && !isLocked) {
noteContext.viewScope.readOnlyTemporarilyDisabled = enabled;
appContext.triggerEvent("readOnlyTemporarilyDisabled", {noteContext});
setTemporarilyEditable(enabled);
}
- }, [noteContext]);
+ }, [noteContext, isLocked]);
useEffect(() => {
if (note && noteContext) {
@@ -1954,13 +1956,13 @@ export function useIsNoteReadOnly(note: FNote | null | undefined, noteContext: N
}, [ note, noteContext, noteContext?.viewScope, readOnlyAttr, autoReadOnlyDisabledAttr ]);
useTriliumEvent("readOnlyTemporarilyDisabled", ({noteContext: eventNoteContext}) => {
- if (noteContext?.ntxId === eventNoteContext.ntxId) {
+ if (noteContext?.ntxId === eventNoteContext.ntxId && !isLocked) {
setIsReadOnly(!noteContext.viewScope?.readOnlyTemporarilyDisabled);
setTemporarilyEditable(true);
}
});
- return { isReadOnly, enableEditing, temporarilyEditable };
+ return { isReadOnly, isLocked, enableEditing, temporarilyEditable };
}
/**
diff --git a/apps/client/src/widgets/scroll_padding.spec.tsx b/apps/client/src/widgets/scroll_padding.spec.tsx
new file mode 100644
index 0000000000..6a817c0cfc
--- /dev/null
+++ b/apps/client/src/widgets/scroll_padding.spec.tsx
@@ -0,0 +1,139 @@
+import { render } from "preact";
+import { act } from "preact/test-utils";
+import { beforeEach, describe, expect, it, vi } from "vitest";
+
+// The widget is rendered on its own, outside a note split, so the context it would pick up from the
+// tree is handed to it instead — a real note context, so the read-only decision is the actual one.
+const shownContext = vi.hoisted(() => ({ current: null as Record<string, unknown> | null }));
+vi.mock("./react/hooks", async (importOriginal) => ({
+ ...(await importOriginal<typeof import("./react/hooks")>()),
+ useNoteContext: () => shownContext.current
+}));
+
+import Component from "../components/component";
+import NoteContext from "../components/note_context";
+import type FNote from "../entities/fnote";
+import type { ViewScope } from "../services/link";
+import options from "../services/options";
+import { buildNote } from "../test/easy-froca";
+import { renderInto } from "../test/render";
+import { ParentComponent } from "./react/react_utils";
+import ScrollPadding from "./scroll_padding";
+
+describe("ScrollPadding", () => {
+ let parentComponent: Component;
+ let noteContext: NoteContext;
+ let container: HTMLElement;
+
+ beforeEach(() => {
+ options.load({ autoReadonlySizeText: 100, autoReadonlySizeCode: 100 });
+ parentComponent = new Component();
+ noteContext = new NoteContext();
+ container = renderInto(null);
+ });
+
+ /**
+ * Shows the given note in the tab, inside the scrolling container the widget measures itself
+ * against. The context handed over here is not the reactive one the widget subscribes to in the
+ * app, so a note switch is staged as a fresh mount.
+ */
+ async function show(note: FNote, viewScope: ViewScope = { viewMode: "default" }) {
+ noteContext.noteId = note.noteId;
+ noteContext.notePath = note.noteId;
+ noteContext.viewScope = viewScope;
+ shownContext.current = {
+ note,
+ noteContext,
+ parentComponent,
+ ntxId: noteContext.ntxId,
+ viewScope
+ };
+
+ await act(async () => {
+ render(null, container);
+ render(
+ <ParentComponent.Provider value={parentComponent}>
+ <div className="scrolling-container"><ScrollPadding /></div>
+ </ParentComponent.Provider>,
+ container
+ );
+ });
+ await settle();
+ }
+
+ /** Lets the asynchronous read-only check resolve, along with the re-render it schedules. */
+ async function settle() {
+ await act(async () => { await new Promise((resolve) => setTimeout(resolve, 0)); });
+ }
+
+ function isShown() {
+ return !!container.querySelector(".scroll-padding-widget");
+ }
+
+ /** What the read-only badge's edit button does: flips the toggle, then announces it. */
+ async function setTemporarilyEditable(editable: boolean) {
+ if (noteContext.viewScope) {
+ noteContext.viewScope.readOnlyTemporarilyDisabled = editable;
+ }
+ await act(async () => {
+ parentComponent.handleEvent("readOnlyTemporarilyDisabled", { noteContext });
+ });
+ await settle();
+ }
+
+ it("pads an editable note, but not one its label holds read-only", async () => {
+ await show(buildNote({ title: "Editable" }));
+ expect(isShown()).toBe(true);
+
+ await show(buildNote({ title: "Locked", "#readOnly": "true" }));
+ expect(isShown()).toBe(false);
+ });
+
+ it("pads a read-only note for as long as it is temporarily editable", async () => {
+ await show(buildNote({ title: "Locked", "#readOnly": "true" }));
+ expect(isShown()).toBe(false);
+
+ await setTemporarilyEditable(true);
+ expect(isShown()).toBe(true);
+
+ await setTemporarilyEditable(false);
+ expect(isShown()).toBe(false);
+ });
+
+ it("skips a note the size limit turned read-only on its own", async () => {
+ await show(buildNote({ title: "Huge", content: "a".repeat(200) }));
+ expect(isShown()).toBe(false);
+
+ await setTemporarilyEditable(true);
+ expect(isShown()).toBe(true);
+ });
+
+ it("skips every note while the database itself is read-only", async () => {
+ options.set("databaseReadonly", "true");
+
+ await show(buildNote({ title: "Editable" }));
+ expect(isShown()).toBe(false);
+ });
+
+ it("only pads text and code notes shown in their default view", async () => {
+ await show(buildNote({ title: "Code", type: "code", mime: "text/plain" }));
+ expect(isShown()).toBe(true);
+
+ await show(buildNote({ title: "Canvas", type: "canvas" }));
+ expect(isShown()).toBe(false);
+
+ await show(buildNote({ title: "Sourced" }), { viewMode: "source" });
+ expect(isShown()).toBe(false);
+ });
+
+ it("scrolls the note to its end when clicked", async () => {
+ const triggerCommand = vi.spyOn(parentComponent, "triggerCommand");
+ await show(buildNote({ title: "Editable" }));
+
+ await act(async () => {
+ container.querySelector<HTMLElement>(".scroll-padding-widget")?.click();
+ });
+
+ expect(triggerCommand).toHaveBeenCalledWith("scrollToEnd", { ntxId: noteContext.ntxId });
+ });
+});
diff --git a/apps/client/src/widgets/scroll_padding.tsx b/apps/client/src/widgets/scroll_padding.tsx
index 208a23f860..c39388d6b2 100644
--- a/apps/client/src/widgets/scroll_padding.tsx
+++ b/apps/client/src/widgets/scroll_padding.tsx
@@ -1,17 +1,24 @@
import { useEffect, useRef, useState } from "preact/hooks";
-import { useNoteContext } from "./react/hooks";
+import options from "../services/options";
+import { useIsNoteReadOnly, useNoteContext } from "./react/hooks";
export default function ScrollPadding() {
- const { note, parentComponent, ntxId, viewScope } = useNoteContext();
+ const { note, noteContext, parentComponent, ntxId, viewScope } = useNoteContext();
const ref = useRef<HTMLDivElement>(null);
const [height, setHeight] = useState<number>(10);
+ // There is nothing to place the caret at the end of when the note can't be edited. The check is
+ // asynchronous, answering `undefined` until it settles; a read-only database is reported as not
+ // read-only (there is no editing to switch to), so it has to be ruled out separately.
+ const { isReadOnly } = useIsNoteReadOnly(note, noteContext);
const isEnabled = ["text", "code"].includes(note?.type ?? "")
&& viewScope?.viewMode === "default"
&& note?.isContentAvailable()
&& !note?.isTriliumSqlite()
&& !note?.isMarkdown()
- && !note?.isIconPack();
+ && !note?.isIconPack()
+ && isReadOnly === false
+ && !options.is("databaseReadonly");
const refreshHeight = () => {
if (!ref.current) return;
diff --git a/apps/client/src/widgets/sidebar/AttributeList.spec.tsx b/apps/client/src/widgets/sidebar/AttributeList.spec.tsx
index d1dd3055b6..3e16b46b66 100644
--- a/apps/client/src/widgets/sidebar/AttributeList.spec.tsx
+++ b/apps/client/src/widgets/sidebar/AttributeList.spec.tsx
@@ -220,6 +220,22 @@ describe("AttributeList", () => {
expect(cards[2].querySelectorAll(".definition-marker")).toHaveLength(1);
});
+ it("lists the attributes of a note that cannot be edited, offering no way to change them", () => {
+ const note = noteWithAttributes();
+ note.isContentWritable = false;
+ renderPanel(note);
+
+ const cards = [ ...container.querySelectorAll(".card") ];
+ expect(namesIn(cards[0])).toEqual([ "author", "cssClass", "template" ]);
+ // Read as any other note's: Trilium's own names below the rule, inherited ones naming their note.
+ expect(cards[0].querySelectorAll("hr.attribute-rows-divider")).toHaveLength(1);
+ expect(cards[1].querySelectorAll(".attribute-owner")).toHaveLength(2);
+ expect(container.querySelectorAll(".attribute-delete-button")).toHaveLength(0);
+ expect(container.querySelectorAll(".attribute-edit-button")).toHaveLength(0);
+ expect(container.querySelector(".attribute-add-row")).toBeNull();
+ expect(container.querySelector(".bx-plus")).toBeNull();
+ });
+
it("keeps to one card, collapsing and all, for a note with nothing but its own attributes", () => {
renderPanel(buildNote({ id: "bare", title: "Bare", "#author": "Elian" }));
diff --git a/apps/client/src/widgets/sidebar/AttributeList.tsx b/apps/client/src/widgets/sidebar/AttributeList.tsx
index 87225a6b8a..bf04e2f14e 100644
--- a/apps/client/src/widgets/sidebar/AttributeList.tsx
+++ b/apps/client/src/widgets/sidebar/AttributeList.tsx
@@ -294,6 +294,7 @@ export default function AttributeList() {
}
const sections = splitIntoSections(owned.current, inherited.current);
+ const canEdit = !!note && note.isContentWritable;
const internalRows = internal.current.map((attribute) => toEntry(attribute, true));
// Not built for an attribute the list no longer holds: a reload can rebuild the rows out from
// under the editor within this very render, before the state has caught up (see above).
@@ -337,6 +338,7 @@ export default function AttributeList() {
note,
activeAttribute: detail?.attribute,
valueEditor,
+ locked: !canEdit,
onOpen: openDetail,
onEditValue: startValueEdit,
onDelete: (attribute: Attribute) => void deleteAttribute(attribute)
@@ -380,11 +382,11 @@ export default function AttributeList() {
buttons={note && (
<>
<SidebarHelp section="attributes" />
- <AddAttributeButton
+ {canEdit && <AddAttributeButton
text={t("attribute_editor.add_a_new_attribute")}
attrTypes={ALL_ATTRIBUTE_KINDS}
onSelect={addAttribute}
- />
+ />}
</>
)}
>
@@ -405,7 +407,7 @@ export default function AttributeList() {
{creationRow && <AttributeRowList rows={[ creationRow ]} {...rowProps} />}
{/* Only on a desktop: a phone adds from the header, page flow and all. */}
- {!IS_MOBILE && note && (
+ {!IS_MOBILE && canEdit && (
<AddAttributeRow onAdd={(e) => addAttribute("label", e)} />
)}
</div>
@@ -429,7 +431,7 @@ export default function AttributeList() {
title={t("attribute_list_panel.definitions", { count: sections.definitions.length })}
buttons={<>
<SidebarHelp section="attributes-definitions" />
- {note && (
+ {canEdit && (
<AddAttributeButton
text={t("attribute_list_panel.add_definition")}
attrTypes={DEFINITION_KINDS}
@@ -541,6 +543,8 @@ interface AttributeRowListProps {
* every one of them is Trilium's, which is what the card they are in says.
*/
readOnly?: boolean;
+ /** Shows the rows as usual, but with no way to change them, for a note that cannot be edited. */
+ locked?: boolean;
onOpen: (attribute: Attribute, isOwned: boolean, anchor: HTMLElement | null, e: MouseEvent) => void;
/** Asks for the in-place editor over the attribute's value; wired to editable labels alone. */
onEditValue: (attribute: Attribute) => void;
@@ -552,7 +556,9 @@ interface AttributeRowListProps {
* Trilium reads for itself. What a row offers follows from whether the note owns its attribute rather
* than from the card it is in: the definitions card holds the note's own alongside a template's.
*/
-function AttributeRowList({ rows, note, activeAttribute, valueEditor, readOnly, onOpen, onEditValue, onDelete }: AttributeRowListProps) {
+function AttributeRowList({ rows, note, activeAttribute, valueEditor, readOnly, locked, onOpen, onEditValue, onDelete }: AttributeRowListProps) {
+ const canChange = !readOnly && !locked;
+
function renderRows(group: AttributeEntry[]) {
return (
// The rows are menu items on a phone (see AttributeRow), and the theme dresses a menu item
@@ -571,15 +577,15 @@ function AttributeRowList({ rows, note, activeAttribute, valueEditor, readOnly,
// An attribute of another note names it; the current note's own would name itself.
showOwner={!isOwned && !readOnly}
// A read-only row opens the popup as an inherited one does: to be read, not edited.
- onOpen={(anchor, e) => onOpen(attribute, isOwned && !readOnly, anchor, e)}
+ onOpen={(anchor, e) => onOpen(attribute, isOwned && canChange, anchor, e)}
// A label's value is typed straight into its row, and a relation's target is
// repicked in it (from the pencil — the value itself is a link, and stays
// one). Definitions, whose value is a summary of settings, keep the popup. On
// a phone the row is a menu item and opens its page whole.
- onEditValue={isOwned && !readOnly && !IS_MOBILE && !isDefinition(getAttributeKind(attribute))
+ onEditValue={isOwned && canChange && !IS_MOBILE && !isDefinition(getAttributeKind(attribute))
? () => onEditValue(attribute)
: undefined}
- onDelete={isOwned && !readOnly ? () => onDelete(attribute) : undefined}
+ onDelete={isOwned && canChange ? () => onDelete(attribute) : undefined}
/>
))}
</ul>
diff --git a/apps/client/src/widgets/sidebar/RightPanelContainer.tsx b/apps/client/src/widgets/sidebar/RightPanelContainer.tsx
index b6fd790093..72fcc3584d 100644
--- a/apps/client/src/widgets/sidebar/RightPanelContainer.tsx
+++ b/apps/client/src/widgets/sidebar/RightPanelContainer.tsx
@@ -242,7 +242,7 @@ function useItems(rightPaneVisible: boolean, widgetsByParent: WidgetsByParent):
},
{
el: <TableOfContents />,
- enabled: (noteType === "text" || noteType === "doc" || isPdf || noteType === "llmChat" || !!note?.isMarkdown()),
+ enabled: (noteType === "text" || isPdf || noteType === "llmChat" || !!note?.isMarkdown()),
tab: "outline"
},
{
diff --git a/apps/client/src/widgets/sidebar/TableOfContents.tsx b/apps/client/src/widgets/sidebar/TableOfContents.tsx
index 4240fdfa2b..f7a767ec94 100644
--- a/apps/client/src/widgets/sidebar/TableOfContents.tsx
+++ b/apps/client/src/widgets/sidebar/TableOfContents.tsx
@@ -38,7 +38,7 @@ export default function TableOfContents() {
return (
<RightPanelWidget id="toc" title={t("toc.table_of_contents")} grow>
- {((noteType === "text" && isReadOnly) || (noteType === "doc")) && <ReadOnlyTextTableOfContents />}
+ {noteType === "text" && isReadOnly && <ReadOnlyTextTableOfContents />}
{noteType === "text" && !isReadOnly && <EditableTextTableOfContents />}
{noteType === "file" && noteMime === "application/pdf" && <ContextDataTableOfContents />}
{noteType === "llmChat" && <ContextDataTableOfContents />}
diff --git a/apps/client/src/widgets/type_widgets/Doc.css b/apps/client/src/widgets/type_widgets/Doc.css
index 3dc440bcfa..a2eb623d6e 100644
--- a/apps/client/src/widgets/type_widgets/Doc.css
+++ b/apps/client/src/widgets/type_widgets/Doc.css
@@ -18,34 +18,3 @@
background-color: var(--accented-background-color);
border: 1px solid var(--main-border-color);
}
-
-.note-detail-doc-content.contextual-help {
- padding-bottom: 0;
-}
-
-.note-detail-doc-content.contextual-help h2,
-.note-detail-doc-content.contextual-help h3,
-.note-detail-doc-content.contextual-help h4,
-.note-detail-doc-content.contextual-help h5,
-.note-detail-doc-content.contextual-help h6 {
- font-size: 1.25rem;
- background-color: var(--main-background-color);
- position: sticky;
- top: 0;
- z-index: 50;
- margin: 0;
- padding-bottom: 0.25em;
-}
-
-img {
- max-width: 100%;
- height: auto;
-}
-
-td img {
- max-width: 40vw;
-}
-
-figure.table {
- overflow: auto !important;
-}
\ No newline at end of file
diff --git a/apps/client/src/widgets/type_widgets/Doc.tsx b/apps/client/src/widgets/type_widgets/Doc.tsx
index 93929c7bab..92596e38f4 100644
--- a/apps/client/src/widgets/type_widgets/Doc.tsx
+++ b/apps/client/src/widgets/type_widgets/Doc.tsx
@@ -8,7 +8,7 @@ import { useTriliumEvent } from "../react/hooks";
import { refToJQuerySelector } from "../react/react_utils";
import { TypeWidgetProps } from "./type_widget";
-export default function Doc({ note, viewScope, ntxId }: TypeWidgetProps) {
+export default function Doc({ note, ntxId }: TypeWidgetProps) {
const initialized = useRef<Promise<void> | null>(null);
const containerRef = useRef<HTMLDivElement>(null);
@@ -31,7 +31,7 @@ export default function Doc({ note, viewScope, ntxId }: TypeWidgetProps) {
return (
<div
ref={containerRef}
- className={`note-detail-doc-content ck-content ${viewScope?.viewMode === "contextual-help" ? "contextual-help" : ""}`}
+ className="note-detail-doc-content ck-content"
/>
);
}
diff --git a/apps/edit-docs/package.json b/apps/edit-docs/package.json
index 3ee46439ba..3be4920d46 100644
--- a/apps/edit-docs/package.json
+++ b/apps/edit-docs/package.json
@@ -20,6 +20,6 @@
"test-build": "vitest --config vitest.build.config.mts",
"edit-docs": "cross-env TRILIUM_PORT=37741 TRILIUM_DATA_DIR=data TRILIUM_INTEGRATION_TEST=memory-no-store tsx ../../scripts/electron-start.mts src/edit-docs.ts",
"sync-docs": "cross-env TRILIUM_DATA_DIR=data TRILIUM_INTEGRATION_TEST=memory-no-store TRILIUM_ENV=dev TRILIUM_RESOURCE_DIR=../server/src tsx src/sync-docs.ts",
- "edit-demo": "cross-env TRILIUM_PORT=37744 TRILIUM_DATA_DIR=data TRILIUM_INTEGRATION_TEST=memory-no-store DOCS_ROOT=../../../docs USER_GUIDE_ROOT=\"../../server/src/assets/doc_notes/en/User Guide\" tsx ../../scripts/electron-start.mts src/edit-demo.ts"
+ "edit-demo": "cross-env TRILIUM_PORT=37744 TRILIUM_DATA_DIR=data TRILIUM_INTEGRATION_TEST=memory-no-store DOCS_ROOT=../../../docs tsx ../../scripts/electron-start.mts src/edit-demo.ts"
}
}
\ No newline at end of file
diff --git a/apps/edit-docs/src/docs_images.spec.ts b/apps/edit-docs/src/docs_images.spec.ts
new file mode 100644
index 0000000000..bdcd5186de
--- /dev/null
+++ b/apps/edit-docs/src/docs_images.spec.ts
@@ -0,0 +1,76 @@
+import { imageExtensionForMime, imageMimeForExtension } from "@triliumnext/commons";
+import { getImageTypeFromBuffer } from "@triliumnext/server/src/services/image_codec.js";
+import { readdirSync, readFileSync, statSync } from "fs";
+import { extname, join, relative, sep } from "path";
+import { describe, expect, it } from "vitest";
+
+/**
+ * The documentation's pictures, checked against what their bytes actually are.
+ *
+ * These files are not read by a browser alone. Every build copies `docs/User Guide` into the app
+ * (`apps/server/scripts/build.ts`, `apps/desktop/scripts/build.ts`, `apps/standalone/vite.config.mts`)
+ * and serves them as the in-app help, where the Content-Type comes from the extension and nothing
+ * looks at the bytes. A file whose name disagrees with its contents is therefore served under the
+ * wrong media type by all three, and any tooling that sorts these by format — a conversion pass,
+ * an optimizer — is misled the same way.
+ *
+ * They arrive by export from a Trilium instance, so the name comes from `mapExtension` in
+ * `packages/trilium-core/src/services/export/zip/abstract_provider.ts` rather than from anyone
+ * typing it, and a wrong one here means that rule got it wrong.
+ */
+
+const DOCS_ROOT = join(__dirname, "..", "..", "..", "docs");
+
+/** Extensions worth opening. Anything else in the tree is not claiming to be a picture. */
+const PICTURE_EXTENSIONS = new Set([".png", ".jpg", ".jpeg", ".gif", ".webp", ".avif", ".bmp", ".ico", ".svg"]);
+
+describe("documentation pictures", () => {
+ it("names every picture after the format its bytes are in", async () => {
+ const pictures = picturesUnder(DOCS_ROOT);
+ const mismatches: string[] = [];
+
+ // A scan that reached nothing would report no mismatch and pass on that alone. The
+ // documentation runs to hundreds of pictures, so anything near zero means the walk went
+ // somewhere else rather than that the tree came out clean.
+ expect(pictures.length).toBeGreaterThan(100);
+
+ for (const file of pictures) {
+ const detected = await getImageTypeFromBuffer(readFileSync(file));
+ const path = relative(DOCS_ROOT, file).split(sep).join("/");
+
+ if (!detected) {
+ mismatches.push(`${path}: not a picture in any format that can be recognised`);
+ continue;
+ }
+
+ // Compared the way the export compares them, so this agrees with the rule that
+ // produced the name: both sides through the media type, which settles `.jpeg` against
+ // `.jpg` and the case of an extension along with it.
+ const claimed = imageExtensionForMime(imageMimeForExtension(extname(file)));
+ const actual = imageExtensionForMime(detected.mime);
+
+ if (claimed !== actual) {
+ mismatches.push(`${path}: named .${claimed}, actually ${actual.toUpperCase()} (${detected.mime})`);
+ }
+ }
+
+ expect(mismatches).toEqual([]);
+ });
+});
+
+/** Every file under a directory whose extension claims it is a picture. */
+function picturesUnder(directory: string): string[] {
+ const found: string[] = [];
+
+ for (const entry of readdirSync(directory)) {
+ const path = join(directory, entry);
+
+ if (statSync(path).isDirectory()) {
+ found.push(...picturesUnder(path));
+ } else if (PICTURE_EXTENSIONS.has(extname(entry).toLowerCase())) {
+ found.push(path);
+ }
+ }
+
+ return found;
+}
diff --git a/apps/edit-docs/src/docs_pipeline.spec.ts b/apps/edit-docs/src/docs_pipeline.spec.ts
index c27b78fedb..b3f21d3b1d 100644
--- a/apps/edit-docs/src/docs_pipeline.spec.ts
+++ b/apps/edit-docs/src/docs_pipeline.spec.ts
@@ -1,63 +1,6 @@
import { describe, expect, it } from "vitest";
-import { normalizeLineEndings, rewriteHelpLinks } from "./docs_pipeline.js";
-
-describe("rewriteHelpLinks", () => {
- it("prefixes plain help-note links with _help_", () => {
- const input = `<a class="reference-link" href="#root/iPIMuisry3hd">Text</a>`;
- expect(rewriteHelpLinks(input)).toBe(`<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>`);
- });
-
- it("does not prefix canonical hidden-subtree notes that already start with an underscore", () => {
- // `_optionsTextNotes` keeps its canonical ID in production; prefixing it would produce the
- // broken `_help__optionsTextNotes` link reported in issue #9646.
- const input = `<a href="#root/_hidden/_options/_optionsTextNotes">Text Notes</a>`;
- expect(rewriteHelpLinks(input)).toBe(input);
- });
-
- it("leaves both options links untouched while still prefixing a sibling help link", () => {
- const input = [
- `<a href="#root/_help_4TIF1oA4VQRO">Options</a>`,
- `<a href="#root/_hidden/_options/_optionsTextNotes">Text Notes</a>`,
- `<a href="#root/_hidden/_options/_optionsCodeNotes">Code Notes</a>`
- ].join(" ");
- const result = rewriteHelpLinks(input);
-
- expect(result).not.toContain("_help__");
- expect(result).toContain("#root/_hidden/_options/_optionsTextNotes");
- expect(result).toContain("#root/_hidden/_options/_optionsCodeNotes");
- });
-
- it("reduces the note path the editor writes to the target ID alone", () => {
- // What a link created in the editor looks like: a full path whose intermediate IDs exist
- // only in the docs instance. An import rewrites the same link to `#root/<noteId>`, so
- // without this the exported HTML alternated between the two forms.
- const input = [
- `<a class="reference-link" href="#root/pOsGYCXsbNQG/tC7s2alapj8V/R9pX4DGra2Vt">Sharing</a>`,
- `<a class="reference-link" href="#root/jdjRLhLV3TtI/YjerxU7Aii8X">Troubleshooting</a>`
- ].join(" ");
- const expected = [
- `<a class="reference-link" href="#root/_help_R9pX4DGra2Vt">Sharing</a>`,
- `<a class="reference-link" href="#root/_help_YjerxU7Aii8X">Troubleshooting</a>`
- ].join(" ");
- expect(rewriteHelpLinks(input)).toBe(expected);
- });
-
- it("reduces a path whose target is already prefixed, as a previously exported link is", () => {
- const input = `<a href="#root/pOsGYCXsbNQG/KSZ04uQ2D1St/_help_hrZ1D00cLbal">Internal links</a>`;
- expect(rewriteHelpLinks(input)).toBe(`<a href="#root/_help_hrZ1D00cLbal">Internal links</a>`);
- });
-
- it("keeps a query suffix on the link it rewrites", () => {
- const input = `<a href="#root/pOsGYCXsbNQG/R9pX4DGra2Vt?viewMode=source">Sharing</a>`;
- expect(rewriteHelpLinks(input)).toBe(`<a href="#root/_help_R9pX4DGra2Vt?viewMode=source">Sharing</a>`);
- });
-
- it("is idempotent for already-prefixed help links", () => {
- const input = `<a href="#root/_help_iPIMuisry3hd">Text</a>`;
- expect(rewriteHelpLinks(input)).toBe(input);
- });
-});
+import { normalizeLineEndings } from "./docs_pipeline.js";
describe("normalizeLineEndings", () => {
const encoder = new TextEncoder();
diff --git a/apps/edit-docs/src/docs_pipeline.ts b/apps/edit-docs/src/docs_pipeline.ts
index 41179ebaba..0cc49df78c 100644
--- a/apps/edit-docs/src/docs_pipeline.ts
+++ b/apps/edit-docs/src/docs_pipeline.ts
@@ -2,7 +2,7 @@
* The import/export half of edit-docs, with no Electron dependency: `edit-docs.ts` runs it
* behind a window, `sync-docs.ts` runs it headless.
*/
-import { BackupService, initializeCore, type AdvancedExportOptions, type MessagingProvider, type NoteMeta, type NoteMetaFile } from "@triliumnext/core";
+import { BackupService, initializeCore, type MessagingProvider, type NoteMeta, type NoteMetaFile } from "@triliumnext/core";
import AsyncLocalStorageExecutionContext from "@triliumnext/server/src/cls_provider.js";
import NodejsCryptoProvider from "@triliumnext/server/src/crypto_provider.js";
import ServerPlatformProvider from "@triliumnext/server/src/platform_provider.js";
@@ -16,14 +16,22 @@ import { load } from "js-yaml";
import path from "path";
import { deferred } from "../../../packages/commons/src/index.js";
-import { parseNoteMetaFile, serverTextNoteHandler, standaloneTextNoteHandler, stripAppVersion } from "./help_meta_generator.js";
+import { buildHelpBundle } from "./help_bundle_generator.js";
+import { buildHelpMeta, serializeHelpMeta, stripAppVersion } from "./help_meta_generator.js";
export interface NoteMapping {
rootNoteId: string;
path: string;
- format: "markdown" | "html";
+ format: "markdown";
ignoredFiles?: string[];
exportOnly?: boolean;
+ /**
+ * Where to write the in-app help tree derived from this mapping's export, if it is the one
+ * backing the User Guide. Relative to the configuration file.
+ */
+ helpMeta?: string;
+ /** Where to write the rendered content of that tree. Relative to the configuration file. */
+ helpContent?: string;
}
export interface Config {
@@ -51,7 +59,9 @@ export async function loadConfig(configPath?: string): Promise<Config> {
baseUrl: config.baseUrl,
noteMappings: config.noteMappings.map((mapping) => ({
...mapping,
- path: path.resolve(configDir, mapping.path)
+ path: path.resolve(configDir, mapping.path),
+ helpMeta: mapping.helpMeta ? path.resolve(configDir, mapping.helpMeta) : undefined,
+ helpContent: mapping.helpContent ? path.resolve(configDir, mapping.helpContent) : undefined
}))
};
}
@@ -136,12 +146,13 @@ export async function importMappings(mappings: NoteMapping[]) {
/** Exports every mapping, in config order, replacing each target directory. */
export async function exportMappings(mappings: NoteMapping[], baseUrl: string) {
for (const mapping of mappings) {
- const ignoredFiles = mapping.ignoredFiles ? new Set(mapping.ignoredFiles) : undefined;
- await exportData(mapping.rootNoteId, mapping.format, mapping.path, baseUrl, ignoredFiles);
+ await exportData(mapping, baseUrl);
}
}
-export async function exportData(noteId: string, format: "markdown" | "html", outputPath: string, baseUrl: string, ignoredFiles?: Set<string>) {
+export async function exportData(mapping: NoteMapping, baseUrl: string) {
+ const { path: outputPath, ignoredFiles: ignoredFileNames } = mapping;
+ const ignoredFiles = ignoredFileNames ? new Set(ignoredFileNames) : undefined;
const zipFilePath = "output.zip";
try {
@@ -151,59 +162,20 @@ export async function exportData(noteId: string, format: "markdown" | "html", ou
// First export as zip.
const { zipExportService } = (await import("@triliumnext/core"));
- const exportOpts: AdvancedExportOptions = {};
- if (format === "html") {
- exportOpts.skipHtmlTemplate = true;
- exportOpts.customRewriteLinks = (originalRewriteLinks, getNoteTargetUrl) => {
- return (content: string, noteMeta: NoteMeta) => {
- content = content.replace(/src="[^"]*api\/images\/([a-zA-Z0-9_]+)\/[^"]*"/g, (match, targetNoteId) => {
- const url = getNoteTargetUrl(targetNoteId, noteMeta);
-
- return url ? `src="${url}"` : match;
- });
-
- content = content.replace(/src="[^"]*api\/attachments\/([a-zA-Z0-9_]+)\/image\/[^"]*"/g, (match, targetAttachmentId) => {
- const url = findAttachment(targetAttachmentId);
-
- return url ? `src="${url}"` : match;
- });
-
- content = content.replace(/href="[^"]*#root[^"]*attachmentId=([a-zA-Z0-9_]+)\/?"/g, (match, targetAttachmentId) => {
- const url = findAttachment(targetAttachmentId);
-
- return url ? `href="${url}"` : match;
- });
-
- content = rewriteHelpLinks(content);
-
- return content;
-
- function findAttachment(targetAttachmentId: string) {
- let url;
-
- const attachmentMeta = (noteMeta.attachments || []).find((attMeta) => attMeta.attachmentId === targetAttachmentId);
- if (attachmentMeta) {
- // easy job here, because attachment will be in the same directory as the note's data file.
- url = attachmentMeta.dataFileName;
- } else {
- console.info(`Could not find attachment meta object for attachmentId '${targetAttachmentId}'`);
- }
- return url;
- }
- };
- };
- }
-
- await zipExportService.exportToZipFile(noteId, format, zipFilePath, exportOpts);
+ await zipExportService.exportToZipFile(mapping.rootNoteId, mapping.format, zipFilePath, {});
await extractZip(zipFilePath, outputPath, ignoredFiles);
} finally {
await fs.rm(zipFilePath, { force: true });
}
- await cleanUpMeta(outputPath, format === "html", baseUrl);
+ await cleanUpMeta(outputPath, mapping, baseUrl);
}
-async function cleanUpMeta(outputPath: string, minify: boolean, baseUrl: string) {
+/**
+ * Normalizes the freshly exported `!!!meta.json` so it doesn't churn between runs, and — for the
+ * mapping backing the User Guide — derives the in-app help tree and its rendered content.
+ */
+async function cleanUpMeta(outputPath: string, mapping: NoteMapping, baseUrl: string) {
const metaPath = path.join(outputPath, "!!!meta.json");
const meta = JSON.parse(await fs.readFile(metaPath, "utf-8")) as NoteMetaFile;
for (const file of meta.files) {
@@ -217,27 +189,44 @@ async function cleanUpMeta(outputPath: string, minify: boolean, baseUrl: string)
}
el.isExpanded = false;
+ }
- // Rewrite web view URLs that point to root.
- if (el.type === "webView" && minify) {
- const srcAttr = el.attributes.find(attr => attr.name === "webViewSrc");
- if (srcAttr.value.startsWith("/")) {
- srcAttr.value = baseUrl + srcAttr.value;
- }
- }
+ await fs.writeFile(metaPath, JSON.stringify(stripAppVersion(meta), null, 4));
+
+ if (!mapping.helpMeta && !mapping.helpContent) {
+ return;
}
- if (minify) {
- const subtree = parseNoteMetaFile(meta, serverTextNoteHandler, baseUrl);
- await fs.writeFile(metaPath, JSON.stringify(subtree));
+ const { meta: helpMeta, sources } = buildHelpMeta(meta, baseUrl);
- // Generate standalone meta: webView-based, pointing to online docs.
- const standaloneSubtree = parseNoteMetaFile(meta, standaloneTextNoteHandler, baseUrl);
- const standaloneMetaPath = path.resolve(__dirname, "../../standalone/src/assets/help_meta.json");
- await fs.writeFile(standaloneMetaPath, JSON.stringify(standaloneSubtree));
- } else {
- await fs.writeFile(metaPath, JSON.stringify(stripAppVersion(meta), null, 4));
+ if (mapping.helpMeta) {
+ await writeArtifact(mapping.helpMeta, serializeHelpMeta(helpMeta));
}
+
+ if (mapping.helpContent) {
+ const { markdownImportService } = await import("@triliumnext/core");
+ const bundle = buildHelpBundle(
+ helpMeta,
+ sources,
+ (source) => {
+ try {
+ return readFileSync(path.join(outputPath, source), "utf-8");
+ } catch {
+ return null;
+ }
+ },
+ (markdown, title) => markdownImportService.renderToHtml(markdown, title)
+ );
+
+ // One page per line: the bundle is a flat map from note ID to HTML.
+ await writeArtifact(mapping.helpContent, JSON.stringify(bundle, null, 4));
+ }
+}
+
+/** Writes a generated help artifact, creating its directory if needed. */
+async function writeArtifact(filePath: string, content: string) {
+ await fs.mkdir(path.dirname(filePath), { recursive: true });
+ await fs.writeFile(filePath, content);
}
async function createImportZip(path: string) {
@@ -268,36 +257,6 @@ function waitForEnd(archive: Archiver, stream: WriteStream) {
});
}
-/**
- * Rewrites internal `#root/...` note links in exported help HTML so that they resolve
- * against the help subtree once imported into a production Trilium instance.
- *
- * In the edit-docs instance the help notes carry plain, randomly generated IDs, but in
- * production they live under the `_help` subtree with a `_help_` prefix. This adds that
- * prefix to the link's target note ID, and reduces the link to that ID alone: the editor
- * writes a full note path when a link is created, whose intermediate IDs belong to the
- * docs instance and match nothing in the tree a reader has, leaving the client to fall
- * back to the note's own path. The importer writes the same single-ID form, so a note
- * exported straight after an edit now matches one that has been through an import.
- */
-export function rewriteHelpLinks(content: string): string {
- return content.replace(/href="([^"]*#root)(?:[a-zA-Z0-9_/]*\/)?([a-zA-Z0-9_]+)([^"]*)"/g,
- (match, prefix: string, targetNoteId: string, suffix: string) => {
- if (targetNoteId.startsWith("_help_")) {
- return `href="${prefix}/${targetNoteId}${suffix}"`;
- }
-
- // Canonical hidden-subtree notes (e.g. _options, _optionsTextNotes) keep their IDs in
- // production, so they already start with an underscore, and their path is a real one.
- // Only help notes (random alphanumeric IDs) get the `_help_` prefix; prefixing the
- // others would produce broken `_help__optionsTextNotes`-style links (see issue #9646).
- if (targetNoteId.startsWith("_")) {
- return match;
- }
- return `href="${prefix}/_help_${targetNoteId}${suffix}"`;
- });
-}
-
export async function createZipFromDirectory(dirPath: string, zipPath: string) {
const archive = new ZipArchive({ zlib: { level: 5 } });
const outputStream = createWriteStream(zipPath);
@@ -329,7 +288,7 @@ export async function extractZip(zipFilePath: string, outputPath: string, ignore
/**
* Rewrites CRLF line endings to LF, so that `extractZip` writes the same bytes on Windows as it
- * does elsewhere. The exported trees (`docs/`, the help HTML, the demo) are stored with LF, and
+ * does elsewhere. The exported trees (`docs/`, the demo) are stored with LF, and
* Git only hides the difference once a file is staged.
*
* Binary entries such as images keep their bytes. They are detected the way Git detects them: a
diff --git a/apps/edit-docs/src/help_bundle_generator.spec.ts b/apps/edit-docs/src/help_bundle_generator.spec.ts
new file mode 100644
index 0000000000..e3a3c4ad8b
--- /dev/null
+++ b/apps/edit-docs/src/help_bundle_generator.spec.ts
@@ -0,0 +1,181 @@
+import type { HelpMetaItem } from "@triliumnext/commons";
+import { describe, expect, it, vi } from "vitest";
+
+import { buildHelpBundle } from "./help_bundle_generator.js";
+import type { HelpSources } from "./help_meta_generator.js";
+
+const render = (markdown: string, title: string) => `<h1>${title}</h1>${markdown.trim()}`;
+const readFrom = (pages: Record<string, string>) => (source: string) => pages[source] ?? null;
+
+/** A note as the export describes it, before the build separates the tree from the files. */
+interface Fixture {
+ id: string;
+ title: string;
+ type: HelpMetaItem["type"];
+ mime?: string;
+ source?: string;
+ dir?: string;
+ children?: Fixture[];
+}
+
+/** Splits fixtures into the two arguments `buildHelpMeta` hands over, so both stay in one place. */
+function split(fixtures: Fixture[]): [ HelpMetaItem[], HelpSources ] {
+ const sources: HelpSources = {};
+
+ const toTree = (items: Fixture[]): HelpMetaItem[] => items.map(({ source, dir, children, ...rest }) => {
+ if (source || dir) {
+ sources[rest.id] = { source, dir };
+ }
+ return children ? { ...rest, children: toTree(children) } : rest;
+ });
+
+ return [ toTree(fixtures), sources ];
+}
+
+describe("buildHelpBundle", () => {
+ it("renders pages by note ID, descends into folders and skips notes without content", () => {
+ const meta: Fixture[] = [
+ {
+ id: "_help_folder",
+ title: "Note Types",
+ type: "book",
+ children: [
+ { id: "_help_text", title: "Text", type: "text", source: "User Guide/Note Types/Text.md" },
+ { id: "_help_embed", title: "Embedded", type: "webView" }
+ ]
+ }
+ ];
+
+ const bundle = buildHelpBundle(...split(meta), readFrom({ "User Guide/Note Types/Text.md": "# Text\nBody" }), render);
+
+ // Folders and web views have no content of their own, so they get no entry at all.
+ expect(Object.keys(bundle)).toEqual([ "_help_text" ]);
+ expect(bundle._help_text).toBe("<h1>Text</h1># Text\nBody");
+ });
+
+ it("keeps code notes verbatim instead of rendering them as markdown", () => {
+ const meta: Fixture[] = [
+ { id: "_help_script", title: "Example", type: "code", mime: "text/javascript", source: "User Guide/Example.js" }
+ ];
+ const script = "// # not a heading\nconst x = 1;\n";
+
+ const bundle = buildHelpBundle(...split(meta), readFrom({ "User Guide/Example.js": script }), render);
+
+ expect(bundle._help_script).toBe(script);
+ });
+
+ it("skips a page whose file cannot be read rather than failing the whole export", () => {
+ const warn = vi.spyOn(console, "warn").mockImplementation(() => {});
+ const meta: Fixture[] = [
+ { id: "_help_gone", title: "Missing", type: "text", source: "User Guide/Missing.md" },
+ { id: "_help_here", title: "Present", type: "text", source: "User Guide/Present.md" }
+ ];
+
+ const bundle = buildHelpBundle(...split(meta), readFrom({ "User Guide/Present.md": "Body" }), render);
+
+ expect(Object.keys(bundle)).toEqual([ "_help_here" ]);
+ expect(warn).toHaveBeenCalledWith(expect.stringContaining("User Guide/Missing.md"));
+ warn.mockRestore();
+ });
+
+ describe("links between pages", () => {
+ const meta: Fixture[] = [
+ { id: "_help_types", title: "Note Types", type: "book", dir: "User Guide/Note Types", children: [
+ { id: "_help_text", title: "Text", type: "text", source: "User Guide/Note Types/Text.md" },
+ { id: "_help_code", title: "Code", type: "text", source: "User Guide/Note Types/Code.md" }
+ ] },
+ { id: "_help_intro", title: "Intro", type: "text", source: "User Guide/Intro.md" }
+ ];
+
+ /** Renders the given body as the "Text" page and returns the values of one attribute. */
+ function urlsOf(body: string, attribute: "href" | "src"): string[] {
+ const bundle = buildHelpBundle(
+ ...split(meta),
+ readFrom({ "User Guide/Note Types/Text.md": body }),
+ (markdown) => markdown
+ );
+ return [ ...bundle._help_text.matchAll(new RegExp(`${attribute}="([^"]*)"`, "g")) ].map((m) => m[1]);
+ }
+
+ const hrefsOf = (body: string) => urlsOf(body, "href");
+ const srcsOf = (body: string) => urlsOf(body, "src");
+
+ it("resolves relative paths against the linking page and rewrites them to note links", () => {
+ expect(hrefsOf('<a href="Code.md">sibling</a>')).toEqual([ "#root/_help_code" ]);
+ expect(hrefsOf('<a href="../Intro.md">up a level</a>')).toEqual([ "#root/_help_intro" ]);
+ // Titles carry spaces, so the authored links are percent-encoded.
+ expect(hrefsOf('<a href="../Note%20Types/Code.md">encoded</a>')).toEqual([ "#root/_help_code" ]);
+ // A folder note is linked without its extension.
+ expect(hrefsOf('<a href="../Intro">extensionless</a>')).toEqual([ "#root/_help_intro" ]);
+ // A note is addressed as a whole, so a fragment on the path has nothing to point at.
+ expect(hrefsOf('<a href="Code.md#syntax">fragment</a>')).toEqual([ "#root/_help_code" ]);
+ });
+
+ it("resolves a link to a folder note, which has no file of its own", () => {
+ expect(hrefsOf('<a href="../Note%20Types">the folder</a>')).toEqual([ "#root/_help_types" ]);
+ });
+
+ it("rewrites markdown-authored links, not just the reference links in raw HTML", () => {
+ const bundle = buildHelpBundle(
+ ...split(meta),
+ readFrom({ "User Guide/Note Types/Text.md": "[Code](Code.md)" }),
+ (markdown) => markdown.replace(/\[(.*?)\]\((.*?)\)/, '<a href="$2">$1</a>')
+ );
+ expect(bundle._help_text).toBe('<a href="#root/_help_code">Code</a>');
+ });
+
+ it("leaves alone everything that addresses something other than a file of the guide", () => {
+ // External link, in-page footnote anchor, an existing deep link into a system note,
+ // and a markdown page the guide does not ship — a broken link, kept visible as
+ // authored rather than disguised as an asset URL.
+ const untouched = [
+ "https://example.com/Code.md",
+ "#fn1saoftmefpp",
+ "#root/_hidden/_options",
+ "../../Technical Guide/Internals.md"
+ ];
+
+ for (const href of untouched) {
+ expect(hrefsOf(`<a href="${href}">link</a>`)).toEqual([ href ]);
+ }
+ });
+
+ it("turns asset references into placeholder paths from the export root", () => {
+ // Pages write these both ways: raw in an <img src>, percent-encoded in markdown image
+ // syntax — and the renderer escapes the ampersands of either as HTML. All three come
+ // out as one consistently encoded URL.
+ expect(hrefsOf('<img src="Text_image.png">'))
+ .toEqual([]);
+ expect(srcsOf('<img src="Text_image.png">'))
+ .toEqual([ "{{helpAssets}}/User%20Guide/Note%20Types/Text_image.png" ]);
+ expect(srcsOf('<img src="../Import%20%26%20Export/pic.png">'))
+ .toEqual([ "{{helpAssets}}/User%20Guide/Import%20%26%20Export/pic.png" ]);
+ expect(srcsOf('<img src="../Import &amp; Export/pic.png">'))
+ .toEqual([ "{{helpAssets}}/User%20Guide/Import%20%26%20Export/pic.png" ]);
+ // The attachments a few pages link to are assets as well, not notes.
+ expect(hrefsOf('<a href="Backend%20API.dat">API</a>'))
+ .toEqual([ "{{helpAssets}}/User%20Guide/Note%20Types/Backend%20API.dat" ]);
+ });
+
+ it("does not touch the contents of code notes", () => {
+ const script = 'const link = \'<a href="Code.md">\';\n';
+ const bundle = buildHelpBundle(
+ ...split([ { id: "_help_script", title: "Example", type: "code", source: "User Guide/Example.js" } ]),
+ readFrom({ "User Guide/Example.js": script }),
+ render
+ );
+
+ expect(bundle._help_script).toBe(script);
+ });
+ });
+
+ it("keeps an empty page as an empty entry, distinct from having no content at all", () => {
+ const meta: Fixture[] = [
+ { id: "_help_empty", title: "Empty", type: "text", source: "User Guide/Empty.md" }
+ ];
+
+ const bundle = buildHelpBundle(...split(meta), readFrom({ "User Guide/Empty.md": "" }), (markdown) => markdown);
+
+ expect(bundle).toHaveProperty("_help_empty", "");
+ });
+});
diff --git a/apps/edit-docs/src/help_bundle_generator.ts b/apps/edit-docs/src/help_bundle_generator.ts
new file mode 100644
index 0000000000..34044c358d
--- /dev/null
+++ b/apps/edit-docs/src/help_bundle_generator.ts
@@ -0,0 +1,173 @@
+import type { HelpBundle, HelpMetaItem } from "@triliumnext/commons";
+import path from "path";
+
+import type { HelpSources } from "./help_meta_generator.js";
+
+/**
+ * Builds the in-app help content bundle: the rendered page of every note in the help tree,
+ * keyed by note ID.
+ *
+ * Pages are authored as markdown under `docs/User Guide` and the application displays HTML, so
+ * the conversion happens here, once, rather than in each application at runtime — that keeps the
+ * markdown renderer out of the server and standalone builds, and pins the whole User Guide to a
+ * single renderer version that is reviewed along with the docs.
+ *
+ * Reading and rendering are injected so this stays a pure function: `edit-docs` passes the
+ * filesystem and the same markdown conversion a user gets when importing a markdown file.
+ *
+ * @param meta the help tree, as produced by `buildHelpMeta`.
+ * @param sources the export file behind each note, as produced alongside that tree.
+ * @param readPage reads a note's source file (paths as they appear in {@link HelpSources}, i.e.
+ * relative to the markdown export root), or returns null if it is missing.
+ * @param renderMarkdown converts markdown to the HTML a text note holds.
+ */
+export function buildHelpBundle(
+ meta: HelpMetaItem[],
+ sources: HelpSources,
+ readPage: (source: string) => string | null,
+ renderMarkdown: (markdown: string, title: string) => string
+): HelpBundle {
+ const bundle: HelpBundle = {};
+ collectPages(meta, sources, readPage, renderMarkdown, indexSources(sources), bundle);
+ return bundle;
+}
+
+function collectPages(
+ items: HelpMetaItem[],
+ sources: HelpSources,
+ readPage: (path: string) => string | null,
+ renderMarkdown: (markdown: string, title: string) => string,
+ noteIdBySource: Map<string, string>,
+ bundle: HelpBundle
+): void {
+ for (const item of items) {
+ const sourcePath = sources[item.id]?.source;
+
+ if (sourcePath) {
+ const source = readPage(sourcePath);
+
+ if (source === null) {
+ // One unreadable page must not cost the whole export; the note stays in the tree
+ // and renders empty, which is visible in the application and in the diff.
+ console.warn(`Help page '${sourcePath}' could not be read, skipping '${item.id}'.`);
+ } else if (item.type === "code") {
+ // Code notes are shown verbatim in their own language — running them through the
+ // markdown renderer would turn a script into a paragraph.
+ bundle[item.id] = source;
+ } else {
+ bundle[item.id] = rewriteLinks(renderMarkdown(source, item.title), sourcePath, noteIdBySource);
+ }
+ }
+
+ if (item.children) {
+ collectPages(item.children, sources, readPage, renderMarkdown, noteIdBySource, bundle);
+ }
+ }
+}
+
+/**
+ * Maps every path a note can be addressed by to that note, for resolving links between pages: its
+ * content file, and its directory — which is all a folder note has, since it holds no file itself.
+ */
+function indexSources(sources: HelpSources): Map<string, string> {
+ const out = new Map<string, string>();
+
+ for (const [ id, { source, dir } ] of Object.entries(sources)) {
+ const noteId = id.replace(/^_help_/, "");
+
+ if (source) {
+ out.set(normalize(source), noteId);
+ }
+ if (dir) {
+ out.set(normalize(dir), noteId);
+ }
+ }
+
+ return out;
+}
+
+/**
+ * Rewrites the two kinds of path a page is authored with.
+ *
+ * Links between pages become note links: pages are authored as files and link to each other by
+ * relative path, but they are displayed as notes, where the only thing that resolves is the note's
+ * ID. Anything that does not name another page — external URLs, in-page anchors (footnotes), the
+ * deliberate `#root/…` deep links into system notes — is left exactly as authored.
+ *
+ * Everything else relative is an asset shipped alongside the guide (images, and the handful of
+ * `.dat` files some pages link to). Those become {@link HELP_ASSET_TOKEN} paths from the export
+ * root; each platform substitutes the token for wherever it serves them from, so one bundle works
+ * everywhere.
+ */
+function rewriteLinks(html: string, source: string, noteIdBySource: Map<string, string>): string {
+ const pageDir = path.posix.dirname(normalize(source));
+
+ return html.replace(/(href|src)="([^"]*)"/g, (match, attribute: string, url: string) => {
+ const noteId = resolveHelpTarget(url, pageDir, noteIdBySource);
+ if (noteId) {
+ return `${attribute}="#root/_help_${noteId}"`;
+ }
+
+ const asset = resolveHelpAsset(url, pageDir);
+ return asset ? `${attribute}="${asset}"` : match;
+ });
+}
+
+/**
+ * Placeholder standing in for wherever a platform serves the guide's assets from — substituted
+ * when a page is read (see `services/in_app_help.ts` in the core).
+ */
+export const HELP_ASSET_TOKEN = "{{helpAssets}}";
+
+/** Resolves a page-relative asset reference to its path from the export root, or null. */
+function resolveHelpAsset(url: string, pageDir: string): string | null {
+ if (!url || url.startsWith("#") || /^[a-z][a-z0-9+.-]*:/i.test(url) || url.startsWith(HELP_ASSET_TOKEN)) {
+ return null;
+ }
+
+ // A markdown file is a page, not an asset. Having got this far it names one the guide does not
+ // ship, so it is a broken link — left as authored rather than disguised as an asset URL.
+ if (url.split("#")[0].endsWith(".md")) {
+ return null;
+ }
+
+ const target = path.posix.normalize(path.posix.join(pageDir, toFilePath(url)));
+ // Re-encoded per segment: the guide's file names carry spaces and ampersands, and pages write
+ // them both ways — raw in `<img src>`, percent-encoded in markdown image syntax.
+ return `${HELP_ASSET_TOKEN}/${target.split("/").map(encodeURIComponent).join("/")}`;
+}
+
+/** Resolves a page-relative href to the note it names, or null if it names something else. */
+function resolveHelpTarget(href: string, pageDir: string, noteIdBySource: Map<string, string>): string | null {
+ // In-page anchors and absolute URLs (including the `#root/…` deep links) address something
+ // other than a file next to this page.
+ if (!href || href.startsWith("#") || /^[a-z][a-z0-9+.-]*:/i.test(href)) {
+ return null;
+ }
+
+ // A note is addressed as a whole, so a fragment on the path has nothing to point at — the
+ // HTML export dropped these too.
+ const [ filePath ] = href.split("#");
+ const target = path.posix.normalize(path.posix.join(pageDir, toFilePath(filePath)));
+
+ // Folder notes are linked without their extension.
+ return noteIdBySource.get(target) ?? noteIdBySource.get(`${target}.md`) ?? null;
+}
+
+/**
+ * Turns a URL as written in a page into the file path it names, so it can be matched against the
+ * export. Pages carry both forms — a raw `<img src>` keeps the file name as-is while markdown
+ * syntax percent-encodes it — and the renderer escapes the ampersands of either as HTML.
+ */
+function toFilePath(url: string): string {
+ const unescaped = url.replaceAll("&amp;", "&");
+
+ try {
+ return decodeURIComponent(unescaped);
+ } catch {
+ // A stray `%` in a file name is not an escape sequence; take the path as written.
+ return unescaped;
+ }
+}
+
+const normalize = (filePath: string) => path.posix.normalize(filePath.split(path.sep).join("/"));
diff --git a/apps/edit-docs/src/help_meta_generator.spec.ts b/apps/edit-docs/src/help_meta_generator.spec.ts
index 6272508bbb..8e46c42914 100644
--- a/apps/edit-docs/src/help_meta_generator.spec.ts
+++ b/apps/edit-docs/src/help_meta_generator.spec.ts
@@ -1,309 +1,150 @@
-import type { HiddenSubtreeItem } from "@triliumnext/commons";
+import type { HelpMetaItem } from "@triliumnext/commons";
import type { NoteMeta, NoteMetaFile } from "@triliumnext/core";
import { describe, expect, it } from "vitest";
-import { parseNoteMetaFile, serverTextNoteHandler, standaloneTextNoteHandler, stripAppVersion } from "./help_meta_generator.js";
-
-describe("Help meta generation (server)", () => {
- it("preserves custom folder icon", () => {
- const child: NoteMeta = {
- isClone: false,
- noteId: "yoAe4jV2yzbd",
- notePath: [ "OkOZllzB3fqN", "yoAe4jV2yzbd" ],
- title: "Features",
- notePosition: 40,
- prefix: null,
- isExpanded: false,
- type: "text",
- mime: "text/html",
- attributes: [
- { type: "label", name: "iconClass", value: "bx bx-star", isInheritable: false, position: 10 }
- ],
- format: "html",
- attachments: [],
- dirFileName: "Features",
- children: []
- };
- const root: NoteMeta = {
- isClone: false, noteId: "root", notePath: ["root"], title: "Root",
- notePosition: 1, prefix: null, isExpanded: false, type: "text",
- mime: "text/html", attributes: [], format: "html", attachments: [],
- dirFileName: "Root", children: [child]
- };
-
- const metaFile = { formatVersion: 2, appVersion: "0.103.0", files: [root] };
- const items = parseNoteMetaFile(metaFile, serverTextNoteHandler);
- const icon = items[0]?.attributes?.find((a) => a.name === "iconClass");
- expect(icon?.value).toBe("bx bx-star");
+import { buildHelpMeta, serializeHelpMeta, stripAppVersion } from "./help_meta_generator.js";
+
+const BASE_URL = "https://docs.triliumnotes.org";
+
+/** Wraps the given notes in a "User Guide" export root, mirroring the real markdown export. */
+function metaFileOf(children: NoteMeta[], rootAttributes: NoteMeta["attributes"] = []): { formatVersion: number; appVersion: string; files: NoteMeta[] } {
+ const root: NoteMeta = {
+ isClone: false, noteId: "root", notePath: ["root"], title: "User Guide",
+ notePosition: 1, prefix: null, isExpanded: false, type: "text", mime: "text/html",
+ attributes: rootAttributes, format: "markdown", attachments: [],
+ dataFileName: "User Guide.md", dirFileName: "User Guide", children
+ };
+ return { formatVersion: 2, appVersion: "0.103.0", files: [root] };
+}
+
+const labelOf = (item: HelpMetaItem | undefined, name: string) =>
+ item?.attributes?.find((a) => a.name === name)?.value;
+
+describe("buildHelpMeta", () => {
+ it("resolves structure, icons and content sources", () => {
+ const page: NoteMeta = {
+ isClone: false, noteId: "text1", title: "Text", type: "text", mime: "text/html",
+ attributes: [{ type: "label", name: "iconClass", value: "bx bx-star", isInheritable: false, position: 10 }],
+ format: "markdown", dataFileName: "Text.md", children: []
+ };
+ const folder: NoteMeta = {
+ isClone: false, noteId: "types", title: "Note Types", type: "text", mime: "text/html",
+ attributes: [], format: "markdown", dirFileName: "Note Types", children: [page]
+ };
+
+ const { meta: items, sources } = buildHelpMeta(metaFileOf([folder]));
+ const folderItem = items[0];
+ const pageItem = folderItem?.children?.[0];
+
+ // A note with no data file of its own is a folder: no source, but a directory, which is
+ // the only path other pages can link to it by.
+ expect(folderItem?.id).toBe("_help_types");
+ expect(folderItem?.type).toBe("book");
+ expect(sources._help_types?.source).toBeUndefined();
+ expect(sources._help_types?.dir).toBe("User Guide/Note Types");
+ expect(labelOf(folderItem, "iconClass")).toBe("bx bx-folder");
+
+ // Sources are relative to the export directory, which already is the root note's folder,
+ // so the root contributes exactly one path segment.
+ expect(pageItem?.id).toBe("_help_text1");
+ expect(pageItem?.type).toBe("text");
+ expect(sources._help_text1?.source).toBe("User Guide/Note Types/Text.md");
+ expect(labelOf(pageItem, "iconClass")).toBe("bx bx-star");
});
- it("resolves a cloned note's iconClass and docName to the primary occurrence", () => {
+ it("resolves a clone's icon and source to the primary occurrence", () => {
// The same note is placed under two folders: a primary occurrence (isClone:false) carrying
- // a custom icon, and a clone (isClone:true) with no attributes and a ".clone" data file.
- // Both occurrences map to the same noteId, so the runtime hidden-subtree check enforces one
- // set of attributes; if the generator emits different iconClass/docName per occurrence, that
- // check flip-flops them on every run. The clone must therefore inherit the primary's values.
+ // a custom icon and the real file, and a clone (isClone:true) with no attributes and a
+ // ".clone" data file. Both are the same note, so both must describe it identically —
+ // otherwise the clone would point at a file that only exists to satisfy the export.
const primary: NoteMeta = {
isClone: false, noteId: "nix", title: "Nix flake", type: "text", mime: "text/html",
attributes: [{ type: "label", name: "iconClass", value: "bx bxl-tux", isInheritable: false, position: 10 }],
- format: "html", dataFileName: "Nix flake.html", children: []
+ format: "markdown", dataFileName: "Nix flake.md", children: []
};
const clone: NoteMeta = {
isClone: true, noteId: "nix", title: "Nix flake", type: "text", mime: "text/html",
- format: "html", dataFileName: "Nix flake.clone.html", children: []
+ format: "markdown", dataFileName: "Nix flake.clone.md", children: []
};
const desktop: NoteMeta = {
isClone: false, noteId: "desktop", title: "Desktop Installation", type: "text", mime: "text/html",
- attributes: [], format: "html", dirFileName: "Desktop Installation", children: [primary]
+ attributes: [], format: "markdown", dirFileName: "Desktop Installation", children: [primary]
};
const server: NoteMeta = {
isClone: false, noteId: "server", title: "Server Installation", type: "text", mime: "text/html",
- attributes: [], format: "html", dirFileName: "Server Installation", children: [clone]
- };
- const root: NoteMeta = {
- isClone: false, noteId: "root", title: "User Guide", type: "text", mime: "text/html",
- attributes: [], format: "html", dirFileName: "User Guide", children: [desktop, server]
+ attributes: [], format: "markdown", dirFileName: "Server Installation", children: [clone]
};
- const metaFile = { formatVersion: 2, appVersion: "0.103.0", files: [root] };
- const items = parseNoteMetaFile(metaFile, serverTextNoteHandler);
-
+ const { meta: items, sources } = buildHelpMeta(metaFileOf([desktop, server]));
const primaryItem = items.find((i) => i.id === "_help_desktop")?.children?.[0];
const cloneItem = items.find((i) => i.id === "_help_server")?.children?.[0];
+
expect(primaryItem?.id).toBe("_help_nix");
expect(cloneItem?.id).toBe("_help_nix");
-
- const iconOf = (it?: HiddenSubtreeItem) => it?.attributes?.find((a) => a.name === "iconClass")?.value;
- const docNameOf = (it?: HiddenSubtreeItem) => it?.attributes?.find((a) => a.name === "docName")?.value;
-
- // The clone inherits the primary's custom icon rather than falling back to "bx bx-file".
- expect(iconOf(primaryItem)).toBe("bx bxl-tux");
- expect(iconOf(cloneItem)).toBe("bx bxl-tux");
- // Both point at the same documentation file (the primary's), not the clone's ".clone" path.
- expect(docNameOf(cloneItem)).toBe(docNameOf(primaryItem));
+ expect(labelOf(cloneItem, "iconClass")).toBe("bx bxl-tux");
+ // Both occurrences are the one note, so they leave one source between them — the primary's
+ // file rather than the ".clone" copy the export wrote beside it.
+ expect(sources._help_nix?.source).toBe("User Guide/Desktop Installation/Nix flake.md");
});
- it("generates docUrl from shareAlias when baseUrl is provided", () => {
- const meta: NoteMeta = {
- isClone: false,
- noteId: "rootNote123",
- notePath: [ "rootNote123" ],
- title: "User Guide",
- notePosition: 1,
- prefix: null,
- isExpanded: false,
- type: "text",
- mime: "text/html",
- attributes: [
- { type: "label", name: "shareAlias", value: "user-guide", isInheritable: false, position: 10 }
- ],
- format: "html",
- dataFileName: "User Guide.html",
- dirFileName: "User Guide",
- attachments: [],
- children: [
- {
- isClone: false,
- noteId: "childNote456",
- notePath: [ "rootNote123", "childNote456" ],
- title: "Feature Highlights",
- notePosition: 10,
- prefix: null,
- isExpanded: false,
- type: "text",
- mime: "text/html",
- attributes: [
- { type: "label", name: "shareAlias", value: "feature-highlights", isInheritable: false, position: 10 }
- ],
- format: "html",
- dataFileName: "Feature Highlights.html",
- attachments: [],
- children: []
- }
- ]
+ it("derives docUrl from the share alias chain, and only when a base URL is given", () => {
+ const page: NoteMeta = {
+ isClone: false, noteId: "highlights", title: "Feature Highlights", type: "text", mime: "text/html",
+ attributes: [{ type: "label", name: "shareAlias", value: "feature-highlights", isInheritable: false, position: 10 }],
+ format: "markdown", dataFileName: "Feature Highlights.md", children: []
};
+ const rootAlias: NoteMeta["attributes"] = [
+ { type: "label", name: "shareAlias", value: "user-guide", isInheritable: false, position: 10 }
+ ];
- const metaFile = { formatVersion: 2, appVersion: "0.103.0", files: [meta] };
- const items = parseNoteMetaFile(metaFile, serverTextNoteHandler, "https://docs.triliumnotes.org");
+ const { meta: withBase } = buildHelpMeta(metaFileOf([page], rootAlias), BASE_URL);
+ expect(labelOf(withBase[0], "docUrl")).toBe("https://docs.triliumnotes.org/user-guide/feature-highlights");
- const child = items[0];
- const docUrl = child?.attributes?.find((a) => a.name === "docUrl");
- expect(docUrl?.value).toBe("https://docs.triliumnotes.org/user-guide/feature-highlights");
+ const { meta: withoutBase } = buildHelpMeta(metaFileOf([page], rootAlias));
+ expect(labelOf(withoutBase[0], "docUrl")).toBeUndefined();
});
- it("omits docUrl when no baseUrl is provided", () => {
- const meta: NoteMeta = {
- isClone: false,
- noteId: "rootNote123",
- notePath: [ "rootNote123" ],
- title: "User Guide",
- notePosition: 1,
- prefix: null,
- isExpanded: false,
- type: "text",
- mime: "text/html",
- attributes: [
- { type: "label", name: "shareAlias", value: "user-guide", isInheritable: false, position: 10 }
- ],
- format: "html",
- dataFileName: "User Guide.html",
- dirFileName: "User Guide",
- attachments: [],
- children: [
- {
- isClone: false,
- noteId: "childNote456",
- notePath: [ "rootNote123", "childNote456" ],
- title: "Feature Highlights",
- notePosition: 10,
- prefix: null,
- isExpanded: false,
- type: "text",
- mime: "text/html",
- attributes: [
- { type: "label", name: "shareAlias", value: "feature-highlights", isInheritable: false, position: 10 }
- ],
- format: "html",
- dataFileName: "Feature Highlights.html",
- attachments: [],
- children: []
- }
- ]
+ it("keeps web views pointing at the online docs and gives them no source", () => {
+ const embedded: NoteMeta = {
+ isClone: false, noteId: "embedded", title: "Embedded", type: "webView", mime: "",
+ attributes: [{ type: "label", name: "webViewSrc", value: "/user-guide/embedded", isInheritable: false, position: 10 }],
+ format: "markdown", dataFileName: "Embedded.md", children: []
};
- const metaFile = { formatVersion: 2, appVersion: "0.103.0", files: [meta] };
- const items = parseNoteMetaFile(metaFile, serverTextNoteHandler);
+ const { meta: items, sources } = buildHelpMeta(metaFileOf([embedded]), BASE_URL);
- const child = items[0];
- const docUrl = child?.attributes?.find((a) => a.name === "docUrl");
- expect(docUrl).toBeUndefined();
+ expect(items[0]?.type).toBe("webView");
+ expect(sources._help_embedded?.source).toBeUndefined();
+ // Root-relative sources are stored that way in the notes; the docs origin is applied here.
+ expect(labelOf(items[0], "webViewSrc")).toBe("https://docs.triliumnotes.org/user-guide/embedded");
});
- it("hides note that is hidden from share tree", () => {
- const meta: NoteMeta = {
- isClone: false,
- noteId: "yoAe4jV2yzbd",
- notePath: [ "OkOZllzB3fqN", "yoAe4jV2yzbd" ],
- title: "Features",
- notePosition: 40,
- prefix: null,
- isExpanded: false,
- type: "text",
- mime: "text/html",
- attributes: [
- { type: "label", name: "shareHiddenFromTree", value: "", isInheritable: false, position: 10 }
- ],
- format: "html",
- attachments: [],
- dirFileName: "Features",
- children: []
+ it("keeps the mime of code notes so their content is not treated as markdown", () => {
+ const script: NoteMeta = {
+ isClone: false, noteId: "script", title: "Example", type: "code", mime: "application/javascript;env=backend",
+ attributes: [], format: "markdown", dataFileName: "Example.js", children: []
};
- const metaFile = { formatVersion: 2, appVersion: "0.103.0", files: [meta] };
- const items = parseNoteMetaFile(metaFile, serverTextNoteHandler);
- expect(items).toHaveLength(0);
- });
-});
+ const { meta: items, sources } = buildHelpMeta(metaFileOf([script]));
-describe("Help meta generation (standalone)", () => {
- it("converts text notes with URL to webView", () => {
- const child: NoteMeta = {
- isClone: false,
- noteId: "childNote456",
- notePath: [ "rootNote123", "childNote456" ],
- title: "Feature Highlights",
- notePosition: 10,
- prefix: null,
- isExpanded: false,
- type: "text",
- mime: "text/html",
- attributes: [
- { type: "label", name: "shareAlias", value: "feature-highlights", isInheritable: false, position: 10 }
- ],
- format: "html",
- dataFileName: "Feature Highlights.html",
- attachments: [],
- children: []
- };
- const root: NoteMeta = {
- isClone: false, noteId: "root", notePath: ["root"], title: "Root",
- notePosition: 1, prefix: null, isExpanded: false, type: "text",
- mime: "text/html", attributes: [
- { type: "label", name: "shareAlias", value: "root", isInheritable: false, position: 10 }
- ], format: "html", attachments: [],
- dirFileName: "Root", children: [child]
- };
-
- const metaFile = { formatVersion: 2, appVersion: "0.103.0", files: [root] };
- const items = parseNoteMetaFile(metaFile, standaloneTextNoteHandler, "https://docs.triliumnotes.org");
-
- expect(items).toHaveLength(1);
- expect(items[0].type).toBe("webView");
- expect(items[0].enforceAttributes).toBe(true);
- expect(items[0].attributes).toContainEqual({
- type: "label", name: "webViewSrc", value: "https://docs.triliumnotes.org/root/feature-highlights"
- });
- expect(items[0].attributes?.find(a => a.name === "docName")).toBeUndefined();
+ expect(items[0]?.type).toBe("code");
+ expect(items[0]?.mime).toBe("application/javascript;env=backend");
+ expect(sources._help_script?.source).toBe("User Guide/Example.js");
});
- it("excludes text notes without URL", () => {
- const child: NoteMeta = {
- isClone: false,
- noteId: "childNote456",
- notePath: [ "rootNote123", "childNote456" ],
- title: "Feature Highlights",
- notePosition: 10,
- prefix: null,
- isExpanded: false,
- type: "text",
- mime: "text/html",
- attributes: [],
- format: "html",
- dataFileName: "Feature Highlights.html",
- attachments: [],
- children: []
- };
- const root: NoteMeta = {
- isClone: false, noteId: "root", notePath: ["root"], title: "Root",
- notePosition: 1, prefix: null, isExpanded: false, type: "text",
- mime: "text/html", attributes: [], format: "html", attachments: [],
- dirFileName: "Root", children: [child]
+ it("hides notes that are hidden from the share tree", () => {
+ const hidden: NoteMeta = {
+ isClone: false, noteId: "hidden", title: "Features", type: "text", mime: "text/html",
+ attributes: [{ type: "label", name: "shareHiddenFromTree", value: "", isInheritable: false, position: 10 }],
+ format: "markdown", dirFileName: "Features", children: []
};
- const metaFile = { formatVersion: 2, appVersion: "0.103.0", files: [root] };
- const items = parseNoteMetaFile(metaFile, standaloneTextNoteHandler);
- expect(items).toHaveLength(0);
+ expect(buildHelpMeta(metaFileOf([hidden])).meta).toHaveLength(0);
});
- it("preserves folder notes", () => {
- const child: NoteMeta = {
- isClone: false,
- noteId: "folderNote",
- notePath: [ "root", "folderNote" ],
- title: "Section",
- notePosition: 1,
- prefix: null,
- isExpanded: false,
- type: "text",
- mime: "text/html",
- attributes: [],
- format: "html",
- attachments: [],
- dirFileName: "Section",
- children: []
- };
- const root: NoteMeta = {
- isClone: false, noteId: "root", notePath: ["root"], title: "Root",
- notePosition: 1, prefix: null, isExpanded: false, type: "text",
- mime: "text/html", attributes: [], format: "html", attachments: [],
- dirFileName: "Root", children: [child]
- };
-
- const metaFile = { formatVersion: 2, appVersion: "0.103.0", files: [root] };
- const items = parseNoteMetaFile(metaFile, standaloneTextNoteHandler);
-
- expect(items).toHaveLength(1);
- expect(items[0].type).toBe("book");
+ it("returns nothing when the export has no files", () => {
+ expect(buildHelpMeta({ formatVersion: 2, appVersion: "0.103.0", files: undefined as never }))
+ .toEqual({ meta: [], sources: {} });
});
});
@@ -319,7 +160,40 @@ describe("stripAppVersion", () => {
expect("appVersion" in stripped).toBe(false);
expect(stripped).toStrictEqual({ formatVersion: 2, files: meta.files });
- // The input is left alone: the minified branch of the export reads the same object.
+ // The input is left alone: the help tree is derived from the same object afterwards.
expect(meta.appVersion).toBe("0.105.0");
});
});
+
+describe("serializeHelpMeta", () => {
+ it("writes each note on a line of its own and parses back to the same tree", () => {
+ const tree: HelpMetaItem[] = [
+ {
+ id: "_help_a",
+ title: "Folder",
+ type: "book",
+ attributes: [ { type: "label", name: "iconClass", value: "bx" } ],
+ children: [
+ { id: "_help_b", title: "Page", type: "text" },
+ { id: "_help_c", title: "Script", type: "code", mime: "text/x", children: [] }
+ ]
+ },
+ { id: "_help_d", title: "Web view", type: "webView" }
+ ];
+
+ const json = serializeHelpMeta(tree);
+
+ expect(JSON.parse(json)).toStrictEqual(tree);
+ expect(json.split("\n")).toStrictEqual([
+ "[",
+ ` {"id":"_help_a","title":"Folder","type":"book",` +
+ `"attributes":[{"type":"label","name":"iconClass","value":"bx"}],"children":[`,
+ ` {"id":"_help_b","title":"Page","type":"text"},`,
+ ` {"id":"_help_c","title":"Script","type":"code","mime":"text/x","children":[]}`,
+ " ]},",
+ ` {"id":"_help_d","title":"Web view","type":"webView"}`,
+ "]"
+ ]);
+ expect(serializeHelpMeta([])).toBe("[]");
+ });
+});
diff --git a/apps/edit-docs/src/help_meta_generator.ts b/apps/edit-docs/src/help_meta_generator.ts
index de89a594a9..dad9eb7915 100644
--- a/apps/edit-docs/src/help_meta_generator.ts
+++ b/apps/edit-docs/src/help_meta_generator.ts
@@ -1,62 +1,67 @@
-import type { HiddenSubtreeItem } from "@triliumnext/commons";
+import type { HelpMetaItem, HiddenSubtreeAttribute } from "@triliumnext/commons";
import type { NoteMeta, NoteMetaFile } from "@triliumnext/core";
-import path from "path";
/**
- * Callback that defines how a text note is represented in the help meta.
- * @param item the HiddenSubtreeItem being built (mutate in place)
- * @param docPath the documentation path (e.g. "User Guide/Quick Start")
- * @param currentUrl the online URL for this note (if available)
- * @returns true to include the item, false to exclude it
+ * Builds the in-app help tree from the User Guide's markdown export meta.
+ *
+ * The tree describes the `_help` subtree the application injects into becca; the files backing it
+ * come back beside it rather than within it, since which markdown produced a page is of no use to
+ * anything past the build. Rendering that markdown into the page content the app displays is the
+ * build's job too, not this module's — here we only resolve structure, identity and the labels
+ * the notes carry.
+ *
+ * @param noteMetaFile the `!!!meta.json` written next to the markdown export.
+ * @param baseUrl root of the online documentation, used to resolve the canonical page URLs
+ * (`docUrl`) and to absolutise root-relative web view sources.
*/
-type TextNoteHandler = (item: HiddenSubtreeItem, docPath: string, currentUrl: string | undefined) => boolean;
-
-/**
- * Server handler: text notes become `doc` type with `docName` and optional `docUrl` attributes.
- */
-export const serverTextNoteHandler: TextNoteHandler = (item, docPath, currentUrl) => {
- item.attributes?.push({ type: "label", name: "docName", value: docPath });
- if (currentUrl) {
- item.attributes?.push({ type: "label", name: "docUrl", value: currentUrl });
- }
- return true;
-};
-
-/**
- * Standalone handler: text notes become `webView` type pointing to the online docs.
- * Excludes notes without an online URL.
- */
-export const standaloneTextNoteHandler: TextNoteHandler = (item, _docPath, currentUrl) => {
- if (!currentUrl) {
- return false;
- }
- item.type = "webView";
- item.enforceAttributes = true;
- item.attributes?.push({ type: "label", name: "webViewSrc", value: currentUrl });
- return true;
-};
-
-/**
- * Parses a NoteMetaFile into HiddenSubtreeItem[] using the given text note handler.
- */
-export function parseNoteMetaFile(noteMetaFile: NoteMetaFile, handleTextNote: TextNoteHandler, baseUrl?: string): HiddenSubtreeItem[] {
+export function buildHelpMeta(noteMetaFile: NoteMetaFile, baseUrl?: string): HelpMetaResult {
if (!noteMetaFile.files) {
console.warn("No meta files found to parse.");
- return [];
+ return { meta: [], sources: {} };
}
const metaRoot = noteMetaFile.files[0];
- const docNameRoot = "/" + (metaRoot.dirFileName ?? "");
- // A note cloned into several help locations appears once per location, but the runtime
- // hidden-subtree check enforces a single set of attributes per noteId. The per-occurrence
- // `iconClass`/`docName` would therefore conflict and flip-flop on every check. Index the
- // primary (non-clone) occurrence's values up front so every clone can reuse them.
+ // A note cloned into several help locations appears once per location, but only one of the
+ // occurrences is the real thing: the others carry no attributes and a ".clone" data file.
+ // Index the primary occurrence's values up front so every clone can reuse them.
const canonicalByNoteId = new Map<string, CanonicalOccurrence>();
- indexPrimaryOccurrences(metaRoot, docNameRoot, canonicalByNoteId);
+ indexPrimaryOccurrences(metaRoot, "", canonicalByNoteId);
+
+ // Sources are relative to the export directory, which is the root note's own directory, so
+ // the walk starts empty and picks up that directory on its first step down. The documentation
+ // root doubles as the parent URL every page's share alias is appended to.
+ const sources: HelpSources = {};
+ const parsedMetaRoot = parseNoteMeta(metaRoot, "", canonicalByNoteId, sources, baseUrl, baseUrl);
+ return { meta: parsedMetaRoot?.children ?? [], sources };
+}
+
+/** The help tree, and the export files each of its notes was built from. */
+export interface HelpMetaResult {
+ meta: HelpMetaItem[];
+ sources: HelpSources;
+}
- const parsedMetaRoot = parseNoteMeta(metaRoot, handleTextNote, docNameRoot, canonicalByNoteId, baseUrl);
- return parsedMetaRoot?.children ?? [];
+/**
+ * Where each note's content came from, by note ID. Only the build has any use for it: the bundler
+ * reads the pages through it and resolves the links between them, and then it is thrown away
+ * rather than shipped.
+ */
+export type HelpSources = Record<string, HelpPageSource>;
+
+export interface HelpPageSource {
+ /**
+ * Content file, relative to the markdown export root (e.g. `User Guide/Note Types/Text.md`).
+ * Absent for folders and web views, which have no file of their own. Clones point at the
+ * primary occurrence's file rather than their own `.clone` copy.
+ */
+ source?: string;
+ /**
+ * Directory this note's children live in, relative to the markdown export root. Set for every
+ * note that has one, and the only way to address a folder note: it has no file of its own, so
+ * pages link to it by its directory.
+ */
+ dir?: string;
}
/**
@@ -70,99 +75,143 @@ export function stripAppVersion(meta: NoteMetaFile): Omit<NoteMetaFile, "appVers
return rest;
}
-interface CanonicalOccurrence {
- iconClass: string;
- docPath?: string;
-}
+/**
+ * Serializes the help tree with one note per line, its children indented below it, so a docs
+ * change shows up in a diff as the notes it touched.
+ */
+export function serializeHelpMeta(items: HelpMetaItem[], depth = 0): string {
+ if (!items.length) {
+ return "[]";
+ }
-function parseNoteMeta(noteMeta: NoteMeta, handleTextNote: TextNoteHandler, docNameRoot: string, canonicalByNoteId: Map<string, CanonicalOccurrence>, parentUrl?: string): HiddenSubtreeItem | null {
- const item: HiddenSubtreeItem = {
- id: `_help_${noteMeta.noteId}`,
- title: noteMeta.title ?? "",
- type: "doc",
- attributes: []
- };
+ const indent = " ".repeat(depth + 1);
+ const lines: string[] = [];
+ for (const item of items) {
+ const { children, ...fields } = item;
+ if (!children?.length) {
+ lines.push(indent + JSON.stringify(item));
+ continue;
+ }
- // Handle folder notes
- if (!noteMeta.dataFileName) {
- item.type = "book";
+ const ownFields = JSON.stringify(fields).slice(0, -1);
+ lines.push(`${indent}${ownFields},"children":${serializeHelpMeta(children, depth + 1)}}`);
}
- // Build the URL for this note
+ return `[\n${lines.join(",\n")}\n${" ".repeat(depth)}]`;
+}
+
+interface CanonicalOccurrence {
+ iconClass: string;
+ source?: string;
+}
+
+function parseNoteMeta(
+ noteMeta: NoteMeta,
+ sourceRoot: string,
+ canonicalByNoteId: Map<string, CanonicalOccurrence>,
+ sources: HelpSources,
+ baseUrl?: string,
+ parentUrl?: string
+): HelpMetaItem | null {
+ const attributes: HiddenSubtreeAttribute[] = [];
+
+ // Build the online URL for this note; only notes with a share alias of their own are
+ // published, the rest just pass their parent's URL down to their children.
const shareAlias = noteMeta.attributes?.find((a) => a.type === "label" && a.name === "shareAlias")?.value;
const currentUrl = parentUrl && shareAlias ? `${parentUrl}/${shareAlias}` : parentUrl;
- const noteUrl = shareAlias ? currentUrl : undefined;
- // Handle attributes
for (const attribute of noteMeta.attributes ?? []) {
+ if (attribute.name === "shareHiddenFromTree") {
+ return null;
+ }
+
if (attribute.name === "webViewSrc") {
- item.attributes?.push({
+ attributes.push({
type: "label",
- name: attribute.name,
- value: attribute.value
+ name: "webViewSrc",
+ // Web views pointing inside the documentation are stored root-relative.
+ value: absolutiseUrl(attribute.value, baseUrl)
});
}
+ }
- if (attribute.name === "shareHiddenFromTree") {
- return null;
- }
+ if (shareAlias && currentUrl) {
+ attributes.push({ type: "label", name: "docUrl", value: currentUrl });
}
- // Clones share the underlying note, so resolve their per-occurrence icon/docName to the
- // primary occurrence's values; otherwise the two occurrences would enforce conflicting ones.
+ // Clones share the underlying note, so resolve their icon and content file to the primary
+ // occurrence's; otherwise the two occurrences would describe the same note differently.
const canonical = noteMeta.isClone ? canonicalByNoteId.get(noteMeta.noteId ?? "") : undefined;
- const iconClass = canonical?.iconClass ?? computeIconClass(noteMeta);
+ attributes.push({
+ type: "label",
+ name: "iconClass",
+ value: canonical?.iconClass ?? computeIconClass(noteMeta)
+ });
- // Handle text notes
- if (noteMeta.type === "text" && noteMeta.dataFileName) {
- const docPath = canonical?.docPath ?? computeDocPath(docNameRoot, noteMeta.dataFileName);
- if (!handleTextNote(item, docPath, noteUrl)) {
- return null;
- }
+ const item: HelpMetaItem = {
+ id: `_help_${noteMeta.noteId}`,
+ title: noteMeta.title ?? "",
+ type: resolveType(noteMeta),
+ attributes
+ };
+
+ if (item.type === "code") {
+ item.mime = noteMeta.mime;
}
- // Handle web views
- if (noteMeta.type === "webView") {
- item.type = "webView";
- item.enforceAttributes = true;
+ const source = item.type === "text" || item.type === "code"
+ ? canonical?.source ?? computeSource(sourceRoot, noteMeta.dataFileName)
+ : undefined;
+ const dir = noteMeta.dirFileName ? computeSource(sourceRoot, noteMeta.dirFileName) : undefined;
+
+ if (source || dir) {
+ sources[item.id] = { source, dir };
}
- // Handle children
if (noteMeta.children) {
- const children: HiddenSubtreeItem[] = [];
+ const childSourceRoot = noteMeta.dirFileName ? `${sourceRoot}/${noteMeta.dirFileName}` : sourceRoot;
+ const children: HelpMetaItem[] = [];
+
for (const childMeta of noteMeta.children) {
- const newDocNameRoot = noteMeta.dirFileName ? `${docNameRoot}/${noteMeta.dirFileName}` : docNameRoot;
- const child = parseNoteMeta(childMeta, handleTextNote, newDocNameRoot, canonicalByNoteId, currentUrl);
+ const child = parseNoteMeta(childMeta, childSourceRoot, canonicalByNoteId, sources, baseUrl, currentUrl);
if (child) {
children.push(child);
}
}
+
item.children = children;
}
- // Handle note icon
- item.attributes?.push({
- name: "iconClass",
- value: iconClass,
- type: "label"
- });
-
return item;
}
-/** Records the `iconClass`/`docName` of every primary (non-clone) occurrence so clones can reuse them. */
-function indexPrimaryOccurrences(noteMeta: NoteMeta, docNameRoot: string, out: Map<string, CanonicalOccurrence>): void {
+/**
+ * A note with no data file of its own is a pure folder. Web views render a remote page, so their
+ * data file (if any) is irrelevant. Everything else carries content built from its source file.
+ */
+function resolveType(noteMeta: NoteMeta): HelpMetaItem["type"] {
+ if (noteMeta.type === "webView") {
+ return "webView";
+ }
+ if (!noteMeta.dataFileName) {
+ return "book";
+ }
+ return noteMeta.type === "code" ? "code" : "text";
+}
+
+/** Records the icon and content file of every primary (non-clone) occurrence, for its clones. */
+function indexPrimaryOccurrences(noteMeta: NoteMeta, sourceRoot: string, out: Map<string, CanonicalOccurrence>): void {
if (!noteMeta.isClone && noteMeta.noteId) {
out.set(noteMeta.noteId, {
iconClass: computeIconClass(noteMeta),
- docPath: noteMeta.type === "text" && noteMeta.dataFileName ? computeDocPath(docNameRoot, noteMeta.dataFileName) : undefined
+ source: computeSource(sourceRoot, noteMeta.dataFileName)
});
}
if (noteMeta.children) {
- const childDocNameRoot = noteMeta.dirFileName ? `${docNameRoot}/${noteMeta.dirFileName}` : docNameRoot;
+ const childSourceRoot = noteMeta.dirFileName ? `${sourceRoot}/${noteMeta.dirFileName}` : sourceRoot;
for (const childMeta of noteMeta.children) {
- indexPrimaryOccurrences(childMeta, childDocNameRoot, out);
+ indexPrimaryOccurrences(childMeta, childSourceRoot, out);
}
}
}
@@ -176,6 +225,18 @@ function computeIconClass(noteMeta: NoteMeta): string {
return noteMeta.dataFileName ? "bx bx-file" : "bx bx-folder";
}
-function computeDocPath(docNameRoot: string, dataFileName: string): string {
- return `${docNameRoot}/${path.basename(dataFileName, ".html")}`.substring(1);
+function computeSource(sourceRoot: string, dataFileName?: string): string | undefined {
+ if (!dataFileName) {
+ return undefined;
+ }
+ // The walk seeds the root as an empty string, so every path picked up along the way carries a
+ // leading separator that has to come back off.
+ return `${sourceRoot}/${dataFileName}`.substring(1);
+}
+
+function absolutiseUrl(url: string | undefined, baseUrl?: string): string | undefined {
+ if (url?.startsWith("/") && baseUrl) {
+ return `${baseUrl}${url}`;
+ }
+ return url;
}
diff --git a/apps/edit-docs/src/help_sources.spec.ts b/apps/edit-docs/src/help_sources.spec.ts
new file mode 100644
index 0000000000..be33989fb9
--- /dev/null
+++ b/apps/edit-docs/src/help_sources.spec.ts
@@ -0,0 +1,115 @@
+import { readdirSync, readFileSync } from "fs";
+import path from "path";
+import { describe, expect, it } from "vitest";
+
+import { buildHelpMeta, type HelpSources } from "./help_meta_generator.js";
+
+/**
+ * The in-app help checked against the markdown it is built from.
+ *
+ * The tree that ships carries no trace of which file produced each page — that mapping is a build
+ * concern and stays here — so these run the generator over the committed export instead, which
+ * also means they check the export as it is now rather than the artifact as it was last written.
+ */
+
+const DOCS_ROOT = path.join(__dirname, "..", "..", "..", "docs", "User Guide");
+
+describe("in-app help sources", () => {
+ const { sources } = buildHelpMeta(JSON.parse(readFileSync(path.join(DOCS_ROOT, "!!!meta.json"), "utf-8")));
+ const pages = sourcePaths(sources);
+
+ // A walk that reached nothing would pass every check below on emptiness alone.
+ it("finds the guide", () => {
+ expect(pages.length).toBeGreaterThan(100);
+ });
+
+ // The server filesystem is case-sensitive. A page whose title casing was changed on a
+ // case-insensitive OS (Windows/macOS) can be committed with a stale-cased filename that git's
+ // core.ignorecase hides, so the export points at one casing while the file on disk has
+ // another → the page ships empty.
+ it("names a file that exists, with the casing it is stored under", () => {
+ const problems = pages.filter((source) => !existsWithExactCase(DOCS_ROOT, source));
+
+ if (problems.length) {
+ expect.fail(
+ `The following help sources do not resolve to an on-disk file with exact casing ` +
+ `(the export and the committed filename disagree — likely a case-only rename dropped ` +
+ `by git core.ignorecase):\n` +
+ problems.map((p) => ` - ${p}`).join("\n")
+ );
+ }
+ });
+
+ // Help pages link to each other by relative markdown path. If the target is not part of the
+ // in-app help (e.g. a link into the Technical Guide subtree, which lives in docs/ but is not
+ // shipped), the link dead-ends once the pages are rendered. `#root/…` hrefs are intentional
+ // runtime deep-links to real system notes and are deliberately not validated here.
+ it("links only to pages that ship with it", () => {
+ const shipped = new Set(pages.map(normalizeSourcePath));
+ const broken: string[] = [];
+
+ for (const source of pages) {
+ const markdown = readFileSync(path.join(DOCS_ROOT, source), "utf-8");
+ for (const match of markdown.matchAll(/<a\b[^>]*class="reference-link"[^>]*href="([^"]+)"[^>]*>(.*?)<\/a>/gs)) {
+ const href = decodeURIComponent(match[1].split(/[#?]/)[0]);
+ if (href.startsWith("#root/")) {
+ continue;
+ }
+
+ const target = normalizeSourcePath(path.posix.join(path.posix.dirname(toPosix(source)), href));
+
+ // Markdown targets must be pages of the guide; anything else (an attachment such as
+ // a .dat or .js file, or a folder) only has to exist on disk.
+ const resolves = href.endsWith(".md")
+ ? shipped.has(target)
+ : existsWithExactCase(DOCS_ROOT, target) || existsWithExactCase(DOCS_ROOT, `${target}.md`);
+
+ if (!resolves) {
+ broken.push(`${source}: "${match[2].trim()}" -> ${href}`);
+ }
+ }
+ }
+
+ if (broken.length) {
+ expect.fail(
+ `The following in-app help links point to pages that are not part of the in-app help. ` +
+ `Either bring the target page into the help tree or remove/repoint the link:\n` +
+ broken.map((b) => ` - ${b}`).join("\n")
+ );
+ }
+ });
+});
+
+/** The content file of every page that has one; folders contribute only a directory. */
+function sourcePaths(sources: HelpSources): string[] {
+ return Object.values(sources)
+ .map(({ source }) => source)
+ .filter((source): source is string => !!source);
+}
+
+/**
+ * Resolves `relativePath` under `rootDir` one segment at a time via `readdirSync`, which reports the
+ * real on-disk names regardless of filesystem case sensitivity. `fs.existsSync` alone would wrongly
+ * pass a mis-cased path on case-insensitive dev machines, so this makes the check meaningful everywhere.
+ */
+function existsWithExactCase(rootDir: string, relativePath: string): boolean {
+ let current = rootDir;
+ for (const segment of relativePath.split("/")) {
+ let entries: string[];
+ try {
+ entries = readdirSync(current);
+ } catch {
+ return false;
+ }
+ if (!entries.includes(segment)) {
+ return false;
+ }
+ current = path.join(current, segment);
+ }
+ return true;
+}
+
+const toPosix = (filePath: string) => filePath.split(path.sep).join("/");
+
+/** Sources are compared as posix paths so link targets and meta entries line up on Windows too. */
+const normalizeSourcePath = (filePath: string) => path.posix.normalize(toPosix(filePath));
diff --git a/apps/edit-docs/src/sync-docs.ts b/apps/edit-docs/src/sync-docs.ts
index 6c9e89365e..5f27c53d53 100644
--- a/apps/edit-docs/src/sync-docs.ts
+++ b/apps/edit-docs/src/sync-docs.ts
@@ -1,8 +1,8 @@
/**
* Regenerates every export target in `edit-docs-config.yaml` from the Markdown trees, with no
* window: the same import and export that `edit-docs.ts` runs after an edit, so a page edited
- * by hand gets its normalized Markdown, the help HTML under `doc_notes` and the standalone
- * `help_meta.json` without opening Electron.
+ * by hand gets its normalized Markdown and the in-app help artifacts under `assets/help` without
+ * opening Electron.
*
* pnpm edit-docs:sync-docs [-- -c <config>]
*
diff --git a/apps/server/spec/in_app_help.spec.ts b/apps/server/spec/in_app_help.spec.ts
new file mode 100644
index 0000000000..c3d6f15cb9
--- /dev/null
+++ b/apps/server/spec/in_app_help.spec.ts
@@ -0,0 +1,143 @@
+import type { HelpMetaItem } from "@triliumnext/commons";
+import becca from "@triliumnext/core/src/becca/becca.js";
+import { load } from "@triliumnext/core/src/becca/becca_loader.js";
+import blobService from "@triliumnext/core/src/services/blob.js";
+import { getContext } from "@triliumnext/core/src/services/context.js";
+import { HELP_ASSET_TOKEN, initInAppHelp } from "@triliumnext/core/src/services/in_app_help.js";
+import { helpTools } from "@triliumnext/core/src/services/llm/tools/help_tools.js";
+import searchService from "@triliumnext/core/src/services/search/services/search.js";
+import { getVirtualNoteAssets } from "@triliumnext/core/src/services/virtual_notes.js";
+import fs from "fs";
+import path from "path";
+import { beforeAll, describe, expect, it } from "vitest";
+
+import NodejsInAppHelpProvider from "../src/in_app_help_provider.js";
+
+/**
+ * Exercises the in-app help against the artifacts that actually ship — the tree and content
+ * `edit-docs` writes into `src/assets/help`. The unit tests around the provider and the injection
+ * use stubs; this is the check that the real files still add up to a working help subtree.
+ */
+describe("in-app help (shipped artifacts)", () => {
+ const provider = new NodejsInAppHelpProvider();
+ const meta = provider.getHelpHiddenSubtreeData() as HelpMetaItem[];
+
+ beforeAll(() => {
+ initInAppHelp(provider);
+ getContext().init(() => load());
+ });
+
+ it("injects every page of the shipped tree under _help", () => {
+ expect(meta.length).toBeGreaterThan(0);
+
+ for (const item of flatten(meta)) {
+ const note = becca.getNote(item.id);
+ expect(note, `help note ${item.id} ("${item.title}") is missing from becca`).toBeTruthy();
+ expect(note?.isVirtual).toBe(true);
+ expect(note?.title).toBe(item.title);
+ }
+ });
+
+ it("serves the content of every page that ships one, through becca and the blob route", () => {
+ const pages = contentPages(meta);
+ expect(pages.length).toBeGreaterThan(0);
+
+ for (const page of pages) {
+ const content = String(becca.getNoteOrThrow(page.id).getContent());
+ expect(content, `help page ${page.id} ("${page.title}") has no content`).not.toBe("");
+
+ const pojo = blobService.getBlobPojo("notes", page.id);
+ expect(pojo.content).toBe(content);
+ expect(pojo.isStubbed).toBe(false);
+ }
+ });
+
+ it("points every image and attachment at a file the server serves", () => {
+ // `getHelpAssetDir` serves these out of the markdown export in a source checkout, and the
+ // build copies the same tree into the package.
+ const assetRoot = path.resolve(__dirname, "../../../docs/User Guide");
+ const missing: string[] = [];
+ let assetCount = 0;
+
+ for (const page of contentPages(meta)) {
+ const html = String(becca.getNoteOrThrow(page.id).getContent());
+ expect(html, `page ${page.id} still carries an unsubstituted asset placeholder`).not.toContain(HELP_ASSET_TOKEN);
+
+ for (const match of html.matchAll(/(?:src|href)="([^"]*\/help\/[^"]*)"/g)) {
+ assetCount++;
+ const relative = decodeURIComponent(match[1].split("/help/")[1]);
+ if (!fs.existsSync(path.join(assetRoot, relative))) {
+ missing.push(`${page.title} -> ${relative}`);
+ }
+ }
+ }
+
+ expect(assetCount).toBeGreaterThan(0);
+ expect(missing).toEqual([]);
+ });
+
+ it("can read every picture and file an export of the guide carries", async () => {
+ const unreadable: string[] = [];
+ let assetCount = 0;
+
+ for (const page of contentPages(meta)) {
+ for (const asset of getVirtualNoteAssets(page.id)) {
+ assetCount++;
+ if (await asset.getContent() === null) {
+ unreadable.push(`${page.id} -> ${asset.url}`);
+ }
+ }
+ }
+
+ expect(assetCount).toBeGreaterThan(0);
+ expect(unreadable).toEqual([]);
+ });
+
+ it("is searchable by its content, but only when the search asks for hidden notes", () => {
+ // A phrase from the body of a page, not from any title.
+ const query = "docker compose";
+
+ const scoped = searchService.searchNotes(query, { includeHiddenNotes: true });
+ expect(scoped.map((note) => note.noteId)).toContain("_help_rWX5eY045zbE");
+
+ // The guide lives under _hidden, so an ordinary search still does not surface it — the
+ // virtual pass makes the content matchable, not suddenly present in every result list.
+ const ordinary = searchService.searchNotes(query, {});
+ expect(ordinary.filter((note) => note.noteId.startsWith("_help"))).toEqual([]);
+ });
+
+ it("is searchable by the assistant, by body text and not only by title", () => {
+ const searchHelp = Object.fromEntries([ ...helpTools ]).search_help;
+ const result = searchHelp.execute({ query: "docker compose" }) as {
+ totalResults: number;
+ results: { noteId: string; contentPreview: string | null }[];
+ };
+
+ // The phrase is in the body of the Docker page and in no title, so a title-only index —
+ // which is what an unresolvable content source leaves behind — scores nothing.
+ expect(result.totalResults).toBeGreaterThan(0);
+ expect(result.results[0].noteId).toBe("_help_rWX5eY045zbE");
+ expect(result.results[0].contentPreview).toBeTruthy();
+ });
+
+ it("makes every page read-only", () => {
+ for (const item of flatten(meta)) {
+ expect(becca.getNoteOrThrow(item.id).isContentWritable()).toBe(false);
+ }
+ });
+});
+
+/** Text and code notes carry a page of their own; folders and web views do not. */
+function contentPages(items: HelpMetaItem[]) {
+ return flatten(items).filter((item) => item.type === "text" || item.type === "code");
+}
+
+function flatten(items: HelpMetaItem[], out: HelpMetaItem[] = []): HelpMetaItem[] {
+ for (const item of items) {
+ out.push(item);
+ if (item.children) {
+ flatten(item.children, out);
+ }
+ }
+ return out;
+}
diff --git a/apps/server/src/assets/doc_notes/cn/hidden.html b/apps/server/src/assets/doc_notes/cn/hidden.html
deleted file mode 100644
index f369e0f82b..0000000000
--- a/apps/server/src/assets/doc_notes/cn/hidden.html
+++ /dev/null
@@ -1,3 +0,0 @@
-<p>隐藏树用于记录各种应用层数据,这些数据大部分时间可能对用户不可见。</p>
-
-<p>确保你知道自己在做什么。对这个子树的错误更改可能会导致应用程序崩溃。</p>
diff --git a/apps/server/src/assets/doc_notes/cn/launchbar_command_launcher.html b/apps/server/src/assets/doc_notes/cn/launchbar_command_launcher.html
deleted file mode 100644
index 1171d699a3..0000000000
--- a/apps/server/src/assets/doc_notes/cn/launchbar_command_launcher.html
+++ /dev/null
@@ -1 +0,0 @@
-<p>此启动器操作的键盘快捷键可以在“选项”->“快捷键”中进行配置。</p>
diff --git a/apps/server/src/assets/doc_notes/cn/launchbar_history_navigation.html b/apps/server/src/assets/doc_notes/cn/launchbar_history_navigation.html
deleted file mode 100644
index e86b0af1a1..0000000000
--- a/apps/server/src/assets/doc_notes/cn/launchbar_history_navigation.html
+++ /dev/null
@@ -1,3 +0,0 @@
-<p>“后退”和“前进”按钮允许您在导航历史中移动。</p>
-
-<p>这些启动器仅在桌面版本中有效,在服务器版本中将被忽略,您可以使用浏览器的原生导航按钮代替。</p>
diff --git a/apps/server/src/assets/doc_notes/cn/launchbar_intro.html b/apps/server/src/assets/doc_notes/cn/launchbar_intro.html
deleted file mode 100644
index e7b32a3cd0..0000000000
--- a/apps/server/src/assets/doc_notes/cn/launchbar_intro.html
+++ /dev/null
@@ -1,11 +0,0 @@
-<p>欢迎来到启动栏配置界面。</p>
-
-<p>您可以在此处执行以下操作:</p>
-
-<ul>
- <li>通过拖动将可用的启动器移动到可见列表中(从而将它们放入启动栏)</li>
- <li>通过拖动将可见的启动器移动到可用列表中(从而将它们从启动栏中隐藏)</li>
- <li>您可以通过拖动重新排列列表中的项目</li>
- <li>通过右键点击“可见启动器”文件夹来创建新的启动器</li>
- <li>如果您想恢复默认设置,可以在右键菜单中找到“重置”选项。</li>
-</ul>
diff --git a/apps/server/src/assets/doc_notes/cn/launchbar_note_launcher.html b/apps/server/src/assets/doc_notes/cn/launchbar_note_launcher.html
deleted file mode 100644
index 1bede769ce..0000000000
--- a/apps/server/src/assets/doc_notes/cn/launchbar_note_launcher.html
+++ /dev/null
@@ -1,9 +0,0 @@
-<p>您可以定义以下属性:</p>
-
-<ol>
- <li><code>target</code> - 激活启动器时应打开的笔记</li>
- <li><code>hoistedNote</code> - 可选,在打开目标笔记之前将更改提升的笔记</li>
- <li><code>keyboardShortcut</code> - 可选,按下键盘快捷键将打开该笔记</li>
-</ol>
-
-<p>启动栏显示来自启动器的标题/图标,这不一定与目标笔记的标题/图标一致。</p>
diff --git a/apps/server/src/assets/doc_notes/cn/launchbar_script_launcher.html b/apps/server/src/assets/doc_notes/cn/launchbar_script_launcher.html
deleted file mode 100644
index 6f17afeddc..0000000000
--- a/apps/server/src/assets/doc_notes/cn/launchbar_script_launcher.html
+++ /dev/null
@@ -1,12 +0,0 @@
-<p>脚本启动器可以执行通过 <code>~script</code> 关系连接的脚本(代码笔记)。</p>
-
-<ol>
- <li><code>script</code> - 与应在启动器激活时执行的脚本笔记的关系</li>
- <li><code>keyboardShortcut</code> - 可选,按下键盘快捷键将激活启动器</li>
-</ol>
-
-<h4>示例脚本</h4>
-
-<pre>
-api.showMessage("当前笔记是 " + api.getActiveContextNote().title);
-</pre>
diff --git a/apps/server/src/assets/doc_notes/cn/launchbar_spacer.html b/apps/server/src/assets/doc_notes/cn/launchbar_spacer.html
deleted file mode 100644
index bcc0e3efe1..0000000000
--- a/apps/server/src/assets/doc_notes/cn/launchbar_spacer.html
+++ /dev/null
@@ -1,6 +0,0 @@
-<p>间隔器允许您在视觉上将启动器分组。您可以在提升的属性中进行配置:</p>
-
-<ul>
- <li><code>baseSize</code> - 定义以像素为单位的大小(如果有足够的空间)</li>
- <li><code>growthFactor</code> - 如果您希望间隔器保持恒定的 <code>baseSize</code>,则设置为 0;如果设置为正值,它将增长。</li>
-</ul>
diff --git a/apps/server/src/assets/doc_notes/cn/launchbar_widget_launcher.html b/apps/server/src/assets/doc_notes/cn/launchbar_widget_launcher.html
deleted file mode 100644
index 8ef57fa7c1..0000000000
--- a/apps/server/src/assets/doc_notes/cn/launchbar_widget_launcher.html
+++ /dev/null
@@ -1,34 +0,0 @@
-<p>请在提升的属性中定义目标小部件笔记。该小部件将用于渲染启动栏图标。</p>
-
-<h4>示例启动栏小部件</h4>
-
-<pre>
-const TPL = `&lt;div style="height: 53px; width: 53px;"&gt;&lt;/div&gt;`;
-
-class ExampleLaunchbarWidget extends api.NoteContextAwareWidget {
- doRender() {
- this.$widget = $(TPL);
- }
-
- async refreshWithNote(note) {
- this.$widget.css("background-color", this.stringToColor(note.title));
- }
-
- stringToColor(str) {
- let hash = 0;
- for (let i = 0; i < str.length; i++) {
- hash = str.charCodeAt(i) + ((hash << 5) - hash);
- }
-
- let color = '#';
- for (let i = 0; i < 3; i++) {
- const value = (hash >> (i * 8)) & 0xFF;
- color += ('00' + value.toString(16)).substr(-2);
- }
-
- return color;
- }
-}
-
-module.exports = new ExampleLaunchbarWidget();
-</pre>
diff --git a/apps/server/src/assets/doc_notes/cn/share.html b/apps/server/src/assets/doc_notes/cn/share.html
deleted file mode 100644
index 3eedb8c093..0000000000
--- a/apps/server/src/assets/doc_notes/cn/share.html
+++ /dev/null
@@ -1 +0,0 @@
-<p>在这里您可以找到所有分享的笔记。</p>
diff --git a/apps/server/src/assets/doc_notes/cn/user_hidden.html b/apps/server/src/assets/doc_notes/cn/user_hidden.html
deleted file mode 100644
index 715be770d4..0000000000
--- a/apps/server/src/assets/doc_notes/cn/user_hidden.html
+++ /dev/null
@@ -1 +0,0 @@
-<p>此笔记作为一个子树,用于存储由用户脚本生成的数据,这些数据本应避免在隐藏子树中随意创建。</p>
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/!!!meta.json b/apps/server/src/assets/doc_notes/en/User Guide/!!!meta.json
deleted file mode 100644
index e1fa67f957..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/!!!meta.json
+++ /dev/null
@@ -1 +0,0 @@
-[{"id":"_help_BOCnjTMBCoxW","title":"Feature Highlights","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Feature Highlights"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/feature-highlights"},{"name":"iconClass","value":"bx bx-star","type":"label"}]},{"id":"_help_Otzi9La2YAUX","title":"Installation & Setup","type":"book","attributes":[{"name":"iconClass","value":"bx bx-cog","type":"label"}],"children":[{"id":"_help_poXkQfguuA0U","title":"Desktop Installation","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Desktop Installation"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/desktop"},{"name":"iconClass","value":"bx bx-desktop","type":"label"}],"children":[{"id":"_help_nRqcgfTb97uV","title":"Using the desktop application as a server","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Desktop Installation/Using the desktop application as a server"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/desktop/desktop-as-server"},{"name":"iconClass","value":"bx bx-file","type":"label"}]},{"id":"_help_Rp0q8bSP6Ayl","title":"System Requirements","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Desktop Installation/System Requirements"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/desktop/system-requirements"},{"name":"iconClass","value":"bx bx-chip","type":"label"}]},{"id":"_help_Un4wj2Mak2Ky","title":"Nix flake","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Desktop Installation/Nix flake"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/desktop/nix-flake"},{"name":"iconClass","value":"bx bxl-tux","type":"label"}]},{"id":"_help_swSFivWk6KkA","title":"Network Access","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Desktop Installation/Network Access"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/desktop/network-access"},{"name":"iconClass","value":"bx bx-network-chart","type":"label"}]},{"id":"_help_7iwde4lsKc6O","title":"Tray icon & automatic startup","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Desktop Installation/Tray icon & automatic startup"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/desktop/tray-icon-and-startup"},{"name":"iconClass","value":"bx bx-file","type":"label"}]},{"id":"_help_hvRfsDr591WP","title":"Troubleshooting","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Desktop Installation/Troubleshooting"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/desktop/troubleshooting"},{"name":"iconClass","value":"bx bx-file","type":"label"}]}]},{"id":"_help_WOcw2SLH6tbX","title":"Server Installation","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Server Installation"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server"},{"name":"iconClass","value":"bx bx-server","type":"label"}],"children":[{"id":"_help_Dgg7bR3b6K9j","title":"1. Installing the server","type":"book","attributes":[{"name":"iconClass","value":"bx bx-folder","type":"label"}],"children":[{"id":"_help_3tW6mORuTHnB","title":"Packaged version for Linux","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Server Installation/1. Installing the server/Packaged version for Linux"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/installation/packaged-server"},{"name":"iconClass","value":"bx bxl-tux","type":"label"}],"children":[{"id":"_help_ZNAjFcxqHr9V","title":"Simple auto-update for server","type":"doc","attributes":[{"name":"iconClass","value":"bx bx-file","type":"label"}]}]},{"id":"_help_rWX5eY045zbE","title":"Using Docker","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Server Installation/1. Installing the server/Using Docker"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/installation/docker"},{"name":"iconClass","value":"bx bxl-docker","type":"label"}]},{"id":"_help_moVgBcoxE3EK","title":"On NixOS","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Server Installation/1. Installing the server/On NixOS"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/installation/nixos"},{"name":"iconClass","value":"bx bxl-tux","type":"label"}]},{"id":"_help_J1Bb6lVlwU5T","title":"Manually","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Server Installation/1. Installing the server/Manually"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/installation/manual"},{"name":"iconClass","value":"bx bx-code-alt","type":"label"}]},{"id":"_help_DCmT6e7clMoP","title":"Using Kubernetes","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Server Installation/1. Installing the server/Using Kubernetes"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/installation/kubernetes"},{"name":"iconClass","value":"bx bxl-kubernetes","type":"label"}]},{"id":"_help_klCWNks3ReaQ","title":"Multiple server instances","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Server Installation/1. Installing the server/Multiple server instances"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/installation/multiple-instances"},{"name":"iconClass","value":"bx bxs-user-account","type":"label"}]}]},{"id":"_help_vcjrb3VVYPZI","title":"2. Reverse proxy","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Server Installation/2. Reverse proxy"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/reverse-proxy"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"children":[{"id":"_help_ud6MShXL4WpO","title":"Nginx","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Server Installation/2. Reverse proxy/Nginx"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/reverse-proxy/nginx"},{"name":"iconClass","value":"bx bx-file","type":"label"}]},{"id":"_help_fDLvzOx29Pfg","title":"Apache using Docker","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Server Installation/2. Reverse proxy/Apache using Docker"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/reverse-proxy/apache"},{"name":"iconClass","value":"bx bx-file","type":"label"}]},{"id":"_help_LLzSMXACKhUs","title":"Trusted proxy","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Server Installation/2. Reverse proxy/Trusted proxy"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/reverse-proxy/trusted-proxy"},{"name":"iconClass","value":"bx bx-file","type":"label"}]},{"id":"_help_5ERVJb9s4FRD","title":"Traefik","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Server Installation/2. Reverse proxy/Traefik"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/reverse-proxy/traefik"},{"name":"iconClass","value":"bx bx-file","type":"label"}]}]},{"id":"_help_l2VkvOwUNfZj","title":"HTTPS (TLS)","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Server Installation/HTTPS (TLS)"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/https"},{"name":"iconClass","value":"bx bx-lock-alt","type":"label"}]},{"id":"_help_0hzsNCP31IAB","title":"Authentication","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Server Installation/Authentication"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/auth"},{"name":"iconClass","value":"bx bx-user","type":"label"}],"children":[{"id":"_help_lwAX5SvbrK2g","title":"Resetting your password","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Server Installation/Authentication/Resetting your password"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/auth/password-reset"},{"name":"iconClass","value":"bx bx-key","type":"label"}]}]},{"id":"_help_7DAiwaf8Z7Rz","title":"Multi-factor authentication with TOTP","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Server Installation/Multi-factor authentication with TOTP"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/mfa"},{"name":"iconClass","value":"bx bx-stopwatch","type":"label"}]},{"id":"_help_Un4wj2Mak2Ky","title":"Nix flake","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Desktop Installation/Nix flake"},{"name":"iconClass","value":"bx bxl-tux","type":"label"}]},{"id":"_help_x1lQNKQBqLcA","title":"Signing in with OpenID Connect","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Server Installation/Signing in with OpenID Connect"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/openid-connect"},{"name":"iconClass","value":"bx bxs-key","type":"label"}],"children":[{"id":"_help_IgkTHSaFfq6A","title":"Setting up with various providers","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Server Installation/Signing in with OpenID Connect/Setting up with various providers"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/openid-connect/setup"},{"name":"iconClass","value":"bx bx-file","type":"label"}]}]},{"id":"_help_yeEaYqosGLSh","title":"Third-party cloud hosting","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Server Installation/Third-party cloud hosting"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/cloud-hosting"},{"name":"iconClass","value":"bx bx-cloud","type":"label"}]},{"id":"_help_iGTnKjubbXkA","title":"System Requirements","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Server Installation/System Requirements"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/system-requirements"},{"name":"iconClass","value":"bx bx-chip","type":"label"}]}]},{"id":"_help_cbkrhQjrkKrh","title":"Synchronization","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Synchronization"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/synchronization"},{"name":"iconClass","value":"bx bx-sync","type":"label"}]},{"id":"_help_RDslemsQ6gCp","title":"Mobile Frontend","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Mobile Frontend"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/mobile-frontend"},{"name":"iconClass","value":"bx bx-mobile-alt","type":"label"}]},{"id":"_help_MtPxeAWVAzMg","title":"Web Clipper","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Web Clipper"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/web-clipper"},{"name":"iconClass","value":"bx bx-paperclip","type":"label"}]},{"id":"_help_n1lujUxCwipy","title":"Upgrading TriliumNext","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Upgrading TriliumNext"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/upgrading"},{"name":"iconClass","value":"bx bx-up-arrow-alt","type":"label"}]},{"id":"_help_ODY7qQn5m2FT","title":"Backup","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Backup"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/backup"},{"name":"iconClass","value":"bx bx-hdd","type":"label"}]},{"id":"_help_tAassRL4RSQL","title":"Data directory","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Data directory"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/data-directory"},{"name":"iconClass","value":"bx bx-folder-open","type":"label"}]},{"id":"_help_ebyr7ES2SwOW","title":"Downloaded resources","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Installation & Setup/Downloaded resources"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/downloaded-resources"},{"name":"iconClass","value":"bx bx-download","type":"label"}]}]},{"id":"_help_gh7bpGYxajRS","title":"Basic Concepts and Features","type":"book","attributes":[{"name":"iconClass","value":"bx bx-help-circle","type":"label"}],"children":[{"id":"_help_Vc8PjrjAGuOp","title":"UI Elements","type":"book","attributes":[{"name":"iconClass","value":"bx bx-window-alt","type":"label"}],"children":[{"id":"_help_x0JgW8UqGXvq","title":"Vertical and horizontal layout","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/UI Elements/Vertical and horizontal layout"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/layouts"},{"name":"iconClass","value":"bx bxs-layout","type":"label"}]},{"id":"_help_x3i7MxGccDuM","title":"Global menu","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/UI Elements/Global menu"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/global-menu"},{"name":"iconClass","value":"bx bx-menu","type":"label"}]},{"id":"_help_oPVyFC7WL2Lp","title":"Note Tree","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-tree"},{"name":"iconClass","value":"bx bxs-tree-alt","type":"label"}],"children":[{"id":"_help_YtSN43OrfzaA","title":"Note tree contextual menu","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Note tree contextual menu"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-tree/context-menu"},{"name":"iconClass","value":"bx bx-menu","type":"label"}]},{"id":"_help_yTjUdsOi4CIE","title":"Multiple selection","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Multiple selection"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-tree/multiple-selection"},{"name":"iconClass","value":"bx bx-list-plus","type":"label"}]},{"id":"_help_DvdZhoQZY9Yd","title":"Keyboard shortcuts","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Keyboard shortcuts"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-tree/keyboard-shortcuts"},{"name":"iconClass","value":"bx bxs-keyboard","type":"label"}]},{"id":"_help_wyaGBBQrl4i3","title":"Hiding the subtree","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Hiding the subtree"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-tree/hiding-subtree"},{"name":"iconClass","value":"bx bx-hide","type":"label"}]}]},{"id":"_help_3seOhtN8uLIY","title":"Tabs","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/UI Elements/Tabs"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/tabs"},{"name":"iconClass","value":"bx bx-dock-top","type":"label"}]},{"id":"_help_xYmIYSP6wE3F","title":"Launch Bar","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/UI Elements/Launch Bar"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/launch-bar"},{"name":"iconClass","value":"bx bx-sidebar","type":"label"}]},{"id":"_help_8YBEPzcpUgxw","title":"Note menu","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/UI Elements/Note menu"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-menu"},{"name":"iconClass","value":"bx bx-dots-horizontal-rounded","type":"label"}]},{"id":"_help_1P8QXI5edXNd","title":"Note buttons","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/UI Elements/Note buttons"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-buttons"},{"name":"iconClass","value":"bx bx-download","type":"label"}]},{"id":"_help_4TIF1oA4VQRO","title":"Options","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/UI Elements/Options"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/options"},{"name":"iconClass","value":"bx bx-cog","type":"label"}]},{"id":"_help_luNhaphA37EO","title":"Split View","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/UI Elements/Split View"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/split-view"},{"name":"iconClass","value":"bx bx-dock-right","type":"label"}]},{"id":"_help_RnaPdbciOfeq","title":"Right Sidebar","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/right-sidebar"},{"name":"iconClass","value":"bx bxs-dock-right","type":"label"}],"children":[{"id":"_help_2dcGDhp9WFKb","title":"Outline tab","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar/Outline tab"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/right-sidebar/outline"},{"name":"iconClass","value":"bx bx-list-ul","type":"label"}]},{"id":"_help_uNtgN0cUKEBc","title":"Attributes tab","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar/Attributes tab"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/right-sidebar/attributes"},{"name":"iconClass","value":"bx bx-hash","type":"label"}]},{"id":"_help_LrKznOtw9cQD","title":"AI chat tab","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar/AI chat tab"},{"name":"iconClass","value":"bx bx-bot","type":"label"}]},{"id":"_help_KRlZFoIH0j6p","title":"Connections tab","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar/Connections tab"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/right-sidebar/connections"},{"name":"iconClass","value":"bx bx-network-chart","type":"label"}]}]},{"id":"_help_r5JGHN99bVKn","title":"Recent Changes","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/UI Elements/Recent Changes"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/recent-changes"},{"name":"iconClass","value":"bx bx-history","type":"label"}]},{"id":"_help_ny318J39E5Z0","title":"Zoom","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/UI Elements/Zoom"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/zoom"},{"name":"iconClass","value":"bx bx-zoom-in","type":"label"}]},{"id":"_help_lgKX7r3aL30x","title":"Note Tooltip","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tooltip"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-tooltip"},{"name":"iconClass","value":"bx bx-message-detail","type":"label"}]},{"id":"_help_SL5f1Auq7sVN","title":"Note types with split view","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/UI Elements/Note types with split view"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-types-with-split-view"},{"name":"iconClass","value":"bx bx-card","type":"label"}]},{"id":"_help_t596jLvPrqkS","title":"Content width","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/UI Elements/Content width"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/content-width"},{"name":"iconClass","value":"bx bx-detail","type":"label"}]},{"id":"_help_jcQVxzYybYgz","title":"Note contextual menu","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/UI Elements/Note contextual menu"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-context-menu"},{"name":"iconClass","value":"bx bx-menu","type":"label"}]},{"id":"_help_AlJ73vBCjWDw","title":"Status bar","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/UI Elements/Status bar"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/status-bar"},{"name":"iconClass","value":"bx bx-dock-bottom","type":"label"}]},{"id":"_help_I6p2a06hdnL6","title":"Breadcrumb","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/UI Elements/Breadcrumb"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/breadcrumb"},{"name":"iconClass","value":"bx bx-chevron-right","type":"label"}]}]},{"id":"_help_BFs8mudNFgCS","title":"Notes","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Notes"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes"},{"name":"iconClass","value":"bx bx-notepad","type":"label"}],"children":[{"id":"_help_l7pigIGu01K2","title":"Title","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Notes/Title"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/title"},{"name":"iconClass","value":"bx bx-text","type":"label"}]},{"id":"_help_p9kXRFAkwN4o","title":"Note Icons & Colors","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Notes/Note Icons & Colors"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/note-icons"},{"name":"iconClass","value":"bx bxs-grid","type":"label"}]},{"id":"_help_0vhv7lsOLy82","title":"Attachments","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Notes/Attachments"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/attachments"},{"name":"iconClass","value":"bx bx-paperclip","type":"label"}]},{"id":"_help_IakOLONlIfGI","title":"Cloning Notes","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Notes/Cloning Notes"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/cloning"},{"name":"iconClass","value":"bx bx-duplicate","type":"label"}],"children":[{"id":"_help_TBwsyfadTA18","title":"Branch prefix","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Notes/Cloning Notes/Branch prefix"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/cloning/branch-prefix"},{"name":"iconClass","value":"bx bx-rename","type":"label"}]}]},{"id":"_help_bwg0e8ewQMak","title":"Protected Notes","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Notes/Protected Notes"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/protected-notes"},{"name":"iconClass","value":"bx bx-lock-alt","type":"label"}]},{"id":"_help_MKmLg5x6xkor","title":"Archived Notes","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Notes/Archived Notes"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/archived-notes"},{"name":"iconClass","value":"bx bx-box","type":"label"}]},{"id":"_help_vZWERwf8U3nx","title":"Note Revisions","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Notes/Note Revisions"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/note-revisions"},{"name":"iconClass","value":"bx bx-history","type":"label"}]},{"id":"_help_aGlEvb9hyDhS","title":"Sorting Notes","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Notes/Sorting Notes"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/sorting"},{"name":"iconClass","value":"bx bx-sort-up","type":"label"}]},{"id":"_help_NRnIZmSMc5sj","title":"Printing & Exporting as PDF","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Notes/Printing & Exporting as PDF"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/printing-and-pdf-export"},{"name":"iconClass","value":"bx bx-printer","type":"label"}]},{"id":"_help_CoFPLs3dRlXc","title":"Read-Only Notes","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Notes/Read-Only Notes"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/read-only-notes"},{"name":"iconClass","value":"bx bx-edit-alt","type":"label"}]},{"id":"_help_0ESUbbAxVnoK","title":"Note List","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Notes/Note List"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/note-list"},{"name":"iconClass","value":"bx bxs-grid","type":"label"}]},{"id":"_help_S0Fos78ZfcY7","title":"Note Inbox","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Notes/Note Inbox"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/note-inbox"},{"name":"iconClass","value":"bx bxs-inbox","type":"label"}]},{"id":"_help_5Ct4MAJTS4tQ","title":"Restoring Deleted Notes","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Notes/Restoring Deleted Notes"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/restoring-deleted-notes"},{"name":"iconClass","value":"bx bx-trash-alt","type":"label"}]},{"id":"_help_m3VlURMSeOrd","title":"New note type switcher","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Notes/New note type switcher"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/new-note-type-switcher"},{"name":"iconClass","value":"bx bxs-widget","type":"label"}]},{"id":"_help_B5dihXRDksTk","title":"Note badges","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Notes/Note badges"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/note-badges"},{"name":"iconClass","value":"bx bx-square-rounded","type":"label"}]},{"id":"_help_Bsm4fyzPJkSc","title":"Save status indicator","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Notes/Save status indicator"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/save-status-indicator"},{"name":"iconClass","value":"bx bx-save","type":"label"}]}]},{"id":"_help_wArbEsdSae6g","title":"Navigation","type":"book","attributes":[{"name":"iconClass","value":"bx bx-navigation","type":"label"}],"children":[{"id":"_help_kBrnXNG3Hplm","title":"Tree Concepts","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Navigation/Tree Concepts"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/tree-concepts"},{"name":"iconClass","value":"bx bx-pyramid","type":"label"}]},{"id":"_help_MMiBEQljMQh2","title":"Note Navigation","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Navigation/Note Navigation"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/note-navigation"},{"name":"iconClass","value":"bx bxs-navigation","type":"label"}]},{"id":"_help_Ms1nauBra7gq","title":"Quick search","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Navigation/Quick search"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/quick-search"},{"name":"iconClass","value":"bx bx-search-alt-2","type":"label"}]},{"id":"_help_F1r9QtzQLZqm","title":"Jump to & command palette","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Navigation/Jump to & command palette"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/jump-to"},{"name":"iconClass","value":"bx bx-send","type":"label"}]},{"id":"_help_eIg8jdvaoNNd","title":"Search","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Navigation/Search"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/search"},{"name":"iconClass","value":"bx bx-search-alt-2","type":"label"}],"children":[{"id":"_help_Oxyb6jOjjVNL","title":"Under the hood","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Navigation/Search/Under the hood"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/search/under-the-hood"},{"name":"iconClass","value":"bx bxs-cog","type":"label"}]},{"id":"_help_WbjlujkUhEb5","title":"How search matches your text","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Navigation/Search/How search matches your text"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/search/matching"},{"name":"iconClass","value":"bx bx-file-find","type":"label"}]}]},{"id":"_help_u3YFHC9tQlpm","title":"Bookmarks","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Navigation/Bookmarks"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/bookmarks"},{"name":"iconClass","value":"bx bx-bookmarks","type":"label"}]},{"id":"_help_OR8WJ7Iz9K4U","title":"Note Hoisting","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Navigation/Note Hoisting"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/note-hoisting"},{"name":"iconClass","value":"bx bxs-chevrons-up","type":"label"}]},{"id":"_help_ZjLYv08Rp3qC","title":"Quick edit","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Navigation/Quick edit"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/quick-edit"},{"name":"iconClass","value":"bx bx-edit","type":"label"}]},{"id":"_help_9sRHySam5fXb","title":"Workspaces","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Navigation/Workspaces"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/workspace"},{"name":"iconClass","value":"bx bx-door-open","type":"label"}]},{"id":"_help_xWtq5NUHOwql","title":"Similar Notes","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Navigation/Similar Notes"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/similar-notes"},{"name":"iconClass","value":"bx bx-bar-chart","type":"label"}]},{"id":"_help_McngOG2jbUWX","title":"Search in note","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Navigation/Search in note"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/search-in-note"},{"name":"iconClass","value":"bx bx-search-alt-2","type":"label"}]}]},{"id":"_help_A9Oc6YKKc65v","title":"Keyboard Shortcuts","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Keyboard Shortcuts"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/keyboard-shortcuts"},{"name":"iconClass","value":"bx bxs-keyboard","type":"label"}]},{"id":"_help_Wy267RK4M69c","title":"Themes","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Themes"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/themes"},{"name":"iconClass","value":"bx bx-palette","type":"label"}],"children":[{"id":"_help_VbjZvtUek0Ln","title":"Theme Gallery","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Themes/Theme Gallery"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/themes/theme-gallery"},{"name":"iconClass","value":"bx bx-book-reader","type":"label"}]},{"id":"_help_gOKqSJgXLcIj","title":"Icon Packs","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Themes/Icon Packs"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/themes/icon-packs"},{"name":"iconClass","value":"bx bx-package","type":"label"}]},{"id":"_help_w4rMEhJsALlA","title":"Personalizing the font","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Themes/Personalizing the font"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/themes/fonts"},{"name":"iconClass","value":"bx bx-font","type":"label"}]}]},{"id":"_help_mHbBMPDPkVV5","title":"Import & Export","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Import & Export"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export"},{"name":"iconClass","value":"bx bx-import","type":"label"}],"children":[{"id":"_help_Oau6X9rCuegd","title":"Markdown","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Import & Export/Markdown"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/markdown"},{"name":"iconClass","value":"bx bxl-markdown","type":"label"}],"children":[{"id":"_help_rJ9grSgoExl9","title":"Supported syntax","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Import & Export/Markdown/Supported syntax"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/markdown/supported-syntax"},{"name":"iconClass","value":"bx bx-code-alt","type":"label"}]}]},{"id":"_help_ckZ2uNWQmVeX","title":"Importing data from other applications","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/import-from-apps"},{"name":"iconClass","value":"bx bx-import","type":"label"}],"children":[{"id":"_help_GnhlmrATVqcH","title":"Microsoft OneNote","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Microsoft OneNote"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/import-from-apps/onenote"},{"name":"iconClass","value":"tn-brand tn-brand-onenote","type":"label"}],"children":[{"id":"_help_LpvyEIBIAAj7","title":"Tags","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Microsoft OneNote/Tags"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/import-from-apps/onenote/tags"},{"name":"iconClass","value":"bx bx-star","type":"label"}]}]},{"id":"_help_Y5mKeJ6dsCld","title":"Notion","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Notion"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/import-from-apps/notion"},{"name":"iconClass","value":"tn-brand tn-brand-notion","type":"label"}]},{"id":"_help_nhQVuO4zvIxi","title":"Google Keep","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Google Keep"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/import-from-apps/keep"},{"name":"iconClass","value":"tn-brand tn-brand-google-keep","type":"label"}]},{"id":"_help_syuSEKf2rUGr","title":"Evernote","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Evernote"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/import-from-apps/evernote"},{"name":"iconClass","value":"tn-brand tn-brand-evernote","type":"label"}],"children":[{"id":"_help_dj3j8dG4th4l","title":"Process internal links by title","type":"doc","attributes":[{"name":"iconClass","value":"bx bx-file","type":"label"}]}]},{"id":"_help_83zmPBJRgfnW","title":"Anytype","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Anytype"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/import-from-apps/anytype"},{"name":"iconClass","value":"tn-brand tn-brand-anytype","type":"label"}]},{"id":"_help_iWD7wiIuMtgV","title":"Obsidian","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Obsidian"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/import-from-apps/obsidian"},{"name":"iconClass","value":"tn-brand tn-brand-obsidian","type":"label"}]}]}]},{"id":"_help_rC3pL2aptaRE","title":"Zen mode","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Zen mode"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/zen-mode"},{"name":"iconClass","value":"bx bxs-yin-yang","type":"label"}]},{"id":"_help_YzMcWlCVeW09","title":"Active content","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Basic Concepts and Features/Active content"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/active-content"},{"name":"iconClass","value":"bx bxs-widget","type":"label"}]}]},{"id":"_help_s3YCWHBfmYuM","title":"Quick Start","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Quick Start"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/quick-start"},{"name":"iconClass","value":"bx bx-run","type":"label"}]},{"id":"_help_i6dbnitykE5D","title":"FAQ","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/FAQ"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/faq"},{"name":"iconClass","value":"bx bx-question-mark","type":"label"}]},{"id":"_help_KSZ04uQ2D1St","title":"Note Types","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types"},{"name":"iconClass","value":"bx bx-edit","type":"label"}],"children":[{"id":"_help_iPIMuisry3hd","title":"Text","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text"},{"name":"iconClass","value":"bx bx-note","type":"label"}],"children":[{"id":"_help_oSuaNgyyKnhu","title":"Anchors","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Anchors"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/bookmarks"},{"name":"iconClass","value":"bx bx-bookmark","type":"label"}]},{"id":"_help_oI7GoyilXXAr","title":"Automatic replacements","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Automatic replacements"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/automatic-replacements"},{"name":"iconClass","value":"bx bx-reply","type":"label"}]},{"id":"_help_NwBbFdNZ9h7O","title":"Block quotes & admonitions","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Block quotes & admonitions"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/blockquotes"},{"name":"iconClass","value":"bx bx-info-circle","type":"label"}]},{"id":"_help_klC3ilXa9kUE","title":"Block references","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Block references"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/block-references"},{"name":"iconClass","value":"bx bx-paragraph","type":"label"}]},{"id":"_help_4n4oQUVbnOxa","title":"Collapsible blocks","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Collapsible blocks"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/collapsible-blocks"},{"name":"iconClass","value":"bx bx-chevron-down-circle","type":"label"}]},{"id":"_help_veGu4faJErEM","title":"Content language & Right-to-left support","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Content language & Right-to-left support"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/content-language"},{"name":"iconClass","value":"bx bx-align-right","type":"label"}]},{"id":"_help_EK2ckIZ74tbT","title":"Content tabs","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Content tabs"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/content-tabs"},{"name":"iconClass","value":"cke cke-trilium-tabs","type":"label"}]},{"id":"_help_2x0ZAX9ePtzV","title":"Cut to subnote","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Cut to subnote"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/cut-to-subnote"},{"name":"iconClass","value":"bx bx-cut","type":"label"}]},{"id":"_help_UYuUB1ZekNQU","title":"Developer-specific formatting","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Developer-specific formatting"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/developer-formatting"},{"name":"iconClass","value":"bx bx-code-alt","type":"label"}],"children":[{"id":"_help_QxEyIjRBizuC","title":"Code blocks","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Developer-specific formatting/Code blocks"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/developer-formatting/code-blocks"},{"name":"iconClass","value":"bx bx-code","type":"label"}]}]},{"id":"_help_AgjCISero73a","title":"Footnotes","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Footnotes"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/footnotes"},{"name":"iconClass","value":"bx bx-bracket","type":"label"}]},{"id":"_help_5wZallV2Qo1t","title":"Format Painter","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Format Painter"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/format-painter"},{"name":"iconClass","value":"bx bxs-paint-roll","type":"label"}]},{"id":"_help_nRhnJkTT8cPs","title":"Formatting toolbar","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Formatting toolbar"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/formatting-toolbar"},{"name":"iconClass","value":"bx bx-text","type":"label"}]},{"id":"_help_Gr6xFaF6ioJ5","title":"General formatting","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/General formatting"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/general-formatting"},{"name":"iconClass","value":"bx bx-bold","type":"label"}]},{"id":"_help_AxshuNRegLAv","title":"Highlights list","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Highlights list"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/highlights-list"},{"name":"iconClass","value":"bx bx-highlight","type":"label"}]},{"id":"_help_mT0HEkOsz6i1","title":"Images","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Images"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/images"},{"name":"iconClass","value":"bx bx-image-alt","type":"label"}],"children":[{"id":"_help_0Ofbk1aSuVRu","title":"Image references","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Images/Image references"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/images/image-references"},{"name":"iconClass","value":"bx bxs-file-image","type":"label"}]}]},{"id":"_help_VRoP0g1uHHc2","title":"In-editor AI assistant","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/In-editor AI assistant"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/ai-assistant"},{"name":"iconClass","value":"bx bx-bot","type":"label"}],"children":[{"id":"_help_mVEYwt20exhO","title":"Custom AI quick actions","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/In-editor AI assistant/Custom AI quick actions"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/ai-assistant/custom-quick-actions"},{"name":"iconClass","value":"bx bx-file","type":"label"}]}]},{"id":"_help_nBAXQFj20hS1","title":"Include Note","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Include Note"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/include-note"},{"name":"iconClass","value":"bx bx-file","type":"label"}]},{"id":"_help_CohkqWQC1iBv","title":"Insert buttons","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Insert buttons"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/insert-buttons"},{"name":"iconClass","value":"bx bx-plus","type":"label"}],"children":[{"id":"_help_hD8GawVuazff","title":"Icons","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Insert buttons/Icons"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/insert-buttons/icons"},{"name":"iconClass","value":"bx bx-sticker","type":"label"}]}]},{"id":"_help_oiVPnW8QfnvS","title":"Keyboard shortcuts","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Keyboard shortcuts"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/keyboard-shortcuts"},{"name":"iconClass","value":"bx bxs-keyboard","type":"label"}]},{"id":"_help_UmgZAfcltxkS","title":"Link Previews","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Link Previews"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/link-previews"},{"name":"iconClass","value":"bx bx-link-external","type":"label"}]},{"id":"_help_QEAPj01N5f7w","title":"Links","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Links"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/links"},{"name":"iconClass","value":"bx bx-link-alt","type":"label"}],"children":[{"id":"_help_3IDVtesTQ8ds","title":"External links","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Links/External links"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/links/external-links"},{"name":"iconClass","value":"bx bx-link-external","type":"label"}]},{"id":"_help_hrZ1D00cLbal","title":"Internal (reference) links","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Links/Internal (reference) links"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/links/reference-links"},{"name":"iconClass","value":"bx bx-link","type":"label"}]},{"id":"_help_wfGXLmm7x27z","title":"Backlinks","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Links/Backlinks"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/links/backlinks"},{"name":"iconClass","value":"bx bx-link-alt","type":"label"}]}]},{"id":"_help_S6Xx8QIWTV66","title":"Lists","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Lists"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/lists"},{"name":"iconClass","value":"bx bx-list-ul","type":"label"}]},{"id":"_help_QrtTYPmdd1qq","title":"Markdown-like formatting","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Markdown-like formatting"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/markdown-formatting"},{"name":"iconClass","value":"bx bxl-markdown","type":"label"}]},{"id":"_help_YfYAtQBcfo5V","title":"Math Equations","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Math Equations"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/math-equations"},{"name":"iconClass","value":"bx bx-math","type":"label"}]},{"id":"_help_wYDzQ1fBFgfT","title":"Multicolumn layout","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Multicolumn layout"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/multicolumn-layout"},{"name":"iconClass","value":"cke cke-trilium-multicolumn","type":"label"}]},{"id":"_help_dEHYtoWWi8ct","title":"Other features","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Other features"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/other-features"},{"name":"iconClass","value":"bx bxs-grid","type":"label"}]},{"id":"_help_gLt3vA97tMcp","title":"Premium features","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Premium features"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/premium-features"},{"name":"iconClass","value":"bx bx-star","type":"label"}]},{"id":"_help_ZlN4nump6EbW","title":"Slash Commands","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Slash Commands"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/slash-commands"},{"name":"iconClass","value":"bx bx-menu","type":"label"}]},{"id":"_help_oBo3iHIZnbG2","title":"Spell Check","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Spell Check"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/spellcheck"},{"name":"iconClass","value":"bx bx-check-double","type":"label"}]},{"id":"_help_BFvAtE74rbP6","title":"Table of contents","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Table of contents"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/table-of-contents"},{"name":"iconClass","value":"bx bx-heading","type":"label"}]},{"id":"_help_NdowYOC1GFKS","title":"Tables","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Tables"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/tables"},{"name":"iconClass","value":"bx bx-table","type":"label"}]},{"id":"_help_pwc194wlRzcH","title":"Text Snippets","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Text Snippets"},{"name":"iconClass","value":"bx bx-file","type":"label"}]},{"id":"_help_fASfBrYnquKU","title":"To-do Lists","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/To-do Lists"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/todo-lists"},{"name":"iconClass","value":"bx bx-checkbox-checked","type":"label"}]}]},{"id":"_help_6f9hih2hXXZk","title":"Code","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Code"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/code"},{"name":"iconClass","value":"bx bx-code","type":"label"}]},{"id":"_help_m523cpzocqaD","title":"Saved Search","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Saved Search"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/saved-search"},{"name":"iconClass","value":"bx bx-file-find","type":"label"}]},{"id":"_help_iRwzGnHPzonm","title":"Relation Map","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Relation Map"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/relation-map"},{"name":"iconClass","value":"bx bx-shape-polygon","type":"label"}]},{"id":"_help_bdUJEHsAPYQR","title":"Note Map","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Note Map"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/note-map"},{"name":"iconClass","value":"bx bxs-network-chart","type":"label"}]},{"id":"_help_HcABDtFCkbFN","title":"Render Note","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Render Note"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/render-note"},{"name":"iconClass","value":"bx bx-extension","type":"label"}]},{"id":"_help_s1aBHPd79XYj","title":"Mermaid Diagrams","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Mermaid Diagrams"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/mermaid-diagrams"},{"name":"iconClass","value":"bx bx-selection","type":"label"}],"children":[{"id":"_help_RH6yLjjWJHof","title":"ELK layout","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Mermaid Diagrams/ELK layout"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/mermaid-diagrams/elk"},{"name":"iconClass","value":"bx bxs-network-chart","type":"label"}]},{"id":"_help_WWgeUaBb7UfC","title":"Syntax reference","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://mermaid.js.org/intro/syntax-reference.html"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true}]},{"id":"_help_grjYqerjn243","title":"Canvas","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Canvas"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/canvas"},{"name":"iconClass","value":"bx bx-pen","type":"label"}]},{"id":"_help_1vHRoWCEjj0L","title":"Web View","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Web View"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/webview"},{"name":"iconClass","value":"bx bx-globe-alt","type":"label"}]},{"id":"_help_gBbsAeiuUxI5","title":"Mind Map","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Mind Map"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/mindmap"},{"name":"iconClass","value":"bx bx-sitemap","type":"label"}]},{"id":"_help_W8vYD3Q1zjCR","title":"File","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/File"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/file"},{"name":"iconClass","value":"bx bx-file-blank","type":"label"}],"children":[{"id":"_help_XJGJrpu7F9sh","title":"PDFs","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/File/PDFs"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/file/pdf"},{"name":"iconClass","value":"bx bxs-file-pdf","type":"label"}]},{"id":"_help_AjqEeiDUOzj4","title":"Audio & Video","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/File/Audio & Video"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/file/audio-video"},{"name":"iconClass","value":"bx bx-video","type":"label"}]},{"id":"_help_KG48zgNY31NW","title":"Office documents","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/File/Office documents"},{"name":"iconClass","value":"bx bxs-file-doc","type":"label"}]}]},{"id":"_help_GWHEkY4I4OE3","title":"Spreadsheets","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Spreadsheets"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/spreadsheets"},{"name":"iconClass","value":"bx bx-table","type":"label"}]},{"id":"_help_6RM1Q7ppFVoj","title":"Markdown","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Markdown"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/markdown"},{"name":"iconClass","value":"bx bxl-markdown","type":"label"}]},{"id":"_help_jludwdW7N4hg","title":"Converting between note types","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Converting between note types"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/note-type-conversion"},{"name":"iconClass","value":"bx bx-repost","type":"label"}]}]},{"id":"_help_GTwFsgaA0lCt","title":"Collections","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Collections"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/collections"},{"name":"iconClass","value":"bx bx-book","type":"label"}],"children":[{"id":"_help_xWbu3jpNWapp","title":"Calendar","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Collections/Calendar"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/collections/calendar"},{"name":"iconClass","value":"bx bx-calendar","type":"label"}]},{"id":"_help_2FvYrpmOXm29","title":"Table","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Collections/Table"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/collections/table"},{"name":"iconClass","value":"bx bx-table","type":"label"}]},{"id":"_help_CtBQqbwXDx1w","title":"Kanban Board","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Collections/Kanban Board"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/collections/kanban-board"},{"name":"iconClass","value":"bx bx-columns","type":"label"}]},{"id":"_help_81SGnPGMk7Xc","title":"Geo Map","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Collections/Geo Map"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/collections/geomap"},{"name":"iconClass","value":"bx bx-map-alt","type":"label"}],"children":[{"id":"_help_C2H9HK4BzwG7","title":"Drawing shapes","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Collections/Geo Map/Drawing shapes"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/collections/geomap/shapes"},{"name":"iconClass","value":"bx bx-shape-square","type":"label"}]},{"id":"_help_ZRDXGc0nAIh4","title":"Image maps","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Collections/Geo Map/Image maps"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/collections/geomap/image-maps"},{"name":"iconClass","value":"bx bx-image-alt","type":"label"}]}]},{"id":"_help_zP3PMqaG71Ct","title":"Presentation","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Collections/Presentation"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/collections/presentation"},{"name":"iconClass","value":"bx bx-slideshow","type":"label"}]},{"id":"_help_8QqnMzx393bx","title":"Grid View","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Collections/Grid View"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/collections/grid"},{"name":"iconClass","value":"bx bxs-grid","type":"label"}]},{"id":"_help_mULW0Q3VojwY","title":"List View","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Collections/List View"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/collections/list"},{"name":"iconClass","value":"bx bx-list-ul","type":"label"}]},{"id":"_help_CssoWBu8I7jF","title":"Collection Properties","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Collections/Collection Properties"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/collections/collection-properties"},{"name":"iconClass","value":"bx bx-cog","type":"label"}]},{"id":"_help_IF7Q6I9x7zuw","title":"Dashboard","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Collections/Dashboard"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/collections/dashboard"},{"name":"iconClass","value":"bx bxs-dashboard","type":"label"}]}]},{"id":"_help_BgmBlOIl72jZ","title":"Troubleshooting","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Troubleshooting"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/troubleshooting"},{"name":"iconClass","value":"bx bx-bug","type":"label"}],"children":[{"id":"_help_wy8So3yZZlH9","title":"Reporting issues","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Troubleshooting/Reporting issues"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/troubleshooting/reporting-issues"},{"name":"iconClass","value":"bx bx-bug-alt","type":"label"}]},{"id":"_help_x59R8J8KV5Bp","title":"Anonymized Database","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Troubleshooting/Anonymized Database"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/troubleshooting/anonymized-database"},{"name":"iconClass","value":"bx bx-low-vision","type":"label"}]},{"id":"_help_qzNzp9LYQyPT","title":"Error logs","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Troubleshooting/Error logs"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/troubleshooting/error-logs"},{"name":"iconClass","value":"bx bx-comment-error","type":"label"}],"children":[{"id":"_help_bnyigUA2UK7s","title":"Backend (server) logs","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Troubleshooting/Error logs/Backend (server) logs"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/troubleshooting/error-logs/backend-logs"},{"name":"iconClass","value":"bx bx-server","type":"label"}]},{"id":"_help_9yEHzMyFirZR","title":"Frontend logs","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Troubleshooting/Error logs/Frontend logs"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/troubleshooting/error-logs/frontend-logs"},{"name":"iconClass","value":"bx bx-window-alt","type":"label"}]}]},{"id":"_help_vdlYGAcpXAgc","title":"Synchronization fails with 504 Gateway Timeout","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Troubleshooting/Synchronization fails with 504 Gateway Timeout"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/troubleshooting/sync-timeout"},{"name":"iconClass","value":"bx bx-error","type":"label"}]},{"id":"_help_s8alTXmpFR61","title":"Refreshing the application","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Troubleshooting/Refreshing the application"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/troubleshooting/refreshing-app"},{"name":"iconClass","value":"bx bx-refresh","type":"label"}]}]},{"id":"_help_pKK96zzmvBGf","title":"Theme development","type":"book","attributes":[{"name":"iconClass","value":"bx bx-palette","type":"label"}],"children":[{"id":"_help_7NfNr5pZpVKV","title":"Creating a custom theme","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Theme development/Creating a custom theme"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/theme-development/creating-custom-theme"},{"name":"iconClass","value":"bx bxs-color","type":"label"}]},{"id":"_help_WFGzWeUK6arS","title":"Customize the Next theme","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Theme development/Customize the Next theme"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/theme-development/customize-next-theme"},{"name":"iconClass","value":"bx bx-news","type":"label"}]},{"id":"_help_WN5z4M8ASACJ","title":"Reference","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Theme development/Reference"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/theme-development/reference"},{"name":"iconClass","value":"bx bx-book-open","type":"label"}]},{"id":"_help_AlhDUqhENtH7","title":"Custom app-wide CSS","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Theme development/Custom app-wide CSS"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/theme-development/custom-appcss"},{"name":"iconClass","value":"bx bxs-file-css","type":"label"}]},{"id":"_help_g1mlRoU8CsqC","title":"Creating an icon pack","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Theme development/Creating an icon pack"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/theme-development/creating-icon-pack"},{"name":"iconClass","value":"bx bx-package","type":"label"}]}]},{"id":"_help_tC7s2alapj8V","title":"Advanced Usage","type":"book","attributes":[{"name":"iconClass","value":"bx bx-rocket","type":"label"}],"children":[{"id":"_help_zEY4DaJG4YT5","title":"Attributes","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Attributes"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/attributes"},{"name":"iconClass","value":"bx bx-list-check","type":"label"}],"children":[{"id":"_help_HI6GBBIduIgv","title":"Labels","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Attributes/Labels"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/attributes/labels"},{"name":"iconClass","value":"bx bx-hash","type":"label"}]},{"id":"_help_Cq5X6iKQop6R","title":"Relations","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Attributes/Relations"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/attributes/relations"},{"name":"iconClass","value":"bx bx-transfer","type":"label"}]},{"id":"_help_bwZpz2ajCEwO","title":"Attribute Inheritance","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Attributes/Attribute Inheritance"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/attributes/attribute-inheritance"},{"name":"iconClass","value":"bx bx-list-plus","type":"label"}]},{"id":"_help_OFXdgB2nNk1F","title":"Promoted Attributes","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Attributes/Promoted Attributes"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/attributes/promoted-attributes"},{"name":"iconClass","value":"bx bx-table","type":"label"}]}]},{"id":"_help_KC1HB96bqqHX","title":"Templates","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Templates"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/template"},{"name":"iconClass","value":"bx bx-detail","type":"label"}]},{"id":"_help_B2ORr7OVEZtc","title":"Snippets","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Snippets"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/snippets"},{"name":"iconClass","value":"bx bx-news","type":"label"}],"children":[{"id":"_help_VQjhl61rlWh9","title":"Markdown Snippets","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Snippets/Markdown Snippets"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/snippets/markdown-snippets"},{"name":"iconClass","value":"bx bxl-markdown","type":"label"}]},{"id":"_help_IEgsWp5hHH35","title":"Code Snippets","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Snippets/Code Snippets"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/snippets/code-snippets"},{"name":"iconClass","value":"bx bx-code-alt","type":"label"}]},{"id":"_help_pwc194wlRzcH","title":"Text Snippets","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Note Types/Text/Text Snippets"},{"name":"iconClass","value":"bx bx-file","type":"label"}]}]},{"id":"_help_BCkXAVs63Ttv","title":"Note Map (Link map, Tree map)","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Note Map (Link map, Tree map)"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/note-map"},{"name":"iconClass","value":"bx bxs-network-chart","type":"label"}]},{"id":"_help_R9pX4DGra2Vt","title":"Sharing","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Sharing"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/sharing"},{"name":"iconClass","value":"bx bx-share-alt","type":"label"}],"children":[{"id":"_help_Qjt68inQ2bRj","title":"Serving directly the content of a note","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Sharing/Serving directly the content of a note"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/sharing/serving-raw"},{"name":"iconClass","value":"bx bx-code","type":"label"}]},{"id":"_help_ycBFjKrrwE9p","title":"Exporting static HTML for web publishing","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Sharing/Exporting static HTML for web publishing"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/sharing/static-html"},{"name":"iconClass","value":"bx bxs-file-html","type":"label"}]},{"id":"_help_sLIJ6f1dkJYW","title":"Reverse proxy configuration","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Sharing/Reverse proxy configuration"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/sharing/reverse-proxy"},{"name":"iconClass","value":"bx bx-world","type":"label"}]},{"id":"_help_Ad7Ku5gOHrDU","title":"Custom share template","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Sharing/Custom share template"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/sharing/custom-share-template"},{"name":"iconClass","value":"bx bxl-nodejs","type":"label"}]}]},{"id":"_help_5668rwcirq1t","title":"Advanced Showcases","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Advanced Showcases"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/advanced-showcases"},{"name":"iconClass","value":"bx bxs-component","type":"label"}],"children":[{"id":"_help_l0tKav7yLHGF","title":"Day Notes","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Advanced Showcases/Day Notes"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/advanced-showcases/day-notes"},{"name":"iconClass","value":"bx bx-calendar","type":"label"}]},{"id":"_help_R7abl2fc6Mxi","title":"Weight Tracker","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Advanced Showcases/Weight Tracker"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/advanced-showcases/weight-tracker"},{"name":"iconClass","value":"bx bx-line-chart","type":"label"}]},{"id":"_help_xYjQUYhpbUEW","title":"Task Manager","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Advanced Showcases/Task Manager"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/advanced-showcases/task-manager"},{"name":"iconClass","value":"bx bx-calendar-check","type":"label"}]}]},{"id":"_help_i16PM6A7GXdU","title":"Customizing to-do task states","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Customizing to-do task states"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/customizing-to-do-task-states"},{"name":"iconClass","value":"bx bx-list-check","type":"label"}]},{"id":"_help_J5Ex1ZrMbyJ6","title":"Custom Request Handler","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Custom Request Handler"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/custom-request-handler"},{"name":"iconClass","value":"bx bx-globe","type":"label"}]},{"id":"_help_d3fAXQ2diepH","title":"Custom Resource Providers","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Custom Resource Providers"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/custom-resource-providers"},{"name":"iconClass","value":"bx bxs-file-plus","type":"label"}]},{"id":"_help_pgxEVkzLl1OP","title":"ETAPI (REST API)","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/ETAPI (REST API)"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/etapi"},{"name":"iconClass","value":"bx bx-extension","type":"label"}],"children":[{"id":"_help_9qPsTWBorUhQ","title":"API Reference","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/rest-api/etapi/"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true}]},{"id":"_help_47ZrP6FNuoG8","title":"Default Note Title","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Default Note Title"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/default-note-title"},{"name":"iconClass","value":"bx bx-edit-alt","type":"label"}]},{"id":"_help_wX4HbRucYSDD","title":"Database","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Database"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/database"},{"name":"iconClass","value":"bx bx-data","type":"label"}],"children":[{"id":"_help_oyIAJ9PvvwHX","title":"Manually altering the database","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Database/Manually altering the database"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/database/manual-editing"},{"name":"iconClass","value":"bx bxs-edit","type":"label"}],"children":[{"id":"_help_YKWqdJhzi2VY","title":"SQL Console","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Database/Manually altering the database/SQL Console"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/database/manual-editing/sql-console"},{"name":"iconClass","value":"bx bx-data","type":"label"}]}]},{"id":"_help_6tZeKvSHEUiB","title":"Demo Notes","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Database/Demo Notes"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/database/demo-notes"},{"name":"iconClass","value":"bx bx-package","type":"label"}]}]},{"id":"_help_Gzjqa934BdH4","title":"Configuration (config.ini or environment variables)","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Configuration (config.ini or environment variables)"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/configuration"},{"name":"iconClass","value":"bx bx-cog","type":"label"}],"children":[{"id":"_help_c5xB8m4g2IY6","title":"Trilium instance","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Configuration (config.ini or environment variables)/Trilium instance"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/configuration/trilium-instance"},{"name":"iconClass","value":"bx bx-windows","type":"label"}]},{"id":"_help_LWtBjFej3wX3","title":"Cross-Origin Resource Sharing (CORS)","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Configuration (config.ini or environment variables)/Cross-Origin Resource Sharing (CORS)"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/configuration/cors"},{"name":"iconClass","value":"bx bx-lock","type":"label"}]}]},{"id":"_help_ivYnonVFBxbQ","title":"Bulk Actions","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Bulk Actions"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/bulk-actions"},{"name":"iconClass","value":"bx bx-list-plus","type":"label"}]},{"id":"_help_4FahAwuGTAwC","title":"Note source","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Note source"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/note-source"},{"name":"iconClass","value":"bx bx-code","type":"label"}]},{"id":"_help_1YeN2MzFUluU","title":"Technologies used","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Technologies used"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/technologies"},{"name":"iconClass","value":"bx bx-pyramid","type":"label"}],"children":[{"id":"_help_MI26XDLSAlCD","title":"CKEditor","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Technologies used/CKEditor"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/technologies/ckeditor"},{"name":"iconClass","value":"bx bx-file","type":"label"}]}]},{"id":"_help_m1lbrzyKDaRB","title":"Note ID","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Note ID"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/note-id"},{"name":"iconClass","value":"bx bx-fingerprint","type":"label"}]},{"id":"_help_0vTSyvhPTAOz","title":"Internal API","type":"book","attributes":[{"name":"iconClass","value":"bx bxs-component","type":"label"}],"children":[{"id":"_help_z8O2VG4ZZJD7","title":"API Reference","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/rest-api/internal/"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true}]},{"id":"_help_2mUhVmZK8RF3","title":"Hidden Notes","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Hidden Notes"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/hidden-notes"},{"name":"iconClass","value":"bx bx-hide","type":"label"}]},{"id":"_help_uYF7pmepw27K","title":"Metrics","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Metrics"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/metrics"},{"name":"iconClass","value":"bx bxs-data","type":"label"}],"children":[{"id":"_help_bOP3TB56fL1V","title":"grafana-dashboard.json","type":"doc","attributes":[{"name":"iconClass","value":"bx bx-file","type":"label"}]}]},{"id":"_help_64ZTlUPgEPtW","title":"Safe mode","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Safe mode"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/safe-mode"},{"name":"iconClass","value":"bx bxs-virus-block","type":"label"}]},{"id":"_help_HAIOFBoYIIdO","title":"Nightly release","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Nightly release"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/nightly-release"},{"name":"iconClass","value":"bx bx-moon","type":"label"}]},{"id":"_help_ZmT9ln8XJX2o","title":"Read-only database","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Read-only database"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/read-only-db"},{"name":"iconClass","value":"bx bx-book-reader","type":"label"}]},{"id":"_help_TiQbQDgP8L5t","title":"Text Extraction (OCR)","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Advanced Usage/Text Extraction (OCR)"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/ocr"},{"name":"iconClass","value":"bx bx-file","type":"label"}]}]},{"id":"_help_GBBMSlVSOIGP","title":"AI","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/AI"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/llm"},{"name":"iconClass","value":"bx bx-bot","type":"label"}],"children":[{"id":"_help_bkPZAMT7d2sR","title":"Providers","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/AI/Providers"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/llm/providers"},{"name":"iconClass","value":"bx bx-cog","type":"label"}],"children":[{"id":"_help_eFhxp9laTW1S","title":"Subscription-based providers","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/AI/Providers/Subscription-based providers"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/llm/providers/subscription-based"},{"name":"iconClass","value":"bx bx-coin","type":"label"}]}]},{"id":"_help_cRRrdZjgyhNc","title":"Privacy","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/AI/Privacy"},{"name":"iconClass","value":"bx bx-lock-alt","type":"label"}]},{"id":"_help_KOWBFgsZXJAD","title":"MCP","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/AI/MCP"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/llm/mcp"},{"name":"iconClass","value":"bx bx-network-chart","type":"label"}]}]},{"id":"_help_Y84QCbArmK3z","title":"Meeting transcription","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Meeting transcription"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/transcription"},{"name":"iconClass","value":"bx bx-microphone","type":"label"}]},{"id":"_help_CdNpE2pqjmI6","title":"Scripting","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts"},{"name":"iconClass","value":"bx bxs-file-js","type":"label"}],"children":[{"id":"_help_yIhgI5H7A2Sm","title":"Frontend Basics","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Frontend Basics"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics"},{"name":"iconClass","value":"bx bx-window","type":"label"}],"children":[{"id":"_help_MgibgPcfeuGz","title":"Custom Widgets","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/custom-widget"},{"name":"iconClass","value":"bx bxs-widget","type":"label"}],"children":[{"id":"_help_SynTBQiBsdYJ","title":"Widget Basics","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/Widget Basics"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/custom-widget/widget-basics"},{"name":"iconClass","value":"bx bx-file","type":"label"}]},{"id":"_help_GhurYZjh8e1V","title":"Note context aware widget","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/Note context aware widget"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/custom-widget/note-context-aware-widget"},{"name":"iconClass","value":"bx bx-file","type":"label"}]},{"id":"_help_M8IppdwVHSjG","title":"Right pane widget","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/Right pane widget"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/custom-widget/right-pane-widget"},{"name":"iconClass","value":"bx bx-file","type":"label"}]},{"id":"_help_YNxAqkI5Kg1M","title":"Word count widget","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/Word count widget"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/custom-widget/word-count"},{"name":"iconClass","value":"bx bx-file","type":"label"}]},{"id":"_help_VqGQnnPGnqAU","title":"CSS","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/CSS"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/custom-widget/css"},{"name":"iconClass","value":"bx bx-file","type":"label"}]},{"id":"_help_gMkgcLJ6jBkg","title":"Troubleshooting","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/Troubleshooting"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/custom-widget/troubleshooting"},{"name":"iconClass","value":"bx bx-file","type":"label"}]}]},{"id":"_help_es8OU2GuguFU","title":"Examples","type":"book","attributes":[{"name":"iconClass","value":"bx bx-code-alt","type":"label"}],"children":[{"id":"_help_TjLYAo3JMO8X","title":"\"New Task\" launcher button","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Frontend Basics/Examples/New Task launcher button"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/examples/new-task-button"},{"name":"iconClass","value":"bx bx-task","type":"label"}]},{"id":"_help_7kZPMD0uFwkH","title":"Downloading responses from Google Forms","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Frontend Basics/Examples/Downloading responses from Google Forms"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/examples/responses-from-google-forms"},{"name":"iconClass","value":"bx bx-file","type":"label"}]},{"id":"_help_DL92EjAaXT26","title":"Using promoted attributes to configure scripts","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Frontend Basics/Examples/Using promoted attributes to configure scripts"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/examples/promoted-attributes-config"},{"name":"iconClass","value":"bx bx-file","type":"label"}]}]},{"id":"_help_4Gn3psZKsfSm","title":"Launch Bar Widgets","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Frontend Basics/Launch Bar Widgets"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/launch-bar-widgets"},{"name":"iconClass","value":"bx bx-dock-left","type":"label"}],"children":[{"id":"_help_IPArqVfDQ4We","title":"Note Title Widget","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Frontend Basics/Launch Bar Widgets/Note Title Widget"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/launch-bar-widgets/note-title"},{"name":"iconClass","value":"bx bx-file","type":"label"}]},{"id":"_help_gcI7RPbaNSh3","title":"Analog Watch","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Frontend Basics/Launch Bar Widgets/Analog Watch"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/launch-bar-widgets/analog-watch"},{"name":"iconClass","value":"bx bx-file","type":"label"}]}]},{"id":"_help_KLsqhjaqh1QW","title":"Preact","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Frontend Basics/Preact"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/preac"},{"name":"iconClass","value":"bx bxl-react","type":"label"}],"children":[{"id":"_help_Bqde6BvPo05g","title":"Component libraries","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Frontend Basics/Preact/Component libraries"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/preac/component-libraries"},{"name":"iconClass","value":"bx bxs-component","type":"label"}]},{"id":"_help_ykYtbM9k3a7B","title":"Hooks","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Frontend Basics/Preact/Hooks"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/preac/hooks"},{"name":"iconClass","value":"bx bx-question-mark","type":"label"}]},{"id":"_help_Sg9GrCtyftZf","title":"CSS","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Frontend Basics/Preact/CSS"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/preac/css"},{"name":"iconClass","value":"bx bxs-file-css","type":"label"}]},{"id":"_help_RSssb9S3xgSr","title":"Built-in components","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Frontend Basics/Preact/Built-in components"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/preac/builtin-components"},{"name":"iconClass","value":"bx bxs-component","type":"label"}],"children":[{"id":"_help_i9B4IW7b6V6z","title":"Widget showcase","type":"doc","attributes":[{"name":"iconClass","value":"bx bx-file","type":"label"}]}]}]},{"id":"_help_irkwjdNtjcxR","title":"Frontend Events","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Frontend Basics/Frontend Events"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/events"},{"name":"iconClass","value":"bx bx-rss","type":"label"}]}]},{"id":"_help_SPirpZypehBG","title":"Backend scripts","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Backend scripts"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/backend-basics"},{"name":"iconClass","value":"bx bx-server","type":"label"}],"children":[{"id":"_help_fZ2IGYFXjkEy","title":"Server-side imports","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Backend scripts/Server-side imports"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/backend-basics/server-imports"},{"name":"iconClass","value":"bx bx-file","type":"label"}]},{"id":"_help_GPERMystNGTB","title":"Backend Events","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Backend scripts/Backend Events"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/backend-basics/events"},{"name":"iconClass","value":"bx bx-rss","type":"label"}]}]},{"id":"_help_wqXwKJl6VpNk","title":"Common concepts","type":"book","attributes":[{"name":"iconClass","value":"bx bxl-nodejs","type":"label"}],"children":[{"id":"_help_hA834UaHhSNn","title":"Script bundles","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Common concepts/Script bundles"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/common-concepts/bundles"},{"name":"iconClass","value":"bx bx-package","type":"label"}]}]},{"id":"_help_GLks18SNjxmC","title":"Script API","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Script API"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/script-api"},{"name":"iconClass","value":"bx bx-code-curly","type":"label"}],"children":[{"id":"_help_Q2z6av6JZVWm","title":"Frontend API","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/script-api/frontend"},{"name":"iconClass","value":"bx bx-folder","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_habiZ3HU8Kw8","title":"FNote","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/script-api/frontend/interfaces/FNote.html"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true}]},{"id":"_help_MEtfsqa5VwNi","title":"Backend API","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/script-api/backend"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true},{"id":"_help_GFXVHyblVN3d","title":"Electron API","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/script-api/electron"},{"name":"iconClass","value":"bx bx-window-alt","type":"label"}],"enforceAttributes":true},{"id":"_help_ApVHZ8JY5ofC","title":"Day.js","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Script API/Day.js"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/script-api/day.js"},{"name":"iconClass","value":"bx bx-calendar","type":"label"}]}]},{"id":"_help_vElnKeDNPSVl","title":"Logging","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Logging"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/logging"},{"name":"iconClass","value":"bx bx-terminal","type":"label"}]},{"id":"_help_cNpC0ITcfX0N","title":"Breaking changes","type":"book","attributes":[{"name":"iconClass","value":"bx bx-up-arrow-alt","type":"label"}],"children":[{"id":"_help_IjZS7iK5EXtb","title":"v0.107.0: Removal of the old layout","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Breaking changes/v0.107.0 Removal of the old layout"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/breaking-changes/old-layout-removal"},{"name":"iconClass","value":"bx bx-layout","type":"label"}]},{"id":"_help_kTx7WqLdZ3Ry","title":"v0.106.0: Removal of cheerio","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Breaking changes/v0.106.0 Removal of cheerio"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/breaking-changes/cheerio-removal"},{"name":"iconClass","value":"bx bx-file","type":"label"}]},{"id":"_help_YeOa2l7Pu39I","title":"v0.104.0: Disabling the Node integration in Electron","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Breaking changes/v0.104.0 Disabling the Node integration in Electron"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/breaking-changes/disabling-node-integration"},{"name":"iconClass","value":"bx bx-file","type":"label"}]},{"id":"_help_fqAK6opjUagR","title":"v0.103.0: Removal of axios","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Breaking changes/v0.103.0 Removal of axios"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/breaking-changes/axios-removal"},{"name":"iconClass","value":"bx bx-file","type":"label"}]},{"id":"_help_pAJ0jWz16xFm","title":"v0.103.0: `cheerio` is now deprecated","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Breaking changes/v0.103.0 `cheerio` is now deprecated"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/breaking-changes/cheerio-deprecated"},{"name":"iconClass","value":"bx bx-file","type":"label"}]},{"id":"_help_72dxvnbnkDFY","title":"v0.102.0: Upgrade to jQuery 4.0.0","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Breaking changes/v0.102.0 Upgrade to jQuery 4.0.0"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/breaking-changes/jquery4"},{"name":"iconClass","value":"bx bx-file","type":"label"}]}]},{"id":"_help_fiHicjpHjIRJ","title":"Security","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Scripting/Security"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/security"},{"name":"iconClass","value":"bx bx-shield","type":"label"}]}]},{"id":"_help_Fm0j45KqyHpU","title":"Miscellaneous","type":"book","attributes":[{"name":"iconClass","value":"bx bx-info-circle","type":"label"}],"children":[{"id":"_help_WFbFXrgnDyyU","title":"Privacy Policy","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Miscellaneous/Privacy Policy"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/misc/privacy-policy"},{"name":"iconClass","value":"bx bx-file","type":"label"}]},{"id":"_help_NcsmUYZRWEW4","title":"Patterns of personal knowledge","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Miscellaneous/Patterns of personal knowledge"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/misc/patterns-of-personal-knowledge"},{"name":"iconClass","value":"bx bx-file","type":"label"}]},{"id":"_help_d1Ap6Pg6IjaJ","title":"License","type":"doc","attributes":[{"type":"label","name":"docName","value":"User Guide/User Guide/Miscellaneous/License"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/misc/license"},{"name":"iconClass","value":"bx bx-file","type":"label"}]}]}]
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/AI.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/AI.html
deleted file mode 100644
index a62d42a39d..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/AI.html
+++ /dev/null
@@ -1,447 +0,0 @@
-<p>Trilium can connect to a large language model and use it as an assistant
- that works directly on your notes: ask questions about the note you're
- reading, have it draft or restructure content, or get it to write scripts
- and widgets for you.</p>
-<p>The integration is off by default and does nothing until you enable it
- and configure a provider; Trilium ships no model of its own. The provider
- you pick decides how your notes travel: a cloud API billed per use, a subscription
- you already pay for, or a model running on your own hardware, in which
- case nothing leaves the machine. See&nbsp;<a class="reference-link" href="#root/_help_bkPZAMT7d2sR">Providers</a>&nbsp;for
- what each involves, and&nbsp;<a class="reference-link" href="#root/_help_cRRrdZjgyhNc">Privacy</a>&nbsp;for
- exactly what gets sent.</p>
-<p>Once enabled, the assistant is available as:</p>
-<ul>
- <li>As a dedicated note type, it can read and modify notes through tools,
- which you can switch off per conversation if you would rather it only saw
- what you type.</li>
- <li>A panel in the right sidebar, which acts similarly to the dedicated note
- type but it also has optional access to the current note.</li>
- <li>An&nbsp;<a class="reference-link" href="#root/_help_VRoP0g1uHHc2">In-editor AI assistant</a>&nbsp;which
- comes with builtin actions that operate over selected text (such as proof-reading,
- summarizing), as well as&nbsp;<a class="reference-link" href="#root/_help_mVEYwt20exhO">Custom AI quick actions</a>.</li>
-</ul>
-<h2>Feature highlights</h2>
-<ul>
- <li>Chat-based interface with live streaming of the messages.</li>
- <li>Provides the AI context with the note currently being looked at.</li>
- <li>Tools to alter note content, create new notes, etc.</li>
- <li>Statistics regarding context window use and pricing per message.</li>
- <li>Attachments for multi-modal chat (images, text files, PDFs).</li>
- <li>Optional MCP to allow external chat tools (e.g. Claude Code) to operate
- on notes within Trilium.</li>
-</ul>
-<h2>Sample use-cases</h2>
-<ul>
- <li>Create any type of&nbsp;<a class="reference-link" href="#root/_help_MgibgPcfeuGz">Custom Widgets</a>.</li>
- <li>Easily create a&nbsp;<a class="reference-link" href="#root/_help_HcABDtFCkbFN">Render Note</a>,
- e.g. <em>Create for me a render note which allows me to play tic-tac-toe. Make sure to use Preact instead of the legacy jQuery.</em>
- </li>
- <li>Create widgets for a&nbsp;<a class="reference-link" href="#root/_help_IF7Q6I9x7zuw">Dashboard</a>,
- such as a calculator, a stopwatch, a pomodoro timer.</li>
-</ul>
-<aside class="admonition note">
- <p>Claude Sonnet is known to produce very good frontend or backend scripts
- with little guidance, as the AI has been instructed in how to produce them.</p>
-</aside>
-<h2>LLM Providers</h2>
-<p>Trilium supports four different types of providers:</p>
-<div class="trilium-tabs">
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bx-cloud"></span>&nbsp;Cloud</p>
- <div class="trilium-tab-panel">
- <p>Pay-per use with an API key which is billed separately from any subscription
- you might already have.</p>
- <ul>
- <li><span class="tn-icon tn-brand tn-brand-anthropic"></span>&nbsp;Anthropic
- Claude</li>
- <li><span class="tn-icon tn-brand tn-brand-openai"></span>&nbsp;OpenAI GPT</li>
- <li><span class="tn-icon tn-brand tn-brand-gemini"></span>&nbsp;Google Gemini</li>
- <li><span class="tn-icon tn-brand tn-brand-deepseek"></span>&nbsp;DeepSeek</li>
- </ul>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bx-coin"></span>&nbsp;Subscription-based</p>
- <div
- class="trilium-tab-panel">
- <p>Reuses an existing subscription instead of paying per use.</p>
- <ul>
- <li><span class="tn-icon tn-brand tn-brand-claude"></span>&nbsp;<a href="#root/_help_eFhxp9laTW1S">Claude Code</a>
- </li>
- <li><span class="tn-icon tn-brand tn-brand-github-copilot"></span>&nbsp;<a
- href="#root/_help_eFhxp9laTW1S">GitHub Copilot</a>
- </li>
- <li><span class="tn-icon tn-brand tn-brand-antigravity"></span>&nbsp;<a href="#root/_help_eFhxp9laTW1S">Google Antigravity</a>
- </li>
- <li><span class="tn-icon tn-brand tn-brand-codex"></span>&nbsp;<a href="#root/_help_eFhxp9laTW1S">OpenAI Codex</a>
- </li>
- </ul>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bx-network-chart"></span>&nbsp;Local/self-hosted</p>
- <div
- class="trilium-tab-panel">
- <ul>
- <li><span class="tn-icon tn-brand tn-brand-ollama"></span>&nbsp;Ollama</li>
- <li><span class="tn-icon tn-brand tn-brand-lmstudio"></span>&nbsp;LM Studio</li>
- </ul>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bx-code-curly"></span>&nbsp;Custom endpoints</p>
- <div
- class="trilium-tab-panel">
- <p>For other providers that are not directly supported by Trilium, either
- local or hosted (e.g. OpenRouter, Groq, Mistral).</p>
- </div>
- </section>
-</div>
-<aside class="admonition tip">
- <p>For more information about each provider, see&nbsp;<a class="reference-link"
- href="#root/_help_bkPZAMT7d2sR">Providers</a>. See the dedicated&nbsp;<a
- class="reference-link" href="#root/_help_cRRrdZjgyhNc">Privacy</a>&nbsp;to
- better understand what data is sent to providers.</p>
-</aside>
-<h2>Enabling the AI integration</h2>
-<p>To enable the AI integration, simply go to&nbsp;<a class="reference-link"
- href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>AI / LLM</em> and
- press the toggle in the top-right of the dialog and configure a provider.</p>
-<h2>Creating a new chat</h2>
-<p>There are two different chat interfaces:</p>
-<ul>
- <li>One in the sidebar.</li>
- <li>A dedicated note type.</li>
-</ul>
-<h3>The sidebar interface</h3>
-<h3>The dedicated note type</h3>
-<p>The dedicated chat note is similar to the sidebar interface, but it makes
- longer conversations more comfortable to read.</p>
-<p>Unlike the sidebar, the AI will not be aware of the current note it's
- in.</p>
-<h3>Templates</h3>
-<p>Chat notes can be set as&nbsp;<a class="reference-link" href="#root/_help_KC1HB96bqqHX">Templates</a>&nbsp;to
- make them easily reusable. The entire conversation history is kept, allowing
- a basic form of specialization for the LLM with the existing chat acting
- like a system prompt.&nbsp;</p>
-<h3>Model selection</h3>
-<p>When a provider is configured in&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>,
- the next step is to select the models that will be available for the chat.</p>
-<p>The models are retrieved dynamically from the provider, only when the
- model selection list is visible. To alter the list of models, simply press
- the Edit button in the model selection box.</p>
-<p>Pricing information is displayed for known models. The pricing information
- (price per million tokens) is embedded in the application (using a subset
- of LiteLLM's data) and is updated with new versions of Trilium. Local providers
- are considered free, whereas custom endpoint providers don't offer any
- pricing information.</p>
-<h2>Features</h2>
-<h3>Web search</h3>
-<p>The AI can optionally search the web to find more information about a
- specific topic.&nbsp;</p>
-<p>Where the search comes from is chosen in the <em>Web search</em> submenu
- of the <span class="tn-icon bx bx-shield-quarter"></span><em>Tools</em> menu
- next to the model selector at the bottom of the chat, whose row shows the
- source in use:</p>
-<ul>
- <li><em>Disabled</em> turns web search off for this chat.</li>
- <li><em>Use the model's built-in search</em>, the default, lets the model
- search with its provider's own search. Anthropic, OpenAI and Google Gemini
- models have one, as do Claude Code, Google Antigravity and OpenAI Codex.
- DeepSeek, Ollama, LM Studio and custom endpoints don't, so this choice
- is disabled for their models.</li>
- <li>A search provider (Brave Search, Tavily, Exa, Serper, Perplexity or SearXNG)
- searches through that service instead, whichever model is answering. Search
- providers are added in the <em>Search Providers</em> section of the AI settings,
- which <em>Manage search providers</em> at the bottom of the submenu opens.
- The browser version can't use Brave Search, Exa or Perplexity, whose services
- refuse requests made from a web page, so they're shown disabled there.</li>
-</ul>
-<p>To use SearXNG, enable its JSON output by adding <code>json</code> to the
- search formats in the instance's <code>settings.yml</code>. SearXNG turns
- JSON off by default, and without it every search fails.</p><pre><code class="language-text-x-yaml">search:
- formats:
- - html
- - json</code></pre>
-<p>SearXNG doesn't use API keys, so leave the API key empty. Fill it in only
- if your instance sits behind a proxy that requires a token; Trilium sends
- it as a bearer token in the <code>Authorization</code> header.</p>
-<p>Whether web search is on is kept per chat; the search source is shared
- by all chats. A choice the current model can't use stays in the menu, disabled;
- hover the <span class="tn-icon bx bx-info-circle"></span>icon next to it
- to see why. Claude Code, GitHub Copilot, Google Antigravity and OpenAI
- Codex run their own tools, so they can't use a search provider.</p>
-<p>In the chat, a search run through a search provider shows that provider's
- logo at the start of its line instead of the <span class="tn-icon bx bx-search"></span>magnifier;
- hover the logo to see the provider's name.</p>
-<p>With a search provider, the model can also read the pages it finds, or
- a link you give it, as text: Trilium fetches the page itself and hands
- the model up to its first 20,000 characters. Addresses on your own machine
- or network are refused. In the browser version most sites don't allow being
- read this way, so reading a page there usually fails.</p>
-<h3>Thinking</h3>
-<p>Some models reason before they answer. While the model is thinking, its
- reasoning is shown in full under a spinner; once it is done, it folds into
- a collapsible <em>Thought process</em> line above the reply.</p>
-<p>How much a model thinks is set per chat, in one of two ways depending
- on the model:</p>
-<ul>
- <li>Most models have an <span class="tn-icon bx bx-brain"></span><em>Extended thinking</em> button,
- next to the <span class="tn-icon bx bx-shield-quarter"></span><em>Tools</em> button.</li>
- <li>Models that offer several levels of reasoning (DeepSeek V4, OpenAI Codex,
- Antigravity) have a <span class="tn-icon bx bx-brain"></span>reasoning effort
- dropdown next to the model selector instead. <em>None</em>, where offered,
- turns thinking off; higher levels give better answers to hard questions,
- but take longer and cost more.</li>
-</ul>
-<aside class="admonition note">
- <p>The effort dropdown only appears once Trilium knows the model's levels.
- For a DeepSeek provider set up with an earlier version of Trilium, edit
- the provider in the model selection box and press <em>Save</em> once.</p>
-</aside>
-<h3>Note access (tools)</h3>
-<p>Tools allow the agentic AI to understand and operate on notes directly
- within your Trilium instance.</p>
-<p>This feature is on by default. To turn it off, press the <span class="tn-icon bx bx-shield-quarter"></span><em>Tools</em> button
- next to the model selector at the bottom of the chat and switch off <em>Note access</em>.
- The <em>Tools</em> button is highlighted while note access or web search
- is on.</p>
-<p>Here are a few tools that Trilium provides for the LLM:</p>
-<ul>
- <li>At note level:
- <ul>
- <li>Search for notes</li>
- <li>Get the metadata or content of a note.</li>
- <li>Edit a note
- <ul>
- <li>There are multiple mechanism for the LLM to edit a note: completely by
- re-writing it, find/replace of a text sequence or append.</li>
- <li>When re-writing a note, the LLM can also change its type (for example
- from a text note to a code note) or the language of a code note, rewriting
- the content to match.</li>
- <li>Whenever the AI makes a change, a <a href="#root/_help_vZWERwf8U3nx">revision</a> is
- saved to be able to revert any unwanted changes.</li>
- </ul>
- </li>
- <li>Create a new note
- <ul>
- <li>Asked for a drawing, the LLM can create an SVG image note, or turn an
- existing note into one. It can write only SVG images, not other formats
- such as PNG.</li>
- </ul>
- </li>
- <li>Rename or delete a note.</li>
- </ul>
- </li>
- <li>At attribute level:
- <ul>
- <li>Get the full list of attributes, or a specific attribute.</li>
- <li>Set the value of an attribute.
- <ul>
- <li>An attribute that runs code, such as <code>#run</code>, <code>#widget</code> or <code>~renderNote</code>,
- is saved with a <code>disabled:</code> prefix (for example <code>#disabled:widget</code>),
- the same way a safe import disables it (see&nbsp;<a class="reference-link"
- href="#root/_help_YzMcWlCVeW09">Active content</a>). If the note already
- had that attribute enabled, the AI removes it, so none of it runs until
- you enable the new value. The AI tells you which note it is on; review
- the code, then enable it with the toggle next to the active content badge
- beside the note's title or, for a&nbsp;<a class="reference-link" href="#root/_help_HcABDtFCkbFN">Render Note</a>,
- the <em>Enable render note</em> button in the note.</li>
- </ul>
- </li>
- <li>Delete an attribute.</li>
- </ul>
- </li>
- <li>At tree level:
- <ul>
- <li>Get the direct children of a note.</li>
- <li>Get the entire subtree of a note.</li>
- <li>Move or clone a note somewhere else.</li>
- </ul>
- </li>
- <li>For&nbsp;<a class="reference-link" href="#root/_help_0vhv7lsOLy82">Attachments</a>:
- <ul>
- <li>Get metadata for an attachment.</li>
- <li>Get the content of an attachment.</li>
- </ul>
- </li>
- <li>Skills (see the dedicated section).</li>
-</ul>
-<p>Each tool the AI uses appears in the chat as a single line naming the
- tool and the note or query it worked on; a renamed note shows its previous
- title struck through, a deleted note its title struck through, a moved
- note where it was moved from and to, an attribute the AI read, set or deleted
- as a pill (struck through once deleted), an attachment by its title, note
- and size, and a web page the AI read as a link. A line folds open only
- when there is something to read inline: the notes a search found, the pages
- a web search found, the icons an icon search found, the type, attributes
- or start of the content of a note the AI read, all the attributes of a
- note, the text of an attachment or of a web page, the User Guide pages
- the AI looked up or its table of contents (both open in the help panel),
- the children or the whole subtree of a note, what the AI wrote into a note
- it created, rewrote or added to, the changes of an edit, or the reason
- a tool failed. A search names on its line the part of the tree it is confined
- to, if any, and also shows how many notes it found and how many of the
- matches the AI asked for; each note it lists opens with a click. To see
- exactly what the AI sent to a tool and what it got back, hover the line
- and press the <span class="tn-icon bx bx-code-alt"></span>button next to
- it; on touch screens the button is always shown.</p>
-<p>When the reply stops moving for a couple of seconds while the AI is still
- at work, for example while it reads what a tool returned, a <em>Still working…</em> line
- appears under it until the next part of the reply arrives.</p>
-<h4>Approving tool calls</h4>
-<p>Before the AI runs a tool, the chat asks whether to allow it. The tool's
- line is marked with a <span class="tn-icon bx bxs-hand"></span>icon and
- has <em>Allow</em> and <em>Deny</em> buttons below it. When the call would
- write to a note, the line opens on the text it would write or the changes
- of an edit. The reply waits until you answer.</p>
-<ul>
- <li>To let the call run, press <em>Allow</em>.</li>
- <li>To stop asking about a tool for the rest of the chat, open the menu next
- to <em>Allow</em> and choose to always allow that tool for this chat. The
- call runs, and so do the other calls of that tool still waiting and every
- later one in this chat. Other tools keep asking, and a new chat asks again.</li>
- <li>To refuse it, press <em>Deny</em>. The AI is told that you declined, and
- its reply carries on without the call, which is marked <em>denied</em>.</li>
- <li>Stopping the reply denies every call that is still waiting.</li>
-</ul>
-<p>To make a chat ask about a tool again, open the <span class="tn-icon bx bx-shield-quarter"></span><em>Tools</em> menu
- at the bottom of the chat and, under <em>Allowed in this chat</em>, press
- the tool. The submenu is shown once the chat has allowed a tool.</p>
-<p>Which calls ask depends on the chat's permission mode, chosen in the <span
- class="tn-icon bx bx-shield-quarter"></span><em>Tools</em> menu under <em>Permissions</em>:</p>
-<ul>
- <li><em>Always ask</em>: every call asks, including the ones that only read
- (searching notes, or reading a note or an attachment).</li>
- <li><em>Ask before changes</em>: the calls that only read run on their own,
- and the ones that change your notes (creating, editing, renaming, moving
- or deleting a note, and setting or deleting an attribute) ask.</li>
- <li><em>Don't ask</em>: every call runs without asking, changes included.</li>
-</ul>
-<p>A new chat starts in the mode you picked last, in any chat, or in <em>Ask before changes</em> until
- you pick one. Picking <em>Don't ask</em> therefore carries over to the next
- chat too.</p>
-<p>A tool allowed for the chat runs without asking in every mode. So does
- looking something up in what ships with Trilium (its User Guide, the skill
- sheets that teach the AI Trilium's search syntax and note types, and the
- icons), since it reads none of your notes. Searching the web and reading
- a web page never ask either: turning on web search in the <em>Tools</em> menu
- is what allows them, whether the model searches on its own or through a
- search provider.</p>
-<aside class="admonition note">
- <p>The&nbsp;<a class="reference-link" href="#root/_help_eFhxp9laTW1S">Subscription-based providers</a>&nbsp;(Claude
- Code, GitHub Copilot, Google Antigravity and OpenAI Codex) ask like any
- other provider.</p>
-</aside>
-<aside class="admonition note">
- <p>Most changes you allow can be undone: a deleted note can be restored,
- and an edit reverted from its revision. Setting an attribute is harder
- to undo, since attributes have no history.</p>
-</aside>
-<aside class="admonition note">
- <p>Gemini can't use its built-in search while note access is on. While it
- is, the built-in search choice in the <em>Tools</em> menu is disabled and
- says why; a search provider works with note access on.</p>
-</aside>
-<h3>Attachments</h3>
-<p>Since Trilium v0.140.0,&nbsp;<a class="reference-link" href="#root/_help_0vhv7lsOLy82">Attachments</a>&nbsp;allow
- for multi-modal chat:</p>
-<ul>
- <li>Raster image (sent as vision input, except for SVGs) with the following
- supported formats: PNG, JPEG, GIF, WebP.</li>
- <li>PDFs, sent natively to the provider (supported by Anthropic, OpenAI and
- Google).</li>
- <li>SVG images (sent as raw HTML).</li>
- <li>Text files.</li>
-</ul>
-<p>Not every model reads every kind of attachment: DeepSeek reads no PDFs,
- and images only with its vision models; OpenAI Codex, GitHub Copilot and
- Google Antigravity read images but no PDFs. For such a model:</p>
-<ul>
- <li>The attach button offers only the kinds the model reads, and a pasted
- or dropped file it can't read is not attached.</li>
- <li>After switching to such a model, an attachment it can't read is marked
- with a <span class="tn-icon bx bx-error"></span>warning, and the message
- can't be sent until the attachment is removed or another model is selected.</li>
- <li>An attachment sent in an earlier message reaches the model as its name
- only, such as <code>[attached file: report.pdf]</code>, so it can tell you
- it doesn't see the content.</li>
-</ul>
-<p>To upload an attachment:</p>
-<ul>
- <li>Press the dedicated <em>Attach</em> button (paperclip icon) underneath the
- text box.</li>
- <li>Paste an image directly from clipboard using Ctrl+V.</li>
-</ul>
-<p>Once one or more attachments are uploaded, they will appear directly above
- the text box:</p>
-<ul>
- <li>Images have a small thumbnail for easy identifications.</li>
- <li>Every attachment can be deleted by pressing their corresponding X button.</li>
-</ul>
-<p>Clicking an image or a PDF, either its chip above the text box or where
- it appears in a sent message, opens it in a viewer: an image can be zoomed
- and panned there, a PDF read page by page. The button next to the viewer's
- close button opens the original file in a new browser tab. <kbd>Ctrl</kbd>-clicking
- instead opens an image in a new browser tab, and a PDF as an attachment
- in a new Trilium tab.</p>
-<p>When an attachment is present, the LLM is instructed to consider the attachment
- with priority, even if it has access to the current note.</p>
-<aside class="admonition note">
- <p>Currently Trilium doesn't pre-process the attachments (e.g. via&nbsp;<a
- class="reference-link" href="#root/_help_TiQbQDgP8L5t">Text Extraction (OCR)</a>)
- before sending them to the LLM provider.</p>
-</aside>
-<h3>Mentions</h3>
-<p>Mentions are a way to insert references to notes other than the current
- note, using the same mechanism as&nbsp;<a class="reference-link" href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a>.
- To refer to another note, simply type @ followed by the name of the note
- to reference.</p>
-<p>This feature is mostly helpful when note tools are enabled, otherwise
- the LLM will have no way to access the given note.</p>
-<h3>Skills</h3>
-<p>Skills in Trilium are specialized instruction sets that help the AI be
- more productive by understanding how Trilium.</p>
-<p>These skills are not loaded by default to avoid an increased consumption
- of tokens, but the AI can load them on-demand if <em>Note tools</em> are
- enabled.</p>
-<p>The following skills are built-in:</p>
-<ul>
- <li>Search syntax: understands the full syntax of&nbsp;<a class="reference-link"
- href="#root/_help_eIg8jdvaoNNd">Search</a>.</li>
- <li>Backend scripting: to be able to write proper&nbsp;<a class="reference-link"
- href="#root/_help_SPirpZypehBG">Backend scripts</a>.</li>
- <li>Frontend scripting: to be able to write proper <a href="#root/_help_yIhgI5H7A2Sm">front-end scripts</a> (basic
- scripts, widgets,&nbsp;<a class="reference-link" href="#root/_help_HcABDtFCkbFN">Render Note</a>).</li>
- <li>Dashboards: to build a&nbsp;<a class="reference-link" href="#root/_help_IF7Q6I9x7zuw">Dashboard</a>&nbsp;and
- its widgets, including interactive ones made with a&nbsp;<a class="reference-link"
- href="#root/_help_HcABDtFCkbFN">Render Note</a>.</li>
-</ul>
-<p>When <em>Note tools</em> are enabled the skills will automatically be made
- available to the AI, so no user interaction is required.</p>
-<aside class="admonition note">
- <p>Custom skills are currently not supported but they are planned.</p>
-</aside>
-<h3>MCP</h3>
-<p>Trilium comes with a built-in MCP server which allows you to use an external
- agent such as Claude Code have access to your database. See the dedicated&nbsp;<a
- class="reference-link" href="#root/_help_KOWBFgsZXJAD">MCP</a>&nbsp;page
- for more details.</p>
-<h2>History</h2>
-<h3>Removal in v0.102.0</h3>
-<p>Starting with version v0.102.0, AI/LLM integration has been removed from
- the Trilium Notes core.</p>
-<p>While a significant amount of effort went into developing this feature,
- maintaining and supporting it long-term proved to be unsustainable.</p>
-<p>When upgrading to v0.102.0, your Chat notes will be preserved, but instead
- of the dedicated chat window they will be turned to a normal&nbsp;<a class="reference-link"
- href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;note, revealing the underlying
- JSON of the conversation.</p>
-<h3>Reintroduction in v0.103.0</h3>
-<p>Given the recent advancements of the AI scene, we decided to give the
- LLM integration another try. v0.103.0 introduces a completely new chat
- system.</p>
-<p>One of the key changes that lead to the reimplementation is that now we
- are using a library (<a href="https://github.com/vercel/ai">Vercel AI</a>)
- to manage the inner mechanism and the differences between LLM providers
- instead of having to implement it on our own.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/AI/MCP.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/AI/MCP.html
deleted file mode 100644
index 29f68f46da..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/AI/MCP.html
+++ /dev/null
@@ -1,49 +0,0 @@
-<p><a href="https://en.wikipedia.org/wiki/Model_Context_Protocol">Model Context Protocol</a> allows
- external chat applications such as Claude Code to have access to the Trilium
- database.</p>
-<h2>Built-in MCP</h2>
-<p>v0.103.0 comes with a built-in MCP server that is not active by default.
- To activate it, go to&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→
- AI/LLM and toggle the <em>MCP server</em> option.</p>
-<p>Once the MCP is active, simply add the MCP server to your AI assistant.
- The URL to use is displayed in the <em>Endpoint</em> <em>URL</em> information
- underneath the MCP toggle.</p>
-<p>Only the HTTP transport is supported, the <code>stdio</code> method is not
- supported. If that is a blocker, consider using a third-party alternative
- listed below.</p>
-<p>The tools exposed to the MCP are the same tools that are supported by
- the internal chat (see the <em>Note access</em> section).</p>
-<h3>Approving tool calls</h3>
-<p>Trilium does not ask for approval of the calls an external assistant makes;
- that is left to the assistant's own permission settings. To help it decide,
- each tool tells the assistant whether it only reads your notes, only adds
- to them (creating a note, cloning it or appending to it), or can overwrite
- or remove something (editing, renaming, moving or deleting). An assistant
- that supports these hints can then run reads on their own and ask before
- changes, the way <em>Ask before changes</em> does in Trilium's chat.</p>
-<h3>Authentication</h3>
-<p>To protect your notes from unauthorized access, the MCP server requires
- authentication. Generally MCP servers need to support OAuth for authentication,
- but Trilium uses a simpler mechanism using Bearer tokens.</p>
-<p>To configure authentication, first create an&nbsp;<a class="reference-link"
- href="#root/_help_pgxEVkzLl1OP">ETAPI (REST API)</a>&nbsp;token by going
- to&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>ETAPI</em>.
- Then follow the instructions in&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>AI / LLM</em>,
- by looking at the <em>How to connect an assistant</em> section under MCP.</p>
-<h2>Third-party alternatives</h2>
-<p>The following are alternatives to Trilium's built-in MCP feature. Since
- Trilium's AI implementation is still experimental, its tooling might not
- be as mature as external tools.</p>
-<ul>
- <li><a href="https://github.com/perfectra1n/triliumnext-mcp">perfectra1n/triliumnext-mcp</a>
- </li>
- <li><a href="https://github.com/tan-yong-sheng/triliumnext-mcp">tan-yong-sheng/triliumnext-mcp</a>
- </li>
- <li><a href="https://github.com/eliassoares/trilium-fastmcp">eliassoares/trilium-fastmcp</a>
- </li>
-</ul>
-<aside class="admonition important">
- <p>These solutions are third-party and thus not endorsed or supported directly
- by the Trilium Notes team. Please address questions and issues on their
- corresponding repository instead.</p>
-</aside>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/AI/Privacy.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/AI/Privacy.html
deleted file mode 100644
index edf6fd08dc..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/AI/Privacy.html
+++ /dev/null
@@ -1,158 +0,0 @@
-<p>Trilium sends nothing to an AI provider until you send a message. Enabling
- the integration, adding a provider or opening a chat transmits nothing
- on its own, the one exception is that listing a provider's models sends
- your API key to that provider, so the list can be fetched.</p>
-<p>Once you send a message or run the&nbsp;<a class="reference-link" href="#root/_help_VRoP0g1uHHc2">In-editor AI assistant</a>,
- what leaves your machine depends on the provider you chose and on which
- context options are enabled.</p>
-<h2>Where your notes go</h2>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Provider type</th>
- <th>Destination</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>Cloud providers</td>
- <td>The provider's servers (Anthropic, OpenAI, Google, DeepSeek)</td>
- </tr>
- <tr>
- <td>Subscription-based</td>
- <td>The provider's servers, via Claude Code running locally</td>
- </tr>
- <tr>
- <td>Local / self-hosted</td>
- <td>Nothing leaves the machine running the model</td>
- </tr>
- <tr>
- <td>Custom endpoint</td>
- <td>Wherever it was pointed, which may be your own hardware or a hosted service</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<p>This is the reason the provider list is grouped this way, and why Trilium
- pre-selects nothing: the choice of where your note content is sent is made
- explicitly by you, before anything is sent.</p>
-<aside class="admonition note">
- <p>The&nbsp;<a class="reference-link" href="#root/_help_VRoP0g1uHHc2">In-editor AI assistant</a>&nbsp;has
- a model selection of its own, so it may be answered by a different provider
- than the one in the chat. The row at the bottom of the assistant's menu
- always names the one being used.</p>
-</aside>
-<h2>What is actually sent</h2>
-<ul>
- <li><strong>Always, with every message</strong>
- <ul>
- <li>The conversation itself: your messages and the assistant's replies, including
- earlier turns</li>
- <li>Trilium's system prompt describing how to format answers and use tools.</li>
- </ul>
- </li>
- <li><strong>The current note, only when note context is enabled.</strong>
- <ul>
- <li>In the sidebar chat this is the file icon at the bottom; the dedicated
- chat note type never sends a current note.</li>
- <li>What travels is a metadata block: the note's ID, title, type, creation
- and modification dates, its parent IDs, the titles of up to 20 children,
- up to 20 attributes, and a preview of the content.</li>
- <li>Notes above a size threshold send a size hint instead of the text, and
- the model must call a tool to read further.</li>
- </ul>
- </li>
- <li><strong>Any note the model asks for, when note access is enabled.</strong>
- <ul>
- <li>Tools let the model search your tree and read notes, attributes and attachments
- beyond the current one.</li>
- <li>It decides what to fetch, and each call waits for you to allow it, unless
- the chat's permission mode lets reads or every call run on their own, or
- you allowed that tool for the chat. There is no per-note permission system,
- so the reachable scope is your whole tree.</li>
- </ul>
- </li>
- <li><strong>Attachments and mentions</strong>, when you add them: images,
- PDFs and text files are sent to the provider, and an <code>@</code> mention
- makes that note fetchable.</li>
- <li><strong>Your search query</strong>, when web search is enabled, the model's
- search terms reach the provider's own search infrastructure, or the search
- provider chosen in the <em>Tools</em> menu (Brave Search, Tavily, Exa, Serper,
- Perplexity or your SearXNG instance).</li>
- <li><strong>The pages the model reads</strong>, when web search goes through
- a search provider: Trilium fetches each page the model asks for from the
- site itself, so the site sees a request from the machine running Trilium.
- The page's text is then sent to the model's provider.</li>
-</ul>
-<h2>The in-editor AI assistant</h2>
-<p>A run of the&nbsp;<a class="reference-link" href="#root/_help_VRoP0g1uHHc2">In-editor AI assistant</a>&nbsp;sends
- a different set than a chat message. For quick actions, it sends it the
- moment you pick an action, there is no send button to reconsider at. For
- the free-form <em>Ask AI</em>, there is a dedicated send button and model
- selector.</p>
-<ul>
- <li><strong>The passage you selected</strong>, or the paragraph the cursor
- is in when you pick a quick action without selecting anything.</li>
- <li><strong>Up to 1500 characters of the note on each side of that passage</strong>,
- as plain text. The assistant is told this is context only and must not
- be rewritten, but it is sent regardless of whether you selected it: a run
- on a single sentence still transmits the paragraphs around it.</li>
- <li><strong>Where the note sits</strong>: its title and the titles of its
- parents, as a breadcrumb.</li>
- <li><strong>Trilium's writing-assistant instructions</strong>, which describe
- the formatting it may produce.</li>
- <li><strong>Earlier turns of the same exchange</strong>, once you follow up
- on a response.</li>
-</ul>
-<p>No note metadata block is sent, web search is never enabled, and the assistant
- has no note tools so it can read nothing beyond the text listed above.</p>
-<h2>Protected notes</h2>
-<p>While your <a href="#root/_help_bwg0e8ewQMak">protected session</a> is locked,
- protected notes send neither title nor content. <strong>While it is unlocked they are treated like any other note,</strong> a
- note the model reads through a tool is sent to the provider in full. If
- you keep sensitive material in protected notes, be aware that unlocking
- them removes that boundary for the duration of the session.</p>
-<p>The same applies to the&nbsp;<a class="reference-link" href="#root/_help_VRoP0g1uHHc2">In-editor AI assistant</a>:
- it works on whatever is open in the editor, so running it inside an unlocked
- protected note sends that note's text like any other.</p>
-<h2>What you control</h2>
-<ul>
- <li><strong>Which provider</strong>: the single decision that determines whether
- anything leaves your machine at all.</li>
- <li><strong>Note access</strong>: turn it off in the <span class="tn-icon bx bx-shield-quarter"></span><em>Tools</em> menu
- at the bottom of the chat, and the model can read nothing beyond what you
- type.</li>
- <li><strong>The current note:</strong> the file icon in the sidebar chat.</li>
- <li><strong>Web search:</strong> also in the <em>Tools</em> menu.</li>
- <li><strong>Which tool calls ask first:</strong> the <em>Permissions</em> submenu
- of the <em>Tools</em> menu. <em>Always ask</em> has every call wait for you,
- reads included. A new chat starts in the mode you picked last, so a chat
- after one set to <em>Don't ask</em> asks about nothing either. Until you
- pick a mode, chats start in <em>Ask before changes</em>, where the AI reads
- and searches your notes without asking.</li>
- <li><strong>The editor assistant</strong>: it has no per-run toggles. What
- you control is whether you run it, what you select before you do and which
- model answers.</li>
-</ul>
-<p>With note access and note context both off, the provider receives only
- the words you typed.</p>
-<h2>Keeping everything local</h2>
-<p>Adding an Ollama or LM Studio provider keeps every message on the machine
- running the model, and Trilium marks their models as free because no metered
- API is involved. The trade-off is quality and hardware: a small local model
- may fail at tool calls that a cloud model handles, so a local setup that
- misbehaves is worth benchmarking against a cloud provider before reporting
- it as a bug.</p>
-<h2>Telemetry &amp; security</h2>
-<p>Trilium itself collects no telemetry from the AI integration.</p>
-<p>Your API key is stored in your database, sent only to the provider it
- belongs to, and is write-only through the options API so that a malevolent&nbsp;<a
- class="reference-link" href="#root/_help_CdNpE2pqjmI6">Scripting</a>&nbsp;cannot
- access it. If you have backend or SQL console access enabled, a malevolent
- script <strong>could potentially exfiltrate your API keys</strong>.</p>
-<p>The built-in MCP server is off by default. When enabled, every request
- must carry an ETAPI token, which grants the same full read and write access
- to your notes as the REST API; treat one like a password. On desktop it
- is reachable only from <code>localhost</code> unless you turn on&nbsp;<a
- class="reference-link" href="#root/_help_swSFivWk6KkA">Network Access</a>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/AI/Providers.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/AI/Providers.html
deleted file mode 100644
index 5fa29a2eba..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/AI/Providers.html
+++ /dev/null
@@ -1,89 +0,0 @@
-<p>Providers are added in the <em>Model Providers</em> section of the AI settings,
- with <em>Add Model Provider</em>. Each one lists the models selected for
- it, which are the ones the chat offers; a provider with no models selected
- is not offered in the chat.</p>
-<h2>Cloud providers using API keys</h2>
-<p>Currently, the following cloud providers are supported:</p>
-<ul>
- <li><span class="tn-icon tn-brand tn-brand-anthropic"></span>&nbsp;<a href="https://platform.claude.com/settings/workspaces/default/keys">Anthropic</a>
- </li>
- <li><span class="tn-icon tn-brand tn-brand-openai"></span>&nbsp;OpenAI</li>
- <li><span class="tn-icon tn-brand tn-brand-gemini"></span>&nbsp;Gemini</li>
- <li><span class="tn-icon tn-brand tn-brand-deepseek"></span>&nbsp;DeepSeek</li>
-</ul>
-<p>For all the providers, an API key is needed. Note that this is charged
- separately from the subscription you might already have (e.g. Claude Pro).
- If that might be a problem, consider using either a subscription provider
- (see below) or using it externally via MCP.</p>
-<p>Do note that most other LLM providers (e.g. OpenRouter, Groq, Mistral)
- can still be used in Trilium via the OpenAI-compatible custom endpoint
- (see below).</p>
-<p>If you are using a proxy or gateway, you can also configure the base URL,
- otherwise the default will be used.</p>
-<aside class="admonition note">
- <p>We don't plan to support all cloud providers, even if the library we are
- using would theoretically support them. Before opening a PR adding support
- for a different cloud provider, make sure to discuss it over <a href="https://github.com/orgs/TriliumNext/discussions">GitHub Discussions</a>.</p>
-</aside>
-<aside class="admonition important">
- <p>See also the dedicated&nbsp;<a class="reference-link" href="#root/_help_cRRrdZjgyhNc">Privacy</a>&nbsp;section
- to better understand what data is being sent to a cloud provider.</p>
-</aside>
-<h2>Subscription-based providers</h2>
-<p>Trilium integrates multiple&nbsp;<a class="reference-link" href="#root/_help_eFhxp9laTW1S">Subscription-based providers</a>:</p>
-<ul>
- <li><span class="tn-icon tn-brand tn-brand-claude"></span>&nbsp;Claude Code
- by reusing your CLI.</li>
- <li><span class="tn-icon tn-brand tn-brand-github-copilot"></span>&nbsp;GitHub
- Copilot by reusing your CLI's ACP.</li>
- <li><span class="tn-icon tn-brand tn-brand-antigravity"></span>&nbsp;Google
- Antigravity by downloading and setting up an ACP for Trilium.</li>
- <li><span class="tn-icon tn-brand tn-brand-codex"></span>&nbsp;OpenAI Codex
- by reusing your CLI through an ACP adapter shipped with Trilium.</li>
-</ul>
-<h2>Local/self-hosted providers</h2>
-<p>Local or self-hosted providers are a free alternative which respects your
- privacy but requires specific hardware.</p>
-<p>Trilium directly supports the following local providers:</p>
-<div class="trilium-tabs">
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon tn-brand tn-brand-ollama"></span>&nbsp;Ollama</p>
- <div
- class="trilium-tab-panel">
- <p>Generally Ollama runs in the background so it should be directly usable
- in Trilium as long as the models are downloaded (e.g. <code>ollama pull llama3.2</code>).</p>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon tn-brand tn-brand-lmstudio"></span>&nbsp;LM Studio</p>
- <div
- class="trilium-tab-panel">
- <p>The OpenAI-compatible server is <strong>disabled</strong> by default in
- LM Studio installations. First download your desired models through the
- graphical interface, then go to <em>Settings</em> → <em>Developer</em> and
- toggle <em>Developer mode</em>. On the left there will be a new <em>Developer</em> tab,
- with a toggle to start it up.</p>
- </div>
- </section>
-</div>
-<p>Even for local providers that are not directly supported by Trilium, you
- can still use a custom endpoint (see below).</p>
-<aside class="admonition warning">
- <p>When dealing with self-hosted LLM models, depending on the training and
- the size of the model, the quality of the output may vary. Before <a href="#root/_help_wy8So3yZZlH9">reporting issues</a> regarding
- the quality of the output (e.g. hallucinating tool calls), consider benchmarking
- the response against a cloud provider (Claude Sonnet is recommended).</p>
-</aside>
-<h2>Custom endpoints</h2>
-<p>If your desired hosted (e.g. OpenRouter, Groq, Mistral) or local LLM provider
- is not listed in Trilium, you can use the dedicated <em>OpenAI-compatible</em> provider
- from the <em>Custom endpoint</em> section.</p>
-<p>This allows you to set the base URL to an OpenAI-compatible API, with
- an optional API key if required by the service.</p>
-<p>Enter the base URL exactly as the service documents it, including its
- version path, such as <code>https://api.groq.com/openai/v1</code> or <code>https://open.bigmodel.cn/api/paas/v4</code>.
- Only a bare host such as <code>http://localhost:8080</code> is completed
- with <code>/v1</code>.</p>
-<p>For custom endpoints, the pricing of the models is not known so the cost
- of a conversation will not be displayed; this is especially relevant for
- hosted providers.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/AI/Providers/Subscription-based providers.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/AI/Providers/Subscription-based providers.html
deleted file mode 100644
index a5ebb5911d..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/AI/Providers/Subscription-based providers.html
+++ /dev/null
@@ -1,268 +0,0 @@
-<p>Some cloud providers offer a subscription, which has a fixed monthly fee
- instead of pay-per-use (unlike the API keys).</p>
-<p>In a nutshell, subscription-based providers work by either reusing your
- existing CLI tools (e.g. Claude Code, GitHub Copilot and OpenAI Codex via
- ACP) whereas some require installing the ACP server manually (e.g. Google
- Antigravity). Because they require something to be installed on your device,
- these providers are not available on Mobile (Android or iOS) or standalone
- mode.</p>
-<p>See also the dedicated&nbsp;<a class="reference-link" href="#root/_help_cRRrdZjgyhNc">Privacy</a>&nbsp;section
- to better understand what data is being sent to a cloud provider.</p>
-<h2><span class="tn-icon tn-brand tn-brand-claude"></span>&nbsp;Claude Code</h2>
-<p>To use a subscription:</p>
-<ol>
- <li>First, Claude Code needs to be installed on the machine that runs Trilium.
- So for a&nbsp;<a class="reference-link" href="#root/_help_poXkQfguuA0U">Desktop Installation</a>,
- Claude needs to be installed locally and for a&nbsp;<a class="reference-link"
- href="#root/_help_WOcw2SLH6tbX">Server Installation</a>&nbsp;accessed via
- a browser, Claude needs to be installed on the server.</li>
- <li>Claude Code must already be authenticated. To do so, run <code>claude</code> in
- a terminal once, type <code>/login</code> and follow the instructions.</li>
- <li>Go to&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>AI / LLM</em> and
- add the Claude Code provider.</li>
-</ol>
-<details class="trilium-collapsible">
- <summary>How Trilium identifies your Claude Code binary</summary>
- <p>In this order:</p>
- <ul>
- <li>By looking for a <code>TRILIUM_CLAUDE_CODE_PATH</code> environment variable
- pointing to the Claude binary. This allows overriding the path if needed.</li>
- <li>By looking for <code>claude</code> in your PATH, generally works in most
- circumstances.</li>
- <li>By asking your login shell for its <code>PATH</code> which lets a desktop
- install find a CLI installed through <code>nvm</code>, <code>fnm</code>, <code>asdf</code> or
- Homebrew, since a GUI-launched app doesn't inherit your terminal's environment.</li>
- </ul>
-</details>
-<p>After your provider is set up, you'll benefit from the same features as
- an API key (note tools, web search, extended thinking, image/PDF attachments,
- streaming).</p>
-<aside class="admonition note">
- <p>Trilium intentionally uses your Claude Code binary in order not to have
- to package a ~250 MB client with it, but this comes at a cost: there is
- a small risk for a version incompatibility, if the version installed locally
- doesn't match the one expected by Trilium. Generally it's best to keep
- both Claude Code and Trilium updated to the latest version.</p>
-</aside>
-<h2><span class="tn-icon tn-brand tn-brand-github-copilot"></span>&nbsp;GitHub Copilot</h2>
-<aside class="admonition note">
- <p>This subscription-based provider is still in beta. It is safe to use (won't
- use additional funds and respects the terms of use), but you might experience
- small issues. Consider&nbsp;<a class="reference-link" href="#root/_help_wy8So3yZZlH9">Reporting issues</a>.</p>
-</aside>
-<p>GitHub Copilot gives access to the models of your GitHub Copilot subscription
- (Pro, Pro+, Business or Enterprise), without an API key. Usage counts against
- your Copilot plan.</p>
-<ol>
- <li>Install the GitHub Copilot CLI on the machine that runs Trilium, for example
- with <code>npm install -g @github/copilot</code>. As with Claude Code, for
- a&nbsp;<a class="reference-link" href="#root/_help_WOcw2SLH6tbX">Server Installation</a>&nbsp;it
- needs to be installed on the server.</li>
- <li>Sign in by running <code>copilot login</code> in a terminal once. If you
- already use GitHub Copilot in another editor on the same machine, that
- login is reused.</li>
- <li>Go to&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>AI / LLM</em> and
- add the GitHub Copilot provider.</li>
-</ol>
-<details class="trilium-collapsible">
- <summary>How Trilium identifies your Copilot CLI binary</summary>
- <p>In this order:</p>
- <ul>
- <li>By looking for a <code>TRILIUM_COPILOT_PATH</code> environment variable
- pointing to the Copilot binary.</li>
- <li>By looking for <code>copilot</code> in your PATH.</li>
- <li>By asking your login shell for its <code>PATH</code>, the same as for Claude
- Code.</li>
- </ul>
-</details>
-<h3>Known limitations</h3>
-<ul>
- <li>The agent can only work with your notes through Trilium's note tools;
- its own file, shell and web tools are blocked for security reasons.</li>
- <li>Images can be attached to the conversation, PDFs cannot. The LLM should
- still be able to read PDF notes and attachments via&nbsp;<a class="reference-link"
- href="#root/_help_TiQbQDgP8L5t">Text Extraction (OCR)</a>&nbsp;when the
- note tools are enabled.</li>
-</ul>
-<h2><span class="tn-icon tn-brand tn-brand-antigravity"></span>&nbsp;Google Antigravity</h2>
-<aside class="admonition note">
- <p>This subscription-based provider is still in beta. It is safe to use (won't
- use additional funds and respects the terms of use), but you might experience
- small issues. Consider&nbsp;<a class="reference-link" href="#root/_help_wy8So3yZZlH9">Reporting issues</a>.</p>
-</aside>
-<p>Google Antigravity gives access to Gemini models using a Google account
- (free, Google AI Pro or Google AI Ultra), without an API key. At the time
- of writing, a free Google account is enough to use it.</p>
-<p>Unlike Claude Code or GitHub Copilot, Google's Antigravity ACP server
- is not part of the CLI so it needs to be installed manually just for Trilium.
- The downloaded archive is around 112-334 MB and the extracted size is around
- 230 MB-2 GB based on the platform.</p>
-<div class="trilium-tabs">
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-windows"></span>&nbsp;Windows</p>
- <div class="trilium-tab-panel">
- <ol>
- <li>Download Google's Antigravity ACP server for your platform. The link is
- shown when adding the provider in&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>AI / LLM</em>.
- Unpack it on the device that runs Trilium.</li>
- <li>Make it findable by Trilium, either:
- <ol>
- <li>by adding the unpacked folder to your PATH, or</li>
- <li>by setting a <code>TRILIUM_ANTIGRAVITY_ACP_PATH</code> environment variable
- pointing to <code>agy_acp_server.exe</code>.</li>
- </ol>
- </li>
- <li>Go to&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→
- AI / LLM and add the&nbsp;<span class="tn-icon tn-brand tn-brand-antigravity"></span> <em>Google Antigravity</em> provider.
- When the list of models is loaded for the first time, the Google sign-in
- page opens in a browser on the machine running Trilium; finish signing
- in there.</li>
- </ol>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-tux"></span>&nbsp;Linux &amp;&nbsp;<span class="tn-icon bx bxl-apple"></span> macOS</p>
- <div
- class="trilium-tab-panel">
- <ol>
- <li>Download Google's Antigravity ACP server for your platform. The link is
- shown when adding the provider in&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>AI / LLM</em>.
- Unpack it on the device that runs Trilium.</li>
- <li>Make it findable by Trilium, either:
- <ol>
- <li>by adding the unpacked folder to your PATH, or</li>
- <li>by setting a <code>TRILIUM_ANTIGRAVITY_ACP_PATH</code> environment variable
- pointing to <code>agy_acp_server.par</code>.</li>
- </ol>
- </li>
- <li>Go to&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→
- AI / LLM and add the&nbsp;<span class="tn-icon tn-brand tn-brand-antigravity"></span> <em>Google Antigravity</em> provider.
- When the list of models is loaded for the first time, the Google sign-in
- page opens in a browser on the machine running Trilium; finish signing
- in there.</li>
- </ol>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title">NixOS</p>
- <div class="trilium-tab-panel">
- <ol>
- <li>
- <p>On NixOS, <code>antigravity-acp</code> package is already available but
- only in <code>nixos-unstable</code> at the time of writing. The easiest method
- to test it out is to use the <code>nix shell</code> with flakes:</p><pre><code class="language-text-x-trilium-auto">NIXPKGS_ALLOW_UNFREE=1 nix shell --impure github:nixos/nixpkgs/nixos-unstable#antigravity-acp
-trilium</code></pre>
- </li>
- <li>
- <p>Go to&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→
- AI / LLM and add the&nbsp;<span class="tn-icon tn-brand tn-brand-antigravity"></span> <em>Google Antigravity</em> provider.
- When the list of models is loaded for the first time, the Google sign-in
- page opens in a browser on the machine running Trilium; finish signing
- in there.</p>
- </li>
- </ol>
- </div>
- </section>
-</div>
-<aside class="admonition note">
- <p>Trilium needs <code>curl</code> to use Google Antigravity. It comes with
- Windows 10 and later, macOS and most Linux distributions.</p>
-</aside>
-<h3>Known limitations</h3>
-<ul>
- <li>The agent can only work with your notes through Trilium's note tools;
- its own file and shell tools are blocked for security reasons.</li>
- <li>The Antigravity ACP server requires authentication via a login link. The
- login link needs to be run on the same device, so it might not be possible
- to set up the provider while using the web version of a Docker installation.&nbsp;<a
- class="reference-link" href="#root/_help_poXkQfguuA0U">Desktop Installation</a>&nbsp;should
- work fine.</li>
- <li>Images can be attached to the conversation, PDFs cannot. The LLM should
- still be able to read PDF notes and attachments via&nbsp;<a class="reference-link"
- href="#root/_help_TiQbQDgP8L5t">Text Extraction (OCR)</a>&nbsp;when the
- note tools are enabled.</li>
- <li>The results of tool calls (e.g. reading a note, writing attributes) are
- not properly displayed because they are not exposed by the ACP server.</li>
-</ul>
-<h2><span class="tn-icon tn-brand tn-brand-codex"></span>&nbsp;OpenAI Codex</h2>
-<aside class="admonition note">
- <p>This subscription-based provider is still in beta. It is safe to use (won't
- use additional funds and respects the terms of use), but you might experience
- small issues. Consider&nbsp;<a class="reference-link" href="#root/_help_wy8So3yZZlH9">Reporting issues</a>.</p>
-</aside>
-<p>OpenAI Codex gives access to the Codex models of your ChatGPT plan (Free,
- Go, Plus, Pro or Business), without an API key. At the time of writing,
- a free ChatGPT account is enough to use it. Usage counts against your plan's
- Codex limits, which are small on the Free plan.</p>
-<div class="trilium-tabs">
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-windows"></span><span class="tn-icon bx bxl-tux"></span><span
- class="tn-icon bx bxl-apple"></span>&nbsp;Most platforms</p>
- <div class="trilium-tab-panel">
- <ol>
- <li>Install the Codex CLI on the machine that runs Trilium, for example with <code>npm install -g @openai/codex</code>.
- As with Claude Code, for a&nbsp;<a class="reference-link" href="#root/_help_WOcw2SLH6tbX">Server Installation</a>&nbsp;it
- needs to be installed on the server. Trilium ships the ACP adapter that
- connects to it, so nothing else is needed.</li>
- <li>Go to&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>AI / LLM</em> and
- add the&nbsp;<span class="tn-icon tn-brand tn-brand-codex"></span> <em>OpenAI Codex</em> provider.
- When the list of models is loaded for the first time, the ChatGPT sign-in
- page opens in a browser on the machine running Trilium; finish signing
- in there.</li>
- </ol>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title">NixOS</p>
- <div class="trilium-tab-panel">
- <ol>
- <li>
- <p>On NixOS, Codex is available as the <code>codex</code> package in nixpkgs.
- The stable channel can lag behind Codex's releases, so a newer version
- can be taken from <code>nixos-unstable</code>:</p><pre><code class="language-text-x-sh">nix shell github:nixos/nixpkgs/nixos-unstable#codex
-trilium</code></pre>
- </li>
- <li>
- <p>Go to&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>AI / LLM</em> and
- add the&nbsp;<span class="tn-icon tn-brand tn-brand-codex"></span> <em>OpenAI Codex</em> provider.
- When the list of models is loaded for the first time, the ChatGPT sign-in
- page opens in a browser on the machine running Trilium; finish signing
- in there.</p>
- </li>
- </ol>
- </div>
- </section>
-</div>
-<p>Trilium keeps its own Codex sign-in and settings, separate from any Codex
- CLI you use in a terminal, so an existing <code>codex login</code> is not
- reused.</p>
-<details class="trilium-collapsible">
- <summary>How Trilium identifies your Codex CLI binary</summary>
- <p>In this order:</p>
- <ul>
- <li>By looking for a <code>TRILIUM_CODEX_PATH</code> environment variable pointing
- to the Codex binary.</li>
- <li>By looking for <code>codex</code> in your PATH.</li>
- <li>By asking your login shell for its <code>PATH</code>, the same as for Claude
- Code.</li>
- </ul>
-</details>
-<aside class="admonition note">
- <p>Trilium needs <code>curl</code> to use OpenAI Codex, the same as for Google
- Antigravity: Trilium checks every tool call Codex makes through it. It
- comes with Windows 10 and later, macOS and most Linux distributions.</p>
-</aside>
-<h3>Known limitations</h3>
-<ul>
- <li>The agent can only work with your notes through Trilium's note tools,
- and search the web when the chat allows it; its own file, shell and other
- tools are blocked for security reasons.</li>
- <li>The ChatGPT sign-in opens in a browser on the device running Trilium,
- so it might not be possible to set up the provider while using the web
- version of a Docker installation.&nbsp;<a class="reference-link" href="#root/_help_poXkQfguuA0U">Desktop Installation</a>&nbsp;should
- work fine.</li>
- <li>Images and SVGs can be attached to the conversation, PDFs cannot. The
- LLM should still be able to read PDF notes and attachments via&nbsp;<a
- class="reference-link" href="#root/_help_TiQbQDgP8L5t">Text Extraction (OCR)</a>&nbsp;when
- the note tools are enabled.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/1_Metrics_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/1_Metrics_image.png
deleted file mode 100644
index 683789547d..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/1_Metrics_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/1_Note Map (Link map, Tree map)_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/1_Note Map (Link map, Tree map)_image.png
deleted file mode 100644
index 6e43f0ae8b..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/1_Note Map (Link map, Tree map)_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/2_Metrics_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/2_Metrics_image.png
deleted file mode 100644
index 08181d9862..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/2_Metrics_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Advanced Showcases.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Advanced Showcases.html
deleted file mode 100644
index 18433a4b36..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Advanced Showcases.html
+++ /dev/null
@@ -1,16 +0,0 @@
-<p>Trilium offers advanced functionality through <a href="#root/_help_CdNpE2pqjmI6">Scripts</a> and <a
- href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>. To illustrate
- these features, we've prepared several showcases available in the <a href="#root/_help_wX4HbRucYSDD">demo notes</a>:</p>
-<ul>
- <li><a href="#root/_help_iRwzGnHPzonm">Relation Map</a>
- </li>
- <li><a href="#root/_help_l0tKav7yLHGF">Day Notes</a>
- </li>
- <li><a href="#root/_help_R7abl2fc6Mxi">Weight Tracker</a>
- </li>
- <li><a href="#root/_help_xYjQUYhpbUEW">Task Manager</a>
- </li>
-</ul>
-<p>It's important to note that these examples are not natively supported
- by Trilium out of the box; instead, they demonstrate what you can build
- within Trilium.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Advanced Showcases/Day Notes.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Advanced Showcases/Day Notes.html
deleted file mode 100644
index 2ad9f754cb..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Advanced Showcases/Day Notes.html
+++ /dev/null
@@ -1,156 +0,0 @@
-<p>A common pattern in note-taking is that a lot of notes will be centered
- around a certain date - e.g. you have some tasks which needs to be done
- on a certain date, you have meeting minutes from a certain date, you have
- your thoughts etc. and it all revolves around a date on which they occurred.
- For this reason, it makes sense to create a certain "day workspace" which
- will centralize all those notes relevant for a certain date.</p>
-<p>For this, Trilium provides a concept of "day note". Trilium semi-automatically
- generates a single note for each day. Under this note you can save all
- those relevant notes.</p>
-<p>Select an existing day note, and the menubar contains a calendar widget.
- Select any day to create a note for that day.&nbsp;</p>
-<p>
- <img src="1_Day Notes_image.png">
-</p>
-<p>This pattern works well also because of <a href="#root/_help_IakOLONlIfGI">Cloning Notes</a> functionality
- - note can appear in multiple places in the note tree, so besides appearing
- under day note, it can also be categorized into other notes.</p>
-<h2>Demo</h2>
-<p>
- <img src="Day Notes_image.png">
-</p>
-<p>You can see the structure of day notes appearing under "Journal" note
- - there's a note for the whole year 2025, under it, you have "03 - March"
- which then contains "09 - Monday". This is our "day note" which contains
- some text in its content and also has some child notes (some of them are
- from <a href="#root/_help_xYjQUYhpbUEW">Task manager</a>).</p>
-<p>You can also notice how this day note has <a href="#root/_help_OFXdgB2nNk1F">promoted attribute</a> "weight"
- where you can track your daily weight. This data is then used in <a href="#root/_help_R7abl2fc6Mxi">Weight tracker</a>.</p>
-<h2>Edited notes</h2>
-<p>When a day note is opened, a collapsible section will appear underneath
- the&nbsp;<a class="reference-link" href="#root/_help_l7pigIGu01K2">Title</a>&nbsp;showing
- the notes edited on that day.</p>
-<h2>Week Note and Quarter Note</h2>
-<p>Week and quarter notes are disabled by default, since it might be too
- much for some people. To enable them, you need to set <code>#enableWeekNote</code> and <code>#enableQuarterNote</code> attributes
- on the root calendar note, which is identified by <code>#calendarRoot</code> label.
- Week note is affected by the first week of year option. Be careful when
- you already have some week notes created, it will not automatically change
- the existing week notes and might lead to some duplicates.</p>
-<h2>Templates</h2>
-<p>Trilium provides <a href="#root/_help_KC1HB96bqqHX">template</a> functionality,
- and it could be used together with day notes.</p>
-<p>You can define one of the following relations on the root of the journal
- (identified by <code>#calendarRoot</code> label):</p>
-<ul>
- <li>yearTemplate</li>
- <li>quarterTemplate (if <code>#enableQuarterNote</code> is set)</li>
- <li>monthTemplate</li>
- <li>weekTemplate (if <code>#enableWeekNote</code> is set)</li>
- <li>dateTemplate</li>
-</ul>
-<p>All of these are relations. When Trilium creates a new note for year or
- month or date, it will take a look at the root and attach a corresponding <code>~template</code> relation
- to the newly created role. Using this, you can e.g. create your daily template
- with e.g. checkboxes for daily routine etc.</p>
-<h3>Migrate from old template usage</h3>
-<p>If you have been using Journal prior to version v0.93.0, the previous
- template pattern likely used was <code>~child:template=</code>.
- <br>To transition to the new system:</p>
-<ol>
- <li>Set up the new template pattern in the Calendar root note.</li>
- <li>Use <a href="#root/_help_ivYnonVFBxbQ">Bulk Actions</a> to remove <code>child:template</code> and <code>child:child:template</code> from
- all notes under the Journal (calendar root).</li>
- <li>Ensure that all old template patterns are fully removed to prevent conflicts
- with the new setup.</li>
-</ol>
-<h2>Naming pattern</h2>
-<p>You can customize the title of generated journal notes by defining a <code>#datePattern</code>, <code>#weekPattern</code>, <code>#monthPattern</code>, <code>#quarterPattern</code> and <code>#yearPattern</code> attribute
- on a root calendar note (identified by <code>#calendarRoot</code> label).
- The naming pattern replacements follow a level-up compatibility - each
- level can use replacements from itself and all levels above it. For example, <code>#monthPattern</code> can
- use month, quarter and year replacements, while <code>#weekPattern</code> can
- use week, month, quarter and year replacements. But it is not possible
- to use week replacements in <code>#monthPattern</code>.</p>
-<h3>Date pattern</h3>
-<p>It's possible to customize the title of generated date notes by defining
- a <code>#datePattern</code> attribute on a root calendar note (identified
- by <code>#calendarRoot</code> label). Following are possible values:</p>
-<ul>
- <li><code>{isoDate}</code> results in an ISO 8061 formatted date (e.g. "2025-03-09"
- for March 9, 2025)</li>
- <li><code>{dateNumber}</code> results in a number like <code>9</code> for the
- 9th day of the month, <code>11</code> for the 11th day of the month</li>
- <li><code>{dateNumberPadded}</code> results in a number like <code>09</code> for
- the 9th day of the month, <code>11</code> for the 11th day of the month</li>
- <li><code>{ordinal}</code> is replaced with the ordinal date (e.g. 1st, 2nd,
- 3rd) etc.</li>
- <li><code>{weekDay}</code> results in the full day name (e.g. <code>Monday</code>)</li>
- <li><code>{weekDay3}</code> is replaced with the first 3 letters of the day,
- e.g. Mon, Tue, etc.</li>
- <li><code>{weekDay2}</code> is replaced with the first 2 letters of the day,
- e.g. Mo, Tu, etc.</li>
-</ul>
-<p>The default is <code>{dateNumberPadded} - {weekDay}</code>
-</p>
-<h3>Week pattern</h3>
-<p>It is also possible to customize the title of generated week notes through
- the <code>#weekPattern</code> attribute on the root calendar note. The options
- are:</p>
-<ul>
- <li><code>{weekNumber}</code> results in a number like <code>9</code> for the
- 9th week of the year, <code>11</code> for the 11th week of the year</li>
- <li><code>{weekNumberPadded}</code> results in a number like <code>09</code> for
- the 9th week of the year, <code>11</code> for the 11th week of the year</li>
- <li><code>{shortWeek}</code> results in a short week string like <code>W9</code> for
- the 9th week of the year, <code>W11</code> for the 11th week of the year</li>
- <li><code>{shortWeek3}</code> results in a short week string like <code>W09</code> for
- the 9th week of the year, <code>W11</code> for the 11th week of the year</li>
-</ul>
-<p>The default is <code>Week {weekNumber}</code>
-</p>
-<h3>Month pattern</h3>
-<p>It is also possible to customize the title of generated month notes through
- the <code>#monthPattern</code> attribute on the root calendar note. The options
- are:</p>
-<ul>
- <li><code>{isoMonth}</code> results in an ISO 8061 formatted month (e.g. "2025-03"
- for March 2025)</li>
- <li><code>{monthNumber}</code> results in a number like <code>9</code> for September,
- and <code>11</code> for November</li>
- <li><code>{monthNumberPadded}</code> results in a number like <code>09</code> for
- September, and <code>11</code> for November</li>
- <li><code>{month}</code> results in the full month name (e.g. <code>September</code> or <code>October</code>)</li>
- <li><code>{shortMonth3}</code> is replaced with the first 3 letters of the
- month, e.g. Jan, Feb, etc.</li>
- <li><code>{shortMonth4}</code> is replaced with the first 4 letters of the
- month, e.g. Sept, Octo, etc.</li>
-</ul>
-<p>The default is <code>{monthNumberPadded} - {month}</code>
-</p>
-<h3>Quarter pattern</h3>
-<p>It is also possible to customize the title of generated quarter notes
- through the <code>#quarterPattern</code> attribute on the root calendar note.
- The options are:</p>
-<ul>
- <li><code>{quarterNumber}</code> results in a number like <code>1</code> for
- the 1st quarter of the year</li>
- <li><code>{shortQuarter}</code> results in a short quarter string like <code>Q1</code> for
- the 1st quarter of the year</li>
-</ul>
-<p>The default is <code>Quarter {quarterNumber}</code>
-</p>
-<h3>Year pattern</h3>
-<p>It is also possible to customize the title of generated year notes through
- the <code>#yearPattern</code> attribute on the root calendar note. The options
- are:</p>
-<ul>
- <li><code>{year}</code> results in the full year (e.g. <code>2025</code>)</li>
-</ul>
-<p>The default is <code>{year}</code>
-</p>
-<h2>Implementation</h2>
-<p>Trilium has some special support for day notes in the form of <a href="https://triliumnext.github.io/Notes/backend_api/BackendScriptApi.html">backend Script API</a> -
- see e.g. getDayNote() function.</p>
-<p>Day (and year, month) notes are created with a label - e.g. <code>#dateNote="2025-03-09"</code> this
- can then be used by other scripts to add new notes to day note etc.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Advanced Showcases/Day Notes_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Advanced Showcases/Day Notes_image.png
deleted file mode 100644
index fd89503ef0..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Advanced Showcases/Day Notes_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Advanced Showcases/Task Manager.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Advanced Showcases/Task Manager.html
deleted file mode 100644
index 83865dad95..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Advanced Showcases/Task Manager.html
+++ /dev/null
@@ -1,62 +0,0 @@
-<p>Task Manager is a <a href="#root/_help_OFXdgB2nNk1F">promoted attributes</a> and <a
- href="#root/_help_CdNpE2pqjmI6">scripts</a>showcase present in the <a href="#root/_help_wX4HbRucYSDD">demo notes</a>.</p>
-<h2>Demo</h2>
-<p>
- <img src="Task Manager_task-manager.png">
-</p>
-<p>Task Manager manages outstanding (TODO) tasks and finished tasks (non-empty
- doneDate attribute). Outstanding tasks are further categorized by location
- and arbitrary tags - whenever you change tag attribute in the task note,
- this task is then automatically moved to appropriate location.</p>
-<p>Task Manager also integrates with <a href="#root/_help_l0tKav7yLHGF">day notes</a> -
- notes are <a href="#root/_help_IakOLONlIfGI">cloned</a> into day note to
- both todoDate note and doneDate note (with <a href="#root/_help_kBrnXNG3Hplm">prefix</a> of
- either "TODO" or "DONE").</p>
-<h2>Implementation</h2>
-<p>New tasks are created in the TODO note which has <code>~child:template</code> <a
- href="#root/_help_zEY4DaJG4YT5">relation</a>(see <a href="#root/_help_bwZpz2ajCEwO">attribute inheritance</a>)
- pointing to the task template.</p>
-<h3>Attributes</h3>
-<p>Task template defines several <a href="#root/_help_OFXdgB2nNk1F">promoted attributes</a> -
- todoDate, doneDate, tags, location. Importantly it also defines <code>~runOnAttributeChange</code> relation
- - <a href="#root/_help_GPERMystNGTB">event</a> handler which is run on attribute
- change. This <a href="#root/_help_CdNpE2pqjmI6">script</a> handles when e.g.
- we fill out the doneDate attribute - meaning the task is done and should
- be moved to "Done" note and removed from TODO, locations and tags.</p>
-<h3>New task button</h3>
-<p>There's also "button" note which contains simple script which adds a button
- to create new note (task) in the TODO note.</p><pre><code class="language-text-x-trilium-auto">api.addButtonToToolbar({
- title: 'New task',
- icon: 'check',
- shortcut: 'alt+n',
- action: async () =&gt; {
- // creating notes is backend (server) responsibility so we need to pass
- // the control there
- const taskNoteId = await api.runOnBackend(async () =&gt; {
- const todoRootNote = await api.getNoteWithLabel('taskTodoRoot');
- const {note} = await api.createNote(todoRootNote.noteId, 'new task', '');
-
- return note.noteId;
- });
-
- // we got an ID of newly created note and we want to immediatelly display it
- await api.activateNewNote(taskNoteId);
- }
-});</code></pre>
-<h3>CSS</h3>
-<p>In the demo screenshot above you may notice that TODO tasks are in red
- color and DONE tasks are green.</p>
-<p>This is done by having this CSS <a href="#root/_help_6f9hih2hXXZk">code note</a> which
- defines extra CSS classes:</p><pre><code class="language-text-x-trilium-auto">span.fancytree-node.todo .fancytree-title {
- color: red !important;
-}
-
-span.fancytree-node.done .fancytree-title {
- color: green !important;
-}</code></pre>
-<p>This <a href="#root/_help_6f9hih2hXXZk">code note</a> has <code>#appCss</code> <a
- href="#root/_help_zEY4DaJG4YT5">label</a>which is recognized by Trilium
- on startup and loaded as CSS into the application.</p>
-<p>Second part of this functionality is based in event handler described
- above which assigns <code>#cssClass</code> label to the task to either "done"
- or "todo" based on the task status.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Advanced Showcases/Task Manager_task-manager.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Advanced Showcases/Task Manager_task-manager.png
deleted file mode 100644
index f2c5c9f8c8..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Advanced Showcases/Task Manager_task-manager.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Advanced Showcases/Weight Tracker.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Advanced Showcases/Weight Tracker.html
deleted file mode 100644
index cfe539d0d6..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Advanced Showcases/Weight Tracker.html
+++ /dev/null
@@ -1,72 +0,0 @@
-<p>
- <img src="Weight Tracker_image.png">
-</p>
-<p>The <code>Weight Tracker</code> is a <a href="#root/_help_GLks18SNjxmC">Script API</a> showcase
- present in the <a href="#root/_help_wX4HbRucYSDD">demo notes</a>.</p>
-<p>By adding <code>weight</code> as a <a href="#root/_help_OFXdgB2nNk1F">promoted attribute</a> in
- the <a href="#root/_help_KC1HB96bqqHX">template</a> from which <a href="#root/_help_l0tKav7yLHGF">day notes</a> are
- created, you can aggregate the data and plot weight change over time.</p>
-<h2>Implementation</h2>
-<p>The <code>Weight Tracker</code> note in the screenshot above is of the type <code>Render Note</code>.
- That type of note doesn't have any useful content itself. Instead it is
- a placeholder where a <a href="#root/_help_CdNpE2pqjmI6">script</a> can render
- its output.</p>
-<p>Scripts for <code>Render Notes</code> are defined in a <a href="#root/_help_zEY4DaJG4YT5">relation</a> called <code>~renderNote</code>.
- In this example, it's the <code>Weight Tracker</code>'s child <code>Implementation</code>.
- The Implementation consists of two <a href="#root/_help_6f9hih2hXXZk">code notes</a> that
- contain some HTML and JavaScript respectively, which load all the notes
- with a <code>weight</code> attribute and display their values in a chart.</p>
-<p>To actually render the chart, we're using a third party library called <a
- href="https://www.chartjs.org/">chart.js</a>which is imported as an attachment,
- since it's not built into Trilium.</p>
-<h3>Code</h3>
-<p>Here's the content of the script which is placed in a <a href="#root/_help_6f9hih2hXXZk">code note</a> of
- type <code>JS Frontend</code>:</p><pre><code class="language-text-x-trilium-auto">async function getChartData() {
- const days = await api.runOnBackend(async () =&gt; {
- const notes = api.getNotesWithLabel('weight');
- const days = [];
-
- for (const note of notes) {
- const date = note.getLabelValue('dateNote');
- const weight = parseFloat(note.getLabelValue('weight'));
-
- if (date &amp;&amp; weight) {
- days.push({ date, weight });
- }
- }
-
- days.sort((a, b) =&gt; a.date &gt; b.date ? 1 : -1);
-
- return days;
- });
-
- const datasets = [
- {
- label: "Weight (kg)",
- backgroundColor: 'red',
- borderColor: 'red',
- data: days.map(day =&gt; day.weight),
- fill: false,
- spanGaps: true,
- datalabels: {
- display: false
- }
- }
- ];
-
- return {
- datasets: datasets,
- labels: days.map(day =&gt; day.date)
- };
-}
-
-const ctx = $("#canvas")[0].getContext("2d");
-
-new chartjs.Chart(ctx, {
- type: 'line',
- data: await getChartData()
-});</code></pre>
-<h2>How to remove the Weight Tracker button from the top bar</h2>
-<p>In the link map of the <code>Weight Tracker</code>, there is a note called <code>Button</code>.
- Open it and delete or comment out its contents. The <code>Weight Tracker</code> button
- will disappear after you restart Trilium.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes.html
deleted file mode 100644
index c8c7d58640..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes.html
+++ /dev/null
@@ -1,76 +0,0 @@
-<figure class="image">
- <img style="aspect-ratio:1071/146;" src="Attributes_image.png" width="1071"
- height="146">
-</figure>
-<p>In Trilium, attributes are key-value pairs assigned to notes, providing
- additional metadata or functionality. There are two primary types of attributes:</p>
-<ol>
- <li>
- <p><a class="reference-link" href="#root/_help_HI6GBBIduIgv">Labels</a>&nbsp;can
- be used for a variety of purposes, such as storing metadata or configuring
- the behavior of notes. Labels are also searchable, enhancing note retrieval.</p>
- <p>For more information, including predefined labels, see&nbsp;<a class="reference-link"
- href="#root/_help_HI6GBBIduIgv">Labels</a>.</p>
- </li>
- <li>
- <p><a class="reference-link" href="#root/_help_Cq5X6iKQop6R">Relations</a>&nbsp;define
- connections between notes, similar to links. These can be used for metadata
- and scripting purposes.</p>
- <p>For more information, including a list of predefined relations, see&nbsp;<a
- class="reference-link" href="#root/_help_Cq5X6iKQop6R">Relations</a>.</p>
- </li>
-</ol>
-<p>These attributes play a crucial role in organizing, categorizing, and
- enhancing the functionality of notes.</p>
-<h2>Types of attributes</h2>
-<p>Conceptually there are two types of attributes (applying to both labels
- and relations):</p>
-<ol>
- <li><strong>System attributes</strong>
- <br>As the name suggest, these attributes have a special meaning since they
- are interpreted by Trilium. For example the <code>color</code> attribute
- will change the color of the note as displayed in the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;and links, and <code>iconClass</code> will
- change the icon of a note.</li>
- <li><strong>User-defined attributes</strong>
- <br>These are free-form labels or relations that can be used by the user.
- They can be used purely for categorization purposes (especially if combined
- with&nbsp;<a class="reference-link" href="#root/_help_eIg8jdvaoNNd">Search</a>),
- or they can be given meaning through the use of&nbsp;<a class="reference-link"
- href="#root/_help_CdNpE2pqjmI6">Scripting</a>.</li>
-</ol>
-<p>In practice, Trilium makes no direct distinction of whether an attribute
- is a system one or a user-defined one. A label or relation is considered
- a system attribute if it matches one of the built-in names (e.g. like the
- aforementioned <code>iconClass</code>). Keep this in mind when creating
- &nbsp;<a class="reference-link" href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;in
- order not to accidentally alter a system attribute (unless intended).</p>
-<h2>Viewing the list of attributes</h2>
-<p>Both the labels and relations for the current note are displayed in:</p>
-<ul>
- <li>The&nbsp;<a class="reference-link" href="#root/_help_RnaPdbciOfeq">Right Sidebar</a>,
- in the&nbsp;<a class="reference-link" href="#root/_help_uNtgN0cUKEBc">Attributes tab</a>&nbsp;with
- a grid-like view.</li>
- <li>A more advanced option, in&nbsp;<a class="reference-link" href="#root/_help_AlJ73vBCjWDw">Status bar</a>&nbsp;→&nbsp;<span
- class="tn-icon bx bx-list-check"></span> (<em>Attributes</em>) where the
- attributes are displayed in a textual way, making it easy to copy them
- around or make batch modifications.
- <ul>
- <li>In the list of attributes, labels are prefixed with the <code>#</code> character
- whereas relations are prefixed with the <code>~</code> character.</li>
- </ul>
- </li>
-</ul>
-<h2>Attribute Definitions and Promoted Attributes</h2>
-<p><a class="reference-link" href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;create
- a form-like editing experience for attributes, which makes it easy to enhancing
- the organization and management of attributes</p>
-<h2>Multiplicity</h2>
-<p>Attributes in Trilium can be "multi-valued", meaning multiple attributes
- with the same name can co-exist. This can be combined with&nbsp;<a class="reference-link"
- href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;to easily
- add them.</p>
-<h2>Attribute Inheritance</h2>
-<p>Trilium supports attribute inheritance, allowing child notes to inherit
- attributes from their parents. For more information, see&nbsp;<a class="reference-link"
- href="#root/_help_bwZpz2ajCEwO">Attribute Inheritance</a>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes/1_Promoted Attributes_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes/1_Promoted Attributes_image.png
deleted file mode 100644
index c7510ca73b..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes/1_Promoted Attributes_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes/2_Promoted Attributes_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes/2_Promoted Attributes_image.png
deleted file mode 100644
index 73d6b7e168..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes/2_Promoted Attributes_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes/3_Promoted Attributes_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes/3_Promoted Attributes_image.png
deleted file mode 100644
index f71526395d..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes/3_Promoted Attributes_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes/Attribute Inheritance.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes/Attribute Inheritance.html
deleted file mode 100644
index a78552bb51..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes/Attribute Inheritance.html
+++ /dev/null
@@ -1,50 +0,0 @@
-<p>Inheritance refers to the process of having a <a href="#root/_help_HI6GBBIduIgv">label</a> or
- a <a href="#root/_help_Cq5X6iKQop6R">relation</a> shared across multiple
- notes, generally in parent-child relations (or anywhere if using templates).</p>
-<h2>Standard Inheritance</h2>
-<p>In Trilium, attributes can be automatically inherited by child notes if
- they have the <code>isInheritable</code> flag set to <code>true</code>. This
- means the attribute (a key-value pair) is applied to the note and all its
- descendants.</p>
-<p>To make an attribute inheritable, simply use the visual editor for&nbsp;<a
- class="reference-link" href="#root/_help_HI6GBBIduIgv">Labels</a>&nbsp;or&nbsp;<a
- class="reference-link" href="#root/_help_Cq5X6iKQop6R">Relations</a>. Alternatively,
- the attribute can be manually defined where <code>#myLabel=value</code> becomes <code>#myLabel(inheritable)=value</code> when
- inheritable.</p>
-<p>As an example, the <code>archived</code> label can be set to be inheritable,
- allowing you to hide a whole subtree of notes from searches and other dialogs
- by applying this label at the top level.</p>
-<p>Standard inheritance forces all the notes that are children (and sub-children)
- of a note to have that particular label or relation. If there is a need
- to have some notes not inherit one of the labels, then <em>copying inheritance</em> or <em>template inheritance</em> needs
- to be used instead.</p>
-<h2>Copying Inheritance</h2>
-<p>Copying inheritance differs from standard inheritance by using a <code>child:</code> prefix
- in the attribute name. This prefix causes new child notes to automatically
- receive specific attributes from the parent note. These attributes are
- independent of the parent and will persist even if the note is moved elsewhere.</p>
-<p>If a parent note has the label <code>#child:exampleAttribute</code>, all
- newly created child notes (one level deep) will inherit the <code>#exampleAttribute</code> label.
- This can be useful for setting default properties for notes in a specific
- section.</p>
-<p>Similarly, for relations use <code>~child:myRelation</code>.</p>
-<p>Due to the way it's designed, copying inheritance cannot be used to cascade
- infinitely within a hierarchy. For that use case, consider using either
- standard inheritance or templates.</p>
-<h3>Chained inheritance</h3>
-<p>It is possible to define labels across multiple levels of depth. For example, <code>#child:child:child:foo</code> applied
- to a root note would create:</p>
-<ul>
- <li><code>#child:child:foo</code> on the first-level children.</li>
- <li><code>#child:foo</code> on the second-level children.</li>
- <li><code>#foo</code> on the third-level children.</li>
-</ul>
-<p>Similarly, use <code>~child:child:child:foo</code> if dealing with relations.</p>
-<p>Do note that same as simple copying inheritance, the changes will not
- apply retroactively to existing notes in the hierarchy, it will only apply
- to the newly created notes.</p>
-<h2>Template Inheritance</h2>
-<p>Attributes can also be inherited from&nbsp;<a class="reference-link" href="#root/_help_KC1HB96bqqHX">Templates</a>.
- When a new note is created using a template, it inherits the attributes
- defined in that template. This is particularly useful for maintaining consistency
- across notes that follow a similar structure or function.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes/Labels.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes/Labels.html
deleted file mode 100644
index 7dfdf5cab5..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes/Labels.html
+++ /dev/null
@@ -1,419 +0,0 @@
-<p>A label is an <a href="#root/_help_zEY4DaJG4YT5">attribute</a> of a note
- which has a name and optionally a value.</p>
-<h2>Common use cases</h2>
-<ul>
- <li><strong>Metadata for personal use</strong>: Assign labels with optional
- values for categorization, such as <code>#year=1999</code>, <code>#genre="sci-fi"</code>,
- or <code>#author="Neal Stephenson"</code>. This can be combined with&nbsp;<a
- class="reference-link" href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;to
- make their display more user-friendly.</li>
- <li><strong>Configuration</strong>: Labels can configure advanced features
- or settings (see reference below).</li>
- <li><strong>Scripts and Plugins</strong>: Used to tag notes with special metadata,
- such as the "weight" attribute in the&nbsp;<a class="reference-link" href="#root/_help_R7abl2fc6Mxi">Weight Tracker</a>.</li>
-</ul>
-<h2>Creating a label using the visual editor</h2>
-<ol>
- <li>Go to the&nbsp;<a class="reference-link" href="#root/_help_uNtgN0cUKEBc">Attributes tab</a>&nbsp;in
- the&nbsp;<a class="reference-link" href="#root/_help_RnaPdbciOfeq">Right Sidebar</a>.</li>
- <li>Press the&nbsp;<span class="tn-icon bx bx-plus"></span> (Add attribute)
- button at the end of the list, or via the&nbsp;<span class="tn-icon bx bx-plus"></span> button
- at the top-right of the section → <em>Add new label</em>.</li>
-</ol>
-<p>While in the visual editor:</p>
-<ul>
- <li>Set the desired name.</li>
- <li>Optionally, set the value of the label. Labels can exist without a value.</li>
- <li>Children can inherit this relation, click the relation and check <em>Inheritable</em>.
- See&nbsp;<a class="reference-link" href="#root/_help_bwZpz2ajCEwO">Attribute Inheritance</a>&nbsp;for
- more information.</li>
-</ul>
-<aside class="admonition tip">
- <p>Alternatively, press <kbd>Alt</kbd>+<kbd>L</kbd> which will open the attribute
- details (same view as when an existing attribute is clicked) in the&nbsp;<a
- class="reference-link" href="#root/_help_AlJ73vBCjWDw">Status bar</a>.</p>
-</aside>
-<h2>Creating a label manually</h2>
-<p>In the&nbsp;<a class="reference-link" href="#root/_help_AlJ73vBCjWDw">Status bar</a>,
- press the&nbsp;<span class="tn-icon bx bx-list-check"></span> button to
- show the list of the attributes.</p>
-<ul>
- <li>Click the input box to focus it.</li>
- <li>To create a label called <code>myLabel</code> with no value, simply type <code>#myLabel</code>.</li>
- <li>To create a label called <code>myLabel</code> with a value <code>value</code>,
- simply type <code>#myLabel=value</code>.</li>
- <li>If the value contains spaces, then the text must be quoted: <code>#myLabel="Hello world"</code>.</li>
- <li>If the string contains quotes (regardless of whether it has spaces), then
- the text must be quoted with apostrophes instead: <code>#myLabel='Hello "world"'</code>.</li>
- <li>To create an inheritable label called <code>myLabel</code>, simply write <code>#myLabel(inheritable)</code> for
- no value or <code>#myLabel(inheritable)=value</code> if there is a value.</li>
-</ul>
-<h2>Predefined labels</h2>
-<p>This is a list of labels that Trilium natively supports.</p>
-<aside class="admonition tip">
- <p>Some labels presented here end with a <code>*</code>. That means that there
- are multiple labels with the same prefix, consult the specific page linked
- in the description of that label for more information.</p>
-</aside>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Label</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>disableVersioning</code>
- </td>
- <td>Disables automatic creation of&nbsp;<a class="reference-link" href="#root/_help_vZWERwf8U3nx">Note Revisions</a>&nbsp;for
- a particular note. Useful for e.g. large, but unimportant notes - e.g.
- large JS libraries used for scripting.</td>
- </tr>
- <tr>
- <td><code>versioningLimit</code>
- </td>
- <td>Limits the maximum number of&nbsp;<a class="reference-link" href="#root/_help_vZWERwf8U3nx">Note Revisions</a>&nbsp;for
- a particular note, overriding the global settings.</td>
- </tr>
- <tr>
- <td><code>calendarRoot</code>
- </td>
- <td>Marks the note which should be used as root for&nbsp;<a class="reference-link"
- href="#root/_help_l0tKav7yLHGF">Day Notes</a>. Only one should be marked
- as such.</td>
- </tr>
- <tr>
- <td><code>archived</code>
- </td>
- <td>Hides notes from default search results and dialogs. Archived notes can
- optionally be hidden in the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>.</td>
- </tr>
- <tr>
- <td><code>excludeFromExport</code>
- </td>
- <td>Excludes this note and its children when exporting.</td>
- </tr>
- <tr>
- <td><code>run</code>, <code>runOnInstance</code>, <code>runAtHour</code>
- </td>
- <td>See&nbsp;<a class="reference-link" href="#root/_help_GPERMystNGTB">Backend Events</a>.</td>
- </tr>
- <tr>
- <td><code>disableInclusion</code>
- </td>
- <td>Scripts with this label won't be included into parent script execution.</td>
- </tr>
- <tr>
- <td><code>sorted</code>, <code>sortDirection</code>, <code>sortFoldersFirst</code>, <code>sortNatural</code>, <code>sortLocale</code>, <code>top</code>, <code>bottom</code>
- </td>
- <td>Manages automatic/permanent sorting. See&nbsp;<a class="reference-link"
- href="#root/_help_aGlEvb9hyDhS">Sorting Notes</a>.</td>
- </tr>
- <tr>
- <td><code>hidePromotedAttributes</code>
- </td>
- <td>Hide&nbsp;<a class="reference-link" href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;on
- this note. Generally useful when defining inherited attributes, but the
- parent note doesn't need them.</td>
- </tr>
- <tr>
- <td><code>readOnly</code>
- </td>
- <td>Marks a note to always be <a href="#root/_help_CoFPLs3dRlXc">read-only</a>,
- if it's a supported note (text, code, mermaid).</td>
- </tr>
- <tr>
- <td><code>autoReadOnlyDisabled</code>
- </td>
- <td>Disables automatic <a href="#root/_help_CoFPLs3dRlXc">read-only mode</a> for
- the given note.</td>
- </tr>
- <tr>
- <td><code>appCss</code>
- </td>
- <td>Marks CSS notes which are loaded into the Trilium application and can
- thus be used to modify Trilium's looks. See&nbsp;<a class="reference-link"
- href="#root/_help_AlhDUqhENtH7">Custom app-wide CSS</a>&nbsp;for more info.</td>
- </tr>
- <tr>
- <td><code>appTheme</code>
- </td>
- <td>Marks CSS notes which are full Trilium themes and are thus available in
- Trilium options. See&nbsp;<a class="reference-link" href="#root/_help_pKK96zzmvBGf">Theme development</a>&nbsp;for
- more information.</td>
- </tr>
- <tr>
- <td><code>appThemeBase</code>
- </td>
- <td>Set to <code>next</code>, <code>next-light</code>, or <code>next-dark</code> to
- use the corresponding TriliumNext theme (auto, light or dark) as the base
- for a custom theme, instead of the legacy one. See&nbsp;<a class="reference-link"
- href="#root/_help_WFGzWeUK6arS">Customize the Next theme</a>&nbsp;for more
- information.</td>
- </tr>
- <tr>
- <td><code>customFont</code>
- </td>
- <td>Marks a font as selectable in the Options → Appearance font selection.
- See&nbsp;<a class="reference-link" href="#root/_help_w4rMEhJsALlA">Personalizing the font</a>.</td>
- </tr>
- <tr>
- <td><code>cssClass</code>
- </td>
- <td>Value of this label is then added as CSS class to the node representing
- given note in the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>.
- This can be useful for advanced theming. Can be used in template notes.</td>
- </tr>
- <tr>
- <td><code>iconClass</code>
- </td>
- <td>value of this label is added as a CSS class to the icon on the tree which
- can help visually distinguish the notes in the tree. Example might be bx
- bx-home - icons are taken from boxicons. Can be used in template notes.</td>
- </tr>
- <tr>
- <td><code>pageSize</code>
- </td>
- <td>Specifies the number of items per page in&nbsp;<a class="reference-link"
- href="#root/_help_0ESUbbAxVnoK">Note List</a>.</td>
- </tr>
- <tr>
- <td><code>customRequestHandler</code>
- </td>
- <td>See&nbsp;<a class="reference-link" href="#root/_help_J5Ex1ZrMbyJ6">Custom Request Handler</a>.</td>
- </tr>
- <tr>
- <td><code>customResourceProvider</code>
- </td>
- <td>See&nbsp;<a class="reference-link" href="#root/_help_d3fAXQ2diepH">Custom Resource Providers</a>.</td>
- </tr>
- <tr>
- <td><code>widget</code>
- </td>
- <td>Marks this note as a custom widget which will be added to the Trilium
- component tree. See&nbsp;<a class="reference-link" href="#root/_help_MgibgPcfeuGz">Custom Widgets</a>&nbsp;for
- more information.</td>
- </tr>
- <tr>
- <td><code>searchHome</code>
- </td>
- <td>New search notes will be created as children of this note (see&nbsp;<a
- class="reference-link" href="#root/_help_m523cpzocqaD">Saved Search</a>).</td>
- </tr>
- <tr>
- <td><code>workspace</code> and related attributes</td>
- <td>See&nbsp;<a class="reference-link" href="#root/_help_9sRHySam5fXb">Workspaces</a>.</td>
- </tr>
- <tr>
- <td><code>inbox</code>
- </td>
- <td>Default inbox location for new notes. See&nbsp;<a class="reference-link"
- href="#root/_help_S0Fos78ZfcY7">Note Inbox</a>&nbsp;for more information.</td>
- </tr>
- <tr>
- <td><code>sqlConsoleHome</code>
- </td>
- <td>Default location of&nbsp;<a class="reference-link" href="#root/_help_YKWqdJhzi2VY">SQL Console</a>&nbsp;saved
- queries.</td>
- </tr>
- <tr>
- <td><code>bookmarked</code>
- </td>
- <td>Indicates this note is a <a href="#root/_help_u3YFHC9tQlpm">bookmark</a>.</td>
- </tr>
- <tr>
- <td><code>bookmarkFolder</code>
- </td>
- <td>Note with this label will appear in bookmarks as folder (allowing access
- to its children). See&nbsp;<a class="reference-link" href="#root/_help_u3YFHC9tQlpm">Bookmarks</a>&nbsp;for
- more information.</td>
- </tr>
- <tr>
- <td><code>share*</code>
- </td>
- <td>See the attribute reference in&nbsp;<a class="reference-link" href="#root/_help_R9pX4DGra2Vt">Sharing</a>.</td>
- </tr>
- <tr>
- <td><code>displayRelations</code>, <code>hideRelations</code>
- </td>
- <td>Comma delimited names of relations which should be displayed/hidden in
- a&nbsp;<a class="reference-link" href="#root/_help_iRwzGnHPzonm">Relation Map</a>&nbsp;(both
- the note type and the&nbsp;<a class="reference-link" href="#root/_help_BCkXAVs63Ttv">Note Map (Link map, Tree map)</a>&nbsp;general
- functionality).</td>
- </tr>
- <tr>
- <td><code>titleTemplate</code>
- </td>
- <td>Default title of notes created as children of this note. This value is
- evaluated as a JavaScript string and thus can be enriched with dynamic
- content via the injected <code>now</code> and <code>parentNote</code> variables.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
- <br>
- <br>See&nbsp;<a class="reference-link" href="#root/_help_47ZrP6FNuoG8">Default Note Title</a>&nbsp;for
- more info.</td>
- </tr>
- <tr>
- <td><code>template</code>
- </td>
- <td>This note will appear in the selection of available template when creating
- new note. See&nbsp;<a class="reference-link" href="#root/_help_KC1HB96bqqHX">Templates</a>&nbsp;for
- more information.</td>
- </tr>
- <tr>
- <td><code>color</code>
- </td>
- <td>defines color of the note in note tree, links etc. Use any valid CSS color
- value like 'red' or #a13d5f&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
- <br>Note: this color may be automatically adjusted when displayed to ensure
- sufficient contrast with the background.</td>
- </tr>
- <tr>
- <td><code>keyboardShortcut</code>
- </td>
- <td>Defines a keyboard shortcut which will immediately jump to this note.
- Example: 'ctrl+alt+e'. Requires frontend reload for the change to take
- effect.</td>
- </tr>
- <tr>
- <td><code>keepCurrentHoisting</code>
- </td>
- <td>Opening this link won't change hoisting even if the note is not displayable
- in the current hoisted subtree.</td>
- </tr>
- <tr>
- <td><code>executeButton</code>
- </td>
- <td>Title of the button which will execute the current code note</td>
- </tr>
- <tr>
- <td><code>executeDescription</code>
- </td>
- <td>Longer description of the current code note displayed together with the
- execute button</td>
- </tr>
- <tr>
- <td><code>excludeFromNoteMap</code>
- </td>
- <td>Notes with this label will be hidden from the&nbsp;<a class="reference-link"
- href="#root/_help_bdUJEHsAPYQR">Note Map</a>.</td>
- </tr>
- <tr>
- <td><code>newNotesOnTop</code>
- </td>
- <td>New notes will be created at the top of the parent note, not on the bottom.</td>
- </tr>
- <tr>
- <td><code>hideChildrenOverview</code>
- </td>
- <td>Hides the&nbsp;<a class="reference-link" href="#root/_help_0ESUbbAxVnoK">Note List</a>&nbsp;for
- that particular note.</td>
- </tr>
- <tr>
- <td><code>subtreeHidden</code>
- </td>
- <td>Hides all child notes of this note from the tree, displaying a badge with
- the count of hidden children. Children remain accessible via search or
- direct links.</td>
- </tr>
- <tr>
- <td><code>printLandscape</code>
- </td>
- <td>When exporting to PDF, changes the orientation of the page to landscape
- instead of portrait.</td>
- </tr>
- <tr>
- <td><code>printPageSize</code>
- </td>
- <td>When exporting to PDF, changes the size of the page. Supported values: <code>A0</code>, <code>A1</code>, <code>A2</code>, <code>A3</code>, <code>A4</code>, <code>A5</code>, <code>A6</code>, <code>Legal</code>, <code>Letter</code>, <code>Tabloid</code>, <code>Ledger</code>.</td>
- </tr>
- <tr>
- <td><code>printScale</code>, <code>printMargins</code>
- </td>
- <td>Additional printing options, generally configured through the&nbsp;<a
- class="reference-link" href="#root/_help_NRnIZmSMc5sj">Printing &amp; Exporting as PDF</a>&nbsp;dialog.</td>
- </tr>
- <tr>
- <td><code>geolocation</code>
- </td>
- <td>Indicates the latitude and longitude of a note, to be displayed in a&nbsp;<a
- class="reference-link" href="#root/_help_81SGnPGMk7Xc">Geo Map</a>.</td>
- </tr>
- <tr>
- <td><code>geoShape</code>
- </td>
- <td>Indicates the coordinates for the points of a <a href="#root/_help_C2H9HK4BzwG7">shapec</a> drawn
- on the&nbsp;<a class="reference-link" href="#root/_help_81SGnPGMk7Xc">Geo Map</a>&nbsp;(e.g.
- area, rectangle, circle).</td>
- </tr>
- <tr>
- <td><code>map:*</code>
- </td>
- <td>Defines specific options for the&nbsp;<a class="reference-link" href="#root/_help_81SGnPGMk7Xc">Geo Map</a>.</td>
- </tr>
- <tr>
- <td><code>calendar:*</code>
- </td>
- <td>Defines specific options for the&nbsp;<a class="reference-link" href="#root/_help_xWbu3jpNWapp">Calendar</a>.</td>
- </tr>
- <tr>
- <td><code>viewType</code>
- </td>
- <td>Sets the view of child notes (e.g. grid or list). See&nbsp;<a class="reference-link"
- href="#root/_help_0ESUbbAxVnoK">Note List</a>&nbsp;for more information.</td>
- </tr>
- <tr>
- <td><code>webViewSrc</code>
- </td>
- <td>Defines the URL of the&nbsp;<a class="reference-link" href="#root/_help_1vHRoWCEjj0L">Web View</a>.</td>
- </tr>
- <tr>
- <td><code>tabWidth</code>, <code>indentWithTabs</code>, <code>wrapLines</code>
- </td>
- <td>Per-note Code editor settings: indentation width, indent with tabs vs.
- spaces, and word wrapping. See&nbsp;<a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>.</td>
- </tr>
- <tr>
- <td><code>datePattern</code>, <code>weekPattern</code>, <code>monthPattern</code>, <code>quarterPattern</code>, <code>yearPattern</code>
- </td>
- <td>Customizes the title naming pattern of day / week / month / quarter /
- year notes. See&nbsp;<a class="reference-link" href="#root/_help_l0tKav7yLHGF">Day Notes</a>.</td>
- </tr>
- <tr>
- <td><code>enableWeekNote</code>, <code>enableQuarterNote</code>
- </td>
- <td>Enables optional week and quarter notes in the calendar hierarchy; set
- on the calendar root. See&nbsp;<a class="reference-link" href="#root/_help_l0tKav7yLHGF">Day Notes</a>.</td>
- </tr>
- <tr>
- <td><code>fullContentWidth</code>
- </td>
- <td>Expands the note to the full editor width, ignoring the configured content
- width (useful for wide tables). See&nbsp;<a class="reference-link" href="#root/_help_t596jLvPrqkS">Content width</a>.</td>
- </tr>
- <tr>
- <td><code>iconPack</code>
- </td>
- <td>Identifies a custom icon pack by its prefix. See&nbsp;<a class="reference-link"
- href="#root/_help_g1mlRoU8CsqC">Creating an icon pack</a>.</td>
- </tr>
- <tr>
- <td><code>clipperInbox</code>
- </td>
- <td>Overrides the default location where the Web Clipper saves clippings (defaults
- to the day note). See&nbsp;<a class="reference-link" href="#root/_help_MtPxeAWVAzMg">Web Clipper</a>.</td>
- </tr>
- <tr>
- <td><code>docName</code> , <code>docUrl</code>
- </td>
- <td>Used internally for the in-app help.</td>
- </tr>
- <tr>
- <td><code>aiQuickAction</code>
- </td>
- <td>Defines a custom prompt to be used for the&nbsp;<a class="reference-link"
- href="#root/_help_VRoP0g1uHHc2">In-editor AI assistant</a>'s quick actions.</td>
- </tr>
- </tbody>
- </table>
-</figure>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes/Promoted Attributes.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes/Promoted Attributes.html
deleted file mode 100644
index 2b5f462a6e..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes/Promoted Attributes.html
+++ /dev/null
@@ -1,212 +0,0 @@
-<figure class="image image_resized" style="width:61.4%;">
- <img style="aspect-ratio:938/368;" src="Promoted Attributes_image.png"
- width="938" height="368">
-</figure>
-<p>Promoted attributes are <a href="#root/_help_zEY4DaJG4YT5">attributes</a> which
- are displayed prominently in the UI which allow them to be easily viewed
- and edited.</p>
-<p>The promoted attributes are shown underneath the&nbsp;<a class="reference-link"
- href="#root/_help_l7pigIGu01K2">Title</a>&nbsp;of the note, in a collapsible
- section. For full-height notes such as&nbsp;<a class="reference-link" href="#root/_help_grjYqerjn243">Canvas</a>,
- the promoted attributes are collapsed by default to make room.</p>
-<p>One way of seeing promoted attributes is as a kind of form with several
- fields. Each field is just regular attribute, the only difference is that
- they appear on the note itself.</p>
-<p>Attributes can be pretty useful since they allow for querying and script
- automation etc. but they are also inconveniently hidden. This allows you
- to select few of the important ones and push them to the front of the user.</p>
-<h2>Attribute definition</h2>
-<figure class="image image-style-align-right image_resized" style="width:50%;">
- <img style="aspect-ratio:885/742;" src="2_Promoted Attributes_image.png"
- width="885" height="742">
-</figure>
-<p>In order to have promoted attributes, there needs to be a way to define
- them.</p>
-<p>Technically, attributes are only name-value pairs where both name and
- value are strings.</p>
-<p>The <em>Attribute definition</em> specifies how should this value be interpreted:</p>
-<ul>
- <li>Is it just string, or is it a date?</li>
- <li>Should we allow multiple values or note?</li>
- <li>Should we <em>promote</em> the attribute or not?</li>
-</ul>
-<h2>Types of attributes</h2>
-<p>Attribute definitions have a dedicated type field which will change how
- the value will be edited in the promoted attributes section.</p>
-<p>The following types are supported:</p>
-<ul>
- <li><em>Text</em>, the default option which allows any type of text to be
- edited, similar to normal labels that don't have a type associated.</li>
- <li><em>Multi-line text</em>, similar to a normal text field, but rendered
- in a bigger text box that also supports writing on multiple lines.</li>
- <li><em>Number</em>, will display as a number input field with up/down arrows.
- <ul>
- <li>Optionally a <em>precision</em> which sets how many decimals the value steps
- by and is displayed with.</li>
- </ul>
- </li>
- <li><em>Checkbox</em>, which renders as a checkbox for a true/false value.
- In the label definition, this type is written as <code>boolean</code>.</li>
- <li><em>Select,</em> which provides a list of user-defined options when editing.
- <ul>
- <li>The list is not fixed, meaning that new options can be easily added from
- the promoted attribute.</li>
- <li>Renaming an option does not change the existing values since the value
- is stored as text. Consider a <a href="#root/_help_ivYnonVFBxbQ">bulk rename</a>.</li>
- <li>The items do not have a custom color or icon. This is intentional as selects
- are meant to be light-weight. For a more customizable option, consider
- using&nbsp;<a class="reference-link" href="#root/_help_Cq5X6iKQop6R">Relations</a>&nbsp;instead
- which use notes as items and those notes can be colorized and also carry
- an icon.</li>
- </ul>
- </li>
- <li><em>Date,</em> which provides a date picker.</li>
- <li><em>Date &amp; Time,</em> which provides a date &amp; time picker.</li>
- <li><em>Time,</em> which provides a time picker.</li>
- <li><em>URL,</em> which provides a button to open the web address in a new
- window.</li>
- <li><em>Email</em>, which provides a button to quickly send an email to that
- address using your operating system's default app.</li>
- <li><em>Phone</em>, which provides a button to quickly call that number using
- your operating system's default app.</li>
- <li><em>Color</em>, which provides a color picker and a way to remove the
- value.</li>
- <li><em>Relation</em>, which points to another note and uses&nbsp;<a class="reference-link"
- href="#root/_help_Cq5X6iKQop6R">Relations</a>&nbsp;instead of&nbsp;<a class="reference-link"
- href="#root/_help_HI6GBBIduIgv">Labels</a>.</li>
-</ul>
-<aside class="admonition note">
- <p>For label-based attributes, these types are not enforced by the attribute
- system, meaning that changing the type afterwards does not guarantee that
- the values in it correspond to the type (e.g. turning a text into a number).</p>
-</aside>
-<h2>Multiple values</h2>
-<p>When the definition allows multiple values, each value is shown as a chip
- and a new one is added in the box after them. Press the <span class="tn-icon bx bx-x"></span> on
- a chip to remove that value.</p>
-<ul>
- <li>For free-form types such as <em>Text</em>, <em>Number</em> or <em>Date</em>,
- press <kbd>Enter</kbd> (or leave the field) to add what was typed. The same
- value can be added more than once, for example two payments of the same
- amount.</li>
- <li>For <em>Select</em>, <em>Checkbox</em> and <em>Relation</em> attributes, a
- value is picked from the list rather than typed, and each one can be picked
- only once.</li>
-</ul>
-<h2>Creating a new promoted attribute definition</h2>
-<p>To create a new promoted attribute:</p>
-<ol>
- <li>Go to a note.</li>
- <li>Go to the&nbsp;<a class="reference-link" href="#root/_help_uNtgN0cUKEBc">Attributes tab</a>&nbsp;in
- the&nbsp;<a class="reference-link" href="#root/_help_RnaPdbciOfeq">Right Sidebar</a>.</li>
- <li>Press the&nbsp;<span class="tn-icon bx bx-plus"></span> button for the
- top-most section (<em>Owned attributes</em>).</li>
- <li>Select either <em>Add new label definition…</em> or <em>Add new relation definition…</em>.</li>
- <li>Select the name which will be name of the label or relation that will
- be created when the promoted attribute is edited.</li>
- <li>Ensure <em>Promoted</em> is checked in order to display it at the top of
- notes.</li>
- <li>Optionally, choose an <em>Alias</em> which will be displayed next to the
- promoted attribute instead of the attribute name. Generally it's best to
- choose a “user-friendly” name since it can contain spaces and other characters
- which are not supported as attribute names.</li>
- <li>Check <em>Inheritable</em> to apply it to this note and all its descendants.
- To keep it only for the current note, un-check it.</li>
- <li>Press <em>Save &amp; Close</em> to apply the changes.</li>
-</ol>
-<p>Alternatively, promoted attributes can be created from the&nbsp;<a class="reference-link"
- href="#root/_help_AlJ73vBCjWDw">Status bar</a>&nbsp;by going to&nbsp;<span
- class="tn-icon bx bx-list-check"></span> (<em>Attributes</em>), pressing
- the&nbsp;<span class="tn-icon bx bx-plus"></span> button and selecting <em>Add new label definition…</em>.
- The resulting attribute can also be copy-pasted or written manually (albeit
- discouraged).</p>
-<h2>How attribute definitions actually work</h2>
-<p>When a new promoted attribute definition is created, it creates a corresponding
- label prefixed with either <code>label</code> or <code>relation</code>, depending
- on the definition type:</p><pre><code class="language-text-x-trilium-auto">#label:myColor(inheritable)="promoted,alias=Color,multi,color"</code></pre>
-<p>The only purpose of the attribute definition is to set up a template.
- If the attribute was marked as promoted, then it's also displayed to the
- user for easy editing.</p>
-<figure class="table">
- <table>
- <tbody>
- <tr>
- <td>
- <figure class="image">
- <img style="aspect-ratio:495/157;" src="1_Promoted Attributes_image.png"
- width="495" height="157">
- </figure>
- </td>
- <td>Notice how the promoted attribute definition only creates a “Due date”
- box above the text content.</td>
- </tr>
- <tr>
- <td>
- <figure class="image">
- <img style="aspect-ratio:663/160;" src="3_Promoted Attributes_image.png"
- width="663" height="160">
- </figure>
- </td>
- <td>Once a value is set by the user, a new label (or relation, depending on
- the type) is created. The name of the attribute matches one set when creating
- the promoted attribute.</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<p>So there's one attribute for value and one for definition. But notice
- how an definition attribute can be made <a href="#root/_help_bwZpz2ajCEwO">Inheritable</a>,
- meaning that it's also applied to all descendant notes. In this case, the
- definition used for the whole sub-tree while "value" attributes are for
- each not individually.</p>
-<h2>Using system attributes</h2>
-<p>It's possible to create promoted attributes out of system attributes,
- to be able to easily alter them.</p>
-<p>Here are a few practical examples:</p>
-<ul>
- <li><a class="reference-link" href="#root/_help_GTwFsgaA0lCt">Collections</a>&nbsp;already
- make use of this practice, for example:
- <ul>
- <li>Calendars add “Start Date”, “End Date”, “Start Time” and “End Time” as
- promoted attributes. These map to system attributes such as <code>startDate</code> which
- are then interpreted by the calendar view.</li>
- <li><a class="reference-link" href="#root/_help_zP3PMqaG71Ct">Presentation</a>&nbsp;adds
- a “Background” promoted attribute for each of the slide to easily be able
- to customize.</li>
- </ul>
- </li>
- <li>The Trilium documentation (which is edited in Trilium) uses a promoted
- attribute to be able to easily edit the <code>#shareAlias</code> (see&nbsp;<a
- class="reference-link" href="#root/_help_R9pX4DGra2Vt">Sharing</a>) in
- order to form clean URLs.</li>
- <li>If you always edit a particular system attribute such as <code>#color</code>,
- simply create a promoted attribute for it to make it easier.</li>
-</ul>
-<h3>Inverse relation</h3>
-<p>Some relations always occur in pairs - my favorite example is on the family.
- If you have a note representing husband and note representing wife, then
- there might be a relation between those two of <code>isPartnerOf</code>.
- This is bidirectional relationship - meaning that if a relation is pointing
- from husband to wife then there should be always another relation pointing
- from wife to husband.</p>
-<p>Another example is with parent-child relationship. Again these always
- occur in pairs, but in this case it's not exact same relation - the one
- going from parent to child might be called <code>isParentOf</code> and the
- other one going from child to parent might be called <code>isChildOf</code>.</p>
-<p>Relation definition allows you to specify such "inverse relation" - for
- the relation you just define you specify which is the inverse relation.
- Note that in the second example we should have two relation definitions
- - one for <code>isParentOf</code> which defines <code>isChildOf</code> as inverse
- relation and then second relation definition for <code>isChildOf</code> which
- defines <code>isParentOf</code> as inverse relation.</p>
-<p>What this does internally is that whenever we save a relation which has
- defined inverse relation, we check that this inverse relation exists on
- the relation target note. Similarly, when we delete relation, we also delete
- inverse relation on the target note.</p>
-<h2>See also</h2>
-<ul>
- <li>The&nbsp;<a class="reference-link" href="#root/_help_2FvYrpmOXm29">Table</a>&nbsp;collection
- makes heavy use of promoted attributes to define the columns of the table,
- since they already carry the type information. When made inheritable, it's
- also easy to change those fields when the child notes are opened.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes/Promoted Attributes_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes/Promoted Attributes_image.png
deleted file mode 100644
index 148f98b8af..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes/Promoted Attributes_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes/Relations.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes/Relations.html
deleted file mode 100644
index 93087c02d2..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes/Relations.html
+++ /dev/null
@@ -1,145 +0,0 @@
-<p>A relation is similar to a <a href="#root/_help_HI6GBBIduIgv">label</a>,
- but instead of having a text value it refers to another note.</p>
-<h2>Common use cases</h2>
-<ul>
- <li><strong>Metadata Relationships for personal use</strong>: For example,
- linking a book note to an author note.
- <br>This can be combined with&nbsp;<a class="reference-link" href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;to
- make their display more user-friendly.</li>
- <li><strong>Configuration</strong>: For configuring some notes such as&nbsp;<a
- class="reference-link" href="#root/_help_HcABDtFCkbFN">Render Note</a>,
- or configuring&nbsp;<a class="reference-link" href="#root/_help_R9pX4DGra2Vt">Sharing</a>&nbsp;or&nbsp;<a
- class="reference-link" href="#root/_help_KC1HB96bqqHX">Templates</a>&nbsp;(see
- the list below).</li>
- <li><strong>Scripting</strong>: Attaching scripts to events or conditions
- related to the note.</li>
-</ul>
-<h2>Creating a relation using the visual editor</h2>
-<ol>
- <li>Go to the&nbsp;<a class="reference-link" href="#root/_help_uNtgN0cUKEBc">Attributes tab</a>&nbsp;in
- the&nbsp;<a class="reference-link" href="#root/_help_RnaPdbciOfeq">Right Sidebar</a>.</li>
- <li>Press the&nbsp;<span class="tn-icon bx bx-plus"></span> button (<em>Add a new attribute</em>)
- to the right of the <em>Owned attributes</em> section.</li>
- <li>Select <em>Add new relation</em> for the relation.</li>
-</ol>
-<p>While in the visual editor, set the desired name and the <em>Target note</em> (the
- note to point to). Unlike labels, relations cannot exist with a target
- note.</p>
-<p>Children can inherit this relation, click the relation and check <em>Inheritable</em>.
- See&nbsp;<a class="reference-link" href="#root/_help_bwZpz2ajCEwO">Attribute Inheritance</a>&nbsp;for
- more information.</p>
-<aside class="admonition tip">
- <p>Alternatively, press <kbd>Alt</kbd>+<kbd>L</kbd> which will open the attribute
- details (same view as when an existing attribute is clicked) in the&nbsp;<a
- class="reference-link" href="#root/_help_AlJ73vBCjWDw">Status bar</a>.</p>
-</aside>
-<h2>Creating a relation manually</h2>
-<p>In the&nbsp;<a class="reference-link" href="#root/_help_AlJ73vBCjWDw">Status bar</a>,
- press the&nbsp;<span class="tn-icon bx bx-list-check"></span> button to
- show the list of the attributes.</p>
-<ul>
- <li>To create a relation called <code>myRelation</code>:
- <ol>
- <li>Click the input box to focus it.</li>
- <li>Type <code>~myRelation=@</code> .</li>
- <li>After this, an autocompletion box should appear.</li>
- <li>Type the title of the note to point to and press <kbd>Enter</kbd> to confirm
- (or click the desired note).</li>
- <li>Alternatively copy a note from the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;and
- paste it after the <code>=</code> sign (without the <code>@</code> , in this
- case).</li>
- </ol>
- </li>
- <li>To create an inheritable relation, follow the same steps as previously
- described but instead of <code>~myRelation</code> write <code>~myRelation(inheritable)</code>.</li>
-</ul>
-<h2>Predefined relations</h2>
-<p>These relations are supported and used internally by Trilium.</p>
-<figure
-class="table">
- <table>
- <thead>
- <tr>
- <th>Label</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>runOn*</code>
- </td>
- <td>See&nbsp;<a class="reference-link" href="#root/_help_GPERMystNGTB">Backend Events</a>
- </td>
- </tr>
- <tr>
- <td><code>template</code>
- </td>
- <td>note's attributes will be inherited even without a parent-child relationship,
- note's content and subtree will be added to instance notes if empty. See
- documentation for details.</td>
- </tr>
- <tr>
- <td><code>template:newNoteDefaultParent</code>
- </td>
- <td>set on a template note, points to the note under which notes created from
- the template are placed when no other location is picked; when set several
- times, the note is cloned into every target. See&nbsp;<a class="reference-link"
- href="#root/_help_KC1HB96bqqHX">Templates</a>.</td>
- </tr>
- <tr>
- <td><code>inherit</code>
- </td>
- <td>note's attributes will be inherited even without a parent-child relationship.
- See&nbsp;<a class="reference-link" href="#root/_help_KC1HB96bqqHX">Templates</a>&nbsp;for
- a similar concept. See&nbsp;<a class="reference-link" href="#root/_help_bwZpz2ajCEwO">Attribute Inheritance</a>&nbsp;in
- the documentation.</td>
- </tr>
- <tr>
- <td><code>renderNote</code>
- </td>
- <td>notes of type&nbsp;<a class="reference-link" href="#root/_help_HcABDtFCkbFN">Render Note</a>&nbsp;will
- be rendered using a code note (HTML or script) and it is necessary to point
- using this relation to which note should be rendered</td>
- </tr>
- <tr>
- <td><code>widget</code>
- </td>
- <td>Used in the context of custom&nbsp;<a class="reference-link" href="#root/_help_4Gn3psZKsfSm">Launch Bar Widgets</a>,
- to refer to the widget that will be rendered.</td>
- </tr>
- <tr>
- <td><code>shareCss</code>
- </td>
- <td>CSS note which will be injected into the share page. CSS note must be
- in the shared sub-tree as well. Consider using <code>shareHiddenFromTree</code> and <code>shareOmitDefaultCss</code> as
- well.</td>
- </tr>
- <tr>
- <td><code>shareJs</code>
- </td>
- <td>JavaScript note which will be injected into the share page. JS note must
- be in the shared sub-tree as well. Consider using <code>shareHiddenFromTree</code>.</td>
- </tr>
- <tr>
- <td><code>shareHtml</code>
- </td>
- <td>HTML note which will be injected into the share page at locations specified
- by the <code>shareHtmlLocation</code> label. HTML note must be in the shared
- sub-tree as well. Consider using <code>shareHiddenFromTree</code>.</td>
- </tr>
- <tr>
- <td><code>shareTemplate</code>
- </td>
- <td>Embedded JavaScript note that will be used as the template for displaying
- the shared note. Falls back to the default template. Consider using <code>shareHiddenFromTree</code>.</td>
- </tr>
- <tr>
- <td><code>shareFavicon</code>
- </td>
- <td>Favicon note to be set in the shared page. Typically you want to set it
- to share root and make it inheritable. Favicon note must be in the shared
- sub-tree as well. Consider using <code>shareHiddenFromTree</code>.</td>
- </tr>
- </tbody>
- </table>
-</figure>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes_image.png
deleted file mode 100644
index f0d2a63c2d..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Attributes_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Bulk Actions.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Bulk Actions.html
deleted file mode 100644
index 6a1c212110..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Bulk Actions.html
+++ /dev/null
@@ -1,237 +0,0 @@
-<figure class="image">
- <img style="aspect-ratio:1425/644;" src="Bulk Actions_image.png" width="1425"
- height="644">
-</figure>
-<p>The <em>Bulk Actions</em> dialog makes it easy to apply changes to multiple
- notes at once, ranging from simple actions such as adding or removing a
- label to being executing custom scripts.</p>
-<h2>Interaction</h2>
-<ul>
- <li>The first step is to select the notes in the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>. It's possible to apply bulk
- actions to:
- <ul>
- <li>A single note (and potentially its child notes) simply by clicking on
- it (with a left click or a right click).</li>
- <li>Multiple notes. See&nbsp;<a class="reference-link" href="#root/_help_yTjUdsOi4CIE">Multiple selection</a>&nbsp;on
- how to do so.</li>
- </ul>
- </li>
- <li>Right click in the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;and
- select <em>Advanced</em> → <em>Apply bulk actions</em>.</li>
- <li>The <em>Selected notes</em> section at the top of the dialog lists the notes
- the actions apply to. When many notes are selected, only the first few
- are shown; click <em>+N more</em> to show the rest.
- <ul>
- <li>To leave a note out without changing the selection in the note tree, press
- the <span class="tn-icon bx bx-x"></span> button on its entry. The last remaining
- note cannot be removed.</li>
- </ul>
- </li>
- <li>By default, only the selected notes will be affected. To also include
- all the descendants of the notes, turn on <em>Include descendants of the selected notes</em>.
- The number of affected notes, shown below that option, updates to reflect
- the change.</li>
- <li>To add an action, click <em>Add action</em> (<span class="tn-icon bx bx-plus"></span>)
- at the bottom of the <em>Chosen actions</em> section and pick one from the
- menu. Hovering over an entry shows a short description of what it does;
- a detailed description of each is available in the next section.
- <ul>
- <li>Each chosen action appears as an entry in the <em>Chosen actions</em> section,
- with its own configuration.</li>
- <li>To remove an action, simply press the <span class="tn-icon bx bx-x"></span> button
- to the right of it.</li>
- <li>It is possible to apply multiple actions of the same type, such as adding
- multiple types.</li>
- <li>The fields for a label or relation name suggest the names already used
- in the database as you type, marking the ones Trilium itself attaches a
- meaning to.</li>
- <li>The value field of <em>Add label</em> and <em>Update label value</em> suggests
- the values the named label already has in the database.</li>
- </ul>
- </li>
- <li>When all the actions are defined, press the <em>Apply to N notes</em> button
- to trigger all of them at once. The button names the number of notes that
- will be affected, and stays disabled until at least one action is added.
- <ul>
- <li>If an action is missing a field it needs, such as the name of the label
- to rename, the dialog does not run and points out the empty field instead.</li>
- </ul>
- </li>
- <li>For convenience, the last bulk action configuration is saved for further
- use and will be restored when entering the dialog again.</li>
-</ul>
-<h2>Actions</h2>
-<h3>Labels</h3>
-<p>These actions operate the&nbsp;<a class="reference-link" href="#root/_help_HI6GBBIduIgv">Labels</a>&nbsp;of
- a note. Except for <em>Add label</em>, they only affect labels set directly
- on the note; inherited labels are left unchanged.</p>
-<ul>
- <li><strong>Add label</strong>
- <ul>
- <li>For each note, it creates a <a href="#root/_help_HI6GBBIduIgv">label</a> of
- the given name. Keep the <em>New value</em> field empty to create a label
- without a value, or complete it to assign a value.</li>
- <li>The label is added even if the note already has one of the same name,
- so the note ends up with both. To change the value of an existing label
- instead, use <em>Update label value</em>.</li>
- </ul>
- </li>
- <li><strong>Update label value</strong>
- <ul>
- <li>For each note, if it has a <a href="#root/_help_HI6GBBIduIgv">label</a> of
- the given name, it will change its value to the specified one. Leave <em>New value</em> field
- empty to create a label without a value.</li>
- <li>Notes without the label will not be affected.</li>
- </ul>
- </li>
- <li><em><strong>Rename label</strong></em>
- <ul>
- <li>For each note, if it has a <a href="#root/_help_HI6GBBIduIgv">label</a> of
- the given name, it will be renamed/replaced with a label of the new name.
- The value of the label (if present) will be kept intact.</li>
- <li>Notes without the label will not be affected.</li>
- </ul>
- </li>
- <li><strong>Delete label</strong>
- <ul>
- <li>For each note, if it has a label of a given name, it will be deleted (regardless
- of whether it has a value or not).</li>
- <li>Notes without the label will not be affected.</li>
- </ul>
- </li>
-</ul>
-<h3>Relations</h3>
-<p>These actions operate the&nbsp;<a class="reference-link" href="#root/_help_Cq5X6iKQop6R">Relations</a>&nbsp;of
- a note. Except for <em>Add relation</em>, they only affect relations set
- directly on the note; inherited relations are left unchanged.</p>
-<ul>
- <li><strong>Add relation</strong>
- <ul>
- <li>For each note, it will create a relation pointing to the given note.</li>
- <li>The relation is added even if the note already has one of the same name.</li>
- </ul>
- </li>
- <li><strong>Update relation target</strong>
- <ul>
- <li>For each note, it will modify a relation to point to the newly given note.</li>
- <li>Notes without this relation will not be affected.</li>
- </ul>
- </li>
- <li><strong>Rename relation</strong>
- <ul>
- <li>For each note, if it has a relation of the given name, it will be renamed/replaced
- with a relation of the new name. The target note of the relation will be
- kept intact.</li>
- <li>Notes without this relation will not be affected.</li>
- </ul>
- </li>
- <li><strong>Delete relation</strong>
- <ul>
- <li>For each note, if it has a relation of the given name, it will be deleted.</li>
- <li>Notes without this relation will not be affected.</li>
- </ul>
- </li>
-</ul>
-<h3>Notes</h3>
-<ul>
- <li><strong>Rename note</strong>
- <ul>
- <li>For each note, it will change the title of the note to the given one.</li>
- <li>The title can contain expressions between <code>${</code> and <code>}</code>,
- which are filled in for each note. They can read the note's properties,
- such as <code>${note.title}</code>, <code>${note.noteId}</code> or <code>${note.type}</code>,
- and call <code>getLabelValue('name')</code>, <code>getRelationValue('name')</code> or,
- on a date such as <code>dateCreatedObj</code>, <code>format('…')</code>.
- For example:
- <ul>
- <li><code>NEW: ${note.title}</code> will prefix all notes with <code>NEW:</code> .</li>
- <li><code>${note.dateCreatedObj.format('MM-DD:')}: ${note.title}</code> will
- prefix the note titles with each note's creation date (in month-day format).</li>
- </ul>
- </li>
- <li>Only property access and those methods are allowed, not arbitrary JavaScript.
- While typing, the field completes the expressions, underlines one that
- is not allowed and shows the resulting title for the first selected note.</li>
- </ul>
- </li>
- <li><strong>Move note</strong>
- <ul>
- <li>For each note, it will be moved to the specified parent note.</li>
- <li>A note with several parents is cloned to the new parent instead, since
- it is not clear which of its places to remove.</li>
- <li>A note that cannot be placed there, such as a parent of the target note,
- stays where it is.</li>
- <li>As an alternative for less complex situations, the notes can be moved
- directly from within the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;via
- cut → paste or via the contextual menu.</li>
- </ul>
- </li>
- <li><strong>Convert note</strong>
- <ul>
- <li>This allows a note to be converted from one type to another:
- <ul>
- <li><strong>Text Notes → Markdown Notes</strong> — each&nbsp;<a class="reference-link"
- href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;note is converted to a&nbsp;<a
- class="reference-link" href="#root/_help_6RM1Q7ppFVoj">Markdown</a>&nbsp;note.
- Since Markdown does not support all the formatting capabilities of Text
- Notes, some formatting may be lost and some unsupported elements may even
- be dropped.</li>
- <li><strong>Markdown Notes → Text Notes</strong> — each&nbsp;<a class="reference-link"
- href="#root/_help_6RM1Q7ppFVoj">Markdown</a>&nbsp;note is converted to
- a&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;Note.</li>
- </ul>
- </li>
- <li>For each converted note, a revision is saved automatically, allowing you
- to restore the original or recover any missing elements from it.</li>
- </ul>
- </li>
- <li><strong>Save revision</strong>
- <ul>
- <li>Automatically creates a revision of each note. Optionally, a name can
- be assigned to this revision. See&nbsp;<a class="reference-link" href="#root/_help_vZWERwf8U3nx">Note Revisions</a>.</li>
- </ul>
- </li>
- <li><strong>Delete note</strong>
- <ul>
- <li>For each note, it will be deleted, including all of its clones and any
- child notes that are not cloned elsewhere.</li>
- <li>Deleted notes can be restored from <em>Recent changes</em> until they are
- erased.</li>
- <li>As an alternative for less complex situations, the notes can be removed
- directly from within the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;by
- selecting them and pressing <kbd>Delete</kbd>.</li>
- </ul>
- </li>
- <li><strong>Delete note revisions</strong>
- <ul>
- <li>This will permanently erase all the&nbsp;<a class="reference-link" href="#root/_help_vZWERwf8U3nx">Note Revisions</a>&nbsp;of
- the notes. Unlike deleted notes, erased revisions cannot be restored.</li>
- </ul>
- </li>
-</ul>
-<h3>Others</h3>
-<ul>
- <li><strong>Execute script</strong>
- <ul>
- <li>For more complex scenarios, it is possible to type in a JavaScript expression
- in order to apply the necessary changes.</li>
- <li>The script runs on the server once for each note, with that note available
- as <code>note</code> and the backend script API as <code>api</code>. The field
- completes both as you type and underlines mistakes, as the editor of a
- backend script note does.</li>
- <li>Examples:
- <ul>
- <li>
- <p>To apply a suffix (<code>- suffix</code> in this example), to the note
- title:</p><pre><code class="language-text-javascript">note.title = note.title + " - suffix";</code></pre>
- </li>
- <li>
- <p>To alter attributes of a note based on another attribute, such as setting
- the <code>#shareAlias</code> label to the title of the note:</p><pre><code class="language-text-javascript">note.setLabel("shareAlias", note.title)</code></pre>
- </li>
- </ul>
- </li>
- </ul>
- </li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Bulk Actions_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Bulk Actions_image.png
deleted file mode 100644
index 83af14fc2c..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Bulk Actions_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Configuration (config.ini or environment variables).html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Configuration (config.ini or environment variables).html
deleted file mode 100644
index f8c3a526cd..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Configuration (config.ini or environment variables).html
+++ /dev/null
@@ -1,411 +0,0 @@
-<p>Trilium supports configuration via a file named <code>config.ini</code> and
- environment variables. This document provides a comprehensive reference
- for all configuration options.</p>
-<h2>Location of the configuration file</h2>
-<p>The configuration file is not located in the same directory as the application.
- Instead, the <code>config.ini</code> is located in the&nbsp;<a class="reference-link"
- href="#root/_help_tAassRL4RSQL">Data directory</a>. As such, the configuration
- file is only available after starting the application and creating a database.</p>
-<h2>Configuration Precedence</h2>
-<p>Configuration values are loaded in the following order of precedence (highest
- to lowest):</p>
-<ol>
- <li><strong>Environment variables</strong> (checked first)</li>
- <li><strong>config.ini file values</strong>
- </li>
- <li><strong>Default values</strong>
- </li>
-</ol>
-<h2>Environment Variable Patterns</h2>
-<p>Trilium supports multiple environment variable patterns for flexibility.
- The primary pattern is: <code>TRILIUM_[SECTION]_[KEY]</code>
-</p>
-<p>Where:</p>
-<ul>
- <li><code>SECTION</code> is the INI section name in UPPERCASE</li>
- <li><code>KEY</code> is the camelCase configuration key converted to UPPERCASE
- (e.g., <code>instanceName</code> → <code>INSTANCENAME</code>)</li>
-</ul>
-<p>Additionally, shorter aliases are available for common configurations
- (see Alternative Variables section below).</p>
-<h2>Environment Variable Reference</h2>
-<div class="trilium-tabs">
- <section class="trilium-tab">
- <p class="trilium-tab-title">General</p>
- <div class="trilium-tab-panel">
- <figure class="table">
- <table>
- <thead>
- <tr>
- <th>Environment Variable</th>
- <th>Type</th>
- <th>Default</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>TRILIUM_GENERAL_INSTANCENAME</code>
- </td>
- <td>string</td>
- <td>""</td>
- <td>Instance name for API identification</td>
- </tr>
- <tr>
- <td><code>TRILIUM_GENERAL_NOAUTHENTICATION</code>
- </td>
- <td>boolean</td>
- <td>false</td>
- <td>Disable authentication (server only)</td>
- </tr>
- <tr>
- <td><code>TRILIUM_GENERAL_NOBACKUP</code>
- </td>
- <td>boolean</td>
- <td>false</td>
- <td>Disable automatic backups</td>
- </tr>
- <tr>
- <td><code>TRILIUM_GENERAL_NODESKTOPICON</code>
- </td>
- <td>boolean</td>
- <td>false</td>
- <td>Disable desktop icon creation</td>
- </tr>
- <tr>
- <td><code>TRILIUM_GENERAL_READONLY</code>
- </td>
- <td>boolean</td>
- <td>false</td>
- <td>Enable read-only mode</td>
- </tr>
- </tbody>
- </table>
- </figure>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title">Network</p>
- <div class="trilium-tab-panel">
- <figure class="table">
- <table>
- <thead>
- <tr>
- <th>Environment Variable</th>
- <th>Type</th>
- <th>Default</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>TRILIUM_NETWORK_HOST</code>
- </td>
- <td>string</td>
- <td>"0.0.0.0"</td>
- <td>Server host binding</td>
- </tr>
- <tr>
- <td><code>TRILIUM_NETWORK_PORT</code>
- </td>
- <td>string</td>
- <td>"8080"</td>
- <td>Server port</td>
- </tr>
- <tr>
- <td><code>TRILIUM_NETWORK_HTTPS</code>
- </td>
- <td>boolean</td>
- <td>false</td>
- <td>Enable HTTPS</td>
- </tr>
- <tr>
- <td><code>TRILIUM_NETWORK_CERTPATH</code>
- </td>
- <td>string</td>
- <td>""</td>
- <td>SSL certificate path</td>
- </tr>
- <tr>
- <td><code>TRILIUM_NETWORK_KEYPATH</code>
- </td>
- <td>string</td>
- <td>""</td>
- <td>SSL key path</td>
- </tr>
- <tr>
- <td><code>TRILIUM_NETWORK_TRUSTEDREVERSEPROXY</code>
- </td>
- <td>boolean/string</td>
- <td>false</td>
- <td>Reverse proxy trust settings</td>
- </tr>
- <tr>
- <td><code>TRILIUM_NETWORK_CORSALLOWORIGIN</code>
- </td>
- <td>string</td>
- <td>""</td>
- <td>CORS allowed origins</td>
- </tr>
- <tr>
- <td><code>TRILIUM_NETWORK_CORSALLOWMETHODS</code>
- </td>
- <td>string</td>
- <td>""</td>
- <td>CORS allowed methods</td>
- </tr>
- <tr>
- <td><code>TRILIUM_NETWORK_CORSALLOWHEADERS</code>
- </td>
- <td>string</td>
- <td>""</td>
- <td>CORS allowed headers</td>
- </tr>
- <tr>
- <td><code>TRILIUM_NETWORK_CORSRESOURCEPOLICY</code>
- </td>
- <td>string</td>
- <td>same-origin</td>
- <td>CORS Resource Policy allows same-origin/same-site/cross-origin as values,
- will error if not</td>
- </tr>
- </tbody>
- </table>
- </figure>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title">Session</p>
- <div class="trilium-tab-panel">
- <figure class="table">
- <table>
- <thead>
- <tr>
- <th>Environment Variable</th>
- <th>Type</th>
- <th>Default</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>TRILIUM_SESSION_COOKIEMAXAGE</code>
- </td>
- <td>integer</td>
- <td>1814400</td>
- <td>Session cookie max age in seconds (21 days)</td>
- </tr>
- </tbody>
- </table>
- </figure>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title">Sync</p>
- <div class="trilium-tab-panel">
- <figure class="table">
- <table>
- <thead>
- <tr>
- <th>Environment Variable</th>
- <th>Type</th>
- <th>Default</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>TRILIUM_SYNC_SYNCSERVERHOST</code>
- </td>
- <td>string</td>
- <td>""</td>
- <td>Sync server host URL</td>
- </tr>
- <tr>
- <td><code>TRILIUM_SYNC_SYNCSERVERTIMEOUT</code>
- </td>
- <td>string</td>
- <td>"120000"</td>
- <td>Sync server timeout in milliseconds</td>
- </tr>
- <tr>
- <td><code>TRILIUM_SYNC_SYNCPROXY</code>
- </td>
- <td>string</td>
- <td>""</td>
- <td>Sync proxy URL</td>
- </tr>
- </tbody>
- </table>
- </figure>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title">MultiFactorAuthentication</p>
- <div class="trilium-tab-panel">
- <p>See&nbsp;<a class="reference-link" href="#root/_help_x1lQNKQBqLcA">Signing in with OpenID Connect</a>.</p>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title">Logging</p>
- <div class="trilium-tab-panel">
- <figure class="table">
- <table>
- <thead>
- <tr>
- <th>Environment Variable</th>
- <th>Type</th>
- <th>Default</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>TRILIUM_LOGGING_RETENTIONDAYS</code>
- </td>
- <td>integer</td>
- <td>90</td>
- <td>Number of days to retain log files</td>
- </tr>
- </tbody>
- </table>
- </figure>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title">Development</p>
- <div class="trilium-tab-panel">
- <figure class="table">
- <table>
- <thead>
- <tr>
- <th>Environment Variable</th>
- <th>Type</th>
- <th>Default</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>TRILIUM_MANUAL_DB_MIGRATION</code>
- </td>
- <td>boolean</td>
- <td>false</td>
- <td>If <code>true</code>, the application will not start if automatic database
- migrations are pending and would modify the database schema.</td>
- </tr>
- </tbody>
- </table>
- </figure>
- </div>
- </section>
-</div>
-<details class="trilium-collapsible">
- <summary>Alternative environment variables</summary>
- <p>The following alternative environment variable names are also supported
- and work identically to their longer counterparts.</p>
- <div class="trilium-tabs">
- <section class="trilium-tab">
- <p class="trilium-tab-title">Network CORS</p>
- <div class="trilium-tab-panel">
- <ul>
- <li><code>TRILIUM_NETWORK_CORS_ALLOW_ORIGIN</code> (alternative to <code>TRILIUM_NETWORK_CORSALLOWORIGIN</code>)</li>
- <li><code>TRILIUM_NETWORK_CORS_ALLOW_METHODS</code> (alternative to <code>TRILIUM_NETWORK_CORSALLOWMETHODS</code>)</li>
- <li><code>TRILIUM_NETWORK_CORS_ALLOW_HEADERS</code> (alternative to <code>TRILIUM_NETWORK_CORSALLOWHEADERS</code>)</li>
- <li><code>TRILIUM_NETWORK_CORS_RESOURCE_POLICY</code> (alternative to <code>TRILIUM_NETWORK_CORSRESOURCEPOLICY</code>)</li>
- </ul>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title">Sync</p>
- <div class="trilium-tab-panel">
- <ul>
- <li><code>TRILIUM_SYNC_SERVER_HOST</code> (alternative to <code>TRILIUM_SYNC_SYNCSERVERHOST</code>)</li>
- <li><code>TRILIUM_SYNC_SERVER_TIMEOUT</code> (alternative to <code>TRILIUM_SYNC_SYNCSERVERTIMEOUT</code>)</li>
- <li><code>TRILIUM_SYNC_SERVER_PROXY</code> (alternative to <code>TRILIUM_SYNC_SYNCPROXY</code>)</li>
- </ul>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title">OAuth/MFA</p>
- <div class="trilium-tab-panel">
- <ul>
- <li><code>TRILIUM_OAUTH_BASE_URL</code> (alternative to <code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHBASEURL</code>)</li>
- <li><code>TRILIUM_OAUTH_CLIENT_ID</code> (alternative to <code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHCLIENTID</code>)</li>
- <li><code>TRILIUM_OAUTH_CLIENT_SECRET</code> (alternative to <code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHCLIENTSECRET</code>)</li>
- <li><code>TRILIUM_OAUTH_ISSUER_BASE_URL</code> (alternative to <code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHISSUERBASEURL</code>)</li>
- <li><code>TRILIUM_OAUTH_ISSUER_NAME</code> (alternative to <code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHISSUERNAME</code>)</li>
- <li><code>TRILIUM_OAUTH_ISSUER_ICON</code> (alternative to <code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHISSUERICON</code>)</li>
- <li><code>TRILIUM_OAUTH_HTTP_TIMEOUT</code> (alternative to <code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHHTTPTIMEOUT</code>)</li>
- <li><code>TRILIUM_OAUTH_SCOPE</code> (alternative to <code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHSCOPE</code>)</li>
- </ul>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title">Logging</p>
- <div class="trilium-tab-panel">
- <ul>
- <li><code>TRILIUM_LOGGING_RETENTION_DAYS</code> (alternative to <code>TRILIUM_LOGGING_RETENTIONDAYS</code>)</li>
- </ul>
- </div>
- </section>
- </div>
-</details>
-<h2>Boolean Values</h2>
-<p>Boolean environment variables accept the following values:</p>
-<ul>
- <li><strong>True</strong>: <code>"true"</code>, <code>"1"</code>, <code>1</code>
- </li>
- <li><strong>False</strong>: <code>"false"</code>, <code>"0"</code>, <code>0</code>
- </li>
- <li>Any other value defaults to <code>false</code>
- </li>
-</ul>
-<h2>Using Environment Variables</h2>
-<p>Both naming patterns are fully supported and can be used interchangeably:</p>
-<ul>
- <li>The longer format follows the section/key pattern for consistency with
- the INI file structure</li>
- <li>The shorter alternatives provide convenience for common configurations</li>
- <li>You can use whichever format you prefer - both are equally valid</li>
-</ul>
-<h2>Examples</h2>
-<div class="trilium-tabs">
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-docker"></span>&nbsp;Docker Compose</p>
- <div
- class="trilium-tab-panel"><pre><code class="language-text-x-yaml">services:
- trilium:
- image: triliumnext/trilium
- environment:
- # Using full format
- TRILIUM_GENERAL_INSTANCENAME: "My Trilium Instance"
- TRILIUM_NETWORK_PORT: "8080"
- TRILIUM_NETWORK_CORSALLOWORIGIN: "https://myapp.com"
- TRILIUM_SYNC_SYNCSERVERHOST: "https://sync.example.com"
- TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHBASEURL: "https://auth.example.com"
-
- # Or using shorter alternatives (equally valid)
- # TRILIUM_NETWORK_CORS_ALLOW_ORIGIN: "https://myapp.com"
- # TRILIUM_SYNC_SERVER_HOST: "https://sync.example.com"
- # TRILIUM_OAUTH_BASE_URL: "https://auth.example.com"</code></pre>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-tux"></span>&nbsp;Linux Shell</p>
- <div class="trilium-tab-panel"><pre><code class="language-text-x-trilium-auto"># Using either format
-export TRILIUM_GENERAL_NOAUTHENTICATION=false
-export TRILIUM_NETWORK_HTTPS=true
-export TRILIUM_NETWORK_CERTPATH=/path/to/cert.pem
-export TRILIUM_NETWORK_KEYPATH=/path/to/key.pem
-export TRILIUM_LOGGING_RETENTIONDAYS=30
-
-# Start Trilium
-npm start</code></pre>
- </div>
- </section>
-</div>
-<h2>config.ini Reference</h2>
-<p>For the complete list of configuration options and their INI file format,
- please review the <a href="https://github.com/TriliumNext/Trilium/blob/main/apps/server/src/assets/config-sample.ini">config-sample.ini</a> file
- in the Trilium repository.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Configuration (config.ini or environment variables)/Cross-Origin Resource Sharing (CORS).html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Configuration (config.ini or environment variables)/Cross-Origin Resource Sharing (CORS).html
deleted file mode 100644
index 5e2a746665..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Configuration (config.ini or environment variables)/Cross-Origin Resource Sharing (CORS).html
+++ /dev/null
@@ -1,42 +0,0 @@
-<p>By default, Trilium cannot be accessed in web browsers by requests coming
- from other domains/origins than Trilium itself.&nbsp;</p>
-<p>However, it is possible to manually configure <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/CORS">Cross-Origin Resource Sharing (CORS)</a> since
- Trilium v0.93.0 using environment variables or <code>config.ini</code>,
- as follows:</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>CORS Header</th>
- <th>Corresponding environment variable</th>
- <th>Corresponding option in <code>config.ini</code> variables in the <code>Network</code> section</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>Access-Control-Allow-Origin</code>
- </td>
- <td><code>TRILIUM_NETWORK_CORS_ALLOW_ORIGIN</code>
- </td>
- <td><code>corsAllowOrigin</code>
- </td>
- </tr>
- <tr>
- <td><code>Access-Control-Allow-Methods</code>
- </td>
- <td><code>TRILIUM_NETWORK_CORS_ALLOW_METHODS</code>
- </td>
- <td><code>corsAllowMethods</code>
- </td>
- </tr>
- <tr>
- <td><code>Access-Control-Allow-Headers</code>
- </td>
- <td><code>TRILIUM_NETWORK_CORS_ALLOW_HEADERS</code>
- </td>
- <td><code>corsAllowHeaders</code>
- </td>
- </tr>
- </tbody>
- </table>
-</figure>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Configuration (config.ini or environment variables)/Trilium instance.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Configuration (config.ini or environment variables)/Trilium instance.html
deleted file mode 100644
index 35fc1d2b81..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Configuration (config.ini or environment variables)/Trilium instance.html
+++ /dev/null
@@ -1,17 +0,0 @@
-<p>A Trilium instance represents a server. If&nbsp;<a class="reference-link"
- href="#root/_help_cbkrhQjrkKrh">Synchronization</a>&nbsp;is set up, since
- multiple servers are involved (the one from the desktop client and the
- one the synchronisation is set up with), sometimes it can be useful to
- distinguish the instance you are running on.</p>
-<h2>Setting the instance name</h2>
-<p>To set up a name for the instance, modify the <code>config.ini</code>:</p><pre><code class="language-text-x-trilium-auto">[General]
-instanceName=Hello</code></pre>
-<h2>Distinguishing the instance on back-end</h2>
-<p>Use <code>api.getInstanceName()</code> to obtain the instance name of the
- current server, as specified in the config file or in environment variables.</p>
-<h2>Limiting script runs based on instance</h2>
-<p>For a script that is run periodically or on a certain event, it's possible
- to limit it to certain instances without having to change the code. Just
- add <code>runOnInstance</code> and set as the value the instance name where
- the script should run. To run on multiple named instances, simply add the
- label multiple times.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Custom Request Handler.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Custom Request Handler.html
deleted file mode 100644
index e6c076aaf3..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Custom Request Handler.html
+++ /dev/null
@@ -1,73 +0,0 @@
-<p>Trilium provides a mechanism for <a href="#root/_help_CdNpE2pqjmI6">scripts</a> to
- open a public REST endpoint. This opens a way for various integrations
- with other services - a simple example would be creating new note from
- Slack by issuing a slash command (e.g. <code>/trilium buy milk</code>).</p>
-<h2>Create note from outside Trilium</h2>
-<p>Let's take a look at an example. The goal is to provide a REST endpoint
- to which we can send title and content and Trilium will create a note.</p>
-<p>We'll start with creating a JavaScript backend <a href="#root/_help_6f9hih2hXXZk">code note</a> containing:</p><pre><code class="language-text-x-trilium-auto">const {req, res} = api;
-const {secret, title, content} = req.body;
-
-if (req.method == 'POST' &amp;&amp; secret === 'secret-password') {
- // notes must be saved somewhere in the tree hierarchy specified by a parent note.
- // This is defined by a relation from this code note to the "target" parent note
- // alternatively you can just use constant noteId for simplicity (get that from "Note Info" dialog of the desired parent note)
- const targetParentNoteId = api.currentNote.getRelationValue('targetNote');
-
- const {note} = api.createTextNote(targetParentNoteId, title, content);
- const notePojo = note.getPojo();
-
- res.status(201).json(notePojo);
-}
-else {
- res.send(400);
-}</code></pre>
-<p>This script note has also following two attributes:</p>
-<ul>
- <li>label <code>#customRequestHandler</code> with value <code>create-note</code>
- </li>
- <li>relation <code>~targetNote</code> pointing to a note where new notes should
- be saved</li>
-</ul>
-<h3>Explanation</h3>
-<p>Let's test this by using an HTTP client to send a request:</p><pre><code class="language-text-x-trilium-auto">POST http://your-trilium-server/custom/create-note
-Content-Type: application/json
-
-{
- "secret": "secret-password",
- "title": "hello",
- "content": "world"
-}+++++++++++++++++++++++++++++++++++++++++++++++</code></pre>
-<p>Notice the <code>/custom</code> part in the request path - Trilium considers
- any request with this prefix as "custom" and tries to find a matching handler
- by looking at all notes which have <code>customRequestHandler</code> <a href="#root/_help_zEY4DaJG4YT5">label</a>.
- Value of this label then contains a regular expression which will match
- the request path (in our case trivial regex "create-note").</p>
-<p>Trilium will then find our code note created above and execute it. <code>api.req</code>, <code>api.res</code> are
- set to <a href="https://expressjs.com/en/api.html#req">request</a> and <a
- href="https://expressjs.com/en/api.html#res">response</a>objects from which
- we can get details of the request and also respond.</p>
-<p>In the code note we check the request method and then use trivial authentication
- - keep in mind that these endpoints are by default totally unauthenticated,
- and you need to take care of this yourself.</p>
-<p>Once we pass these checks we will just create the desired note using <a
- href="#root/_help_GLks18SNjxmC">Script API</a>.</p>
-<h2>Custom resource provider</h2>
-<p>Another common use case is that you want to just expose a file note -
- in such case you create label <code>customResourceProvider</code> (value
- is again path regex).</p>
-<p>For more information, see&nbsp;<a href="#root/_help_d3fAXQ2diepH">Custom Resource Providers</a>.</p>
-<h2>Advanced concepts</h2>
-<p><code>api.req</code> and <code>api.res</code> are Express.js objects - you
- can always look into its <a href="https://expressjs.com/en/api.html">documentation</a> for
- details.</p>
-<h3>Parameters</h3>
-<p>REST request paths often contain parameters in the URL, e.g.:</p><pre><code class="language-text-x-trilium-auto">http://your-trilium-server/custom/notes/123</code></pre>
-<p>The last part is dynamic so the matching of the URL must also be dynamic
- - for this reason the matching is done with regular expressions. Following <code>customRequestHandler</code> value
- would match it:</p><pre><code class="language-text-x-trilium-auto">notes/([0-9]+)</code></pre>
-<p>Additionally, this also defines a matching group with the use of parenthesis
- which then makes it easier to extract the value. The matched groups are
- available in <code>api.pathParams</code>:</p><pre><code class="language-text-x-trilium-auto">const noteId = api.pathParams[0];</code></pre>
-<p>Often you also need query params (as in e.g. <code>http://your-trilium-server/custom/notes?noteId=123</code>),
- you can get those with standard express <code>req.query.noteId</code>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Custom Resource Providers.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Custom Resource Providers.html
deleted file mode 100644
index 1cdcbd0c8f..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Custom Resource Providers.html
+++ /dev/null
@@ -1,35 +0,0 @@
-<p>A custom resource provider allows any file imported into Trilium (images,
- fonts, stylesheets) to be publicly accessible via a URL.</p>
-<p>A potential use case for this is to add embed a custom font alongside
- a theme.</p>
-<h2>Steps for creating a custom resource provider</h2>
-<ol>
- <li>Import a file such as an image or a font into Trilium by drag &amp; drop.</li>
- <li>Set the <a href="#root/_help_HI6GBBIduIgv">label</a> <code>#customResourceProvider</code> to <code>hello</code>.</li>
- <li>To test if it is working, use a browser to navigate to <code>&lt;protocol&gt;://&lt;host&gt;/custom/hello</code> (where <code>&lt;protocol&gt;</code> is
- either <code>http</code> or <code>https</code> based on your setup, and <code>&lt;host&gt;</code> is
- the host or IP to your Trilium server instance). If you are running the
- TriliumNext application without a server, use <code>http://localhost:37840</code> as
- the base URL.</li>
- <li>If everything went well, at the previous step the browser should have
- downloaded the file uploaded in the first step.</li>
-</ol>
-<p>Instead of <code>hello</code>, the name can be:</p>
-<ul>
- <li>A path, such as <code>fonts/Roboto.ttf</code>, which would be accessible
- via <code>&lt;host&gt;/custom/fonts/Roboto.ttf</code>.</li>
- <li>As a more advanced use case, a regular expression to match multiple routes,
- such as <code>hello/.*</code> which will be accessible via <code>/custom/hello/1</code>, <code>/custom/hello/2</code>, <code>/custom/hello/world</code>,
- etc.</li>
-</ul>
-<h2>Using it in a theme</h2>
-<p>For example, if you have a custom font to be imported by the theme, first
- upload a font file into Trilium and assign it the <code>#customResourceProvider=fonts/myfont.ttf</code> attribute.</p>
-<p>Then modify the theme CSS to point to:</p><pre><code class="language-text-css">@font-face {
- font-family: customFont;
- src: url("/custom/fonts/myfont.ttf");
-}
-
-div {
- font-family: customFont;
-}</code></pre>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Customizing to-do task states.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Customizing to-do task states.html
deleted file mode 100644
index fb18847248..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Customizing to-do task states.html
+++ /dev/null
@@ -1,63 +0,0 @@
-<p>Trilium features customizable to-do list task states. To customize them,
- go to&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a> → <em>Text Notes</em> → <em>Related settings</em> → <em>Custom checkbox states for to-do lists</em>.
- Alternatively, right-click a checkbox in an editable text note and click
- the pencil icon.</p>
-<aside class="admonition warning">
- <p>Changes take effect only after restarting the application.</p>
-</aside>
-<h2>Creating a new task state</h2>
-<p>Click the plus icon next to Task States in the left-side pane, then define
- the task details as described in the next section.</p>
-<h2>Editing a task state</h2>
-<p>Selecting any state other than "None" and "Done" (which cannot be modified)
- from the side pane reveals the following editable fields:</p>
-<ul>
- <li><em>Icon</em> (required): The symbol shown inside the checkbox. You can
- pick an icon just as you would for any regular note, including from custom
- icon packs.</li>
- <li><em>Title</em> (required): The name of the task state shown in the UI.
- For example: "Doing", "Postponed".</li>
- <li><em>Identifier</em> (required): A short name for the state, using only
- letters, digits, "<code>-</code>" and "<code>_</code>". It is stored as
- metadata in the note's markup and used to identify the task state. Two
- task states cannot share the same identifier.
- <br>Prefix the identifiers of your custom task states with an underscore "<code>_</code>"
- or a hyphen "<code>-</code>" to avoid clashes with task states that may
- be introduced in future versions of Trilium.</li>
- <li><em>Markdown symbol</em>: A single character used to represent the state
- in Markdown syntax. For example, "<code>#</code>" creates a task state
- that can be applied in Markdown using " <code>- [#]</code> ". Make sure no
- other task state uses the same symbol.</li>
- <li><em>Counts as completed</em>: If checked, the task is treated as completed.</li>
- <li><em>Color</em>: The color of the checkbox. Its lightness and saturation
- are adjusted automatically to match the current color scheme or theme.</li>
- <li><em>Hidden from toolbar</em>: The state is not listed in the UI. This
- is useful when you want existing notes to keep rendering the state correctly
- but no longer need to apply it yourself.</li>
-</ul>
-<aside class="admonition note">
- <p>The task definition details are validated at startup. If errors are found,
- a toast provides the details and the affected task definition is ignored.</p>
-</aside>
-<h2>Reordering task states</h2>
-<p>To change the order in which task states appear in the UI and when cycling
- through them with the keyboard, simply reorder the states in the side pane
- (or tree panel, if it's the case).</p>
-<h2>Deleting task states</h2>
-<p>Any task state other than "None" and "Done" can be deleted.</p>
-<p>Once deleted, to-do items using that state will no longer display the
- custom checkbox. They fall back to either a "None" or "Done" state, depending
- on the state's "Counts as completed" setting. The identifier and title
- remain stored in the note until you set the checkbox to a new state.</p>
-<h2>Transferring notes with custom task states between Trilium database instances</h2>
-<p>Exporting notes to another Trilium database instance preserves the task
- states of to-do items, but does not include the custom task definitions.
- As a result, the destination instance won't know how to render the checkbox
- unless you recreate the task state there with the same identifier and Markdown
- symbol.</p>
-<aside class="admonition note">
- <p>This is a known limitation of the current version. If there is enough
- interest in the community for transferring notes between Trilium database
- instances more easily, the Trilium team may consider a better state definition
- mechanism.</p>
-</aside>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Database.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Database.html
deleted file mode 100644
index b023a235c3..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Database.html
+++ /dev/null
@@ -1,47 +0,0 @@
-<p>Your Trilium data is stored in a <a href="https://www.sqlite.org">SQLite</a> database
- which contains all notes, tree structure, metadata, and most of the configuration.
- The database file is named <code>document.db</code> and is stored in the
- application's default&nbsp;<a href="#root/_help_tAassRL4RSQL">Data directory</a>.</p>
-<h2>Demo Notes</h2>
-<p>When first starting Trilium, it will provide a set of notes to showcase
- various features of the application.</p>
-<p>For more information see&nbsp;<a class="reference-link" href="#root/_help_6tZeKvSHEUiB">Demo Notes</a>.</p>
-<h2>Manually Modifying the Database</h2>
-<p>Trilium provides a lot of flexibility, and with it, opportunities for
- advanced users to tweak it. If you need to explore or modify the database
- directly, you can use a tool such as <a href="https://sqlitebrowser.org/">SQLite Browser</a> to
- work directly on the database file.</p>
-<p>See&nbsp;<a href="#root/_help_oyIAJ9PvvwHX">Manually altering the database</a>&nbsp;for
- more information.</p>
-<h2>How to Reset the Database</h2>
-<p>If you want to start again and:</p>
-<ul>
- <li>Create and switch to a new blank knowledge base</li>
- <li>Use a different knowledge base synced from a server or desktop application</li>
- <li>Restore a backup</li>
-</ul>
-<p>You can navigate to&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a> → <em>Database</em> and
- click the <em>Start over</em> button. You'll be prompted to restart the application,
- with the option to back up your current database before proceeding.</p>
-<aside
-class="admonition important">
- <p>For the web client, Trilium cannot restart automatically. You'll need
- to manually restart the server/container and then reload the web application.</p>
-</aside>
-<p>After restarting, the setup screen will appear. You can choose to back
- up your existing database, then proceed with the setup menu as if it's
- a new installation. The existing database will only be overwritten after
- selecting to create a new database, sync with a server, or restore from
- a backup.</p>
-<h3>The Legacy Method</h3>
-<p>If you are experimenting with Trilium and want to return it to its original
- state, you can do that by deleting the current database. When you restart
- the application, it will generate a new database containing the original
- demo notes.</p>
-<p>To delete the database, simply go to the <a href="#root/_help_tAassRL4RSQL">data directory</a> and
- delete the <code>document.db</code> file (and any other files starting with <code>document.db</code>).</p>
-<p>If you do not need to preserve any configurations that might be stored
- in the <code>config.ini</code> file, you can just delete all of the <a href="#root/_help_tAassRL4RSQL">data directory's</a> contents
- to fully restore the application to its original state. You can also review
- the <a href="#root/_help_Gzjqa934BdH4">configuration</a> file to provide
- all <code>config.ini</code> values as environment variables instead.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Database/Demo Notes.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Database/Demo Notes.html
deleted file mode 100644
index e55a4d21d2..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Database/Demo Notes.html
+++ /dev/null
@@ -1,30 +0,0 @@
-<p>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:</p>
-<ul>
- <li><a class="reference-link" href="#root/_help_iRwzGnHPzonm">Relation Map</a>
- </li>
- <li><a class="reference-link" href="#root/_help_l0tKav7yLHGF">Day Notes</a>
- </li>
- <li><a class="reference-link" href="#root/_help_R7abl2fc6Mxi">Weight Tracker</a>
- </li>
- <li><a class="reference-link" href="#root/_help_xYjQUYhpbUEW">Task Manager</a>
- </li>
- <li><a class="reference-link" href="#root/_help_Wy267RK4M69c">Themes</a>
- </li>
-</ul>
-<h3>Restoring Demo Notes</h3>
-<p>There are some cases in which you may want to restore the original demo
- notes. For example, if you experimented with some of the more advanced
- features and want to see the original reference, or if you simply want
- to explore the latest version of the demo notes, which might showcase new
- features.</p>
-<p>You can easily restore the demo notes by using Trilium's built-in import
- feature by importing them:</p>
-<ul>
- <li>Download <a href="https://github.com/TriliumNext/Trilium/raw/refs/heads/main/apps/server/src/assets/db/demo.zip">the .zip archive</a> with
- the latest version of the demo notes</li>
- <li>Right click on any note in your tree under which you would like the demo
- notes to be imported</li>
- <li>Click "Import into note…"</li>
- <li>Select the .zip archive to import it</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Database/Manually altering the database.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Database/Manually altering the database.html
deleted file mode 100644
index 6f0caf2e04..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Database/Manually altering the database.html
+++ /dev/null
@@ -1,36 +0,0 @@
-<p>There are some situations where modifying the SQLite database that Trilium
- uses is desirable.</p>
-<p>If you are doing any advanced development or troubleshooting where you
- manually modify the database, you might want to consider creating backups
- of your <code>document.db</code> file.</p>
-<h2>Modifying it internally using the SQL Console</h2>
-<p>The SQL Console is Trilium's built-in database editor.</p>
-<p>See&nbsp;<a class="reference-link" href="#root/_help_YKWqdJhzi2VY">SQL Console</a>.</p>
-<h2>Externally modifying the database</h2>
-<p>Sometimes the SQL Console cannot be used (for example if the application
- cannot start).</p>
-<p>When making external modifications, consider closing the desktop application.
- If modifying the server database, then stop the service or Docker container.</p>
-<h3>Using DB Browser for SQLite</h3>
-<p>DB Browser for SQLite is a cross-platform editor that can be used to alter
- the database using a graphical user interface.</p>
-<p>To do so:</p>
-<ol>
- <li>In the main menu, select File → Open database… and navigate to the database
- in the&nbsp;<a href="#root/_help_tAassRL4RSQL">Data directory</a>.</li>
- <li>Select the <em>Execute SQL</em> tab.</li>
- <li>Type in the desired SQL statement.</li>
- <li>Press the "Play" button in the toolbar underneath the "Execute SQL" tab
- (or F5 key).</li>
- <li>Press "Write Changes" in the main toolbar.</li>
- <li>Close the application or close the database.</li>
-</ol>
-<p>
- <img src="Manually altering the database_image.png">
-</p>
-<h3>Using the SQLite CLI</h3>
-<p>First, start the SQLite 3 CLI by specifying the path to the database:</p><pre><code class="language-text-x-trilium-auto">sqlite3 ~/.local/share/trilium-data/document.db</code></pre>
-<ul>
- <li>In the prompt simply type the statement and make sure it ends with a <code>;</code> character.</li>
- <li>To exit, simply type <code>.quit</code> and enter.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Database/Manually altering the database/1_SQL Console_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Database/Manually altering the database/1_SQL Console_image.png
deleted file mode 100644
index a395a969b4..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Database/Manually altering the database/1_SQL Console_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Database/Manually altering the database/SQL Console.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Database/Manually altering the database/SQL Console.html
deleted file mode 100644
index c4f97e894f..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Database/Manually altering the database/SQL Console.html
+++ /dev/null
@@ -1,46 +0,0 @@
-<aside class="admonition important">
- <p>Starting with v0.104.0, backend scripts are disabled by default to reduce
- the attack surface. See&nbsp;<a class="reference-link" href="#root/_help_fiHicjpHjIRJ">Security</a>&nbsp;for
- more information.</p>
-</aside>
-<p>The SQL Console is Trilium's built-in database editor.</p>
-<p>It can be accessed by going to the&nbsp;<a class="reference-link" href="#root/_help_x3i7MxGccDuM">Global menu</a>&nbsp;→
- Advanced → Open SQL Console.</p>
-<p>
- <img src="SQL Console_image.png">
-</p>
-<h3>Interaction</h3>
-<ul>
- <li>Hovering the mouse over one of the tables listed at the top of the document
- will show the columns and their data type.</li>
- <li>Only one SQL statement can be run at once.</li>
- <li>To run the statement, press the <em>Execute</em> icon.</li>
- <li>For queries that return a result, the data will displayed in a table.</li>
- <li>For statements (e.g. <code>INSERT</code>, <code>UPDATE</code>), the number
- of affected rows is displayed.</li>
-</ul>
-<figure class="image">
- <img style="aspect-ratio:1124/571;" src="1_SQL Console_image.png" width="1124"
- height="571">
-</figure>
-<h3>Interacting with the table</h3>
-<p>After executing a query, a table with the results will be displayed:</p>
-<ul>
- <li>Clicking on a column allows sorting ascending or descending.</li>
- <li>Underneath each column there is an input field which allows filtering
- by text.</li>
- <li>Press <kbd>Ctrl</kbd>+<kbd>C</kbd> to copy the current cell to clipboard.</li>
- <li>Multiple cells can be selected by dragging or by holding <kbd>Shift</kbd> +
- arrow keys</li>
- <li>Results are paginated for performance reasons. The controls at the bottom
- of the table can be used to navigate through pages.</li>
-</ul>
-<h3>Saved SQL console</h3>
-<p>SQL queries or commands can be saved into a dedicated note.</p>
-<p>To do so, simply write the query and press the&nbsp;<span class="tn-icon bx bx-save"></span> button.
- Once saved, the note will appear in&nbsp;<a class="reference-link" href="#root/_help_l0tKav7yLHGF">Day Notes</a>&nbsp;by
- default. It is possible to change the default location of saved queries
- by assigning a <code>#sqlConsoleHome</code> <a href="#root/_help_HI6GBBIduIgv">label</a>.</p>
-<p>The note can be locked for editing by pressing the <em>Lock</em> button
- in the note actions section near the title bar. When editing is locked,
- the SQL statement is hidden from view.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Default Note Title.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Default Note Title.html
deleted file mode 100644
index 1323e5e695..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Default Note Title.html
+++ /dev/null
@@ -1,53 +0,0 @@
-<p>When a new note is created, its name is by default "new note". In some
- cases, it can be desirable to have a different or even a dynamic default
- note title.</p>
-<p>For this use case, Trilium (since v0.52) supports <code>#titleTemplate</code> <a
- href="#root/_help_zEY4DaJG4YT5">label</a>. You can create such a label
- for a given note, assign it a value, and this value will be used as a default
- title when creating child notes. As with other labels, you can make it
- inheritable to apply recursively, and you can even place it on the root
- note to have it applied globally everywhere.</p>
-<p>As an example use case, imagine you collect books you've read in a given
- year like this:</p>
-<ul>
- <li>2022 Books
- <ul>
- <li>Neal Stephenson: Anathem, 2008</li>
- <li>Franz Kafka: Die Verwandlung, 1915</li>
- </ul>
- </li>
-</ul>
-<p>Now, to the parent note "2022 Books" you can assign label <code>#titleTemplate="[Author name]: [Book title], [Publication year]"</code>.</p>
-<p>And all children of "2022 Books" will be created with initial title "[Author
- name]: [Book title], [Publication year]". There's no artificial intelligence
- here, the idea is to just prompt you to manually fill in the pieces of
- information into the note title by yourself.</p>
-<h2>Dynamic value</h2>
-<p>The value of <code>#titleTemplate</code> is evaluated at the point of note's
- creation as a JavaScript string, which means it can be enriched with the
- help of JS string interpolation with dynamic data.</p>
-<p>Second variable injected is <code>parentNote</code> which gives access to
- the parent <a href="#root/_help_habiZ3HU8Kw8"><code>FNote</code></a>.</p>
-<p>See also&nbsp;<a class="reference-link" href="#root/_help_KC1HB96bqqHX">Templates</a>&nbsp;which
- provides similar capabilities, including default note's content.</p>
-<h3>Examples</h3>
-<ul>
- <li>Imagine you collect server outage incidents and write some notes. It looks
- like this:
- <ul>
- <li>Incidents
- <ul>
- <li>2022-05-09: System crash</li>
- <li>2022-05-15: Backup delay</li>
- </ul>
- </li>
- <li>You can automatize the date assignment by assigning a label <code>#titleTemplate="${now.format('YYYY-MM-DD')}: "</code> to
- the parent note "Incidents". Whenever a new child note is created, the
- title template is evaluated with the injected <a href="https://day.js.org/docs/en/display/format">now</a> object.</li>
- </ul>
- </li>
- <li>To use a parent's attribute in the title of new notes: <code>#titleTemplate="${parentNote.getLabelValue('authorName')}'s literary works"</code>
- </li>
- <li>To mirror the parent's note title: <code>${parentNote.title}</code>
- </li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/ETAPI (REST API).html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/ETAPI (REST API).html
deleted file mode 100644
index 8454c5f4e7..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/ETAPI (REST API).html
+++ /dev/null
@@ -1,76 +0,0 @@
-<aside class="admonition tip">
- <p>For a quick start, consult the&nbsp;<a class="reference-link" href="#root/_help_9qPsTWBorUhQ">API Reference</a>.</p>
-</aside>
-<p>ETAPI is Trilium's public/external REST API. It is available since Trilium
- v0.50.</p>
-<h2>API clients</h2>
-<p>As an alternative to calling the API directly, there are client libraries
- to simplify this</p>
-<ul>
- <li><a href="https://github.com/Nriver/trilium-py">trilium-py</a>, you can
- use Python to communicate with Trilium.</li>
-</ul>
-<h2>Obtaining a token</h2>
-<p>All operations with the REST API have to be authenticated using a token.
- You can get this token either from Options -&gt; ETAPI or programmatically
- using the <code>/auth/login</code> REST call (see the <a href="https://github.com/TriliumNext/Trilium/blob/master/src/etapi/etapi.openapi.yaml">spec</a>).</p>
-<h2>Authentication</h2>
-<h3>Via the <code>Authorization</code> header</h3><pre><code class="language-text-x-trilium-auto">GET https://myserver.com/etapi/app-info
-Authorization: ETAPITOKEN</code></pre>
-<p>where <code>ETAPITOKEN</code> is the token obtained in the previous step.</p>
-<p>For compatibility with various tools, it's also possible to specify the
- value of the <code>Authorization</code> header in the format <code>Bearer ETAPITOKEN</code> (since
- 0.93.0).</p>
-<h3>Basic authentication</h3>
-<p>Since v0.56 you can also use basic auth format:</p><pre><code class="language-text-x-trilium-auto">GET https://myserver.com/etapi/app-info
-Authorization: Basic BATOKEN</code></pre>
-<ul>
- <li>Where <code>BATOKEN = BASE64(username + ':' + password)</code> - this is
- a standard Basic Auth serialization</li>
- <li>Where <code>username</code> is "etapi"</li>
- <li>And <code>password</code> is the generated ETAPI token described above.</li>
-</ul>
-<p>Basic Auth is meant to be used with tools which support only basic auth.</p>
-<h2>Interaction using Bash scripts</h2>
-<p>It is possible to write simple Bash scripts to interact with Trilium.
- As an example, here's how to obtain the HTML content of a note:</p><pre><code class="language-text-x-trilium-auto">#!/usr/bin/env bash
-
-# Configuration
-TOKEN=z1vA4fkGxjOR_ZXLrZeqHEFOv65yV3882iFCRtNIK9k9iWrHliITNSLQ=
-SERVER=http://localhost:8080
-
-# Download a note by ID
-NOTE_ID="i6ra4ZshJhgN"
-curl "$SERVER/etapi/notes/$NOTE_ID/content" -H "Authorization: $TOKEN" </code></pre>
-<p>Make sure to replace the values of:</p>
-<ul>
- <li><code>TOKEN</code> with your ETAPI token.</li>
- <li><code>SERVER</code> with the correct protocol, host name and port to your
- Trilium instance.</li>
- <li><code>NOTE_ID</code> with an existing note ID to download.</li>
-</ul>
-<p>As another example, to obtain a .zip export of a note and place it in
- a directory called <code>out</code>, simply replace the last statement in
- the script with:</p><pre><code class="language-text-x-trilium-auto">curl -H "Authorization: $TOKEN" \
- -X GET "$SERVER/etapi/notes/$NOTE_ID/export" \
- --output "out/$NOTE_ID.zip"</code></pre>
-<h2>Uploading binary content</h2>
-<p>A JSON request body can only carry text, so the <code>content</code> field
- of <code>POST /etapi/attachments</code> stores exactly the string it receives.
- To upload an image, a PDF or any other binary file, send the raw bytes
- to the content endpoint with the <code>application/octet-stream</code> content
- type. The same applies to the content of a note (<code>PUT /etapi/notes/{noteId}/content</code>).</p>
-<p>To attach a file to a note, create the attachment without content, then
- upload the file to it:</p><pre><code class="language-text-x-trilium-auto">ATTACHMENT_ID=$(curl -s -X POST "$SERVER/etapi/attachments" \
- -H "Authorization: $TOKEN" \
- -H "Content-Type: application/json" \
- -d "{\"ownerId\": \"$NOTE_ID\", \"role\": \"file\", \"mime\": \"application/pdf\", \"title\": \"report.pdf\", \"position\": 10}" \
- | jq -r .attachmentId)
-
-curl -X PUT "$SERVER/etapi/attachments/$ATTACHMENT_ID/content" \
- -H "Authorization: $TOKEN" \
- -H "Content-Type: application/octet-stream" \
- --data-binary @report.pdf</code></pre>
-<p>Use <code>--data-binary</code> rather than <code>-d</code>, which strips
- line breaks from the file. For an image, set <code>role</code> to <code>image</code> and <code>mime</code> to
- the image's type, such as <code>image/png</code>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/ETAPI (REST API)/API Reference.dat b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/ETAPI (REST API)/API Reference.dat
deleted file mode 100644
index e69de29bb2..0000000000
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Hidden Notes.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Hidden Notes.html
deleted file mode 100644
index 406f73abe4..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Hidden Notes.html
+++ /dev/null
@@ -1,182 +0,0 @@
-<figure class="image image-style-align-right">
- <img style="aspect-ratio:263/445;" src="Hidden Notes_image.png" width="263"
- height="445">
-</figure>
-<p>For easy extensibility, a lot of features in Trilium make use of actual
- notes to store information as opposed to having them stored in a separate
- location in the database. This allows some functions such as&nbsp;<a class="reference-link"
- href="#root/_help_zEY4DaJG4YT5">Attributes</a>,&nbsp;<a class="reference-link"
- href="#root/_help_Cq5X6iKQop6R">Relations</a>&nbsp;or even&nbsp;<a class="reference-link"
- href="#root/_help_eIg8jdvaoNNd">Search</a>&nbsp;and&nbsp;<a class="reference-link"
- href="#root/_help_QEAPj01N5f7w">Links</a>&nbsp;to be able to operate on
- them.</p>
-<p>As the name suggests, these notes are hidden to the user by default to
- prevent cluttering the note tree and to prevent them from being accidentally
- deleted.</p>
-<p>The hidden notes are stored in the user's&nbsp;<a class="reference-link"
- href="#root/_help_wX4HbRucYSDD">Database</a>&nbsp;just like normal notes,
- but they have a unique&nbsp;<a class="reference-link" href="#root/_help_m1lbrzyKDaRB">Note ID</a>&nbsp;which
- allows them to be distinguished from the normal ones.</p>
-<h2>Accessing the hidden note tree</h2>
-<p>From the&nbsp;<a class="reference-link" href="#root/_help_x3i7MxGccDuM">Global menu</a>,
- select <em>Advanced</em> → <em>Show Hidden Subtree</em>.</p>
-<h2>Contents of the hidden note tree</h2>
-<p>Here is a brief summary of all the notes within the hidden tree:</p>
-<figure
-class="table">
- <table class="ck-table-resized">
- <colgroup>
- <col style="width:19.93%;">
- <col style="width:80.07%;">
- </colgroup>
- <thead>
- <tr>
- <th>Note</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><a class="reference-link" href="#root/_hidden/_globalNoteMap">Note Map</a>
- </td>
- <td>
- <p>This note is actually opened when the&nbsp;<a class="reference-link" href="#root/_help_bdUJEHsAPYQR">Note Map</a>&nbsp;feature
- that is accessed from the&nbsp;<a class="reference-link" href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>.</p>
- <p>It is possible to create any child notes in it without any additional
- meaning. For example, it can be used to store a list of note maps which
- can be linked to from other notes or <a href="#root/_help_u3YFHC9tQlpm">bookmarked</a>.</p>
- </td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_hidden/_sqlConsole">SQL Console History</a>
- </td>
- <td>
- <p>When SQL queries or commands are executed in the&nbsp;<a class="reference-link"
- href="#root/_help_YKWqdJhzi2VY">SQL Console</a>, they are stored here,
- grouped by month. Only the query is stored and not the results.</p>
- <p>This section can be accessed without going to the hidden tree by simply
- going to the&nbsp;<a class="reference-link" href="#root/_help_x3i7MxGccDuM">Global menu</a>&nbsp;and
- selecting Advanced → Open SQL Console History.</p>
- <p>Notes can be added as children of this tree, but it's generally not recommended
- to do so to not interfere with the normal history process.</p>
- </td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_hidden/_search">Search History</a>
- </td>
- <td>
- <p>Whenever a search is executed from the full&nbsp;<a class="reference-link"
- href="#root/_help_eIg8jdvaoNNd">Search</a>, the query will be stored here,
- grouped by month. Only the search parameters are stored and not the results
- themselves.</p>
- <p>This section can be accessed without going to the hidden tree by simply
- going to the&nbsp;<a class="reference-link" href="#root/_help_x3i7MxGccDuM">Global menu</a>&nbsp;and
- selecting Advanced → Open Search History.</p>
- <p>Notes can be added as children of this tree, but it's generally not recommended
- to do so to not interfere with the normal history process.</p>
- </td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_hidden/_bulkAction">Bulk Action</a>
- </td>
- <td>
- <p>This section is used for&nbsp;<a class="reference-link" href="#root/_help_ivYnonVFBxbQ">Bulk Actions</a>.
- The last configuration for bulk actions will be stored as part of this
- note, each action in its own <code>action</code> label.</p>
- <p>Notes can be added as children of this tree, but there won't be any benefit
- in doing so.</p>
- </td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_hidden/_backendLog">Backend Log</a>
- </td>
- <td>
- <p>This note corresponds to the backend log feature (see&nbsp;<a class="reference-link"
- href="#root/_help_qzNzp9LYQyPT">Error logs</a>).</p>
- <p>This item can be accessed without going to the hidden try by going to
- the&nbsp;<a class="reference-link" href="#root/_help_x3i7MxGccDuM">Global menu</a>&nbsp;and
- selecting Advanced → Show backend log.</p>
- </td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_hidden/_userHidden">User Hidden</a>
- </td>
- <td>This section can be used by <a href="#root/_help_CdNpE2pqjmI6">scripts</a> to
- create their own notes that should not be directly visible to the user.
- The note can be identified by scripts by its unique ID: <code>_userHidden</code>
- </td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_hidden/_lbTplRoot">Launch Bar Templates</a>
- </td>
- <td>
- <p>This section contains the templates for the creation of launchers in the&nbsp;<a
- class="reference-link" href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>.
- It is not possible to create child notes here.</p>
- <p>Theoretically some of the notes here can be customized, but there's not
- much benefit to be had in doing so.</p>
- </td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_hidden/_share">Shared Notes</a>
- </td>
- <td>
- <p>This tree lists all of the notes that are <a href="#root/_help_R9pX4DGra2Vt">shared</a> publicly.
- It can be useful to track down which notes are shared regardless of their
- position in the note tree.</p>
- <p>This section can be accessed without going to the hidden tree simply by
- going to the&nbsp;<a class="reference-link" href="#root/_help_x3i7MxGccDuM">Global menu</a>&nbsp;and
- selecting <em>Show Shared Notes Subtree</em>.</p>
- <p>Sub-notes cannot be created here.</p>
- </td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_hidden/_lbRoot">Launch Bar</a>
- </td>
- <td>
- <p>The tree contains both available and displayed items of the&nbsp;<a class="reference-link"
- href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>.</p>
- <p>This section can be accessed without going to the hidden tree by:</p>
- <ul>
- <li>Going to the&nbsp;<a class="reference-link" href="#root/_help_x3i7MxGccDuM">Global menu</a>&nbsp;and
- selecting <em>Configure Launchbar…</em>.</li>
- <li>Right-clicking an empty space on the&nbsp;<a class="reference-link" href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>&nbsp;and
- selecting <em>Configure Launchbar…</em>.</li>
- </ul>
- <p>Sub-notes cannot be created here.</p>
- </td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_hidden/_options">Options</a>
- </td>
- <td>
- <p>This section stores the list of&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>.</p>
- <p>This section can be accessed without going to the hidden tree by:</p>
- <ul>
- <li>Going to the&nbsp;<a class="reference-link" href="#root/_help_x3i7MxGccDuM">Global menu</a>&nbsp;and
- selecting <em>Options</em>.</li>
- <li>Pressing the dedicated Options icon in the&nbsp;<a class="reference-link"
- href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>.</li>
- </ul>
- </td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_hidden/_lbMobileRoot">Mobile Launch Bar</a>
- </td>
- <td>
- <p>This is very similar to the <em>Launch Bar</em>, but is dedicated for the
- mobile UI only.</p>
- <p>Accessing it outside the <em>Launch Bar</em> is the same as the Launch Bar,
- but needs to be done so from the mobile interface.</p>
- </td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_hidden/_help">User Guide</a>
- </td>
- <td>This is where the note structure for the User Guide is actually stored.
- Only the metadata is stored, as the help itself is present as actual files
- in the application directory.</td>
- </tr>
- </tbody>
- </table>
-</figure>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Hidden Notes_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Hidden Notes_image.png
deleted file mode 100644
index eb59b57b13..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Hidden Notes_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Internal API/API Reference.dat b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Internal API/API Reference.dat
deleted file mode 100644
index e69de29bb2..0000000000
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Metrics.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Metrics.html
deleted file mode 100644
index 7e9a0d344f..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Metrics.html
+++ /dev/null
@@ -1,108 +0,0 @@
-<p>The Trilium Metrics API provides comprehensive monitoring data about your
- Trilium instance, designed for external monitoring systems like Prometheus.</p>
-<h2>Endpoint</h2>
-<ul>
- <li><strong>URL</strong>: <code>/etapi/metrics</code>
- </li>
- <li><strong>Method</strong>: <code>GET</code>
- </li>
- <li><strong>Authentication</strong>: ETAPI token required</li>
- <li><strong>Default Format</strong>: Prometheus text format</li>
-</ul>
-<h2>Authentication</h2>
-<p>You need an ETAPI token to access the metrics endpoint. Get one by:</p><pre><code class="language-text-x-trilium-auto"># Get an ETAPI token
-curl -X POST http://localhost:8080/etapi/auth/login \
- -H "Content-Type: application/json" \
- -d '{"password": "your_password"}'
-</code></pre>
-<h2>Usage</h2>
-<div class="trilium-tabs">
- <section class="trilium-tab">
- <p class="trilium-tab-title">Prometheus Format (Default)</p>
- <div class="trilium-tab-panel"><pre><code class="language-text-x-trilium-auto">curl -H "Authorization: YOUR_ETAPI_TOKEN" \
- http://localhost:8080/etapi/metrics
-</code></pre>
- <p>Returns metrics in Prometheus text format:</p><pre><code class="language-text-x-trilium-auto"># HELP trilium_info Trilium instance information
-# TYPE trilium_info gauge
-trilium_info{version="0.91.6",db_version="231",node_version="v18.17.0"} 1 1701432000
-
-# HELP trilium_notes_total Total number of notes including deleted
-# TYPE trilium_notes_total gauge
-trilium_notes_total 1234 1701432000</code></pre>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title">JSON Format</p>
- <div class="trilium-tab-panel"><pre><code class="language-text-x-trilium-auto">curl -H "Authorization: YOUR_ETAPI_TOKEN" \
- "http://localhost:8080/etapi/metrics?format=json"
-</code></pre>
- <p>Returns detailed metrics in JSON format for debugging or custom integrations.</p>
- </div>
- </section>
-</div>
-<h2>Available Metrics</h2>
-<h3>Instance Information</h3>
-<ul>
- <li><code>trilium_info</code> - Version and build information with labels</li>
-</ul>
-<h3>Database Metrics</h3>
-<ul>
- <li><code>trilium_notes_total</code> - Total notes (including deleted)</li>
- <li><code>trilium_notes_deleted</code> - Number of deleted notes</li>
- <li><code>trilium_notes_active</code> - Number of active notes</li>
- <li><code>trilium_notes_protected</code> - Number of protected notes</li>
- <li><code>trilium_attachments_total</code> - Total attachments</li>
- <li><code>trilium_attachments_active</code> - Active attachments</li>
- <li><code>trilium_revisions_total</code> - Total note revisions</li>
- <li><code>trilium_branches_total</code> - Active branches</li>
- <li><code>trilium_attributes_total</code> - Active attributes</li>
- <li><code>trilium_blobs_total</code> - Total blob records</li>
- <li><code>trilium_etapi_tokens_total</code> - Active ETAPI tokens</li>
- <li><code>trilium_embeddings_total</code> - Note embeddings (if available)</li>
-</ul>
-<h3>Categorized Metrics</h3>
-<ul>
- <li><code>trilium_notes_by_type{type="text|code|image|file"}</code> - Notes
- by type</li>
- <li><code>trilium_attachments_by_type{mime_type="..."}</code> - Attachments
- by MIME type</li>
-</ul>
-<h3>Statistics</h3>
-<ul>
- <li><code>trilium_database_size_bytes</code> - Database size in bytes</li>
- <li><code>trilium_oldest_note_timestamp</code> - Timestamp of oldest note</li>
- <li><code>trilium_newest_note_timestamp</code> - Timestamp of newest note</li>
- <li><code>trilium_last_modified_timestamp</code> - Last modification timestamp</li>
-</ul>
-<h2>Prometheus Configuration</h2>
-<p>Add to your <code>prometheus.yml</code>:</p><pre><code class="language-text-x-trilium-auto">scrape_configs:
- - job_name: 'trilium'
- static_configs:
- - targets: ['localhost:8080']
- metrics_path: '/etapi/metrics'
- bearer_token: 'YOUR_ETAPI_TOKEN'
- scrape_interval: 30s
-</code></pre>
-<h2>Error Responses</h2>
-<ul>
- <li><code>400</code> - Invalid format parameter</li>
- <li><code>401</code> - Missing or invalid ETAPI token</li>
- <li><code>500</code> - Internal server error</li>
-</ul>
-<h2>Grafana Dashboard</h2>
-<figure class="image">
- <img style="aspect-ratio:2594/1568;" src="1_Metrics_image.png" width="2594"
- height="1568">
-</figure>
-<p>You can also use the Grafana Dashboard that has been created for TriliumNext
- - just take the JSON from&nbsp;<a class="reference-link" href="#root/_help_bOP3TB56fL1V">grafana-dashboard.json</a>&nbsp;and
- then import the dashboard, following these screenshots:</p>
-<figure class="image">
- <img style="aspect-ratio:1881/282;" src="2_Metrics_image.png" width="1881"
- height="282">
-</figure>
-<p>Then paste the JSON, and hit load:</p>
-<figure class="image">
- <img style="aspect-ratio:1055/830;" src="Metrics_image.png" width="1055"
- height="830">
-</figure>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Metrics/grafana-dashboard.json b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Metrics/grafana-dashboard.json
deleted file mode 100644
index 2e1e4511ef..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Metrics/grafana-dashboard.json
+++ /dev/null
@@ -1,1335 +0,0 @@
-{
- "annotations": {
- "list": [
- {
- "builtIn": 1,
- "datasource": {
- "type": "grafana",
- "uid": "-- Grafana --"
- },
- "enable": true,
- "hide": true,
- "iconColor": "rgba(0, 211, 255, 1)",
- "name": "Annotations & Alerts",
- "type": "dashboard"
- }
- ]
- },
- "editable": true,
- "fiscalYearStartMonth": 0,
- "graphTooltip": 1,
- "id": 549,
- "links": [],
- "panels": [
- {
- "collapsed": false,
- "gridPos": {
- "h": 1,
- "w": 24,
- "x": 0,
- "y": 0
- },
- "id": 100,
- "panels": [],
- "title": "🏠 Trilium Overview",
- "type": "row"
- },
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "description": "Current Trilium version and build information",
- "fieldConfig": {
- "defaults": {
- "color": {
- "mode": "thresholds"
- },
- "custom": {
- "align": "auto",
- "cellOptions": {
- "type": "auto"
- },
- "filterable": false,
- "inspect": false
- },
- "mappings": [],
- "thresholds": {
- "mode": "absolute",
- "steps": [
- {
- "color": "green"
- }
- ]
- }
- },
- "overrides": []
- },
- "gridPos": {
- "h": 6,
- "w": 12,
- "x": 0,
- "y": 1
- },
- "id": 101,
- "options": {
- "cellHeight": "sm",
- "footer": {
- "countRows": false,
- "fields": "",
- "reducer": [
- "sum"
- ],
- "show": false
- },
- "showHeader": true
- },
- "pluginVersion": "12.0.1",
- "targets": [
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "expr": "trilium_info{job=~'$job',instance=~'$instance'}",
- "format": "table",
- "instant": true,
- "refId": "A"
- }
- ],
- "title": "📋 Instance Information",
- "transformations": [
- {
- "id": "organize",
- "options": {
- "excludeByName": {
- "Time": true,
- "Value": true,
- "__name__": true,
- "instance": true,
- "job": true
- },
- "indexByName": {},
- "renameByName": {
- "build_date": "Build Date",
- "build_revision": "Git Revision",
- "db_version": "DB Version",
- "node_version": "Node.js",
- "sync_version": "Sync Version",
- "version": "Version"
- }
- }
- }
- ],
- "type": "table"
- },
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "description": "Database file size in human-readable format",
- "fieldConfig": {
- "defaults": {
- "color": {
- "mode": "thresholds"
- },
- "mappings": [],
- "thresholds": {
- "mode": "absolute",
- "steps": [
- {
- "color": "green"
- },
- {
- "color": "yellow",
- "value": 500000000
- },
- {
- "color": "red",
- "value": 1000000000
- }
- ]
- },
- "unit": "decbytes"
- },
- "overrides": []
- },
- "gridPos": {
- "h": 6,
- "w": 6,
- "x": 12,
- "y": 1
- },
- "id": 102,
- "options": {
- "colorMode": "background",
- "graphMode": "area",
- "justifyMode": "center",
- "orientation": "auto",
- "percentChangeColorMode": "standard",
- "reduceOptions": {
- "calcs": [
- "lastNotNull"
- ],
- "fields": "",
- "values": false
- },
- "showPercentChange": false,
- "textMode": "auto",
- "wideLayout": true
- },
- "pluginVersion": "12.0.1",
- "targets": [
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "expr": "trilium_database_size_bytes{job=~'$job',instance=~'$instance'}",
- "refId": "A"
- }
- ],
- "title": "💾 Database Size",
- "type": "stat"
- },
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "description": "Total active notes in your Trilium instance",
- "fieldConfig": {
- "defaults": {
- "color": {
- "mode": "thresholds"
- },
- "mappings": [],
- "thresholds": {
- "mode": "absolute",
- "steps": [
- {
- "color": "green"
- },
- {
- "color": "yellow",
- "value": 1000
- },
- {
- "color": "red",
- "value": 5000
- }
- ]
- },
- "unit": "short"
- },
- "overrides": []
- },
- "gridPos": {
- "h": 6,
- "w": 6,
- "x": 18,
- "y": 1
- },
- "id": 103,
- "options": {
- "colorMode": "background",
- "graphMode": "area",
- "justifyMode": "center",
- "orientation": "auto",
- "percentChangeColorMode": "standard",
- "reduceOptions": {
- "calcs": [
- "lastNotNull"
- ],
- "fields": "",
- "values": false
- },
- "showPercentChange": false,
- "textMode": "auto",
- "wideLayout": true
- },
- "pluginVersion": "12.0.1",
- "targets": [
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "expr": "trilium_notes_active{job=~'$job',instance=~'$instance'}",
- "refId": "A"
- }
- ],
- "title": "📝 Active Notes",
- "type": "stat"
- },
- {
- "collapsed": false,
- "gridPos": {
- "h": 1,
- "w": 24,
- "x": 0,
- "y": 7
- },
- "id": 200,
- "panels": [],
- "title": "📊 Key Metrics",
- "type": "row"
- },
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "description": "Total notes including deleted ones",
- "fieldConfig": {
- "defaults": {
- "color": {
- "mode": "palette-classic"
- },
- "custom": {
- "hideFrom": {
- "legend": false,
- "tooltip": false,
- "viz": false
- }
- },
- "mappings": [],
- "unit": "short"
- },
- "overrides": []
- },
- "gridPos": {
- "h": 8,
- "w": 6,
- "x": 0,
- "y": 8
- },
- "id": 201,
- "options": {
- "legend": {
- "displayMode": "list",
- "placement": "bottom",
- "showLegend": true,
- "values": []
- },
- "pieType": "pie",
- "reduceOptions": {
- "calcs": [
- "lastNotNull"
- ],
- "fields": "",
- "values": false
- },
- "tooltip": {
- "hideZeros": false,
- "mode": "single",
- "sort": "none"
- }
- },
- "pluginVersion": "12.0.1",
- "targets": [
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "expr": "trilium_notes_active{job=~'$job',instance=~'$instance'}",
- "legendFormat": "Active Notes",
- "refId": "A"
- },
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "expr": "trilium_notes_deleted{job=~'$job',instance=~'$instance'}",
- "legendFormat": "Deleted Notes",
- "refId": "B"
- },
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "expr": "trilium_notes_protected{job=~'$job',instance=~'$instance'}",
- "legendFormat": "Protected Notes",
- "refId": "C"
- }
- ],
- "title": "📝 Notes Distribution",
- "type": "piechart"
- },
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "description": "Breakdown of attachments by MIME type",
- "fieldConfig": {
- "defaults": {
- "color": {
- "mode": "palette-classic"
- },
- "custom": {
- "hideFrom": {
- "legend": false,
- "tooltip": false,
- "viz": false
- }
- },
- "mappings": [],
- "unit": "short"
- },
- "overrides": []
- },
- "gridPos": {
- "h": 8,
- "w": 6,
- "x": 6,
- "y": 8
- },
- "id": 202,
- "options": {
- "legend": {
- "displayMode": "list",
- "placement": "bottom",
- "showLegend": true,
- "values": []
- },
- "pieType": "donut",
- "reduceOptions": {
- "calcs": [
- "lastNotNull"
- ],
- "fields": "",
- "values": false
- },
- "tooltip": {
- "hideZeros": false,
- "mode": "single",
- "sort": "none"
- }
- },
- "pluginVersion": "12.0.1",
- "targets": [
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "expr": "trilium_attachments_by_type{job=~'$job',instance=~'$instance'}",
- "legendFormat": "{{mime_type}}",
- "refId": "A"
- }
- ],
- "title": "🖼️ Attachments by Type",
- "type": "piechart"
- },
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "description": "Distribution of notes by their content type",
- "fieldConfig": {
- "defaults": {
- "color": {
- "mode": "palette-classic"
- },
- "custom": {
- "hideFrom": {
- "legend": false,
- "tooltip": false,
- "viz": false
- }
- },
- "mappings": [],
- "unit": "short"
- },
- "overrides": []
- },
- "gridPos": {
- "h": 8,
- "w": 12,
- "x": 12,
- "y": 8
- },
- "id": 203,
- "options": {
- "legend": {
- "displayMode": "table",
- "placement": "right",
- "showLegend": true,
- "values": [
- "value",
- "percent"
- ]
- },
- "pieType": "donut",
- "reduceOptions": {
- "calcs": [
- "lastNotNull"
- ],
- "fields": "",
- "values": false
- },
- "tooltip": {
- "hideZeros": false,
- "mode": "single",
- "sort": "none"
- }
- },
- "pluginVersion": "12.0.1",
- "targets": [
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "expr": "trilium_notes_by_type{job=~'$job',instance=~'$instance'}",
- "legendFormat": "{{type}}",
- "refId": "A"
- }
- ],
- "title": "📄 Notes by Content Type",
- "type": "piechart"
- },
- {
- "collapsed": false,
- "gridPos": {
- "h": 1,
- "w": 24,
- "x": 0,
- "y": 16
- },
- "id": 300,
- "panels": [],
- "title": "📈 Trends & Time Series",
- "type": "row"
- },
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "description": "Growth of notes over time",
- "fieldConfig": {
- "defaults": {
- "color": {
- "mode": "palette-classic"
- },
- "custom": {
- "axisBorderShow": false,
- "axisCenteredZero": false,
- "axisColorMode": "text",
- "axisLabel": "",
- "axisPlacement": "auto",
- "barAlignment": 0,
- "barWidthFactor": 0.6,
- "drawStyle": "line",
- "fillOpacity": 20,
- "gradientMode": "hue",
- "hideFrom": {
- "legend": false,
- "tooltip": false,
- "viz": false
- },
- "insertNulls": false,
- "lineInterpolation": "smooth",
- "lineWidth": 3,
- "pointSize": 8,
- "scaleDistribution": {
- "type": "linear"
- },
- "showPoints": "auto",
- "spanNulls": false,
- "stacking": {
- "group": "A",
- "mode": "none"
- },
- "thresholdsStyle": {
- "mode": "off"
- }
- },
- "mappings": [],
- "thresholds": {
- "mode": "absolute",
- "steps": [
- {
- "color": "green"
- }
- ]
- },
- "unit": "short"
- },
- "overrides": [
- {
- "matcher": {
- "id": "byName",
- "options": "Active Notes"
- },
- "properties": [
- {
- "id": "color",
- "value": {
- "fixedColor": "blue",
- "mode": "fixed"
- }
- }
- ]
- },
- {
- "matcher": {
- "id": "byName",
- "options": "Total Notes"
- },
- "properties": [
- {
- "id": "color",
- "value": {
- "fixedColor": "green",
- "mode": "fixed"
- }
- }
- ]
- }
- ]
- },
- "gridPos": {
- "h": 8,
- "w": 12,
- "x": 0,
- "y": 17
- },
- "id": 301,
- "options": {
- "legend": {
- "calcs": [
- "last",
- "max"
- ],
- "displayMode": "table",
- "placement": "bottom",
- "showLegend": true
- },
- "tooltip": {
- "hideZeros": false,
- "mode": "multi",
- "sort": "desc"
- }
- },
- "pluginVersion": "12.0.1",
- "targets": [
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "expr": "trilium_notes_active{job=~'$job',instance=~'$instance'}",
- "legendFormat": "Active Notes",
- "refId": "A"
- },
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "expr": "trilium_notes_total{job=~'$job',instance=~'$instance'}",
- "legendFormat": "Total Notes",
- "refId": "B"
- }
- ],
- "title": "📈 Notes Growth Over Time",
- "type": "timeseries"
- },
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "description": "Attachment storage trends",
- "fieldConfig": {
- "defaults": {
- "color": {
- "mode": "palette-classic"
- },
- "custom": {
- "axisBorderShow": false,
- "axisCenteredZero": false,
- "axisColorMode": "text",
- "axisLabel": "",
- "axisPlacement": "auto",
- "barAlignment": 0,
- "barWidthFactor": 0.6,
- "drawStyle": "line",
- "fillOpacity": 20,
- "gradientMode": "hue",
- "hideFrom": {
- "legend": false,
- "tooltip": false,
- "viz": false
- },
- "insertNulls": false,
- "lineInterpolation": "smooth",
- "lineWidth": 3,
- "pointSize": 8,
- "scaleDistribution": {
- "type": "linear"
- },
- "showPoints": "auto",
- "spanNulls": false,
- "stacking": {
- "group": "A",
- "mode": "none"
- },
- "thresholdsStyle": {
- "mode": "off"
- }
- },
- "mappings": [],
- "thresholds": {
- "mode": "absolute",
- "steps": [
- {
- "color": "green"
- }
- ]
- },
- "unit": "short"
- },
- "overrides": [
- {
- "matcher": {
- "id": "byName",
- "options": "Active Attachments"
- },
- "properties": [
- {
- "id": "color",
- "value": {
- "fixedColor": "purple",
- "mode": "fixed"
- }
- }
- ]
- },
- {
- "matcher": {
- "id": "byName",
- "options": "Total Attachments"
- },
- "properties": [
- {
- "id": "color",
- "value": {
- "fixedColor": "orange",
- "mode": "fixed"
- }
- }
- ]
- }
- ]
- },
- "gridPos": {
- "h": 8,
- "w": 12,
- "x": 12,
- "y": 17
- },
- "id": 302,
- "options": {
- "legend": {
- "calcs": [
- "last",
- "max"
- ],
- "displayMode": "table",
- "placement": "bottom",
- "showLegend": true
- },
- "tooltip": {
- "hideZeros": false,
- "mode": "multi",
- "sort": "desc"
- }
- },
- "pluginVersion": "12.0.1",
- "targets": [
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "expr": "trilium_attachments_active{job=~'$job',instance=~'$instance'}",
- "legendFormat": "Active Attachments",
- "refId": "A"
- },
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "expr": "trilium_attachments_total{job=~'$job',instance=~'$instance'}",
- "legendFormat": "Total Attachments",
- "refId": "B"
- }
- ],
- "title": "📎 Attachments Growth Over Time",
- "type": "timeseries"
- },
- {
- "collapsed": false,
- "gridPos": {
- "h": 1,
- "w": 24,
- "x": 0,
- "y": 25
- },
- "id": 400,
- "panels": [],
- "title": "🔧 Advanced Metrics",
- "type": "row"
- },
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "description": "Number of branches connecting notes",
- "fieldConfig": {
- "defaults": {
- "color": {
- "mode": "thresholds"
- },
- "mappings": [],
- "thresholds": {
- "mode": "absolute",
- "steps": [
- {
- "color": "green"
- }
- ]
- },
- "unit": "short"
- },
- "overrides": []
- },
- "gridPos": {
- "h": 4,
- "w": 6,
- "x": 0,
- "y": 26
- },
- "id": 401,
- "options": {
- "colorMode": "value",
- "graphMode": "none",
- "justifyMode": "center",
- "orientation": "auto",
- "percentChangeColorMode": "standard",
- "reduceOptions": {
- "calcs": [
- "lastNotNull"
- ],
- "fields": "",
- "values": false
- },
- "showPercentChange": false,
- "textMode": "auto",
- "wideLayout": true
- },
- "pluginVersion": "12.0.1",
- "targets": [
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "expr": "trilium_branches_total{job=~'$job',instance=~'$instance'}",
- "refId": "A"
- }
- ],
- "title": "🌳 Total Branches",
- "type": "stat"
- },
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "description": "Number of note attributes",
- "fieldConfig": {
- "defaults": {
- "color": {
- "mode": "thresholds"
- },
- "mappings": [],
- "thresholds": {
- "mode": "absolute",
- "steps": [
- {
- "color": "green"
- }
- ]
- },
- "unit": "short"
- },
- "overrides": []
- },
- "gridPos": {
- "h": 4,
- "w": 6,
- "x": 6,
- "y": 26
- },
- "id": 402,
- "options": {
- "colorMode": "value",
- "graphMode": "none",
- "justifyMode": "center",
- "orientation": "auto",
- "percentChangeColorMode": "standard",
- "reduceOptions": {
- "calcs": [
- "lastNotNull"
- ],
- "fields": "",
- "values": false
- },
- "showPercentChange": false,
- "textMode": "auto",
- "wideLayout": true
- },
- "pluginVersion": "12.0.1",
- "targets": [
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "expr": "trilium_attributes_total{job=~'$job',instance=~'$instance'}",
- "refId": "A"
- }
- ],
- "title": "🏷️ Attributes",
- "type": "stat"
- },
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "description": "Number of note revisions",
- "fieldConfig": {
- "defaults": {
- "color": {
- "mode": "thresholds"
- },
- "mappings": [],
- "thresholds": {
- "mode": "absolute",
- "steps": [
- {
- "color": "green"
- }
- ]
- },
- "unit": "short"
- },
- "overrides": []
- },
- "gridPos": {
- "h": 4,
- "w": 6,
- "x": 12,
- "y": 26
- },
- "id": 403,
- "options": {
- "colorMode": "value",
- "graphMode": "none",
- "justifyMode": "center",
- "orientation": "auto",
- "percentChangeColorMode": "standard",
- "reduceOptions": {
- "calcs": [
- "lastNotNull"
- ],
- "fields": "",
- "values": false
- },
- "showPercentChange": false,
- "textMode": "auto",
- "wideLayout": true
- },
- "pluginVersion": "12.0.1",
- "targets": [
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "expr": "trilium_revisions_total{job=~'$job',instance=~'$instance'}",
- "refId": "A"
- }
- ],
- "title": "🔄 Revisions",
- "type": "stat"
- },
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "description": "Number of ETAPI tokens",
- "fieldConfig": {
- "defaults": {
- "color": {
- "mode": "thresholds"
- },
- "mappings": [],
- "thresholds": {
- "mode": "absolute",
- "steps": [
- {
- "color": "green"
- }
- ]
- },
- "unit": "short"
- },
- "overrides": []
- },
- "gridPos": {
- "h": 4,
- "w": 6,
- "x": 18,
- "y": 26
- },
- "id": 404,
- "options": {
- "colorMode": "value",
- "graphMode": "none",
- "justifyMode": "center",
- "orientation": "auto",
- "percentChangeColorMode": "standard",
- "reduceOptions": {
- "calcs": [
- "lastNotNull"
- ],
- "fields": "",
- "values": false
- },
- "showPercentChange": false,
- "textMode": "auto",
- "wideLayout": true
- },
- "pluginVersion": "12.0.1",
- "targets": [
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "expr": "trilium_etapi_tokens_total{job=~'$job',instance=~'$instance'}",
- "refId": "A"
- }
- ],
- "title": "🔑 API Tokens",
- "type": "stat"
- },
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "description": "Various storage and system metrics",
- "fieldConfig": {
- "defaults": {
- "color": {
- "mode": "palette-classic"
- },
- "custom": {
- "axisBorderShow": false,
- "axisCenteredZero": false,
- "axisColorMode": "text",
- "axisLabel": "",
- "axisPlacement": "auto",
- "barAlignment": 0,
- "barWidthFactor": 0.6,
- "drawStyle": "line",
- "fillOpacity": 10,
- "gradientMode": "none",
- "hideFrom": {
- "legend": false,
- "tooltip": false,
- "viz": false
- },
- "insertNulls": false,
- "lineInterpolation": "linear",
- "lineWidth": 2,
- "pointSize": 5,
- "scaleDistribution": {
- "type": "linear"
- },
- "showPoints": "auto",
- "spanNulls": false,
- "stacking": {
- "group": "A",
- "mode": "none"
- },
- "thresholdsStyle": {
- "mode": "off"
- }
- },
- "mappings": [],
- "thresholds": {
- "mode": "absolute",
- "steps": [
- {
- "color": "green"
- }
- ]
- },
- "unit": "short"
- },
- "overrides": [
- {
- "matcher": {
- "id": "byName",
- "options": "Recent Notes"
- },
- "properties": [
- {
- "id": "color",
- "value": {
- "fixedColor": "yellow",
- "mode": "fixed"
- }
- }
- ]
- }
- ]
- },
- "gridPos": {
- "h": 8,
- "w": 12,
- "x": 0,
- "y": 30
- },
- "id": 405,
- "options": {
- "legend": {
- "calcs": [
- "last"
- ],
- "displayMode": "table",
- "placement": "bottom",
- "showLegend": true
- },
- "tooltip": {
- "hideZeros": false,
- "mode": "multi",
- "sort": "desc"
- }
- },
- "pluginVersion": "12.0.1",
- "targets": [
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "expr": "trilium_blobs_total{job=~'$job',instance=~'$instance'}",
- "legendFormat": "Blob Records",
- "refId": "A"
- },
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "expr": "trilium_recent_notes_total{job=~'$job',instance=~'$instance'}",
- "legendFormat": "Recent Notes",
- "refId": "B"
- },
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "expr": "trilium_embeddings_total{job=~'$job',instance=~'$instance'}",
- "legendFormat": "Embeddings",
- "refId": "C"
- },
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "expr": "trilium_embedding_providers_total{job=~'$job',instance=~'$instance'}",
- "legendFormat": "Embedding Providers",
- "refId": "D"
- }
- ],
- "title": "📊 Storage & System Metrics",
- "type": "timeseries"
- },
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "description": "Timeline showing when content was created and last modified",
- "fieldConfig": {
- "defaults": {
- "color": {
- "mode": "palette-classic"
- },
- "custom": {
- "axisBorderShow": false,
- "axisCenteredZero": false,
- "axisColorMode": "text",
- "axisLabel": "",
- "axisPlacement": "auto",
- "barAlignment": 0,
- "barWidthFactor": 0.6,
- "drawStyle": "points",
- "fillOpacity": 0,
- "gradientMode": "none",
- "hideFrom": {
- "legend": false,
- "tooltip": false,
- "viz": false
- },
- "insertNulls": false,
- "lineInterpolation": "linear",
- "lineWidth": 1,
- "pointSize": 8,
- "scaleDistribution": {
- "type": "linear"
- },
- "showPoints": "always",
- "spanNulls": false,
- "stacking": {
- "group": "A",
- "mode": "none"
- },
- "thresholdsStyle": {
- "mode": "off"
- }
- },
- "mappings": [],
- "thresholds": {
- "mode": "absolute",
- "steps": [
- {
- "color": "green"
- }
- ]
- },
- "unit": "dateTimeAsIso"
- },
- "overrides": []
- },
- "gridPos": {
- "h": 8,
- "w": 12,
- "x": 12,
- "y": 30
- },
- "id": 406,
- "options": {
- "legend": {
- "calcs": [],
- "displayMode": "list",
- "placement": "bottom",
- "showLegend": true
- },
- "tooltip": {
- "hideZeros": false,
- "mode": "single",
- "sort": "none"
- }
- },
- "pluginVersion": "12.0.1",
- "targets": [
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "expr": "trilium_oldest_note_timestamp{job=~'$job',instance=~'$instance'} * 1000",
- "legendFormat": "Oldest Note",
- "refId": "A"
- },
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "expr": "trilium_newest_note_timestamp{job=~'$job',instance=~'$instance'} * 1000",
- "legendFormat": "Newest Note",
- "refId": "B"
- },
- {
- "datasource": {
- "uid": "${datasource}"
- },
- "expr": "trilium_last_modified_timestamp{job=~'$job',instance=~'$instance'} * 1000",
- "legendFormat": "Last Modified",
- "refId": "C"
- }
- ],
- "title": "⏰ Content Timeline",
- "type": "timeseries"
- }
- ],
- "preload": false,
- "refresh": "1m",
- "schemaVersion": 41,
- "tags": [
- "trilium",
- "notes",
- "monitoring",
- "enhanced"
- ],
- "templating": {
- "list": [
- {
- "current": {
- "text": "myprom",
- "value": "PA04845DA3A4B088E"
- },
- "includeAll": false,
- "label": "Datasource",
- "name": "datasource",
- "options": [],
- "query": "prometheus",
- "refresh": 1,
- "regex": "//",
- "type": "datasource"
- },
- {
- "allValue": ".*",
- "current": {
- "text": "All",
- "value": "$__all"
- },
- "datasource": {
- "UID": "",
- "type": ""
- },
- "includeAll": true,
- "label": "Job",
- "multi": true,
- "name": "job",
- "options": [],
- "query": "query_result(up)",
- "refresh": 1,
- "regex": "/job=\"([^\"]+)\"/",
- "sort": 1,
- "type": "query"
- },
- {
- "allValue": ".*",
- "current": {
- "text": [
- "All"
- ],
- "value": [
- "$__all"
- ]
- },
- "datasource": {
- "type": "prometheus",
- "uid": "${datasource}"
- },
- "includeAll": true,
- "label": "Instance",
- "multi": true,
- "name": "instance",
- "options": [],
- "query": "trilium_database_size_bytes",
- "refresh": 1,
- "regex": "/instance=\"([^\"]+)\"/",
- "sort": 1,
- "type": "query"
- }
- ]
- },
- "time": {
- "from": "now-1h",
- "to": "now"
- },
- "timepicker": {},
- "timezone": "browser",
- "title": "TriliumNext Dashboard",
- "uid": "06993f9b-a477-4723-bf18-47743393b382",
- "version": 5
-}
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Metrics_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Metrics_image.png
deleted file mode 100644
index ae68ddd02a..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Metrics_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Nightly release.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Nightly release.html
deleted file mode 100644
index ed3050dd2f..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Nightly release.html
+++ /dev/null
@@ -1,71 +0,0 @@
-<p>Nightly releases are versions built every day, containing the latest improvements
- and bugfixes, directly from the main development branch. These versions
- are generally useful in preparation for a release, to ensure that there
- are no significant bugs that need to be addressed first, or they can be
- used to confirm whether a particular bug is fixed or feature is well implemented.</p>
-<h2>Regarding the stability</h2>
-<p>Despite being on a development branch, generally the main branch is pretty
- stable since PRs are tested before they are merged. If you notice any issues,
- feel free to report them either via a ticket or via the Matrix.</p>
-<h2>Downloading the nightly release manually</h2>
-<p>Go to <a href="https://github.com/TriliumNext/Trilium/releases/tag/nightly">github.com/TriliumNext/Trilium/releases/tag/nightly</a> and
- look for the artifacts starting with <code>TriliumNotes-main</code>. Choose
- the appropriate one for your platform (e.g. <code>windows-x64.zip</code>).</p>
-<p>Depending on your use case, you can either test the portable version or
- even use the installer.</p>
-<aside class="admonition note">
- <p>If you choose the installable version (e.g. the .exe on Windows), it will
- replace your stable installation.</p>
-</aside>
-<aside class="admonition important">
- <p>By default, the nightly uses the same database as the production version.
- Generally you could easily downgrade if needed. However, if there are changes
- to the database or sync version, it will not be possible to downgrade without
- having to restore from a backup.</p>
-</aside>
-<h2>Automatically download and install the latest nightly</h2>
-<p>This is pretty useful if you are a beta tester that wants to periodically
- update their version:</p>
-<div class="trilium-tabs">
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-tux"></span>&nbsp;Ubuntu (Bash)</p>
- <div class="trilium-tab-panel"><pre><code class="language-text-x-sh">#!/usr/bin/env bash
-
-name=TriliumNotes-linux-x64-nightly.deb
-rm -f $name*
-wget https://github.com/TriliumNext/Trilium/releases/download/nightly/$name
-sudo apt-get install ./$name
-rm $name</code></pre>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-windows"></span>&nbsp;Windows (PowerShell)</p>
- <div
- class="trilium-tab-panel"><pre><code class="language-application-x-powershell">if ($env:PROCESSOR_ARCHITECTURE -eq "ARM64") {
- $arch = "arm64";
-} else {
- $arch = "x64";
-}
-
-$exeUrl = "https://github.com/TriliumNext/Trilium/releases/download/nightly/TriliumNotes-main-windows-$($arch).exe";
-Write-Host "Downloading $($exeUrl)"
-
-# Generate a unique path in the temp dir
-$guid = [guid]::NewGuid().ToString()
-$destination = Join-Path -Path $env:TEMP -ChildPath "$guid.exe"
-
-try {
- $ProgressPreference = 'SilentlyContinue'
- Invoke-WebRequest -Uri $exeUrl -OutFile $destination
- $process = Start-Process -FilePath $destination
-} catch {
- Write-Error "An error occurred: $_"
-} finally {
- # Clean up
- if (Test-Path $destination) {
- Remove-Item -Path $destination -Force
- }
-}</code></pre>
- </div>
- </section>
-</div>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Note ID.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Note ID.html
deleted file mode 100644
index 04b1738e55..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Note ID.html
+++ /dev/null
@@ -1,26 +0,0 @@
-<p>Whereas some applications use file names to uniquely identify notes, Trilium
- uses the concept of Note ID.</p>
-<p>Generally, the Note ID is a 12-character long alphanumeric sequence (including
- both lower and upper case letter) that is randomly generated for each new
- note.</p>
-<h2>How does the import/export affect the note IDs</h2>
-<p>When notes are exported, their note ID is kept in the metadata of the
- export. However when they are imported back in, a new note ID is generated
- for all the notes. This also includes other entities that are part of the
- import/export process such as&nbsp;<a class="reference-link" href="#root/_help_0vhv7lsOLy82">Attachments</a>.</p>
-<h2>Note collisions</h2>
-<p>Since the Note ID is a fixed-width randomly generated number, due to the <a
- href="https://en.wikipedia.org/wiki/Pigeonhole_principle">pigeonhole principle</a>,
- there is a possibility that a newly created note will have the same ID
- as an existing note.</p>
-<p>Since the note ID is alphanumeric and the length is 12 we have&nbsp;<span
- class="math-tex">\(62^{12}\)</span>&nbsp;unique IDs. However since we are
- generating them randomly, we can use a collision calculator such as the
- one for <a href="https://alex7kom.github.io/nano-nanoid-cc/?alphabet=0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz&amp;size=12&amp;speed=1000&amp;speedUnit=hour">Nano ID</a> to
- determine that we'd need to create 1000 notes per hour every hour for 9
- centuries in order to have at least 1% probability of a note collision.</p>
-<p>As such, Trilium does not take any explicit action against potential note
- collisions, similar to other software that makes uses of unique hashes
- such as <a href="https://stackoverflow.com/questions/10434326/hash-collision-in-git">Git</a>.
- If one would theoretically occur, what would most likely happen is that
- the existing note will be replaced by the new one.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Note Map (Link map, Tree map).html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Note Map (Link map, Tree map).html
deleted file mode 100644
index f2910812cd..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Note Map (Link map, Tree map).html
+++ /dev/null
@@ -1,113 +0,0 @@
-<p>Note map is a visualization of connections between notes. This provides
- an insight into a structure ("web") of notes.</p>
-<p>There are two types of note map:</p>
-<ul>
- <li>Link Map, which shows relations between notes.</li>
- <li>Note Map, which shows the hierarchical tree structure.</li>
-</ul>
-<h2>Accessing the note map</h2>
-<p>The note map comes into multiple flavors:</p>
-<ul>
- <li>The note map is available in the&nbsp;<a class="reference-link" href="#root/_help_KRlZFoIH0j6p">Connections tab</a>&nbsp;in
- the&nbsp;<a class="reference-link" href="#root/_help_RnaPdbciOfeq">Right Sidebar</a>,
- in the <em>Note map</em> section.
- <ul>
- <li>It can also be accessed by going to&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a>&nbsp;→ <em>Note map</em>,
- which will focus the sidebar at the right section.</li>
- </ul>
- </li>
- <li>To display a full-screen note map, there is a <a href="#root/_help_bdUJEHsAPYQR">dedicated note type</a> with
- the same name.</li>
- <li>To view the global note map (of all the notes in the knowledge base),
- there is a dedicated <em>Note map</em> button in the&nbsp;<a class="reference-link"
- href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>.</li>
-</ul>
-<h2>Terminology and structure</h2>
-<ul>
- <li>Each note is represented as a <em>node</em> in the graph, with the title
- displayed underneath.
- <ul>
- <li>When the map is zoomed out, the title can still be viewed by hovering
- over the node.</li>
- <li>The <a href="#root/_help_p9kXRFAkwN4o">icon and color</a> of the note are
- respected.</li>
- </ul>
- </li>
- <li>The root node is the reference point for which the relations and hierarchical
- structure are displayed.
- <ul>
- <li>When accessing the note map through the&nbsp;<a class="reference-link"
- href="#root/_help_RnaPdbciOfeq">Right Sidebar</a>, the root node is the
- current note.</li>
- <li>When using a dedicated&nbsp;<a class="reference-link" href="#root/_help_bdUJEHsAPYQR">Note Map</a>&nbsp;note,
- the root note can be either the parent note, the currently <a href="#root/_help_OR8WJ7Iz9K4U">hoisted</a> note
- or a specific note. See the note type documentation for more information.</li>
- </ul>
- </li>
-</ul>
-<h2>Interaction</h2>
-<ul>
- <li>Nodes can be dragged around, but they will return to their original position
- once released.
- <ul>
- <li>To have the notes remain in the same position as they were dragged, press
- the <em>Fix nodes</em> button. The position of the notes is not saved, so
- it will return to normal once you navigate to another note or restart the
- application.</li>
- </ul>
- </li>
- <li>When hovering over a node, the adjacent relations and nodes are highlighted.</li>
- <li>The distance between nodes can be adjusted via the slider in the bottom-left.
- Similarly, this value is not saved.</li>
- <li>To zoom, use the mouse wheel, pinch on a touch screen, or press the <span
- class="tn-icon bx bx-plus-circle"></span> and <span class="tn-icon bx bx-minus-circle"></span> buttons
- in the bottom-right corner.
- <ul>
- <li>To bring the whole map back into view, press the <span class="tn-icon bx bx-scan"></span> <em>Fit to view</em> button
- next to them.</li>
- <li>The zoom buttons are not shown on mobile, where pinching zooms instead.
- The <em>Fit to view</em> button is always shown.</li>
- </ul>
- </li>
- <li><a class="reference-link" href="#root/_help_MKmLg5x6xkor">Archived Notes</a>&nbsp;are
- generally ignored by the note map in order to reduce clutter. There is
- one exception: if the root note is also archived, then all archived notes
- are displayed too.</li>
-</ul>
-<h2>Link Map</h2>
-<img src="Note Map (Link map, Tree map)_image.png" width="1425" height="1093">
-<p>The link map is a visualization of links and&nbsp;<a class="reference-link"
- href="#root/_help_Cq5X6iKQop6R">Relations</a>&nbsp;incoming to and outgoing
- from a particular note.</p>
-<p>The map indicates the following types of relations:</p>
-<ul>
- <li><a class="reference-link" href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a>&nbsp;between
- notes.</li>
- <li><a class="reference-link" href="#root/_help_Cq5X6iKQop6R">Relations</a>
- </li>
-</ul>
-<p>The link map will also show unlinked notes that are part of the hierarchy
- as a cloud of unconnected dots. On the&nbsp;<a class="reference-link" href="#root/_help_RnaPdbciOfeq">Right Sidebar</a>&nbsp;deliberately
- omits this in order to save some space, but they will be revealed once
- the map is maximized.</p>
-<h2>Tree Map</h2>
-<p>Shows hierarchical map of notes:</p>
-<figure class="image">
- <img style="aspect-ratio:1420/1490;" src="1_Note Map (Link map, Tree map)_image.png"
- width="1420" height="1490">
-</figure>
-<h2>See also</h2>
-<ul>
- <li>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&nbsp;<a class="reference-link" href="#root/_help_bdUJEHsAPYQR">Note Map</a>&nbsp;for
- more information.</li>
- <li><a class="reference-link" href="#root/_help_iRwzGnHPzonm">Relation Map</a>&nbsp;is
- a similar concept, with some differences:
- <ul>
- <li>note map is automatically generated while relation map must be created
- manually</li>
- <li>relation map is a type of note while a link map is just virtual visualization</li>
- </ul>
- </li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Note Map (Link map, Tree map)_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Note Map (Link map, Tree map)_image.png
deleted file mode 100644
index 60579c57da..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Note Map (Link map, Tree map)_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Note source.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Note source.html
deleted file mode 100644
index eae3955387..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Note source.html
+++ /dev/null
@@ -1,67 +0,0 @@
-<h2>Understanding the source code of the different notes</h2>
-<p>Internally, the structure of the content of each note is different based
- on the&nbsp;<a class="reference-link" href="#root/_help_KSZ04uQ2D1St">Note Types</a>.</p>
-<p>For example:</p>
-<ul>
- <li><a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes&nbsp;are
- represented internally as HTML, using the&nbsp;<a class="reference-link"
- href="#root/_help_MI26XDLSAlCD">CKEditor</a>&nbsp;representation. Note
- that due to the custom plugins, some HTML elements are specific to Trilium
- only, for example the admonitions.</li>
- <li><a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;notes&nbsp;are
- plain text and are represented internally as-is.</li>
- <li><a class="reference-link" href="#root/_help_81SGnPGMk7Xc">Geo Map</a>&nbsp;notes
- contain only minimal information (viewport, zoom) as a JSON.</li>
- <li><a class="reference-link" href="#root/_help_grjYqerjn243">Canvas</a>&nbsp;notes
- are represented as JSON, with Trilium's own information alongside with&nbsp;<a
- href="#root/_help_1YeN2MzFUluU">Excalidraw</a>'s internal JSON representation
- format.</li>
- <li><a class="reference-link" href="#root/_help_gBbsAeiuUxI5">Mind Map</a>&nbsp;notes
- are represented as JSON, with the internal format of&nbsp;<a href="#root/_help_1YeN2MzFUluU">MindElixir</a>.</li>
-</ul>
-<p>Note that some information is also stored as&nbsp;<a class="reference-link"
- href="#root/_help_0vhv7lsOLy82">Attachments</a>. For example&nbsp;<a class="reference-link"
- href="#root/_help_grjYqerjn243">Canvas</a>&nbsp;notes use the attachments
- feature to store the custom libraries, and alongside with&nbsp;<a class="reference-link"
- href="#root/_help_gBbsAeiuUxI5">Mind Map</a>&nbsp;and other similar note
- types it stores an SVG representation of the content for use in other features
- such as including in other notes, shared notes, etc.</p>
-<p>Here's part of the HTML representation of this note, as it's stored in
- the database (but prettified).</p><pre><code class="language-text-x-trilium-auto">&lt;h2&gt;
- Understanding the source code of the different notes
-&lt;/h2&gt;
-&lt;p&gt;
- Internally, the structure of the content of each note is different based on the&amp;nbsp;
- &lt;a class="reference-link" href="#root/_help_KSZ04uQ2D1St"&gt;
- Note Types
- &lt;/a&gt;
- .
-&lt;/p&gt;</code></pre>
-<h2>Viewing the source code</h2>
-<p>It is possible to view the source code of a note by pressing the contextual
- menu in&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a>&nbsp;and
- selecting <em>Note source</em>.</p>
-<p>
- <img src="Note source_image.png">
-</p>
-<p>The source code will be displayed in a new tab.</p>
-<p>For some note types, such as text notes and JSON notes, the source code
- is also formatted in order to be more easily readable.</p>
-<h2>Modifying the source code</h2>
-<p>It is possible to modify the source code of a note directly, however not
- via the <em>Note source</em> functionality.&nbsp;</p>
-<p>To do so:</p>
-<ol>
- <li>Change the note type from the real note type (e.g. Canvas, Geo Type) to
- Code (plain text) or the corresponding format such as JSON or HTML.</li>
- <li>Confirm the warning about changing the note type.</li>
- <li>The source code will appear, make the necessary modifications.</li>
- <li>Change the note type back to the real note type.</li>
-</ol>
-<aside class="admonition warning">
- <p>Depending on the changes made, there is a risk that the note will not
- render properly. It's best to save a revision before making any big changes.</p>
- <p>If the note does not render properly, modify the source code again or
- revert to a prior revision. Since the error handling for unexpected changes
- might not always be perfect, it be required to refresh the application.</p>
-</aside>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Note source_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Note source_image.png
deleted file mode 100644
index 71f0ddf4ae..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Note source_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Read-only database.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Read-only database.html
deleted file mode 100644
index c4aa76de75..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Read-only database.html
+++ /dev/null
@@ -1,41 +0,0 @@
-<aside class="admonition warning">
- <p>This functionality is still in preview, expect possible issues or even
- the feature disappearing completely.
- <br>Feel free to <a href="#root/_help_wy8So3yZZlH9">report</a> any issues you
- might have.</p>
-</aside>
-<p>The read-only database is an alternative to&nbsp;<a class="reference-link"
- href="#root/_help_R9pX4DGra2Vt">Sharing</a>&nbsp;notes. Although the share
- functionality works pretty well to publish pages to the Internet in a wiki,
- blog-like format it does not offer the full functionality behind Trilium
- (such as the advanced&nbsp;<a class="reference-link" href="#root/_help_eIg8jdvaoNNd">Search</a>&nbsp;or
- the interactivity behind&nbsp;<a class="reference-link" href="#root/_help_GTwFsgaA0lCt">Collections</a>&nbsp;or
- the various&nbsp;<a class="reference-link" href="#root/_help_KSZ04uQ2D1St">Note Types</a>).</p>
-<p>When the database is in read-only mode, the Trilium application can be
- used as normal, but editing is disabled and changes are made in-memory
- only.</p>
-<h2>What it does</h2>
-<ul>
- <li>All notes are read-only, without the possibility of editing them.</li>
- <li>Features that would normally alter the database such as the list of recent
- notes are disabled.</li>
-</ul>
-<h2>Limitations</h2>
-<ul>
- <li>Some features might “slip through” and still end up creating a note, for
- example.
- <ul>
- <li>However, the database is still read-only, so all modifications will be
- reset if the server is restarted.</li>
- <li>Whenever this occurs, <code>ERROR: read-only DB ignored</code> will be shown
- in the logs.</li>
- </ul>
- </li>
-</ul>
-<h2>Setting a database as read-only</h2>
-<p>First, make sure the database is initialized (e.g. the first set up is
- complete). Then modify the <a href="#root/_help_Gzjqa934BdH4">config.ini</a> by
- looking for the <code>[General]</code> section and adding a new <code>readOnly</code> field:</p><pre><code class="language-text-x-trilium-auto">[General]
-readOnly=true</code></pre>
-<p>If your server is already running, restart it to apply the changes.</p>
-<p>Similarly, to disable read-only remove the line or set it to <code>false</code>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Safe mode.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Safe mode.html
deleted file mode 100644
index 93098d7e30..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Safe mode.html
+++ /dev/null
@@ -1,14 +0,0 @@
-<p>Safe mode is triggered by setting the <code>TRILIUM_SAFE_MODE</code> environment
- variable to a truthy value, usually <code>1</code>.</p>
-<p>In each artifact there is a <code>trilium-safe-mode.sh</code> (or <code>.bat</code>)
- script to enable it.</p>
-<p>What it does:</p>
-<ul>
- <li>Disables <code>customWidget</code> launcher types in <code>app/widgets/containers/launcher.js</code>.</li>
- <li>Disables the running of <code>mobileStartup</code> or <code>frontendStartup</code> scripts.</li>
- <li>Displays the root note instead of the previously saved session.</li>
- <li>Does not run a <a class="reference-link" href="#root/_help_m523cpzocqaD">Saved Search</a> when
- it is opened; press <em>Search now</em> to run it.</li>
- <li>Disables the running of <code>backendStartup</code>, <code>hourly</code>, <code>daily</code> scripts
- and checks for the hidden subtree.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Sharing.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Sharing.html
deleted file mode 100644
index 0574bacc9a..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Sharing.html
+++ /dev/null
@@ -1,562 +0,0 @@
-<p>Trilium allows you to share selected notes as <strong>publicly accessible</strong> read-only
- documents. This feature is particularly useful for publishing content directly
- from your Trilium notes, making it accessible to others online.</p>
-<figure
-class="image">
- <img style="aspect-ratio:1144/660;" src="Sharing_image.png" width="1144"
- height="660">
-</figure>
-<h2>Features, interaction and limitations</h2>
-<ul>
- <li>Searching by note title.</li>
- <li>Light and dark mode, following the visitor's system setting by default,
- also while the page is open. The visitor can pick <em>Light</em>, <em>Dark</em> or <em>System</em> with
- the buttons at the top of the navigation pane; the choice is remembered
- by the browser.</li>
- <li>A layout centered on wide screens, with the navigation tree and the table
- of contents at either side of the content, and a mobile-friendly layout
- on narrow ones. There, the navigation tree slides in from the menu button
- in the header, and lists the headings of the current page below its entry
- (at the top of the pane, for a page the tree does not show).</li>
- <li>Collapsible tree with the same note icons as the application. It keeps
- the sections the visitor expanded and its scroll position while they move
- between the pages of the site, and shows the current note.</li>
- <li>Customizable logo.</li>
- <li>Quick navigation buttons (previous and next note).</li>
- <li>Notes that hide their children from the tree with <code>#subtreeHidden</code> (such
- as a <a class="reference-link" href="#root/_help_CtBQqbwXDx1w">Kanban Board</a>)
- show a badge counting them in place of listing them. The page of one of
- those children shows only that child below its parent, and the previous
- and next buttons skip them.</li>
- <li>The subpages of a text or code note shown below its content as cards,
- as in the application. Each card shows the icon of the subpage and the
- start of its text (or its <code>#shareDescription</code>), or, for a subpage
- without text, links to its own first subpages. The cards can be hidden
- with <code>#hideChildrenOverview</code>.</li>
- <li>Displaying the date of the last update of the note, written out in the
- application's language.</li>
- <li>Marking the page with the application's language and its text direction,
- and the content of the note with its own <a href="#root/_help_veGu4faJErEM">content language</a>,
- for screen readers and right-to-left text.</li>
-</ul>
-<h3>By note type</h3>
-<figure class="table">
- <table class="ck-table-resized">
- <colgroup>
- <col style="width:19.92%;">
- <col style="width:41.66%;">
- <col style="width:38.42%;">
- </colgroup>
- <thead>
- <tr>
- <th>&nbsp;</th>
- <th>Supported features</th>
- <th>Limitations</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <th><a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>
- </th>
- <td>
- <ul>
- <li>Table of contents.</li>
- <li>A link next to each heading, shown while the pointer is over the heading.
- Clicking it shows the address of the section in the address bar of the
- browser and copies it, to share a link to the section.</li>
- <li>Syntax highlight of code blocks, in the language selected for each block
- and in the colors of the VS Code light or dark theme, following the page's
- mode. For “Auto-detected” blocks, the language is guessed among the ones
- enabled in <a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a> → <em>Code Notes</em>;
- a language not enabled there is not highlighted.</li>
- <li>Rendering for math equations.</li>
- <li><a href="#root/_help_nBAXQFj20hS1">Including notes</a> (only if the included
- notes are also shared).</li>
- <li>Drawing canvases, shown as pictures at their own size.</li>
- <li>Mermaid diagrams in code blocks, drawn in the page's light or dark mode
- and redrawn when the visitor switches it.</li>
- </ul>
- </td>
- <td>&nbsp;</td>
- </tr>
- <tr>
- <th><a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>
- </th>
- <td>
- <ul>
- <li>Basic support (displaying the contents of the note in a monospace font).</li>
- </ul>
- </td>
- <td>
- <ul>
- <li>No syntax highlight.</li>
- </ul>
- </td>
- </tr>
- <tr>
- <th><a class="reference-link" href="#root/_help_m523cpzocqaD">Saved Search</a>
- </th>
- <td>Not supported.</td>
- <td>&nbsp;</td>
- </tr>
- <tr>
- <th><a class="reference-link" href="#root/_help_iRwzGnHPzonm">Relation Map</a>
- </th>
- <td>Not supported.</td>
- <td>&nbsp;</td>
- </tr>
- <tr>
- <th><a class="reference-link" href="#root/_help_bdUJEHsAPYQR">Note Map</a>
- </th>
- <td>Not supported.</td>
- <td>&nbsp;</td>
- </tr>
- <tr>
- <th><a class="reference-link" href="#root/_help_HcABDtFCkbFN">Render Note</a>
- </th>
- <td>Not supported.</td>
- <td>&nbsp;</td>
- </tr>
- <tr>
- <th><a class="reference-link" href="#root/_help_GTwFsgaA0lCt">Collections</a>
- </th>
- <td>
- <ul>
- <li>The child notes are shown as cards, or as a list when the view type of
- the collection is <em>List</em>. Each shows its icon and the start of its
- text (or its <code>#shareDescription</code>), or, for a child note without
- text, links to its own first child notes.</li>
- </ul>
- </td>
- <td>
- <ul>
- <li>The calendar, table, board, geo map, dashboard and presentation view types
- are shown as in the app, but read-only.</li>
- </ul>
- </td>
- </tr>
- <tr>
- <th><a class="reference-link" href="#root/_help_s1aBHPd79XYj">Mermaid Diagrams</a>
- </th>
- <td>
- <ul>
- <li>The diagram is drawn in the page's light or dark mode and redrawn when
- the visitor switches it. In browsers with JavaScript disabled, the image
- saved when the note was last edited is shown instead, and the source of
- the diagram can be expanded below it.</li>
- <li>The diagram fills the page and can be zoomed with the <span class="tn-icon bx bx-minus-circle"></span> and <span
- class="tn-icon bx bx-plus-circle"></span> buttons in its bottom corner
- or with the mouse wheel, between 50% and 1000% of its fitted size, and
- on touch screens by pinching. Clicking the percentage between the buttons,
- or double-clicking the diagram, shows it whole again. The diagram can be
- panned by dragging it.</li>
- </ul>
- </td>
- <td>&nbsp;</td>
- </tr>
- <tr>
- <th><a class="reference-link" href="#root/_help_grjYqerjn243">Canvas</a>
- </th>
- <td>
- <ul>
- <li>The diagram is displayed as a vector image.</li>
- </ul>
- </td>
- <td>
- <ul>
- <li>No further interaction supported.</li>
- </ul>
- </td>
- </tr>
- <tr>
- <th><a class="reference-link" href="#root/_help_1vHRoWCEjj0L">Web View</a>
- </th>
- <td>Not supported.</td>
- <td>&nbsp;</td>
- </tr>
- <tr>
- <th><a class="reference-link" href="#root/_help_gBbsAeiuUxI5">Mind Map</a>
- </th>
- <td>The diagram is displayed as a vector image.</td>
- <td>
- <ul>
- <li>No further interaction supported.</li>
- </ul>
- </td>
- </tr>
- <tr>
- <th><a class="reference-link" href="#root/_help_81SGnPGMk7Xc">Geo Map</a>
- </th>
- <td>Not supported.</td>
- <td>&nbsp;</td>
- </tr>
- <tr>
- <th><a class="reference-link" href="#root/_help_W8vYD3Q1zjCR">File</a>
- </th>
- <td>Basic interaction (downloading the file).</td>
- <td>
- <ul>
- <li>No further interaction supported.</li>
- </ul>
- </td>
- </tr>
- </tbody>
- </table>
-</figure>
-<p>While the sharing feature is powerful, it has some limitations:</p>
-<ul>
- <li><strong>Code Notes</strong>: No syntax highlighting.</li>
- <li><strong>Static Note Tree</strong>
- </li>
- <li><strong>Protected Notes</strong>: Cannot be shared.</li>
- <li><strong>Include Notes</strong>: Not supported.</li>
-</ul>
-<p>Some of these limitations may be addressed in future updates.</p>
-<h2>Prerequisites</h2>
-<p>To use the sharing feature, you must have a&nbsp;<a class="reference-link"
- href="#root/_help_WOcw2SLH6tbX">Server Installation</a>&nbsp;of Trilium.
- This is necessary because the notes will be hosted from the server.</p>
-<h2>Sharing a note</h2>
-<ol>
- <li>
- <p><strong>Enable Sharing</strong>: To share a note, toggle the <code>Shared</code> switch
- within the note's interface. Once sharing is enabled, an URL will appear,
- which you can click to access the shared note.</p>
- <p>
- <img src="Sharing_share-single-note.png" alt="Share Note">
- </p>
- </li>
- <li>
- <p><strong>Access the Shared Note</strong>: The link provided will open the
- note in your browser. If your server is not configured with a public IP,
- the URL will refer to <code>localhost (127.0.0.1)</code>.</p>
- </li>
-</ol>
-<h2>Sharing a note subtree</h2>
-<p>When you share a note, you actually share the entire subtree of notes
- beneath it. If the note has child notes, they will also be included in
- the shared content. For example, sharing the "Formatting" subtree will
- display a page with basic navigation for exploring all the notes within
- that subtree.</p>
-<h2>Viewing and managing shared notes</h2>
-<p>You can view a list of all shared notes by clicking on "Show Shared Notes
- Subtree" in the&nbsp;<a class="reference-link" href="#root/_help_x3i7MxGccDuM">Global menu</a>.
- This allows you to manage and navigate through all the notes you have made
- public.</p>
-<h2>Security considerations</h2>
-<ul>
- <li>Shared notes are published on the open internet and can be accessed by
- anyone with the URL unless the notes are password-protected.</li>
- <li>The URL's randomness does not provide security, so it is crucial not to
- share sensitive information through this feature.</li>
- <li>Trilium takes precautions to protect your publicly shared instance from
- leaking information for non-shared notes, including opening a separate
- read-only connection to the&nbsp;<a class="reference-link" href="#root/_help_wX4HbRucYSDD">Database</a>.
- Depending on your threat model, it might make more sense to use&nbsp;<a
- class="reference-link" href="#root/_help_ycBFjKrrwE9p">Exporting static HTML for web publishing</a>&nbsp;and
- use battle-tested web servers such as Nginx or Apache to serve static content.</li>
-</ul>
-<h3>Password protection</h3>
-<p>To protect shared notes with a username and password, you can use the <code>#shareCredentials</code> attribute.
- Add this label to the note with the format <code>#shareCredentials="username:password"</code>.
- To protect an entire subtree, make sure the label is <a href="#root/_help_bwZpz2ajCEwO">inheritable</a>.</p>
-<h2>Advanced sharing options</h2>
-<h3>Customizing the appearance of shared notes</h3>
-<p>The default design should be a good starting point, but you can customize
- it using your own CSS:</p>
-<ul>
- <li><strong>Custom CSS</strong>: Link a CSS&nbsp;<a class="reference-link"
- href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;note to the shared page by
- adding a <code>~shareCss</code> relation to the note. If you want this style
- to apply to the entire subtree, make the label inheritable. You can hide
- the CSS code note from the tree navigation by adding the <code>#shareHiddenFromTree</code> label.</li>
- <li><strong>Omitting Default CSS</strong>: For extensive styling changes,
- use the <code>#shareOmitDefaultCss</code> label to avoid conflicts with Trilium's <a
- href="#root/_help_Wy267RK4M69c">default stylesheet</a>.</li>
-</ul>
-<h3>Adding JavaScript</h3>
-<p>You can inject custom JavaScript into the shared note using the <code>~shareJs</code> relation.
- This allows you to access note attributes or traverse the note tree using
- the <code>fetchNote()</code> API, which retrieves note data based on its
- ID.</p>
-<h3>Adding custom HTML</h3>
-<p>You can inject custom HTML snippets into specific locations of the shared
- page using the <code>~shareHtml</code> relation. The HTML note should contain
- the raw HTML content you want to inject, and you can control where it appears
- by adding the <code>#shareHtmlLocation</code> label to the HTML snippet note
- itself.</p>
-<p>The <code>#shareHtmlLocation</code> label accepts values in the format <code>location:position</code>:</p>
-<ul>
- <li><strong>Locations</strong>: <code>head</code>, <code>body</code>, <code>content</code>
- </li>
- <li><strong>Positions</strong>: <code>start</code>, <code>end</code>
- </li>
-</ul>
-<p>For example:</p>
-<ul>
- <li><code>#shareHtmlLocation=head:start</code> - Injects HTML at the beginning
- of the <code>&lt;head&gt;</code> section</li>
- <li><code>#shareHtmlLocation=head:end</code> - Injects HTML at the end of the <code>&lt;head&gt;</code> section
- (default)</li>
- <li><code>#shareHtmlLocation=body:start</code> - Injects HTML at the beginning
- of the <code>&lt;body&gt;</code> section</li>
- <li><code>#shareHtmlLocation=content:start</code> - Injects HTML at the beginning
- of the content area</li>
- <li><code>#shareHtmlLocation=content:end</code> - Injects HTML at the end of
- the content area</li>
-</ul>
-<p>If no location is specified, the HTML will be injected at <code>content:end</code> by
- default.</p>
-<p>Example:</p><pre><code class="language-text-javascript">const currentNote = await fetchNote();
-const parentNote = await fetchNote(currentNote.parentNoteIds[0]);
-
-for (const attr of parentNote.attributes) {
- console.log(attr.type, attr.name, attr.value);
-}</code></pre>
-<h3>Custom share templates</h3>
-<p>To completely redesign the share, it is possible to create or use an existing <a
- href="#root/_help_Ad7Ku5gOHrDU">custom share template</a>.</p>
-<h3>Creating human-readable URL aliases</h3>
-<p>Shared notes typically have URLs like <code>http://domain.tld/share/knvU8aJy4dJ7</code>,
- where the last part is the note's ID. You can make these URLs more user-friendly
- by adding the <code>#shareAlias</code> label to individual notes (e.g., <code>#shareAlias=highlighting</code>).
- This will change the URL to <code>http://domain.tld/share/highlighting</code>.
- The URL with the note's ID keeps working and redirects to the alias.</p>
-<p><strong>Important</strong>:</p>
-<ol>
- <li>Ensure that aliases are unique.</li>
- <li>Using slashes (<code>/</code>) within aliases to create subpaths is not
- supported.</li>
-</ol>
-<aside class="admonition tip">
- <ul>
- <li>To easily identify pages that don't have a share alias, run a&nbsp;<a
- class="reference-link" href="#root/_help_eIg8jdvaoNNd">Search</a>&nbsp;with <code>#!shareAlias</code>.</li>
- <li>To be able to enter the share alias faster, consider using&nbsp;<a class="reference-link"
- href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;(for example <code>#label:shareAlias(inheritable)="promoted,alias=Slug,single,text"</code>).</li>
- </ul>
-</aside>
-<h3>Setting a custom favicon</h3>
-<p>To customize the favicon for your shared pages, create a relation <code>~shareFavicon</code> pointing
- to a file note containing the favicon (e.g., in <code>.ico</code> format).</p>
-<h3>Sharing a note as the root</h3>
-<p>You can designate a specific note or folder as the root of your shared
- content by adding the <code>#shareRoot</code> label. This note will be linked
- when visiting <code>[http://domain.tld/share](http://domain/share)</code>,
- making it easier to use Trilium as a fully-fledged website.</p>
-<aside class="admonition tip">
- <p>Consider combining this with the <code>#shareIndex</code> label, which will
- display a list of all shared notes.</p>
-</aside>
-<h3>Displaying an index of shared notes</h3>
-<p>When accessing a share, the sub-notes will be displayed in a tree on the
- left. But since multiple note trees can be shared, it might be useful to
- display a list of all the different share trees.</p>
-<p>To do so, create a shared text note and apply the <code>shareIndex</code> label.
- When viewed, the list of shared roots will be displayed at the bottom of
- the note.</p>
-<h3>Linking to an external website</h3>
-<p>Sometimes it's useful to include a link to an external website alongside
- your shared notes — for example in the shared navigation or in an index.
- To do so, add the <code>#shareExternalLink</code> label to a note, with the
- target URL as its value (e.g. <code>#shareExternalLink="https://example.com"</code>).</p>
-<p>Any link pointing to this note will then redirect to the external website
- and open in a new browser tab, instead of opening the note's own shared
- page. Opening the note's shared URL by its ID also redirects to the external
- website. This applies to:</p>
-<ul>
- <li>the listing produced by the <code>#shareIndex</code> label;</li>
- <li>the navigation tree of the shared site;</li>
- <li>the "Subpages" list shown under a parent note;</li>
- <li>inline links to this note from within other shared notes.</li>
-</ul>
-<p>The URL must be absolute and include the scheme (e.g. <code>https://</code>).</p>
-<aside
-class="admonition note">
- <p>The note still exists in the share tree and its own page remains reachable
- by its direct URL — the label only changes how links to it behave.</p>
-</aside>
-<h2>Attribute reference</h2>
-<figure class="table">
- <table class="ck-table-resized">
- <colgroup>
- <col style="width:18.38%;">
- <col style="width:81.62%;">
- </colgroup>
- <thead>
- <tr>
- <th>Attribute</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>#shareHiddenFromTree</code>
- </td>
- <td>this note is hidden from the left navigation tree, from its parent's list
- of subpages, from shared note maps and from the share's search, but still
- accessible with its URL</td>
- </tr>
- <tr>
- <td><code>#shareExternalLink</code>
- </td>
- <td>when a link points to this note (from the share index, a subpage list,
- or an inline link in another shared note), it redirects to the given external
- URL in a new tab instead of the note's shared page. Value is the absolute
- URL, e.g. <code>https://example.com</code>.</td>
- </tr>
- <tr>
- <td><code>#shareAlias</code>
- </td>
- <td>define an alias using which the note will be available under <code>https://your_trilium_host/share/[your_alias]</code>
- </td>
- </tr>
- <tr>
- <td><code>#shareOmitDefaultCss</code>
- </td>
- <td>default share page CSS will be omitted. Use when you make extensive styling
- changes.</td>
- </tr>
- <tr>
- <td><code>#shareRoot</code>
- </td>
- <td>marks note which is served on /share root.</td>
- </tr>
- <tr>
- <td><code>#shareDescription</code>
- </td>
- <td>define text to be added to the HTML meta tag for description. It also
- describes the note in the list of subpages of its parent, in place of the
- start of its text.</td>
- </tr>
- <tr>
- <td><code>#shareRaw</code>
- </td>
- <td>Note will be served in its raw format, without HTML wrapper. See also&nbsp;<a
- class="reference-link" href="#root/_help_Qjt68inQ2bRj">Serving directly the content of a note</a>&nbsp;for
- an alternative method without setting an attribute.</td>
- </tr>
- <tr>
- <td><code>#shareDisallowRobotIndexing</code>
- </td>
- <td>
- <p>Indicates to web crawlers that the page should not be indexed of this
- note by:</p>
- <ul>
- <li>Setting the <code>X-Robots-Tag: noindex</code> HTTP header.</li>
- <li>Setting the <code>noindex, follow</code> meta tag.</li>
- </ul>
- </td>
- </tr>
- <tr>
- <td><code>#shareCredentials</code>
- </td>
- <td>require credentials to access this shared note. Value is expected to be
- in format <code>username:password</code>. Don't forget to make this inheritable
- to apply to child-notes/images.</td>
- </tr>
- <tr>
- <td><code>#shareIndex</code>
- </td>
- <td>Note with this label will list all roots of shared notes.</td>
- </tr>
- <tr>
- <td><code>#shareHtmlLocation</code>
- </td>
- <td>defines where custom HTML injected via <code>~shareHtml</code> relation
- should be placed. Applied to the HTML snippet note itself. Format: <code>location:position</code> where
- location is <code>head</code>, <code>body</code>, or <code>content</code> and
- position is <code>start</code> or <code>end</code>. Defaults to <code>content:end</code>.</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<h3>Customizing logo</h3>
-<p>It's possible to adjust the logo which is displayed above the navigation
- tree (in the header, on a narrow screen).</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Attribute</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>~shareLogo</code>
- </td>
- <td>Relation set to an image to use as logo. The image must be part of the
- share tree (it can be hidden if needed). Without it, the logo is the icon
- of the shared root note.</td>
- </tr>
- <tr>
- <td><code>#shareLogoWidth</code>
- </td>
- <td>The width of the logo, as a number without unit. With <code>#shareLogoHeight</code>,
- it sets the proportions of the logo, which is shown 32 pixels wide. Default
- is <code>53</code>.</td>
- </tr>
- <tr>
- <td><code>#shareLogoHeight</code>
- </td>
- <td>The height of the logo, as a number without unit. With <code>#shareLogoWidth</code>,
- it sets the proportions of the logo. Default is <code>40</code>.</td>
- </tr>
- <tr>
- <td><code>#shareRootLink</code>
- </td>
- <td>URL to navigate to when the logo is pressed.</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<h3>Customizing OpenGraph</h3>
-<p>A meta-property is left out of the page when its attribute is not set.
- Without an image, link previews use a small card.</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Attribute</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>#shareOpenGraphColor</code>
- </td>
- <td>This adjusts the <code>theme-color</code> meta-property.</td>
- </tr>
- <tr>
- <td><code>#shareOpenGraphURL</code>
- </td>
- <td>This adjusts the <code>og:url</code> and <code>twitter:url</code> meta-properties.
- It is also the address a relative <code>og:image</code> is completed with,
- so it should be the public address of the shared site, such as <code>https://example.com/share/</code>.</td>
- </tr>
- <tr>
- <td><code>#shareOpenGraphDomain</code>
- </td>
- <td>Adjusts the <code>twitter:domain</code> meta-property.</td>
- </tr>
- <tr>
- <td><code>#shareOpenGraphImage</code>&nbsp;
- <br><code>~shareOpenGraphImage</code>
- </td>
- <td>Can be either a label with the address of an image, or a relation to an
- image&nbsp;<a class="reference-link" href="#root/_help_W8vYD3Q1zjCR">File</a>.
- This controls the <code>og:image</code> meta-property. Sites that show a
- preview of the link load the image from their own servers, so a relative
- address, which the relation always gives, is completed with <code>#shareOpenGraphURL</code>;
- without it, the image does not show in such previews.</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<h2>Credits</h2>
-<p>Since v0.95.0, a new theme was introduced (and enabled by default) which
- greatly improves the visual aspect of the Share feature, as well as its
- functionality (such as mobile support, dark/light mode, collapsible tree,
- etc.). This theme is an adaptation of the <a href="https://github.com/zerebos/trilium.rocks">Trilium Rocks!</a> by <a
- href="https://github.com/zerebos">zerebos</a>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Sharing/1_Serving directly the content of a note_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Sharing/1_Serving directly the content of a note_image.png
deleted file mode 100644
index 23592294b1..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Sharing/1_Serving directly the content of a note_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Sharing/Custom share template.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Sharing/Custom share template.html
deleted file mode 100644
index 8b492e7956..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Sharing/Custom share template.html
+++ /dev/null
@@ -1,220 +0,0 @@
-<aside class="admonition note">
- <p>This topic of creating share templates is considered advanced and requires
- JavaScript/EJS knowledge.</p>
- <p>The default share template should cover most normal uses.</p>
-</aside>
-<p>For full control over the HTML structure of a shared page — beyond what
- custom CSS, JS, or HTML snippets allow — you can replace the page template
- entirely using the <code>~shareTemplate</code> relation.</p>
-<p>To do so:</p>
-<ol>
- <li>Create a&nbsp;<a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;note
- with the language <em>Embedded JavaScript</em> (EJS).</li>
- <li>For a shared note to apply the newly created template, apply the <code>~shareTemplate</code> relation
- pointing to the note created at step (1). Make use of&nbsp;<a class="reference-link"
- href="#root/_help_bwZpz2ajCEwO">Attribute Inheritance</a>&nbsp;to apply
- it to multiple shared notes.</li>
-</ol>
-<p>There are two important constraints to be aware of:</p>
-<ul>
- <li>Because EJS templates execute arbitrary server-side JavaScript, <code>~shareTemplate</code> only
- takes effect when backend scripting is enabled. If it is disabled (see&nbsp;<a
- class="reference-link" href="#root/_help_fiHicjpHjIRJ">Security</a>), the
- relation is ignored and the default template is used. For the same reason, <strong>only apply templates from notes you trust</strong>.</li>
- <li>The template note must be part of the shared subtree (just like <code>~shareCss</code>, <code>~shareJs</code>)
- in order for it to be loaded. To prevent it from being shown in the navigation,
- apply <code>#shareHiddenFromTree</code> to it.</li>
-</ul>
-<h2>Content of the share template</h2>
-<p>Use the <a href="https://github.com/TriliumNext/Notes/blob/develop/packages/share-theme/src/templates/page.ejs">original template</a> as
- reference when creating a new share template.</p>
-<h2>Available variables</h2>
-<p>Your template is rendered with a context object exposing the note and
- its rendering environment. The most useful values are:</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Variable</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>note</code>
- </td>
- <td>The note being rendered. Use it to read attributes (<code>note.getLabelValue(...)</code>), <code>note.title</code>,
- child notes, etc.</td>
- </tr>
- <tr>
- <td><code>content</code>
- </td>
- <td>The note's already-rendered HTML content, as a string.</td>
- </tr>
- <tr>
- <td><code>header</code>
- </td>
- <td>Extra HTML to place in the document head for this note (used by some note
- types).</td>
- </tr>
- <tr>
- <td><code>isEmpty</code>
- </td>
- <td><code>true</code> when the note has no content of its own.</td>
- </tr>
- <tr>
- <td><code>head</code>
- </td>
- <td>The values of the page's <code>&lt;head&gt;</code>: <code>title</code> (the
- note's title, followed by the site's), <code>description</code> (<code>#shareDescription</code>), <code>noIndex</code> (<code>#shareDisallowRobotIndexing</code>)
- and <code>openGraph</code> with <code>url</code>, <code>domain</code>, <code>image</code>, <code>color</code> and <code>card</code> (<code>summary_large_image</code> with
- an image, <code>summary</code> without). A value whose label is not set is <code>null</code>. <code>metaTags</code> lists
- the description, OpenGraph and Twitter <code>&lt;meta&gt;</code> tags of
- the values that are set, each with <code>attribute</code> (<code>name</code> or <code>property</code>), <code>key</code> and <code>content</code>.</td>
- </tr>
- <tr>
- <td><code>logo</code>
- </td>
- <td>The site logo above the navigation tree and, on a narrow screen, in the
- header: <code>href</code> (<code>#shareRootLink</code>, otherwise the site's
- root page), <code>image</code> (the <code>~shareLogo</code> image, or <code>null</code>), <code>icon</code> (the
- icon classes of the site's root note, shown when there is no <code>image</code>),
- and <code>width</code> and <code>height</code> for the image.</td>
- </tr>
- <tr>
- <td><code>navigation</code>
- </td>
- <td>The navigation tree of the site: its visible pages, each with <code>title</code>, <code>href</code>, <code>isExternal</code>, <code>type</code>, <code>icon</code>, <code>isActive</code> (the
- page being shown), <code>isExpanded</code> (that page or one of its ancestors)
- and <code>children</code>.</td>
- </tr>
- <tr>
- <td><code>contentClasses</code>
- </td>
- <td>The classes of the content element: <code>type-&lt;note type&gt;</code>, <code>ck-content</code> for
- text and Markdown notes, <code>full-height</code> for a note that takes the
- whole page (such as a PDF, a web view, a calendar, a geo map or an image),
- and <code>no-content</code> when the note has no content of its own.</td>
- </tr>
- <tr>
- <td><code>childLinks</code>
- </td>
- <td>The links to the note's visible children, each with <code>title</code>, <code>href</code>, <code>isExternal</code>, <code>type</code>, <code>icon</code> (its
- icon classes), <code>excerpt</code> (its <code>#shareDescription</code> or
- the start of its text, with a line break between paragraphs, or <code>null</code>)
- and <code>children</code> (when it has no excerpt, its first ten visible
- children, each with <code>title</code>, <code>href</code>, <code>isExternal</code> and <code>icon</code>).
- Empty for a note that is not a collection, a text note or a code note,
- for a note that takes the whole page, and with <code>#hideChildrenOverview</code>.</td>
- </tr>
- <tr>
- <td><code>childLinksLayout</code>
- </td>
- <td>How the default template lays <code>childLinks</code> out: <code>list</code> for
- a collection whose view type is list, <code>grid</code> otherwise.</td>
- </tr>
- <tr>
- <td><code>prevNext</code>
- </td>
- <td>The pages before and after the note in the navigation tree, as <code>previous</code> and <code>next</code>,
- each with <code>title</code> and <code>href</code>, or <code>null</code>. Both <code>null</code> for
- a note that takes the whole page.</td>
- </tr>
- <tr>
- <td><code>language</code>
- </td>
- <td>The languages of the page: <code>page</code> with the <code>lang</code> and <code>dir</code> of
- the application's language, and <code>content</code> with those of the note's
- content language, or <code>null</code> when they are the same.</td>
- </tr>
- <tr>
- <td><code>lastUpdated</code>
- </td>
- <td>When the note was last changed, as <code>iso</code> for a <code>&lt;time&gt;</code> element
- and as <code>text</code> in the application's language, or <code>null</code>,
- which it also is for a note that takes the whole page.</td>
- </tr>
- <tr>
- <td><code>showTitle</code>
- </td>
- <td>Whether the default template shows the note's title above the content.
- Always <code>true</code>.</td>
- </tr>
- <tr>
- <td><code>titleIcon</code>
- </td>
- <td>The icon classes of the note, which the default template shows beside
- the title in a row of its own for a note that takes the whole page; <code>null</code> for
- any other note.</td>
- </tr>
- <tr>
- <td><code>snippets</code>
- </td>
- <td>The HTML of the <code>~shareHtml</code> snippets for each location, such
- as <code>snippets["head:end"]</code>. Every location is present, empty when
- no snippet goes there.</td>
- </tr>
- <tr>
- <td><code>subRoot</code>
- </td>
- <td>The root of the shared subtree as <code>{ note, branch }</code> — handy
- for a site-wide title or logo.</td>
- </tr>
- <tr>
- <td><code>cssToLoad</code> / <code>jsToLoad</code>
- </td>
- <td>Arrays of stylesheet / script URLs the default theme would inject (includes
- anything added via <code>~shareCss</code> / <code>~shareJs</code>).</td>
- </tr>
- <tr>
- <td><code>faviconUrl</code> / <code>logoUrl</code>
- </td>
- <td>Resolved favicon and logo URLs. Without <code>~shareLogo</code>, <code>logoUrl</code> is
- the Trilium logo.</td>
- </tr>
- <tr>
- <td><code>fontPreloads</code>
- </td>
- <td>The icon fonts to preload, each with <code>href</code> and <code>type</code> (the
- font's media type): Boxicons, and the icon packs used by the logo, the
- navigation tree or the subpages. The default template adds a <code>&lt;link rel="preload" as="font" crossorigin&gt;</code> for
- each, so that the icons do not appear only after the first paint.</td>
- </tr>
- <tr>
- <td><code>isStatic</code>
- </td>
- <td><code>true</code> during a static HTML export, <code>false</code> for a live
- server render.</td>
- </tr>
- <tr>
- <td><code>t</code>
- </td>
- <td>The <code>i18next</code> translation function.</td>
- </tr>
- <tr>
- <td><code>utils</code>
- </td>
- <td>Helper utilities such as <code>slugify()</code> and <code>stripTags()</code>.</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<h2>Error handling</h2>
-<p>If your template throws an error while rendering, Trilium logs the error
- and quietly falls back to the default template, so a broken template never
- takes the shared page down.</p>
-<h2>Splitting a template into partials</h2>
-<p>A template can pull in other EJS notes as partials. Create them as <strong>child notes</strong> of
- the template note (each also a <code>code</code> / <code>application/x-ejs</code> note)
- and reference them by title:</p><pre><code class="language-text-x-trilium-auto">&lt;%- include("header") %&gt;
-
-&lt;main&gt;
- &lt;h1&gt;&lt;%= note.title %&gt;&lt;/h1&gt;
- &lt;%- content %&gt;
-&lt;/main&gt;
-
-&lt;%- include("footer") %&gt;
-</code></pre>
-<p>Here <code>header</code> and <code>footer</code> are the titles of child notes
- of the template. Only direct children are resolvable, and they must be
- EJS code notes.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Sharing/Exporting static HTML for web publishing.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Sharing/Exporting static HTML for web publishing.html
deleted file mode 100644
index f36ee6be74..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Sharing/Exporting static HTML for web publishing.html
+++ /dev/null
@@ -1,67 +0,0 @@
-<p>As described in&nbsp;<a class="reference-link" href="#root/_help_R9pX4DGra2Vt">Sharing</a>,
- Trilium can act as a public server in which the shared notes are displayed
- in read-only mode. While this can work in most cases, it's generally not
- meant for high-traffic websites and since it's running on a Node.js server
- it can be potentially exploited.</p>
-<p>Another alternative is to generate static HTML files (just like other
- static site generators such as <a href="https://www.mkdocs.org/">MkDocs</a>).
- Since the normal HTML ZIP export does not contain any styling or additional
- functionality, Trilium provides a way to export the same layout and style
- as the&nbsp;<a class="reference-link" href="#root/_help_R9pX4DGra2Vt">Sharing</a>&nbsp;function
- into static HTML files.</p>
-<p>Apart from the enhanced security, these HTML files are also easy to deploy
- on “serverless” deployments such as GitHub Pages or CloudFlare Pages and
- cache very easily.</p>
-<aside class="admonition tip">
- <p>Trilium's documentation, available at <a href="https://docs.triliumnotes.org/">docs.triliumnotes.org</a> is
- built using this function of exporting to static HTML files which are then
- deployed automatically to CloudFlare Pages.</p>
- <p>The process is <a href="https://github.com/TriliumNext/Trilium/blob/main/apps/edit-docs/src/build-docs.ts">automated</a> by
- importing the Markdown documentation and exporting it via a script to the
- static web format.</p>
-</aside>
-<h2>Differences from normal sharing</h2>
-<p>Apart from normal&nbsp;<a class="reference-link" href="#root/_help_R9pX4DGra2Vt">Sharing</a>,
- exporting to static HTML files comes with a few subtle differences:</p>
-<ul>
- <li>The URL structure is different. Where in normal sharing it's something
- along the way of <code>example.com/share/noteid</code>, the notes follow
- an hierarchical structure, such as <code>docs.triliumnotes.org/user-guide/concepts/navigation/tree-concepts</code>.</li>
- <li>The <code>favicon.ico</code> is not handled automatically, it needs to be
- manually added on the server after the export is generated.</li>
- <li>The “Last updated” for notes is not available.</li>
- <li>The search functionality works slightly different since the normal one
- requires an active API to work. In the static export, search still works
- but uses a different mechanism so results might be different.</li>
-</ul>
-<h2>Differences from normal .zip export</h2>
-<ul>
- <li>The name of the files/URLs will prefer <code>shareAlias</code> to allow
- for clean URLs.</li>
- <li>The export requires a functional web server as the pages will not render
- properly if accessed locally via a web browser due to the use of module
- scripts.</li>
- <li>The directory structure is also slightly different:
- <ul>
- <li>A normal HTML export results in an index file and a single directory.</li>
- <li>Instead, for static exporting the top-root level becomes the index file
- and the child directories are on the root instead.</li>
- <li>This makes it possible to easily publish to a website, without forcing
- everything but the root note to be in a sub-directory.</li>
- </ul>
- </li>
-</ul>
-<h2>Testing locally</h2>
-<p>As mentioned previously, the exported static pages require a website to
- function. In order to test locally, a web server needs to be used.</p>
-<p>One example is to use the Node.js-based <a href="https://www.npmjs.com/package/http-server"><code>http-server</code></a> which
- can be installed via:</p><pre><code class="language-text-x-trilium-auto">npm i -g http-server</code></pre>
-<p>Once installed simply:</p>
-<ol>
- <li>Extract the exported .zip file.</li>
- <li>Inside the extracted directory, run <code>http-server</code>.</li>
- <li>Access the indicated address (e.g. <a href="http://localhost:8080">http://localhost:8080</a>).</li>
-</ol>
-<h2>Automation</h2>
-<p><a class="reference-link" href="#root/_help_pgxEVkzLl1OP">ETAPI (REST API)</a>&nbsp;could
- potentially be used to automate an export on a scheduled task.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Sharing/Reverse proxy configuration.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Sharing/Reverse proxy configuration.html
deleted file mode 100644
index cb72124628..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Sharing/Reverse proxy configuration.html
+++ /dev/null
@@ -1,19 +0,0 @@
-<p>It might be desirable to only expose the share functionality of Trilium
- to the Internet, and keep the application accessible only within a local
- network or via VPN.</p>
-<p>To do so, a reverse proxy is required.</p>
-<h2>Caddy</h2><pre><code class="language-text-x-trilium-auto">http://domain.com {
- reverse_proxy /share http://localhost:8080/share
-}</code></pre>
-<p>This is for newer versions where the share functionality is isolated,
- for older versions it's required to also include <code>/assets</code>.<a
- href="#fn2b8mg20aol8"><sup>[1]</sup></a>
-</p>
-<ol>
- <li>
- <p><a href="#fnref2b8mg20aol8"><strong><sup>^</sup></strong></a>
- </p>
- <p><a href="https://github.com/orgs/TriliumNext/discussions/7341#discussioncomment-14679897">https://github.com/orgs/TriliumNext/discussions/7341#discussioncomment-14679897</a>
- </p>
- </li>
-</ol>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Sharing/Serving directly the content of a note.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Sharing/Serving directly the content of a note.html
deleted file mode 100644
index 4854f51f92..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Sharing/Serving directly the content of a note.html
+++ /dev/null
@@ -1,36 +0,0 @@
-<p>When accessing a shared note, Trilium will render it as a web page. Sometimes
- it's desirable to serve the content directly so that it can be used in
- a script or downloaded by the user.</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>A note displayed as a web page (HTML)</th>
- <th>A note displayed as a raw format</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>
- <figure class="image">
- <img style="aspect-ratio:738/275;" src="1_Serving directly the content of a note_image.png"
- width="738" height="275">
- </figure>
- </td>
- <td>
- <img src="Serving directly the content of a note_image.png">
- </td>
- </tr>
- </tbody>
- </table>
-</figure>
-<h2>By adding an attribute to the note</h2>
-<p>Simply add the <code>#shareRaw</code> attribute and the note will always
- be rendered <em>raw</em> when accessed from the share URL.</p>
-<h2>By altering the URL</h2>
-<p>Append <code>?raw</code> to the URL to display a note in its raw format
- regardless of whether the <code>#shareRaw</code> attribute is added on the
- note.</p>
-<p>
- <img src="Serving directly the content of a note_image.png">
-</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Sharing_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Sharing_image.png
deleted file mode 100644
index 4c92b90c5a..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Sharing_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Sharing_share-single-note.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Sharing_share-single-note.png
deleted file mode 100644
index 87b99cabb2..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Sharing_share-single-note.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Snippets.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Snippets.html
deleted file mode 100644
index db9ac5dd31..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Snippets.html
+++ /dev/null
@@ -1,2 +0,0 @@
-<p>Snippets let you define reusable pieces of text, Markdown or code that
- can be quickly inserted into your notes.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Snippets/Code Snippets.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Snippets/Code Snippets.html
deleted file mode 100644
index acd582f10b..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Snippets/Code Snippets.html
+++ /dev/null
@@ -1,30 +0,0 @@
-<p>Code Snippets are closely related to&nbsp;<a class="reference-link" href="#root/_help_KC1HB96bqqHX">Templates</a>,
- but instead of defining the content of an entire note, a snippet is a reusable
- piece of code that can easily be inserted into a&nbsp;<a class="reference-link"
- href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;note.</p>
-<h2>Creating a Code snippet</h2>
-<p>In the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>: </p>
-<ol>
- <li>Right-click the note where you want to place the snippet.</li>
- <li>Select <em>Insert child note</em>.</li>
- <li>Select <em>More</em> → <em>Code snippet</em>.</li>
-</ol>
-<p>Then simply type the desired code into the note and set the correct language
- mode.</p>
-<p>The note's title becomes the title of the snippet. Optionally, you can
- add a description in the&nbsp;<a class="reference-link" href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;section.</p>
-<h2>Inserting a snippet</h2>
-<p>To insert a snippet, type <code>/snippet</code> and select its title from
- the dropdown.</p>
-<aside class="admonition important">
- <p>Only code snippets whose language mode matches the current code note are
- listed. For example, a CSS code note shows only CSS snippets, not JavaScript
- ones. The exception is snippets set to "Plain text", which are available
- in&nbsp;<a class="reference-link" href="#root/_help_6RM1Q7ppFVoj">Markdown</a>&nbsp;notes
- and any code note regardless of its language mode.</p>
-</aside>
-<h2>Limitations</h2>
-<ul>
- <li>Unlike&nbsp;<a class="reference-link" href="#root/_help_KC1HB96bqqHX">Templates</a>,
- snippets cannot be limited to a particular <a href="#root/_help_9sRHySam5fXb">workspace</a>.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Snippets/Markdown Snippets.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Snippets/Markdown Snippets.html
deleted file mode 100644
index 5ad0c35a53..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Snippets/Markdown Snippets.html
+++ /dev/null
@@ -1,25 +0,0 @@
-<p>Markdown Snippets are closely related to&nbsp;<a class="reference-link"
- href="#root/_help_KC1HB96bqqHX">Templates</a>, but instead of defining
- the content of an entire note, a snippet is a reusable piece of Markdown
- text that can easily be inserted into a&nbsp;<a class="reference-link"
- href="#root/_help_6RM1Q7ppFVoj">Markdown</a>&nbsp;note.</p>
-<h2>Creating a Markdown snippet</h2>
-<p>In the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>: </p>
-<ol>
- <li>Right-click the note where you want to place the snippet.</li>
- <li>Select <em>Insert child note</em>.</li>
- <li>Select <em>More</em> → <em>Markdown snippet</em>.</li>
-</ol>
-<p>Then simply type the desired content into the note.</p>
-<p>The note's title becomes the title of the snippet. Optionally, you can
- add a description in the&nbsp;<a class="reference-link" href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;section.</p>
-<h2>Inserting a snippet</h2>
-<p>To insert a snippet, type <code>/snippet</code> and select its title from
- the dropdown.</p>
-<p><a class="reference-link" href="#root/_help_IEgsWp5hHH35">Code Snippets</a>&nbsp;with
- their language mode set to "Plain text" are also listed here.</p>
-<h2>Limitations</h2>
-<ul>
- <li>Unlike&nbsp;<a class="reference-link" href="#root/_help_KC1HB96bqqHX">Templates</a>,
- snippets cannot be limited to a particular <a href="#root/_help_9sRHySam5fXb">workspace</a>.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Snippets/Text Snippets.clone.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Snippets/Text Snippets.clone.html
deleted file mode 100644
index 06951da859..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Snippets/Text Snippets.clone.html
+++ /dev/null
@@ -1 +0,0 @@
-<p>This is a clone of a note. Go to its <a href="../../Note%20Types/Text/Text%20Snippets.html">primary location</a>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Technologies used.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Technologies used.html
deleted file mode 100644
index 3d79a35807..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Technologies used.html
+++ /dev/null
@@ -1,39 +0,0 @@
-<p>One core aspect of Trilium that allows it to have support for multiple&nbsp;<a
- href="#root/_help_KSZ04uQ2D1St">Note Types</a>&nbsp;is the fact that it
- makes use of various off-the-shelf or reusable libraries.</p>
-<p>This page showcases some of the technologies used, for a better understanding
- of how Trilium works but also to credit the developers of that particular
- technology.</p>
-<h2>CKEditor</h2>
-<p>CKEditor is the editor behind&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes,
- as well as integrated in various facets of the application such as the
- attribute editor in the&nbsp;<a class="reference-link" href="#root/_help_AlJ73vBCjWDw">Status bar</a>&nbsp;or
- the chat box in the&nbsp;<a class="reference-link" href="#root/_help_GBBMSlVSOIGP">AI</a>&nbsp;sidebar
- or notes.</p>
-<p>For more information see&nbsp;<a class="reference-link" href="#root/_help_MI26XDLSAlCD">CKEditor</a>.</p>
-<h2>Excalidraw</h2>
-<p><a href="https://excalidraw.com/">Excalidraw</a> is the technology behind
- the&nbsp;<a class="reference-link" href="#root/_help_grjYqerjn243">Canvas</a>&nbsp;notes.
- The source code of the library is available on <a href="https://github.com/excalidraw/excalidraw">GitHub</a>.</p>
-<p>We are using an unmodified version of it, so it shares the same <a href="https://github.com/excalidraw/excalidraw/issues">issues</a> as
- the original.</p>
-<h2>MapLibre GL JS</h2>
-<p>Trilium v0.105.0 introduces <a href="https://github.com/maplibre/maplibre-gl-js">MapLibre GL JS</a> for
- the&nbsp;<a class="reference-link" href="#root/_help_81SGnPGMk7Xc">Geo Map</a>&nbsp;collection,
- which brings improved performance by using graphical acceleration (WebGL).
- Trilium ships its own track parsing logic as well as most of the UI such
- as the right panel.</p>
-<h2>MindElixir</h2>
-<p>MindElixir is the library we are using for&nbsp;<a class="reference-link"
- href="#root/_help_gBbsAeiuUxI5">Mind Map</a>&nbsp;note types. The main
- library is available on <a href="https://github.com/SSShooter/mind-elixir-core/issues">GitHub as mind-elixir-core</a>.</p>
-<p>Trilium ships its own UI which covers the toolbars, the contextual menu,
- the zoom buttons and the right panel that shows when clicking a node.</p>
-<h2>FullCalendar</h2>
-<p><a href="https://fullcalendar.io/">FullCalendar</a> is the technology behind
- the&nbsp;<a class="reference-link" href="#root/_help_xWbu3jpNWapp">Calendar</a>&nbsp;collection,
- providing the various views (day, week, month, year) and the event management.
- Trilium also ships its own UI in the form of the popup that appears when
- editing, as well as the header that appears in the&nbsp;<a class="reference-link"
- href="#root/_help_CssoWBu8I7jF">Collection Properties</a>.</p>
-<p>Licensed under the MIT license.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Technologies used/CKEditor.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Technologies used/CKEditor.html
deleted file mode 100644
index 735ee7bd93..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Technologies used/CKEditor.html
+++ /dev/null
@@ -1,47 +0,0 @@
-<h2>Editor core</h2>
-<p>The CKEditor is the WYSIWYG (standing for What You See Is What You Get)
- editor behind&nbsp;<a href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes.</p>
-<p>Their website is <a href="https://ckeditor.com/">ckeditor.com</a>.</p>
-<p>CKEditor by itself is a commercial product, but the core is open-source.
- As described in <a href="https://ckeditor.com/docs/ckeditor5/latest/features/index.html">its documentation</a>,
- the editor supports quite a large number of features. Do note that not
- all the features are enabled in Trilium.</p>
-<h2>Premium features</h2>
-<p>CKEditor ships some plugins as premium (slash commands, templates, AI
- integration). Initially Trilium (since v0.96.0) shipped some of them like
- slash commands as part of a license grant from CKEditor to the Trilium
- Notes developers.</p>
-<p>In v0.105.0 we've decided to replace those premium plugins with our own
- open-source implementations. This also means that we can better tailor
- those plugins to the Trilium app.</p>
-<h2>Plugins</h2>
-<p>The CKEditor ecosystem is quite extensible, in the sense that custom plugins
- can be written to extend the functionality of the editor beyond its original
- scope.</p>
-<p>Trilium makes use of such features:</p>
-<ul>
- <li>The math feature is added by a version of <a href="https://github.com/isaul32/ckeditor5-math">isaul32/ckeditor5-math: Math feature for CKEditor 5.</a> modified
- by us to fit our needs.</li>
- <li>We also make use of modified upstream plugins such as <a href="https://github.com/ckeditor/ckeditor5-mermaid">ckeditor/ckeditor5-mermaid</a> to
- allow inline Mermaid code.</li>
- <li><a href="https://github.com/mlewand/ckeditor5-keyboard-marker">mlewand/ckeditor5-keyboard-marker: Plugin adds support for the keyboard input element (<code>&lt;kbd&gt;</code>) to CKEditor 5.</a>
- </li>
- <li>A modified version of <a href="https://github.com/ThomasAitken/ckeditor5-footnotes">ThomasAitken/ckeditor5-footnotes: Footnotes plugin for CKEditor5</a> to
- allow footnotes.</li>
-</ul>
-<p>Apart from that, Trilium also has its own set of specific plugins such
- as:</p>
-<ul>
- <li><a class="reference-link" href="#root/_help_2x0ZAX9ePtzV">Cut to subnote</a>
- </li>
- <li><a class="reference-link" href="#root/_help_nBAXQFj20hS1">Include Note</a>
- </li>
- <li>Mentions, for linking pages.</li>
- <li><a class="reference-link" href="#root/_help_Oau6X9rCuegd">Markdown</a>
- </li>
- <li><a href="#root/_help_QEAPj01N5f7w">Reference links</a>
- </li>
- <li><a href="#root/_help_NwBbFdNZ9h7O">Admonitions</a>, we ended up creating
- our own plugin but <a href="https://github.com/aarkue/ckeditor5-admonition">aarkue/ckeditor5-admonition</a> was
- a good inspiration (including the toolbar icon).</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Templates.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Templates.html
deleted file mode 100644
index 7761975cad..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Templates.html
+++ /dev/null
@@ -1,113 +0,0 @@
-<p>A template in Trilium serves as a predefined structure for other notes,
- referred to as instance notes. Assigning a template to a note brings three
- main effects:</p>
-<ol>
- <li><strong>Attribute Inheritance</strong>: All attributes from the template
- note are <a href="#root/_help_bwZpz2ajCEwO">inherited</a> by the instance
- notes. Even attributes with <code>#isInheritable=false</code> are inherited
- by the instance notes, although only inheritable attributes are further
- inherited by the children of the instance notes.</li>
- <li><strong>Content Duplication</strong>: The content of the template note
- is copied to the instance note, provided the instance note is empty at
- the time of template assignment.</li>
- <li><strong>Child Note Duplication</strong>: All child notes of the template
- are deep-duplicated to the instance note.</li>
-</ol>
-<h2>Example</h2>
-<p>A typical example would be a "Book" template note, which might include:</p>
-<ul>
- <li><strong>Promoted Attributes</strong>: Such as publication year, author,
- etc. (see <a href="#root/_help_OFXdgB2nNk1F">promoted attributes</a>).</li>
- <li><strong>Outline</strong>: An outline for a book review, including sections
- like themes, conclusion, etc.</li>
- <li><strong>Child Notes</strong>: Additional notes for highlights, summary,
- etc.</li>
-</ul>
-<p>
- <img src="Templates_template.png" alt="Template Example">
-</p>
-<h2>Instance Note</h2>
-<p>An instance note is a note related to a template note. This relationship
- means the instance note's content is initialized from the template, and
- all attributes from the template are inherited.</p>
-<p>To create an instance note through the UI:</p>
-<p>
- <img src="Templates_template-create-instance-note.png" alt="show child note templates">
-</p>
-<p>For the template to appear in the menu, the template note must have the <code>#template</code> label.
- Do not confuse this with the <code>~template</code> relation, which links
- the instance note to the template note. If you use <a href="#root/_help_9sRHySam5fXb">workspaces</a>,
- you can also mark templates with <code>#workspaceTemplate</code> to display
- them only in the workspace.</p>
-<p>Templates can also be added or changed after note creation by creating
- a <code>~template</code> relation pointing to the desired template note.&nbsp;</p>
-<p>To specify a template for child notes, you can use a <code>~child:template</code> relation
- pointing to the appropriate template note. There is no limit to the depth
- of the hierarchy — you can use <code>~child:child:template</code>, <code>~child:child:child:template</code>,
- and so on.</p>
-<aside class="admonition important">
- <p>Changing the template hierarchy after the parent note is created will
- not retroactively apply to newly created child notes.
- <br>For example, if you initially use <code>~child:template</code> and later
- switch to <code>~child:child:template</code>, it will not automatically
- apply the new template to the grandchild notes. Only the structure present
- at the time of note creation is considered.</p>
-</aside>
-<h2>Default parent for new notes</h2>
-<p>A template can gather the notes created from it in one place, instead
- of having them land wherever they happen to be created. To do so, add a <code>~template:newNoteDefaultParent</code> relation
- to the template note, pointing at the note that should hold the instances,
- for example a <em>Person</em> template pointing to a <em>People</em> note.</p>
-<p>Adding the relation several times places the new note in every target,
- as&nbsp;<a class="reference-link" href="#root/_help_IakOLONlIfGI">Cloning Notes</a>.
- The relation can also be inherited (e.g. from a folder holding several
- templates), in which case a relation owned by the template itself replaces
- the inherited one. The default parent is only inherited from the template's
- ancestors in the tree: a template created from another template does not
- adopt that template's default parent.</p>
-<p>The default parent is used whenever a note is created from the template
- through the <em>Choose note type</em> dialog:</p>
-<ul>
- <li>Via <code>@</code>-completion in a&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;note</li>
- <li>Via the <em>Create note</em> or <em>Create child note</em> options of the
- note search (new tab or&nbsp;<a class="reference-link" href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a>),
- but only if the default/empty location is set.</li>
-</ul>
-<p>Creating an instance note from the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;context
- menu (<em>Insert child note</em>, <em>Insert note after</em>) still creates
- it at the chosen place.</p>
-<p>Unlike the&nbsp;<a class="reference-link" href="#root/_help_S0Fos78ZfcY7">Note Inbox</a>,
- which holds quickly captured notes until they are sorted, the default parent
- is meant as the instances' permanent location.</p>
-<h2>Regarding note types</h2>
-<p>By default, newly created notes are&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes.
- If a parent note defines a <code>child:template</code> pointing to a template
- of a different type (e.g. a Code note), the behavior depends on how the
- new note is created:</p>
-<ul>
- <li>If no note type is explicitly chosen (e.g. the + button in the&nbsp;<a
- class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>),
- the template is applied and the new note takes the type and content of
- the template.</li>
- <li>If a note type is explicitly selected (e.g.&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;→ <em>Insert note after</em> / <em>Insert child note</em>):
- <ul>
- <li>If the selected type matches the template's type, the template is applied.</li>
- <li>If the selected type differs, the template is disregarded entirely — the
- new note is an empty note of the selected type.</li>
- </ul>
- </li>
-</ul>
-<p>Selecting a specific template from the creation menu always takes precedence
- over <code>child:template</code>.</p>
-<h2>Additional Notes</h2>
-<p>From a visual perspective, templates can define <code>#iconClass</code> and <code>#cssClass</code> attributes,
- allowing all instance notes (e.g., books) to display a specific icon and
- CSS style.</p>
-<p>Explore the concept further in the&nbsp;<a class="reference-link" href="#root/_help_6tZeKvSHEUiB">Demo Notes</a>,
- including examples like the&nbsp;<a class="reference-link" href="#root/_help_iRwzGnHPzonm">Relation Map</a>,&nbsp;<a
- class="reference-link" href="#root/_help_xYjQUYhpbUEW">Task Manager</a>,
- and&nbsp;<a class="reference-link" href="#root/_help_l0tKav7yLHGF">Day Notes</a>.</p>
-<p>Additionally, see&nbsp;<a class="reference-link" href="#root/_help_47ZrP6FNuoG8">Default Note Title</a>&nbsp;for
- creating title templates. Note templates and title templates can be combined
- by creating a <code>#titleTemplate</code> for a template note.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Templates_template-create-instance-note.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Templates_template-create-instance-note.png
deleted file mode 100644
index e0de7dc974..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Templates_template-create-instance-note.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Templates_template.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Templates_template.png
deleted file mode 100644
index 72af71ad8f..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Templates_template.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Text Extraction (OCR).html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Text Extraction (OCR).html
deleted file mode 100644
index cb9bfa59ff..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Text Extraction (OCR).html
+++ /dev/null
@@ -1,137 +0,0 @@
-<p>Optical Character Recognition is the process in which the text from images
- or PDFs is extracted.</p>
-<h2>Built-in support</h2>
-<p>Since v0.103.0, Trilium has built-in support for OCR. The extracted text
- can be:</p>
-<ul>
- <li>Integrated with&nbsp;<a class="reference-link" href="#root/_help_eIg8jdvaoNNd">Search</a>,
- to quickly find the image or file based on snippets of text.</li>
- <li>Integrated with the&nbsp;<a class="reference-link" href="#root/_help_GBBMSlVSOIGP">AI</a>&nbsp;feature,
- which allows the agent to access the content of a non-text note.</li>
- <li>Manually accessed for other purposes (e.g. copying into a note or sending
- it somewhere else).</li>
-</ul>
-<h2>Supported formats</h2>
-<p>OCR in Trilium supports the following formats:</p>
-<h3>Images</h3>
-<ul>
- <li>Both <a href="#root/_help_W8vYD3Q1zjCR">individual image notes</a> and <a
- href="#root/_help_mT0HEkOsz6i1">attachments in text files</a> are supported.</li>
- <li>Supported formats:
- <ul>
- <li>JPEG</li>
- <li>PNG</li>
- <li>GIF (only non-animated)</li>
- <li>BMP</li>
- <li>WebP</li>
- </ul>
- </li>
- <li>Note that this feature works best for computer-rendered text rather than
- handwriting.</li>
- <li>The underlying technology is Tesseract.js.</li>
-</ul>
-<h3>PDFs</h3>
-<p>The PDF extraction supports:</p>
-<ul>
- <li>PDFs with text information (e.g. a PDF created by a browser or a word
- processing application), in which the text is extracted.</li>
- <li>Scanned PDFs, and other PDFs whose text cannot be selected (such as documents
- whose text was converted to outlines), in which the text is extracted through
- an OCR process.</li>
- <li>Mixed PDFs, containing both text and images with text content.</li>
-</ul>
-<p>Note that OCR extraction is limited to 50 pages per PDF, pages containing
- text information (not as an image) are not subject to this limitation.</p>
-<aside
-class="admonition note">
- <p>Text extraction for scanned PDFs using OCR was introduced in v0.106.0.
- If a scanned PDF was already processed by an earlier version, reprocess
- it individually via <em>Process OCR</em>; batch processing only handles
- files that haven't been OCR'd yet.</p>
-</aside>
-<h3>Office documents</h3>
-<p>The text will be extracted from the following file formats:</p>
-<ul>
- <li>Microsoft Word documents</li>
- <li>Microsoft Excel documents
- <ul>
- <li>Only the raw text information, the cell structure is not maintained.</li>
- <li>Values are extracted raw, so searching for dates will not work. The OpenDocument
- alternative will actually extract the properly formatted value.</li>
- </ul>
- </li>
- <li>Microsoft PowerPoint documents</li>
- <li>The OpenDocument alternatives to the previous formats (Text, Spreadsheet,
- Presentation), created by editors such as LibreOffice and OpenOffice.</li>
- <li><a href="https://en.wikipedia.org/wiki/Rich_Text_Format">Rich Text Format (RTF)</a>,
- since v0.104.0.</li>
- <li><a href="https://en.wikipedia.org/wiki/EPUB">EPUB</a>, since v0.104.1.</li>
-</ul>
-<h2>Configuring and triggering OCR</h2>
-<p>The OCR can be configured by going to&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→&nbsp;<a
- class="reference-link" href="#root/_hidden/_options/_optionsMedia">Media</a>&nbsp;and
- looking for the <em>Text Extraction (OCR)</em> section.</p>
-<p>There are three ways to trigger the OCR:</p>
-<ul>
- <li>By enabling <em>Auto-process new files</em> which will process only the
- notes or attachments created after enabling the option, existing files
- will remain unprocessed.</li>
- <li>By pressing <em>Start Batch Processing</em> which will process all the existing
- notes.</li>
- <li>By manually requesting for an image or file to have its text extracted,
- regardless of whether the automatic processing is enabled or not.</li>
-</ul>
-<h3>Minimum confidence</h3>
-<p>When extracting text from an image, there is a certain level of confidence
- which indicates whether the extracted text appears relevant.</p>
-<p>When the minimum confidence is set to a low percentage, the text extraction
- can interpret symbols and drawings incorrectly resulting in garbled text.</p>
-<p>If the extracted text for a note or an attachment quality is lower than
- the minimum confidence, the OCR is disregarded.</p>
-<h2>Language management</h2>
-<p>OCR needs to be aware of the language of the content in order for it to
- work correctly. The reason is that each language has its own data which
- needs to be downloaded, and accents or other symbols will not be supported
- by the default language.</p>
-<p>To configure the languages that are supported by the OCR, simply go to&nbsp;<a
- class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→&nbsp;<a
- class="reference-link" href="#root/_hidden/_options/_optionsLocalization">Language &amp; Region</a>&nbsp;and
- adjust the <em>Content languages</em>.</p>
-<p>When there are no content languages defined, the user interface <em>Language</em> is
- used instead.</p>
-<p>After making this change, the automatic processing or manual reprocessing
- will take into consideration the new languages.</p>
-<p>To enforce the detection in a particular language for a given note, use
- the <code>language</code> <a href="#root/_help_zEY4DaJG4YT5">attribute</a>,
- similar to <a href="#root/_help_veGu4faJErEM">text content language</a>.
- For&nbsp;<a class="reference-link" href="#root/_help_0vhv7lsOLy82">Attachments</a>,
- it's not possible to manually adjust the language.</p>
-<aside class="admonition note">
- <p>The trained data for each language is not packaged with Trilium, as that
- would require a significant amount of space that might not be otherwise
- needed. As such, when the trained data will be downloaded automatically
- via <a href="https://github.com/naptha/tesseract.js/">Tesseract.js</a>.</p>
- <p>The downloaded trained data is located in the&nbsp;<a class="reference-link"
- href="#root/_help_tAassRL4RSQL">Data directory</a>, in the <code>ocr-cache</code> directory.</p>
-</aside>
-<h2>Viewing extracted content for a single note</h2>
-<p>To access the extracted content of a note:</p>
-<ul>
- <li>For&nbsp;<a class="reference-link" href="#root/_help_W8vYD3Q1zjCR">File</a>&nbsp;notes,
- go to the&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a>&nbsp;→ <em>Advanced</em> → <em>View OCR Text</em>.</li>
- <li>For&nbsp;<a class="reference-link" href="#root/_help_0vhv7lsOLy82">Attachments</a>&nbsp;(e.g.&nbsp;<a
- class="reference-link" href="#root/_help_mT0HEkOsz6i1">Images</a>&nbsp;in&nbsp;<a
- class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes),
- double-click the attachment to view the details, press the […] button at
- the left and select <em>View extracted text (OCR)</em>.</li>
-</ul>
-<p>This section allows:</p>
-<ul>
- <li>Viewing the extracted text, which can be copied elsewhere if needed or
- just to check the quality of the extraction.</li>
- <li>If the note has not been extracted yet, pressing <em>Process OCR</em> will
- process it in the background. If the extraction confidence is lower than
- the minimum confidence, there will be a notification.</li>
- <li>Similarly, if the minimum confidence was changed in settings, it is possible
- to press the <em>Process OCR</em> button again to extract the text again.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/1_Zen mode_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/1_Zen mode_image.png
deleted file mode 100644
index cd5a9ccde9..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/1_Zen mode_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/2_Zen mode_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/2_Zen mode_image.png
deleted file mode 100644
index e708d46de6..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/2_Zen mode_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Active content.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Active content.html
deleted file mode 100644
index f86edd769f..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Active content.html
+++ /dev/null
@@ -1,118 +0,0 @@
-<p><em>Active content</em> is a generic name for powerful features in Trilium,
- these range from customizing the UI to advanced scripting that can alter
- your notes or even your PC.</p>
-<h2>Safe import</h2>
-<p>Active content problem of safety, especially when this active content
- comes from a third-party such as if it is downloaded from a website and
- then imported into Trilium.</p>
-<p>When <a href="#root/_help_mHbBMPDPkVV5">importing</a> .zip archives into
- Trilium, <em>safe mode</em> is active by default which will try to prevent
- untrusted code from executing. For example, a <a href="#root/_help_MgibgPcfeuGz">custom widget</a> needs
- the <code>#widget</code> <a href="#root/_help_HI6GBBIduIgv">label</a> in order
- to function; safe import works by renaming that label to <code>#disabled:widget</code>.</p>
-<h2>Safe mode</h2>
-<p>Sometimes active content can cause issues with the UI or the server, preventing
- it from functioning properly.&nbsp;<a class="reference-link" href="#root/_help_64ZTlUPgEPtW">Safe mode</a>&nbsp;allows
- starting Trilium in such a way that active content is not loaded by default
- at start-up, allowing the user to fix the problematic scripts or widgets.</p>
-<h2>Types of active content</h2>
-<p>These are the types of active content in Trilium, along with a few examples
- of what untrusted content of that type could cause:</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Name</th>
- <th>Disabled on a safe <a href="#root/_help_mHbBMPDPkVV5">import</a>
- </th>
- <th>Description</th>
- <th>Potential risks of untrusted code</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><a href="#root/_help_yIhgI5H7A2Sm">Front-end scripts</a>
- </td>
- <td>Yes</td>
- <td>Allow running arbitrary code on the client (UI) of Trilium, which can
- alter the user interface.</td>
- <td>A malicious script can execute server-side code, access un-encrypted notes
- or change their contents.</td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_MgibgPcfeuGz">Custom Widgets</a>
- </td>
- <td>Yes</td>
- <td>Can add new UI features to Trilium, for example by adding a new section
- in the&nbsp;<a class="reference-link" href="#root/_help_RnaPdbciOfeq">Right Sidebar</a>.</td>
- <td>The UI can be altered in such a way that it can be used to extract sensitive
- information or it can simply cause the application to crash.</td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_SPirpZypehBG">Backend scripts</a>
- </td>
- <td>Yes</td>
- <td>Can run custom code on the server of Trilium (Node.js environment), with
- full access to the notes and the database.</td>
- <td>Has access to all the unencrypted notes, but with full access to the database
- it can completely destroy the data. It also has access to execute other
- applications or alter the files and folders on the server).</td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_1vHRoWCEjj0L">Web View</a>
- </td>
- <td>Yes</td>
- <td>Displays a website inside a note.</td>
- <td>Can point to a phishing website which can collect the data (for example
- on a log in page).</td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_HcABDtFCkbFN">Render Note</a>
- </td>
- <td>Yes</td>
- <td>Renders custom content inside a note, such as a dashboard or a new editor
- that is not officially supported by Trilium.</td>
- <td>Can affect the UI similar to front-end scripts or custom widgets since
- the scripts are not completely encapsulated, or they can act similar to
- a web view where they can collect data entered by the user.</td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_AlhDUqhENtH7">Custom app-wide CSS</a>
- </td>
- <td>No</td>
- <td>Can alter the layout and style of the UI using CSS, applied regardless
- of theme.</td>
- <td>Generally less problematic than the rest of active content, but a badly
- written CSS can affect the layout of the application, requiring the use
- of&nbsp;<a class="reference-link" href="#root/_help_64ZTlUPgEPtW">Safe mode</a>&nbsp;to
- be able to use the application.</td>
- </tr>
- <tr>
- <td><a href="#root/_help_pKK96zzmvBGf">Custom themes</a>
- </td>
- <td>No</td>
- <td>Can change the style of the entire UI.</td>
- <td>Similar to custom app-wide CSS.</td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_gOKqSJgXLcIj">Icon Packs</a>
- </td>
- <td>No</td>
- <td>Introduces new icons that can be used for notes.</td>
- <td>Generally are more contained and less prone to cause issues, but they
- can cause performance issues (for example if the icon pack has millions
- of icons in it).</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<h2>Active content badge</h2>
-<p>If a note is considered to have active content, a badge is shown in the&nbsp;<a
- class="reference-link" href="#root/_help_B5dihXRDksTk">Note badges</a>&nbsp;area.
- Clicking the badge will reveal a menu with various options related to that
- content type, for example to open the documentation or to configure the
- execution of scripts.</p>
-<p>For some active content types, such as backend scripts with custom triggering
- conditions a toggle button will appear. This makes it possible to easily
- disable scripts or widgets, but also to re-enable them if an import was
- made with safe mode active.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export.html
deleted file mode 100644
index 94433797c7..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export.html
+++ /dev/null
@@ -1,135 +0,0 @@
-<p>To import a note:</p>
-<ul>
- <li>The easiest way to import is to simply drag &amp; drop a file or an archive
- into the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>.
- <ul>
- <li>This will automatically detect some formats such as&nbsp;<a class="reference-link"
- href="#root/_help_iWD7wiIuMtgV">Obsidian</a>.</li>
- <li><em>Safe import</em> is automatically on to prevent accidental running
- of foreign scripts.</li>
- </ul>
- </li>
- <li>To configure an import, there is a dedicated dialog which can be accessed
- from either&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;→ <em>Import into note</em> or&nbsp;<a
- class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a>&nbsp;→ <em>Import into note</em>.
- <ul>
- <li>This feature allows for dedicated importers for others apps such as&nbsp;<a
- class="reference-link" href="#root/_help_iWD7wiIuMtgV">Obsidian</a>&nbsp;or&nbsp;<a
- class="reference-link" href="#root/_help_GnhlmrATVqcH">Microsoft OneNote</a>.</li>
- <li><em>Safe import</em> as well as other options can be configured from the
- collapsed <em>Options</em> section at the bottom.</li>
- </ul>
- </li>
-</ul>
-<p>To export a note, right click the note in the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;and select <em>Export</em>.
- Similarly, in&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a>&nbsp;there
- is a <em>Export note</em> option.</p>
-<h2>Supported formats</h2>
-<p>Trilium natively supports the following formats for both import and export.</p>
-<ul>
- <li>HTML:
- <ul>
- <li>This is the main format used by Trilium, where standard tags are used
- to represent basic formatting and layout (e.g. <code>&lt;strong&gt;</code>, <code>&lt;table&gt;</code>, <code>&lt;pre&gt;</code>).</li>
- <li>Note that HTML is not a standardized format so some more specific features
- such as admonitions or&nbsp;<a class="reference-link" href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a>&nbsp;might
- not be supported by other applications.</li>
- <li>The notes can also be exported as <a href="#root/_help_ycBFjKrrwE9p">static HTML that can be used for web publishing</a>.</li>
- </ul>
- </li>
- <li><a class="reference-link" href="#root/_help_Oau6X9rCuegd">Markdown</a>
- <ul>
- <li>Most of the formatting is preserved, see&nbsp;<a class="reference-link"
- href="#root/_help_rJ9grSgoExl9">Supported syntax</a>.</li>
- </ul>
- </li>
- <li>OPML (Outliner Interchange Format)
- <ul>
- <li>Supports both OPML v1.0 for plain text and v2.0 with HTML support.</li>
- </ul>
- </li>
-</ul>
-<p>To import from other applications such as OneNote, Notion and others,
- see&nbsp;<a class="reference-link" href="#root/_help_ckZ2uNWQmVeX">Importing data from other applications</a>.</p>
-<h2>Maximum import size</h2>
-<p>Versions prior to v0.104.0 had an upload limit of 250 MiB that could be
- bypassed via a <code>TRILIUM_NO_UPLOAD_LIMIT</code> environment variable;
- with v0.104.0 this limit was removed.</p>
-<p>Nevertheless, there is still a limit for the maximum size of a <strong>single item</strong> (whether
- it's a&nbsp;<a class="reference-link" href="#root/_help_W8vYD3Q1zjCR">File</a>,
- an&nbsp;<a class="reference-link" href="#root/_help_0vhv7lsOLy82">Attachments</a>&nbsp;or
- even a&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;note).
- The limit is approximately 374 MiB and it's determined by the&nbsp;<a class="reference-link"
- href="#root/_help_cbkrhQjrkKrh">Synchronization</a>&nbsp;protocol. Attempts
- to import such large files will be refused.</p>
-<p>During large imports or exports, memory consumption might spike but it
- will remain somewhere around the 2 gigabyte mark. Tested with a 2.4 GB
- database with ~21k notes.</p>
-<aside class="admonition important">
- <p>For the&nbsp;<a class="reference-link" href="#root/_help_poXkQfguuA0U">Desktop Installation</a>,
- there are two distinct import mechanisms:</p>
- <ul>
- <li>A quick import, from the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>.</li>
- <li>The import dialog (via right click in the note tree → <em>Import into note</em> or
- from&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a>).</li>
- </ul>
- <p>When dealing with large files (multi-gigabyte), prefer using the import
- dialog as it has a special mechanism which makes sure that the file is
- read directly from disk rather than uploaded again.</p>
-</aside>
-<h2>Exporting the root note</h2>
-<p>The root note is the top-most note. Exporting it behaves just like any
- other note: right click on it in the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;and
- select <em>Export</em>.</p>
-<p>Starting with v0.104.0, when a root note is imported, it will be imported
- as a child of your existing root note. This behavior makes sure that the
- import cannot change or overwrite your existing notes.</p>
-<p>You can easily move the notes onto the root using the tree's&nbsp;<a class="reference-link"
- href="#root/_help_yTjUdsOi4CIE">Multiple selection</a>&nbsp;and delete
- the redundant root note.</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th scope="col">Before</th>
- <th scope="col">After</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>
- <ul>
- <li>root
- <ul>
- <li>one</li>
- <li>two</li>
- </ul>
- </li>
- </ul>
- </td>
- <td>
- <ul>
- <li>root (existing)
- <ul>
- <li>root (from import)
- <ul>
- <li>one</li>
- <li>two</li>
- </ul>
- </li>
- </ul>
- </li>
- </ul>
- </td>
- </tr>
- </tbody>
- </table>
-</figure>
-<aside class="admonition tip">
- <p>Instead of exporting full ZIPs (including the root note), consider using <a
- href="#root/_help_ODY7qQn5m2FT">backups</a> instead. Backups always contain
- the entire structure, as well as additional information a ZIP export does
- not have: maintains note IDs, contains the options/tokens and handle&nbsp;<a
- class="reference-link" href="#root/_help_bwg0e8ewQMak">Protected Notes</a>&nbsp;better.</p>
-</aside>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications.html
deleted file mode 100644
index 133edeef83..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications.html
+++ /dev/null
@@ -1,37 +0,0 @@
-<p>Starting with version v0.104.0, Trilium's importer was expanded to application-specific
- imports. Unlike the standard HTML or&nbsp;<a class="reference-link" href="#root/_help_Oau6X9rCuegd">Markdown</a>&nbsp;import/export,
- these importers are tailored to support the features and note structure
- of a particular application.</p>
-<h2>Supported applications</h2>
-<ul>
- <li><a class="reference-link" href="#root/_help_GnhlmrATVqcH">Microsoft OneNote</a>,
- by connecting to your account using Microsoft Graph.</li>
- <li><a class="reference-link" href="#root/_help_Y5mKeJ6dsCld">Notion</a>,
- via a ZIP export.</li>
- <li><a class="reference-link" href="#root/_help_nhQVuO4zvIxi">Google Keep</a>,
- via a ZIP export from <em>Google Takeout</em> (Keep has no dedicated export
- mechanism).</li>
- <li><a class="reference-link" href="#root/_help_syuSEKf2rUGr">Evernote</a>,
- via an ENEX export.</li>
- <li><a class="reference-link" href="#root/_help_83zmPBJRgfnW">Anytype</a>,
- via a JSON export.</li>
- <li><a class="reference-link" href="#root/_help_iWD7wiIuMtgV">Obsidian</a>,
- via a ZIP of the vault.</li>
-</ul>
-<h2>Importing data from another application</h2>
-<p>To import from an application, there are two ways to access the import
- dialog:</p>
-<ul>
- <li>In the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>,
- right click on a note and select <em>Import into note</em>.</li>
- <li>In the&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a>,
- select <em>Import files</em>.</li>
-</ul>
-<p>A list of supported applications will appear at the top, each with their
- own configuration. Simply click one and proceed with the on-screen instructions.</p>
-<h2>Acknowledgement</h2>
-<ul>
- <li>Trilium's importer is inspired by Obsidian's <a href="https://github.com/obsidianmd/obsidian-importer">Importer plugin</a> (licensed
- under the MIT license), for example regarding the OneNote connection process
- or the Notion ID management.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Anytype.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Anytype.html
deleted file mode 100644
index 6b59c77239..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Anytype.html
+++ /dev/null
@@ -1,165 +0,0 @@
-<p>Starting with v0.104.0, Trilium is able to import data from Anytype from
- JSON imports which preserve most of the formatting and the metainformation.</p>
-<h2>Import process</h2>
-<p>The first step is to export the data from Anytype:</p>
-<ul>
- <li>To export a single page:
- <ul>
- <li>Select the page to export.</li>
- <li>Press the […] at the top-right of the window and select <em>Export</em>.</li>
- <li>Ensure the following options are set:
- <ul>
- <li>Export format: Any-Block</li>
- <li>File Format: JSON</li>
- <li>Zip archive: On</li>
- <li>Include linked objects: On</li>
- <li>Include files: On</li>
- <li>Include archived objects: On</li>
- </ul>
- </li>
- </ul>
- </li>
- <li>To export an entire channel:
- <ul>
- <li>Select the desired channel from the left bar.</li>
- <li>Underneath the channel icon in the left sidebar, press the name of the
- channel with an arrow and select <em>Channel Settings</em>.</li>
- <li>In the left sidebar, look for the <em>Integrations</em> section and select <em>Export</em>.</li>
- <li>Press <em>Any-Block</em>.</li>
- <li>Ensure the following options are set:
- <ul>
- <li>File Format: JSON</li>
- <li>Zip archive: On</li>
- <li>Include files: On</li>
- <li>Include archived objects: On</li>
- </ul>
- </li>
- </ul>
- </li>
-</ul>
-<p>In Trilium Notes:</p>
-<ol>
- <li>In the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>,
- right click and select <em>Import into note</em>.</li>
- <li>In the <em>Import from</em> section, select&nbsp;<span class="tn-icon tn-brand tn-brand-anytype"></span> <em>Anytype</em>.</li>
- <li>Upload the ZIP.</li>
-</ol>
-<aside class="admonition note">
- <p>Exporting collections individually can sometimes miss information that
- would otherwise be picked up from an export of the entire channel. The
- reason is that Anytype leaves out some information when exporting individual
- pages/collections.</p>
-</aside>
-<h2>Supported features</h2>
-<p>The following features are preserved by Trilium during the import process:</p>
-<ul>
- <li>Basic formatting (bold, italic, underline, strikethrough, headings, colors,
- highlights, inline code).</li>
- <li><a class="reference-link" href="#root/_help_S6Xx8QIWTV66">Lists</a>&nbsp;(numbered
- or bullet)</li>
- <li><a class="reference-link" href="#root/_help_mT0HEkOsz6i1">Images</a>&nbsp;and
- files are handled as&nbsp;<a class="reference-link" href="#root/_help_0vhv7lsOLy82">Attachments</a>.</li>
- <li>To-do lists</li>
- <li>Toggle sections</li>
- <li><a class="reference-link" href="#root/_help_NdowYOC1GFKS">Tables</a>
- </li>
- <li>Inline&nbsp;<a class="reference-link" href="#root/_help_s1aBHPd79XYj">Mermaid Diagrams</a>
- </li>
- <li><a class="reference-link" href="#root/_help_YfYAtQBcfo5V">Math Equations</a>
- </li>
- <li>Highlight blocks are imported as block quotes.</li>
- <li><a class="reference-link" href="#root/_help_QxEyIjRBizuC">Code blocks</a>,
- with a best-effort attempt to restore the language.</li>
- <li>Links between other imported pages are converted to&nbsp;<a class="reference-link"
- href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a>&nbsp;if
- they are part of the same import.
- <ul>
- <li>Applies to both block links and inline links.</li>
- </ul>
- </li>
- <li>Collections are imported as&nbsp;Trilium-native&nbsp;<a class="reference-link"
- href="#root/_help_GTwFsgaA0lCt">Collections</a>&nbsp;(see below).
- <ul>
- <li>Files inside collections are imported as&nbsp;<a class="reference-link"
- href="#root/_help_W8vYD3Q1zjCR">File</a>&nbsp;notes.</li>
- </ul>
- </li>
- <li>Dividers (line, dots) are imported as horizontal rules.</li>
- <li><a href="#root/_help_NwBbFdNZ9h7O">Admonitions</a> are preserved, including
- its emoji (added as part of the content).</li>
- <li>Creation and modification date of pages is preserved.</li>
-</ul>
-<h2>Collections</h2>
-<p>Collections created in Anytype are imported on a best-effort basis, preserving
- both the view mode and the page properties as&nbsp;<a class="reference-link"
- href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>.</p>
-<p>The following view modes are supported:</p>
-<ul>
- <li>List as&nbsp;<a class="reference-link" href="#root/_help_mULW0Q3VojwY">List View</a>
- </li>
- <li>Gallery as&nbsp;<a class="reference-link" href="#root/_help_8QqnMzx393bx">Grid View</a>
- </li>
- <li><a class="reference-link" href="#root/_help_xWbu3jpNWapp">Calendar</a>,
- preserving the attribute which identifies the date.</li>
- <li><a class="reference-link" href="#root/_help_CtBQqbwXDx1w">Kanban Board</a>,
- preserving the board group column.</li>
- <li><a class="reference-link" href="#root/_help_2FvYrpmOXm29">Table</a>, also
- used as fallback for unsupported collection layouts.</li>
-</ul>
-<p>The following types are supported:</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th scope="col">Anytype property type</th>
- <th scope="col">Trilium</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>Text / Select</td>
- <td>Single-valued <code>text</code> label</td>
- </tr>
- <tr>
- <td>Number</td>
- <td>Single-valued <code>number</code> label</td>
- </tr>
- <tr>
- <td>Multi-select</td>
- <td>One <code>text</code> label per option (multi)</td>
- </tr>
- <tr>
- <td>Date / Date with time</td>
- <td>
- <ul>
- <li><code>datetime</code> if the time is included.</li>
- <li><code>date</code> if only dates.</li>
- </ul>
- </td>
- </tr>
- <tr>
- <td>File</td>
- <td>The files are preserved as attachments, and a link to them is prepended
- to the content of the note for visibility.</td>
- </tr>
- <tr>
- <td>Checkbox</td>
- <td><code>boolean</code> label (<code>true</code>/<code>false</code>).</td>
- </tr>
- <tr>
- <td>URL / Email / Phone</td>
- <td><code>url</code> label (<code>mailto:</code>, <code>tel:</code> prefix)</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<h2>Reporting issues</h2>
-<p>When importing your Anytype notes, you might find issues in how a note
- is imported; in that case consider <a href="#root/_help_wy8So3yZZlH9">reporting</a> it.</p>
-<p>When reporting such an issue make sure to provide the following information:</p>
-<ul>
- <li>A .zip export of the original note (and children if applicable). This
- allows us to reproduce the issue.</li>
- <li>A screenshot with how it originally looked like before the import and
- how it looks after the import.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Evernote.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Evernote.html
deleted file mode 100644
index 135c10477f..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Evernote.html
+++ /dev/null
@@ -1,157 +0,0 @@
-<p>Trilium can import ENEX files, which are used by Evernote for backup/export.
- One ENEX file represents the content (notes and resources) of one notebook.</p>
-<h2>Import process</h2>
-<p>The first step is to export the data from Evernote:</p>
-<ul>
- <li>To export a single notebook:
- <ul>
- <li>In the left sidebar, select <em>Notebooks</em>.</li>
- <li>If you have a notebook stack, expand it.</li>
- <li>Right click on a notebook and select <em>Export notebook</em>.</li>
- <li>Make sure the following options are set:
- <ul>
- <li>File format is set to <em>ENEX format</em>.</li>
- <li>All the options in <em>Export note attributes</em> are checked.</li>
- </ul>
- </li>
- </ul>
- </li>
- <li>To export a bunch of notes (up to 100 notes):
- <ul>
- <li>In the left sidebar, select <em>Notes</em>.</li>
- <li>In the list of notes, <kbd>Ctrl</kbd>-click individual notes to select
- them. Alternatively, click on a note and then <kbd>Shift</kbd>-click a more
- distant note to select all the notes in between.</li>
- <li>At the bottom there should be a floating bar with some options. Select
- […] → <em>Export.</em>
- </li>
- <li>Make sure the following options are set:
- <ul>
- <li>File format is set to <em>ENEX format</em>.</li>
- <li>All the options in <em>Export note attributes</em> are checked.</li>
- </ul>
- </li>
- </ul>
- </li>
- <li>To export a single note:
- <ul>
- <li>Select the note.</li>
- <li>In the top-right, press the […] button and select <em>Export</em>.</li>
- <li>Make sure the following options are set:
- <ul>
- <li>File format is set to <em>ENEX format</em>.</li>
- <li>All the options in <em>Export note attributes</em> are checked.</li>
- </ul>
- </li>
- </ul>
- </li>
-</ul>
-<aside class="admonition tip">
- <p>To export multiple notebooks in bulk, consider using a third-party CLI
- tool called <a href="https://github.com/vzhd1701/evernote-backup">evernote-backup</a>
- </p>
-</aside>
-<p>Once you have your ENEX files, do the following to import them in Trilium:</p>
-<ol>
- <li>In the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>,
- right click and select <em>Import into note</em>.</li>
- <li>In the <em>Import from</em> section, select&nbsp;<span class="tn-icon tn-brand tn-brand-evernote"></span> <em>Evernote</em>.</li>
- <li>During the import, you will see "Import in progress" message. If the import
- is successful, the message will change to “Import finished successfully”
- and then disappear.</li>
- <li>We recommend you to check the imported notes and their attachments to
- verify that you haven’t lost any data.</li>
-</ol>
-<h2>Supported features</h2>
-<p>The following features are preserved by Trilium during the import process:</p>
-<ul>
- <li>Basic formatting (bold, italic, underline, strikethrough, colors, highlights,
- superscript, subscript, text alignment, inline code).</li>
- <li>The hierarchy of headings (these are shifted to start with H2 because
- H1 is reserved for note title, see&nbsp;<a href="#root/_help_Gr6xFaF6ioJ5">Headings</a>)</li>
- <li>To-do lists. The new task format is collapsed to standard to-do lists</li>
- <li><a class="reference-link" href="#root/_help_mT0HEkOsz6i1">Images</a>&nbsp;and&nbsp;<a
- class="reference-link" href="#root/_help_0vhv7lsOLy82">Attachments</a>
- </li>
- <li><a class="reference-link" href="#root/_help_S6Xx8QIWTV66">Lists</a>&nbsp;(with
- bullets or with numbers)</li>
- <li><a class="reference-link" href="#root/_help_NdowYOC1GFKS">Tables</a>
- </li>
- <li>Block quotes</li>
- <li><a href="#root/_help_NwBbFdNZ9h7O">Admonitions</a> are preserved, including
- its emoji (added as part of the content).</li>
- <li><a class="reference-link" href="#root/_help_QxEyIjRBizuC">Code blocks</a>,
- with a best-effort attempt to restore the language.</li>
- <li><a class="reference-link" href="#root/_help_s1aBHPd79XYj">Mermaid Diagrams</a>
- </li>
- <li><a class="reference-link" href="#root/_help_YfYAtQBcfo5V">Math Equations</a>
- </li>
- <li>Toggle sections</li>
- <li>External links</li>
- <li>Internal links are re-written to&nbsp;<a class="reference-link" href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a>&nbsp;if
- the target note is part of the same import.</li>
-</ul>
-<h2>Limitations</h2>
-<ul>
- <li>The size limit of one import is 250Mb. If the total size of your files
- is larger, you can increase the&nbsp;<a href="#root/_help_WOcw2SLH6tbX">upload limit</a>,
- or divide your files, and run the import as many times as necessary.</li>
- <li>All resources (except for images) are created as notes’ attachments.</li>
- <li>If you have HTML inside ENEX files, the HTML formatting may be broken
- or lost after import in Trilium. See&nbsp;<a class="reference-link" href="#root/_help_wy8So3yZZlH9">Reporting issues</a>.</li>
-</ul>
-<h3>Links to other notes</h3>
-<p>Since v0.104.0, the ENEX importer tries to recreate links to other notes
- automatically by converting their Evernote-specific URLs to Trilium's&nbsp;<a
- class="reference-link" href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a>.</p>
-<p>Since the ENEX format does not provide the unique ID of notes, the note
- references are determined via their note title.</p>
-<p>Limitations:</p>
-<ul>
- <li>Only notes that are part of the same import will have their links rewritten
- to reference links, to avoid linking to the wrong note.</li>
- <li>If there are to notes with the same name, internal links will not be created
- to avoid pointing to the wrong note.</li>
- <li>Links that couldn't be rewritten (e.g. referring to a missing/duplicate
- note) will be kept with their original <code>evernote://</code> URL.</li>
- <li>It will not fix links to anchors and links to notes that you renamed in
- Evernote after you created the links.</li>
-</ul>
-<h4>Post-processing notes</h4>
-<aside class="admonition tip">
- <p>This script allows rewriting links after the import has been done, and
- it should also allow finding links between two different imports.</p>
-</aside>
-<p>If you want to restore the internal links in Trilium after you import
- all of your ENEX files, you can use or adapt this custom script:&nbsp;<a
- class="reference-link" href="#root/_help_dj3j8dG4th4l">Process internal links by title</a>
-</p>
-<p>The script does the following:</p>
-<ol>
- <li>It finds all Evernote internal links.</li>
- <li>For each one, it checks if its link text matches a note title, and if
- yes, it replaces the Evernote link with an internal Trilium link. If not,
- it leaves the Evernote link in place.</li>
- <li>If it finds more than one note with a matching note title, it leaves the
- Evernote link in place.</li>
- <li>It outputs the results in a log that you can see in the respective code
- note in Trilium.</li>
-</ol>
-<p>The script has the following limitations:</p>
-<ul>
- <li>It will not fix links to anchors and links to notes that you renamed in
- Evernote after you created the links.</li>
- <li>Some note titles might not be well identified, even if they exist. This
- is especially the case if the note title contains some special characters.
- Should this be problematic, consider&nbsp;<a class="reference-link" href="#root/_help_wy8So3yZZlH9">Reporting issues</a>.</li>
-</ul>
-<h2>Reporting issues</h2>
-<p>When importing your Evernote notebooks, you might find issues in how a
- note is imported; in that case consider <a href="#root/_help_wy8So3yZZlH9">reporting</a> it.</p>
-<p>When reporting such an issue make sure to provide the following information:</p>
-<ul>
- <li>A <code>.enex</code> export of the original note. This allows us to reproduce
- the issue.</li>
- <li>A screenshot with how it originally looked like before the import and
- how it looks after the import.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Evernote/Process internal links by title.js b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Evernote/Process internal links by title.js
deleted file mode 100644
index 732744ba6c..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Evernote/Process internal links by title.js
+++ /dev/null
@@ -1,33 +0,0 @@
-const query = `note.type = "text" and note.content *=* "evernote:///view/"`;
-const notes = api.searchForNotes(query);
-
-for (const note of notes) {
- api.log(`Processing note ${note.title}...`);
-
- const content = note.getContent();
- const root = api.htmlParser.parse(content);
-
- for (const el of root.querySelectorAll("a")) {
- const url = el.getAttribute("href");
- if (!url?.startsWith("evernote:///")) continue;
-
- const text = el.textContent;
- const matchingNotes = api.searchForNotes(`note.title = "${text}"`);
- if (matchingNotes.length === 0) {
- api.log(`No matching notes for "${text}..."`);
- continue;
- }
-
- if (matchingNotes.length > 1) {
- api.log(`Found multiple matching notes for "${text}". Skipping.`);
- continue;
- }
-
- const matchingNote = matchingNotes[0];
-
- api.log(`Found matching note: ${matchingNote.title} ${matchingNote.noteId}`);
- el.setAttribute("href", `#root/${matchingNote.noteId}`);
- el.classList.add("reference-link");
- }
- note.setContent(root.toString());
-}
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Google Keep.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Google Keep.html
deleted file mode 100644
index f18dba435b..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Google Keep.html
+++ /dev/null
@@ -1,69 +0,0 @@
-<p>Trilium can import notes from Google Keep, preserving their structure
- and formatting.</p>
-<h2>Import process</h2>
-<p>Google Keep has no native export process, but Google Takeout allows you
- to download a ZIP of all the notes.</p>
-<p>The first step is to download your Google Keep information:</p>
-<ol>
- <li>Navigate to <a href="https://takeout.google.com/">takeout.google.com</a>.</li>
- <li>In the <em>Create a new export</em> section, press <em>Deselect all.</em>
- </li>
- <li>In the list of data to export, check <em>Keep</em>.</li>
- <li>Scroll all the way down and choose <em>Next step</em>.</li>
- <li>In <em>Choose file type, frequency &amp; destination</em> make sure the
- following options are set:
- <ol>
- <li><em>Transfer to</em> is set to <em>Send download link via email</em>.</li>
- <li><em>Frequency</em> is set to <em>Export once</em>.</li>
- <li><em>File type</em> is set to <em>.zip</em>.</li>
- <li><em>File size</em> can remain set to <em>2 GB</em>.</li>
- </ol>
- </li>
- <li>Press <em>Create export</em> and wait for the export to finish.</li>
-</ol>
-<p>Then in Trilium Notes:</p>
-<ol>
- <li>In the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>,
- right click and select <em>Import into note</em>.</li>
- <li>In the <em>Import from</em> section, select&nbsp;<span class="tn-icon tn-brand tn-brand-google-keep"></span> <em>Google Keep</em>.</li>
- <li>Upload the ZIP obtained in the previous step.</li>
-</ol>
-<h2>Supported features</h2>
-<ul>
- <li>Basic formatting (bold, italic, underline)</li>
- <li><a href="#root/_help_p9kXRFAkwN4o">Note color</a>
- </li>
- <li>Note titles are maintained, if present.
- <ul>
- <li>In Google Keep it's common for notes not to have a title, case in which
- the date and time of the note are used as a title.</li>
- </ul>
- </li>
- <li>To-do lists</li>
- <li><a class="reference-link" href="#root/_help_mT0HEkOsz6i1">Images</a>&nbsp;and&nbsp;<a
- class="reference-link" href="#root/_help_0vhv7lsOLy82">Attachments</a>.</li>
- <li>Creation and modification dates are preserved.</li>
-</ul>
-<h2>Limitations</h2>
-<p>Currently the following information is not imported:</p>
-<ul>
- <li>Labels are disregarded.</li>
- <li>Pinned, archived or trashed state is not preserved, all notes are treated
- the same.</li>
-</ul>
-<h2>Reporting issues</h2>
-<p>When importing your notes from Google Keep, you might encounter some issues
- with how the notes are imported, or there might be some missing information.
- In this case, consider <a href="#root/_help_wy8So3yZZlH9">reporting it</a>.</p>
-<p>When reporting such an issue make sure to provide the following information:</p>
-<ul>
- <li>A sample of the note is required to better understand what happened.
- <ul>
- <li>Because Google Keep has no per-note export, extract the Google Takeout
- ZIP and copy the files corresponding to the problematic note (<code>.html</code>, <code>.json</code> and
- any attachments if you are able to identify them).</li>
- </ul>
- </li>
- <li>A screenshot with how it originally looked like before the import and
- how it looks after the import.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Microsoft OneNote.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Microsoft OneNote.html
deleted file mode 100644
index bd1861cf68..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Microsoft OneNote.html
+++ /dev/null
@@ -1,180 +0,0 @@
-<p>Trilium allows importing from OneNote. Currently the only mechanism supported
- is via the Microsoft Graph API which requires you to authenticate in a
- browser in order for the notes to be obtained by Trilium.</p>
-<h2>Import process</h2>
-<ol>
- <li>In the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>,
- right click and select <em>Import into note</em>.</li>
- <li>In the <em>Import from</em> section, select&nbsp;<span class="tn-icon tn-brand tn-brand-onenote"></span> <em>OneNote</em>.</li>
- <li>Press the <em>Connect</em> button:
- <ol>
- <li>On the desktop app, you will be redirected to Microsoft's authentication
- screen where you can log into your account.</li>
- <li>On the web app, the process is slightly more involved as it requires copying
- the code to clipboard, accessing the link, pasting the code and then signing
- in once more.</li>
- </ol>
- </li>
- <li>After the connection is successful, you should be able to see a list of
- sections that can be imported. Simply check the ones to import and press
- the <em>Import selected</em> button.</li>
- <li>Wait for the import to finish.</li>
-</ol>
-<h2>Supported features</h2>
-<p>The following features are preserved by Trilium during the import process:</p>
-<ul>
- <li>Basic formatting (bold, italic, underline, strikethrough, subscript, super
- script, font sizes, headings, colors, highlights).
- <ul>
- <li>Black-colored text is intentionally stripped to allow it to work in dark
- themes.</li>
- </ul>
- </li>
- <li>Inline code is automatically detected and formatted. Paragraphs that use
- the Code style are also converted to&nbsp;<a class="reference-link" href="#root/_help_QxEyIjRBizuC">Code blocks</a>.
- <ul>
- <li>Unfortunately the indentation of the code might be lost because the information
- is simply not present in the data from the Microsoft API.</li>
- </ul>
- </li>
- <li><a class="reference-link" href="#root/_help_S6Xx8QIWTV66">Lists</a>&nbsp;with
- different bullet types.</li>
- <li><a class="reference-link" href="#root/_help_NdowYOC1GFKS">Tables</a>
- <ul>
- <li>Cell backgrounds are preserved, including a best-effort hue correction
- because the colors returned by the Graph API are sometimes incorrect.</li>
- <li>Cell widths are also preserved proportionally, with the only difference
- that tables in Trilium have a percentage-based width, not fixed pixel sizes.</li>
- </ul>
- </li>
- <li>Images and&nbsp;<a class="reference-link" href="#root/_help_0vhv7lsOLy82">Attachments</a>.
- <ul>
- <li>Screen clippings are also properly supported since v0.104.1, displaying
- their timestamp as a figure caption.</li>
- </ul>
- </li>
- <li>To-do lists</li>
- <li>Hand-drawing is preserved and displayed as an SVG image inside the note
- <ul>
- <li>OneNote's default color (black) is special since it also renders as white
- for dark themes. Since v0.104.1, this is also supported by using a special
- SVG tweak which reacts to light/dark themes.</li>
- </ul>
- </li>
- <li>Links between other imported pages are converted to&nbsp;<a class="reference-link"
- href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a>&nbsp;if
- the text of the link matches the name of the page, or plain links otherwise.
- If the pages are not part of the import, the original <code>onenote:</code> link
- is kept.</li>
- <li>Tags (apart from to-do lists) are preserved by converting them to <a href="#root/_help_hD8GawVuazff">inline icons</a>,
- which are searchable by the icon's name and can be recolored like any other
- icon. Some icons are turned into emojis instead.</li>
-</ul>
-<p>Regarding the note structure:</p>
-<ul>
- <li>The order of the pages within a section is maintained.</li>
- <li>Sub-pages and section groups are maintained by nesting notes in a hierarchical
- structure.</li>
- <li>Creation and modification of both notes and sections is preserved. The
- order of section or section groups is not preserved (see limitations).</li>
-</ul>
-<h2>Error management and reporting</h2>
-<p>The OneNote importer uses Microsoft's Graph API which handles the HTML
- export (that we later post-process for Trilium use). The Graph API itself
- has to process the OneNote pages before sending them to us, and as such
- it's a time-consuming operation that is directly proportional to the number
- of notes and the complexity/size of the notes.</p>
-<p>The Graph API throttles access if it detects too many operations. The
- importer takes that into account, but sometimes this means that most of
- the time is spent waiting for the Graph API to unblock access rather than
- actually importing data.</p>
-<p>In addition, some pages may fail at the Graph API level due to an internal
- timeout on their side or other issues. Trilium will try to refetch pages
- in order to avoid that but sometimes pages cannot be retrieved even after
- multiple retries. In that case, the importer will still create a corresponding
- note in Trilium but with an error report instead of a content. This preserves&nbsp;<a
- class="reference-link" href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a>&nbsp;and
- makes it easy to identify and manually fix the pages that failed.</p>
-<p>At the end of the import, the top-level note called <em>OneNote</em> <em>import</em> will
- contain information about how the import went:</p>
-<ul>
- <li>The number of notes imported;</li>
- <li>The success rate;</li>
- <li>A list of notes that could not be imported, as well as the failure reason;</li>
- <li>Pages whose images/attachments failed to download</li>
- <li>How long the import spent waiting out throttling.</li>
-</ul>
-<p>To avoid cases in which the import is fundamentally broken (e.g. an expired
- sign-in), the import will error out if it fails to import 6 pages in a
- row.</p>
-<h2>Attributes</h2>
-<p>Pages imported from OneNote have a few built-in <a href="#root/_help_HI6GBBIduIgv">labels</a>:</p>
-<ul>
- <li><code>oneNotePageId</code>, with the corresponding page ID in OneNote.
- This can be used to identify the original OneNote page. Trilium doesn't
- use it in any way at this moment.</li>
- <li><code>oneNoteImportFailed</code> attached to notes that couldn't be imported.
- This can be used to quickly&nbsp;<a class="reference-link" href="#root/_help_eIg8jdvaoNNd">Search</a>&nbsp;for
- failed notes.</li>
-</ul>
-<h2>Limitations</h2>
-<h3>Regarding OneNote's freehand structure</h3>
-<p>OneNote is fundamentally different to Trilium in structure because it
- allows freehand drawing to coexist with text, and text boxes can be placed
- anywhere in the document (e.g. a common use case is to have columns). Trilium
- has a document flow mechanism for&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes
- which means that it can't be freely positioned.</p>
-<p>To cope with this difference, Trilium will flatten the text structure
- into normal paragraphs. The paragraphs will be ordered visually based on
- the original position of the text boxes, but their horizontal position
- will not be preserved. Parallel text such as columns may appear interleaved
- which can cause problems.</p>
-<p>In addition, drawing in OneNote can be interleaved with text boxes. Text
- notes in Trilium do not allow for this feature, so all drawing will appear
- at the end. For some use cases (diagrams, for example) this will work fine,
- but if you have highlights or other text-dependent drawings they will appear
- out of order.</p>
-<aside class="admonition note">
- <p>There are plans to support drawing-heavy notes that interleave with text
- boxes by converting them to a&nbsp;<a class="reference-link" href="#root/_help_grjYqerjn243">Canvas</a>&nbsp;instead.</p>
-</aside>
-<h3>Password-protected sections</h3>
-<p>OneNote supports encryption at section level; when importing a notebook
- that contains these password-protection sections, Trilium will not be able
- to read the content of password-protected sections so they will appear
- empty. This is not a limitation of Trilium, the information is simply not
- available from the source (Graph API).</p>
-<p>The section itself is kept for reference and all the sections that could
- not be imported will be shown in the report (the top-level note called <em>OneNote import</em>).</p>
-<p>To unprotect a section in OneNote Desktop, right click on the protected
- section → <em>Password Protect This Section</em> and press <em>Remove Password</em> and
- sync. Then re-import either only the protected sections or remove everything
- and start the import from scratch.</p>
-<h2>Other limitations</h2>
-<p>The following are known limitations due to how the information comes from
- the import (Microsoft Graph API), which means that they cannot be fixed.</p>
-<ul>
- <li>The order of the sections (and section groups) is not available, the sections
- are ordered by creation date instead.</li>
- <li>Revision history.</li>
- <li>Paragraph indentation, as well as code block indentation.</li>
- <li>Section colors.</li>
- <li>Drawings inside titles, the title might appear incomplete or “Untitled”.</li>
-</ul>
-<h2>Reporting issues</h2>
-<p>When importing notes, you might find that some text is not rendered properly
- or the structure is not properly maintained. As long as this issue is not
- a fundamental issue (like the issue with freehand text not being preserved
- exactly), it's a good idea to <a href="#root/_help_wy8So3yZZlH9">report it</a>.</p>
-<p>When reporting, make sure that you provide the following information:</p>
-<ul>
- <li>Import again the section, checking the debug checkbox before importing.
- This preserves the original document (and the hand-drawing data if any)
- as it came through from OneNote's cloud API so that it can be used for
- comparison.</li>
- <li>Export only the affected page as ZIP, making sure not to accidentally
- expose any sensitive information.</li>
- <li>Take screenshots of how the note looked like in OneNote and how it ends
- up in Trilium.</li>
- <li>Attach the ZIP and the screenshots to the issue report.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Microsoft OneNote/Tags.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Microsoft OneNote/Tags.html
deleted file mode 100644
index f4bf01bc1b..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Microsoft OneNote/Tags.html
+++ /dev/null
@@ -1,298 +0,0 @@
-<p>OneNote's <em>Tags</em> functionality is imported in Trilium as&nbsp;<a
- class="reference-link" href="#root/_help_hD8GawVuazff">Icons</a>&nbsp;using
- the default icon pack or emojis (if there is no suitable replacement).</p>
-<aside
-class="admonition important">
- <p>Custom tags are not supported by OneNote's Graph API so Trilium cannot
- import them.</p>
-</aside>
-<h3>Decorative tags</h3>
-<p>These remain formatted as paragraphs, with the glyph prepended to the
- text. A paragraph can carry several tags at once, in which case their glyphs
- stack.</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>OneNote tag</th>
- <th><code>data-tag</code>
- </th>
- <th>Imported as</th>
- <th>Searchable as</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>Important</td>
- <td><code>important</code>
- </td>
- <td><span class="tn-icon bx bx-star"></span>
- </td>
- <td><code>star</code>
- </td>
- </tr>
- <tr>
- <td>Critical</td>
- <td><code>critical</code>
- </td>
- <td><span class="tn-icon bx bx-error-circle"></span>
- </td>
- <td><code>error-circle</code>
- </td>
- </tr>
- <tr>
- <td>Question</td>
- <td><code>question</code>
- </td>
- <td><span class="tn-icon bx bx-help-circle"></span>
- </td>
- <td><code>help-circle</code>
- </td>
- </tr>
- <tr>
- <td>Highlight</td>
- <td><code>highlight</code>
- </td>
- <td><span class="tn-icon bx bx-highlight"></span>
- </td>
- <td><code>highlight</code>
- </td>
- </tr>
- <tr>
- <td>Definition</td>
- <td><code>remember-for-later</code>
- </td>
- <td><span class="tn-icon bx bx-pin"></span>
- </td>
- <td><code>pin</code>
- </td>
- </tr>
- <tr>
- <td>Remember for later</td>
- <td><code>remember-for-later</code>
- </td>
- <td><span class="tn-icon bx bx-pin"></span>
- </td>
- <td><code>pin</code>
- </td>
- </tr>
- <tr>
- <td>Remember for blog</td>
- <td><code>remember-for-blog</code>
- </td>
- <td><span class="tn-icon bx bx-edit"></span>
- </td>
- <td><code>edit</code>
- </td>
- </tr>
- <tr>
- <td>Idea</td>
- <td><code>idea</code>
- </td>
- <td><span class="tn-icon bx bx-bulb"></span>
- </td>
- <td><code>bulb</code>
- </td>
- </tr>
- <tr>
- <td>Password</td>
- <td><code>password</code>
- </td>
- <td><span class="tn-icon bx bx-key"></span>
- </td>
- <td><code>key</code>
- </td>
- </tr>
- <tr>
- <td>Contact</td>
- <td><code>contact</code>
- </td>
- <td><span class="tn-icon bx bx-user"></span>
- </td>
- <td><code>user</code>
- </td>
- </tr>
- <tr>
- <td>Address</td>
- <td><code>address</code>
- </td>
- <td><span class="tn-icon bx bx-home"></span>
- </td>
- <td><code>home</code>
- </td>
- </tr>
- <tr>
- <td>Phone number</td>
- <td><code>phone-number</code>
- </td>
- <td><span class="tn-icon bx bx-phone"></span>
- </td>
- <td><code>phone</code>
- </td>
- </tr>
- <tr>
- <td>Web site to visit</td>
- <td><code>web-site-to-visit</code>
- </td>
- <td><span class="tn-icon bx bx-globe"></span>
- </td>
- <td><code>globe</code>
- </td>
- </tr>
- <tr>
- <td>Source for article</td>
- <td><code>source-for-article</code>
- </td>
- <td><span class="tn-icon bx bx-news"></span>
- </td>
- <td><code>news</code>
- </td>
- </tr>
- <tr>
- <td>Send in email</td>
- <td><code>send-in-email</code>
- </td>
- <td><span class="tn-icon bx bx-envelope"></span>
- </td>
- <td><code>envelope</code>
- </td>
- </tr>
- <tr>
- <td>Movie to see</td>
- <td><code>movie-to-see</code>
- </td>
- <td><span class="tn-icon bx bx-movie"></span>
- </td>
- <td><code>movie</code>
- </td>
- </tr>
- <tr>
- <td>Book to read</td>
- <td><code>book-to-read</code>
- </td>
- <td><span class="tn-icon bx bx-book"></span>
- </td>
- <td><code>book</code>
- </td>
- </tr>
- <tr>
- <td>Music to listen to</td>
- <td><code>music-to-listen-to</code>
- </td>
- <td><span class="tn-icon bx bx-music"></span>
- </td>
- <td><code>music</code>
- </td>
- </tr>
- <tr>
- <td>Project A</td>
- <td><code>project-a</code>
- </td>
- <td>🅰️</td>
- <td>🅰️</td>
- </tr>
- <tr>
- <td>Project B</td>
- <td><code>project-b</code>
- </td>
- <td>🅱️</td>
- <td>🅱️</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<h3>Check box tags</h3>
-<p>These become&nbsp;<a class="reference-link" href="#root/_help_fASfBrYnquKU">To-do Lists</a>,
- with the glyph inside the item with the tick state preserved:</p>
-<figure
-class="table">
- <table>
- <thead>
- <tr>
- <th>OneNote tag</th>
- <th><code>data-tag</code>
- </th>
- <th>Imported as</th>
- <th>Searchable as</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>To Do</td>
- <td><code>to-do</code>
- </td>
- <td><em>(none)</em>
- </td>
- <td>—</td>
- </tr>
- <tr>
- <td>To Do priority 1</td>
- <td><code>to-do-priority-1</code>
- </td>
- <td>1️⃣</td>
- <td>1️⃣</td>
- </tr>
- <tr>
- <td>To Do priority 2</td>
- <td><code>to-do-priority-2</code>
- </td>
- <td>2️⃣</td>
- <td>2️⃣</td>
- </tr>
- <tr>
- <td>Discuss with Person A</td>
- <td><code>discuss-with-person-a</code>
- </td>
- <td><span class="tn-icon bx bx-message-rounded"></span>
- </td>
- <td><code>message-rounded</code>
- </td>
- </tr>
- <tr>
- <td>Discuss with Person B</td>
- <td><code>discuss-with-person-b</code>
- </td>
- <td><span class="tn-icon bx bx-message-rounded"></span>
- </td>
- <td><code>message-rounded</code>
- </td>
- </tr>
- <tr>
- <td>Discuss with manager</td>
- <td><code>discuss-with-manager</code>
- </td>
- <td><span class="tn-icon bx bx-conversation"></span>
- </td>
- <td><code>conversation</code>
- </td>
- </tr>
- <tr>
- <td>Schedule meeting</td>
- <td><code>schedule-meeting</code>
- </td>
- <td><span class="tn-icon bx bx-calendar"></span>
- </td>
- <td><code>calendar</code>
- </td>
- </tr>
- <tr>
- <td>Call back</td>
- <td><code>call-back</code>
- </td>
- <td><span class="tn-icon bx bx-phone-call"></span>
- </td>
- <td><code>phone-call</code>
- </td>
- </tr>
- <tr>
- <td>Client request</td>
- <td><code>client-request</code>
- </td>
- <td><span class="tn-icon bx bx-clipboard"></span>
- </td>
- <td><code>clipboard</code>
- </td>
- </tr>
- </tbody>
- </table>
-</figure>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Notion.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Notion.html
deleted file mode 100644
index 76b7867142..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Notion.html
+++ /dev/null
@@ -1,226 +0,0 @@
-<p>Trilium can import ZIP exports from Notion while preserving structure
- and formatting.</p>
-<h2>Import process</h2>
-<p>In Notion, there are two ways to export data:</p>
-<ul>
- <li>To export a single page (and optionally its sub-pages):
- <ul>
- <li>Select the page to export.</li>
- <li>Press the […] button at the top-right of the window and select <em>Export</em>.</li>
- <li>Ensure the following options are set:
- <ul>
- <li>Export format: HTML</li>
- <li>Page content: Everything</li>
- <li>Include subpages: On</li>
- <li>Create folders for subpages: On</li>
- </ul>
- </li>
- <li>Press the Export button.</li>
- <li>Wait for the download to finish.</li>
- </ul>
- </li>
- <li>To export an entire workspace, press your user name badge at top-left
- and select <em>Settings</em>.
- <ul>
- <li>In the left section, look for the <em>Workspace</em> category and select <em>General</em>.</li>
- <li>In the <em>General</em> settings page, look for the <em>Export</em> section
- and press the <em>Export</em> button corresponding to <em>Workspace content</em>.</li>
- <li>Ensure the following options are set:
- <ul>
- <li>Export format: HTML</li>
- <li>Page content: Everything</li>
- <li>Include subpages: On</li>
- <li>Create folders for subpages: On</li>
- </ul>
- </li>
- <li>Press the Export button.</li>
- <li>Wait for the download to finish. Depending on the size of your workspace
- it might take a while. You will get a downloadable copy via email if takes
- too long.</li>
- </ul>
- </li>
-</ul>
-<p>In Trilium Notes:</p>
-<ol>
- <li>In the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>,
- right click and select <em>Import into note</em> (<span class="tn-icon bx bx-import"></span>).</li>
- <li>In the <em>Import from</em> section, select&nbsp;<span class="tn-icon tn-brand tn-brand-notion"></span> <em>Notion</em>.</li>
- <li>Upload the ZIP obtained in the previous step.</li>
-</ol>
-<h2>Supported features</h2>
-<p>The following features are preserved by Trilium during the import process:</p>
-<ul>
- <li>Basic formatting (bold, italic, underline, strikethrough, headings, colors,
- highlights).</li>
- <li><a class="reference-link" href="#root/_help_S6Xx8QIWTV66">Lists</a>
- </li>
- <li>To-do lists</li>
- <li><a class="reference-link" href="#root/_help_mT0HEkOsz6i1">Images</a>&nbsp;and&nbsp;<a
- class="reference-link" href="#root/_help_0vhv7lsOLy82">Attachments</a>.</li>
- <li>Toggle sections
- <ul>
- <li>Nested toggle sections are also supported.</li>
- <li>Toggle headings are stripped of their toggle button and become normal
- headings instead.</li>
- </ul>
- </li>
- <li><a class="reference-link" href="#root/_help_YfYAtQBcfo5V">Math Equations</a>&nbsp;(inline
- or block)</li>
- <li><a class="reference-link" href="#root/_help_UmgZAfcltxkS">Link Previews</a>
- <ul>
- <li>The icon and image of the links need to be retrieved online since the
- exports don't carry the images. This operation is done only if <em>Download images automatically</em> is
- enabled in&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Media</em>.</li>
- </ul>
- </li>
- <li><a class="reference-link" href="#root/_help_QxEyIjRBizuC">Code blocks</a>,
- with a best-effort attempt to restore the language.</li>
- <li><a class="reference-link" href="#root/_help_s1aBHPd79XYj">Mermaid Diagrams</a>
- </li>
- <li>Links between other imported pages are converted to&nbsp;<a class="reference-link"
- href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a>&nbsp;if
- they are part of the same import.</li>
- <li>Databases are imported as&nbsp;<a class="reference-link" href="#root/_help_GTwFsgaA0lCt">Collections</a>&nbsp;(see
- below).</li>
- <li><a href="#root/_help_NwBbFdNZ9h7O">Admonitions</a> are preserved, including
- its emoji (added as part of the content).</li>
- <li>Columns are imported as transparent <a href="#root/_help_NdowYOC1GFKS">tables</a>,
- preserving the column definition.</li>
- <li>Table of content blocks are <em>removed</em>, as the table of contents
- is already present in the sidebar (see&nbsp;<a class="reference-link" href="#root/_help_BFvAtE74rbP6">Table of contents</a>),
- as well as in shared notes.</li>
-</ul>
-<h2>Databases</h2>
-<p>Notion databases are imported into&nbsp;<a class="reference-link" href="#root/_help_GTwFsgaA0lCt">Collections</a>,
- where each item of the database is saved as a page in the collection. Through
- the use of <a href="#root/_help_bwZpz2ajCEwO">inherited</a>&nbsp;<a class="reference-link"
- href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>, most of the page
- properties in Notion are preserved by the import.</p>
-<p>The resulting collection will be&nbsp;<a class="reference-link" href="#root/_help_2FvYrpmOXm29">Table</a>&nbsp;regardless
- of the original view the database was exported in. That's because the active
- view is not saved in the export and the table collection is the most compatible
- with Notion.</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th scope="col">Notion type</th>
- <th scope="col">Trilium</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>Text / Select / Status / Place</td>
- <td>Single-valued <code>text</code> label</td>
- </tr>
- <tr>
- <td>Number</td>
- <td>Single-valued <code>number</code> label for plain numbers. Formatted values
- (currency, percent, thousands separators) are normalized to a bare number,
- e.g. <code>$1,200.50</code> → <code>1200.50</code>.</td>
- </tr>
- <tr>
- <td>ID</td>
- <td>Single-valued <code>number</code> or <code>text</code> label (depending on
- whether a prefix is configured)</td>
- </tr>
- <tr>
- <td>Multi-select</td>
- <td>One text label per option (multi)</td>
- </tr>
- <tr>
- <td>URL / Email / Phone</td>
- <td><code>url</code> label (<code>mailto:</code>, <code>tel:</code> prefix)</td>
- </tr>
- <tr>
- <td>Date</td>
- <td>
- <ul>
- <li><code>datetime</code> if at least one has time.</li>
- <li><code>date</code> if only dates.</li>
- <li>Two attributes if any of the dates have an end date.</li>
- </ul>
- </td>
- </tr>
- <tr>
- <td>Checkbox</td>
- <td><code>boolean</code> label (<code>true</code>/<code>false</code>).</td>
- </tr>
- <tr>
- <td>Person</td>
- <td>One text label per user (multi)</td>
- </tr>
- <tr>
- <td>Created by / Edited by</td>
- <td>Single-valued <code>text</code> label</td>
- </tr>
- <tr>
- <td>Created time / Last edited time</td>
- <td>Assigned to the note's creation and modification date.</td>
- </tr>
- <tr>
- <td>Relation</td>
- <td>Mapped to <a href="#root/_help_Cq5X6iKQop6R">relations</a>, each link resolved
- to its target note via the existing cross-page map; targets outside the
- import are dropped.</td>
- </tr>
- <tr>
- <td>Files &amp; Media</td>
- <td>The files are preserved as attachments, and a link to them is prepended
- to the content of the note for visibility.</td>
- </tr>
- <tr>
- <td>Formulas / Rollup</td>
- <td>
- <p>A <code>text</code>, <code>number</code> or <code>boolean</code> label depending
- on the value. Dates are rendered as <code>text</code> because the export
- doesn't offer any type information.</p>
- <p>The Notion export does not preserve the formula/rollup configuration itself,
- instead it just exports the value.</p>
- </td>
- </tr>
- <tr>
- <td>Button / Verification / any other type</td>
- <td>Unsupported, they will be dropped from the import.</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<aside class="admonition note">
- <p><strong>Technical information</strong>
- </p>
- <p>Every page property that can be preserved according to the table above
- is saved as a label or relation to the corresponding note (except for creation
- and modification dates which are saved at note level).</p>
- <p>To maintain a similar UX to Notion, every property is also turned into&nbsp;<a
- class="reference-link" href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;at
- collection level. This also makes the columns visible in the table collection.
- The promoted attributes are made inheritable so that they appear when navigating
- in the child notes as well.</p>
- <p>The names of the labels are intentionally converted to <code>camelCase</code> to
- match Trilium's conventions, but the full name of the column is preserved
- through the <em>Alias</em> mechanism of promoted attributes.</p>
-</aside>
-<h2>Limitations</h2>
-<h3>Missing data from the import</h3>
-<p>The following information is not preserved by the import because it is
- not available in the export so it cannot be restored:</p>
-<ul>
- <li>The order of the pages and sub-pages.</li>
- <li>Creation/modification dates are restored only when the page includes Created
- time / Last edited time properties (collection or not); otherwise the import
- time is used.</li>
-</ul>
-<h3>Cover images and page icon</h3>
-<p>The page icon or emoji is not preserved, with created notes having the
- default icon. The cover image is not imported at all.</p>
-<h2>Reporting issues</h2>
-<p>When importing your Notion workspace, you might find issues in how a note
- is imported; in that case consider <a href="#root/_help_wy8So3yZZlH9">reporting</a> it.</p>
-<p>When reporting such an issue make sure to provide the following information:</p>
-<ul>
- <li>A .zip export of the original Notion note (and children if applicable).
- This allows us to reproduce the issue.</li>
- <li>A screenshot with how it originally looked like before the import and
- how it looks after the import.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Obsidian.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Obsidian.html
deleted file mode 100644
index f163a44f6e..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Importing data from other applications/Obsidian.html
+++ /dev/null
@@ -1,170 +0,0 @@
-<p>Although Obsidian was indirectly supported through the standard&nbsp;<a
- class="reference-link" href="#root/_help_Oau6X9rCuegd">Markdown</a>&nbsp;import,
- its vault structure is distinct enough to warrant its own dedicated import
- channel.</p>
-<h2>Import process</h2>
-<p>The first step is to obtain a .zip of your Obsidian vault:</p>
-<ol>
- <li>First, identify where your Obsidian vault is located. The easiest way
- to do so is to open Obsidian and right clicking the name of the vault at
- the bottom of the left sidebar and then selecting <em>Show in system explorer</em>.</li>
- <li>In your system explorer, right click the directory containing your Obsidian
- vault and compress it to a ZIP file (e.g. on Windows, <em>Compress To</em> → <em>ZIP</em>).</li>
-</ol>
-<aside class="admonition tip">
- <p>When zipping, you can either ZIP the outer folder of the vault, or the
- contents of the vault as Trilium will automatically determine the position
- of the vault in the archive via the <code>.obsidian</code> directory.</p>
-</aside>
-<p>Then, in Trilium Notes:</p>
-<ol>
- <li>In the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>,
- right click and select <em>Import into note</em>.</li>
- <li>In the <em>Import from</em> section, select&nbsp;<span class="tn-icon tn-brand tn-brand-obsidian"></span> <em>Obsidian</em>.</li>
- <li>Upload the ZIP obtained in the previous step.</li>
-</ol>
-<p>Alternatively, simply drag &amp; drop the .zip archive in the&nbsp;<a
- class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;and
- Trilium will auto-detect it as an Obsidian import provided there is a <code>.obsidian</code> directory.
- If not, follow the previous steps instead.</p>
-<h2>Supported features</h2>
-<p>The following features are preserved by Trilium during the import process:</p>
-<ul>
- <li>Folder hierarchy is preserved.</li>
- <li>Basic Markdown formatting (bold, italic, underline, strikethrough, headings).</li>
- <li>Specific Obsidian formatting (highlighting).</li>
- <li><a class="reference-link" href="#root/_help_S6Xx8QIWTV66">Lists</a>
- </li>
- <li>To-do lists</li>
- <li><a class="reference-link" href="#root/_help_mT0HEkOsz6i1">Images</a>&nbsp;and&nbsp;<a
- class="reference-link" href="#root/_help_0vhv7lsOLy82">Attachments</a>
- <ul>
- <li>Non-Markdown files in the Vault are treated as attachments by default
- if they are referenced by at least one note.</li>
- <li>Otherwise, they will be imported as&nbsp;<a class="reference-link" href="#root/_help_W8vYD3Q1zjCR">File</a>&nbsp;notes.</li>
- </ul>
- </li>
- <li>Transclusions are converted to&nbsp;<a class="reference-link" href="#root/_help_nBAXQFj20hS1">Include Note</a>&nbsp;or&nbsp;<a
- class="reference-link" href="#root/_help_mT0HEkOsz6i1">Images</a>&nbsp;(depending
- on type).</li>
- <li><a class="reference-link" href="#root/_help_YfYAtQBcfo5V">Math Equations</a>&nbsp;(inline
- or block)</li>
- <li><a class="reference-link" href="#root/_help_QxEyIjRBizuC">Code blocks</a>,
- with a best-effort attempt to restore the language.</li>
- <li>Links between pages are converted to&nbsp;<a class="reference-link" href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a>.</li>
- <li>Callouts are converted to Trilium's <a href="#root/_help_NwBbFdNZ9h7O">Admonitions</a>.
- <ul>
- <li>Obsidian has many more types of callouts (<code>tldr</code>, <code>question</code>, <code>attention</code>),
- these are all mapped to one of Trilium's existing admonition types (e.g.
- Note, Tip, Important).</li>
- <li>Custom titles are kept and shown as a bold line at the top of the admonition,
- since there is no concept of admonition title in Trilium.</li>
- <li>Foldable callouts are imported expanded and without a fold marker.</li>
- </ul>
- </li>
- <li>Notes created by the <a href="https://github.com/zsviczian/obsidian-excalidraw-plugin"><em>Excalidraw</em></a> community
- plugin for Obsidian are converted to&nbsp;<a class="reference-link" href="#root/_help_grjYqerjn243">Canvas</a>&nbsp;(same
- underlying technology).
- <ul>
- <li>Note that custom features introduced by that plugin will not be supported.</li>
- </ul>
- </li>
- <li>Modification date is preserved via the information obtained from the .zip
- archive, creation date is not recoverable so it's kept the same as the
- modification date.</li>
-</ul>
-<h2>Properties</h2>
-<p>Properties are Obsidian's equivalent of&nbsp;<a class="reference-link"
- href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>. One of the core
- differences between the two is where the property information is stored
- (i.e. name and type): in Obsidian everything is stored at vault level and
- shared across all notes, whereas in Trilium each page can have individual
- promoted attributes, shared through&nbsp;<a class="reference-link" href="#root/_help_KC1HB96bqqHX">Templates</a>&nbsp;or&nbsp;<a
- class="reference-link" href="#root/_help_bwZpz2ajCEwO">Attribute Inheritance</a>.</p>
-<p>Another important difference is that promoted attributes in Trilium are
- always displayed, even if empty. In Obsidian, these are simply suggested
- when creating a new property.</p>
-<p>To reconcile all these differences, properties are converted to&nbsp;<a
- class="reference-link" href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;at
- note level.</p>
-<p>The following note types are supported:</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Obsidian type</th>
- <th>Trilium</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>Text or not defined</td>
- <td>Single-valued <code>text</code> label</td>
- </tr>
- <tr>
- <td>Number</td>
- <td>Single-valued <code>number</code> label</td>
- </tr>
- <tr>
- <td>Multitext</td>
- <td>Multi-valued <code>text</code> label</td>
- </tr>
- <tr>
- <td>Checkbox</td>
- <td><code>boolean</code> label (<code>true</code>/<code>false</code>).</td>
- </tr>
- <tr>
- <td>Date</td>
- <td><code>date</code>
- </td>
- </tr>
- <tr>
- <td>Date &amp; Time</td>
- <td><code>datetime</code>
- </td>
- </tr>
- </tbody>
- </table>
-</figure>
-<h3>Special properties</h3>
-<p>Obsidian has a few reserved property names, which are treated differently
- in Trilium as well:</p>
-<ul>
- <li><code>tags</code>, where every tag is turned into its own <a href="#root/_help_HI6GBBIduIgv">label</a> (e.g. <code>#one</code>, <code>#two</code> when <code>tags: [ one, two ]</code>).</li>
- <li><code>aliases</code> are simply mapped to individual <code>#alias</code> labels</li>
- <li><code>cssclasses</code>, <code>publish</code>, <code>permalink</code> are
- ignored.</li>
-</ul>
-<h2>Limitations</h2>
-<ul>
- <li>Comments (<code>%%</code> syntax) are simply stripped.</li>
- <li>Obsidian <em>bases</em> functionality is not preserved.
- <ul>
- <li>The closest equivalent in Trilium would be&nbsp;<a class="reference-link"
- href="#root/_help_GTwFsgaA0lCt">Collections</a>&nbsp;but they work fundamentally
- different because bases don't store particular notes, they act more like
- a&nbsp;<a class="reference-link" href="#root/_help_m523cpzocqaD">Saved Search</a>&nbsp;with
- a collection view.</li>
- <li>Since the base query format is quite different to Trilium's&nbsp;<a class="reference-link"
- href="#root/_help_eIg8jdvaoNNd">Search</a>&nbsp;syntax, it's unlikely they'll
- ever be supported.</li>
- <li>When a base is encountered, it is simply ignored from the import.</li>
- </ul>
- </li>
- <li>Canvases are not imported.
- <ul>
- <li>Theoretically they could map to either&nbsp;<a class="reference-link"
- href="#root/_help_grjYqerjn243">Canvas</a>&nbsp;or&nbsp;<a class="reference-link"
- href="#root/_help_iRwzGnHPzonm">Relation Map</a>&nbsp;but they are too
- different to reconcile.</li>
- </ul>
- </li>
- <li>Links
- <ul>
- <li>Links to a specific heading in another note will still point to the right
- note, but the heading anchor will be dropped.</li>
- <li>Dangling links (pointing to a note that doesn't exist) and ambiguous links
- (same base name in 2+ notes) are unwrapped to plain text.</li>
- </ul>
- </li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Markdown.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Markdown.html
deleted file mode 100644
index 5d8d02dead..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Markdown.html
+++ /dev/null
@@ -1,45 +0,0 @@
-<p>Trilium supports Markdown for both import and export, while trying to
- keep compatibility as high as possible.</p>
-<h2>Import</h2>
-<h3>Clipboard import</h3>
-<p>If you want to import just a chunk of markdown from clipboard, you can
- do it from editor block menu:</p>
-<p>
- <img src="Markdown_markdown-inline-import.gif">
-</p>
-<h3>File import</h3>
-<p>You can also import Markdown files from files:</p>
-<ul>
- <li>single markdown file (with .md extension)</li>
- <li>whole tree of markdown files (packaged into <a href="https://en.wikipedia.org/wiki/Tar_(computing)">.zip</a> archive)
- <ul>
- <li>Markdown files need to be packaged into ZIP archive because browser can't
- read directories, only single files.</li>
- <li>You can use e.g. <a href="https://www.7-zip.org">7-zip</a> to package directory
- of markdown files into the ZIP file</li>
- </ul>
- </li>
-</ul>
-<p>
- <img src="Markdown_markdown-file-import.gif">
-</p>
-<h2>Export</h2>
-<h3>Subtree export</h3>
-<p>You can export whole subtree to ZIP archive which will have directory
- structured modelled after subtree structure:</p>
-<p>
- <img src="Markdown_markdown-export-subtree.gif">
-</p>
-<h3>Single note export</h3>
-<p>If you want to export just single note without its subtree, you can do
- it from Note actions menu:</p>
-<p>
- <img src="Markdown_markdown-export-note.gif">
-</p>
-<h3>Exporting protected notes</h3>
-<p>If you want to export protected notes, enter a protected session first!
- This will export the notes in an unencrypted form, so if you reimport into
- Trilium, make sure to re-protect these notes.</p>
-<h2>Supported syntax</h2>
-<p>See the dedicated page:&nbsp;<a class="reference-link" href="#root/_help_rJ9grSgoExl9">Supported syntax</a>
-</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Markdown/Supported syntax.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Markdown/Supported syntax.html
deleted file mode 100644
index 4d7897b98b..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Markdown/Supported syntax.html
+++ /dev/null
@@ -1,86 +0,0 @@
-<p><a href="https://github.github.com/gfm/">GitHub-Flavored Markdown</a> is
- the main syntax that Trilium is following.</p>
-<h2>Images</h2>
-<p>When exporting, images are usually kept in the basic Markdown syntax but
- will use the HTML syntax if the image has a custom width. Figures are always
- embedded as HTML.</p>
-<h2>Tables</h2>
-<p>Simple tables are supported with the Markdown syntax. If the table is
- too complex or contains elements that would render as HTML, the table is
- also rendered as HTML.</p>
-<h2>Links</h2>
-<p>Standard Markdown links are supported.</p>
-<p>Trilium internal links (that mirror a note's title and display its icon)
- are embedded as HTML in order to preserve the information on import.</p>
-<h2>Math equations</h2>
-<p>Both inline and display equations are supported, using the <code>$</code> and <code>$$</code> syntaxes.</p>
-<h2>Admonitions</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-trilium-auto">&gt; [!NOTE]
-&gt; This is a note.
-
-&gt; [!TIP]
-&gt; This is a tip.
-
-&gt; [!IMPORTANT]
-&gt; This is a very important information.
-
-&gt; [!CAUTION]
-&gt; This is a caution.</code></pre>
-<p>There are currently no plans of supporting alternative admonition syntaxes
- such as <code>!!! note</code>.</p>
-<h2>Tabs</h2>
-<p>Tabs use the syntax of <a href="https://squidfunk.github.io/mkdocs-material/reference/content-tabs/">Material for MkDocs</a>:
- each tab starts with a <code>=== "Title"</code> line, followed by its content
- indented by four spaces. Consecutive tabs form one tabs block, and <code>===!</code> starts
- a new block right after another one:</p><pre><code class="language-text-x-trilium-auto">=== "Windows"
-
- Run the **installer**.
-
-=== "Linux"
-
- Use the package.
-
-===! "Another block"
-
- This tab starts a separate tabs block.</code></pre>
-<p>Tabs can be nested by indenting the inner tabs inside the content of a
- tab. A tab title is plain text, so its formatting is not kept on export.
- For how tabs blocks work in a text note, see&nbsp;<a class="reference-link"
- href="#root/_help_EK2ckIZ74tbT">Content tabs</a>.</p>
-<h2>Wikilinks</h2>
-<p>Basic support for wikilinks has been added in v0.96.0:</p>
-<ul>
- <li><code>[[foo/bar]]</code> will look for the <code>bar.md</code> file in the <code>foo</code> directory
- and turn it into an internal link.</li>
- <li><code>![[foo/baz.png]]</code> will look for the <code>baz.png</code> file
- in the <code>foo</code> directory and turn it into an image.</li>
-</ul>
-<p>This feature is import-only, which means that it will turn wikilinks into
- Trilium-compatible syntax, but it will not export Trilium Notes into Markdown
- files with this syntax.</p>
-<aside class="admonition important">
- <p>The path to pages in wikilinks is resolved relatively to the <em>import root</em> and
- not the current directory of the note. This is to be inline with other
- platforms that use wikilinks such as SilverBullet.</p>
- <p>The root path of the import is determined as follows:</p>
- <ul>
- <li>If there is a single directory within the archive at root level, then
- that directory is considered the root.</li>
- <li>If there are multiple files &amp; directories at root level, then the
- archive root (containing all of these items) is considered the root.</li>
- </ul>
-</aside>
-<h2>Highlights</h2>
-<p>Background highlights are supported in two ways:</p>
-<ul>
- <li>
- <p>The Markdown <code>==</code> extension which is supported by other Markdown-based
- applications such as Obsidian:</p><pre><code class="language-text-x-trilium-auto">==highlighted==</code></pre>
- </li>
- <li>
- <p>The canonical HTML representation of highlights, as supported by Trilium:</p><pre><code class="language-text-html">&lt;span style="background-color:hsl(0,0%,100%);"&gt;Highlighted&lt;/span&gt;</code></pre>
- </li>
-</ul>
-<p>When the yellow highlight is used, import/export prefers the <code>==</code> syntax
- whereas the canonical HTML reprepresentation is used otherwise.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Markdown_markdown-export-note.gif b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Markdown_markdown-export-note.gif
deleted file mode 100644
index d1eb7c0876..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Markdown_markdown-export-note.gif and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Markdown_markdown-export-subtree.gif b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Markdown_markdown-export-subtree.gif
deleted file mode 100644
index 13316bb5fb..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Markdown_markdown-export-subtree.gif and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Markdown_markdown-file-import.gif b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Markdown_markdown-file-import.gif
deleted file mode 100644
index bcb2541f31..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Markdown_markdown-file-import.gif and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Markdown_markdown-inline-import.gif b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Markdown_markdown-inline-import.gif
deleted file mode 100644
index bf27467fd7..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Import & Export/Markdown_markdown-inline-import.gif and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Keyboard Shortcuts.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Keyboard Shortcuts.html
deleted file mode 100644
index 0853ffd07c..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Keyboard Shortcuts.html
+++ /dev/null
@@ -1,134 +0,0 @@
-<p>This is supposed to be a complete list of keyboard shortcuts. Note that
- some of these may work only in certain contexts (e.g. in tree pane or note
- editor).</p>
-<h2>Configuring keyboard shortcuts</h2>
-<p>It is also possible to configure most keyboard shortcuts in&nbsp;<a class="reference-link"
- href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Shortcuts</em>.</p>
-<p>On the&nbsp;<a class="reference-link" href="#root/_help_poXkQfguuA0U">Desktop Installation</a>,
- it's also possible to make shortcuts global by pressing on the globe icon
- near the key combination, which makes the shortcut work even without Trilium
- being in focus.</p>
-<h3>Keyboard layouts</h3>
-<p>Shortcuts follow the characters printed on the keys of the active keyboard
- layout. On a French AZERTY keyboard, for example, <kbd>Ctrl</kbd>+<kbd>Z</kbd> is
- the key labeled Z.</p>
-<p>On a layout that doesn't type Latin letters, such as Russian, Greek or
- Hebrew, a key that types a letter of that alphabet counts as the key at
- the same position on a US QWERTY keyboard. <kbd>Ctrl</kbd>+<kbd>J</kbd> is
- then the key that types <code>о</code> on a Russian keyboard, so shortcuts
- keep working without switching the layout first.</p>
-<p>Keys that type punctuation still follow their own character. On a Russian
- keyboard, the key that types <code>.</code> triggers <kbd>Ctrl</kbd>+<kbd>.</kbd>,
- not the shortcut of the US key at its position.</p>
-<h2>Shortcut reference</h2>
-<aside class="admonition note">
- <p>All these shortcuts indicate the default key-bindings which can be changed
- individually from&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Shortcuts.</em>
- </p>
-</aside>
-<h3>Tree</h3>
-<p>See the corresponding section:&nbsp;<a class="reference-link" href="#root/_help_DvdZhoQZY9Yd">Keyboard shortcuts</a>
-</p>
-<h3>Note navigation</h3>
-<ul>
- <li><kbd>Alt</kbd>+<kbd>←</kbd>, <kbd>Alt</kbd>+<kbd>→</kbd> – go back / forwards
- in the history</li>
- <li><kbd>Ctrl</kbd>+<kbd>J</kbd> – show <a href="#root/_help_MMiBEQljMQh2">"Jump to" dialog</a>
- </li>
- <li><kbd>Ctrl</kbd>+<kbd>.</kbd> – scroll to current note (useful when you
- scroll away from your note or your focus is currently in the editor)</li>
- <li><kbd>Backspace</kbd> – jumps to parent note</li>
- <li><kbd>Alt</kbd>+<kbd>C</kbd> – collapse whole note tree</li>
- <li><kbd>Alt</kbd>+<kbd>-</kbd> (alt with minus sign) – collapse subtree (if
- some subtree takes too much space on tree pane you can collapse it)</li>
- <li>you can define a <a href="#root/_help_zEY4DaJG4YT5">label</a> <code>#keyboardShortcut</code> with
- e.g. value <code>Ctrl + I</code> . Pressing this keyboard combination will
- then bring you to the note on which it is defined. Note that Trilium must
- be reloaded/restarted (<kbd>Ctrl</kbd>+<kbd>R</kbd> ) for changes to be
- in effect.</li>
-</ul>
-<p>See demo of some of these features in <a href="#root/_help_MMiBEQljMQh2">note navigation</a>.</p>
-<h3>Tabs</h3>
-<ul>
- <li><kbd>Ctrl</kbd> + <kbd>🖱 Left click</kbd> – (or middle mouse click) on note
- link opens note in a new tab</li>
-</ul>
-<p>Only in desktop (electron build):</p>
-<ul>
- <li><kbd>Ctrl</kbd>+<kbd>T</kbd> – opens empty tab</li>
- <li><kbd>Ctrl</kbd>+<kbd>W</kbd> – closes active tab</li>
- <li><kbd>Ctrl</kbd>+<kbd>Tab</kbd> – activates next tab</li>
- <li><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Tab</kbd> – activates previous tab</li>
-</ul>
-<h3>Splits</h3>
-<p><a class="reference-link" href="#root/_help_luNhaphA37EO">Split View</a>&nbsp;can
- also be controlled through keyboard actions, such as:</p>
-<ul>
- <li>Creating a new split</li>
- <li>Closing the active split</li>
- <li>Moving a split left/right</li>
- <li>Focusing the split to the left/right.</li>
-</ul>
-<p>All these keyboard shortcuts do not have a default set, go to&nbsp;<a
- class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Shortcuts</em> and
- look for the <em>Split View</em> category.</p>
-<h3>Context menus</h3>
-<p>Every context menu can be operated from the keyboard, however it was opened,
- for example with the <kbd>Menu</kbd> key in a text note to reach the spelling
- suggestions. These keys are fixed and cannot be changed in the options.</p>
-<ul>
- <li><kbd>↑</kbd>, <kbd>↓</kbd> – move to the previous / next item, skipping
- disabled ones and wrapping around at either end</li>
- <li><kbd>Home</kbd>, <kbd>End</kbd> – move to the first / last item</li>
- <li><kbd>→</kbd> – open the submenu of the current item, or move to the next
- column in a submenu laid out in columns</li>
- <li><kbd>←</kbd> – move to the previous column, or close the submenu and go
- back to its item</li>
- <li><kbd>Enter</kbd> or <kbd>Space</kbd> – run the current item, or open its
- submenu</li>
- <li><kbd>Esc</kbd> – close the innermost submenu, then the menu itself</li>
- <li>typing the first letters of an item – jump to the next item whose title
- starts with them</li>
-</ul>
-<p>With a right-to-left language, <kbd>←</kbd> and <kbd>→</kbd> swap roles.</p>
-<h3>Creating notes</h3>
-<ul>
- <li><kbd>Ctrl</kbd>+<kbd>O</kbd> – creates new note after the current note</li>
- <li><kbd>Ctrl</kbd>+<kbd>P</kbd> – creates new sub-note into current note</li>
- <li><kbd>F2</kbd> – edit the&nbsp;<a class="reference-link" href="#root/_help_TBwsyfadTA18">Branch prefix</a>&nbsp;of
- current note clone</li>
-</ul>
-<h3>Editing notes</h3>
-<aside class="admonition note">
- <p>For keyboard shortcuts specific to&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes,
- refer to&nbsp;<a class="reference-link" href="#root/_help_oiVPnW8QfnvS">Keyboard shortcuts</a>&nbsp;and&nbsp;<a
- class="reference-link" href="#root/_help_QrtTYPmdd1qq">Markdown-like formatting</a>.</p>
-</aside>
-<ul>
- <li>Enter in tree pane switches from tree pane into note title. Enter from
- note title switches focus to text editor. <kbd>Ctrl</kbd>+<kbd>.</kbd> switches
- back from editor to tree pane.</li>
- <li><kbd>Ctrl</kbd>+<kbd>.</kbd> – jump away from the editor to tree pane and
- scroll to current note</li>
-</ul>
-<h3>Runtime shortcuts</h3>
-<p>These are hooked in Electron to be similar to native browser keyboard
- shortcuts.</p>
-<ul>
- <li><kbd>F5</kbd>, <kbd>Ctrl</kbd>+<kbd>R</kbd> – reloads Trilium front-end</li>
- <li><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd> – show developer tools</li>
- <li><kbd>Ctrl</kbd>+<kbd>F</kbd> – show search dialog</li>
- <li><kbd>Ctrl</kbd>+<kbd>-</kbd> – zoom out</li>
- <li><kbd>Ctrl</kbd>+<kbd>=</kbd> – zoom in</li>
-</ul>
-<h3>Other</h3>
-<ul>
- <li><kbd>Alt</kbd>+<kbd>O</kbd> – show SQL console (use only if you know what
- you're doing)</li>
- <li><kbd>Alt</kbd>+<kbd>M</kbd> – distraction-free mode - display only note
- editor, everything else is hidden</li>
- <li><kbd>F11 </kbd> – toggle full screen</li>
- <li><kbd>Ctrl</kbd>+<kbd>S</kbd> – toggle <a href="#root/_help_eIg8jdvaoNNd">search</a> form
- in tree pane</li>
- <li><kbd>Alt</kbd>+<kbd>A</kbd> – show note <a href="#root/_help_zEY4DaJG4YT5">attributes</a> dialog</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/1_Jump to & command palette_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/1_Jump to & command palette_image.png
deleted file mode 100644
index 4304944c41..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/1_Jump to & command palette_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Bookmarks.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Bookmarks.html
deleted file mode 100644
index f4ed28c94f..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Bookmarks.html
+++ /dev/null
@@ -1,18 +0,0 @@
-<p>Frequently used notes can be bookmarked, which will make them appear in
- the&nbsp;<a class="reference-link" href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>&nbsp;for
- easy access.</p>
-<h2>Configuring the launch bar</h2>
-<p>If bookmarks don't appear in the launch bar, then most likely the bookmark
- section has been hidden. Go to the&nbsp;<a class="reference-link" href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>&nbsp;configuration
- from the&nbsp;<a class="reference-link" href="#root/_help_x3i7MxGccDuM">Global menu</a>&nbsp;and
- ensure <em>Bookmarks</em> is in the <em>Visible Launchers</em> section.</p>
-<h2>Bookmark folder</h2>
-<p>Space in the left panel is limited, and you might want to bookmark many
- items. One possible solution is to bookmark a folder, so it shows its children:</p>
-<p>To do this, bookmark a folder and assign it the <code>#bookmarkFolder</code> label.</p>
-<h2>Mobile</h2>
-<p>On mobile, bookmarks are only displayed starting with v0.102.0. Because
- of the more constrained screen size, the bookmarks are grouped under a
- single icon instead of displaying them as separate icons.</p>
-<p>When pressed, a menu will appear listing all the bookmarks. Bookmark folders
- are also supported and will appear as sub-menus.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Jump to & command palette.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Jump to & command palette.html
deleted file mode 100644
index b25d39591a..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Jump to & command palette.html
+++ /dev/null
@@ -1,117 +0,0 @@
-<figure class="image image-style-align-center">
- <img style="aspect-ratio:991/403;" src="1_Jump to & command palette_image.png"
- width="991" height="403">
-</figure>
-<h2>Jump to Note</h2>
-<p>The <em>Jump to Note</em> function allows easy navigation between notes
- by searching for their title. In addition to that, it can also trigger
- a full search or create notes.</p>
-<p>To enter the “Jump to” dialog:</p>
-<ul>
- <li>In the&nbsp;<a class="reference-link" href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>,
- press&nbsp;<span class="tn-icon bx bx-send"></span> button.</li>
- <li>Using the keyboard, press <kbd>Ctrl</kbd> + <kbd>J</kbd>.</li>
-</ul>
-<p>In addition to searching for notes, it is also possible to search for
- commands. See the dedicated section below for more information.</p>
-<h3>Interaction</h3>
-<ul>
- <li>By default, when there is no text entered it will display the most recent
- notes.</li>
- <li>Using the keyboard, use the up or down arrow keys to navigate between
- items. Press <kbd>Enter</kbd> to open the desired note.</li>
- <li>If the note doesn't exist, it's possible to create it by typing the desired
- note title and selecting one of two options:
- <ul>
- <li><em>Create note</em> places it in the&nbsp;<a class="reference-link" href="#root/_help_S0Fos78ZfcY7">Note Inbox</a>:
- the note labelled <code>#inbox</code>, today's&nbsp;<a class="reference-link"
- href="#root/_help_l0tKav7yLHGF">Day Notes</a>&nbsp;if there is none, or
- the top level if there is no journal either. While hoisted into a&nbsp;<a
- class="reference-link" href="#root/_help_9sRHySam5fXb">Workspaces</a>,
- the workspace's own inbox is used, then today's day note if the workspace
- has a <code>#workspaceCalendarRoot</code>, otherwise the workspace root
- itself. The option names the destination, so it is always visible before
- the note is created.</li>
- <li><em>Create child note</em> places it under the note that is currently open.</li>
- </ul>
- </li>
- <li>When the title search does not find a note, the bar below the results
- offers two ways to search further. It stays below the list, however far
- the results are scrolled. Both are hidden while the field is empty or lists
- commands.
- <ul>
- <li>The <em>Include note contents</em> switch searches the content of the notes
- as well as their titles, and lists what it finds in place of the current
- results, without leaving the dialog. It stays on while the query changes,
- until it is switched off. Press <kbd>Shift</kbd>+<kbd>Enter</kbd> to switch
- it from the keyboard.</li>
- <li><em>Show in full search</em> opens the query in the full <a class="reference-link"
- href="#root/_help_eIg8jdvaoNNd">Search</a>, in a new tab, where its options
- can refine it. Press <kbd>Ctrl</kbd>+<kbd>Enter</kbd> to run it from the
- keyboard.</li>
- </ul>
- </li>
- <li>To see the keys the results answer to, click the <kbd>?</kbd> button below
- the results, or press <kbd>Alt</kbd>+<kbd>F1</kbd> while the search field
- is focused.</li>
- <li>On a wide enough desktop window, the note highlighted in the results is
- previewed on their right: its path, title, attributes and the start of
- its content. The preview follows the highlight as it moves through the
- results, and is left out for the command palette.</li>
- <li>The options to create a note are listed after the notes. When no note
- matches, the list says so above them. <kbd>Enter</kbd> opens the note that
- matches best, or creates the note when none matches. Otherwise, press <kbd>↑</kbd> from
- the first note to reach the options to create a note.</li>
-</ul>
-<h2>Recent notes</h2>
-<p>Jump to note also has the ability to show the list of recently viewed
- / edited notes and quickly jump to it.</p>
-<p>To access this functionality, click on <code>Jump to</code> button on the
- top. By default, (when nothing is entered into autocomplete), this dialog
- will show the list of recent notes.</p>
-<p>The recent notes are grouped by when they were last visited: <em>Today</em>, <em>Yesterday</em>, <em>Past 7 days</em>, <em>Past 30 days</em> and <em>Older</em>.
- The same list, with the same groups, opens in any note field that is focused
- while empty.</p>
-<h2>Command Palette</h2>
-<figure class="image image-style-align-center">
- <img style="aspect-ratio:982/524;" src="Jump to & command palette_image.png"
- width="982" height="524">
-</figure>
-<p>The command palette is a feature which allows easy execution of various
- commands that can be found throughout the application, such as from menus
- or keyboard shortcuts. This feature integrates directly into the “Jump
- to” dialog.</p>
-<h3>Interaction</h3>
-<p>To trigger the command palette:</p>
-<ul>
- <li>Press <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>J</kbd> to display the command
- palette directly.</li>
- <li>If in the “Jump to” dialog, type <code>&gt;</code> in the search to switch
- to the command palette.</li>
-</ul>
-<p>Interaction:</p>
-<ul>
- <li>Type a few words to filter between commands.</li>
- <li>Use the up and down arrows on the keyboard or the mouse to select a command.</li>
- <li>Press <kbd>Enter</kbd> to execute the command.</li>
-</ul>
-<p>To exit the command palette:</p>
-<ul>
- <li>Remove the <code>&gt;</code> in the search to go back to the note search.</li>
- <li>Press <kbd>Esc</kbd> to dismiss the dialog entirely.</li>
-</ul>
-<h3>Options available</h3>
-<p>Currently the following options are displayed:</p>
-<ul>
- <li>Most of the&nbsp;<a class="reference-link" href="#root/_help_A9Oc6YKKc65v">Keyboard Shortcuts</a>&nbsp;have
- an entry, with the exception of those that are too specific to be run from
- a dialog.</li>
- <li>Some additional options which are not yet available as keyboard shortcuts,
- but can be accessed from various menus such as: exporting a note, showing
- attachments, searching for notes or configuring the&nbsp;<a class="reference-link"
- href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>.</li>
-</ul>
-<h3>Limitations</h3>
-<p>Currently it's not possible to define custom actions that are displayed
- in the command palette. In the future this might change by integrating
- the options in the launch bar, which can be customized if needed.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Jump to & command palette_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Jump to & command palette_image.png
deleted file mode 100644
index 707dbc309d..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Jump to & command palette_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Note Hoisting.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Note Hoisting.html
deleted file mode 100644
index 4be8b4fe0a..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Note Hoisting.html
+++ /dev/null
@@ -1,11 +0,0 @@
-<p>Hoisting is a standard outliner feature which allows you to focus on (or
- "zoom into") a specific note and its subtree by hiding all parent and sibling
- notes. Demo:</p>
-<p>
- <img src="Note Hoisting_note-hoisting.gif">
-</p>
-<p>In addition to showing only this subtree, this also narrows both full
- text search and <a href="#root/_help_MMiBEQljMQh2">“jump to note”</a> to
- just notes present in hoisted subtree.</p>
-<p>See also <a href="#root/_help_9sRHySam5fXb">Workspace</a> which extends
- this feature.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Note Hoisting_note-hoisting.gif b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Note Hoisting_note-hoisting.gif
deleted file mode 100644
index cafab4a165..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Note Hoisting_note-hoisting.gif and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Note Navigation.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Note Navigation.html
deleted file mode 100644
index 7b999c53b3..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Note Navigation.html
+++ /dev/null
@@ -1,16 +0,0 @@
-<p>One of the Trilium's goals is to provide fast and comfortable navigation
- between notes.</p>
-<h2>Backwards and forward</h2>
-<p>You can use alt-left and alt-right to move back and forward in history
- of viewed pages.</p>
-<p>This works identically to browser backwards / forwards, it's actually
- using built-in browser support for this.</p>
-<p>
- <img src="Note Navigation_image.png">
-</p>
-<h2>Jump to note</h2>
-<p>This is useful to quickly find and view arbitrary notes - click on <code>Jump to</code> button
- on the top or press <kbd>Ctrl</kbd> + <kbd>J</kbd> . Then type part of the
- note name and autocomplete will help you pick the desired note.</p>
-<p>See&nbsp;<a class="reference-link" href="#root/_help_F1r9QtzQLZqm">Jump to Note</a>&nbsp;for
- more information.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Quick edit.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Quick edit.html
deleted file mode 100644
index 052c646ae0..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Quick edit.html
+++ /dev/null
@@ -1,94 +0,0 @@
-<figure class="image image-style-align-right image_resized" style="width:53.13%;">
- <img style="aspect-ratio:895/694;" src="Quick edit_image.png" width="895"
- height="694">
-</figure>
-<p><em>Quick edit</em> provides an alternative to the standard tab-based navigation
- and editing.</p>
-<p>Instead of clicking on a note which switches the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;to the newly selected
- note, or navigating between two different&nbsp;<a class="reference-link"
- href="#root/_help_3seOhtN8uLIY">Tabs</a>, the <em>Quick edit</em> feature
- opens as a popup window that can be easily dismissed.</p>
-<p>This feature is also well integrated with&nbsp;<a class="reference-link"
- href="#root/_help_GTwFsgaA0lCt">Collections</a>&nbsp;such as the calendar
- view, which makes it easy to edit entries without having to go back and
- forth between the child note and the calendar.</p>
-<h2>Feature highlights</h2>
-<ul>
- <li>All note types are supported, including&nbsp;<a class="reference-link"
- href="#root/_help_GTwFsgaA0lCt">Collections</a>.</li>
- <li>Note that the&nbsp;<a class="reference-link" href="#root/_help_0ESUbbAxVnoK">Note List</a>&nbsp;will
- not be displayed, except for notes of type&nbsp;<a class="reference-link"
- href="#root/_help_GTwFsgaA0lCt">Collections</a>.</li>
- <li>For&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes,
- depending on user preference, both the floating and classic editors are
- supported. See&nbsp;<a class="reference-link" href="#root/_help_nRhnJkTT8cPs">Formatting toolbar</a>.</li>
- <li>The title and the note and the icon are editable, just like a normal tab.</li>
- <li>The note's actions and its menu are shown in the header of the popup,
- as in the title row of a tab.
- <ul>
- <li>When other notes link to the note, a button with a link icon lists the <a
- class="reference-link" href="#root/_help_wfGXLmm7x27z">Backlinks</a>. Pressing
- one opens that note in the popup.</li>
- <li>The menu items that only work in a tab are not shown: <em>Search in note</em>, <em>Note map</em>, <em>Full width</em> and <em>Convert into attachment</em>.</li>
- <li>A help page opened from the popup, such as through the help button of
- the note type, opens in a second popup on top of it. Closing that popup
- returns to the note being edited.</li>
- </ul>
- </li>
- <li>The&nbsp;<a class="reference-link" href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;are
- also displayed.
- <ul>
- <li>This integrates well with&nbsp;<a class="reference-link" href="#root/_help_GTwFsgaA0lCt">Collections</a>&nbsp;where
- there are predefined attributes such as the <em>Start date</em> and <em>End date</em>,
- allowing for easy editing.</li>
- </ul>
- </li>
-</ul>
-<h2>Accessing the quick edit</h2>
-<ul>
- <li>From the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>:
- <ul>
- <li>Right click on a note and select <em>Quick edit</em>.</li>
- <li>or, press <kbd>Ctrl</kbd>+<kbd>Right click</kbd> on a note.</li>
- </ul>
- </li>
- <li>On&nbsp;<a class="reference-link" href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a>: 
- <ul>
- <li>Right click and select <em>Quick edit</em>.</li>
- <li>or, press <kbd>Ctrl</kbd>+<kbd>Right click</kbd> on the link.</li>
- </ul>
- </li>
- <li>On a&nbsp;<a class="reference-link" href="#root/_help_lgKX7r3aL30x">Note Tooltip</a>,
- press the quick edit icon.</li>
- <li>In&nbsp;<a class="reference-link" href="#root/_help_GTwFsgaA0lCt">Collections</a>:
- <ul>
- <li>For&nbsp;<a class="reference-link" href="#root/_help_xWbu3jpNWapp">Calendar</a>:
- <ul>
- <li>Clicking on an event will open that event for quick editing.</li>
- <li>If the calendar is for the&nbsp;<a class="reference-link" href="#root/_help_l0tKav7yLHGF">Day Notes</a>&nbsp;root,
- clicking on the day number will open the popup for that day note.</li>
- </ul>
- </li>
- <li>For&nbsp;<a class="reference-link" href="#root/_help_81SGnPGMk7Xc">Geo Map</a>:
- <ul>
- <li>Clicking on a marker will open that marker, but only if the map is in
- read-only mode.</li>
- </ul>
- </li>
- </ul>
- </li>
-</ul>
-<h2>Handling of read-only notes</h2>
-<p>The Quick edit feature has a unique behavior for&nbsp;<a class="reference-link"
- href="#root/_help_CoFPLs3dRlXc">Read-Only Notes</a>: </p>
-<ul>
- <li>If the note is read-only due to performance reasons (auto read-only),
- then the note is made editable for quick editing.</li>
- <li>If the note has been manually set to read-only, then the note is read-only
- to prevent accidental change.
- <ul>
- <li>In this case, the note can still be edited by on-screen instructions.</li>
- </ul>
- </li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Quick edit_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Quick edit_image.png
deleted file mode 100644
index 89882f216e..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Quick edit_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Quick search.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Quick search.html
deleted file mode 100644
index a36c1d5217..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Quick search.html
+++ /dev/null
@@ -1,171 +0,0 @@
-<figure class="image image-style-align-center">
- <img style="aspect-ratio:659/256;" src="Quick search_image.png" width="659"
- height="256">
-</figure>
-<p>The <em>Quick search</em> function does a full-text search (that is, it
- searches through the content of notes and not just the title of a note)
- and displays the result in an easy-to-access manner.</p>
-<p>The alternative to the quick search is the&nbsp;<a class="reference-link"
- href="#root/_help_eIg8jdvaoNNd">Search</a>&nbsp;function, which opens in
- a dedicated tab and has support for advanced queries.</p>
-<p>For even faster navigation, it's possible to use&nbsp;<a class="reference-link"
- href="#root/_help_F1r9QtzQLZqm">Jump to &amp; command palette</a>&nbsp;which
- will only search through the note titles instead of the content.</p>
-<h2>Layout</h2>
-<p>Based on the&nbsp;<a class="reference-link" href="#root/_help_x0JgW8UqGXvq">Vertical and horizontal layout</a>,
- the quick search is placed:</p>
-<ul>
- <li>On the vertical layout, it is displayed right above the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>.</li>
- <li>On the horizontal layout, it is displayed in the&nbsp;<a class="reference-link"
- href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>, where it can be positioned
- just like any other icon.</li>
-</ul>
-<h2>Search Features</h2>
-<p>Quick search includes the following features:</p>
-<h3>Content Previews</h3>
-<p>Search results now display a 200-character preview of the note content
- below the note title. This preview shows the context where your search
- terms appear, making it easier to identify the right note without opening
- it.</p>
-<h3>All results in one list</h3>
-<p>Quick search lists up to 200 matching notes in a single scrollable list,
- so the scrollbar shows how many results there are and how far through them
- you are.</p>
-<h3>Continuing in the full search</h3>
-<p>To refine a query with the options of the full <a class="reference-link"
- href="#root/_help_eIg8jdvaoNNd">Search</a>, click <em>Show in full search</em> below
- the results, or press <kbd>Ctrl</kbd>+<kbd>Enter</kbd> in the search field.
- The full search opens in a new tab with the same query. The button stays
- below the list, however far the results are scrolled.</p>
-<h3>Visual Features</h3>
-<ul>
- <li><strong>Highlighting</strong>: Search terms appear in bold with accent
- colors</li>
- <li><strong>Separation</strong>: Results are separated with dividers</li>
- <li><strong>Theme Support</strong>: Highlighting colors adapt to light/dark
- themes</li>
-</ul>
-<h3>Search Behavior</h3>
-<p>Quick search uses progressive search:</p>
-<ol>
- <li>Shows exact matches first</li>
- <li>Includes fuzzy matches when exact results are fewer than 5</li>
- <li>Exact matches appear before fuzzy matches</li>
-</ol>
-<h3>Search Scope</h3>
-<p>Quick search covers only the subtree you are currently working in:</p>
-<ul>
- <li>Without hoisting, it covers the whole note tree.</li>
- <li>Under a <a href="#root/_help_OR8WJ7Iz9K4U">hoisted note</a> or inside a <a
- href="#root/_help_9sRHySam5fXb">workspace</a>, it covers only that subtree.</li>
- <li>Notes that exist only in the hidden tree, such as the built-in help pages
- and the launch bar configuration, are not returned. Hoist into the help
- to search it, or use <a href="#root/_help_F1r9QtzQLZqm">Jump to…</a>, which
- searches titles across the hidden tree.</li>
-</ul>
-<p>To search the whole database while hoisted, use the full&nbsp;<a class="reference-link"
- href="#root/_help_eIg8jdvaoNNd">Search</a>&nbsp;and leave <em>Ancestor</em> field
- empty.</p>
-<h3>Keyboard Navigation</h3>
-<ul>
- <li>Press <kbd>Enter</kbd> in the search field to search, or to refresh the
- results already shown.</li>
- <li>Press <kbd>Down</kbd> in the search field to move to the first result, then <kbd>Up</kbd> and <kbd>Down</kbd> to
- move between results. <kbd>Up</kbd> on the first result returns to the search
- field.</li>
- <li>Press <kbd>Page Down</kbd> and <kbd>Page Up</kbd> to move through the results
- a page at a time.</li>
- <li>Press <kbd>Enter</kbd> on a result to open it.</li>
- <li>Press <kbd>Ctrl</kbd>+<kbd>Enter</kbd> to open the query in the full search.</li>
- <li>Press <kbd>Escape</kbd> to close the results.</li>
-</ul>
-<p>To see these shortcuts on screen, click the <kbd>?</kbd> button below the
- results, or press <kbd>Alt</kbd>+<kbd>F1</kbd> while the search field is
- focused.</p>
-<h2>Using Quick Search</h2>
-<ol>
- <li><strong>Typo tolerance</strong>: Search finds results despite minor typos</li>
- <li><strong>Content previews</strong>: 200-character snippets show match context</li>
- <li><strong>Specific terms</strong>: Specific search terms return more focused
- results</li>
- <li><strong>Match locations</strong>: Bold text indicates where matches occur</li>
-</ol>
-<h2>Quick Search - Exact Match Operator</h2>
-<p>Quick Search shares the same search engine as the full&nbsp;<a class="reference-link"
- href="#root/_help_eIg8jdvaoNNd">Search</a>, so the exact match operator
- (<code>=</code>) behaves identically in both. Start your query with <code>=</code> (no
- space after it) to switch from the default "contains" behavior to exact
- whole-word or phrase matching.</p>
-<p><strong>What</strong> <code>**=**</code> <strong>actually does:</strong> it
- finds notes where the title or content contains your term as a <strong>whole word or phrase</strong>,
- ignoring surrounding punctuation. It does <strong>not</strong> require the
- whole note to equal your term, and it does <strong>not</strong> do substring
- or fuzzy matching.</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Query</th>
- <th>Example note content</th>
- <th>Matches?</th>
- <th>Why</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>sync</code>
- </td>
- <td><code>synchronize the database now</code>
- </td>
- <td>Yes</td>
- <td>default search matches the substring</td>
- </tr>
- <tr>
- <td><code>=sync</code>
- </td>
- <td><code>see (sync) mode</code>
- </td>
- <td>Yes</td>
- <td><code>=</code> matches the whole word <code>sync</code>, punctuation ignored</td>
- </tr>
- <tr>
- <td><code>=sync</code>
- </td>
- <td><code>synchronize the database now</code>
- </td>
- <td>No</td>
- <td><code>=</code> never matches substrings</td>
- </tr>
- <tr>
- <td><code>="project plan"</code>
- </td>
- <td><code>the (project plan) is ready to share</code>
- </td>
- <td>Yes</td>
- <td>quote a multi-word phrase to match it exactly</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<p>The search is case- and diacritic-insensitive. For the complete explanation
- of the three matching modes, fuzzy operators and relevance ranking, see <a
- href="#root/_help_eIg8jdvaoNNd">How search matches your text</a> in the
- full Search documentation.</p>
-<h3>Limitations</h3>
-<ul>
- <li>The <code>=</code> operator must be at the very beginning of the search
- query.</li>
- <li>A space immediately after <code>=</code> is treated as a regular search.</li>
- <li>Multiple <code>=</code> operators (like <code>==example</code>) are treated
- as regular text search.</li>
-</ul>
-<h3>Related Features</h3>
-<ul>
- <li>For attribute, property, boolean and ordering queries, use the full <a
- href="#root/_help_eIg8jdvaoNNd">Search</a> functionality.</li>
- <li>For fuzzy matching (finding results despite typos), use the <code>~=</code> or <code>~*</code> operators
- in the full search.</li>
- <li>For partial matches with wildcards, use operators like <code>*=*</code>, <code>=*</code>,
- or <code>*=</code> in the full search.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Quick search_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Quick search_image.png
deleted file mode 100644
index 997ff79c90..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Quick search_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Search in note.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Search in note.html
deleted file mode 100644
index 506d67199d..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Search in note.html
+++ /dev/null
@@ -1,49 +0,0 @@
-<figure class="image image_resized" style="width:100%;">
- <img style="aspect-ratio:898/93;" src="Search in note_image.png" width="898"
- height="93">
-</figure>
-<p>Local search allows you to search within the currently displayed note.&nbsp;</p>
-<h2>Alternatives</h2>
-<ul>
- <li>Pressing <kbd>Ctrl</kbd>+<kbd>F</kbd> while in a browser while not focused
- in a&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;or
- a&nbsp;<a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;note
- will trigger the browser's native search. This will also find text that
- is part of Trilium's UI.</li>
- <li>Pressing <kbd>Ctrl</kbd>+<kbd>F</kbd> in a&nbsp;<a class="reference-link"
- href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;note will reveal&nbsp;<a
- class="reference-link" href="#root/_help_MI26XDLSAlCD">CKEditor</a>'s search
- functionality.</li>
-</ul>
-<h2>Accessing the search</h2>
-<ul>
- <li>On desktop, press<kbd>Ctrl</kbd> + <kbd>F</kbd>.</li>
- <li>From the&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a>,
- look for the context menu and select <em>Search in note</em>.</li>
-</ul>
-<h2>Interaction</h2>
-<ul>
- <li>Finding:
- <ul>
- <li>Fill in the <em>Find in text…</em> with the text to search for.</li>
- <li>The search will be executed automatically in the background.</li>
- <li>Use up and down arrows of the text box to navigate between results.</li>
- </ul>
- </li>
- <li>Replacing:
- <ul>
- <li>Fill in the <em>Find in text</em>… field with the text to replace.</li>
- <li>Fill in the <em>Replace with…</em> field the text to replace it with.</li>
- <li>Press <em>Replace</em> to replace only the current result.</li>
- <li>Press <em>Replace all</em> to replace all of them at once.</li>
- </ul>
- </li>
- <li>Options:
- <ul>
- <li><em>Case sensitive</em> – the search will distinguish upper case characters
- from lower case (e.g. searching for Hello will not match <code>hello</code>).</li>
- <li><em>Match words</em> - the search will find only exact word matches (e.g.
- searching for <code>Java</code> will not match <code>JavaScript</code>).</li>
- </ul>
- </li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Search in note_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Search in note_image.png
deleted file mode 100644
index 762d1e543a..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Search in note_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Search.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Search.html
deleted file mode 100644
index b1d6cbce63..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Search.html
+++ /dev/null
@@ -1,424 +0,0 @@
-<figure class="image">
- <img style="aspect-ratio:987/725;" src="Search_image.png" width="987"
- height="725">
-</figure>
-<p>Note search enables you to find notes by searching for text in the title,
- content, or <a href="#root/_help_zEY4DaJG4YT5">attributes</a> of the notes.
- You also have the option to save your searches, which will create a special
- search note which is visible on your navigation tree and contains the search
- results as sub-items.</p>
-<h2>Types of search</h2>
-<p>There are multiple types of searches, all using the same search mechanism
- and query language:</p>
-<ul>
- <li><a class="reference-link" href="#root/_help_Ms1nauBra7gq">Quick search</a>&nbsp;which
- can be found in the&nbsp;<a class="reference-link" href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>&nbsp;for
- small one-off searches.
- <ul>
- <li>The results are shown in a popup and it has an infinite scroll.</li>
- </ul>
- </li>
- <li><em>Full search</em> is the more advanced search mechanism.
- <ul>
- <li>The results are displayed in a separate page and it has multiple advanced
- features (search script, fast search, include archived notes, order by,
- limit).</li>
- <li><a class="reference-link" href="#root/_help_ivYnonVFBxbQ">Bulk Actions</a>&nbsp;such
- as adding a label/relation can be applied to the results.</li>
- <li>The results are paginated and they can be displayed in any&nbsp;<a class="reference-link"
- href="#root/_help_GTwFsgaA0lCt">Collections</a>&nbsp;view (e.g. grid, list,
- calendar, table).</li>
- </ul>
- </li>
- <li>Some&nbsp;<a class="reference-link" href="#root/_help_GTwFsgaA0lCt">Collections</a>&nbsp;such
- as board view have a dedicated search bar which applies to that collection.
- <ul>
- <li>In this case, the results are displayed directly in the collection instead
- of a popup and they are limited to the collection but the query language
- remains the same.</li>
- </ul>
- </li>
-</ul>
-<aside class="admonition note">
- <p><a href="#root/_help_F1r9QtzQLZqm">Jump to note</a> is a similar concept
- but it's mainly used to search for notes by title, not by content. Nevertheless,
- it also features a way to search in full text if the results are unsatisfactory.</p>
-</aside>
-<h2>Accessing the search</h2>
-<ul>
- <li>From the&nbsp;<a class="reference-link" href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>,
- look for the dedicated <span class="tn-icon bx bx-search"></span> search
- button.</li>
- <li>To limit the search to a note and its children, select <em>Search in subtree</em> (<span
- class="tn-icon bx bx-search"></span>) from the&nbsp;<a class="reference-link"
- href="#root/_help_YtSN43OrfzaA">Note tree contextual menu</a>&nbsp;or press <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>S</kbd>.</li>
- <li>Go to&nbsp;<a class="reference-link" href="#root/_help_F1r9QtzQLZqm">Jump to &amp; command palette</a>,
- look for something then press <em>Show in full search</em> below the results
- (or <kbd>Ctrl</kbd>+<kbd>Enter</kbd>).</li>
-</ul>
-<h2>Interaction</h2>
-<p>To search for notes, click on the <span class="tn-icon bx bx-search"></span> icon
- in the&nbsp;<a class="reference-link" href="#root/_help_xYmIYSP6wE3F">Launch Bar</a> or
- press the keyboard <a href="#root/_help_A9Oc6YKKc65v">shortcut</a>.</p>
-<ol>
- <li>Set the text to search for in the <em>Search string</em> field.
- <ol>
- <li>Apart from searching for words literally, there is also the possibility
- to search for attributes or properties of notes.</li>
- <li>See the examples below for more information.</li>
- </ol>
- </li>
- <li>To limit the search to a note and its sub-children, set a note in <em>Ancestor</em>.
- <ol>
- <li>This value is also pre-filled if the search is triggered from a <a href="#root/_help_OR8WJ7Iz9K4U">hoisted note</a> or
- a <a href="#root/_help_9sRHySam5fXb">workspace</a>.</li>
- <li>To search the entire database, keep the value empty.</li>
- </ol>
- </li>
- <li>To limit the search to only a few levels of hierarchy (e.g. look in sub-children
- but not in sub-sub-children of a note), set the <em>depth</em> field to one
- of the provided values.</li>
- <li>In addition to that, the search can be configured via the <em>Add search option</em> buttons,
- as described in the follow-up section.</li>
- <li>Press <em>Search</em> (<span class="tn-icon bx bx-search"></span>) to trigger
- the search. The results are displayed below the search configuration pane.</li>
- <li>The <em>Search &amp; Execute actions</em> (<span class="tn-icon bx bxs-zap"></span>)
- button is only relevant if at least one action has been added (as described
- in the section below).</li>
- <li>The <em>Save to note</em> (<span class="tn-icon bx bx-save"></span>) button
- will create a new note with the search configuration. For more information,
- see&nbsp;<a class="reference-link" href="#root/_help_m523cpzocqaD">Saved Search</a>.</li>
-</ol>
-<h2>Features</h2>
-<h3>Autocomplete</h3>
-<p>To help with the syntax, Trilium offers an autocomplete functionality
- which can be triggered by pressing <kbd>Ctrl</kbd>+<kbd>Space</kbd>.</p>
-<p>Some suggestions also open on their own as you type: label and relation
- names after <code>#</code> and <code>~</code>, fields after <code>.</code>,
- operators, values, and notes after <code>@</code>. Keywords such as <code>and</code>, <code>or</code>, <code>not</code>, <code>orderBy</code> and <code>limit</code> appear
- only on <kbd>Ctrl</kbd>+<kbd>Space</kbd>, since a plain word is usually
- a search term.</p>
-<p>No suggestion is selected when a list opens on its own, so <kbd>Enter</kbd> runs
- the search as typed. To insert a suggestion, select it with <kbd>Down</kbd> and
- press <kbd>Enter</kbd>. The list opened with <kbd>Ctrl</kbd>+<kbd>Space</kbd> and
- the notes after <code>@</code> open on the best match instead, so <kbd>Enter</kbd> inserts
- it.</p>
-<p>The autocomplete offers:</p>
-<ul>
- <li>Basic operators such as <code>*=</code> and keywords (<code>limit</code>, <code>not</code>).</li>
- <li>Fields for object-like fields such as <code>note</code> or <code>~relation</code>,
- triggered by typing <code>.</code>.</li>
- <li>Contextual enumerations such as <code>note.type = "</code> or <code>note.mime = "</code>.</li>
- <li><a href="#root/_help_HI6GBBIduIgv">Label</a> names by typing <code>#</code>.
- <ul>
- <li>A small gear on the name's icon indicates a system attribute.</li>
- <li>After typing the label name, the value is also autocompleted with values
- that are present in the database.</li>
- </ul>
- </li>
- <li><a href="#root/_help_Cq5X6iKQop6R">Relation</a> names by typing <code>~</code>.</li>
- <li><a href="#root/_help_m1lbrzyKDaRB">Note ID</a>s can be inserted easily
- by typing <code>@</code> and looking for a note.
- <ul>
- <li>If the note ID is under a valid syntax, it will be shown as a chip of
- the note instead of the raw ID.</li>
- <li>This is especially useful for queries that make use of the note ID such
- as searching by template: <code>~template.noteId = @</code>
- </li>
- </ul>
- </li>
-</ul>
-<h3>Syntax highlighting</h3>
-<p>The search input features syntax highlighting, making recognized fields
- such as <code>note.</code> and operators like <code>NOT</code> stand out.</p>
-<h3>Error highlighting &amp; linting</h3>
-<p>The search is also checked for errors in two phases, which will be displayed
- as a red squiggle:</p>
-<ul>
- <li>Linter errors which identify common error patterns and also provide a
- way to fix them.</li>
- <li>Search errors which are checked by the server, without indicating the
- exact place the error occurred.</li>
-</ul>
-<p>An error the search only runs into while running, such as an operator
- that note content cannot be searched with, is shown in a <em>Search error</em> card
- instead: below the search string, or at the top of the&nbsp;<a class="reference-link"
- href="#root/_help_Ms1nauBra7gq">Quick search</a>&nbsp;results.</p>
-<h3>Multiline</h3>
-<p>Long or complicated searches can be formatted by using newlines, similar
- to SQL queries. Newlines are treated just like spaces.</p>
-<p>To add a new line, press <kbd>Shift</kbd>+<kbd>Enter</kbd>.</p>
-<aside class="admonition note">
- <p>Multiline is available only for the full search, other inputs such as
- the quick search or the collection filter are single line.</p>
-</aside>
-<h2>Search options</h2>
-<p>Click on which search option to apply from the <em>Add search option</em> section.</p>
-<ul>
- <li>For each search option selected, the search configuration will update
- to reveal the entry. Each search option will have its own configuration.</li>
- <li>To remove a search option, simply press the <span class="tn-icon bx bx-x"></span> button
- to the right of it.</li>
-</ul>
-<p>The options available are:</p>
-<ol>
- <li><span class="tn-icon bx bx-code"></span> Search script
- <ol>
- <li>This feature allows writing a&nbsp;<a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;note
- that will handle the search on its own.</li>
- </ol>
- </li>
- <li><span class="tn-icon bx bx-run"></span> Fast search
- <ol>
- <li>The search will not look into the content of the notes, but it will still
- look into note titles and attributes, relations (based on the search query).</li>
- <li>This method can speed up the search considerably for large <a href="#root/_help_wX4HbRucYSDD">databases</a>.</li>
- </ol>
- </li>
- <li><span class="tn-icon bx bx-archive"></span> Include archived
- <ol>
- <li><a class="reference-link" href="#root/_help_MKmLg5x6xkor">Archived Notes</a>&nbsp;will
- also be included in the results, whereas otherwise they would be ignored.</li>
- </ol>
- </li>
- <li><span class="tn-icon bx bx-arrow-from-top"></span> Order by
- <ol>
- <li>Allows changing the criteria for ordering the results, for example to
- order by creation date or alphabetically instead of by relevancy (default).</li>
- <li>It's also possible to change the order (ascending or descending) of the
- results.</li>
- </ol>
- </li>
- <li><span class="tn-icon bx bx-stop"></span> Limit
- <ol>
- <li>Limits the results to a given maximum.</li>
- <li>This can help if the number of results would otherwise be high, at the
- cost of not being able to view all the results.</li>
- </ol>
- </li>
- <li><span class="tn-icon bx bx-bug"></span> Debug
- <ol>
- <li>This will print additional information in the server log (see&nbsp;<a
- class="reference-link" href="#root/_help_qzNzp9LYQyPT">Error logs</a>),
- regarding how the search expression was parsed.</li>
- <li>This function is especially useful after understanding the search functionality
- in detail, in order to determine why a complex search query is not working
- as expected.</li>
- </ol>
- </li>
- <li><span class="tn-icon bx bxs-zap"></span> Action
- <ol>
- <li>Apart from just searching, it is also possible to apply actions such as
- to add a label or a relation to the notes that have been matched by the
- search.</li>
- <li>Unlike other search configurations, here it's possible to apply the same
- action multiple times (i.e. in order to be able to apply multiple labels
- to notes).</li>
- <li>The actions given are the same as the ones in&nbsp;<a class="reference-link"
- href="#root/_help_ivYnonVFBxbQ">Bulk Actions</a>, which is an alternative
- for operating directly with notes within the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>.</li>
- <li>After defining the actions, first press <em>Search</em> to check the matched
- notes and then press <em>Search &amp; Execute actions</em> to trigger the
- actions.</li>
- </ol>
- </li>
-</ol>
-<h2>Viewing search results</h2>
-<p>Results appear below the search pane as a list of <strong>snippet cards</strong>.
- Each card shows the note title and a short excerpt of the text that matched.</p>
-<p>The search will also highlight the words from the title or content that
- matched:</p>
-<ul>
- <li>With a solid underlined green for a direct match;</li>
- <li>With a dotted underline orange for a partial match (matched by the fuzzy
- search).</li>
-</ul>
-<p>In addition:&nbsp;</p>
-<ul>
- <li>The <strong>total number of results</strong> is always shown, so you can
- immediately tell how broad a query is.</li>
- <li>A <strong>page-size selector</strong> lets you choose how many results to
- display per page. Your choice is remembered and synced across your devices
- (stored in the <code>searchResultsPageSize</code> option), so you do not
- have to reset it on every device.</li>
- <li><strong>Clicking a result</strong> opens the note and jumps straight to
- the first match. The in-note find bar opens pre-filled with the first word
- of your search, so you can step through its matches with the find controls.
- To have the find bar look for a whole phrase instead, put the phrase in
- quotes in the search, e.g. <code>"The Lord of the Rings"</code>. In read-only
- notes, the other words of the search are highlighted as well.</li>
- <li><em>Open all results in new tabs</em> (<span class="tn-icon bx bx-window-open"></span>,
- the button above the results) opens every result in a tab of its own, up
- to 50. Each tab opens on its first match with the find bar pre-filled,
- as when clicking a result.</li>
- <li>If a match is inside a <strong>collapsed section</strong> (for example a
- folded heading), that section is expanded automatically so the match is
- visible.</li>
-</ul>
-<h2>Simple Note Search Examples</h2>
-<ul>
- <li><code>rings tolkien</code>: Full-text search to find notes containing
- both "rings" and "tolkien".</li>
- <li><code>"The Lord of the Rings" Tolkien</code>: Full-text search where "The
- Lord of the Rings" must match exactly.</li>
- <li><code>note.content *=* rings OR note.content *=* tolkien</code>: Find
- notes containing "rings" or "tolkien" in their content.</li>
- <li><code>towers #book</code>: Combine full-text and attribute search to find
- notes containing "towers" and having the "book" label. Writing <code>towers AND #book</code> does
- the same; to search for the word "and" itself, put it in quotes.</li>
- <li><code>c#</code> or <code>towers#book</code>: A <code>#</code> or <code>~</code> inside
- a word is part of the text, so these find notes containing "c#" or "towers#book".
- To start a label or relation, put a space before it.</li>
- <li><code>towers #book or #author</code>: Search for notes containing "towers"
- and having either the "book" or "author" label.</li>
- <li><code>towers #!book</code>: Search for notes containing "towers" and not
- having the "book" label.</li>
- <li><code>#book #publicationYear = 1954</code>: Find notes with the "book"
- label and "publicationYear" set to 1954.</li>
- <li><code>#genre *=* fan</code>: Find notes with the "genre" label containing
- the substring "fan". Additional operators include <code>*=*</code> for "contains", <code>=*</code> for
- "starts with", <code>*=</code> for "ends with", and <code>!=</code> for "is
- not equal to".</li>
- <li><code>#book #publicationYear &gt;= 1950 #publicationYear &lt; 1960</code>:
- Use numeric operators to find all books published in the 1950s.</li>
- <li><code>#dateNote &gt;= TODAY-30</code>: Find notes with the "dateNote"
- label within the last 30 days. Supported date values include NOW +- seconds,
- TODAY +- days, MONTH +- months, YEAR +- years.</li>
- <li><code>~author.title *=* Tolkien</code>: Find notes related to an author
- whose title contains "Tolkien".</li>
- <li><code>#publicationYear %= '19[0-9]{2}'</code>: Use the '%=' operator to
- match a regular expression (regex). This feature has been available since
- Trilium 0.52.</li>
- <li><code>note.content %= '\\d{2}:\\d{2} (PM|AM)'</code>: Find notes that
- mention a time. Backslashes in a regex must be escaped.</li>
-</ul>
-<h2>Advanced Use Cases</h2>
-<ul>
- <li><code>~author.relations.son.title = 'Christopher Tolkien'</code>: Search
- for notes with an "author" relation to a note that has a "son" relation
- to "Christopher Tolkien". This can be modeled with the following note structure:
- <ul>
- <li>Books
- <ul>
- <li>Lord of the Rings
- <ul>
- <li>label: “book”</li>
- <li>relation: “author” points to “J. R. R. Tolkien” note</li>
- </ul>
- </li>
- </ul>
- </li>
- <li>People
- <ul>
- <li>J. R. R. Tolkien
- <ul>
- <li>relation: “son” points to "Christopher Tolkien" note</li>
- <li>Christopher Tolkien</li>
- </ul>
- </li>
- </ul>
- </li>
- </ul>
- </li>
- <li><code>~author.title *= Tolkien OR (#publicationDate &gt;= 1954 AND #publicationDate &lt;= 1960)</code>:
- Use boolean expressions and parentheses to group expressions.</li>
- <li><code>towers (#genre = fantasy OR #genre = scifi)</code>: A group can
- open the expression part directly, without a <code>#</code> or <code>~</code> before
- the parenthesis. Here it finds notes containing "towers" whose genre is
- fantasy or scifi.</li>
- <li><code>note.parents.title = 'Books'</code>: Find notes with a parent named
- "Books".</li>
- <li><code>note.parents.parents.title = 'Books'</code>: Find notes with a grandparent
- named "Books".</li>
- <li><code>note.ancestors.title = 'Books'</code>: Find notes with an ancestor
- named "Books".</li>
- <li><code>note.children.title = 'sub-note'</code>: Find notes with a child
- named "sub-note".</li>
- <li><code>note.links.title = 'Tolkien'</code>: Find notes linking to a note
- named "Tolkien".</li>
- <li><code>note.backlinks.title = 'Reading list'</code>: Find the notes that
- "Reading list" links to.</li>
- <li>A link is a relation you created, such as <code>~author</code>, or one
- that content creates: an internal link (<code>~internalLink</code>), an
- image (<code>~imageLink</code>), an included note (<code>~includeNoteLink</code>)
- or a relation map connection (<code>~relationMapLink</code>). Relations
- that configure a note, such as <code>~template</code> or a saved search's <code>~ancestor</code>,
- are not links.</li>
-</ul>
-<p>See also&nbsp;<a class="reference-link" href="#root/_help_Oxyb6jOjjVNL">Under the hood</a>&nbsp;for
- more syntax references.</p>
-<h3>Search with Note Properties</h3>
-<p>Notes have properties that can be used in searches, such as <code>noteId</code>, <code>dateModified</code>, <code>dateCreated</code>, <code>isProtected</code>, <code>type</code>, <code>title</code>, <code>text</code>, <code>content</code>, <code>rawContent</code>, <code>ownedLabelCount</code>, <code>labelCount</code>, <code>ownedRelationCount</code>, <code>relationCount</code>, <code>ownedRelationCountIncludingLinks</code>, <code>relationCountIncludingLinks</code>, <code>ownedAttributeCount</code>, <code>attributeCount</code>, <code>targetRelationCount</code>, <code>targetRelationCountIncludingLinks</code>, <code>parentCount</code>, <code>childrenCount</code>, <code>isArchived</code>, <code>contentSize</code>, <code>noteSize</code>,
- and <code>revisionCount</code>.</p>
-<p>These properties can be accessed via the <code>note.</code> prefix, e.g., <code>note.type = code AND note.mime = 'application/json'</code>.</p>
-<h3>Order by and Limit</h3><pre><code class="language-text-x-trilium-auto">#author=Tolkien orderBy #publicationDate desc, note.title limit 10</code></pre>
-<p>This example will:</p>
-<ol>
- <li>Find notes with the author label "Tolkien".</li>
- <li>Order the results by <code>publicationDate</code> in descending order.</li>
- <li>Use <code>note.title</code> as a secondary ordering if publication dates
- are equal.</li>
- <li>Limit the results to the first 10 notes.</li>
-</ol>
-<h3>Negation</h3>
-<p>Some queries can only be expressed with negation:</p><pre><code class="language-text-x-trilium-auto">#book AND not(note.ancestors.title = 'Tolkien')</code></pre>
-<p>This query finds all book notes not in the "Tolkien" subtree.</p>
-<h2>Under the Hood</h2>
-<p>See the <a href="#root/_help_Oxyb6jOjjVNL">dedicated page</a> to understand
- how progressive search works in Trilium, as well as some advanced use cases.</p>
-<h2>Auto-Trigger Search from URL</h2>
-<p>You can open Trilium and automatically trigger a search by including the
- search <a href="https://meyerweb.com/eric/tools/dencoder/">url encoded</a> string
- in the URL:</p>
-<p><code>http://localhost:8080/#?searchString=abc</code>
-</p>
-<h2>Search Configuration</h2>
-<h3>Parameters</h3>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Parameter</th>
- <th>Value</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>MIN_FUZZY_TOKEN_LENGTH</code>
- </td>
- <td>3</td>
- <td>Minimum characters the <code>~=</code> and <code>~*</code> operators accept</td>
- </tr>
- <tr>
- <td><code>MAX_EDIT_DISTANCE</code>
- </td>
- <td>2</td>
- <td>Ceiling on character changes, reached only by 7+ character terms; shorter
- terms allow fewer. See the <em>Fuzzy tolerance</em> section above</td>
- </tr>
- <tr>
- <td><code>RESULT_SUFFICIENCY_THRESHOLD</code>
- </td>
- <td>5</td>
- <td>Minimum exact results before fuzzy fallback</td>
- </tr>
- <tr>
- <td><code>MAX_CONTENT_SIZE</code>
- </td>
- <td>10MB</td>
- <td>Maximum note content size for search processing</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<h3>Limits</h3>
-<ul>
- <li>Searched note content is limited to 10MB per note to prevent performance
- issues</li>
- <li>Notes exceeding this limit will still be included in title and attribute
- searches</li>
- <li>Terms of 3 characters or fewer are matched exactly; typo tolerance starts
- at 4 characters</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Search/How search matches your text.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Search/How search matches your text.html
deleted file mode 100644
index ce80673e5d..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Search/How search matches your text.html
+++ /dev/null
@@ -1,556 +0,0 @@
-<p>The single most common source of confusion is that the <code>=</code> sign
- means two <em>different</em> things depending on where it appears. Read this
- section once and the rest of search becomes predictable.</p>
-<p>There are three matching modes:</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Mode</th>
- <th>How you trigger it</th>
- <th>What it matches</th>
- <th>Substring?</th>
- <th>Fuzzy (typos)?</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><strong>Default</strong>
- </td>
- <td>type words with no prefix</td>
- <td>whole words <em>and</em> substrings, anywhere in title, content or attributes,
- relevance-ranked</td>
- <td>Yes</td>
- <td>Yes</td>
- </tr>
- <tr>
- <td><strong>Exact full-text</strong>
- </td>
- <td>a leading <code>=</code> (e.g. <code>=sync</code>)</td>
- <td>the exact whole word or phrase, ignoring surrounding punctuation</td>
- <td>No</td>
- <td>No</td>
- </tr>
- <tr>
- <td><strong>Attribute / property equality</strong>
- </td>
- <td><code>=</code> inside a <code>#label=value</code> or <code>note.property=value</code> clause</td>
- <td>the <em>entire</em> attribute or property value, exactly</td>
- <td>No</td>
- <td>No</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<h3>Default matching (no prefix)</h3>
-<p><strong>Rule:</strong> typing words with no prefix finds notes that contain
- those words anywhere in the title, content or attributes, as whole words
- or as substrings. The closest matches are ranked first.</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Query</th>
- <th>Example note content</th>
- <th>Matches?</th>
- <th>Why</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>sync</code>
- </td>
- <td><code>please sync the folders</code>
- </td>
- <td>Yes (ranked higher)</td>
- <td>contains the exact word <code>sync</code>
- </td>
- </tr>
- <tr>
- <td><code>sync</code>
- </td>
- <td><code>synchronize the database now</code>
- </td>
- <td>Yes (ranked lower)</td>
- <td><code>sync</code> is a substring of <code>synchronize</code>
- </td>
- </tr>
- </tbody>
- </table>
-</figure>
-<h3>Exact match with the <code>=</code> prefix</h3>
-<p><strong>Rule:</strong> a leading <code>=</code> switches the full-text search
- to exact matching. It finds the whole word or phrase only, ignoring surrounding
- punctuation, with <strong>no</strong> substring and <strong>no</strong> fuzzy
- matching. Use it when a normal search returns too many near-matches.</p>
-<figure
-class="table">
- <table>
- <thead>
- <tr>
- <th>Query</th>
- <th>Example note content</th>
- <th>Matches?</th>
- <th>Why</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>=sync</code>
- </td>
- <td><code>see (sync) mode</code>
- </td>
- <td>Yes</td>
- <td><code>(sync)</code> is the whole word <code>sync</code>; punctuation is
- ignored</td>
- </tr>
- <tr>
- <td><code>=sync</code>
- </td>
- <td><code>in sync, then continue</code>
- </td>
- <td>Yes</td>
- <td><code>sync,</code> is the whole word <code>sync</code>
- </td>
- </tr>
- <tr>
- <td><code>=sync</code>
- </td>
- <td><code>he said "sync" out loud</code>
- </td>
- <td>Yes</td>
- <td><code>"sync"</code> is the whole word <code>sync</code>
- </td>
- </tr>
- <tr>
- <td><code>=sync</code>
- </td>
- <td><code>synchronize the database now</code>
- </td>
- <td>No</td>
- <td><code>=</code> never matches substrings</td>
- </tr>
- <tr>
- <td><code>=sync</code>
- </td>
- <td><code>please send the file</code>
- </td>
- <td>No</td>
- <td><code>=</code> never matches typos / fuzzy</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<p>To match an exact <strong>phrase</strong>, quote it after the <code>=</code> (single,
- double or backtick quotes all work). The phrase must appear as consecutive
- words, but punctuation between or around them is ignored:</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Query</th>
- <th>Example note (title or content)</th>
- <th>Matches?</th>
- <th>Why</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>="project plan"</code>
- </td>
- <td>title <code>Project Plan</code>
- </td>
- <td>Yes</td>
- <td>the title is exactly the phrase</td>
- </tr>
- <tr>
- <td><code>="project plan"</code>
- </td>
- <td><code>the (project plan) is ready to share</code>
- </td>
- <td>Yes</td>
- <td>the consecutive phrase appears; punctuation is ignored</td>
- </tr>
- <tr>
- <td><code>="project plan"</code>
- </td>
- <td><code>the plan for this project is late</code>
- </td>
- <td>No</td>
- <td>the words are present but not consecutive</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<h3>Attribute and property equality (<code>=</code>, <code>!=</code>)</h3>
-<p><strong>Rule:</strong> when <code>=</code> compares an attribute or property,
- as in <code>#label=value</code> or <code>note.title=value</code>, it is <strong>strict full-value equality</strong>:
- the <em>whole</em> value must equal what you typed, ignoring case and diacritics.
- This is <strong>not</strong> word matching. <code>!=</code> inverts it.</p>
-<p>The examples below assume four notes: <em>Austria</em> (<code>#capital=Vienna</code>), <em>Somewhere</em> (<code>#capital=Vienna Austria</code>), <em>Czech Republic</em> (<code>#capital=Prague</code>)
- and <em>Switzerland</em> (<code>#capital=Zürich</code>).</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Query</th>
- <th>Example label value</th>
- <th>Matches?</th>
- <th>Why</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>#capital=Vienna</code>
- </td>
- <td><code>Vienna</code>
- </td>
- <td>Yes</td>
- <td>the whole value equals <code>Vienna</code>
- </td>
- </tr>
- <tr>
- <td><code>#capital=Vienna</code>
- </td>
- <td><code>Vienna Austria</code>
- </td>
- <td>No</td>
- <td>the whole value is <code>Vienna Austria</code>, not <code>Vienna</code>
- </td>
- </tr>
- <tr>
- <td><code>#capital="Vienna Austria"</code>
- </td>
- <td><code>Vienna Austria</code>
- </td>
- <td>Yes</td>
- <td>quote a multi-word value to match it in full</td>
- </tr>
- <tr>
- <td><code>#capital=Zurich</code>
- </td>
- <td><code>Zürich</code>
- </td>
- <td>Yes</td>
- <td>equality ignores diacritics</td>
- </tr>
- <tr>
- <td><code>#capital!=Vienna</code>
- </td>
- <td><code>Prague</code>
- </td>
- <td>Yes</td>
- <td><code>!=</code> matches every value that is not <code>Vienna</code>
- </td>
- </tr>
- <tr>
- <td><code>#capital!=Vienna</code>
- </td>
- <td><code>Vienna</code>
- </td>
- <td>No</td>
- <td><code>!=</code> excludes the exact value</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<blockquote>
- <p><strong>Quick search relaxes this.</strong> The <a href="#root/_help_Ms1nauBra7gq">Quick search</a> bar
- and autocomplete treat an attribute <code>=</code> as "contains", so <code>#capital=Vienna</code> typed
- there also matches <code>Vienna Austria</code>. The strict full-value equality
- described here applies only in the full Search.</p>
-</blockquote>
-<h3>Fuzzy operators (<code>~=</code> and <code>~*</code>)</h3>
-<p><strong>Rule:</strong> the fuzzy operators tolerate typos. <code>~=</code> (fuzzy-equals)
- matches a value that is a close whole-word variant of your term. <code>~*</code> (fuzzy-contains)
- matches when your term appears anywhere inside the value, either as a fragment
- or as a near-miss. Both work on note properties such as <code>note.title</code> and <code>note.content</code>,
- and on labels (<code>#label</code>). Fuzzy operators accept terms of at
- least 3 characters, though how many typos each term tolerates depends on
- its length — see <em>Fuzzy tolerance</em> below.</p>
-<p>The examples assume a note titled <code>Books</code> carrying the label <code>#author=Tolkien</code>,
- and a note whose content is <code>learn programming today</code>.</p>
-<figure
-class="table">
- <table>
- <thead>
- <tr>
- <th>Query</th>
- <th>Example value</th>
- <th>Matches?</th>
- <th>Why</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>note.title ~= boks</code>
- </td>
- <td>title <code>Books</code>
- </td>
- <td>Yes</td>
- <td>one edit away from <code>books</code>
- </td>
- </tr>
- <tr>
- <td><code>#author ~= tolkein</code>
- </td>
- <td>author <code>Tolkien</code>
- </td>
- <td>Yes</td>
- <td><code>tolkein</code> is a typo of <code>tolkien</code>
- </td>
- </tr>
- <tr>
- <td><code>note.content ~* progr</code>
- </td>
- <td><code>learn programming today</code>
- </td>
- <td>Yes</td>
- <td><code>progr</code> is a fragment of <code>programming</code>
- </td>
- </tr>
- <tr>
- <td><code>note.content ~* programing</code>
- </td>
- <td><code>learn programming today</code>
- </td>
- <td>Yes</td>
- <td><code>programing</code> is one edit from <code>programming</code>
- </td>
- </tr>
- </tbody>
- </table>
-</figure>
-<h3>Fuzzy tolerance</h3>
-<p><strong>Rule:</strong> how many typos are tolerated depends on the <strong>length</strong> of
- your search term. Short terms must match exactly, because a single edit
- is enough to turn one short word into an unrelated one; longer terms have
- greater tolerance.</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Term length</th>
- <th>Edits allowed</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>1–3 characters</td>
- <td>0 (exact only)</td>
- </tr>
- <tr>
- <td>4–6 characters</td>
- <td>1</td>
- </tr>
- <tr>
- <td>7+ characters</td>
- <td>2</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Query</th>
- <th>Term length</th>
- <th>Example note content</th>
- <th>Matches?</th>
- <th>Why</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>cat</code>
- </td>
- <td>3</td>
- <td><code>a bright red car</code>
- </td>
- <td>No</td>
- <td>No edits are allowed below 4 characters, so <code>cat</code> does not reach <code>car</code>
- </td>
- </tr>
- <tr>
- <td><code>carr</code>
- </td>
- <td>4</td>
- <td><code>a blue debit card</code>
- </td>
- <td>Yes</td>
- <td>1 edit is within budget for 4–6 character terms</td>
- </tr>
- <tr>
- <td><code>ceck</code>
- </td>
- <td>4</td>
- <td><code>the latest tech trends</code>
- </td>
- <td>No</td>
- <td><code>ceck</code>→<code>tech</code> needs 2 edits; only 1 is allowed at
- this length</td>
- </tr>
- <tr>
- <td><code>combinef</code>
- </td>
- <td>8</td>
- <td><code>the values were combined together</code>
- </td>
- <td>Yes</td>
- <td><code>combinef</code>→<code>combined</code> is 1 edit; up to 2 are allowed
- at 7+ characters</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<h3>Relevance ranking</h3>
-<p><strong>Rule:</strong> results are ordered by <em>how well</em> they match,
- not merely whether they match. Exact whole-word and phrase matches rank
- above substring and fuzzy matches, and a note where your words appear as
- a consecutive phrase outranks one where they are scattered.</p>
-<figure
-class="table">
- <table>
- <thead>
- <tr>
- <th>Query</th>
- <th>Ranked higher</th>
- <th>Ranked lower</th>
- <th>Why</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>sync</code>
- </td>
- <td><code>please sync the folders</code>
- </td>
- <td><code>synchronize the database now</code>
- </td>
- <td>exact word beats substring</td>
- </tr>
- <tr>
- <td><code>you and me</code>
- </td>
- <td><code>I like you and me as a phrase</code>
- </td>
- <td><code>the menu is here and you know it</code>
- </td>
- <td>consecutive phrase beats scattered words</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<h3>What is searchable</h3>
-<p>A search looks at more than the visible body text. All of the following
- are indexed and searchable:</p>
-<ul>
- <li>note titles,</li>
- <li>note body content,</li>
- <li>labels and relations (<a href="#root/_help_zEY4DaJG4YT5">attributes</a>),</li>
- <li>link URLs and the titles/descriptions of link previews,</li>
- <li>the titles of notes that a note reference-links to.</li>
-</ul>
-<p>The last point is the least obvious: if a note's only content is a reference
- link to another note, searching for that other note's <strong>title</strong> still
- finds the linking note.</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Query</th>
- <th>Setup</th>
- <th>Matches?</th>
- <th>Why</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>special topic</code>
- </td>
- <td>a note whose only content is a reference link to a note titled <code>Special Topic</code>
- </td>
- <td>Yes, and the linked target ranks first</td>
- <td>the target's title is indexed into the linking note's searchable text</td>
- </tr>
- <tr>
- <td><code>special</code>
- </td>
- <td>the same note (only a reference link to <code>Special Topic</code>)</td>
- <td>Yes, one word from the target's title is enough</td>
- <td>the indexed title is normalized just like body text, so even one lowercased
- word matches</td>
- </tr>
- <tr>
- <td><code>zurich</code>
- </td>
- <td>a note whose only content is a reference link to a note titled <code>Zürich</code>
- </td>
- <td>Yes</td>
- <td>the indexed title has its accents normalized, so the plain form matches
- the accented title</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<h3>Diacritics</h3>
-<p><strong>Rule:</strong> accents are normalized on both sides, so an accented
- word and its plain form match each other.</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Query</th>
- <th>Example note content</th>
- <th>Matches?</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>ktory</code>
- </td>
- <td><code>slovo ktorý znamena nieco</code>
- </td>
- <td>Yes</td>
- </tr>
- <tr>
- <td><code>ktorý</code>
- </td>
- <td><code>the word ktory appears here</code>
- </td>
- <td>Yes</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<h3>Regular expressions (<code>%=</code>)</h3>
-<p><strong>Rule:</strong> the <code>%=</code> operator matches a property or
- label value against a regular expression.</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Query</th>
- <th>Example note content</th>
- <th>Matches?</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>note.content %= 'colou?r'</code>
- </td>
- <td><code>my favorite color of all</code>
- </td>
- <td>Yes</td>
- </tr>
- <tr>
- <td><code>note.content %= 'colou?r'</code>
- </td>
- <td><code>my favourite colour of all</code>
- </td>
- <td>Yes</td>
- </tr>
- </tbody>
- </table>
-</figure>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Search/Under the hood.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Search/Under the hood.html
deleted file mode 100644
index 978dcfe84e..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Search/Under the hood.html
+++ /dev/null
@@ -1,63 +0,0 @@
-<h2>Progressive Search Strategy</h2>
-<p>Trilium uses a progressive search strategy that performs exact matching
- first, then adds fuzzy matching when needed.</p>
-<p>The search has three phases:</p>
-<ol>
- <li><strong>Phase 1 - Exact Matching</strong>: When you search, Trilium first
- looks for exact matches of your search terms. This handles the vast majority
- of searches (90%+) and returns results almost instantly.</li>
- <li><strong>Phase 2 - Fuzzy Fallback</strong>: If Phase 1 doesn't find enough
- high-quality results (fewer than 5 results with good relevance scores),
- Trilium automatically adds fuzzy matching to find results with typos or
- spelling variations.</li>
- <li><strong>Result Ordering</strong>: Exact matches always appear before fuzzy
- matches, regardless of individual scores. This ensures that when you search
- for "project", notes containing the exact word "project" will appear before
- notes containing similar words like "projects" or "projection".</li>
-</ol>
-<h3>Progressive Search Behavior</h3>
-<ul>
- <li><strong>Speed</strong>: Most searches complete using only exact matching</li>
- <li><strong>Ordering</strong>: Exact matches appear before fuzzy matches</li>
- <li><strong>Fallback</strong>: Fuzzy matching activates when exact matches
- return fewer than 5 results</li>
- <li><strong>Identification</strong>: Results indicate whether they are exact
- or fuzzy matches</li>
-</ul>
-<h2>Search Performance</h2>
-<p>Search system specifications:</p>
-<ul>
- <li>Content size limit: 10MB per note (previously 50KB)</li>
- <li>Edit distance calculations for fuzzy matching</li>
- <li>Infinite scrolling in Quick Search</li>
-</ul>
-<h2>Label and Relation Shortcuts</h2>
-<p>The "full" syntax for searching by labels is:</p><pre><code class="language-text-x-trilium-auto">note.labels.publicationYear = 1954</code></pre>
-<p>For relations:</p><pre><code class="language-text-x-trilium-auto">note.relations.author.title *=* Tolkien</code></pre>
-<p>However, common label and relation searches have shortcut syntax:</p><pre><code class="language-text-x-trilium-auto">#publicationYear = 1954
-~author.title *=* Tolkien</code></pre>
-<h2>Separating Full-Text and Attribute Parts</h2>
-<p>Search syntax allows combining full-text search with attribute-based search.
- For example, <code>tolkien #book</code> contains:</p>
-<ol>
- <li>Full-text tokens - <code>tolkien</code>
- </li>
- <li>Attribute expressions - <code>#book</code>
- </li>
-</ol>
-<p>Trilium detects the separation between full text search and attribute/property
- search by looking for certain special characters or words that denote attributes
- and properties (e.g., #, ~, note.). If you need to include these in full-text
- search, escape them with a backslash so they are processed as regular text:</p><pre><code class="language-text-x-trilium-auto">"note.txt"
-\#hash
-#myLabel = 'Say "Hello World"'</code></pre>
-<h2>Escaping Special Characters</h2>
-<p>Special characters can be enclosed in quotes or escaped with a backslash
- to be used in full-text search:</p><pre><code class="language-text-x-trilium-auto">"note.txt"
-\#hash
-#myLabel = 'Say "Hello World"'</code></pre>
-<p>Three types of quotes are supported: single, double, and backtick.</p>
-<h2>Type Coercion</h2>
-<p>Label values are technically strings but can be coerced for numeric comparisons:</p><pre><code class="language-text-x-trilium-auto">note.dateCreated =* '2019-05'</code></pre>
-<p>This finds notes created in May 2019. Numeric operators like <code>#publicationYear &gt;= 1960</code> convert
- string values to numbers for comparison.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Search_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Search_image.png
deleted file mode 100644
index 55f550c543..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Search_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Similar Notes.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Similar Notes.html
deleted file mode 100644
index dc57ec455b..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Similar Notes.html
+++ /dev/null
@@ -1,22 +0,0 @@
-<figure class="image image-style-align-right image_resized" style="width:50.46%;">
- <img style="aspect-ratio:538/290;" src="Similar Notes_image.png" width="538"
- height="290">
-</figure>
-<p>The Similar Notes feature tries to identify notes that relate to the current
- note by looking at the content of the notes, their relationships, as well
- as the date they were created.</p>
-<p>To access the list of similar notes:</p>
-<ul>
- <li>Go to the&nbsp;<a class="reference-link" href="#root/_help_KRlZFoIH0j6p">Connections tab</a>&nbsp;in
- the&nbsp;<a class="reference-link" href="#root/_help_RnaPdbciOfeq">Right Sidebar</a>&nbsp;and
- look for the corresponding section.</li>
- <li>Alternatively, press the&nbsp;<span class="tn-icon bx bx-info-circle"></span> in
- the&nbsp;<a class="reference-link" href="#root/_help_AlJ73vBCjWDw">Status bar</a>&nbsp;and
- select <em>Show similar notes</em> which will open a pane at the bottom.</li>
-</ul>
-<h2>Interaction</h2>
-<ul>
- <li>Hover over a note to see a short preview of the note.</li>
- <li>Click over a note to open it in the current view.</li>
- <li><kbd>Ctrl</kbd> + click a note to open it in a separate tab.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Similar Notes_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Similar Notes_image.png
deleted file mode 100644
index ddf6536e66..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Similar Notes_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Tree Concepts.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Tree Concepts.html
deleted file mode 100644
index 5d34d76c5a..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Tree Concepts.html
+++ /dev/null
@@ -1,25 +0,0 @@
-<p>This page explains the basic concepts related to the tree structure of
- notes in TriliumNext.</p>
-<h2>Note</h2>
-<p>A note is the central entity in TriliumNext. For more details, see&nbsp;<a
- class="reference-link" href="#root/_help_BFs8mudNFgCS">Notes</a>.</p>
-<h2>Branch</h2>
-<p>A branch describes the placement of a note within the note tree. Essentially,
- it is a tuple of <code>parentNoteId</code> and <code>noteId</code>, indicating
- that the given note is placed as a child under the specified parent note.</p>
-<p>Each note can have multiple branches, meaning any note can be placed in
- multiple locations within the tree. This concept is referred to as&nbsp;<a
- class="reference-link" href="#root/_help_IakOLONlIfGI">Cloning Notes</a>.</p>
-<h2>Prefix</h2>
-<p>A prefix is a branch-specific title modifier for a note. If you place
- your note in two different locations within the tree and want to alter
- the title slightly in one of those placements, you can use a prefix.</p>
-<p>To edit a prefix, right-click on the note in the tree pane and select <em>Edit branch prefix</em>.</p>
-<p>The prefix is not part of the note itself and is not encrypted when the
- note is protected. This can be useful if you want part of the title to
- remain visible in the tree for easier navigation, even when the note is
- protected.</p>
-<h2>Subtree</h2>
-<p>A subtree consists of a particular note (the subtree root) and all its
- children and descendants. Some operations, such as exporting, work on entire
- subtrees.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Workspaces.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Workspaces.html
deleted file mode 100644
index 0bbc753320..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Workspaces.html
+++ /dev/null
@@ -1,81 +0,0 @@
-<p>Workspace is a concept built up on top of <a href="#root/_help_OR8WJ7Iz9K4U">note hoisting</a>.
- It is based on the idea that a user has several distinct spheres of interest.
- An example might be "Personal" and "Work", these two spheres are quite
- distinct and don't interact together. When I focus on Work, I don't really
- care about personal notes.</p>
-<p>So far workspace consists of these features:</p>
-<ul>
- <li>
- <p><a href="#root/_help_OR8WJ7Iz9K4U">note hoisting</a> - you can "zoom" into
- a workspace subtree to focus only on the relevant notes</p>
- </li>
- <li>
- <p>easy entering of workspace:&nbsp;</p>
- <p>
- <img src="1_Workspaces_image.png">
- </p>
- </li>
- <li>
- <p>visual identification of workspace in tabs:
- <br>
- <img src="Workspaces_image.png">
- </p>
- </li>
-</ul>
-<h3>Configuration</h3>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Label</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>workspace</code>
- </td>
- <td>Marks this note as a workspace, button to enter the workspace is controlled
- by this</td>
- </tr>
- <tr>
- <td><code>workspaceIconClass</code>
- </td>
- <td>defines box icon CSS class which will be used in tab when hoisted to this
- note</td>
- </tr>
- <tr>
- <td><code>workspaceTabBackgroundColor</code>
- </td>
- <td>CSS color used in the note tab when hoisted to this note, use any CSS
- color format, e.g. "lightblue" or "#ddd". See <a href="https://www.w3schools.com/cssref/css_colors.asp">https://www.w3schools.com/cssref/css_colors.asp</a>.</td>
- </tr>
- <tr>
- <td><code>workspaceCalendarRoot</code>
- </td>
- <td>Marking a note with this label will define a new per-workspace calendar
- for&nbsp;<a class="reference-link" href="#root/_help_l0tKav7yLHGF">Day Notes</a>.
- If there's no such note, the global calendar will be used.</td>
- </tr>
- <tr>
- <td><code>workspaceTemplate</code>
- </td>
- <td>This note will appear in the selection of available template when creating
- new note, but only when hoisted into a workspace containing this template</td>
- </tr>
- <tr>
- <td><code>workspaceSearchHome</code>
- </td>
- <td>new search notes will be created as children of this note when hoisted
- to some ancestor of this workspace note</td>
- </tr>
- <tr>
- <td><code>workspaceInbox</code>
- </td>
- <td>Default inbox location for new notes when hoisted to some ancestor of
- this workspace note. See&nbsp;<a class="reference-link" href="#root/_help_S0Fos78ZfcY7">Note Inbox</a>&nbsp;for
- more information.</td>
- </tr>
- </tbody>
- </table>
-</figure>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes.html
deleted file mode 100644
index bf60a16639..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes.html
+++ /dev/null
@@ -1,52 +0,0 @@
-<p>Note is a central entity in Trilium. Main attributes of note are <a href="#root/_help_l7pigIGu01K2">title</a> and
- content.</p>
-<h3>Note types</h3>
-<p>The main note type is a rich-text note type called&nbsp;<a class="reference-link"
- href="#root/_help_iPIMuisry3hd">Text</a>. For diagrams and drawing there
- is&nbsp;<a class="reference-link" href="#root/_help_grjYqerjn243">Canvas</a>&nbsp;and&nbsp;<a
- class="reference-link" href="#root/_help_s1aBHPd79XYj">Mermaid Diagrams</a>.</p>
-<p>There are also more complex note types such as&nbsp;<a class="reference-link"
- href="#root/_help_m523cpzocqaD">Saved Search</a>,&nbsp;<a class="reference-link"
- href="#root/_help_HcABDtFCkbFN">Render Note</a>&nbsp;that usually go hand-in-hand
- with&nbsp;<a class="reference-link" href="#root/_help_CdNpE2pqjmI6">Scripting</a>.</p>
-<p>In Trilium there's no specific "folder" note type. Any note can have children
- and thus be a folder. To make a note that only shows its children, like
- a folder in other applications, use a <a class="reference-link" href="#root/_help_8QqnMzx393bx">Grid View</a> or <a
- class="reference-link" href="#root/_help_mULW0Q3VojwY">List View</a> collection.
- See also <a class="reference-link" href="#root/_help_i6dbnitykE5D">FAQ</a>.</p>
-<h3>Root note</h3>
-<p>There's one special note called "root note" which is root of the note
- tree. All other notes are placed below it in the structure.</p>
-<h3>Tree structure</h3>
-<p>Importantly, note itself doesn't carry information on its placement in
- note tree. See&nbsp;<a class="reference-link" href="#root/_help_IakOLONlIfGI">Cloning Notes</a>&nbsp;for
- details.</p>
-<p>Tree structure of notes can resemble file system - but compared to that
- notes in Trilium can act as both file and directory - meaning that note
- can both have its own content and have children. "Leaf note" is a note
- which doesn't have any children.</p>
-<h3>Deleting / undeleting notes</h3>
-<p>When you delete a note in Trilium, it is actually only marked for deletion
- (soft-delete) - the actual content, title, attributes etc. are not deleted,
- only hidden.</p>
-<p>Within (by default) 7 days, it is possible to undelete these soft-deleted
- notes - open the&nbsp;<a class="reference-link" href="#root/_help_r5JGHN99bVKn">Recent Changes</a>&nbsp;dialog,
- and you will see a list of all modified notes including the deleted ones.
- Notes available for undeletion have a link to do so. This is kind of "trash
- can" functionality known from e.g. Windows.</p>
-<p>Clicking an undelete will recover the note, its content and attributes
- - note should be just as before being deleted. This action will also undelete
- note's children which have been deleted in the same action.</p>
-<p>To be able to undelete a note, it is necessary that deleted note's parent
- must be undeleted (otherwise there's no place where we can undelete it
- to). This might become a problem when you delete more notes in succession
- - the solution is then undelete in the reverse order of your deletion.</p>
-<p>After the 7 days (configurable) the notes will be "erased" - their title,
- content, revisions and attributes will be erased, and it will not be possible
- anymore to recover them (unless you restore a&nbsp;<a class="reference-link"
- href="#root/_help_ODY7qQn5m2FT">Backup</a>).</p>
-<h2>See also</h2>
-<ul>
- <li><a class="reference-link" href="#root/_help_CoFPLs3dRlXc">Read-Only Notes</a>
- </li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/1_Title_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/1_Title_image.png
deleted file mode 100644
index b4452f6952..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/1_Title_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Archived Notes.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Archived Notes.html
deleted file mode 100644
index d90b9813a0..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Archived Notes.html
+++ /dev/null
@@ -1,11 +0,0 @@
-<p>Archived notes are notes which have <code>archived</code> <a href="#root/_help_zEY4DaJG4YT5">attribute</a> -
- either directly or <a href="#root/_help_bwZpz2ajCEwO">inherited</a>.</p>
-<p>Such notes are then by default not shown in the autocomplete and in the
- full text <a href="#root/_help_eIg8jdvaoNNd">search</a>.</p>
-<p>This can be useful for notes which are no longer very useful but still
- valuable enough to keep around without them getting too much in the way.</p>
-<p>You can control whether archived notes are displayed in the note tree
- with a setting:</p>
-<p>
- <img src="Archived Notes_hide-archived.png">
-</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Archived Notes_hide-archived.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Archived Notes_hide-archived.png
deleted file mode 100644
index 82528ac634..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Archived Notes_hide-archived.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Attachments.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Attachments.html
deleted file mode 100644
index a3844ff1f6..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Attachments.html
+++ /dev/null
@@ -1,129 +0,0 @@
-<p>A <a href="#root/_help_BFs8mudNFgCS">note</a> in Trilium can <em>own</em> one
- or more attachments, which can be either images or files. These attachments
- can be displayed or linked within the note that owns them.</p>
-<p>This can be especially useful to include dependencies for your <a href="#root/_help_CdNpE2pqjmI6">scripts</a>.
- The&nbsp;<a class="reference-link" href="#root/_help_R7abl2fc6Mxi">Weight Tracker</a>&nbsp;shows
- how to use <a href="https://chartjs.org/">chartjs</a> which is attached to
- the script note.</p>
-<p>Each note exclusively owns its attachments, meaning attachments cannot
- be shared or linked from one note to another. If an attachment link is
- copied to a different note, the attachment itself is duplicated, and the
- copies are managed independently thereafter.</p>
-<p>Attachments, especially image files, are the recommended method for embedding
- visuals in notes. It is important to link image attachments within the
- text of the owning note; otherwise, they will be automatically deleted
- after a configurable timeout period if not referenced.</p>
-<h2>Types of attachments</h2>
-<p>There are two different types of attachment:</p>
-<ul>
- <li><em>User content</em>, representing files or images that are uploaded
- and part of the content of the note.</li>
- <li><em>System attachments</em> which are used internally by Trilium and can
- be of multiple types, including:
- <ul>
- <li><a class="reference-link" href="#root/_help_GTwFsgaA0lCt">Collections</a>&nbsp;to
- store information about views such as the column information for the&nbsp;<a
- class="reference-link" href="#root/_help_CtBQqbwXDx1w">Kanban Board</a>.</li>
- <li>Icons and cover images for&nbsp;<a class="reference-link" href="#root/_help_UmgZAfcltxkS">Link Previews</a>.</li>
- <li>Debug information for some importers such as&nbsp;<a class="reference-link"
- href="#root/_help_GnhlmrATVqcH">Microsoft OneNote</a>&nbsp;(only if the
- debug flag was enabled at import time).</li>
- </ul>
- </li>
-</ul>
-<p>The system attachments are displayed at the end of the attachments list,
- in a dedicated section (<em>Generated by Trilium</em>).</p>
-<h2>Attaching files from a text note</h2>
-<p>To attach files to a&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;note
- and embed them in its content, press the <span class="tn-icon cke cke-paper-clip"></span><em>Attach file</em> button
- in the&nbsp;<a class="reference-link" href="#root/_help_nRhnJkTT8cPs">Formatting toolbar</a>,
- next to the <span class="tn-icon cke cke-image-upload"></span>image upload
- button, and select one or more files (see <em>Embedding an attachment</em> below).
- The arrow beside the button lists the same action as <em>Attach and embed file</em>,
- followed by <em>Attach file as a link</em>, which links the files instead.
- Both actions are also available as <em>Attach file as a link</em> and <em>Attach and embed file</em> in
- the&nbsp;<a class="reference-link" href="#root/_help_ZlN4nump6EbW">Slash Commands</a>.</p>
-<p>When files are attached as links:</p>
-<ul>
- <li>Each file becomes an attachment of the note, and a link to it is inserted
- at the cursor. Several files produce several links, separated by a space.</li>
- <li>While a file uploads, its link shows the file name and a toast shows the
- progress.</li>
- <li>Pictures appear as links rather than images, and are attached exactly
- as they are, without being compressed. To display a picture in the text,
- use the image upload button instead (see&nbsp;<a class="reference-link"
- href="#root/_help_mT0HEkOsz6i1">Images</a>).</li>
-</ul>
-<p>Dragging a file that is not a picture from the file explorer onto the
- text also attaches it and inserts a link to it.</p>
-<h2>Acting on an attachment link</h2>
-<p>Right-clicking a link to an attachment shows the ways to open it, followed
- by actions on the attachment: opening it externally, downloading it, uploading
- a new revision, renaming or deleting it, and converting it into a note.</p>
-<p>Links follow changes to their attachment: renaming it updates the title
- they show, and deleting it removes them from the text notes open for editing
- at that moment. Converting it into a note turns its links into links to
- the new note.</p>
-<h2>Embedding an attachment</h2>
-<p>An attachment can be shown in the text instead of linked, the way&nbsp;<a
- class="reference-link" href="#root/_help_nBAXQFj20hS1">Include Note</a>&nbsp;shows
- a note: a picture is displayed, a PDF, a video or a document is previewed,
- and a code or text file is shown with syntax highlighting. An embedded
- code file can also be edited in place (see <em>Editing an include in place</em> in&nbsp;<a
- class="reference-link" href="#root/_help_nBAXQFj20hS1">Include Note</a>).</p>
-<ul>
- <li>To attach files and embed them straight away, press the <span class="tn-icon cke cke-paper-clip"></span><em>Attach file</em> button.
- Each file gets an embed of its own, which shows the file name while the
- file uploads.</li>
- <li>To embed an attachment that is already linked, right-click a link to it
- in a text note being edited and select <em>Convert link to an embed</em>,
- at the end of the menu.</li>
- <li>A drawing canvas, inserted with <span class="tn-icon bx bx-pen"></span><em>Drawing canvas</em> in
- the <span class="tn-icon cke cke-plus"></span><em>Insert</em> menu, is an
- embed of a <code>Canvas.excalidraw</code> attachment that can be drawn on
- in place. An attached Excalidraw file (<code>.excalidraw</code>) is embedded
- as a drawing canvas too (see <em>Drawing canvases</em> in&nbsp;<a class="reference-link"
- href="#root/_help_nBAXQFj20hS1">Include Note</a>).</li>
- <li>An embed gets the box size that suits the attachment, as a new included
- note does (see <em>Box sizes</em> there). To change its size, select the
- embed and use the box size menu in its toolbar, or the <em>Size</em> submenu
- of its <span class="tn-icon bx bx-dots-vertical-rounded"></span><em>More actions</em> menu.
- A <em>Small</em>, <em>Medium</em> or <em>Expandable</em> embed can also be resized
- by dragging its handles (see <em>Resizing</em> there).</li>
- <li>An embed can have a caption, as an included note can (see <em>Caption</em> there).</li>
- <li>To show only the attachment, select the embed and press the&nbsp;<span
- class="tn-icon bx bx-window-alt"></span> (<em>Show title)</em> button in
- its toolbar, as for an included note (see <em>Title</em> there).</li>
- <li>To open the attachment in a new tab, press the&nbsp;<span class="tn-icon bx bx-link-external"></span> (<em>Open in new tab)</em> button
- at the end of the embed's title.</li>
- <li>An embed of size <em>Tiny</em> shows only the title of the attachment and
- its size, in a single row. Its buttons are <span class="tn-icon bx bx-file-find"></span><em>Open externally</em> and <span
- class="tn-icon bx bx-download"></span><em>Download</em>.</li>
- <li>To show an embed of size <em>Medium</em> or <em>Full</em> on the whole screen,
- press the&nbsp;<span class="tn-icon bx bx-fullscreen"></span> (<em>Fullscreen)</em> button
- at the end of its title. To return, press&nbsp;<span class="tn-icon bx bx-exit"></span> (<em>Exit fullscreen)</em> in
- the top-right corner, or <kbd>Esc</kbd>.</li>
- <li>To turn the embed back into a link, select it and press the <span class="tn-icon cke cke-link"></span><em>Convert to link</em> button
- in its toolbar. <em>Convert to link</em> also ends the menu that right-clicking
- the title row of the embed or pressing its <span class="tn-icon bx bx-dots-vertical-rounded"></span><em>More actions</em> button
- opens.</li>
-</ul>
-<p>An embed follows its attachment like a link does. Converting the attachment
- into a note turns the embed into an included note. In a <a href="#root/_help_R9pX4DGra2Vt">shared note</a>,
- an embedded picture is displayed with its caption, a drawing canvas as
- a picture of the drawing, and any other attachment, or a picture in a <em>Tiny</em> embed,
- appears as a link to download it.</p>
-<h2>Converting notes to attachments</h2>
-<p><a class="reference-link" href="#root/_help_W8vYD3Q1zjCR">File</a>&nbsp;notes
- can be easily converted to attachments of the parent note.</p>
-<p>To do so:</p>
-<ul>
- <li>For a single note, press the context menu from the&nbsp;<a class="reference-link"
- href="#root/_help_8YBEPzcpUgxw">Note menu</a>&nbsp;and select <em>Convert into attachment</em>.</li>
- <li>For multiple notes, select the given notes in the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>, right click → Advanced → <em>Convert to attachment…</em>.</li>
-</ul>
-<h2>Attachment previews</h2>
-<p>Attachments share the same content preview for images, videos, PDFs, etc.
- as the&nbsp;<a class="reference-link" href="#root/_help_W8vYD3Q1zjCR">File</a>&nbsp;note
- type.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Cloning Notes.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Cloning Notes.html
deleted file mode 100644
index 1ab7b86768..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Cloning Notes.html
+++ /dev/null
@@ -1,107 +0,0 @@
-<h2>Motivation</h2>
-<p>Trilium's core feature is the ability to structure your notes into hierarchical
- tree-like structure.</p>
-<p>It is expected then that you'll have an elaborate and deep note hierarchy
- - each subtree will represent a more refined and specialized view of your
- knowledge base.</p>
-<p>This is a pretty powerful approach, but it also carries a hidden assumption
- that each "subtopic" is "owned" by one parent. I'll illustrate this with
- an example - let's say my basic structure is this:</p>
-<ul>
- <li>Technology
- <ul>
- <li>Programming
- <ul>
- <li>Kotlin</li>
- <li>JavaScript</li>
- </ul>
- </li>
- <li>Operating systems
- <ul>
- <li>Linux</li>
- <li>Windows</li>
- </ul>
- </li>
- </ul>
- </li>
-</ul>
-<p>Now, I'm starting to learn about <a href="https://en.wikipedia.org/wiki/Bash_(Unix_shell)">Bash</a> and
- would like to create notes related to this topic. But now I'm facing a
- problem of where to categorize this. The issue here is that Bash is both
- a programming language and a tool (shell) very much tied into Linux. It
- seems it belongs to both of these, I can't (and don't want to) choose one
- over the other.</p>
-<h2>Solution</h2>
-<p>The solution to the problem shown above is to allow notes to have multiple
- parents.</p>
-<p>I call these "clones", but that is a bit misleading - there's no original
- and cloned note - the notes in both of the parents categories are identical.</p>
-<p>Another misleading thing about "cloning" is that it suggests that a copy
- of the note has been made. That's not really true, the note itself stays
- in just one original, it is just referenced in multiple places in the tree
- hierarchy. So changing it in one category changes it in all the others,
- because they're all the same note.</p>
-<p>Here's the final structure with cloning:</p>
-<ul>
- <li>Technology
- <ul>
- <li>Programming
- <ul>
- <li>Kotlin</li>
- <li>JavaScript</li>
- <li>Bash
- <ul>
- <li>some sub-notes ...</li>
- </ul>
- </li>
- </ul>
- </li>
- <li>Operating systems
- <ul>
- <li>Linux
- <ul>
- <li>Bash
- <ul>
- <li>some sub-notes ...</li>
- </ul>
- </li>
- </ul>
- </li>
- <li>Windows</li>
- </ul>
- </li>
- </ul>
- </li>
-</ul>
-<p>So now the "Bash" subtree appears on multiple locations in the hierarchy.
- Both the Bash subtrees are the same and contain the same sub-categories
- and notes.</p>
-<h3>Demo</h3>
-<p>
- <img src="Cloning Notes_create-clone.gif">
-</p>
-<p>In the demo, you can see how a clone can be created using the context
- menu. It's possible to do this also using the Add Link dialog or with <kbd>Ctrl</kbd>+<kbd>C</kbd> and <kbd>Ctrl</kbd>+<kbd>V</kbd> <a
- href="#root/_help_A9Oc6YKKc65v">keyboard shortcuts</a>.</p>
-<p>You can view the list of all available clones:</p>
-<ul>
- <li>In the&nbsp;<a class="reference-link" href="#root/_help_AlJ73vBCjWDw">Status bar</a>,
- by looking for the&nbsp;<span class="tn-icon bx bx-directions"></span> icon.</li>
- <li>In the&nbsp;<a class="reference-link" href="#root/_help_KRlZFoIH0j6p">Connections tab</a>&nbsp;of
- the&nbsp;<a class="reference-link" href="#root/_help_RnaPdbciOfeq">Right Sidebar</a>,
- by looking at the <em>Note paths</em> section.</li>
-</ul>
-<p>Titles of cloned notes in the tree view have an asterisk to the right
- to easily see that the note is also placed into some other location.</p>
-<h2>Deleting notes/clones</h2>
-<p>With clones, it might not be immediately obvious how deleting works.</p>
-<p>If you try to delete a note, it works like this:</p>
-<ol>
- <li>if the note has multiple clones, delete just this clone and leave the
- actual note (and its other clones) as it is.</li>
- <li>if this note doesn't have any other clones, delete the note
- <ul>
- <li>Run the whole process starting with 1. on all note's children notes</li>
- </ul>
- </li>
-</ol>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Cloning Notes/Branch prefix.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Cloning Notes/Branch prefix.html
deleted file mode 100644
index 74df3e1975..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Cloning Notes/Branch prefix.html
+++ /dev/null
@@ -1,9 +0,0 @@
-<p>Since a single note can appear into multiple places in the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;via a process called&nbsp;<a
- class="reference-link" href="#root/_help_IakOLONlIfGI">Cloning Notes</a>,
- it's recommended to choose a generalized name that fits into all locations
- instead of something more specific to avoid confusion.</p>
-<p>In some cases this isn't possible so Trilium provides "branch prefixes",
- which is shown before the note name in the tree and as such provides a
- specific kind of context.</p>
-<p>The prefix is location-specific, so it's displayed only in the note tree.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Cloning Notes_create-clone.gif b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Cloning Notes_create-clone.gif
deleted file mode 100644
index 7429e5e737..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Cloning Notes_create-clone.gif and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/New note type switcher.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/New note type switcher.html
deleted file mode 100644
index b93d0cc8a6..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/New note type switcher.html
+++ /dev/null
@@ -1,25 +0,0 @@
-<p>When an empty&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;note
- is created, a note type switcher will appear below the&nbsp;inline&nbsp;<a
- class="reference-link" href="#root/_help_l7pigIGu01K2">Title</a>. Apart
- from changing the note type, it's also possible to apply a <a href="#root/_help_KC1HB96bqqHX">template</a>:</p>
-<ul>
- <li><span class="tn-icon bx bxl-markdown"></span>&nbsp;<em>Markdown</em> and&nbsp;<span
- class="tn-icon bx bx-pen"></span> <em>Canvas</em> switch the note to that
- type in one click.</li>
- <li><span class="tn-icon bx bx-code"></span>&nbsp;<em>Code</em> lists the scripting
- notes (<em>Custom CSS</em>, <em>Widget</em> and <em>Backend script</em>),
- then the enabled code languages.</li>
- <li><span class="tn-icon bx bx-book"></span>&nbsp;<em>Collection</em> and <span
- class="tn-icon bx bx-copy-alt"></span><em>Template</em> list the collections
- and the templates.</li>
- <li><span class="tn-icon bx bx-dots-vertical-rounded"></span>&nbsp;<em>All types</em> displays
- the same menu as <em>Insert note after</em> in the&nbsp;<a class="reference-link"
- href="#root/_help_YtSN43OrfzaA">Note tree contextual menu</a>, with every
- note type and template.</li>
-</ul>
-<p>Typing while the&nbsp;<span class="tn-icon bx bx-code"></span> <em>Code</em>,&nbsp;<span
- class="tn-icon bx bx-copy-alt"></span> <em>Template</em> or&nbsp;<span class="tn-icon bx bx-dots-vertical-rounded"></span> <em>All types</em> menu
- is open narrows it down to the matching entries.</p>
-<p>The switcher will disappear as soon as a text is entered.</p>
-<img src="New note type switcher_image.png"
-width="735" height="143">
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/New note type switcher_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/New note type switcher_image.png
deleted file mode 100644
index ca7593700b..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/New note type switcher_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note Icons & Colors.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note Icons & Colors.html
deleted file mode 100644
index e313c53fbe..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note Icons & Colors.html
+++ /dev/null
@@ -1,34 +0,0 @@
-<h2>Icons</h2>
-<figure class="image image-style-align-right image_resized" style="width:48.4%;">
- <img style="aspect-ratio:1089/995;" src="Note Icons & Colors_image.png"
- width="1089" height="995">
-</figure>
-<p>Icons are useful for distinguishing notes and are displayed near the note
- title, as well as in various places such as the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>,&nbsp;<a class="reference-link"
- href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a>&nbsp;or
- the&nbsp;<a class="reference-link" href="#root/_help_F1r9QtzQLZqm">Jump to &amp; command palette</a>.</p>
-<p>While editing a note, click on the icon next to the title to bring up
- a chooser gallery.</p>
-<p>Icons can be inherited through the use of&nbsp;<a class="reference-link"
- href="#root/_help_KC1HB96bqqHX">Templates</a>, or&nbsp;<a class="reference-link"
- href="#root/_help_bwZpz2ajCEwO">Attribute Inheritance</a>.</p>
-<aside class="admonition note">
- <p>At the technical level, they are set by the <code>iconClass</code> attribute
- which adds a CSS class to the note. For example <code>#iconClass="bx bx-calendar"</code> will
- show a calendar instead of the default page or folder icon. Looking up
- and remembering the CSS class names is not necessary.</p>
-</aside>
-<h2>Colors</h2>
-<p>Notes can also carry a custom color. Similar to the note icon, this color
- will be shown in various places such as the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;and&nbsp;<a class="reference-link"
- href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a>.</p>
-<p>To set a custom color, right click on the note in the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;and select a predefined
- color from there or use the color picker (last option).</p>
-<p>Alternatively, a custom color can be set manually through the <code>#color</code> <a
- href="#root/_help_HI6GBBIduIgv">label</a>, whose value must be a valid
- hex color including the leading <code>#</code> (e.g. <code>#ff0000</code> for
- red). This color can be carried over across multiple notes via&nbsp;<a
- class="reference-link" href="#root/_help_bwZpz2ajCEwO">Attribute Inheritance</a>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note Icons & Colors_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note Icons & Colors_image.png
deleted file mode 100644
index 0157d47413..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note Icons & Colors_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note Inbox.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note Inbox.html
deleted file mode 100644
index d0723bf36a..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note Inbox.html
+++ /dev/null
@@ -1,36 +0,0 @@
-<p>The inbox is the default destination for quickly captured notes. When
- a note is created without picking a location first, it lands in the inbox.
- This makes it easy to quickly capture notes and sort them later.</p>
-<h2>Where the inbox is used</h2>
-<ul>
- <li>The <em>New note</em> button in the&nbsp;<a class="reference-link" href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>.</li>
- <li>The global <em>Create note into inbox</em> shortcut (default <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>P</kbd>).</li>
- <li>The <em>New note</em> action in the <a href="#root/_help_7iwde4lsKc6O">tray icon menu</a>.</li>
- <li>The&nbsp;<a class="reference-link" href="#root/_help_MtPxeAWVAzMg">Web Clipper</a>&nbsp;extension.</li>
- <li>The <em>Create note</em> option offered when a search finds no match, in&nbsp;<a
- class="reference-link" href="#root/_help_F1r9QtzQLZqm">Jump to &amp; command palette</a>,
- in an empty tab and in the <code>@</code> completion of a text note.</li>
-</ul>
-<h2>Setting a note inbox</h2>
-<p>To create a note inbox, apply the <code>#inbox</code> <a href="#root/_help_HI6GBBIduIgv">label</a> to
- it.</p>
-<p>Only one note should carry this label. If there are multiple notes, only
- one will be used by the application.</p>
-<aside class="admonition note">
- <p>If there is no inbox note, Trilium will fall back to today's <a href="#root/_help_l0tKav7yLHGF">day note</a>,
- creating it and its calendar ancestors as needed. If the journal has been
- removed altogether, the note is created at the top level instead of a new
- journal being built for it.</p>
-</aside>
-<h2>Workspace inboxes</h2>
-<p>Each <a href="#root/_help_9sRHySam5fXb">workspace</a> can have its own inbox,
- set via the <code>#workspaceInbox</code> label.</p>
-<p>When a new note is created while hoisted in a workspace, the location
- is determined in the following order:</p>
-<ul>
- <li>A note carrying the <code>#workspaceInbox</code> label in that workspace.</li>
- <li>A note carrying the <code>#inbox</code> within that workspace.</li>
- <li>Today's <a href="#root/_help_l0tKav7yLHGF">day note</a>, if the workspace
- has a <code>#workspaceCalendarRoot</code>.</li>
- <li>The workspace root note itself.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note List.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note List.html
deleted file mode 100644
index 9a8e59f9a7..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note List.html
+++ /dev/null
@@ -1,23 +0,0 @@
-<figure class="image">
- <img style="aspect-ratio:990/590;" src="Note List_image.png" width="990"
- height="590">
-</figure>
-<p>When a note has one or more child notes, they will be listed at the end
- of the note for easy navigation.</p>
-<h2>Configuration</h2>
-<ul>
- <li>To hide the note list for a particular note, simply apply the <code>hideChildrenOverview</code> <a
- href="#root/_help_zEY4DaJG4YT5">label</a>.</li>
- <li>For some view types, such as Grid view, only a subset of notes will be
- displayed and pagination can be used to navigate through all of them for
- performance reasons. To adjust the number of notes per page, set <code>pageSize</code> to
- the desired number.</li>
-</ul>
-<h2>View types</h2>
-<p>The view types dictate how the child notes are represented. By default,
- the notes will be displayed in a grid, however there are also some other
- view types available.</p>
-<p>Generally the view type can only be changed from the&nbsp;<a class="reference-link"
- href="#root/_help_CssoWBu8I7jF">Collection Properties</a>, but it can also
- be changed manually on any type of note using the <code>#viewType</code> <a
- href="#root/_help_HI6GBBIduIgv">label</a>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note List_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note List_image.png
deleted file mode 100644
index 8de2914c1c..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note List_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note Revisions.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note Revisions.html
deleted file mode 100644
index 6a4f7c91b2..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note Revisions.html
+++ /dev/null
@@ -1,116 +0,0 @@
-<figure class="image">
- <img style="aspect-ratio:2089/1515;" src="Note Revisions_image.png" width="2089"
- height="1515">
-</figure>
-<p>Trilium supports seamless versioning of notes by storing snapshots ("revisions")
- of notes at regular intervals.</p>
-<p>To display the revisions, press the&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a>&nbsp;and
- select <em>Note revisions…</em> (<span class="tn-icon bx bx-history"></span>).</p>
-<h2>Interaction</h2>
-<aside class="admonition note">
- <p>This documentation matches the redesign of the note revisions dialog on
- v0.103.0, older versions have a similar dialog but with some differences.</p>
-</aside>
-<ul>
- <li>The full list of revisions are displayed on the left in reverse chronological
- order.
- <ul>
- <li>The revisions are grouped by the date the revision was taken.</li>
- <li>This list does not contain the <em>current state</em> of the note, so it
- is possible to have notes with no revisions/snapshots saved.</li>
- </ul>
- </li>
- <li>The icon of a revision indicates the <em>source</em> of that revision (e.g.
- a&nbsp;<span class="tn-icon bx bx-save"></span> icon for a manually saved
- revision).</li>
- <li>Pressing the <span class="tn-icon bx bx-dots-horizontal-rounded"></span> button
- on the top-right of the dialog displays multiple options, including:
- <ul>
- <li><span class="tn-icon bx bx-save"></span> Saving a new revision now.</li>
- <li>Checking the interval and limit for this note (see below).</li>
- <li><span class="tn-icon bx bx-trash"></span> Deleting all the revisions of
- this note.</li>
- </ul>
- </li>
- <li>For supported notes (text, code), changes are highlighted. This behavior
- can be toggled via the <em>Highlight changes</em> at the top of the dialog.
- <ul>
- <li>The highlighted changes are relative to the <strong>current state of the note</strong>,
- not to the revision prior to this one.</li>
- </ul>
- </li>
- <li>For any given revision, the buttons on the top-right allow operating on
- it:
- <ul>
- <li><span class="tn-icon bx bx-trash"></span> Deleting the revision.</li>
- <li><span class="tn-icon bx bx-download"></span> Downloading the revision locally.</li>
- <li><span class="tn-icon bx bx-history"></span> Restoring the revision, which
- replaces the current content of the note with the one from the revision.
- Another revision is saved containing the current content of the note.</li>
- </ul>
- </li>
-</ul>
-<h2>Named revisions</h2>
-<p>Named revisions are a new feature of Trilium v0.103.0 which allows adding
- a short description of what the changes in the snapshot contain.</p>
-<p>In the list of note revisions:</p>
-<ul>
- <li>The name of the revision is displayed underneath the time of the revision
- in the sidebar, as well as at the top of the dialog where it is displayed
- in full.</li>
- <li>Clicking on the <span class="tn-icon bx bx-edit-alt"></span> edit button
- near the name of the revision allows it to be changed.</li>
-</ul>
-<p>To create a named revision, either:</p>
-<ul>
- <li>Go to the&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a>,
- select <em>Save named revision…</em> (<span class="tn-icon bx bx-purchase-tag"></span>),
- enter the name of revision and confirm.</li>
- <li>Use the corresponding <a href="#root/_help_A9Oc6YKKc65v">keyboard shortcut</a> or
- the&nbsp;<a class="reference-link" href="#root/_help_F1r9QtzQLZqm">Jump to &amp; command palette</a>&nbsp;command
- with the same name.</li>
- <li>Save a revision normally, and adjust the name afterwards from the note
- revision list.</li>
-</ul>
-<h2>When revisions are saved</h2>
-<p>Revisions are saved:</p>
-<ul>
- <li>Automatically at a fixed interval. This behavior can be configured (see
- below).</li>
- <li>Manually, by:
- <ul>
- <li>Going to the <a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a> and
- selecting <em>Save revision</em> (<span class="tn-icon bx bx-save"></span>).</li>
- <li>Using the <em>Force Save Revision</em> <a href="#root/_help_A9Oc6YKKc65v">keyboard shortcut</a>.</li>
- <li>In the <em>Note Revisions</em> dialog, pressing the <span class="tn-icon bx bx-dots-horizontal-rounded"></span> button
- in the top-right and selecting <em>Save a revision now</em>.</li>
- </ul>
- </li>
-</ul>
-<p>Additionally, revisions can also come from somewhere else, and this is
- indicated via the icon of the revision:</p>
-<ul>
- <li><span class="tn-icon bx bx-code-alt"></span> Generated externally, by&nbsp;<a
- class="reference-link" href="#root/_help_pgxEVkzLl1OP">ETAPI (REST API)</a>.</li>
- <li><span class="tn-icon bx bx-bot"></span> A modification created by&nbsp;<a
- class="reference-link" href="#root/_help_GBBMSlVSOIGP">AI</a>.</li>
- <li><span class="tn-icon bx bx-history"></span> A revision is restored, causing
- the existing note content to be saved as a revision to prevent potential
- data loss.</li>
-</ul>
-<h4>Snapshot interval</h4>
-<p>Time interval of taking note snapshot is configurable in the Options →
- Other dialog. This provides a trade-off between more revisions and more
- data to store.</p>
-<p>To turn off note versioning for a particular note (or sub-tree), add <code>disableVersioning</code> <a
- href="#root/_help_zEY4DaJG4YT5">label</a> to the note.</p>
-<h4>Maximum revisions</h4>
-<p>The limit on the number of note snapshots can be configured in the Options
- → Other dialog. The note revision snapshot number limit refers to the maximum
- number of revisions that can be saved for each note. Where -1 means no
- limit, 0 means delete all revisions. You can set the maximum revisions
- for a single note through the <code>versioningLimit=X</code> label.</p>
-<p>The note limit will not take effect immediately; it will only apply when
- the note is modified.</p>
-<p>You can click the <em>Erase now</em> button under <em>Erase excess revision snapshots</em> to
- apply the changes immediately.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note Revisions_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note Revisions_image.png
deleted file mode 100644
index cdaf1cef60..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note Revisions_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note badges.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note badges.html
deleted file mode 100644
index 1ed01ade94..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note badges.html
+++ /dev/null
@@ -1,32 +0,0 @@
-<p>Note badges appear near the fixed note title and indicate important information
- about the note such as whether it is read-only. Some of the badges are
- also interactive.</p>
-<figure class="image">
- <img style="aspect-ratio:910/49;" src="Note badges_image.png" width="910"
- height="49">
-</figure>
-<p>The following badges are available:</p>
-<ul>
- <li><span class="tn-icon bx bx-lock-alt"></span>&nbsp;<strong>Read-only badge</strong>,
- which will be shown if the note is not editable due to either automatic
- read-only or manual read-only. Clicking on the badge will temporarily edit
- the note.</li>
- <li><span class="tn-icon bx bx-share-alt"></span>&nbsp;<strong>Share badge</strong>,
- which will indicate that the current note is shared. The badge will also
- indicate if the share is on the local network (for the desktop application
- without&nbsp;<a class="reference-link" href="#root/_help_cbkrhQjrkKrh">Synchronization</a>&nbsp;set
- up) or publicly accessible (for the server).</li>
- <li><span class="tn-icon bx bx-globe"></span>&nbsp;<strong>Web clip badge</strong>,
- which will indicate if the note was clipped using the&nbsp;<a class="reference-link"
- href="#root/_help_MtPxeAWVAzMg">Web Clipper</a>. The badge acts as a link,
- so it can be clicked on to navigate to the page or right clicked for more
- options. When the clipper also saved the page's description, its author,
- or the dates it was published and last updated, clicking the badge shows
- these details instead, with a link to the page at the top.</li>
- <li><span class="tn-icon bx bx-play"></span>&nbsp;<strong>Execute badge</strong>,
- for <a href="#root/_help_CdNpE2pqjmI6">scripts</a> or <a href="#root/_help_YKWqdJhzi2VY">saved SQL queries</a> which
- have an execute button or a description.</li>
- <li>For&nbsp;<a class="reference-link" href="#root/_help_YzMcWlCVeW09">Active content</a>&nbsp;(e.g.
- scripts, styles), a dedicated badge will be shown indicating the type of
- note and with an option to easily enable or disable it.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note badges_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note badges_image.png
deleted file mode 100644
index 10676a08ef..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note badges_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Printing & Exporting as PDF.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Printing & Exporting as PDF.html
deleted file mode 100644
index 7200880573..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Printing & Exporting as PDF.html
+++ /dev/null
@@ -1,217 +0,0 @@
-<figure class="image">
- <img style="aspect-ratio:2023/1488;" src="Printing & Exporting as PDF_image.png"
- width="2023" height="1488">
- <figcaption>Screenshot of the Print preview functionality introduced in v0.103.0.</figcaption>
-</figure>
-<p>Trilium allows printing notes to a real printer, or generating a structured
- PDF for a single note or for multiple notes through&nbsp;<a class="reference-link"
- href="#root/_help_GTwFsgaA0lCt">Collections</a>.</p>
-<p>Note that not all note types are printable as of now. We do plan to increase
- the coverage of supported note types in the future.</p>
-<p>Printing and exporting as PDF are not perfect. Due to technical limitations,
- and sometimes even browser or Electron glitches the text might appear cut
- off in some circumstances.&nbsp;</p>
-<h2>Printing a note or exporting as PDF on the desktop</h2>
-<aside class="admonition note">
- <p>Versions prior to v0.103.0 had two different options, one for printing
- and another one for exporting to PDF. With the introduction of the print
- preview, these functions have been unified.</p>
-</aside>
-<p>On the desktop application of Trilium it is possible to export a note
- as PDF. To print a note:</p>
-<ul>
- <li>Press the menu button in the&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a>&nbsp;and
- select <em>Print note</em>.</li>
- <li>Alternatively, printing can be triggered from a <a href="#root/_help_A9Oc6YKKc65v">keyboard shortcut</a> (unassigned
- by default) or through the <a href="#root/_help_F1r9QtzQLZqm">command palette</a>.</li>
-</ul>
-<p>This will trigger the print preview screen next.</p>
-<h3>Print preview &amp; print options</h3>
-<p>The print preview dialog allows the following printing options to be adjusted:</p>
-<ul>
- <li>The printer to use
- <ul>
- <li><em>Save as PDF</em> generates a PDF that is structured (maintains a table
- of contents, keeps the text selectable). Prefer this over other virtual
- PDF printers that ship with the operating system.</li>
- </ul>
- </li>
- <li>Page orientation: <em>Portrait</em> (default) or <em>Landscape</em>.</li>
- <li>Page size</li>
- <li>Scale the entire content from 10% to 200% to improve the fit within the
- page.</li>
- <li>Margins, which can be removed completely or adjusted individually for
- all the four edges.</li>
- <li>Print only a subset of pages. Individual page numbers are separated by
- colons and hyphen-based ranges are supported (e.g. 3-5 for pages 3 to 5).</li>
-</ul>
-<p>Additional interaction:</p>
-<ul>
- <li><em>Print using system dialog</em> allows setting more options that are
- otherwise not available in Trilium.</li>
-</ul>
-<p>If the note cannot be rendered with the current options, or stops making
- progress for 30 seconds, the preview is replaced by an error message. Adjust
- the options to try again.</p>
-<aside class="admonition note">
- <p>Most of the options here (except printer &amp; which pages to print) are
- managed at note level through&nbsp;<a class="reference-link" href="#root/_help_zEY4DaJG4YT5">Attributes</a>&nbsp;(such
- as <code>#printLandscape</code>, <code>#printPageSize</code>, <code>#printScale</code>, <code>#printMargins</code>).</p>
- <p>This means that the print settings will be restored when printing the
- same note. There are no default settings that can be configured for all
- the notes, but this can be achieved via <a href="#root/_help_bwZpz2ajCEwO">inheritable attributes</a>.</p>
-</aside>
-<h2>Printing on the browser</h2>
-<p>This feature allows printing of notes. It works on both the desktop client,
- but also on the web.</p>
-<p>To print a note, click the&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a>&nbsp;and
- select <em>Print note</em>. Depending on the size and type of the note,
- this can take up to a few seconds. Afterwards you will be redirected to
- the system/browser printing dialog.</p>
-<p>On the server or PWA (mobile), the option is not available due to technical
- constraints and it will be hidden.</p>
-<h2>Reporting issues with the rendering</h2>
-<p>Should you encounter any visual issues in the resulting PDF file (e.g.
- a table does not fit properly, there is cut off text, etc.) feel free to <a
- href="#root/_help_wy8So3yZZlH9">report the issue</a>. In this case, it's
- best to offer a sample note (click on the&nbsp;<span class="tn-icon cke cke-three-vertical-dots"></span> button,
- select <em>Export note</em> → <em>This note and all of its descendants</em> → <em>HTML in ZIP archive</em>).
- Make sure not to accidentally leak any personal information.</p>
-<p>Consider adjusting font sizes and using <a href="#root/_help_CohkqWQC1iBv">page breaks</a> to
- work around the layout.</p>
-<aside class="admonition tip">
- <p>Although direct export as PDF is not available in the browser version
- of the application, it's still possible to generate a PDF by selecting
- the <em>Print</em> option instead and selecting “Save to PDF” as the printer
- (depending on the browser). Generally, Mozilla Firefox has better printing
- capabilities.</p>
-</aside>
-<h3>Automatic opening of the file</h3>
-<p>When the PDF is exported, it is automatically opened with the system default
- application for easy preview.</p>
-<p>Note that if you are using Linux with the GNOME desktop environment, sometimes
- the default application might seem incorrect (such as opening in GIMP).
- This is because it uses Gnome's “Recommended applications” list.</p>
-<p>To solve this, you can change the recommended application for PDFs via
- this command line. First, list the available applications via <code>gio mime application/pdf</code> and
- then set the desired one. For example to use GNOME's Evince:</p><pre><code class="language-text-x-trilium-auto">gio mime application/pdf</code></pre>
-<h2>Printing multiple notes</h2>
-<p>Since v0.100.0, it is possible to print more than one note at the time
- by using&nbsp;<a class="reference-link" href="#root/_help_GTwFsgaA0lCt">Collections</a>:</p>
-<ol>
- <li>First create a collection.</li>
- <li>Configure it to use&nbsp;<a class="reference-link" href="#root/_help_mULW0Q3VojwY">List View</a>.</li>
- <li>Print the collection note normally.</li>
-</ol>
-<p>The resulting collection will contain all the children of the collection,
- while maintaining the hierarchy.</p>
-<aside class="admonition note">
- <p>Not all note types are supported when printing or exporting to PDF. When
- an unsupported note is encountered, it is skipped. At the end, if any of
- the notes were skipped, a message will be displayed with the possibility
- of viewing the full list of skipped notes. The same limitations as the
- ones described in <em>Constraints &amp; limitations</em> apply.</p>
-</aside>
-<h2>Keyboard shortcut</h2>
-<p>It's possible to trigger both printing and export as PDF from the keyboard
- by going to&nbsp;<em>Keyboard shortcuts</em>&nbsp;in&nbsp;<a class="reference-link"
- href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;and assigning a key combination
- for:</p>
-<ul>
- <li><em>Print Active Note</em>
- </li>
- <li><em>Export Active Note as PDF</em>
- </li>
-</ul>
-<h2>Constraints &amp; limitations</h2>
-<p>Not all&nbsp;<a class="reference-link" href="#root/_help_KSZ04uQ2D1St">Note Types</a>&nbsp;are
- supported when printing, in which case the <em>Print</em> and <em>Export as PDF</em> options
- will be disabled.</p>
-<ul>
- <li>For&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes,
- font, background and table colors are printed in the shades of light themes,
- whatever the current theme (see&nbsp;<a class="reference-link" href="#root/_help_Gr6xFaF6ioJ5">General formatting</a>).</li>
- <li>For&nbsp;<a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;notes:
- <ul>
- <li>Line numbers are not printed.</li>
- <li>Syntax highlighting is enabled, however a default theme (Visual Studio)
- is enforced.</li>
- </ul>
- </li>
- <li>A <a class="reference-link" href="#root/_help_HcABDtFCkbFN">Render Note</a> is
- printed as it is displayed, without running its script again, once its <code>~renderNote</code> relation
- is set.</li>
- <li>For&nbsp;<a class="reference-link" href="#root/_help_GTwFsgaA0lCt">Collections</a>,
- the following are supported:
- <ul>
- <li><a class="reference-link" href="#root/_help_mULW0Q3VojwY">List View</a>,
- allowing to print multiple notes at once while preserving hierarchy (similar
- to a book).</li>
- <li><a class="reference-link" href="#root/_help_zP3PMqaG71Ct">Presentation</a>,
- where each slide/sub-note is displayed.
- <ul>
- <li>Most note types are supported, especially the ones that have an image
- representation such as&nbsp;<a class="reference-link" href="#root/_help_grjYqerjn243">Canvas</a>&nbsp;and&nbsp;<a
- class="reference-link" href="#root/_help_gBbsAeiuUxI5">Mind Map</a>.</li>
- </ul>
- </li>
- <li><a class="reference-link" href="#root/_help_2FvYrpmOXm29">Table</a>, where
- the table is rendered in a print-friendly way.
- <ul>
- <li>Tables that are too complex (especially if they have multiple columns)
- might not fit properly, however tables with a large number of rows are
- supported thanks to pagination.</li>
- <li>Consider printing in landscape mode, or using <code>#printLandscape</code> if
- exporting to PDF.</li>
- </ul>
- </li>
- <li>The rest of the collections are not supported, but we plan to add support
- for all the collection types at some point.</li>
- </ul>
- </li>
- <li>Using&nbsp;<a class="reference-link" href="#root/_help_AlhDUqhENtH7">Custom app-wide CSS</a>&nbsp;for
- printing is no longer supported, instead a custom <code>printCss</code> relation
- needs to be used (see below).</li>
-</ul>
-<h2>Customizing the print CSS</h2>
-<p>As an advanced use case, it's possible to customize the CSS used for printing
- such as adjusting the fonts, sizes or margins. Note that&nbsp;<a class="reference-link"
- href="#root/_help_AlhDUqhENtH7">Custom app-wide CSS</a>&nbsp;will not work
- for printing.</p>
-<p>To do so:</p>
-<ul>
- <li>Create a CSS <a href="#root/_help_6f9hih2hXXZk">code note</a>.</li>
- <li>On the note being printed, apply the <code>~printCss</code> relation to
- point to the newly created CSS code note.</li>
- <li>To apply the CSS to multiple notes, consider using <a href="#root/_help_bwZpz2ajCEwO">inheritable attributes</a> or&nbsp;<a
- class="reference-link" href="#root/_help_KC1HB96bqqHX">Templates</a>.</li>
-</ul>
-<p>For example, to change the font of the document from the one defined by
- the theme or the user to a serif one:</p><pre><code class="language-text-x-trilium-auto">body {
- --print-font-family: serif;
- --print-font-size: 11pt;
-}</code></pre>
-<aside class="admonition important">
- <p>When altering <code>--print-font-family</code>, make sure the change is
- done at <code>body</code> level and not <code>:root</code>, since otherwise
- it won't be picked up due to specificity rules.</p>
-</aside>
-<p>To remark:</p>
-<ul>
- <li>Multiple CSS notes can be add by using multiple <code>~printCss</code> relations.</li>
- <li>If the note pointing to the <code>printCss</code> doesn't have the right
- note type or mime type, it will be ignored.</li>
- <li>If migrating from a previous version where&nbsp;<a class="reference-link"
- href="#root/_help_AlhDUqhENtH7">Custom app-wide CSS</a>, there's no need
- for <code>@media print {</code>  since the style-sheet is used only for printing.</li>
-</ul>
-<h2>Under the hood</h2>
-<p>Both printing and exporting as PDF use the same mechanism: a note is rendered
- individually in a separate webpage that is then sent to the browser or
- the Electron application either for printing or exporting as PDF.</p>
-<p>The webpage that renders a single note can actually be accessed in a web
- browser. For example <code>http://localhost:8080/#root/WWRGzqHUfRln/RRZsE9Al8AIZ?ntxId=0o4fzk</code> becomes <code>http://localhost:8080/?print#root/WWRGzqHUfRln/RRZsE9Al8AIZ</code>.</p>
-<p>Accessing the print note in a web browser allows for easy debugging to
- understand why a particular note doesn't render well. The mechanism for
- rendering is similar to the one used in&nbsp;<a class="reference-link"
- href="#root/_help_0ESUbbAxVnoK">Note List</a>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Printing & Exporting as PDF_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Printing & Exporting as PDF_image.png
deleted file mode 100644
index ee46c2c7b3..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Printing & Exporting as PDF_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Protected Notes.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Protected Notes.html
deleted file mode 100644
index ef77097137..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Protected Notes.html
+++ /dev/null
@@ -1,89 +0,0 @@
-<p>Trilium is designed to store a wide variety of data, including sensitive
- information such as personal journals, credentials, or confidential documents.
- To safeguard this type of content, Trilium offers the option to protect
- notes, which involves the following measures:</p>
-<ul>
- <li><strong>Encryption:</strong> Protected notes are encrypted using a key
- derived from your password. This ensures that without the correct password,
- protected notes remain indecipherable. Even if someone gains access to
- your Trilium <a href="#root/_help_wX4HbRucYSDD">database</a>, they won't
- be able to read your encrypted notes.</li>
- <li><strong>Time-limited access:</strong> To access protected notes, you must
- first enter your password, which decrypts the note for reading and writing.
- However, after a specified period of inactivity (10 minutes by default),
- the note is unloaded from memory, requiring you to re-enter your password
- to access it again.
- <ul>
- <li>The session timeout is extended automatically while you're interacting
- with the protected note, so if you're actively editing, the session remains
- open. However, if you switch to an unprotected note, the session timer
- starts, and the session expires after 10 minutes of inactivity unless you
- return to the protected notes.</li>
- </ul>
- </li>
- <li><strong>Protection scope:</strong> Protected notes ensure the confidentiality
- of their content and partially their integrity. While unauthorized users
- cannot read or edit protected notes, they can still delete or move them
- outside of the protected session.</li>
-</ul>
-<h2>Using Protected Notes</h2>
-<p>By default, notes are unprotected. To protect a note, simply click on
- the shield icon next to the note's title, as shown here:</p>
-<p>
- <img src="Protected Notes_protecting-note.gif" alt="example animation of unlocking protected notes">
-</p>
-<h2>What is Encrypted?</h2>
-<p>Trilium encrypts the data within protected notes but not their metadata.
- Specifically:</p>
-<p><strong>Encrypted:</strong>
-</p>
-<ul>
- <li>Note title</li>
- <li>Note content</li>
- <li>Images</li>
- <li>File attachments</li>
-</ul>
-<p><strong>Not encrypted:</strong>
-</p>
-<ul>
- <li>Note structure (i.e., it remains visible that there are protected notes)</li>
- <li>Metadata, such as the last modified date</li>
- <li><a href="#root/_help_zEY4DaJG4YT5">Attributes</a>
- </li>
-</ul>
-<h2>Encryption Details</h2>
-<p>The following steps outline how encryption and decryption work in Trilium:</p>
-<ol>
- <li>The user enters a password.</li>
- <li>The password is passed through the <a href="https://en.wikipedia.org/wiki/Scrypt">scrypt</a> algorithm
- along with a "password verification" <a href="https://en.wikipedia.org/wiki/Salt_(cryptography)">salt</a> to
- confirm that the password is correct.</li>
- <li>The password is then processed again through scrypt with an "encryption"
- salt, which generates a hash.
- <ul>
- <li>Scrypt is used for <a href="https://en.wikipedia.org/wiki/Key_stretching">key stretching</a> to
- make the password harder to guess.</li>
- </ul>
- </li>
- <li>The generated hash is used to decrypt the actual <em>data encryption key</em>.
- <ul>
- <li>The data encryption key is encrypted using <a href="https://en.wikipedia.org/wiki/Advanced_Encryption_Standard">AES-128</a> with
- a random <a href="https://en.wikipedia.org/wiki/Initialization_vector">IV</a>.</li>
- <li>The data encryption key is randomly generated during the <a href="#root/_help_wX4HbRucYSDD">database</a> initialization
- and remains constant throughout the document’s lifetime. When the password
- is changed, only this key is re-encrypted.</li>
- </ul>
- </li>
- <li>The data encryption key is then used to decrypt the actual content of
- the note, including its title and body.
- <ul>
- <li>The encryption algorithm used is AES-128 with <a href="https://en.wikipedia.org/wiki/Block_cipher_mode_of_operation">CBC mode</a>,
- where a unique IV is generated for each encryption operation and stored
- with the cipher text.</li>
- </ul>
- </li>
-</ol>
-<h2>Sharing Protected Notes</h2>
-<p>Protected notes cannot be shared in the same way as regular notes. Their
- encryption ensures that only authorized users with the correct password
- can access them.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Protected Notes_protecting-note.gif b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Protected Notes_protecting-note.gif
deleted file mode 100644
index 23a6213df4..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Protected Notes_protecting-note.gif and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Read-Only Notes.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Read-Only Notes.html
deleted file mode 100644
index f7e0012518..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Read-Only Notes.html
+++ /dev/null
@@ -1,49 +0,0 @@
-<p>Some note types such as&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>,&nbsp;<a
- class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;notes
- and even some of the&nbsp;<a class="reference-link" href="#root/_help_GTwFsgaA0lCt">Collections</a>&nbsp;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.</p>
-<h2>Automatic read-only mode</h2>
-<p>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.</p>
-<p>This behavior can be disabled on a per-note basis, by following the instructions
- of the next section.</p>
-<p>In addition, it's possible to change the number of characters at which
- the automatic read-only mode will trigger in&nbsp;<a class="reference-link"
- href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;by going to the options
- for&nbsp;<a class="reference-link" href="#root/_hidden/_options/_optionsTextNotes">Text Notes</a>&nbsp;and&nbsp;<a
- class="reference-link" href="#root/_hidden/_options/_optionsCodeNotes">Code Notes</a>.</p>
-<h2>Changing a note's read-only behavior</h2>
-<p>A note's read-only behavior can be changed via&nbsp;<a class="reference-link"
- href="#root/_help_8YBEPzcpUgxw">Note menu</a>&nbsp;→ <em>Editable.</em> The
- following options are possible:</p>
-<ul>
- <li><strong>Auto</strong>
- <br>This is the default behavior in which the note will be editable by default,
- unless it becomes large enough to trigger read-only mode.</li>
- <li><strong>Read-only</strong>
- <br>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.</li>
- <li><strong>Always Editable</strong>
- <br>This option will bypass the automatic read-only activation for this particular
- note. It's useful for large notes that are frequently edited.</li>
-</ul>
-<p>If the <em>Editable</em> section is missing from the&nbsp;<a class="reference-link"
- href="#root/_help_8YBEPzcpUgxw">Note menu</a>, then the note type does
- not support read-only mode.</p>
-<h3>Manually setting the options</h3>
-<p>Apart from using the&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a>&nbsp;as
- previously mentioned, it's also possible to use <a href="#root/_help_zEY4DaJG4YT5">labels</a> to
- change the behavior:</p>
-<ul>
- <li>To set as read-only, apply the <code>readOnly</code> label to the note.</li>
- <li>To disable automatic read-only (always editable), apply the <code>autoReadOnlyDisabled</code> label.</li>
-</ul>
-<h2>Temporarily editing a read-only note</h2>
-<p>When accessing a read-only note, it's possible to temporarily edit it
- pressing the <em>Read-only</em> badge.</p>
-<p>When pressed, the note will become editable but will become read-only
- again after navigating to a different note.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Restoring Deleted Notes.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Restoring Deleted Notes.html
deleted file mode 100644
index 5f71ebaaa4..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Restoring Deleted Notes.html
+++ /dev/null
@@ -1,16 +0,0 @@
-<p>Deleted notes are listed in the <em>Deleted Notes</em> dialog (<a class="reference-link"
- href="#root/_help_x3i7MxGccDuM">Global menu</a> → <em>Show Deleted Notes</em>)
- and can be restored by pressing the <em>undelete</em> link.</p>
-<p>If a note has child notes, they will be restored along with it. Should
- the original location no longer exist (e.g. the parent has been deleted),
- the note will be restored into the default location for new notes (<a class="reference-link"
- href="#root/_help_S0Fos78ZfcY7">Note Inbox</a>).</p>
-<aside class="admonition note">
- <p>When a note is hoisted in the tree, the dialog will only display notes
- deleted from the subtree of that hoisted note.</p>
-</aside>
-<p>To permanently erase deleted notes and clear the list, press the three-dots
- menu and select <em>Erase deleted notes now</em>.</p>
-<p>Deleted notes are permanently erased after a certain amount of time (7
- days by default). To change this interval, press the three-dots menu and
- select <em>Deleted Notes Settings</em>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Save status indicator.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Save status indicator.html
deleted file mode 100644
index 2af2a8ffb8..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Save status indicator.html
+++ /dev/null
@@ -1,18 +0,0 @@
-<p>
- <img class="image-style-align-right" src="Save status indicator_image.png"
- width="168" height="47">To the right of the note title, a temporary indicator appears after making
- a change to the document which shows whether the document has been saved.</p>
-<p>It indicates the following states:</p>
-<ul>
- <li><span class="tn-icon bx bx-pencil"></span>&nbsp;<em>Unsaved</em>, if the
- changes will be saved soon.</li>
- <li><span class="tn-icon bx bx-loader"></span>&nbsp;<em>Saving</em>, if the
- changes are being saved.</li>
- <li><span class="tn-icon bx bx-check"></span>&nbsp;<em>Saved</em>, if all
- the changes were successfully saved to the server.</li>
- <li><span class="tn-icon bx bx-error"></span>&nbsp;<em>Error</em>, if the
- changes could not be saved, for example due to a communication server with
- the server.</li>
-</ul>
-<p>After all changes have been saved, the indicator will hide automatically
- after a few seconds.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Save status indicator_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Save status indicator_image.png
deleted file mode 100644
index efd435a32d..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Save status indicator_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Sorting Notes.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Sorting Notes.html
deleted file mode 100644
index a22d7f3f9f..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Sorting Notes.html
+++ /dev/null
@@ -1,122 +0,0 @@
-<h2>Manual sorting</h2>
-<p>You can sort notes by right-clicking the parent note in the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;and selecting Advanced
- -&gt; Sort notes by ... This will sort existing notes, but will not automatically
- sort future notes added to this parent note.</p>
-<p>The sorting dialog allows:</p>
-<ul>
- <li>Sorting by title, creation or modification date, or by the value of a
- label on the child notes.</li>
- <li>Sorting by several such criteria in turn, each ascending or descending:
- the next level only decides between notes the previous ones left equal.</li>
- <li>Ensuring folders are displayed at the top.</li>
- <li>Natural sort, based on the sorting rules of a particular language.</li>
-</ul>
-<h2>Automatic/Permanent Sorting</h2>
-<p>Child notes can be automatically sorted by attaching specific <a href="#root/_help_zEY4DaJG4YT5">labels</a> to
- the parent note:</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Label</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>#sorted</code>
- </td>
- <td>
- <p>Keeps child notes sorted by title alphabetically.</p>
- <p>When given a value, it will sort by other criteria instead: a comma-separated
- list of levels, each <code>title</code>, <code>dateCreated</code>, <code>dateModified</code> or
- the name of a label on the child notes, optionally followed by <code>asc</code> or <code>desc</code>,
- as in a search's <code>orderBy</code>. For example <code>#sorted="priority desc, dueDate"</code> sorts
- by priority, highest first, and notes of equal priority by due date. A
- child note without a level's label sorts after every child that has it,
- whichever direction the level runs in. When neither note has the label,
- the next level decides.</p>
- </td>
- </tr>
- <tr>
- <td><code>#sortDirection</code>
- </td>
- <td>
- <p>If <code>sorted</code> is applied, specifies the direction of the sort:</p>
- <ul>
- <li><code>ASC</code>, ascending (default)</li>
- <li><code>DESC</code>, descending</li>
- </ul>
- <p>A level of <code>sorted</code> followed by its own <code>asc</code> or <code>desc</code> keeps
- that direction regardless.</p>
- </td>
- </tr>
- <tr>
- <td><code>#sortFoldersFirst</code>
- </td>
- <td>If <code>sorted</code> is applied, folders (notes with children) will be
- sorted as a group at the top (at the bottom when <code>#sortDirection</code> is <code>desc</code>),
- and the rest will be sorted.</td>
- </tr>
- <tr>
- <td><code>#sortNatural</code>
- </td>
- <td>Sort numbers naturally instead of alphabetically, so 2 comes before 10.</td>
- </tr>
- <tr>
- <td><code>#sortLocale</code>
- </td>
- <td>The language code driving the natural sort (e.g. <code>zh-CN</code>, <code>de</code>).
- Only meaningful together with <code>#sortNatural</code>.</td>
- </tr>
- <tr>
- <td><code>#top</code>
- </td>
- <td>If <code>sorted</code> is applied to the parent note, keeps given note on
- top in its parent.</td>
- </tr>
- <tr>
- <td><code>#bottom</code>
- </td>
- <td>If <code>sorted</code> is applied to the parent note, keeps given note on
- bottom in its parent.</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<p>Sorting is done by comparing note properties or specific labels on child
- notes. There are four sorting levels, with the first having the highest
- priority. Lower priority levels are applied only if higher priority comparisons
- result in equality.</p>
-<ol>
- <li><strong>Top Label Sorting</strong>: Child notes with the <code>#top</code> label
- will appear at the top of the folder.</li>
- <li><strong>Bottom Label Sorting</strong>: (Introduced in Trilium 0.62) Child
- notes with the <code>#bottom</code> label will appear at the bottom of the
- folder.</li>
- <li><strong>Property/Label-Based Sorting</strong>: Sorting is based on the
- parent note's <code>#sorted</code> label:
- <ul>
- <li><strong>Default Sorting</strong>: If <code>#sorted</code> has no value,
- notes are sorted alphabetically.</li>
- <li><strong>Property Sorting</strong>: If <code>#sorted</code> is set to <code>title</code>, <code>dateModified</code>,
- or <code>dateCreated</code>, notes are sorted based on the specified property.</li>
- <li><strong>Label Sorting</strong>: If <code>#sorted</code> has any other value,
- this value is treated as the name of a child note's label, and sorting
- is based on the values of this label. For example, setting <code>#sorted=myOrder</code> on
- the parent note and using <code>#myOrder=001</code>, <code>#myOrder=002</code>,
- etc., on child notes.</li>
- <li><strong>Multi-Level Sorting</strong>: Several of the above can be combined,
- separated by commas; each level is applied only where the previous ones
- are equal. Every level can carry its own direction as a word after the
- name, <code>asc</code> or <code>desc</code>, otherwise it follows <code>#sortDirection</code>.
- For example <code>#sorted="priority desc, area, dateCreated"</code> sorts
- by priority, highest first, then by area, then by creation date.</li>
- </ul>
- </li>
- <li><strong>Alphabetical Sorting</strong>: Used as a last resort when other
- criteria result in equality.</li>
-</ol>
-<p>All comparisons are made string-wise (e.g., "1" &lt; "2" or "2020-10-10"
- &lt; "2021-01-15", but also "2" &gt; "10").</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Title.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Title.html
deleted file mode 100644
index 6a7e4d53c2..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Title.html
+++ /dev/null
@@ -1,101 +0,0 @@
-<p>Alongside its content, the <strong>title</strong> is one of the two main
- attributes of a <a href="#root/_help_BFs8mudNFgCS">note</a>. It's the short,
- human-readable name shown in the editable field at the top of every note,
- and it's what identifies the note throughout the interface (in the&nbsp;<a
- class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>, in
- tabs, in the&nbsp;<a class="reference-link" href="#root/_help_I6p2a06hdnL6">Breadcrumb</a>&nbsp;and
- win&nbsp;<a class="reference-link" href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a>.</p>
-<p>Internally, notes are identified by a unique&nbsp;<a class="reference-link"
- href="#root/_help_m1lbrzyKDaRB">Note ID</a>&nbsp;rather than by their title,
- so the title is purely for your benefit. This has a few consequences:</p>
-<ul>
- <li><strong>Titles don't have to be unique.</strong> You can have any number
- of notes that share the same title without conflict.</li>
- <li><strong>Renaming a note never breaks links to it.</strong> Links between
- notes point at the underlying note, so changing a title leaves existing
- links intact (they'll simply display the new title).</li>
- <li><strong>The title can be left empty.</strong> Notes with no title display
- a placeholder (<em>type note's title here…</em>) but are otherwise perfectly
- valid.</li>
-</ul>
-<p>In addition:</p>
-<ul>
- <li>There is no limitation on the length of the title, however in exports
- the title might get trimmed.</li>
- <li>There are no forbidden symbols, unsupported characters will get trimmed
- when exporting.</li>
- <li>When exporting to a ZIP file, a meta file will contain the full title
- which will be recognized by Trilium when importing again.</li>
-</ul>
-<h2>Inline title</h2>
-<p><a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes
- have a special title bar behavior in which the <a href="#root/_help_l7pigIGu01K2">note title</a> is
- initially displayed in a larger font, while also displaying additional
- information such as the creation and the modification date.</p>
-<p>Whenever the title is scrolled past, the fixed title is shown instead.</p>
-<p>Note types that take the entirety of the screen, such as&nbsp;<a class="reference-link"
- href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;and&nbsp;<a class="reference-link"
- href="#root/_help_grjYqerjn243">Canvas</a>, will always have only the fixed
- title bar.</p>
-<p>Under the note title, the&nbsp;<a class="reference-link" href="#root/_help_m3VlURMSeOrd">New note type switcher</a>&nbsp;appears
- if the note is empty.</p>
-<figure class="image">
- <img style="aspect-ratio:899/122;" src="Title_image.png" width="899" height="122">
- <figcaption>The <em>Inline title</em>, which is displayed at the top of the note and
- can be scrolled past.</figcaption>
-</figure>
-<figure class="image">
- <img style="aspect-ratio:910/104;" src="1_Title_image.png" width="910"
- height="104">
- <figcaption>The fixed title bar. The title only appears after scrolling past the <em>Inline title</em>.</figcaption>
-</figure>
-<h3>Editing the title</h3>
-<p>To rename a note, simply click into the title field and type. Changes
- are saved automatically as you type.</p>
-<p>You can also begin editing the title directly from the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;by selecting a note
- and pressing <kbd>Enter</kbd> (see <em>Edit note title</em> in&nbsp;<a class="reference-link"
- href="#root/_help_A9Oc6YKKc65v">Keyboard Shortcuts</a>), which focuses
- the title field for the active note.</p>
-<aside class="admonition note">
- <p>Titles may contain any characters, including Unicode and emoji. For security,
- any HTML in the title is stripped automatically, so the title is always
- treated as plain text.</p>
-</aside>
-<h3>Easily navigating between the title and the content</h3>
-<p>When the cursor is in the title field, pressing <kbd>Enter</kbd> moves focus
- into the note's content. For&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes
- this also inserts a fresh empty paragraph at the very top of the document,
- so you can start writing immediately — much like other note-taking apps.</p>
-<p>This makes it possible to create a note, type its title, press <kbd>Enter</kbd>,
- and continue straight into the body without reaching for the mouse.</p>
-<h3>Working with new notes</h3>
-<p>When you create a new note it's given a default title (<em>new note</em>)
- which is pre-selected, so you can type a name right away to replace it.
- The default title for new notes can be customized per-section — see&nbsp;<a
- class="reference-link" href="#root/_help_47ZrP6FNuoG8">Default Note Title</a>.</p>
-<p>If you decide you don't want the note after all, pressing <kbd>Escape</kbd> while
- the title of a freshly created note is still focused will discard it.</p>
-<h3>Automatically generated titles</h3>
-<p>Some notes get their titles assigned automatically rather than typed:</p>
-<ul>
- <li><strong>Day, week, month and year notes</strong> in the&nbsp;<a class="reference-link"
- href="#root/_help_l0tKav7yLHGF">Day Notes</a>&nbsp;are named from a configurable
- date pattern.</li>
- <li><a class="reference-link" href="#root/_help_m523cpzocqaD">Saved Search</a>&nbsp;notes
- are named after the search they perform.</li>
- <li>When a note is duplicated, a suffix is appended to the copy's title to
- tell it apart from the original.</li>
-</ul>
-<h3>Protected notes</h3>
-<p>For&nbsp;<a class="reference-link" href="#root/_help_bwg0e8ewQMak">Protected Notes</a>,
- the title is <em>not</em> encrypted — only the content is. The title therefore
- remains visible in the tree and tabs even when no protected session is
- active. While locked, however, the title field is read-only and cannot
- be edited until you enter your password.</p>
-<p>The titles of&nbsp;<a class="reference-link" href="#root/_help_bwg0e8ewQMak">Protected Notes</a>&nbsp;are
- encrypted along with their content. Before entering your password, Trilium
- cannot decrypt the title, so it is shown as <code>[protected]</code> in instead
- and the title cannot be modified.</p>
-<p>Once you enter your password and a protected session is active, the real
- title is decrypted and displayed, and becomes editable again.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Title_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Title_image.png
deleted file mode 100644
index 12f5e0d5f0..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Title_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Themes.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Themes.html
deleted file mode 100644
index 85516491f8..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Themes.html
+++ /dev/null
@@ -1,148 +0,0 @@
-<h2>Default Themes</h2>
-<p>Trilium comes with a couple pre-installed color themes, with the default
- being a light theme. To switch to a dark theme or any other available theme,
- navigate to the <span class="tn-icon bx bx-cog"></span> Options menu (accessible
- via the app icon in the top-left corner), select the Appearance tab, and
- choose your preferred theme.</p>
-<p>
- <img src="Themes_dark-theme.png" alt="Dark Theme">
-</p>
-<p>While a dark theme is active, Trilium asks the Dark Reader browser extension
- not to darken the page a second time. Dark Reader still darkens the light
- themes. After switching from a dark theme to a light one, reload the page
- (<kbd>Ctrl</kbd>+<kbd>R</kbd>) for Dark Reader to take effect again.</p>
-<h2>Creating Custom CSS Themes</h2>
-<p>Trilium supports custom user themes, allowing you to personalize the application's
- appearance. To create a custom theme, follow these steps:</p>
-<ol>
- <li><strong>Create a CSS Code Note</strong>: Start by creating a new <a href="#root/_help_6f9hih2hXXZk">code note</a> with
- the <code>CSS</code> type.</li>
- <li><strong>Annotate with</strong> <code>#appTheme</code>: Add the <a href="#root/_help_zEY4DaJG4YT5">attribute</a> <code>#appTheme=my-theme-name</code> to
- your note, where <code>my-theme-name</code> is the name of your custom theme.</li>
- <li><strong>Define Your Styles</strong>: Write your custom CSS within the
- note.</li>
-</ol>
-<details class="trilium-collapsible" open="">
- <summary>Example of a custom theme</summary><pre><code class="language-text-x-trilium-auto">@font-face {
- font-family: 'Raleway';
- font-style: normal;
- font-weight: 400;
- src: url('/custom/fonts/raleway.woff2') format('woff2');
-}
-
-:root {
- --main-font-family: 'Raleway' !important;
- --main-font-size: normal;
- --tree-font-family: inherit;
- --tree-font-size: normal;
- --detail-font-family: inherit;
- --detail-font-size: normal;
- --detail-text-font-family: 'Garamond' !important;
-
- --main-background-color: #404552;
- --main-text-color: #AFB8C6;
- --main-border-color: #AFB8C6;
- --accented-background-color: #383C4A;
- --more-accented-background-color: #2F343F;
- --header-background-color: #383C4A;
- --button-background-color: #2F343F;
- --button-disabled-background-color: #404552;
- --button-border-color: #333;
- --button-text-color: #AFB8C6;
- --button-border-radius: 2px;
- --primary-button-background-color: #6c757d;
- --primary-button-text-color: white;
- --primary-button-border-color: #6c757d;
- --muted-text-color: #86919F;
- --input-text-color: #AFB8C6;
- --input-background-color: #404552;
- --hover-item-text-color: white;
- --hover-item-background-color: #4877B1;
- --active-item-text-color: white;
- --active-item-background-color: #4877B1;
- --menu-text-color: #AFB8C6;
- --menu-background-color: #383C4A;
- --tooltip-background-color: #383C4A;
- --link-color: lightskyblue;
- --modal-background-color: #404552;
- --modal-backdrop-color: black;
- --scrollbar-border-color: rgba(175, 184, 198, 0.5);
-}
-
-body .note-detail-text {
- font-size: 120%;
-}
-
-body .CodeMirror {
- filter: invert(100%) hue-rotate(180deg);
-}</code></pre>
- <p>&nbsp;</p>
-</details>
-<p>&nbsp;</p>
-<h3>Activating Your Custom Theme</h3>
-<p>Once you've created your custom theme:</p>
-<ol>
- <li>Go to "Menu" -&gt; "Options" (<span class="tn-icon bx bx-cog"></span>)
- -&gt; "Appearance."</li>
- <li>In the theme selection dropdown, you should see your custom theme listed
- under the name you provided with the <code>#appTheme</code> <a href="#root/_help_zEY4DaJG4YT5">label</a>.</li>
- <li>Select your custom theme to activate it.</li>
-</ol>
-<p>If you make changes to your theme, press Ctrl + R to reload the frontend
- and apply your updates.</p>
-<h3>Sharing and Importing Themes</h3>
-<p>Custom themes can be exported as <code>.tar</code> archives, which can be
- shared with other users. However, be cautious when importing themes from
- untrusted sources, as they may contain executable scripts that could pose
- security risks.</p>
-<p>An example user theme, <em>Steel Blue</em>, is available in the demo document.</p>
-<p>
- <img src="Themes_steel-blue.png" alt="Steel Blue Theme">
-</p>
-<h3>Using Custom CSS for Specific Purposes</h3>
-<p>In addition to full themes, Trilium allows for custom CSS that isn't tied
- to a theme. This can be particularly useful in scripting contexts, where
- you might want to modify specific UI elements, such as changing the colors
- of notes in the tree view.</p>
-<h3>Applying Custom CSS</h3>
-<p>To use custom CSS:</p>
-<ol>
- <li><strong>Create a CSS Code Note</strong>: Create a new&nbsp;<a class="reference-link"
- href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;note with the <code>CSS</code> type.</li>
- <li><strong>Add the</strong> <code>appCss</code> <strong>Label</strong>: Annotate
- the note with the <code>#appCss</code> <a href="#root/_help_zEY4DaJG4YT5">label</a>.</li>
- <li><strong>Write Your CSS</strong>: Add your custom CSS rules to the note.</li>
-</ol>
-<p>For example:</p><pre><code class="language-text-x-trilium-auto">/* Custom CSS to style specific elements */
-.tree-item {
- color: #ff6347; /* Change tree item color */
-}</code></pre>
-<p>When Trilium's frontend starts, all notes labeled with <code>appCss</code> are
- automatically included in the style element of the HTML page.</p>
-<p>After making changes, press Ctrl + R to reload the frontend and apply
- your new styles.</p>
-<p>
- <img src="Themes_image.png">
-</p>
-<h3>Styling Specific Notes in the Tree</h3>
-<p>To apply specific styles to certain notes in the tree:</p>
-<ul>
- <li><strong>Use the</strong> <code>cssClass</code> <strong>Attribute</strong>:
- Add the <code>cssClass</code> <a href="#root/_help_zEY4DaJG4YT5">attribute</a> to
- a note, and assign it a value representing the desired CSS class.</li>
- <li><strong>Define an</strong> <code>iconClass</code>: You can also define
- a custom icon for a note using the <code>iconClass</code> attribute, selecting
- from <a href="https://boxicons.com">Box Icons</a> or your own custom classes.</li>
-</ul>
-<p>For example, if you want to style notes of a specific type, such as notes
- containing PNG images, you can target them with classes like <code>type-image mime-image-png</code>.</p>
-<h3>User-Provided Themes</h3>
-<p>A gallery of user-created themes is available, showcasing the variety
- of customizations that the Trilium community has developed. For more information,
- check the&nbsp;<a class="reference-link" href="#root/_help_VbjZvtUek0Ln">Theme Gallery</a>.</p>
-<h3>Asset Path Management</h3>
-<p>When referencing built-in assets like images in your custom themes or
- CSS, you can avoid hardcoding version numbers by using the <code>vX</code> alias.
- For example, instead of specifying <code>/assets/v0.57.0-beta/images/icon-grey.png</code>,
- you can use <code>/assets/vX/images/icon-grey.png</code> to keep your theme
- compatible with future versions of Trilium.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Themes/Icon Packs.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Themes/Icon Packs.html
deleted file mode 100644
index 1c7cc1a52b..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Themes/Icon Packs.html
+++ /dev/null
@@ -1,81 +0,0 @@
-<figure class="image image-style-align-right image_resized" style="width:45.14%;">
- <img style="aspect-ratio:854/649;" src="Icon Packs_image.png" width="854"
- height="649">
-</figure>
-<p>By default, Trilium comes with a set of icons called Boxicons v2. Since
- v0.102.0, custom icon packs allow a wider selection of icons for notes.</p>
-<p>Icon packs are specific to Trilium, so they must either be created from
- scratch (see below) or imported from a ZIP file from a third-party developer.</p>
-<h2>Sample icon packs</h2>
-<p>The Trilium team maintains a few icon packs that are not shipped with
- Trilium. These icon packs can be found on the official website on the <a
- href="https://triliumnotes.org/resources">Resources page</a>.</p>
-<h2>Importing an existing icon pack</h2>
-<aside class="admonition note">
- <p><strong>Icon packs are third-party content</strong>
- </p>
- <p>Apart from the <a href="https://triliumnotes.org/resources">sample icon packs</a>,
- the Trilium maintainers are not responsible for keeping icon packs up to
- date. If you have an issue with a specific icon pack, then the issue must
- be reported to the third-party developer responsible for it, not the Trilium
- team.</p>
-</aside>
-<p>To import an icon pack:</p>
-<ol>
- <li>Ideally, create a dedicated spot in your note tree where to place the
- icon packs.</li>
- <li>Right click the note where to put it and select <em>Import into note</em>.</li>
- <li>Uncheck <em>Safe import</em>.</li>
- <li>Select <em>Import</em>.</li>
- <li><a href="#root/_help_s8alTXmpFR61">Refresh the application</a>.</li>
-</ol>
-<aside class="admonition warning">
- <p>Since <em>Safe import</em> is disabled, make sure you trust the source as
- it could contain dangerous third-party scripts. One good way to check if
- the icon pack is safe is to manually extract the .zip and inspect the file
- contents. Icon packs should only contain a font file and a JSON file. Other
- files (especially scripts) are to be considered harmful.</p>
-</aside>
-<h2>Creating an icon pack</h2>
-<p>Creating an icon pack requires some scripting knowledge outside Trilium
- in order to generate the list of icons. For information, see&nbsp;<a class="reference-link"
- href="#root/_help_g1mlRoU8CsqC">Creating an icon pack</a>.</p>
-<h2>Using an icon from an icon pack</h2>
-<p>After <a href="#root/_help_s8alTXmpFR61">refreshing the application</a>,
- the icon pack should be enabled by default. To test this, simply select
- an existing note or create a new one and try to change the note icon.</p>
-<p>There should be a <em>Filter</em> button to the right of the search bar
- in the icon list. Clicking it allows filtering by icon pack and the newly
- imported icon pack should be displayed there.</p>
-<aside class="admonition note">
- <p>If the icon pack is missing from that list, then most likely there's something
- wrong with it.</p>
- <ul>
- <li>Try checking the&nbsp;<a class="reference-link" href="#root/_help_bnyigUA2UK7s">Backend (server) logs</a>&nbsp;for
- clues and make sure that the icon pack has the <code>#iconPack</code> <a
- href="#root/_help_HI6GBBIduIgv">label</a> with a value assigned to it (a
- prefix).</li>
- <li>Icon packs that are <a href="#root/_help_bwg0e8ewQMak">protected</a> are
- ignored.</li>
- </ul>
-</aside>
-<h2>Integration with the share and export functionality</h2>
-<p>Custom icon packs are also supported by the&nbsp;<a class="reference-link"
- href="#root/_help_R9pX4DGra2Vt">Sharing</a>&nbsp;feature, where they will
- be shown in the note tree. However, in order for an icon pack to be visible
- to the share function, the icon pack note must also be shared.</p>
-<p>If you are using a custom share theme, make sure it supports the <code>iconPackCss</code>,
- otherwise icons will not show up. Check the original share template source
- code for reference.</p>
-<p>Custom icon packs will also be preserved when&nbsp;<a class="reference-link"
- href="#root/_help_ycBFjKrrwE9p">Exporting static HTML for web publishing</a>.
- In this case, there's no requirement to make the icon pack shared.</p>
-<h2>What happens if I remove an icon pack</h2>
-<p>If an icon pack is removed or disabled (by removing or altering its <code>#iconPack</code> label),
- all the notes that use this icon pack will show in the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;with no icon. This won't
- cause any issues apart from looking strange.</p>
-<p>The solution is to replace the icons with some else, try using&nbsp;<a
- class="reference-link" href="#root/_help_eIg8jdvaoNNd">Search</a>&nbsp;which
- supports bulk actions, to identify the notes with the now deleted icon
- pack (by looking for the prefix) and changing or removing their <code>iconClass</code>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Themes/Icon Packs_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Themes/Icon Packs_image.png
deleted file mode 100644
index 2730befaa6..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Themes/Icon Packs_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Themes/Personalizing the font.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Themes/Personalizing the font.html
deleted file mode 100644
index 21bb6e4efe..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Themes/Personalizing the font.html
+++ /dev/null
@@ -1,108 +0,0 @@
-<h2>Using different fonts</h2>
-<p>Trilium comes by default with its own font (<em>Inter</em>), but the font
- can be adjusted in&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Appearance</em>,
- by checking <em>Use different fonts</em> in the <em>Fonts</em> section.</p>
-<p>The font can be personalized for the following areas of the application:</p>
-<ul>
- <li>Interface text, for most of the UI (menus, toolbars, dialogs).</li>
- <li><a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>.</li>
- <li>Document text, for the actual content of the notes (especially for&nbsp;<a
- class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes).</li>
- <li>Monospace text, e.g. for&nbsp;<a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;notes
- and&nbsp;<a class="reference-link" href="#root/_help_QxEyIjRBizuC">Code blocks</a>.</li>
-</ul>
-<p>Each area also has its own <em>Size</em>. The note tree and document sizes
- are relative to the interface size, so changing the interface size moves
- them along with it.</p>
-<p>The list of fonts contains the following items:</p>
-<ul>
- <li><strong>Generic fonts</strong>
- <ul>
- <li><em>Theme defined</em> which uses the font that is embedded with the current <a
- href="#root/_help_Wy267RK4M69c">theme</a>. For example on the default modern
- theme, the font is <em>Inter</em>. This does not require the font to be
- installed.</li>
- <li><em>System default</em> which uses a combination of fonts that works best
- for the <a href="#root/_help_poXkQfguuA0U">desktop app</a>. For example
- on Windows it will use <em>Segoe UI</em>.</li>
- <li>Generic font selections for fonts with serifs (e.g. <em>Times New Roman</em>-like),
- no serifs and monospace.</li>
- </ul>
- </li>
- <li><strong>Web fonts</strong> which appear on the&nbsp;<a class="reference-link"
- href="#root/_help_WOcw2SLH6tbX">Server Installation</a>, which is a predefined
- list of fonts and grouped into Sans-serif, serif, monospace and handwriting.
- The fonts that are not supported by your system (i.e. not installed) are
- not displayed.</li>
- <li><strong>System fonts</strong> which appear on the&nbsp;<a class="reference-link"
- href="#root/_help_poXkQfguuA0U">Desktop Installation</a>. Unlike the server
- fonts which are predefined, the system fonts are listed from your operating
- system.</li>
- <li><strong>Custom fonts</strong>, allowing any font to be used provided it's
- imported into Trilium. See the section below for more information.</li>
-</ul>
-<p>Font changes take effect after a reload; the section offers a <em>Reload to apply changes</em> button
- once something has been changed.</p>
-<h2>Custom fonts</h2>
-<p>A font file imported into Trilium can be used by the application itself,
- without writing any CSS.</p>
-<h3>Adding a font</h3>
-<ol>
- <li>Import the font file, by dragging it into the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;or through <em>Import into note</em>.
- TrueType (<code>.ttf</code>), OpenType (<code>.otf</code>) and Web Open
- Font Format (<code>.woff</code>, <code>.woff2</code>) files are recognized;
- the note takes the font's name without its extension and is marked with
- a font icon (an “A” icon).</li>
- <li>Select the resulting note where a preview of a font will be displayed:
- a specimen line to type your own text into, a slider for its size, a preview
- in multiple sizes, and the Latin character set.</li>
- <li>Turn on <em>In font picker</em> above the specimen.</li>
- <li>In&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Appearance</em> → <em>Fonts</em>,
- the font is now offered under <em>Custom fonts</em>, ahead of the built-in
- families, and can be set for any of the four areas.</li>
-</ol>
-<aside class="admonition note">
- <p>Embedded OpenType (<code>.eot</code>) files and TrueType collections (<code>.ttc</code>)
- cannot be drawn by the browser, so they are treated as ordinary files:
- no preview, and no entry in the picker.</p>
-</aside>
-<h3>How custom fonts behave</h3>
-<ul>
- <li>Each entry is named after its note, so renaming the note renames the entry.
- The setting refers to the note itself rather than to its name, and keeps
- working across a rename.</li>
- <li>The font file is an ordinary note, so&nbsp;<a class="reference-link" href="#root/_help_cbkrhQjrkKrh">Synchronization</a>&nbsp;carries
- it to your other devices. The choice of font is not synced: appearance
- settings are deliberately kept per-device, so on another device the font
- is already there and only needs to be selected again.</li>
- <li>A font kept in a <a href="#root/_help_bwg0e8ewQMak">protected note</a> can
- only be previewed and used while the protected session is open.</li>
-</ul>
-<p>For theme authors, a font can also be embedded in a theme's CSS through&nbsp;<a
- class="reference-link" href="#root/_help_d3fAXQ2diepH">Custom Resource Providers</a>,
- which is the route to take when the font should come with the theme rather
- than be chosen in the settings.</p>
-<h3>Downloading from Google Fonts</h3>
-<p>A large selection of fonts can be easily retrieved from Google Fonts,
- as follows:</p>
-<ol>
- <li>Go to <a href="https://fonts.google.com">https://fonts.google.com</a>.</li>
- <li>Search for a desired font.</li>
- <li>Press <em>Get font</em> in the top right.</li>
- <li>Check that the list of fonts on the left side corresponds to your selection.</li>
- <li>Press <em>Download all</em>.</li>
- <li>In the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>,
- create a note where to store the new fonts.</li>
- <li>In the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>,
- drag-and-drop the .zip file directly onto the newly created note and follow
- the steps from the previous section.</li>
-</ol>
-<h2>Programming ligatures</h2>
-<p>Some fonts support programming ligatures, which will turn character combinations
- such as <code>!=</code> into <code>≠</code> or <code>-&gt;</code> as <code>→</code> in&nbsp;<a
- class="reference-link" href="#root/_help_QxEyIjRBizuC">Code blocks</a>&nbsp;and&nbsp;<a
- class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;notes.</p>
-<p>These are only a display affordance, so copying the text is not affected.
- Regardless, this feature can be disabled in Trilium by unchecking <em>Programming ligatures</em> in
- the font settings.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Themes/Theme Gallery.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Themes/Theme Gallery.html
deleted file mode 100644
index a47e642e93..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Themes/Theme Gallery.html
+++ /dev/null
@@ -1,126 +0,0 @@
-<p>These are user-created themes which were made publicly available:</p>
-<h2>Legacy Themes</h2>
-<p>These themes may or may not be compatible with the latest versions of
- TriliumNext and are based on the original/legacy theme.</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Theme</th>
- <th>Author</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><a href="https://github.com/tobealive/trilium-midnight-theme">Midnight</a>
- </td>
- <td><a href="https://github.com/tobealive">tobealive</a>
- </td>
- </tr>
- <tr>
- <td><a href="https://github.com/tobealive/trilum-eote-theme">EOTE</a>
- </td>
- <td><a href="https://github.com/tobealive">tobealive</a>
- </td>
- </tr>
- <tr>
- <td><a href="https://github.com/Abourass/TriliumThemes">Trilium Themes</a>
- </td>
- <td><a href="https://github.com/Abourass">Abourass</a>
- </td>
- </tr>
- <tr>
- <td><a href="https://github.com/ZMonk91/Material-Dark-Trilium">MaterialDark</a>
- </td>
- <td><a href="https://github.com/ZMonk91">ZMonk91</a>
- </td>
- </tr>
- <tr>
- <td><a href="https://github.com/jaroet/trilium-theme-lightslategray">lightslategray</a>
- </td>
- <td><a href="https://github.com/jaroet">jaroet</a>
- </td>
- </tr>
- <tr>
- <td><a href="https://github.com/raphwriter/trilium-theme-melon">melon-4</a>
- </td>
- <td><a href="https://github.com/raphwriter">raphwriter</a>
- </td>
- </tr>
- <tr>
- <td><a href="https://github.com/Engr-AllanG/trilium-themes">Neon_Dark</a>
- </td>
- <td><a href="https://github.com/Engr-AllanG">Engr-AllanG</a>
- </td>
- </tr>
- <tr>
- <td><a href="https://github.com/Engr-AllanG/trilium-themes">Coder_Dark</a>
- </td>
- <td><a href="https://github.com/Engr-AllanG">Engr-AllanG</a>
- </td>
- </tr>
- <tr>
- <td><a href="https://github.com/idelem/trilium-theme-velvet">velvet</a>
- </td>
- <td><a href="https://github.com/idelem">idelem</a>
- </td>
- </tr>
- <tr>
- <td><a href="https://github.com/SADAVA/trilium-notes-theme-dark-plus">Dark Plus</a>
- </td>
- <td><a href="https://github.com/SADAVA">SADAVA</a>
- </td>
- </tr>
- <tr>
- <td><a href="https://github.com/WKSu/trilium-solarized-theme">Solarized</a>
- </td>
- <td><a href="https://github.com/WKSu">WKSu</a>
- </td>
- </tr>
- <tr>
- <td><a href="https://github.com/en3r0/Trilium-Nord-Theme">Nord</a>
- </td>
- <td><a href="https://github.com/en3r0">en3r0</a>
- </td>
- </tr>
- <tr>
- <td><a href="https://github.com/AllanZyne/trilium-bear-theme">Bear Note Light</a>
- </td>
- <td><a href="https://github.com/AllanZyne">AllanZyne</a>
- </td>
- </tr>
- <tr>
- <td><a href="https://github.com/AllanZyne/trilium-bear-theme">Bear Note Dark</a>
- </td>
- <td><a href="https://github.com/AllanZyne">AllanZyne</a>
- </td>
- </tr>
- <tr>
- <td><a href="https://github.com/Sebiann/miku-hatsune-trilium-theme">Miku Hatsune</a>
- </td>
- <td><a href="https://github.com/Sebiann">Sebiann</a>
- </td>
- </tr>
- <tr>
- <td><a href="https://github.com/cwilliams5/Midnight-Trilium-Dark-Mode">Midnight</a>
- </td>
- <td><a href="https://github.com/cwilliams5">cwilliams5</a>
- </td>
- </tr>
- <tr>
- <td><a href="https://github.com/SiriusXT/trilium-theme-blue">Blue</a> (light)</td>
- <td><a href="https://github.com/SiriusXT">SiriusXT</a>
- </td>
- </tr>
- <tr>
- <td><a href="https://github.com/SiriusXT/trilium-theme-blue">Blue</a> (dark)</td>
- <td><a href="https://github.com/SiriusXT">SiriusXT</a>
- </td>
- </tr>
- </tbody>
- </table>
-</figure>
-<aside class="admonition tip">
- <p>If you would like to add your theme to this gallery, write a new post
- in <a href="https://github.com/TriliumNext/Trilium/discussions/categories/show-and-tell">👐 Show and tell</a>.</p>
-</aside>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Themes_dark-theme.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Themes_dark-theme.png
deleted file mode 100644
index 8a3e85714b..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Themes_dark-theme.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Themes_steel-blue.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Themes_steel-blue.png
deleted file mode 100644
index 4a5ed7bdb6..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Themes_steel-blue.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Breadcrumb.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Breadcrumb.html
deleted file mode 100644
index fe9853ef8e..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Breadcrumb.html
+++ /dev/null
@@ -1,55 +0,0 @@
-<figure class="image">
- <img style="aspect-ratio:1150/27;" src="Breadcrumb_image.png" width="1150"
- height="27">
-</figure>
-<p>The breadcrumb allows quickly viewing the note hierarchy of the current
- note and navigating through it.</p>
-<p>It is part of the&nbsp;<a class="reference-link" href="#root/_help_AlJ73vBCjWDw">Status bar</a>,
- displayed in the bottom-left of the screen.</p>
-<h2>Layout and Interaction</h2>
-<ul>
- <li>If a note or workspace is hoisted, a badge will appear on the left-most
- side.
- <ul>
- <li>Clicking on the badge will un-hoist the note/workspace.</li>
- </ul>
- </li>
- <li>The left-most icon represents the root note, or the hoisted note or workspace.
- <ul>
- <li>Clicking the icon will jump to the root note.</li>
- <li>Right clicking the icon will display a menu that allows opening the note
- in a new tab, split, etc.</li>
- </ul>
- </li>
- <li>Each segment shows the title of a note in the current note hierarchy.
- <ul>
- <li>Clicking the icon will jump to that note.</li>
- <li>Right clicking will open a menu with multiple options such as opening
- the note in a different tab/split/window, hoisting, moving/cloning the
- note, duplicating as well as changing the color of the note.</li>
- </ul>
- </li>
- <li>Clicking the arrow next to each segment will reveal the child notes of
- the segment on the left.
- <ul>
- <li>Clicking on an icon will navigate to that particular note.</li>
- <li>It's also possible to create a new child note from here.</li>
- <li>The menu can optionally hide the archived notes.</li>
- </ul>
- </li>
- <li>If the current note is deep within a hierarchy, the segments will collapse
- into a […] button in order not to occupy too much space.
- <ul>
- <li>Clicking this button will display each collapsed entry as a menu item.
- Clicking on it will navigate to that particular note.</li>
- </ul>
- </li>
- <li>Right clicking on an empty space to the right of the breadcrumb (before
- the other status bar items) will reveal another menu that allows:
- <ul>
- <li>Toggling whether archived notes are displayed in the breadcrumb and in
- the note tree.</li>
- <li>Copying the current note path to clipboard.</li>
- </ul>
- </li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Breadcrumb_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Breadcrumb_image.png
deleted file mode 100644
index 4a2f36ae2e..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Breadcrumb_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Content width.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Content width.html
deleted file mode 100644
index eef98ee032..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Content width.html
+++ /dev/null
@@ -1,42 +0,0 @@
-<p>Some note types (such as&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;and
- saved search) intentionally limit the width of the content.</p>
-<p>This might appear surprising at first, but the idea is to make text fit
- well on wider screens without appearing distorted. This is especially the
- case if the document contains&nbsp;<a class="reference-link" href="#root/_help_mT0HEkOsz6i1">Images</a>,
- tables or other width-dependent elements.</p>
-<h2>Configuring the content width and alignment</h2>
-<p>The content width is expressed in pixels and can be changed from&nbsp;<a
- class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Appearance</em> → <em>Content Width</em> and
- adjusting the <em>Max content width</em> section.</p>
-<p>To effectively disable the content width limitation, simply set the width
- to a value larger than your screen size (e.g. 9999).</p>
-<p>By default, the content is aligned to the left, but it can be centered
- horizontally by checking <em>Keep content centered</em> from the same section
- as the content width.</p>
-<h2>Adjusting at note level</h2>
-<p>For notes with large elements such as&nbsp;<a class="reference-link" href="#root/_help_NdowYOC1GFKS">Tables</a>,
- it sometimes makes sense to avoid the content width without affecting other
- notes. To do so:</p>
-<ul>
- <li>Go to&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a>&nbsp;and
- toggle <em>Full width</em>.</li>
- <li>Or manually apply the <code>fullContentWidth</code> <a href="#root/_help_HI6GBBIduIgv">label</a> to
- the note.</li>
-</ul>
-<p>Since v0.107.0, a single table can also be made wider than the content
- width, in which case it scrolls sideways. See&nbsp;<a class="reference-link"
- href="#root/_help_NdowYOC1GFKS">Tables</a>.</p>
-<aside class="admonition note">
- <p>Some <a href="#root/_help_KSZ04uQ2D1St">note types</a> are full width by
- default, such as the&nbsp;<a class="reference-link" href="#root/_help_grjYqerjn243">Canvas</a>.
- In that case the <em>Full width</em> toggle will not be displayed and the
- label will have no effect.</p>
-</aside>
-<h2>Shared notes</h2>
-<p>On a <a href="#root/_help_R9pX4DGra2Vt">shared page</a>, a text note is
- shown at a fixed reading width, whatever the width configured in Options,
- and the navigation tree, the content and the table of contents are kept
- together in a column centered on a wide screen. A note with <code>fullContentWidth</code>,
- or of a type that is full width in the application, uses the whole width
- of the window there, with the navigation tree and the table of contents
- at its edges.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Global menu.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Global menu.html
deleted file mode 100644
index 2d9a809944..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Global menu.html
+++ /dev/null
@@ -1,9 +0,0 @@
-<p>The global menu configures the current window (zoom, keeping the window
- on top) and offers access to some more advanced options.</p>
-<p>
- <img src="Global menu_image.png">
-</p>
-<h2>Accessing the global menu</h2>
-<p>See&nbsp;<a href="#root/_help_x0JgW8UqGXvq">Vertical and horizontal layout</a>&nbsp;since
- the position of the global menu is changed based on which layout has been
- selected.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Launch Bar.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Launch Bar.html
deleted file mode 100644
index aaa7e43c25..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Launch Bar.html
+++ /dev/null
@@ -1,106 +0,0 @@
-<h2>Position of the Launch bar</h2>
-<p>On desktop, depending on the layout selected, the launcher bar will either
- be on the left side of the screen with buttons displayed vertically or
- at the top of the screen. See&nbsp;<a class="reference-link" href="#root/_help_x0JgW8UqGXvq">Vertical and horizontal layout</a>&nbsp;for
- more information.</p>
-<p>On mobile, the launch bar will always be at the bottom.</p>
-<p>If there are too many items in the launch bar to fit the screen, it will
- become scrollable.</p>
-<h2>Terminology</h2>
-<ul>
- <li><strong>Launcher</strong>: a button that can be (or is) displayed on the
- launch bar.</li>
- <li><strong>Available Launcher</strong>: a launcher that is not displayed
- on the launch bar, but can be added.</li>
- <li><strong>Visible Launcher</strong>: a launcher that is currently displayed
- on the launch bar.</li>
-</ul>
-<h2>Configuring the desktop Launch bar</h2>
-<p>There are two ways to configure the launch bar:</p>
-<ul>
- <li>Right click in the empty space between launchers on the launch bar and
- select <em>Configure Launchbar…</em>
- </li>
- <li>Click on the&nbsp;<a class="reference-link" href="#root/_help_x3i7MxGccDuM">Global menu</a>&nbsp;and
- select <em>Configure Launchbar</em>.</li>
-</ul>
-<p>This will open a new tab with the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;listing
- the launchers.</p>
-<p>
- <img src="Launch Bar_image.png">
-</p>
-<p>Expanding <em>Available Launchers</em> section will show the list of launchers
- that are not displayed on the launch bar. The <em>Visible Launchers</em> will
- show the ones that are currently displayed.</p>
-<h2>Configuring the mobile launch bar</h2>
-<p>The launch bar on mobile uses a different configuration from the desktop
- one. The reasoning is that not all desktop icons are available on mobile,
- and fewer icons fit on a mobile screen.</p>
-<p>To configure the launch bar on mobile, go to&nbsp;<a class="reference-link"
- href="#root/_help_x3i7MxGccDuM">Global menu</a>&nbsp;and select <em>Configure Launchbar</em>.</p>
-<p>The configure the mobile launch bar while on the desktop (especially useful
- to configure more complicated launchers such as scripts or custom widgets),
- go to&nbsp;<a class="reference-link" href="#root/_help_x3i7MxGccDuM">Global menu</a>&nbsp;→
- Advanced → Show Hidden Subtree and look for the <em>Mobile Launch Bar</em> section.
- While in the hidden subtree, it's also possible to drag launchers between
- the <em>Mobile Launch Bar</em> and (Desktop) <em>Launch Bar</em> sections.</p>
-<h3>Adding/removing and reordering launchers</h3>
-<p>To display a new launcher in the launch bar, first look for it in the <em>Available Launchers</em> section.
- Then right click it and select <em>Move to visible launchers</em>. It is
- also possible to drag and drop the item manually.</p>
-<p>Similarly, to remove it from the launch bar, simply look for it in <em>Visible Launchers</em> then
- right click it and select <em>Move to available launchers</em> or use drag-and-drop.</p>
-<p>Drag-and-drop the items in the&nbsp;tree&nbsp;in order to change their
- order. See&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;for
- more interaction options, including using keyboard shortcuts.</p>
-<h2>Customizing the launcher</h2>
-<ul>
- <li>The icon of a launcher can be changed just like a normal note. See&nbsp;<a
- href="#root/_help_p9kXRFAkwN4o">note icons</a>&nbsp;for more information.</li>
- <li>The title of the launcher can also be changed.</li>
-</ul>
-<h3>Resetting</h3>
-<p>Resetting allows restoring the original configuration of Trilium for the
- launcher bar, or for a portion of it. Simply right click a launcher (or
- even the entire <em>Launch Bar</em> section) and select <em>Reset</em> to bring
- it back to the original state.</p>
-<h3>Creating new launchers / types of launchers</h3>
-<p>Right click either the <em>Available launchers</em> or <em>Visible launchers</em> sections
- and select one of the options:</p>
-<ol>
- <li>
- <p><strong>Note Launcher</strong>
- <br>A note launcher will simply navigate to a specified note.</p>
- <ol>
- <li>Set the <code>target</code> promoted attribute to the note to navigate to.</li>
- <li>Optionally, set <code>hoistedNote</code> to hoist a particular note. See&nbsp;<a
- class="reference-link" href="#root/_help_OR8WJ7Iz9K4U">Note Hoisting</a>&nbsp;for
- more information.</li>
- <li>Optionally, set a <code>keyboardShortcut</code> to trigger the launcher.</li>
- </ol>
- </li>
- <li>
- <p><strong>Script Launcher</strong>
- <br>An advanced launcher which will run a script upon pressing. See&nbsp;<a
- class="reference-link" href="#root/_help_CdNpE2pqjmI6">Scripting</a>&nbsp;for
- more information.</p>
- <ol>
- <li>Set <code>script</code> to point to the desired script to run.</li>
- <li>Optionally, set a <code>keyboardShortcut</code> to trigger the launcher.</li>
- </ol>
- </li>
- <li>
- <p><strong>Custom Widget</strong>
- </p>
- <p>Allows defining a custom widget to be rendered inside the launcher. See&nbsp;<a
- class="reference-link" href="#root/_help_SynTBQiBsdYJ">Widget Basics</a>&nbsp;for
- more information.</p>
- </li>
- <li>
- <p><strong>Spacers</strong>
- <br>Launchers that create some distance between other launchers for better
- visual distinction.</p>
- </li>
-</ol>
-<p>Launchers are configured via predefined&nbsp;<a class="reference-link"
- href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tooltip.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tooltip.html
deleted file mode 100644
index 3315a9a6ba..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tooltip.html
+++ /dev/null
@@ -1,41 +0,0 @@
-<figure class="image image-style-align-right">
- <img style="aspect-ratio:505/261;" src="Note Tooltip_image.png" width="505"
- height="261">
-</figure>
-<p>The note tooltip is a convenience feature which displays a popup when
- hovering over an <a href="#root/_help_hrZ1D00cLbal">internal link</a> to
- another note.</p>
-<p>The following information is displayed:</p>
-<ul>
- <li>The note path, at the top of the popup.</li>
- <li>The title of the note.
- <ul>
- <li>Clicking on the title will open the note in the current tab.</li>
- <li>Holding <kbd>Ctrl</kbd> pressed while clicking the title will open in a
- new tab instead of the current one.</li>
- </ul>
- </li>
- <li>A snippet of the content will be displayed as well.</li>
- <li>A button to <a href="#root/_help_ZjLYv08Rp3qC">quickly edit</a> the note
- in a popup.</li>
-</ul>
-<p>For a link to an <a href="#root/_help_0vhv7lsOLy82">attachment</a>, the
- tooltip shows the attachment instead: its title after the path of the note
- that owns it, a line giving its size (for example <em>Attachment • 20.59 MiB</em>),
- a preview of its content where one is available, and the quick edit button
- opening the attachment.</p>
-<p>The tooltip can be found in multiple places, including:</p>
-<ul>
- <li>In&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes,
- when hovering over&nbsp;<a class="reference-link" href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a>&nbsp;.</li>
- <li><a class="reference-link" href="#root/_help_GTwFsgaA0lCt">Collections</a>: 
- <ul>
- <li><a class="reference-link" href="#root/_help_81SGnPGMk7Xc">Geo Map View</a>,
- when hovering over a marker.</li>
- <li><a class="reference-link" href="#root/_help_xWbu3jpNWapp">Calendar View</a>,
- when hovering over an event.</li>
- <li><a class="reference-link" href="#root/_help_2FvYrpmOXm29">Table View</a>,
- when hovering over a note title, or over a <a href="#root/_help_Cq5X6iKQop6R">relation</a>.</li>
- </ul>
- </li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tooltip_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tooltip_image.png
deleted file mode 100644
index 049a07d61b..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tooltip_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree.html
deleted file mode 100644
index 527d762277..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree.html
+++ /dev/null
@@ -1,61 +0,0 @@
-<p>This page explains how to manipulate the note tree in TriliumNext, focusing
- on moving notes.</p>
-<p>
- <img src="Note Tree_image.png">
-</p>
-<h2>Drag and Drop</h2>
-<p>
- <img src="Note Tree_drag-and-drop.gif" alt="Drag and drop example">
-</p>
-<p>You can easily rearrange the note tree by dragging and dropping notes,
- as demonstrated in the example above.</p>
-<h3>Importing files</h3>
-<p>A file or archive can easily be imported into Trilium just by dragging
- it inside the note tree.</p>
-<p>Note that a drag &amp; drop always imports with <em>safe import</em> on,
- meaning that some features such as scripts are disabled in the upcoming
- notes. To bypass that, use the dedicated <a href="#root/_help_mHbBMPDPkVV5">import</a> feature
- (right click → <em>Import into note</em>).</p>
-<p>Unlike the import dialog, the drag &amp; drop also has some basic auto-detection
- of the import. For example, dragging a .zip file with a <code>.obsidian</code> folder
- in it will automatically trigger a dedicated&nbsp;<a class="reference-link"
- href="#root/_help_iWD7wiIuMtgV">Obsidian</a>&nbsp;import.</p>
-<h2>Keyboard Manipulation</h2>
-<p>
- <img src="Note Tree_move-note-with-keyboard.gif" alt="Example of using keyboard keys to move a note">Trilium offers efficient keyboard-based manipulation using the following <a
- href="#root/_help_A9Oc6YKKc65v">shortcuts</a>:</p>
-<ul>
- <li><kbd>Ctrl</kbd> + <kbd>↑</kbd> and <kbd>Ctrl</kbd> +<kbd>↓</kbd>: Move the
- note up or down in the order.</li>
- <li><kbd>Ctrl</kbd>+<kbd>←</kbd>: Move the note up in the hierarchy by changing
- its parent to the note's grandparent.</li>
- <li><kbd>Ctrl</kbd>+<kbd>→</kbd>: Move the note down in the hierarchy by setting
- its parent to the note currently above it (this action is best understood
- through a demo or hands-on experience).</li>
- <li><kbd>←</kbd> and <kbd>→</kbd>: Expand and collapse a sub-tree.</li>
-</ul>
-<h2>Context Menu</h2>
-<p>You can also move notes using the familiar cut and paste functions available
- in the context menu, or with the associated keyboard <a href="#root/_help_A9Oc6YKKc65v">shortcuts</a>: <code>CTRL-C</code> ( <a
- href="#root/_help_IakOLONlIfGI">copy</a>), <kbd>Ctrl</kbd> + <kbd>X</kbd> (cut)
- and <kbd>Ctrl</kbd> + <kbd>V</kbd> (paste).</p>
-<p>See&nbsp;<a class="reference-link" href="#root/_help_YtSN43OrfzaA">Note tree contextual menu</a>&nbsp;for
- more information.</p>
-<h2>Tree Settings</h2>
-<p>Click the tree icon in the tree toolbar to open the tree settings popup.
- It contains the following options:</p>
-<ul>
- <li><em>Hide archived notes</em>: When enabled, archived notes are not shown
- in the tree.</li>
- <li><em>Automatically collapse notes</em>: When enabled, notes are collapsed
- after a period of inactivity to keep the tree tidy.</li>
- <li><em>Follow active note</em>: When enabled (default), the tree automatically
- scrolls and expands parent nodes to keep the currently active note visible.
- When disabled, the tree is fully detached from navigation — only the background
- highlight of the active note is updated, but the tree viewport and its
- expanded/collapsed state are never changed by navigation. Use the crosshair
- button to manually jump the tree to the active note at any time.</li>
-</ul>
-<h2>Keyboard shortcuts</h2>
-<p>The note tree comes with multiple keyboard shortcuts to make editing faster,
- consult the dedicated&nbsp;<a class="reference-link" href="#root/_help_DvdZhoQZY9Yd">Keyboard shortcuts</a>&nbsp;section.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/1_Hiding the subtree_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/1_Hiding the subtree_image.png
deleted file mode 100644
index 44f0bbe515..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/1_Hiding the subtree_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/1_Note tree contextual menu_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/1_Note tree contextual menu_image.png
deleted file mode 100644
index cd9f40c1cb..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/1_Note tree contextual menu_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/2_Multiple selection_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/2_Multiple selection_image.png
deleted file mode 100644
index 9ec0a2fdf3..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/2_Multiple selection_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Hiding the subtree.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Hiding the subtree.html
deleted file mode 100644
index feff010f5d..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Hiding the subtree.html
+++ /dev/null
@@ -1,80 +0,0 @@
-<figure class="image image-style-align-right">
- <img style="aspect-ratio:328/45;" src="1_Hiding the subtree_image.png"
- width="328" height="45">
- <figcaption>An example of a collection with a relatively large number of children
- that are hidden from the tree.</figcaption>
-</figure>
-<p>The tree works well when the notes are structured in a hierarchy so that
- the number of items stays small. When a note has a large number of notes
- (in the order of thousands or tens of thousands), two problems arise:</p>
-<ul>
- <li>Navigating between notes becomes cumbersome and the tree itself gets cluttered
- with a large amount of notes.</li>
- <li>The large amount of notes can slow down the application considerably.</li>
-</ul>
-<p>Since v0.102.0, Trilium allows the tree to hide the child notes of particular
- notes. This works for both&nbsp;<a class="reference-link" href="#root/_help_GTwFsgaA0lCt">Collections</a>&nbsp;and
- normal notes.</p>
-<h2>Interaction</h2>
-<p>When the subtree of a note is hidden, there are a few subtle changes:</p>
-<ul>
- <li>To indicate that the subtree is hidden, the note will not have an expand
- button and it will display the number of children to the right.</li>
- <li>It's not possible to add a new note directly from the tree.
- <ul>
- <li>For&nbsp;<a class="reference-link" href="#root/_help_GTwFsgaA0lCt">Collections</a>,
- it's best to use the built-in mechanism to create notes (for example by
- creating a new point on a geo-map, or by adding a new row in a table).</li>
- <li>For normal notes, it's still possible to create children via other means
- such as using the&nbsp;<a class="reference-link" href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a>&nbsp;system.</li>
- </ul>
- </li>
- <li>Notes can be dragged from outside the note, case in which they will be
- cloned into it.
- <ul>
- <li>Instead of switching to the child notes that were copied, the parent note
- is highlighted instead.</li>
- <li>A notification will indicate this behavior.</li>
- </ul>
- </li>
- <li>Similarly, features such as cut/copy and then paste into the note will
- also work.</li>
-</ul>
-<h2>Spotlighting</h2>
-<figure class="image image-style-align-right">
- <img style="aspect-ratio:322/83;" src="Hiding the subtree_image.png" width="322"
- height="83">
-</figure>
-<p>Even if the subtree of a note is hidden, if a child note manages to become
- active, it will still appear inside the tree in a special state called <em>spotlighted</em>.</p>
-<p>During this state, the note remains under its normal hierarchy, so that
- its easy to tell its location. In addition, this means that:</p>
-<ul>
- <li>The note position is clearly visible when using the&nbsp;<a class="reference-link"
- href="#root/_help_eIg8jdvaoNNd">Search</a>.</li>
- <li>The note can still be operated on from the tree, such as adding a&nbsp;<a
- class="reference-link" href="#root/_help_TBwsyfadTA18">Branch prefix</a>&nbsp;or
- moving it outside the collection.</li>
-</ul>
-<p>The note appears in italics to indicate its temporary display. When switching
- to another note, the spotlighted note will disappear.</p>
-<aside class="admonition note">
- <p>Only one note can be highlighted at the time. When working with multiple
- notes such as dragging them into the collection, no note will be spotlighted.
- This is intentional to avoid displaying a partial state of the subtree.</p>
-</aside>
-<h2>Working with collections</h2>
-<p>For large collections, it can be helpful to hide their child notes for
- performance reasons or de-cluttering the tree.</p>
-<p>To toggle this behavior:</p>
-<ul>
- <li>Open the collection and in&nbsp;<a class="reference-link" href="#root/_help_CssoWBu8I7jF">Collection Properties</a>,
- look for <em>Hide child notes in tree</em>.</li>
- <li>Right click the collection note in the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;and select <em>Advanced</em> → <em>Show subtree</em>.</li>
-</ul>
-<h2>Working with normal notes</h2>
-<p>It's possible to hide the subtree for normal notes as well, not just collections.
- To do so, right click the note in the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;and
- select <em>Advanced</em> → <em>Hide subtree.</em>
-</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Hiding the subtree_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Hiding the subtree_image.png
deleted file mode 100644
index 7b75834e96..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Hiding the subtree_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Keyboard shortcuts.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Keyboard shortcuts.html
deleted file mode 100644
index 2d17206499..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Keyboard shortcuts.html
+++ /dev/null
@@ -1,48 +0,0 @@
-<p>The&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;comes
- with multiple keyboard shortcuts to make editing faster:</p>
-<h2>Navigation within the tree</h2>
-<ul>
- <li><kbd><span>↑</span></kbd> and <kbd><span>↑</span></kbd> to navigate between
- notes.</li>
- <li><kbd><span>←</span></kbd> to collapse a note with children, or <kbd><span>→</span></kbd> to
- expand it.</li>
- <li><kbd><span>←</span></kbd> on a note with no children to navigate to its
- parent.</li>
-</ul>
-<h2>Opening notes</h2>
-<ul>
- <li><kbd>Click</kbd> to open the note in the current tab.</li>
- <li><kbd>Ctrl</kbd>+<kbd>Click</kbd> or <kbd>Middle click</kbd> to open the note
- in a new tab.</li>
- <li><kbd>Ctrl</kbd>+<kbd>Right click</kbd> to open the note in&nbsp;<a class="reference-link"
- href="#root/_help_ZjLYv08Rp3qC">Quick edit</a>.</li>
-</ul>
-<h2>Clipboard management</h2>
-<ul>
- <li><kbd>Ctrl</kbd>+<kbd>C</kbd> to copy one or more notes based on selection
- (see&nbsp;<a class="reference-link" href="#root/_help_IakOLONlIfGI">Cloning Notes</a>).</li>
- <li><kbd>Ctrl</kbd>+<kbd>X</kbd> to cut one or more notes (for moving them).</li>
- <li><kbd>Ctrl</kbd>+<kbd>V</kbd> to paste them somewhere (which results in
- a copy or move based on the shortcut used).</li>
-</ul>
-<h2>Moving notes</h2>
-<ul>
- <li><kbd>Ctrl</kbd> + <kbd><span>↑</span></kbd> , <kbd>Ctrl</kbd> + <kbd><span>↓</span></kbd> -
- move note up/down in the note list.</li>
- <li><kbd>Ctrl</kbd> + <kbd><span>←</span></kbd> - move note up in the note tree.</li>
- <li><kbd>Ctrl</kbd>+<kbd><span>→</span></kbd> - move note down in the note
- tree.</li>
- <li><kbd>Del</kbd> - deletes note and optionally its subtree (asked in the
- dialog).</li>
-</ul>
-<h2>Multiple selection</h2>
-<p>See&nbsp;<a class="reference-link" href="#root/_help_yTjUdsOi4CIE">Multiple selection</a>&nbsp;for
- more information about how selection works.</p>
-<ul>
- <li><kbd>Alt</kbd>+<kbd>Click</kbd> – add a single note to the current selection.</li>
- <li><kbd>Shift</kbd>+<kbd>Click</kbd> – select a range of notes, starting from
- the current note (the highlighted one) to the one that is being clicked.</li>
- <li><kbd>Shift</kbd>+<kbd><span>↑</span></kbd>, <kbd>Shift</kbd>+<kbd><span>↓</span></kbd> –
- multi-select not above/below.</li>
- <li><kbd>Ctrl</kbd>+<kbd>A</kbd> – select all notes in the current level</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Multiple selection.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Multiple selection.html
deleted file mode 100644
index 93b71644b8..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Multiple selection.html
+++ /dev/null
@@ -1,45 +0,0 @@
-<p>In the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>,
- it's possible to select multiple notes at one time. This won't affect the
- currently displayed note, but it allows to do batch operations.</p>
-<h2>Types of multiple selection</h2>
-<figure class="image image-style-align-right image_resized" style="width:28.54%;">
- <img style="aspect-ratio:335/306;" src="Multiple selection_image.png"
- width="335" height="306">
-</figure>
-<h3>Selecting notes one by one</h3>
-<p>To individually select each note, press the <kbd>Alt</kbd> key and click
- on the note to be selected.</p>
-<p>The selected notes will be indicated via a different background color
- and an icon.</p>
-<h3>Selecting notes in a sequence</h3>
-<figure class="image image-style-align-right image_resized" style="width:29.24%;">
- <img style="aspect-ratio:233/205;" src="1_Multiple selection_image.png"
- width="233" height="205">
-</figure>
-<p>When notes are in a sequence (e.g. one underneath the other), the entire
- selection can be made just by selecting the first and the last item instead
- of individually clicking all the notes.</p>
-<p>To do so, first select the note to start the selection with. Then hold <kbd>Shift</kbd> and
- click on the note to end the selection with. All the notes between the
- start and the end note will be selected as well.</p>
-<h2>Selected notes vs. active note</h2>
-<p>There is a distinction between <em>selected notes</em> and the <em>active note</em>:</p>
-<ul>
- <li><em>Selected notes</em> are simply the notes that were selected in the
- multiple section process (i.e. either via <kbd>Alt</kbd> or <kbd>Shift</kbd>).</li>
- <li>The <em>active note</em> is simply the note that whose content is being
- displayed to the right of the tree.
- <ul>
- <li>
- <p>Visually, it's identified in the tree by having a different background
- color and a subtle shadow.</p>
- </li>
- <li>
- <p>The active note can also be selected case in which the icon and background
- will also change:</p>
- <img class="image_resized" style="aspect-ratio:317/223;width:35.1%;"
- src="2_Multiple selection_image.png" width="317" height="223">
- </li>
- </ul>
- </li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Multiple selection_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Multiple selection_image.png
deleted file mode 100644
index 569ac2f2c0..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Multiple selection_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Note tree contextual menu.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Note tree contextual menu.html
deleted file mode 100644
index eb3237f831..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Note tree contextual menu.html
+++ /dev/null
@@ -1,262 +0,0 @@
-<figure class="image image-style-align-right">
- <img style="aspect-ratio:269/608;" src="1_Note tree contextual menu_image.png"
- width="269" height="608">
-</figure>
-<p>The <em>note tree menu</em> can be accessed by right-clicking in the&nbsp;<a
- class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>.</p>
-<h2>Interaction</h2>
-<p>The contextual menu can operate:</p>
-<ul>
- <li>On a single note, by right clicking it in the note tree.</li>
- <li>On multiple notes, by selecting them first. See&nbsp;<a class="reference-link"
- href="#root/_help_yTjUdsOi4CIE">Multiple selection</a>&nbsp;on how to do
- so.
- <ul>
- <li>When right clicking, do note that usually the note being right clicked
- is also included in the affected notes, regardless of whether it was selected
- or not.</li>
- </ul>
- </li>
-</ul>
-<h2>Available options</h2>
-<aside class="admonition note">
- <p>When multiple notes are selected, only a subset of notes will be active.
- The ones that do support multiple notes will mention this in the list below.</p>
-</aside>
-<p>The most frequent actions stand side by side at the top of the menu, each
- as an icon over its name. Use <kbd>←</kbd> and <kbd>→</kbd>, or <kbd>↑</kbd> and <kbd>↓</kbd>,
- to move between them.</p>
-<ul>
- <li><strong>Cut</strong>
- <ul>
- <li>Will place the given notes in clipboard.</li>
- <li>Use one of the two paste functions (or the keyboard shortcuts) to move
- them to the desired location.</li>
- </ul>
- </li>
- <li><strong>Clone</strong>
- <ul>
- <li>Will place the given notes in clipboard.</li>
- <li>Use one of the two paste functions (or the keyboard shortcuts) to copy
- them to the desired location.</li>
- <li>Note that the copy function here works according to the <a class="reference-link"
- href="#root/_help_IakOLONlIfGI">Cloning Notes</a> functionality (i.e. the
- note itself will be present in two locations at once, and editing it in
- one place will edit it everywhere).</li>
- <li>To simply create a duplicate note that can be modified independently,
- look for <em>Duplicate</em>.</li>
- </ul>
- </li>
- <li><strong>Paste into</strong>
- <ul>
- <li>Pastes the notes in clipboard as child notes of the right-clicked one.</li>
- <li>Shown only after notes have been cut or cloned.</li>
- </ul>
- </li>
- <li><strong>Paste after</strong>
- <ul>
- <li>Pastes the notes in clipboard underneath the right-clicked one.</li>
- <li>Shown only after notes have been cut or cloned.</li>
- </ul>
- </li>
- <li><strong>Delete…</strong>
- <ul>
- <li>Will delete the given notes, asking for confirmation first.</li>
- <li>In the dialog, the following options can be configured:
- <ul>
- <li><em>Delete also all clones</em> to ensure that the note will be deleted
- everywhere if it has been placed into multiple locations (see <a class="reference-link"
- href="#root/_help_IakOLONlIfGI">Cloning Notes</a>).</li>
- <li><em>Erase notes permanently</em> will ensure that the note cannot be recovered
- from <a class="reference-link" href="#root/_help_r5JGHN99bVKn">Recent Changes</a>.</li>
- </ul>
- </li>
- </ul>
- </li>
-</ul>
-<p>The rest of the menu lists its options one per row:</p>
-<ul>
- <li><strong>Open note</strong>
- <ul>
- <li>Clicking it opens the note in a new <a href="#root/_help_3seOhtN8uLIY">tab</a>.</li>
- <li>Hovering it or clicking its arrow opens a submenu with the places the
- note can be opened in: <em>Open in a new tab</em>, <em>Open in a new split</em> (to
- the right of the note, within the current tab) and <em>Open in a new window</em>.</li>
- </ul>
- </li>
- <li><strong>Quick edit</strong>
- <ul>
- <li>Opens the note in <a class="reference-link" href="#root/_help_ZjLYv08Rp3qC">Quick edit</a>,
- over the current one.</li>
- </ul>
- </li>
- <li><strong>Hoist note</strong>
- <ul>
- <li>Will focus the note tree on this note. See <a class="reference-link" href="#root/_help_OR8WJ7Iz9K4U">Note Hoisting</a> for
- more information.</li>
- </ul>
- </li>
- <li><strong>Insert note after</strong>
- <ul>
- <li>Allows easy creation of a note with a specified <a href="#root/_help_KSZ04uQ2D1St">note type</a>.</li>
- <li>The <em>Code</em> submenu starts with the scripting notes, each a code note
- set up for its role: <em>Custom CSS</em> (with <code>#appCss</code>), <em>Widget</em> (with <code>#widget</code> and
- a starting skeleton) and <em>Backend script</em>. The enabled code languages
- follow.</li>
- <li><a class="reference-link" href="#root/_help_GTwFsgaA0lCt">Collections</a> are
- grouped in the <em>Collection</em> submenu. The note types created less often,
- the <a class="reference-link" href="#root/_help_B2ORr7OVEZtc">Snippets</a> and
- the AI quick action are in the <em>More</em> submenu.</li>
- <li><a class="reference-link" href="#root/_help_KC1HB96bqqHX">Templates</a> will
- also be present (if any) at the end of the list.</li>
- <li>To find an entry quickly, type into the search box at the top of the submenu,
- or just start typing while the submenu is open. The submenu then lists
- every matching entry, including those inside its own submenus (such as
- a code language or a collection), each with the submenu it comes from.
- Use <kbd>↑</kbd> and <kbd>↓</kbd> to pick a match, <kbd>Enter</kbd> to create
- it, and <kbd>Esc</kbd> to clear the search.</li>
- <li>The note will be added on the same level of hierarchy as the note selected.</li>
- </ul>
- </li>
- <li><strong>Insert child note</strong>
- <ul>
- <li>Same as <em>Insert note after</em>, but the note will be created as a child
- of the selected note.</li>
- </ul>
- </li>
- <li><strong>Move to…</strong>
- <ul>
- <li>Will display a modal to specify where to move the desired notes.</li>
- </ul>
- </li>
- <li><strong>Clone to…</strong>
- <ul>
- <li>Will display a modal to specify where to <a href="#root/_help_IakOLONlIfGI">clone</a> the
- desired notes.</li>
- </ul>
- </li>
- <li><strong>Duplicate</strong>
- <ul>
- <li>Creates a copy of the note and its descendants, placed right after the
- original.</li>
- <li>When the note has child notes, the item also has an arrow, set apart by
- a divider. Hovering the item or clicking the arrow opens a submenu:
- <ul>
- <li><em>Note and its children</em> does the same as clicking <em>Duplicate</em>.</li>
- <li><em>This note only</em> copies the note with its content and attributes,
- but without any of its child notes. Links and relations to the original
- children keep pointing at them.</li>
- </ul>
- </li>
- <li>This process is different from <a class="reference-link" href="#root/_help_IakOLONlIfGI">Cloning Notes</a> since
- the duplicated note can be edited independently from the original.</li>
- <li>An alternative to this, if done regularly, would be <a class="reference-link"
- href="#root/_help_KC1HB96bqqHX">Templates</a>.</li>
- </ul>
- </li>
- <li><strong>Archive/Unarchive</strong>
- <ul>
- <li>Marks a note as <a href="#root/_help_MKmLg5x6xkor">archived</a>.</li>
- <li>If the note is already archived, it will be unarchived instead.</li>
- <li>Multiple notes can be selected as well. However, all the selected notes
- must be in the same state (archived or not), otherwise the option will
- be disabled.</li>
- </ul>
- </li>
- <li><strong>Protect subtree/Unprotect subtree</strong>
- <ul>
- <li>On a note that is not protected, <em>Protect subtree</em> marks this note
- and all of its descendants as protected. On a protected note, the item
- reads <em>Unprotect subtree</em> and unprotects them instead. See <a class="reference-link"
- href="#root/_help_bwg0e8ewQMak">Protected Notes</a> for more information.</li>
- <li>Hovering the item or clicking its arrow opens a submenu with both actions,
- for instance to unprotect the protected notes below a note that is not
- protected itself.</li>
- </ul>
- </li>
- <li><strong>Import into note…</strong>
- <ul>
- <li>Opens the <a href="#root/_help_mHbBMPDPkVV5">import</a> dialog and places
- the imported notes as child notes of the selected one.</li>
- </ul>
- </li>
- <li><strong>Export…</strong>
- <ul>
- <li>Opens the <a href="#root/_help_mHbBMPDPkVV5">export</a> dialog for the selected
- notes.</li>
- </ul>
- </li>
- <li><strong>Search in subtree</strong>
- <ul>
- <li>Opens a full&nbsp;<a class="reference-link" href="#root/_help_eIg8jdvaoNNd">Search</a>&nbsp;with
- it preconfigured to only look into this note and its descendants (the <em>Ancestor</em> field).</li>
- </ul>
- </li>
-</ul>
-<h2>Advanced options</h2>
-<figure class="image image-style-align-right">
- <img style="aspect-ratio:231/263;" src="Note tree contextual menu_image.png"
- width="231" height="263">
-</figure>
-<p>The advanced options menu offers some of the less frequently used actions
- for notes.</p>
-<p>To access these options, first look for the <em>Advanced</em> option at
- the bottom of the contextual menu to reveal a sub-menu with:</p>
-<ul>
- <li><strong>Apply bulk actions…</strong>
- <ul>
- <li>Opens the&nbsp;<a class="reference-link" href="#root/_help_ivYnonVFBxbQ">Bulk Actions</a>&nbsp;dialog,
- to apply actions such as adding labels or moving notes to multiple notes
- at once (see&nbsp;<a class="reference-link" href="#root/_help_yTjUdsOi4CIE">Multiple selection</a>).</li>
- </ul>
- </li>
- <li><strong>Edit branch prefix…</strong>
- <ul>
- <li>Opens a dialog to assign a name to be able to distinguish <a href="#root/_help_IakOLONlIfGI">clones</a>,
- see&nbsp;<a class="reference-link" href="#root/_help_TBwsyfadTA18">Branch prefix</a>&nbsp;for
- more information.</li>
- </ul>
- </li>
- <li><strong>Convert to attachment…</strong>
- <ul>
- <li>Converts the selected notes to&nbsp;<a class="reference-link" href="#root/_help_0vhv7lsOLy82">Attachments</a>&nbsp;of
- their parent notes.</li>
- <li>This functional is most useful when dealing with image&nbsp;<a class="reference-link"
- href="#root/_help_W8vYD3Q1zjCR">File</a>&nbsp;notes that were imported
- from an external source or an older version of Trilium.</li>
- </ul>
- </li>
- <li><strong>Expand subtree</strong>
- <ul>
- <li>Expands all the child notes in the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>.</li>
- </ul>
- </li>
- <li><strong>Collapse subtree</strong>
- <ul>
- <li>Collapses all the child notes in the note tree.</li>
- </ul>
- </li>
- <li><strong>Sort by…</strong>
- <ul>
- <li>Opens a dialog to sort all the child notes of the selected note.</li>
- <li>The sorting is done only once, there is an automatic sorting mechanism
- as well that can be set using&nbsp;<a class="reference-link" href="#root/_help_zEY4DaJG4YT5">Attributes</a>.</li>
- <li>See&nbsp;<a class="reference-link" href="#root/_help_aGlEvb9hyDhS">Sorting Notes</a>&nbsp;for
- more information.</li>
- </ul>
- </li>
- <li><strong>Copy note path to clipboard</strong>
- <ul>
- <li>Copies a URL fragment representing the full path to this branch for a
- note, such as <code>#root/Hb2E70L7HPuf/4sRFgMZhYFts/2IVuShedRJ3U/LJVMvKXOFv7n</code>.</li>
- <li>The URL to manually create&nbsp;<a class="reference-link" href="#root/_help_QEAPj01N5f7w">Links</a>&nbsp;within
- notes, or for note&nbsp;<a class="reference-link" href="#root/_help_wArbEsdSae6g">Navigation</a>.</li>
- </ul>
- </li>
- <li><strong>Recent changes in subtree</strong>
- <ul>
- <li>This will open&nbsp;<a class="reference-link" href="#root/_help_r5JGHN99bVKn">Recent Changes</a>,
- but filtered to only the changes related to this note or one of its descendants.</li>
- </ul>
- </li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Note tree contextual menu_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Note tree contextual menu_image.png
deleted file mode 100644
index 51683bdc0f..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Note tree contextual menu_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree_drag-and-drop.gif b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree_drag-and-drop.gif
deleted file mode 100644
index 64cea383fb..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree_drag-and-drop.gif and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree_move-note-with-keyboard.gif b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree_move-note-with-keyboard.gif
deleted file mode 100644
index 4f42279533..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree_move-note-with-keyboard.gif and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note buttons.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note buttons.html
deleted file mode 100644
index e39e01dc50..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note buttons.html
+++ /dev/null
@@ -1,18 +0,0 @@
-<p>The note buttons is an area at the top-right of a note with a few buttons:</p>
-<ul>
- <li>The&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a>&nbsp;which
- offers commands for the note or its subtree, such as import, export, viewing
- the&nbsp;<a href="#root/_help_4FahAwuGTAwC">Note source code</a>&nbsp;or&nbsp;<a
- href="#root/_help_0vhv7lsOLy82">Attachments</a>.</li>
- <li><a class="reference-link" href="#root/_help_luNhaphA37EO">Split View</a>&nbsp;controls
- <ul>
- <li><span class="tn-icon bx bx-dock-right"></span>&nbsp;to open a new split</li>
- <li><span class="tn-icon bx bx-chevron-right"></span>/<span class="tn-icon bx bx-chevron-left"></span> to
- move the pane around</li>
- <li><span class="tn-icon bx bx-x"></span>&nbsp;to close the pane.</li>
- </ul>
- </li>
- <li>On some note types such as&nbsp;<a class="reference-link" href="#root/_help_W8vYD3Q1zjCR">File</a>&nbsp;and
- images, there are dedicated buttons (e.g.&nbsp;<span class="tn-icon bx bx-download"></span> to
- download the file locally).</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note contextual menu.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note contextual menu.html
deleted file mode 100644
index 61141acfbe..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note contextual menu.html
+++ /dev/null
@@ -1,38 +0,0 @@
-<figure class="image image-style-align-right image_resized" style="width:44.65%;">
- <img style="aspect-ratio:514/291;" src="Note contextual menu_image.png"
- width="514" height="291">
-</figure>
-<p>Right-clicking the content of some note types such as&nbsp;<a class="reference-link"
- href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;or&nbsp;<a class="reference-link"
- href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;reveals a contextual menu.</p>
-<h2>Features</h2>
-<ul>
- <li>On the&nbsp;<a class="reference-link" href="#root/_help_poXkQfguuA0U">Desktop Installation</a>,
- the&nbsp;<a class="reference-link" href="#root/_help_oBo3iHIZnbG2">Spell Check</a>&nbsp;suggestions
- are shown when right clicking on a misspelled word.</li>
- <li>The selected text can be searched either with a search engine (configured
- from&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>)
- or <a href="#root/_help_eIg8jdvaoNNd">inside Trilium</a>.</li>
- <li>Basic clipboard functionality (cut, copy, paste).</li>
- <li>Copying the selected text as&nbsp;<a class="reference-link" href="#root/_help_Oau6X9rCuegd">Markdown</a>.</li>
- <li>Performing quick operations using the&nbsp;<a class="reference-link" href="#root/_help_VRoP0g1uHHc2">In-editor AI assistant</a>.</li>
-</ul>
-<h2>Differences between desktop and web</h2>
-<p>The <a href="#root/_help_WOcw2SLH6tbX">web version</a> behaves slightly
- different due to limitations imposed by web browsers:</p>
-<ul>
- <li>When no text is selected or a word is right-clicked, the browser's default
- contextual menu is displayed.
- <ul>
- <li>This is intentional since it preserves the&nbsp;<a class="reference-link"
- href="#root/_help_oBo3iHIZnbG2">Spell Check</a>&nbsp;functionality.</li>
- </ul>
- </li>
- <li>When a text is selected, a reduced menu is displayed instead which features
- only the functionality that is available within the browser version
- <ul>
- <li><em>Paste</em> is not available since the browser doesn't expose it, use <kbd>Ctrl</kbd>+<kbd>V</kbd> instead.</li>
- <li>The browser menu can be triggered anyway by pressing <kbd>Shift</kbd> + <kbd>Right click</kbd>.</li>
- </ul>
- </li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note contextual menu_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note contextual menu_image.png
deleted file mode 100644
index 2c8676ff9e..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note contextual menu_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note menu.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note menu.html
deleted file mode 100644
index 89f8380c7c..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note menu.html
+++ /dev/null
@@ -1,268 +0,0 @@
-<figure class="image image-style-align-right image_resized" style="width:25.95%;">
- <img style="aspect-ratio:402/988;" src="Note menu_image.png" width="402"
- height="988">
-</figure>
-<p>The note menu contains various actions and configurations for the current
- note. It can be found in the&nbsp;<a class="reference-link" href="#root/_help_1P8QXI5edXNd">Note buttons</a>&nbsp;area
- (to the right of the&nbsp;<a class="reference-link" href="#root/_help_l7pigIGu01K2">Title</a>).</p>
-<p>Every split has a note menu of its own, which acts on the note displayed
- in that split. Entries that don't apply to the current note are still listed
- but grayed out, while entries that only exist for some notes (described
- in <em>Note-specific entries</em>) appear only on those notes.</p>
-<h2>Navigating the note</h2>
-<ul>
- <li><span class="tn-icon bx bx-search"></span>&nbsp;<em>Search in note</em> opens
- the&nbsp;<a class="reference-link" href="#root/_help_McngOG2jbUWX">Search in note</a>&nbsp;bar,
- to find and replace text inside the current note. On the desktop application,
- the same bar opens with <kbd>Ctrl</kbd>+<kbd>F</kbd>.
- <ul>
- <li>It is available on&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>,&nbsp;<a
- class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>,&nbsp;<a
- class="reference-link" href="#root/_help_gBbsAeiuUxI5">Mind Map</a>&nbsp;and&nbsp;<a
- class="reference-link" href="#root/_help_GWHEkY4I4OE3">Spreadsheets</a>&nbsp;notes,&nbsp;<a
- class="reference-link" href="#root/_help_GTwFsgaA0lCt">Collections</a>,
- PDF files, and any note displayed as&nbsp;<a class="reference-link" href="#root/_help_4FahAwuGTAwC">Note source</a>.</li>
- </ul>
- </li>
- <li><span class="tn-icon bx bx-paperclip"></span>&nbsp;<em>Note attachments</em> switches
- the note to the list of its&nbsp;<a class="reference-link" href="#root/_help_0vhv7lsOLy82">Attachments</a>,
- where they can be uploaded, opened, downloaded, renamed or deleted.</li>
- <li><span class="tn-icon bx bxs-network-chart"></span>&nbsp;<em>Note map</em> opens
- the&nbsp;<a class="reference-link" href="#root/_help_KRlZFoIH0j6p">Connections tab</a>&nbsp;of
- the&nbsp;<a class="reference-link" href="#root/_help_RnaPdbciOfeq">Right Sidebar</a>,
- which shows the&nbsp;<a class="reference-link" href="#root/_help_BCkXAVs63Ttv">Note Map (Link map, Tree map)</a>&nbsp;centered
- on the current note.</li>
-</ul>
-<h2>Note properties</h2>
-<p>The toggles in this section take effect immediately:</p>
-<ul>
- <li><span class="tn-icon bx bx-share-alt"></span>&nbsp;<em>Shared</em> publishes
- the note via&nbsp;<a class="reference-link" href="#root/_help_R9pX4DGra2Vt">Sharing</a>,
- by cloning it into the <em>Shared Notes</em> tree.
- <ul>
- <li>Turning it off removes the clone from that tree. If the note exists only
- as a shared note, Trilium asks for confirmation, since unsharing it deletes
- it.</li>
- <li>The toggle is unavailable on the root note, on the <em>Shared Notes</em> note
- itself, and on system notes.</li>
- </ul>
- </li>
- <li><span class="tn-icon bx bx-lock-alt"></span>&nbsp;<em>Protect the note</em> encrypts
- the note, turning it into one of the&nbsp;<a class="reference-link" href="#root/_help_bwg0e8ewQMak">Protected Notes</a>.
- If no protected session is active, Trilium asks for the password first.
- Only the current note is affected, not its children.</li>
- <li><span class="tn-icon bx bx-bookmark"></span>&nbsp;<em>Bookmark</em> adds
- the note to the&nbsp;<a class="reference-link" href="#root/_help_u3YFHC9tQlpm">Bookmarks</a>&nbsp;that
- are displayed in the&nbsp;<a class="reference-link" href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>,
- or removes it from them.</li>
- <li><span class="tn-icon bx bx-copy-alt"></span>&nbsp;<em>Template</em> marks
- the note as one of the&nbsp;<a class="reference-link" href="#root/_help_KC1HB96bqqHX">Templates</a>&nbsp;(by
- adding the <code>#template</code> label), which makes it available when creating
- a new note.</li>
- <li><span class="tn-icon bx bx-expand-horizontal"></span>&nbsp;<em>Full width</em> lets
- the note use the whole width of the window instead of the limit set in&nbsp;<a
- class="reference-link" href="#root/_help_t596jLvPrqkS">Content width</a>&nbsp;by
- adding the <code>#fullContentWidth</code> label. It is not listed for note
- types that are always displayed at full width.</li>
-</ul>
-<p>The two submenus in this section:</p>
-<ul>
- <li><span class="tn-icon bx bx-file"></span>&nbsp;<em>Note type</em> changes
- the type of the note to any of the&nbsp;<a class="reference-link" href="#root/_help_KSZ04uQ2D1St">Note Types</a>;
- the current one is checked. If the note already has content, Trilium asks
- for confirmation first, since the content generally doesn't carry over.&nbsp;<a
- class="reference-link" href="#root/_help_jludwdW7N4hg">Converting between note types</a>.
- <ul>
- <li>For a&nbsp;<a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;note,
- the language is chosen in the&nbsp;<a class="reference-link" href="#root/_help_AlJ73vBCjWDw">Status bar</a>&nbsp;instead.</li>
- </ul>
- </li>
- <li><span class="tn-icon bx bx-edit-alt"></span>&nbsp;<em>Editable</em> controls
- when the note opens as read-only (see&nbsp;<a class="reference-link" href="#root/_help_CoFPLs3dRlXc">Read-Only Notes</a>):
- <ul>
- <li><em>Auto</em> (the default): the note is editable, unless it is long enough
- to be opened as read-only automatically.</li>
- <li><em>Read-only</em>: the note always opens as read-only, but can still
- be edited after pressing <em>Edit note</em>.</li>
- <li><em>Always Editable</em>: the note is always editable, regardless of its
- length.</li>
- </ul>
- </li>
-</ul>
-<h2>Importing, exporting and printing</h2>
-<ul>
- <li><span class="tn-icon bx bx-import"></span>&nbsp;<em>Import files</em> opens
- the import dialog, which imports files as children of the current note.
- See&nbsp;<a class="reference-link" href="#root/_help_mHbBMPDPkVV5">Import &amp; Export</a>.
- It is unavailable on&nbsp;<a class="reference-link" href="#root/_help_m523cpzocqaD">Saved Search</a>&nbsp;notes.</li>
- <li><span class="tn-icon bx bx-export"></span>&nbsp;<em>Export note</em> opens
- the export dialog with <em>Only this note</em> selected; select <em>This note &amp; all descendants</em> there
- to export the whole subtree.</li>
- <li><span class="tn-icon bx bx-printer"></span><em>Print note…</em> prints
- the note. On the desktop application this entry reads <em>Print/export to PDF…</em> and
- can also save the note as a PDF file. See&nbsp;<a class="reference-link"
- href="#root/_help_NRnIZmSMc5sj">Printing &amp; Exporting as PDF</a>, including
- which note types and collections can be printed.</li>
-</ul>
-<p>Some note types add their own export formats right below <em>Export note</em>:</p>
-<ul>
- <li><span class="tn-icon bx bxs-file-image"></span><em>Export as image</em>,
- on&nbsp;<a class="reference-link" href="#root/_help_s1aBHPd79XYj">Mermaid Diagrams</a>&nbsp;and&nbsp;<a
- class="reference-link" href="#root/_help_gBbsAeiuUxI5">Mind Map</a>&nbsp;notes,
- downloads the diagram as <em>PNG (raster)</em> or <em>SVG (vector)</em>.</li>
- <li><span class="tn-icon bx bxs-spreadsheet"></span><em>Export to Excel (.xlsx)</em> and <em>Export to CSV (.csv)</em>,
- on&nbsp;<a class="reference-link" href="#root/_help_GWHEkY4I4OE3">Spreadsheets</a>,
- download the spreadsheet in those formats.</li>
-</ul>
-<h2>Revisions</h2>
-<p>These entries manage the&nbsp;<a class="reference-link" href="#root/_help_vZWERwf8U3nx">Note Revisions</a>&nbsp;of
- the note:</p>
-<ul>
- <li><span class="tn-icon bx bx-history"></span><em>Note revisions…</em> opens
- the revisions dialog, where previous versions can be previewed, compared
- with the current one, downloaded or restored.</li>
- <li><span class="tn-icon bx bx-save"></span><em>Save revision</em> saves a
- revision of the note right away, instead of waiting for the next automatic
- snapshot.</li>
- <li><span class="tn-icon bx bx-purchase-tag"></span><em>Save named revision…</em> also
- saves a revision right away, but first asks for a short description of
- the changes, which is shown in the revisions dialog.</li>
-</ul>
-<h2>Note-specific entries</h2>
-<p>The following entries only appear on some notes:</p>
-<ul>
- <li><span class="tn-icon bx bx-pencil"></span><em>Edit note</em> appears at
- the top of the menu when the note is currently read-only. It enables editing
- until the note is closed.</li>
- <li><span class="tn-icon bx bx-align-justify"></span><em>Word wrap</em> appears
- at the top of the menu on&nbsp;<a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;notes,
- and sets whether long lines wrap in this note:
- <ul>
- <li><em>Auto</em> (the default) follows&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Code Notes</em> → <em>Wrap lines in code notes</em>.</li>
- <li><em>On</em> and <em>Off</em> override it for this note only, by setting the <code>#wrapLines</code> label.</li>
- </ul>
- </li>
- <li><span class="tn-icon bx bx-paperclip"></span><em>Convert into attachment</em> appears
- on an image note that has no children and a single parent which is a&nbsp;<a
- class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;note.
- After a confirmation, it turns the image into an attachment of its parent
- note and opens it there. See&nbsp;<a class="reference-link" href="#root/_help_0vhv7lsOLy82">Attachments</a>.</li>
- <li><span class="tn-icon bx bx-extension"></span><em>Re-render note</em> appears
- on a&nbsp;<a class="reference-link" href="#root/_help_HcABDtFCkbFN">Render Note</a>,
- and runs its script again to refresh the output.</li>
- <li><span class="tn-icon bx bx-cog"></span><em>Board properties</em> appears
- on a&nbsp;<a class="reference-link" href="#root/_help_CtBQqbwXDx1w">Kanban Board</a>,
- and configures its columns, card attributes and card templates.</li>
- <li><span class="tn-icon bx bx-cog"></span><em>Calendar properties</em> appears
- on a&nbsp;<a class="reference-link" href="#root/_help_xWbu3jpNWapp">Calendar</a> that
- creates events, and configures its event templates.</li>
- <li><span class="tn-icon bx bx-cog"></span><em>Geo map properties</em> appears
- on a&nbsp;<a class="reference-link" href="#root/_help_81SGnPGMk7Xc">Geo Map</a>,
- and configures its map settings and the image of an <a href="#root/_help_ZRDXGc0nAIh4">image map</a>.</li>
- <li><span class="tn-icon bx bx-cog"></span><em>Table properties</em> appears
- on a <a class="reference-link" href="#root/_help_2FvYrpmOXm29">Table</a>,
- and configures which notes it shows.</li>
-</ul>
-<h2>Advanced</h2>
-<p>The <span class="tn-icon bx bx-wrench"></span><em>Advanced</em> submenu
- groups the actions that are needed less often:</p>
-<ul>
- <li>
- <p><span class="tn-icon bx bx-file-find"></span><em>Open note externally</em> (desktop
- application only) saves the note to a temporary file and opens it in the
- application that the operating system associates with it. Trilium watches
- the file, and offers to upload the modified version back into the note.
- It is unavailable on&nbsp;<a class="reference-link" href="#root/_help_GTwFsgaA0lCt">Collections</a>&nbsp;and&nbsp;<a
- class="reference-link" href="#root/_help_m523cpzocqaD">Saved Search</a>&nbsp;notes.</p>
- </li>
- <li>
- <p><span class="tn-icon bx bx-customize"></span><em>Open note custom</em> (desktop
- application only, Windows and Linux) works like <em>Open note externally</em>,
- but lets you pick the application to open the file with.</p>
- </li>
- <li>
- <p><span class="tn-icon bx bx-code"></span><em>Note source</em> shows the&nbsp;<a
- class="reference-link" href="#root/_help_4FahAwuGTAwC">Note source</a>,
- the content of the note exactly as it is stored.</p>
- </li>
- <li>
- <p><span class="tn-icon bx bxl-markdown"></span><em>Convert to Markdown Note</em> (on
- text notes) and <em>Convert to Text Note</em> (on Markdown notes) switch
- the note between rich text and Markdown. After a confirmation, Trilium
- saves a revision and converts the content; the revision allows going back
- if some formatting was lost. See&nbsp;<a class="reference-link" href="#root/_help_jludwdW7N4hg">Converting between note types</a>.</p>
- </li>
- <li>
- <p><span class="tn-icon bx bx-collapse-alt"></span><em>Compress images</em> opens
- a dialog that reduces the size of the images in the note. It lists the
- images found and how much space they take, and offers to:</p>
- <ul>
- <li>Resize the images larger than a chosen size.</li>
- <li>Keep, or compress, JPEG images.</li>
- <li>Keep, optimize, or convert to JPEG the PNG images.</li>
- <li><em>Process child notes as well</em>, to include the images of the notes
- beneath this one.</li>
- </ul>
- <p>Compressing cannot be undone. Images can also be compressed automatically
- on upload, see&nbsp;<a class="reference-link" href="#root/_help_mT0HEkOsz6i1">Images</a>.</p>
- </li>
- <li>
- <p><span class="tn-icon bx bx-text"></span><em>View OCR text</em> (on image
- and file notes) shows the text extracted from the note via&nbsp;<a class="reference-link"
- href="#root/_help_TiQbQDgP8L5t">Text Extraction (OCR)</a>. If the note
- has not been processed yet, the dialog offers to <em>Process OCR</em>.</p>
- </li>
- <li>
- <p><span class="tn-icon bx bx-world"></span><em>Open note on server</em> (desktop
- application only, listed when&nbsp;<a class="reference-link" href="#root/_help_cbkrhQjrkKrh">Synchronization</a>&nbsp;is
- configured) opens the same note on the sync server, in the web browser.</p>
- </li>
-</ul>
-<h2>Deleting the note</h2>
-<p><span class="tn-icon bx bx-trash"></span><em>Delete note</em> opens the
- deletion dialog for the current note and its subtree. The dialog lists
- the notes that will be deleted and the relations that will be broken, and
- offers to:</p>
-<ul>
- <li>Also delete the other clones of the note, if it is cloned elsewhere. Otherwise,
- only the current placement is removed and the note stays in its other locations.
- See&nbsp;<a class="reference-link" href="#root/_help_IakOLONlIfGI">Cloning Notes</a>.</li>
- <li><em>Erase permanently</em> instead of the usual soft deletion. This cannot
- be undone.</li>
-</ul>
-<p>Notes deleted without erasing can be brought back, see&nbsp;<a class="reference-link"
- href="#root/_help_5Ct4MAJTS4tQ">Restoring Deleted Notes</a>.</p>
-<h2>Limitations</h2>
-<ul>
- <li>The note menu is not available on launchers.</li>
- <li>On the notes of&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;and
- of the in-app help, most entries are grayed out, since these notes cannot
- be imported into, exported, deleted or have revisions.</li>
- <li>The <a href="#note-properties">Note properties</a> section is only listed
- when the note itself is displayed, not its&nbsp;<a class="reference-link"
- href="#root/_help_0vhv7lsOLy82">Attachments</a>&nbsp;or its&nbsp;<a class="reference-link"
- href="#root/_help_4FahAwuGTAwC">Note source</a>.</li>
- <li>In&nbsp;<a class="reference-link" href="#root/_help_ZjLYv08Rp3qC">Quick edit</a>, <em>Search in note</em>, <em>Note map</em>, <em>Full width</em> and <em>Convert into attachment</em> are
- not listed.</li>
-</ul>
-<h2>Mobile support</h2>
-<p>On the&nbsp;<a class="reference-link" href="#root/_help_RDslemsQ6gCp">Mobile Frontend</a>,
- the note menu opens as a sheet from the bottom of the screen. Besides the
- entries above, it contains the items that the desktop layout places elsewhere:</p>
-<ul>
- <li><em>Backlinks</em> and <em>Note paths</em>, at the top, which open the&nbsp;<a
- class="reference-link" href="#root/_help_wfGXLmm7x27z">Backlinks</a>&nbsp;and
- the other locations of the note.</li>
- <li>The custom buttons of the note type (such as <span class="tn-icon bx bx-download"></span><em>Download</em> on
- a&nbsp;<a class="reference-link" href="#root/_help_W8vYD3Q1zjCR">File</a>).</li>
- <li><em>Insert child note</em>, which creates a note under the current one.</li>
- <li><em>Create new split</em> and <em>Close this pane</em>, to manage the&nbsp;<a
- class="reference-link" href="#root/_help_luNhaphA37EO">Split View</a>.</li>
- <li><em>Note attributes</em>, which opens the attributes of the note.</li>
- <li>On&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes,
- the content language (see&nbsp;<a class="reference-link" href="#root/_help_veGu4faJErEM">Content language &amp; Right-to-left support</a>);
- on&nbsp;<a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;notes,
- the language of the code.</li>
- <li><em>Note info</em> and&nbsp;<a class="reference-link" href="#root/_help_xWtq5NUHOwql">Similar Notes</a>.</li>
- <li><em>Note map</em> opens the map in a popup instead of the right sidebar.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note menu_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note menu_image.png
deleted file mode 100644
index d488a0c41a..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note menu_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note types with split view.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note types with split view.html
deleted file mode 100644
index b82781cabb..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note types with split view.html
+++ /dev/null
@@ -1,30 +0,0 @@
-<p>Split view is a feature of&nbsp;<a class="reference-link" href="#root/_help_s1aBHPd79XYj">Mermaid Diagrams</a>&nbsp;and&nbsp;<a
- class="reference-link" href="#root/_help_6RM1Q7ppFVoj">Markdown</a>&nbsp;notes
- which displays both the source code on one side and the preview of the
- content on the other.</p>
-<p><a class="reference-link" href="#root/_help_s1aBHPd79XYj">Mermaid Diagrams</a>&nbsp;also
- allow changing between a horizontal or a vertical split, to accommodate
- for the various sizes of diagrams.</p>
-<h2>Display modes and interaction</h2>
-<p>The split comes with three different display modes which can be toggled
- from the&nbsp;<a class="reference-link" href="#root/_help_1P8QXI5edXNd">Note buttons</a>&nbsp;area:</p>
-<ul>
- <li><span class="tn-icon bx bxs-dock-left"></span>&nbsp;<em>(Split view)</em>,
- in which both the source code is available on one side and can be edited,
- and the preview is available on the other side.
- <ul>
- <li>In this mode, the size of either the source pane or the preview pane can
- be adjusted by dragging the small border between them.</li>
- </ul>
- </li>
- <li><span class="tn-icon bx bx-code"></span>&nbsp;(<em>Source view)</em> which
- shows the source code on the entire screen for a more focused editing experience.</li>
- <li><span class="tn-icon bx bx-show"></span>&nbsp;<em>(Preview)</em> which
- displays only the rendering of the diagram or text in full screen, especially
- useful for read-only notes.</li>
-</ul>
-<p>The display node is stored at note level.</p>
-<h2>Relation to read-only notes</h2>
-<p>If a note is marked as <a href="#root/_help_CoFPLs3dRlXc">read-only</a>,
- the source view will not be editable. While in preview mode, marking a
- note as read-only has no effect since the preview itself is not editable.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Options.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Options.html
deleted file mode 100644
index cb57e4ed69..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Options.html
+++ /dev/null
@@ -1,30 +0,0 @@
-<figure class="image image-style-align-center">
- <img style="aspect-ratio:1189/709;" src="Options_image.png" width="1189"
- height="709">
-</figure>
-<p>The Options section allows the configuration of the TriliumNext client
- and server.</p>
-<h2>Entering options</h2>
-<p>The Options can be accessed via:</p>
-<ul>
- <li>The&nbsp;<a href="#root/_help_x3i7MxGccDuM">Global menu</a>, by selecting
- the <em>Options</em> item.</li>
- <li>The&nbsp;<span class="tn-icon bx bx-cog"></span> button in the&nbsp;<a
- href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>&nbsp;which can optionally
- be hidden if not desirable.</li>
- <li>Optionally, a keyboard shortcut can be defined, but it is not assigned
- by default.</li>
- <li>By clicking on this link:&nbsp;<a class="reference-link" href="#root/_hidden/_options">Options</a>.</li>
-</ul>
-<p>Once in the options section, simply select one of the option categories
- using the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>.</p>
-<h2>Exiting options</h2>
-<p>When entering the options, they are opened in a new <a href="#root/_help_3seOhtN8uLIY">tab</a>.
- To close them, simply close the tab.</p>
-<h2>Options when using sync</h2>
-<p>When using&nbsp;<a class="reference-link" href="#root/_help_cbkrhQjrkKrh">Synchronization</a>,
- some of the options will be kept in sync across all the devices while others
- can be changed independently.</p>
-<p>Generally, the options that relate to appearance are intentionally kept
- not synced in order to allow per-client customization (layout orientation,
- theme, vertical/horizontal layout, code block themes).</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Options_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Options_image.png
deleted file mode 100644
index 1c583ecfa1..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Options_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Recent Changes.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Recent Changes.html
deleted file mode 100644
index 1daf2c4fd0..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Recent Changes.html
+++ /dev/null
@@ -1,29 +0,0 @@
-<figure class="image image-style-align-center image_resized" style="width:50%;">
- <img style="aspect-ratio:988/572;" src="Recent Changes_image.png" width="988"
- height="572">
-</figure>
-<h2>Accessing the recent changes</h2>
-<ul>
- <li>For an overview of the changes across all documents, press the&nbsp;<span
- class="tn-icon bx bx-history"></span> button in the&nbsp;<a class="reference-link"
- href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>.
- <ul>
- <li>If there is a <a href="#root/_help_OR8WJ7Iz9K4U">hoisted note</a> or a <a
- href="#root/_help_9sRHySam5fXb">workspace</a>, the list of recent changes
- will be limited to the descendents of the hoisted note, or the workspace.</li>
- </ul>
- </li>
- <li>To limit the list of recent changes to a note and its descendants, look
- for the corresponding option in the&nbsp;<a class="reference-link" href="#root/_help_YtSN43OrfzaA">Note tree contextual menu</a>&nbsp;→
- Advanced.</li>
-</ul>
-<h2>Interaction</h2>
-<ul>
- <li>Notes which were changed will appear in reverse chronological order (latest
- update first).</li>
- <li>The title of the note is displayed, as well as the note path. Clicking
- on the note title will dismiss the dialog and navigate to that particular
- note.</li>
- <li>Deleted notes will also be listed here, at their time of deletion. Press
- the <em>Undelete</em> link next to them in order to recover them.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Recent Changes_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Recent Changes_image.png
deleted file mode 100644
index 59a29f39d0..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Recent Changes_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar.html
deleted file mode 100644
index 4e9859777f..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar.html
+++ /dev/null
@@ -1,43 +0,0 @@
-<figure class="image">
- <img style="aspect-ratio:1990/1168;" src="Right Sidebar_image.png" width="1990"
- height="1168">
-</figure>
-<p>The right sidebar displays specific content for the current note. The
- sidebar is grouped into multiple tabs:</p>
-<ul>
- <li><a class="reference-link" href="#root/_help_2dcGDhp9WFKb">Outline tab</a>,
- which displays the table of contents, highlights and other navigation-related
- sections depending on the note type.</li>
- <li><a class="reference-link" href="#root/_help_uNtgN0cUKEBc">Attributes tab</a>,
- which provides a visual editor for the current note's&nbsp;<a class="reference-link"
- href="#root/_help_zEY4DaJG4YT5">Attributes</a>.</li>
- <li><a class="reference-link" href="#root/_help_LrKznOtw9cQD">AI chat tab</a>,
- which uses the&nbsp;<a class="reference-link" href="#root/_help_GBBMSlVSOIGP">AI</a>&nbsp;integration
- to chat, with optional access to the current note.</li>
- <li><a class="reference-link" href="#root/_help_KRlZFoIH0j6p">Connections tab</a>,
- which groups together the note map, note paths, backlinks and similar notes.</li>
-</ul>
-<h2>Toggling the right sidebar</h2>
-<p>There are two ways to toggle the right sidebar:</p>
-<ul>
- <li>Via the&nbsp;<span class="tn-icon bx bx-sidebar bx-flip-horizontal"></span> icon
- near the title bar, which toggles whether the sidebar is docked.</li>
- <li>Via the <em>Toggle right pane</em> <a href="#root/_help_A9Oc6YKKc65v">keyboard shortcut</a>,
- which is not assigned by default.</li>
-</ul>
-<h2>Peeking the sidebar</h2>
-<p>There is a small strip near the right edge of the app which shows an arrow
- icon.</p>
-<ul>
- <li>When the sidebar is hidden, pressing the edge will <em>peek</em> the sidebar.
- <ul>
- <li>In this mode the sidebar is shown temporarily above the content, without
- shifting the content of your notes.</li>
- <li>Clicking outside the sidebar while in peek mode will simply hide the sidebar.
- Same goes for the X button and clicking on the right edge.</li>
- <li>Pressing the pin icon will dock the sidebar.</li>
- </ul>
- </li>
- <li>When the sidebar is docked, pressing the edge will hide the sidebar (similar
- to the toggle icon at the top).</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar/1_Outline tab_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar/1_Outline tab_image.png
deleted file mode 100644
index af8f47d658..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar/1_Outline tab_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar/AI chat tab.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar/AI chat tab.html
deleted file mode 100644
index f1ed2fef1b..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar/AI chat tab.html
+++ /dev/null
@@ -1,26 +0,0 @@
-<p>Once the&nbsp;<a class="reference-link" href="#root/_help_GBBMSlVSOIGP">AI</a>&nbsp;integration
- is activated, a <em>Chat</em> entry will appear in the&nbsp;<a class="reference-link"
- href="#root/_help_RnaPdbciOfeq">Right Sidebar</a>.</p>
-<ul>
- <li>Unlike the dedicated note type, the side bar has optional access to the
- current note, making it easy to ask for information or modifications to
- a note without having to search for the note first.
- <ul>
- <li>To toggle whether the current note is visible to the AI, simply click
- on the file icon at the bottom of the chat interface.</li>
- </ul>
- </li>
- <li>On the top-right of the sidebar there are three buttons:
- <ul>
- <li>Create a new conversation.</li>
- <li>Go to a previous conversation</li>
- <li>Save the current conversation as a dedicated note in the&nbsp;<a class="reference-link"
- href="#root/_help_l0tKav7yLHGF">Day Notes</a>, which turns it into a dedicated
- chat note.</li>
- </ul>
- </li>
-</ul>
-<aside class="admonition note">
- <p>The sidebar chats are stored in the&nbsp;<a class="reference-link" href="#root/_help_2mUhVmZK8RF3">Hidden Notes</a>&nbsp;and
- can be seen in the <em>AI Chat History</em> section.</p>
-</aside>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar/Attributes tab.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar/Attributes tab.html
deleted file mode 100644
index 2820100cc4..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar/Attributes tab.html
+++ /dev/null
@@ -1,119 +0,0 @@
-<figure class="image image-style-align-right image_resized" style="width:34.71%;">
- <img style="aspect-ratio:596/1688;" src="Attributes tab_image.png" width="596"
- height="1688">
-</figure>
-<p>The attributes tab provides a more graphical way to view and edit <a href="#root/_help_zEY4DaJG4YT5">attributes</a>.</p>
-<h2>Sections</h2>
-<p>The following information is displayed in sections:</p>
-<ul>
- <li><em>Owned attributes</em>, contains a list of the attributes that belong
- to this note.</li>
- <li><em>Inherited attributes</em> are attributes that apply to the current
- note but come through&nbsp;<a class="reference-link" href="#root/_help_bwZpz2ajCEwO">Attribute Inheritance</a>.</li>
- <li><em>Definitions</em> describe the type of attributes and are used in&nbsp;<a
- class="reference-link" href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;and&nbsp;<a
- class="reference-link" href="#root/_help_2FvYrpmOXm29">Table</a>&nbsp;collections.</li>
-</ul>
-<h2>Owned attributes</h2>
-<p>Every item is structured as such:</p>
-<ul>
- <li>The icon of each item indicates whether it's a <a href="#root/_help_HI6GBBIduIgv">label</a> (<span
- class="tn-icon bx bx-hash"></span>) or a <a href="#root/_help_Cq5X6iKQop6R">relation</a> (<span
- class="tn-icon bx bx-transfer"></span>, link to another note).</li>
- <li>The first text is the name of the label.</li>
- <li>The value of the attribute is displayed after the name, if present.
- <ul>
- <li>The value is shown in a graphical way: a relation's value is a clickable
- note link; a color label shows a color chip.</li>
- </ul>
- </li>
-</ul>
-<p>System attributes (that have a special meaning in Trilium) show a small <span
- class="tn-icon bx bx-cog"></span> cog near the icon and are grouped separately
- from the user-defined ones.</p>
-<p>Interaction:</p>
-<ul>
- <li>Clicking on the item (apart from the value and links) reveals a dedicated
- popup where the name, value and&nbsp;<a class="reference-link" href="#root/_help_bwZpz2ajCEwO">Attribute Inheritance</a>&nbsp;can
- be defined.</li>
- <li>The value of the attributes can be edited in-place:
- <ul>
- <li>The input box follows the type defined in a corresponding label definition
- (date, color, dropdown, numbers), as well as for system attributes that
- have a specific type (e.g. <code>color</code>).</li>
- <li>For labels, clicking on the value edits its in-place.
- <ul>
- <li>Press <kbd>Enter</kbd> to confirm or click outside the input box, or <kbd>Esc</kbd> to
- dismiss.</li>
- <li>For multi-line text, <kbd>Ctrl</kbd>+<kbd>Enter</kbd> confirms whereas <kbd>Enter</kbd> creates
- a newline.</li>
- </ul>
- </li>
- <li>For checkbox attributes, clicking on the checkbox will toggle its state.</li>
- <li>For labels without a value, a value can be added by clicking on the <em>No value</em> text
- which appears while the mouse is hovered on the item.</li>
- <li>For relations, there is a dedicated <span class="tn-icon bx bx-pencil"></span> button
- instead.</li>
- </ul>
- </li>
- <li>An attribute can be deleted by pressing the <span class="tn-icon bx bx-trash"></span> button
- to its right, which only appears while hovered. A confirmation screen is
- displayed first to ensure the attribute is not accidentally deleted.</li>
-</ul>
-<p>Attributes can be added in two ways:</p>
-<ul>
- <li>A new label, relation or attribute definition can be added from the <span
- class="tn-icon bx bx-plus"></span> button near the title of the section.
- This shows the full detail popup.</li>
- <li>To quickly add a label or a relation directly from the sidebar, click
- the <em>Add attribute</em> (<span class="tn-icon bx bx-plus"></span>) item
- at the end of the list.
- <ul>
- <li>The name field will be focused first. By default, a label will be created
- instead but it can be toggled to a relation by typing <kbd>~</kbd> or pressing
- the <span class="tn-icon bx bx-hash"></span> icon (similarly, typing <code>#</code> will
- switch back to a label instead of a relation).</li>
- <li>Once the name is filled, press <kbd>Enter</kbd> to continue to the value.
- Type in a value if desired and then press <kbd>Enter</kbd> again to create
- the attribute.</li>
- <li>Clicking outside the editor will also create the attribute, but only if
- a name is specified.</li>
- </ul>
- </li>
-</ul>
-<h2>Inherited attributes</h2>
-<p>Inherited labels or relations are shown in the same fashion as <em>Owned attributes</em>.</p>
-<p>The only differences are:</p>
-<ul>
- <li>To the right of the inherited attribute there is a link to the note where
- the attribute comes from, as well as an <span class="tn-icon bx bx-sitemap"></span> icon
- to indicate that it's inheritable.</li>
- <li>Clicking on an inherited attribute will reveal the same popup as owned
- attributes, but it is not editable. To edit it, first navigate to the note
- where the attribute is defined.</li>
-</ul>
-<h2>Definitions</h2>
-<p>For attribute definition (see&nbsp;<a class="reference-link" href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>):</p>
-<ul>
- <li>The icon indicates the type of the attribute (text, number).
- <ul>
- <li>If an attribute is promoted, it has a small <span class="tn-icon bx bx-chevron-up"></span> chevron
- icon overlaid on top of it.</li>
- </ul>
- </li>
- <li>The name indicates the name of the attribute it defines (without the <code>label:</code> or <code>relation:</code> prefix).</li>
- <li>To the right of the name a short summary is displayed which indicates
- the display name (alias), whether it has multiple values or an inverse
- relation.</li>
- <li>Clicking on a definition reveals a popup, where the name, type, display
- name and other aspects can be configured.</li>
- <li>A new label or relation definition can be added from the <span class="tn-icon bx bx-plus"></span> button
- near the title of the section.</li>
- <li>For inherited definition, there is a link to the note where the definition
- comes from, as well as an <span class="tn-icon bx bx-sitemap"></span> icon
- to indicate that it's inherited.</li>
-</ul>
-<h2>Mobile</h2>
-<p>The attributes can also be edited visually on mobile, but not as part
- of the sidebar. Go to&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a>&nbsp;and
- select <em>Note attributes</em>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar/Attributes tab_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar/Attributes tab_image.png
deleted file mode 100644
index 603c206b4c..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar/Attributes tab_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar/Connections tab.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar/Connections tab.html
deleted file mode 100644
index d9dbdce1ec..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar/Connections tab.html
+++ /dev/null
@@ -1,61 +0,0 @@
-<figure class="image image-style-align-right image_resized" style="width:33.35%;">
- <img style="aspect-ratio:490/1801;" src="Connections tab_image.png" width="490"
- height="1801">
-</figure>
-<p>The connections tab groups together all the information about the current
- note and how it relates to other notes, in four different sections.</p>
-<aside
-class="admonition note">
- <p>It's generally best to keep only the desired sections expanded as each
- of the sections have to retrieve additional data that might not otherwise
- be needed. While collapsed, the sections do not retrieve any additional
- data.</p>
-</aside>
-<h2>Note map</h2>
-<p>The note map displays a graph which shows the relation between the current
- notes and other notes on the hierarchy. There are two types of visualizations,
- which can be selected from the top-right part of the section:</p>
-<ul>
- <li>The <em>Link map</em> (<span class="tn-icon bx bx-network-chart"></span>),
- which displays the <a href="#root/_help_Cq5X6iKQop6R">relations</a> between
- notes.</li>
- <li>The <em>Tree map</em> (<span class="tn-icon bx bx-sitemap"></span>), which
- displays the hierarchical structure.</li>
-</ul>
-<p>The sidebar will remember which visualization is selected, as a global
- option. Note that note maps also have a <code>#mapType</code> which describes
- which visualization to use, but the sidebar deliberately ignores that to
- keep consistency when switching between notes.</p>
-<p>The map can also be expanded by pressing the <span class="tn-icon bx bx-expand-alt"></span> button
- in the top-right of the section. When expanded, the map is displayed in
- a separate dialog. Alternatively, all other sections can be collapsed,
- which will make the note map taller and the sidebar can be dragged to make
- for more lateral space.</p>
-<p>The note map view inside the sidebar is deliberately more compact in order
- to fit the space: the link map would also show notes that don't have a
- link to the current note from the hierarchy (creating a cloud of dots)
- but this is only shown while the map is expanded. Similarly, the link strength
- and pin configuration buttons are not displayed here.</p>
-<p>See also:</p>
-<ul>
- <li>The&nbsp;<a class="reference-link" href="#root/_help_bdUJEHsAPYQR">Note Map</a>&nbsp;note
- type</li>
- <li><a class="reference-link" href="#root/_help_BCkXAVs63Ttv">Note Map (Link map, Tree map)</a>&nbsp;for
- more information on the concept as a whole.</li>
-</ul>
-<h2>Note paths</h2>
-<p>The note paths section displays the locations in which the current note
- is <a href="#root/_help_IakOLONlIfGI">cloned</a>. Each segment of the note
- path is clickable, in order to navigate to that note or clone. The root
- note is shown as its icon, the same as in the <a class="reference-link"
- href="#root/_help_I6p2a06hdnL6">Breadcrumb</a>; hovering it shows its title.</p>
-<p>A new clone can be created from the <span class="tn-icon bx bx-duplicate"></span> button
- at the top-right.</p>
-<h2>Backlinks</h2>
-<p>Backlinks list the notes that refer to the current note, as well as a
- preview of the content where the reference to the note is made.</p>
-<p>For more information, see&nbsp;<a class="reference-link" href="#root/_help_wfGXLmm7x27z">Backlinks</a>.</p>
-<h2>Similar notes</h2>
-<p>Displays a list of notes that appear similar based on the content of the
- notes and their attributes. For more information, see&nbsp;<a class="reference-link"
- href="#root/_help_xWtq5NUHOwql">Similar Notes</a>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar/Connections tab_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar/Connections tab_image.png
deleted file mode 100644
index 9e336829a3..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar/Connections tab_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar/Outline tab.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar/Outline tab.html
deleted file mode 100644
index aae4c3b3a9..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar/Outline tab.html
+++ /dev/null
@@ -1,111 +0,0 @@
-<p>The Outline tab appears in the&nbsp;<a class="reference-link" href="#root/_help_RnaPdbciOfeq">Right Sidebar</a>&nbsp;and
- displays the headings and highlights for the current note.</p>
-<h2>Table of contents</h2>
-<p>The table of contents displays the titles / headings in the current note
- and allows easy navigation.</p>
-<p>The following note types are supported:</p>
-<ul>
- <li><a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>
- </li>
- <li><a class="reference-link" href="#root/_help_6RM1Q7ppFVoj">Markdown</a>
- </li>
- <li><a class="reference-link" href="#root/_help_XJGJrpu7F9sh">PDFs</a>
- </li>
- <li><a class="reference-link" href="#root/_help_GBBMSlVSOIGP">AI</a>&nbsp;chat
- notes</li>
- <li>The pages of the in-app documentation</li>
-</ul>
-<figure class="image image-style-align-right image_resized" style="width:47%;">
- <img style="aspect-ratio:556/205;" src="1_Outline tab_image.png" width="556"
- height="205">
-</figure>
-<h3>Interaction</h3>
-<ul>
- <li>Clicking on a heading will scroll the document to the position of the
- heading.</li>
- <li>As the document is scrolled, the heading being read is highlighted and
- the list scrolls to keep it in view. If that heading is hidden inside a
- collapsed section, the collapsed heading is highlighted instead.</li>
- <li>Nested items can be collapsed by pressing the corresponding&nbsp;<span
- class="tn-icon bx bx-chevron-down"></span> button.</li>
-</ul>
-<h2>Highlights</h2>
-<figure class="image image-style-align-right image_resized" style="width:46.04%;">
- <img style="aspect-ratio:489/240;" src="Outline tab_image.png" width="489"
- height="240">
-</figure>
-<p>Similar to the&nbsp;table of contents, but instead of headings this feature
- will list highlighted text from a text note and allow easy navigation to
- them.</p>
-<p>Unlike table of contents which supports multiple note types, the highlights
- are specific to the&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes.</p>
-<p>Highlighted text is defined as:</p>
-<ul>
- <li>Bold text.</li>
- <li>Italic text.</li>
- <li>Underlined text.</li>
- <li>Text with a foreground color set.</li>
- <li>Text with a background color/highlight set.</li>
-</ul>
-<h3>Interaction</h3>
-<ul>
- <li>Clicking on a highlighted text will scroll the document to its position.</li>
-</ul>
-<h3>Configuration</h3>
-<ul>
- <li>Globally, it's possible to toggle the display of each category of highlighted
- text (as defined above)&nbsp;
- <ul>
- <li>Pressing the gear button in the top-right part of the section will reveal
- a menu to toggle between the highlight categories.</li>
- <li>Alternatively, they can be changed by going to&nbsp;<a class="reference-link"
- href="#root/_hidden/_options/_optionsTextNotes">Text Notes</a>&nbsp;settings
- and looking for the <em>Highlights List</em> section.</li>
- </ul>
- </li>
-</ul>
-<h2>PDF-specific outline</h2>
-<p>When&nbsp;<a class="reference-link" href="#root/_help_XJGJrpu7F9sh">PDFs</a>&nbsp;are
- opened in Trilium, the&nbsp;<a class="reference-link" href="#root/_help_RnaPdbciOfeq">Right Sidebar</a>&nbsp;is
- augmented with PDF-specific navigation, with the following features:</p>
-<ul>
- <li>Table of contents/outline
- <ul>
- <li>All the headings and “bookmarks” will be displayed hierarchically.</li>
- <li>The heading on the current page is also highlighted (note that it can
- be slightly offset depending on how many headings are on the same page).</li>
- <li>Clicking on a heading will jump to the corresponding position in the PDF.</li>
- </ul>
- </li>
- <li>Pages
- <ul>
- <li>A preview of all the pages with a small thumbnail.</li>
- <li>Clicking on a page will automatically navigate to that page.</li>
- <li>Right-clicking a page and selecting <em>Copy reference</em> copies a link
- that opens the PDF at that page.</li>
- </ul>
- </li>
- <li>Annotations
- <ul>
- <li>Highlight and comment annotations are listed here.</li>
- <li>Right-clicking an annotation and selecting <em>Copy reference</em> copies
- a link that opens the PDF at that annotation.</li>
- </ul>
- </li>
- <li>Attachments
- <ul>
- <li>If the PDF has its own attachments (not to be confused with Trilium's&nbsp;<a
- class="reference-link" href="#root/_help_0vhv7lsOLy82">Attachments</a>),
- they will be displayed in a list.</li>
- <li>Some information such as the name and size of the attachment are displayed.</li>
- <li>It's possible to download the attachment by clicking on the download button.</li>
- </ul>
- </li>
- <li>Layers
- <ul>
- <li>A less common feature, if the PDF has toggle-able layers, these layers
- will be displayed in a list here.</li>
- <li>It's possible to toggle the visibility for each individual layer.</li>
- </ul>
- </li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar/Outline tab_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar/Outline tab_image.png
deleted file mode 100644
index ac66326822..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar/Outline tab_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar_image.png
deleted file mode 100644
index e30ca8cb32..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Right Sidebar_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Split View.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Split View.html
deleted file mode 100644
index 86f255e9d3..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Split View.html
+++ /dev/null
@@ -1,87 +0,0 @@
-<p>In Trilium, is possible to work with two or more notes side-by-side.</p>
-<figure
-class="image image-style-align-center">
- <img style="aspect-ratio:1398/1015;" src="Split View_2_Split View_image.png"
- width="1398" height="1015">
-</figure>
-<h2>Interactions</h2>
-<ul>
- <li>Press the&nbsp;<span class="tn-icon bx bx-dock-right"></span> button to
- the right of a note's title to open a new split to the right of it.
- <ul>
- <li>It is possible to have as many splits as desired, simply press again the
- button.</li>
- <li>Only horizontal splits are possible, vertical or drag &amp; dropping is
- not supported.</li>
- </ul>
- </li>
- <li>When at least one split is open, press the&nbsp;<span class="tn-icon bx bx-x"></span> button
- next to it to close it.</li>
- <li>Use the&nbsp;<span class="tn-icon bx bx-chevron-right"></span> or the&nbsp;<span
- class="tn-icon bx bx-chevron-left"></span> button to move around the splits.</li>
- <li>Creating, closing and moving a split can also be triggered from a <a href="#root/_help_A9Oc6YKKc65v">keyboard shortcut</a> (<em>Create New Split</em>, <em>Close Active Split</em>, <em>Move Split Left</em> and <em>Move Split Right</em>,
- all unassigned by default) or through the <a href="#root/_help_F1r9QtzQLZqm">command palette</a>.</li>
- <li>The focus can be moved from one split to the one next to it with the <em>Focus Split to the Left</em> and <em>Focus Split to the Right</em> actions,
- which stop at either end of the tab instead of continuing into the next
- tab. They are unassigned by default as well.</li>
- <li>Each <a href="#root/_help_3seOhtN8uLIY">tab</a> has its own split view configuration
- (e.g. one tab can have two notes in a split view, whereas the others are
- one-note views).
- <ul>
- <li>The tab's title will indicate all the note titles, in the order of the
- splits from the left to right and separated by a bullet symbol.</li>
- <li>The tab's icon will indicate the icon of the last active split, which
- will be automatically focused when clicking on the tab.</li>
- </ul>
- </li>
-</ul>
-<h2>Splits and the note tree &amp; hoisting</h2>
-<p>Clicking on the content of a split will focus that split. While focused,
- the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;will
- also indicate the note that is being edited.</p>
-<p>It is possible for each of the splits to have their own&nbsp;<a class="reference-link"
- href="#root/_help_OR8WJ7Iz9K4U">Note Hoisting</a>.</p>
-<p>When a new split is created, it will share the same note hoisting as the
- previous one. An easy solution to this is to simply hoist the notes after
- the split is created.</p>
-<p>This is generally quite useful for reorganizing notes from one place to
- the other, by hoisting the old place in the first split and hoisting the
- new place to the second one. This will allow easy cut and paste without
- the tree jumping around from switching between notes.</p>
-<h2>Mobile support</h2>
-<p>Since v0.100.0, it's possible to have a split view on the mobile view
- as well, with the following differences from the desktop version of the
- split:</p>
-<ul>
- <li>On smartphones, the split views are laid out vertically (one on the top
- and one on the bottom), instead of horizontally as on the desktop.</li>
- <li>There can be only one split open per tab.</li>
- <li>It's not possible to resize the two split panes.</li>
- <li>When the keyboard is opened, the active note will be “maximized”, thus
- allowing for more space even when a split is open. When the keyboard is
- closed, the splits become equal in size again.</li>
-</ul>
-<p>Interaction:</p>
-<ul>
- <li>To create a new split, click the three dots button on the right of the
- note title and select <em>Create new split</em>.
- <ul>
- <li>This option will only be available if there is no split already open in
- the current tab.</li>
- </ul>
- </li>
- <li>To close a split, click the three dots button on the right of the note
- title and select <em>Close this pane</em>.
- <ul>
- <li>Note that this option will only be available on the second note in the
- split (the one at the bottom on smartphones, the one on the right on tablets).</li>
- </ul>
- </li>
- <li>When long-pressing a link, a contextual menu will show up with an option
- to <em>Open note in a new split</em>.
- <ul>
- <li>If there's already a split, the option will replace the existing split
- instead.</li>
- </ul>
- </li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Split View_2_Split View_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Split View_2_Split View_image.png
deleted file mode 100644
index 7a74de6a2d..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Split View_2_Split View_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Status bar.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Status bar.html
deleted file mode 100644
index dca838b11c..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Status bar.html
+++ /dev/null
@@ -1,63 +0,0 @@
-<p>The status bar displays information about the current note and allows
- changing settings related to it such as configuring the language or attributes.</p>
-<h2>Layout and interaction</h2>
-<p>On the left side, the&nbsp;<a class="reference-link" href="#root/_help_I6p2a06hdnL6">Breadcrumb</a>&nbsp;is
- displayed which indicates the current note as well as its parent notes
- and allows for quick navigation throughout the hierarchy.</p>
-<p>On the right side, specific sections will show depending on the type of
- the current note.</p>
-<ol>
- <li>For&nbsp;<a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;notes,
- the language mode of the note is indicated (e.g. JavaScript, plain text),
- as well as allowing easy switching to another mode.</li>
- <li>For&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes,
- the content language is displayed and can be changed, thus configuring
- the spell-check and the right-to-left support.
- <ol>
- <li>Note that this applies to the entire note and not the selection, unlike
- some text editors.</li>
- </ol>
- </li>
- <li>If a note is placed in multiple places in the tree (cloned), the number
- of the note paths will be displayed.
- <ol>
- <li>Clicking it opens a popup with the full list of note paths, from which
- the note can also be cloned to a new location. The same list is available
- in the sidebar's&nbsp;<a class="reference-link" href="#root/_help_KRlZFoIH0j6p">Connections tab</a>.</li>
- </ol>
- </li>
- <li>If a note has attachments, their number will be displayed.
- <ol>
- <li>Clicking on it will reveal the list of attachments in a new tab.</li>
- </ol>
- </li>
- <li>If a note is linked from other text notes (backlinks), the number of backlinks
- will be displayed.
- <ol>
- <li>Clicking on it opens a popup with the list of notes that link to this
- note, as well as an excerpt of where the note is referenced. The same list
- is available in the sidebar's&nbsp;<a class="reference-link" href="#root/_help_KRlZFoIH0j6p">Connections tab</a>.</li>
- </ol>
- </li>
-</ol>
-<p>Regardless of note type, the following items will always be displayed
- if there is a note:</p>
-<ol>
- <li>Note info, which displays:
- <ol>
- <li>The creation/modification date of the note.</li>
- <li>The type and MIME of the note.</li>
- <li>The note ID.</li>
- <li>An estimation of the note size of the note itself and its children.</li>
- <li>A button to reveal the Similar notes in the sidebar's&nbsp;<a class="reference-link"
- href="#root/_help_KRlZFoIH0j6p">Connections tab</a>.</li>
- </ol>
- </li>
-</ol>
-<aside class="admonition note">
- <p>When pressing a button which reveals the&nbsp;<a class="reference-link"
- href="#root/_help_RnaPdbciOfeq">Right Sidebar</a>, it has a specific behavior
- if the sidebar is hidden: the sidebar will be peeked instead of docked.
- Regardless the sidebar will be switched to the appropriate tab and the
- corresponding section will be highlighted.</p>
-</aside>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Tabs.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Tabs.html
deleted file mode 100644
index 6ef36ef98f..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Tabs.html
+++ /dev/null
@@ -1,62 +0,0 @@
-<figure class="image image-style-align-center">
- <img style="aspect-ratio:1119/43;" src="Tabs_image.png" width="1119" height="43">
-</figure>
-<p>In Trilium, tabs allow easy switching between notes.</p>
-<h2>Layout</h2>
-<p>Depending on the&nbsp;<a class="reference-link" href="#root/_help_x0JgW8UqGXvq">Vertical and horizontal layout</a>:</p>
-<ul>
- <li>For the vertical layout, the tabs will be placed at the top but to the
- right of the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>.</li>
- <li>For the horizontal layout, the tabs will be placed at the top in full-width,
- above the&nbsp;<a href="#root/_help_oPVyFC7WL2Lp">note tree</a>, allowing
- for more tabs to be comfortably displayed.</li>
-</ul>
-<h2>Interaction</h2>
-<ul>
- <li>To create a new tab, press the&nbsp;<span class="tn-icon bx bx-plus"></span> button
- that is to the right of the last tab.</li>
- <li>To close a tab, press the corresponding&nbsp;<span class="tn-icon bx bx-x"></span> button.</li>
- <li>For multitasking, tabs can be used alongside&nbsp;<a class="reference-link"
- href="#root/_help_luNhaphA37EO">Split View</a>. Each tab can have one or
- more notes, displayed horizontally.</li>
- <li>Tabs can be reordered by drag-and-dropping it into a new position.</li>
- <li>An existing tab can be displayed in a new window by dragging the tab upwards
- or downwards. It is not possible to combine tabs back into another window.</li>
-</ul>
-<h2>Keyboard interaction</h2>
-<p>Since tabs are a commonly used feature, there are multiple keyboard shortcuts
- that can be used:</p>
-<ul>
- <li><kbd>Ctrl</kbd>+<kbd>T</kbd> to open a new tab.</li>
- <li><kbd>Ctrl</kbd>+<kbd>W</kbd> to close the current tab.</li>
- <li><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>T</kbd> to reopen the last closed
- tab.</li>
- <li><kbd>Ctrl</kbd>+<kbd>Tab</kbd> and <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Tab</kbd> to
- go to the next or previous tab.</li>
- <li><kbd>Ctrl</kbd>+<kbd>1</kbd>, <kbd>Ctrl</kbd>+<kbd>2</kbd>, up to <kbd>Ctrl</kbd>+<kbd>9</kbd> to
- activate the first, second and up to ninth tab.</li>
- <li>There is also a shortcut to go to the last tab, but it is not assigned
- a key by default.</li>
-</ul>
-<h2>Mobile</h2>
-<figure class="image image-style-align-right image_resized" style="width:34.12%;">
- <img style="aspect-ratio:1242/2688;" src="Tabs_IMG_1767.PNG" width="1242"
- height="2688">
-</figure>
-<p>Tabs are also supported on the&nbsp;<a class="reference-link" href="#root/_help_RDslemsQ6gCp">Mobile Frontend</a>.</p>
-<p>Since v0.102.0, the tabs are displayed by pressing the dedicated tab switcher
- button in the&nbsp;<a class="reference-link" href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>.
- In this view the tabs are laid out on a grid with a preview of the note
- content.</p>
-<p>The context menu button at the top-right of the popup allows creating
- a new tab, reopening the last closed tab and closing all the tabs.</p>
-<p><a class="reference-link" href="#root/_help_luNhaphA37EO">Split View</a>s
- are also indicated in the tab switcher, with two titles displayed in a
- tab.</p>
-<aside class="admonition note">
- <p>Versions prior to v0.102.0 also supported tabs, but they were displayed
- directly above the&nbsp;<a class="reference-link" href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>.
- The decision to use a more mobile-like tab switcher was taken because the
- original tab bar could not support many tabs at once and the new design
- better aligns with how mobile applications handle tabs.</p>
-</aside>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Tabs_IMG_1767.PNG b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Tabs_IMG_1767.PNG
deleted file mode 100644
index dd5a7ab1e5..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Tabs_IMG_1767.PNG and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Tabs_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Tabs_image.png
deleted file mode 100644
index 3395aab050..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Tabs_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Vertical and horizontal layout.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Vertical and horizontal layout.html
deleted file mode 100644
index 087212fb93..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Vertical and horizontal layout.html
+++ /dev/null
@@ -1,48 +0,0 @@
-<p>Trilium supports two different layouts, based on your preference.</p>
-<h3>Vertical layout</h3>
-<p>The vertical layout is Trilium's original layout:</p>
-<ul>
- <li>The&nbsp;<a class="reference-link" href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>&nbsp;is
- positioned on the left side of the screen, with buttons being laid out
- vertically.</li>
- <li>The tab bar is at the top, but to the right of the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>.</li>
- <li>The&nbsp;<a class="reference-link" href="#root/_help_Ms1nauBra7gq">Quick search</a>&nbsp;is
- at the top of the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>.</li>
- <li>The&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;can
- be collapsed by pressing the&nbsp;<span class="tn-icon bx bx-chevrons-left"></span> button
- at the bottom of the&nbsp;<a class="reference-link" href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>.</li>
- <li>The&nbsp;<a class="reference-link" href="#root/_help_x3i7MxGccDuM">Global menu</a>&nbsp;can
- be accessed via the&nbsp;<span class="tn-icon cke cke-trilium"></span> icon
- at the top of the&nbsp;<a class="reference-link" href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>.</li>
-</ul>
-<p>
- <img src="1_Vertical and horizontal layout_image.png">
-</p>
-<h3>Horizontal layout</h3>
-<p>The horizontal layout is a more traditional layout, since it bears similarity
- with other applications. In this mode:</p>
-<ul>
- <li>The&nbsp;<a class="reference-link" href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>&nbsp;is
- at the top of the screen, with the buttons laid horizontally.</li>
- <li>The tab bar is at the top of the screen, but now covers the entirety of
- the width, allowing for more tabs to be displayed at once.</li>
- <li>The&nbsp;<a class="reference-link" href="#root/_help_Ms1nauBra7gq">Quick search</a>&nbsp;is
- now part of the&nbsp;<a class="reference-link" href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>.
- It can be moved around according to preference and even removed if needed.</li>
- <li>The&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;can
- be collapsed by pressing the small&nbsp;<span class="tn-icon bx bx-sidebar"></span> button
- to the left of the first tab.</li>
- <li>The&nbsp;<a class="reference-link" href="#root/_help_x3i7MxGccDuM">Global menu</a>&nbsp;can
- be accessed via the&nbsp;<span class="tn-icon bx bx-menu"></span> button
- at the end of the&nbsp;<a class="reference-link" href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>.</li>
-</ul>
-<p>
- <img src="Vertical and horizontal layout_image.png">
-</p>
-<h2>Changing the layout</h2>
-<p>Go to&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;and
- look for the <em>Appearance</em> option on the left. Then look for the <em>Layout</em> section,
- where there is the possibility to switch between the two available layouts.</p>
-<p>Clicking an option will immediately apply the selected layout by reloading
- the window.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Zoom.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Zoom.html
deleted file mode 100644
index b056e6fda0..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Zoom.html
+++ /dev/null
@@ -1,8 +0,0 @@
-<p>Zoom applies to the entire UI, including text.</p>
-<p>On the desktop application, use the&nbsp;<a class="reference-link" href="#root/_help_x3i7MxGccDuM">Global menu</a>&nbsp;to
- zoom in/out.</p>
-<p>On both web browser and the desktop, the keyboard shortcuts <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>+</kbd> and <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>-</kbd> can
- be used.</p>
-<h2>Adjusting the text size instead</h2>
-<p>As an alternative to the zoom, the text size can be individually adjusted
- by going to&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Appearance</em>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Zen mode.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Zen mode.html
deleted file mode 100644
index 18e7154026..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Zen mode.html
+++ /dev/null
@@ -1,47 +0,0 @@
-<p>
- <img src="2_Zen mode_image.png">
-</p>
-<p>Screenshot of Zen Mode activated on a Windows 11 system with native title
- bar off and background effects on.</p>
-<p>When Zen Mode is activated (pictured on the side), most of the user interface
- of Trilium is hidden away in order to be able to focus on the content,
- whether it's for reading or writing.</p>
-<p>
- <img src="1_Zen mode_image.png">
-</p>
-<p>Screenshot of the Zen Mode option in the global menu.</p>
-<h2>Activating &amp; deactivating</h2>
-<p>The Zen Mode can be activated by accessing the global menu and selecting
- the “Zen Mode” option:</p>
-<p>Aside from the global menu, it's also possible to activate this mode by
- using a keyboard shortcut (which is <kbd>F9</kbd> since TriliumNext 0.92.5
- and <kbd>Alt</kbd>+<kbd>Z</kbd> for older versions). Look for <code>toggleZenMode</code> in
- the shortcut configuration.</p>
-<p>Once Zen Mode is activated, all the UI elements of the application will
- be hidden away, including the global menu. In that case, the Zen Mode can
- be deactivated either by pressing the&nbsp;<span class="tn-icon bx bxs-yin-yang"></span> icon
- in the top-right corner of the window or by pressing the keyboard combination
- again.</p>
-<p>Do note that, by design, activating or deactivating the Zen Mode applies
- only to the current window. Restarting the application will also disable
- the Zen Mode.</p>
-<h2>Moving the window around</h2>
-<p>If “Native title bar” is activated, then the operating system's default
- title bar can be used to drag the window around. If deactivated, the window
- can still be moved by dragging the mouse across the top part of the window
- where the note titles are.</p>
-<p>
- <img src="Zen mode_image.png">
-</p>
-<p>Screenshot of two notes side-by-side while Zen Mode is active, on Windows
- 11 with background effects off.</p>
-<h2>Split windows and tabs</h2>
-<p>Tabs are completely hidden, however it's still possible to use keyboard
- shortcuts such as <code>firstTab</code> (<kbd>Ctrl</kbd>+<kbd>1</kbd> by default), <code>secondTab</code> (<kbd>Ctrl</kbd>+<kbd>2</kbd> by
- default). There are also some newer shortcuts such as <code>activateNextTab</code> (<kbd>Ctrl</kbd>+<kbd>Tab</kbd>)
- or <code>activatePreviousTab</code> (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Tab</kbd>)
- that allow easy navigation, however make sure that they are configured
- properly in the settings.</p>
-<p>For the split view of notes, there are no keyboard shortcuts at the time
- of writing, but it's still possible to have them in Zen Mode by creating
- the split while the Zen Mode is off and then reactivating it afterwards.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Zen mode_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Zen mode_image.png
deleted file mode 100644
index 347ade3a25..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Zen mode_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections.html
deleted file mode 100644
index eed3df318d..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections.html
+++ /dev/null
@@ -1,162 +0,0 @@
-<p>Collections are a unique type of note that don't have content, but instead
- display their child notes in various presentation methods.</p>
-<h2>Main collections</h2>
-<div class="trilium-tabs">
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bx-calendar"></span>&nbsp;Calendar</p>
- <div class="trilium-tab-panel">
- <p><a class="reference-link" href="#root/_help_xWbu3jpNWapp">Calendar</a>&nbsp;displays
- a week, month or year calendar with the notes being shown as events. New
- events can be added easily by dragging across the calendar.</p>
- <figure
- class="image">
- <img style="aspect-ratio:1651/810;" src="Collections_collection_calendar.webp"
- width="1651" height="810">
- </figure>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bx-table"></span>&nbsp;Table</p>
- <div class="trilium-tab-panel">
- <p><a class="reference-link" href="#root/_help_2FvYrpmOXm29">Table</a>&nbsp;displays
- each note as a row in a table, with&nbsp;<a class="reference-link" href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;being
- shown as well. This makes it easy to visualize attributes of notes, as
- well as making them easily editable.</p>
- <figure class="image">
- <img style="aspect-ratio:1643/647;" src="Collections_collection_table.webp"
- width="1643" height="647">
- </figure>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bx-columns"></span>&nbsp;Kanban Board</p>
- <div
- class="trilium-tab-panel">
- <p><a class="reference-link" href="#root/_help_CtBQqbwXDx1w">Kanban Board</a>&nbsp;displays
- notes in columns, grouped by the value of a label. Items and columns can
- easily be created or dragged around to change their status.</p>
- <figure
- class="image">
- <img style="aspect-ratio:1174/850;" src="Collections_collection_board.webp"
- width="1174" height="850">
- </figure>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bx-map-alt"></span>&nbsp;Geo Map</p>
- <div class="trilium-tab-panel">
- <p><a class="reference-link" href="#root/_help_81SGnPGMk7Xc">Geo Map</a>&nbsp;which
- displays a geographical map in which the notes are represented as pins
- on the map. New markers can be easily added by pointing on the map. In
- addition <a href="#root/_help_C2H9HK4BzwG7">shapes</a> such as paths, rectangles
- and circles can be added, as well as GPX tracks.</p>
- <figure class="image">
- <img style="aspect-ratio:844/639;" src="Collections_collection_geomap.webp"
- width="844" height="639">
- </figure>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bx-slideshow"></span>&nbsp;Presentation</p>
- <div
- class="trilium-tab-panel">
- <p><a class="reference-link" href="#root/_help_zP3PMqaG71Ct">Presentation</a>&nbsp;which
- shows each note as a slide and can be presented full-screen with smooth
- transitions or exported to PDF for sharing.</p>
- <figure class="image">
- <img style="aspect-ratio:1120/763;" src="Collections_collection_presentation.webp"
- width="1120" height="763">
- </figure>
- </div>
- </section>
-</div>
-<h2>Classic collections</h2>
-<p>Classic collections are read-only mode and compiles the contents of all
- child notes into one continuous view. This makes it ideal for reading extensive
- information broken into smaller, manageable segments.</p>
-<ul>
- <li><a class="reference-link" href="#root/_help_8QqnMzx393bx">Grid View</a>&nbsp;which
- is the default presentation method for child notes (see&nbsp;<a class="reference-link"
- href="#root/_help_0ESUbbAxVnoK">Note List</a>), where the notes are displayed
- as tiles with their title and content being visible.</li>
- <li><a class="reference-link" href="#root/_help_mULW0Q3VojwY">List View</a>&nbsp;is
- similar to&nbsp;<a class="reference-link" href="#root/_help_8QqnMzx393bx">Grid View</a>,
- but it displays the notes one under the other with the content being expandable/collapsible,
- but also works recursively.</li>
-</ul>
-<p>Classic collections make use of pagination to support a large number of
- notes. The size of a page can be customized via <code>pageSize</code>.</p>
-<h2>Creating a new collection</h2>
-<p>To create a new collection, right-click a note in the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;and select <em>Insert child note</em> → <em>Collection</em> →
- the desired type.</p>
-<p>By default, collections come with a default configuration and sometimes
- even sample notes. To create a collection completely from scratch:</p>
-<ol>
- <li>Create a new note of type <em>Text</em> (or any type).</li>
- <li>Change the <a href="#root/_help_KSZ04uQ2D1St">note type</a> to <em>Collection</em>.</li>
- <li>In&nbsp;<a class="reference-link" href="#root/_help_CssoWBu8I7jF">Collection Properties</a>,
- select the desired view type.</li>
- <li>Consult the help page of the corresponding view type in order to understand
- how to configure them.</li>
-</ol>
-<h2>Configuration</h2>
-<p>To change the configuration of a collection or even switch to a different
- collection (e.g. from Kanban Board to a Calendar), see the&nbsp;<a class="reference-link"
- href="#root/_help_CssoWBu8I7jF">Collection Properties</a>&nbsp;bar at the
- top of the note.</p>
-<h2>Archived notes</h2>
-<p>By default, <a href="#root/_help_MKmLg5x6xkor">archived notes</a> will not
- be shown in collections. This behavior can be changed by going to&nbsp;<a
- class="reference-link" href="#root/_help_CssoWBu8I7jF">Collection Properties</a>&nbsp;and
- checking <em>Show archived notes</em>.</p>
-<p>Archived notes will be generally indicated by being greyed out as opposed
- to the normal ones.</p>
-<h2>Hiding the child notes from the note tree</h2>
-<p>For collections with a large number of items, it can be helpful to hide
- the items from the note tree for performance reasons and to reduce clutter.
- This is especially useful for standalone collections, such as a geomap
- or a task board.</p>
-<p>To do so, go to&nbsp;<a class="reference-link" href="#root/_help_CssoWBu8I7jF">Collection Properties</a>&nbsp;and
- select <em>Hide child notes in tree</em>.</p>
-<h2>Advanced use cases</h2>
-<h3>Adding a description to a collection</h3>
-<p>To add a text before the collection, for example to describe it:</p>
-<ol>
- <li>Create a new collection.</li>
- <li>Change the <a href="#root/_help_KSZ04uQ2D1St">note type</a> from <em>Collection</em> to <em>Text</em>.</li>
-</ol>
-<p>Now the text will be displayed above while still maintaining the collection
- view.</p>
-<p>The only downside to this method is that&nbsp;<a class="reference-link"
- href="#root/_help_CssoWBu8I7jF">Collection Properties</a>&nbsp;will not
- be shown anymore. In this case, modify the attributes manually or switch
- back temporarily to the <em>Collection</em> type for configuration purposes.</p>
-<h3>Using saved search</h3>
-<p>Collections, by default, only display the child notes. However, it is
- possible to use the&nbsp;<a class="reference-link" href="#root/_help_eIg8jdvaoNNd">Search</a>&nbsp;functionality
- to display notes all across the tree, with advanced querying functionality.</p>
-<p>To do so, simply start a&nbsp;<a class="reference-link" href="#root/_help_eIg8jdvaoNNd">Search</a>&nbsp;and
- go to the&nbsp;<a class="reference-link" href="#root/_help_CssoWBu8I7jF">Collection Properties</a>&nbsp;and
- select a desired type of collection. To keep the search-based collection,
- use a&nbsp;<a class="reference-link" href="#root/_help_m523cpzocqaD">Saved Search</a>.</p>
-<aside
-class="admonition important">
- <p>While in search, none of the collections will not display the child notes
- of the search results. The reason is that the search might hit a note multiple
- times, causing an exponential rise in the number of results.</p>
-</aside>
-<h2>Under the hood</h2>
-<p>Collections by themselves are simply notes with no content that rely on
- the&nbsp;<a class="reference-link" href="#root/_help_0ESUbbAxVnoK">Note List</a>&nbsp;mechanism
- (the one that lists the children notes at the bottom of a note) to display
- information.</p>
-<p>By default, new collections use predefined&nbsp;<a class="reference-link"
- href="#root/_help_KC1HB96bqqHX">Templates</a>&nbsp;that are stored safely
- in the&nbsp;<a class="reference-link" href="#root/_help_2mUhVmZK8RF3">Hidden Notes</a>&nbsp;to
- define some basic configuration such as the type of view, but also some&nbsp;<a
- class="reference-link" href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;to
- make editing easier.</p>
-<p>Collections don't store their configuration (e.g. the position on the
- map, the hidden columns in a table) in the content of the note itself,
- but as attachments.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/1_Calendar_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/1_Calendar_image.png
deleted file mode 100644
index e2743dd637..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/1_Calendar_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/1_Geo Map_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/1_Geo Map_image.png
deleted file mode 100644
index 27eeb4b4eb..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/1_Geo Map_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/1_Presentation_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/1_Presentation_image.png
deleted file mode 100644
index 83b0c01af7..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/1_Presentation_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/2_Calendar_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/2_Calendar_image.png
deleted file mode 100644
index 3db9e775e6..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/2_Calendar_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/2_Geo Map_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/2_Geo Map_image.png
deleted file mode 100644
index d1d58e2def..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/2_Geo Map_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/3_Calendar_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/3_Calendar_image.png
deleted file mode 100644
index b147a7991e..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/3_Calendar_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/3_Geo Map_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/3_Geo Map_image.png
deleted file mode 100644
index f46ae8a641..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/3_Geo Map_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/4_Calendar_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/4_Calendar_image.png
deleted file mode 100644
index 920ffc6075..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/4_Calendar_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/5_Calendar_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/5_Calendar_image.png
deleted file mode 100644
index e89fee4d02..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/5_Calendar_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/6_Calendar_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/6_Calendar_image.png
deleted file mode 100644
index ae9c9a3c18..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/6_Calendar_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/7_Calendar_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/7_Calendar_image.png
deleted file mode 100644
index 875127df2e..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/7_Calendar_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/8_Calendar_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/8_Calendar_image.png
deleted file mode 100644
index 7bdf27a6f4..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/8_Calendar_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Calendar.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Calendar.html
deleted file mode 100644
index 7bb72ae10b..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Calendar.html
+++ /dev/null
@@ -1,620 +0,0 @@
-<figure class="image">
- <img style="aspect-ratio:2016/1413;" src="1_Calendar_image.png" width="2016"
- height="1413">
-</figure>
-<p>The Calendar view will display each child note in a calendar that has
- a start date and optionally an end date, as an event.</p>
-<p>The Calendar view has multiple display modes:</p>
-<ul>
- <li>Month view, where the entire month is displayed and all-day events can
- be inserted. Both time-specific events and all-day events are listed.</li>
- <li>Week view, where all the 7 days of the week (or 5 if the weekends are
- hidden) are displayed in columns. This mode allows entering and displaying
- time-specific events, not just all-day events.</li>
- <li>Day view, which views only a single day. Especially useful for heavy agendas
- or mobile views.</li>
- <li>List view, which displays all the events of a given month in sequence.</li>
- <li>Year view, which displays the entire year for quick reference.</li>
-</ul>
-<p>Unlike other Collection view types, the Calendar view also allows some
- kind of interaction, such as moving events around as well as creating new
- ones.</p>
-<h2>Creating a calendar</h2>
-<p>Right click on an existing note in the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;and select <em>Insert child note</em> → <em>Collection</em> → <em>Calendar</em>.</p>
-<h2>Creating a new event/note</h2>
-<p>To create a new event:</p>
-<ul>
- <li>First, click the desired day (month &amp; year views) or the desired timeslot
- (day view).</li>
- <li>Alternatively, drag across multiple days (or time slots) to set both the
- start and end date.</li>
-</ul>
-<p>In either cases, a small popup will show with a prompt for a title and
- the date &amp; time of the event that will be created. The date and time
- can be changed there the same way as in the popup view of an existing event
- (see below).</p>
-<p>At this point, the event hasn't been created yet to protect against accidental
- clicks. Add a title optionally and press the <em>Create</em> button. If no
- title is provided, the event will follow the&nbsp;<a class="reference-link"
- href="#root/_help_47ZrP6FNuoG8">Default Note Title</a>&nbsp;rules.</p>
-<p>The <span class="tn-icon bx bx-detail"></span> template field below the
- date and time shows the note type or template the event's note is made
- from. To make the event from another one, press the field and select it
- from the list; the calendar remembers the choice for the next event. Select <em>More templates…</em> to
- change which templates are listed (see <a href="#event-templates">Event templates</a>).
- The date and time entered for the event replace any dates and times the
- template carries.</p>
-<p>To give the event a time before creating it (for example, after clicking
- a day in the month view), press <em>Add time</em> and set the start and end
- time; the duration is shown to the right of them. To make the event all-day
- again, press the <span class="tn-icon bx bx-x"></span> button at the end
- of the row. Adding or removing a time keeps the dates, so an event can
- start at a time on one day and end at a time on another (for example, a
- night shift). Changing the start date or time moves the end by the same
- amount, keeping the duration. An empty end date means the event ends on
- the day it starts; setting the end time before the start time moves the
- end date to the next day.</p>
-<p>After creating the event, it will show up on the calendar. To edit the
- content of the event (including recurrence), click on it to bring it into
- the popup view.</p>
-<aside class="admonition note">
- <p>Creating new notes from the calendar will respect the <code>~child:template</code> relation
- if set on the Collection note.</p>
-</aside>
-<h2>Interacting with events</h2>
-<ul>
- <li>Hovering the mouse over an event will display information about the note.
- <br>
- <img src="4_Calendar_image.png">
- </li>
- <li>Left clicking the event will open a&nbsp;dedicated popup to quickly configure
- the event or edit its note content.</li>
- <li>Right click will offer more options including opening the note in a new
- split or window.</li>
- <li>Drag and drop an event on the calendar to move it to another day.</li>
- <li>The length of an event can be changed by placing the mouse to the right
- edge of the event and dragging the mouse around.</li>
-</ul>
-<p>On a <a href="#root/_help_CoFPLs3dRlXc">read-only</a> calendar, events can't
- be dragged, resized or created, their context menu only offers the places
- to open them in, and the button to pin the current date is hidden. Switching
- between the month, week and day views still works, but the choice isn't
- saved.</p>
-<h3>Popup view</h3>
-<p>When an event is clicked, a popup will show near the event which contains
- the following inforamtion:</p>
-<ul>
- <li>The title and icon of the event, both editable.</li>
- <li>Buttons to interact with the event:
- <ul>
- <li>Open the event in the same pane, new tab, etc.</li>
- <li>Color picker to change the color of the event.</li>
- <li>Button to remove the event from the calendar, which can optionally delete
- its corresponding note.</li>
- </ul>
- </li>
- <li>Calendar-specific features:
- <ul>
- <li>The start date and, for an event spanning several days, the end date.</li>
- <li>The start and end time with the duration to the right of them, and a <span
- class="tn-icon bx bx-x"></span> button that removes the time, making the
- event all-day. An all-day event shows an <em>Add time</em> button instead.</li>
- <li>A full recurrence editor, opened from the dropdown below the time, to
- have the same event show up weekly, monthly, etc.</li>
- </ul>
- </li>
- <li>The&nbsp;<a class="reference-link" href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;of
- the marker, if any.</li>
- <li>The note's content which can be edited directly from the panel.</li>
-</ul>
-<p>To dismiss the popup:</p>
-<ul>
- <li>Press the X button at the top-right of the popup.</li>
- <li>In the calendar, press anywhere outside the popup.</li>
- <li>Or simply press the <kbd>Escape</kbd> key.</li>
-</ul>
-<p>It is possible to switch between events by clicking on them even when
- the popup view is already open.</p>
-<p>Events can have&nbsp;<a class="reference-link" href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a>&nbsp;between
- them and clicking on such a link will automatically navigate the calendar
- to the right date and the popup view to the new note.</p>
-<h2>Interaction on mobile</h2>
-<p>When Trilium is on mobile, the interaction with the calendar is slightly
- different:</p>
-<ul>
- <li>Clicking on an event displays the popup view, which allows editing the
- event.</li>
- <li>Long-presing an event triggers the contextual menu, including the option
- to open in&nbsp;<a class="reference-link" href="#root/_help_ZjLYv08Rp3qC">Quick edit</a>.</li>
- <li>To insert a new event, touch and hold the empty space. When successful,
- the empty space will become colored to indicate the selection.
- <ul>
- <li>Before releasing, drag across multiple spaces to create multi-day events.</li>
- <li>When released, a prompt will appear to enter the note title.</li>
- </ul>
- </li>
- <li>To move an existing event, touch and hold the event until the empty space
- near it will become colored.
- <ul>
- <li>At this point the event can be dragged across other days on the calendar.</li>
- <li>Or the event can be resized by tapping on the small circle to the right
- end of the event.</li>
- <li>To exit out of editing mode, simply tap the empty space anywhere on the
- calendar.</li>
- </ul>
- </li>
-</ul>
-<h2>Configuring the calendar view</h2>
-<p>In the&nbsp;<a class="reference-link" href="#root/_help_CssoWBu8I7jF">Collection Properties</a>,
- it's possible to:</p>
-<ul>
- <li>Hide weekends from the week view.</li>
- <li>Display week numbers on the calendar.</li>
- <li>Set the slot duration (the length of each time row in day/week view).</li>
- <li>Set the slot label interval (how often time labels appear on the axis
- in day/week view).</li>
-</ul>
-<p>The same settings are also listed under <em>General</em> in the <span class="tn-icon bx bx-cog"></span> <em>Calendar properties</em> dialog
- (see <a href="#event-templates">Event templates</a> for how to open it).
- The time slots are listed there whichever view the calendar is in. Its <em>Included notes</em> section
- sets whether archived notes are shown and how deep the calendar looks for
- events (see <a href="#limiting-the-depth">Limiting the depth</a>).</p>
-<h3>Event templates</h3>
-<p>By default, a new event is a&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a> note.
- To make events from other note types, or from&nbsp;<a class="reference-link"
- href="#root/_help_KC1HB96bqqHX">Templates</a> with predefined content and
- attributes (such as a color), open the <span class="tn-icon bx bx-cog"></span> <em>Calendar properties</em> dialog
- from the&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a> or
- from the settings menu of the&nbsp;<a class="reference-link" href="#root/_help_CssoWBu8I7jF">Collection Properties</a>,
- and find <em>Event templates</em>. Here you can:</p>
-<ul>
- <li>Include a note type or note template already created in your knowledge
- base by pressing the <span class="tn-icon bx bx-list-plus"></span> <em>Add existing template</em> button
- and then selecting the desired note type or template.</li>
- <li>Create a new template by pressing the <span class="tn-icon bx bx-plus"></span> <em>Create a new template</em> button.
- The template is created as a child of the calendar, and is not shown as
- an event.</li>
- <li>Press the <span class="tn-icon bx bx-x"></span> button to remove a template
- from the list. The template is removed only from the list, not deleted.</li>
- <li>Press the <span class="tn-icon bx bx-dots-vertical-rounded"></span> button
- of a custom template to edit, open in a new window, duplicate, or delete
- it.</li>
- <li>Drag a template by its handle to reorder the list shown when creating
- an event.</li>
-</ul>
-<p>The dialog is not available on a read-only calendar, or on a calendar
- marked with <code>#calendarRoot</code> or <code>#workspaceCalendarRoot</code> (see <a
- href="#using-with-the-journal--calendar">Using with the Journal / calendar</a>).</p>
-<h3>Event attributes</h3>
-<p>Events can show the values of their attributes below their title, in the
- month view, and in the week and day views for all-day events and for timed
- ones tall enough to hold them. To choose which attributes are shown, open
- the <span class="tn-icon bx bx-cog"></span> <em>Calendar properties</em> dialog
- (see <a href="#event-templates">Event templates</a> for how to open it) and
- find <em>Event attributes</em>. It lists the <a class="reference-link" href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a> the
- calendar defines, and those its events define themselves. Here you can:</p>
-<ul>
- <li>Turn an attribute on to show it on the events. New attributes are hidden
- until you turn them on, which keeps the calendar from getting cluttered.</li>
- <li>Drag an attribute by its handle to change the order in which the events
- show them.</li>
- <li>Create a new attribute, which is shown on the events right away, or edit
- or delete one the calendar defines.</li>
-</ul>
-<p>The dates, times and recurrence of the events are not listed, as the calendar
- always shows them itself.</p>
-<p>If an event has a <code>#calendar:displayedAttributes</code> label, including
- one inherited from the calendar, the attributes listed in that label are
- shown instead.</p>
-<h2>Configuring the calendar using attributes</h2>
-<p>The following attributes can be added to the Collection type:</p>
-<figure
-class="table">
- <table>
- <thead>
- <tr>
- <th>Name</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>#calendar:hideWeekends</code>
- </td>
- <td>When present (regardless of value), it will hide Saturday and Sundays
- from the calendar.</td>
- </tr>
- <tr>
- <td><code>#calendar:weekNumbers</code>
- </td>
- <td>When present (regardless of value), it will show the number of the week
- on the calendar.</td>
- </tr>
- <tr>
- <td><code>#calendar:initialDate</code>
- </td>
- <td>Change the date the calendar opens on. When not present, the calendar
- opens on the current date.</td>
- </tr>
- <tr>
- <td><code>#calendar:view</code>
- </td>
- <td>
- <p>Which view to display in the calendar:</p>
- <ul>
- <li><code>timeGridDay</code> for the <em>day</em> view;</li>
- <li><code>timeGridWeek</code> for the <em>week</em> view;</li>
- <li><code>dayGridMonth</code> for the <em>month</em> view;</li>
- <li><code>multiMonthYear</code> for the <em>year</em> view;</li>
- <li><code>listMonth</code> for the <em>list</em> view.</li>
- </ul>
- <p>Any other value will be dismissed and the default view (month) will be
- used instead.</p>
- <p>The value of this label is automatically updated when changing the view
- using the UI buttons.</p>
- </td>
- </tr>
- <tr>
- <td><code>#calendar:slotDuration</code>
- </td>
- <td>Sets how long each timeslot is on the calendar. Defaults to <code>00:15:00</code> (15
- minutes). Must have the format "HH:MM:SS". For example, to create timeslots
- for every 10 minutes, you would set <code>#calendar:slotDuration="00:10:00"</code>.</td>
- </tr>
- <tr>
- <td><code>#calendar:slotLabelInterval</code>
- </td>
- <td>Sets how often the timeslots on the calendar should be labeled. Defaults
- to <code>01:00:00</code> (1 hour). Must have the format "HH:MM:SS". For example,
- to label timeslots every 30 minutes, you would set <code>#calendar:slotLabelInterval="00:30:00"</code>.</td>
- </tr>
- <tr>
- <td><code>~child:template</code>
- </td>
- <td>Defines the template for newly created notes in the calendar (via dragging
- or clicking).</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<p>In addition, the first day of the week can be either Sunday or Monday
- and can be adjusted from the application settings.</p>
-<h2>Configuring the calendar events using attributes</h2>
-<p>For each note of the calendar, the following attributes can be used:</p>
-<figure
-class="table">
- <table>
- <thead>
- <tr>
- <th>Name</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>#startDate</code>
- </td>
- <td>The date the event starts, which will display it in the calendar. The
- format is <code>YYYY-MM-DD</code> (year, month and day separated by a minus
- sign).</td>
- </tr>
- <tr>
- <td><code>#endDate</code>
- </td>
- <td>Similar to <code>startDate</code>, mentions the end date if the event spans
- across multiple days. The date is inclusive, so the end day is also considered.
- The attribute can be missing for single-day events.</td>
- </tr>
- <tr>
- <td><code>#startTime</code>
- </td>
- <td>The time the event starts at. If this value is missing, then the event
- is considered a full-day event. The format is <code>HH:MM</code> (hours in
- 24-hour format and minutes).</td>
- </tr>
- <tr>
- <td><code>#endTime</code>
- </td>
- <td>Similar to <code>startTime</code>, it mentions the time at which the event
- ends (in relation with <code>endDate</code> if present, or <code>startDate</code>).</td>
- </tr>
- <tr>
- <td><code>#recurrence</code>
- </td>
- <td>This is an optional CalDAV <code>RRULE</code> string that if present, determines
- whether a task should repeat or not. Note that it does not include the <code>DTSTART</code> attribute,
- which is derived from the <code>#startDate</code> and <code>#startTime</code> directly.
- For examples of valid <code>RRULE</code> strings see <a href="https://icalendar.org/rrule-tool.html">https://icalendar.org/rrule-tool.html</a>
- </td>
- </tr>
- <tr>
- <td><code>#color</code>
- </td>
- <td>Displays the event with a specified color (named such as <code>red</code>, <code>gray</code> or
- hex such as <code>#FF0000</code>). This will also change the color of the
- note in other places such as the note tree.</td>
- </tr>
- <tr>
- <td><code>#calendar:color</code>
- </td>
- <td><strong>❌️ Removed since v0.100.0. Use</strong> <code>#color</code> <strong>instead.</strong>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
- <br>
- <br>Similar to <code>#color</code>, but applies the color only for the event
- in the calendar and not for other places such as the note tree.</td>
- </tr>
- <tr>
- <td><code>#iconClass</code>
- </td>
- <td>If present, the icon of the note will be displayed to the left of the
- event title.</td>
- </tr>
- <tr>
- <td><code>#calendar:title</code>
- </td>
- <td>Changes the title of an event to point to an attribute of the note other
- than the title, can either a label or a relation (without the <code>#</code> or <code>~</code> symbol).
- See <em>Use-cases</em> for more information.</td>
- </tr>
- <tr>
- <td><code>#calendar:titleTemplate</code>
- </td>
- <td>Changes the title an event is displayed with on the calendar, filled in
- again for every occurrence of a repeating event. See <em>Use-cases</em> for
- displaying an age on a birthday.</td>
- </tr>
- <tr>
- <td><code>#calendar:displayedAttributes</code>
- </td>
- <td>Takes precedence over the <a href="#event-attributes">Event attributes</a> chosen
- in the calendar's properties. Allows displaying the value of one or more
- attributes in the calendar, in the order given, like this:&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
- <br>
- <br>
- <img src="6_Calendar_image.png">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
- <br>
- <br><code>#weight="70" #Mood="Good" #calendar:displayedAttributes="weight,Mood"</code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
- <br>
- <br>It can also be used with relations, case in which it will display the
- title of the target note:&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
- <br>
- <br><code>~assignee=@My assignee #calendar:displayedAttributes="assignee"</code>
- </td>
- </tr>
- <tr>
- <td><code>#calendar:startDate</code>
- </td>
- <td>Allows using a different label to represent the start date, other than <code>startDate</code> (e.g. <code>expiryDate</code>).
- The label name <strong>must not be</strong> prefixed with <code>#</code>.
- If the label is not defined for a note, the default will be used instead.</td>
- </tr>
- <tr>
- <td><code>#calendar:endDate</code>
- </td>
- <td>Similar to <code>#calendar:startDate</code>, allows changing the attribute
- which is being used to read the end date.</td>
- </tr>
- <tr>
- <td><code>#calendar:startTime</code>
- </td>
- <td>Similar to <code>#calendar:startDate</code>, allows changing the attribute
- which is being used to read the start time.</td>
- </tr>
- <tr>
- <td><code>#calendar:endTime</code>
- </td>
- <td>Similar to <code>#calendar:startDate</code>, allows changing the attribute
- which is being used to read the end time.</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<h2>How the calendar works</h2>
-<p>
- <img src="8_Calendar_image.png">
-</p>
-<p>The calendar displays all the child notes of the Collection that have
- a <code>#startDate</code>. An <code>#endDate</code> can optionally be added.</p>
-<p>A text note with a start date is shown with the <span class="tn-icon bx bx-calendar-event"></span> icon
- in the note tree and elsewhere, unless it has an icon of its own (set with <code>#iconClass</code>).
- The start date is read from the label <code>#calendar:startDate</code> names,
- if any.</p>
-<p>The start date &amp; end date can easily be edited from the calendar collection
- itself by clicking on the event. To edit the date while in the event note
- itself, the following attributes can be added to the Collection note:</p><pre><code class="language-text-x-trilium-auto">#viewType=calendar #label:startDate(inheritable)="promoted,alias=Start Date,single,date"
-#label:endDate(inheritable)="promoted,alias=End Date,single,date"
-#hidePromotedAttributes </code></pre>
-<p>This will result in:</p>
-<p>
- <img src="7_Calendar_image.png">
-</p>
-<p>When not used in a Journal, the calendar is recursive. That is, it will
- look for events not just in its child notes but also in the children of
- these child notes.</p>
-<h3>Limiting the depth</h3>
-<p>To limit how deep the calendar looks for events, set <em>Maximum nesting depth</em> under <em>Included notes</em> in
- the <span class="tn-icon bx bx-cog"></span><em>Calendar properties</em> dialog
- (see <a href="#event-templates">Event templates</a> for how to open it),
- or the <code>#maxNestingDepth</code> label: <code>0</code> shows only the child
- notes, <code>1</code> adds their children, and so on. Without a value, events
- are looked for at every level. The setting doesn't apply in a Journal.</p>
-<h2>Recurrence</h2>
-<p>The built in calendar view also supports repeating tasks (e.g. every week,
- every month as well as more complex recurrency rules).</p>
-<p>Starting with v0.105.0, recurrence can be directly edited from the calendar
- by clicking on an event and then selecting the <em>Repeats</em> option.</p>
-<h3>Custom recurrence using a subset of RRULE</h3>
-<p>If the existing recurrence editor from the event popup is not sufficient,
- more complex rules can be manually set via the <code>#recurrence</code> label.</p>
-<p>For example, to make a note repeat on the calendar:</p>
-<ul>
- <li>Every Day - <code>#recurrence="FREQ=DAILY;INTERVAL=1"</code>
- </li>
- <li>Every 3 days - <code>#recurrence="FREQ=DAILY;INTERVAL=3"</code>
- </li>
- <li>Every week - <code>#recurrence="FREQ=WEEKLY;INTERVAL=1"</code>
- </li>
- <li>Every 2 weeks on Monday, Wednesday and Friday - <code>#recurrence="FREQ=WEEKLY;INTERVAL=2;BYDAY=MO,WE,FR"</code>
- </li>
- <li>Every 3 months - <code>#recurrence="FREQ=MONTHLY;INTERVAL=3"</code>
- </li>
- <li>Every 2 months on the First Sunday - <code>#recurrence="FREQ=MONTHLY;INTERVAL=2;BYDAY=1SU"</code>
- </li>
- <li>Every month on the Last Friday - <code>#recurrence="FREQ=MONTHLY;INTERVAL=1;BYDAY=-1FR"</code>
- </li>
-</ul>
-<p>For other examples of valid <code>RRULE</code> strings see <a href="https://icalendar.org/rrule-tool.html">https://icalendar.org/rrule-tool.html</a>
-</p>
-<p>Note that the recurrence string does not include the <code>DTSTART</code> attribute
- as defined in the iCAL specifications. This is derived directly from the <code>startDate</code> and <code>startTime</code> attributes</p>
-<p>If you want to override the label the calendar uses to fetch the recurrence
- string, you can use the <code>#calendar:recurrence</code> attribute. For
- example, you can set <code>#calendar:recurrence=taskRepeats</code>. Then
- you can set your recurrence string like <code>#taskRepeats="FREQ=DAILY;INTERVAL=1"</code>
-</p>
-<p>Also note that the recurrence label can be made promoted as with the start
- and end dates.&nbsp;</p>
-<aside class="admonition warning">
- <p>If the recurrence string is not valid, a toast will be shown with the
- note ID and title of the note with the erroneous recurrence message. This
- note will not be added to the calendar</p>
-</aside>
-<h2>Customizing the slot duration and label interval</h2>
-<p>Time slots in day and week views can be customized from&nbsp;<a class="reference-link"
- href="#root/_help_CssoWBu8I7jF">Collection Properties</a>
-</p>
-<ul>
- <li><em>Slot duration</em> controls how tall each time slot is on the calendar
- (essentially the smallest unit of time the grid is divided into).
- <ul>
- <li>A shorter duration means more rows and finer granularity; a longer one
- means fewer, chunkier rows.</li>
- <li>The default is one row every 15 minutes.</li>
- </ul>
- </li>
- <li><em>Label interval</em> controls how often a time label appears on the
- left-hand axis.
- <ul>
- <li>This is independent of the slot size: you can have very small slots but
- only label every hour to keep the axis readable.</li>
- <li>The default is a time label shown every hour.</li>
- </ul>
- </li>
-</ul>
-<aside class="admonition note">
- <p>These values can also be customized directly via the <code>#calendar:slotDuration</code> and <code>#calendar:slotLabelInterval</code> <a
- href="#root/_help_HI6GBBIduIgv">labels</a>. Both values use <code>HH:mm:ss</code> format.
- Hours can go up to <code>24</code> (<code>24:00:00</code>), while minutes
- and seconds must be between <code>00</code> and <code>59</code>. The minimum
- meaningful duration is 1 minute (<code>00:01:00</code>).</p>
-</aside>
-<h2>Use-cases</h2>
-<h3>Using with the Journal / calendar</h3>
-<p>It is possible to integrate the calendar view into the Journal with day
- notes. In order to do so change the note type of the Journal note (calendar
- root) to Collection and then select the Calendar View.</p>
-<p>While in journal mode, the popup editor will not show dates, recurrence,
- colors or removal, since day notes aren't editable events.</p>
-<p>Based on the <code>#calendarRoot</code> (or <code>#workspaceCalendarRoot</code>)
- attribute, the calendar will know that it's in a calendar and apply the
- following:</p>
-<ul>
- <li>The calendar events are now rendered based on their <code>dateNote</code> attribute
- rather than <code>startDate</code>.</li>
- <li>Interactive editing such as dragging over an empty era or resizing an
- event is no longer possible.</li>
- <li>Clicking on the empty space on a date will automatically open that day's
- note or create it if it does not exist.</li>
- <li>Direct children of a day note will be displayed on the calendar despite
- not having a <code>dateNote</code> attribute. Children of the child notes
- will not be displayed.</li>
-</ul>
-<img src="5_Calendar_image.png" width="1217" height="724">
-<h3>Using a different attribute as event title</h3>
-<p>
- <img class="image-style-align-right" src="2_Calendar_image.png" width="445"
- height="124">By default, events are displayed on the calendar by their note title.
- However, it is possible to configure a different attribute to be displayed
- instead.</p>
-<p>To do so, assign <code>#calendar:title</code> to the child note (not the
- calendar/Collection note), with the value being <code>name</code> where <code>name</code> can
- be any label (make not to add the <code>#</code> prefix). The attribute can
- also come through inheritance such as a template attribute. If the note
- does not have the requested label, the title of the note will be used instead.</p><pre><code class="language-text-x-trilium-auto">#startDate=2025-02-11 #endDate=2025-02-13 #name="My vacation" #calendar:title="name"</code></pre>
-<h3>Using a relation attribute as event title</h3>
-<p>
- <img class="image-style-align-right image_resized" style="aspect-ratio:294/151;width:21.22%;"
- src="3_Calendar_image.png" width="294" height="151">Similarly to using an attribute, use <code>#calendar:title</code> and set
- it to <code>name</code> where <code>name</code> is the name of the relation
- to use.</p>
-<p>Moreover, if there are more relations of the same name, they will be displayed
- as multiple events coming from the same note.</p><pre><code class="language-text-x-trilium-auto">#startDate=2025-02-14 #endDate=2025-02-15 ~for=@John Smith ~for=@Jane Doe #calendar:title="for"</code></pre>
-<p>
- <img class="image-style-align-left" src="Calendar_image.png" width="296"
- height="150">Note that it's even possible to have a <code>#calendar:title</code> on the
- target note (e.g. “John Smith”) which will try to render an attribute of
- it. Note that it's not possible to use a relation here as well for safety
- reasons (an accidental recursion &nbsp;of attributes could cause the application
- to loop infinitely).</p><pre><code class="language-text-x-trilium-auto">#calendar:title="shortName" #shortName="John S."</code></pre>
-<h3>Displaying an age on a recurring event</h3>
-<p>A birthday or an anniversary repeats every year, and what is interesting
- about each occurrence is the number of years it marks. To display it:</p>
-<ol>
- <li>Set the event's start date to the original date (for example, the date
- of birth).</li>
- <li>Click the event, then select the <em>Repeats</em> dropdown.</li>
- <li>Select <em>Yearly</em> and check <em>Show the number of years in the title</em>.</li>
-</ol>
-<p>The event is then displayed as “John Smith (35)” in 2025, “John Smith
- (36)” in 2026, and so on. Only the calendar is affected; the note keeps
- its own title.</p>
-<p>The checkbox sets the <code>#calendar:titleTemplate</code> label, which
- sets the title an event is displayed with and is filled in again for every
- occurrence the recurrence rule produces:</p><pre><code class="language-text-x-trilium-auto">#startDate=1990-05-12 #recurrence="FREQ=YEARLY" #calendar:titleTemplate="${title} (${years})"</code></pre>
-<p>To word the title differently, edit the label directly. The checkbox is
- then disabled, as it is when the template is inherited, so that it never
- overwrites a template of your own.</p>
-<p>The following values can be used in the template:</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Value</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>${title}</code>
- </td>
- <td>The title the event would otherwise be displayed with: the note title,
- or the attribute <code>#calendar:title</code> points to.</td>
- </tr>
- <tr>
- <td><code>${years}</code>
- </td>
- <td>The whole years between <code>#startDate</code> and the occurrence being
- displayed. It is <code>0</code> on the first occurrence.</td>
- </tr>
- <tr>
- <td><code>${date}</code>
- </td>
- <td>The date of the occurrence being displayed, as a <a href="https://day.js.org/docs/en/display/format">day.js</a> object.
- For example, <code>${date.format('YYYY')}</code>.</td>
- </tr>
- <tr>
- <td><code>${startDate}</code>
- </td>
- <td>The date the event starts on, in the same form. For example, <code>${startDate.format('YYYY')}</code>.</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<p>To use the same template for every event of a calendar, make the label
- inheritable on the Collection note:</p><pre><code class="language-text-x-trilium-auto">#calendar:titleTemplate(inheritable)="${title} (${years})"</code></pre>
-<aside
-class="admonition note">
- <p>A template that cannot be read — an unknown value, or an expression other
- than a value and the <code>format</code> call shown above — leaves the event
- with its plain title and reports the reason in the browser console.</p>
-</aside>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Calendar_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Calendar_image.png
deleted file mode 100644
index 10ac2bb3d9..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Calendar_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Collection Properties.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Collection Properties.html
deleted file mode 100644
index 41b53e75f5..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Collection Properties.html
+++ /dev/null
@@ -1,19 +0,0 @@
-<figure class="image">
- <img style="aspect-ratio:1177/98;" src="Collection Properties_image.png"
- width="1177" height="98">
-</figure>
-<p>The <em>Collection Properties</em> is a toolbar that is displayed at the
- top of every <a href="#root/_help_GTwFsgaA0lCt">collection note</a>.</p>
-<p>The collection properties has:</p>
-<ul>
- <li>A quick selector for the view type (e.g. grid, calendar, board).</li>
- <li>A settings button with:
- <ul>
- <li>Settings for the current view, for example hiding the weekends in a calendar.</li>
- <li>Generic settings for the collection, such as <a href="#root/_help_wyaGBBQrl4i3">hiding the child notes</a> or
- showing <a href="#root/_help_MKmLg5x6xkor">archived notes</a>.</li>
- </ul>
- </li>
- <li>Specific interactions for the current view, for example month selector
- and view switcher for the calendar.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Collection Properties_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Collection Properties_image.png
deleted file mode 100644
index c1955ce8b1..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Collection Properties_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Dashboard.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Dashboard.html
deleted file mode 100644
index 2b36b88dd2..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Dashboard.html
+++ /dev/null
@@ -1,64 +0,0 @@
-<figure class="image">
- <img style="aspect-ratio:1406/1030;" src="Dashboard_image.png" width="1406"
- height="1030">
-</figure>
-<aside class="admonition note">
- <p>The dashboard is currently considered beta. This means that it might face
- some changes in behavior until it is stabilized.</p>
-</aside>
-<p>The dashboard is a collection introduced in Trilium v0.104.0. It is similar
- to the&nbsp;<a class="reference-link" href="#root/_help_8QqnMzx393bx">Grid View</a>&nbsp;collection,
- but with some key differences:</p>
-<ul>
- <li>The grid layout is not fixed, allowing for tiles of varying widths and
- heights. The grid has 12 columns and an unlimited number of rows.</li>
- <li>Each widget represents a child note of the collection and can be reordered
- or resized.</li>
- <li>The grid will distribute the columns evenly to fill the entire screen.
- <ul>
- <li>If the available space is too low (e.g. in a split or in mobile), the
- columns are collapsed so that all widgets are displayed one under the other.</li>
- <li>While the columns are collapsed, the widgets cannot be reordered or resized.</li>
- </ul>
- </li>
- <li>Unlike the&nbsp;<a class="reference-link" href="#root/_help_8QqnMzx393bx">Grid View</a>,
- the widgets are not clickable which allows them to be interactive.</li>
-</ul>
-<h2>Types of widgets</h2>
-<p>The dashboard uses the same rendering mechanism as the&nbsp;<a class="reference-link"
- href="#root/_help_8QqnMzx393bx">Grid View</a>&nbsp;or the&nbsp;<a class="reference-link"
- href="#root/_help_0ESUbbAxVnoK">Note List</a>, which means every note can
- be rendered, such as:</p>
-<ul>
- <li>Static content, via&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;or&nbsp;<a
- class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>.</li>
- <li>Images via&nbsp;<a class="reference-link" href="#root/_help_W8vYD3Q1zjCR">File</a>,&nbsp;<a
- class="reference-link" href="#root/_help_s1aBHPd79XYj">Mermaid Diagrams</a>,&nbsp;<a
- class="reference-link" href="#root/_help_gBbsAeiuUxI5">Mind Map</a>.</li>
- <li>Interactive widgets via&nbsp;<a class="reference-link" href="#root/_help_HcABDtFCkbFN">Render Note</a>.</li>
- <li>Web pages can be displayed via&nbsp;<a class="reference-link" href="#root/_help_1vHRoWCEjj0L">Web View</a>&nbsp;and
- refreshed via the context menu.</li>
- <li><a class="reference-link" href="#root/_help_GTwFsgaA0lCt">Collections</a>&nbsp;render
- interactively inside the dashboard</li>
-</ul>
-<aside class="admonition tip">
- <p>Interactive widgets through the use of&nbsp;<a class="reference-link"
- href="#root/_help_HcABDtFCkbFN">Render Note</a>&nbsp;is the highlighted
- use case of the dashboard. Using the&nbsp;<a class="reference-link" href="#root/_help_GBBMSlVSOIGP">AI</a>&nbsp;chat,
- these widgets can be easily created as the AI is instructed in how to write
- them.</p>
-</aside>
-<h2>Adding new widgets</h2>
-<p>There are two ways to add widgets to a dashboard:</p>
-<ul>
- <li>Create a child note of any type, the dashboard will automatically pick
- it up and add it onto the grid.</li>
- <li>From the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>,
- drag an existing note onto the dashboard and it will be placed there. This
- will <a href="#root/_help_IakOLONlIfGI">clone</a> the note into the collection.</li>
-</ul>
-<h2>Read-only dashboards</h2>
-<p>On a <a href="#root/_help_CoFPLs3dRlXc">read-only</a> dashboard, the widgets
- can't be moved or resized, notes dragged from the <a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a> aren't added, and the menu
- of a widget no longer offers to remove it.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Dashboard_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Dashboard_image.png
deleted file mode 100644
index 6b02e70ca9..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Dashboard_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Geo Map.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Geo Map.html
deleted file mode 100644
index b7d225d973..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Geo Map.html
+++ /dev/null
@@ -1,637 +0,0 @@
-<figure class="image">
- <img style="aspect-ratio:1561/1149;" src="Geo Map_image.png" width="1561"
- height="1149">
-</figure>
-<p>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.</p>
-<h2>Features</h2>
-<ul>
- <li>Add markers on the map, which can be customized with icons, colors and
- text.</li>
- <li>Search the notes already on the map, and look up places anywhere in the
- world.</li>
- <li>Turn a place the map already shows into a marker by clicking it.</li>
- <li>Draw paths, areas, rectangles and circles onto the map.</li>
- <li>Display tracks on the map using <code>.gpx</code> files.</li>
- <li>Show your own location on the map and follow it as you move.</li>
- <li>3D view of the map, which displays buildings when using a vector map.</li>
-</ul>
-<h2>System requirements</h2>
-<p>Starting with v0.105.0, the geomap uses MapLibre GL which requires WebGL
- v1 support. In general, most devices will support it because browsers/Electron
- can render it in software if needed.</p>
-<p>If the map could not be drawn because WebGL could not be initialized,
- an error message will appear instead of the map (<em>This map can't be drawn because WebGL isn't available…</em>).</p>
-<p>The button that shows your location is offered only when Trilium is reached
- over HTTPS, in the desktop application or in the mobile application. Browsers
- refuse to share the location of a device with a page served over plain
- HTTP, so on such a server the button does not appear.</p>
-<h2>Interaction</h2>
-<ul>
- <li>At the top-left there is the search bar. It searches the notes already
- on the map, and it can also search for places online when you ask it to.
- While you move through the results of a search, a counter with previous
- (<span class="tn-icon bx bx-chevron-left"></span>) and next (<span class="tn-icon bx bx-chevron-right"></span>)
- buttons appears under it.</li>
- <li>At the bottom-center there is a central toolbar which provides editing
- features: adding new markers on the map (<span class="tn-icon bx bx-pin"></span>)
- and importing GPX tracks (<span class="tn-icon bx bx-trip"></span>).</li>
- <li>At the bottom-right there are the viewport items:
- <ul>
- <li>Zoom in/out (<span class="tn-icon bx bx-plus-circle"></span> / <span class="tn-icon bx bx-minus-circle"></span>)
- <ul>
- <li>On mobile these are hidden, use pinch to zoom instead.</li>
- <li>On desktop, alternatively use the scroll wheel to adjust the zoom.</li>
- </ul>
- </li>
- <li>A <span class="tn-icon bx bx-current-location"></span> button that shows
- your location on the map and follows it (see <em>Going to your location</em> below).</li>
- <li><span class="tn-icon bx bx-fullscreen"></span> Full screen button which
- focuses the entire map onto the screen, while still allowing for edits.</li>
- </ul>
- </li>
- <li>At the top-center (on desktop, or left-center on mobile and in split views)
- there are the drawing tools such as paths, areas, rectangles and circles.
- <ul>
- <li>When the map is read-only, the toolbar is not shown.</li>
- </ul>
- </li>
-</ul>
-<h2>Creating a new geo map</h2>
-<p>Right click on an existing note in the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;and select <em>Insert child note</em> → <em>Collection</em> → <em>Geo Map</em>.</p>
-<p>By default the map will be empty and will show the entire world.</p>
-<h2>Repositioning the map</h2>
-<ul>
- <li>Click and drag the map in order to move across the map.</li>
- <li>Use the mouse wheel, two-finger gesture on a touchpad or the +/- buttons
- on the bottom-right to adjust the zoom.</li>
-</ul>
-<p>The position on the map and the zoom are saved inside the map note and
- restored when visiting again the note.</p>
-<p>A map that has no position saved yet is framed around the markers it contains
- when you open it, so they are all in view without having to go looking
- for them. A map that contains no markers shows the whole world instead.</p>
-<p>In practice this applies to maps whose markers were added externally,
- by a script or through&nbsp;<a class="reference-link" href="#root/_help_pgxEVkzLl1OP">ETAPI (REST API)</a>.
- When you add markers yourself you have already moved the map to reach the
- place you are marking, and that movement saves a position.</p>
-<h2>Going to your location</h2>
-<p>Press the <em>Show your location</em> (<span class="tn-icon bx bx-current-location"></span>)
- button at the bottom-right of the map, beside the zoom buttons. The first
- time, the browser or the operating system asks whether Trilium may know
- where the device is. In the desktop application the operating system's
- location settings decide.</p>
-<p>The map then moves to where the device is and marks it with a blue dot.
- A lighter circle around the dot shows how accurate the position is: a phone
- with GPS gives a dot on the street, while a computer located through its
- network connection can give a circle that covers a neighbourhood. The map
- follows the dot as it moves, and the button stays pressed while it does.</p>
-<p>Dragging the map stops it from following. The dot stays and keeps moving,
- and pressing the button again brings the map back to it. Pressing the button
- while the map is following turns the dot off.</p>
-<p>Click the dot to see its coordinates in the panel a searched place is
- shown in. From there the position can be kept as a marker (see <em>Keeping a place as a marker</em>).
- Clicking the lighter circle around the dot is a click on the map.</p>
-<p>If the position cannot be found, a message says so and the button keeps
- waiting for one; press it again to stop. If you refuse the permission,
- the button is disabled until the map is opened again. To allow it after
- all, change the permission for Trilium in the browser or in the system's
- location settings.</p>
-<p>Your position is not stored in the note, and Trilium does not send it
- anywhere on its own. Moving the map there does what any other pan or zoom
- does: the tile provider behind the map's style sees the coordinates of
- the area now on screen. The map does remember where you left it, as it
- does after any other movement, so a map you have taken to your location
- opens there the next time.</p>
-<h2>Searching the map</h2>
-<p>The search bar at the top-left of the map searches in two places. It always
- searches the notes that are already on the map. It can also search for
- places online, but only when you ask it to.</p>
-<h3>Searching the notes already on the map</h3>
-<p>Type in the search bar, and the notes on the map are matched by their
- title as you type. Accents are ignored, both in what you type and in the
- titles, so <code>zurich</code> finds <em>Zürich Hauptbahnhof</em>. Each word
- is searched for on its own, so <code>hotel paris</code> finds <em>Paris Hotel</em>.
- Notes without a <code>#geolocation</code> attribute are not offered, since
- there would be nowhere to go. Drawn shapes and GPS tracks are offered,
- even though they carry no such attribute: selecting one brings the whole
- shape or route into view.</p>
-<p>If more notes match than the list can show, you are offered the ones closest
- to the area you are viewing.</p>
-<h3>Searching for places online</h3>
-<p>Looking up a place sends what you typed to a third-party service. For
- this reason, it never happens while you type. Instead, the last row of
- the result list offers the search. That row reads <em>Search online for "…"</em>,
- with the name of the service below it. The search runs only when you press
- that row or select it with Enter.</p>
-<p>Trilium uses Nominatim, the place search run by the OpenStreetMap Foundation.
- It needs no account and no API key. Its name is shown on every row that
- belongs to it: the row that offers the search, the row that says a search
- is running, and the row that reports that nothing was found or that the
- service could not be reached.</p>
-<p>The search prefers the area you are viewing. Places inside the current
- view are searched for first and listed above the others. If you search
- for a shop while looking at your own town, you therefore find the branch
- in that town, and not one with the same name on another continent. The
- view is always treated as at least 25 km across, so a search made while
- zoomed into a single street still covers the town around it.</p>
-<h3>Going to a point</h3>
-<p>If you type or paste coordinates into the search bar, a <em>Go to</em> row
- is offered above all the other results. Selecting it moves the map to that
- exact spot and marks it. You can then keep it as a marker, in the same
- way you keep a place found by searching.</p>
-<p>Points are untitled by default; the corresponding note opens with the
- default name selected so it can be easily replaced. If the map has a&nbsp;<a
- class="reference-link" href="#root/_help_47ZrP6FNuoG8">Default Note Title</a>&nbsp;label,
- the marker is named by that template instead.</p>
-<p>The supported forms are:</p>
-<ul>
- <li>A plain pair, such as <code>45.9432, 24.9668</code>. This is what Google
- Maps and OpenStreetMap both give you when you ask for the coordinates of
- a place, and it is also what the <code>#geolocation</code> attribute holds.</li>
- <li>The <code>geo:</code> link that the map itself offers for a place, through
- the <em>Open location</em> action.</li>
- <li>The address of a place on Google Maps or OpenStreetMap, pasted whole.</li>
-</ul>
-<p>A pair that is not a place on Earth, such as <code>1234, 5678</code>, is
- not offered.</p>
-<h3>Reading the results</h3>
-<p>Results are gathered under headings, and each group is ordered by distance
- from the middle of the map:</p>
-<ul>
- <li><em>On this map</em>: notes that are already on the map, whatever their
- distance.</li>
- <li><em>Nearby</em>: places found within about 25 km of the view.</li>
- <li><em>Far away</em>: all the other places.</li>
-</ul>
-<p>The headings only appear when at least two of the three groups contain
- something. Every row that has a position shows how far away it is, in kilometres
- or miles according to your locale. A place found online shows its name
- on the first line and its address on the second.</p>
-<h3>Selecting a result</h3>
-<p>Selecting a note already on the map moves to its marker and opens the
- note beside the map, as clicking the marker would.</p>
-<p>Selecting a place found online moves the map to it and marks it with a
- temporary pin. The pin has a different color from the map's own markers.
- The map is fitted to the area that the place covers, so a country fills
- the view, while a house is shown at street level. Some places have a boundary,
- such as a country, a county or a park. When the service reports one, that
- boundary is outlined under the pin.</p>
-<p>A panel then opens with the place's full address and its coordinates:
- in the top-right corner on desktop, and at the bottom of the map on mobile,
- where the top is kept for the search bar and the result counter. Pressing
- the coordinates copies them to the clipboard.</p>
-<h3>Keeping a place as a marker</h3>
-<p>Press <em>Add as marker</em> in that panel to keep the place. A child note
- is created under the map. It takes the name of the place, as well as the
- icon, which matches the kind of place it is. Its <code>#geolocation</code> attribute
- is already set. The note opens beside the map, so you can edit it straight
- away. The temporary pin disappears, because the place is now a marker like
- any other.</p>
-<p>The button is not offered on a map that cannot be edited, where the panel
- can still be read.</p>
-<p>Press the panel's close button, or the Escape key, to send the place away
- without keeping it. The pin goes with it.</p>
-<h3>Stepping through the results</h3>
-<p>Once you select a result, a counter appears under the search bar, with
- a previous (<span class="tn-icon bx bx-chevron-left"></span>) and a next
- (<span class="tn-icon bx bx-chevron-right"></span>) button. These buttons
- move through everything the search offered, in the order it was listed.
- You can therefore compare several results without opening the list again.
- Pressing the counter itself moves the map back to the current result, which
- is useful after you have moved the map away from it.</p>
-<h3>The keyboard</h3>
-<ul>
- <li><kbd>Enter</kbd> runs the online search when its row is the one selected,
- and otherwise moves to the highlighted result. Pressed after a result has
- been taken, it brings the list back.</li>
- <li><kbd>Escape</kbd> closes the result list, and closes the place panel.</li>
- <li>Returning to the search bar reopens the list it was showing.</li>
- <li>The <span class="tn-icon bx bx-x"></span> button at the end of the bar empties
- it, which also takes a searched place, its pin and its panel off the map.</li>
-</ul>
-<h2>Adding a marker using the map</h2>
-<h3>Adding a new note using the <em>Add marker</em> button</h3>
-<ol>
- <li>
- <p>To create a marker, first navigate to the desired point on the map. Then
- press the <em>Add marker</em> (<span class="tn-icon bx bx-pin"></span>) button
- at the center-bottom of the map.</p>
- </li>
- <li>
- <p>Once pressed, the map will enter in the insert mode, as illustrated by
- the notification. Additionally, a preview of the marker will be shown at
- the cursor position.</p>
- <p>Simply click the point on the map where to place the marker. To cancel,
- press either the &nbsp;Escape key or press again the <em>Add marker</em> button.</p>
- </li>
- <li>
- <p>Once clicked, the marker will show up on the map and a popup will show
- to the right with the title already selected to be changed.</p>
- </li>
-</ol>
-<h3>Adding a new note using the contextual menu</h3>
-<ol>
- <li>Right click anywhere on the map, where to place the newly created marker
- (and corresponding note).</li>
- <li>Select <em>Add a marker at this location</em> (<span class="tn-icon bx bx-pin"></span>).</li>
- <li>Once clicked on a position on the map, the marker will show up on the
- map and a popup will show to the right with the title already selected
- to be changed.</li>
-</ol>
-<h3>Adding an existing note from the note tree</h3>
-<ol>
- <li>Select the desired note in the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>.</li>
- <li>Hold the mouse on the note and drag it to the map to the desired location.</li>
- <li>The map should be updated with the new marker.</li>
-</ol>
-<p>This works for:</p>
-<ul>
- <li>Notes that are not part of the geo map, case in which a <a href="#root/_help_IakOLONlIfGI">clone</a> will
- be created.</li>
- <li>Notes that are a child of the geo map but not yet positioned on the map.</li>
- <li>Notes that are a child of the geo map and also positioned, case in which
- the marker will be relocated to the new position.</li>
-</ul>
-<aside class="admonition note">
- <p>Dragging existing notes only works if the map is in editing mode. See
- the <em>Read-only</em> section for more information.</p>
-</aside>
-<h3>Adding a note from a place the map already shows</h3>
-<p>When a vector map style is used, the map itself draws the shops, cafés,
- museums and other places around the area being viewed. Once the map is
- zoomed in far enough for these to be drawn, they can be clicked:</p>
-<ol>
- <li>Look for the places drawn in orange. This is the same color used for a
- place found by searching. These are the places you can click. They are
- drawn almost solid, while the other places on the map stay a faint grey.</li>
- <li>Rest the mouse on one of them. Its name appears above it, and the mouse
- cursor changes to a pointer. The map draws these places as icons without
- names, so you read a name by hovering over it. If all the names were shown
- at once, they would crowd out the titles of your own markers.</li>
- <li>Click it. The same panel used for a place found by searching appears.
- It shows the name of the place and its coordinates, and a pin is placed
- on the map.</li>
- <li>Press <em>Add as marker</em> to keep it. The note is created with the name
- of the place as its title, and with the icon that matches the kind of place
- it is.</li>
-</ol>
-<p>Places are read from the map data that has already been downloaded, so
- clicking one does not send anything to the internet.</p>
-<p>Some things to keep in mind:</p>
-<ul>
- <li>Places with no name in the map data, such as benches or parking spaces,
- show no name and cannot be clicked. Clicking them does nothing, just like
- clicking an empty part of the map.</li>
- <li>The map's own markers come first. If a marker covers a place, clicking
- it opens the note and not the place.</li>
- <li>This does not work with the raster (OpenStreetMap) style, because its
- places are part of the map image. It also does not work with the <em>Neutrino</em> style,
- which draws no places.</li>
- <li>In read-only mode you can still click a place and read it, but you cannot
- keep it as a marker.</li>
-</ul>
-<h2>How the location of the markers is stored</h2>
-<p>The location of a marker is stored in the <code>#geolocation</code> attribute
- of the child notes:</p>
-<p>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.</p>
-<p>On an image map, the position is stored in <code>#mapPosition</code> instead
- (see&nbsp;<a class="reference-link" href="#root/_help_ZRDXGc0nAIh4">Image maps</a>).</p>
-<h2>Repositioning markers</h2>
-<p>Once a marker is set, it can be repositioned using one of the two ways:</p>
-<ul>
- <li>By right clicking the marker and selecting <em>Move to another location</em> (<span
- class="tn-icon bx bx-move"></span>).</li>
- <li>By clicking the marker to open the popup and selecting the <em>Move to another location</em> (<span
- class="tn-icon bx bx-move"></span>) button underneath the title bar.</li>
-</ul>
-<p>After clicking the button to move the marker, click at the desired position
- on the map to replace it. To cancel the operation, press Escape.</p>
-<aside
-class="admonition note">
- <p>If the map is locked for editing (see below), the map needs to be unlocked
- before moving the marker.</p>
-</aside>
-<h2>Interaction with the markers, tracks or shapes</h2>
-<ul>
- <li>Hovering over a marker will display a&nbsp;<a class="reference-link" href="#root/_help_lgKX7r3aL30x">Note Tooltip</a>&nbsp;with
- the content of the note it belongs to.
- <ul>
- <li>Clicking on the note title in the tooltip will navigate to the note in
- the current view.</li>
- </ul>
- </li>
- <li>Right-clicking the marker will open a contextual menu (as described below).</li>
- <li>Clicking a marker will focus on the marker and display a dedicated popup
- with the details. This works regardless of whether the map is editable
- or not.</li>
-</ul>
-<h3>Popup view</h3>
-<p>When a marker, a <a href="#root/_help_C2H9HK4BzwG7">shape</a>, or track
- is clicked, a popup will open to the right which contains the following
- information:</p>
-<ul>
- <li>The title and icon of the marker, both editable.</li>
- <li>An indicator for the coordinates (<span class="tn-icon bx bx-crosshair"></span>);
- clicking it will copy the coordinates to clipboard.</li>
- <li>A <span class="tn-icon bx bx-expand-alt"></span> button to maximize the
- popup.</li>
- <li>Buttons to interact with the current item:
- <ul>
- <li><span class="tn-icon bx bx-log-in"></span> Open the marker in the same
- pane, or use <span class="tn-icon bx bx-dots-horizontal-rounded"></span> to
- open it in a new tab, split, etc.</li>
- <li>A <span class="tn-icon bx bx-map-alt"></span> button to open the location
- in a dedicated application (e.g. Google Maps on mobile).</li>
- <li><span class="tn-icon bx bx-palette"></span> Color picker to change the
- color of the marker.</li>
- <li><span class="tn-icon bx bx-move"></span> Markers can also be moved, unlike
- tracks or shapes (which need to be redrawn).</li>
- <li><span class="tn-icon bx bx-trash"></span> Button to remove the marker from
- the map, which can optionally delete its corresponding note.
- <ul>
- <li>Removing a marker without deleting the note will only remove its <code>#geolocation</code> attribute
- (case in which the coordinates have to be manually added back in in order
- to get the note to show on the map again).</li>
- <li>Similarly, removing a shape will remove its <code>#geoShape</code> attribute.</li>
- </ul>
- </li>
- </ul>
- </li>
- <li>The&nbsp;<a class="reference-link" href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;of
- the marker, if any.</li>
- <li>The note's content which can be edited directly from the panel.</li>
-</ul>
-<p>To dismiss the popup:</p>
-<ul>
- <li>Press the X button at the top-right of the popup.</li>
- <li>In the map, press anywhere outside the popup.</li>
- <li>Or simply press the Escape key.</li>
-</ul>
-<p>When a marker is clicked, the map will automatically adjust the viewport
- so that the marker is still visible with the popup open. The currently
- selected marker is shown slightly bigger.</p>
-<p>It is possible to switch between markers by clicking on them even when
- the popup view is already open.</p>
-<p>Markers can have&nbsp;<a class="reference-link" href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a>&nbsp;between
- them and clicking on such a link will automatically adjust the viewport
- and the popup view to the new note.</p>
-<h3>Contextual menu</h3>
-<p>It's possible to press the right mouse button to display a contextual
- menu.</p>
-<ol>
- <li>If right-clicking an empty section of the map (not on a marker), it allows
- to:
- <ol>
- <li><span class="tn-icon bx bx-crosshair"></span> Displays the latitude and
- longitude. Clicking this option will copy them to the clipboard.</li>
- <li><span class="tn-icon bx bx-map-alt"></span> Open the location using an
- external application (if the operating system supports it).</li>
- <li><span class="tn-icon bx bx-pin"></span> Adding a new marker at that location.</li>
- </ol>
- </li>
- <li>If right-clicking on a marker, it allows to:
- <ol>
- <li><span class="tn-icon bx bx-crosshair"></span> Displays the latitude and
- longitude. Clicking this option will copy them to the clipboard.</li>
- <li><span class="tn-icon bx bx-map-alt"></span> Open the location using an
- external application (if the operating system supports it).</li>
- <li>Open the note in a new tab, split or window.</li>
- <li><span class="tn-icon bx bx-move"></span> Move the marker to another location.</li>
- <li><span class="tn-icon bx bx-trash"></span> Button to remove the marker from
- the map, which can optionally delete its corresponding note. Removing a
- marker without deleting the note will only remove its <code>#geolocation</code> attribute
- (case in which the coordinates have to be manually added back in in order
- to get the note to show on the map again).</li>
- </ol>
- </li>
- <li>Shapes can also be right-clicked and the menu is similar to markers except
- they cannot be moved.</li>
-</ol>
-<h3>Icon and color</h3>
-<figure class="image image-style-align-right image_resized" style="width:47.42%;">
- <img style="aspect-ratio:885/321;" src="3_Geo Map_image.png" width="885"
- height="321">
-</figure>
-<p>The markers will have the same icon as the note.</p>
-<p>It's possible to add a custom color to a marker by assigning them a <code>#color</code> attribute
- such as <code>#color=green</code>.</p>
-<p>This also applies to tracks and <a href="#root/_help_C2H9HK4BzwG7">shapes</a>.</p>
-<aside
-class="admonition note">
- <p>The color as it will be displayed on the map might be slightly tinted
- in order to make the text or icon more legible.</p>
-</aside>
-<h3>Adding the coordinates manually</h3>
-<p>Searching for the place is usually quicker (see <em>Searching the map</em> above).
- The steps below remain useful for a coordinate that is already to hand,
- or for a place the search cannot find.</p>
-<p>In a nutshell, create a child note and set the <code>#geolocation</code> attribute
- to the coordinates.</p>
-<p>The value of the attribute is made up of the latitude and longitude separated
- by a comma.</p>
-<h4>Adding from Google Maps</h4>
-<ol>
- <li>In Google Maps, on the web:
- <ol>
- <li>Look for a desired location, right click on it and a context menu will
- show up.</li>
- <li>Simply click on the first item displaying the coordinates and they will
- be copied to clipboard.</li>
- </ol>
- </li>
- <li>In Trilium, create a child note under the map.</li>
- <li>Then paste the value inside the text box into the <code>#geolocation</code> attribute
- of a child note of the map (don't forget to surround the value with a <code>"</code> character).</li>
-</ol>
-<h4>Adding from OpenStreetMap</h4>
-<p>Similarly to the Google Maps approach:</p>
-<ol>
- <li>Go to any location on openstreetmap.org and right click to bring up the
- context menu. Select the <em>Show address</em> item.</li>
- <li>The address will be visible in the top-left of the screen, in the place
- of the search bar.&nbsp;Select the coordinates and copy them into the clipboard.</li>
- <li>Simply paste the value inside the text box into the <code>#geolocation</code> attribute
- of a child note of the map and then it should be displayed on the map.</li>
-</ol>
-<h2>Drawing shapes on the map</h2>
-<p>See the dedicated&nbsp;<a class="reference-link" href="#root/_help_C2H9HK4BzwG7">Drawing shapes</a>&nbsp;page.</p>
-<h2>Using an image instead of the world map</h2>
-<p>A geo map can be drawn over an image of your own, such as a floor plan
- or a fantasy map, with markers placed in the image's pixels. See&nbsp;<a
- class="reference-link" href="#root/_help_ZRDXGc0nAIh4">Image maps</a>.</p>
-<h2>Adding GPS tracks (.gpx)</h2>
-<figure class="image">
- <img style="aspect-ratio:1566/1155;" src="1_Geo Map_image.png" width="1566"
- height="1155">
-</figure>
-<p>Trilium can display GPS tracks on the geo map, in the form of <code>.gpx</code> files.</p>
-<p>To add a track, either:</p>
-<ol>
- <li>Drag &amp; drop a <code>.gpx</code> file inside the geo map in the note
- tree.
- <ol>
- <li>In order for the file to be recognized as a GPS track, it needs to show
- up as <code>application/gpx+xml</code> in the <em>File type</em> field.</li>
- </ol>
- </li>
- <li>Press the <em>Add a GPS track from a GPX file</em> (<span class="tn-icon bx bx-trip"></span>)
- button which will directly prompt for a GPX file and import it as a subnote
- of the collection.</li>
-</ol>
-<p>When going back to the map, the track should now be visible.</p>
-<p>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 <code>color</code> of the note. The end marker is displayed with
- a distinct icon.</p>
-<p>If the track file contains multiple tracks, they will all be displayed
- as well as markers. Trilium will also split a single track that happens
- to have non-continuous points.</p>
-<p>If the GPX contains waypoints, they will also be displayed, including
- their names.</p>
-<p>When the track is clicked, the entire route is brought into view, as well
- as the right popup will indicate details about the track such as distance,
- duration and the elevation map. This information is also displayed when
- clicking the <code>.gpx</code> note itself.</p>
-<p>When clicking on the markers of a track (whether it's the start or stop
- builtin markers, or custom markers that are part of the track), only that
- marker is brought into view, as opposed to the entire route.</p>
-<h2>Read-only mode</h2>
-<p>When a map is <a href="#root/_help_CoFPLs3dRlXc">read-only</a> all editing
- features will be disabled such as:</p>
-<ul>
- <li>The <em>Add marker</em> (<span class="tn-icon bx bx-pin"></span>) button
- at the bottom of the map.</li>
- <li>Repositioning markers.</li>
- <li>Editing from the contextual menu (removing locations or adding new items).</li>
- <li>Keeping a place as a marker, whether you found it by searching or clicked
- it on the map. You can still search and click, and you can still look at
- a place and copy its coordinates.</li>
- <li>Drawing <a href="#root/_help_C2H9HK4BzwG7">shapes</a>.</li>
- <li>The <em>Geo map properties</em> dialog; its entry is hidden from the&nbsp;<a
- class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a>.</li>
-</ul>
-<p>To set a map as read-only, go to&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a>&nbsp;→ <em>Editable</em> → <em>Read-only</em>.</p>
-<h2>Configuration</h2>
-<h3>Map Style</h3>
-<p>The styling of the map can be adjusted in the&nbsp;<a class="reference-link"
- href="#root/_help_CssoWBu8I7jF">Collection Properties</a>, under <em>Background</em> in
- the <em>Geo map properties</em> dialog, or manually via the <code>#map:style</code> attribute.</p>
-<p>The geo map comes with two different types of styles:</p>
-<ul>
- <li>Raster styles
- <ul>
- <li>For these styles the map is represented as a grid of images at different
- zoom levels. This is the traditional way OpenStreetMap used to work.</li>
- <li>Zoom is slightly restricted.</li>
- <li>Currently, the only raster theme is the original OpenStreetMap style.</li>
- </ul>
- </li>
- <li>Vector styles
- <ul>
- <li>Vector styles are not represented as images, but as geometrical shapes.
- This makes the rendering much smoother, especially when zooming and looking
- at the building edges, for example.</li>
- <li>The map can be zoomed in much further.</li>
- <li>These come in various styles that are both light (Colorful, Graybeard,
- Neutrino) and dark (Eclipse, Shadow).</li>
- <li>The vector styles come from <a href="https://versatiles.org/">VersaTiles</a>,
- a free and open-source project providing map tiles based on OpenStreetMap.</li>
- <li>The VersaTiles layers also provide 3D building information (see below).</li>
- </ul>
- </li>
-</ul>
-<p>The default theme is Versatiles Colorful (vector).</p>
-<h4>3D view with buildings</h4>
-<figure class="image">
- <img style="aspect-ratio:2727/1642;" src="2_Geo Map_image.png" width="2727"
- height="1642">
-</figure>
-<p>Trilium v0.105.0 introduces a 3D view, courtesy of MapLibre GL. To enter
- 3D mode, simply press the <em>3D</em> button at the bottom-right of the map
- or press Ctrl and drag across the map.</p>
-<p>The buildings will only appear from zoom 14 onwards to avoid lag.</p>
-<aside
-class="admonition note">
- <p>To get 3D buildings, make sure you are using the <em>VersaTiles</em> styles
- which provide the building informatia via the <code>versatiles-shortbread</code> source.</p>
-</aside>
-<h3>Custom map style / tiles</h3>
-<p>Starting with v0.102.0 it is possible to use custom tile sets, but only
- in raster format.</p>
-<p>To use one:</p>
-<ol>
- <li>Open the <em>Geo map properties</em> dialog from the <a class="reference-link"
- href="#root/_help_8YBEPzcpUgxw">Note menu</a>.</li>
- <li>Under <em>Background</em>, set <em>Type</em> to <em>Custom tileset</em>.</li>
- <li>In <em>Tile URL</em>, enter the address of the tile set, with <code>{z}</code>, <code>{x}</code> and <code>{y}</code> where
- the zoom level and the position of the tile go. For example, to use Esri.NatGeoWorldMap,
- enter <a href="https://server.arcgisonline.com/ArcGIS/rest/services/NatGeo_World_Map/MapServer/tile/%7Bz%7D/%7By%7D/%7Bx%7D"><code>https://server.arcgisonline.com/ArcGIS/rest/services/NatGeo_World_Map/MapServer/tile/{z}/{y}/{x}</code></a>.
- The URL is saved once you leave the field; a URL that doesn't start with <code>http://</code> or <code>https://</code>,
- or that lacks one of the three placeholders, is not saved. A map drawn
- over an image keeps its image until a URL is saved.</li>
- <li>If the tiles are dark, turn on <em>Dark tileset</em>, which draws the marker
- titles in a light color so that they remain readable.</li>
-</ol>
-<p>Additionally:</p>
-<ul>
- <li>Hi-DPI tiles are supported via the <code>{r}</code> placeholder.</li>
- <li>Servers that number their tiles by quadkey are supported via the <code>{quadkey}</code> placeholder,
- in place of <code>{z}</code>, <code>{x}</code> and <code>{y}</code>.</li>
-</ul>
-<p>To go back to a built-in style, set <em>Type</em> back to <em>Vector &amp; Raster</em>.
- The tile set is switched off rather than removed: its label is renamed
- to <code>#disabled:map:style</code>, so setting <em>Type</em> to <em>Custom tileset</em> again
- brings back the same URL. A tile set inherited from a parent note or a
- template is overridden by the default style instead.</p>
-<p>The tile set can also be set manually: the URL goes in the <code>#map:style</code> <a
- href="#root/_help_HI6GBBIduIgv">label</a>, and the <code>#map:darkStyle</code> label
- marks it as dark. <code>#map:darkStyle</code> also overrides the built-in
- styles.</p>
-<aside class="admonition note">
- <p>For a list of tile sets, see the <a href="https://leaflet-extras.github.io/leaflet-providers/preview/">Leaflet Providers preview</a> page.
- Select a desired tile set and just copy the URL from the <em>Plain JavaScript</em> example.</p>
-</aside>
-<p>Custom vector map support is planned, but not yet implemented.</p>
-<h3>Other options</h3>
-<p>The following options can be configured either via the&nbsp;<a class="reference-link"
- href="#root/_help_CssoWBu8I7jF">Collection Properties</a>, by clicking
- on the settings (<span class="tn-icon bx bx-cog"></span>) button. Alternatively,
- each of these options also have a corresponding <a href="#root/_help_HI6GBBIduIgv">label</a> that
- can be set manually.</p>
-<ul>
- <li>Scale, which illustrates the scale of the map in either kilometers or
- miles in the bottom-left of the map.
- <ul>
- <li>The unit is determined by the <em>Formatting locale</em> option in <em>Language &amp; Region</em>.</li>
- </ul>
- </li>
- <li>The name of the markers is displayed by default underneath the pin on
- the map. Since v0.102.0, it is possible to hide these labels which increases
- the performance and decreases clutter when there are many markers on the
- map.</li>
- <li>v0.105.0 also introduces a feature called <em>Group nearby markers</em> which
- will cluster multiple markers together at low zoom.
- <ul>
- <li>The clusters display the number of items they contain. The color also
- changes based on the count.</li>
- <li>Clicking on a cluster will automatically zoom in so that the individual
- markers that make up the cluster are now visible.</li>
- </ul>
- </li>
-</ul>
-<p>The same options are also listed under <em>General</em> in the <span class="tn-icon bx bx-cog"></span><em>Geo map properties</em> dialog,
- opened from the&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a> or
- from the settings menu of the&nbsp;<a class="reference-link" href="#root/_help_CssoWBu8I7jF">Collection Properties</a>.
- Its <em>Included notes</em> section sets whether archived notes are shown
- and the <em>Maximum nesting depth</em> (see below), and its <em>Background</em> section
- holds the map style, the URL of a custom tile set when <em>Type</em> is set
- to <em>Custom tileset</em> (see above), or, with <em>Type</em> set to <em>Custom image</em>,
- draws the map over an image of your own instead, as described in&nbsp;<a
- class="reference-link" href="#root/_help_ZRDXGc0nAIh4">Image maps</a>.</p>
-<p>The map shows the notes of its whole subtree, not only its children. <em>Maximum nesting depth</em> (<code>#maxNestingDepth</code>)
- limits how deep below the map it looks: <code>0</code> shows only the children, <code>1</code> adds
- their children, and so on. Without a value, every level is shown.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Geo Map/Drawing shapes.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Geo Map/Drawing shapes.html
deleted file mode 100644
index df65367a1c..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Geo Map/Drawing shapes.html
+++ /dev/null
@@ -1,55 +0,0 @@
-<p>The following shapes can be drawn on the map: a path, an area, a rectangle
- or a circle.</p>
-<p>Unlike markers, the title of the shape is not displayed directly on the
- map but it will be displayed when hovered.</p>
-<p>The shape will also be drawn in the <a href="#root/_help_p9kXRFAkwN4o">color of the note</a>,
- if set.&nbsp;</p>
-<h2>Drawing a shape on the map</h2>
-<p>To draw a shape, use the toolbar that appears in the top-center area on
- desktop and on the left-center on mobile and in split view.</p>
-<p>Once a shape is drawn, it cannot be moved or modified. To do so, simply
- remove the shape and draw another one instead.</p>
-<h3>Drawing a path or an area</h3>
-<ol>
- <li>Press the <em>Draw a path on the map</em> (<span class="tn-icon bx bx-vector"></span>)
- or <em>Draw an area on the map</em> (<span class="tn-icon bx bx-shape-polygon"></span>)
- button. The button stays held down while the tool is armed, and a notification
- describes what to do.</li>
- <li>Click on the map once for each point. The shape is previewed as it grows.</li>
- <li>Finish it by pressing <kbd>Enter</kbd>. A path can also be finished by
- clicking its last point again, and an area by clicking the corner it started
- from. A path needs at least two points and an area at least three.</li>
-</ol>
-<h3>Drawing a rectangle or a circle</h3>
-<ol>
- <li>Press the <em>Draw a rectangle on the map</em> (<span class="tn-icon bx bx-shape-square"></span>)
- or <em>Draw a circle on the map</em> (<span class="tn-icon bx bx-shape-circle"></span>)
- button.</li>
- <li>Click once to set the first corner, or the center of the circle. Click
- a second time at the opposite corner, or at the distance the circle should
- reach.</li>
- <li>Instead of two clicks you can drag from one to the other. This also works
- on mobile and other touch-based apps.</li>
-</ol>
-<h3>Finishing and cancelling</h3>
-<p>To give up on a shape while drawing it, press <kbd>Escape</kbd> or press
- the tool's button again. Whatever has been drawn so far is discarded.</p>
-<p>The tool is deactivated once a shape is finished, so drawing a second
- shape requires another button press.</p>
-<h2>Interaction</h2>
-<p>Once a shape is created:</p>
-<ul>
- <li>Clicking a shape opens the standard panel which allows changing the title,
- the content and with buttons to open the note or remove it.
- <ul>
- <li>When clicking, a marker takes priority over the shape.</li>
- </ul>
- </li>
- <li>Right-clicking a shape opens a contextual menu similar to the one for
- markers, which allows opening the corresponding note or removing the shape.</li>
- <li>Typing in the map's search bar finds shapes by their title, as it does
- markers. Selecting one brings the whole shape into view.</li>
-</ul>
-<h2>How shapes are represented</h2>
-<p>Shapes are represented quite similarly to markers, which means each shape
- is a note. The information about the same is stored using a <a href="#root/_help_HI6GBBIduIgv">label</a> called <code>geoShape</code>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Geo Map/Image maps.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Geo Map/Image maps.html
deleted file mode 100644
index 1f6a4c68b1..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Geo Map/Image maps.html
+++ /dev/null
@@ -1,151 +0,0 @@
-<p>An image map is a geo map drawn over an image of your own instead of a
- world map, such as a floor plan, a fantasy map for a tabletop game, or
- a diagram to annotate. Markers and shapes work as they do on a geo map,
- but their positions are measured on the image instead of in latitude and
- longitude: in the image's own pixels, or in a coordinate system of your
- choosing, such as the one a video game uses.</p>
-<h2>Creating an image map</h2>
-<ol>
- <li>Upload the image as a note of its own, for example by dragging the file
- into the note tree. PNG, JPEG, WebP and GIF images are supported; SVG images
- are not.</li>
- <li>Create a geo map, or open an existing one.</li>
- <li>Open the <span class="tn-icon bx bx-cog"></span><em>Geo map properties</em> dialog
- from the&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a> or
- from the settings menu of the&nbsp;<a class="reference-link" href="#root/_help_CssoWBu8I7jF">Collection Properties</a>.</li>
- <li>Under <em>Background</em>, set <em>Type</em> to <em>Custom image</em>, then
- choose the image note in <em>Image note</em>. The list only offers image
- notes in a format the map can draw (PNG, JPEG, WebP or GIF), and shows
- all of them before anything is typed.</li>
-</ol>
-<p>The map then shows the image instead of the world map and opens with the
- whole image in view. To go back to a world map, set <em>Type</em> back to <em>Vector &amp; Raster</em>.
- The image is switched off rather than removed: its relation is renamed
- to <code>~disabled:map:image</code>, so setting <em>Type</em> to <em>Custom image</em> again
- brings back the same image, with its coordinates. An image that the geo
- map inherits from a parent note or a template can only be switched off
- on the note that holds it.</p>
-<p>The image note is stored in a <code>~map:image</code> <a href="#root/_help_Cq5X6iKQop6R">relation</a> of
- the geo map, which can also be added by hand.</p>
-<h2>Image size</h2>
-<p>Images are resized when they are uploaded, so by default the image of
- a map is at most 2000 pixels on its longer side, which can be too coarse
- for a detailed map. To keep an image at a higher resolution, do one of
- the following before uploading it:</p>
-<ul>
- <li>In <a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a> → <em>Media</em>,
- raise <em>Max image dimensions</em> or turn off <em>Automatically compress images</em>.</li>
- <li>Upload it through the <em>Import</em> dialog with <em>Compress images</em> unchecked.</li>
-</ul>
-<p>An image that was already uploaded keeps its size; upload it again after
- changing the settings.</p>
-<p>The image is drawn as a single picture by the graphics card, which limits
- how large it can be. Images up to 4096 pixels on their longer side are
- safe on practically every device, and most computers handle up to 16384
- pixels. On a device whose graphics card cannot hold the image, the markers
- and shapes still appear but the image itself does not. The <em>Geo map properties</em> dialog
- warns about an image larger than 4096 pixels, and about one that can't
- be used at all, such as an SVG image.</p>
-<h2>Interaction</h2>
-<p>Adding, moving and removing markers, drawing shapes, the popup view and
- the contextual menu work as described for the&nbsp;<a class="reference-link"
- href="#root/_help_81SGnPGMk7Xc">Geo Map</a>. The camera stays over the
- image and can zoom in up to four times past the image's own resolution.</p>
-<p>The features that only make sense on a real map are not available on an
- image map:</p>
-<ul>
- <li>Searching the map and searching for places online.</li>
- <li>Going to your location.</li>
- <li>Adding GPS tracks.</li>
- <li>Clicking the places the base map shows.</li>
- <li>The 3D buildings.</li>
- <li>Opening a location in an external map application.</li>
-</ul>
-<p>The look of the marker titles follows the image: if the image is dark,
- turn on <em>Dark image</em> under <em>Background</em> in the <em>Geo map properties</em> dialog,
- so that the titles are drawn in a light color. This sets the <code>#map:darkStyle</code> label.</p>
-<p>The <em>Map style</em> setting doesn't apply to an image map, so it's hidden
- from the settings menu of the collection while the map has an image.</p>
-<h2>Choosing the coordinate system</h2>
-<p>By default, positions are measured in pixels of the image at its original
- size, from its top-left corner, with <code>x</code> growing to the right
- and <code>y</code> growing downwards.</p>
-<p>To use coordinates of your own instead, open the <em>Geo map properties</em> dialog,
- set <em>Coordinates</em> under <em>Background</em> to <em>Custom</em>, and enter
- the coordinates of the image's <em>Top-left corner</em> and <em>Bottom-right corner</em>.
- Switching to <em>Custom</em> starts from the image's size in pixels, so the
- markers stay where they are until the corners are changed; for that reason, <em>Custom</em> can
- only be chosen once the image has loaded. All positions are then read and
- written in those coordinates, including the ones shown in the contextual
- menu and in the popup view. To go back to pixels, set <em>Coordinates</em> to <em>Image pixels</em>.
- Corners that the geo map inherits from a parent note or a template can
- only be removed on the note that holds them; entering other corners on
- this map overrides them.</p>
-<p>The corners are stored in the <code>#map:imageBounds</code> label of the
- geo map as <code>x,y x,y</code>, with a space between the two corners, which
- can also be set by hand. For example:</p>
-<ul>
- <li>A screenshot of a game map that covers <code>x</code> from -512 to 512 and <code>y</code> from
- -512 to 512, with <code>y</code> growing downwards: <code>#map:imageBounds=-512,-512 512,512</code>.
- Coordinates copied from the game can then be pasted directly into <code>#mapPosition</code>.</li>
- <li>A world whose <code>y</code> grows upwards, with the origin in the middle
- of the image: <code>#map:imageBounds=-2000,1000 2000,-1000</code>. A top-left <code>y</code> larger
- than the bottom-right one is what flips the axis.</li>
- <li>A floor plan measured in meters: <code>#map:imageBounds=0,0 24,12</code>.</li>
-</ul>
-<p>The two axes don't have to use the same scale. A circle is always measured
- in the map's own units, so it appears as an ellipse when the units are
- stretched differently along the two axes.</p>
-<p>Corners that share an <code>x</code> or a <code>y</code> don't span an area:
- the dialog doesn't save them, and a label holding them, or a value that
- cannot be read, is ignored and the pixels of the image are used instead.</p>
-<h2>Coordinate rulers</h2>
-<p>Enabling <em>Show scale</em> in the collection properties draws rulers along
- the edges of the image instead of a distance scale. Round values of the
- map's coordinates are marked with ticks along all four edges, labeled along
- the top and left ones, with faint grid lines across the image. The spacing
- follows the zoom level, and the values follow <code>#map:imageBounds</code> when
- it is set.</p>
-<p>The rulers are drawn on the image itself, so they move out of view along
- with its edges when zooming in. The grid lines remain visible across the
- image.</p>
-<h2>How the positions are stored</h2>
-<p>Because positions are stored in different labels from the ones of a geo
- map, the same note can be placed both on a geo map and on an image map.</p>
-<figure
-class="table">
- <table>
- <thead>
- <tr>
- <th>Label</th>
- <th>Content</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>#mapPosition</code>
- </td>
- <td>The position of a marker, as <code>x,y</code>, for example <code>#mapPosition=320,145</code>.</td>
- </tr>
- <tr>
- <td><code>#mapShape</code>
- </td>
- <td>A shape, in the same format as <code>#geoShape</code> (see&nbsp;<a class="reference-link"
- href="#root/_help_C2H9HK4BzwG7">Drawing shapes</a>) but with <code>x,y</code> pairs,
- and a circle's radius in the map's units, for example <code>#mapShape=circle:400,300 50</code>.</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<p>The positions belong to the coordinate system, not to the image. When
- replacing the image with a different one, for example a higher-resolution
- copy, keep <code>#map:imageBounds</code> describing the area the new image
- covers and every marker stays in place. With <em>Image pixels</em>, the
- positions are pixels, so an image of a different size moves the markers
- relative to what the image shows; to avoid that, switch <em>Coordinates</em> to <em>Custom</em> before
- replacing the image, which keeps the size of the old one (<code>0,0 &lt;width&gt;,&lt;height&gt;</code>)
- as the corners.</p>
-<aside class="admonition tip">
- <p>To draw freely over an image instead of placing notes on it, consider
- a&nbsp;<a class="reference-link" href="#root/_help_grjYqerjn243">Canvas</a>.</p>
-</aside>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Geo Map_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Geo Map_image.png
deleted file mode 100644
index d6df259bf2..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Geo Map_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Grid View.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Grid View.html
deleted file mode 100644
index e19052b21f..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Grid View.html
+++ /dev/null
@@ -1,33 +0,0 @@
-<figure class="image">
- <img style="aspect-ratio:990/590;" src="Grid View_image.png" width="990"
- height="590">
-</figure>
-<p>This view presents the child notes in a grid format, allowing for a more
- visual navigation experience.</p>
-<p>Each tile contains:</p>
-<ul>
- <li>The title of a note.</li>
- <li>A snippet of the content.</li>
- <li>For empty notes, the sub-children are also displayed, allowing for quick
- navigation.</li>
-</ul>
-<p>Depending on the type of note:</p>
-<ul>
- <li>For&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes,
- the text can be slightly scrollable via the mouse wheel to reveal more
- context.</li>
- <li>For&nbsp;<a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;notes,
- syntax highlighting is applied.</li>
- <li>For&nbsp;<a class="reference-link" href="#root/_help_W8vYD3Q1zjCR">File</a>&nbsp;notes,
- a preview is made available for audio, video and PDF notes.</li>
- <li>If the note does not have a content, a list of its child notes will be
- displayed instead.</li>
-</ul>
-<p>The grid view is also used by default in the&nbsp;<a class="reference-link"
- href="#root/_help_0ESUbbAxVnoK">Note List</a>&nbsp;of every note, making
- it easy to navigate to children notes.</p>
-<h3>Creating a new table</h3>
-<p>Right click on an existing note in the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;and select <em>Insert child note</em> → <em>Collection</em> → <em>Grid View</em>.</p>
-<h2>Configuration</h2>
-<p>Unlike most other view types, the grid view is not actually configurable.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Grid View_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Grid View_image.png
deleted file mode 100644
index 8de2914c1c..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Grid View_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Kanban Board.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Kanban Board.html
deleted file mode 100644
index 128b35e043..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Kanban Board.html
+++ /dev/null
@@ -1,742 +0,0 @@
-<p>The Board view lets you arrange subnotes as cards on a <a href="https://en.wikipedia.org/wiki/Kanban_board">Kanban board</a>.</p>
-<h2>Creating a Kanban board</h2>
-<p>Right-click an existing note in the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>,
- select <em>Insert child note</em> → <em>Collection</em> → <em>Kanban Board</em>.</p>
-<h2>How it works</h2>
-<p>When you first create a collection of the <em>Board</em> type, a few subnotes
- are created, each with a <code>#status</code> label set. The board then groups
- each note by the value of its status attribute.</p>
-<p>Notes are displayed recursively, so even grandchildren and more deeply
- nested notes will be displayed. However, unlike the&nbsp;<a class="reference-link"
- href="#root/_help_2FvYrpmOXm29">Table</a>, the notes are not displayed
- hierarchically.</p>
-<p>To limit how deep the board looks, go to <a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a> → <em>Board properties</em> and
- set <em>Maximum nesting depth</em> (under the <em>Included notes</em> section),
- or apply the <code>#maxNestingDepth</code> label to the board note: <code>0</code> shows
- only the children, <code>1</code> adds their children, and so on. Without
- a value, every level is shown.</p>
-<h2>Working with columns</h2>
-<h3>Creating columns</h3>
-<p>You can create a new column by pressing the <span class="tn-icon bx bx-plus"></span> <em>Add column</em> button
- located after the last column.</p>
-<p>Enter the new name (which must not match another column), optionally select
- an icon by pressing the circle at the start of the text box, and then press
- the (+) button or <kbd>Enter</kbd>. Click or tap outside the text box, or
- press <kbd>Esc</kbd>, to dismiss it.</p>
-<p>Columns can also be added from a context menu:</p>
-<ul>
- <li>To add a column at the end of the board, right-click an empty area of
- the board and select <span class="tn-icon bx bx-columns"></span> <em>Add new column</em>.</li>
- <li>To add a column next to an existing one, open its column menu and select <span
- class="tn-icon bx bx-columns"></span> <em>Add new column</em> → <em>Before</em> (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Enter</kbd>)
- or <em>After</em> (<kbd>Ctrl</kbd>+<kbd>Enter</kbd>).</li>
-</ul>
-<p>Once a board is set up, the <em>Add column</em> button can be hidden. To
- do so, go to&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a> → <em>Board properties</em> and
- turn off <em>Show the "Add column" button</em> (under the <em>General</em> section),
- or apply the <code>#board:hideAddColumn</code> label to the board note. Columns
- can still be added from the context menus above.</p>
-<h3>Reordering columns</h3>
-<p>The order of the columns can be changed at any time. There are several
- ways to do this:</p>
-<ul>
- <li><strong>Using touch or a mouse:</strong> Touch and hold the column header,
- or click and hold it with the mouse. Drag the column left or right until
- it reaches the desired location, and then release it.</li>
- <li><strong>Using the keyboard:</strong> While the keyboard focus is anywhere
- inside the column, you can use these key combinations. If the column header
- itself is focused, you can omit <kbd>Alt</kbd>:
- <ul>
- <li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Right</kbd>: Move the column to the
- right.</li>
- <li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Left</kbd>: Move the column to the
- left.</li>
- <li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Home</kbd>: Make it the first column.</li>
- <li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>End</kbd>: Make it the last column.</li>
- </ul>
- </li>
- <li><em>Using the column menu:</em> Open the column menu and use the&nbsp;<span
- class="tn-icon bx bx-horizontal-left"></span> <em>Move column</em> submenu.</li>
-</ul>
-<h3>Renaming and recoloring columns</h3>
-<p>To change the name of a column, open the column menu and select&nbsp;<span
- class="tn-icon bx bx-edit-alt"></span> <em>Rename column</em>, or press <kbd>F2</kbd> while
- the column header is selected.</p>
-<p>From the same menu, you can tint the column with a different color by
- using the color palette at the bottom of the menu.</p>
-<h3>Collapsing and expanding columns</h3>
-<h4>Collapsing</h4>
-<p>A column can be collapsed (minimized) to occupy less space on the screen
- and make the board look less cluttered. This is particularly useful for
- columns that are not frequently used, or when you want to focus on only
- a few columns and keep the rest out of sight.</p>
-<p>To collapse a column:</p>
-<ul>
- <li><strong>Using a mouse:</strong> Double-click the column header.</li>
- <li><strong>Using touch:</strong> Tap the column header, and then press the&nbsp;<span
- class="tn-icon bx bx-collapse-horizontal"></span> button on the side toolbar.</li>
- <li><strong>Using the keyboard:</strong> Focus the column header, and then
- press <kbd>Space</kbd>.</li>
-</ul>
-<p>Alternatively, you can use the&nbsp;<span class="tn-icon bx bx-collapse-horizontal"></span> <em>Collapse column</em> command
- from the column menu.</p>
-<p>Once a column is collapsed, its cards are no longer visible, but the column
- can still receive cards from other columns:</p>
-<ul>
- <li><strong>Drop cards onto a collapsed column:</strong> The cards will be
- moved to the column (at the bottom if manual sorting is enabled).</li>
- <li><strong>Hold cards over a collapsed column for a few seconds:</strong> The
- column will expand, allowing you to drop the cards at the desired position
- (if manual sorting is enabled) or peek at the other cards before deciding
- whether to drop them.</li>
- <li><strong>Move a card to a collapsed column using the keyboard:</strong> The
- column will temporarily expand to reveal the moved card. You can then continue
- moving the selected cards up or down, or to another column.</li>
-</ul>
-<p>Collapsed columns can still be reordered, and their menus remain available.</p>
-<p>A collapsed column shows its title vertically, read from the bottom up.
- If any column title on the board contains Chinese, Japanese or Korean characters,
- the titles of all collapsed columns read from the top down instead, so
- that those characters stay upright.</p>
-<h4>Expanding</h4>
-<p>You can restore a collapsed column so that its content is visible again
- in the following ways:</p>
-<ul>
- <li><strong>Using a mouse:</strong> Click the collapsed column.</li>
- <li><strong>Using touch:</strong> Tap the collapsed column, and then press
- the&nbsp;<span class="tn-icon bx bx-expand-horizontal"></span> button on
- the side toolbar.</li>
- <li><strong>Using the keyboard:</strong> Move the focus to the collapsed column,
- and then press <kbd>Space</kbd>.</li>
-</ul>
-<h4>Keeping a column collapsed</h4>
-<p>By default, once a column is expanded, it remains expanded. However, you
- can configure a column to collapse again after you finish working with
- it. To activate this behavior, open the column menu and check&nbsp;<span
- class="tn-icon bx bx-lock-alt"></span> <em>Keep the column collapsed</em>.</p>
-<p>A column configured to remain collapsed will expand like any other collapsed
- column, but only temporarily, until another column is focused.</p>
-<h4>Collapsing and expanding all columns</h4>
-<p>You can expand or collapse all columns at once by using the&nbsp;<span
- class="tn-icon bx bx-collapse-alt"></span> (collapse) and&nbsp;<span class="tn-icon bx bx-expand-alt"></span> (expand)
- buttons. On the desktop, these buttons are located at the bottom of the
- screen; on the mobile interface, they are in the header.</p>
-<h3>Sorting cards within a column</h3>
-<p>By default, the cards in a column are sorted manually by moving them up
- and down. You can also keep them sorted automatically, using customizable
- criteria for each column. To customize the sorting options, open the column
- menu → <em>Sort</em>. The following options are available:</p>
-<ul>
- <li><span class="tn-icon bx bx-collection"></span>&nbsp;<em>Board's default</em>:
- Use the default sorting order (initially manual for new boards).</li>
- <li><span class="tn-icon bx bx-move-vertical"></span>&nbsp;<em>Manually</em>:
- Sort cards by manually moving them up and down.</li>
- <li><span class="tn-icon bx bx-text"></span>&nbsp;<em>Title</em>: Sort cards
- by title.</li>
- <li><span class="tn-icon bx bx-calendar-plus"></span>&nbsp;<em>Creation date &amp; time</em>:
- Sort cards by the creation date and time of the note represented by each
- card. If a card was created from an existing note, the date and time will
- match the original creation date and time of that note, not when the card
- was added to the board.</li>
- <li>Any custom attribute: Any card attribute (see&nbsp;<a class="reference-link"
- href="#root/_help_zEY4DaJG4YT5">Attributes</a>) can be used as a sorting
- criterion.</li>
- <li><span class="tn-icon bx bx-sort-up"></span>&nbsp;<em>Ascending</em>: Sort
- from smallest to largest (A to Z, 0 to 9, or oldest to newest).</li>
- <li><span class="tn-icon bx bx-sort-down"></span>&nbsp;<em>Descending</em>:
- Sort in reverse order, from largest to smallest.</li>
-</ul>
-<aside class="admonition important">
- <p>The card order you set is preserved after you switch away from manual
- sorting. When you switch back to manual sorting, the cards will be in the
- same order in which you arranged them.</p>
-</aside>
-<h4>How card attributes are sorted</h4>
-<p>When cards are sorted by an attribute, they are ordered according to the
- following rules:</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Attribute type</th>
- <th>Sort order (ascending)</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>Text, Multi-line text, URL, Email, Phone</td>
- <td>A to Z, 0 to 9</td>
- </tr>
- <tr>
- <td>Number</td>
- <td>lowest → greatest</td>
- </tr>
- <tr>
- <td>Date, Date &amp; time</td>
- <td>oldest → newest</td>
- </tr>
- <tr>
- <td>Time</td>
- <td>earliest hour (closest to 0) → latest hour (closest to 24)</td>
- </tr>
- <tr>
- <td>Checkbox</td>
- <td>unchecked → checked</td>
- </tr>
- <tr>
- <td>Select</td>
- <td>The order in which the options are declared.&nbsp;&nbsp;&nbsp;&nbsp;
- <br>For example, a select attribute declared with “Low”, “Medium”, and “High”
- options will be sorted as follows: Low → Medium → High.</td>
- </tr>
- <tr>
- <td>Color</td>
- <td>Grays → colors. Colors are ordered by their color-wheel <a href="https://en.wikipedia.org/wiki/Hue">hue</a> angle
- (from 0° to 360°).</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<p>Relation attributes are ordered according to the title of the target note.</p>
-<p>Cards with attributes that have no value set are always sorted at the
- end of the column, regardless of whether the sort order is ascending or
- descending. If an attribute holds more than one value, only the first value
- is used for sorting.</p>
-<h4>Configuring the default sorting options</h4>
-<p>Every new column uses the <em>Board's default</em> sorting option, which
- is initially set to manual sorting on new boards. However, the default
- can be changed to any other sorting criterion and direction. To configure
- it, go to&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a> → <em>Board properties</em> → <em>Default card order</em> (under
- the <em>General</em> section).</p>
-<p>Once the default is changed, all columns set to the <em>Board's default</em> sorting
- option will follow the new sorting options.</p>
-<p>Columns using a sorting option other than <em>Board's default</em> will
- not be affected by the new default. To override all columns so that they
- use the default sorting options, use the <em>Reset sorting options to default for all columns</em> command
- in <em>Board properties</em>.</p>
-<aside class="admonition warning">
- <p>Using the <code>#sorted</code> attribute on Kanban boards <strong>is no longer recommended</strong>,
- because it applies to every column and prevents manual sorting. Instead,
- use <code>#board:sortColumns</code>, which is designed exclusively for board
- collections and can take one of the following values: <code>title</code>, <code>creationDate</code>,
- or <code>attr:_&lt;attribute name&gt;_</code>, for example, <code>#board:sortColumns=attr:dueDate</code>.
- Using the <code>#board:sortColumnsDescending</code> label will switch to
- descending order.</p>
-</aside>
-<h3>Setting a limit</h3>
-<p>For each column, you can limit the number of cards it contains (also known
- as a WIP limit). Once the limit is exceeded, the column displays a visual
- warning to indicate that it is over its limit.</p>
-<p>To enable the limit, go to the column menu →&nbsp;<span class="tn-icon bx bx-tachometer"></span> <em>Set limit</em>,
- and then:</p>
-<ul>
- <li>Turn on the <em>Warn for exceeding the column capacity</em> toggle.</li>
- <li>Enter the desired limit in the <em>Maximum number of cards in the column</em> text
- box.</li>
- <li>Press the <em>Set limit</em> button.</li>
-</ul>
-<p>A column that has reached its limit can still accept new cards. Blocking
- new cards is not supported and most likely never will be, due to the way
- Trilium works: cards are regular notes, and the attributes used to group
- them into columns can be set from anywhere in the app, outside the board
- control. As a result, enforcing the limit would not be consistent.</p>
-<h3>Archiving a column</h3>
-<p>If you want to hide a column from the board without deleting it, you can
- archive it by opening the column menu →&nbsp;<span class="tn-icon bx bx-archive-in"></span> <em>Archive column</em>.
- Archiving a column does not set the archived flag (see&nbsp;<a class="reference-link"
- href="#root/_help_MKmLg5x6xkor">Archived Notes</a>) on the notes corresponding
- to its cards.</p>
-<p>To show archived columns again, go to&nbsp;<span class="tn-icon bx bx-cog"></span> <em>Collection options</em> and
- toggle&nbsp;<span class="tn-icon bx bx-archive-in"></span> <em>Show archived notes</em>,
- or turn on <em>Show archived cards and columns</em> in <a class="reference-link"
- href="#root/_help_8YBEPzcpUgxw">Note menu</a> → <em>Board properties</em> (under
- the <em>Included notes</em> section). Archived columns will appear faded.
- To restore one, open its column menu and select&nbsp;<span class="tn-icon bx bx-archive-out"></span> <em>Unarchive column</em>.</p>
-<h3>Deleting a column</h3>
-<p>You can delete a column by opening the column menu →&nbsp;<span class="tn-icon bx bx-trash"></span> <em>Delete column</em>,
- or by pressing <kbd>Delete</kbd> when a column header is focused, and then
- confirming. This removes the column from the board and unsets the grouping
- attribute for each note represented by a card in that column. If the column
- contains cards, the confirmation also offers to delete their notes instead
- of keeping them.</p>
-<p>The inbox column is not deleted this way. Its menu entry is&nbsp;<span
- class="tn-icon bx bx-trash"></span> <em>Remove inbox column</em>, and <kbd>Delete</kbd> on
- its header hides the inbox without changing any card.</p>
-<h3>The inbox column</h3>
-<p>The inbox column is a special column containing cards that are not assigned
- to another column. It is particularly useful when you switch an existing
- collection containing child notes to a board collection. The inbox column
- turns all child notes into cards that you can quickly distribute among
- the other columns. It can also act as a backlog where you can keep new
- cards that might eventually become part of the board.</p>
-<p>The inbox column is hidden by default. To show it, go to&nbsp;<span class="tn-icon bx bx-cog"></span> <em>Collection options</em> and
- toggle <em>Show inbox column</em>. The inbox column is distinguishable by
- its transparent background. It is always the first column and cannot be
- moved. It does not support a card limit. Otherwise, it operates like a
- regular column: its title, icon, and color can be changed; it can be sorted
- manually or automatically; and it can be collapsed.</p>
-<p>You can also show the inbox column by applying the <code>#board:showInbox</code> label
- (read more about&nbsp;<a class="reference-link" href="#root/_help_zEY4DaJG4YT5">Attributes</a>)
- to the board note.</p>
-<p>Optionally, the inbox column can also list nested notes from the board
- collection's subtree. To enable this, open the column menu and check&nbsp;<span
- class="tn-icon bx bx-subdirectory-right"></span> <em>Include nested notes</em>.</p>
-<h3>Changing the width of columns</h3>
-<p>There are three predefined widths for board columns: narrow (default),
- medium, and wide. To change the width, open the&nbsp;<a class="reference-link"
- href="#root/_help_8YBEPzcpUgxw">Note menu</a> → <em>Board properties</em> → <em>Column width</em> (under
- the <em>General</em> section). This option applies to every column on the
- board, except in the mobile version.</p>
-<p>The same option is also available through the <code>#board:columnWidth</code> label
- (read more about&nbsp;<a class="reference-link" href="#root/_help_zEY4DaJG4YT5">Attributes</a>)
- on the board note, which accepts “<code>narrow</code>”, “<code>medium</code>”,
- or “<code>wide</code>” as its value.</p>
-<p>You can also redefine these three widths by using custom app CSS (read
- more about&nbsp;<a class="reference-link" href="#root/_help_AlhDUqhENtH7">Custom app-wide CSS</a>)
- and assigning the desired pixel values as follows:</p><pre><code class="language-text-x-trilium-auto">#trilium-app {
- --board-column-width-narrow: 275px;
- --board-column-width-medium: 325px;
- --board-column-width-wide: 400px;
-}</code></pre>
-<h2>Working with cards</h2>
-<h3>Creating a new card</h3>
-<p>To create a new card, press the <span class="tn-icon bx bx-plus"></span> <em>New card</em> button
- located at the bottom of each column. To create a new card above or below
- a specific card, right-click or hold that card, and then select&nbsp;<span
- class="tn-icon bx bx-list-plus bx-flip-vertical"></span> <em>Insert new above</em> or&nbsp;<span
- class="tn-icon bx bx-list-plus"></span> <em>Insert new below</em> from the
- context menu. Alternatively, press <kbd>Shift</kbd> + <kbd>Enter</kbd> to create
- a new card above the focused card, or <kbd>Enter</kbd> to create one below
- it.</p>
-<p>Next, type the title of the new card, and then press the&nbsp;<span class="tn-icon bx bx-plus-circle"></span> button
- or <kbd>Enter</kbd> to complete it. Tap or click anywhere outside the text
- box to dismiss it. You can also select a different icon and card template.
- To learn more about card templates, see Card templates (learn more about&nbsp;<a
- class="reference-link" href="#root/_help_KC1HB96bqqHX">Templates</a>).</p>
-<p>After the card is created, you can tap or click it, or press <kbd>Space</kbd>,
- to edit the note content.</p>
-<p>When using the&nbsp;<span class="tn-icon bx bx-plus"></span> <em>New card</em> button,
- cards are always created at the end of the column. To create the card at
- the top of the column, right-click or hold the&nbsp;<span class="tn-icon bx bx-plus-circle"></span> button
- and select&nbsp;<span class="tn-icon bx bx-vertical-top"></span> <em>Create at top</em>.
- When using keyboard shortcuts, focus the column header and press <kbd>Enter</kbd> to
- create a new card at the start of the column, or <kbd>Shift</kbd> + <kbd>Enter</kbd> to
- create one at the end.</p>
-<h3>Adding an existing note as a card</h3>
-<p>Any note in your knowledge base can be represented as a card on a board.
- To add an existing note to your board, create a new card but do not enter
- a title. Instead, press the&nbsp;<span class="tn-icon bx bx-folder-open"></span> button.
- Alternatively, use the&nbsp;<span class="tn-icon bx bx-folder-open"></span> <em>Add an existing note as a card</em> command
- from the column menu.</p>
-<p>In the dialog that opens, search for the note by name, and then press
- the <em>Add to column</em> button to insert it. Alternatively, you can drag
- any note from the tree and drop it at the desired position on the board.</p>
-<p>If the target note is already in the board collection's subtree, it will
- already be listed in the <strong>inbox column</strong>.</p>
-<aside class="admonition important">
- <p>Notes added to the board are cloned, not duplicated. This means that changes
- to their titles, content, and attributes on the board are reflected in
- their original locations as well. Learn more about cloned notes.</p>
-</aside>
-<h3>Selecting multiple cards</h3>
-<p>When working with a board, you may need to perform operations on multiple
- cards at once, such as moving them to another column, setting attributes
- or colors, deleting them, or archiving them.</p>
-<p>You can select multiple cards in the following ways:</p>
-<ul>
- <li><strong>Using a mouse and keyboard:</strong>
- <ul>
- <li>To add a card to the selection, hold <kbd>Ctrl</kbd> and click the card.
- Repeat this for other cards until all the desired cards are selected. Clicking
- a selected card again while holding <kbd>Ctrl</kbd> will deselect it.</li>
- <li>If the cards you want to select form a continuous sequence within a column,
- hold <kbd>Shift</kbd>, click the first card in the sequence, and then click
- the last card.</li>
- <li>Press <kbd>Esc</kbd> to clear the selection.</li>
- </ul>
- </li>
- <li><strong>On mobile:</strong>
- <ol>
- <li>To enter selection mode, tap the&nbsp;<span class="tn-icon bx bx-select-multiple"></span> button
- at the top of the screen. A selection toolbar will appear in the header,
- displaying “0 cards selected”.</li>
- <li>Tap the cards you want to select. If you tap a selected card again, it
- will be deselected. To select all cards in a column, press the&nbsp;<span
- class="tn-icon bx bx-list-check"></span> button on the selection toolbar.
- To clear the selection, press the&nbsp;<span class="tn-icon bx bx-x"></span> button.</li>
- <li>Use the side toolbar to apply actions to the selected cards.</li>
- </ol>
- </li>
- <li><strong>Using only the keyboard:</strong>
- <ul>
- <li>To add the currently focused card to the selection, press <kbd>Ctrl</kbd> + <kbd>Space</kbd>.
- Repeat this for the other cards you want to select. Pressing <kbd>Ctrl</kbd> + <kbd>Space</kbd> again
- on a selected card will deselect it.</li>
- <li>To select a continuous sequence of cards within a column, hold <kbd>Shift</kbd> and
- use the <kbd>Up</kbd> and <kbd>Down</kbd> arrow keys to expand or shrink the
- selection.</li>
- <li>To select every card in the column the focus is in, press <kbd>Ctrl</kbd> + <kbd>A</kbd>.
- The same action is available from the column menu, as <span class="tn-icon bx bx-selection"></span> <em>Select all cards</em>.</li>
- <li>Press <kbd>Esc</kbd> to clear the selection.</li>
- </ul>
- </li>
-</ul>
-<h3>Moving cards between columns</h3>
-<p>To move one or more cards to another column, use one of the following
- methods:</p>
-<h4>Using touch or a mouse</h4>
-<p>Touch and hold the card, or click and hold it with the mouse, and then
- drag it to the desired column. If the column uses manual sorting, you can
- also position the card relative to the other cards.</p>
-<aside class="admonition tip">
- <p>To drag a card outside the board, for example to the note tree, another
- split, or another window, hold <kbd>Ctrl</kbd> and then start dragging.</p>
-</aside>
-<p>If the target column is collapsed, you can drop the card onto its header
- to move it into that column (at the end if manually sorted), without expanding
- it. However, if you want to reveal its cards before dropping, hold the
- card over the column for a few seconds; the column will then expand.</p>
-<aside
-class="admonition tip">
- <p><strong>You can quickly drop a card at the start or end of a column.</strong>
- </p>
- <p>Drop the card above the column while the “Drop as the first card” hint
- is displayed to make it the first card in that column. Alternatively, drop
- it below the column while the “Drop as the last card” hint is displayed
- to make it the last card.</p>
-</aside>
-<h4>Using the keyboard</h4>
-<p>You can also use keyboard shortcuts to move the selected card or cards
- between columns:</p>
-<ul>
- <li><kbd>Ctrl</kbd> + <kbd>Right</kbd>: Move to the next column.</li>
- <li><kbd>Ctrl</kbd> + <kbd>Left</kbd>: Move to the previous column.</li>
- <li><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Right</kbd>: Move to the last column.</li>
- <li><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Left</kbd>: Move to the first column.</li>
-</ul>
-<h4>Using the context menu</h4>
-<p>To quickly move a card to another column, open the card's context menu
- and select the destination column. The menu lists the first seven columns;
- on a wider board, the remaining ones are grouped under <em>More…</em>.</p>
-<h3>Reordering cards within a column</h3>
-<p>Cards within a column can be freely reordered unless the column uses a
- sorting option other than manual. To reposition a card, drag it as described
- in the <strong>Moving cards between columns</strong> section and drop it
- at the desired position.</p>
-<p>Alternatively, you can use keyboard shortcuts to move the selected card
- or cards:</p>
-<ul>
- <li><kbd>Ctrl</kbd> + <kbd>Up</kbd>: Move up.</li>
- <li><kbd>Ctrl</kbd> + <kbd>Down</kbd>: Move down.</li>
- <li><kbd>Ctrl</kbd> + <kbd>Home</kbd>: Move to the top of the column.</li>
- <li><kbd>Ctrl</kbd> + <kbd>End</kbd>: Move to the end of the column.</li>
-</ul>
-<p>If multiple cards are selected, the keyboard shortcuts work only if the
- selection consists of a continuous sequence of cards.</p>
-<h3>Editing a card</h3>
-<p>Every card on a board is a regular note. To edit the note associated with
- a card, click or tap the card, or press <kbd>Space</kbd> when the card is
- selected. The note will open in a Quick Edit dialog, where you can modify
- it. You can also open the note in a new tab, split, or window by using
- the&nbsp;<span class="tn-icon bx bx-link-external"></span> <em>Open note</em> submenu
- in the card's context menu. To open the note in a new tab on the desktop
- version, you can also click or tap the&nbsp;<span class="tn-icon bx bx-link-external"></span> <em>Open note</em> menu
- item directly, without opening its submenu.</p>
-<p>To change the title or icon of a card, use one of the following methods:</p>
-<ul>
- <li><strong>Using a mouse:</strong> Place the mouse pointer over the card,
- and then click the&nbsp;<span class="tn-icon bx bx-rename"></span> button.</li>
- <li><strong>On mobile:</strong> Hold the card until the side toolbar appears,
- and then tap the&nbsp;<span class="tn-icon bx bx-rename"></span> button.</li>
- <li><strong>Using the keyboard:</strong> Select a card, and then press <kbd>F2</kbd>.</li>
- <li><em>Using the context menu:</em> Open the card's context menu and select&nbsp;<span
- class="tn-icon bx bx-rename"></span> <em>Edit title &amp; icon</em>.</li>
-</ul>
-<p>You can then enter a new name and select another icon. To move the keyboard
- focus from the title field to the icon selector, press <kbd>Shift</kbd> + <kbd>Tab</kbd>.
- Click or tap anywhere outside the card, or press <kbd>Enter</kbd>, to apply
- the change. Press <kbd>Esc</kbd> to discard the changes.</p>
-<p>Each card can be tinted with a different color. Open the card's context
- menu and select the desired color. If no color is assigned, the card inherits
- the column color.</p>
-<aside class="admonition important">
- <p>The title, icon, and color of a card are the same as those of the corresponding
- note. If that note exists in multiple locations in the tree, any change
- to its title, icon, or color on the board will apply in those locations
- as well, not only on the board.</p>
-</aside>
-<h3>Archiving a card</h3>
-<p>A card can be hidden from the board without deleting it by using the&nbsp;<span
- class="tn-icon bx bx-archive-in"></span> <em>Archive note</em> command from
- the card's context menu.</p>
-<p>To show archived cards again, go to&nbsp;<span class="tn-icon bx bx-cog"></span> <em>Collection options</em> and
- toggle&nbsp;<span class="tn-icon bx bx-archive-in"></span> <em>Show archived notes</em>,
- or turn on <em>Show archived cards and columns</em> in <a class="reference-link"
- href="#root/_help_8YBEPzcpUgxw">Note menu</a> → <em>Board properties</em> (under
- the <em>Included notes</em> section). Archived cards will appear faded. To
- restore one, open its context menu and select&nbsp;<span class="tn-icon bx bx-archive-out"></span> <em>Unarchive note</em>.</p>
-<aside
-class="admonition warning">
- <p>Archiving a card sets the <code>#archived</code> flag on its note. If the
- note exists in multiple locations in the tree, it will appear archived
- in those locations as well. Read more about&nbsp;<a class="reference-link"
- href="#root/_help_MKmLg5x6xkor">Archived Notes</a>.</p>
-</aside>
-<h3>Deleting a card</h3>
-<p>You can remove one or more cards from the board and delete their associated
- notes by using the&nbsp;<span class="tn-icon bx bx-trash"></span> <em>Delete note…</em> command
- from the card's context menu, or by pressing <kbd>Shift</kbd> + <kbd>Delete</kbd>.
- On mobile, hold the card until the side toolbar appears, and then tap the&nbsp;<span
- class="tn-icon bx bx-trash"></span> button.</p>
-<h4>Removing a card from the board without deleting the note</h4>
-<p>To remove a card from the board's columns while keeping its note, open
- the card's context menu and select&nbsp;<span class="tn-icon bx bx-task-x"></span> <em>Remove from column</em>,
- or press <kbd>Delete</kbd>. On mobile, hold the card until the side toolbar
- appears, and then tap the&nbsp;<span class="tn-icon bx bx-task-x"></span> button.</p>
-<p>This command is not available when the inbox column is enabled. Instead,
- drag the card to the inbox column to achieve the same result.</p>
-<p>The note remains in the board collection but is not assigned to any column.
- To see it on the board again, enable the inbox column.</p>
-<aside class="admonition note">
- <p>Under the hood, removing a card simply unsets the note's grouping attribute.</p>
-</aside>
-<h3>Working with custom card attributes</h3>
-<p>By default, the face of a card displays a minimal set of information:
- the title, icon, and color. In some cases, this may not provide enough
- useful information at a glance. You can extend the card to display extra
- information, called card attributes, such as a due date, priority, completion
- status, or any other information you need. Card attributes use the same
- principles as&nbsp;<a class="reference-link" href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>.</p>
-<h4>Creating a new attribute</h4>
-<p>To create a new attribute, follow these steps:</p>
-<ol>
- <li>Go to&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a> → <em>Board properties</em>,
- find the <em>Card attributes</em> section, and then press the&nbsp;<span
- class="tn-icon bx bx-plus"></span> <em>Create a new attribute</em> button.</li>
- <li>Enter a name for the attribute. This is the internal name used by Trilium,
- so do not use spaces or special characters.</li>
- <li>Select a type (text, number, checkbox, and so on).</li>
- <li>Set the display name. This is the name shown on the card.</li>
- <li>Press <em>Save &amp; close</em>.</li>
-</ol>
-<aside class="admonition note">
- <p>For each newly created attribute, Trilium creates an attribute definition
- on the board collection note. A card displays the attributes declared as
- inheritable on the board note, as well as any attribute the card gets a
- definition for from elsewhere, for example through&nbsp;<a class="reference-link"
- href="#root/_help_KC1HB96bqqHX">Templates</a>&nbsp;or another parent note
- it is cloned under. Attributes that only the cards define are listed after
- the board's own.</p>
-</aside>
-<p>Here is an example of the attributes you can define for a typical Kanban
- board used to track tasks:</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Attribute name</th>
- <th>Attribute type</th>
- <th>Attribute display name</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>dueDate</td>
- <td>Date &amp; Time</td>
- <td>Due date</td>
- </tr>
- <tr>
- <td>priority</td>
- <td>Select (options: Low, Medium, High, Urgent)</td>
- <td>Priority</td>
- </tr>
- <tr>
- <td>done</td>
- <td>Checkbox</td>
- <td>Done</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<h4>Modifying the values of custom attributes</h4>
-<p>To set the value of a custom attribute, click or tap the card, and then
- enter or select the desired value in the dialog header.</p>
-<p>For attributes of the “select” or “checkbox” type, you can quickly change
- the value by using the card's context menu under the <em>Attributes</em> section.</p>
-<h4>Reordering, hiding, redefining, and deleting custom attributes</h4>
-<p>Go to&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a> → <em>Board properties</em>.
- Under the <em>Card attributes</em> section, you can:</p>
-<ul>
- <li>Hold the <strong>=</strong> handle shown beside an attribute, and then drag
- the item up or down to reorder the attributes. This determines the order
- in which the attributes are displayed on the card.</li>
- <li>Turn off the toggle to hide an attribute from the card's face. The attribute
- remains available when you edit the card. For the current grouping attribute,
- the toggle is disabled.</li>
- <li>Press the&nbsp;<span class="tn-icon bx bxs-edit"></span> button to modify
- the definition of an attribute.</li>
- <li>Press the&nbsp;<span class="tn-icon bx bx-trash"></span> button to delete
- the attribute and all its values from every note in the board collection.</li>
-</ul>
-<p>Attributes that the cards get from a template or another parent note can
- be reordered and hidden here, but not modified or deleted. Edit them on
- the note that defines them.</p>
-<p>If cards define an attribute with the same name but a different type or
- different select options, for example through two different templates,
- or if a card overrides the board's definition with its own, the attribute
- is marked <em>Multiple definitions</em>. Such an attribute is sorted as
- text and does not appear in the card's context menu.</p>
-<h3>Managing card templates</h3>
-<p>When you create a new card, Trilium offers four templates by default: <em>Text</em>, <em>Markdown</em>, <em>Canvas</em>,
- and <em>Spreadsheet</em>. You can customize this list to include other note
- types or custom templates with predefined placeholder content and prefilled
- card attributes.</p>
-<p>To customize the card templates, go to&nbsp;<a class="reference-link"
- href="#root/_help_8YBEPzcpUgxw">Note menu</a> → <em>Board properties</em> and
- find <em>Card templates</em>. Here you can:</p>
-<ul>
- <li>Include a note type or note template already created in your knowledge
- base by pressing the&nbsp;<span class="tn-icon bx bx-list-plus"></span> <em>Add existing template</em> button
- and then selecting the desired note type or template.</li>
- <li>Create a new template by pressing the&nbsp;<span class="tn-icon bx bx-plus"></span> <em>Create a new template</em> button.
- The template editor will open, where you can define the icon, title, default
- attribute values, and default content. The note template will be created
- as a child of the board collection.</li>
- <li>Press the&nbsp;<span class="tn-icon bx bx-x"></span> button to remove a
- template from the list. The template is removed only from the list, not
- deleted from your knowledge base. You can add it again using&nbsp;<span
- class="tn-icon bx bx-list-plus"></span> <em>Add existing template</em>.</li>
- <li>Press the&nbsp;<span class="tn-icon bx bx-dots-vertical-rounded"></span> button
- to open a dropdown that lets you edit, open in a new window, duplicate,
- or delete a template. This button is visible only for custom note templates.</li>
- <li>Hold the <strong>=</strong> handle shown beside a template, and then drag
- the item up or down to reorder the templates. This determines the order
- in which templates are listed in the template dropdown when you create
- a new card. You can move the most frequently used templates to the top
- for faster access.</li>
-</ul>
-<h3>Grouping cards</h3>
-<p>On a board, cards are grouped into columns. The column to which a card
- belongs is determined by the value of the <strong>grouping attribute</strong>,
- which is a regular attribute of the card's note.</p>
-<p>By default, boards use the <strong>Status</strong> attribute as the grouping
- attribute. When you move a card to a column called “Waiting on Customer”,
- the card's Status attribute is set to “Waiting on Customer”.</p>
-<aside
-class="admonition note">
- <p>Under the hood, the Status attribute is declared on the board collection
- note with the name <code>status</code>. It is a select-type attribute that
- is inheritable and promoted. Each select option becomes a column, and each
- new column created on the board extends the list of options.</p>
-</aside>
-<h4>Creating a new grouping attribute</h4>
-<p>To quickly create a new grouping attribute:</p>
-<ol>
- <li>Open the&nbsp;<span class="tn-icon bx bx-category-alt"></span> <em>Group by</em> dropdown
- in the board header and select&nbsp;<span class="tn-icon bx bx-plus"></span> <em>Create a new attribute</em>.</li>
- <li>Fill in the <em>Name</em> field. This is used internally by Trilium, so
- do not use spaces or special characters.</li>
- <li>Enter the <em>Display name</em>. This is the attribute name shown in the
- dropdown list.</li>
- <li>Press <em>Save &amp; close</em>.</li>
-</ol>
-<aside class="admonition tip">
- <p>Because the grouping attribute is a regular card attribute, you can also
- create it in <em>Board properties</em>. Make sure you set the attribute
- type to “select”.</p>
-</aside>
-<h4>Switching the grouping attribute</h4>
-<p>Switching the grouping attribute lets you view your cards by priority,
- category, or any other custom grouping attribute. You can switch the grouping
- attribute at any time by using the&nbsp;<span class="tn-icon bx bx-category-alt"></span> <em>Group by</em> dropdown
- in the board header. You can also change it using the <code>#board:groupBy=&lt;_attribute name_&gt;</code> label.</p>
-<aside
-class="admonition warning">
- <p>The order of cards in manually sorted columns corresponds to their positions
- within the board collection subtree. This means that the card order is
- shared across all views, regardless of the grouping attribute. Reordering
- notes in one view will also reorder them in other views that use a different
- grouping attribute.</p>
-</aside>
-<h4>Deleting a grouping attribute</h4>
-<p>To delete a grouping attribute, go to&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a> → <em>Board properties</em>,
- find the attribute under the <em>Card attributes</em> section, and press
- the corresponding&nbsp;<span class="tn-icon bx bx-trash"></span> button.</p>
-<h4>Grouping by relations</h4>
-<p>A more advanced use case is grouping by <a href="#root/_help_Cq5X6iKQop6R">Relations</a>.</p>
-<p>In this mode:</p>
-<ul>
- <li>The columns represent the <em>target notes</em> of a relation.</li>
- <li>When creating a new column, you select a note instead of entering a column
- name.</li>
- <li>The column icon matches the target note.</li>
- <li>Moving notes between columns changes their relations.</li>
- <li>Renaming an existing column changes the target note for all notes in that
- column.</li>
-</ul>
-<p>Using relations instead of labels has several benefits:</p>
-<ul>
- <li>The status or grouping of notes is visible outside the Kanban board, for
- example, on the&nbsp;<a class="reference-link" href="#root/_help_bdUJEHsAPYQR">Note Map</a>.</li>
- <li>A column takes its title and icon from the target note, so renaming that
- note anywhere in the tree renames the column.</li>
-</ul>
-<p>To use relations for grouping:</p>
-<ol>
- <li>
- <p>Create a Kanban board from scratch rather than from a template.</p>
- </li>
- <li>
- <p>Assign <code>#viewType=board #hidePromotedAttributes</code> to emulate the
- default template.</p>
- </li>
- <li>
- <p>Set <code>#board:groupBy</code> to the name of a relation, <strong>including the</strong> <code>~</code> <strong>prefix</strong> (for
- example, <code>~status</code>).</p>
- </li>
- <li>
- <p>Optionally, use&nbsp;<a class="reference-link" href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;to
- make changing the status within the note easier:</p><pre><code class="language-text-x-trilium-auto">#relation:status(inheritable)="promoted,alias=Status,single"</code></pre>
- </li>
-</ol>
-<h2>Searching and filtering the board</h2>
-<p>You can search for cards using the search box at the top of the board.
- Enter your keywords, and then press the&nbsp;<span class="tn-icon bx bx-search"></span> button
- in the search field or press <kbd>Enter</kbd>. Only cards whose titles,
- content, or attribute values match the query will be displayed. Columns
- without results will be temporarily collapsed to make room for the matching
- cards. Press the&nbsp;<span class="tn-icon bx bx-x"></span> button in the
- search field to clear the search and display all cards again.</p>
-<h3>Advanced filtering</h3>
-<p>If you need to refine the view to display only cards matching specific
- criteria beyond a regular text search, you can use Trilium's search query
- syntax. Here are some example queries:</p>
-<p>Display only cards whose <strong>Priority</strong> attribute is set to “Low”:</p><pre><code class="language-text-x-trilium-auto">#priority=Low</code></pre>
-<p>Display only cards whose <strong>Issue Category</strong> is set to “Software”
- and whose <strong>Site</strong> is set to either “Office” or “Factory”:</p><pre><code class="language-text-x-trilium-auto">#issueCategory="Software" AND (#site="Office" OR #site="Factory")</code></pre>
-<p>Display only cards with a <strong>Due Date</strong> in the next seven days
- that are not yet marked as <strong>Done</strong>:</p><pre><code class="language-text-x-trilium-auto">#dueDate &gt;= TODAY AND #dueDate &lt;= TODAY+7 AND #!done</code></pre>
-<p>The filter persists even after you close the tab. When you reopen the
- collection, the filter remains active until you clear the search query
- by using the&nbsp;<span class="tn-icon bx bx-x"></span> button.</p>
-<h2>Linking to a column or a card</h2>
-<p>You can create a link that opens the board and points out a specific column
- or card. Open the column menu or the card’s context menu, select&nbsp;<span
- class="tn-icon bx bx-copy"></span> <em>Copy reference</em>, and then paste
- the link where you need it.</p>
-<p>In a text note, the pasted link displays the title, icon, and color of
- the column or card it points to. In a Markdown or code note, the plain
- link address is pasted instead. Opening the link scrolls the board to the
- column or card and focuses it. If the column belongs to a different grouping
- attribute, the board switches to that attribute first.</p>
-<h2>Read-only boards</h2>
-<p>A board marked as <a href="#root/_help_CoFPLs3dRlXc">read-only</a> only
- shows its cards. It has no buttons to add a card or a column, column and
- card titles can't be renamed, and column icons can't be changed. Cards
- and columns can't be dragged, moved or deleted with the keyboard, and notes
- dragged in from the note tree aren't added. The context menus of a card
- or a column keep only the entries that change nothing, such as opening
- the note or <span class="tn-icon bx bx-copy"></span> <em>Copy reference</em>,
- and the board's own menu doesn't open. The cards can still be grouped by
- another attribute, but the choice isn't saved, and no new grouping attribute
- can be created.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/List View.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/List View.html
deleted file mode 100644
index 7a35c26d03..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/List View.html
+++ /dev/null
@@ -1,61 +0,0 @@
-<figure class="image">
- <img style="aspect-ratio:1387/758;" src="List View_image.png" width="1387"
- height="758">
-</figure>
-<p>List view is similar to&nbsp;<a class="reference-link" href="#root/_help_8QqnMzx393bx">Grid View</a>,
- but in the list view mode, each note is displayed in a single row with
- only the title and the icon of the note being visible by the default. By
- pressing the <span class="tn-icon bx bx-chevron-right"></span> expand button
- it's possible to view the content of the note, as well as the children
- of the note (recursively).</p>
-<p>In the example above, the "Node.js" note on the left panel contains several
- child notes. The right panel displays the content of these child notes
- as a single continuous document.</p>
-<h3>Creating a new table</h3>
-<p>Right click on an existing note in the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;and select <em>Insert child note</em> → <em>Collection</em> → <em>List View</em>.</p>
-<h2>Interaction</h2>
-<ul>
- <li>Each note can be expanded or collapsed by clicking on the <span class="tn-icon bx bx-chevron-right"></span> arrow
- to the left of the title.</li>
- <li>In the&nbsp;<a class="reference-link" href="#root/_help_CssoWBu8I7jF">Collection Properties</a>,
- there are buttons to expand (<span class="tn-icon bx bx-move-vertical"></span>)
- and to collapse (<span class="tn-icon bx bx-layer-minus"></span>) all notes
- easily.</li>
-</ul>
-<h2>Printing and exporting to PDF</h2>
-<p>Since v0.100.0, list collections can be <a href="#root/_help_NRnIZmSMc5sj">printed or exported to PDF</a>.</p>
-<p>A printed list collection will print all the notes in the collection,
- in the right order and preserving the full hierarchy.</p>
-<p>If exported to PDF within the desktop application, there is additional
- functionality:</p>
-<ul>
- <li>The table of contents of the PDF will reflect the structure of the notes.</li>
- <li>Reference and inline links to other notes within the same hierarchy will
- be functional (will jump to the corresponding page). If a link refers to
- a note that is not in the printed hierarchy, it will be unlinked.</li>
-</ul>
-<h2>Expanding and collapsing multiple notes at once</h2>
-<p>Apart from individually expanding or collapsing notes, it's also possible
- to expand or collapse them all at once. To do so, go to the&nbsp;<a class="reference-link"
- href="#root/_help_CssoWBu8I7jF">Collection Properties</a>&nbsp;and look
- for the corresponding button.</p>
-<p>By default, the <em>Expand</em> (<span class="tn-icon bx bx-move-vertical"></span>)
- button will only expand the direct children (first level) of the collection.
- Starting with v0.100.0, it's possible to expand multiple levels of notes
- using the arrow button next to the button.</p>
-<p>Manually expanded notes will reset if the application/tab is closed and
- then the collection is visited again. However notes automatically expanded/collapsed
- via the buttons in&nbsp;<a class="reference-link" href="#root/_help_CssoWBu8I7jF">Collection Properties</a>&nbsp;will
- persist.</p>
-<aside class="admonition tip">
- <p>By design, the UI provides only a handful of levels of depth for expanding
- notes (direct children, 2-5, all levels). It's also possible to specify
- any desired depth by manually setting the <a href="#root/_help_HI6GBBIduIgv">corresponding label</a>.
- For example: <code>#expanded=100</code> to expand up to 100 levels of depth.</p>
-</aside>
-<aside class="admonition note">
- <p>From a performance standpoint, the List collection is efficient since
- it does not load child notes unless the notes are actually expanded. Expanding
- the list for a significantly large hierarchy can cause slow-downs.</p>
-</aside>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/List View_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/List View_image.png
deleted file mode 100644
index 61a9d82496..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/List View_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Presentation.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Presentation.html
deleted file mode 100644
index efa3f75d6f..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Presentation.html
+++ /dev/null
@@ -1,141 +0,0 @@
-<figure class="image">
- <img style="aspect-ratio:1120/763;" src="Presentation_image.png" width="1120"
- height="763">
-</figure>
-<p>The Presentation view allows the creation of slideshows directly from
- within Trilium.</p>
-<h3>Creating a new presentation</h3>
-<p>Right click on an existing note in the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;and select <em>Insert child note</em> → <em>Collection</em> → <em>Presentation</em>.</p>
-<h2>How it works</h2>
-<ul>
- <li>Each slide is a child note of the collection.</li>
- <li>The order of the child notes determines the order of the slides.</li>
- <li>Unlike traditional presentation software, slides can be laid out both
- horizontally and vertically (see below for more information).</li>
- <li>Direct children will be laid out horizontally and the children of those
- will be laid out vertically. Children deeper than two levels of nesting
- are ignored.</li>
-</ul>
-<h2>Interaction and navigation</h2>
-<p>In the floating toolbar (top-right):</p>
-<ul>
- <li><span class="tn-icon bx bx-edit"></span> <em>Edit this slide</em> button
- to go to the corresponding note of the current slide. A <a href="#root/_help_CoFPLs3dRlXc">read-only</a> presentation
- doesn't show it.</li>
- <li>Press the <span class="tn-icon bx bx-grid-horizontal"></span> Overview button
- (or the <kbd>O</kbd> key) to show a birds-eye view of the slides. Press the
- button again to disable it.</li>
- <li>Press the <span class="tn-icon bx bx-fullscreen"></span> “Start presentation”
- button to show the presentation in full-screen.</li>
-</ul>
-<p>The following keyboard shortcuts are supported:</p>
-<ul>
- <li>Press <kbd>←</kbd> and <kbd>→</kbd> (or <kbd>H</kbd> and <kbd>L</kbd>) to go
- to the slide on the left or on the right (horizontal).</li>
- <li>Press <kbd>↑</kbd> and <kbd>↓</kbd> &nbsp;(or <kbd>K</kbd> and <kbd>J</kbd>)
- to go to the upward or downward slide (vertical).</li>
- <li>Press <kbd>Space</kbd> and <kbd>Shift</kbd> + <kbd>Space</kbd> or &nbsp;to go
- to the next/previous slide in order.</li>
- <li>And a few more, press <kbd>?</kbd> to display a popup with all the supported
- keyboard combinations.</li>
-</ul>
-<h2>Vertical slides and nesting</h2>
-<p>Unlike traditional presentation software such as Microsoft PowerPoint,
- the slides in Trilium can be laid out horizontally or vertically in order
- to create depth or better organize the slides by topic.</p>
-<p>This horizontal/vertical organization affects transitions (especially
- on the “slide” transition), however it is most noticeable in navigation.</p>
-<ul>
- <li>Pressing <kbd>←</kbd> and <kbd>→</kbd> will navigate through slides horizontally,
- thus skipping vertical notes under the current slide. This is useful to
- skip entire chapters/related slides.</li>
- <li>Pressing <kbd>↑</kbd> and <kbd>↓</kbd> will navigate through the vertical
- slides at the current level.</li>
- <li>Pressing <kbd>Space</kbd> and <kbd>Shift</kbd> + <kbd>Space</kbd> will go to
- the next/previous slide in order, regardless of the direction. This is
- generally the key combination to use when presenting.</li>
- <li>The arrows on the bottom-right of the slide will also reflect this navigation
- scheme.</li>
-</ul>
-<figure class="image image-style-align-right image_resized" style="width:55.57%;">
- <img style="aspect-ratio:890/569;" src="1_Presentation_image.png" width="890"
- height="569">
-</figure>
-<p>All direct children of the collection will be laid out horizontally. If
- a direct child also has children, those children will be placed as vertical
- slides.</p>
-<p>In the following example, the note structure is as follows:</p>
-<ul>
- <li>Presentation collection
- <ul>
- <li>Trilium Notes (demo page)</li>
- <li>“Introduction” slide
- <ul>
- <li>“The challenge of personal knowledge management”</li>
- <li>“Note-taking structures”</li>
- </ul>
- </li>
- <li>“Demo &amp; Feature highlights” slide
- <ul>
- <li>“Really fast installation process”</li>
- <li>Video slide</li>
- </ul>
- </li>
- </ul>
- </li>
-</ul>
-<h2>Customization</h2>
-<p>At collection level, it's possible to adjust:</p>
-<ul>
- <li>The theme of the entire presentation to one of the predefined themes by
- going to the&nbsp;<a class="reference-link" href="#root/_help_CssoWBu8I7jF">Collection Properties</a>&nbsp;and
- looking for the <em>Theme</em> option.</li>
- <li>It's currently not possible to create custom themes, although it is planned.</li>
- <li>Note that it is note possible to alter the CSS via&nbsp;<a class="reference-link"
- href="#root/_help_AlhDUqhENtH7">Custom app-wide CSS</a>&nbsp;because the
- slides are rendered isolated (in a shadow DOM).</li>
-</ul>
-<p>At slide level:</p>
-<ul>
- <li>It's possible to adjust the background color of a slide by using the <a
- href="#root/_help_OFXdgB2nNk1F">predefined promoted attribute</a> for the
- color or manually setting <code>#slide:background</code> to a hex color.</li>
- <li>More complex backgrounds can be achieved via gradients. There's no UI
- for it; it has to be set via <code>#slide:background</code> to a CSS gradient
- definition such as: <code>linear-gradient(to bottom, #283b95, #17b2c3)</code>.</li>
-</ul>
-<h2>Tips and tricks</h2>
-<ul>
- <li>Text notes generally respect the formatting (bold, italic, foreground
- and background colors) and font size. Code blocks and tables also work.</li>
- <li>Try using more than just text notes, the presentation uses the same mechanism
- as <a href="#root/_help_R9pX4DGra2Vt">shared notes</a> and&nbsp;<a class="reference-link"
- href="#root/_help_0ESUbbAxVnoK">Note List</a>&nbsp;so it should be able
- to display&nbsp;<a class="reference-link" href="#root/_help_s1aBHPd79XYj">Mermaid Diagrams</a>,&nbsp;<a
- class="reference-link" href="#root/_help_grjYqerjn243">Canvas</a>&nbsp;and&nbsp;<a
- class="reference-link" href="#root/_help_gBbsAeiuUxI5">Mind Map</a>&nbsp;in
- full-screen (without the interactivity).
- <ul>
- <li>
- <p>Consider using a transparent background for&nbsp;<a class="reference-link"
- href="#root/_help_grjYqerjn243">Canvas</a>, if the slides have a custom
- background (go to the hamburger menu in the Canvas, press the button select
- a custom color and write <code>transparent</code>).</p>
- </li>
- <li>
- <p>For&nbsp;<a class="reference-link" href="#root/_help_s1aBHPd79XYj">Mermaid Diagrams</a>,
- some of them have a predefined background which can be changed via the
- frontmatter. For example, for XY-charts:</p><pre><code class="language-text-x-trilium-auto">---
-config:
- themeVariables:
- xyChart:
- backgroundColor: transparent
----</code></pre>
- </li>
- </ul>
- </li>
-</ul>
-<h2>Under the hood</h2>
-<p>The Presentation view uses <a href="https://revealjs.com/">Reveal.js</a> to
- handle the navigation and layout of the slides.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Presentation_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Presentation_image.png
deleted file mode 100644
index b87b47a4b5..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Presentation_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Table.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Table.html
deleted file mode 100644
index e4f8014d57..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Table.html
+++ /dev/null
@@ -1,195 +0,0 @@
-<figure class="image">
- <img style="aspect-ratio:1050/259;" src="Table_image.png" width="1050"
- height="259">
-</figure>
-<p>The table view displays information in a grid, where the rows are individual
- notes and the columns are&nbsp;<a class="reference-link" href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>.
- In addition, values are editable.</p>
-<h2>How it works</h2>
-<p>The tabular structure is represented as such:</p>
-<ul>
- <li>Each child note is a row in the table.</li>
- <li>If child rows also have children, they will be displayed under an expander
- (nested notes).</li>
- <li>Each column is a <a href="#root/_help_OFXdgB2nNk1F">promoted attribute</a> that
- is defined on the Collection note.
- <ul>
- <li>Actually, both promoted and unpromoted attributes are supported, but it's
- a requirement to use a label/relation definition.</li>
- <li>The promoted attributes are usually defined as inheritable in order to
- show up in the child notes, but it's not a requirement.</li>
- </ul>
- </li>
- <li>If there are multiple attribute definitions with the same <code>name</code>,
- only one will be displayed.</li>
- <li>If an attribute definition has multiple values, they will all be grouped
- under a single column, with chips indicating individual values.</li>
-</ul>
-<p>There are also a few predefined columns:</p>
-<ul>
- <li>The current item number, identified by the <code>#</code> symbol.
- <ul>
- <li>This simply counts the note and is affected by sorting.</li>
- </ul>
- </li>
- <li><a class="reference-link" href="#root/_help_m1lbrzyKDaRB">Note ID</a>,
- representing the unique ID used internally by Trilium</li>
- <li>The title of the note.</li>
-</ul>
-<h2>Interaction</h2>
-<h3>Creating a new table</h3>
-<p>Right click on an existing note in the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;and select <em>Insert child note</em> → <em>Collection</em> → <em>Table</em>.</p>
-<h3>Adding columns</h3>
-<p>Each column is a <a href="#root/_help_OFXdgB2nNk1F">promoted or unpromoted attribute</a> that
- is defined on the Collection note.</p>
-<p>To create a new column, either:</p>
-<ul>
- <li>Press <em>Add new column</em> at the bottom of the table.</li>
- <li>Right click on an existing column and select Add column to the left/right.</li>
- <li>Right click on the empty space of the column header and select <em>Label</em> or <em>Relation</em> in
- the <em>New column</em> section.</li>
-</ul>
-<h3>Adding new rows</h3>
-<p>Each row is actually a note that is a child of the Collection note.</p>
-<p>To create a new note, either:</p>
-<ul>
- <li>Press <em>Add new row</em> at the bottom of the table.</li>
- <li>Right click on an existing row and select <em>Insert row above, Insert child note</em> or <em>Insert row below</em>.</li>
-</ul>
-<p>By default it will try to edit the title of the newly created note.</p>
-<p>Alternatively, the note can be created from the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;or <a href="#root/_help_CdNpE2pqjmI6">scripting</a>.</p>
-<h3>Context menu</h3>
-<p>There are multiple menus:</p>
-<ul>
- <li>Right clicking on a column, allows:
- <ul>
- <li>Sorting by the selected column and resetting the sort.</li>
- <li>Hiding the selected column or adjusting the visibility of every column.</li>
- <li>Adding new columns to the left or the right of the column.</li>
- <li>Editing the current column.</li>
- <li>Deleting the current column.</li>
- </ul>
- </li>
- <li>Right clicking on the space to the right of the columns, allows:
- <ul>
- <li>Adjusting the visibility of every column.</li>
- <li>Adding new columns.</li>
- </ul>
- </li>
- <li>Right clicking on a row, allows:
- <ul>
- <li>Opening the corresponding note of the row in a new tab, split, window
- or quick editing it.</li>
- <li>Inserting a new note above or below the selected row. These options are
- only enabled if the table is not sorted.</li>
- <li>Inserting a new child note for the selected row.</li>
- <li>Deleting the row.</li>
- </ul>
- </li>
-</ul>
-<h3>Editing data</h3>
-<p>Simply click on a cell within a row to change its value. The change will
- not only reflect in the table, but also as an attribute of the corresponding
- note.</p>
-<ul>
- <li>The editing will respect the type of the promoted attribute, by presenting
- a normal text box, a number selector or a date selector for example.</li>
- <li>It also possible to change the title of a note.</li>
- <li>Editing relations is also possible
- <ul>
- <li>Simply click on a relation and it will become editable. Enter the text
- to look for a note and click on it.</li>
- <li>To remove a relation, remove the title of the note from the text box and
- click outside the cell.</li>
- </ul>
- </li>
-</ul>
-<h3>Editing columns</h3>
-<p>It is possible to edit a column by right clicking it and selecting <em>Edit column…</em> This
- will basically change the label/relation definition at the collection level.</p>
-<p>If the <em>Name</em> field of a column is changed, this will trigger a batch
- operation in which the corresponding label/relation will be renamed in
- all the children.</p>
-<h3>Read-only tables</h3>
-<p>On a <a href="#root/_help_CoFPLs3dRlXc">read-only</a> table, the cells can't
- be edited and the rows can't be dragged. The <em>New row</em> and <em>New column</em> buttons
- are hidden, and the context menus offer only what leaves the notes as they
- are: sorting and hiding columns, and opening the notes. Columns can still
- be resized and reordered, but the layout isn't saved. The <em>Table properties</em> dialog
- isn't available.</p>
-<h2>Working with the data</h2>
-<h3>Sorting by column</h3>
-<p>By default, the order of the notes matches the order in the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>. However, it is possible
- to sort the data by the values of a column:</p>
-<ul>
- <li>To do so, simply click on a column.</li>
- <li>To switch between ascending or descending sort, simply click again on
- the same column. The arrow next to the column will indicate the direction
- of the sort.</li>
- <li>To disable sorting and fall back to the original order, right click any
- column on the header and select <em>Clear sorting.</em>
- </li>
-</ul>
-<h3>Reordering and hiding columns</h3>
-<ul>
- <li>Columns can be reordered by dragging the header of the columns.</li>
- <li>Columns can be hidden or shown by right clicking on a column and clicking
- the item corresponding to the column.</li>
-</ul>
-<h3>Reordering rows</h3>
-<p>Notes can be dragged around to change their order. To do so, move the
- mouse over the three vertical dots near the number row and drag the mouse
- to the desired position.</p>
-<p>This will also change the order of the note in the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>.</p>
-<p>Reordering does have some limitations:</p>
-<ul>
- <li>If the parent note has <code>#sorted</code>, reordering will be disabled.</li>
- <li>If using nested tables, then reordering will also be disabled.</li>
- <li>Currently, it's possible to reorder notes even if column sorting is used,
- but the result might be inconsistent.</li>
-</ul>
-<h3>Nested trees</h3>
-<p>If the child notes of the collection also have their own child notes,
- then they will be displayed in a hierarchy.</p>
-<p>Next to the title of each element there will be a button to expand or
- collapse. By default, all items are expanded.</p>
-<p>Since nesting is not always desirable, it is possible to limit the nesting
- to a certain number of levels or even disable it completely. To do so,
- go to <a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a> → <em>Table properties</em> and
- set <em>Maximum nesting depth</em> (under the <em>Included notes</em> section),
- or set the <code>#maxNestingDepth</code> <a href="#root/_help_HI6GBBIduIgv">label</a> of
- the collection:</p>
-<ul>
- <li><code>0</code> disables nesting, showing only the children of the collection.</li>
- <li><code>1</code> also shows their children, <code>2</code> the level below
- that, and so on.</li>
- <li>Removing the label shows every level again.</li>
-</ul>
-<p>Limitations:</p>
-<ul>
- <li>While in this mode, it's not possible to reorder notes.</li>
-</ul>
-<h2>Limitations</h2>
-<ul>
- <li>There is no support to filter the rows by a certain criteria. Consider
- using the table view in search for that use case.</li>
-</ul>
-<h2>Use in search</h2>
-<p>The table view can be used in a&nbsp;<a class="reference-link" href="#root/_help_m523cpzocqaD">Saved Search</a>&nbsp;by
- adding the <code>#viewType=table</code> attribute.</p>
-<p>Unlike when used in a Collection, saved searches are not limited to the
- sub-hierarchy of a note and allows for advanced queries thanks to the power
- of the&nbsp;<a class="reference-link" href="#root/_help_eIg8jdvaoNNd">Search</a>.</p>
-<p>However, there are also some limitations:</p>
-<ul>
- <li>It's not possible to reorder notes.</li>
- <li>It's not possible to add a new row.</li>
-</ul>
-<p>Columns are supported, by being defined as&nbsp;<a class="reference-link"
- href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;to the&nbsp;<a
- class="reference-link" href="#root/_help_m523cpzocqaD">Saved Search</a>&nbsp;note.</p>
-<p>Editing is also supported.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Table_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Table_image.png
deleted file mode 100644
index 7750b698c5..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/Table_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections_collection_board.webp b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections_collection_board.webp
deleted file mode 100644
index 6ed49dd449..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections_collection_board.webp and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections_collection_calendar.webp b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections_collection_calendar.webp
deleted file mode 100644
index 34b7961e0f..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections_collection_calendar.webp and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections_collection_geomap.webp b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections_collection_geomap.webp
deleted file mode 100644
index e564fbfc6f..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections_collection_geomap.webp and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections_collection_presentation.webp b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections_collection_presentation.webp
deleted file mode 100644
index f7ae75cc3a..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections_collection_presentation.webp and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections_collection_table.webp b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections_collection_table.webp
deleted file mode 100644
index 2113caf65f..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections_collection_table.webp and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/FAQ.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/FAQ.html
deleted file mode 100644
index 030236e1c1..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/FAQ.html
+++ /dev/null
@@ -1,137 +0,0 @@
-<h2>Inspiration for the name “Trilium”</h2>
-<blockquote>
- <p>Naming software is hard. I lived in Ontario when I first started the project
- and Trillium (the flower) is sort of a provincial logo, many institutions
- in Ontario are named "Trillium [something]". So I kept hearing/reading
- it almost everyday, I liked the sound of it and its nature motif, so I
- just reused it.</p>
- <p><em>– Zadam (original Trilium maintainer)</em>
- </p>
-</blockquote>
-<aside class="admonition note">
- <p>Despite the fact that the Trillium flower has two “l"s, the Trilium application
- only has one.</p>
-</aside>
-<h2>How do I create a folder?</h2>
-<p>Trilium has no separate folder type: any note can have child notes, so
- any note can act as a folder. A note can hold its own content and have
- children at the same time, unlike a file system, which separates files
- from directories.</p>
-<p>To organize notes into a folder:</p>
-<ol>
- <li>Create a note that acts as the folder, for example "Projects".</li>
- <li>Right-click it in the <a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a> and
- select <em>Insert child note</em>, or hover over it and press the <span class="tn-icon bx bx-plus"></span> button.</li>
- <li>To move existing notes into it, drag them onto it in the tree.</li>
-</ol>
-<p>The children of a note are listed at the end of its content (see <a class="reference-link"
- href="#root/_help_0ESUbbAxVnoK">Note List</a>).</p>
-<p>If you want the note to look like a folder, with no content of its own
- and only its children shown, make it a collection instead: right-click
- in the tree, select <em>Insert child note</em> → <em>Collection</em>, then
- choose <a class="reference-link" href="#root/_help_8QqnMzx393bx">Grid View</a> or <a
- class="reference-link" href="#root/_help_mULW0Q3VojwY">List View</a>. See <a
- class="reference-link" href="#root/_help_GTwFsgaA0lCt">Collections</a> for
- the other views, such as tables, boards and calendars.</p>
-<h2>macOS support</h2>
-<p>Originally, Trilium Notes considered the macOS build unsupported. TriliumNext
- commits to make the experience on macOS as good as possible.</p>
-<p>if you find any platform-specific issues, feel free to <a href="#root/_help_wy8So3yZZlH9">report them</a>.</p>
-<h2>Translation / localisation support</h2>
-<p>The original Trilium Notes application did not support multiple languages.
- Since we believe that internationalisation is a core part of an application,
- we have added support for it.</p>
-<p>Contributions to translations are welcome.</p>
-<h2>Multi-user support</h2>
-<p>Common request is to allow multiple users collaborate, share notes etc.
- So far I'm resisting this because of these reasons:</p>
-<ul>
- <li>it's a huge feature, or rather a Pandora's box of collaboration features
- like user management, permissions, conflict resolution, real-time editing
- of a note by multiple people etc. This would be a huge amount of work.
- Trilium Notes is project made mostly by one person in free time and that's
- unlikely to change in the future.</li>
- <li>given its size it would probably pivot the attention away from my main
- focus which is a personal note-taking</li>
- <li>the assumption that only single person has access to the app simplifies
- many things, or just outright makes them possible. In multi-user app, our <a
- href="#root/_help_CdNpE2pqjmI6">scripting</a>support would be a XSS security
- hole, while with the single user assumption it's an endless customizable
- tool.</li>
-</ul>
-<h2>How to open multiple documents in one Trilium instance</h2>
-<p>This is normally not supported - one Trilium process can open only a single
- instance of a <a href="#root/_help_wX4HbRucYSDD">database</a>. However,
- you can run two Trilium processes (from one installation), each connected
- to a separate document. To achieve this, you need to set a location for
- the <a href="#root/_help_tAassRL4RSQL">data directory</a> in the <code>TRILIUM_DATA_DIR</code> environment
- variable and separate port on <code>TRILIUM_PORT</code> environment variable.
- How to do that depends on the platform, in Unix-based systems you can achieve
- that by running command such as this:</p><pre><code class="language-text-x-sh">TRILIUM_DATA_DIR=/home/me/path/to/data/dir TRILIUM_PORT=12345 trilium </code></pre>
-<p>You can save this command into a <code>.sh</code> script file or make an
- alias. Do this similarly for a second instance with different data directory
- and port.</p>
-<h2>Can I use Dropbox / Google Drive / OneDrive to sync data across multiple computers.</h2>
-<p>No.</p>
-<p>These general purpose sync apps are not suitable to sync database files
- which are open and being worked on by another application. The result is
- that they will corrupt the database file, resulting in data loss and this
- message in the Trilium logs:</p><pre><code class="language-text-x-trilium-auto">SqliteError: database disk image is malformed</code></pre>
-<p>The only supported way to sync Trilium's data across the network is to
- use a <a href="#root/_help_cbkrhQjrkKrh">sync/web server</a>.</p>
-<h2>Why database instead of flat files?</h2>
-<p>Trilium stores notes in a <a href="#root/_help_wX4HbRucYSDD">database</a> which
- is an SQLite database. People often ask why doesn't Trilium rather use
- flat files for note storage - it's fair question since flat files are easily
- interoperable, work with SCM/git etc.</p>
-<p>Short answer is that file systems are simply not powerful enough for what
- we want to achieve with Trilium. Using filesystem would mean fewer features
- with probably more problems.</p>
-<p>More detailed answer:</p>
-<ul>
- <li><a href="#root/_help_IakOLONlIfGI">clones</a> are what you might call "hard
- directory link" in filesystem lingo, but this concept is not implemented
- in any filesystem</li>
- <li>filesystems make a distinction between directory and file while there's
- intentionally no such difference in Trilium</li>
- <li>files are stored in no particular order and user can't change this</li>
- <li>Trilium allows storing note <a href="#root/_help_zEY4DaJG4YT5">attributes</a> which
- could be represented in extended user attributes but their support differs
- greatly among different filesystems / operating systems</li>
- <li>Trilium makes links / relations between different notes which can be quickly
- retrieved / navigated (e.g. for <a href="#root/_help_BCkXAVs63Ttv">note map</a>).
- There's no such support in file systems which means these would have to
- be stored in some kind of side-car files (mini-databases).</li>
- <li>Filesystems are generally not transactional. While this is not completely
- required for a note-taking application, having transactions make it way
- easier to keep notes and their metadata in predictable and consistent state.</li>
-</ul>
-<h2>Search-related Questions</h2>
-<h3>Why does search sometimes find results with typos?</h3>
-<p>Trilium uses a progressive search strategy that includes fuzzy matching
- when exact matches return fewer than 5 results. This finds notes despite
- minor typos in your search query. You can use fuzzy search operators (<code>~=</code> for
- fuzzy exact match and <code>~*</code> for fuzzy contains). See the&nbsp;<a
- class="reference-link" href="#root/_help_eIg8jdvaoNNd">Search</a>&nbsp;documentation
- for details.</p>
-<h3>How can I search for notes when I'm not sure of the exact spelling?</h3>
-<p>Use the fuzzy search operators:</p>
-<ul>
- <li><code>#title ~= "projct"</code> - finds notes with titles like "project"
- despite the typo</li>
- <li><code>note.content ~* "algoritm"</code> - finds content containing "algorithm"
- or similar words</li>
-</ul>
-<h3>Why do some search results appear before others with lower scores?</h3>
-<p>Trilium places exact matches before fuzzy matches. When you search for
- "project", notes containing exactly "project" appear before notes with
- variations like "projects" or "projection", regardless of other scoring
- factors.</p>
-<h3>How can I make my searches faster?</h3>
-<ol>
- <li>Use the "Fast search" option to search only titles and attributes (not
- content)</li>
- <li>Limit search scope using the "Ancestor" field</li>
- <li>Set a result limit to prevent loading too many results</li>
- <li>For large databases, consider archiving old notes to reduce search scope</li>
-</ol>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Feature Highlights.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Feature Highlights.html
deleted file mode 100644
index 30feb72f6c..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Feature Highlights.html
+++ /dev/null
@@ -1,98 +0,0 @@
-<p>This section presents the most important changes by version. For a full
- set of changes, please consult the change log of each release. For purposes
- of brevity, beta versions are skipped and the features gathered to the
- nearest stable version.</p>
-<ul>
- <li>v0.105.0:
- <ul>
- <li>Text notes now have a&nbsp;<a class="reference-link" href="#root/_help_VRoP0g1uHHc2">In-editor AI assistant</a>&nbsp;for
- quick proof-reading and other text-based operations that don't require
- a full chat.</li>
- </ul>
- </li>
- <li>v0.101.0:
- <ul>
- <li>A&nbsp;new layout&nbsp;has been introduced, making significant modifications
- to the UI/UX such as integrating the ribbon and the floating buttons into
- other UI elements and introducing new functionality such as the&nbsp;<a
- class="reference-link" href="#root/_help_I6p2a06hdnL6">Breadcrumb</a>.</li>
- </ul>
- </li>
- <li>v0.97.0:
- <ul>
- <li>Books are now&nbsp;<a class="reference-link" href="#root/_help_GTwFsgaA0lCt">Collections</a>.</li>
- <li><a class="reference-link" href="#root/_help_2FvYrpmOXm29">Table</a>&nbsp;is
- a new collection type displaying notes and attributes in an editable grid.</li>
- <li><a class="reference-link" href="#root/_help_ZjLYv08Rp3qC">Quick edit</a>&nbsp;is
- introduced, adding a new way to edit notes in a popup instead of opening
- a new tab. It also integrates well with&nbsp;<a class="reference-link"
- href="#root/_help_GTwFsgaA0lCt">Collections</a>.</li>
- </ul>
- </li>
- <li>v0.96.0:
- <ul>
- <li><a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;gain
- premium features thanks to a collaboration with the CKEditor team:
- <ul>
- <li><a class="reference-link" href="#root/_help_ZlN4nump6EbW">Slash Commands</a>
- </li>
- <li><a class="reference-link" href="#root/_help_pwc194wlRzcH">Text Snippets</a>
- </li>
- </ul>
- </li>
- </ul>
- </li>
- <li>v0.95.0:
- <ul>
- <li>A more friendly theme was introduced for&nbsp;<a class="reference-link"
- href="#root/_help_R9pX4DGra2Vt">Sharing</a>, with search, expandable tree,
- night mode and more.</li>
- </ul>
- </li>
- <li>v0.94.0:
- <ul>
- <li>Added integration with&nbsp;<a class="reference-link" href="#root/_help_GBBMSlVSOIGP">AI</a>&nbsp;(using
- self-hosted LLMs such as Ollama or industry standards such as ChatGPT).</li>
- </ul>
- </li>
- <li>v0.92.5:
- <ul>
- <li>Windows binaries are now signed.</li>
- <li><a class="reference-link" href="#root/_help_7DAiwaf8Z7Rz">Multi-factor authentication with TOTP</a>&nbsp;was
- introduced.</li>
- </ul>
- </li>
- <li>v0.92.4:
- <ul>
- <li>macOS binaries are now signed.</li>
- <li><a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes
- can now have adjustable&nbsp;<a class="reference-link" href="#root/_help_veGu4faJErEM">Content language &amp; Right-to-left support</a>.</li>
- <li><a class="reference-link" href="#root/_help_NRnIZmSMc5sj">Printing &amp; Exporting as PDF</a>
- </li>
- <li><a class="reference-link" href="#root/_help_rC3pL2aptaRE">Zen mode</a>
- </li>
- <li><a class="reference-link" href="#root/_help_xWbu3jpNWapp">Calendar</a>,
- allowing notes to be displayed in a monthly grid based on start and end
- dates.</li>
- </ul>
- </li>
- <li>v0.91.5:
- <ul>
- <li>Significant improvements for mobile.</li>
- <li><a class="reference-link" href="#root/_help_AgjCISero73a">Footnotes</a>&nbsp;are
- now supported in&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes.</li>
- <li>Mermaid diagrams can now be inserted inline within&nbsp;<a class="reference-link"
- href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes.</li>
- <li>The TriliumNext theme is introduced, bringing a more modern design to
- the application.</li>
- <li><a class="reference-link" href="#root/_help_81SGnPGMk7Xc">Geo Map</a>,
- displaying notes as markers on a geographical map for easy trip planning.</li>
- </ul>
- </li>
- <li>v0.90.8:
- <ul>
- <li>A new note type was introduced:&nbsp;<a class="reference-link" href="#root/_help_gBbsAeiuUxI5">Mind Map</a>
- </li>
- </ul>
- </li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Backup.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Backup.html
deleted file mode 100644
index 00889b3d7f..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Backup.html
+++ /dev/null
@@ -1,191 +0,0 @@
-<p>Trilium supports simple backup scheme where it saves copy of the&nbsp;<a
- class="reference-link" href="#root/_help_wX4HbRucYSDD">Database</a>&nbsp;on
- these events:</p>
-<ul>
- <li>once a day</li>
- <li>once a week</li>
- <li>once a month</li>
- <li>before DB migration to newer version</li>
-</ul>
-<p>So in total you'll have at most 4 backups from different points in time
- which should protect you from various problems. These backups are stored
- by default in <code>backup</code> directory placed in the <a href="#root/_help_tAassRL4RSQL">data directory</a>.</p>
-<p>This is only very basic backup solution, and you're encouraged to add
- some better backup solution - e.g. backing up the&nbsp;<a class="reference-link"
- href="#root/_help_wX4HbRucYSDD">Database</a>&nbsp;to cloud / different
- computer etc.</p>
-<p>Note that&nbsp;<a class="reference-link" href="#root/_help_cbkrhQjrkKrh">Synchronization</a>&nbsp;provides
- also some backup capabilities by its nature of distributing the data to
- other computers.</p>
-<h2>Creating a backup</h2>
-<div class="trilium-tabs">
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bx-desktop"></span>&nbsp;On the desktop app &amp;
- web client</p>
- <div class="trilium-tab-panel">
- <ol>
- <li>Go to&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a> → <em>Backup</em> and
- press the <em>Backup now</em> button.</li>
- <li>The backup creation process may take a few moments, especially for larger
- databases. A notification will inform you when the backup is complete.</li>
- <li>The backup will be saved as <code>backup-now</code> in the <em>Existing backups</em> list,
- where you can download it.</li>
- </ol>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bx-globe"></span>&nbsp;On the standalone client</p>
- <div
- class="trilium-tab-panel">
- <ol>
- <li>Go to&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a> → <em>Backup</em> and
- press the <em>Download backup</em> button.</li>
- <li>You will be prompted to restart the app. Confirm, and the app will restart
- automatically.</li>
- <li>Set a <em>backup name</em> or <em>password</em> (both optional), then press <em>Continue</em>.</li>
- <li>Press the <em>Generate and download</em> button and wait for the download
- to complete.</li>
- <li>Once you confirm the download is saved on your device, press <em>Finish</em> to
- complete</li>
- </ol>
- </div>
- </section>
-</div>
-<h2>Downloading a backup</h2>
-<ul>
- <li><strong>Desktop and web client</strong>: to download an existing backup,
- navigate to&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a> → <em>Backup</em> → <em>Existing backups</em> and
- select <em>Download</em> (<span class="tn-icon bx bx-download"></span>).</li>
- <li><strong>Standalone client</strong>: automatic backups are not supported
- in this version. You can manually create and download a backup by going
- to&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a> → <em>Backup</em> → <em>Download backup</em>.</li>
-</ul>
-<h2>Restoring a backup</h2>
-<ul>
- <li><strong>For a new Trilium instance</strong>: When setting up a new Trilium
- instance, use the <em>Restore from backup</em> option in the setup menu to
- guide you through restoring your existing backup.</li>
- <li><strong>For an existing Trilium instance</strong>: To restore a backup
- and replace your current database, go to&nbsp;<a class="reference-link"
- href="#root/_help_4TIF1oA4VQRO">Options</a> → <em>Backup</em> and click <em>Restore a backup</em>.
- You will be prompted to restart the app for the restoration process to
- begin. After restarting, you can choose to back up the existing database
- before overwriting it. Note: For the web client, use the Start Over feature
- (&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a> → <em>Database</em> → <em>Start over</em> (<span
- class="tn-icon bx bx-reset"></span>)) to switch to the setup screen and
- restore a backup.</li>
-</ul>
-<p>Next, select the backup file (.db or .tnbackup) from your device. The
- web client is optimized for handling large backups and is resilient to
- unstable network conditions, similar to the desktop application.</p>
-<p>If your database is encrypted, you will be prompted to enter the password
- used for encrypting the backup file. Without the correct password, decryption
- and restoration cannot proceed.</p>
-<p>Restoring a backup may take some time, depending on its size. Once it
- completes, Trilium will open the freshly restored database.</p>
-<h3>The alternative way for restoring a backup</h3>
-<p>Let's assume you want to restore the weekly backup (only in .db format,
- .tnbackup files are not supported by this method), here's how to do it:</p>
-<ul>
- <li>find <a href="#root/_help_tAassRL4RSQL">data directory</a> Trilium uses
- - easy way is to open "About Trilium Notes" (<span class="tn-icon bx bx-info-circle"></span>)
- from "Menu" in upper left corner and looking at "data directory"
- <ul>
- <li>I'll refer to <code>~/trilium-data</code> as data directory from now on</li>
- </ul>
- </li>
- <li>find <code>~/trilium-data/backup/backup-weekly.db</code> - this is the&nbsp;<a
- class="reference-link" href="#root/_help_wX4HbRucYSDD">Database</a>&nbsp;backup.</li>
- <li>at this point stop/kill Trilium</li>
- <li>delete <code>~/trilium-data/document.db</code>, <code>~/trilium-data/document.db-wal</code> and <code>~/trilium-data/document.db-shm</code> (latter
- two files are auto generated)</li>
- <li>copy and rename this <code>~/trilium-data/backup/backup-weekly.db</code> to <code>~/trilium-data/document.db</code>
- </li>
- <li>make sure that the file is writable, e.g. with <code>chmod 600 document.db</code>
- </li>
- <li>start Trilium again</li>
-</ul>
-<aside class="admonition warning">
- <p>If you have configured sync then you need to do it across all members
- of the sync cluster, otherwise older version (restored backup) of the document
- will be detected and synced to the newer version.</p>
-</aside>
-<h2>Changing the backup location in Trilium (desktop only)</h2>
-<p>Starting with version 0.105, the Trilium desktop client allows users to
- change the directory where backups are stored. Follow these steps to specify
- a custom backup directory:</p>
-<ol>
- <li>Navigate to&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a> → <em>Backup</em> → <em>Backup location</em>.</li>
- <li>Click the <em>Select location</em> button.</li>
- <li>Choose any writable directory on your file system. This could include
- network shares, depending on your operating system.</li>
-</ol>
-<p>Once you set a custom directory, all manual and automatic backups will
- be saved there. If the selected directory becomes unavailable, backups
- may fail or revert to the default location.</p>
-<aside class="admonition tip">
- <p>For better privacy when using unsafe backup locations, you can enable
- backup encryption, which makes the backup file unreadable without the correct
- password.</p>
-</aside>
-<h2>Backup encryption</h2>
-<p>Trilium can secure the entire content of the database backup, ensuring
- it remains unreadable unless the correct password is provided. This is
- particularly useful for storing backups in unsecured locations, like network
- shares, unencrypted external drives, or cloud services.&nbsp;</p>
-<p>Encrypted database backups use the Trilium Backup Container (.tnbackup)
- format, which relies on AES-256-GCM. This authenticated encryption mode
- scrambles the data and generates a tag confirming it hasn't been altered.
- The password itself isn't directly used as the key; it's processed through
- scrypt, a key derivation function designed to be slow and memory-intensive,
- making brute-force password guessing difficult even with powerful hardware.
- Each backup also receives a random 16-byte salt, ensuring that the same
- password never produces the same encryption key twice. Additionally, critical
- metadata such as chunk order, length, and header flags are cryptographically
- bound into the encryption (via "additional authenticated data"), preventing
- undetected tampering like reorder, truncate, or splice operations.</p>
-<h3>Enabling backup encryption</h3>
-<p>To enable encryption for automatic backups in the Desktop application:</p>
-<ol>
- <li>Go to&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a> → <em>Backup</em> → <em>Backup options</em>.</li>
- <li>Click on <em>Turn on encryption</em> and set a password.</li>
-</ol>
-<p>Once encryption is enabled, all newly created backups (both automatic
- and manual) will be encrypted with the specified password. Backups created
- prior to enabling encryption will remain unsecured.</p>
-<p>You can change the password anytime using the <em>Change password</em> button.
- The new password will apply to backups created after the change.</p>
-<p>To disable encryption, uncheck&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a> → <em>Backup</em> → <em>Enable encryption</em>.</p>
-<aside
-class="admonition note">
- <p>On some systems, a keyring may not be available for Trilium to securely
- store the encryption password. In such cases, the encryption option is
- disabled.</p>
-</aside>
-<h2>Backup compression</h2>
-<p>Database backups can be optionally compressed to minimize storage footprint.
- This method is effective primarily when the database consists largely of
- text content. However, media files (images, videos, audio), along with
- PDF, ODF, and DOCX files, are already compressed in their original formats
- and won't benefit from further compression.</p>
-<p>Compressed backups are stored using the Trilium Backup Container (.tnbackup),
- employing RFC 1952 GZIP compression.</p>
-<aside class="admonition warning">
- <p><strong>Note:</strong> Compression increases the time required for backup
- creation and restoration. It may also lead to higher CPU usage during automatic
- backups, potentially draining the battery faster on battery-powered devices.
- Enable this option only if necessary.</p>
-</aside>
-<h3>Enabling Backup Compression (Desktop Only)</h3>
-<p>To enable compression for new automatic and manual backups, navigate to&nbsp;<a
- class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a> → <em>Backup</em> → <em>Backup options</em> and
- toggle <em>Enable compression</em> to on.</p>
-<h2>Disabling backup</h2>
-<p>Although this is not recommended, it is possible to disable backup in <code>config.ini</code> in
- the <a href="#root/_help_tAassRL4RSQL">data directory</a>:</p><pre><code class="language-text-x-trilium-auto">[General]
-... some other configs
-# set to true to disable backups (e.g. because of limited space on server)
-noBackup=true</code></pre>
-<p>You can also review the <a href="#root/_help_Gzjqa934BdH4">configuration</a> file
- to provide all <code>config.ini</code> values as environment variables instead.</p>
-<p>See <a href="https://github.com/TriliumNext/Trilium/blob/master/config-sample.ini">sample config</a>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Data directory.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Data directory.html
deleted file mode 100644
index 6bffc5cf94..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Data directory.html
+++ /dev/null
@@ -1,229 +0,0 @@
-<p>Data directory contains:</p>
-<ul>
- <li><code>document.db</code> - <a href="#root/_help_wX4HbRucYSDD">database</a>
- </li>
- <li><code>config.ini</code> - instance level settings like port on which the
- Trilium application runs</li>
- <li><code>backup</code> - contains automatically <a href="#root/_help_ODY7qQn5m2FT">backup</a> of
- documents</li>
- <li><code>log</code> - contains application log files</li>
-</ul>
-<h2>Location of the data directory</h2>
-<p>Easy way how to find out which data directory Trilium uses is to look
- at the "About Trilium Notes" dialog (from "Menu" in upper left corner):</p>
-<p>
- <img src="Data directory_image.png">
-</p>
-<p>Here's how the location is decided:</p>
-<p>Data directory is normally named <code>trilium-data</code> and it is stored
- in:</p>
-<ul>
- <li><code>/home/[user]/.local/share</code> for Linux</li>
- <li><code>/home/[user]/.var/app/org.triliumnotes.Trilium/data</code> for the
- Flathub version on Linux</li>
- <li><code>C:\Users\[user]\AppData\Roaming</code> for Windows Vista and up</li>
- <li><code>/Users/[user]/Library/Application Support</code> for Mac OS</li>
- <li>user's home is a fallback if some of the paths above don't exist</li>
- <li>user's home is also a default setup for [[docker|Docker server installation]]</li>
-</ul>
-<p>If you want to back up your Trilium data, just backup this single directory
- - it contains everything you need.</p>
-<h3>Changing the location of data directory</h3>
-<p>If you want to use some other location for the data directory than the
- default one, you may change it via <code>TRILIUM_DATA_DIR</code> environment
- variable to some other location:</p>
-<div class="trilium-tabs">
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-windows"></span>&nbsp;Windows</p>
- <div class="trilium-tab-panel">
- <ol>
- <li>Press the&nbsp;<span class="tn-icon bx bxl-windows"></span> key on your
- keyboard.</li>
- <li>Search and select <em>Edit the system variables</em>.</li>
- <li>Press the <em>Environment Variables…</em> button in the bottom-right of
- the newly opened screen.</li>
- <li>On the top section (<em>User variables for [user]</em>), press the <em>New…</em> button.</li>
- <li>In the <em>Variable name</em> field insert <code>TRILIUM_DATA_DIR</code>.</li>
- <li>Press the <em>Browse Directory…</em> button and select the new directory
- where to store the database.</li>
- <li>Close all the windows by pressing the <em>OK</em> button for each of them.</li>
- </ol>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-tux"></span>&nbsp;Linux</p>
- <div class="trilium-tab-panel">
- <p>Trilium reads <code>TRILIUM_DATA_DIR</code> when it starts, so the variable
- must be set in the environment that launches it.</p>
- <aside class="admonition note">
- <p>Setting the variable does not move existing notes. To keep them, close
- Trilium and copy the old data directory to the new location first. Trilium
- creates the last folder of the path if it is missing, but not its parent
- folders.</p>
- </aside>
- <p><strong>Desktop application (.deb, .rpm, AppImage or .zip)</strong>
- </p>
- <p>To use the new location however Trilium is started (from the application
- menu, a desktop shortcut, at login or from a terminal), set the variable
- for the whole session:</p>
- <ol>
- <li>
- <p>Create the file <code>~/.config/environment.d/trilium.conf</code> with the
- following content, using the full path (<code>~</code> is not expanded in
- this file):</p><pre><code class="language-text-x-trilium-auto">TRILIUM_DATA_DIR=/home/myuser/data/my-trilium-data</code></pre>
- </li>
- <li>
- <p>Log out and log back in.</p>
- </li>
- </ol>
- <p>This works on desktops started by <code>systemd</code>, which covers most
- distributions running GNOME or KDE Plasma. On other systems, add the following
- line to <code>~/.profile</code> instead, then log out and log back in:</p><pre><code class="language-text-x-sh">export TRILIUM_DATA_DIR="$HOME/data/my-trilium-data"</code></pre>
- <p>The same line in <code>~/.bashrc</code> (or your shell's equivalent) only
- applies when Trilium is started from a terminal, not from the application
- menu.</p>
- <p><strong>Flatpak (Flathub)</strong>
- </p>
- <p>The Flathub version runs in a sandbox that cannot see the rest of the
- file system, so it needs access to the folder as well as the variable:</p><pre><code class="language-text-x-sh">flatpak override --user \
- --env=TRILIUM_DATA_DIR=/home/myuser/data/my-trilium-data \
- --filesystem=/home/myuser/data/my-trilium-data:create \
- org.triliumnotes.Trilium</code></pre>
- <p>To return to the default location, run <code>flatpak override --user --reset org.triliumnotes.Trilium</code>.
- This also removes any other overrides set for Trilium.</p>
- <p><strong>Server running as a systemd service</strong>
- </p>
- <p>Add an <code>Environment=</code> line to the <code>[Service]</code> section
- of the unit file described in&nbsp;<a class="reference-link" href="#root/_help_3tW6mORuTHnB">Packaged version for Linux</a>:</p><pre><code class="language-text-x-trilium-auto">[Service]
-Environment=TRILIUM_DATA_DIR=/var/lib/trilium-data</code></pre>
- <p>Then reload and restart the service:</p><pre><code class="language-text-x-sh">sudo systemctl daemon-reload
-sudo systemctl restart trilium</code></pre>
- <p>The user set in <code>User=</code> must be able to write to the folder.
- For Docker, see&nbsp;<a class="reference-link" href="#root/_help_rWX5eY045zbE">Using Docker</a>&nbsp;instead.</p>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-apple"></span>&nbsp;macOS</p>
- <div class="trilium-tab-panel">
- <p>You need to create a <code>.plist</code> file under <code>~/Library/LaunchAgents</code> to
- load it properly each login.</p>
- <p>To load it manually, you need to use <code>launchctl setenv TRILIUM_DATA_DIR &lt;yourpath&gt;</code>
- </p>
- <p>Here is a pre-defined template, where you just need to add your path to:</p><pre><code class="language-text-xml">&lt;?xml version="1.0" encoding="UTF-8"?&gt;
-&lt;!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"&gt;
-&lt;plist version="1.0"&gt;
-&lt;dict&gt;
- &lt;key&gt;Label&lt;/key&gt;
- &lt;string&gt;set.trilium.env&lt;/string&gt;
- &lt;key&gt;RunAtLoad&lt;/key&gt;
- &lt;true/&gt;
- &lt;key&gt;ProgramArguments&lt;/key&gt;
- &lt;array&gt;
- &lt;string&gt;/bin/launchctl&lt;/string&gt;
- &lt;string&gt;setenv&lt;/string&gt;
- &lt;string&gt;TRILIUM_DATA_DIR&lt;/string&gt;
- &lt;string&gt;/Users/YourUserName/Library/Application Support/trilium-data&lt;/string&gt;
- &lt;/array&gt;
-&lt;/dict&gt;
-&lt;/plist&gt;
-</code></pre>
- </div>
- </section>
-</div>
-<h3>Create a script to run with specific data directory</h3>
-<p>An alternative to globally setting environment variable is to run only
- the Trilium Notes with this environment variable. This then allows for
- different setup styles like two <a href="#root/_help_wX4HbRucYSDD">database</a> instances
- or "portable" installation.</p>
-<p>To do this in Unix-based systems simply run <code>trilium</code> like this:</p><pre><code class="language-text-x-trilium-auto">TRILIUM_DATA_DIR=/home/myuser/data/my-trilium-data trilium</code></pre>
-<p>You can then save the above command as a shell script on your path for
- convenience.</p>
-<h2>Electron user data directory (desktop only)</h2>
-<p>When running the desktop application, Electron stores internal data (caches,
- spell-check dictionaries, session storage, etc.) separately from the Trilium
- data directory. By default this goes to the system's application data folder
- (e.g. <code>%APPDATA%</code> on Windows), which may be undesirable in corporate
- environments with roaming profiles or when running in portable mode.</p>
-<p>To keep Electron data out of the system's roaming profile, set the <code>TRILIUM_ELECTRON_DATA_DIR</code> environment
- variable to an explicit path. The <code>trilium-portable</code> script does
- this automatically, pointing it to <code>trilium-electron-data/</code> next
- to the application.</p>
-<h2>Fine-grained directory/path location</h2>
-<p>Apart from the data directory, some of the subdirectories of it can be
- moved elsewhere by changing an environment variable:</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Environment variable</th>
- <th>Default value</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>TRILIUM_DOCUMENT_PATH</code>
- </td>
- <td><code>${TRILIUM_DATA_DIR}/document.db</code>
- </td>
- <td>Path to the&nbsp;<a class="reference-link" href="#root/_help_wX4HbRucYSDD">Database</a>&nbsp;(storing
- all notes and metadata).</td>
- </tr>
- <tr>
- <td><code>TRILIUM_BACKUP_DIR</code>
- </td>
- <td><code>${TRILIUM_DATA_DIR}/backup</code>
- </td>
- <td>Directory where automated&nbsp;<a class="reference-link" href="#root/_help_ODY7qQn5m2FT">Backup</a>&nbsp;databases
- are stored.</td>
- </tr>
- <tr>
- <td><code>TRILIUM_LOG_DIR</code>
- </td>
- <td><code>${TRILIUM_DATA_DIR}/log</code>
- </td>
- <td>Directory where daily&nbsp;<a class="reference-link" href="#root/_help_bnyigUA2UK7s">Backend (server) logs</a>&nbsp;are
- stored.</td>
- </tr>
- <tr>
- <td><code>TRILIUM_TMP_DIR</code>
- </td>
- <td><code>${TRILIUM_DATA_DIR}/tmp</code>
- </td>
- <td>Directory where temporary files are stored (for example when opening in
- an external app).</td>
- </tr>
- <tr>
- <td><code>TRILIUM_ANONYMIZED_DB_DIR</code>
- </td>
- <td><code>${TRILIUM_DATA_DIR}/anonymized-db</code>
- </td>
- <td>Directory where a&nbsp;<a class="reference-link" href="#root/_help_x59R8J8KV5Bp">Anonymized Database</a>&nbsp;is
- stored.</td>
- </tr>
- <tr>
- <td><code>TRILIUM_RESOURCES_DIR</code>
- </td>
- <td><code>${TRILIUM_DATA_DIR}/resources</code>
- </td>
- <td>Directory where <a class="reference-link" href="#root/_help_ebyr7ES2SwOW">Downloaded resources</a> are
- stored, such as the speech recognition models.</td>
- </tr>
- <tr>
- <td><code>TRILIUM_CONFIG_INI_PATH</code>
- </td>
- <td><code>${TRILIUM_DATA_DIR}/config.ini</code>
- </td>
- <td>Path to&nbsp;<a class="reference-link" href="#root/_help_Gzjqa934BdH4">Configuration (config.ini or environment variables)</a>&nbsp;file.</td>
- </tr>
- <tr>
- <td><code>TRILIUM_ELECTRON_DATA_DIR</code>
- </td>
- <td>System appData</td>
- <td>Directory for Electron internal data (caches, spell-check dictionaries,
- etc.). Set this in portable mode to avoid writing to the system profile
- (desktop only).</td>
- </tr>
- </tbody>
- </table>
-</figure>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Desktop Installation.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Desktop Installation.html
deleted file mode 100644
index 1e34f1b8d9..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Desktop Installation.html
+++ /dev/null
@@ -1,58 +0,0 @@
-<p>To install Trilium on your desktop, follow these steps:</p>
-<ol>
- <li><strong>Download the Latest Release</strong>: Obtain the appropriate binary
- release for your operating system from the <a href="https://github.com/TriliumNext/Trilium/releases/latest">latest release page</a> on
- GitHub.</li>
- <li><strong>Extract the Package</strong>: Unzip the downloaded package to
- a location of your choice.</li>
- <li><strong>Run the Application</strong>: Launch Trilium by executing the <code>trilium</code> executable
- found within the unzipped folder.</li>
-</ol>
-<h2>Installing from Flathub</h2>
-<p>On Linux, Trilium is also available on <a href="https://flathub.org/en/apps/org.triliumnotes.Trilium">Flathub</a>,
- for both x86_64 and ARM (aarch64). Install it from your software center
- (e.g. GNOME Software or KDE Discover), or from a terminal:</p><pre><code class="language-text-x-sh">flatpak install flathub org.triliumnotes.Trilium</code></pre>
-<p>Updates arrive through the software center or <code>flatpak update</code>,
- like any other Flatpak.</p>
-<p>The Flathub version runs in a sandbox and keeps its <a href="#root/_help_tAassRL4RSQL">data directory</a> in <code>~/.var/app/org.triliumnotes.Trilium/data/trilium-data</code>.
- It cannot see the data directory of a <code>.deb</code>, <code>.rpm</code>,
- AppImage or <code>.zip</code> installation (<code>~/.local/share/trilium-data</code>),
- so it starts with an empty database. To bring existing notes over:</p>
-<ol>
- <li>
- <p>Close Trilium, in both the old installation and the Flatpak.</p>
- </li>
- <li>
- <p>Copy the old data directory into the sandbox:</p><pre><code class="language-text-x-sh">mkdir -p ~/.var/app/org.triliumnotes.Trilium/data
-cp -a ~/.local/share/trilium-data ~/.var/app/org.triliumnotes.Trilium/data/</code></pre>
- </li>
- <li>
- <p>Start the Flatpak version.</p>
- </li>
-</ol>
-<p>If <code>~/.var/app/org.triliumnotes.Trilium/data/trilium-data</code> already
- exists because the Flatpak version was started before, remove or rename
- it first.</p>
-<h2>Startup Scripts</h2>
-<p>Trilium offers various startup scripts to customize your experience:</p>
-<ul>
- <li><code>trilium-no-cert-check</code>: Starts Trilium without validating <a
- href="#root/_help_l2VkvOwUNfZj">TLS certificates</a>, useful if connecting
- to a server with a self-signed certificate.
- <ul>
- <li>Alternatively, set the <code>NODE_TLS_REJECT_UNAUTHORIZED=0</code> environment
- variable before starting Trilium.</li>
- </ul>
- </li>
- <li><code>trilium-portable</code>: Launches Trilium in portable mode, where
- the <a href="#root/_help_tAassRL4RSQL">data directory</a> is created within
- the application's directory, making it easy to move the entire setup. Electron's
- internal data (caches, dictionaries, etc.) is also stored within the data
- directory, so no files are written to the system's roaming profile.</li>
- <li><code>trilium-safe-mode</code>: Boots Trilium in "safe mode," disabling
- any startup scripts that might cause the application to crash.</li>
-</ul>
-<h2>Synchronization</h2>
-<p>For Trilium desktop users who wish to synchronize their data with a server
- instance, refer to the&nbsp;<a class="reference-link" href="#root/_help_cbkrhQjrkKrh">Synchronization</a>&nbsp;guide
- for detailed instructions.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Desktop Installation/Network Access.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Desktop Installation/Network Access.html
deleted file mode 100644
index 2ddfc9aa38..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Desktop Installation/Network Access.html
+++ /dev/null
@@ -1,53 +0,0 @@
-<p>Prior to v0.104.0, the <a href="#root/_help_poXkQfguuA0U">desktop application</a> would
- also open a network port so that it can offer access to&nbsp;<a class="reference-link"
- href="#root/_help_pgxEVkzLl1OP">ETAPI (REST API)</a>&nbsp;or even use it
- as a web server (see&nbsp;<a class="reference-link" href="#root/_help_nRqcgfTb97uV">Using the desktop application as a server</a>).</p>
-<p>In order to reduce the attack surface, Trilium now enables these services
- only for the local device (e.g. <code>localhost</code>) instead of serving
- them over the LAN.</p>
-<p>To better understand what is affected, refer to the following table:</p>
-<figure
-class="table">
- <table>
- <thead>
- <tr>
- <th>Feature</th>
- <th>Network access OFF</th>
- <th>Network access ON</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><a class="reference-link" href="#root/_help_MtPxeAWVAzMg">Web Clipper</a>
- </td>
- <td>🔒️ <code>localhost</code> only (still accessible to the browser extension
- on the same device)</td>
- <td>🌐 <code>localhost</code> + LAN</td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_pgxEVkzLl1OP">ETAPI (REST API)</a>
- </td>
- <td>🔒️ <code>localhost</code> only</td>
- <td>🌐 <code>localhost</code> + LAN</td>
- </tr>
- <tr>
- <td><a href="#root/_help_GBBMSlVSOIGP">LLM MCP</a> (only if enabled in settings)</td>
- <td>🔒️ <code>localhost</code> only (needs auth)</td>
- <td>🌐 <code>localhost</code> + LAN (needs auth)</td>
- </tr>
- <tr>
- <td><a href="#root/_help_nRqcgfTb97uV">Web app</a>
- </td>
- <td>❌️ completely disabled (403), only the desktop app is usable.</td>
- <td>🌐 <code>localhost</code> + LAN</td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_R9pX4DGra2Vt">Sharing</a>&nbsp;notes</td>
- <td>❌️ completely disabled (403), if you are using&nbsp;<a class="reference-link"
- href="#root/_help_cbkrhQjrkKrh">Synchronization</a>&nbsp;this will still
- work as part of the <a href="#root/_help_WOcw2SLH6tbX">server</a>.</td>
- <td>🌐 <code>localhost</code> + LAN</td>
- </tr>
- </tbody>
- </table>
-</figure>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Desktop Installation/Nix flake.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Desktop Installation/Nix flake.html
deleted file mode 100644
index 6436cfbe85..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Desktop Installation/Nix flake.html
+++ /dev/null
@@ -1,64 +0,0 @@
-<p>Since TriliumNext 0.94.1, the desktop and server applications can be built
- using <a href="https://nixos.org/">Nix</a>.</p>
-<h2>System requirements</h2>
-<p>Installation of Nix on Mac or Linux (<a href="https://nixos.org/download/">download page</a>).
- About 3-4 gigabytes of additional storage space, for build artifacts.</p>
-<h2>Run directly</h2>
-<p>Using <a href="https://nix.dev/manual/nix/stable/command-ref/new-cli/nix3-run.html">nix run</a>,
- the desktop app can be started as: <code>nix run github:TriliumNext/Trilium/v0.95.0</code>
-</p>
-<p>Running the server requires explicitly specifying the desired package: <code>nix run github:TriliumNext/Trilium/v0.95.0#server</code>
-</p>
-<p>Instead of a version (<code>v0.95.0</code> above), you can also specify
- a commit hash (or a branch name). This makes it easy to test development
- builds.</p>
-<h2>Install on NixOS</h2>
-<p>Add to your <code>flake.nix</code>:</p><pre><code class="language-text-x-trilium-auto">{
- inputs = {
- nixpkgs.url = # ...;
- trilium-notes = {
- url = "github:TriliumNext/Trilium/v0.95.0";
- inputs.nixpkgs.follows = "nixpkgs";
- };
- };
-
- outputs =
- {
- self,
- # ...
- trilium-notes,
- ...
- }:
- {
- nixosConfigurations = {
- "nixos" = nixpkgs.lib.nixosSystem {
- system = "x86_64-linux";
- modules = [
- ./configuration.nix
- ];
- specialArgs = {
- inherit
- trilium-notes
- ;
- };
- };
- };
- };
-}
-</code></pre>
-<p>Add to your <code>configuration.nix</code>:</p><pre><code class="language-text-x-trilium-auto">{
- # ...
- trilium-notes,
- ...
-}:
-
-{
- # ...
-
- services.trilium-server.package = trilium-notes.packages.x86_64-linux.server;
-
- environment.systemPackages = [
- trilium-notes.packages.x86_64-linux.desktop
- ];
-}</code></pre>
-<p>The flake aims to be compatible with the latest NixOS stable and unstable.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Desktop Installation/System Requirements.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Desktop Installation/System Requirements.html
deleted file mode 100644
index 67583ecad1..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Desktop Installation/System Requirements.html
+++ /dev/null
@@ -1,31 +0,0 @@
-<p>The desktop version of Trilium supports all three main operating systems:</p>
-<div
-class="trilium-tabs">
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-windows"></span>&nbsp;Windows</p>
- <div class="trilium-tab-panel">
- <ul>
- <li>Windows 11 is officially supported.</li>
- <li>Windows on ARM is also supported</li>
- </ul>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-tux"></span>&nbsp;Linux</p>
- <div class="trilium-tab-panel">
- <ul>
- <li>Most modern distributions are supported, including NixOS.</li>
- <li>ARM is supported in <code>aarch64</code> (no ARM v7 support).</li>
- </ul>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-apple"></span>&nbsp;macOS</p>
- <div class="trilium-tab-panel">
- <ul>
- <li>Minimum supported operating system: macOS Ventura</li>
- <li>Both Intel and Apple Silicon devices are supported.</li>
- </ul>
- </div>
- </section>
-</div>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Desktop Installation/Tray icon & automatic startup.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Desktop Installation/Tray icon & automatic startup.html
deleted file mode 100644
index 8aa4ead097..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Desktop Installation/Tray icon & automatic startup.html
+++ /dev/null
@@ -1,75 +0,0 @@
-<aside class="admonition note">
- <p>Automatic startup and better integration with the system tray was introduced
- in v0.104.0. Versions prior to that only have the system tray option which
- could be found in&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Others</em>.</p>
-</aside>
-<h2>Tray icon</h2>
-<figure class="image image-style-align-right">
- <img style="aspect-ratio:332/71;" src="Tray icon & automatic startup_image.png"
- width="332" height="71">
-</figure>
-<p>The desktop application has native integration with the system tray on
- all operating systems.</p>
-<p>The tray icon is enabled by default, but it can be toggled from&nbsp;<a
- class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Desktop</em>.</p>
-<p>The tray icon has the following functionality:</p>
-<ul>
- <li>When clicked, the last window is hidden (minimized to the tray icon).
- Clicking it again will reveal that window.</li>
- <li>Right clicking reveals the following options:
- <ul>
- <li>Each window can be individually shown or hidden, identified by their active
- note.</li>
- <li>New windows can be opened.</li>
- <li>A new note can be created directly, which will be created in the&nbsp;<a
- class="reference-link" href="#root/_help_S0Fos78ZfcY7">Note Inbox</a>&nbsp;(or&nbsp;<a
- class="reference-link" href="#root/_help_l0tKav7yLHGF">Day Notes</a>&nbsp;if
- an inbox is not available).</li>
- <li>Today's day note can be opened.</li>
- <li>Bookmarks and recent notes are displayed in a sub-menu and clicking them
- navigates to that note.</li>
- <li>Quitting the application.</li>
- </ul>
- </li>
-</ul>
-<h3>Closing to system tray</h3>
-<p>This is an option which is not enabled by default and it allows a specific
- behavior: instead of exiting the application when the last window has been
- closed, the last window is instead hidden with the tray icon remaining
- available.</p>
-<p>This option requires the tray icon to be enabled, otherwise it has no
- effect.</p>
-<h2>Automatic startup</h2>
-<p>Two options control the automatic startup functionality in&nbsp;<a class="reference-link"
- href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Startup</em>:</p>
-<ul>
- <li>When <em>Launch on startup</em> is enabled, the application will automatically
- start up when logging into the current user.
- <ul>
- <li>Note that on Linux support depends on the desktop environment. Feel free
- to <a href="#root/_help_wy8So3yZZlH9">report</a> any issues.</li>
- </ul>
- </li>
- <li>If <em>Start minimized to tray</em> is also enabled, the application will
- start up in the background and can be revealed from the tray icon.
- <ul>
- <li>This only applies if <em>Launch on startup</em> is enabled, manual starts
- are not impacted by this option.</li>
- </ul>
- </li>
-</ul>
-<h3>Linux: custom launch command for packagers</h3>
-<p>On Linux, <em>Launch on startup</em> writes a <code>trilium.desktop</code> entry
- to the user's autostart directory (<code>$XDG_CONFIG_HOME/autostart</code>,
- usually <code>~/.config/autostart</code>). Its <code>Exec</code> line points
- to the AppImage when running from one, or to the running executable otherwise.</p>
-<p>Distribution packages that run Trilium on a system-wide Electron (for
- example <code>electron /usr/lib/trilium/app.asar</code>) cannot rely on
- the running executable, since it is the bare Electron binary, which starts
- without Trilium. Such packages can set the <code>TRILIUM_LAUNCH_EXEC</code> environment
- variable, typically in their wrapper script, to the full command that starts
- Trilium:</p><pre><code class="language-text-x-trilium-auto">export TRILIUM_LAUNCH_EXEC='electron "/usr/lib/trilium/app.asar"'</code></pre>
-<p>The value is written to the <code>Exec</code> line as-is, so any paths containing
- spaces must already be quoted. When <em>Start minimized to tray</em> is enabled, <code>--start-hidden</code> is
- appended to it. <code>TRILIUM_LAUNCH_EXEC</code> takes precedence over both
- the AppImage path and the running executable.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Desktop Installation/Tray icon & automatic startup_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Desktop Installation/Tray icon & automatic startup_image.png
deleted file mode 100644
index e21d7d53e4..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Desktop Installation/Tray icon & automatic startup_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Desktop Installation/Troubleshooting.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Desktop Installation/Troubleshooting.html
deleted file mode 100644
index a06ca313af..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Desktop Installation/Troubleshooting.html
+++ /dev/null
@@ -1,16 +0,0 @@
-<h2>Trilium only shows a blank window</h2>
-<p>Trilium uses Electron which is based on Chromium (the open-source alternative
- to Google Chrome); in order to improve performance it makes use of <em>GPU acceleration</em>.
- In some cases, a GPU incompatibility (especially on older models of integrated
- graphics) can cause nothing to render at all, resulting in a blank window.&nbsp;</p>
-<p>To bypass this, try running Trilium with the following command line argument:</p><pre><code class="language-text-x-trilium-auto">trilium --disable-gpu</code></pre>
-<p>If that doesn't work, try the following commands as well:</p>
-<ul>
- <li><code>trilium --disable-gpu-compositing</code>
- </li>
- <li><code>ELECTRON_OZONE_PLATFORM_HINT=x11 trilium</code> (this one forces
- the rendering to X11 on Wayland)</li>
-</ul>
-<p>If Trilium renders fine after this, Trilium offers a built-in option to
- disable GPU acceleration: go to&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Appearance</em>,
- look for the <em>Performance</em> section and then uncheck <em>Hardware acceleration (GPU)</em>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Desktop Installation/Using the desktop application as a server.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Desktop Installation/Using the desktop application as a server.html
deleted file mode 100644
index b2c191d600..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Desktop Installation/Using the desktop application as a server.html
+++ /dev/null
@@ -1,44 +0,0 @@
-<p>Sometimes, setting up a <a href="#root/_help_WOcw2SLH6tbX">dedicated server installation</a> is
- not feasible. The desktop application ships with a fully functional server
- instance by default.</p>
-<p>For security reasons, this feature is <strong>not enabled</strong> by default.
- To enable it, enable <em>Network access</em> in&nbsp;<a class="reference-link"
- href="#root/_help_fiHicjpHjIRJ">Security</a>.</p>
-<p>After enabling network access and restarting the application, you can
- access this web interface locally by navigating to <a href="http://localhost:37840/login">http://localhost:37840/login</a>.</p>
-<aside
-class="admonition note">
- <p>The server embedded in the desktop application will only run as long as
- the desktop application itself is running. So closing the application will
- also close the server. To overcome this, you can try hiding the application
- in the system tray.</p>
-</aside>
-<h2>Mobile interface</h2>
-<p>By default, this will display the desktop user interface, even on mobile.
- To switch to the mobile version, simply go to the&nbsp;<a class="reference-link"
- href="#root/_help_x3i7MxGccDuM">Global menu</a>&nbsp;and select “Switch
- to the mobile version”.</p>
-<h2>Allowing the port externally on Windows with Windows Defender Firewall</h2>
-<p>First, find out the IP of your desktop server by running <code>ipconfig</code> in
- your local terminal. Then try accessing <code>http://&lt;ip&gt;:37840/login</code> on
- another device. If it doesn't work, then most likely the port is blocked
- by your operating system's firewall.</p>
-<p>If you use Windows Defender Firewall:</p>
-<ol>
- <li>Go to Windows's start menu and look for “Windows Defender Firewall with
- Advanced Security”.</li>
- <li>Go to “Inbound Rules” on the left tree, and select “New Rule” in the “Actions”
- sidebar on the right.</li>
- <li>Select “Port” and press “Next”.</li>
- <li>Type in <code>37840</code> in the “Specific local ports” section and then
- press “Next”.</li>
- <li>Leave “Allow the connection” checked and press “Next”.</li>
- <li>Configure the networks to apply to (check all if unsure) and then press
- “Next”.</li>
- <li>Add an appropriate name to the rule (e.g. “Trilium Notes”) and press “Finish”.</li>
-</ol>
-<aside class="admonition warning">
- <p>Since v0.104.0, the port used by Trilium is accessible only on <code>localhost</code>.
- To enable across the local network, see&nbsp;<a class="reference-link"
- href="#root/_help_swSFivWk6KkA">Network Access</a>.</p>
-</aside>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Downloaded resources.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Downloaded resources.html
deleted file mode 100644
index ff228727b4..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Downloaded resources.html
+++ /dev/null
@@ -1,105 +0,0 @@
-<p>Downloaded resources are large files that some features need but that
- do not ship with Trilium, such as the speech recognition models used to
- transcribe meetings. Trilium downloads them the first time a feature needs
- them, and keeps them on the device for later use.</p>
-<p>Currently, only&nbsp;<a class="reference-link" href="#root/_help_Y84QCbArmK3z">Meeting transcription</a>&nbsp;on
- the desktop application uses downloaded resources:</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Resource</th>
- <th>Size</th>
- <th>License</th>
- <th>Used for</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>Parakeet TDT 0.6B v3 (standard)</td>
- <td>0.6 GB</td>
- <td>CC-BY-4.0</td>
- <td>Recognizing speech, with the <em>Standard</em> model.</td>
- </tr>
- <tr>
- <td>Parakeet TDT 0.6B v3 (high accuracy)</td>
- <td>2.4 GB</td>
- <td>CC-BY-4.0</td>
- <td>Recognizing speech, with the <em>High accuracy</em> model.</td>
- </tr>
- <tr>
- <td>Silero VAD</td>
- <td>0.6 MB</td>
- <td>MIT</td>
- <td>Detecting when someone speaks.</td>
- </tr>
- <tr>
- <td>TitaNet</td>
- <td>40 MB</td>
- <td>Apache-2.0</td>
- <td>Telling speakers apart, while <em>Identify speakers</em> is on.</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<h2>Downloading resources</h2>
-<p>When a feature needs resources that are not on the device yet, Trilium
- asks before downloading them. The dialog lists each resource with what
- it is used for, where it is downloaded from, its license and its size,
- followed by the total download size and the free space on the disk.</p>
-<ul>
- <li>To start the download, press <em>Download</em>. Each resource shows its
- progress, and the feature continues once all of them are downloaded.</li>
- <li>To stop the download, press <em>Cancel</em> or close the dialog. The files
- already downloaded are kept, and the next download continues where this
- one stopped, even within a large file.</li>
- <li>If the disk does not have enough free space, the dialog says so and the
- download cannot be started.</li>
-</ul>
-<p>Every file is checked against a checksum built into Trilium before it
- is used, so a file that was damaged or altered during the download is discarded.</p>
-<aside
-class="admonition note">
- <p>Downloaded resources are not synchronized. Each device that uses a feature
- downloads its resources separately, even when the notes are kept in sync
- through <a class="reference-link" href="#root/_help_cbkrhQjrkKrh">Synchronization</a>.</p>
-</aside>
-<h2>Managing downloaded resources</h2>
-<p>To see the downloaded resources, go to <a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a> → <em>Downloaded resources</em>.
- Each resource that was downloaded, or partly downloaded by an interrupted
- download, is listed with the space it takes on the disk and its status.
- Below the list, <em>Space used</em> shows the space they take in total, and
- how much free space is left on the disk.</p>
-<ul>
- <li>To open the folder of a resource, press the <span class="tn-icon bx bx-folder-open"></span> button
- (desktop only).</li>
- <li>To delete a resource, press the <span class="tn-icon bx bx-trash"></span> button.
- If a feature needs it again, it is downloaded again.</li>
-</ul>
-<p>The list also shows, faded out, anything else in the resources folder:</p>
-<ul>
- <li><em>Older version</em>: the files of an earlier version of a resource.
- When a resource is updated, the new version is downloaded into a new folder,
- and the old one is left behind.</li>
- <li><em>Not used</em>: a resource that no feature of this installation uses,
- for example one downloaded by a feature that was removed.</li>
- <li><em>Unknown</em>: any other file or folder, for example one copied there
- by hand.</li>
-</ul>
-<p>These can be deleted in the same way.</p>
-<aside class="admonition warning">
- <p>If a server and a desktop application share the same data directory, a
- resource used by only one of them shows as <em>Not used</em> in the other.
- Deleting it there removes it for both.</p>
-</aside>
-<h2>Location</h2>
-<p>The resources are stored in the <code>resources</code> folder of the <a class="reference-link"
- href="#root/_help_tAassRL4RSQL">Data directory</a>, one folder per resource.
- To store them elsewhere, set the <code>TRILIUM_RESOURCES_DIR</code> environment
- variable to another folder before starting Trilium.</p>
-<h2>Installing without an Internet connection</h2>
-<p>To install a resource on a device that cannot download it, copy its folder
- from the <code>resources</code> folder of a device that already has it into
- the same place on the other device. The next time a feature asks to download
- it, press <em>Download</em>: the files already in place are checked against
- their checksums and kept, and only the missing ones are downloaded.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Mobile Frontend.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Mobile Frontend.html
deleted file mode 100644
index 761904f3e7..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Mobile Frontend.html
+++ /dev/null
@@ -1,137 +0,0 @@
-<figure class="image image-style-align-right image_resized" style="width:33.52%;">
- <img style="aspect-ratio:1242/2688;" src="Mobile Frontend_IMG_1765.PNG"
- width="1242" height="2688">
-</figure>
-<p>Trilium has a mobile web frontend which is optimized for touch based devices
- - smartphones and tablets. It is activated automatically during login process
- based on browser detection.</p>
-<p>Mobile frontend is limited in features compared to the full desktop version.
- See below for more details on this.</p>
-<h2>Layout basics</h2>
-<p>Unlike the desktop version, the mobile version has a slightly different
- UI meant to better fit the constrained screens of a mobile phone.</p>
-<p>Here is a non-exhaustive list of differences between the desktop version
- and the mobile one:</p>
-<ul>
- <li>The&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;is
- displayed as a sidebar. To display the sidebar, press the button in the
- top-left of the screen.
- <ul>
- <li>There is also a swipe gesture that can be done from the left of the screen,
- but the browser's navigation gesture interferes with it most of the time
- (depending on the platform).</li>
- <li>Press and hold a note to display the&nbsp;<a class="reference-link" href="#root/_help_YtSN43OrfzaA">Note tree contextual menu</a>.</li>
- </ul>
- </li>
- <li>The&nbsp;<a class="reference-link" href="#root/_help_Ms1nauBra7gq">Quick search</a>&nbsp;bar
- is also displayed at the top of the note tree.</li>
- <li>The full&nbsp;<a class="reference-link" href="#root/_help_eIg8jdvaoNNd">Search</a>&nbsp;function
- can be triggered either from either the&nbsp;<a class="reference-link"
- href="#root/_help_x3i7MxGccDuM">Global menu</a>&nbsp;or from the&nbsp;<a
- class="reference-link" href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>,
- if configured.</li>
- <li>The&nbsp;<a class="reference-link" href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>&nbsp;is
- displayed at the bottom of the screen.
- <ul>
- <li>The launch bar uses a different configuration for icons than the desktop
- version. See the dedicated page for more information on how to configure
- it.</li>
- </ul>
- </li>
- <li>Most of the note-related actions are grouped in the horizontal dots icon
- on the top-right of the note.</li>
- <li>The&nbsp;<a class="reference-link" href="#root/_help_3seOhtN8uLIY">Tabs</a>&nbsp;are
- grouped under a tab switcher in the&nbsp;<a class="reference-link" href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>,
- where the tabs are displayed in a full-screen grid with preview for easy
- switching, as well as additional options such as reopening closed tabs.</li>
- <li>Since v0.100.0,&nbsp;<a class="reference-link" href="#root/_help_luNhaphA37EO">Split View</a>&nbsp;can
- also be used in mobile view, but with a maximum of two panes at once. The
- splits are displayed vertically instead of horizontally.</li>
-</ul>
-<h2>Installing as a PWA</h2>
-<p>The mobile view can be set up as a PWA. While this does not offer any
- offline capabilities, it will display the application in full-screen and
- makes it easy to access via your mobile phone's home screen.</p>
-<div class="trilium-tabs">
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-apple"></span>&nbsp;iOS with Safari</p>
- <div
- class="trilium-tab-panel">
- <ol>
- <li>Open your default web browser and access your Trilium instance.</li>
- <li>Login.</li>
- <li>Press the […] button in the bottom-right of the screen and select Share.</li>
- <li>Scroll down to reveal the full list of items and choose <em>Add to Home Screen</em>.</li>
- <li>Press <em>Add</em> and the web app will be available.</li>
- </ol>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-chrome"></span>&nbsp;Android with Google Chrome</p>
- <div
- class="trilium-tab-panel">
- <aside class="admonition important">
- <p>Google Chrome requires the server to be served over HTTPS in order to
- display in full-screen. If using HTTP, the app will appear like a normal
- web page (similar to a bookmark).</p>
- </aside>
- <ol>
- <li>Open your default web browser and access your Trilium instance.</li>
- <li>Login.</li>
- <li>Press the three vertical dots icon in the top-right of the screen and
- select <em>Add to Home screen.</em>
- </li>
- <li>Select the <em>Install</em> option.</li>
- <li>Select an appropriate name.</li>
- <li>The web app will appear as an application, not on the home screen.</li>
- </ol>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title">Android with Brave</p>
- <div class="trilium-tab-panel">
- <aside class="admonition important">
- <p>Brave requires the server to be served over HTTPS in order to display
- in full-screen. If using HTTP, the app will appear like a normal web page
- (similar to a bookmark).</p>
- </aside>
- <ol>
- <li>Open your default web browser and access your Trilium instance.</li>
- <li>Login.</li>
- <li>Press the three vertical dots icon in the bottom-right of the screen and
- select <em>Add to Home screen</em>.</li>
- <li>Press the <em>Install</em> option.</li>
- <li>The web app will appear as an application, not on the home screen.</li>
- </ol>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title">Samsung Browser</p>
- <div class="trilium-tab-panel">
- <ol>
- <li>Open your default web browser and access your Trilium instance.</li>
- <li>Login.</li>
- <li>Press the hamburger menu in the bottom-right of the screen.</li>
- <li>Select <em>Add to</em>, followed by <em>Home screen</em>.</li>
- <li>Press <em>Add</em> and the web app will appear on the home page.</li>
- </ol>
- </div>
- </section>
-</div>
-<h2>Testing via the desktop application</h2>
-<p>If you are running Trilium without a dedicated <a href="#root/_help_WOcw2SLH6tbX">server installation</a>,
- you can still test the mobile application using the desktop application.
- For more information, see&nbsp;<a class="reference-link" href="#root/_help_nRqcgfTb97uV">Using the desktop application as a server</a>.
- To access it go to <code>http://&lt;ip&gt;:37840/login?mobile</code> .</p>
-<h2>Forcing mobile/desktop frontend</h2>
-<p>Trilium decides automatically whether to use mobile or desktop front-end.
- If this is not appropriate, you can use <code>?mobile</code> or <code>?desktop</code> query
- param on <strong>login</strong> page (Note: you might need to log out).</p>
-<p>Alternatively, simply select <em>Switch to Mobile/Desktop Version</em> in
- the&nbsp;<a class="reference-link" href="#root/_help_x3i7MxGccDuM">Global menu</a>.</p>
-<h2>Scripting</h2>
-<p>You can alter the behavior with&nbsp;<a class="reference-link" href="#root/_help_CdNpE2pqjmI6">Scripting</a>,
- just like for normal frontend. For script notes to be executed, they need
- to have labeled <code>#run=mobileStartup</code>.</p>
-<p>Custom&nbsp;<a class="reference-link" href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>&nbsp;widgets
- are also supported.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Mobile Frontend_IMG_1765.PNG b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Mobile Frontend_IMG_1765.PNG
deleted file mode 100644
index 5536b5ffbd..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Mobile Frontend_IMG_1765.PNG and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation.html
deleted file mode 100644
index 8c153fbff6..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation.html
+++ /dev/null
@@ -1,69 +0,0 @@
-<p>This guide outlines the steps to install Trilium on your own server. You
- might consider this option if you want to set up <a href="#root/_help_cbkrhQjrkKrh">synchronization</a> or
- use Trilium in a browser - accessible from anywhere.</p>
-<h2>Installation Options</h2>
-<p>There are several ways to install Trilium on a server, each with its own
- advantages:</p>
-<ul>
- <li><strong>Recommended</strong>: <a href="#root/_help_rWX5eY045zbE">Docker Installation</a> -
- Available for <strong>AMD64</strong> and <strong>ARM</strong> architectures.</li>
- <li><a href="#root/_help_3tW6mORuTHnB">Packaged Server Installation</a>
- </li>
- <li><a href="https://www.pikapods.com/pods?run=trilium-next">PikaPods managed hosting</a>
- </li>
- <li><a href="#root/_help_J1Bb6lVlwU5T">Manual Installation</a>
- </li>
- <li><a href="#root/_help_DCmT6e7clMoP">Kubernetes</a>
- </li>
- <li><a href="https://www.cloudron.io/store/com.github.trilium.cloudronapp.html">Cloudron</a>
- </li>
- <li><a href="https://homelabos.com/docs/software/trilium/">HomelabOS</a>
- </li>
- <li><a href="#root/_help_moVgBcoxE3EK">NixOS Module</a>
- </li>
-</ul>
-<p>The server installation includes both web and <a href="#root/_help_RDslemsQ6gCp">mobile frontends</a>.</p>
-<h2>Configuration</h2>
-<p>After setting up your server installation, you may want to configure settings
- such as the port or enable <a href="#root/_help_l2VkvOwUNfZj">TLS</a>. Configuration
- is managed via the Trilium <code>config.ini</code> file, which is located
- in the <a href="#root/_help_tAassRL4RSQL">data directory</a> by default.
- To begin customizing your setup, copy the provided <code>config-sample.ini</code> file
- with default values to <code>config.ini</code>.</p>
-<p>You can also review the <a href="#root/_help_Gzjqa934BdH4">configuration</a> file
- to provide all <code>config.ini</code> values as environment variables instead.</p>
-<h3>Config Location</h3>
-<p>By default, <code>config.ini</code>, the <a href="#root/_help_wX4HbRucYSDD">database</a>,
- and other important Trilium data files are stored in the <a href="#root/_help_tAassRL4RSQL">data directory</a>.
- If you prefer a different location, you can change it by setting the <code>TRILIUM_DATA_DIR</code> environment
- variable:</p><pre><code class="language-text-x-trilium-auto">export TRILIUM_DATA_DIR=/home/myuser/data/my-trilium-data</code></pre>
-<h3>Disabling Authentication</h3>
-<p>See&nbsp;<a class="reference-link" href="#root/_help_0hzsNCP31IAB">Authentication</a>.</p>
-<h2>Reverse Proxy Setup</h2>
-<p>To configure a reverse proxy for Trilium, you can use either <strong>nginx</strong> or <strong>Apache</strong>.
- You can also check out the documentation stored in the Reverse proxy folder.</p>
-<div
-class="trilium-tabs">
- <section class="trilium-tab">
- <p class="trilium-tab-title">nginx</p>
- <div class="trilium-tab-panel">
- <p>Add the following configuration to your <code>nginx</code> setup to proxy
- requests to Trilium:</p><pre><code class="language-text-x-trilium-auto">location /trilium/ {
- proxy_pass http://127.0.0.1:8080/;
- proxy_http_version 1.1;
- proxy_set_header Upgrade $http_upgrade;
- proxy_set_header Connection 'upgrade';
- proxy_set_header Host $host;
- proxy_cache_bypass $http_upgrade;
-}</code></pre>
- <p>To avoid limiting the size of payloads, include this in the <code>server {}</code> block:</p><pre><code class="language-text-x-trilium-auto"># Set to 0 for unlimited. Default is 1M.
-client_max_body_size 0;</code></pre>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title">Apache</p>
- <div class="trilium-tab-panel">
- <p>For an Apache setup, refer to the&nbsp;<a class="reference-link" href="#root/_help_fDLvzOx29Pfg">Apache using Docker</a>&nbsp;guide.</p>
- </div>
- </section>
-</div>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/1. Installing the server/Manually.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/1. Installing the server/Manually.html
deleted file mode 100644
index b6d20457d3..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/1. Installing the server/Manually.html
+++ /dev/null
@@ -1,42 +0,0 @@
-<aside class="admonition warning">
- <p>This page describes manually installing Trilium on your server. <strong>Note that this is a not well supported way to install Trilium, problems may appear, information laid out here is quite out of date. It is recommended to use either</strong>&nbsp;<a
- class="reference-link" href="#root/_help_rWX5eY045zbE">Docker Server Installation</a>&nbsp;<strong>or</strong>&nbsp;<a
- class="reference-link" href="#root/_help_3tW6mORuTHnB">Packaged server installation</a><strong>.</strong>
- </p>
-</aside>
-<h2>Requirements</h2>
-<p>Trilium is a node.js application. Supported (tested) version of node.js
- is latest 14.X.X and 16.X.X. Trilium might work with older versions as
- well.</p>
-<p>You can check your node version with this command (node.js needs to be
- installed):</p><pre><code class="language-text-x-trilium-auto">node --version</code></pre>
-<p>If your Linux distribution has only an outdated version of node.js, you
- can take a look at the installation instruction on node.js website, which
- covers most popular distributions.</p>
-<h3>Dependencies</h3>
-<p>There are some dependencies required. You can see command for Debian and
- its derivatives (like Ubuntu) below:</p><pre><code class="language-text-x-trilium-auto">sudo apt install libpng16-16 libpng-dev pkg-config autoconf libtool build-essential nasm libx11-dev libxkbfile-dev</code></pre>
-<h2>Installation</h2>
-<h3>Download</h3>
-<p>You can either download source code zip/tar from <a href="https://github.com/TriliumNext/Trilium/releases/latest">https://github.com/TriliumNext/Trilium/releases/latest</a>.</p>
-<p>For the latest version including betas, clone Git repository <strong>from</strong> <code>main</code> <strong>branch</strong> with:</p><pre><code class="language-text-x-trilium-auto">git clone -b main https://github.com/triliumnext/trilium.git</code></pre>
-<h2>Installation</h2><pre><code class="language-text-x-trilium-auto">cd trilium
-
-# download all node dependencies
-npm install
-
-# make sure the better-sqlite3 binary is there
-npm rebuild
-
-# bundles &amp; minifies frontend JavaScript
-npm run webpack</code></pre>
-<h2>Run</h2><pre><code class="language-text-x-trilium-auto">cd trilium
-
-# using nohup to make sure trilium keeps running after user logs out
-nohup TRILIUM_ENV=dev node src/www &amp;</code></pre>
-<p>The application by default starts up on port 8080, so you can open your
- browser and navigate to <a href="http://localhost:8080">http://localhost:8080</a> to
- access Trilium (replace "localhost" with your hostname).</p>
-<h2>TLS</h2>
-<p>Don't forget to <a href="#root/_help_l2VkvOwUNfZj">configure TLS</a> which
- is required for secure usage!</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/1. Installing the server/Multiple server instances.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/1. Installing the server/Multiple server instances.html
deleted file mode 100644
index de3dce9111..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/1. Installing the server/Multiple server instances.html
+++ /dev/null
@@ -1,25 +0,0 @@
-<p>Trilium does not support multiple users. In order to have two or more
- persons with their own set of notes, multiple server instances must be
- set up. It is also not possible to use multiple <a href="#root/_help_cbkrhQjrkKrh">sync</a> servers.</p>
-<p>To allow multiple server instances on a single physical server:</p>
-<ul>
- <li>
- <p>For&nbsp;<a class="reference-link" href="#root/_help_3tW6mORuTHnB">Packaged version for Linux</a>&nbsp;or&nbsp;<a
- class="reference-link" href="#root/_help_J1Bb6lVlwU5T">Manually</a>, if
- starting the server manually just specify a different port and data directory
- per instance:</p><pre><code class="language-text-x-trilium-auto">TRILIUM_NETWORK_PORT=8080 TRILIUM_DATA_DIR=/path/to/your/data-dir-A /opt/trilium/trilium.sh</code></pre>
- <p>For a second instance:</p><pre><code class="language-text-x-trilium-auto">TRILIUM_NETWORK_PORT=8081 TRILIUM_DATA_DIR=/path/to/your/data-dir-B /opt/trilium/trilium.sh</code></pre>
- <p>If using <code>systemd</code>, then set the <a href="https://serverfault.com/questions/413397/how-to-set-environment-variable-in-systemd-service">environment variables in the service configuration</a>.</p>
- </li>
- <li>
- <p>For&nbsp;<a class="reference-link" href="#root/_help_rWX5eY045zbE">Using Docker</a>,
- simply use two different containers, each with their own port binding and
- data directory.</p>
- </li>
- <li>
- <p>For&nbsp;<a class="reference-link" href="#root/_help_moVgBcoxE3EK">On NixOS</a>,
- the only possible way is to use Docker OCI containers or at least one NixOS
- container with its own service definition.</p>
- </li>
-</ul>
-<p>For support or additional context, see the related <a href="https://github.com/orgs/TriliumNext/discussions/1642#discussioncomment-12768808">GitHub Discussion</a>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/1. Installing the server/On NixOS.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/1. Installing the server/On NixOS.html
deleted file mode 100644
index b965f62fc6..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/1. Installing the server/On NixOS.html
+++ /dev/null
@@ -1,15 +0,0 @@
-<p>This page describes configuring the Trilium module included in NixOS.</p>
-<h2>Requirements</h2>
-<p><a href="https://nixos.org/">NixOS</a> installation.</p>
-<h2>Configuration</h2>
-<p>Add this to your <code>configuration.nix</code>:</p><pre><code class="language-text-x-trilium-auto">services.trilium-server.enable = true;
-
-# default data directory: /var/lib/trilium
-#services.trilium-server.dataDir = "/var/lib/trilium-sync-server";
-
-# default bind address: 127.0.0.1, port 8080
-#services.trilium-server.host = "0.0.0.0";
-#services.trilium-server.port = 12783;</code></pre>
-<p>Uncomment any option you would like to change.</p>
-<p>See the <a href="https://search.nixos.org/options?channel=unstable&amp;from=0&amp;size=50&amp;sort=relevance&amp;type=packages&amp;query=trilium-server">NixOS options list</a> for
- more options (including nginx reverse proxy configuration).</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/1. Installing the server/Packaged version for Linux.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/1. Installing the server/Packaged version for Linux.html
deleted file mode 100644
index 78cb1c951b..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/1. Installing the server/Packaged version for Linux.html
+++ /dev/null
@@ -1,87 +0,0 @@
-<p>This is essentially Trilium sources + node modules + node.js runtime packaged
- into one 7z file.</p>
-<h2>Steps</h2>
-<ul>
- <li>SSH into your server</li>
- <li>use <code>wget</code> (or <code>curl</code>) to download latest <code>TriliumNotes-Server-[VERSION]-linux-x64.tar.xz</code> (copy
- link from <a href="https://github.com/TriliumNext/Trilium/releases">release page</a>,
- notice <code>-Server</code> suffix) on your server.</li>
- <li>unpack the archive, e.g. using <code>tar -xf -d TriliumNotes-Server-[VERSION]-linux-x64.tar.xz</code>
- </li>
- <li><code>cd trilium-linux-x64-server</code>
- </li>
- <li><code>./trilium.sh</code>
- </li>
- <li>you can open the browser and open http://[your-server-hostname]:8080 and
- you should see Trilium initialization page</li>
-</ul>
-<p>The problem with above steps is that once you close the SSH connection,
- the Trilium process is terminated. To avoid that, you have two options:</p>
-<ul>
- <li>Kill it (with e.g. <kbd>Ctrl</kbd> + <kbd>C</kbd>) and run again like this: <code>nohup ./trilium.sh &amp;</code>.
- (nohup keeps the process running in the background, <code>&amp;</code> runs
- it in the background)</li>
- <li>Configure systemd to automatically run Trilium in the background on every
- boot</li>
-</ul>
-<h2>Configure Trilium to auto-run on boot with systemd</h2>
-<ul>
- <li>After downloading, extract and move Trilium:</li>
-</ul><pre><code class="language-text-x-trilium-auto">tar -xvf TriliumNotes-Server-[VERSION]-linux-x64.tar.xz
-sudo mv trilium-linux-x64-server /opt/trilium</code></pre>
-<ul>
- <li>Create the service:</li>
-</ul><pre><code class="language-text-x-trilium-auto">sudo nano /etc/systemd/system/trilium.service</code></pre>
-<ul>
- <li>Paste this into the file (replace the user and group as needed):</li>
-</ul><pre><code class="language-text-x-trilium-auto">[Unit]
-Description=Trilium Daemon
-After=syslog.target network.target
-
-[Service]
-User=xxx
-Group=xxx
-Type=simple
-ExecStart=/opt/trilium/trilium.sh
-WorkingDirectory=/opt/trilium/
-
-TimeoutStopSec=20
-# KillMode=process leads to error, according to https://www.freedesktop.org/software/systemd/man/systemd.kill.html
-Restart=always
-
-[Install]
-WantedBy=multi-user.target</code></pre>
-<ul>
- <li>Save the file (CTRL-S) and exit (CTRL-X)</li>
- <li>Enable and launch the service:</li>
-</ul><pre><code class="language-text-x-trilium-auto">sudo systemctl enable --now -q trilium</code></pre>
-<ul>
- <li>You can now open a browser to http://[your-server-hostname]:8080 and you
- should see the Trilium initialization page.</li>
-</ul>
-<h2>Simple auto-update for Server</h2>
-<p>The script is available in&nbsp;<a class="reference-link" href="#root/_help_ZNAjFcxqHr9V">Simple auto-update for server</a>.</p>
-<ul>
- <li>
- <p>Run as the same User Trilium runs.</p>
- <ul>
- <li>If you run as <code>root</code> please remove <code>sudo</code> from the commands.</li>
- </ul>
- </li>
- <li>
- <p>Requires <code>jq</code>:</p><pre><code class="language-text-x-sh">apt install jq</code></pre>
- </li>
-</ul>
-<p>It will stop the service above, overwrite everything (expecting no <code>config.ini</code>),
- and start service. It also creates a version file in the Trilium directory
- so it updates only with a newer version.</p>
-<h2>Common issues</h2>
-<h3>Outdated glibc</h3><pre><code class="language-text-x-trilium-auto">Error: /usr/lib64/libstdc++.so.6: version `GLIBCXX_3.4.21' not found (required by /var/www/virtual/.../node_modules/@mlink/scrypt/build/Release/scrypt.node)
- at Object.Module._extensions..node (module.js:681:18)
- at Module.load (module.js:565:32)
- at tryModuleLoad (module.js:505:12)</code></pre>
-<p>If you get an error like this, you need to either upgrade your glibc (typically
- by upgrading to up-to-date distribution version) or use some other <a href="#root/_help_WOcw2SLH6tbX">server installation</a> method.</p>
-<h2>TLS</h2>
-<p>Don't forget to <a href="#root/_help_l2VkvOwUNfZj">configure TLS</a>, which
- is required for secure usage!</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/1. Installing the server/Packaged version for Linux/Simple auto-update for server.dat b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/1. Installing the server/Packaged version for Linux/Simple auto-update for server.dat
deleted file mode 100644
index d461a05716..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/1. Installing the server/Packaged version for Linux/Simple auto-update for server.dat
+++ /dev/null
@@ -1,89 +0,0 @@
-#!/bin/bash
-
-# Configuration
-REPO="TriliumNext/Trilium"
-PATTERN="TriliumNotes-Server-.*-linux-x64.tar.xz"
-DOWNLOAD_DIR="/var/tmp/trilium_download"
-OUTPUT_DIR="/opt/trilium"
-SERVICE_NAME="trilium"
-VERSION_FILE="$OUTPUT_DIR/version.txt"
-
-# Ensure dependencies are installed
-command -v curl >/dev/null 2>&1 || { echo "Error: curl is required"; exit 1; }
-command -v jq >/dev/null 2>&1 || { echo "Error: jq is required"; exit 1; }
-command -v tar >/dev/null 2>&1 || { echo "Error: tar is required"; exit 1; }
-
-# Create download directory
-mkdir -p "$DOWNLOAD_DIR" || { echo "Error: Cannot create $DOWNLOAD_DIR"; exit 1; }
-
-# Get the latest release version
-LATEST_VERSION=$(curl -sL https://api.github.com/repos/$REPO/releases/latest | jq -r '.tag_name')
-if [ -z "$LATEST_VERSION" ]; then
- echo "Error: Could not fetch latest release version"
- exit 1
-fi
-
-# Check current installed version (from version.txt or existing tarball)
-CURRENT_VERSION=""
-if [ -f "$VERSION_FILE" ]; then
- CURRENT_VERSION=$(cat "$VERSION_FILE")
-elif [ -f "$DOWNLOAD_DIR/TriliumNotes-Server-$LATEST_VERSION-linux-x64.tar.xz" ]; then
- CURRENT_VERSION="$LATEST_VERSION"
-fi
-
-# Compare versions
-if [ "$CURRENT_VERSION" = "$LATEST_VERSION" ]; then
- echo "Latest version ($LATEST_VERSION) is already installed"
- exit 0
-fi
-
-# Download the latest release
-LATEST_URL=$(curl -sL https://api.github.com/repos/$REPO/releases/latest | jq -r ".assets[] | select(.name | test(\"$PATTERN\")) | .browser_download_url")
-if [ -z "$LATEST_URL" ]; then
- echo "Error: No asset found matching pattern '$PATTERN'"
- exit 1
-fi
-
-FILE_NAME=$(basename "$LATEST_URL")
-FILE_PATH="$DOWNLOAD_DIR/$FILE_NAME"
-
-# Download if not already present
-if [ -f "$FILE_PATH" ]; then
- echo "Latest release $FILE_NAME already downloaded"
-else
- curl -LO --output-dir "$DOWNLOAD_DIR" "$LATEST_URL" || { echo "Error: Download failed"; exit 1; }
- echo "Downloaded $FILE_NAME to $DOWNLOAD_DIR"
-fi
-
-# Extract the tarball
-EXTRACT_DIR="$DOWNLOAD_DIR/extracted"
-mkdir -p "$EXTRACT_DIR"
-tar -xJf "$FILE_PATH" -C "$EXTRACT_DIR" || { echo "Error: Extraction failed"; exit 1; }
-
-# Find the extracted directory (e.g., TriliumNotes-Server-0.97.2-linux-x64)
-INNER_DIR=$(find "$EXTRACT_DIR" -maxdepth 1 -type d -name "TriliumNotes-Server-*-linux-x64" | head -n 1)
-if [ -z "$INNER_DIR" ]; then
- echo "Error: Could not find extracted directory matching TriliumNotes-Server-*-linux-x64"
- exit 1
-fi
-
-# Stop the trilium-server service
-if systemctl is-active --quiet "$SERVICE_NAME"; then
- echo "Stopping $SERVICE_NAME service..."
- sudo systemctl stop "$SERVICE_NAME" || { echo "Error: Failed to stop $SERVICE_NAME"; exit 1; }
-fi
-
-# Copy contents to /opt/trilium, overwriting existing files
-echo "Copying contents from $INNER_DIR to $OUTPUT_DIR..."
-sudo mkdir -p "$OUTPUT_DIR"
-sudo cp -r "$INNER_DIR"/* "$OUTPUT_DIR"/ || { echo "Error: Copy failed"; exit 1; }
-echo "$LATEST_VERSION" | sudo tee "$VERSION_FILE" >/dev/null
-echo "Files copied to $OUTPUT_DIR"
-
-# Start the trilium-server service
-echo "Starting $SERVICE_NAME service..."
-sudo systemctl start "$SERVICE_NAME" || { echo "Error: Failed to start $SERVICE_NAME"; exit 1; }
-
-# Clean up
-rm -rf "$EXTRACT_DIR"
-echo "Cleanup complete. Trilium updated to $LATEST_VERSION."
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/1. Installing the server/Using Docker.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/1. Installing the server/Using Docker.html
deleted file mode 100644
index e2369f0ee5..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/1. Installing the server/Using Docker.html
+++ /dev/null
@@ -1,142 +0,0 @@
-<p>Official docker images are published on docker hub for <strong>AMD64</strong>, <strong>ARMv7</strong> and <strong>ARM64/v8</strong>: <a
- href="https://hub.docker.com/r/triliumnext/trilium/">https://hub.docker.com/r/triliumnext/trilium/</a>
-</p>
-<h2>Prerequisites</h2>
-<p>Ensure Docker is installed on your system.</p>
-<p>If you need help installing Docker, reference the <a href="https://docs.docker.com/engine/install/">Docker Installation Docs</a>
-</p>
-<p>By default, the container starts as root, prepares the data directory
- and then runs Trilium as an unprivileged user. It can also run entirely
- without root, as described in <em>Running as a non-root user</em> below.</p>
-<aside
-class="admonition warning">
- <p>If you're using a SMB/CIFS share or folder as your Trilium data directory, <a
- href="https://github.com/TriliumNext/Notes/issues/415#issuecomment-2344824400">you'll need</a> to
- add the mount options of <code>nobrl</code> and <code>noperm</code> when mounting
- your SMB share.</p>
-</aside>
-<h2>Running with Docker Compose</h2>
-<h3>Grab the latest docker-compose.yml:</h3><pre><code class="language-text-x-trilium-auto">wget https://raw.githubusercontent.com/TriliumNext/Trilium/master/docker-compose.yml</code></pre>
-<p>Optionally, edit the <code>docker-compose.yml</code> file to configure the
- container settings prior to starting it. Unless configured otherwise, the
- data directory will be <code>trilium-data</code> next to <code>docker-compose.yml</code> and
- the container will be accessible at port 8080.</p>
-<p>To keep the data somewhere else, edit the <code>volumes</code> entry in <code>docker-compose.yml</code> and
- change the host path before the colon (for example <code>- /srv/trilium-data:/home/node/trilium-data</code>).
- Leave the path after the colon unchanged.</p>
-<h3>Start the container:</h3>
-<p>Run the following command to start the container in the background:</p><pre><code class="language-text-x-trilium-auto">docker compose up -d</code></pre>
-<h2>Running without Docker Compose / Further Configuration</h2>
-<h3>Pulling the Docker Image</h3>
-<p>To pull the image, use the following command, replacing <code>[VERSION]</code> with
- the desired version or tag, such as <code>v0.91.6</code> or just <code>latest</code>.
- (See published tag names at <a href="https://hub.docker.com/r/triliumnext/trilium/tags">https://hub.docker.com/r/triliumnext/trilium/tags</a>.):</p><pre><code class="language-text-x-trilium-auto">docker pull triliumnext/trilium:v0.91.6</code></pre>
-<p><strong>Warning:</strong> Avoid using the "latest" tag, as it may automatically
- upgrade your instance to a new minor version, potentially disrupting sync
- setups or causing other issues.</p>
-<h3>Preparing the Data Directory</h3>
-<p>Trilium requires a directory on the host system to store its data. This
- directory must be mounted into the Docker container with write permissions.</p>
-<h3>Running the Docker Container</h3>
-<div class="trilium-tabs">
- <section class="trilium-tab">
- <p class="trilium-tab-title">Local Access Only</p>
- <div class="trilium-tab-panel">
- <p>Run the container to make it accessible only from the localhost. This
- setup is suitable for testing or when using a proxy server like Nginx or
- Apache.</p><pre><code class="language-text-x-sh">sudo docker run -t -i -p 127.0.0.1:8080:8080 \
- -v ~/trilium-data:/home/node/trilium-data \
- triliumnext/trilium:[VERSION]</code></pre>
- <ol>
- <li>Verify the container is running using <code>docker ps</code>.</li>
- <li>Access Trilium via a web browser at <code>127.0.0.1:8080</code>.</li>
- </ol>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title">Local Network Access</p>
- <div class="trilium-tab-panel">
- <p>To make the container accessible only on your local network, first create
- a new Docker network:</p><pre><code class="language-text-x-sh">docker network create -d macvlan -o parent=eth0 --subnet 192.168.2.0/24 --gateway 192.168.2.254 --ip-range 192.168.2.252/27 mynet</code></pre>
- <p>Then, run the container with the network settings:</p><pre><code class="language-text-x-sh">docker run --net=mynet -d -p 127.0.0.1:8080:8080 -v ~/trilium-data:/home/node/trilium-data triliumnext/trilium:-latest</code></pre>
- <p>To set a different user ID (UID) and group ID (GID) for the saved data,
- use the <code>USER_UID</code> and <code>USER_GID</code> environment variables:</p><pre><code class="language-text-x-sh">docker run --net=mynet -d -p 127.0.0.1:8080:8080 -e "USER_UID=1001" -e "USER_GID=1001" -v ~/trilium-data:/home/node/trilium-data triliumnext/trilium:-latest</code></pre>
- <p>Find the local IP address using <code>docker inspect [container_name]</code> and
- access the service from devices on the local network.</p><pre><code class="language-text-x-sh">docker ps
-docker inspect [container_name]</code></pre>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title">Global Access</p>
- <div class="trilium-tab-panel">
- <p>To allow access from any IP address, run the container as follows:</p><pre><code class="language-text-x-sh">docker run -d -p 0.0.0.0:8080:8080 \
- -v ~/trilium-data:/home/node/trilium-data \
- triliumnext/trilium:[VERSION]</code></pre>
- <p>Stop the container with <code>docker stop &lt;CONTAINER ID&gt;</code>,
- where the container ID is obtained from <code>docker ps</code>.</p>
- </div>
- </section>
-</div>
-<h3>Custom Data Directory</h3>
-<p>For a custom data directory, use:</p><pre><code class="language-text-x-trilium-auto">-v ~/YourOwnDirectory:/home/node/trilium-data triliumnext/trilium:[VERSION]</code></pre>
-<p>If you want to run your instance in a non-default way, please use the
- volume switch as follows: <code>-v ~/YourOwnDirectory:/home/node/trilium-data triliumnext/trilium:&lt;VERSION&gt;</code>.
- It is important to be aware of how Docker works for volumes, with the first
- path being your own and the second the one to virtually bind to. <a href="https://docs.docker.com/storage/volumes/">https://docs.docker.com/storage/volumes/</a> The
- path before the colon is the host directory, and the path after the colon
- is the container's path. More details can be found in the <a href="https://docs.docker.com/storage/volumes/">Docker Volumes Documentation</a>.</p>
-<h2>Reverse Proxy</h2>
-<ol>
- <li><a href="#root/_help_ud6MShXL4WpO">Nginx</a>
- </li>
- <li><a href="#root/_help_fDLvzOx29Pfg">Apache</a>
- </li>
-</ol>
-<h3>Note on timezones</h3>
-<p>If you are having timezone issues and you are not using docker-compose,
- you may need to add a <code>TZ</code> environment variable with the <a href="https://en.wikipedia.org/wiki/List_of_tz_database_time_zones">TZ identifier</a> of
- your local timezone.</p>
-<h3>Other environment variables</h3>
-<p>For the complete list of environment variables Trilium reads (network
- settings, authentication, sync, etc.), see&nbsp;<a class="reference-link"
- href="#root/_help_Gzjqa934BdH4">Configuration (config.ini or environment variables)</a>.</p>
-<h2>Running as a non-root user</h2>
-<p>By default, the container starts as root, gives the data directory to
- the <code>node</code> user (UID and GID <code>1000</code>, or the values of <code>USER_UID</code> and <code>USER_GID</code>)
- and then runs Trilium as that user. Some environments do not allow a container
- to start as root at all, for example rootless Docker or Podman, or Kubernetes
- with <code>runAsNonRoot</code>. Starting with v0.107.0, the same image can
- run entirely as a non-root user instead.</p>
-<p>To run Trilium as a non-root user, set the user with Docker's <code>--user</code> flag:</p><pre><code class="language-text-x-sh">docker run -d -p 8080:8080 --user 1000:1000 -v /srv/trilium-data:/home/node/trilium-data triliumnext/trilium:[VERSION]</code></pre>
-<p>With Docker Compose, add <code>user:</code> to the service in <code>docker-compose.yml</code>:</p><pre><code class="language-text-x-yaml">services:
- trilium:
- user: "1000:1000"</code></pre>
-<p>The image also runs with a read-only root filesystem and without any capabilities,
- for example with <code>--read-only --tmpfs /tmp --cap-drop ALL --security-opt no-new-privileges</code>.</p>
-<p>Without root, the container cannot change the ownership of files, so:</p>
-<ul>
- <li>
- <p>The data directory on the host must exist and belong to that user before
- the container starts. If the directory is missing, Docker creates it as
- root, and Trilium cannot write to it. For example:</p><pre><code class="language-text-x-sh">mkdir -p /srv/trilium-data
-sudo chown 1000:1000 /srv/trilium-data</code></pre>
- </li>
- <li>
- <p>A named volume instead of a host directory only works for UID <code>1000</code>:
- Docker gives a new volume the owner of the image's data directory, which
- is the <code>node</code> user.</p>
- </li>
- <li>
- <p><code>USER_UID</code> and <code>USER_GID</code> are ignored. The user comes
- from <code>--user</code> or <code>user:</code> alone.</p>
- </li>
-</ul>
-<p>If Trilium cannot use its data directory, it stops at startup and prints
- which directory or files it cannot use, who owns them, and the command
- that fixes it.</p>
-<aside class="admonition note">
- <p>An installation that ran as root leaves its files owned by UID <code>1000</code>,
- or by <code>USER_UID</code> if it was set. To switch it to <code>--user</code>,
- either use that same UID, or give the data directory to the new user first,
- for example with <code>sudo chown -R 1001:1001 /srv/trilium-data</code>.</p>
-</aside>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/1. Installing the server/Using Kubernetes.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/1. Installing the server/Using Kubernetes.html
deleted file mode 100644
index acc582e20e..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/1. Installing the server/Using Kubernetes.html
+++ /dev/null
@@ -1,35 +0,0 @@
-<p>As Trilium can be run in Docker it also can be deployed in Kubernetes.
- You can either use our Helm chart, a community Helm chart, or roll your
- own Kubernetes deployment.</p>
-<p>The recommended way is to use a Helm chart.</p>
-<h2>Root privileges</h2>
-<p>By default, the Trilium container starts as root, gives the data directory
- to UID and GID <code>1000:1000</code> and then runs Trilium with those reduced
- privileges, so no init container is needed to fix the permissions. To use
- a different UID and GID, set the <code>USER_UID</code> and <code>USER_GID</code> environment
- variables.</p>
-<p>Starting with v0.107.0, the container can also run without root, which
- a <code>restricted</code> Pod Security Standard requires. Set the user in
- the pod's security context, and <code>fsGroup</code> so that Kubernetes gives
- the volume to that group:</p><pre><code class="language-text-x-yaml">securityContext:
- runAsUser: 1000
- runAsGroup: 1000
- runAsNonRoot: true
- fsGroup: 1000</code></pre>
-<p>In that mode <code>USER_UID</code> and <code>USER_GID</code> are ignored.
- See the section on running as a non-root user in&nbsp;<a class="reference-link"
- href="#root/_help_rWX5eY045zbE">Using Docker</a> for what the data directory
- needs.</p>
-<h2>Helm Charts</h2>
-<p><a href="https://github.com/TriliumNext/helm-charts">Official Helm chart</a> from
- TriliumNext Unofficial helm chart by <a href="https://github.com/ohdearaugustin">ohdearaugustin</a>: <a
- href="https://github.com/ohdearaugustin/charts">https://github.com/ohdearaugustin/charts</a>
-</p>
-<h2>Adding a Helm repository</h2>
-<p>Below is an example of how</p><pre><code class="language-text-x-trilium-auto">helm repo add trilium https://triliumnext.github.io/helm-charts
-"trilium" has been added to your repositories</code></pre>
-<h2>How to install a chart</h2>
-<p>After reviewing the <a href="https://github.com/TriliumNext/helm-charts/blob/main/charts/trilium/values.yaml"><code>values.yaml</code></a> from
- the Helm chart, modifying as required and then creating your own:</p><pre><code class="language-text-x-trilium-auto">helm install --create-namespace --namespace trilium trilium trilium/trilium -f values.yaml</code></pre>
-<p>For more information on using Helm, please refer to the Helm documentation,
- or create a Discussion in the TriliumNext GitHub Organization.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/2. Reverse proxy.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/2. Reverse proxy.html
deleted file mode 100644
index 564a61596b..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/2. Reverse proxy.html
+++ /dev/null
@@ -1,92 +0,0 @@
-<p>Trilium is typically exposed to the internet behind a <strong>reverse proxy</strong>,
- which handles TLS termination, presents a single public entry point, and
- (optionally) lets you host multiple instances under one domain. Trilium
- itself keeps running on plain HTTP on its local port; the proxy sits in
- front of it.</p>
-<p>This section collects provider-specific guides and the configuration that
- applies regardless of which proxy you use.</p>
-<h2>Provider guides</h2>
-<ul>
- <li><a class="reference-link" href="#root/_help_ud6MShXL4WpO">Nginx</a>
- </li>
- <li><a class="reference-link" href="#root/_help_5ERVJb9s4FRD">Traefik</a>
- </li>
- <li><a class="reference-link" href="#root/_help_fDLvzOx29Pfg">Apache using Docker</a>
- </li>
-</ul>
-<h2>Applies to every proxy</h2>
-<p>Regardless of the proxy you choose, make sure of the following:</p>
-<ul>
- <li><strong>Forward the WebSocket upgrade.</strong> Trilium uses a WebSocket
- for synchronization and live UI updates. Your proxy must pass the <code>Upgrade</code> and <code>Connection</code> headers
- through, otherwise the client will appear to load but never receive updates.</li>
- <li><strong>Configure the trusted proxy.</strong> So that Trilium sees the
- real client IP (for rate limiting, logging, and secure cookies) rather
- than the proxy's address. See&nbsp;<a class="reference-link" href="#root/_help_LLzSMXACKhUs">Trusted proxy</a>.</li>
- <li><strong>Terminate TLS at the proxy.</strong> See&nbsp;<a class="reference-link"
- href="#root/_help_l2VkvOwUNfZj">HTTPS (TLS)</a>.</li>
-</ul>
-<h2>Putting an authentication proxy in front of Trilium</h2>
-<p>Some setups place a <strong>forward-auth / SSO layer</strong> (Authelia,
- Authentik, oauth2-proxy, or an OIDC plugin) at the proxy so that <em>every</em> request
- must pass an interactive login first.</p>
-<p>This <strong>breaks synchronization and initial setup.</strong> Sync is
- a machine-to-machine process that runs unattended in the background — it
- has no browser and cannot complete an interactive login challenge. When
- the proxy intercepts a sync request, it returns its HTML login page instead
- of the expected JSON, and the client fails with an error such as:</p><pre><code class="language-text-x-trilium-auto">Sync failed: Request to GET https://trilium.example.com/api/setup/status failed,
-error: Unexpected token '&lt;', "&lt;!doctype "... is not valid JSON
-</code></pre>
-<p>There are two ways to resolve this:</p>
-<ul>
- <li><strong>Preferred, use Trilium's built-in authentication.</strong> Don't
- gate Trilium at the proxy at all. Trilium can authenticate the web interface
- itself, including via <a href="#root/_help_x1lQNKQBqLcA">OpenID Connect</a>.
- This leaves the sync endpoints free to authenticate the way they're designed
- to.</li>
- <li><strong>Exempt the sync endpoints from the proxy's authentication.</strong> If
- you must keep auth at the proxy, exclude these paths from the forward-auth
- check:
- <ul>
- <li><code>/api/setup/*</code>
- </li>
- <li><code>/api/login/sync</code>
- </li>
- <li><code>/api/sync/*</code>
- </li>
- </ul>
- </li>
-</ul>
-<aside class="admonition note">
- <p>This is safe: Trilium authenticates these endpoints itself. Sync uses
- a challenge-free HMAC handshake based on a shared secret, and the one-time
- setup seed request is password-protected — so exempting them at the proxy
- does not expose unauthenticated access to your data.</p>
-</aside>
-<p>An example for Nginx, where <code>/auth</code> is your forward-auth endpoint:</p><pre><code class="language-text-x-trilium-auto">server {
- # ... TLS, server_name, etc. ...
-
- # Sync and setup endpoints authenticate themselves — skip forward-auth.
- location ~ ^/api/(sync|login/sync|setup) {
- auth_request off;
- proxy_set_header Host $host;
- proxy_set_header X-Real-IP $remote_addr;
- proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
- proxy_set_header X-Forwarded-Proto $scheme;
- proxy_set_header Upgrade $http_upgrade;
- proxy_set_header Connection "upgrade";
- proxy_pass http://trilium;
- }
-
- # Everything else goes through forward-auth.
- location / {
- auth_request /auth;
- proxy_set_header Host $host;
- proxy_set_header X-Real-IP $remote_addr;
- proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
- proxy_set_header X-Forwarded-Proto $scheme;
- proxy_set_header Upgrade $http_upgrade;
- proxy_set_header Connection "upgrade";
- proxy_pass http://trilium;
- }
-}</code></pre>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/2. Reverse proxy/Apache using Docker.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/2. Reverse proxy/Apache using Docker.html
deleted file mode 100644
index a3a9db1676..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/2. Reverse proxy/Apache using Docker.html
+++ /dev/null
@@ -1,76 +0,0 @@
-<p>This tutorial assumes that you have created a DNS A record for <code>trilium.yourdomain.com</code> that
- you want to use for your Trilium server.</p>
-<h2>Docker setup</h2>
-<p>Download docker image and create container</p><pre><code class="language-text-x-trilium-auto"> docker pull triliumnext/trilium:[VERSION]
- docker create --name trilium -t -p 127.0.0.1:8080:8080 -v ~/trilium-data:/home/node/trilium-data triliumnext/trilium:[VERSION]</code></pre>
-<h2>Configuring the Apache proxy</h2>
-<ol>
- <li>
- <p>Enable apache proxy modules</p><pre><code class="language-text-x-trilium-auto"> a2enmod ssl
- a2enmod proxy
- a2enmod proxy_http
- a2enmod proxy_wstunnel</code></pre>
- </li>
- <li>
- <p>Create a new let's encrypt certificate</p><pre><code class="language-text-x-trilium-auto"> sudo certbot certonly -d trilium.mydomain.com</code></pre>
- <p>Choose standalone (2) and note the location of the created certificates
- (typically /etc/letsencrypt/live/...)</p>
- </li>
- <li>
- <p>Create a new virtual host file for apache (you may want to use <code>apachectl -S</code> to
- determine the server root location, mine is /etc/apache2)</p><pre><code class="language-text-x-trilium-auto"> sudo nano /etc/apache2/sites-available/trilium.yourdomain.com.conf</code></pre>
- <p>Paste (and customize) the following text into the configuration file</p><pre><code class="language-text-x-trilium-auto">
- ServerName http://trilium.yourdomain.com
- RewriteEngine on
- RewriteRule ^ https://%{SERVER_NAME}%{REQUEST_URI} [END,QSA,R=permanent]
-
-
- ServerName https://trilium.yourdomain.com
- RewriteEngine On
- RewriteCond %{HTTP:Connection} Upgrade [NC]
- RewriteCond %{HTTP:Upgrade} websocket [NC]
- RewriteRule /(.*) ws://localhost:8080/$1 [P,L]
- AllowEncodedSlashes NoDecode
- ProxyPass / http://localhost:8080/ nocanon
- ProxyPassReverse / http://localhost:8080/
- SSLCertificateFile /etc/letsencrypt/live/trilium.yourdomain.com/fullchain.pem
- SSLCertificateKeyFile /etc/letsencrypt/live/trilium.yourdomain.com/privkey.pem
- Include /etc/letsencrypt/options-ssl-apache.conf
- </code></pre>
- </li>
- <li>
- <p>Enable the virtual host with <code>sudo a2ensite trilium.yourdomain.com.conf</code>
- </p>
- </li>
- <li>
- <p>Reload apache2 with <code>sudo systemctl reload apache2</code>
- </p>
- </li>
-</ol>
-<h2>Configuring the trusted proxy</h2>
-<p>After setting up a reverse proxy, make sure to configure the&nbsp;<a class="reference-link"
- href="#root/_help_LLzSMXACKhUs">Trusted proxy</a>.</p>
-<h2>Setup the systemd service to start up the server</h2>
-<p>Create and enable a systemd service to start the docker container on boot</p>
-<ol>
- <li>
- <p>Create a new empty file called <code>/lib/systemd/system/trilium.service</code> with
- the contents</p><pre><code class="language-text-x-trilium-auto"> [Unit]
- Description=Trilium Server
- Requires=docker.service
- After=docker.service
-
- [Service]
- Restart=always
- ExecStart=/usr/bin/docker start -a trilium
- ExecStop=/usr/bin/docker stop -t 2 trilium
-
- [Install]
- WantedBy=local.target</code></pre>
- </li>
- <li>
- <p>Install, enable and start service</p><pre><code class="language-text-x-trilium-auto"> sudo systemctl daemon-reload
- sudo systemctl enable trilium.service
- sudo systemctl start trilium.service</code></pre>
- </li>
-</ol>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/2. Reverse proxy/Nginx.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/2. Reverse proxy/Nginx.html
deleted file mode 100644
index 3ea96af027..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/2. Reverse proxy/Nginx.html
+++ /dev/null
@@ -1,75 +0,0 @@
-<p>Configure Nginx proxy and HTTPS. The operating system here is Ubuntu.</p>
-<h2>Installing Nginx</h2>
-<p>Download Nginx and remove Apache2</p><pre><code class="language-text-x-trilium-auto">sudo apt-get install nginx
-sudo apt-get remove apache2</code></pre>
-<h2>Build the configuration file</h2>
-<ol>
- <li>
- <p>First, create the configuration file:</p><pre><code class="language-text-x-trilium-auto">cd /etc/nginx/conf.d
-vim default.conf</code></pre>
- </li>
- <li>
- <p>Fill the file with the context shown below, part of the setting show be
- changed. Then you can enjoy your web with HTTPS forced and proxy.</p><pre><code class="language-text-x-trilium-auto"># This part configures, where your Trilium server is running
-upstream trilium {
- zone trilium 64k;
- server 127.0.0.1:8080; # change it to a different hostname and port if non-default is used
- keepalive 2;
-}
-
-# This part is for proxy and HTTPS configure
-server {
- listen 443 ssl;
- server_name trilium.example.net; #change trilium.example.net to your domain without HTTPS or HTTP.
- ssl_certificate /etc/ssl/note/example.crt; #change /etc/ssl/note/example.crt to your path of crt file.
- ssl_certificate_key /etc/ssl/note/example.net.key; #change /etc/ssl/note/example.net.key to your path of key file.
- ssl_session_cache builtin:1000 shared:SSL:10m;
- ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
- ssl_ciphers HIGH:!aNULL:!eNULL:!EXPORT:!CAMELLIA:!DES:!MD5:!PSK:!RC4;
- ssl_prefer_server_ciphers on;
- access_log /var/log/nginx/access.log; #check the path of access.log, if it doesn't fit your file, change it
-
- location / {
- proxy_set_header Host $host;
- proxy_set_header X-Real-IP $remote_addr;
- proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
- proxy_set_header X-Forwarded-Proto $scheme;
- proxy_set_header Upgrade $http_upgrade;
- proxy_set_header Connection "upgrade";
- proxy_pass http://trilium;
- proxy_read_timeout 90;
- }
-}
-
-# This part is for HTTPS forced
-server {
- listen 80;
- server_name trilium.example.net; # change to your domain
- return 301 https://$server_name$request_uri;
-}</code></pre>
- </li>
-</ol>
-<h2>Serving under a different path</h2>
-<p>Alternatively if you want to serve the instance under a different path
- (useful e.g. if you want to serve multiple instances), update the location
- block like so:</p>
-<ul>
- <li>update the location with your desired path (make sure to not leave a trailing
- slash "/", if your <code>proxy_pass</code> does not end on a slash as well)</li>
- <li>add the <code>proxy_cookie_path</code> directive with the same path: this
- allows you to stay logged in at multiple instances at the same time.</li>
-</ul><pre><code class="language-text-x-trilium-auto"> location /trilium/instance-one {
- rewrite /trilium/instance-one/(.*) /$1 break;
- proxy_set_header Host $host;
- proxy_set_header X-Real-IP $remote_addr;
- proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
- proxy_set_header X-Forwarded-Proto $scheme;
- proxy_set_header Upgrade $http_upgrade;
- proxy_set_header Connection "upgrade";
- proxy_pass http://trilium;
- proxy_cookie_path / /trilium/instance-one
- proxy_read_timeout 90;
- }</code></pre>
-<h2>Configuring the trusted proxy</h2>
-<p>After setting up a reverse proxy, make sure to configure the&nbsp;<a class="reference-link"
- href="#root/_help_LLzSMXACKhUs">Trusted proxy</a>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/2. Reverse proxy/Traefik.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/2. Reverse proxy/Traefik.html
deleted file mode 100644
index 249d6ae095..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/2. Reverse proxy/Traefik.html
+++ /dev/null
@@ -1,74 +0,0 @@
-<p>The goal of this article is to configure Traefik proxy and HTTPS. See <a
- href="https://github.com/TriliumNext/Trilium/issues/7768#issuecomment-3539165814">#7768</a> for
- reference.</p>
-<h2>Breaking change in Traefik 3.6.4</h2>
-<p>Traefik 3.6.4 introduced a <a href="https://doc.traefik.io/traefik/migrate/v3/#encoded-characters-in-request-path">breaking change</a> regarding
- how percent-encoded characters are handled in URLs. Trilium puts the title
- of an image or attachment in its URL path, so one whose title contains <code>#</code> or <code>/</code> is
- requested at a path such as <code>/api/images/…/diagram%231.png</code>.
- Traefik rejects these paths with HTTP 400, and the image does not load.
- Search is not affected, because it sends its text in a query parameter.</p>
-<p>The easiest solution is to update to Traefik 3.6.7 or later which reverts
- this configuration change. Alternatively, the configuration can be changed
- according to the section below.</p>
-<details class="trilium-collapsible">
- <summary>Configuration change</summary>
- <p>To solve this, the Traefik <a href="https://doc.traefik.io/traefik/getting-started/configuration-overview/#the-install-configuration"><strong>static</strong> configuration</a> must
- be modified in order to allow those characters:</p><pre><code class="language-text-x-yaml">entryPoints:
- web:
- http:
- encodedCharacters:
- allowEncodedSlash: true
- allowEncodedHash: true</code></pre>
- <aside class="admonition tip">
- <p>If images still fail to load, you might need to enable more encoded character
- groups. For more information, see <a href="https://github.com/TriliumNext/Trilium/issues/7968">the relevant GitHub issue</a>;
- feel free to report your findings.</p>
- </aside>
-</details>
-<h3>Build the docker-compose file</h3>
-<p>Setting up Traefik as reverse proxy requires setting the following labels:</p><pre><code class="language-text-x-yaml"> labels:
- - traefik.enable=true
- - traefik.http.routers.trilium.entrypoints=https
- - traefik.http.routers.trilium.rule=Host(`trilium.mydomain.tld`)
- - traefik.http.routers.trilium.tls=true
- - traefik.http.routers.trilium.service=trilium
- - traefik.http.services.trilium.loadbalancer.server.port=8080
- # scheme must be HTTP instead of the usual HTTPS because Trilium listens on HTTP internally
- - traefik.http.services.trilium.loadbalancer.server.scheme=http
- - traefik.docker.network=proxy
- # forward HTTP to HTTPS
- - traefik.http.routers.trilium.middlewares=trilium-headers@docker
- - traefik.http.middlewares.trilium-headers.headers.customrequestheaders.X-Forwarded-Proto=https</code></pre>
-<h3>Setup needed environment variables</h3>
-<p>After setting up a reverse proxy, make sure to configure the&nbsp;<a class="reference-link"
- href="#root/_help_LLzSMXACKhUs">Trusted proxy</a>.</p>
-<h3>Example <code>docker-compose.yaml</code></h3><pre><code class="language-text-x-yaml">services:
- trilium:
- image: triliumnext/trilium
- container_name: trilium
- networks:
- - traefik-proxy
- environment:
- - TRILIUM_NETWORK_TRUSTEDREVERSEPROXY=my-traefik-host-ip # e.g., 172.18.0.0/16
- volumes:
- - /path/to/data:/home/node/trilium-data
- - /etc/timezone:/etc/timezone:ro
- - /etc/localtime:/etc/localtime:ro
- labels:
- - traefik.enable=true
- - traefik.http.routers.trilium.entrypoints=https
- - traefik.http.routers.trilium.rule=Host(`trilium.mydomain.tld`)
- - traefik.http.routers.trilium.tls=true
- - traefik.http.routers.trilium.service=trilium
- - traefik.http.services.trilium.loadbalancer.server.port=8080
- # scheme must be HTTP instead of the usual HTTPS because of how trilium works
- - traefik.http.services.trilium.loadbalancer.server.scheme=http
- - traefik.docker.network=traefik-proxy
- # Tell Trilium the original request was HTTPS
- - traefik.http.routers.trilium.middlewares=trilium-headers@docker
- - traefik.http.middlewares.trilium-headers.headers.customrequestheaders.X-Forwarded-Proto=https
-
-networks:
- traefik-proxy:
- external: true</code></pre>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/2. Reverse proxy/Trusted proxy.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/2. Reverse proxy/Trusted proxy.html
deleted file mode 100644
index e477571ac7..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/2. Reverse proxy/Trusted proxy.html
+++ /dev/null
@@ -1,11 +0,0 @@
-<p>If you are running the Trilium server under a <a href="#root/_help_vcjrb3VVYPZI">reverse proxy</a>,
- it's important to configure it as a trusted proxy so that the application
- can correctly identify the real IP address of the clients (for authentication
- and rate limiting purposes).</p>
-<p>To do so, simply modify&nbsp;<a class="reference-link" href="#root/_help_Gzjqa934BdH4">Configuration (config.ini or environment variables)</a>&nbsp;and
- set:</p><pre><code class="language-text-x-trilium-auto">[Network]
-trustedReverseProxy=true</code></pre>
-<p>This will use the left-most IP in the <code>X-Forwarded-For</code> header.
- Alternatively, instead of <code>true</code> use the IP address of the reverse
- proxy or Express.js shortcuts such as:</p><pre><code class="language-text-x-trilium-auto">loopback(127.0.0.1/8, ::1/128), linklocal(169.254.0.0/16, fe80::/10), uniquelocal(10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, fc00::/7)</code></pre>
-<p>For more information, consult <a href="https://expressjs.com/en/guide/behind-proxies.html">Express behind proxies</a>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/Authentication.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/Authentication.html
deleted file mode 100644
index 55a085b4bb..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/Authentication.html
+++ /dev/null
@@ -1,35 +0,0 @@
-<h2>Disabling authentication</h2>
-<p>If you are running Trilium on <code>localhost</code> only or if authentication
- is handled by another component, you can disable Trilium’s authentication
- by adding the following to <code>config.ini</code>:</p><pre><code class="language-text-x-trilium-auto">[General]
-noAuthentication=true</code></pre>
-<p>Disabling authentication will bypass even the&nbsp;<a class="reference-link"
- href="#root/_help_7DAiwaf8Z7Rz">Multi-Factor Authentication</a>&nbsp;since
- v0.94.1.</p>
-<h2>Understanding how the session works</h2>
-<p>Once logged into Trilium, the application will store this information
- about the login into a cookie on the browser, but also as a session on
- the server.</p>
-<p>If “Remember me” is checked, then the login will expire in 21 days. This
- period can be adjusted by modifying the <code>Session.cookieMaxAge</code> value
- in <code>config.ini</code>. For example, to have the session expire in one
- day:</p><pre><code class="language-text-x-trilium-auto">[Session]
-cookieMaxAge=86400</code></pre>
-<p>When “Remember me” is unchecked, the behavior is different. At client/browser
- level the authentication does not have any expiration date, but it will
- be automatically cleared as soon as the user closes the browser. Nevertheless,
- the server will also dismiss this authentication in around 24 hours from
- the <em>last interaction with the application</em>.</p>
-<h2>Viewing active sessions</h2>
-<p>The login sessions are now stored in the same&nbsp;<a class="reference-link"
- href="#root/_help_wX4HbRucYSDD">Database</a>&nbsp;as the user data. In
- order to view which sessions are active, open the&nbsp;<a class="reference-link"
- href="#root/_help_YKWqdJhzi2VY">SQL Console</a>&nbsp;and run the following
- query:</p><pre><code class="language-text-x-trilium-auto">SELECT * FROM sessions</code></pre>
-<p>Expired sessions are periodically cleaned by the server, generally an
- hourly interval.</p>
-<h2>See also</h2>
-<ul>
- <li><a class="reference-link" href="#root/_help_7DAiwaf8Z7Rz">Multi-Factor Authentication</a>
- </li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/Authentication/Resetting your password.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/Authentication/Resetting your password.html
deleted file mode 100644
index 88e7bfe464..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/Authentication/Resetting your password.html
+++ /dev/null
@@ -1,49 +0,0 @@
-<aside class="admonition important">
- <p>If you forget your password:</p>
- <ul>
- <li>Protected notes are irretrievable without the password.</li>
- <li>Unprotected notes can be recovered.</li>
- </ul>
-</aside>
-<p>There are two options, both involving access to the device that is running
- your server.</p>
-<h3>By disabling authentication</h3>
-<ol>
- <li>See&nbsp;<a class="reference-link" href="#root/_help_0hzsNCP31IAB">Authentication</a>&nbsp;on
- how to disable the authentication.</li>
- <li>Restart the server.</li>
- <li>Go to&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→
- Password → Reset password.</li>
- <li>Re-enable authentication by following step (1) in reverse.</li>
- <li>Restart the server.</li>
- <li>Log in with the new password.</li>
-</ol>
-<h3>By altering the database</h3>
-<ol>
- <li>
- <p>Access the <a href="#root/_help_wX4HbRucYSDD">database</a> file in the <a
- href="#root/_help_tAassRL4RSQL">data directory</a>. Open the <code>document.db</code> file
- with an SQLite client (e.g., <a href="https://sqlitebrowser.org/">DB Browser</a>).</p>
- </li>
- <li>
- <p>Execute the following queries:</p><pre><code class="language-text-x-trilium-auto">UPDATE options SET value = '77/twC5O00cuQgNC63VK32qOKKYwj21ev3jZDXoytVU=' WHERE name = 'passwordVerificationSalt';
-UPDATE options SET value = '710BMasZCAgibzIc07X4P9Q4TeBd4ONnqJOho+pWcBM=' WHERE name = 'passwordDerivedKeySalt';
-UPDATE options SET value = 'Eb8af1/T57b89lCRuS97tPEl4CwxsAWAU7YNJ77oY+s=' WHERE name = 'passwordVerificationHash';
-UPDATE options SET value = 'QpC8XoiYYeqHPtHKRtbNxfTHsk+pEBqVBODYp0FkPBa22tlBBKBMigdLu5GNX8Uu' WHERE name = 'encryptedDataKey';</code></pre>
- </li>
- <li>
- <p>After executing the changes, commit/write the changes. <strong>This sets the password to</strong> <code>**password**</code><strong>, allowing you to log in again.</strong>
- </p>
- </li>
- <li>
- <p>Go to&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Password</em> → <em>Change password</em> and
- replace the unsafe password.</p>
- </li>
-</ol>
-<h2>Handling protected notes</h2>
-<p>When the password is reset, the protected notes are permanently lost due
- to the fact that they are encrypted with your password so there is no way
- for Trilium to recover them.</p>
-<p>For pre-existing protected notes (now unrecoverable), consider deleting
- them or exporting the unprotected notes. Then, delete <code>document.db</code> and
- start fresh.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/HTTPS (TLS).html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/HTTPS (TLS).html
deleted file mode 100644
index f28b4da7ec..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/HTTPS (TLS).html
+++ /dev/null
@@ -1,52 +0,0 @@
-<p>Configuring TLS is essential for <a href="#root/_help_WOcw2SLH6tbX">server installation</a> in
- Trilium. This guide details the steps to set up TLS within Trilium itself.</p>
-<aside
-class="admonition tip">
- <p>While Trilium supports HTTPS on its own, it's generally a good idea to
- use a <a href="#root/_help_vcjrb3VVYPZI">reverse proxy</a> instead with TLS
- termination. You can follow a <a href="https://www.digitalocean.com/community/tutorials/how-to-secure-nginx-with-let-s-encrypt-on-ubuntu-20-04">guide like this</a> for
- such setups.</p>
-</aside>
-<h2>Obtaining a TLS Certificate</h2>
-<p>You have two options for obtaining a TLS certificate:</p>
-<ul>
- <li><strong>Recommended</strong>: Obtain a TLS certificate signed by a root
- certificate authority. For personal use, <a href="https://letsencrypt.org">Let's Encrypt</a> is
- an excellent choice. It is free, automated, and straightforward. Certbot
- can facilitate automatic TLS setup.</li>
- <li>Generate a self-signed certificate. This option is not recommended due
- to the additional complexity of importing the certificate into all machines
- connecting to the server.</li>
-</ul>
-<h2>Modifying <code>config.ini</code></h2>
-<p>Once you have your certificate, modify the <code>config.ini</code> file
- in the <a href="#root/_help_tAassRL4RSQL">data directory</a> to configure
- Trilium to use it:</p><pre><code class="language-text-x-trilium-auto">[Network]
-port=8080
-# Set to true for TLS/SSL/HTTPS (secure), false for HTTP (insecure).
-https=true
-# Path to the certificate (run "bash bin/generate-cert.sh" to generate a self-signed certificate).
-# Relevant only if https=true
-certPath=/[username]/.acme.sh/[hostname]/fullchain.cer
-keyPath=/[username]/.acme.sh/[hostname]/example.com.key</code></pre>
-<p>You can also review the <a href="#root/_help_Gzjqa934BdH4">configuration</a> file
- to provide all <code>config.ini</code> values as environment variables instead.
- For example, you can configure TLS using environment variables:</p><pre><code class="language-text-x-trilium-auto">export TRILIUM_NETWORK_HTTPS=true
-export TRILIUM_NETWORK_CERTPATH=/path/to/cert.pem
-export TRILIUM_NETWORK_KEYPATH=/path/to/key.pem</code></pre>
-<p>The above example shows how this is set up in an environment where the
- certificate was generated using Let's Encrypt's ACME utility. Your paths
- may differ. For Docker installations, ensure these paths are within a volume
- or another directory accessible by the Docker container, such as <code>/home/node/trilium-data/[DIR IN DATA DIRECTORY]</code>.</p>
-<p>After configuring <code>config.ini</code>, restart Trilium and access the
- hostname using "https".</p>
-<h2>Self-Signed Certificate</h2>
-<p>If you opt to use a self-signed certificate for your server instance,
- note that the desktop instance will not trust it by default.</p>
-<p>To bypass this, disable certificate validation by setting the following
- environment variable (for Linux):</p><pre><code class="language-text-x-trilium-auto">export NODE_TLS_REJECT_UNAUTHORIZED=0
-trilium</code></pre>
-<p>Trilium provides scripts to start in this mode, such as <code>trilium-no-cert-check.bat</code> for
- Windows.</p>
-<p><strong>Warning</strong>: Disabling TLS certificate validation is insecure.
- Proceed only if you fully understand the implications.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/Multi-factor authentication with TOTP.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/Multi-factor authentication with TOTP.html
deleted file mode 100644
index 536d513c08..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/Multi-factor authentication with TOTP.html
+++ /dev/null
@@ -1,45 +0,0 @@
-<p>Multi-factor authentication (MFA) is a security process that requires
- users to provide two or more verification factors to gain access to a system,
- application, or account. This adds an extra layer of protection beyond
- just using a password.</p>
-<p>By requiring more than one verification method, MFA helps reduce the risk
- of unauthorized access, even if someone has obtained your password. It’s
- highly recommended for securing sensitive information stored in your notes.</p>
-<h2>Relationship to OpenID Connect (OIDC)</h2>
-<p>Multi-factor authentication makes your Trilium login safer by requiring
- an additional proof of identity apart from your password.&nbsp;<a class="reference-link"
- href="#root/_help_x1lQNKQBqLcA">Signing in with OpenID Connect</a>&nbsp;is
- a different concept which delegates your authentication to an external
- provider (e.g. your Google provider, or a self-hosted one such as Authelia).
- These authentication providers might provide their own security features
- such as TOTP or passkeys.</p>
-<h2>Time-based one-time password (TOTP)</h2>
-<p>TOTP (Time-Based One-Time Password) is a security feature that generates
- a unique, temporary code on your device, like a smartphone, which changes
- every 30 seconds. You use this code, along with your password, to log into
- your account, making it much harder for anyone else to access them.</p>
-<ol>
- <li>Go to&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Password &amp; Auth.</em>
- </li>
- <li>Make sure <em>Sign-in with</em> has <em>Local password</em> selected.</li>
- <li>In the <em>Two-factor authentication</em> section, press <em>Set up.</em>
- </li>
- <li>Scan the QR code or manually enter the code in your authenticator app.</li>
- <li>Enter the verification code from your authenticator app to confirm that
- the setup was successful and press <em>Verify &amp; continue</em>.</li>
- <li>Save the recovery codes, then tick the confirmation and press <em>Finish setup</em>.</li>
- <li>Re-login will be required after TOTP setup is finished (After you refreshing
- the page).</li>
-</ol>
-<h2>Recovery codes</h2>
-<p>Recovery codes can be used in place of the TOTP if you lose access to
- your authenticator. Trilium provides 8 different recovery codes, each recovery
- code can be used once.</p>
-<p>To use a recovery code, simply login with your password and use the recovery
- code as the security token.</p>
-<p>The initial set of recovery codes is generated when setting up your TOTP
- for the first time. They can be regenerated at any time by going to &nbsp;<a
- class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Password &amp; Auth</em> and
- pressing the <em>Regenerate recovery codes</em> button. This will generate
- a new set of recovery codes while at the same time disabling the previous
- ones.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/Nix flake.clone.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/Nix flake.clone.html
deleted file mode 100644
index e9944f59e8..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/Nix flake.clone.html
+++ /dev/null
@@ -1 +0,0 @@
-<p>This is a clone of a note. Go to its <a href="../Desktop%20Installation/Nix%20flake.html">primary location</a>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/Signing in with OpenID Connect.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/Signing in with OpenID Connect.html
deleted file mode 100644
index cacd4fdaec..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/Signing in with OpenID Connect.html
+++ /dev/null
@@ -1,276 +0,0 @@
-<p>OpenID is a standardized way to let you log into websites using an account
- from another service, like Google or Authelia, to verify your identity.</p>
-<p>When OpenID is activated, the password-based authentication in Trilium
- is replaced with a button that connects using your provider. This means
- that the configuration of&nbsp;<a class="reference-link" href="#root/_help_7DAiwaf8Z7Rz">Multi-factor authentication with TOTP</a>&nbsp;no
- longer takes effect, since your provider has to handle any multi-factor
- authentication.</p>
-<h2>Setup</h2>
-<p>Setting up authentication with OpenID connect is a two-step process:</p>
-<ol>
- <li>First the Trilium server must be configured with information about your
- authentication provider such as the URL, client ID and secret.</li>
- <li>Second, the user must connect from options to create a link between the
- account on the provider and the one Trilium has.</li>
-</ol>
-<h3>Configuring the authentication provider</h3>
-<ol>
- <li>
- <p>First, make sure the authentication provider (e.g. Google, Authelia) is
- configured properly. See&nbsp;<a class="reference-link" href="#root/_help_IgkTHSaFfq6A">Setting up with various providers</a>&nbsp;for
- concrete examples.</p>
- <ol>
- <li>The redirect URL of Trilium is <code>https://&lt;your-trilium-domain&gt;/callback</code>.</li>
- <li>You should obtain the base URL, client ID and client secret.</li>
- </ol>
- </li>
- <li>
- <p>Set the following information using&nbsp;<a class="reference-link" href="#root/_help_Gzjqa934BdH4">Configuration (config.ini or environment variables)</a>:</p>
- <figure
- class="table">
- <table>
- <thead>
- <tr>
- <th>Configuration</th>
- <th><code>config.ini</code> in <code>[MultiFactorAuthentication]</code> section</th>
- <th>Environment variable</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>Base URL*</td>
- <td><code>oauthBaseUrl</code>
- </td>
- <td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHBASEURL</code>
- </td>
- <td>The URL of your Trilium instance (e.g. <code>https://example.com</code>).</td>
- </tr>
- <tr>
- <td>Client ID*</td>
- <td><code>oauthClientId</code>
- </td>
- <td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHCLIENTID</code>
- </td>
- <td>The client ID from your provider configuration.</td>
- </tr>
- <tr>
- <td>Client Secret*</td>
- <td><code>oauthClientSecret</code>
- </td>
- <td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHCLIENTSECRET</code>
- </td>
- <td>The client secret from your provider configuration.</td>
- </tr>
- <tr>
- <td>Client auth method</td>
- <td><code>oauthClientAuthMethod</code>
- </td>
- <td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHCLIENTAUTHMETHOD</code>
- </td>
- <td>Token-endpoint auth method: <code>client_secret_basic</code> or <code>client_secret_post</code>.
- Empty auto-detects. &nbsp;Only needed if sign-in fails with a <code>WWW-Authenticate</code> or <code>invalid_client</code> error.</td>
- </tr>
- <tr>
- <td>ID token algorithm</td>
- <td><code>oauthIdTokenSigningAlg</code>
- </td>
- <td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHIDTOKENSIGNINGALG</code>
- </td>
- <td><span style="color:rgb(32,32,32);">The algorithm your provider signs ID tokens with, e.g.</span> <code>RS256</code><span
- style="color:rgb(32,32,32);">,</span> <code>EdDSA</code><span style="color:rgb(32,32,32);">,</span> <code>ES256</code><span
- style="color:rgb(32,32,32);">. Empty auto-detects from the provider. Only needed if sign-in fails with an</span> <code>unexpected JWT alg</code> <span
- style="color:rgb(32,32,32);">error.</span>
- </td>
- </tr>
- </tbody>
- </table>
- </figure>
- <p>Asterisk (*) marks a required field</p>
- </li>
- <li>
- <p>The default OAuth issuer is Google. To use other services such as Authentik
- or Auth0, you can configure the settings via <code>oauthIssuerBaseUrl</code>, <code>oauthIssuerName</code>,
- and <code>oauthIssuerIcon</code> in the <code>config.ini</code> file. Alternatively,
- these values can be set using environment variables:</p>
- <figure class="table">
- <table>
- <thead>
- <tr>
- <th>Configuration</th>
- <th><code>config.ini</code> in <code>[MultiFactorAuthentication]</code> section</th>
- <th>Environment variable</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>Issuer base URL</td>
- <td><code>oauthIssuerBaseUrl</code>
- </td>
- <td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHISSUERBASEURL</code>
- </td>
- <td>Either the issuer itself (<code>https://auth.example.com</code>) or a
- full discovery URL (<code>https://auth.example.com/.well-known/openid-configuration</code>).
- <br>
- <br>A URL containing <code>/.well-known/</code> is used as-is<span style="color:rgb(32,32,32);">, which is convenient when your provider hands you a discovery URL to copy. A trailing slash may be included or omitted; Trilium matches whichever spelling the provider advertises.</span>
- <br>
- <br>Use the full form when your provider advertises an issuer that differs
- from the path serving its discovery document, such as Authentik in "global"
- issuer mode.</td>
- </tr>
- <tr>
- <td>Issuer name</td>
- <td><code>oauthIssuerName</code>
- </td>
- <td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHISSUERNAME</code>
- </td>
- <td>The name of your authentication provider, used for reference on the login
- screen and in settings. Default is “Google”.</td>
- </tr>
- <tr>
- <td>Issuer icon</td>
- <td><code>oauthIssuerIcon</code>
- </td>
- <td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHISSUERICON</code>
- </td>
- <td>Optionally, the URL to a logo of the provider. By default it will try
- to obtain the favicon from the website, so it's optional.</td>
- </tr>
- </tbody>
- </table>
- </figure>
- <p>All the fields here are optional, since the default OAuth issuer is Google.</p>
- </li>
- <li>
- <p>Optionally, tune the following advanced settings. All are optional and
- have sensible defaults:</p>
- <figure class="table">
- <table>
- <thead>
- <tr>
- <th>Configuration</th>
- <th><code>config.ini</code> in <code>[MultiFactorAuthentication]</code> section</th>
- <th>Environment variable</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>HTTP timeout</td>
- <td><code>oauthHttpTimeout</code>
- </td>
- <td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHHTTPTIMEOUT</code>
- </td>
- <td>Timeout in milliseconds for the provider HTTP requests (discovery, token
- exchange, userinfo). Defaults to <code>30000</code> (30s). Raise this if
- your provider cold-starts slowly and you are occasionally asked to sign
- in twice. Minimum accepted value is <code>500</code>.</td>
- </tr>
- <tr>
- <td>Scopes</td>
- <td><code>oauthScope</code>
- </td>
- <td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHSCOPE</code>
- </td>
- <td>Space-separated list of OIDC scopes requested at login. Defaults to <code>openid profile email</code>. <code>openid</code> is
- required and is prepended automatically if you omit it.</td>
- </tr>
- </tbody>
- </table>
- </figure>
- <p>The OIDC session lifetime is automatically bound to Trilium's own session
- cookie lifetime (the <code>cookieMaxAge</code> setting in the <code>[Session]</code> section,
- 21 days by default), so a single sign-in stays valid for as long as your
- Trilium session does rather than expiring early on the OIDC library's shorter
- internal defaults.</p>
- </li>
- <li>
- <p>Restart the server so that the changes are applied.</p>
- </li>
-</ol>
-<aside class="admonition note">
- <p>Legacy environment variables are also supported: <code>TRILIUM_OAUTH_BASE_URL</code>, <code>TRILIUM_OAUTH_CLIENT_ID</code>, <code>TRILIUM_OAUTH_CLIENT_SECRET</code>,
- and for customizing the provider: <code>TRILIUM_OAUTH_ISSUER_BASE_URL</code>, <code>TRILIUM_OAUTH_ISSUER_NAME</code>, <code>TRILIUM_OAUTH_ISSUER_ICON</code>, <code>TRILIUM_OAUTH_HTTP_TIMEOUT</code>, <code>TRILIUM_OAUTH_SCOPE</code>, <code>TRILIUM_OAUTH_CLIENT_AUTH_METHOD</code>, <code>TRILIUM_OAUTH_ID_TOKEN_SIGNING_ALG</code>.</p>
-</aside>
-<h2>Connecting to the authentication provider</h2>
-<p>Once the server has been configured at the previous step, the next step
- is to create a link between your account on the authentication provider
- and the Trilium instance. This makes sure that only you can access the
- Trilium instance, and not just any other valid account.</p>
-<p>To do so:</p>
-<ol>
- <li>Go to&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Password &amp; Auth.</em>
- </li>
- <li>In the <em>Sign-in with</em> field, choose <em>OpenID Connect provider.</em>
- </li>
- <li>In the <em>OpenID Connect</em> section, look for the <em>Connect account</em> (<span
- class="tn-icon bx bx-log-in"></span>) button.</li>
- <li>This will redirect you to your authentication provider, where you can
- sign in or confirm the action if needed.</li>
- <li>Once you are authenticated you will be redirected back to the Trilium
- application.</li>
-</ol>
-<h2>Logging out</h2>
-<p>When logging out of Trilium, a request is made to the authentication provider
- to log out from there as well. This feature depends on the authentication
- provider, so it may not be honored (Google and Authelia are known cases
- in which they don't respect the logout feature).</p>
-<h2>Switching providers</h2>
-<p>When switching providers (e.g. going from Google to Authelia), it's important
- to take the following steps:</p>
-<ol>
- <li>Go to&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Password &amp; Auth</em>.</li>
- <li>In the <em>OpenID Connect</em> section, press the <em>Disconnect</em> (<span
- class="tn-icon bx bx-trash"></span>) button.</li>
- <li>Wait for the section to indicate that you are disconnected.</li>
- <li>Change the configuration pointing to the new provider.</li>
- <li>Restart your server.</li>
- <li>Repeat the normal steps to connect to the authentication provider.</li>
-</ol>
-<p>Failing to disconnect before switching providers might temporarily lock
- you in, as you will not be able to login (credentials won't match). Should
- this happen:</p>
-<ol>
- <li>Modify the server configuration again to your old provider.</li>
- <li>Restart the server and follow the disconnect instructions above.</li>
- <li>Modify the server configuration again to your new provider.</li>
- <li>Restart again the server.</li>
-</ol>
-<h2>Deactivating OpenID Connect temporarily</h2>
-<p>To disable the OpenID Connect authentication and instead rely on the local
- password temporarily, you must:</p>
-<ol>
- <li>Modify the <code>config.ini</code> or environment variables (depending on
- how you set up the provider information) and temporarily deactivate the
- multi-factor authentication section by renaming <code>[MultiFactorAuthentication]</code> to
- something else (e.g. <code>[MultiFactorAuthentication.bak]</code>.</li>
- <li>Restart the server for the changes to take effect.</li>
-</ol>
-<h2>Troubleshooting</h2>
-<h3>Setup fails with a <code>WWW-Authenticate</code> or <code>invalid_client</code> error</h3>
-<p>Your provider disagrees with Trilium about how client credentials should
- be sent to the token endpoint. Set <code>oauthClientAuthMethod</code> to <code>client_secret_post</code> (or <code>client_secret_basic</code> if
- it's already set to post) and restart. Providers vary: some reject <code>client_secret_post</code> outright
- because the method is fixed when the client is registered (e.g. Authelia),
- so if one value doesn't work, try the other.</p>
-<h3>Setup fails with <code>invalid user</code></h3>
-<p>If you are running behind a <a href="#root/_help_vcjrb3VVYPZI">reverse proxy</a>,
- a buffer overflow can also cause this issue. Here is a sample fix for&nbsp;<a
- class="reference-link" href="#root/_help_ud6MShXL4WpO">Nginx</a>: </p><pre><code class="language-text-x-trilium-auto">proxy_buffer_size 128k;
-proxy_buffers 4 256k;
-proxy_busy_buffers_size 256k;</code></pre>
-<h3>Setup fails with an <code>unexpected JWT alg</code> error</h3>
-<p>Depending on your version the message reads <code>unexpected JWT "alg" header parameter</code> or <code>unexpected JWT alg received, expected RS256, got: EdDSA</code>.
- Both mean the same thing: your provider signs ID tokens with an algorithm
- other than RS256. Pocket ID (Ed25519) and Kanidm (ES256) do this.</p>
-<p>From v0.104.2 Trilium detects the algorithm from your provider automatically,
- and the log records the outcome (<code>OAuth: the issuer does not sign ID tokens with RS256; expecting ES256</code>).
- If detection can't reach the provider it falls back to RS256, so check
- that the issuer URL is correct and reachable first. Should it still fail,
- set <code>oauthIdTokenSigningAlg</code> explicitly to the algorithm your
- provider uses.</p>
-<h3>Setup fails with <code>OAUTH_RESPONSE_IS_NOT_CONFORM</code></h3>
-<p>Make sure the base URL is correct and that the identity provider actually
- supports OpenID Connect. Some providers such as GitHub offer only OAuth
- 2.0.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/Signing in with OpenID Connect/Setting up with various providers.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/Signing in with OpenID Connect/Setting up with various providers.html
deleted file mode 100644
index 5c5257e2c4..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/Signing in with OpenID Connect/Setting up with various providers.html
+++ /dev/null
@@ -1,191 +0,0 @@
-<p>This page contains instructions on how to set up&nbsp;<a class="reference-link"
- href="#root/_help_x1lQNKQBqLcA">Signing in with OpenID Connect</a>&nbsp;with
- various providers such as Authelia, GitLab, Google.</p>
-<aside class="admonition note">
- <p>While the configuration reference is correct and up to date, the steps
- to create the OAuth application might differ slightly as providers change
- their UI.</p>
-</aside>
-<div class="trilium-tabs">
- <section class="trilium-tab">
- <p class="trilium-tab-title">Authelia</p>
- <div class="trilium-tab-panel">
- <ol>
- <li>
- <p>Generate a client secret:</p><pre><code class="language-text-x-trilium-auto">authelia crypto hash generate pbkdf2 --variant sha512 --random --random.length 72 --random.charset rfc3986
-</code></pre>
- <p><code>Random Password</code> goes to Trilium, <code>Digest</code> (the <code>$pbkdf2-sha512$…</code> string)
- goes to Authelia.</p>
- </li>
- <li>
- <p>Add a client under <code>identity_providers.oidc.clients</code> in Authelia's <code>configuration.yml</code>,
- replacing <code>&lt;server&gt;</code> with the URL of your Trilium instance:</p><pre><code class="language-text-x-yaml">identity_providers:
- oidc:
- clients:
- - client_id: 'trilium'
- client_name: 'Trilium'
- client_secret: '&lt;Digest&gt;'
- public: false
- authorization_policy: 'two_factor'
- redirect_uris:
- - 'https://&lt;server&gt;/callback'
- scopes:
- - 'openid'
- - 'profile'
- - 'email'</code></pre>
- <p>Unlike GitLab, <code>client_id</code> is a name you choose rather than one
- the provider generates.</p>
- </li>
- <li>
- <p>Restart Authelia.</p>
- </li>
- </ol>
- <p>Adjust <code>config.ini</code>, using the <code>Random Password</code> from
- step 1:</p><pre><code class="language-text-x-trilium-auto">[MultiFactorAuthentication]
-oauthBaseUrl=https://&lt;server&gt;
-oauthClientId=&lt;ClientId&gt;
-oauthClientSecret=&lt;RandomPassword&gt;
-oauthIssuerBaseUrl=https://&lt;server&gt;
-oauthIssuerName=Authelia</code></pre>
- <aside class="admonition important">
- <p>Do <strong>not</strong> set <code>oauthClientAuthMethod</code> for Authelia.
- It defaults confidential clients to <code>client_secret_basic</code> and
- rejects any other method with <code>invalid_client</code>, which is the
- default Trilium already uses. This is the opposite of the GitLab case below.</p>
- </aside>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-gitlab"></span>&nbsp;GitLab</p>
- <div class="trilium-tab-panel">
- <ol>
- <li>Go to user settings on <a href="https://gitlab.com/-/user_settings/applications">gitlab.com</a> or
- your own self-hosted instance.</li>
- <li>Press <em>Add new application</em>.</li>
- <li>Give it a name (e.g. Trilium).</li>
- <li>Set <em>Redirect URI</em> to <code>https://&lt;server&gt;/callback</code>
- </li>
- <li>Make sure <em>Confidential</em> is checked and <em>Device authorization grant</em> is
- unchecked.</li>
- <li>Under scopes, check <em>openid</em>, <em>profile</em> and <em>email</em> (they
- should be near the end).</li>
- <li>Save the application and copy the <em>Application ID</em> and <em>Secret</em>.</li>
- </ol>
- <p>Adjust <code>config.ini</code> as follows, replacing <code>&lt;ApplicationId&gt;</code> and <code>&lt;Secret&gt;</code> with
- the values from the last step as well as the <code>&lt;server&gt;</code> with
- a URL to your Trilium instance.</p><pre><code class="language-text-x-trilium-auto">[MultiFactorAuthentication]
-oauthBaseUrl=https://&lt;server&gt;
-oauthClientId=&lt;ApplicationId&gt;
-oauthClientSecret=&lt;Secret&gt;
-oauthIssuerBaseUrl=https://gitlab.com
-oauthIssuerName=GitLab
-oauthClientAuthMethod=client_secret_post
-</code></pre>
- <aside class="admonition important">
- <p>If you are using a self-hosted instance of GitLab, make sure to also update <code>oauthIssuerBaseUrl</code>,
- and keep the <code>oauthClientAuthMethod</code> line above.</p>
- <p>GitLab's token endpoint does not decode credentials sent via HTTP Basic,
- so without <code>oauthClientAuthMethod</code>, sign-in fails with a <code>server responded with a challenge in the WWW-Authenticate HTTP Header</code> error.
- Trilium applies this automatically for <code>gitlab.com</code>, but a self-hosted
- issuer URL cannot be detected.</p>
- </aside>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title">Kanidm</p>
- <div class="trilium-tab-panel">
- <ol>
- <li>
- <p>Create the client, add the redirect URL and grant the scopes, replacing <code>&lt;server&gt;</code> with
- the URL of your Trilium instance and <code>&lt;group&gt;</code> with an existing
- Kanidm group whose members may sign in:</p><pre><code class="language-text-x-trilium-auto">kanidm system oauth2 create trilium "Trilium" "https://&lt;server&gt;"
-kanidm system oauth2 add-redirect-url trilium "https://&lt;server&gt;/callback"
-kanidm system oauth2 update-scope-map trilium &lt;group&gt; openid profile email</code></pre>
- <p>The <code>openid</code> scope is mandatory; without it Kanidm treats the
- client as plain OAuth 2.0.</p>
- </li>
- <li>
- <p>Read the client secret:</p><pre><code class="language-text-x-trilium-auto">kanidm system oauth2 show-basic-secret trilium</code></pre>
- </li>
- </ol>
- <p>Adjust <code>config.ini</code> as follows, replacing <code>&lt;idm&gt;</code> with
- the URL of your Kanidm instance and <code>&lt;BasicSecret&gt;</code> with
- the value from step 2:</p><pre><code class="language-text-x-trilium-auto">[MultiFactorAuthentication]
-oauthBaseUrl=https://&lt;server&gt;
-oauthClientId=trilium
-oauthClientSecret=&lt;BasicSecret&gt;
-oauthIssuerBaseUrl=https://&lt;idm&gt;/oauth2/openid/trilium
-oauthIssuerName=Kanidm</code></pre>
- <p>The client name you chose in step 1 is both the client ID and the last
- path segment of the issuer URL, so the two must match.</p>
- <aside class="admonition important">
- <p>Kanidm signs ID tokens with ES256, not RS256. Trilium detects this from
- the provider on v0.105.0 and later, so no extra configuration is needed.
- Do <strong>not</strong> run <code>kanidm system oauth2 warning-enable-legacy-crypto</code>,
- it downgrades the client to RS256 and disables ES256 entirely. On older
- Trilium versions sign-in fails with an <code>unexpected JWT alg</code> error.</p>
- </aside>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title">Pocket ID</p>
- <div class="trilium-tab-panel">
- <aside class="admonition important">
- <p>Pocket ID is passwordless, signing in requires a passkey. Register one
- and confirm you can sign in to Pocket ID itself <em>before</em> switching
- Trilium over to OpenID Connect, otherwise you may find yourself unable
- to authenticate at either end.</p>
- </aside>
- <ol>
- <li>Sign in to Pocket ID as an administrator and go to <em>OIDC Clients</em> → <em>Add OIDC Client</em>.</li>
- <li>Give it a name (e.g. Trilium).</li>
- <li>Set <em>Callback URLs</em> to <code>https://&lt;server&gt;/callback</code>,
- replacing <code>&lt;server&gt;</code> with the URL of your Trilium instance.</li>
- <li>Save, then copy the <em>Client ID</em>, <em>Client Secret</em> and <em>OIDC Discovery URL</em>.</li>
- </ol>
- <p>Adjust <code>config.ini</code> as follows, using the values from step 4:</p><pre><code class="language-text-x-trilium-auto">[MultiFactorAuthentication]
-oauthBaseUrl=https://&lt;server&gt;
-oauthClientId=&lt;ClientID&gt;
-oauthClientSecret=&lt;ClientSecret&gt;
-oauthIssuerBaseUrl=&lt;OIDCDiscoveryURL&gt;
-oauthIssuerName=Pocket ID</code></pre>
- <aside class="admonition note">
- <p>Pocket ID gives you an <em>OIDC Discovery URL</em> ending in <code>/.well-known/openid-configuration</code>.
- On v0.105.0 and later you can paste it as-is. On earlier versions, remove
- that suffix and use only the part before it.</p>
- </aside>
- <aside class="admonition important">
- <p>Pocket ID generates an RS256 signing key on first start, which works without
- further configuration. If you rotate it to Ed25519 (<code>pocket-id key-rotate --alg EdDSA --crv Ed25519</code>),
- ID tokens are signed with EdDSA instead. Trilium detects this automatically
- on v0.105.0 and later; older versions fail with <code>unexpected JWT alg received, expected RS256, got: EdDSA</code>.</p>
- </aside>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span style="--tn-color:#e64d4d;color:#e64d4d;"><span class="tn-icon bx bx-x"></span>&nbsp;GitHub</span>
- </p>
- <div class="trilium-tab-panel">
- <p>GitHub cannot be used as an identity provider because it is plain OAuth
- 2.0 and not OpenID Connect, so it will fail with <code>OAUTH_RESPONSE_IS_NOT_CONFORM</code>.</p>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-google"></span>&nbsp;Google</p>
- <div class="trilium-tab-panel">
- <ol>
- <li>Go to <a href="https://console.cloud.google.com/auth/clients">Google Cloud's Clients</a> dashboard
- and select <em>Create client</em>.</li>
- <li>For <em>Application type,</em> select <em>Web application</em>.</li>
- <li>In <em>Authorized redirect URIs</em>, set &nbsp;<code>https://&lt;server&gt;/callback</code>.</li>
- <li>Press <em>Create</em> and copy <em>Client ID</em> and <em>Client secret</em>.</li>
- </ol>
- <p>Adjust <code>config.ini</code> as follows, replacing <code>&lt;ClientID&gt;</code> and <code>&lt;ClientSecret&gt;</code> with
- the values from the last step as well as the <code>&lt;server&gt;</code> with
- a URL to your Trilium instance.</p><pre><code class="language-text-x-trilium-auto">[MultiFactorAuthentication]
-oauthBaseUrl=https://&lt;server&gt;
-oauthClientId=&lt;ClientID&gt;
-oauthClientSecret=&lt;ClientSecret&gt;</code></pre>
- </div>
- </section>
-</div>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/System Requirements.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/System Requirements.html
deleted file mode 100644
index fa53b6404d..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/System Requirements.html
+++ /dev/null
@@ -1,16 +0,0 @@
-<ul>
- <li>Using Docker, the server can be run on Windows, Linux and macOS devices.</li>
- <li>Native binaries are provided for Linux x64 and ARM (<code>aarch64</code>).</li>
-</ul>
-<h2>Legacy ARM support</h2>
-<p>The Docker builds also provide <code>linux/arm/v7</code> and <code>linux/arm/v8</code> platforms.
- These platforms are considered legacy since Trilium uses Node.js version
- 24 which have <a href="https://github.com/nodejs/node/commit/6682861d6f">officially downgraded support</a> for
- these platforms to “experimental”.</p>
-<p>As a result, Trilium needs to use Node.js 22 for these versions. As soon
- as soon Node.js 22 will no longer be compatible, support for <code>armv7</code> and <code>armv8</code> will
- be dropped entirely.</p>
-<p>Regardless of upstream support, these platforms are supported on a best-effort
- basis and are not officially supported by the Trilium development team.
- Bug reports are accepted but they will not be treated with priority; contributions
- are welcome.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/Third-party cloud hosting.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/Third-party cloud hosting.html
deleted file mode 100644
index 1fbc0fb6bb..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Server Installation/Third-party cloud hosting.html
+++ /dev/null
@@ -1,31 +0,0 @@
-<p>As an alternative to <a href="#root/_help_Dgg7bR3b6K9j">hosting your own Trilium instance</a>,
- there are two services out there that provide out of the box support for
- Trilium.</p>
-<aside class="admonition important">
- <p><strong>Disclaimer</strong>: The Trilium Notes project and maintainers
- are not directly affiliated with either of the projects.</p>
- <p>PikaPods have gracefully offered us free credits for testing purposes.</p>
-</aside>
-<h2>Cloud instance providers</h2>
-<h3>PikaPods</h3>
-<ol>
- <li>Go to <a href="https://www.pikapods.com">pikapods.com</a> &nbsp;and sign
- up.</li>
- <li>In the “Available Apps” section, look for "TriliumNext
- <br>&nbsp;and select “Run your own”.</li>
- <li>Follow the on-screen instructions to set up your own cloud hosted instance.</li>
-</ol>
-<p>PikaPods generally updates their Trilium instances to the latest version
- within a two-week interval after a new version is released.</p>
-<h2>Matching your version with the cloud instance</h2>
-<p>Please note that once you set up&nbsp;<a class="reference-link" href="#root/_help_cbkrhQjrkKrh">Synchronization</a>&nbsp;between
- a cloud instance and <a href="#root/_help_poXkQfguuA0U">desktop</a> clients,
- it's important that the version of the desktop application and the server
- match up.</p>
-<p>When setting up a cloud instance, it's best to check the version of the
- server by accessing it via a web browser and going to the <em>About</em> section.
- It's best that both the desktop and the server have the same <em>App version</em>;
- however it's generally OK to update the desktop to a newer version than
- the server if it has the same <em>Sync version</em>.</p>
-<p>If the <em>Sync version</em> between the server and the desktop application
- doesn't match, synchronization will not work.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Synchronization.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Synchronization.html
deleted file mode 100644
index 3699938261..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Synchronization.html
+++ /dev/null
@@ -1,104 +0,0 @@
-<p>Trilium is an offline-first note-taking application that stores all data
- locally on the desktop client. However, it also offers the option to set
- up synchronization with a server instance, allowing multiple desktop clients
- to sync with a central server. This creates a star-shaped topology:</p>
-<p>
- <img src="Synchronization_image.png">
-</p>
-<p>In this setup, a central server (referred to as the <em>sync server</em>)
- and multiple <em>client</em> (or <em>desktop</em>) instances synchronize with
- the sync server. Once configured, synchronization is automatic and ongoing,
- requiring no manual intervention.</p>
-<h2>Setting Up Synchronization</h2>
-<h3>Security Considerations</h3>
-<p>Setting up the server securely is critical and can be complex. It is crucial
- to use a valid <a href="#root/_help_l2VkvOwUNfZj">TLS certificate</a> (HTTPS)
- rather than an unencrypted HTTP connection to ensure security and avoid
- potential vulnerabilities.</p>
-<h3>Synchronizing a Desktop Instance with a Sync Server</h3>
-<p>This method is used when you already have a desktop instance of Trilium
- and want to set up a sync server on your web host.</p>
-<ol>
- <li><strong>Server Deployment</strong>: Ensure your server instance is deployed
- but uninitialized.</li>
- <li><strong>Desktop Configuration</strong>: Open your desktop instance, navigate
- to&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Sync</em> → <em>Sync server</em>,
- and set the <em>Server address</em> to your sync server's address.
- <ul>
- <li>Note that the sync server can also be overridden through&nbsp;<a class="reference-link"
- href="#root/_help_Gzjqa934BdH4">Configuration (config.ini or environment variables)</a>,
- case in which that value takes precedence. If that's the case, a field
- called <em>Server in use</em> indicates it.</li>
- </ul>
- </li>
- <li><strong>Testing Sync</strong>: Click the <em>Test sync</em> button to verify
- the connection to the sync server.
- <ul>
- <li>If successful, the client will start pushing all data to the server instance.</li>
- <li>This process may take some time, but you can continue using Trilium. Periodically
- check the server instance to confirm when the sync is complete. Once finished,
- you should see the login screen on the server.</li>
- </ul>
- </li>
-</ol>
-<h3>Synchronizing a Desktop Instance from a Sync Server</h3>
-<p>This method is used when you already have a sync server and want to configure
- a new desktop instance to sync with it.</p>
-<ol>
- <li><strong>Desktop Setup</strong>: Follow the <a href="#root/_help_poXkQfguuA0U">desktop installation page</a>.</li>
- <li><strong>Initial Configuration</strong>: When prompted, choose the option
- to set up sync with a sync server.</li>
-</ol>
-<p>
- <img src="Synchronization_sync-init.png" alt="screenshot of the sync from server setup page">
-</p>
-<ol>
- <li><strong>Server Details</strong>: Configure the Trilium server address
- and enter the correct username and password for authentication.</li>
- <li><strong>Finish Setup</strong>: Click the "Finish setup" button. If successful,
- you will see the following screen:</li>
-</ol>
-<p>
- <img src="Synchronization_sync-in-progress.png" alt="screenshot of the sync page">
-</p>
-<p>Once synchronization is complete, you will be automatically redirected
- to the Trilium application.</p>
-<h3>Desktop-to-desktop sync</h3>
-<p>This method allows two desktop instances to synchronize between each other
- without requiring a&nbsp;<a class="reference-link" href="#root/_help_WOcw2SLH6tbX">Server Installation</a>.</p>
-<aside
-class="admonition warning">
- <p>Since v0.104.0, LAN access needs to be enabled to allow this sync to function.
- See&nbsp;<a class="reference-link" href="#root/_help_swSFivWk6KkA">Network Access</a>&nbsp;for
- information on how to do so.</p>
-</aside>
-<h2>Proxy Configuration</h2>
-<p>Two proxy setups are supported:</p>
-<ul>
- <li><strong>Explicit Proxy Configuration</strong>: Set the proxy server in
- Options / Sync. Only unauthenticated proxy servers are supported.</li>
- <li><strong>System Proxy Settings</strong>: If no proxy server is explicitly
- configured, Trilium will use the system proxy settings.</li>
-</ul>
-<h2>Troubleshooting</h2>
-<h3>Date/Time Synchronization</h3>
-<p>For successful synchronization, both client and server must have the same
- date and time, with a tolerance of up to five minutes.</p>
-<h3>Certificate Issues</h3>
-<p>When using TLS, Trilium will verify the server certificate. If verification
- fails (e.g., due to self-signed certificates or certain corporate proxies),
- you can run the Trilium client with the <code>NODE_TLS_REJECT_UNAUTHORIZED</code> environment
- variable set to <code>0</code>:</p><pre><code class="language-text-x-trilium-auto">export NODE_TLS_REJECT_UNAUTHORIZED=0</code></pre>
-<p>This will disable TLS certificate verification, significantly reducing
- security and exposing the setup to MITM attacks. It is strongly recommended
- to use a valid signed server certificate. Newer Trilium versions include
- a script called <code>trilium-no-cert-check.sh</code> for this purpose.</p>
-<h3>Conflict Resolution</h3>
-<p>If you edit the same note on multiple instances before synchronization,
- Trilium resolves conflicts by retaining the newer change and discarding
- the older one. The older version remains accessible in <a href="#root/_help_vZWERwf8U3nx">note revisions</a>,
- allowing data recovery if needed.</p>
-<h3>Hash Check</h3>
-<p>After each synchronization, Trilium computes a hash of all synced data
- on both the client and the sync server. If there is a discrepancy, Trilium
- will automatically initiate a recovery mechanism to resolve the issue.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Synchronization_sync-in-progress.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Synchronization_sync-in-progress.png
deleted file mode 100644
index 9eb684b380..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Synchronization_sync-in-progress.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Synchronization_sync-init.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Synchronization_sync-init.png
deleted file mode 100644
index ac9c1e3a67..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Synchronization_sync-init.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Upgrading TriliumNext.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Upgrading TriliumNext.html
deleted file mode 100644
index 36d1cb7e44..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Upgrading TriliumNext.html
+++ /dev/null
@@ -1,25 +0,0 @@
-<p>This document outlines the steps required to upgrade Trilium to a new
- release version.</p>
-<h2>How to Upgrade</h2>
-<p>Trilium does not support built-in automatic upgrades; all updates must
- be performed manually. The upgrade process varies depending on the installation
- method:</p>
-<ul>
- <li><a href="#root/_help_rWX5eY045zbE"><strong>Docker Server Installation</strong></a>:
- Pull the new image and restart the container.</li>
- <li><strong>Other Installations</strong>: Download the latest version from
- the <a href="https://github.com/TriliumNext/Trilium/releases/latest">release page</a> and
- replace the existing application files.</li>
-</ul>
-<h2>Database Compatibility and Migration</h2>
-<p>Upon startup, Trilium will automatically migrate the <a href="#root/_help_wX4HbRucYSDD">database</a> to
- the new version. Note that after migration, older versions of Trilium will
- be unable to read the database. If you need to revert to a previous version
- of Trilium and its database, you can restore the <a href="#root/_help_ODY7qQn5m2FT">backup</a> that
- is created prior to migration.</p>
-<h2>Sync Compatibility</h2>
-<p>The <a href="#root/_help_cbkrhQjrkKrh">synchronization</a> protocol used
- by Trilium is versioned, requiring all members of the sync cluster to use
- the same protocol version. Therefore, when upgrading to a new version,
- you may need to upgrade all instances in the sync cluster. Changes to the
- sync protocol version are typically indicated on the release page.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Web Clipper.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Web Clipper.html
deleted file mode 100644
index 29fc7c96fd..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Web Clipper.html
+++ /dev/null
@@ -1,314 +0,0 @@
-<p>
- <img src="Web Clipper_image.png">
-</p>
-<p>Trilium Web Clipper is a web browser extension which allows user to clip
- text, screenshots, whole pages and short notes and save them directly to
- Trilium Notes.</p>
-<h2>Supported browsers</h2>
-<p>Trilium Web Clipper officially supports the following web browsers:</p>
-<ul>
- <li>Mozilla Firefox, using Manifest v2.</li>
- <li>Google Chrome, using Manifest v3. Theoretically the extension should work
- on other Chromium-based browsers as well, but they are not officially supported.</li>
-</ul>
-<h2>Obtaining the extension</h2>
-<p>The extension is available from the official browser web stores:</p>
-<ul>
- <li><strong>Firefox</strong>: <a href="https://addons.mozilla.org/firefox/addon/trilium-notes-web-clipper/">Trilium Web Clipper on Firefox Add-ons</a>
- </li>
- <li><strong>Chrome</strong>: <a href="https://chromewebstore.google.com/detail/trilium-web-clipper/ofoiklieachadcaeffficgjaajojpkpi">Trilium Web Clipper on Chrome Web Store</a>
- </li>
-</ul>
-<h2>Functionality</h2>
-<ul>
- <li>select text and clip it with the right-click context menu</li>
- <li>click on an image or link and save it through context menu</li>
- <li>save whole page from the popup or context menu</li>
- <li>save a PDF that the browser shows, as a file note</li>
- <li>save a screenshot of an area you select, of the visible part of the page
- or of the whole page, from either popup or context menu</li>
- <li>create short text note from popup</li>
-</ul>
-<h2>The popup</h2>
-<p>Clicking the extension's button in the browser toolbar opens its popup:</p>
-<ul>
- <li>
- <p>The popup shows what will be saved from the current page: the note's title,
- which can be edited before saving, the website, and below them a preview,
- which starts with a box for your own note and the page's description. A
- switch above the preview chooses what to save, among what the page offers:</p>
- <ul>
- <li><em>Selection</em>, when text is selected on the page: <em>Save selection</em> saves
- it into the note of that page's clippings, as the context menu does.</li>
- <li><em>Page</em>: <em>Save page to Trilium</em> saves the page's text and images.
- A smaller switch at the top of the preview chooses how much of the page
- to keep: <em>Article</em> keeps only the page's main text, without its menus,
- sidebars and footers, and <em>Whole page</em> keeps everything the page shows. <em>Whole page</em> is
- for pages that are not an article (such as a gallery or a page of cards),
- where <em>Article</em> can leave out part of the content; the preview shows
- what each one keeps. <em>Article</em> is unavailable on a page where Trilium
- finds no article. The author the page names shows under the description,
- marked by the <span class="tn-icon bx bx-user"></span> icon. It can be edited
- or cleared before saving, or written in when the page names none, and is
- saved in the <code>#pageAuthor</code> label of the note. When the page states
- when it was published, that date shows under the author, marked by the <span
- class="tn-icon bx bx-calendar"></span> icon, and is saved in the <code>#publishedDate</code> label
- of the note. When it states when it was last modified, that date shows
- below, marked by the <span class="tn-icon bx bx-history"></span> icon, and
- is saved in the <code>#modifiedDate</code> label.</li>
- <li><em>PDF</em>, when the tab shows a PDF in the browser's viewer: <em>Save PDF to Trilium</em> downloads
- the PDF and saves it as a file note, which Trilium opens in its&nbsp;<a
- class="reference-link" href="#root/_help_XJGJrpu7F9sh">PDFs</a> viewer.
- Only the title and the description can be edited, since a file note has
- no text of its own for your note. The page's address is saved in the note's <code>#pageUrl</code> label
- and the PDF's file name in <code>#originalFileName</code>. Saving a PDF
- needs Trilium v0.107.0 or later.</li>
- <li><em>Bookmark</em>, always: there is no preview, and <em>Save bookmark</em> saves
- a link to the page with your note as the content of the note. Left empty,
- the title stays the page's title.</li>
- </ul>
- <p>The box for your note, marked by the <span class="tn-icon bx bx-info-circle"></span> icon,
- has the cursor when the popup opens, so a note (such as why the page is
- worth keeping) can be typed right away. It grows with its text, and keeps
- it when switching between <em>Selection</em>, <em>Page</em> and <em>Bookmark</em>.
- A note on a selection or a page is saved above the clipped content, in
- a <em>Note</em> admonition. Left empty, nothing is added. <kbd>Ctrl</kbd>+<kbd>Enter</kbd> in
- any of the popup's fields saves, whichever is chosen.</p>
- <p>The description, marked by the <span class="tn-icon bx bx-align-left"></span> icon,
- comes from the page's <code>description</code> meta tag, or the one it gives
- social sites. It can be edited or cleared before saving, or written in
- when the page has none, and is saved in the <code>#pageDescription</code> label
- of the note. Clippings saved with the keyboard shortcuts or the context
- menu, screenshots and images included, get the description as the page
- gives it. Each clipping that brings a description updates the label. The
- description, the author and the dates are shown by clicking the <em>Web clip</em> badge
- next to the title of the note (see <a class="reference-link" href="#root/_help_B5dihXRDksTk">Note badges</a>).</p>
- <p>The popup opens on the selection if there is one, otherwise on <em>Page</em>,
- showing the article, or the whole page when the page has no article. On
- a PDF, it opens on <em>PDF</em>. On a page that shows nothing to save, it
- opens on <em>Bookmark</em> and says so. The keyboard shortcuts and the context
- menu still save right away, without a preview: saving the whole page that
- way saves the article, the whole page when the page has no article, or
- the PDF when the tab shows one.</p>
- </li>
- <li>
- <p>Pages the extension cannot access (the browser's own pages, the extension
- stores, and pages that were open before the extension was installed until
- they are reloaded) cannot be saved or captured, so the popup says so in
- place of the preview, and only <em>All tabs</em> remains available there.</p>
- </li>
- <li>
- <p>Below the preview, a row of buttons offers the other actions: <em>Area</em> (a
- screenshot of an area you select), <em>Visible</em> (a screenshot of the
- visible part of the page), <em>Full page</em> (a screenshot of the whole
- page) and <em>All tabs</em> (saves the links of every tab in the current
- window as a list of <a class="reference-link" href="#root/_help_UmgZAfcltxkS">Link Previews</a>,
- or of plain links when <em>Autogenerate link previews</em> is turned off).
- Hovering over a button shows its full name and, if it has one, its keyboard
- shortcut.</p>
- </li>
- <li>
- <p><em>Full page</em> scrolls through the page, takes a screenshot of each
- part and joins them into one image, then scrolls back to where the page
- was. The scrollbars are hidden while it does, so they do not appear in
- the image. Stay on the tab until it is saved: switching to another tab
- stops the screenshot. A header that stays at the top of the window appears
- once, at the top of the image, and headings that stick while scrolling
- appear where they are in the page. Other elements that stay in place while
- scrolling (such as cookie banners and chat buttons) are left out, while
- a background that fills the whole window repeats on every screen. In Firefox,
- the page is captured without scrolling through it, which is faster: such
- a background then appears only at the top, and images that the page loads
- only once they are scrolled into view can be missing. A long page is saved
- as several images, one below the other in the note. A page longer than
- 100 screens is cut off there, and the message after saving says so. Screenshots
- keep their full height in Trilium: <em>Resize image</em> (under <em>Automatically compress images</em> in
- Options → Media) limits only their width.</p>
- </li>
- <li>
- <p>The popup stays open while Trilium saves, which can take a few seconds
- for a long page or a large PDF, and the other actions wait until it is
- done. The bar at the top of the popup then says, in green, that the clipping
- was saved (in place of the notice that the page was already clipped), with <em>Open note</em> to
- open it in Trilium (and, after <em>All tabs</em>, <em>Close saved tabs</em>),
- or, in red, why it could not be saved. The same clipping cannot be saved
- twice by accident: the save button stays disabled until another mode is
- chosen. <em>Crop</em> is the exception: the popup closes so that an area
- of the page can be selected, and the notification on the page reports the
- outcome.</p>
- </li>
- <li>
- <p>If the current page was already clipped, a notice at the top offers to
- open the note in Trilium.</p>
- </li>
- <li>
- <p>If Trilium cannot be found, the popup explains why instead of showing
- the actions, with buttons to look for Trilium again and to open the options.</p>
- </li>
- <li>
- <p>The bottom of the popup shows whether the extension is connected to Trilium,
- as a colored dot (green when connected, amber when the versions are not
- compatible, red when Trilium was not found) next to a description of the
- connection, followed by the buttons for the extension's options and for
- this help page. A button to check the connection again appears next to
- them when hovering over the bar, and stays visible while Trilium cannot
- be reached or is not compatible.</p>
- </li>
-</ul>
-<h2>Location of clippings</h2>
-<p>Trilium will save these clippings as a new child note under a "clipper
- inbox" note.</p>
-<p>By default, that's the&nbsp;<a class="reference-link" href="#root/_help_l0tKav7yLHGF">Day Notes</a>&nbsp;but
- you can override that by setting the <a href="#root/_help_zEY4DaJG4YT5">label</a> <code>clipperInbox</code>,
- on any other note.</p>
-<p>Further clippings of the same kind from the same page are added to the
- note created by the first one, even on a later day or after that note was
- moved out of the clipper inbox. The note stays where it is and is not cloned
- back into the inbox. A PDF is the exception: each save creates a new file
- note, since the PDF can have changed since it was last saved.</p>
-<p>The icon of a clipped note shows what was saved:</p>
-<ul>
- <li><span class="tn-icon bx bx-paperclip"></span> a selection, a screenshot
- or a link from the context menu;</li>
- <li><span class="tn-icon bx bx-globe"></span> a page (<em>Article</em> or <em>Whole page</em>);</li>
- <li><span class="tn-icon bx bx-bookmark"></span> a bookmark;</li>
- <li><span class="tn-icon bx bx-window-alt"></span> the tabs of a window.</li>
-</ul>
-<p>The icon is derived from the note's <code>#clipType</code> label, so setting
- an <code>#iconClass</code> label on the note replaces it. A saved PDF has
- the icon of a PDF file, like any other PDF in Trilium.</p>
-<h2>Embedded videos</h2>
-<p>A YouTube video embedded in a clipped page is saved as a <a class="reference-link"
- href="#root/_help_UmgZAfcltxkS">Link Previews</a> embed, with the video's
- title and thumbnail. As with a link preview added in the editor, the video
- plays only when clicked. Other embedded content (such as videos from other
- websites) is not saved.</p>
-<p>The popup's preview shows each such video as a chip with the YouTube icon
- and the video's short link, and leaves out the embedded content that will
- not be saved.</p>
-<h2>Keyboard shortcuts</h2>
-<p>Keyboard shortcuts are available for most functions:</p>
-<ul>
- <li>Save selected text: <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>S</kbd> (Mac: <kbd>⌘</kbd>+<kbd>⇧</kbd>+<kbd>S</kbd>)</li>
- <li>Save whole page: <kbd>Alt</kbd>+<kbd>Shift</kbd>+<kbd>S</kbd> (Mac: <kbd>⌥</kbd>+<kbd>⇧</kbd>+<kbd>S</kbd>)</li>
- <li>Save a screenshot of an area: <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>E</kbd> (Mac: <kbd>⌘</kbd>+<kbd>⇧</kbd>+<kbd>E</kbd>)</li>
- <li>Save all tabs of the current window: no default shortcut, but one can
- be assigned as described below.</li>
- <li>Save a screenshot of the whole page: no default shortcut, but one can
- be assigned as described below.</li>
-</ul>
-<p>To set custom shortcuts, follow the directions for your browser.</p>
-<ul>
- <li><strong>Firefox</strong>: <code>about:addons</code> → Gear icon ⚙️ → Manage
- extension shortcuts</li>
- <li><strong>Chrome</strong>: <code>chrome://extensions/shortcuts</code>
- </li>
-</ul>
-<aside class="admonition note">
- <p>On Firefox, the default shortcuts interfere with some browser features.
- As such, the keyboard combinations will not trigger the Web Clipper action.
- To fix this, simply change the keyboard shortcut to something that works.
- The defaults will be adjusted in future versions.</p>
-</aside>
-<h2>Configuration</h2>
-<p>The extension needs to connect to a running Trilium instance. By default,
- it looks for the desktop application on port 37840 of the local computer.
- If the desktop application runs on a different port (for example because
- it was started with the <code>TRILIUM_PORT</code> environment variable),
- enter that port in the extension's options. The extension checks for Trilium
- again every minute, or right away when pressing the refresh button at the
- bottom of its popup.</p>
-<p>It's also possible to configure the <a href="#root/_help_WOcw2SLH6tbX">server</a> address
- if you don't run the desktop application, or want it to work without the
- desktop application running.</p>
-<p>To connect to a server, enter its address and your password in the extension's
- options and press <em>Login to the server instance</em>. If the server uses <a
- href="#root/_help_7DAiwaf8Z7Rz">multi-factor authentication</a>, also fill
- in <em>Authentication code</em> with the current code from your authenticator
- app (or one of your recovery codes); otherwise leave it empty. The password
- and the code are used only once, to obtain a token for the extension, and
- are not stored.</p>
-<h3>When a clipping fails</h3>
-<p>After each clipping made with a keyboard shortcut or the context menu,
- a notification in the corner of the page confirms that it was saved, with
- a link to open the new note in Trilium. A clipping made from the popup
- reports in the popup instead, unless the popup was closed before it was
- saved. If the clipping could not be saved, the message says why instead:</p>
-<ul>
- <li>Trilium was not found: start the desktop application, or check the server
- address and token in the extension's options.</li>
- <li>The versions of Trilium and the extension are not compatible: update the
- one the message names.</li>
- <li>Trilium rejected the request: the message includes the reason Trilium
- gave.</li>
- <li>The popup could not reach the extension's background script, or it gave
- no answer: close the popup and open it again. If the extension was just
- updated or reloaded, reload the page as well.</li>
- <li>A PDF could not be saved: Trilium is older than v0.107.0, the website
- refused to send the PDF again, or the PDF is larger than 100 MB. The extension
- downloads the PDF with the browser's cookies for that website, so a PDF
- behind a login can be saved while you are logged in.</li>
-</ul>
-<p>The extension downloads the images of a clipping itself, so that they
- are stored in Trilium together with the note. If some of them cannot be
- downloaded (for example because the website refuses the request), the clipping
- is still saved, and the notification says how many images are missing.
- Those images keep their address on the original website: Trilium tries
- to download them once more if <em>Download images automatically</em> is enabled
- in <a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a> → <em>Media</em>,
- and otherwise the note shows them from the website for as long as it serves
- them.</p>
-<p>The notification is shown on the page itself, so it does not appear on
- pages where extensions cannot run (such as the browser's own settings pages,
- the extension stores and Firefox's PDF viewer). A clipping saved from the
- popup on such a page still reports in the popup.</p>
-<h2>Testing development versions</h2>
-<p>Development versions are version pre-release versions, generally meant
- for testing purposes. These are not available in the Google or Firefox
- web stores, but can be downloaded from either:</p>
-<ul>
- <li><a href="https://github.com/TriliumNext/Trilium/releases">GitHub Releases</a> by
- looking for releases starting with <em>Web Clipper.</em>
- </li>
- <li>Artifacts in GitHub Actions, by looking for the <a href="https://github.com/TriliumNext/Trilium/actions/workflows/web-clipper.yml"><em>Deploy web clipper extension</em> workflow</a>.
- Once a workflow run is selected, the ZIP files are available in the <em>Artifacts</em> section,
- under the name <code>web-clipper-extension</code>.</li>
-</ul>
-<div class="trilium-tabs">
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-chrome"></span>&nbsp;Chrome</p>
- <div class="trilium-tab-panel">
- <ol>
- <li>Download <code>trilium-web-clipper-[x.y.z]-chrome.zip</code>.</li>
- <li>Extract the archive.</li>
- <li>In Chrome, navigate to <code>chrome://extensions/</code>
- </li>
- <li>Toggle <em>Developer Mode</em> in top-right of the page.</li>
- <li>Press the <em>Load unpacked</em> button near the header.</li>
- <li>Point to the extracted directory from step (2).</li>
- </ol>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-firefox"></span>&nbsp;Firefox</p>
- <div class="trilium-tab-panel">
- <aside class="admonition warning">
- <p>Firefox prevents installation of unsigned packages in the “retail” version.
- To be able to install extensions from disk, consider using <em>Firefox Developer Edition</em> or
- a non-branded version of Firefox (e.g. <em>GNU IceCat</em>).</p>
- <p>One time, go to <code>about:config</code> and change <code>xpinstall.signatures.required</code> to <code>false</code>.</p>
- </aside>
- <ol>
- <li>Navigate to <code>about:addons</code>.</li>
- <li>Select <em>Extensions</em> in the left-side navigation.</li>
- <li>Press the <em>Gear</em> icon on the right of the <em>Manage Your Extensions</em> title.</li>
- <li>Select <em>Install Add-on From File…</em>
- </li>
- <li>Point it to <code>trilium-web-clipper-[x.y.z]-firefox.zip</code>.</li>
- <li>Press the <em>Add</em> button to confirm.</li>
- </ol>
- </div>
- </section>
-</div>
-<h2>Credits</h2>
-<p>Some parts of the code are based on the <a href="https://github.com/laurent22/joplin/tree/master/Clipper">Joplin Notes browser extension</a>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Web Clipper_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Web Clipper_image.png
deleted file mode 100644
index de3c69b819..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Web Clipper_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Meeting transcription.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Meeting transcription.html
deleted file mode 100644
index 18d5c09a10..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Meeting transcription.html
+++ /dev/null
@@ -1,173 +0,0 @@
-<aside class="admonition important">
- <p><strong>Meeting transcription is in beta</strong>
- </p>
- <p>Meeting transcription is a new feature and is still in beta. It has not
- been tested on every operating system, audio setup and meeting application,
- so it might fail to capture the audio, miss part of a meeting or behave
- differently from what this page describes. Before relying on it for an
- important meeting, try it on a short call first.</p>
- <p>If something does not work, please <a href="#root/_help_wy8So3yZZlH9">report the issue</a>,
- mentioning your operating system and the meeting application you used.
- The <em>Keep recordings for troubleshooting</em> option described below keeps
- what is needed to reproduce a problem.</p>
-</aside>
-<p>Meeting transcription turns a meeting into text while it happens: Trilium
- listens to your microphone and to what the other participants say through
- your speakers, and writes down who said what in a new note. Recognition
- runs entirely on your device, so no audio leaves it.</p>
-<p>Meeting transcription is available only in the desktop application. It
- is not available when Trilium is accessed through a browser, nor in the
- mobile application.</p>
-<h2>Enabling meeting transcription</h2>
-<p>Meeting transcription is off by default. To turn it on, go to&nbsp;<a
- class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Transcription</em> and
- turn on <em>Meeting transcription</em>. This adds the <span class="tn-icon bx bx-microphone"></span> <em>Transcribe meeting</em> button
- to the&nbsp;<a class="reference-link" href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>,
- marked with a <em>Beta</em> badge.</p>
-<p>The speech recognition models are not part of Trilium. The first time
- you transcribe a meeting, Trilium asks to download them; see&nbsp;<a class="reference-link"
- href="#root/_help_ebyr7ES2SwOW">Downloaded resources</a> for the sizes and
- how to manage them. Each device downloads its own copy.</p>
-<h2>Transcribing a meeting</h2>
-<ol>
- <li>Press the <span class="tn-icon bx bx-microphone"></span> <em>Transcribe meeting</em> button
- in the&nbsp;<a class="reference-link" href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>.</li>
- <li>If the models are not downloaded yet, confirm the download and wait for
- it to finish.</li>
- <li>Trilium creates a text note titled with the current date and time (for
- example <em>Meeting 2026-10-15 14:30</em>) in the&nbsp;<a class="reference-link"
- href="#root/_help_S0Fos78ZfcY7">Note Inbox</a>, opens it and starts transcribing.
- While it transcribes, the button turns into a <span class="tn-icon bx bx-stop-circle"></span> <em>Stop transcribing</em> button
- and shows the time elapsed. Beside it, a reminder asks you to let everyone
- in the meeting know that it is being transcribed and to ask for their consent;
- it closes by itself after 10 seconds, or when you click it.</li>
- <li>To end the transcription, press the <span class="tn-icon bx bx-stop-circle"></span> <em>Stop transcribing</em> button.
- Trilium finishes transcribing what was already said before it stops.</li>
-</ol>
-<p>Only one meeting can be transcribed at a time. The note itself is an ordinary
- text note: you can take notes in it during the meeting, rename it or move
- it anywhere in the tree. It carries the <code>#meetingRecording</code> label.</p>
-<p>Trilium tells you when your microphone or the meeting's audio is not being
- transcribed. It shows a message saying which one and why, the time on the
- button turns red and the button's tooltip says that some audio is not being
- transcribed:</p>
-<ul>
- <li><strong>Not captured</strong>: the transcription started without that
- audio, for example because there is no microphone or because Trilium was
- not allowed to record the screen and its audio. Connect the microphone
- or allow the recording, then stop the transcription and start it again.</li>
- <li><strong>No audio</strong>: nothing has arrived from it for 10 seconds,
- as when its capture hangs. Stop the transcription and start it again; what
- was transcribed until then is kept.</li>
- <li><strong>Only silence</strong>: it has delivered nothing but silence, for
- 15 seconds from your microphone or for a minute from the meeting. A microphone
- muted in your system's settings, or with a mute button of its own, does
- this. A meeting nobody speaks in for a minute does it too, so this message
- can be ignored when the others are just quiet.</li>
-</ul>
-<p>Each message shows once. <em>No audio</em> and <em>Only silence</em> clear
- by themselves once sound arrives again.</p>
-<p>If the transcription stops on its own, for example because the audio could
- no longer be captured, Trilium shows a message and keeps everything transcribed
- until then. Closing Trilium during a meeting waits for the transcription
- to finish first.</p>
-<h2>The transcript</h2>
-<p>The transcript is stored as an <a href="#root/_help_0vhv7lsOLy82">attachment</a> of
- the meeting note and is shown in a collapsible <em>Transcript</em> section
- above the note's content. It updates as the meeting goes on, one paragraph
- per speaker turn, each with the time it started. While the meeting is being
- transcribed, the header of the <em>Transcript</em> section shows the level
- of your microphone (<em>Me</em>) and of the meeting's audio (<em>Others</em>),
- so you can tell that both are being heard, even while the section is collapsed;
- a source that is not being transcribed is marked <em>Not captured</em>, <em>No audio</em> or <em>Only silence</em>.
- While someone is talking, <em>Speaking…</em> shows under their name until
- their words are transcribed. If you are reading the end of the transcript,
- it scrolls to follow new text.</p>
-<ul>
- <li>What you say into your microphone is labeled <em>Me</em>.</li>
- <li>What the other participants say is labeled <em>Speaker 1</em>, <em>Speaker 2</em> and
- so on, while <em>Identify speakers</em> is on; otherwise it is labeled <em>Others</em>.</li>
- <li>To name a speaker, click their name, type the new name and press <kbd>Enter</kbd>.
- The name changes on every turn of that speaker. Press <kbd>Esc</kbd> to cancel,
- or clear the name to restore the default one.</li>
- <li>To show the transcript with or without hesitations such as "uh", "um"
- and stuttered words, press the <span class="tn-icon bx bx-eraser"></span> <em>Hide filler words</em> button
- above it, which shows as pressed while they are hidden. While they are
- shown, they are grayed out, so you can see what hiding them would remove.
- This affects only what is shown; the stored transcript keeps every word.</li>
- <li>To copy the transcript as plain text, press the <span class="tn-icon bx bx-copy"></span> <em>Copy transcript</em> button
- above it. Each turn is copied with the speaker's name and the time it started,
- as shown, so the copy leaves out filler words while they are hidden.</li>
-</ul>
-<p>If the meeting note is <a href="#root/_help_bwg0e8ewQMak">protected</a> and
- the protected session is locked during the meeting, the transcript cannot
- be saved. Trilium keeps it in memory and saves it once you enter the protected
- session again, as long as Trilium stays open.</p>
-<h2>Configuration</h2>
-<p>The settings are in&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Transcription</em>,
- and are shown once <em>Meeting transcription</em> is on.</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Option</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><em>European languages</em>
- </td>
- <td>The speech recognition model. Both recognize 25 European languages and
- work out which one is spoken. <em>Standard</em> is a smaller download and
- runs well on most computers. <em>High accuracy</em> makes fewer mistakes,
- but is a larger download and needs about 1.6 GB more memory while transcribing.
- A model is downloaded the first time you transcribe with it.</td>
- </tr>
- <tr>
- <td><em>Identify speakers</em>
- </td>
- <td>Tells the other participants apart and labels each of them separately.
- Voices are compared only during the meeting: nothing about a voice is stored,
- and no one is recognized from one meeting to the next. Turn it off if it
- mixes up voices. The change applies from the next meeting.</td>
- </tr>
- <tr>
- <td><em>Keep recordings for troubleshooting</em>
- </td>
- <td>Keeps the audio of the meeting, the settings used and the transcript as
- it was produced, so that a problem can be reported and reproduced. It takes
- about 230 MB per hour of meeting and is never deleted automatically. The
- folder where they are kept is shown below the option.</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<aside class="admonition warning">
- <p>Before turning on <em>Keep recordings for troubleshooting</em>, ask everyone
- in the meeting to agree to being recorded. In several countries and US
- states, recording a conversation without everyone's consent is a criminal
- offense. The audio is stored unencrypted, even for protected notes. While
- the option is on, the tooltip of the <em>Transcribe meeting</em> button says
- so, and the reminder shown when the transcription starts mentions that
- the audio is kept.</p>
-</aside>
-<h2>Limitations</h2>
-<ul>
- <li>Meeting transcription needs a speech recognition engine that does not
- load on every computer, for example on Linux distributions older than Ubuntu
- 22.04 or Debian 12. Where it does not load, the <em>Transcribe meeting</em> button
- does not appear, the <em>Transcription</em> options say so, and the log records
- why.</li>
- <li>The transcript is made from the audio played by your device. A participant
- whose voice does not come out of your speakers or headphones, for example
- someone in the same room, is transcribed only as far as your microphone
- picks them up, and is labeled <em>Me</em>.</li>
- <li>Speaker identification works best with a few clearly distinct voices.
- Similar voices, many participants or poor call quality can lead to speakers
- being merged or split.</li>
- <li>Accuracy is lower for languages other than English, and the model can
- switch to the wrong language for short passages.</li>
- <li>Transcribing uses a noticeable amount of processor time and memory, especially
- with the <em>High accuracy</em> model.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Miscellaneous/License.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Miscellaneous/License.html
deleted file mode 100644
index a250c4bdb7..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Miscellaneous/License.html
+++ /dev/null
@@ -1,517 +0,0 @@
-<p>GNU AFFERO GENERAL PUBLIC LICENSE
- <br>Version 3, 19 November 2007</p>
-<p>Copyright (C) 2007 Free Software Foundation, Inc. <a href="https://fsf.org/">https://fsf.org/</a>
-</p>
-<p>Everyone is permitted to copy and distribute verbatim copies of this license
- document, but changing it is not allowed.</p>
-<h2>Preamble</h2>
-<p>The GNU Affero General Public License is a free, copyleft license for
- software and other kinds of works, specifically designed to ensure cooperation
- with the community in the case of network server software.</p>
-<p>The licenses for most software and other practical works are designed
- to take away your freedom to share and change the works. By contrast, our
- General Public Licenses are intended to guarantee your freedom to share
- and change all versions of a program--to make sure it remains free software
- for all its users.</p>
-<p>When we speak of free software, we are referring to freedom, not price.
- Our General Public Licenses are designed to make sure that you have the
- freedom to distribute copies of free software (and charge for them if you
- wish), that you receive source code or can get it if you want it, that
- you can change the software or use pieces of it in new free programs, and
- that you know you can do these things.</p>
-<p>Developers that use our General Public Licenses protect your rights with
- two steps: (1) assert copyright on the software, and (2) offer you this
- License which gives you legal permission to copy, distribute and/or modify
- the software.</p>
-<p>A secondary benefit of defending all users' freedom is that improvements
- made in alternate versions of the program, if they receive widespread use,
- become available for other developers to incorporate. Many developers of
- free software are heartened and encouraged by the resulting cooperation.
- However, in the case of software used on network servers, this result may
- fail to come about. The GNU General Public License permits making a modified
- version and letting the public access it on a server without ever releasing
- its source code to the public.</p>
-<p>The GNU Affero General Public License is designed specifically to ensure
- that, in such cases, the modified source code becomes available to the
- community. It requires the operator of a network server to provide the
- source code of the modified version running there to the users of that
- server. Therefore, public use of a modified version, on a publicly accessible
- server, gives the public access to the source code of the modified version.</p>
-<p>An older license, called the Affero General Public License and published
- by Affero, was designed to accomplish similar goals. This is a different
- license, not a version of the Affero GPL, but Affero has released a new
- version of the Affero GPL which permits relicensing under this license.</p>
-<p>The precise terms and conditions for copying, distribution and modification
- follow.</p>
-<h2>TERMS AND CONDITIONS</h2>
-<h3>0. Definitions.</h3>
-<p>"This License" refers to version 3 of the GNU Affero General Public License.</p>
-<p>"Copyright" also means copyright-like laws that apply to other kinds of
- works, such as semiconductor masks.</p>
-<p>"The Program" refers to any copyrightable work licensed under this License.
- Each licensee is addressed as "you". "Licensees" and "recipients" may be
- individuals or organizations.</p>
-<p>To "modify" a work means to copy from or adapt all or part of the work
- in a fashion requiring copyright permission, other than the making of an
- exact copy. The resulting work is called a "modified version" of the earlier
- work or a work "based on" the earlier work.</p>
-<p>A "covered work" means either the unmodified Program or a work based on
- the Program.</p>
-<p>To "propagate" a work means to do anything with it that, without permission,
- would make you directly or secondarily liable for infringement under applicable
- copyright law, except executing it on a computer or modifying a private
- copy. Propagation includes copying, distribution (with or without modification),
- making available to the public, and in some countries other activities
- as well.</p>
-<p>To "convey" a work means any kind of propagation that enables other parties
- to make or receive copies. Mere interaction with a user through a computer
- network, with no transfer of a copy, is not conveying.</p>
-<p>An interactive user interface displays "Appropriate Legal Notices" to
- the extent that it includes a convenient and prominently visible feature
- that (1) displays an appropriate copyright notice, and (2) tells the user
- that there is no warranty for the work (except to the extent that warranties
- are provided), that licensees may convey the work under this License, and
- how to view a copy of this License. If the interface presents a list of
- user commands or options, such as a menu, a prominent item in the list
- meets this criterion.</p>
-<h3>1. Source Code.</h3>
-<p>The "source code" for a work means the preferred form of the work for
- making modifications to it. "Object code" means any non-source form of
- a work.</p>
-<p>A "Standard Interface" means an interface that either is an official standard
- defined by a recognized standards body, or, in the case of interfaces specified
- for a particular programming language, one that is widely used among developers
- working in that language.</p>
-<p>The "System Libraries" of an executable work include anything, other than
- the work as a whole, that (a) is included in the normal form of packaging
- a Major Component, but which is not part of that Major Component, and (b)
- serves only to enable use of the work with that Major Component, or to
- implement a Standard Interface for which an implementation is available
- to the public in source code form. A "Major Component", in this context,
- means a major essential component (kernel, window system, and so on) of
- the specific operating system (if any) on which the executable work runs,
- or a compiler used to produce the work, or an object code interpreter used
- to run it.</p>
-<p>The "Corresponding Source" for a work in object code form means all the
- source code needed to generate, install, and (for an executable work) run
- the object code and to modify the work, including scripts to control those
- activities. However, it does not include the work's System Libraries, or
- general-purpose tools or generally available free programs which are used
- unmodified in performing those activities but which are not part of the
- work. For example, Corresponding Source includes interface definition files
- associated with source files for the work, and the source code for shared
- libraries and dynamically linked subprograms that the work is specifically
- designed to require, such as by intimate data communication or control
- flow between those subprograms and other parts of the work.</p>
-<p>The Corresponding Source need not include anything that users can regenerate
- automatically from other parts of the Corresponding Source.</p>
-<p>The Corresponding Source for a work in source code form is that same work.</p>
-<h3>2. Basic Permissions.</h3>
-<p>All rights granted under this License are granted for the term of copyright
- on the Program, and are irrevocable provided the stated conditions are
- met. This License explicitly affirms your unlimited permission to run the
- unmodified Program. The output from running a covered work is covered by
- this License only if the output, given its content, constitutes a covered
- work. This License acknowledges your rights of fair use or other equivalent,
- as provided by copyright law.</p>
-<p>You may make, run and propagate covered works that you do not convey,
- without conditions so long as your license otherwise remains in force.
- You may convey covered works to others for the sole purpose of having them
- make modifications exclusively for you, or provide you with facilities
- for running those works, provided that you comply with the terms of this
- License in conveying all material for which you do not control copyright.
- Those thus making or running the covered works for you must do so exclusively
- on your behalf, under your direction and control, on terms that prohibit
- them from making any copies of your copyrighted material outside their
- relationship with you.</p>
-<p>Conveying under any other circumstances is permitted solely under the
- conditions stated below. Sublicensing is not allowed; section 10 makes
- it unnecessary.</p>
-<h3>3. Protecting Users' Legal Rights From Anti-Circumvention Law.</h3>
-<p>No covered work shall be deemed part of an effective technological measure
- under any applicable law fulfilling obligations under article 11 of the
- WIPO copyright treaty adopted on 20 December 1996, or similar laws prohibiting
- or restricting circumvention of such measures.</p>
-<p>When you convey a covered work, you waive any legal power to forbid circumvention
- of technological measures to the extent such circumvention is effected
- by exercising rights under this License with respect to the covered work,
- and you disclaim any intention to limit operation or modification of the
- work as a means of enforcing, against the work's users, your or third parties'
- legal rights to forbid circumvention of technological measures.</p>
-<h3>4. Conveying Verbatim Copies.</h3>
-<p>You may convey verbatim copies of the Program's source code as you receive
- it, in any medium, provided that you conspicuously and appropriately publish
- on each copy an appropriate copyright notice; keep intact all notices stating
- that this License and any non-permissive terms added in accord with section
- 7 apply to the code; keep intact all notices of the absence of any warranty;
- and give all recipients a copy of this License along with the Program.</p>
-<p>You may charge any price or no price for each copy that you convey, and
- you may offer support or warranty protection for a fee.</p>
-<h3>5. Conveying Modified Source Versions.</h3>
-<p>You may convey a work based on the Program, or the modifications to produce
- it from the Program, in the form of source code under the terms of section
- 4, provided that you also meet all of these conditions:</p>
-<ul>
- <li>a) The work must carry prominent notices stating that you modified it,
- and giving a relevant date.</li>
- <li>b) The work must carry prominent notices stating that it is released under
- this License and any conditions added under section 7. This requirement
- modifies the requirement in section 4 to "keep intact all notices".</li>
- <li>c) You must license the entire work, as a whole, under this License to
- anyone who comes into possession of a copy. This License will therefore
- apply, along with any applicable section 7 additional terms, to the whole
- of the work, and all its parts, regardless of how they are packaged. This
- License gives no permission to license the work in any other way, but it
- does not invalidate such permission if you have separately received it.</li>
- <li>d) If the work has interactive user interfaces, each must display Appropriate
- Legal Notices; however, if the Program has interactive interfaces that
- do not display Appropriate Legal Notices, your work need not make them
- do so.</li>
-</ul>
-<p>A compilation of a covered work with other separate and independent works,
- which are not by their nature extensions of the covered work, and which
- are not combined with it such as to form a larger program, in or on a volume
- of a storage or distribution medium, is called an "aggregate" if the compilation
- and its resulting copyright are not used to limit the access or legal rights
- of the compilation's users beyond what the individual works permit. Inclusion
- of a covered work in an aggregate does not cause this License to apply
- to the other parts of the aggregate.</p>
-<h3>6. Conveying Non-Source Forms.</h3>
-<p>You may convey a covered work in object code form under the terms of sections
- 4 and 5, provided that you also convey the machine-readable Corresponding
- Source under the terms of this License, in one of these ways:</p>
-<ul>
- <li>a) Convey the object code in, or embodied in, a physical product (including
- a physical distribution medium), accompanied by the Corresponding Source
- fixed on a durable physical medium customarily used for software interchange.</li>
- <li>b) Convey the object code in, or embodied in, a physical product (including
- a physical distribution medium), accompanied by a written offer, valid
- for at least three years and valid for as long as you offer spare parts
- or customer support for that product model, to give anyone who possesses
- the object code either (1) a copy of the Corresponding Source for all the
- software in the product that is covered by this License, on a durable physical
- medium customarily used for software interchange, for a price no more than
- your reasonable cost of physically performing this conveying of source,
- or (2) access to copy the Corresponding Source from a network server at
- no charge.</li>
- <li>c) Convey individual copies of the object code with a copy of the written
- offer to provide the Corresponding Source. This alternative is allowed
- only occasionally and noncommercially, and only if you received the object
- code with such an offer, in accord with subsection 6b.</li>
- <li>d) Convey the object code by offering access from a designated place (gratis
- or for a charge), and offer equivalent access to the Corresponding Source
- in the same way through the same place at no further charge. You need not
- require recipients to copy the Corresponding Source along with the object
- code. If the place to copy the object code is a network server, the Corresponding
- Source may be on a different server (operated by you or a third party)
- that supports equivalent copying facilities, provided you maintain clear
- directions next to the object code saying where to find the Corresponding
- Source. Regardless of what server hosts the Corresponding Source, you remain
- obligated to ensure that it is available for as long as needed to satisfy
- these requirements.</li>
- <li>e) Convey the object code using peer-to-peer transmission, provided you
- inform other peers where the object code and Corresponding Source of the
- work are being offered to the general public at no charge under subsection
- 6d.</li>
-</ul>
-<p>A separable portion of the object code, whose source code is excluded
- from the Corresponding Source as a System Library, need not be included
- in conveying the object code work.</p>
-<p>A "User Product" is either (1) a "consumer product", which means any tangible
- personal property which is normally used for personal, family, or household
- purposes, or (2) anything designed or sold for incorporation into a dwelling.
- In determining whether a product is a consumer product, doubtful cases
- shall be resolved in favor of coverage. For a particular product received
- by a particular user, "normally used" refers to a typical or common use
- of that class of product, regardless of the status of the particular user
- or of the way in which the particular user actually uses, or expects or
- is expected to use, the product. A product is a consumer product regardless
- of whether the product has substantial commercial, industrial or non-consumer
- uses, unless such uses represent the only significant mode of use of the
- product.</p>
-<p>"Installation Information" for a User Product means any methods, procedures,
- authorization keys, or other information required to install and execute
- modified versions of a covered work in that User Product from a modified
- version of its Corresponding Source. The information must suffice to ensure
- that the continued functioning of the modified object code is in no case
- prevented or interfered with solely because modification has been made.</p>
-<p>If you convey an object code work under this section in, or with, or specifically
- for use in, a User Product, and the conveying occurs as part of a transaction
- in which the right of possession and use of the User Product is transferred
- to the recipient in perpetuity or for a fixed term (regardless of how the
- transaction is characterized), the Corresponding Source conveyed under
- this section must be accompanied by the Installation Information. But this
- requirement does not apply if neither you nor any third party retains the
- ability to install modified object code on the User Product (for example,
- the work has been installed in ROM).</p>
-<p>The requirement to provide Installation Information does not include a
- requirement to continue to provide support service, warranty, or updates
- for a work that has been modified or installed by the recipient, or for
- the User Product in which it has been modified or installed. Access to
- a network may be denied when the modification itself materially and adversely
- affects the operation of the network or violates the rules and protocols
- for communication across the network.</p>
-<p>Corresponding Source conveyed, and Installation Information provided,
- in accord with this section must be in a format that is publicly documented
- (and with an implementation available to the public in source code form),
- and must require no special password or key for unpacking, reading or copying.</p>
-<h3>7. Additional Terms.</h3>
-<p>"Additional permissions" are terms that supplement the terms of this License
- by making exceptions from one or more of its conditions. Additional permissions
- that are applicable to the entire Program shall be treated as though they
- were included in this License, to the extent that they are valid under
- applicable law. If additional permissions apply only to part of the Program,
- that part may be used separately under those permissions, but the entire
- Program remains governed by this License without regard to the additional
- permissions.</p>
-<p>When you convey a copy of a covered work, you may at your option remove
- any additional permissions from that copy, or from any part of it. (Additional
- permissions may be written to require their own removal in certain cases
- when you modify the work.) You may place additional permissions on material,
- added by you to a covered work, for which you have or can give appropriate
- copyright permission.</p>
-<p>Notwithstanding any other provision of this License, for material you
- add to a covered work, you may (if authorized by the copyright holders
- of that material) supplement the terms of this License with terms:</p>
-<ul>
- <li>a) Disclaiming warranty or limiting liability differently from the terms
- of sections 15 and 16 of this License; or</li>
- <li>b) Requiring preservation of specified reasonable legal notices or author
- attributions in that material or in the Appropriate Legal Notices displayed
- by works containing it; or</li>
- <li>c) Prohibiting misrepresentation of the origin of that material, or requiring
- that modified versions of such material be marked in reasonable ways as
- different from the original version; or</li>
- <li>d) Limiting the use for publicity purposes of names of licensors or authors
- of the material; or</li>
- <li>e) Declining to grant rights under trademark law for use of some trade
- names, trademarks, or service marks; or</li>
- <li>f) Requiring indemnification of licensors and authors of that material
- by anyone who conveys the material (or modified versions of it) with contractual
- assumptions of liability to the recipient, for any liability that these
- contractual assumptions directly impose on those licensors and authors.</li>
-</ul>
-<p>All other non-permissive additional terms are considered "further restrictions"
- within the meaning of section 10. If the Program as you received it, or
- any part of it, contains a notice stating that it is governed by this License
- along with a term that is a further restriction, you may remove that term.
- If a license document contains a further restriction but permits relicensing
- or conveying under this License, you may add to a covered work material
- governed by the terms of that license document, provided that the further
- restriction does not survive such relicensing or conveying.</p>
-<p>If you add terms to a covered work in accord with this section, you must
- place, in the relevant source files, a statement of the additional terms
- that apply to those files, or a notice indicating where to find the applicable
- terms.</p>
-<p>Additional terms, permissive or non-permissive, may be stated in the form
- of a separately written license, or stated as exceptions; the above requirements
- apply either way.</p>
-<h3>8. Termination.</h3>
-<p>You may not propagate or modify a covered work except as expressly provided
- under this License. Any attempt otherwise to propagate or modify it is
- void, and will automatically terminate your rights under this License (including
- any patent licenses granted under the third paragraph of section 11).</p>
-<p>However, if you cease all violation of this License, then your license
- from a particular copyright holder is reinstated (a) provisionally, unless
- and until the copyright holder explicitly and finally terminates your license,
- and (b) permanently, if the copyright holder fails to notify you of the
- violation by some reasonable means prior to 60 days after the cessation.</p>
-<p>Moreover, your license from a particular copyright holder is reinstated
- permanently if the copyright holder notifies you of the violation by some
- reasonable means, this is the first time you have received notice of violation
- of this License (for any work) from that copyright holder, and you cure
- the violation prior to 30 days after your receipt of the notice.</p>
-<p>Termination of your rights under this section does not terminate the licenses
- of parties who have received copies or rights from you under this License.
- If your rights have been terminated and not permanently reinstated, you
- do not qualify to receive new licenses for the same material under section
- 10.</p>
-<h3>9. Acceptance Not Required for Having Copies.</h3>
-<p>You are not required to accept this License in order to receive or run
- a copy of the Program. Ancillary propagation of a covered work occurring
- solely as a consequence of using peer-to-peer transmission to receive a
- copy likewise does not require acceptance. However, nothing other than
- this License grants you permission to propagate or modify any covered work.
- These actions infringe copyright if you do not accept this License. Therefore,
- by modifying or propagating a covered work, you indicate your acceptance
- of this License to do so.</p>
-<h3>10. Automatic Licensing of Downstream Recipients.</h3>
-<p>Each time you convey a covered work, the recipient automatically receives
- a license from the original licensors, to run, modify and propagate that
- work, subject to this License. You are not responsible for enforcing compliance
- by third parties with this License.</p>
-<p>An "entity transaction" is a transaction transferring control of an organization,
- or substantially all assets of one, or subdividing an organization, or
- merging organizations. If propagation of a covered work results from an
- entity transaction, each party to that transaction who receives a copy
- of the work also receives whatever licenses to the work the party's predecessor
- in interest had or could give under the previous paragraph, plus a right
- to possession of the Corresponding Source of the work from the predecessor
- in interest, if the predecessor has it or can get it with reasonable efforts.</p>
-<p>You may not impose any further restrictions on the exercise of the rights
- granted or affirmed under this License. For example, you may not impose
- a license fee, royalty, or other charge for exercise of rights granted
- under this License, and you may not initiate litigation (including a cross-claim
- or counterclaim in a lawsuit) alleging that any patent claim is infringed
- by making, using, selling, offering for sale, or importing the Program
- or any portion of it.</p>
-<h3>11. Patents.</h3>
-<p>A "contributor" is a copyright holder who authorizes use under this License
- of the Program or a work on which the Program is based. The work thus licensed
- is called the contributor's "contributor version".</p>
-<p>A contributor's "essential patent claims" are all patent claims owned
- or controlled by the contributor, whether already acquired or hereafter
- acquired, that would be infringed by some manner, permitted by this License,
- of making, using, or selling its contributor version, but do not include
- claims that would be infringed only as a consequence of further modification
- of the contributor version. For purposes of this definition, "control"
- includes the right to grant patent sublicenses in a manner consistent with
- the requirements of this License.</p>
-<p>Each contributor grants you a non-exclusive, worldwide, royalty-free patent
- license under the contributor's essential patent claims, to make, use,
- sell, offer for sale, import and otherwise run, modify and propagate the
- contents of its contributor version.</p>
-<p>In the following three paragraphs, a "patent license" is any express agreement
- or commitment, however denominated, not to enforce a patent (such as an
- express permission to practice a patent or covenant not to sue for patent
- infringement). To "grant" such a patent license to a party means to make
- such an agreement or commitment not to enforce a patent against the party.</p>
-<p>If you convey a covered work, knowingly relying on a patent license, and
- the Corresponding Source of the work is not available for anyone to copy,
- free of charge and under the terms of this License, through a publicly
- available network server or other readily accessible means, then you must
- either (1) cause the Corresponding Source to be so available, or (2) arrange
- to deprive yourself of the benefit of the patent license for this particular
- work, or (3) arrange, in a manner consistent with the requirements of this
- License, to extend the patent license to downstream recipients. "Knowingly
- relying" means you have actual knowledge that, but for the patent license,
- your conveying the covered work in a country, or your recipient's use of
- the covered work in a country, would infringe one or more identifiable
- patents in that country that you have reason to believe are valid.</p>
-<p>If, pursuant to or in connection with a single transaction or arrangement,
- you convey, or propagate by procuring conveyance of, a covered work, and
- grant a patent license to some of the parties receiving the covered work
- authorizing them to use, propagate, modify or convey a specific copy of
- the covered work, then the patent license you grant is automatically extended
- to all recipients of the covered work and works based on it.</p>
-<p>A patent license is "discriminatory" if it does not include within the
- scope of its coverage, prohibits the exercise of, or is conditioned on
- the non-exercise of one or more of the rights that are specifically granted
- under this License. You may not convey a covered work if you are a party
- to an arrangement with a third party that is in the business of distributing
- software, under which you make payment to the third party based on the
- extent of your activity of conveying the work, and under which the third
- party grants, to any of the parties who would receive the covered work
- from you, a discriminatory patent license (a) in connection with copies
- of the covered work conveyed by you (or copies made from those copies),
- or (b) primarily for and in connection with specific products or compilations
- that contain the covered work, unless you entered into that arrangement,
- or that patent license was granted, prior to 28 March 2007.</p>
-<p>Nothing in this License shall be construed as excluding or limiting any
- implied license or other defenses to infringement that may otherwise be
- available to you under applicable patent law.</p>
-<h3>12. No Surrender of Others' Freedom.</h3>
-<p>If conditions are imposed on you (whether by court order, agreement or
- otherwise) that contradict the conditions of this License, they do not
- excuse you from the conditions of this License. If you cannot convey a
- covered work so as to satisfy simultaneously your obligations under this
- License and any other pertinent obligations, then as a consequence you
- may not convey it at all. For example, if you agree to terms that obligate
- you to collect a royalty for further conveying from those to whom you convey
- the Program, the only way you could satisfy both those terms and this License
- would be to refrain entirely from conveying the Program.</p>
-<h3>13. Remote Network Interaction; Use with the GNU General Public License.</h3>
-<p>Notwithstanding any other provision of this License, if you modify the
- Program, your modified version must prominently offer all users interacting
- with it remotely through a computer network (if your version supports such
- interaction) an opportunity to receive the Corresponding Source of your
- version by providing access to the Corresponding Source from a network
- server at no charge, through some standard or customary means of facilitating
- copying of software. This Corresponding Source shall include the Corresponding
- Source for any work covered by version 3 of the GNU General Public License
- that is incorporated pursuant to the following paragraph.</p>
-<p>Notwithstanding any other provision of this License, you have permission
- to link or combine any covered work with a work licensed under version
- 3 of the GNU General Public License into a single combined work, and to
- convey the resulting work. The terms of this License will continue to apply
- to the part which is the covered work, but the work with which it is combined
- will remain governed by version 3 of the GNU General Public License.</p>
-<h3>14. Revised Versions of this License.</h3>
-<p>The Free Software Foundation may publish revised and/or new versions of
- the GNU Affero General Public License from time to time. Such new versions
- will be similar in spirit to the present version, but may differ in detail
- to address new problems or concerns.</p>
-<p>Each version is given a distinguishing version number. If the Program
- specifies that a certain numbered version of the GNU Affero General Public
- License "or any later version" applies to it, you have the option of following
- the terms and conditions either of that numbered version or of any later
- version published by the Free Software Foundation. If the Program does
- not specify a version number of the GNU Affero General Public License,
- you may choose any version ever published by the Free Software Foundation.</p>
-<p>If the Program specifies that a proxy can decide which future versions
- of the GNU Affero General Public License can be used, that proxy's public
- statement of acceptance of a version permanently authorizes you to choose
- that version for the Program.</p>
-<p>Later license versions may give you additional or different permissions.
- However, no additional obligations are imposed on any author or copyright
- holder as a result of your choosing to follow a later version.</p>
-<h3>15. Disclaimer of Warranty.</h3>
-<p>THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE
- LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
- OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND,
- EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
- WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE
- ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.
- SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
- SERVICING, REPAIR OR CORRECTION.</p>
-<h3>16. Limitation of Liability.</h3>
-<p>IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
- WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
- THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING
- ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF
- THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS
- OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR
- THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
- EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY
- OF SUCH DAMAGES.</p>
-<h3>17. Interpretation of Sections 15 and 16.</h3>
-<p>If the disclaimer of warranty and limitation of liability provided above
- cannot be given local legal effect according to their terms, reviewing
- courts shall apply local law that most closely approximates an absolute
- waiver of all civil liability in connection with the Program, unless a
- warranty or assumption of liability accompanies a copy of the Program in
- return for a fee.</p>
-<p>END OF TERMS AND CONDITIONS</p>
-<h2>How to Apply These Terms to Your New Programs</h2>
-<p>If you develop a new program, and you want it to be of the greatest possible
- use to the public, the best way to achieve this is to make it free software
- which everyone can redistribute and change under these terms.</p>
-<p>To do so, attach the following notices to the program. It is safest to
- attach them to the start of each source file to most effectively state
- the exclusion of warranty; and each file should have at least the "copyright"
- line and a pointer to where the full notice is found.</p><pre><code class="language-text-x-trilium-auto"> &lt;one line to give the program's name and a brief idea of what it does.&gt;
- Copyright (C) &lt;year&gt; &lt;name of author&gt;
-
- This program is free software: you can redistribute it and/or modify
- it under the terms of the GNU Affero General Public License as
- published by the Free Software Foundation, either version 3 of the
- License, or (at your option) any later version.
-
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- GNU Affero General Public License for more details.
-
- You should have received a copy of the GNU Affero General Public License
- along with this program. If not, see &lt;https://www.gnu.org/licenses/&gt;.</code></pre>
-<p>Also add information on how to contact you by electronic and paper mail.</p>
-<p>If your software can interact with users remotely through a computer network,
- you should also make sure that it provides a way for users to get its source.
- For example, if your program is a web application, its interface could
- display a "Source" link that leads users to an archive of the code. There
- are many ways you could offer source, and different solutions will be better
- for different programs; see section 13 for the specific requirements.</p>
-<p>You should also get your employer (if you work as a programmer) or school,
- if any, to sign a "copyright disclaimer" for the program, if necessary.
- For more information on this, and how to apply and follow the GNU AGPL,
- see <a href="https://www.gnu.org/licenses/">https://www.gnu.org/licenses/</a>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Miscellaneous/Patterns of personal knowledge.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Miscellaneous/Patterns of personal knowledge.html
deleted file mode 100644
index 284a26cd18..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Miscellaneous/Patterns of personal knowledge.html
+++ /dev/null
@@ -1,299 +0,0 @@
-<aside class="admonition note">
- <p>This article is a description of the original author of Trilium (zadam)
- in regards with his own knowledge base.</p>
-</aside>
-<p>This page contains description of some of the patterns I use to organize
- information in my knowledge base. This is meant to give some inspiration
- of how one might create and structure their knowledge base in general and
- also specifically in Trilium Notes. It also gives some background and justification
- for some of the design decisions.</p>
-<h2>Meta patterns</h2>
-<p>Just to be clear, meta patterns are "patterns of patterns", i.e. patterns
- appearing in other patterns.</p>
-<h3>Hierarchical organization of information</h3>
-<p>Basic meta pattern is that I sort notes (units of information) into a
- hierarchy - I have some "top level" notes which represent coarse grained
- organization, these then split into sub-notes defining finer grained organization
- and so on. I consider this hierarchical (tree) organization very efficient
- for organization of large amounts of information. A lot of note taking
- software (such as Evernote) are frustratingly limited in this regard which
- limits scalability of the software to large amounts of notes.</p>
-<h4>Scalability</h4>
-<p>It's important to frame the following (meta) patterns with some idea of
- how large amount of data are we talking about.</p>
-<p>My rule of thumb for estimation of size of personal knowledge base is
- that you can reasonably produce around 10 notes a day, which is 3650 in
- a year. I plan to use my knowledge base long term (with or without Trilium
- Notes), probably decades so you can easily get to number 100 000 or even
- more. Right now, my personal knowledge base has around 10 000 notes.</p>
-<p>100 000 is a number to which most note taking software doesn't scale well
- (in both performance and UI). Yet I don't think it's really very much considering
- a lifetime of knowledge.</p>
-<h4>Lazy hierarchy</h4>
-<p>My approach to creating the hierarchy is being lazy - I don't create the
- structure first and then fill it with notes, instead I create single note
- for some specific topic and start using this one note. Once the content
- starts to grow, and I see how <em>some</em> parts could be split out, I move
- them out into separate sub notes. As an example I have a book review for <em>The Fellowship of the Ring</em>:</p>
-<ul>
- <li>Book reviews
- <ul>
- <li>The Fellowship of the Ring</li>
- </ul>
- </li>
-</ul>
-<p>The note contains basic book info (author, publisher etc.), book highlights
- with the comments and then overall review. Now it turns out there's far
- too many book highlights and overall review is also rather long, so I want
- to change the structure to the following:</p>
-<ul>
- <li>Book reviews
- <ul>
- <li>The Fellowship of the Ring &nbsp; &nbsp; &nbsp;&nbsp;<em>(still contains basic info)</em>
- <ul>
- <li>Highlights</li>
- <li>Review</li>
- </ul>
- </li>
- </ul>
- </li>
-</ul>
-<p>If I used standard text file stored in a filesystem I would soon run into
- an annoying problem that in order to split out the Highlights and Review
- into sub-notes I would also have to convert <em>The Fellowship of the Ring</em> from
- text file into directory and split out all sections of the note into sub-notes.
- Instead, Trilium treats all notes as equal - both leaf notes and inner
- notes can have both text content which allows me to sub-structure only
- content which needs it.</p>
-<h3>Sorting notes into multiple places in the hierarchy</h3>
-<p>While organizing the notes into the hierarchy, you very quickly run into
- a dilemma - your note seem to belong to two places in the hierarchy equally.
- As an example - you want to make a note about <a href="https://en.wikipedia.org/wiki/Bash_(Unix_shell)">bash</a> -
- does it belong to "OS / Linux" or "Programming / Scripting languages"?
- This is actually a false dichotomy forced down by the limits of the basic
- tree hierarchy - the answer is <em>of course it belongs to both</em>. This
- is the reason why Trilium doesn't use standard tree structure (which requires
- every note to have exactly one parent), but an extension which allows every
- note to have several parents, thus effectively allowing it to appear in
- multiple places in the hierarchy. For lack of better term I call this "cloning".
- The main problem with this term is that it suggests that each clone must
- have an original, but here all clones are completely equal - effectively
- there's no original.</p>
-<p>In tech lingo, it might be better to describe it as a <a href="https://en.wikipedia.org/wiki/Hard_link">hard link</a> with
- an important difference that it is possible to hard link (clone) a directory
- (inner note).</p>
-<h3>Protected notes</h3>
-<p>I have Trilium Notes opened non-stop. Sometimes I forget to lock my computer
- when going to the bathroom. Sometimes I let a friend or family member to
- use my computer for a minute without supervision. They might click on (running)
- Trilium and inadvertently see a note I really don't want anybody to see
- (personal diary, credentials). To cover this, Trilium has a concept of
- "<a href="https://github.com/zadam/trilium/wiki/Protected-notes">protected notes</a>"
- - protected note is encrypted and on top of that requires the user to enter
- the password every 5 minutes which guarantees that such note can be in
- a readable state only for small amount of time. Working with ordinary (not
- protected) notes don't require password so you're not bothered by extra
- security when it's not needed.</p>
-<h3>Archiving notes</h3>
-<p>Notes can lose relevancy with time - let's say I switch jobs - all the
- notes specific to the former employer immediately lose most of its import.
- This doesn't mean I want to delete these notes though - typically I just
- want them to somehow deprioritize - in Trilium I would do that by assigning
- an <a href="https://github.com/zadam/trilium/wiki/Attribute-inheritance">inherited</a> <a
- href="https://github.com/zadam/trilium/wiki/Attributes">label</a> <code>archived</code> to
- the company root note. The main effect of this label is that all the notes
- from this sub-tree are filtered out from search results (fast search via
- note autocomplete is my main <a href="https://github.com/zadam/trilium/wiki/Note-navigation">navigation approach</a>).
- Apart from this, I also typically move such outdated notes to some less
- prominent place in the hierarchy.</p>
-<p>I use archivation also for notes which are not very relevant from their
- creation - an example might be automatically imported reddit comments.</p>
-<p>Sometimes there's no clear <em>category</em> split between relevant and
- non-relevant notes, in that case I just create "<em>OLD</em>" note with <code>archived</code> label
- and move all irrelevant notes there. So my credentials note might look
- something like this:</p>
-<ul>
- <li>Credentials
- <ul>
- <li>Personal
- <ul>
- <li>OLD &nbsp; &nbsp; &nbsp;&nbsp;<em>(contains a bunch of notes with credentials for services I don't use anymore)</em>
- </li>
- <li>Gmail</li>
- <li>Github</li>
- <li>...</li>
- </ul>
- </li>
- </ul>
- </li>
-</ul>
-<h2>Patterns</h2>
-<h3>Day note</h3>
-<p>Every day has its note which contains or references everything related
- to the given day. Structure looks like this:</p>
-<ul>
- <li>2018
- <ul>
- <li>11 - November
- <ul>
- <li>26 - Monday</li>
- <li>27 - Tuesday
- <ul>
- <li>subnote 1</li>
- </ul>
- </li>
- </ul>
- </li>
- </ul>
- </li>
-</ul>
-<p>Day note serves as a workspace and note inbox at the same time - it's
- the default location to create a note when I don't have time to think about
- proper placement. At the end of the day I typically review my day note
- and clone the notes into suitable locations in the hierarchy.</p>
-<p>Trilium has this pattern partly built-in - Trilium understands and can
- create this Year / Month / Day structure semi-automatically (on API call).
- There's also global keyboard shortcut <code>CTRL-ALT-P</code> which will
- create new note in the day note.</p>
-<p>What notes do I keep under this day note?</p>
-<ul>
- <li>TODO list for given day (this can be automated - see&nbsp;<a class="reference-link"
- href="#root/_help_xYjQUYhpbUEW">Task Manager</a>)</li>
- <li>Personal diary</li>
- <li><a href="#root/_help_IakOLONlIfGI">clones</a> of notes I created during
- this day (which kind of represents what I've been working on).</li>
- <li>I often clone notes (or sub-trees) of e.g. projects I'm working on at
- given day so they are at hand</li>
- <li>I have some <a href="#root/_help_CdNpE2pqjmI6">scripts</a> which allow me
- to track certain daily metrics (like weight). These are saved into one
- daily "data note" (actually JSON <a href="#root/_help_6f9hih2hXXZk">code note</a>).
- <ul>
- <li>I have other scripts which then help me to visualize these data (see a&nbsp;<a
- class="reference-link" href="#root/_help_R7abl2fc6Mxi">Weight Tracker</a>&nbsp;example)</li>
- <li>I have a script which automatically imports all my comments from reddit
- into the day note.
- <ul>
- <li>People are sometimes wondering why. The answer is that I usually put some
- effort and thought into a comment and that's why I feel it's worth preserving,
- especially if it can be done automatically.</li>
- </ul>
- </li>
- </ul>
- </li>
-</ul>
-<p>For most notes, this day note placement is <em>secondary</em> and their
- primary location is somewhere else (e.g. for a book review I've been working
- on it's <em>Book / Reviews</em>, not the day note). So for this pattern
- to work, ability to <a href="#root/_help_IakOLONlIfGI">clone</a> notes into
- multiple places is pretty fundamental.</p>
-<h3>Projects</h3>
-<p><em>Project</em> is pretty self-explanatory, for me specifically it also
- means being long term (years) - an example of a project might be Trilium
- Notes or university studies. Given their longevity, projects can be large
- and deep, but their structure is very domain specific, and I don't see
- any common patterns. What's pretty clear is they are often widely interconnected
- with other parts of the knowledge base - e.g. university credentials are
- cloned from "Credentials / University" top level notes and Trilium related
- blog posts are in "Blog / [Name of the blog] / Trilium".</p>
-<p><em>Epics</em> are the same thing as projects, but differ in scope - they
- are typically several months long and as such are usually placed into a
- year note (e.g. <em>2018 / Epics</em>). Epics are often of work nature (also
- cloned into work note) and personal (e.g. currently I have large epic for
- moving to a different city).</p>
-<p>I don't have a term for short term projects (typically several days long),
- but continuing the scrum analogy I might call them <em>story</em>. These
- are often placed directly into day notes and manually moved from one day
- to another (or place into a month note, e.g. <em>2018 / 11 - November</em>).</p>
-<h3>Credentials</h3>
-<p>I keep all my credentials in the knowledge base, they are sorted into
- categories - work related, project related, personal per country etc. These
- notes are of course <a href="#root/_help_bwg0e8ewQMak">protected</a> and
- are often cloned into other places (e.g. project credentials are cloned
- into the project itself). This is a pretty important advantage compared
- to traditional tools like KeePass - all the relevant information is centralized
- into one place without compromising security.</p>
-<h3>People profiles</h3>
-<p>This might seem creepy to some, but I keep a profile on most people. It
- contains pretty standard things like date of birth, contacts, address,
- but also current and previous employments, their hobbies and worldviews
- and sometimes even important (IM/mail/meatspace) conversations. Just about
- everything I find notable. It helps to refresh some basic info before meeting
- people, especially if you haven't been in touch in a while. It gets pretty
- awkward to ask for the tenth time where do they work for example, because
- you keep forgetting it.</p>
-<p>Naturally I have a lot of (extended) family members, friends, acquaintances
- etc. so I need some way to sort them. My main method is to sort them by
- social circle (work, high school, sports club etc.), sometimes also by
- their town of residence. Family <em>circle</em> is still too large so the
- further organization is by <em>clan</em> (as in "Smiths"). Some people are
- members of several such circles, so they are just cloned into multiple
- places.</p>
-<p>For family specifically it's pretty useful to create a&nbsp;<a class="reference-link"
- href="#root/_help_iRwzGnHPzonm">Relation Map</a>&nbsp;to visualize relationships:</p>
-<figure
-class="image">
- <img style="aspect-ratio:941/758;" src="Patterns of personal knowledge_relation-map-family.png"
- width="941" height="758">
-</figure>
-<h3>Books</h3>
-<p>Of course, I keep standard "To read" list. I also keep a record on the
- books I've read - typically one book has one subtree where the root has
- some basic info like author, page count, publication date, date started,
- date finished (in the form of&nbsp;<a class="reference-link" href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>).
- I also write a (private) review and keep list of highlights from Kindle,
- optionally with some commentary, these are usually stored in sub notes
- (unless they are pretty short).</p>
-<p>To keep the list of books manageable, I sort them per year (of reading
- them), this also gives me some basic overview of "reading performance"
- for given year. I plan to create a <a href="#root/_help_CdNpE2pqjmI6">script</a> which
- would show some timeline chart visualizing book attributes <code>dateStarted</code> - <code>dateFinished</code> to
- have nicer view of my reading sprints and trends.</p>
-<p>Some specific authors also have their own note which contains cloned book
- reviews, links to interviews and other related resources.</p>
-<p>I have similar system for movies and TV shows, but not as sophisticated.</p>
-<h3>Personal diary</h3>
-<p>This is a place to reflect on events, experiences, new findings etc. This
- can help you get deeper understanding of your inner self, clarify your
- thinking and make better decisions as a result.</p>
-<p>I sort personal diary notes directly under <em>day note</em> (explained
- above), but it can be cloned also to e.g. "trip note" (if the diary note
- is about given trip) or to person's profile (if the person plays a role
- in the diary note). All my diary notes are <a href="#root/_help_bwg0e8ewQMak">protected</a> since
- they are usually pretty sensitive.</p>
-<h3>Documents</h3>
-<p>I keep all my personal documents (ID, passport, education certificates
- ...) scanned in the knowledge base. They are <a href="#root/_help_cbkrhQjrkKrh">synchronized</a> across
- every PC which provides decent backup and makes them available everywhere.</p>
-<p>Advantage compared to e.g. keeping them in Dropbox or Google Drive is
- that they are not stored on some 3rd party server and they can be encrypted
- (see&nbsp;<a class="reference-link" href="#root/_help_bwg0e8ewQMak">Protected Notes</a>).</p>
-<h3>Inventory</h3>
-<p>Inventory contains documents and other relevant importation for my important
- belongings - e.g. for car you can keep the registration card, maintenance
- record, related costs etc. I also keep inventory for some items personally
- important to me - mainly computers, phones, cameras and similar electronics.
- This can be practical at times but also provides sentimental value.</p>
-<h3>Topic knowledge base</h3>
-<p>This where I store hard "knowledge" - summarized topics and findings from
- different domains. Topics can range from traditional sciences - physics,
- history, economy to philosophy, mental models, apps (notes about specific
- apps I use) etc. Of course this is very subjective - given what I do, my
- Physics sub-tree is pretty sparse compared to my Programming subtree.</p>
-<h3>Work knowledge base</h3>
-<p>I usually keep top level note for the company I currently work at (past
- jobs are moved elsewhere). I track basic organization of the company (divisions,
- business units), who is who (<a class="reference-link" href="#root/_help_iRwzGnHPzonm">Relation Map</a>)
- are again useful for visualization), projects I work at etc.</p>
-<p>There's a number of credentials to various company services I need to
- use. Companies usually have a bunch of complex processes and tools. I record
- meeting minutes, link to the company wiki (which is usually difficult to
- find relevant info). In general there's a lot of company specific information
- I need to know or need have them at hand in a nice structure I can understand.
- Often it's just copy pasting and reshuffling of existing information into
- something more understandable for me.</p>
-<p>From my experience, keeping this makes me more productive and even more
- importantly dramatically reduces frustration and stress.</p>
-<h2>Conclusion</h2>
-<p>I could probably go on with more patterns (e.g. study notes, travelling),
- but I think you get the idea. Whatever is important in your life, it probably
- makes sense to document and track it.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Miscellaneous/Patterns of personal knowledge_relation-map-family.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Miscellaneous/Patterns of personal knowledge_relation-map-family.png
deleted file mode 100644
index 39788216a7..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Miscellaneous/Patterns of personal knowledge_relation-map-family.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Miscellaneous/Privacy Policy.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Miscellaneous/Privacy Policy.html
deleted file mode 100644
index 8f81ba26e7..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Miscellaneous/Privacy Policy.html
+++ /dev/null
@@ -1,20 +0,0 @@
-<h3>Trilium Notes</h3>
-<p>Trilium Notes does not collect/send any data from the user's installation,
- i.e. no analytics, no telemetry etc. The data flows only between user controlled
- / installed applications, without any intermediary.</p>
-<p>Automatic network activity consists of:</p>
-<ul>
- <li>Trilium periodically queries URL <a href="https://github.com/TriliumNext/Trilium/releases">https://github.com/TriliumNext/Trilium/releases</a> to
- see if there's a new stable version released. (check only, there's no automatic
- download and/or installation).</li>
- <li>Trilium will download spelling dictionaries automatically as needed based
- on language settings</li>
-</ul>
-<h3>Trilium Web Clipper</h3>
-<p>Trilium Web Clipper does not collect/send any data from the user's installation,
- i.e. no analytics, no telemetry etc. The data flows only between user controlled
- / installed applications, without any intermediary.</p>
-<h3>Trilium Sender for Android</h3>
-<p>Trilium Sender for Android does not collect/send any data from the user's
- installation, i.e. no analytics, no telemetry etc. The data flows only
- between user controlled / installed applications, without any intermediary.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types.html
deleted file mode 100644
index 40f466ed61..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types.html
+++ /dev/null
@@ -1,138 +0,0 @@
-<p>One of the core features of Trilium is that it supports multiple types
- of notes, depending on the need.</p>
-<h2>Creating a new note with a different type via the note tree</h2>
-<p>The default note type in Trilium (e.g. when creating a new note) is&nbsp;<a
- class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>, since
- it's for general use.</p>
-<p>To create a new note of a different type, head to the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;and right click an existing
- note where to place the new one and select:</p>
-<ul>
- <li><em>Insert note after</em>, to put the new note underneath the one selected.</li>
- <li><em>Insert child note</em>, to insert the note as a child of the selected
- note.</li>
-</ul>
-<p>The note types created less often,&nbsp;<a class="reference-link" href="#root/_help_m523cpzocqaD">Saved Search</a>,&nbsp;<a
- class="reference-link" href="#root/_help_HcABDtFCkbFN">Render Note</a>,&nbsp;<a
- class="reference-link" href="#root/_help_1vHRoWCEjj0L">Web View</a>&nbsp;and&nbsp;<a
- class="reference-link" href="#root/_help_bdUJEHsAPYQR">Note Map</a>, are
- in the <em>More</em> submenu.</p>
-<p>
- <img src="Note Types_image.png">
-</p>
-<h2>Creating a new note of a different type via add link or new tab</h2>
-<ul>
- <li>When adding a <a href="#root/_help_QEAPj01N5f7w">link</a> in a&nbsp;<a class="reference-link"
- href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;note, type the desired title
- of the new note and press Enter. Afterwards the type of the note will be
- asked.</li>
- <li>Similarly, when creating a new tab, type the desired title and press Enter.</li>
-</ul>
-<p>The note type is chosen from the same menu as in the note tree, with its
- submenus (code languages, snippets, collections and the note types created
- less often) and its search box: type to narrow the list, then press <kbd>Enter</kbd> to
- create the first match. <kbd>Enter</kbd> right away creates a Text note.</p>
-<h2>Changing the type of a note</h2>
-<p>It is possible to change the type of a note after it has been created
- via&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a>&nbsp;→ <em>Note type</em>.
- This feature can also be used to edit the <a href="#root/_help_4FahAwuGTAwC">source of a note</a>.</p>
-<aside
-class="admonition note">
- <p>Note that it's generally a good idea to change the note type only if the
- note is empty</p>
-</aside>
-<h2>Supported note types</h2>
-<p>The following note types are supported by Trilium:</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Note Type</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>
- </td>
- <td>The default note type, which allows for rich text formatting, images,
- admonitions and right-to-left support.</td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>
- </td>
- <td>Uses a mono-space font and can be used to store larger chunks of code
- or plain text than a text note, and has better syntax highlighting.</td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_m523cpzocqaD">Saved Search</a>
- </td>
- <td>Stores the information about a search (the search text, criteria, etc.)
- for later use. Can be used for quick filtering of a large amount of notes,
- for example. The search can easily be triggered.</td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_iRwzGnHPzonm">Relation Map</a>
- </td>
- <td>Allows easy creation of notes and relations between them. Can be used
- for mainly relational data such as a family tree.</td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_bdUJEHsAPYQR">Note Map</a>
- </td>
- <td>Displays the relationships between the notes, whether via relations or
- their hierarchical structure.</td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_HcABDtFCkbFN">Render Note</a>
- </td>
- <td>Used in&nbsp;<a class="reference-link" href="#root/_help_CdNpE2pqjmI6">Scripting</a>,
- it displays the HTML content of another note. This allows displaying any
- kind of content, provided there is a script behind it to generate it.</td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_GTwFsgaA0lCt">Collections</a>
- </td>
- <td>Displays the children of the note either as a grid, a list, or for a more
- specialized case: a calendar.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
- <br>
- <br>Generally useful for easy reading of short notes.</td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_s1aBHPd79XYj">Mermaid Diagrams</a>
- </td>
- <td>Displays diagrams such as bar charts, flow charts, state diagrams, etc.
- Requires a bit of technical knowledge since the diagrams are written in
- a specialized format.</td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_grjYqerjn243">Canvas</a>
- </td>
- <td>Allows easy drawing of sketches, diagrams, handwritten content. Uses the
- same technology behind <a href="https://excalidraw.com">excalidraw.com</a>.</td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_1vHRoWCEjj0L">Web View</a>
- </td>
- <td>Displays the content of an external web page, similar to a browser.</td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_gBbsAeiuUxI5">Mind Map</a>
- </td>
- <td>Easy for brainstorming ideas, by placing them in a hierarchical layout.</td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_81SGnPGMk7Xc">Geo Map</a>
- </td>
- <td>Displays the children of the note as a geographical map, one use-case
- would be to plan vacations. It even has basic support for tracks. Notes
- can also be created from it.</td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_W8vYD3Q1zjCR">File</a>
- </td>
- <td>Represents an uploaded file such as PDFs, images, video or audio files.</td>
- </tr>
- </tbody>
- </table>
-</figure>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/1_File_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/1_File_image.png
deleted file mode 100644
index 498813236b..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/1_File_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/1_Text_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/1_Text_image.png
deleted file mode 100644
index 278d44dbc4..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/1_Text_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/2_File_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/2_File_image.png
deleted file mode 100644
index 3dd5cebb82..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/2_File_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/2_Text_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/2_Text_image.png
deleted file mode 100644
index 8a68dcb5ae..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/2_Text_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/3_File_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/3_File_image.png
deleted file mode 100644
index af5bdfd5b2..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/3_File_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/4_File_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/4_File_image.png
deleted file mode 100644
index 1d50d7a826..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/4_File_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/5_File_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/5_File_image.png
deleted file mode 100644
index 14044ba955..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/5_File_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Canvas.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Canvas.html
deleted file mode 100644
index c082c168f2..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Canvas.html
+++ /dev/null
@@ -1,42 +0,0 @@
-<figure class="image">
- <img src="Canvas_image.png" alt="grafik">
-</figure>
-<p>Canvas notes use the Excalidraw library to allow handwritten notes with
- mouse, pen or touch on an infinite canvas. It also supports basic diagramming,
- text and graphics input.</p>
-<h2>Interaction</h2>
-<ul>
- <li>The note can be togged <a href="#root/_help_CoFPLs3dRlXc">read-only</a> from
- the&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a>.</li>
-</ul>
-<h2>Embedding notes</h2>
-<p>Since v0.104.0, Canvas supports embedding notes in a similar fashion to
- the&nbsp;<a class="reference-link" href="#root/_help_nBAXQFj20hS1">Include Note</a>&nbsp;functionality
- for&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes.</p>
-<p>To embed a note:</p>
-<ul>
- <li>From the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>,
- drag the item onto the canvas.</li>
- <li>Manually, by choosing <em>More tools</em> → <em>Web Embed</em> and pasting
- the link to the note (e.g. <code>root/MujWAc9fQ1nj</code>).</li>
-</ul>
-<p>Embedding notes in the canvas follows the same rules as&nbsp;<a class="reference-link"
- href="#root/_help_nBAXQFj20hS1">Include Note</a>: some notes are rendered
- as images (e.g.&nbsp;<a class="reference-link" href="#root/_help_gBbsAeiuUxI5">Mind Map</a>),
- whereas some render fully interactive such as&nbsp;<a class="reference-link"
- href="#root/_help_GTwFsgaA0lCt">Collections</a>.</p>
-<h2>Linking to a note</h2>
-<ol>
- <li>From the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;right
- click the note to be linked and selected <em>Advanced → Copy note path to the clipboard</em>.</li>
- <li>In the canvas note, right click an element and select <em>Add link</em> (or
- press <kbd>Ctrl</kbd>+<kbd>K</kbd>). Paste the link and press <kbd>Enter</kbd>.</li>
- <li>A&nbsp;<span class="tn-icon bx bx-link-external"></span> icon will appear
- at the top-right of the element which will navigate to the linked note
- when clicked.</li>
-</ol>
-<h2>Drawing in a text note</h2>
-<p>To draw inside a&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;note
- instead of in a note of its own, insert a drawing canvas with <span class="tn-icon bx bx-pen"></span><em>Drawing canvas</em> in
- the <span class="tn-icon cke cke-plus"></span><em>Insert</em> menu. See <em>Drawing canvases</em> in&nbsp;<a
- class="reference-link" href="#root/_help_nBAXQFj20hS1">Include Note</a>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Canvas_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Canvas_image.png
deleted file mode 100644
index 9259c84d59..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Canvas_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Code.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Code.html
deleted file mode 100644
index 158e1022db..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Code.html
+++ /dev/null
@@ -1,131 +0,0 @@
-<p>Trilium supports creating "code" notes, i.e. notes which contain some
- sort of formal code - be it programming language (C++, JavaScript), structured
- data (JSON, XML) or other types of codes (CSS etc.).</p>
-<p>This can be useful for a few things:</p>
-<ul>
- <li>computer programmers can store code snippets as notes with syntax highlighting</li>
- <li>JavaScript code notes can be executed inside Trilium for some extra functionality
- <ul>
- <li>we call such JavaScript code notes "scripts" – see&nbsp;<a class="reference-link"
- href="#root/_help_CdNpE2pqjmI6">Scripting</a>
- </li>
- </ul>
- </li>
- <li>JSON, XML etc. can be used as storage for structured data (typically used
- in conjunction with scripting)</li>
-</ul>
-<p>For shorter snippets of code that can be embedded in&nbsp;<a href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes,
- see&nbsp;<a href="#root/_help_QxEyIjRBizuC">Code blocks</a>.</p>
-<p>
- <img src="Code_image.png">
-</p>
-<h2>Creating a code note</h2>
-<p>In the <a href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>, right-click a
- note and select <em>Insert child note</em> or <em>Insert note after</em>,
- then:</p>
-<ul>
- <li>To create a plain text code note, select <em>Code</em>.</li>
- <li>To create a code note in a given language, hover <em>Code</em> and select
- the language. The list shows the languages enabled in the options (see
- below), and ends with <em>Configure code notes...</em>, which opens them.</li>
-</ul>
-<h2>Adjusting the language of a code note</h2>
-<p>To change the language of a code note, look for the&nbsp;<span class="tn-icon bx bx-code"></span> icon
- in the&nbsp;<a class="reference-link" href="#root/_help_AlJ73vBCjWDw">Status bar</a>.
- When clicked it will reveal the list of available languages (which can
- be customized according to the section below). The menu also features a
- search bar to quickly filter, and icons to visually distinguish some of
- the programming languages.</p>
-<p>On the&nbsp;<a class="reference-link" href="#root/_help_RDslemsQ6gCp">Mobile Frontend</a>,
- the same list is available in the&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a>&nbsp;→ <em>Change language mode</em>.</p>
-<h2>Adjusting the list of languages</h2>
-<p>Trilium supports syntax highlighting for many languages, but by default
- displays only some of them. The supported languages can be adjusted by
- going to&nbsp;<a href="#root/_help_4TIF1oA4VQRO">Options</a>, then <em>Code Notes</em> and
- looking for the <em>Available MIME types in the dropdown</em> section. Simply
- check any of the items to add them to the list, or un-check them to remove
- them from the list.</p>
-<p>Note that the list of languages is not immediately refreshed, you'd have
- to manually <a href="#root/_help_s8alTXmpFR61">refresh the application</a>.</p>
-<p>The list of languages is also shared with the&nbsp;<a href="#root/_help_QxEyIjRBizuC">Code blocks</a>&nbsp;feature
- of&nbsp;<a href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes.</p>
-<h2>Word wrap</h2>
-<p>Long lines can be displayed on multiple lines:</p>
-<ul>
- <li>Globally for all code notes, from&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Code Notes.</em>
- </li>
- <li>For a particular note, by going to the menu in&nbsp;<a class="reference-link"
- href="#root/_help_8YBEPzcpUgxw">Note menu</a>&nbsp;and selecting <em>Word wrap</em> and
- selecting the appropriate option:
- <ul>
- <li><em>Auto</em>, to respect the global word wrap for code notes.</li>
- <li><em>On</em> or <em>Off</em>, to change the state of the word wrap for this
- note regardless of the global option.</li>
- </ul>
- </li>
-</ul>
-<aside class="admonition note">
- <p>Word wrapping can also be adjusted at note level through the <code>#wrapLines</code> <a
- href="#root/_help_HI6GBBIduIgv">label</a>, which can also be inherited.</p>
-</aside>
-<h2>Adjusting options using the status bar</h2>
-<p>The status bar at the bottom of the editor shows the current indentation
- settings and language. Clicking on the indentation indicator opens a menu
- with three sections:</p>
-<ol>
- <li><em>Indent Using</em> — switch between Spaces and Tabs (<code>#indentWithTabs</code>).
- If a per-note override is active, a "Reset to default" option appears.</li>
- <li><em>Display Width</em> — choose from preset widths (1, 2, 3, 4, 6, 8).
- Changes are saved as a per-note <code>#tabWidth</code> label.</li>
- <li><em>Re-indent Content To</em> — convert existing indentation to a different
- style. For example, re-indent a file from 4 spaces to 2 spaces, or from
- spaces to tabs. This rewrites the leading whitespace on every line while
- preserving alignment remainders.</li>
-</ol>
-<p>Clicking the language indicator lets you change the note's MIME type.
- As in the <em>Note type</em> selector, typing narrows the list of languages.</p>
-<h3>Re-indentation</h3>
-<p>When you re-indent content, the editor:</p>
-<ul>
- <li>Measures the visual column width of each line's leading whitespace using
- the current style</li>
- <li>Calculates indent levels and any alignment remainder</li>
- <li>Rebuilds the leading whitespace in the target style</li>
- <li>Preserves non-leading whitespace, blank lines, and content without indentation</li>
-</ul>
-<h2>Color schemes</h2>
-<p>Since Trilium 0.94.0 the colors of code notes can be customized by going&nbsp;<a
- class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→
- Code Notes and looking for the <em>Appearance</em> section.</p>
-<aside class="admonition note">
- <p><strong>Why are there only a few themes whereas the code block themes for text notes have a lot?</strong>
- <br>The reason is that Code notes use a different technology than the one
- used in Text notes, and as such there is a more limited selection of themes.
- If you find a CodeMirror 6 (not 5) theme that you would like to use, let
- us know and we might consider adding it to the set of default themes. There
- is no possibility of adding new themes (at least for now), since the themes
- are defined in JavaScript and not at CSS level.</p>
-</aside>
-<h2>Programming ligatures</h2>
-<p>If you see <code>!=</code> displayed as <code>≠</code> or <code>-&gt;</code> as <code>→</code> inside
- a code note, those are <em>font ligature</em>: the default monospace font
- draws certain character pairs as a single symbol. The underlying text is
- not changed by Trilium (unlike text notes which have&nbsp;<a class="reference-link"
- href="#root/_help_oI7GoyilXXAr">Automatic replacements</a>), and copying
- it out gives you back <code>!=</code> and <code>-&gt;</code>.</p>
-<p>This can be turned off with&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a><em>→ Appearance → Fonts → Programming ligatures</em>.</p>
-<h2>Virtual keyboard behavior</h2>
-<p>When using a virtual keyboard, keyboard suggestions and corrections are
- controlled as follows:</p>
-<ul>
- <li>For&nbsp;<a class="reference-link" href="#root/_help_6RM1Q7ppFVoj">Markdown</a>&nbsp;and
- plain text code notes, the autocorrect is <strong>on</strong>, as well as
- automatic capitalization.</li>
- <li>For all the other code notes, the autocorrect is off in order to avoid
- issues when typing code.</li>
-</ul>
-<aside class="admonition note">
- <p>Not all browsers and platforms respect this value, so the keyboard suggestions
- might appear without autocorrecting or the browser might disregard this
- and autocorrect anyway.</p>
-</aside>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Converting between note types.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Converting between note types.html
deleted file mode 100644
index 21e6cd1dd9..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Converting between note types.html
+++ /dev/null
@@ -1,29 +0,0 @@
-<p>A note's type may be converted to another:</p>
-<ul>
- <li><a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes
- to&nbsp;<a class="reference-link" href="#root/_help_6RM1Q7ppFVoj">Markdown</a>&nbsp;notes</li>
- <li>Markdown notes to Text notes</li>
-</ul>
-<p>Before conversion, a revision is saved automatically, so you can restore
- the original or recover any missing elements from it if the conversion
- produces undesired results. Read more about&nbsp;<a class="reference-link"
- href="#root/_help_vZWERwf8U3nx">Note Revisions</a>.</p>
-<h2>Converting individual notes</h2>
-<h3>Markdown to Text Note</h3>
-<p>Markdown notes can be converted to Text Notes with negligible loss of
- formatting fidelity.</p>
-<p>To do so, go to the&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a> → <em>Advanced</em> and
- select <em>Convert to Text Note</em>.</p>
-<h3>Text Note to Markdown</h3>
-<aside class="admonition warning">
- <p>Since Markdown does not support all the capabilities of Text notes, this
- conversion is lossy in terms of formatting: some formatting may be lost,
- and some unsupported elements may even be dropped. It's strongly recommended
- that you inspect the content for any information that might have gone missing
- after the conversion.</p>
-</aside>
-<p>To convert a text note to Markdown, go to the&nbsp;<a class="reference-link"
- href="#root/_help_8YBEPzcpUgxw">Note menu</a> → <em>Advanced</em> and select <em>Convert to Markdown Note</em>.</p>
-<h2>Converting multiple notes</h2>
-<p>A note type conversion can also be performed on an entire subtree or a
- set of multiple notes using&nbsp;<a class="reference-link" href="#root/_help_ivYnonVFBxbQ">Bulk Actions</a>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/File.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/File.html
deleted file mode 100644
index f3cdbe721f..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/File.html
+++ /dev/null
@@ -1,137 +0,0 @@
-<p>The <em>File</em> note type can be used to attach various external files
- such as images, videos or PDF documents.</p>
-<h2>Uploading a file</h2>
-<p>Since these files come from an external source, it is not possible to
- create a <em>File</em> note type directly:</p>
-<ul>
- <li>Drag a file into the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>.</li>
- <li>Right click a note and select <em>Import into note</em> and point it to
- one of the supported files.</li>
-</ul>
-<h2>Supported file types</h2>
-<h3>PDFs</h3>
-<p>PDFs can be uploaded to Trilium and they will display a live preview with
- full support for various features such as table of contents, annotations,
- as well as remembering the last page read. For more information, see the
- dedicated&nbsp;<a class="reference-link" href="#root/_help_XJGJrpu7F9sh">PDFs</a>&nbsp;page.</p>
-<h2>Office documents</h2>
-<p>Trilium offers previews for Office documents such as Word (<code>.docx</code>),
- Excel (<code>.xlsx</code>) and PowerPoint (<code>.pptx</code>). For more
- information, see the dedicated&nbsp;<a class="reference-link" href="#root/_help_KG48zgNY31NW">Office documents</a>.</p>
-<h3>Images</h3>
-<figure class="image image-style-align-center image_resized" style="width:50%;">
- <img style="aspect-ratio:879/766;" src="2_File_image.png" width="879"
- height="766">
-</figure>
-<p>Interaction:</p>
-<ul>
- <li>An <a href="#root/_help_0Ofbk1aSuVRu">image reference</a> can be copied
- by pressing the&nbsp;<span class="tn-icon bx bx-copy"></span> icon from
- the&nbsp;<a class="reference-link" href="#root/_help_1P8QXI5edXNd">Note buttons</a>&nbsp;area,
- which allows pasting it in a&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;note.</li>
-</ul>
-<h3>Videos</h3>
-<p>See&nbsp;<a class="reference-link" href="#root/_help_AjqEeiDUOzj4">Audio &amp; Video</a>.</p>
-<h3>Audio</h3>
-<figure class="image image-style-align-center image_resized" style="width:50%;">
- <img style="aspect-ratio:850/243;" src="1_File_image.png" width="850"
- height="243">
-</figure>
-<p>Adding a supported audio file will reveal a basic audio player that can
- be used to play it.</p>
-<p>Interactions:</p>
-<ul>
- <li>The audio can be played/paused using the dedicated button.</li>
- <li>Dragging the mouse across, or clicking the progress bar will seek through
- the song.</li>
- <li>The volume can be set.</li>
- <li>The playback speed can be adjusted via the contextual menu next to the
- volume.</li>
-</ul>
-<h3>Text files</h3>
-<figure class="image image-style-align-center image_resized" style="width:50%;">
- <img style="aspect-ratio:926/347;" src="File_image.png" width="926" height="347">
-</figure>
-<p>Files that are identified as containing text will show a preview of their
- content. One common use case for this type of file is to embed text files
- whose content is not necessarily of interest to the user, such as third-party
- libraries or generated content, that can then be downloaded if needed.</p>
-<p>Note that generally text files will be <a href="#root/_help_mHbBMPDPkVV5">imported</a> as
- either&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;or&nbsp;<a
- class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;notes.
- To bypass this behavior and create a <em>File</em> note type, use the <em>Import into note</em> feature
- and uncheck <em>Import HTML, Markdown and TXT as text notes</em>, as well
- as <em>Import recognized code files as code notes</em>.&nbsp;</p>
-<p>Since one of the use cases for having files instead of notes is to display
- large files, the content preview is limited to a relatively small amount
- of characters. To view the full file, consider opening it in an external
- application.</p>
-<h3>GPS tracks</h3>
-<p>Trilium displays information about GPS tracks in <code>.gpx</code> format,
- such as the distance, duration, elevation profile, tracks, markers.</p>
-<p>When a <code>.gpx</code> note is dropped in a&nbsp;<a class="reference-link"
- href="#root/_help_81SGnPGMk7Xc">Geo Map</a>, the track itself will also
- be displayed on the map.</p>
-<figure class="image">
- <img style="aspect-ratio:1500/807;" src="4_File_image.png" width="1500"
- height="807">
-</figure>
-<h3>Fonts</h3>
-<p>Supported font formats will show an interactive preview of the font:</p>
-<ul>
- <li>A field to type in a custom text.</li>
- <li>A slider to change the font size of the preview.</li>
- <li>A preview of the text at the given size.</li>
- <li>A sampling of various font sizes for this font.</li>
- <li>The Latin alphabet.</li>
-</ul>
-<p>Additionally, enabling <em>In font picker</em> will make the font available
- in the&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Appearance</em> font
- selection. See&nbsp;<a class="reference-link" href="#root/_help_w4rMEhJsALlA">Personalizing the font</a>&nbsp;for
- more information.</p>
-<h3>Unknown file types</h3>
-<figure class="image image-style-align-center image_resized" style="width:50%;">
- <img style="aspect-ratio:532/240;" src="3_File_image.png" width="532"
- height="240">
-</figure>
-<p>If the file could not be identified as any of the supported file types
- from above, it will be treated as an unknown file. In this case, all the
- default interactions will be available such as downloading or opening the
- file externally, but there will be no preview of the content.</p>
-<h2>Interaction</h2>
-<ul>
- <li>Regardless of the file type, a series of buttons will be displayed in
- the&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a>&nbsp;area.
- <ul>
- <li><span class="tn-icon bx bx-download"></span>&nbsp;(Download), which will
- download the file for local use.</li>
- <li><span class="tn-icon bx bx-link-external"></span>&nbsp;(Open), will will
- open the file with the system-default application.</li>
- <li><span class="tn-icon bx bx-folder-open"></span>&nbsp;(Upload new revision)
- to replace the file with a new one.</li>
- </ul>
- </li>
- <li>It is <strong>not</strong> possible to change the note type of a <em>File</em> note.</li>
- <li>Convert into an <a href="#root/_help_0vhv7lsOLy82">attachment</a> from the <a
- href="#root/_help_8YBEPzcpUgxw">note menu</a>.</li>
-</ul>
-<h2>Relation with other notes</h2>
-<ul>
- <li>
- <p>Files are also displayed in the&nbsp;<a class="reference-link" href="#root/_help_0ESUbbAxVnoK">Note List</a>&nbsp;based
- on their type:</p>
- <img class="image_resized" style="aspect-ratio:853/315;width:50%;"
- src="5_File_image.png" width="853" height="315">
- </li>
- <li>
- <p>Non-image files can be embedded into text notes as read-only widgets via
- the&nbsp;<a class="reference-link" href="#root/_help_nBAXQFj20hS1">Include Note</a>&nbsp;functionality.</p>
- </li>
- <li>
- <p>Image files can be embedded into text notes like normal images via&nbsp;<a
- class="reference-link" href="#root/_help_0Ofbk1aSuVRu">Image references</a>.</p>
- </li>
-</ul>
-<h2>File size limit</h2>
-<p>An individual file cannot be bigger than 374 MiB. For more information
- see <em>Maximum import size</em> in&nbsp;<a class="reference-link" href="#root/_help_mHbBMPDPkVV5">Import &amp; Export</a>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/File/1_Audio & Video_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/File/1_Audio & Video_image.png
deleted file mode 100644
index 5ad8fe36b5..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/File/1_Audio & Video_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/File/1_PDFs_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/File/1_PDFs_image.png
deleted file mode 100644
index 36e4fd6d82..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/File/1_PDFs_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/File/Audio & Video.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/File/Audio & Video.html
deleted file mode 100644
index b55bcdca14..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/File/Audio & Video.html
+++ /dev/null
@@ -1,164 +0,0 @@
-<figure class="image image-style-align-right image_resized" style="width:61.8%;">
- <img style="aspect-ratio:953/587;" src="Audio & Video_image.png" width="953"
- height="587">
-</figure>
-<p>Starting with v0.103.0, Trilium has a custom media player for both video
- and audio files, which offers more features than the built-in player.</p>
-<p>Versions prior to v0.103.0 also support media, but using the built-in
- player.</p>
-<p>The file is streamed directly, so when accessing the note from a server
- it doesn't have to download the entire file to start playing it.</p>
-<h2>Note on large media files</h2>
-<p>Although Trilium offers support for media files, it is generally not meant
- to be used with very large files. Uploading large media will cause the&nbsp;<a
- class="reference-link" href="#root/_help_wX4HbRucYSDD">Database</a>&nbsp;to
- balloon, as well as any&nbsp;<a class="reference-link" href="#root/_help_ODY7qQn5m2FT">Backup</a>&nbsp;of
- it. In addition, there might be slowdowns when first uploading the files.
- Otherwise, a large database should not impact the general performance of
- Trilium significantly.</p>
-<h2>Supported formats</h2>
-<p>Trilium uses the built-in media decoding mechanism of the browser (or
- Electron/Chromium when running on the desktop). Starting with v0.103.0,
- a message will be displayed instead when a media format is not supported.</p>
-<h2>Interactions</h2>
-<p>To play/pause, simply click anywhere on the media. For video files, the
- controls at the bottom will hide automatically after playing, simply move
- the mouse to show them again.</p>
-<p>The bottom bar has the following features:</p>
-<ul>
- <li>A track bar to seek across the media. Audio files up to 60 MB will display
- a waveform seekbar, to give a visual overview of the track's structure:
- silences, pauses, and louder segments.</li>
- <li>On the left of the track bar, the current time is indicated.</li>
- <li>On the right of the track bar, the remaining time is indicated.</li>
- <li>On the left side there are buttons to:
- <ul>
- <li>Adjust the playback speed (e.g. 0.5x, 1x).</li>
- <li>Play mode (applies to all media from the parent note):
- <ul>
- <li>Play once — play the media until it ends, then stop.</li>
- <li>Loop — replay the media automatically once it ends.</li>
- <li>Play next — when the current item ends, continue with the next one in
- the same parent note until the last item finishes.</li>
- </ul>
- </li>
- <li>Rotate the video by 90 degrees (video only).</li>
- </ul>
- </li>
- <li>In the center:
- <ul>
- <li>Previous media — jumps to the previous media: the nearest media note above
- the current one in the tree (within the same parent note) in the case of
- media notes, or the previous media attachment.</li>
- <li>Go back by 10s</li>
- <li>Play/pause</li>
- <li>Go forward by 10s</li>
- <li>Next media — jumps to the next media: the nearest media note below the
- current one in the tree (within the same parent note) in the case of media
- notes, or the next media attachment.</li>
- </ul>
- </li>
- <li>On the right side:
- <ul>
- <li>Mute button</li>
- <li>Volume adjustment</li>
- <li>Full screen (video only)</li>
- <li>Zoom to fill, which will crop the video so that it fills the entire window
- (video only).</li>
- <li>Picture-in-picture, if the browser supports it (video only).</li>
- </ul>
- </li>
-</ul>
-<h2>Including media in notes</h2>
-<figure class="image">
- <img style="aspect-ratio:1395/145;" src="1_Audio & Video_image.png" width="1395"
- height="145">
- <figcaption>An audio note include (configured to the "Small" size).</figcaption>
-</figure>
-<p><a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;and&nbsp;<a
- class="reference-link" href="#root/_help_6RM1Q7ppFVoj">Markdown</a>&nbsp;notes
- can embed an interactive media player directly in the note content. To
- do so, include the audio or video file:</p>
-<ul>
- <li><strong>Text notes:</strong> in the formatting toolbar, click <em>Insert</em> → <em>Include</em>.</li>
- <li><strong>Markdown notes:</strong> type <code>/include</code> press <kbd>Enter</kbd>.</li>
-</ul>
-<p>Then select the audio/video file note to be included.</p>
-<h2>Keyboard shortcuts</h2>
-<p>The following keyboard shortcuts are supported by the media player:</p>
-<figure
-class="table">
- <table>
- <tbody>
- <tr>
- <td><kbd>Space</kbd>
- </td>
- <td>Play/pause</td>
- </tr>
- <tr>
- <td><kbd>Left arrow key</kbd>
- </td>
- <td>Go back by 10s</td>
- </tr>
- <tr>
- <td><kbd>Right arrow key</kbd>
- </td>
- <td>Go forward by 10s</td>
- </tr>
- <tr>
- <td><kbd>Ctrl</kbd> + <kbd>Left arrow key</kbd>
- </td>
- <td>Go back by 1 min</td>
- </tr>
- <tr>
- <td><kbd>Ctrl</kbd> + <kbd>Right arrow key</kbd>
- </td>
- <td>Go right by 1 min</td>
- </tr>
- <tr>
- <td><kbd>Page Up</kbd>
- </td>
- <td>Navigate to the previous media</td>
- </tr>
- <tr>
- <td><kbd>Page Down</kbd>
- </td>
- <td>Navigate to the next media</td>
- </tr>
- <tr>
- <td><kbd>F</kbd>
- </td>
- <td>Toggle full-screen</td>
- </tr>
- <tr>
- <td><kbd>M</kbd>
- </td>
- <td>Mute/unmute</td>
- </tr>
- <tr>
- <td><kbd>Home</kbd>
- </td>
- <td>Go to the beginning of the media</td>
- </tr>
- <tr>
- <td><kbd>End</kbd>
- </td>
- <td>Go to the end of the media</td>
- </tr>
- <tr>
- <td><kbd>Up</kbd>
- </td>
- <td>Increase volume by 5%</td>
- </tr>
- <tr>
- <td><kbd>Down</kbd>
- </td>
- <td>Decrease volume by 5%</td>
- </tr>
- <tr>
- <td><kbd>Alt+F1</kbd> (customizable)</td>
- <td>Show this list of keyboard shortcuts on screen.</td>
- </tr>
- </tbody>
- </table>
-</figure>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/File/Audio & Video_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/File/Audio & Video_image.png
deleted file mode 100644
index 29cfb5da79..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/File/Audio & Video_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/File/Office documents.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/File/Office documents.html
deleted file mode 100644
index 89163e6602..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/File/Office documents.html
+++ /dev/null
@@ -1,61 +0,0 @@
-<p>Since v0.105.0, office documents stored in Trilium display an inline preview
- of their content, without the need to download them or open them in an
- external application.</p>
-<h2>Supported formats</h2>
-<ul>
- <li>Microsoft Office formats: Word (<code>.docx</code>), Excel (<code>.xlsx</code>)
- and PowerPoint (<code>.pptx</code>).</li>
- <li>The OpenDocument alternatives to the previous formats (Text, Spreadsheet,
- Presentation), created by editors such as LibreOffice and OpenOffice.</li>
- <li><a href="https://en.wikipedia.org/wiki/Rich_Text_Format">Rich Text Format (RTF)</a>.</li>
- <li><a href="https://en.wikipedia.org/wiki/EPUB">EPUB</a> e-books.</li>
-</ul>
-<aside class="admonition note">
- <p>Older Microsoft Office formats (<code>.doc</code>, <code>.xls</code>, <code>.ppt</code>)
- are not supported.</p>
-</aside>
-<h2>How it works</h2>
-<p>The document is converted to a simplified representation on the server
- and rendered as read-only content, similar to a&nbsp;<a class="reference-link"
- href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;note.</p>
-<p>The preview generally preserves:</p>
-<ul>
- <li>Headings, paragraphs and text alignment.</li>
- <li>Text formatting: bold, italic, underline, strikethrough, subscript/superscript,
- text and highlight colors, fonts and font sizes.</li>
- <li>Bulleted and numbered lists.</li>
- <li>Tables, including merged cells and cell background colors.</li>
- <li>Embedded images.</li>
- <li>Links and footnotes.</li>
-</ul>
-<p>To keep links readable regardless of the theme, the default hyperlink
- color applied automatically by word processors is ignored; links that were
- deliberately given a custom color by the author keep it.</p>
-<h2>Limitations</h2>
-<ul>
- <li>The preview is read-only. To edit the document, download it or open it
- in an external application; the content of the note is not affected by
- the preview. Alternatively copy and paste it into a text note.</li>
- <li>The preview is a simplified rendering: complex layouts (columns, text
- boxes, headers and footers), charts and the precise styling of table borders
- are not reproduced.</li>
- <li>Documents larger than 20 MB are not previewed, to keep the server responsive.
- The usual download and open actions remain available.</li>
- <li>If the document cannot be converted, a notice is displayed instead and
- the file can still be downloaded or opened externally.</li>
-</ul>
-<h2>Relation with other features</h2>
-<ul>
- <li>The same preview is used when an office document is displayed in the&nbsp;<a
- class="reference-link" href="#root/_help_0ESUbbAxVnoK">Note List</a>&nbsp;or
- embedded in a text note via&nbsp;<a class="reference-link" href="#root/_help_nBAXQFj20hS1">Include Note</a>,
- as well as for office documents stored as&nbsp;<a class="reference-link"
- href="#root/_help_0vhv7lsOLy82">Attachments</a>.</li>
- <li>Independently of the preview, the text content of office documents is
- also extracted in the background so that it can be found with&nbsp;<a class="reference-link"
- href="#root/_help_eIg8jdvaoNNd">Search</a>&nbsp;via&nbsp;<a class="reference-link"
- href="#root/_help_TiQbQDgP8L5t">Text Extraction (OCR)</a>.</li>
- <li><code>.csv</code> and <code>.xlsx</code> files can be converted to&nbsp;<a
- class="reference-link" href="#root/_help_GWHEkY4I4OE3">Spreadsheets</a>&nbsp;via
- the <a href="#root/_help_mHbBMPDPkVV5">import</a> function.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/File/PDFs.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/File/PDFs.html
deleted file mode 100644
index 2bf193fa99..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/File/PDFs.html
+++ /dev/null
@@ -1,132 +0,0 @@
-<figure class="image image_resized" style="width:74.34%;">
- <img style="aspect-ratio:1360/698;" src="PDFs_image.png" width="1360"
- height="698">
-</figure>
-<p>PDFs file can be uploaded in Trilium, where they will be displayed without
- the need to download them first.</p>
-<p>Since v0.102.0, PDFs will be rendered using Trilium's built-in PDF viewer,
- which is a customization of <a href="https://mozilla.github.io/pdf.js/">Mozilla's PDF.js viewer</a> (also
- built-in in the Mozilla Firefox browser). Versions prior to that render
- PDFs using the browser's default PDF viewer.</p>
-<h2>Features</h2>
-<ul>
- <li>The last page viewed and scroll position is maintained in between restarts
- or note navigations.</li>
- <li>Annotations (text, highlights) as well as comments. These are saved automatically.</li>
- <li>Forms can be filled.</li>
- <li>Can be printed or downloaded.</li>
- <li>Can be saved as a <a href="#root/_help_KC1HB96bqqHX">template</a> and the
- content of the PDF will be copied over to the new note. This is especially
- useful in combination with annotations or filled forms.</li>
- <li>Integrates with the&nbsp;<a class="reference-link" href="#root/_help_RnaPdbciOfeq">Right Sidebar</a>&nbsp;by
- displaying the list of pages with thumbnails, table of contents and a listing
- of the annotations.</li>
- <li>Basic support for signatures (the hand-drawn ones, not proper digital
- signatures), similar to annotations. Signatures are stored and can be reused
- across multiple documents (up to 5).</li>
-</ul>
-<h2>Storing last position and settings</h2>
-<p>For every PDF, Trilium will remember the following information:</p>
-<ul>
- <li>The current page.</li>
- <li>The scroll position, within the current page.</li>
- <li>The rotation of the page.</li>
-</ul>
-<p>This makes it useful when reading large documents since the position is
- remembered automatically. This happens in the background, however it's
- recorded only a few seconds after stopping any scroll actions.</p>
-<aside
-class="admonition tip">
- <p>Technically, the information about the scroll position and rotation is
- stored in the&nbsp;<a class="reference-link" href="#root/_help_0vhv7lsOLy82">Attachments</a>&nbsp;section,
- in a dedicated attachment called <code>pdfHistory.json</code>.</p>
-</aside>
-<h2>Annotations</h2>
-<p>Since v0.102.0 it's possible to annotate PDFs. To do so, look for the
- annotation buttons on the right side of the PDF toolbar (
- <img src="1_PDFs_image.png"
- width="120" height="32">).</p>
-<p>Since v0.103.0:</p>
-<ul>
- <li>Annotations are disabled if the note is marked as&nbsp;<a class="reference-link"
- href="#root/_help_CoFPLs3dRlXc">Read-Only Notes</a>.</li>
- <li>Comments can also be added, which is similar to highlights but also attach
- a text.</li>
- <li>The&nbsp;<a class="reference-link" href="#root/_help_RnaPdbciOfeq">Right Sidebar</a>&nbsp;also
- displays a list of annotations (highlights, comments).</li>
-</ul>
-<h3>Supported annotations</h3>
-<p>The following annotation methods are supported:</p>
-<ul>
- <li><strong>Highlight</strong>
- <br>Allows highlighting text with one of the predefined colors.
- <ul>
- <li>The thickness is also adjustable.</li>
- <li>It's also possible to highlight the blank space, turning the feature more
- into a thicker pen.</li>
- </ul>
- </li>
- <li><strong>Text</strong>
- <br>Allows adding arbitrary text, with a custom color and size.</li>
- <li><strong>Pen</strong>
- <br>Allows free drawing on the document, with variable color, thickness and
- opacity.</li>
- <li><strong>Image</strong>
- <br>Allows inserting images from outside Trilium directly into the document.</li>
-</ul>
-<h3>Editing existing annotations</h3>
-<p>Although annotations are stored in the PDF itself, they can be edited.
- To edit an annotation, press one of the annotation buttons from the previous
- section to enter edit mode and click on an existing annotation. This will
- reveal a toolbar with options to customize the annotation (e.g. to change
- a color), as well as the possibility to remove it.</p>
-<h3>How are annotations stored</h3>
-<p>Annotations are stored directly in the PDF. When modifications are made,
- Trilium will replace the PDF with the new one.</p>
-<p>Since modifications are automatically saved, there's no need to manually
- save the document after making modifications to the annotations.</p>
-<p>The benefit of “baked-in annotations” is that they are also accessible
- if downloading (for external use outside Trilium) or sharing the note.</p>
-<p>The downside is that the entire PDF needs to be sent back to the server,
- which can slow down performance for larger documents. If you encounter
- any issues from this system, feel free to <a href="#root/_help_wy8So3yZZlH9">report it</a>.</p>
-<h2>Linking to a page or an annotation</h2>
-<p>A link can open a PDF at a given page, or at one of its annotations. To
- create one:</p>
-<ul>
- <li>To link to a page, right-click the page in the <em>Pages</em> section of
- the&nbsp;<a class="reference-link" href="#root/_help_RnaPdbciOfeq">Right Sidebar</a>&nbsp;and
- select <em>Copy reference</em>.</li>
- <li>To link to an annotation, right-click it in the <em>Annotations</em> section
- of the sidebar and select <em>Copy reference</em>.</li>
-</ul>
-<p>Pasted into a text note, the reference becomes one of the&nbsp;<a class="reference-link"
- href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a>, showing
- the title of the PDF followed by the page (<em>Page 5</em>), or by <em>Annotation on page 5</em> for
- a reference to an annotation. Clicking it opens the PDF and scrolls to
- the page or to the annotation.</p>
-<p>A reference to an annotation also carries its page, so a link to an annotation
- that was deleted still opens the right page.</p>
-<aside class="admonition note">
- <p>An annotation drawn since the PDF was opened does not have a permanent
- identifier until the PDF is opened again, so a reference copied for it
- points at its page only.</p>
-</aside>
-<h2>Filling out forms</h2>
-<p>Similar to annotations, forms are also supported by Trilium since v0.102.0.
- If the document has fields that can be filled-in, they will be indicated
- with a colored background.</p>
-<p>Simply type text in the forms and they will be automatically saved.</p>
-<h2>Sidebar navigation</h2>
-<p>See the dedicated section on PDFs in&nbsp;<a class="reference-link" href="#root/_help_2dcGDhp9WFKb">Outline tab</a>.</p>
-<h2>Share functionality</h2>
-<p>PDFs can also be shared using the&nbsp;<a class="reference-link" href="#root/_help_R9pX4DGra2Vt">Sharing</a>&nbsp;feature.
- This will also use Trilium's customized PDF viewer.</p>
-<p>If you are using a reverse proxy on your server with strict access limitations
- for the share functionality, make sure that <code>[host].com/pdfjs</code> directory
- is accessible. Note that this directory is outside the <code>/share</code> route
- as it's common with the rest of the application.</p>
-<h2>OCR</h2>
-<p>PDFs are eligible for&nbsp;<a class="reference-link" href="#root/_help_TiQbQDgP8L5t">Text Extraction (OCR)</a>,
- which means that their text can be used in&nbsp;<a class="reference-link"
- href="#root/_help_eIg8jdvaoNNd">Search</a>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/File/PDFs_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/File/PDFs_image.png
deleted file mode 100644
index cf8d2c109b..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/File/PDFs_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/File_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/File_image.png
deleted file mode 100644
index 04478a3ada..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/File_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Markdown.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Markdown.html
deleted file mode 100644
index 8dc4f00e05..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Markdown.html
+++ /dev/null
@@ -1,323 +0,0 @@
-<p>Trilium has always supported Markdown through its <a href="#root/_help_Oau6X9rCuegd">import feature</a>,
- however the file was either transformed to a&nbsp;<a class="reference-link"
- href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;note (converted to Trilium's
- internal HTML format) or saved as a&nbsp;<a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;note
- with only syntax highlight.</p>
-<p>This note type is a split view, meaning that both the source code and
- a preview of the document are displayed side-by-side. See&nbsp;<a class="reference-link"
- href="#root/_help_SL5f1Auq7sVN">Note types with split view</a>&nbsp;for
- more information.</p>
-<h2>Rationale</h2>
-<p>The goal of this note type is to fill a gap: rendering Markdown but not
- altering its structure or its whitespace which would inevitably change
- otherwise through import/export.</p>
-<p>Even if Markdown is now specially treated by having a preview mechanism,
- Trilium remains at its core a WYSWYG editor so Markdown will not replace
- text notes.</p>
-<aside class="admonition note">
- <p>Feature requests regarding the Markdown implementation will be considered,
- but if they are outside the realm of Trilium, they will not be implemented.
- One of the core aspects of the Markdown integration is that it reuses components
- that are already available through other features of the application.</p>
-</aside>
-<h2>Features</h2>
-<h3>Source view pane</h3>
-<ul>
- <li>Syntax highlighting for the Markdown syntax.</li>
- <li>Nested syntax highlighting for code inside code blocks.</li>
- <li>When editing larger documents, the preview scrolls along with the source
- editor.</li>
-</ul>
-<h3>Preview pane</h3>
-<p>The following features are supported by Trilium's Markdown format and
- will show up in the preview pane:</p>
-<ul>
- <li>
- <p>All standard and GitHub-flavored syntax (basic formatting, tables, blockquotes).</p>
- </li>
- <li>
- <p>Basic HTML is also supported (e.g. collapsible blocks using <code>&lt;details&gt;</code> and <code>&lt;summary&gt;</code>).</p>
- </li>
- <li>
- <p>Code blocks with syntax highlight.</p>
- <ul>
- <li>The language must be specified for syntax highlight to be applied (e.g. <code>```js</code>).</li>
- <li>Code blocks will respect the text wrapping from the&nbsp;<a class="reference-link"
- href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;section in&nbsp;<a class="reference-link"
- href="#root/_help_4TIF1oA4VQRO">Options</a>.</li>
- </ul>
- </li>
- <li>
- <p><a class="reference-link" href="#root/_help_NwBbFdNZ9h7O">Block quotes &amp; admonitions</a>
- </p>
- </li>
- <li>
- <p><a class="reference-link" href="#root/_help_YfYAtQBcfo5V">Math Equations</a>&nbsp;(both
- inline and block)</p>
- </li>
- <li>
- <p><a class="reference-link" href="#root/_help_s1aBHPd79XYj">Mermaid Diagrams</a>&nbsp;using <code>```mermaid</code>
- </p>
- </li>
- <li>
- <p><a class="reference-link" href="#root/_help_nBAXQFj20hS1">Include Note</a>&nbsp;(no
- built-in Markdown syntax, but HTML syntax works just fine):</p><pre><code class="language-text-html">&lt;figure class="include-note" data-note-id="vJDjQm0VK8Na" data-box-size="expandable"&gt;
- &lt;figcaption&gt;An optional caption, with &lt;strong&gt;HTML&lt;/strong&gt; formatting&lt;/figcaption&gt;
-&lt;/figure&gt;</code></pre>
- <ul>
- <li>The caption is optional. Markdown is not processed inside the HTML block,
- so format the caption with HTML tags.</li>
- <li>Includes written as <code>&lt;section class="include-note"&gt;</code>,
- the syntax of earlier versions, still work.</li>
- <li>These can also be quickly created via the <code>/include</code> command
- or via a dedicated keyboard shortcut (not assigned by default).</li>
- </ul>
- </li>
- <li>
- <p><a class="reference-link" href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a>&nbsp;via
- its HTML syntax, or through a <em>Wikilinks</em>-like format (only&nbsp;<a
- class="reference-link" href="#root/_help_m1lbrzyKDaRB">Note ID</a>):</p><pre><code class="language-text-x-trilium-auto">[[Hg8TS5ZOxti6]]</code></pre>
- </li>
- <li>
- <p>To-do lists with extended task states:</p>
- <figure class="table">
- <table class="ck-table-resized" style="border-style:none;">
- <colgroup>
- <col style="width:80.6%;">
- <col style="width:19.4%;">
- </colgroup>
- <tbody>
- <tr>
- <td><pre><code class="language-text-x-markdown">- [ ] None
-- [/] Doing
-- [X] Done
-- [?] Maybe
-- [-] Cancelled</code></pre>
- </td>
- <td>
- <figure class="image image-style-align-right">
- <img style="aspect-ratio:218/221;" src="Markdown_image.png" width="218"
- height="221">
- </figure>
- </td>
- </tr>
- </tbody>
- </table>
- </figure>
- <p>Task states are customizable: you can reorder them, create new ones with
- different colors and symbols, or delete the ones you don't need. See&nbsp;<a
- class="reference-link" href="#root/_help_i16PM6A7GXdU">Customizing to-do task states</a>&nbsp;for
- more details.</p>
- <p>Note that to-do items with task states other than "None" and "Done" are
- Trilium-specific and may not work well with other Markdown software.</p>
- </li>
- <li>
- <p><a class="reference-link" href="#root/_help_AgjCISero73a">Footnotes</a>&nbsp;are
- also supported via the corresponding Markdown syntax:</p><pre><code class="language-text-x-trilium-auto">This is [^1], while this is [^2].
-
-[^1]: the first footnote
-[^2]: the second footnote</code></pre>
- <ul>
- <li>These can also be quickly created using the <code>/footnote</code> command.</li>
- </ul>
- </li>
- <li>
- <p>Page breaks for&nbsp;<a class="reference-link" href="#root/_help_NRnIZmSMc5sj">Printing &amp; Exporting as PDF</a>:</p><pre><code class="language-text-x-trilium-auto">&lt;div class="page-break"&gt;&lt;/div&gt;</code></pre>
- </li>
- <li>
- <p>Highlights (background color) are supported both via the <code>==</code> Markdown
- syntax, as well as the canonical HTML representation in Trilium:</p><pre><code class="language-text-x-trilium-auto">==highlighted==
-&lt;span style="background-color:#e5e64d;--tn-background:#e5e64d;"&gt;Highlighted&lt;/span&gt;</code></pre>
- </li>
-</ul>
-<h3>Links</h3>
-<p>Multiple types of links are supported:</p>
-<ul>
- <li>
- <p>Web URLs can be written with the standard Markdown syntax:</p><pre><code class="language-text-x-trilium-auto">[Wikipedia](https://www.wikipedia.org)</code></pre>
- </li>
- <li>
- <p><a href="#root/_help_hrZ1D00cLbal">Reference link</a> to other notes with
- dynamic title, either by manually entering the note ID or via the <em>Add link</em> dialog:</p><pre><code class="language-text-x-trilium-auto">[[B9oMG6rFvvfq]]</code></pre>
- </li>
- <li>
- <p><a href="#root/_help_hrZ1D00cLbal">Reference link</a> to other notes with
- a custom text:</p><pre><code class="language-text-x-trilium-auto">[This is a link](#root/LhtnZxtVsUMp)</code></pre>
- </li>
-</ul>
-<p>To create a link, either:</p>
-<ul>
- <li>Type it manually using the syntax described above.</li>
- <li>Use the <em>Add link</em> dialog by pressing <kbd>Ctrl</kbd>+<kbd>L</kbd> or
- typing the <code>/link</code> command.</li>
-</ul>
-<p><a class="reference-link" href="#root/_help_UmgZAfcltxkS">Link Previews</a>&nbsp;are
- also rendered, but there is no mechanism to insert them automatically as
- of now, they have to be copied from a&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;note
- instead.</p>
-<h3>Keyboard shortcuts</h3>
-<p>The Markdown notes share some of the keyboard shortcuts from&nbsp;<a class="reference-link"
- href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes:</p>
-<ul>
- <li><em>Cut to note</em> (<kbd>Ctrl</kbd>+<kbd>X</kbd>) which cuts the selection
- into a new child note.</li>
- <li><em>Add link</em> (<kbd>Ctrl</kbd>+<kbd>L</kbd>) which shows the dialog
- to create external or reference links.</li>
- <li><em>Date/time</em> (<kbd>Alt</kbd>+<kbd>T</kbd>) which respects the same
- formatting as text notes.</li>
- <li><em>Include note</em> (not assigned by default), which triggers the same
- dialog to insert notes as the one for text notes.</li>
-</ul>
-<p>In addition, the following formatting keyboard shortcuts are available:</p>
-<ul>
- <li><kbd>Ctrl</kbd>+<kbd>B</kbd> to toggle <strong>bold</strong>.</li>
- <li><kbd>Ctrl</kbd>+<kbd>I</kbd> to toggle <em>italic</em>.</li>
- <li><kbd>Ctrl</kbd>+<kbd>M</kbd> to wrap the current selection in an inline
- math (<code>$</code>).</li>
- <li><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>X</kbd> to toggle <del>strikethrough</del>.</li>
-</ul>
-<h3>Images &amp; attachments</h3>
-<p>Images can be inserted into the document in four different methods:</p>
-<ul>
- <li>Drag &amp; drop directly into the editor area.</li>
- <li>Pasting an image from clipboard.</li>
- <li>Pasting a reference to another <a href="#root/_help_0vhv7lsOLy82">attachment</a> (e.g. <em>Copy reference to clipboard</em> button).</li>
- <li>Use the <code>/image</code> slash command.</li>
-</ul>
-<p>An image reference to an attachment looks like this:</p><pre><code class="language-text-x-trilium-auto">![Name.jpeg](api/attachments/z50RceuHXe9J/image/image)</code></pre>
-<h3>Auto-completion</h3>
-<h4>Slash commands</h4>
-<p>Just like&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes,
- Markdown notes support a selection of slash commands:</p>
-<ul>
- <li>Inserting the current date &amp; time (<code>/date</code>).</li>
- <li><a href="#root/_help_nBAXQFj20hS1">Including</a> another note (<code>/include</code>).</li>
- <li>Uploading and inserting an image (<code>/image</code>).</li>
- <li>Inserting a note link (<code>/link</code>).</li>
- <li>Inserting a math equation block (<code>/math</code>).</li>
- <li>Inserting a <a href="#root/_help_AgjCISero73a">footnote</a> (<code>/footnote</code>).</li>
- <li>Inserting a <a href="#root/_help_s1aBHPd79XYj">Mermaid</a> diagram (<code>/mermaid</code>),
- with one variant per sample template (e.g. <code>/mermaid:flowchart</code>).</li>
- <li>Inserting a collapsible block (<code>/collapsible</code>).</li>
- <li>Inserting <a href="#root/_help_rJ9grSgoExl9">tabs</a> (<code>/tabs</code>).</li>
- <li>Inserting a page break for printing (<code>/page-break</code>).</li>
- <li>Inserting a table (<code>/table</code>).</li>
- <li>Creating admonitions (e.g. <code>/tip</code>, <code>/note</code>, <code>/important</code>, <code>/caution</code>, <code>/warning</code>).</li>
- <li>Inserting task items (<code>/todo:&lt;state&gt;</code>, e.g. <code>/todo:done</code>),
- one per configured task state.</li>
- <li>Inserting code snippets (<code>/snippet:&lt;name&gt;</code>) from your
- Markdown/plain-text snippet notes.</li>
-</ul>
-<p>The list shows each command by its title, as in Text notes. Typing a command's
- title, its keyword (as listed above) or a related word such as <code>latex</code> or <code>grid</code> finds
- it.</p>
-<p>Note that slash commands only work outside of code blocks and inline code.</p>
-<h4>Linking notes with <code>@</code> or <code>[[</code></h4>
-<p>As in&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes,
- typing <code>@</code> at the start of a line or after a space opens the note
- search. Picking a note replaces what was typed with a link to it in the
- Wikilinks-like format (<code>[[noteId]]</code>), which the preview shows
- as an&nbsp;<a class="reference-link" href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a>&nbsp;with
- the note's title.</p>
-<p>The search runs on everything typed after the <code>@</code>, spaces included,
- so a title such as <code>@My meeting notes</code> can be typed out; press <kbd>Esc</kbd> to
- close the list and go on writing. If no note fits, the list offers to create
- one, as a child of the Markdown note or in the inbox; the link is inserted
- once the note is created.</p>
-<p>You can also start typing the link directly: <code>[[</code> opens the same
- list, and closing the brackets yourself dismisses it. To change where an
- existing link points, place the cursor inside it and pick another note.</p>
-<p>Like slash commands, <code>@</code> and <code>[[</code> do nothing inside
- code blocks and inline code.</p>
-<p>In the editor, a <code>[[noteId]]</code> link shows as the note's icon and
- title, so you can tell which note it points to without looking up its ID.
- Clicking it, or moving the cursor next to it, shows the link as written
- so it can be edited. Links inside code blocks and inline code are left
- as they are.</p>
-<h4>Code block language auto-completion</h4>
-<p>Starting with v0.104.0, typing ``` to insert a code block will automatically
- open a list of suggested language types which have syntax highlighting.</p>
-<p>The list of languages matches the one for&nbsp;<a class="reference-link"
- href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;notes set in&nbsp;<a class="reference-link"
- href="#root/_help_4TIF1oA4VQRO">Options</a>, it's not the full list of
- languages supported by Trilium.</p>
-<h3>Other features</h3>
-<ul>
- <li>The&nbsp;<a class="reference-link" href="#root/_help_BFvAtE74rbP6">Table of contents</a>&nbsp;will
- be displayed in the&nbsp;<a class="reference-link" href="#root/_help_RnaPdbciOfeq">Right Sidebar</a>&nbsp;based
- on the Markdown-level headings.</li>
-</ul>
-<h3>Shared notes</h3>
-<p>When a Markdown note is <a href="#root/_help_R9pX4DGra2Vt">shared publicly</a>,
- it will be rendered with extended formatting just like&nbsp;<a class="reference-link"
- href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes.</p>
-<p>Most of the features described previously should be supported. If you
- face any issues, feel free to <a href="#root/_help_wy8So3yZZlH9">report it</a> alongside
- a sample Markdown file.</p>
-<h2>Creating Markdown notes</h2>
-<p>There are two ways to create a Markdown note:</p>
-<ol>
- <li>Create a new note (e.g. in the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>)
- and select the type <em>Markdown</em>, just like all the other note types.</li>
- <li>Create a note of type&nbsp;<a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;and
- select as the language either <em>Markdown</em> or <em>GitHub-Flavored Markdown</em>.
- This maintains compatibility with your existing notes prior to the introduction
- of this feature.</li>
-</ol>
-<aside class="admonition note">
- <p>There is no distinction between the new Markdown note type and code notes
- of type Markdown; internally both are represented as&nbsp;<a class="reference-link"
- href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;notes with one of the following
- MIME types:</p>
- <ul>
- <li><code>text/markdown</code>
- </li>
- <li><code>text/x-markdown</code>
- </li>
- <li><code>text/x-gfm</code> (GitHub Flavored Markdown)</li>
- </ul>
-</aside>
-<h2>Import/export</h2>
-<h3>Import</h3>
-<p>By default, when importing a single Markdown file it automatically gets
- converted to a&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;note.
- To avoid that and have it imported as a Markdown note instead:</p>
-<ul>
- <li>Right click the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;and
- select <em>Import into note</em>.</li>
- <li>Select the file normally.</li>
- <li>Uncheck <em>Import HTML, Markdown and TXT as text notes if it's unclear from the metadata</em>.</li>
-</ul>
-<p>When importing a Trilium ZIP, it will preserve the Markdown type without
- converting to text notes thanks to the meta-information in it.</p>
-<h3>Exporting</h3>
-<p>When exporting Markdown files, the extension is preserved and the content
- remains the same as in the source view (with some small exceptions such
- as handling of attachments).</p>
-<p>When exporting Markdown files as ZIP, choosing HTML or Markdown as the
- export format makes no difference as that only affects&nbsp;<a class="reference-link"
- href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes.</p>
-<p>If the Markdown note contains attachments, a ZIP export will rewrite the
- links to attachments so that they are replaced with a relative path to
- the attachment. On import, the links are re-written back.</p>
-<h2>Conversion between text notes and Markdown notes</h2>
-<p><a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes
- can be converted into Markdown notes and vice versa. See&nbsp;<a class="reference-link"
- href="#root/_help_jludwdW7N4hg">Converting between note types</a>.</p>
-<h2>Sync-scrolling &amp; block highlight</h2>
-<p>When scrolling through the editing pane, the preview pane will attempt
- to synchronize its position to make it easier to see the preview.</p>
-<p>In addition, the block in the preview matching the position of the cursor
- in the source view will appear slightly highlighted.</p>
-<p>The sync is currently one-way only, scrolling the preview will not synchronize
- the position of the editor.</p>
-<p>This feature cannot be disabled as of now; if the scrolling feels distracting,
- consider temporarily switching to the editor mode and then switching to
- preview mode when ready.</p>
-<aside class="admonition note">
- <p>This feature of synchronizing the scroll is based on blocks but it's provided
- on a best-effort basis since our underlying Markdown library doesn't support
- this feature natively, so we had to implement our own algorithm. Feel free
- to <a href="#root/_help_wy8So3yZZlH9">report issues</a>, but always provide
- a sample Markdown file to be able to reproduce it.</p>
-</aside>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Markdown_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Markdown_image.png
deleted file mode 100644
index 60c9dd2ade..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Markdown_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Mermaid Diagrams.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Mermaid Diagrams.html
deleted file mode 100644
index 9dd10682d8..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Mermaid Diagrams.html
+++ /dev/null
@@ -1,101 +0,0 @@
-<aside class="admonition tip">
- <p>For a quick understanding of the Mermaid syntax, see&nbsp;<a class="reference-link"
- href="#root/_help_WWgeUaBb7UfC">Syntax reference</a>&nbsp;(official documentation).</p>
-</aside>
-<figure class="image">
- <img style="aspect-ratio:1464/915;" src="Mermaid Diagrams_image.png" width="1464"
- height="915">
-</figure>
-<p>Trilium supports Mermaid, which adds support for various diagrams such
- as flowchart, sequence diagram, class diagram, state diagram, pie charts,
- etc., all using a text description of the chart instead of manually drawing
- the diagram.</p>
-<p>This note type is a split view, meaning that both the source code and
- a preview of the document are displayed side-by-side. See&nbsp;<a class="reference-link"
- href="#root/_help_SL5f1Auq7sVN">Note types with split view</a>&nbsp;for
- more information.</p>
-<h2>Sample diagrams</h2>
-<p>Starting with v0.103.0, Mermaid diagrams no longer start with a sample
- flowchart, but instead a pane at the bottom will show all the supported
- diagrams with sample code for each:</p>
-<ul>
- <li>Simply click on any of the samples to apply it.</li>
- <li>The pane will disappear as soon as something is typed in the code editor
- or a sample is selected. To make it appear again, simply remove the content
- of the note.</li>
-</ul>
-<h2>Layouts</h2>
-<p>Depending on the chart being edited and user preference, there are two
- layouts supported by the Mermaid note type:</p>
-<ul>
- <li>Horizontal, where the source code (editable part) is on the left side
- of the screen and the preview is to the right.</li>
- <li>Vertical, where the source code is at the bottom of the screen and the
- preview is at the top.</li>
-</ul>
-<p>It's possible to switch between the two layouts at any time by pressing
- the&nbsp;<span class="tn-icon bx bxs-dock-left"></span> icon in the&nbsp;<a
- class="reference-link" href="#root/_help_1P8QXI5edXNd">Note buttons</a>.</p>
-<h2>Interaction</h2>
-<ul>
- <li>The source code of the diagram (in Mermaid format) is displayed on the
- left or bottom side of the note (depending on the layout).
- <ul>
- <li>Changing the diagram code will refresh automatically the diagram.</li>
- </ul>
- </li>
- <li>The preview of the diagram is displayed at the right or top side of the
- note (depending on the layout):
- <ul>
- <li>There are dedicated buttons at the bottom-right of the preview to control
- the zoom in, zoom out or fit the diagram.</li>
- <li>The preview can be moved around by holding the left mouse button and dragging.</li>
- <li>Zooming can also be done by using the scroll wheel.</li>
- <li>The zoom and position on the preview will remain fixed as the diagram
- changes, to be able to work more easily with large diagrams.</li>
- <li>Double-clicking the preview resets the zoom/position.</li>
- <li>The preview can also be focused by clicking on it, case in which keyboard
- shortcuts can be used:
- <ul>
- <li><kbd>+</kbd> or <kbd>E</kbd> to zoom in, <kbd>-</kbd> or <kbd>Q</kbd> to zoom
- out.</li>
- <li><kbd>/</kbd> to reset the zoom/position.</li>
- <li>Arrow keys or <kbd>W</kbd> <kbd>A</kbd> <kbd>S</kbd> <kbd>D</kbd> to pan. Holding <kbd>Shift</kbd> pans
- faster.</li>
- </ul>
- </li>
- </ul>
- </li>
- <li>The size of the source/preview panes can be adjusted by hovering over
- the border between them and dragging it with the mouse.</li>
- <li>In the&nbsp;<a class="reference-link" href="#root/_help_1P8QXI5edXNd">Note buttons</a>:
- <ul>
- <li>The source/preview can be laid out left-right (via <span class="tn-icon bx bxs-dock-left"></span>)
- or bottom-top (via <span class="tn-icon bx bxs-dock-bottom"></span>).</li>
- <li>Press the&nbsp;<span class="tn-icon bx bx-copy"></span> (<em>Copy image reference to the clipboard</em>)
- to be able to insert the image representation of the diagram into a text
- note. See&nbsp;<a class="reference-link" href="#root/_help_0Ofbk1aSuVRu">Image references</a>&nbsp;for
- more information.</li>
- </ul>
- </li>
- <li>To export the diagram as either SVG or PNG, go to the&nbsp;<a class="reference-link"
- href="#root/_help_1P8QXI5edXNd">Note buttons</a>&nbsp;and select <em>Export as image</em>:
- <ul>
- <li>Select <em>SVG (vector)</em> to download a scalable/vector rendering of
- the diagram. Can be used to present the diagram without degrading when
- zooming.</li>
- <li>Select <em>PNG (raster)</em> to download a normal image (at 1x scale, raster)
- of the diagram. Can be used to send the diagram in more traditional channels
- such as e-mail.</li>
- </ul>
- </li>
- <li>The note can be marked as <a href="#root/_help_CoFPLs3dRlXc">read-only</a>,
- case in which it switches by default to the preview (although it can be
- switched back using the source/preview buttons) and the source is no longer
- editable.</li>
-</ul>
-<h2>Errors in the diagram</h2>
-<p>If there is an error in the source code, the error will be displayed in
- an information pane.</p>
-<p>During the state of an error, the diagram will no longer be rendered and
- the previously working diagram will remain in the preview section.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Mermaid Diagrams/ELK layout.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Mermaid Diagrams/ELK layout.html
deleted file mode 100644
index 6da5ab3105..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Mermaid Diagrams/ELK layout.html
+++ /dev/null
@@ -1,28 +0,0 @@
-<p>Mermaid supports a different layout engine which supports slightly more
- complex diagrams, called the <a href="https://eclipse.dev/elk/">Eclipse Layout Kernel (ELK)</a>.
- Trilium has support for these as well, but it's not enabled by default.</p>
-<p>In order to activate ELK for any diagram, insert the following YAML frontmatter
- right at the beginning of the diagram:</p><pre><code class="language-text-x-yaml">---
-config:
- layout: elk
----</code></pre>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>With ELK off</th>
- <th>With ELK on</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>
- <img src="ELK layout_ELK off.svg">
- </td>
- <td>
- <img src="ELK layout_ELK on.svg">
- </td>
- </tr>
- </tbody>
- </table>
-</figure>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Mermaid Diagrams/ELK layout_ELK off.svg b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Mermaid Diagrams/ELK layout_ELK off.svg
deleted file mode 100644
index a6a8a01252..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Mermaid Diagrams/ELK layout_ELK off.svg
+++ /dev/null
@@ -1 +0,0 @@
-<svg aria-roledescription="flowchart-v2" role="graphics-document document" viewBox="0 -50 512.90625 442" height="442" class="flowchart" xmlns="http://www.w3.org/2000/svg" width="512.90625" id="mermaid-graph-13"><style>#mermaid-graph-13{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-graph-13 .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-graph-13 .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-graph-13 .error-icon{fill:#552222;}#mermaid-graph-13 .error-text{fill:#552222;stroke:#552222;}#mermaid-graph-13 .edge-thickness-normal{stroke-width:1px;}#mermaid-graph-13 .edge-thickness-thick{stroke-width:3.5px;}#mermaid-graph-13 .edge-pattern-solid{stroke-dasharray:0;}#mermaid-graph-13 .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-graph-13 .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-graph-13 .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-graph-13 .marker{fill:#333333;stroke:#333333;}#mermaid-graph-13 .marker.cross{stroke:#333333;}#mermaid-graph-13 svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-graph-13 p{margin:0;}#mermaid-graph-13 .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-graph-13 .cluster-label text{fill:#333;}#mermaid-graph-13 .cluster-label span{color:#333;}#mermaid-graph-13 .cluster-label span p{background-color:transparent;}#mermaid-graph-13 .label text,#mermaid-graph-13 span{fill:#333;color:#333;}#mermaid-graph-13 .node rect,#mermaid-graph-13 .node circle,#mermaid-graph-13 .node ellipse,#mermaid-graph-13 .node polygon,#mermaid-graph-13 .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-graph-13 .rough-node .label text,#mermaid-graph-13 .node .label text,#mermaid-graph-13 .image-shape .label,#mermaid-graph-13 .icon-shape .label{text-anchor:middle;}#mermaid-graph-13 .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-graph-13 .rough-node .label,#mermaid-graph-13 .node .label,#mermaid-graph-13 .image-shape .label,#mermaid-graph-13 .icon-shape .label{text-align:center;}#mermaid-graph-13 .node.clickable{cursor:pointer;}#mermaid-graph-13 .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-graph-13 .arrowheadPath{fill:#333333;}#mermaid-graph-13 .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-graph-13 .flowchart-link{stroke:#333333;fill:none;}#mermaid-graph-13 .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-graph-13 .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-graph-13 .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-graph-13 .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-graph-13 .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-graph-13 .cluster text{fill:#333;}#mermaid-graph-13 .cluster span{color:#333;}#mermaid-graph-13 div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-graph-13 .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-graph-13 rect.text{fill:none;stroke-width:0;}#mermaid-graph-13 .icon-shape,#mermaid-graph-13 .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-graph-13 .icon-shape p,#mermaid-graph-13 .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-graph-13 .icon-shape rect,#mermaid-graph-13 .image-shape rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-graph-13 :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;}</style><g><marker orient="auto" markerHeight="8" markerWidth="8" markerUnits="userSpaceOnUse" refY="5" refX="5" viewBox="0 0 10 10" class="marker flowchart-v2" id="mermaid-graph-13_flowchart-v2-pointEnd"><path style="stroke-width: 1; stroke-dasharray: 1, 0;" class="arrowMarkerPath" d="M 0 0 L 10 5 L 0 10 z"></path></marker><marker orient="auto" markerHeight="8" markerWidth="8" markerUnits="userSpaceOnUse" refY="5" refX="4.5" viewBox="0 0 10 10" class="marker flowchart-v2" id="mermaid-graph-13_flowchart-v2-pointStart"><path style="stroke-width: 1; stroke-dasharray: 1, 0;" class="arrowMarkerPath" d="M 0 5 L 10 10 L 10 0 z"></path></marker><marker orient="auto" markerHeight="11" markerWidth="11" markerUnits="userSpaceOnUse" refY="5" refX="11" viewBox="0 0 10 10" class="marker flowchart-v2" id="mermaid-graph-13_flowchart-v2-circleEnd"><circle style="stroke-width: 1; stroke-dasharray: 1, 0;" class="arrowMarkerPath" r="5" cy="5" cx="5"></circle></marker><marker orient="auto" markerHeight="11" markerWidth="11" markerUnits="userSpaceOnUse" refY="5" refX="-1" viewBox="0 0 10 10" class="marker flowchart-v2" id="mermaid-graph-13_flowchart-v2-circleStart"><circle style="stroke-width: 1; stroke-dasharray: 1, 0;" class="arrowMarkerPath" r="5" cy="5" cx="5"></circle></marker><marker orient="auto" markerHeight="11" markerWidth="11" markerUnits="userSpaceOnUse" refY="5.2" refX="12" viewBox="0 0 11 11" class="marker cross flowchart-v2" id="mermaid-graph-13_flowchart-v2-crossEnd"><path style="stroke-width: 2; stroke-dasharray: 1, 0;" class="arrowMarkerPath" d="M 1,1 l 9,9 M 10,1 l -9,9"></path></marker><marker orient="auto" markerHeight="11" markerWidth="11" markerUnits="userSpaceOnUse" refY="5.2" refX="-1" viewBox="0 0 11 11" class="marker cross flowchart-v2" id="mermaid-graph-13_flowchart-v2-crossStart"><path style="stroke-width: 2; stroke-dasharray: 1, 0;" class="arrowMarkerPath" d="M 1,1 l 9,9 M 10,1 l -9,9"></path></marker><g class="root"><g class="clusters"></g><g class="edgePaths"><path marker-end="url(#mermaid-graph-13_flowchart-v2-pointEnd)" style="" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" id="L_A_B_0" d="M77.438,196L87.866,196C98.294,196,119.151,196,139.341,196C159.531,196,179.055,196,188.816,196L198.578,196"></path><path marker-end="url(#mermaid-graph-13_flowchart-v2-pointEnd)" style="" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" id="L_C_B_0" d="M446.26,169L430.798,151.5C415.335,134,384.41,99,353.959,98.5C323.509,98,293.534,132,278.546,149L263.559,166"></path><path marker-end="url(#mermaid-graph-13_flowchart-v2-pointEnd)" style="" class="edge-thickness-normal edge-pattern-dotted edge-thickness-normal edge-pattern-solid flowchart-link" id="L_C_B_2" d="M435.328,169.751L421.688,159.46C408.047,149.168,380.766,128.584,354.016,128.205C327.267,127.825,301.049,147.65,287.94,157.563L274.831,167.476"></path><path marker-end="url(#mermaid-graph-13_flowchart-v2-pointEnd)" style="" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" id="L_C_B_3" d="M435.328,182.876L421.688,177.73C408.047,172.584,380.766,162.292,354.108,162.068C327.45,161.843,301.416,171.686,288.399,176.608L275.382,181.53"></path><path marker-end="url(#mermaid-graph-13_flowchart-v2-pointEnd)" style="" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" id="L_C_B_4" d="M435.328,196L421.688,196C408.047,196,380.766,196,354.151,196C327.536,196,301.589,196,288.615,196L275.641,196"></path><path marker-end="url(#mermaid-graph-13_flowchart-v2-pointEnd)" style="" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" id="L_C_B_5" d="M435.328,209.124L421.688,214.27C408.047,219.416,380.766,229.708,354.108,229.932C327.45,230.157,301.416,220.314,288.399,215.392L275.382,210.47"></path><path marker-end="url(#mermaid-graph-13_flowchart-v2-pointEnd)" style="" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" id="L_C_B_6" d="M435.328,222.249L421.688,232.54C408.047,242.832,380.766,263.416,354.016,263.795C327.267,264.175,301.049,244.35,287.94,234.437L274.831,224.524"></path><path marker-end="url(#mermaid-graph-13_flowchart-v2-pointEnd)" style="" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" id="L_C_B_7" d="M446.26,223L430.798,240.5C415.335,258,384.41,293,353.959,293.5C323.509,294,293.534,260,278.546,243L263.559,226"></path><path marker-end="url(#mermaid-graph-13_flowchart-v2-pointEnd)" style="" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" id="L_C_B_8" d="M452.225,223L435.768,247.833C419.311,272.667,386.398,322.333,353.888,322.889C321.379,323.446,289.274,274.891,273.221,250.614L257.169,226.337"></path><path marker-end="url(#mermaid-graph-13_flowchart-v2-pointEnd)" style="" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" id="L_B_C_0" d="M254.962,169L271.383,144.167C287.803,119.333,320.644,69.667,353.152,69.111C385.661,68.555,417.838,117.11,433.927,141.388L450.015,165.666"></path></g><g class="edgeLabels"><g transform="translate(140.0078125, 196)" class="edgeLabel"><g transform="translate(-37.5703125, -12)" class="label"><foreignObject height="24" width="75.140625"><div style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" class="labelBkg" xmlns="http://www.w3.org/1999/xhtml"><span class="edgeLabel"><p>Guarantee</p></span></div></foreignObject></g></g><g transform="translate(353.484375, 64)" class="edgeLabel"><g transform="translate(-53.8515625, -12)" class="label"><foreignObject height="24" width="107.703125"><div style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" class="labelBkg" xmlns="http://www.w3.org/1999/xhtml"><span class="edgeLabel"><p>User attributes</p></span></div></foreignObject></g></g><g transform="translate(353.484375, 108)" class="edgeLabel"><g transform="translate(-42.2109375, -12)" class="label"><foreignObject height="24" width="84.421875"><div style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" class="labelBkg" xmlns="http://www.w3.org/1999/xhtml"><span class="edgeLabel"><p>Master data</p></span></div></foreignObject></g></g><g transform="translate(353.484375, 152)" class="edgeLabel"><g transform="translate(-52.3828125, -12)" class="label"><foreignObject height="24" width="104.765625"><div style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" class="labelBkg" xmlns="http://www.w3.org/1999/xhtml"><span class="edgeLabel"><p>Exchange Rate</p></span></div></foreignObject></g></g><g transform="translate(353.484375, 196)" class="edgeLabel"><g transform="translate(-49.7109375, -12)" class="label"><foreignObject height="24" width="99.421875"><div style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" class="labelBkg" xmlns="http://www.w3.org/1999/xhtml"><span class="edgeLabel"><p>Profit Centers</p></span></div></foreignObject></g></g><g transform="translate(353.484375, 240)" class="edgeLabel"><g transform="translate(-56.84375, -12)" class="label"><foreignObject height="24" width="113.6875"><div style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" class="labelBkg" xmlns="http://www.w3.org/1999/xhtml"><span class="edgeLabel"><p>Vendor Partners</p></span></div></foreignObject></g></g><g transform="translate(353.484375, 284)" class="edgeLabel"><g transform="translate(-52.2890625, -12)" class="label"><foreignObject height="24" width="104.578125"><div style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" class="labelBkg" xmlns="http://www.w3.org/1999/xhtml"><span class="edgeLabel"><p>Work Situation</p></span></div></foreignObject></g></g><g transform="translate(353.484375, 328)" class="edgeLabel"><g transform="translate(-33.9765625, -12)" class="label"><foreignObject height="24" width="67.953125"><div style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" class="labelBkg" xmlns="http://www.w3.org/1999/xhtml"><span class="edgeLabel"><p>Customer</p></span></div></foreignObject></g></g><g transform="translate(353.484375, 372)" class="edgeLabel"><g transform="translate(-49.7109375, -12)" class="label"><foreignObject height="24" width="99.421875"><div style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" class="labelBkg" xmlns="http://www.w3.org/1999/xhtml"><span class="edgeLabel"><p>Profit Centers</p></span></div></foreignObject></g></g><g transform="translate(353.484375, 20)" class="edgeLabel"><g transform="translate(-37.5703125, -12)" class="label"><foreignObject height="24" width="75.140625"><div style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" class="labelBkg" xmlns="http://www.w3.org/1999/xhtml"><span class="edgeLabel"><p>Guarantee</p></span></div></foreignObject></g></g></g><g class="nodes"><g transform="translate(42.71875, 196)" id="flowchart-A-0" class="node default"><rect height="54" width="69.4375" y="-27" x="-34.71875" style="" class="basic label-container"></rect><g transform="translate(-4.71875, -12)" style="" class="label"><rect></rect><foreignObject height="24" width="9.4375"><div style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" xmlns="http://www.w3.org/1999/xhtml"><span class="nodeLabel"><p>A</p></span></div></foreignObject></g></g><g transform="translate(237.109375, 196)" id="flowchart-B-1" class="node default"><rect height="54" width="69.0625" y="-27" x="-34.53125" style="" class="basic label-container"></rect><g transform="translate(-4.53125, -12)" style="" class="label"><rect></rect><foreignObject height="24" width="9.0625"><div style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" xmlns="http://www.w3.org/1999/xhtml"><span class="nodeLabel"><p>B</p></span></div></foreignObject></g></g><g transform="translate(470.1171875, 196)" id="flowchart-C-2" class="node default"><rect height="54" width="69.578125" y="-27" x="-34.7890625" style="" class="basic label-container"></rect><g transform="translate(-4.7890625, -12)" style="" class="label"><rect></rect><foreignObject height="24" width="9.578125"><div style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" xmlns="http://www.w3.org/1999/xhtml"><span class="nodeLabel"><p>C</p></span></div></foreignObject></g></g></g></g></g><text class="flowchartTitleText" y="-25" x="256.453125" text-anchor="middle">Interfaces for B</text></svg>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Mermaid Diagrams/ELK layout_ELK on.svg b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Mermaid Diagrams/ELK layout_ELK on.svg
deleted file mode 100644
index 1a400331d5..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Mermaid Diagrams/ELK layout_ELK on.svg
+++ /dev/null
@@ -1 +0,0 @@
-<svg aria-roledescription="flowchart-v2" role="graphics-document document" viewBox="4 -50 530.828125 491" height="491" class="flowchart" xmlns="http://www.w3.org/2000/svg" width="530.828125" id="mermaid-graph-12"><style>#mermaid-graph-12{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-graph-12 .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-graph-12 .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-graph-12 .error-icon{fill:#552222;}#mermaid-graph-12 .error-text{fill:#552222;stroke:#552222;}#mermaid-graph-12 .edge-thickness-normal{stroke-width:1px;}#mermaid-graph-12 .edge-thickness-thick{stroke-width:3.5px;}#mermaid-graph-12 .edge-pattern-solid{stroke-dasharray:0;}#mermaid-graph-12 .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-graph-12 .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-graph-12 .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-graph-12 .marker{fill:#333333;stroke:#333333;}#mermaid-graph-12 .marker.cross{stroke:#333333;}#mermaid-graph-12 svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-graph-12 p{margin:0;}#mermaid-graph-12 .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-graph-12 .cluster-label text{fill:#333;}#mermaid-graph-12 .cluster-label span{color:#333;}#mermaid-graph-12 .cluster-label span p{background-color:transparent;}#mermaid-graph-12 .label text,#mermaid-graph-12 span{fill:#333;color:#333;}#mermaid-graph-12 .node rect,#mermaid-graph-12 .node circle,#mermaid-graph-12 .node ellipse,#mermaid-graph-12 .node polygon,#mermaid-graph-12 .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-graph-12 .rough-node .label text,#mermaid-graph-12 .node .label text,#mermaid-graph-12 .image-shape .label,#mermaid-graph-12 .icon-shape .label{text-anchor:middle;}#mermaid-graph-12 .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-graph-12 .rough-node .label,#mermaid-graph-12 .node .label,#mermaid-graph-12 .image-shape .label,#mermaid-graph-12 .icon-shape .label{text-align:center;}#mermaid-graph-12 .node.clickable{cursor:pointer;}#mermaid-graph-12 .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-graph-12 .arrowheadPath{fill:#333333;}#mermaid-graph-12 .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-graph-12 .flowchart-link{stroke:#333333;fill:none;}#mermaid-graph-12 .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-graph-12 .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-graph-12 .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-graph-12 .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-graph-12 .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-graph-12 .cluster text{fill:#333;}#mermaid-graph-12 .cluster span{color:#333;}#mermaid-graph-12 div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-graph-12 .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-graph-12 rect.text{fill:none;stroke-width:0;}#mermaid-graph-12 .icon-shape,#mermaid-graph-12 .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-graph-12 .icon-shape p,#mermaid-graph-12 .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-graph-12 .icon-shape rect,#mermaid-graph-12 .image-shape rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-graph-12 :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;}</style><g><marker orient="auto" markerHeight="8" markerWidth="8" markerUnits="userSpaceOnUse" refY="5" refX="5" viewBox="0 0 10 10" class="marker flowchart-v2" id="mermaid-graph-12_flowchart-v2-pointEnd"><path style="stroke-width: 1; stroke-dasharray: 1, 0;" class="arrowMarkerPath" d="M 0 0 L 10 5 L 0 10 z"></path></marker><marker orient="auto" markerHeight="8" markerWidth="8" markerUnits="userSpaceOnUse" refY="5" refX="4.5" viewBox="0 0 10 10" class="marker flowchart-v2" id="mermaid-graph-12_flowchart-v2-pointStart"><path style="stroke-width: 1; stroke-dasharray: 1, 0;" class="arrowMarkerPath" d="M 0 5 L 10 10 L 10 0 z"></path></marker><marker orient="auto" markerHeight="11" markerWidth="11" markerUnits="userSpaceOnUse" refY="5" refX="11" viewBox="0 0 10 10" class="marker flowchart-v2" id="mermaid-graph-12_flowchart-v2-circleEnd"><circle style="stroke-width: 1; stroke-dasharray: 1, 0;" class="arrowMarkerPath" r="5" cy="5" cx="5"></circle></marker><marker orient="auto" markerHeight="11" markerWidth="11" markerUnits="userSpaceOnUse" refY="5" refX="-1" viewBox="0 0 10 10" class="marker flowchart-v2" id="mermaid-graph-12_flowchart-v2-circleStart"><circle style="stroke-width: 1; stroke-dasharray: 1, 0;" class="arrowMarkerPath" r="5" cy="5" cx="5"></circle></marker><marker orient="auto" markerHeight="11" markerWidth="11" markerUnits="userSpaceOnUse" refY="5.2" refX="12" viewBox="0 0 11 11" class="marker cross flowchart-v2" id="mermaid-graph-12_flowchart-v2-crossEnd"><path style="stroke-width: 2; stroke-dasharray: 1, 0;" class="arrowMarkerPath" d="M 1,1 l 9,9 M 10,1 l -9,9"></path></marker><marker orient="auto" markerHeight="11" markerWidth="11" markerUnits="userSpaceOnUse" refY="5.2" refX="-1" viewBox="0 0 11 11" class="marker cross flowchart-v2" id="mermaid-graph-12_flowchart-v2-crossStart"><path style="stroke-width: 2; stroke-dasharray: 1, 0;" class="arrowMarkerPath" d="M 1,1 l 9,9 M 10,1 l -9,9"></path></marker></g><g class="subgraphs"></g><g class="nodes"><g transform="translate(46.859375, 39)" id="flowchart-A-0" class="node default"><rect height="54" width="69.4375" y="-27" x="-34.71875" style="" class="basic label-container"></rect><g transform="translate(-4.71875, -12)" style="" class="label"><rect></rect><foreignObject height="24" width="9.4375"><div style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" xmlns="http://www.w3.org/1999/xhtml"><span class="nodeLabel"><p>A</p></span></div></foreignObject></g></g><g transform="translate(492.296875, 249.04545454545453)" id="flowchart-B-1" class="node default"><rect height="54" width="69.0625" y="-27" x="-34.53125" style="" class="basic label-container"></rect><g transform="translate(-4.53125, -12)" style="" class="label"><rect></rect><foreignObject height="24" width="9.0625"><div style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" xmlns="http://www.w3.org/1999/xhtml"><span class="nodeLabel"><p>B</p></span></div></foreignObject></g></g><g transform="translate(46.7890625, 399.9)" id="flowchart-C-2" class="node default"><rect height="54" width="69.578125" y="-27" x="-34.7890625" style="" class="basic label-container"></rect><g transform="translate(-4.7890625, -12)" style="" class="label"><rect></rect><foreignObject height="24" width="9.578125"><div style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" xmlns="http://www.w3.org/1999/xhtml"><span class="nodeLabel"><p>C</p></span></div></foreignObject></g></g></g><g class="edges edgePaths"><path marker-end="url(#mermaid-graph-12_flowchart-v2-pointEnd)" style="" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" id="L_A_B_0_0" d="M81.578,39L140.526,39C199.474,39,317.37,39,376.789,39.362C436.208,39.724,437.151,40.448,437.985,41.281C438.818,42.114,439.542,43.057,439.904,73.188C440.266,103.318,440.266,162.636,440.628,192.767C440.989,222.897,441.713,223.84,442.547,224.673C443.38,225.507,444.323,226.231,446.211,226.593C448.099,226.955,450.932,226.955,452.349,226.955L453.766,226.955"></path><path marker-end="url(#mermaid-graph-12_flowchart-v2-pointEnd)" style="" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" id="L_C_B_0_0" d="M81.578,383.7L86.578,383.7C91.578,383.7,101.578,383.7,107.05,383.338C112.521,382.976,113.464,382.252,114.297,381.419C115.13,380.586,115.854,379.643,116.216,337.555C116.578,295.467,116.578,212.233,116.94,170.145C117.302,128.057,118.026,127.114,118.859,126.281C119.693,125.448,120.635,124.724,167.555,124.362C214.474,124,307.37,124,354.289,124.362C401.208,124.724,402.151,125.448,402.985,126.281C403.818,127.114,404.542,128.057,404.904,145.657C405.266,163.258,405.266,197.515,405.628,215.115C405.989,232.716,406.713,233.658,407.547,234.492C408.38,235.325,409.323,236.049,417.044,236.411C424.766,236.773,439.266,236.773,446.516,236.773L453.766,236.773"></path><path marker-end="url(#mermaid-graph-12_flowchart-v2-pointEnd)" style="" class="edge-thickness-normal edge-pattern-dotted edge-thickness-normal edge-pattern-solid flowchart-link" id="L_C_B_2_0" d="M81.578,389.1L89.495,389.1C97.411,389.1,113.245,389.1,121.633,388.738C130.021,388.376,130.964,387.652,131.797,386.819C132.63,385.986,133.354,385.043,133.716,349.138C134.078,313.233,134.078,242.367,134.44,206.462C134.802,170.557,135.526,169.614,136.359,168.781C137.193,167.948,138.135,167.224,179.221,166.862C220.307,166.5,301.536,166.5,342.622,166.862C383.708,167.224,384.651,167.948,385.485,168.781C386.318,169.614,387.042,170.557,387.404,181.892C387.766,193.227,387.766,214.955,388.128,226.29C388.489,237.625,389.213,238.567,390.047,239.401C390.88,240.234,391.823,240.958,402.461,241.32C413.099,241.682,433.432,241.682,443.599,241.682L453.766,241.682"></path><path marker-end="url(#mermaid-graph-12_flowchart-v2-pointEnd)" style="" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" id="L_C_B_3_0" d="M81.578,394.5L92.411,394.5C103.245,394.5,124.911,394.5,136.216,394.138C147.521,393.776,148.464,393.052,149.297,392.219C150.13,391.386,150.854,390.443,151.216,360.721C151.578,331,151.578,272.5,151.94,242.779C152.302,213.057,153.026,212.114,153.859,211.281C154.693,210.448,155.635,209.724,190.888,209.362C226.141,209,295.703,209,330.956,209.362C366.208,209.724,367.151,210.448,367.985,211.281C368.818,212.114,369.542,213.057,369.904,218.127C370.266,223.197,370.266,232.394,370.628,237.464C370.989,242.534,371.713,243.477,372.547,244.31C373.38,245.143,374.323,245.867,387.878,246.229C401.432,246.591,427.599,246.591,440.682,246.591L453.766,246.591"></path><path marker-end="url(#mermaid-graph-12_flowchart-v2-pointEnd)" style="" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" id="L_C_B_4_0" d="M81.578,399.9L95.328,399.9C109.078,399.9,136.578,399.9,150.8,399.538C165.021,399.176,165.964,398.452,166.797,397.619C167.63,396.786,168.354,395.843,168.716,372.305C169.078,348.767,169.078,302.633,169.44,279.095C169.802,255.557,170.526,254.614,171.359,253.781C172.193,252.948,173.135,252.224,220.221,251.862C267.307,251.5,360.536,251.5,407.151,251.5L453.766,251.5"></path><path marker-end="url(#mermaid-graph-12_flowchart-v2-pointEnd)" style="" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" id="L_C_B_5_0" d="M81.578,405.3L98.245,405.3C114.911,405.3,148.245,405.3,165.383,404.938C182.521,404.576,183.464,403.852,184.297,403.019C185.13,402.186,185.854,401.243,186.216,383.888C186.578,366.533,186.578,332.767,186.94,315.412C187.302,298.057,188.026,297.114,188.859,296.281C189.693,295.448,190.635,294.724,220.055,294.362C249.474,294,307.37,294,336.789,293.638C366.208,293.276,367.151,292.552,367.985,291.719C368.818,290.886,369.542,289.943,369.904,284.873C370.266,279.803,370.266,270.606,370.628,265.536C370.989,260.466,371.713,259.523,372.547,258.69C373.38,257.857,374.323,257.133,387.878,256.771C401.432,256.409,427.599,256.409,440.682,256.409L453.766,256.409"></path><path marker-end="url(#mermaid-graph-12_flowchart-v2-pointEnd)" style="" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" id="L_C_B_6_0" d="M81.578,410.7L101.161,410.7C120.745,410.7,159.911,410.7,179.966,410.338C200.021,409.976,200.964,409.252,201.797,408.419C202.63,407.586,203.354,406.643,203.716,395.471C204.078,384.3,204.078,362.9,204.44,351.729C204.802,340.557,205.526,339.614,206.359,338.781C207.193,337.948,208.135,337.224,237.555,336.862C266.974,336.5,324.87,336.5,354.289,336.138C383.708,335.776,384.651,335.052,385.485,334.219C386.318,333.386,387.042,332.443,387.404,321.108C387.766,309.773,387.766,288.045,388.128,276.71C388.489,265.375,389.213,264.433,390.047,263.599C390.88,262.766,391.823,262.042,402.461,261.68C413.099,261.318,433.432,261.318,443.599,261.318L453.766,261.318"></path><path marker-end="url(#mermaid-graph-12_flowchart-v2-pointEnd)" style="" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" id="L_C_B_7_0" d="M81.578,416.1L104.078,416.1C126.578,416.1,171.578,416.1,194.55,415.738C217.521,415.376,218.464,414.652,219.297,413.819C220.13,412.986,220.854,412.043,221.216,407.055C221.578,402.067,221.578,393.033,221.94,388.045C222.302,383.057,223.026,382.114,223.859,381.281C224.693,380.448,225.635,379.724,255.055,379.362C284.474,379,342.37,379,371.789,378.638C401.208,378.276,402.151,377.552,402.985,376.719C403.818,375.886,404.542,374.943,404.904,357.343C405.266,339.742,405.266,305.485,405.628,287.885C405.989,270.284,406.713,269.342,407.547,268.508C408.38,267.675,409.323,266.951,417.044,266.589C424.766,266.227,439.266,266.227,446.516,266.227L453.766,266.227"></path><path marker-end="url(#mermaid-graph-12_flowchart-v2-pointEnd)" style="" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" id="L_C_B_8_0" d="M81.578,421.5L137.609,421.5C193.641,421.5,305.703,421.5,362.206,421.138C418.708,420.776,419.651,420.052,420.485,419.219C421.318,418.386,422.042,417.443,422.404,393.577C422.766,369.712,422.766,322.924,423.128,299.059C423.489,275.194,424.213,274.251,425.047,273.417C425.88,272.584,426.823,271.86,431.628,271.498C436.432,271.136,445.099,271.136,449.432,271.136L453.766,271.136"></path><path marker-end="url(#mermaid-graph-12_flowchart-v2-pointEnd)" style="" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" id="L_B_C_0_0" d="M457.766,231.864L452.766,231.864C447.766,231.864,437.766,231.864,432.294,231.502C426.823,231.14,425.88,230.416,425.047,229.583C424.213,228.749,423.489,227.806,423.128,203.941C422.766,180.076,422.766,133.288,422.404,109.423C422.042,85.557,421.318,84.614,420.485,83.781C419.651,82.948,418.708,82.224,365.956,81.862C313.203,81.5,208.641,81.5,155.888,81.862C103.135,82.224,102.193,82.948,101.359,83.781C100.526,84.614,99.802,85.557,99.44,133.829C99.078,182.1,99.078,277.7,98.716,325.971C98.354,374.243,97.63,375.186,96.797,376.019C95.964,376.852,95.021,377.576,93.133,377.938C91.245,378.3,88.411,378.3,86.995,378.3L85.578,378.3"></path></g><g class="edgeLabels"><g transform="translate(295.921875, 38.5)" class="edgeLabel"><g transform="translate(-37.5703125, -12)" class="label"><foreignObject height="24" width="75.140625"><div style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" class="labelBkg" xmlns="http://www.w3.org/1999/xhtml"><span class="edgeLabel"><p>Guarantee</p></span></div></foreignObject></g></g><g transform="translate(295.921875, 123.5)" class="edgeLabel"><g transform="translate(-53.8515625, -12)" class="label"><foreignObject height="24" width="107.703125"><div style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" class="labelBkg" xmlns="http://www.w3.org/1999/xhtml"><span class="edgeLabel"><p>User attributes</p></span></div></foreignObject></g></g><g transform="translate(295.921875, 165.99999999999997)" class="edgeLabel"><g transform="translate(-42.2109375, -12)" class="label"><foreignObject height="24" width="84.421875"><div style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" class="labelBkg" xmlns="http://www.w3.org/1999/xhtml"><span class="edgeLabel"><p>Master data</p></span></div></foreignObject></g></g><g transform="translate(295.921875, 208.49999999999997)" class="edgeLabel"><g transform="translate(-52.3828125, -12)" class="label"><foreignObject height="24" width="104.765625"><div style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" class="labelBkg" xmlns="http://www.w3.org/1999/xhtml"><span class="edgeLabel"><p>Exchange Rate</p></span></div></foreignObject></g></g><g transform="translate(295.921875, 250.99999999999997)" class="edgeLabel"><g transform="translate(-49.7109375, -12)" class="label"><foreignObject height="24" width="99.421875"><div style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" class="labelBkg" xmlns="http://www.w3.org/1999/xhtml"><span class="edgeLabel"><p>Profit Centers</p></span></div></foreignObject></g></g><g transform="translate(295.921875, 293.5)" class="edgeLabel"><g transform="translate(-56.84375, -12)" class="label"><foreignObject height="24" width="113.6875"><div style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" class="labelBkg" xmlns="http://www.w3.org/1999/xhtml"><span class="edgeLabel"><p>Vendor Partners</p></span></div></foreignObject></g></g><g transform="translate(295.921875, 336)" class="edgeLabel"><g transform="translate(-52.2890625, -12)" class="label"><foreignObject height="24" width="104.578125"><div style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" class="labelBkg" xmlns="http://www.w3.org/1999/xhtml"><span class="edgeLabel"><p>Work Situation</p></span></div></foreignObject></g></g><g transform="translate(295.921875, 378.5)" class="edgeLabel"><g transform="translate(-33.9765625, -12)" class="label"><foreignObject height="24" width="67.953125"><div style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" class="labelBkg" xmlns="http://www.w3.org/1999/xhtml"><span class="edgeLabel"><p>Customer</p></span></div></foreignObject></g></g><g transform="translate(295.921875, 421)" class="edgeLabel"><g transform="translate(-49.7109375, -12)" class="label"><foreignObject height="24" width="99.421875"><div style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" class="labelBkg" xmlns="http://www.w3.org/1999/xhtml"><span class="edgeLabel"><p>Profit Centers</p></span></div></foreignObject></g></g><g transform="translate(295.921875, 81)" class="edgeLabel"><g transform="translate(-37.5703125, -12)" class="label"><foreignObject height="24" width="75.140625"><div style="display: table-cell; white-space: nowrap; line-height: 1.5; max-width: 200px; text-align: center;" class="labelBkg" xmlns="http://www.w3.org/1999/xhtml"><span class="edgeLabel"><p>Guarantee</p></span></div></foreignObject></g></g></g><text class="flowchartTitleText" y="-25" x="269.4140625" text-anchor="middle">Interfaces for B</text></svg>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Mermaid Diagrams/Syntax reference.dat b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Mermaid Diagrams/Syntax reference.dat
deleted file mode 100644
index e69de29bb2..0000000000
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Mermaid Diagrams_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Mermaid Diagrams_image.png
deleted file mode 100644
index 964dae4915..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Mermaid Diagrams_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Mind Map.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Mind Map.html
deleted file mode 100644
index 88feb149b7..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Mind Map.html
+++ /dev/null
@@ -1,41 +0,0 @@
-<figure class="image image-style-align-center">
- <img style="aspect-ratio:892/675;" src="Mind Map_image.png" width="892"
- height="675">
-</figure>
-<p>The mindmap allows for easy jotting down of ideas and storing them in
- a hierarchical fashion.</p>
-<h2>Terminology</h2>
-<ul>
- <li>A <strong>node</strong> is a single idea, represented differently based
- on depth (filled rounded rectangle for the root note, unfilled rectangles
- for sub-ideas, lines only for sub-sub-ideas).</li>
- <li>The <strong>root node</strong> is the top-most node from which all other
- nodes derive, displayed as a filled rectangle. There can only be a single
- root node.</li>
-</ul>
-<h2>Interaction</h2>
-<ul>
- <li>To create a new node at the same level as the current one, press <kbd>Enter</kbd>,
- enter the desired text and then press <kbd>Enter</kbd> once again to confirm.</li>
- <li>Similarly, to create a sub-node, press <kbd>Tab</kbd>, enter the desired
- text and then press <kbd>Enter</kbd>.</li>
- <li>To create a parent, use <kbd>Ctrl</kbd>+<kbd>Enter</kbd> instead.</li>
- <li>To remove a node, press <kbd>Delete</kbd>.</li>
- <li>To move a node up or down, press <kbd>Page Up</kbd> or <kbd>Page Down</kbd>.</li>
- <li>To adjust the font size, color of the text or background or to add a link,
- click on a node and use the floating panel that appears to the right.</li>
- <li>To select one or more notes, drag and drop across the map.</li>
- <li>Right click the node to bring a contextual menu with options such as creating
- new nodes, focusing on a particular notes or creating links between them.</li>
- <li>Use the buttons at the top-left to change the positioning of the nodes
- relative to the root node (to the left, to the right, or to both sides).</li>
- <li>In the&nbsp;<a class="reference-link" href="#root/_help_1P8QXI5edXNd">Note buttons</a>&nbsp;area,
- an <a href="#root/_help_0Ofbk1aSuVRu">image reference</a> can be copied by
- pressing the&nbsp;<span class="tn-icon bx bx-copy"></span> button, to paste
- the mind map in a text note.</li>
- <li>From the&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a>,
- the diagram can be exported either as SVG (vectorial) or PNG (raster) by
- selecting <em>Export as image</em>.</li>
- <li>The note can be set as <a href="#root/_help_CoFPLs3dRlXc">read-only</a> which
- will disable all editing features.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Mind Map_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Mind Map_image.png
deleted file mode 100644
index 9e44818621..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Mind Map_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Note Map.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Note Map.html
deleted file mode 100644
index 631c83b8d5..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Note Map.html
+++ /dev/null
@@ -1,54 +0,0 @@
-<figure class="image image_resized" style="width:72.68%;">
- <img style="aspect-ratio:1311/1271;" src="Note Map_image.png" width="1311"
- height="1271">
-</figure>
-<p>A Note map is a note type which displays a standalone version of the feature
- of the same name:&nbsp;<a class="reference-link" href="#root/_help_BCkXAVs63Ttv">Note Map (Link map, Tree map)</a>.
- Consult that page for more information on how the note map works and what
- it displays.</p>
-<p>Once created, the note map will display the relations between notes. Only
- the notes that are part of the parent of the note map will be displayed
- (including their children).</p>
-<h2>Root note</h2>
-<p>The root note defines the starting point of the graph, from which the
- relations and the hierarchy are derived from.</p>
-<p>There are three possible root notes:</p>
-<ul>
- <li>The default root note is the parent note of the note map.</li>
- <li>To use the currently <a href="#root/_help_OR8WJ7Iz9K4U">hoisted note</a> instead,
- set the <code>mapRootNoteId</code> label to <code>hoisted</code>.</li>
- <li>To use a specific note instead, set <code>mapRootNoteId</code> to the&nbsp;<a
- class="reference-link" href="#root/_help_m1lbrzyKDaRB">Note ID</a>&nbsp;of
- the desired note.</li>
-</ul>
-<h2>Customization</h2>
-<p>The note map can be customized using the following&nbsp;<a class="reference-link"
- href="#root/_help_HI6GBBIduIgv">Labels</a>:</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Label</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>#mapIncludeRelation</code>
- </td>
- <td>Comma-delimited relation names to include from the note map.</td>
- </tr>
- <tr>
- <td><code>#mapExcludeRelation</code>
- </td>
- <td>Comma-delimited relation names to exclude from the note map.</td>
- </tr>
- <tr>
- <td><code>#mapRootNoteId</code>
- </td>
- <td>The ID of the note the map roots from, or <code>hoisted</code>. See the
- root note section above for more information.</td>
- </tr>
- </tbody>
- </table>
-</figure>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Note Map_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Note Map_image.png
deleted file mode 100644
index 43fdd0749c..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Note Map_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Relation Map.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Relation Map.html
deleted file mode 100644
index 0487b4d091..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Relation Map.html
+++ /dev/null
@@ -1,189 +0,0 @@
-<p>Relation map is a type of&nbsp;note&nbsp;which visualizes notes and their <a
- href="#root/_help_zEY4DaJG4YT5">relations</a>.</p>
-<h2>Interaction</h2>
-<ul>
- <li>To create a new note and add it to the map, press the <span class="tn-icon bx bx-note"></span> <em>Add note</em> button
- at the bottom of the map, then click anywhere on the map to place it there.
- <ul>
- <li>While the map waits for the click, a translucent box follows the mouse
- to show where the note will go. To cancel, press the button again (now
- labeled <em>Cancel</em>) or press <kbd>Esc</kbd>.</li>
- <li>The note is created as a child of the map, with the default title of a
- new note. It opens in the note panel (see below) with its title selected,
- so you can type its name straight away.</li>
- </ul>
- </li>
- <li>An existing note can also be dragged from the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>. It will be placed at the
- position it's dragged on.
- <ul>
- <li>Multiple notes can also be dragged via&nbsp;<a class="reference-link"
- href="#root/_help_yTjUdsOi4CIE">Multiple selection</a>. The notes will
- be positioned near the dragged position without overlapping.</li>
- <li>The dragged note can be a sub-child of the map, or it can be at any arbitrary
- position.</li>
- </ul>
- </li>
- <li>Notes can also be pasted onto the map. Copy or cut them in the <a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>, then click the map and press <kbd>Ctrl</kbd>+<kbd>V</kbd>,
- or right click an empty part of the map and select <em>Paste note(s)</em>.
- <ul>
- <li>With <kbd>Ctrl</kbd>+<kbd>V</kbd>, the notes are placed under the mouse,
- or in the middle of the map if the mouse is not over it. From the right
- click menu, they are placed where the menu was opened.</li>
- <li>Copied notes stay where they are in the tree. Cut notes are moved under
- the map, as if they had been pasted into it in the tree.</li>
- <li>Links to notes, such as an <a class="reference-link" href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a> copied
- from a text note, can be pasted the same way. If the clipboard holds no
- link to a note, the notes last copied or cut in the tree are pasted.</li>
- <li>The right click menu of an empty part of the map also has <em>Add note</em>,
- which creates a new note where the menu was opened.</li>
- </ul>
- </li>
- <li>To create a relationship, hold the mouse on the dot on the right of a
- note and then:
- <ul>
- <li>Drag it over another note to create a relationship pointing from the first
- note to the second one.</li>
- <li>Drag over the same note to create a self-referencing relationship (represented
- as a loop).</li>
- <li>Once dragged, a popover next to the relationship asks for its name. Type
- a new name and press <kbd>Enter</kbd>, or pick a relation name already in
- use from the suggestions. To cancel, press <kbd>Esc</kbd>, close the popover
- or click elsewhere on the map.</li>
- </ul>
- </li>
- <li>Each note is shown as a card with its icon and title, colored in the note's
- color the same way as the cards of a <a class="reference-link" href="#root/_help_CtBQqbwXDx1w">Kanban Board</a>.</li>
- <li>Hovering a note highlights its relationships, in the note's color if it
- has one, and fades the other relationships.</li>
- <li>To view or edit a note, click it on the map. This opens the note panel
- (see below).
- <ul>
- <li>To open the note in a new tab instead, <kbd>Ctrl</kbd>+click it or click
- it with the middle mouse button. <kbd>Shift</kbd>+click opens it in a new
- window. The right click menu offers the same options.</li>
- </ul>
- </li>
- <li>To edit the title of a note, change its color or delete it (either from
- the map, or delete it completely), right click the note.</li>
- <li>To rename or delete a relationship, right click it and select the corresponding
- option.</li>
- <li>On a <a href="#root/_help_CoFPLs3dRlXc">read-only</a> map, notes cannot
- be moved and relationships cannot be drawn, renamed or deleted. The right
- click menu of a note only offers to open it, and a relationship has no
- right click menu.</li>
- <li>To move around the map, drag an empty part of it, and zoom with the mouse
- wheel or the <span class="tn-icon bx bx-minus-circle"></span> and <span class="tn-icon bx bx-plus-circle"></span> buttons
- at the bottom-right corner. Clicking the zoom percentage goes back to 100%,
- and <span class="tn-icon bx bx-scan"></span> <em>Fit to view</em> zooms and
- pans so that all the notes are visible.
- <ul>
- <li>Once the map has been clicked, the arrow keys or <kbd>W</kbd> <kbd>A</kbd> <kbd>S</kbd> <kbd>D</kbd> pan
- it, and <kbd>+</kbd> and <kbd>-</kbd> zoom it. The <kbd>?</kbd> button at the
- top-right corner of the map lists all its keyboard shortcuts.</li>
- </ul>
- </li>
-</ul>
-<h2>Note panel</h2>
-<p>When a note on the map is clicked, a panel opens to the right of the map
- and the note is highlighted. If the panel would cover the note, or the
- note is partly off-screen, the map pans to bring it into view. The panel
- contains:</p>
-<ul>
- <li>The title and icon of the note, both editable.</li>
- <li>A <span class="tn-icon bx bx-expand-alt"></span> button to expand the panel
- over the whole map, and to restore it afterwards.</li>
- <li>Buttons to interact with the note:
- <ul>
- <li><span class="tn-icon bx bx-log-in"></span> Open the note in the current
- tab, or, through the <span class="tn-icon bx bx-dots-horizontal-rounded"></span> menu,
- in a new tab, split, window or the quick edit popup.</li>
- <li>A <span class="tn-icon bx bx-palette"></span> color picker to change the
- color of the note.</li>
- <li>A <span class="tn-icon bx bx-trash"></span> button to remove the note from
- the map, which can optionally delete the note as well.</li>
- </ul>
- </li>
- <li>The <a class="reference-link" href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a> of
- the note, if any.</li>
- <li>The note's content, which can be edited directly from the panel.</li>
-</ul>
-<p>The color picker and the remove button are not shown if the map is read-only.</p>
-<p>Clicking another note on the map switches the panel to it. Similarly,
- clicking an <a class="reference-link" href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a> inside
- the panel switches the panel to that note, as long as it is on the map.</p>
-<p>To close the panel, press the <span class="tn-icon bx bx-x"></span> button
- at its top-right, click an empty part of the map, or press <kbd>Esc</kbd>.</p>
-<p>On mobile, the note opens as a dialog over the whole screen instead of
- a panel.</p>
-<h2>Development process demo</h2>
-<p>This is a basic example how you can create simple diagram using relation
- maps:</p>
-<img src="Relation Map_relation-map-dev-process.png" width="934"
-height="667">
-<p>And this is how you can create it:</p>
-<img src="Relation Map_relation-map-dev-process-demo.gif"
-width="812" height="585">
-<p>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 <a
- href="#root/_help_zEY4DaJG4YT5">relations</a>between notes and name them.
- That's all!</p>
-<p>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 "<a href="#root/_help_zEY4DaJG4YT5">relations</a>".</p>
-<h2>Family demo</h2>
-<p>This is more complicated demo using some advanced concepts. Resulting
- diagram is here:</p>
-<img src="Relation Map_relation-map-family.png" width="941"
-height="758">
-<p>This is how you get to it:</p>
-<img src="Relation Map_relation-map-family-demo.gif"
-width="812" height="585">
-<p>There are several steps here:</p>
-<ul>
- <li>we start with empty relation map and two existing notes representing Prince
- Philip and Queen Elizabeth II. These two notes already have <code>isPartnerOf</code> <a
- href="#root/_help_zEY4DaJG4YT5">relations</a>defined.
- <ul>
- <li>There are actually two "inverse" relations (one from Philip to Elizabeth
- and one from Elizabeth to Philip)</li>
- </ul>
- </li>
- <li>we drag both notes to relation map and place to suitable position. Notice
- how the existing <code>isPartnerOf</code> relations are displayed.</li>
- <li>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).</li>
- <li>we create two new relations <code>isChildOf</code> targeting both Philip
- and Elizabeth
- <ul>
- <li>now there's something unexpected - we can also see the relation to display
- another <code>hasChild</code> relation. This is because there's a <a href="#root/_help_OFXdgB2nNk1F">relation definition</a> which
- puts <code>isChildOf</code> as an "<a href="#root/_help_OFXdgB2nNk1F">inverse</a>"
- relation of <code>hasChildOf</code> (and vice versa) and thus it is created
- automatically.</li>
- </ul>
- </li>
- <li>we create another note for Princess Diana and create <code>isPartnerOf</code> relation
- from Charles. Again notice how the relation has arrows both ways - this
- is because <code>isPartnerOf</code> definition specifies its inverse relation
- as again "isPartnerOf" so the opposite relation is created automatically.</li>
- <li>as the last step we pan &amp; zoom the map to fit better to window dimensions.</li>
-</ul>
-<p>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 <a href="#root/_help_wX4HbRucYSDD">demo notes</a>.</p>
-<h2>Details</h2>
-<p>You can specify which relations should be displayed with comma delimited
- names of relations in <code>displayRelations</code> label.</p>
-<p>Alternatively, you can specify comma delimited list of relation names
- in <code>hideRelations</code> which will display all relations, except for
- the ones defined in the label.</p>
-<h2>See also</h2>
-<ul>
- <li><a class="reference-link" href="#root/_help_bdUJEHsAPYQR">Note Map</a>&nbsp;is
- a similar concept.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Relation Map_relation-map-dev-process-demo.gif b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Relation Map_relation-map-dev-process-demo.gif
deleted file mode 100644
index 8ff234f4ea..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Relation Map_relation-map-dev-process-demo.gif and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Relation Map_relation-map-dev-process.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Relation Map_relation-map-dev-process.png
deleted file mode 100644
index fb97d0e998..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Relation Map_relation-map-dev-process.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Relation Map_relation-map-family-demo.gif b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Relation Map_relation-map-family-demo.gif
deleted file mode 100644
index 8366855144..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Relation Map_relation-map-family-demo.gif and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Relation Map_relation-map-family.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Relation Map_relation-map-family.png
deleted file mode 100644
index 86ea6477f5..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Relation Map_relation-map-family.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Render Note.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Render Note.html
deleted file mode 100644
index cae003429e..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Render Note.html
+++ /dev/null
@@ -1,102 +0,0 @@
-<figure class="image">
- <img style="aspect-ratio:601/216;" src="Render Note_image.png" width="601"
- height="216">
-</figure>
-<p>Render Note is a special case of <a href="#root/_help_yIhgI5H7A2Sm">front-end scripting</a> which
- allows rendering custom content inside a note. This makes it possible to
- create custom dashboards, or to use a custom note editor.</p>
-<p>The content can either be a vanilla HTML, or Preact JSX.</p>
-<h2>Creating a render note</h2>
-<ol>
- <li>Create a&nbsp;<a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;note
- with the:
- <ol>
- <li>HTML language for the legacy/vanilla method, with what needs to be displayed
- (for example <code>&lt;p&gt;Hello world.&lt;/p&gt;</code>).</li>
- <li>JSX for the Preact-based approach (see below).</li>
- </ol>
- </li>
- <li>Create a&nbsp;<a class="reference-link" href="#root/_help_HcABDtFCkbFN">Render Note</a>.</li>
- <li>Assign the <code>renderNote</code> <a href="#root/_help_zEY4DaJG4YT5">relation</a> to
- point at the previously created code note.</li>
-</ol>
-<h2>Legacy scripting using jQuery</h2>
-<p>A static HTML is generally not enough for&nbsp;<a class="reference-link"
- href="#root/_help_CdNpE2pqjmI6">Scripting</a>. The next step is to automatically
- change parts of the note using JavaScript.</p>
-<p>For a simple example, we are going to create a render note that displays
- the current date in a field.</p>
-<p>To do so, first create an HTML code note with the following content:</p><pre><code class="language-text-html">&lt;h1&gt;Current date &amp; time&lt;/h1&gt;
-The current date &amp; time is &lt;span class="date"&gt;&lt;/span&gt;</code></pre>
-<p>Now we need to add the script. Create another&nbsp;<a class="reference-link"
- href="#root/_help_6f9hih2hXXZk">Code</a>, but this time of JavaScript (frontend)
- language. Make sure the newly created note is a direct child of the HTML
- note created previously; with the following content:</p><pre><code class="language-text-javascript">const $dateEl = api.$container.find(".date");
-$dateEl.text(new Date());</code></pre>
-<p>Now create a render note at any place and set its <code>~renderNote</code> relation
- to point to the HTML note. When the render note is accessed it will display:</p>
-<blockquote>
- <p><strong>Current date &amp; time</strong>
- <br>The current date &amp; time is Sun Apr 06 2025 15:26:29 GMT+0300 (Eastern
- European Summer Time)</p>
-</blockquote>
-<h2>Dynamic content using Preact &amp; JSX</h2>
-<p>As a more modern alternative to jQuery, it's possible to use Preact &amp;
- JSX to render pages. Since JSX is a superset of JavaScript, there's no
- need to provide a HTML anymore.</p>
-<p>Here are the steps to creating a simple render note:</p>
-<ol>
- <li>
- <p>Create a note of type&nbsp;<a class="reference-link" href="#root/_help_HcABDtFCkbFN">Render Note</a>.</p>
- </li>
- <li>
- <p>Create a child&nbsp;<a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;note
- with JSX as the language.
- <br>As an example, use the following content:</p><pre><code class="language-text-x-trilium-auto">export default function() {
- return (
- &lt;&gt;
- &lt;p&gt;Hello world.&lt;/p&gt;
- &lt;/&gt;
- );
-}</code></pre>
- </li>
- <li>
- <p>In the parent render note, define a <code>~renderNote</code> relation pointing
- to the newly created child.</p>
- </li>
- <li>
- <p>Refresh the render note and it should display a “Hello world” message.</p>
- </li>
-</ol>
-<h2>Refreshing the note</h2>
-<p>It's possible to refresh the note via:</p>
-<ul>
- <li>The&nbsp;<span class="tn-icon bx bx-refresh"></span> button in&nbsp;the&nbsp;<a
- class="reference-link" href="#root/_help_1P8QXI5edXNd">Note buttons</a>&nbsp;area.</li>
- <li>The “Render active note” <a href="#root/_help_A9Oc6YKKc65v">keyboard shortcut</a> (not
- assigned by default).</li>
-</ul>
-<h2>Printing</h2>
-<p>A render note can be printed or exported as PDF from the <a class="reference-link"
- href="#root/_help_8YBEPzcpUgxw">Note menu</a> once its <code>~renderNote</code> relation
- is set (see <a class="reference-link" href="#root/_help_NRnIZmSMc5sj">Printing &amp; Exporting as PDF</a>).
- Unlike other notes, it is printed exactly as it is displayed: the script
- does not run again, so what was typed, selected or loaded in the note is
- kept.</p>
-<ul>
- <li>The content is laid out again at the width of the page, so elements sized
- by the script for the screen (such as charts) might not fit.</li>
- <li>Scrolling areas, such as a table in a scrolling container, are printed
- at their full height, without a scrollbar.</li>
- <li>To adjust the layout for printing, use a <code>~printCss</code> relation.</li>
- <li>The light colors are used for printing, whatever the current theme.</li>
-</ul>
-<p>When a render note is printed as part of a <a class="reference-link" href="#root/_help_mULW0Q3VojwY">List View</a> collection,
- or from another view such as its attachments, it is not on screen, so its
- script runs again for the print. In a collection, the output is printed
- without the note's own styles.</p>
-<h2>Examples</h2>
-<ul>
- <li><a class="reference-link" href="#root/_help_R7abl2fc6Mxi">Weight Tracker</a>&nbsp;which
- is present in the&nbsp;<a class="reference-link" href="#root/_help_6tZeKvSHEUiB">Demo Notes</a>.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Render Note_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Render Note_image.png
deleted file mode 100644
index 75e246c442..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Render Note_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Saved Search.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Saved Search.html
deleted file mode 100644
index c95f5b7311..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Saved Search.html
+++ /dev/null
@@ -1,26 +0,0 @@
-<p>Trilium allows you to save common searches as notes within the note tree.
- The search results will appear as sub-notes under these "saved search"
- notes. Here is an example of how it works:</p>
-<figure class="image image-style-align-center image_resized"
-style="width:50%;">
- <img style="aspect-ratio:812/585;" src="Saved Search_saved-search.gif"
- width="812" height="585">
-</figure>
-<p>A saved search runs when you open it, and when you expand it in the note
- tree. A saved search in a tab that is not shown, such as a background tab
- restored at startup, runs when you switch to that tab. Its results stay
- until you run the search again with the <em>Search</em> button of the search
- parameters. If the query has an error, it appears as a notification.</p>
-<p>In&nbsp;<a class="reference-link" href="#root/_help_64ZTlUPgEPtW">Safe mode</a>,
- and when the request fails, the search does not run on its own. Press <em>Search now</em> to
- run it.</p>
-<p>Once a search is saved, the <em>Search parameters</em> is still available
- underneath the&nbsp;<a class="reference-link" href="#root/_help_l7pigIGu01K2">Title</a>&nbsp;in
- order to be able to change the settings later on but it will appear collapsed
- by default.</p>
-<h2>Location</h2>
-<p>By default, saved searches are stored in the day note. However, you can
- designate a different note to store saved searches by marking it with the <code>#searchHome</code> label.
- Additionally, for <a href="#root/_help_9sRHySam5fXb">workspaces</a>, you
- can use the <code>#workspaceSearchHome</code> label to specify a storage
- location for saved searches within that workspace.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Saved Search_saved-search.gif b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Saved Search_saved-search.gif
deleted file mode 100644
index 72864f1cc8..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Saved Search_saved-search.gif and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Spreadsheets.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Spreadsheets.html
deleted file mode 100644
index 290ec8aadc..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Spreadsheets.html
+++ /dev/null
@@ -1,142 +0,0 @@
-<figure class="image">
- <img style="aspect-ratio:1102/573;" src="Spreadsheets_image.png" width="1102"
- height="573">
-</figure>
-<aside class="admonition important">
- <p>Spreadsheets are a new type of note introduced in v0.103.0 and are currently
- considered experimental/beta. As such, expect major changes to occur to
- this note type.</p>
-</aside>
-<p>Spreadsheets provide a familiar experience to Microsoft Excel or LibreOffice
- Calc, with support for formulas, data validation and text formatting.</p>
-<h2>Spreadsheets vs. collections</h2>
-<p>There is a slight overlap between spreadsheets and the&nbsp;<a class="reference-link"
- href="#root/_help_2FvYrpmOXm29">Table</a>&nbsp;collection. In general the
- table collection is useful to track meta-information about notes (for example
- a collection of people and their birthdays), whereas spreadsheets are quite
- useful for calculations since they support formulas.</p>
-<p>Spreadsheets also benefit from a wider range of features such as data
- validation, formatting and can work on a relatively large dataset.</p>
-<h2>Data intercompatibility (import/export)</h2>
-<p>Starting with v0.104.0, Trilium provides a level of data intercompatibility
- between the internal format (Univer) and the following formats:</p>
-<ul>
- <li>Microsoft Excel (.xlsx)
- <ul>
- <li>Preserves basic formatting (fonts, sizes, borders, backgrounds).</li>
- <li>Formulas are preserved, but note that not all Excel functions are supported
- and vice-versa with Univer.</li>
- <li>Images (cell-bound or floating), without preserving rotation.</li>
- <li>Supports multi-sheets natively.</li>
- </ul>
- </li>
- <li>Comma-Separated Values (.csv)
- <ul>
- <li>Since it's a text-based format, any formatting is lost.</li>
- <li>Formulas are evaluated and turned into their final value instead.</li>
- <li>Multi-sheets spreadsheets are exported as a single ZIP containing a CSV
- file per sheet.</li>
- </ul>
- </li>
-</ul>
-<p>Both <a href="#root/_help_mHbBMPDPkVV5">import and export</a> are supported,
- as follows:</p>
-<ul>
- <li>To import a file, simply drag it into the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;and it will be converted
- into a spreadsheet note.
- <ul>
- <li>To avoid this behavior (e.g. to import a .xlsx file as an actual&nbsp;<a
- class="reference-link" href="#root/_help_W8vYD3Q1zjCR">File</a>), uncheck
- the corresponding option in the <a href="#root/_help_mHbBMPDPkVV5">Import dialog</a>.</li>
- <li>Multiple files can be imported at the same time, including a mixture of
- .csv and .xlsx files. Folder structure can be preserved by using a .zip
- file.</li>
- </ul>
- </li>
- <li>Unlike importing, exporting is on a per-note basis:
- <ul>
- <li>In the&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a>,
- choose the <em>Export to Excel</em> or <em>Export to CSV</em> options.</li>
- <li>If exported as a single file via&nbsp;<a class="reference-link" href="#root/_help_mHbBMPDPkVV5">Import &amp; Export</a>,
- the resulting file will be a custom <code>.triliumsheet</code> file that
- preserves the spreadsheet as-is.
- <ul>
- <li>The export is intentionally a different process than the normal&nbsp;<a
- class="reference-link" href="#root/_help_mHbBMPDPkVV5">Import &amp; Export</a>&nbsp;functionality
- because it does conversion to multiple formats with varying degrees of
- compatibility.</li>
- </ul>
- </li>
- </ul>
- </li>
-</ul>
-<p>Cells pasted from Excel or another application keep their formatting except
- for the font, so they use the spreadsheet's font like the rest of the cells.</p>
-<aside
-class="admonition important">
- <p>Import &amp; export for both .xlsx and .csv files are supported on a best-effort
- basis. It does not support advanced features (data validation, scripting,
- etc.). If you notice a particular issue, it can be <a href="#root/_help_wy8So3yZZlH9">reported</a>,
- however all bug reports must contain a sample file in order to be taken
- into consideration.</p>
-</aside>
-<h2>Supported features</h2>
-<p>The spreadsheet has support for the following features:</p>
-<ul>
- <li>Since v0.104.0, images that can be either inside a cell or floating above.
- <ul>
- <li>The images are saved as&nbsp;<a class="reference-link" href="#root/_help_0vhv7lsOLy82">Attachments</a>&nbsp;for
- performance reasons.</li>
- <li>The image upload respects the same compression settings as text&nbsp;<a
- class="reference-link" href="#root/_help_mT0HEkOsz6i1">Images</a>.</li>
- </ul>
- </li>
- <li>Filtering</li>
- <li>Sorting</li>
- <li>Data validation</li>
- <li>Conditional formatting</li>
- <li>Notes / annotations</li>
- <li>Find / replace</li>
-</ul>
-<p>We might consider adding <a href="https://docs.univer.ai/guides/sheets/features/filter">other features</a> from
- Univer at some point. If there is a particular feature that can be added
- easily, it can be discussed over <a href="#root/_help_wy8So3yZZlH9">GitHub Issues</a>.</p>
-<h3>Share functionality</h3>
-<p>Spreadsheets can be <a href="#root/_help_R9pX4DGra2Vt">shared</a>, case
- in which a best-effort HTML rendering of the spreadsheet is done:</p>
-<ul>
- <li>Preserves basic formatting.</li>
- <li>Cells with formulas display the precalculated value instead of the formula.</li>
-</ul>
-<p>Since v0.104.0:</p>
-<ul>
- <li>Numbers and dates are properly formatted.</li>
- <li>Images are shown inside a cell or floating above, including rotation.</li>
-</ul>
-<p>For more advanced use cases, this will most likely not work as intended.
- Feel free to <a href="#root/_help_wy8So3yZZlH9">report issues</a>, but keep
- in mind that we might not be able to have a complete feature parity with
- all the features of Univer.</p>
-<h2>Features not supported yet</h2>
-<h3>Regarding Pro features</h3>
-<p>Univer spreadsheets also feature a <a href="https://univer.ai/pro">Pro plan</a> which
- adds quite a lot of functionality such as charts, printing, pivot tables,
- export, etc.</p>
-<p>As the Pro plan needs a license, Trilium does not support any of the premium
- features. Theoretically, pro features can be used in trial mode with some
- limitations, we might explore this direction at some point.</p>
-<h3>Planned features</h3>
-<p>There are a few features that are already planned but are not supported
- yet:</p>
-<ul>
- <li>Trilium-specific formulas (e.g. to obtain the title of a note).</li>
- <li>User-defined formulas</li>
- <li>Cross-workbook calculation</li>
-</ul>
-<p>If you would like us to work on these features, consider <a href="https://triliumnotes.org/en/support-us">supporting us</a>.</p>
-<h3>Mobile support</h3>
-<p>Versions prior to v0.104.0 have no dedicated mobile support, which means
- that the interaction is difficult without a mouse and keyboard. Starting
- with v0.104.0 we integrate Univer's mobile plugin, which introduces feature
- such as drag to pan which makes the interface more usable on mobile.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Spreadsheets_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Spreadsheets_image.png
deleted file mode 100644
index 6b957c220b..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Spreadsheets_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text.html
deleted file mode 100644
index 0e95aa43f9..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text.html
+++ /dev/null
@@ -1,204 +0,0 @@
-<p>The default note type in Trilium, text notes allow for rich formatting,
- tables, images, admonitions and a handful of other features.</p>
-<h2>Formatting bars</h2>
-<p>Most of the interaction with text notes is done via the built-in toolbars.
- Depending on preference, there are two different layouts:</p>
-<ul>
- <li>The <em>Floating toolbar</em> is hidden by default and only appears when
- needed. In this mode there are actually two different toolbars:
- <br>
- <img src="1_Text_image.png" width="496" height="91">
- <img src="2_Text_image.png" width="812" height="114">
- </li>
- <li>A toolbar that appears when text is selected. This provides text-level
- formatting such as bold, italic, text colors, inline code, etc.
- <br><em><img src="Text_image.png" width="1109" height="124"></em>
- </li>
-</ul>
-<p>Fore more information see&nbsp;<a class="reference-link" href="#root/_help_nRhnJkTT8cPs">Formatting toolbar</a>.</p>
-<h2>Features and formatting</h2>
-<p>Here's a list of various features supported by text notes:</p>
-<figure
-class="table">
- <table>
- <thead>
- <tr>
- <th>Dedicated article</th>
- <th>Feature</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><a class="reference-link" href="#root/_help_Gr6xFaF6ioJ5">General formatting</a>
- </td>
- <td>
- <ul>
- <li>Headings (section titles, paragraph)</li>
- <li>Font size</li>
- <li>Bold, italic, underline, strike-through</li>
- <li>Superscript, subscript</li>
- <li>Font color &amp; background color</li>
- <li>Remove formatting</li>
- </ul>
- </td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_S6Xx8QIWTV66">Lists</a>
- </td>
- <td>
- <ul>
- <li>Bulleted lists</li>
- <li>Numbered lists</li>
- <li>To-do lists</li>
- </ul>
- </td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_NwBbFdNZ9h7O">Block quotes &amp; admonitions</a>
- </td>
- <td>
- <ul>
- <li>Block quotes</li>
- <li>Admonitions</li>
- </ul>
- </td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_NdowYOC1GFKS">Tables</a>
- </td>
- <td>
- <ul>
- <li>Basic tables</li>
- <li>Merging cells</li>
- <li>Styling tables and cells.</li>
- <li>Table captions</li>
- </ul>
- </td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_UYuUB1ZekNQU">Developer-specific formatting</a>
- </td>
- <td>
- <ul>
- <li>Inline code</li>
- <li>Code blocks</li>
- <li>Keyboard shortcuts</li>
- </ul>
- </td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_AgjCISero73a">Footnotes</a>
- </td>
- <td>
- <ul>
- <li>Footnotes</li>
- </ul>
- </td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_mT0HEkOsz6i1">Images</a>
- </td>
- <td>
- <ul>
- <li>Images</li>
- </ul>
- </td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_QEAPj01N5f7w">Links</a>
- </td>
- <td>
- <ul>
- <li>External links</li>
- <li>Internal Trilium links</li>
- </ul>
- </td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_nBAXQFj20hS1">Include Note</a>
- </td>
- <td>
- <ul>
- <li>Include note</li>
- </ul>
- </td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_klC3ilXa9kUE">Block references</a>
- </td>
- <td>
- <ul>
- <li>Links to blocks of a note</li>
- <li>Including blocks of a note</li>
- </ul>
- </td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_CohkqWQC1iBv">Insert buttons</a>
- </td>
- <td>
- <ul>
- <li>Symbols</li>
- <li><a class="reference-link" href="#root/_help_YfYAtQBcfo5V">Math Equations</a>
- </li>
- <li>Mermaid diagrams</li>
- <li>Horizontal ruler</li>
- <li>Page break</li>
- </ul>
- </td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_dEHYtoWWi8ct">Other features</a>
- </td>
- <td>
- <ul>
- <li>Indentation
- <ul>
- <li>Markdown import</li>
- </ul>
- </li>
- <li><a class="reference-link" href="#root/_help_2x0ZAX9ePtzV">Cut to subnote</a>
- </li>
- </ul>
- </td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_gLt3vA97tMcp">Premium features</a>
- </td>
- <td>
- <ul>
- <li><a class="reference-link" href="#root/_help_ZlN4nump6EbW">Slash Commands</a>
- </li>
- <li><a class="reference-link" href="#root/_help_KC1HB96bqqHX">Templates</a>
- </li>
- <li><a class="reference-link" href="#root/_help_5wZallV2Qo1t">Format Painter</a>
- </li>
- </ul>
- </td>
- </tr>
- </tbody>
- </table>
-</figure>
-<h2>Read-Only vs. Editing Mode</h2>
-<p>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&nbsp;<a class="reference-link"
- href="#root/_help_CoFPLs3dRlXc">Read-Only Notes</a>.</p>
-<h2>Keyboard shortcuts</h2>
-<p>There are numerous keyboard shortcuts to format the text without having
- to use the mouse. For a reference of all the key combinations, see&nbsp;<a
- class="reference-link" href="#root/_help_A9Oc6YKKc65v">Keyboard Shortcuts</a>.
- In addition, see&nbsp;<a class="reference-link" href="#root/_help_QrtTYPmdd1qq">Markdown-like formatting</a>&nbsp;as
- an alternative to the keyboard shortcuts.</p>
-<h2>Content width</h2>
-<p>For readability purposes on wider screens, the width of text notes is
- limited via a configurable option. See&nbsp;<a class="reference-link" href="#root/_help_t596jLvPrqkS">Content width</a>&nbsp;for
- more information.</p>
-<h2>Converting to a Markdown note</h2>
-<p>Text notes can be converted to&nbsp;<a class="reference-link" href="#root/_help_6RM1Q7ppFVoj">Markdown</a>&nbsp;notes.
- See&nbsp;<a class="reference-link" href="#root/_help_jludwdW7N4hg">Converting between note types</a>.</p>
-<h2>Technical details</h2>
-<p>For the text editing functionality, Trilium uses a commercial product
- (with an open-source base) called&nbsp;<a class="reference-link" href="#root/_help_MI26XDLSAlCD">CKEditor</a>.
- This brings the benefit of having a powerful WYSIWYG (What You See Is What
- You Get) editor.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/1_Block quotes & admonitions_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/1_Block quotes & admonitions_image.png
deleted file mode 100644
index afc26f32c2..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/1_Block quotes & admonitions_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/1_General formatting_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/1_General formatting_image.png
deleted file mode 100644
index aa65a36f0a..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/1_General formatting_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/1_Insert buttons_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/1_Insert buttons_image.png
deleted file mode 100644
index b6b4179317..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/1_Insert buttons_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/1_Insert buttons_plus.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/1_Insert buttons_plus.png
deleted file mode 100644
index 723ca82d71..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/1_Insert buttons_plus.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/1_Link Previews_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/1_Link Previews_image.png
deleted file mode 100644
index a36b38cdb1..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/1_Link Previews_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/1_Other features_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/1_Other features_image.png
deleted file mode 100644
index 4c702d5383..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/1_Other features_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/1_Tables_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/1_Tables_image.png
deleted file mode 100644
index 092a053e56..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/1_Tables_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/2_Developer-specific formatting_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/2_Developer-specific formatting_image.png
deleted file mode 100644
index c0cf731a5f..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/2_Developer-specific formatting_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/2_Formatting toolbar_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/2_Formatting toolbar_image.png
deleted file mode 100644
index 785ce7fc54..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/2_Formatting toolbar_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/2_General formatting_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/2_General formatting_image.png
deleted file mode 100644
index d19a5e7a0d..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/2_General formatting_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/2_Insert buttons_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/2_Insert buttons_image.png
deleted file mode 100644
index 28711b3cb0..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/2_Insert buttons_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/2_Link Previews_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/2_Link Previews_image.png
deleted file mode 100644
index 9d74aab0dd..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/2_Link Previews_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/2_Tables_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/2_Tables_image.png
deleted file mode 100644
index 3394d46617..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/2_Tables_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/3_Formatting toolbar_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/3_Formatting toolbar_image.png
deleted file mode 100644
index 44b3746526..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/3_Formatting toolbar_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/3_General formatting_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/3_General formatting_image.png
deleted file mode 100644
index 7d1208b108..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/3_General formatting_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/3_Insert buttons_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/3_Insert buttons_image.png
deleted file mode 100644
index 20581dfa7b..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/3_Insert buttons_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/3_Tables_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/3_Tables_image.png
deleted file mode 100644
index 099b253570..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/3_Tables_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/4_Images_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/4_Images_image.png
deleted file mode 100644
index 8fa28fbf98..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/4_Images_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Anchors.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Anchors.html
deleted file mode 100644
index efbb99feb0..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Anchors.html
+++ /dev/null
@@ -1,67 +0,0 @@
-<aside class="admonition note">
- <p>This feature used to be called <em>Bookmarks</em> (as it is the official
- name in the editor we are using), but in order not to collide with the
- concept of&nbsp;<a class="reference-link" href="#root/_help_u3YFHC9tQlpm">Bookmarks</a>,
- we have renamed it to <em>Anchors.</em>
- </p>
-</aside>
-<p>Anchors allows creating <a href="#root/_help_QEAPj01N5f7w">links</a> to
- a certain part of a note, such as referencing a particular heading or section
- within a note.</p>
-<p>This feature was introduced in TriliumNext v0.94.0 and augmented in v0.103.0
- to support linking across notes.</p>
-<h2>Interaction</h2>
-<ul>
- <li>To create a anchor:
- <ul>
- <li>Place the cursor at the desired position where to place the anchor.</li>
- <li>Look for the&nbsp;<span class="tn-icon bx bx-plus"></span> button in the&nbsp;<a
- class="reference-link" href="#root/_help_nRhnJkTT8cPs">Formatting toolbar</a>,
- and then press the&nbsp;<span class="tn-icon cke cke-bookmark"></span> button.</li>
- <li>Alternatively, use&nbsp;<a class="reference-link" href="#root/_help_ZlN4nump6EbW">Slash Commands</a>&nbsp;and
- look for <em>anchor</em>.</li>
- </ul>
- </li>
- <li>To place a link to a anchor:
- <ul>
- <li>Place the cursor at the desired position of the link.</li>
- <li>From the <a href="#root/_help_QEAPj01N5f7w">link</a> pane, select the <em>Anchors</em> section
- and select the desired anchor.</li>
- </ul>
- </li>
-</ul>
-<h2>Linking across notes</h2>
-<p>Trilium v0.103.0 introduces cross-note Anchors, which makes it possible
- to create&nbsp;<a class="reference-link" href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a>&nbsp;which
- point to a specific anchor in that document.</p>
-<h3>Compatibility with documents from previous versions</h3>
-<p>For notes created prior to Trilium v0.103.0, you might notice that the
- Anchors might not be identified. This limitation is intentional in order
- not to have to re-process all the notes, looking for anchors.</p>
-<p>To fix this, simply go that note and make any change (e.g. inserting a
- space), this will trigger the recalculation of the links.</p>
-<h3>Linking to anchors through the <em>Add link</em> dialog</h3>
-<ol>
- <li>Create an anchor in the target note using the same process as described
- above.</li>
- <li>In another note, press <kbd>Ctrl</kbd>+<kbd>L</kbd> to insert an internal
- link. Select the target note containing Anchors.</li>
- <li>If the target note contains Anchors, a section will appear underneath
- the note selector with the list of Anchors.</li>
- <li>Add the link normally.</li>
-</ol>
-<p>Clicking on a reference link pointing to a anchor will automatically scroll
- to the desired section.</p>
-<h3>Linking to anchors through the bookmark toolbar</h3>
-<ol>
- <li>Create an anchor in the target note using the same process as described
- above.</li>
- <li>Click on the anchor to reveal the anchor's floating toolbar.</li>
- <li>Click on the <span class="tn-icon cke cke-trilium-copy"></span> <em>Copy anchor reference link</em> button.</li>
- <li>Go to the note where to insert the link and press <kbd>Ctrl</kbd>+<kbd>V</kbd>.</li>
-</ol>
-<aside class="admonition note">
- <p>Use this method only to insert&nbsp;<a class="reference-link" href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a>&nbsp;between
- two documents. To link to an anchor on the same note, use the <em>Insert link</em> dialog
- (<kbd>Ctrl</kbd>+<kbd>K</kbd>) and select the <em>Anchors</em> item instead.</p>
-</aside>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Automatic replacements.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Automatic replacements.html
deleted file mode 100644
index 1490e5bd45..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Automatic replacements.html
+++ /dev/null
@@ -1,131 +0,0 @@
-<h2>Automatic replacements</h2>
-<p>As you type in a text note, certain character sequences are replaced with
- the typographic symbol they represent. Typing <code>(c)</code> gives you <code>©</code>, <code>...</code> gives
- you <code>…</code>, and <code>"quote"</code> gives you <code>“quote”</code>.</p>
-<p>These replacements are not applied inside code blocks or inline code,
- and pasted text is never affected, only text you type. If you have pasted
- a code snippet, or written one inside a code block, its characters are
- left exactly as they are.</p>
-<h3>Undoing a replacement</h3>
-<p>Once an automatic replacement takes place, it can be undone by:</p>
-<ul>
- <li>Pressing <kbd>Backspace</kbd> immediately after a replacement undoes it
- and restores what you typed.
- <ul>
- <li>Note that this consumes the undo, so a further <kbd>Ctrl</kbd>+<kbd>Z</kbd> might
- delete your typed text.</li>
- <li>Pressing <kbd>Space</kbd> or changing the cursor position disables this
- functionality.</li>
- </ul>
- </li>
- <li>Pressing <kbd>Ctrl</kbd>+<kbd>Z</kbd>, which works even after pressing
- space.</li>
-</ul>
-<h3>Replacement groups &amp; configuration</h3>
-<p>Each group can be turned off in&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Text notes</em> → <em>Automatic replacements</em>.</p>
-<figure
-class="table">
- <table>
- <thead>
- <tr>
- <th>Group</th>
- <th>What it replaces</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>Punctuation</td>
- <td><code>...</code> with an ellipsis (<code>…</code>), and <code>--</code> and <code>---</code> <em>surrounded by spaces</em> with
- an en dash (<code>–</code>) and an em dash (<code>—</code>)</td>
- </tr>
- <tr>
- <td>Mathematical symbols</td>
- <td>fractions such as <code>1/2</code> with <code>½</code>, and the operators <code>&lt;=</code>, <code>&gt;=</code>, <code>!=</code>, <code>&lt;-</code> and <code>-&gt;</code> with <code>≤</code>, <code>≥</code>, <code>≠</code>, <code>←</code> and <code>→</code>
- </td>
- </tr>
- <tr>
- <td>Copyright and trademark</td>
- <td><code>(c)</code>, <code>(r)</code> and <code>(tm)</code> with <code>©</code>, <code>®</code> and <code>™</code>
- </td>
- </tr>
- <tr>
- <td>Quotation marks</td>
- <td>straight quotes with typographic ones — see below</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<h2>Quotation marks</h2>
-<p>Quotation marks are configured separately from the rest, with one setting
- for the <strong>double</strong> quote key and one for the <strong>single</strong> quote
- key, because which pair belongs on which key differs between conventions:
- British typography traditionally sets a quotation in <code>‘…’</code> where
- American sets it in <code>“…”</code>.</p>
-<p>Each offers:</p>
-<ul>
- <li><em>Based on the note's content language</em> (the default) — English gives <code>“quote”</code>,
- German <code>„quote“</code>, French <code>« quote »</code>, Japanese <code>「quote」</code>.
- See&nbsp;<a class="reference-link" href="#root/_help_veGu4faJErEM">Content language &amp; Right-to-left support</a>&nbsp;for
- how a note's language is decided.</li>
- <li><em>Disabled,</em> straight quotes stay straight.</li>
- <li>A specific pair_:_ <code>“…”</code>, <code>‘…’</code>, <code>„…“</code>, <code>„…”</code>, <code>«…»</code>, <code>« … »</code>, <code>‹…›</code>, <code>「…」</code>, <code>『…』</code>.
- Choosing one applies it to every note, regardless of its content language.</li>
-</ul>
-<h2>Custom replacements</h2>
-<p>You can add your own under&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Text notes</em> → <em>Automatic replacements</em> → <em>Custom replacements</em>.
- Type the text to replace and the replacement, then press Enter. Existing
- ones are shown as chips and removed with the × on each.</p>
-<p>A custom replacement is applied when the text is typed as a whole word
- and followed by a space, so longer words that begin with it are left alone
- — a <code>TN</code> replacement does not rewrite the end of <code>BTN</code>,
- and <code>TNT</code> can still be typed.</p>
-<p>Capitalization follows what you type, unless the replacement has capitals
- of its own:</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th><strong>Replacement you defined</strong>
- </th>
- <th><strong>You type</strong>
- </th>
- <th><strong>You get</strong>
- </th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>teh</code> → <code>the</code>
- </td>
- <td><code>teh</code> / <code>Teh</code> / <code>TEH</code>
- </td>
- <td><code>the</code> / <code>The</code> / <code>THE</code>
- </td>
- </tr>
- <tr>
- <td><code>TN</code> → <code>Trilium Notes</code>
- </td>
- <td><code>TN</code> or <code>tn</code>
- </td>
- <td><code>Trilium Notes</code> (unchanged, it has capitals)</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<p>Of note:</p>
-<ul>
- <li>The text to replace is matched literally; it is not a pattern.</li>
- <li>Typing a "text to replace" that already exists in the list of replacements
- will update the existing one instead. It's not possible to have multiple
- replacements for the same text.</li>
- <li>The same “text to replace” with different capitalization (e.g. <code>TN</code> and <code>tn</code> co-existing)
- doesn't work because it would interfere with the capitalization rules above.</li>
-</ul>
-<h2>Characters that only look replaced (ligatures)</h2>
-<p>If you see <code>!=</code> displayed as <code>≠</code> or <code>-&gt;</code> as <code>→</code> inside
- a code block, that is not a replacement since replacements never run there
- (unless a code block is applied to an existing text). It is a <em>font ligature</em>:
- the default monospace font draws certain character pairs as a single symbol.
- The underlying text is unchanged, and copying it out gives you back <code>!=</code> and <code>-&gt;</code>.</p>
-<p>This can be turned off with&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a><em>→ Appearance → Fonts → Programming ligatures.</em>
-</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Block quotes & admonitions.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Block quotes & admonitions.html
deleted file mode 100644
index 65e4b2a139..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Block quotes & admonitions.html
+++ /dev/null
@@ -1,64 +0,0 @@
-<h2>Block quotes</h2>
-<p>As the name suggests, block quotes can be useful to cite one or more paragraphs.</p>
-<p>To create a block quote, press&nbsp;<span class="tn-icon cke cke-quote"></span> from
- the&nbsp;<a class="reference-link" href="#root/_help_nRhnJkTT8cPs">Formatting toolbar</a>.
- It's also possible to type <kbd>&gt;</kbd>, followed by a space to create
- one (but only if the cursor is at the beginning of a line).</p>
-<p>Inside the quote block, other block items can be inserted such as tables,
- images, or even other block quotes or admonitions.</p>
-<h2>Admonitions</h2>
-<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>
-<figure
-class="image image-style-align-center">
- <img style="aspect-ratio:959/547;" src="1_Block quotes & admonitions_image.png"
- width="959" height="547">
-</figure>
-<p>From a functional point of view, admonitions act very similarly to a block
- quote, just with different styling. This includes the ability to insert
- other elements in it such as headings, tables, images, etc.</p>
-<h3>Inserting a new admonition</h3>
-<p>In the&nbsp;<a class="reference-link" href="#root/_help_nRhnJkTT8cPs">Formatting toolbar</a>:</p>
-<p>
- <img src="Block quotes & admonitions_image.png">
-</p>
-<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>&nbsp;
- followed by any text, case in which a default admonition type will appear
- (note) with the entered text inside it.</p>
-<h3>Interaction</h3>
-<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>
-<h3>Types of admonitions</h3>
-<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>
-<h3>Markdown support</h3>
-<p>See&nbsp;<a class="reference-link" href="#root/_help_rJ9grSgoExl9">Supported syntax</a>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Block quotes & admonitions_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Block quotes & admonitions_image.png
deleted file mode 100644
index 175c661f79..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Block quotes & admonitions_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Block references.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Block references.html
deleted file mode 100644
index 4dfec004bb..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Block references.html
+++ /dev/null
@@ -1,72 +0,0 @@
-<p>Block references are <a href="#root/_help_QEAPj01N5f7w">links</a> to a block
- of a text note, such as a paragraph, a heading, a list item or a table,
- or to a range of consecutive blocks. A block reference can be pasted in
- another note as a link, or turned into an <a class="reference-link" href="#root/_help_nBAXQFj20hS1">Include Note</a> that
- shows only the referenced blocks.</p>
-<h2>Copying a reference</h2>
-<ol>
- <li>Place the cursor in the block to reference. To reference several consecutive
- blocks, select them.</li>
- <li>Right-click the block handle, the sequence of dots to the left of the
- block (see <a class="reference-link" href="#root/_help_nRhnJkTT8cPs">Formatting toolbar</a>).
- Alternatively, right-click the text and open the <em>Copy</em> submenu.</li>
- <li>Select <em>Copy reference to this block</em>, or <em>Copy reference to these blocks</em> for
- a selection. The referenced blocks flash briefly.</li>
- <li>Go to the note where to insert the link and press <kbd>Ctrl</kbd>+<kbd>V</kbd>.</li>
-</ol>
-<p>Inside a <a class="reference-link" href="#root/_help_EK2ckIZ74tbT">Content tabs</a> block,
- the reference points to the whole block. To link to a single tab, use <em>Copy link to tab</em> instead.
- Inside a <a class="reference-link" href="#root/_help_wYDzQ1fBFgfT">Multicolumn layout</a>,
- the reference points to the blocks in the column, and an include shows
- them without the layout around them.</p>
-<p>The link shows the title of the note, followed by the beginning of the
- referenced text. A link to blocks of the same note shows only the beginning
- of the referenced text.</p>
-<p>If the note is <a href="#root/_help_R9pX4DGra2Vt">shared</a>, the menu
- of the block handle also offers <em>Copy public link to this block</em>.
- It copies the web address of the shared page with the reference added,
- to send to people who read the note outside Trilium. Opening the address
- scrolls the shared page to the referenced blocks and flashes them.</p>
-<p>The <em>Paste</em> submenu of the context menu offers two more ways to insert
- a copied reference:</p>
-<ul>
- <li><em>Paste reference as a link</em> inserts only the link, even when the
- reference was copied as plain text or along with other content.</li>
- <li><em>Paste reference as an excerpt</em> inserts an include of the referenced
- blocks, as described below.</li>
-</ul>
-<p>In a browser, the context menu of the text editor opens only when right-clicking
- selected text. Elsewhere the browser shows its own menu.</p>
-<h2>Following a reference</h2>
-<p>Clicking a block reference opens the note, scrolls to the referenced blocks
- and flashes them. If a referenced block was deleted, an error message is
- shown instead, along with the blocks of the range that still exist.</p>
-<h2>Including the referenced blocks</h2>
-<p>To show the referenced blocks inside another note, right-click the link
- in a note being edited and select <em>Convert link to note excerpt</em>,
- or paste the copied reference with <em>Paste</em> → <em>Paste reference as an excerpt</em>.
- The include shows only the referenced blocks, not the rest of the note,
- and marks them with an <em>Excerpt</em> badge in its title. It starts at
- the <em>Full</em> box size, so all the referenced blocks are visible. To
- see the whole note, press the <span class="tn-icon bx bx-link-external"></span> button
- in the same title, which opens the note in a new tab. Converting the include
- back to a link keeps the reference.</p>
-<p>To edit the referenced blocks without leaving the note, press the <span
- class="tn-icon bx bx-pencil"></span> <em>Edit excerpt</em> button in the
- title of the include, or turn on <em>Editable</em> (<span class="tn-icon bx bx-edit-alt"></span>)
- in its toolbar, as for any <a class="reference-link" href="#root/_help_nBAXQFj20hS1">Include Note</a>.
- Press the button again to stop editing. The changes are saved to the referenced
- blocks, and the rest of the note stays as it is. The button is grayed out
- where the blocks cannot be edited, such as in a read-only note. An excerpt
- has no <em>Fullscreen</em> button.</p>
-<p>If a referenced block was deleted, the include shows <em>Broken reference</em>.</p>
-<h2>Limitations</h2>
-<ul>
- <li>References can be copied only from a note being edited, and not in the
- mobile layout.</li>
- <li>An include of a range that covers only part of a list or a quote, such
- as from its second item to a paragraph after it, cannot be edited in place.</li>
- <li>Deleting a block breaks the references to it.</li>
- <li>Block references are not kept when exporting to Markdown. On a <a href="#root/_help_R9pX4DGra2Vt">shared page</a>,
- a block reference opens the whole note.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Collapsible blocks.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Collapsible blocks.html
deleted file mode 100644
index df27bdfc28..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Collapsible blocks.html
+++ /dev/null
@@ -1,27 +0,0 @@
-<p>Collapsible blocks are sections of content that can be expanded and collapsed,
- letting you hide detail until it's needed.</p>
-<p>A collapsible block consists of:</p>
-<ul>
- <li><strong>An always-visible header</strong>, containing:
- <ul>
- <li><strong>An arrow</strong> that expands or collapses the block when clicked.</li>
- <li><strong>A summary line</strong> that acts as the block's title. With the
- cursor in the summary line, press <kbd>Ctrl</kbd>+<kbd>Enter</kbd> to expand
- or collapse the block.</li>
- <li><strong>A drag handle</strong> for repositioning the block within the note.</li>
- </ul>
- </li>
- <li><strong>The body</strong>, which is hidden while the block is collapsed.
- It can hold any kind of content, including nested collapsible blocks. To
- break out of a collapsible block and continue typing outside it, press <kbd>Enter</kbd> twice
- at the end of the block.</li>
-</ul>
-<p>You can use the arrow keys to move freely with the cursor between the
- summary line, the block's body, and the text around the block.</p>
-<h2>Inserting a collapsible block</h2>
-<p>In the formatting bar, go to <em>Insert</em> → <em>Collapsible Block</em>.</p>
-<aside
-class="admonition tip">
- <p>Place multiple collapsible blocks one after another to create an accordion,
- where each block can be expanded or collapsed independently.</p>
-</aside>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Content language & Right-to-left support.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Content language & Right-to-left support.html
deleted file mode 100644
index 277e62a28c..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Content language & Right-to-left support.html
+++ /dev/null
@@ -1,35 +0,0 @@
-<p>
- <img src="Content language & Right-to-left support_image.png">
-</p>
-<p>The content language determines:</p>
-<ul>
- <li>The spell-checking of the note, when in a browser. The desktop installation
- has a dedicated spellchecking section.</li>
- <li>Whether the text is displayed from right-to-left, for languages such as
- Arabic, Hebrew, etc.</li>
- <li>How typed quotes are <a href="#root/_help_oI7GoyilXXAr">automatically replaced</a> (e.g.
- English uses <code>“text”</code>, whereas some languages use <code>«text»</code>).
- This applies only if&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Text</em> → <em>Single/Double quotation marks</em> is
- set to <em>Based on note's content language</em>.</li>
- <li>Which languages are offered by the&nbsp;<a class="reference-link" href="#root/_help_VRoP0g1uHHc2">In-editor AI assistant</a>&nbsp;for
- translation.</li>
- <li>The language and the text direction the content is marked with on a <a
- href="#root/_help_R9pX4DGra2Vt">shared page</a>, which screen readers and
- browsers follow.</li>
-</ul>
-<h2>Setting the language of a single note</h2>
-<p>To set the language of the content of a&nbsp;<a class="reference-link"
- href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;note, there is a language
- selector in the&nbsp;<a class="reference-link" href="#root/_help_AlJ73vBCjWDw">Status bar</a>&nbsp;indicated
- by a&nbsp;<span class="tn-icon bx bx-globe"></span> icon.</p>
-<h2>Adjusting the list of languages</h2>
-<p>By default there will be no language configured, they can be configured
- by going to&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→
- Language &amp; Region or by selecting the <em>Configure languages</em> item
- when setting the language.</p>
-<h2>Default content language</h2>
-<p>Notes that do not have a language of their own follow&nbsp;<a class="reference-link"
- href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Language &amp; Region</em> → <em>Default content language</em>.
- It is set to English initially, and can be set to any content language,
- or to <em>Based on the application's language</em>.</p>
-<p>If a note has a language set, it always takes precedence over the default.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Content tabs.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Content tabs.html
deleted file mode 100644
index c46a432cc9..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Content tabs.html
+++ /dev/null
@@ -1,161 +0,0 @@
-<p>Content tabs group several titled panels of content into one block that
- shows a single panel at a time. They suit content that comes in variants
- (such as installation steps for each operating system or the same snippet
- in several programming languages).</p>
-<p>A tabs block consists of:</p>
-<ul>
- <li><strong>A single row of tab titles</strong>, above the panel or, when
- the tabs are aligned at the bottom, below it. The title of the panel that
- is showing is highlighted.</li>
- <li><strong>The panel of the active tab.</strong> A panel can hold any kind
- of content (including nested tabs blocks).</li>
-</ul>
-<h2>Inserting a tabs block</h2>
-<ul>
- <li>In the formatting bar, go to <em>Insert</em> → <em>Tabs</em>.</li>
- <li>Alternatively, type <code>/tabs</code> and press <kbd>Enter</kbd>, as described
- in&nbsp;<a class="reference-link" href="#root/_help_ZlN4nump6EbW">Slash Commands</a>.</li>
-</ul>
-<p>A new block contains two tabs, named “Tab 1” and “Tab 2”. Any content
- that was selected prior to inserting the tabs will be moved into the first
- tab. The title of the first tab is selected, so typing replaces it.</p>
-<h2>Scrolling through the titles</h2>
-<p>When the titles of a block do not fit on their row, a <span class="tn-icon bx bx-chevron-left"></span> button
- and a <span class="tn-icon bx bx-chevron-right"></span> button appear at
- its ends:</p>
-<ul>
- <li>To scroll the titles, click one of the buttons. Holding a button down
- scrolls the titles continuously until it is released.</li>
- <li>On a touch screen, the titles can also be swiped sideways.</li>
-</ul>
-<p>Whenever another tab is shown (for example by clicking its title, by moving
- the cursor into it or by following a link to it), the row scrolls so that
- its whole title is visible. This works the same while editing, in read-only
- notes and on shared pages.</p>
-<h2>Editing tabs</h2>
-<ul>
- <li>To show a tab, click its title or move the cursor into it.</li>
- <li>To move from a title into its panel, press <kbd>Enter</kbd>.</li>
- <li>The label of a tab can be formatted just like normal text, including support
- for&nbsp;<a class="reference-link" href="#root/_help_hD8GawVuazff">Icons</a>.</li>
-</ul>
-<p>While the cursor is inside a tabs block, a toolbar appears above it with
- the following buttons:</p>
-<ul>
- <li><span class="tn-icon cke cke-plus"></span>&nbsp;<em>(Add tab)</em> inserts
- a tab after the current one and selects its title.</li>
- <li><span class="tn-icon cke cke-remove"></span>&nbsp;<em>(Remove tab)</em> removes
- the current tab. Removing the last tab removes the whole block.</li>
- <li><span class="tn-icon cke cke-chevron-right bx-flip-horizontal"></span>&nbsp;<em>(Move tab left)</em> and&nbsp;<span
- class="tn-icon cke cke-chevron-right"></span> (<em>Move tab right)</em> change
- the order of the tabs.</li>
- <li><span class="tn-icon cke cke-link"></span>&nbsp;<em>(Copy link to tab)</em> copies
- a link to the current tab, as described below.</li>
- <li><span class="tn-icon cke cke-trilium-tabs"></span>&nbsp;<em>(Tab alignment)</em> places
- the tab titles above the panel (<em>Align tabs at top</em>, the default)
- or below it (<em>Align tabs at bottom</em>).</li>
-</ul>
-<p>The tab that is showing is not saved with the note: every tabs block opens
- on its first tab.</p>
-<h3>Adding tabs</h3>
-<p>While the cursor is in a tab, either in its title or in its panel, you
- can use these key combinations:</p>
-<ul>
- <li><kbd>Ctrl</kbd> + <kbd>Enter</kbd>: Add a tab after the current one.</li>
- <li><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Enter</kbd>: Add a tab before the
- current one.</li>
-</ul>
-<p>The new tab is shown and its title is selected, so typing replaces it.</p>
-<p><kbd>Ctrl</kbd> + <kbd>Enter</kbd> keeps its usual function on a link, in
- a to-do item and in the title of a collapsible block, and <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Enter</kbd> in
- a to-do item.</p>
-<h3>Reordering tabs</h3>
-<p>While the cursor is in a tab, either in its title or in its panel, you
- can use these key combinations:</p>
-<ul>
- <li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Right</kbd>: Move the tab to the right.</li>
- <li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Left</kbd>: Move the tab to the left.</li>
- <li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Home</kbd>: Make it the first tab.</li>
- <li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>End</kbd>: Make it the last tab.</li>
-</ul>
-<h2>Moving content between tabs</h2>
-<p>To move content to another tab, select it in the panel, and then use these
- key combinations:</p>
-<ul>
- <li><kbd>Ctrl</kbd> + <kbd>Right</kbd>: Move to the tab on the right.</li>
- <li><kbd>Ctrl</kbd> + <kbd>Left</kbd>: Move to the tab on the left.</li>
- <li><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>End</kbd>: Move to the last tab.</li>
- <li><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Home</kbd>: Move to the first tab.</li>
-</ul>
-<p>The tab that receives the content is shown, with the content still selected,
- so pressing the key again moves it on to the next tab. Paragraphs, list
- items, tables and other blocks move whole, even when only part of them
- is selected. Content moved to a tab on the left goes to the end of that
- tab, and content moved to a tab on the right goes to its start, so it keeps
- its place in the reading order.</p>
-<p>Without a selection, or with a selection in a tab title, these keys keep
- their usual function: moving the cursor by word, or selecting up to the
- start or end of the tab.</p>
-<p>When a tabs block and a <a class="reference-link" href="#root/_help_wYDzQ1fBFgfT">Multicolumn layout</a> are
- nested in one another, the key combinations act on the one closest to the
- cursor.</p>
-<h2>Reading tabs</h2>
-<p>In&nbsp;<a class="reference-link" href="#root/_help_CoFPLs3dRlXc">Read-Only Notes</a>&nbsp;and
- on&nbsp;<a class="reference-link" href="#root/_help_R9pX4DGra2Vt">Sharing</a>,
- tabs blocks work as tabs as well:</p>
-<ul>
- <li>To show a tab, click its title, or focus it and press <kbd>Enter</kbd> or <kbd>Space</kbd>.</li>
- <li>To move between the titles of a block, use the arrow keys, <kbd>Home</kbd> and <kbd>End</kbd>.</li>
-</ul>
-<p>A tab without a title shows “Tab title” in place of one.</p>
-<p>In read-only notes, a title too long for its tab fades out where it is
- cut off. To read the rest of it, swipe it sideways or drag it with the
- mouse.</p>
-<h2>Linking to a tab</h2>
-<p>A link can point to a single tab, much like a link to a block (see&nbsp;<a
- class="reference-link" href="#root/_help_klC3ilXa9kUE">Block references</a>):</p>
-<ol>
- <li>Place the cursor in the tab, either in its title or in its panel.</li>
- <li>Press <em>Copy link to tab</em> (<span class="tn-icon cke cke-link"></span>)
- in the toolbar of the tabs block. Alternatively, right-click the text and
- select <em>Copy</em> → <em>Copy link to this tab</em>. The tab flashes briefly.</li>
- <li>Go to the note where to insert the link and press <kbd>Ctrl</kbd>+<kbd>V</kbd>.</li>
-</ol>
-<p>The link shows the title of the note, followed by the title of the tab.
- Clicking it opens the note, shows the tab and flashes it. As with any block
- reference, the link can be turned into an&nbsp;<a class="reference-link"
- href="#root/_help_nBAXQFj20hS1">Include Note</a>&nbsp;that shows only that
- tab.</p>
-<p>Links to a tab can be copied only from a note being edited. On a <a href="#root/_help_R9pX4DGra2Vt">shared page</a>,
- such a link opens the whole note.</p>
-<h2>Content in hidden tabs</h2>
-<p>Content inside a tab that is not showing is still reachable (both while
- editing and while reading). The tab that holds it is shown when:</p>
-<ul>
- <li>searching the note with <kbd>Ctrl</kbd>+<kbd>F</kbd> highlights a match
- inside it;</li>
- <li>a link points to an anchor or a block inside it (see&nbsp;<a class="reference-link"
- href="#root/_help_oSuaNgyyKnhu">Anchors</a>&nbsp;and&nbsp;<a class="reference-link"
- href="#root/_help_klC3ilXa9kUE">Block references</a>);</li>
- <li>an entry of the&nbsp;<a class="reference-link" href="#root/_help_BFvAtE74rbP6">Table of contents</a>&nbsp;or
- the&nbsp;<a class="reference-link" href="#root/_help_AxshuNRegLAv">Highlights list</a>&nbsp;points
- inside it;</li>
- <li>on a shared page, the address of the page points to a heading or an anchor
- inside it.</li>
-</ul>
-<p>Tab titles are not headings, so they do not appear in the table of contents;
- headings inside a panel do.</p>
-<h2>Printing and exporting</h2>
-<ul>
- <li>When printing or <a href="#root/_help_NRnIZmSMc5sj">exporting to PDF</a>,
- every tab is printed, one after another, each with its title above its
- panel, whatever the tab alignment.</li>
- <li>Markdown export and import write tabs blocks in the content tabs syntax
- of Material for MkDocs, described in&nbsp;<a class="reference-link" href="#root/_help_rJ9grSgoExl9">Supported syntax</a>.&nbsp;<a
- class="reference-link" href="#root/_help_6RM1Q7ppFVoj">Markdown</a>&nbsp;notes
- use the same syntax, show the blocks as tabs in their preview and insert
- them with <code>/tabs</code>. That syntax has no tab alignment, so tabs
- aligned at the bottom are exported as regular tabs.</li>
- <li>Anywhere the tabs cannot work as tabs (such as an HTML export opened elsewhere),
- a tabs block reads as a sequence of titled sections.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Cut to subnote.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Cut to subnote.html
deleted file mode 100644
index ac577c61a5..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Cut to subnote.html
+++ /dev/null
@@ -1,17 +0,0 @@
-<figure class="image image_resized image-style-align-right" style="width:64.63%;">
- <img style="aspect-ratio:812/585;" src="Cut to subnote_cut-to-subnote.gif"
- width="812" height="585">
-</figure>
-<p>When editing a document that becomes too large, you can split it into
- sub-notes:</p>
-<ol>
- <li>Select the desired text and cut it to the clipboard.</li>
- <li>Create a new sub-note and name it.</li>
- <li>Paste the content from the clipboard into the sub-note.</li>
-</ol>
-<p>Trilium can automate this process. Select some text within the note, and
- in the selection toolbar, click the scissors icon for the "cut &amp; pasted
- selection to sub-note" action. The heading is automatically detected and
- the new sub-note is named accordingly. You can also assign a keyboard shortcut
- for this action. This functionality is available through the block toolbar
- icon.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Cut to subnote_cut-to-subnote.gif b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Cut to subnote_cut-to-subnote.gif
deleted file mode 100644
index b71afd0bd3..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Cut to subnote_cut-to-subnote.gif and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Developer-specific formatting.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Developer-specific formatting.html
deleted file mode 100644
index edcbb2a56a..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Developer-specific formatting.html
+++ /dev/null
@@ -1,41 +0,0 @@
-<h3>Inline code</h3>
-<p>Inline code formats text using a monospace font to indicate technical
- content in a sentence such as code, paths, etc.</p>
-<p>
- <img src="2_Developer-specific formatting_image.png">
-</p>
-<p>Example of inline code being used to illustrate file system paths as well
- as shell commands (<code>git</code> in this case).</p>
-<p>To insert an inline code:</p>
-<ul>
- <li>Via the&nbsp;<a href="#root/_help_nRhnJkTT8cPs">Formatting toolbar</a>,
- look for the&nbsp;<span class="tn-icon cke cke-code"></span> button.</li>
- <li>Type `code` where <code>code</code> is the desired text to be automatically
- formatted as inline code.</li>
- <li>Paste a single line copied from Visual Studio Code. See <a href="#root/_help_QxEyIjRBizuC">Code blocks</a> for
- pasting several lines.</li>
-</ul>
-<h3>Code blocks</h3>
-<p>Code blocks display a snippet of code as a dedicated block:</p>
-<p>
- <img src="1_Developer-specific formatting_image.png">
-</p>
-<p>A code block with JavaScript syntax highlight enabled.</p>
-<p>Note that these are not meant for very large portions of code. Use the
- dedicated&nbsp;<a href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;note type
- instead.</p>
-<p>See the dedicated documentation for more information:&nbsp;<a href="#root/_help_QxEyIjRBizuC">Code blocks</a>
-</p>
-<h3>Keyboard shortcuts</h3>
-<p>This allows marking a portion of text as a shortcut key.</p>
-<p>
- <img src="Developer-specific formatting_image.png">
-</p>
-<p>To apply this style, press the&nbsp;<span class="tn-icon cke cke-trilium-kbd"></span> button
- in&nbsp;<span class="tn-icon bx bx-text"></span> group from the&nbsp;<a
- href="#root/_help_nRhnJkTT8cPs">Formatting toolbar</a>. On the floating
- toolbar, the buttons appear when selecting a text.</p>
-<p>Alternatively, press the <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>K</kbd> combination
- to apply keyboard shortcut formatting to the current text selection.</p>
-<p>The formatting can be removed by pressing again the button (from the UI
- or from the keyboard), or by using the&nbsp;<span class="tn-icon cke cke-remove-format"></span> <em>Remove formatting</em> button.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Developer-specific formatting/1_Code blocks_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Developer-specific formatting/1_Code blocks_image.png
deleted file mode 100644
index 6cd7f4b4e3..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Developer-specific formatting/1_Code blocks_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Developer-specific formatting/Code blocks.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Developer-specific formatting/Code blocks.html
deleted file mode 100644
index 3bc2c06c61..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Developer-specific formatting/Code blocks.html
+++ /dev/null
@@ -1,134 +0,0 @@
-<p>
- <img src="Code blocks_image.png">
-</p>
-<p>The code blocks feature allows entering pieces of code in text notes.</p>
-<p>Note that this feature is meant for generally small snippets of code.
- For larger files such as an entire log, see the&nbsp;<a class="reference-link"
- href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;note type instead.</p>
-<h2>Inserting a code block</h2>
-<ul>
- <li>Via the&nbsp;<a class="reference-link" href="#root/_help_nRhnJkTT8cPs">Formatting toolbar</a>,
- look for the&nbsp;<span class="tn-icon cke cke-code-block"></span> button.
- <ul>
- <li>Pressing directly on the icon will insert a code block with the language
- that was selected most recently. If this is the first time a code block
- is inserted, the language will be “Auto-detected” by default.</li>
- <li>Pressing the arrow next to the icon, which will show a popup with the
- available languages.</li>
- </ul>
- </li>
- <li>Type <code>```</code> (as in Markdown).
- <ul>
- <li>Note that it's not possible to specify the language, as it will default
- to the last selected language.</li>
- </ul>
- </li>
- <li>Paste several lines of code copied from Visual Studio Code.
- <ul>
- <li>The code block uses the language of the file in Visual Studio Code.</li>
- <li>If that language is not in the list of languages, the code block uses <em>Auto-detected</em>.</li>
- <li>The colors of the Visual Studio Code theme are removed.</li>
- <li>A single line becomes inline code instead of a code block.</li>
- <li>In Firefox, the code block always uses <em>Auto-detected</em>. Firefox
- can't read the language from Visual Studio Code.</li>
- </ul>
- </li>
-</ul>
-<h2>Exiting out of the code block</h2>
-<ul>
- <li>To exit out of a code block and enter a normal paragraph, move the cursor
- at the end of the code block and press Enter twice.</li>
- <li>Similarly, to insert a paragraph above the note block, move the cursor
- at the beginning of the code block and press Enter twice.</li>
-</ul>
-<aside class="admonition note">
- <p>If you've pasted a code block with a more complex HTML structure, exiting
- out of the code block by pressing Enter multiple times might not work.
- In that case the best approach is to delete the code block entirely and
- use Ctrl+Shift+V (paste as plain text).</p>
-</aside>
-<h2>Syntax highlighting &amp; color schemes</h2>
-<p>Since TriliumNext v0.90.12, Trilium will try to offer syntax highlighting
- to the code block. Note that the syntax highlighting mechanism is slightly
- different than the one in&nbsp;<a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;notes
- as different technologies are involved.</p>
-<p>Interaction:</p>
-<ul>
- <li>When the language is set to <em>Auto-detected</em> (by default), Trilium
- will try to identify the programming language (or similar) that corresponds
- to the given snippet of text and highlight it. Only the languages enabled
- in <a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a> → <em>Code Notes</em> → <em>Available MIME types in the dropdown</em> are
- considered. If this is problematic, consider changing the language of the
- code block manually.</li>
- <li>When the language is set to <em>Plain text</em>, there will be no syntax
- highlighting.</li>
-</ul>
-<p>Note that when editing a text note, syntax highlighting is automatically
- disabled if the code block is too big (somewhere around 500 lines). In&nbsp;<a
- class="reference-link" href="#root/_help_CoFPLs3dRlXc">Read-Only Notes</a>,
- in print and on a <a href="#root/_help_R9pX4DGra2Vt">shared page</a>, a
- code block of more than 500 lines or 50,000 characters is shown without
- syntax highlighting. These limits are not configurable.</p>
-<p>In order to configure this new feature, a section has been added in&nbsp;<a
- class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Appearance</em> to
- control the syntax highlighting. There the color scheme can be chosen,
- from a builtin selection of themes from Highlight.js. <em>VS Code (Light)</em> and <em>VS Code (Dark)</em> use
- the same colors as the default themes of <a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a> notes,
- so a code block and a code note color the same code alike.</p>
-<ul>
- <li>It is possible to disable the syntax highlighting for all the notes by
- selecting “No syntax highlighting” in the “Color scheme” option.</li>
- <li>Word wrapping is disabled by default, but can be configured from the same
- section.</li>
- <li>The tab width can also be adjusted from Options.</li>
-</ul>
-<aside class="admonition note">
- <p><strong>Context regarding syntax highlighting</strong>
- </p>
- <p>In order to achieve the syntax highlight, the Highlight.js library is
- being used. Do note that support for syntax highlighting in code blocks
- is not a supported feature of the text editor we are using CKEditor), but
- rather a hack which makes use of the highlights API (used for highlighting
- search results for example). Nevertheless, we haven't noticed any major
- issues during the development of the feature, but feel free to report any
- issues you might have.</p>
- <p>Most of the work to achieve the syntax highlight itself was already done
- by <a href="https://github.com/antoniotejada">antoniotejada</a> in <a href="https://github.com/antoniotejada/Trilium-SyntaxHighlightWidget">https://github.com/antoniotejada/Trilium-SyntaxHighlightWidget</a>.
- On our side we added customization but also additional functionality.</p>
-</aside>
-<h3>Migrating from existing syntax highlight plugins</h3>
-<p>If you are already using a syntax highlighting plugin such as the <a href="https://github.com/antoniotejada/Trilium-SyntaxHighlightWidget">Trilium-SyntaxHighlightWidget</a> we
- are basing off of, it is important to disable that plugin before upgrading
- in order for it not to conflict with our implementation.</p>
-<p>Should you encounter any issues after the migration, try running Trilium
- in safe mode.</p>
-<h2>Changing the language of a code block</h2>
-<p>Simply click anywhere inside the code block and press again the code block
- button in the&nbsp;<a class="reference-link" href="#root/_help_nRhnJkTT8cPs">Formatting toolbar</a>:
- <br>
- <img src="1_Code blocks_image.png">
-</p>
-<h2>Adjusting the list of languages</h2>
-<p>The code blocks feature shares the list of languages with the&nbsp;<a
- class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;note
- type.</p>
-<p>The supported languages can be adjusted by going to&nbsp;<a class="reference-link"
- href="#root/_help_4TIF1oA4VQRO">Options</a>, then <em>Code Notes</em> and
- looking for the <em>Available MIME types in the dropdown</em> section. Simply
- check any of the items to add them to the list, or uncheck them to remove
- them from the list.</p>
-<p>Note that the list of languages is not immediately refreshed, you'd have
- to manually <a href="#root/_help_s8alTXmpFR61">refresh the application</a>.</p>
-<h2>Text replacements and ligatures</h2>
-<p><a class="reference-link" href="#root/_help_oI7GoyilXXAr">Automatic replacements</a>&nbsp;are
- a feature of text notes which converts some character sequences into another
- and some of them interfere with programming text, such as the conversion
- of quotes. While in a code block, the automatic replacements <strong>are not effect</strong>.
- The only way the automatic replacements can interfere is if the text is
- typed/pasted before being put in a code block.</p>
-<p>A different feature is <em>programming ligatures</em>, which is simply
- a display affordance which turns <code>!=</code> into <code>≠</code> or <code>-&gt;</code> as <code>→</code> .
- These come from the <a href="#root/_help_w4rMEhJsALlA">font</a>. The underlying
- text is not actually changed, and copying it out gives you back <code>!=</code> and <code>-&gt;</code>.</p>
-<p>Ligatures can be disabled in&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a><em>→ Appearance → Fonts → Programming ligatures.</em>
-</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Footnotes.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Footnotes.html
deleted file mode 100644
index bcd196e818..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Footnotes.html
+++ /dev/null
@@ -1,20 +0,0 @@
-<figure class="image image-style-align-right">
- <img style="aspect-ratio:199/187;" src="Footnotes_image.png" width="199"
- height="187">
-</figure>
-<p>Footnotes are a good place to insert references to a paragraph or details
- that are displayed at the bottom of the note.</p>
-<h2>Interaction</h2>
-<ul>
- <li>To insert a new footnote, press&nbsp;<span class="tn-icon cke cke-trilium-insert-footnote"></span> (or
- press the right arrow and select <em>New footnote</em>).</li>
- <li>To insert a reference to an existing footnote, press the right arrow and
- select <em>Insert footnote</em>, followed by the number of the footnote
- to insert.</li>
- <li>Hovering over a reference (e.g. <code>[1]</code>) will display the content
- of the footnote in a tooltip for easy reference.</li>
- <li>Clicking on a reference in the text (e.g. <code>[1]</code>) will navigate
- to the corresponding footnote.</li>
- <li>Similarly, clicking on the <code>^</code> button of a footnote will navigate
- to the corresponding reference in the text.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Footnotes_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Footnotes_image.png
deleted file mode 100644
index 64c876e33e..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Footnotes_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Format Painter.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Format Painter.html
deleted file mode 100644
index 78c178950a..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Format Painter.html
+++ /dev/null
@@ -1,32 +0,0 @@
-<figure class="image image-style-align-right">
- <img style="aspect-ratio:220/76;" src="Format Painter_image.png" width="220"
- height="76">
-</figure>
-<p>The Format Painter is a feature in text notes that allows users to copy
- the formatting of text (such as <strong>bold</strong>, <em>italic</em>, <del>Strikethrough</del>,
- etc.) and apply it to other parts of the document. It helps maintain consistent
- formatting and accelerates the creation of rich content.</p>
-<h2>Usage Instructions</h2>
-<p>Click the text that you want to copy the formatting from and use the <em>Copy formatting</em> toolbar
- button (<span class="tn-icon cke cke-paint-roller"></span>) to copy the
- style. Then select the target text with your mouse to apply the formatting.</p>
-<ul>
- <li><strong>To copy the formatting</strong>: Place the cursor inside text
- with some formatting and click the <em>Copy formatting</em> toolbar button.
- The mouse cursor changes to indicate the painter is armed.</li>
- <li><strong>To paint with the copied formatting</strong>: Select the target
- text with your mouse. The formatting is applied when you release the button,
- and the painter disarms — the cursor returns to normal.</li>
- <li><strong>To cancel without painting</strong>: Click the toolbar button
- again or press <kbd>Escape</kbd>.</li>
-</ul>
-<h2>Limitations</h2>
-<ol>
- <li>Painting with block-level formatting (like headings or image styles) is
- not supported yet. This is because, in&nbsp;<a class="reference-link" href="#root/_help_MI26XDLSAlCD">CKEditor</a>,
- they are considered a part of the content rather than text formatting.</li>
- <li>The painter applies to a selection, not to a word: clicking a single word
- does not format it. A click only primes the caret, so text you type there
- takes the copied formatting.</li>
- <li>The painter is one-shot; each paint requires copying the formatting again.</li>
-</ol>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Format Painter_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Format Painter_image.png
deleted file mode 100644
index db5cbbbd11..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Format Painter_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Formatting toolbar.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Formatting toolbar.html
deleted file mode 100644
index e2d3c4ed83..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Formatting toolbar.html
+++ /dev/null
@@ -1,58 +0,0 @@
-<p>Trilium allows two different editing experiences for text notes, based
- on your preference.</p>
-<p>The type of formatting toolbar can be changed by going to&nbsp;<a class="reference-link"
- href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;and then looking for the&nbsp;<a
- class="reference-link" href="#root/_hidden/_options/_optionsTextNotes">Text Notes</a>&nbsp;section.
- In it, look for the <em>Formatting toolbar</em> category.</p>
-<h2>Floating</h2>
-<p>The floating bar is a more minimalist option, in which the formatting
- is hidden behind two different popups.</p>
-<h3>Block-level popup</h3>
-<p>The first popup is the block-level popup. This will appear to the left
- of the current paragraph you are currently editing, as a sequence of dots:
- <br>
- <img src="1_Formatting toolbar_image.png">
-</p>
-<p>Clicking this popup will reveal the formatting options that are specific
- to the entire paragraph, such as setting a heading, lists, tables, etc.</p>
-<p>The dots are also a drag handle: drag them to move the paragraph, all
- the selected paragraphs, or a selected element such as an image, a table
- or an included note to another place in the note. Right-clicking them copies
- a reference to the paragraph or to the selected paragraphs, see&nbsp;<a
- class="reference-link" href="#root/_help_klC3ilXa9kUE">Block references</a>.</p>
-<figure
-class="image">
- <img style="aspect-ratio:1404/156;" src="3_Formatting toolbar_image.png"
- width="1404" height="156">
-</figure>
-<h3>Inline popup</h3>
-<p>The inline popup appears automatically when selecting a text:</p>
-<figure
-class="image">
- <img style="aspect-ratio:1008/154;" src="2_Formatting toolbar_image.png"
- width="1008" height="154">
-</figure>
-<p>All the options here apply only to the selected portion of text, such
- as changing the font size, or making the text bold.</p>
-<h2>Fixed</h2>
-<p>The fixed formatting offers a more traditional editing paradigm, usually
- useful if a lot of formatting is needed.</p>
-<p>All the options are combined into a single toolbar that will appear at
- the above the note. When using&nbsp;<a class="reference-link" href="#root/_help_luNhaphA37EO">Split View</a>,
- a single toolbar will be available to save space and it acts on the active
- note.</p>
-<p>The sequence of dots to the left of the current paragraph is still shown,
- but only as a drag handle: drag it to move the paragraph, all the selected
- paragraphs, or a selected element such as an image, a table or an included
- note to another place in the note. Clicking it does not open a popup, and
- right-clicking it copies a reference to the block, see&nbsp;<a class="reference-link"
- href="#root/_help_klC3ilXa9kUE">Block references</a>. The drag handle is
- not shown in the mobile layout.</p>
-<figure class="image">
- <img style="aspect-ratio:1440/60;" src="Formatting toolbar_image.png"
- width="1440" height="60">
-</figure>
-<p>By default, if the toolbar does not fit on the screen, the rest of the
- options will be grouped into a single option at the end. It is possible
- to display items on multiple lines by checking the corresponding option
- in the <em>Formatting toolbar</em> section.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Formatting toolbar_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Formatting toolbar_image.png
deleted file mode 100644
index f1c1965277..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Formatting toolbar_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/General formatting.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/General formatting.html
deleted file mode 100644
index 0a08f3f8b8..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/General formatting.html
+++ /dev/null
@@ -1,128 +0,0 @@
-<h2>Headings</h2>
-<figure class="image image-style-align-right">
- <img style="aspect-ratio:255/284;" src="2_General formatting_image.png"
- width="255" height="284">
-</figure>
-<p>Trilium provides headings to define sections within text. Headings are
- numbered from 2 to 6.</p>
-<p>The reason why Heading 1 is missing from the list is that it is being
- reserved for the title of note.</p>
-<p>To turn a heading back into a normal text, select <em>Paragraph</em> from
- the list.</p>
-<p>Apart from using the UI, it is also possible to quickly insert headings
- using the Markdown-like shortcuts:</p>
-<ul>
- <li><code>##</code> for Heading 2</li>
- <li><code>###</code> for Heading 3</li>
- <li><code>####</code> for Heading 4</li>
- <li><code>#####</code> for Heading 5</li>
- <li><code>######</code> for Heading 6</li>
-</ul>
-<h2>Font size</h2>
-<figure class="image image-style-align-right">
- <img style="aspect-ratio:363/249;" src="General formatting_image.png"
- width="363" height="249">
-</figure>
-<p>One way to highlight a portion of text is to increase the size of the
- font.</p>
-<p>To do so, select some text and choose an option from the <em>Font size</em> (<span
- class="tn-icon cke cke-font-size"></span>) selector (as pictured to the
- right).</p>
-<p>Unlike other text editors such as Microsoft Word, the font size is relative
- (i.e. “Tiny”, “Small” instead of a number like 12).</p>
-<p>Avoid using this feature just to simply make all text bigger. In that
- case it's generally better to adjust the font size for all notes in&nbsp;<a
- class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;or
- by zooming.</p>
-<h2>Bold, italic, underline, strike-through</h2>
-<figure class="image image-style-align-right">
- <img style="aspect-ratio:215/71;" src="3_General formatting_image.png"
- width="215" height="71">
-</figure>
-<p>Text can be formatted as <strong>Bold,</strong> <em>Italic,</em> Underline
- or <del>Strike-through</del> via the dedicated buttons (<span class="tn-icon cke cke-bold"></span>, <span
- class="tn-icon cke cke-italic"></span>, <span class="tn-icon cke cke-underline"></span>, <span
- class="tn-icon cke cke-strikethrough"></span>) in the formatting toolbar.</p>
-<p>This formatting can be easily removed using the <em>Remove formatting</em> (<span
- class="tn-icon cke cke-remove-format"></span>) item.</p>
-<p>The following keyboard shortcuts can be used here:</p>
-<ul>
- <li><kbd>Ctrl</kbd>+<kbd>B</kbd> for bold</li>
- <li><kbd>Ctrl</kbd>+<kbd>I</kbd> for italic</li>
- <li><kbd>Ctrl</kbd>+<kbd>U</kbd> for underline</li>
-</ul>
-<p>Alternatively, Markdown-like formatting can be used:</p>
-<ul>
- <li><strong>Bold</strong>: Type <code>**text**</code> or <code>__text__</code>
- </li>
- <li><em>Italic</em>: Type <code>*text*</code> or <code>_text_</code>
- </li>
- <li><del>Strikethrough</del>: Type <code>~~text~~</code>
- </li>
-</ul>
-<h2>Superscript, subscript</h2>
-<p>This allows writing superscript or subscript text.</p>
-<p>This is mostly useful for units of measure (e.g. cm3 for cubic centimeters)
- and chemical notations (e.g. NaHCO3)</p>
-<p>For mathematical formulas, prefer the&nbsp;<a class="reference-link" href="#root/_help_YfYAtQBcfo5V">Math Equations</a>&nbsp;feature
- instead.</p>
-<h2>Font color and background color</h2>
-<figure class="image image-style-align-right">
- <img style="aspect-ratio:167/204;" src="1_General formatting_image.png"
- width="167" height="204">
-</figure>
-<p>Selected text can be colored with one of the predefined colors from a
- palette or any color can be selected using the color picker (<span class="tn-icon cke cke-color-palette"></span>).</p>
-<p>Once there is at least one color defined in the document, it will appear
- in the list for easy reuse.</p>
-<p>Colors adapt to the <a href="#root/_help_Wy267RK4M69c">theme</a>. Trilium
- shows each color in a lighter or darker shade that suits the current theme,
- so the text stays readable after switching between light and dark themes.
- The hue stays the same: red text is red in both themes, only lighter or
- darker. This applies to the palette, the color picker and the document
- colors alike, and to shared notes too. Printed notes and PDF exports always
- use the shades of light themes, which suit white paper. The note itself
- keeps the color as it was picked, so an exported note shows it unchanged.</p>
-<p>Colors applied with older versions of Trilium are shown exactly as they
- were picked, until the note is next edited.</p>
-<p>Older browsers that can't adapt colors show them exactly as they were
- picked.</p>
-<p>When you paste text copied from a web page in Chrome, Edge or a Chromium-based
- app (such as Visual Studio Code), Trilium removes the page's styling:</p>
-<ul>
- <li>Text and background colors.</li>
- <li>Fonts and font sizes.</li>
- <li>Table borders, backgrounds and spacing.</li>
-</ul>
-<p>The following formatting is preserved:</p>
-<ul>
- <li>Bold, italic, underline and strikethrough.</li>
- <li>Subscript and superscript.</li>
- <li>Links, code and tables.</li>
-</ul>
-<p>Colors are preserved when pasting from Word, Google Docs or another note.</p>
-<p>To remove either the background or foreground color of a text, select
- the corresponding formatting button (<span class="tn-icon cke cke-font-color"></span> or <span
- class="tn-icon cke cke-font-background"></span>) and press <em>Remove color</em> (<span
- class="tn-icon cke cke-eraser"></span>) or use the <em>Remove formatting</em> (<span
- class="tn-icon cke cke-remove-format"></span>) toolbar item.</p>
-<h2>Remove formatting</h2>
-<p>The&nbsp;<span class="tn-icon cke cke-remove-format"></span> <em>Remove formatting</em> button
- is a quick way to eliminate the general formatting styling of a particular
- text.</p>
-<p>Simply select the text and press the button to remove the formatting (bold,
- italic, colors, sizes, etc.). If the text does not have any removable formatting,
- the button will appear disabled.</p>
-<p>Note that heading styles are not taken into consideration, these must
- be manually changed back to a paragraph according to the <em>Headings</em> section.</p>
-<p>When pasting content that comes with undesired formatting, an alternative
- to pasting and then removing formatting is pasting as plain text via <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>V</kbd>.</p>
-<h2>Format painter</h2>
-<p>The&nbsp;<a class="reference-link" href="#root/_help_5wZallV2Qo1t">Format Painter</a>&nbsp;allows
- users to copy the formatting of text (such as bold, italic, Strikethrough,
- etc.) and apply it to other parts of the document. It helps maintain consistent
- formatting and accelerates the creation of rich content.</p>
-<h2>Support for Markdown</h2>
-<p>When exported to&nbsp;<a class="reference-link" href="#root/_help_Oau6X9rCuegd">Markdown</a>,
- most of the general formatting is maintained such as headings, bold, italic,
- underline, etc.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/General formatting_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/General formatting_image.png
deleted file mode 100644
index 1d1cfb3eae..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/General formatting_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Highlights list.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Highlights list.html
deleted file mode 100644
index de81326980..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Highlights list.html
+++ /dev/null
@@ -1,3 +0,0 @@
-<aside class="admonition note">
- <p>This page has been relocated to&nbsp;<a class="reference-link" href="#root/_help_2dcGDhp9WFKb">Outline tab</a>.</p>
-</aside>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Images.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Images.html
deleted file mode 100644
index 9c0669de68..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Images.html
+++ /dev/null
@@ -1,127 +0,0 @@
-<p>Trilium supports storing and displaying images. Supported formats are
- PNG, JPEG, GIF, BMP, WebP, AVIF and SVG.</p>
-<p>An image can be uploaded in the form of note's <a href="#root/_help_0vhv7lsOLy82">attachment</a> or
- as a standalone <a href="#root/_help_kBrnXNG3Hplm">note</a> placed into the <a
- href="#root/_help_kBrnXNG3Hplm">note tree</a>. Its reference can be copied
- into a text note, in order to display it in the text itself.</p>
-<h2>Uploading images</h2>
-<p>To add an image to the note:</p>
-<ul>
- <li>Simply drag it from file explorer onto the note editor inside Trilium
- and the image will be uploaded.</li>
- <li>Alternatively, from the&nbsp;<a class="reference-link" href="#root/_help_nRhnJkTT8cPs">Formatting toolbar</a>&nbsp;look
- for the <span class="tn-icon cke cke-image-upload"></span> <em>Upload image from computer</em> button.</li>
- <li>You can also copy and paste an image from web (see section below).</li>
-</ul>
-<aside class="admonition tip">
- <p>To link a picture instead of displaying it, attach it with <em>Attach file as a link</em>,
- from the arrow beside the <span class="tn-icon cke cke-paper-clip"></span><em>Attach file</em> button.
- See&nbsp;<a class="reference-link" href="#root/_help_0vhv7lsOLy82">Attachments</a>.</p>
-</aside>
-<h2>Clipboard &amp; automatic download of images</h2>
-<p>Trilium has a special handling for images copied to and pasted from the
- clipboard.</p>
-<ul>
- <li>For a mix of text and images, the images are downloaded automatically
- by the server (or desktop app, depending on what is being used).
- <ul>
- <li>This means that the image must be publicly accessible and reachable from
- wherever Trilium is running. Inaccessible images will end up as broken
- images.</li>
- </ul>
- </li>
- <li>If a single image is pasted into Trilium, it will prefer the image that
- comes in the clipboard. This makes it possible to copy images that Trilium
- would not otherwise be able to reach, such as Google Chat, Slack, etc.</li>
- <li>When a text with images is copied from Trilium and pasted in another app
- (such as Microsoft Word or LibreOffice Writer), the images will be preserved.</li>
-</ul>
-<p>The automatic download of images is enabled by default and can be toggled
- from&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Media</em> → <em>Download images automatically.</em>
-</p>
-<h2>Configuring the images</h2>
-<p>Clicking on an image will reveal a popup with multiple options:
- <br>
- <img src="4_Images_image.png">
-</p>
-<h3>Alignment</h3>
-<p>The first set of options configure the alignment are, in order:</p>
-<figure
-class="table">
- <table>
- <thead>
- <tr>
- <th>Icon</th>
- <th>Option</th>
- <th>Preview</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><span class="tn-icon cke cke-object-inline"></span>
- </td>
- <td>Inline</td>
- <td>
- <img src="Images_image.png">
- </td>
- <td>As the name suggests, the name can be put inside a paragraph and moved
- around similarly as if it was a block of text. Use drag &amp; drop or cut-paste
- to move it around.</td>
- </tr>
- <tr>
- <td><span class="tn-icon cke cke-object-center"></span>
- </td>
- <td>Centered image</td>
- <td>
- <img src="1_Images_image.png">
- </td>
- <td>The image will be displayed as a block and centered, not allowing text
- in either the left or right of it.</td>
- </tr>
- <tr>
- <td><span class="tn-icon cke cke-object-inline-right"></span>
- </td>
- <td>Wrap text</td>
- <td>
- <img src="3_Images_image.png">
- </td>
- <td>The image will be displayed to the left or the right of the text.</td>
- </tr>
- <tr>
- <td><span class="tn-icon cke cke-object-left"></span>
- </td>
- <td>Block align</td>
- <td>
- <img src="2_Images_image.png">
- </td>
- <td>Similarly to <em>Centered image</em>, the image will be displayed as a
- block and aligned either to the left or to the right, but not allowing
- text to flow on either of its sides.</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<h3>Drawing over an image</h3>
-<p>To draw or write over an image, press the <span class="tn-icon bx bxs-pen"></span> <em>Convert image to a drawing canvas</em> button
- of its toolbar. The image becomes a drawing canvas that shows all of it,
- locked in place. See the drawing canvases section of <a class="reference-link"
- href="#root/_help_nBAXQFj20hS1">Include Note</a>.</p>
-<h2>Compression</h2>
-<p>Since Trilium isn't really meant to be primary storage for image data,
- it attempts to compress and resize (with pretty aggressive settings) uploaded
- images before storing them to the database. You may then notice some quality
- degradation. Basic quality settings is available in&nbsp;<a class="reference-link"
- href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Media</em>.</p>
-<p>If you want to save images in their original resolution, it is recommended
- to save them as attachment to note (look for the contextual menu in&nbsp;<a
- class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a>&nbsp;→ <em>Import files</em>).</p>
-<h2>Aligning images side-by-side</h2>
-<p>There are generally two ways to display images side by side:</p>
-<ul>
- <li>If they are roughly the same size, simply make the two images in-line,
- according to the alignment section above. The images can be dragged &amp;
- dropped onto the same line.</li>
- <li>If they are on different size, create a <a href="#root/_help_NdowYOC1GFKS">table</a> with
- invisible borders.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Images/Image references.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Images/Image references.html
deleted file mode 100644
index 4604655969..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Images/Image references.html
+++ /dev/null
@@ -1,32 +0,0 @@
-<figure class="image image-style-align-right image_resized" style="width:50.47%;">
- <img style="aspect-ratio:880/553;" src="Image references_image.png" width="880"
- height="553">
-</figure>
-<p>Image references are an easy way to embed the preview of another note
- type into a&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;note.</p>
-<h2>Supported note types</h2>
-<ul>
- <li><a class="reference-link" href="#root/_help_grjYqerjn243">Canvas</a>
- </li>
- <li><a class="reference-link" href="#root/_help_s1aBHPd79XYj">Mermaid Diagrams</a>
- </li>
- <li><a class="reference-link" href="#root/_help_gBbsAeiuUxI5">Mind Map</a>
- </li>
-</ul>
-<h2>Steps</h2>
-<ol>
- <li>Go to one of the supported notes (listed above) and look for the&nbsp;<span
- class="tn-icon bx bx-copy"></span> button in the&nbsp;<a class="reference-link"
- href="#root/_help_1P8QXI5edXNd">Note buttons</a>&nbsp;area.</li>
- <li>Go to a&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;note
- and use the Paste function to insert the reference to that note.</li>
-</ol>
-<h2>Interaction</h2>
-<ul>
- <li>Double-clicking an image reference from a text note will automatically
- open the target note.</li>
- <li>Clicking an image reference while <kbd>Ctrl</kbd> is pressed will open the
- target note in a new tab.</li>
- <li>Modifying the target note should also update the image reference. If that
- doesn't happen, consider&nbsp;<a class="reference-link" href="#root/_help_s8alTXmpFR61">Refreshing the application</a>.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Images/Image references_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Images/Image references_image.png
deleted file mode 100644
index a54daef4a2..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Images/Image references_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/In-editor AI assistant.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/In-editor AI assistant.html
deleted file mode 100644
index 2c4a84df0d..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/In-editor AI assistant.html
+++ /dev/null
@@ -1,117 +0,0 @@
-<figure class="image image-style-align-center image_resized" style="width:76.29%;">
- <img style="aspect-ratio:1479/865;" src="In-editor AI assistant_image.png"
- width="1479" height="865">
-</figure>
-<p>The AI assistant works on the text you are already writing: select a passage
- and have it rewritten, translated or turned into a table, or ask for new
- content at the cursor. Unlike the <a href="#root/_help_LrKznOtw9cQD">AI chat</a>,
- it does not open a conversation window, the result is previewed in place
- and only enters the note when you accept it.</p>
-<h2>Requirements</h2>
-<p>The assistant is only available once at least one provider is configured
- in&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>AI / LLM</em>,
- with at least one model selected for it. Until then the toolbar entry is
- not shown at all.</p>
-<h2>Accessing the AI assistant</h2>
-<p>To access the AI assistant:</p>
-<ul>
- <li>Look for the&nbsp;<span class="tn-icon cke cke-trilium-ai"></span> button
- in the&nbsp;<a class="reference-link" href="#root/_help_nRhnJkTT8cPs">Formatting toolbar</a>.
- Press the button itself to enter the <em>Ask AI</em> mode or press the arrow
- key next to it to access the quick commands and the model selection.</li>
- <li>Look for <em>AI assistant</em> or any of the <em>AI</em>-prefixed quick commands
- in&nbsp;<a class="reference-link" href="#root/_help_ZlN4nump6EbW">Slash Commands</a>.</li>
- <li>Press <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>K</kbd>.</li>
- <li>Select a text and choose the <em>AI assistant</em> option in the&nbsp;<a
- class="reference-link" href="#root/_help_jcQVxzYybYgz">Note contextual menu</a>.</li>
-</ul>
-<h2>What the assistant works on</h2>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Situation</th>
- <th>What is sent</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>Text is selected</td>
- <td>The selection.</td>
- </tr>
- <tr>
- <td>Nothing is selected, and you pick a quick action</td>
- <td>The paragraph the cursor is in.</td>
- </tr>
- <tr>
- <td>Nothing is selected, and you type your own prompt</td>
- <td>Nothing, the response is new content written at the cursor.</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<p>In all cases the assistant also sends the text before and after the target,
- so that the model can tell what it is writing into: asked to <em>Continue writing</em> or
- to summarize, a model that can only see the selected words is guessing
- at the document around them. This surrounding text is context only, it
- is never rewritten.</p>
-<aside class="admonition important">
- <p>That means a single run sends more than the passage you highlighted. See&nbsp;<a
- class="reference-link" href="#root/_help_cRRrdZjgyhNc">Privacy</a>&nbsp;for
- exactly what leaves your machine.</p>
-</aside>
-<h2>Quick actions</h2>
-<p>The arrow beside the toolbar button opens a menu of ready-made instructions,
- grouped by what they do.</p>
-<ul>
- <li>The <em>Reformat</em> actions produce real Trilium content rather than plain
- text: <em>Diagram</em> inserts a Mermaid diagram, <em>Callout</em> an admonition,
- and <em>Collapsible</em> a collapsible block.</li>
- <li>The <em>Translate</em> group lists the <a href="#root/_help_veGu4faJErEM">content languages</a> you
- have enabled, or a predefined list if no content languages are set. It
- can be filled from within the editor, the last entry of the submenu opens
- the language configuration directly.</li>
-</ul>
-<p>Actions that need something to work on are greyed out when there is nothing
- to work on (for example an empty paragraph with no selection).</p>
-<h2>Asking for something specific</h2>
-<p>Choosing <em>Ask AI…</em> (<span class="tn-icon bx bx-message-square-dots"></span>)
- opens a prompt where you can describe the change in your own words, for
- example: "make this less formal", "add a row for 2024", "write an intro
- paragraph for this section". Press <kbd>Enter</kbd> or the <span class="tn-icon cke cke-arrow-up"></span> send
- button to run it.</p>
-<p>Once a response arrives you can keep going in the same prompt, and the
- assistant treats it as a conversation rather than as a fresh request: after <em>Translate this to German</em>,
- asking for <em>make it shorter</em> shortens the German, not the original.</p>
-<h2>Reviewing the result</h2>
-<p>The response streams in as it is generated, and can be interrupted at
- any point by pressing the <em>Stop</em> (<span class="tn-icon cke cke-stop"></span>)
- button; whatever arrived before that stays usable.</p>
-<p>Nothing is written into the note until you say so. The review offers:</p>
-<ul>
- <li><em>Result</em>, which displays the response as it will be inserted.</li>
- <li><em>Changes</em>, which displays an inline diff against the original,
- with insertions and deletions marked. When the model rewrote the passage
- rather than editing it, the review opens on <em>Result</em> instead: a diff
- of two texts with little in common is harder to read than the answer itself.</li>
- <li><em>Try again</em> (<span class="tn-icon cke cke-refresh"></span>), to
- re-run the same instruction.</li>
- <li><em>Replace</em>, which substitutes the original passage</li>
- <li><em>Insert below</em>, which keeps the original and adds the response
- after it.</li>
-</ul>
-<p>Trilium also reports the model that produced it, the tokens consumed and,
- for providers that report it, the price.</p>
-<p>If you ask for a correction and there is nothing to correct, the assistant
- will indicate it instead of showing a blank diff.</p>
-<h2>Choosing the model</h2>
-<p>The bottom of the quick actions menu shows which model the assistant runs
- on, and lets you pick another from the models you selected in&nbsp;<a class="reference-link"
- href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>AI / LLM</em>, grouped
- by provider.</p>
-<p>The model can also be changed while asking for something specific, or
- after the assistant has generated its response (i.e. if the response needs
- a better model).</p>
-<p>This choice is separate from the model used by the chat, and is remembered
- across notes and devices. Left unset, the assistant follows the first configured
- provider.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/In-editor AI assistant/Custom AI quick actions.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/In-editor AI assistant/Custom AI quick actions.html
deleted file mode 100644
index a035764c85..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/In-editor AI assistant/Custom AI quick actions.html
+++ /dev/null
@@ -1,29 +0,0 @@
-<p><em>Quick actions</em> are a feature of the&nbsp;<a class="reference-link"
- href="#root/_help_VRoP0g1uHHc2">In-editor AI assistant</a>&nbsp;for&nbsp;<a
- class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes
- which automatically triggers an LLM suggestion based on a defined prompt.
- The built-in quick actions come with a predefined prompt, but it is also
- possible to define your own quick actions.</p>
-<h2>Creating a custom quick action</h2>
-<p>In the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>: </p>
-<ol>
- <li>Right-click the note where you want to place the quick action.</li>
- <li>Select <em>Insert child note</em>.</li>
- <li>Select <em>More</em> → <em>AI Quick Action</em>. The entry appears only when
- AI is enabled.</li>
-</ol>
-<p>Afterwards, simply type in the content of the note the desired prompt.
- The text can be formatted in the same manner as a normal text note and
- it will be passed to the LLM as Markdown.</p>
-<p>The title of the note will become the title of the quick action.</p>
-<p>Of note:</p>
-<ul>
- <li><a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;notes
- work too.</li>
- <li>An empty note is ignored.</li>
- <li><a class="reference-link" href="#root/_help_MKmLg5x6xkor">Archived Notes</a>&nbsp;are
- also excluded.</li>
-</ul>
-<h2>Using a quick action</h2>
-<p>Once a quick action is defined, the action will appear under the <em>Quick Actions</em> dropdown
- in a group called <em>Custom</em>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/In-editor AI assistant_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/In-editor AI assistant_image.png
deleted file mode 100644
index a9111cc931..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/In-editor AI assistant_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Include Note.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Include Note.html
deleted file mode 100644
index 8cd40cd6e9..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Include Note.html
+++ /dev/null
@@ -1,274 +0,0 @@
-<p>Text notes can "include" another note as a read-only widget or an interactive
- widget, depending on the type of note.</p>
-<p>This can be useful for e.g. including a dynamically generated chart (from
- scripts &amp; "render HTML" note) or other more advanced use cases.</p>
-<h2>Including a note</h2>
-<p>In the&nbsp;<a class="reference-link" href="#root/_help_nRhnJkTT8cPs">Formatting toolbar</a>,
- look for the&nbsp;<span class="tn-icon cke cke-trilium-note"></span> button.
- There is also a keyboard shortcut defined for it but it is not allocated
- by default.</p>
-<p>To include a note that is already linked, right-click a reference link
- to it in a text note being edited and select <em>Convert link to an included note</em>,
- at the end of the menu. The include gets the box size that suits the note,
- as one added from the button does.</p>
-<p>An <a href="#root/_help_0vhv7lsOLy82">attachment</a> can be included the
- same way, from the context menu of a link to it (see <em>Embedding an attachment</em> there).</p>
-<p>A link to blocks of a text note is converted the same way, with <em>Convert link to note excerpt</em>,
- and the include then shows only those blocks. See <a class="reference-link"
- href="#root/_help_klC3ilXa9kUE">Block references</a>.</p>
-<h2>Box sizes</h2>
-<p>The box size sets how much of the included note is shown.</p>
-<ul>
- <li><em>Tiny</em> shows a single row instead of the content: the note's icon,
- its title with the path to the note above it, and buttons to act on the
- note. The included note is never rendered, so wherever the note is shown
- outside the editor, such as in print, in a tooltip or on a shared page,
- a <em>Tiny</em> include appears as a link to the included note.</li>
- <li><em>Small</em> and <em>Medium</em> show the content in a box of limited height.
- Text scrolls inside the box, while a picture, a diagram or a video is scaled
- down to fit it.</li>
- <li><em>Full</em> shows the whole content.</li>
- <li><em>Expandable</em> shows only the title until its <span class="tn-icon bx bx-chevron-right"></span> arrow
- is pressed. In a read-only note, a click anywhere on the title row other
- than its buttons and link expands or collapses it as well.</li>
-</ul>
-<p>A new include gets the size that suits what it shows:</p>
-<ul>
- <li><em>Tiny</em> for a note or an attachment that has no preview, such as
- a relation map or an archive.</li>
- <li><em>Small</em> for audio.</li>
- <li><em>Full</em> for a code note or a code file, such as a <code>.js</code>, <code>.py</code> or <code>.txt</code> attachment,
- and for an excerpt of the blocks of a text note.</li>
- <li><em>Medium</em> for anything else.</li>
-</ul>
-<p>The dialog that includes a note selects that size once the note is picked,
- and you can choose another one there. To change the size later, select
- the include and use the <em>Box size</em> menu in its toolbar, or the <em>Size</em> submenu
- of its <em>More actions</em> menu.</p>
-<h2>Resizing</h2>
-<p>A <em>Small</em>, <em>Medium</em> or <em>Expandable</em> include can be resized
- to any width and height. A <em>Tiny</em> or <em>Full</em> include always fits
- its content.</p>
-<ul>
- <li>To resize an include, select it and drag the handle in its bottom-right
- corner. To change only the width or only the height, drag the middle of
- its right or bottom edge instead, where a touch screen shows a handle too.
- In right-to-left text, the handle is in the bottom-left corner and the
- width changes from the left edge.</li>
- <li>Resizing works with a mouse, a pen or a finger.</li>
- <li>While the height changes, moving the handle near the top or the bottom
- of the note scrolls the note.</li>
- <li>An include narrower than the note is centered, so changing its width moves
- both of its sides. Making it as wide as the note returns it to the full
- width.</li>
- <li>To cancel a resize, press <kbd>Esc</kbd> before releasing the handle.</li>
- <li>To reset the size, double-click the corner handle, or double-tap it on
- a touch screen. Double-clicking the right or bottom edge resets only the
- width or the height.</li>
- <li>Choosing a box size resets the height. Choosing <em>Tiny</em> or <em>Full</em> resets
- the width too.</li>
- <li>While an <em>Expandable</em> include is collapsed, only its width can be
- changed.</li>
-</ul>
-<h2>Caption</h2>
-<p>An include can have a caption, shown centered at the bottom of its box.
- The caption is part of the text note, so it can be formatted like the rest
- of the text, for example in bold or with a link.</p>
-<ul>
- <li>To add a caption, select the include, press the <span class="tn-icon cke cke-caption"></span> <em>Toggle caption on</em> button
- in its toolbar and type the caption.</li>
- <li>To remove the caption, press the same button again. Pressing it once more
- brings back the text it had, as long as the note stays open.</li>
- <li>A <em>Tiny</em> include has no caption. Switching an include to <em>Tiny</em> removes
- its caption, and switching it back to a larger size restores the caption,
- as long as the note stays open.</li>
- <li>An <em>Expandable</em> include shows its caption under the title while the
- content is collapsed, and under the content once it is expanded.</li>
-</ul>
-<h2>Title</h2>
-<p>The title row of an include links to the included note and holds its buttons.
- To show only the content, select the include and press the <span class="tn-icon bx bx-window-alt"></span> <em>Show title</em> button
- in its toolbar. Pressing it again shows the title.</p>
-<ul>
- <li>While the title is hidden, the <span class="tn-icon cke cke-three-vertical-dots"></span> <em>More actions</em> button
- in the toolbar of the include opens the menu of the included note.</li>
- <li>A <em>Tiny</em> or <em>Expandable</em> include always shows its title, and
- its toolbar has no <em>Show title</em> button.</li>
-</ul>
-<h2>Opening an included note</h2>
-<p>To open an included note in a new tab, press the <span class="tn-icon bx bx-link-external"></span> <em>Open in new tab</em> button
- at the end of its title. An embedded attachment has the same button.</p>
-<p>The <span class="tn-icon bx bx-dots-vertical-rounded"></span> <em>More actions</em> button
- at the end of the title row opens the same menu as right-clicking anywhere
- on the title row: the other places to open the note in and, for an embedded
- attachment, the actions on the attachment.</p>
-<p>In a note being edited, the menu also has the commands of the include's
- toolbar: the <em>Size</em> submenu, <em>Show title</em> and <em>Show caption</em>,
- each checked while it is in effect, and <em>Convert to link</em> at the end.
- A drawing canvas, an included text or code note and an embedded code file
- also have <em>Editable</em>, above <em>Size</em>. For an embedded attachment
- they follow its first group of actions; for an included note they end the
- menu.</p>
-<p>To show an include of size <em>Medium</em> or <em>Full</em> on the whole screen,
- press the <span class="tn-icon bx bx-fullscreen"></span> <em>Fullscreen</em> button
- at the end of its title. An excerpt of the blocks of a note has an <span
- class="tn-icon bx bx-pencil"></span> <em>Edit excerpt</em> button there instead;
- see <a class="reference-link" href="#root/_help_klC3ilXa9kUE">Block references</a>.
- To return, press <span class="tn-icon bx bx-exit"></span> <em>Exit fullscreen</em> in
- the top-right corner, or <kbd>Esc</kbd>.</p>
-<p>A <em>Tiny</em> include has these buttons instead, followed by the same <em>More actions</em> button:</p>
-<ul>
- <li>For a note, <span class="tn-icon bx bx-edit"></span> <em>Quick edit</em> opens
- the note in&nbsp;<a class="reference-link" href="#root/_help_ZjLYv08Rp3qC">Quick edit</a>,
- and <span class="tn-icon bx bx-link-external"></span> <em>Open in new tab</em> opens
- it in a new tab.</li>
- <li>For an embedded attachment, <span class="tn-icon bx bx-file-find"></span> <em>Open externally</em> opens
- the file in another application, and <span class="tn-icon bx bx-download"></span> <em>Download</em> downloads
- it. The size of the file is shown under its title.</li>
-</ul>
-<h2>Converting an include to a link</h2>
-<p>To replace an include with a link to the included note, select it and
- press the <span class="tn-icon cke cke-link"></span> <em>Convert to link</em> button
- in its toolbar, or choose <em>Convert to link</em> at the end of its <em>More actions</em> menu.
- An embedded attachment turns into a link to the attachment the same way.</p>
-<h2>Included notes in the share functionality</h2>
-<p>If a <a href="#root/_help_R9pX4DGra2Vt">shared note</a> contains one or
- more included notes, they will be displayed in the content of the note
- as if they were part of the note itself. The caption of an include is shown
- under the included content. A <em>Tiny</em> include is shown as a link to
- the included note instead, and so is an include that would show a note
- already shown around it, such as a note that includes itself. The same
- goes for a printed or exported note.</p>
-<p>For this to work, the included notes must also be shared, otherwise they
- will not be shown. However, the included notes can still be hidden from
- the note tree via <code>#shareHiddenFromTree</code>.</p>
-<h2>Interactive notes</h2>
-<p>Since v0.104.0, included notes might become interactive depending on their
- note type:</p>
-<ul>
- <li><a class="reference-link" href="#root/_help_GTwFsgaA0lCt">Collections</a>&nbsp;(e.g.&nbsp;<a
- class="reference-link" href="#root/_help_81SGnPGMk7Xc">Geo Map</a>) will
- render fully interactive, including creating new notes.</li>
- <li><a class="reference-link" href="#root/_help_m523cpzocqaD">Saved Search</a>&nbsp;will
- also display the results.</li>
- <li><a class="reference-link" href="#root/_help_1vHRoWCEjj0L">Web View</a>&nbsp;provides
- an interactive preview of the website.</li>
-</ul>
-<h2>Included images</h2>
-<p>An included image, whether an image note or an image attachment, is shown
- in the image viewer, which zooms and pans it:</p>
-<ul>
- <li>To zoom, press the <span class="tn-icon bx bx-plus-circle"></span> <em>Zoom in</em> and <span
- class="tn-icon bx bx-minus-circle"></span> <em>Zoom out</em> buttons in the
- bottom-right corner of the image, or pinch on a touch screen. The percentage
- between them resets the zoom.</li>
- <li>To zoom with the mouse wheel, click the image first. Until then, the mouse
- wheel scrolls the note.</li>
- <li>To pan an image that is zoomed in, drag it. At its fitted size, dragging
- the image on a touch screen scrolls the note.</li>
- <li>To return to the fitted size, double-click the image.</li>
-</ul>
-<p>In a <em>Small</em> or <em>Medium</em> box, the image is scaled down to fit
- the height of the box. In fullscreen, it fits the screen.</p>
-<h2>Editing an include in place</h2>
-<p>An included text note, an included code note and an embedded code file
- such as a <code>.js</code>, <code>.py</code> or <code>.txt</code> attachment
- can be edited without leaving the note that includes them. A code note
- or file is shown with syntax highlighting until then.</p>
-<ul>
- <li>To edit, select the include and turn on the <span class="tn-icon bx bx-edit-alt"></span> <em>Editable</em> button
- at the start of its toolbar, or check <em>Editable</em> in its <span class="tn-icon cke cke-three-vertical-dots"></span> <em>More actions</em> menu.
- Turn <em>Editable</em> off to return to the preview.</li>
- <li>While an included text note has the focus, the formatting toolbar applies
- to it. The notes it includes in turn stay read-only.</li>
- <li>Code is edited in the same code editor as a <a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a> note,
- with its theme, indentation and line wrapping settings.</li>
- <li>The changes are saved as you type, to the included note or to the attachment,
- as they would be in its own tab.</li>
- <li>An include of <a class="reference-link" href="#root/_help_klC3ilXa9kUE">Block references</a> edits
- only the referenced blocks.</li>
- <li>Editing is not available in a <a href="#root/_help_CoFPLs3dRlXc">read-only note</a>,
- for an included note marked <code>#readOnly</code>, or for an attachment
- of another note.</li>
-</ul>
-<h2>Drawing canvases</h2>
-<p>A drawing canvas is an Excalidraw canvas, like the one of a <a class="reference-link"
- href="#root/_help_grjYqerjn243">Canvas</a> note, drawn directly in the text
- note. It is not a note of its own: the drawing is kept in a <code>Canvas.excalidraw</code> <a
- href="#root/_help_0vhv7lsOLy82">attachment</a> of the text note and is saved
- together with the text.</p>
-<ul>
- <li>To insert a drawing canvas, open the <span class="tn-icon cke cke-plus"></span> <em>Insert</em> menu
- of the <a class="reference-link" href="#root/_help_nRhnJkTT8cPs">Formatting toolbar</a> and
- choose <span class="tn-icon bx bx-pen"></span> <em>Drawing canvas</em>, above <em>Mermaid diagram</em>.
- It is also available as <em>Drawing canvas</em> in the <a class="reference-link"
- href="#root/_help_ZlN4nump6EbW">Slash Commands</a>. The canvas is added
- empty and editable, in a <em>Medium</em> box with its title hidden, and takes
- the focus, ready for drawing.</li>
- <li>To draw or write over an image, select the image and press the <span class="tn-icon bx bxs-pen"></span> <em>Convert image to a drawing canvas</em> button
- of its toolbar. The image is replaced by an editable drawing canvas in
- a <em>Medium</em> box, with its title hidden and the focus in it. The image
- sits at its original size in the middle of the canvas, zoomed so that all
- of it shows, and is locked so that it cannot be selected or moved by accident.
- While it is locked, the canvas can be zoomed in on the image but not zoomed
- out past it or scrolled beyond its edges. To move or resize the image anyway,
- right-click it and choose <em>Unlock</em>. The caption of the image is kept,
- but not its alignment or link. Only an image on its own line can be converted,
- not one inside a paragraph. Undo brings the image back.</li>
- <li>An Excalidraw file (<code>.excalidraw</code>) attached with the <span class="tn-icon cke cke-paper-clip"></span><em>Attach file</em> button
- becomes a drawing canvas too, in a <em>Medium</em> box titled with the file
- name. It starts with <em>Editable</em> off, so the drawing shows but cannot
- be changed until <em>Editable</em> is turned on (see below).</li>
- <li>To draw on a canvas that does not have the focus, click it first. Until
- then, touch gestures scroll the note. The canvas then has the tools, menus
- and keyboard shortcuts of a Canvas note. The toolbars, the menus and the
- properties of the selected shapes show only while the canvas has the focus,
- so elsewhere the drawing reads like a picture in the text.</li>
- <li>The mouse wheel and the touchpad scroll the note over a canvas too, as
- over the text. To zoom, use the zoom buttons of the canvas toolbar; to
- move around the drawing, use the <span class="tn-icon bx bxs-hand"></span> <em>Hand</em> tool.
- In fullscreen, the mouse wheel moves and zooms the drawing instead.</li>
- <li>The canvas toolbar replaces the Excalidraw menu: <em>Export image</em>, <em>Find on canvas</em>, <em>Library</em> and <em>Help</em> are
- at the end of its <span class="tn-icon bx bx-category"></span> <em>More tools</em> menu.
- In fullscreen, the Excalidraw menu shows again.</li>
- <li>A new drawing has the background color of the note. A background chosen
- from the Excalidraw menu replaces it.</li>
- <li>To protect a finished drawing from accidental changes, select it and turn
- off the <span class="tn-icon bx bx-edit-alt"></span> <em>Editable</em> button
- at the start of its toolbar, or uncheck <em>Editable</em> in its <span class="tn-icon cke cke-three-vertical-dots"></span> <em>More actions</em> menu.
- The drawing then shows as a still picture, at the zoom and position it
- had, and can no longer be changed, zoomed or moved. To draw again, turn <em>Editable</em> back
- on.</li>
- <li>The box sizes, resizing, the caption and the title work as for an included
- note, but the toolbar of a drawing leaves the box size, <em>Show title</em> and <em>Convert to link</em> to
- its <em>More actions</em> menu.</li>
- <li>In the desktop layout, Excalidraw keeps its desktop interface however
- small the box is. In the mobile layout, a narrow or short box switches
- it to a compact interface. For more room, choose <em>Full</em>, or show
- the title and press <span class="tn-icon bx bx-fullscreen"></span> <em>Fullscreen</em>.</li>
- <li>Pictures added to the drawing are stored in the same attachment. A converted
- image is kept as an image attachment of the note instead, named with a
- generated code.</li>
- <li>In a <a href="#root/_help_CoFPLs3dRlXc">read-only note</a>, the drawing
- shows as a still picture too.</li>
- <li>On a <a href="#root/_help_R9pX4DGra2Vt">shared page</a>, the drawing is
- shown as a picture at its own size, whatever the size of its box, in light
- or dark colors to match the page. Each change to the drawing saves this
- picture as an SVG image attachment of the note, also named with a generated
- code.</li>
-</ul>
-<h3>Limitations</h3>
-<ul>
- <li>The Excalidraw shape library is not saved for a drawing canvas.</li>
- <li>Outside the editor, for example in a tooltip, when printing or in the
- list of attachments, the drawing is shown as a picture.</li>
- <li>A drawing has no picture for shared pages until its first change, except
- one converted from an image. Until then, for example for an attached <code>.excalidraw</code> file,
- a shared page shows a link to download the drawing instead.</li>
- <li>In Safari, the picture of a drawing on a shared page follows the light
- or dark appearance of the system rather than the theme chosen on the page.</li>
- <li>A copy of a drawing canvas pasted in the same note shares the drawing
- with the original, so a change to one shows in the other only after the
- note is opened again. A copy pasted in another note gets a drawing of its
- own.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Insert buttons.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Insert buttons.html
deleted file mode 100644
index 083746f365..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Insert buttons.html
+++ /dev/null
@@ -1,102 +0,0 @@
-<p>Press the&nbsp;<span class="tn-icon cke cke-plus"></span> button in the&nbsp;<a
- class="reference-link" href="#root/_help_nRhnJkTT8cPs">Formatting toolbar</a>&nbsp;to
- reveal special inserable items and blocks such as symbols, Math expressions
- and separators.</p>
-<h2>Bookmarks</h2>
-<p>See the dedicated&nbsp;<a class="reference-link" href="#root/_help_oSuaNgyyKnhu">Anchors</a>&nbsp;section.</p>
-<h2>Emoji</h2>
-<figure class="image image-style-align-right image_resized" style="width:42.4%;">
- <img style="aspect-ratio:366/410;" src="Insert buttons_plus.png" width="366"
- height="410">
-</figure>
-<p>This feature allows inserting Unicode emoji characters. Simply select
- a category and a desired emoji to insert it.</p>
-<p>Emojis can also be searched by their English name and the skin tone can
- be selected via a combo box to the right.</p>
-<p>There is also the possibility of inserting emojis directly by typing <code>:</code> followed
- by a name of an emoji, triggering the display of a list of emojis. Simply
- use the arrow keys to select one and press <kbd>Enter</kbd> or <kbd>Tab</kbd> to
- insert it.</p>
-<img src="1_Insert buttons_plus.png" width="272" height="187">
-<h2>Symbols</h2>
-<figure class="image image-style-align-right">
- <img style="aspect-ratio:346/322;" src="Insert buttons_image.png" width="346"
- height="322">
-</figure>
-<p>Pressing the&nbsp;<span class="tn-icon cke cke-special-characters"></span> button
- will reveal a popup window displaying a list of characters that are generally
- more difficult to insert directly from the keyboard, such as a subset of
- emojis, quotation characters, etc.</p>
-<p>Interaction:</p>
-<ul>
- <li>Click on a character to insert it at the current cursor position.</li>
- <li>The window can be dragged around by the top bar where the title is, to
- avoid it getting in the way of the text.</li>
- <li>Click on the <em>Category</em> selector to filter the characters.</li>
-</ul>
-<h2>Multicolumn layout</h2>
-<p>See the dedicated&nbsp;<a class="reference-link" href="#root/_help_wYDzQ1fBFgfT">Multicolumn layout</a>&nbsp;page.</p>
-<h2>Math equations</h2>
-<p>See the dedicated&nbsp;<a class="reference-link" href="#root/_help_YfYAtQBcfo5V">Math Equations</a>&nbsp;page.</p>
-<h2>Drawing canvas</h2>
-<p>Choose <span class="tn-icon bx bx-pen"></span> <em>Drawing canvas</em> to
- draw on an Excalidraw canvas inside the text. See <em>Drawing canvases</em> in <a
- class="reference-link" href="#root/_help_nBAXQFj20hS1">Include Note</a>.</p>
-<h2>Mermaid diagram</h2>
-<p>Press the&nbsp;<span class="tn-icon cke cke-trilium-mermaid-insert"></span> button
- to create an inline Mermaid diagram.</p>
-<p>This feature is quite similar to the&nbsp;<a class="reference-link" href="#root/_help_s1aBHPd79XYj">Mermaid Diagrams</a>&nbsp;note
- types and is meant as an alternative to it for simple diagrams. For more
- complex diagrams, use the&nbsp;<a class="reference-link" href="#root/_help_nBAXQFj20hS1">Include Note</a>&nbsp;feature
- for a dedicated Mermaid note.</p>
-<figure class="image">
- <img style="aspect-ratio:1174/358;" src="2_Insert buttons_image.png" width="1174"
- height="358">
-</figure>
-<h2>Horizontal ruler</h2>
-<p>This feature will display a horizontal line, generally useful to separate
- different sections of the text. To do so, press the&nbsp;<span class="tn-icon cke cke-horizontal-line"></span> button
- in the&nbsp;<a class="reference-link" href="#root/_help_nRhnJkTT8cPs">Formatting toolbar</a>.</p>
-<img
-src="1_Insert buttons_image.png" width="502" height="95">
-<p>Alternatively, it's possible to insert a horizontal ruler by typing <code>---</code>.</p>
-<h2>Page break</h2>
-<figure class="image image-style-align-right">
- <img style="aspect-ratio:371/79;" src="3_Insert buttons_image.png" width="371"
- height="79">
-</figure>
-<p>Page breaks provide a way to force the next paragraph or block (table,
- image, etc.) to be displayed onto the next page when printing (either to
- a real printer to <a href="#root/_help_NRnIZmSMc5sj">when exporting to PDF</a>).</p>
-<p>Page breaks are marked in the editor with the words <em>Page break</em>,
- but they will not actually be shown when printed.</p>
-<ul>
- <li>To insert a page break, press the&nbsp;<span class="tn-icon cke cke-page-break"></span> in
- the formatting toolbar.</li>
- <li>To insert many page breaks at once, insert a page break first, click on
- it and press <kbd>Ctrl</kbd>+<kbd>C</kbd>. Then use <kbd>Ctrl</kbd>+<kbd>V</kbd>,
- to paste as many times as needed.</li>
-</ul>
-<h2>Date and time</h2>
-<p>The <span class="tn-icon cke cke-trilium-date-time"></span> button inserts
- the current date and time at the cursor, replacing the selected text if
- there is any. The inserted text takes the formatting of the text around
- it, so a date inserted inside bold text is bold too.</p>
-<ul>
- <li>To insert the date in the default format, press the button itself or press <kbd>Alt</kbd>+<kbd>T</kbd>.</li>
- <li>To insert it in another format, press the arrow next to the button and
- pick a format from the list. Each entry shows the current date and time
- in that format: the default one, the date or the time alone, the date written
- out, and ISO 8601.</li>
- <li>The same formats are offered by the <a class="reference-link" href="#root/_help_ZlN4nump6EbW">Slash Commands</a>:
- type <code>/date</code>, <code>/time</code>, <code>/now</code> or <code>/today</code>.
- The <em>Insert date/time</em> entry uses the default format, and shows what
- it inserts underneath; the other entries show their output in the title.</li>
-</ul>
-<p>The default format can be changed in <a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a> → <em>Text Notes</em> → <em>Editor</em> → <em>Date/time format</em>,
- using <a href="https://day.js.org/docs/en/display/format">Day.js format tokens</a> (for
- example <code>DD.MM.YYYY HH:mm</code>).</p>
-<h2>Icons</h2>
-<p>Icons just like the ones for the <a href="#root/_help_p9kXRFAkwN4o">note icon</a> can
- be inserted in text. For more information see&nbsp;<a class="reference-link"
- href="#root/_help_hD8GawVuazff">Icons</a>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Insert buttons/Icons.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Insert buttons/Icons.html
deleted file mode 100644
index 8ca2fdbe74..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Insert buttons/Icons.html
+++ /dev/null
@@ -1,57 +0,0 @@
-<p>Icons just like the <a href="#root/_help_hD8GawVuazff">note icons</a> can
- be inserted in the content of a note, including from any other <a href="#root/_help_gOKqSJgXLcIj">custom icon packs</a>.</p>
-<h2>Features</h2>
-<ul>
- <li>The icon can be formatted through the<a class="reference-link" href="#root/_help_Gr6xFaF6ioJ5">General formatting</a>&nbsp;tools
- of the&nbsp;<a class="reference-link" href="#root/_help_nRhnJkTT8cPs">Formatting toolbar</a>:
- <ul>
- <li>Foreground/icon color</li>
- <li>Background color/highlight</li>
- <li>Font size</li>
- </ul>
- </li>
- <li>Custom&nbsp;<a class="reference-link" href="#root/_help_gOKqSJgXLcIj">Icon Packs</a>&nbsp;are
- also supported.
- <ul>
- <li>For emojis, prefer the Emoji functionality from&nbsp;<a class="reference-link"
- href="#root/_help_CohkqWQC1iBv">Insert buttons</a>.</li>
- </ul>
- </li>
- <li>When an icon is clicked a floating toolbar appears with the following
- functions:
- <ul>
- <li><span class="tn-icon bx bx-sticker"></span>&nbsp;which changes the icon.</li>
- <li><span class="tn-icon bx bx-reflect-horizontal"></span>&nbsp;which applies
- transforms: rotate (90 / 180 / 270) and flip horizontal/vertical. Only
- one transform can be used per icon.</li>
- </ul>
- </li>
-</ul>
-<h2>Usage</h2>
-<ul>
- <li>The in-app help/user guide makes use of these icons in order to illustrate
- buttons in the UI.</li>
- <li>The&nbsp;<a class="reference-link" href="#root/_help_GnhlmrATVqcH">Microsoft OneNote</a>&nbsp;importer
- also makes use of them for the&nbsp;<a class="reference-link" href="#root/_help_LpvyEIBIAAj7">Tags</a>.</li>
-</ul>
-<h2>Inserting an icon</h2>
-<p>There are two ways to insert an icon:</p>
-<ul>
- <li>Via the&nbsp;<a class="reference-link" href="#root/_help_nRhnJkTT8cPs">Formatting toolbar</a>&nbsp;look
- for the&nbsp;<span class="tn-icon bx bx-plus"></span> icon and then the&nbsp;<span
- class="tn-icon bx bx-sticker"></span> icon.</li>
- <li>Via&nbsp;<a class="reference-link" href="#root/_help_ZlN4nump6EbW">Slash Commands</a>,
- type <code>/icon</code>.</li>
-</ul>
-<p>An icon picker will appear, search for an icon and click it to insert
- it in the document.</p>
-<h2>Finding notes by their icons</h2>
-<p>An icon can be <a href="#root/_help_eIg8jdvaoNNd">searched</a>. A note
- containing a&nbsp;<span class="tn-icon bx bx-star"></span> icon can be found
- by searching for <code>star</code>, or its <code>iconClass</code> (<code>bx-star</code>).</p>
-<p>To find the name of the icon, hover the mouse over an icon while in the
- icon picker.</p>
-<h2>Markdown rendering</h2>
-<p>When exporting to&nbsp;<a class="reference-link" href="#root/_help_Oau6X9rCuegd">Markdown</a>,
- the item will render as raw HTML representation of the icon as is used
- by Trilium:</p><pre><code class="language-text-html">&lt;span class="tn-icon bx bx-star"&gt;&lt;/span&gt;</code></pre>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Insert buttons_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Insert buttons_image.png
deleted file mode 100644
index 7ae8c13cc4..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Insert buttons_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Insert buttons_plus.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Insert buttons_plus.png
deleted file mode 100644
index 5cd65f1e16..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Insert buttons_plus.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Keyboard shortcuts.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Keyboard shortcuts.html
deleted file mode 100644
index 097b482a74..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Keyboard shortcuts.html
+++ /dev/null
@@ -1,394 +0,0 @@
-<h2>Trilium-specific shortcuts</h2>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Action</th>
- <th>PC</th>
- <th>Mac</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>Bring up inline formatting toolbar (arrow keys ←,→ to navigate, Enter
- to apply)</td>
- <td>Alt+F10</td>
- <td>⌥+F10</td>
- </tr>
- <tr>
- <td>Bring up block formatting toolbar</td>
- <td>Alt+F10</td>
- <td>⌥+F10</td>
- </tr>
- <tr>
- <td>Create <a href="#root/_help_QEAPj01N5f7w">external link</a>
- </td>
- <td>Ctrl+K</td>
- <td>⌘+K</td>
- </tr>
- <tr>
- <td>Create <a href="#root/_help_QEAPj01N5f7w">internal (note) link</a>
- </td>
- <td>Ctrl+L</td>
- <td>⌘+L</td>
- </tr>
- <tr>
- <td>Inserts current date and time at caret position</td>
- <td>Alt+T</td>
- <td>⌥+T</td>
- </tr>
- <tr>
- <td>Increase paragraph indentation</td>
- <td>Tab</td>
- <td>⇥</td>
- </tr>
- <tr>
- <td>Decrease paragraph indentation</td>
- <td>Shift + Tab</td>
- <td>⇧ + ⇥</td>
- </tr>
- <tr>
- <td>Mark selected text as <a href="#root/_help_UYuUB1ZekNQU">keyboard shortcut</a>
- </td>
- <td>Ctrl + Alt + K</td>
- <td>⌘+ ⌥+ K</td>
- </tr>
- <tr>
- <td>Insert&nbsp;<a class="reference-link" href="#root/_help_YfYAtQBcfo5V">Math Equations</a>
- </td>
- <td>Ctrl + M</td>
- <td>⌘+ M</td>
- </tr>
- <tr>
- <td>Move blocks (lists, paragraphs, etc.) up</td>
- <td>Ctrl+↑</td>
- <td>⌘+↑</td>
- </tr>
- <tr>
- <td>Alt+↑</td>
- <td>⌥+↑</td>
- <td></td>
- </tr>
- <tr>
- <td>Move blocks (lists, paragraphs, etc.) down</td>
- <td>Ctrl+↑</td>
- <td>⌘+↑</td>
- </tr>
- <tr>
- <td>Alt+↓</td>
- <td>⌥+↓</td>
- <td></td>
- </tr>
- <tr>
- <td>Move the selected content to another column of a <a class="reference-link"
- href="#root/_help_wYDzQ1fBFgfT">Multicolumn layout</a>
- </td>
- <td>Ctrl+←, Ctrl+→, Ctrl+Shift+Home, Ctrl+Shift+End</td>
- <td>⌘+←, ⌘+→, ⌘+⇧+Home, ⌘+⇧+End</td>
- </tr>
- <tr>
- <td>Move the current column of a multicolumn layout</td>
- <td>Ctrl+Alt+←, Ctrl+Alt+→, Ctrl+Alt+Home, Ctrl+Alt+End</td>
- <td>⌘+⌥+←, ⌘+⌥+→, ⌘+⌥+Home, ⌘+⌥+End</td>
- </tr>
- <tr>
- <td>Add a column after or before the current one in a multicolumn layout</td>
- <td>Ctrl+Enter, Ctrl+Shift+Enter</td>
- <td>⌘+Enter, ⌘+⇧+Enter</td>
- </tr>
- <tr>
- <td>Move the selected content to another tab in <a class="reference-link" href="#root/_help_EK2ckIZ74tbT">Content tabs</a>
- </td>
- <td>Ctrl+←, Ctrl+→, Ctrl+Shift+Home, Ctrl+Shift+End</td>
- <td>⌘+←, ⌘+→, ⌘+⇧+Home, ⌘+⇧+End</td>
- </tr>
- <tr>
- <td>Move the current tab of a tabs block</td>
- <td>Ctrl+Alt+←, Ctrl+Alt+→, Ctrl+Alt+Home, Ctrl+Alt+End</td>
- <td>⌘+⌥+←, ⌘+⌥+→, ⌘+⌥+Home, ⌘+⌥+End</td>
- </tr>
- <tr>
- <td>Add a tab after or before the current one in a tabs block</td>
- <td>Ctrl+Enter, Ctrl+Shift+Enter</td>
- <td>⌘+Enter, ⌘+⇧+Enter</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<h2>Common shortcuts</h2>
-<aside class="admonition tip">
- <p>This section of keyboard shortcuts presents a subset of the keyboard shortcuts
- as supported by the editor technology we are using,&nbsp;<a class="reference-link"
- href="#root/_help_MI26XDLSAlCD">CKEditor</a>. The shortcuts were taken
- from the <a href="https://ckeditor.com/docs/ckeditor5/latest/features/accessibility.html#keyboard-shortcuts">official documentation</a>.
- Note that not all the shortcuts in the original documentation are applicable
- (due to using a different configuration).</p>
-</aside>
-<h3>Content editing</h3>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Action</th>
- <th>PC</th>
- <th>Mac</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>Insert a hard break (a new paragraph)</td>
- <td>Enter</td>
- <td></td>
- </tr>
- <tr>
- <td>Insert a soft break (a <code>&lt;br&gt;</code> element)</td>
- <td>Shift+Enter</td>
- <td>⇧Enter</td>
- </tr>
- <tr>
- <td>Copy selected content</td>
- <td>Ctrl+C</td>
- <td>⌘C</td>
- </tr>
- <tr>
- <td>Paste content</td>
- <td>Ctrl+V</td>
- <td>⌘V</td>
- </tr>
- <tr>
- <td>Paste content as plain text</td>
- <td>Ctrl+Shift+V</td>
- <td>⌘⇧V</td>
- </tr>
- <tr>
- <td>Undo</td>
- <td>Ctrl+Z</td>
- <td>⌘Z</td>
- </tr>
- <tr>
- <td>Redo</td>
- <td>Ctrl+Y, Ctrl+Shift+Z</td>
- <td>⌘Y, ⌘⇧Z</td>
- </tr>
- <tr>
- <td>Bold text</td>
- <td>Ctrl+B</td>
- <td>⌘B</td>
- </tr>
- <tr>
- <td>Change text case</td>
- <td>Shift+F3</td>
- <td>⇧F3 (may require Fn)</td>
- </tr>
- <tr>
- <td>Create link</td>
- <td>Ctrl+K</td>
- <td>⌘K</td>
- </tr>
- <tr>
- <td>Move out of a link</td>
- <td>←←, →→</td>
- <td></td>
- </tr>
- <tr>
- <td>Move out of an inline code style</td>
- <td>←←, →→</td>
- <td></td>
- </tr>
- <tr>
- <td>Select all</td>
- <td>Ctrl+A</td>
- <td>⌘A</td>
- </tr>
- <tr>
- <td>Find in the document</td>
- <td>Ctrl+F</td>
- <td>⌘F</td>
- </tr>
- <tr>
- <td>Copy text formatting</td>
- <td>Ctrl+Shift+C</td>
- <td>⌘⇧C</td>
- </tr>
- <tr>
- <td>Paste text formatting</td>
- <td>Ctrl+Shift+V</td>
- <td>⌘⇧V</td>
- </tr>
- <tr>
- <td>Italic text</td>
- <td>Ctrl+I</td>
- <td>⌘I</td>
- </tr>
- <tr>
- <td>Strikethrough text</td>
- <td>Ctrl+Shift+X</td>
- <td>⌘⇧X</td>
- </tr>
- <tr>
- <td>Underline text</td>
- <td>Ctrl+U</td>
- <td>⌘U</td>
- </tr>
- <tr>
- <td>Revert autoformatting action</td>
- <td>Backspace</td>
- <td></td>
- </tr>
- </tbody>
- </table>
-</figure>
-<h3>Interacting with blocks</h3>
-<p>Blocks are images, tables, blockquotes, annotations.</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Action</th>
- <th>PC</th>
- <th>Mac</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>Insert a new paragraph directly after a widget</td>
- <td>Enter</td>
- <td></td>
- </tr>
- <tr>
- <td>Insert a new paragraph directly before a widget</td>
- <td>Shift+Enter</td>
- <td>⇧Enter</td>
- </tr>
- <tr>
- <td>Move the caret to allow typing directly before a widget</td>
- <td>↑, ←</td>
- <td></td>
- </tr>
- <tr>
- <td>Move the caret to allow typing directly after a widget</td>
- <td>↓, →</td>
- <td></td>
- </tr>
- <tr>
- <td>After entering a nested editable, move the selection to the closest ancestor
- widget. For example: move from an image caption to the whole image widget.</td>
- <td>Tab then Esc</td>
- <td></td>
- </tr>
- </tbody>
- </table>
-</figure>
-<p>Specifically for lists:</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Action</th>
- <th>PC</th>
- <th>Mac</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>Increase list item indent</td>
- <td>⇥</td>
- <td></td>
- </tr>
- <tr>
- <td>Decrease list item indent</td>
- <td>Shift+⇥</td>
- <td>⇧⇥</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<p>In tables:</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Action</th>
- <th>PC</th>
- <th>Mac</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>Move the selection to the next cell</td>
- <td>⇥</td>
- <td></td>
- </tr>
- <tr>
- <td>Move the selection to the previous cell</td>
- <td>Shift+⇥</td>
- <td>⇧⇥</td>
- </tr>
- <tr>
- <td>Insert a new table row (when in the last cell of a table)</td>
- <td>⇥</td>
- <td></td>
- </tr>
- <tr>
- <td>Navigate through the table</td>
- <td>↑, →, ↓, ←</td>
- <td></td>
- </tr>
- </tbody>
- </table>
-</figure>
-<h3>General UI shortcuts</h3>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Action</th>
- <th>PC</th>
- <th>Mac</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>Close contextual balloons, dropdowns, and dialogs</td>
- <td>Esc</td>
- <td></td>
- </tr>
- <tr>
- <td>Open the accessibility help dialog</td>
- <td>Alt+0</td>
- <td>⌥0</td>
- </tr>
- <tr>
- <td>Move focus between form fields (inputs, buttons, etc.)</td>
- <td>⇥, Shift+⇥</td>
- <td>⇥, ⇧⇥</td>
- </tr>
- <tr>
- <td>Move focus to the toolbar, navigate between toolbars</td>
- <td>Alt+F10</td>
- <td>⌥F10 (may require Fn)</td>
- </tr>
- <tr>
- <td>Navigate through the toolbar or menu bar</td>
- <td>↑, →, ↓, ←</td>
- <td></td>
- </tr>
- <tr>
- <td>Navigate to the next focusable field or an element outside the editor</td>
- <td>Tab, Shift+Tab</td>
- <td></td>
- </tr>
- <tr>
- <td>Execute the currently focused button. Executing buttons that interact
- with the editor content moves the focus back to the content.</td>
- <td>Enter, Space</td>
- <td></td>
- </tr>
- <tr>
- <td>Move focus in and out of an active dialog window</td>
- <td>Ctrl+F6</td>
- <td>⌘F6 (may require Fn)</td>
- </tr>
- </tbody>
- </table>
-</figure>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Link Previews.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Link Previews.html
deleted file mode 100644
index a55693478e..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Link Previews.html
+++ /dev/null
@@ -1,123 +0,0 @@
-<p>Link previews turn a pasted URL into a rich, metadata-aware widget that
- can be displayed in three visual modes:</p>
-<h2>Display modes</h2>
-<p>A link preview can be displayed in one of three modes:</p>
-<ul>
- <li><strong>Inline</strong> — a link showing the site's favicon and page title
- (quite similar to&nbsp;<a class="reference-link" href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a>).
- Use this when you want the link to flow with the surrounding paragraph.</li>
- <li><strong>Card</strong> — a block-level preview with thumbnail, title, description,
- and site name. Use this when the link is the focus of a paragraph.</li>
- <li><strong>Embed</strong> — a block-level interactive embed.
- <ul>
- <li>Currently supported for YouTube videos, which render interactively (via
- an <code>iframe</code>).</li>
- <li>To prevent unwanted remote requests, the video is shown only after clicking
- on it first.</li>
- </ul>
- </li>
-</ul>
-<div class="trilium-multicolumn-layout" data-trilium-column-ratios="1-1-1">
- <div class="trilium-multicolumn-column">
- <figure class="image image_resized" style="width:100%;">
- <img style="aspect-ratio:251/42;" src="Link Previews_image.png" width="251"
- height="42">
- <figcaption><em>Inline</em> link preview</figcaption>
- </figure>
- </div>
- <div class="trilium-multicolumn-column">
- <figure class="image image_resized" style="width:100%;">
- <img style="aspect-ratio:1217/196;" src="2_Link Previews_image.png" width="1217"
- height="196">
- <figcaption><em>Card</em> link preview</figcaption>
- </figure>
- </div>
- <div class="trilium-multicolumn-column">
- <figure class="image image_resized" style="width:100%;">
- <img style="aspect-ratio:994/563;" src="1_Link Previews_image.png" width="994"
- height="563">
- <figcaption><em>Embed</em> link preview</figcaption>
- </figure>
- </div>
-</div>
-<h2>Inserting a link preview</h2>
-<p>There are three ways to create one:</p>
-<h3>1. By pasting a URL</h3>
-<p>A link preview is automatically created:</p>
-<ul>
- <li>By pasting the URL and pressing <kbd>Space</kbd>. This will create an <em>inline</em> link
- preview.</li>
- <li>When at the start of a new paragraph, pressing <kbd>Enter</kbd> will create
- a <em>card</em> or an <em>embed</em> for YouTube URLs.</li>
-</ul>
-<p>To undo an automatic link preview, press <kbd>Ctrl</kbd>+<kbd>Z</kbd> immediately
- afterwards which keeps it as a plain link instead. Alternatively, once
- a link preview was created, click on the link and select <em>Plain link</em> from
- the link preview toolbar.</p>
-<p>This automatic conversion can be disabled by going to&nbsp;<a class="reference-link"
- href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Text Notes</em> and
- unchecking <em>Autogenerate link previews</em> from the <em>Features</em> section.</p>
-<p>If the link is not accessible to the Trilium server (or the network request
- fails for any other reason), it will not be converted to a link preview.</p>
-<aside
-class="admonition note">
- <p>A URL is only auto-converted when the pasted text <em>is</em> the URL. Links
- with a display name (e.g. <a href="https://triliumnotes.org">Trilium Notes website</a>)
- are left as plain links.</p>
-</aside>
-<h3>2. By using the "Link preview" toolbar button</h3>
-<p>Click <em>Link preview</em> (<span class="tn-icon cke cke-trilium-link-preview"></span>)
- in the formatting toolbar to open the <em>Link preview</em> popup. Paste
- the URL and choose the type of preview.</p>
-<h3>3. By saving browser tabs from the Web Clipper</h3>
-<p>When the&nbsp;<a class="reference-link" href="#root/_help_MtPxeAWVAzMg">Web Clipper</a>&nbsp;saves
- the tabs of a window, each tab becomes an <em>inline</em> link preview showing
- the title and favicon the browser displays for it. Because this data comes
- from the browser, pages behind a login keep their real title, and the Trilium
- server does not contact the saved pages.</p>
-<p>When <em>Autogenerate link previews</em> is turned off, the tabs are saved
- as a list of plain links instead.</p>
-<h2>Altering an existing link preview</h2>
-<p>Click on an inserted link preview to select it, and a small toolbar will
- appear with the following options:</p>
-<ul>
- <li>The normal link operations (opening in a new tab, copying the link, unlinking).</li>
- <li>A button to edit the title of the link preview. This is especially useful
- if the title is hidden behind a login screen.</li>
- <li>A way to switch between the link preview modes (Inline, Card or Embed)
- as well as to convert it to a normal link instead.
- <ul>
- <li>The Embed option is only enabled when the URL points to a supported service
- (YouTube today).</li>
- </ul>
- </li>
-</ul>
-<h2>Where the preview data comes from</h2>
-<p>When you insert a link preview, Trilium fetches metadata once and stores
- it inside the note's HTML:</p>
-<ul>
- <li><strong>YouTube URLs</strong> — title, channel name, and thumbnail are
- fetched via YouTube's public oEmbed endpoint.</li>
- <li><strong>All other URLs</strong> — Trilium fetches the page and reads OpenGraph
- tags (<code>og:title</code>, <code>og:description</code>, <code>og:image</code>, <code>og:site_name</code>),
- falling back to the page's <code>&lt;title&gt;</code> and <code>&lt;meta name="description"&gt;</code>.
- The site's favicon is downloaded and inlined.</li>
-</ul>
-<p>Because the data is stored in the note itself, link previews continue
- to render correctly when you reopen the note, share/publish it, or export
- to HTML — without any further network requests.</p>
-<p>The metadata is captured <strong>at insertion time</strong> and is not automatically
- refreshed. If the linked page later changes its title or thumbnail, you'll
- need to re-insert the link to pick up the new values. To refresh a link,
- simply create it again.</p>
-<p>When accessing a&nbsp;<a class="reference-link" href="#root/_help_WOcw2SLH6tbX">Server Installation</a>,
- the data is fetched from the remote URL by the server and not the client.</p>
-<h2>Known limitations</h2>
-<ul>
- <li>The Embed display mode currently only supports YouTube. Other video and
- media platforms fall back to a Card preview.</li>
- <li>Pages that block automated fetches may produce a minimal preview (hostname
- only).</li>
- <li>Link previews require the Trilium server to reach the target URL, so they
- won't generate previews for pages on networks the server can't see.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Link Previews_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Link Previews_image.png
deleted file mode 100644
index 5a9a57da56..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Link Previews_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links.html
deleted file mode 100644
index 0f1556e117..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links.html
+++ /dev/null
@@ -1,16 +0,0 @@
-<p>There are two types of links:</p>
-<ul>
- <li><a class="reference-link" href="#root/_help_3IDVtesTQ8ds">External links</a>,
- for standard hyperlinks to websites or other resources.</li>
- <li><a class="reference-link" href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a>&nbsp;for
- links to other notes within Trilium.
- <ul>
- <li>The list of notes that refer to a particular note is called&nbsp;<a class="reference-link"
- href="#root/_help_wfGXLmm7x27z">Backlinks</a>.</li>
- </ul>
- </li>
-</ul>
-<h2>Note map</h2>
-<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>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/Backlinks.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/Backlinks.html
deleted file mode 100644
index dcf34d1ec6..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/Backlinks.html
+++ /dev/null
@@ -1,80 +0,0 @@
-<p>A link points from one note to another; a <em>backlink</em> is that same
- connection seen from the other end: the list of notes that refer to the
- current one.</p>
-<p>Backlinks are maintained automatically and are read-only from this side.
- A backlink disappears when the note that created it removes the link; it
- cannot be deleted from the note being pointed at.</p>
-<h2>What counts as a backlink</h2>
-<p>Any&nbsp;<a class="reference-link" href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a>&nbsp;pointing
- at the current note, which covers two rather different cases:</p>
-<ul>
- <li>Relations that Trilium maintains on your behalf.
- <ul>
- <li>The most common is <code>internalLink</code>, created whenever a note refers
- to another one through&nbsp;<a class="reference-link" href="#root/_help_hrZ1D00cLbal">Internal (reference) links</a>&nbsp;in
- its text.</li>
- <li>Embedded images (<code>imageLink</code>), relation map connections (<code>relationMapLink</code>)
- and note inclusions (<code>includeNoteLink</code>) work the same way.</li>
- </ul>
- </li>
- <li>Relations you define yourself.
- <ul>
- <li>If another note has <code>~author</code> pointing at the current note, that
- note is listed here as well.</li>
- </ul>
- </li>
-</ul>
-<p>Relations coming from a&nbsp;<a class="reference-link" href="#root/_help_m523cpzocqaD">Saved Search</a>&nbsp;are
- excluded, since a search stores an <code>ancestor</code> relation that would
- otherwise list every one of its results as a backlink.</p>
-<aside class="admonition note">
- <p>Only some note types have their content scanned for links:&nbsp;<a class="reference-link"
- href="#root/_help_iPIMuisry3hd">Text</a>,&nbsp;<a class="reference-link"
- href="#root/_help_6RM1Q7ppFVoj">Markdown</a>,&nbsp;<a class="reference-link"
- href="#root/_help_iRwzGnHPzonm">Relation Map</a>&nbsp;and&nbsp;<a class="reference-link"
- href="#root/_help_GBBMSlVSOIGP">AI</a>&nbsp;chats. A link written inside
- a&nbsp;<a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;note
- is not registered and will not appear as a backlink on the target note.
- A relation set manually on a code note does still count.</p>
-</aside>
-<h2>How entries are displayed</h2>
-<p>Each entry names the note the reference comes from, followed by one of:</p>
-<ul>
- <li><strong>An excerpt</strong> of the surrounding content, with the link itself
- highlighted. This is available for&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes
- and for&nbsp;<a class="reference-link" href="#root/_help_GBBMSlVSOIGP">AI</a>&nbsp;chat
- notes. Roughly 200 characters of context are quoted around the link, trimmed
- with an ellipsis where the surrounding text is longer, and images are left
- out.</li>
- <li><strong>The name of the relation</strong>, for every other note type where
- the source cannot be quoted. This is the case for&nbsp;<a class="reference-link"
- href="#root/_help_iRwzGnHPzonm">Relation Map</a>&nbsp;notes and for any
- note carrying a relation you defined yourself.</li>
-</ul>
-<p>A note is listed once per reference it makes, so a note that links to
- the current one three times occupies three rows.</p>
-<p>Of note:</p>
-<ul>
- <li>For AI chat notes, only the assistant's own prose is quoted. A chat that
- reached the note purely through tool calls has nothing to quote and is
- listed by relation name instead.</li>
- <li>Excerpts are only generated for roughly the first 50 sources. On a heavily
- referenced note, the remaining entries fall back to showing the relation
- name.</li>
-</ul>
-<h2>Where backlinks are shown</h2>
-<ul>
- <li>In the&nbsp;<a class="reference-link" href="#root/_help_KRlZFoIH0j6p">Connections tab</a>&nbsp;of
- the&nbsp;<a class="reference-link" href="#root/_help_RnaPdbciOfeq">Right Sidebar</a>,
- as a dedicated section.</li>
- <li>As a badge in the&nbsp;<a class="reference-link" href="#root/_help_AlJ73vBCjWDw">Status bar</a>&nbsp;showing
- the number of backlinks. The badge only appears when the note is being
- read normally (not in a revision or attachment view) and when there is
- at least one backlink; pressing it opens the section above.</li>
- <li>In&nbsp;<a class="reference-link" href="#root/_help_ZjLYv08Rp3qC">Quick edit</a>,
- as a button with a link icon in the header of the popup, under the same
- conditions; its tooltip gives the number of backlinks. Pressing a backlink
- opens that note in the popup.</li>
- <li>Incoming links are also drawn on the link map, see&nbsp;<a class="reference-link"
- href="#root/_help_BCkXAVs63Ttv">Note Map (Link map, Tree map)</a>.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/External links.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/External links.html
deleted file mode 100644
index 0a1045761f..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/External links.html
+++ /dev/null
@@ -1,35 +0,0 @@
-<p>An external link is a standard web link targeting for example a website.
- For example, <a href="https://en.wikipedia.org/wiki/South_China_Sea">https://en.wikipedia.org/wiki/South_China_Sea</a> is
- an external link to a Wikipedia page.</p>
-<p>To create a link without a custom text:</p>
-<ul>
- <li>Press&nbsp;<span class="tn-icon cke cke-link"></span> in the&nbsp;<a class="reference-link"
- href="#root/_help_nRhnJkTT8cPs">Formatting toolbar</a>:
- <ul>
- <li>A popup will appear, type or paste the URL in the box.</li>
- <li>Press <kbd>Enter</kbd> or the check mark icon to confirm.</li>
- </ul>
- </li>
- <li>Alternatively, press <kbd>Ctrl</kbd>+<kbd>K</kbd> to trigger the aforementioned
- popup.</li>
- <li>A simpler way is to paste the raw link and press space to turn it automatically
- into a link.</li>
-</ul>
-<p>To create a link with a custom text:</p>
-<ul>
- <li>First, type and select the text which will be turned into a link.</li>
- <li>Follow the previous steps to open the link interface (via the formatting
- toolbar, or <kbd>Ctrl</kbd>+<kbd>K</kbd>).</li>
- <li>Alternatively, simply paste (<kbd>Ctrl</kbd>+<kbd>V</kbd>) over the selected
- text to turn it into a link.</li>
-</ul>
-<p>Once a link is inserted:</p>
-<ul>
- <li>The text inside the link can be changed if needed but the link itself
- will remain.</li>
- <li>To modify the link, click on the link to display the popup and press the&nbsp;<span
- class="tn-icon cke cke-pencil"></span> <em>Edit link</em> button.</li>
- <li>To remove a link, click on it and press the&nbsp;<span class="tn-icon cke cke-unlink"></span> <em>Unlink</em> button.</li>
-</ul>
-<p>You can follow external link by either double clicking (will open new
- tab/window) it or right clicking on them and choosing "Open in new tab".</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/Internal (reference) links.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/Internal (reference) links.html
deleted file mode 100644
index f4e76b20e0..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/Internal (reference) links.html
+++ /dev/null
@@ -1,56 +0,0 @@
-<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&nbsp;<span class="tn-icon cke cke-trilium"></span> button
- underneath the&nbsp;<span class="tn-icon cke cke-plus"></span> menu in the&nbsp;<a
- class="reference-link" href="#root/_help_nRhnJkTT8cPs">Formatting toolbar</a>.</li>
- <li>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 either <em>Create note</em>, which places it in the&nbsp;<a
- class="reference-link" href="#root/_help_S0Fos78ZfcY7">Note Inbox</a>&nbsp;(today's
- day note, or the top level, when no inbox is set), or <em>Create child note</em>,
- which places it under the note being edited.</li>
-</ol>
-<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>
- <ol>
- <li>This is sometimes also called "reference link".</li>
- <li>The title of this link cannot be changed. Instead, it will always show
- the current title of the linked note.</li>
- <li>The icon of the linked note will also be displayed.</li>
- <li>If the linked note is deleted, the link keeps the last title it showed,
- in red and with a <span class="tn-icon bx bx-x"></span> icon instead of the
- note icon. Clicking it while editing opens the <em>Fix link</em> dialog,
- which searches for that title; picking a note, or creating a new one, replaces
- the link with one to that note.</li>
- </ol>
- </li>
- <li><em>Link title can be changed arbitrarily</em>
- <ol>
- <li>This will create a traditional hyperlink, where the text of the link can
- be different from the note title.</li>
- </ol>
- </li>
-</ol>
-<h2>In-place linking</h2>
-<p>You can also insert internal links “inline” by using the <code>@</code> symbol:</p>
-<ol>
- <li>Type <code>@</code> in a text note, which will open the note search menu.</li>
- <li>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 note</em> or <em>Create child note</em>,
- as described above.</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>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>In a text note, paste the link by pressing <kbd>Ctrl</kbd> + <kbd>V</kbd>.</li>
-</ol>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Lists.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Lists.html
deleted file mode 100644
index 7c3cef7fdd..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Lists.html
+++ /dev/null
@@ -1,118 +0,0 @@
-<p>There are three types of lists supported by text notes:</p>
-<ul>
- <li><span class="tn-icon cke cke-bulleted-list"></span>&nbsp;Bulleted lists
- (also known as unordered lists).</li>
- <li><span class="tn-icon cke cke-numbered-list"></span>&nbsp;Numbered lists
- (or ordered lists).</li>
- <li><span class="tn-icon cke cke-todo-list"></span>&nbsp;To-do lists</li>
-</ul>
-<p>For bulleted and numbered lists, it's possible to configure an alternative
- marker such as squares or Roman numbering by pressing the&nbsp;<span class="tn-icon cke cke-dropdown-arrow"></span> icon.
- For numbered lists, it's also possible to specify the number to start at
- or whether to count in reverse order.</p>
-<h2>Keyboard interaction</h2>
-<ul>
- <li>To create a new list:
- <ul>
- <li>Bulleted list: Start a line with <code>*</code> or <code>-</code> followed
- by a space;</li>
- <li>Numbered list: Start a line with <code>1.</code> or <code>1)</code> followed
- by a space;</li>
- <li>To-do list: Start a line with <code>- [ ]</code> for an unchecked item or <code>[x]</code> for
- a checked item.</li>
- </ul>
- </li>
- <li>To create a new item in the list, press <kbd>Enter</kbd>.</li>
- <li>To create a blank line within a list item, press <kbd>Shift</kbd>+<kbd>Enter</kbd>.</li>
- <li>To exit out of the list, press <kbd>Enter</kbd> twice.</li>
- <li>To merge two lists, simply delete the gap between them.</li>
- <li>To create nested lists, simply use the&nbsp;<span class="tn-icon cke cke-indent"></span> button
- (see <em>Indentation</em> in&nbsp;<a class="reference-link" href="#root/_help_dEHYtoWWi8ct">Other features</a>)
- or the <kbd>Tab</kbd> key. To decrease the nesting level for the current
- element, press <kbd>Shift</kbd>+<kbd>Tab</kbd>.</li>
-</ul>
-<h2>Headings, code blocks within lists</h2>
-<p>It possible to add content-level blocks such as headings, code blocks,
- tables within lists, as follows:</p>
-<figure class="table">
- <table>
- <tbody>
- <tr>
- <td>1</td>
- <td>
- <img src="2_Lists_image.png">
- </td>
- <td>First, create a list.</td>
- </tr>
- <tr>
- <td>2</td>
- <td>
- <img src="4_Lists_image.png">
- </td>
- <td>Press Enter to create a new list item.</td>
- </tr>
- <tr>
- <td>3</td>
- <td>
- <img src="1_Lists_image.png">
- </td>
- <td>Press Backspace to get rid of the bullet point. Notice the cursor position.</td>
- </tr>
- <tr>
- <td>4</td>
- <td>
- <img class="image_resized" style="aspect-ratio:676/112;width:98.29%;"
- src="5_Lists_image.png" width="676" height="112">
- </td>
- <td>At this point, insert any desired block-level item such as a code block.</td>
- </tr>
- <tr>
- <td>5</td>
- <td>
- <img class="image_resized" style="aspect-ratio:675/129;width:94.22%;"
- src="3_Lists_image.png" width="675" height="129">
- </td>
- <td>To continue with a new bullet point, press Enter until the cursor moves
- to a new blank position.</td>
- </tr>
- <tr>
- <td>6</td>
- <td>
- <img class="image_resized" style="aspect-ratio:675/129;width:100%;" src="Lists_image.png"
- width="675" height="129">
- </td>
- <td>Press Enter once more to create the new bullet.</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<p>The same principle applies to all three list types (bullet, numbered and
- to-do).</p>
-<h2>To-do lists</h2>
-<p>See&nbsp;<a class="reference-link" href="#root/_help_fASfBrYnquKU">To-do Lists</a>.</p>
-<h2>Collapsible lists</h2>
-<p>Starting with Trilium v0.104.0, it is possible to collapse nested list
- items. This applies to bullet lists, numbered lists as well as to-do lists.</p>
-<p>To collapse or expand a list item that has nested sub-items:</p>
-<ul>
- <li>Using the mouse, move the cursor over the list item and an arrow will
- appear to its left. Clicking it will toggle between collapsed and expanded.</li>
- <li>For bullet lists and numbered lists, it's also possible to click directly
- on the marker (e.g. the bullet or the number) instead of on the arrow to
- collapse or expand it. This won't work for to-do lists since this would
- toggle the to-do instead.</li>
- <li>Press <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Enter</kbd> which will toggle
- the collapse/expand state for the item at the cursor position.</li>
-</ul>
-<p>Of note:</p>
-<ul>
- <li>Collapsed items always show the arrow to indicate its state.</li>
- <li>The collapsed state is saved at note level and synced across instances,
- which means that it will restore after a refresh or reopening of the application.</li>
- <li>The collapsed state is also persisted in&nbsp;<a class="reference-link"
- href="#root/_help_mHbBMPDPkVV5">Import &amp; Export</a>, but only for the
- HTML format. Markdown exports will not preserve the collapse state.</li>
- <li>Collapsible bullets only exist in the context of editable text notes.
- Read-only lists will always be fully expanded.</li>
- <li>The list items will auto-expand on edit to avoid typing in a hidden area.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Markdown-like formatting.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Markdown-like formatting.html
deleted file mode 100644
index 16b2d68877..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Markdown-like formatting.html
+++ /dev/null
@@ -1,65 +0,0 @@
-<p>Markdown-like formatting allows inserting some basic formatting by typing
- the Markdown equivalent. Note that this does not mean that&nbsp;<a class="reference-link"
- href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes supports Markdown,
- these are just some convenience shortcuts.</p>
-<p>To import more complex formatting into text notes, consider using the <a
- href="#root/_help_dEHYtoWWi8ct"><em>Import from Markdown</em></a> function.
- For fully-fleged Markdown notes imports, consider using the dedicated <a
- href="#root/_help_Oau6X9rCuegd">import</a> function.</p>
-<ul>
- <li>For <a href="#root/_help_Gr6xFaF6ioJ5">headings:</a>
- <ul>
- <li><code>##</code> for Heading 2 (the first-level heading is reserved for
- the note title).</li>
- <li><code>###</code> for Heading 3</li>
- <li><code>####</code> for Heading 4</li>
- <li><code>#####</code> for Heading 5</li>
- <li><code>######</code> for Heading 6</li>
- </ul>
- </li>
- <li>For&nbsp;<a class="reference-link" href="#root/_help_Gr6xFaF6ioJ5">General formatting</a>:
- <ul>
- <li><strong>Bold</strong>: Type <code>**text**</code> or <code>__text__</code>
- </li>
- <li><em>Italic</em>: Type <code>*text*</code> or <code>_text_</code>
- </li>
- <li><del>Strikethrough</del>: Type <code>~~text~~</code>
- </li>
- </ul>
- </li>
- <li>For&nbsp;<a class="reference-link" href="#root/_help_S6Xx8QIWTV66">Lists</a>:
- <ul>
- <li>Bulleted list: Start a line with <code>*</code> or <code>-</code> followed
- by a space;</li>
- <li>Numbered list: Start a line with <code>1.</code> or <code>1)</code> followed
- by a space;</li>
- <li>To-do list: Start a line with <code>[ ]</code> for an unchecked item or <code>[x]</code> for
- a checked item.</li>
- </ul>
- </li>
- <li>For <a href="#root/_help_NwBbFdNZ9h7O">block quotes</a>, press <code>&gt;</code>,
- followed by a space.</li>
- <li>For&nbsp;<a class="reference-link" href="#root/_help_QxEyIjRBizuC">Code blocks</a>,
- type <code>```</code>.</li>
- <li>For a <a href="#root/_help_dEHYtoWWi8ct">horizontal line</a>, type <code>---</code>.</li>
- <li>For <a href="#root/_help_NwBbFdNZ9h7O">admonitions</a>:
- <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>
- <li>Starting any other text with <code>!!!</code> will insert a note admonition
- with the text inside of it.</li>
- </ul>
- </li>
- <li>For <a href="#root/_help_CohkqWQC1iBv">emojis</a>, type <code>:</code> followed
- by an emoji name to trigger an auto-completion.</li>
-</ul>
-<p>If auto-formatting is not desirable, press <kbd>Ctrl</kbd> + <kbd>Z</kbd> to
- revert the text to its original form.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Math Equations.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Math Equations.html
deleted file mode 100644
index caf84b0840..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Math Equations.html
+++ /dev/null
@@ -1,39 +0,0 @@
-<figure class="image image-style-align-right">
- <img style="aspect-ratio:350/193;" src="Math Equations_image.png" width="350"
- height="193">
-</figure>
-<p>Within text notes, it's possible to enter mathematical equations using
- the&nbsp;<span class="tn-icon cke cke-trilium-math"></span> button from
- the&nbsp;<a class="reference-link" href="#root/_help_nRhnJkTT8cPs">Formatting toolbar</a>&nbsp;(generally
- found under the&nbsp;<a class="reference-link" href="#root/_help_CohkqWQC1iBv">Insert buttons</a>).</p>
-<p>By default, the math dialog includes a MathLive visual editor and a TeX
- field. Disable <em>MathLive visual editor</em> under Options → Text Notes
- → Features to use only the TeX field and preview.</p>
-<p>Enabling <em>Display mode</em> will render the equation slightly bigger
- (especially if using big operators such as summation, or fractions) and
- center it. Display mode equations will act as blocks (i.e. like paragraphs,
- or tables) and can be inserted for example in lists. Non-display equations
- can be part of the text.</p>
-<h2>Keyboard shortcuts</h2>
-<p>If inserting equations frequently, using the <kbd>Ctrl</kbd>+<kbd>M</kbd> keyboard
- shortcut can be more comfortable. Alternatively, type <code>$$</code> or <code>\[</code> to
- trigger the popup directly.</p>
-<p>There is currently no quick way to turn an already typed-out equation,
- such as surrounding it with <code>$</code> or pressing <kbd>Ctrl</kbd>+<kbd>M</kbd>.</p>
-<h2>Supported math features</h2>
-<p>Technically we are using the KaTeX library which allows for a subset of
- the TeX format. To see the full list of supported features, consult the <a
- href="https://katex.org/docs/supported">Supported Functions</a> and the <a
- href="https://katex.org/docs/support_table">Support Table</a> from the official
- documentation.</p>
-<h2>Markdown support</h2>
-<p>Math equations will be preserved when exporting to or importing from Markdown,
- surrounded by <code>$</code> characters for inline math expressions, and <code>$$</code> for
- display mode.</p>
-<p>If you notice any issue with the Markdown import/export for equations,
- feel free to <a href="#root/_help_wy8So3yZZlH9">report</a> it while providing
- the equation that causes issues.</p>
-<h2>Formatting the equation</h2>
-<p>It is possible to customize the font size and foreground color for both
- inline and display-mode equations, just like any other text. For inline
- equations, the background color/highlight can also be adjusted.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Math Equations_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Math Equations_image.png
deleted file mode 100644
index ffd51f4fa9..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Math Equations_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Multicolumn layout.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Multicolumn layout.html
deleted file mode 100644
index 78869767ea..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Multicolumn layout.html
+++ /dev/null
@@ -1,113 +0,0 @@
-<p>A multicolumn layout arranges content in two to four columns, side by
- side. A column can hold any kind of content, including tables, images and
- another multicolumn layout.</p>
-<h2>Inserting a layout</h2>
-<ul>
- <li>In the formatting bar, go to <em>Insert</em> → <span class="tn-icon cke cke-trilium-multicolumn"></span> <em>Multiple column layout</em> to
- insert a layout with two columns. Its submenu offers <em>2 columns</em>, <em>3 columns</em> and <em>4 columns</em>.</li>
- <li>Alternatively, type <code>/columns</code> and choose <em>2 columns layout</em>, <em>3 columns layout</em> or <em>4 columns layout</em>,
- as described in&nbsp;<a class="reference-link" href="#root/_help_ZlN4nump6EbW">Slash Commands</a>.</li>
-</ul>
-<p>The columns of a new layout have equal widths. If text is selected when
- the layout is inserted, the selection moves into the first column.</p>
-<h2>Changing the columns</h2>
-<h3>Changing the layout</h3>
-<p>While the cursor is inside a layout, a toolbar appears above it with a
- button that shows the current layout. Clicking it opens a row of figures,
- one for each available layout; hovering over a figure shows its number
- of columns and their widths:</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Columns</th>
- <th>Widths</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>2</td>
- <td>50%-50%, 25%-75%, 75%-25%</td>
- </tr>
- <tr>
- <td>3</td>
- <td>33%-33%-33%, 25%-50%-25%</td>
- </tr>
- <tr>
- <td>4</td>
- <td>25%-25%-25%-25%</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<ul>
- <li>Choosing a layout with more columns adds empty columns at the end.</li>
- <li>Choosing a layout with fewer columns removes the last columns and moves
- their content to the end of the last remaining column.</li>
-</ul>
-<h3>Adding columns</h3>
-<p>While the cursor is in a column, you can use these key combinations:</p>
-<ul>
- <li><kbd>Ctrl</kbd> + <kbd>Enter</kbd>: Add a column after the current one.</li>
- <li><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Enter</kbd>: Add a column before
- the current one.</li>
-</ul>
-<p>The new column is empty and the cursor moves into it. All the columns
- then have equal widths. A layout has at most four columns, so the keys
- do nothing in a layout that already has four.</p>
-<p><kbd>Ctrl</kbd> + <kbd>Enter</kbd> keeps its usual function on a link, in
- a to-do item and in the title of a collapsible block, and <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Enter</kbd> in
- a to-do item.</p>
-<h3>Reordering columns</h3>
-<p>While the cursor is anywhere inside a column, you can use these key combinations:</p>
-<ul>
- <li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Right</kbd>: Move the column to the
- right.</li>
- <li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Left</kbd>: Move the column to the
- left.</li>
- <li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Home</kbd>: Make it the first column.</li>
- <li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>End</kbd>: Make it the last column.</li>
-</ul>
-<p>In a layout with two columns of different widths, the column keeps its
- width.</p>
-<h2>Moving content between columns</h2>
-<p>To move content to another column, select it, and then use these key combinations:</p>
-<ul>
- <li><kbd>Ctrl</kbd> + <kbd>Right</kbd>: Move to the column on the right.</li>
- <li><kbd>Ctrl</kbd> + <kbd>Left</kbd>: Move to the column on the left.</li>
- <li><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>End</kbd>: Move to the last column.</li>
- <li><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Home</kbd>: Move to the first column.</li>
-</ul>
-<p>Paragraphs, list items, tables and other blocks move whole, even when
- only part of them is selected. Content moved to a column on the left goes
- to the end of that column, and content moved to a column on the right goes
- to its start, so it keeps its place in the reading order.</p>
-<p>Without a selection, these keys keep their usual function: moving the
- cursor by word, or selecting up to the start or end of the column.</p>
-<p>When a layout and <a class="reference-link" href="#root/_help_EK2ckIZ74tbT">Content tabs</a> are
- nested in one another, the key combinations act on the one closest to the
- cursor.</p>
-<h2>Removing a layout</h2>
-<ul>
- <li>To remove the layout but keep its content, click the <span class="tn-icon cke cke-remove"></span> <em>Remove layout</em> button
- in the layout's toolbar. The content of the columns is placed one after
- another where the layout was, and empty columns are left out.</li>
- <li>To delete the layout together with its content, click the handle at its
- top-left corner to select it, then press <kbd>Delete</kbd>.</li>
-</ul>
-<h2>Narrow screens</h2>
-<p>When a layout has too little room for its columns (narrower than about
- 500 pixels, such as on a phone), the columns are stacked one below the
- other. While editing, alternating background colors tell the columns apart.
- This applies to each layout on its own, so a layout inside a narrow column
- is stacked while the outer one stays side by side.</p>
-<h2>Printing and exporting</h2>
-<ul>
- <li>When printing or <a href="#root/_help_NRnIZmSMc5sj">exporting to PDF</a>,
- the columns are printed side by side.</li>
- <li>Markdown has no columns, so Markdown export keeps the layout and each
- column as HTML <code>&lt;div&gt;</code> tags, with the content of each column
- written as Markdown between them. Importing the file back restores the
- layout. Markdown viewers that don't support HTML show the content of the
- columns one after another.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Other features.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Other features.html
deleted file mode 100644
index ab13e5e2e0..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Other features.html
+++ /dev/null
@@ -1,58 +0,0 @@
-<h2>Indentation</h2>
-<figure class="image image-style-align-right">
- <img style="aspect-ratio:201/124;" src="1_Other features_image.png" width="201"
- height="124">
-</figure>
-<p>Paragraphs can be indented using the following buttons from the&nbsp;<a
- class="reference-link" href="#root/_help_nRhnJkTT8cPs">Formatting toolbar</a>:</p>
-<ul>
- <li>Press&nbsp;<span class="tn-icon cke cke-indent"></span> to increase the
- indentation of the current paragraph by one. Can be pressed multiple times
- if needed.</li>
- <li>Press&nbsp;<span class="tn-icon cke cke-outdent"></span> to decrease the
- indentation of a current paragraph. The button will be disabled if it is
- already at the minimum indentation level.</li>
- <li>For convenience, keyboard shortcuts are also available. Press <kbd>Tab</kbd> to
- indent or <kbd>Shift</kbd>+<kbd>Tab</kbd> to decrease the indentation. These
- shortcuts work even if the cursor is not at the beginning of a paragraph
- or a list.</li>
- <li>Apart from paragraphs, the indent button is also enabled in&nbsp;<a class="reference-link"
- href="#root/_help_S6Xx8QIWTV66">Lists</a>&nbsp;(for nesting) and&nbsp;<a
- class="reference-link" href="#root/_help_NdowYOC1GFKS">Tables</a>.</li>
-</ul>
-<p>When indented paragraphs or headings are copied and pasted as plain text,
- for example into a <a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a> note
- or another application, each indentation level becomes a tab at the start
- of the line. A copy that stays within a single paragraph contains only
- its text, without the indentation.</p>
-<p>The reverse also works: when plain text is pasted into a text note, each
- paragraph whose lines all start with tabs is indented by one level per
- tab. Pasting into a code block keeps the tabs as they are.</p>
-<h2>Markdown import</h2>
-<p>If the clipboard contains Markdown text, it can be easily imported into
- text notes. Simply copy a Markdown-formatted text and press the&nbsp;<span
- class="tn-icon cke cke-trilium-markdown-mark"></span> to insert its visual
- representation.</p>
-<p>Note that this only works with raw Markdown (e.g. <code># Heading 1</code> to
- generate a heading) and not the visual representation of the Markdown (e.g.
- as in the preview pane of an application). In that case, simply use the
- paste function which already accepts HTML-formatted content.</p>
-<p>This is mostly useful for snippets of text, for entire Markdown documents
- use the dedicated&nbsp;<a class="reference-link" href="#root/_help_Oau6X9rCuegd">Markdown</a>&nbsp;import/export
- function.</p>
-<p>If accessing Trilium with a web browser, the Markdown import action will
- ask for the content to be inserted into a dedicated screen since it does
- not have access to the clipboard.</p>
-<h2>Cut to subnote</h2>
-<p>The&nbsp;<span class="tn-icon cke cke-trilium-scissors"></span> button
- will create a child note with the selected text. For more information,
- see&nbsp;<a class="reference-link" href="#root/_help_2x0ZAX9ePtzV">Cut to subnote</a>.</p>
-<h2>Find and replace</h2>
-<figure class="image image-style-align-right">
- <img style="aspect-ratio:394/203;" src="Other features_image.png" width="394"
- height="203">
-</figure>
-<p>The&nbsp;<span class="tn-icon cke cke-find-replace"></span> button will
- open the editor's dedicated search and replace functionality.</p>
-<p>Alternatively, the <kbd>Ctrl</kbd>+<kbd>F</kbd> combination can be pressed
- to show the dialog.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Other features_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Other features_image.png
deleted file mode 100644
index 3645073c63..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Other features_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Premium features.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Premium features.html
deleted file mode 100644
index 17ce2a2c84..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Premium features.html
+++ /dev/null
@@ -1,24 +0,0 @@
-<p>The text editor we are using is called&nbsp;<a class="reference-link"
- href="#root/_help_MI26XDLSAlCD">CKEditor</a>&nbsp;which has an open-source
- core, but it's also a commercial product which offers <a href="https://ckeditor.com/docs/trial/latest/index.html">premium features</a>.</p>
-<p>Prior to v0.105.0, Trilium used the following premium features as part
- of a signed agreement between the CKEditor and the Trilium team:</p>
-<ul>
- <li><a class="reference-link" href="#root/_help_ZlN4nump6EbW">Slash Commands</a>
- </li>
- <li><a class="reference-link" href="#root/_help_pwc194wlRzcH">Text Snippets</a>
- </li>
- <li><a class="reference-link" href="#root/_help_5wZallV2Qo1t">Format Painter</a>
- </li>
-</ul>
-<p>Starting with v0.105.0, those features have been completely rewritten
- as custom CKEditor plugins, licensed under AGPL-3.0.</p>
-<h2>Lookalikes</h2>
-<p>There are some premium CK features that look like Trilium's built-in functionality
- but they are completely different:</p>
-<ul>
- <li><a class="reference-link" href="#root/_help_VRoP0g1uHHc2">In-editor AI assistant</a>
- </li>
- <li><a class="reference-link" href="#root/_help_YfYAtQBcfo5V">Math Equations</a>&nbsp;which
- uses a third-party plugin that has been adapted for Trilium.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Slash Commands.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Slash Commands.html
deleted file mode 100644
index 1eee532043..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Slash Commands.html
+++ /dev/null
@@ -1,31 +0,0 @@
-<figure class="image image-style-align-right">
- <img style="aspect-ratio:419/571;" src="Slash Commands_image.png" width="419"
- height="571">
-</figure>
-<p>Slash commands is a feature of&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes
- which allows easily accessing commonly used commands simply by using the
- keyboard, without having to remember dedicated&nbsp;<a class="reference-link"
- href="#root/_help_A9Oc6YKKc65v">Keyboard Shortcuts</a>.</p>
-<h2>Interaction</h2>
-<ul>
- <li>As the name suggests, to trigger the slash commands simply press the /
- key to trigger it. Note that this can be anywhere in a paragraph as long
- as it's not part of the word, if it doesn't show up simply press a space
- and press the / key again.</li>
- <li>Use ↑ and ↓ keys to navigate between options.</li>
- <li>By default, the full list of commands is displayed.</li>
- <li>To search, simply start typing: commands are found by their title or by
- other names they go by (for example <code>h2</code> for <em>Heading 2</em>).</li>
- <li>To trigger the highlighted action, press Enter or Tab.</li>
-</ul>
-<h2>Integration with other features</h2>
-<p>Apart from the common set of commands, some features are specially integrated
- with the slash commands:</p>
-<ul>
- <li>For <a href="#root/_help_NwBbFdNZ9h7O">admonitions</a>, each admonition
- type (e.g. note, tip) will be individually displayed.</li>
- <li>Every&nbsp;<a class="reference-link" href="#root/_help_pwc194wlRzcH">Text Snippets</a>&nbsp;will
- also appear individually, making it easy to insert them.</li>
- <li><a class="reference-link" href="#root/_help_VRoP0g1uHHc2">In-editor AI assistant</a>:
- dedicated <em>Ask AI</em> item as well as all the predefined and <a href="#root/_help_mVEYwt20exhO">custom quick actions</a>.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Slash Commands_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Slash Commands_image.png
deleted file mode 100644
index b46c1a4c67..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Slash Commands_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Spell Check.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Spell Check.html
deleted file mode 100644
index 8635e3f084..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Spell Check.html
+++ /dev/null
@@ -1,88 +0,0 @@
-<p>Trilium supports spell checking for your notes. How it works depends on
- whether you're using the <strong>desktop application</strong> (Electron)
- or accessing Trilium through a <strong>web browser</strong>.</p>
-<h2>Desktop</h2>
-<p>The desktop app uses Chromium's built-in spellchecker. You can configure
- it from <em>Options</em> → <em>Spell Check</em>.</p>
-<h3>Enabling spell check</h3>
-<p>Toggle <em>Check spelling</em> to enable or disable the spellchecker. A
- restart is required for changes to take effect — use the restart button
- at the bottom of the section.</p>
-<h3>Choosing languages</h3>
-<p>When spell check is enabled, a <em>Spell Check Languages</em> section appears
- listing all languages available on your system. Select one or more languages
- by checking the boxes. The spellchecker will accept words that are valid
- in <em>any</em> of the selected languages.</p>
-<p>The available languages depend on your operating system's installed language
- packs. For example, on Windows you can add languages through <em>Options</em> → <em>Time &amp; Language</em> → <em>Language &amp; Region</em> → <em>Add a language</em>.</p>
-<aside
-class="admonition note">
- <p>The changes take effect only after restarting the application.</p>
-</aside>
-<h3>Custom dictionary</h3>
-<aside class="admonition tip">
- <p>This function is available starting with Trilium v0.103.0.</p>
-</aside>
-<p>Words you add to the dictionary (e.g. via the right-click context menu
- → "Add to dictionary") are stored in a <strong>synced note</strong> inside
- Trilium. This means your custom dictionary automatically syncs across all
- your devices.</p>
-<p>You can view and edit the dictionary directly from <em>Settings</em> → <em>Spell Check</em> → <em>Custom Dictionary</em> → <em>Edit dictionary</em>.
- This opens the underlying note, which contains one word per line. You can
- add, remove, or modify entries as you like.</p>
-<aside class="admonition note">
- <p>Changes to the custom dictionary (whether from the editor or the context
- menu) take effect after restarting the application.</p>
-</aside>
-<h4>How the custom dictionary works</h4>
-<ul>
- <li>When you right-click a misspelled word and choose "Add to dictionary",
- the word is saved both to Electron's local spellchecker and to the synced
- dictionary note.</li>
- <li>On startup, Trilium loads all words from the dictionary note into the
- spellchecker session.</li>
- <li>If Trilium detects words in Electron's local dictionary but the dictionary
- note is empty (e.g. on first use), it performs a <strong>one-time import</strong> of
- those words into the note.</li>
- <li>Words that are in Electron's local dictionary but <em>not</em> in the note
- (e.g. you removed them manually) are cleaned up from the local dictionary
- on startup.</li>
-</ul>
-<h4>Known limitations</h4>
-<p>On Windows and macOS, Electron delegates "Add to dictionary" to the operating
- system's user dictionary. This means:</p>
-<ul>
- <li>Words added via the context menu are also written to the OS-level dictionary
- (e.g. <code>%APPDATA%\Microsoft\Spelling\&lt;language&gt;\default.dic</code> on
- Windows).</li>
- <li><strong>Removing a word</strong> from the Trilium dictionary note prevents
- it from being loaded into the spellchecker on next startup, but does <em>not</em> remove
- it from the OS dictionary. The word may still be accepted by the OS spellchecker
- until you remove it from the OS dictionary manually.</li>
-</ul>
-<h2>Web browser</h2>
-<p>When accessing Trilium through a web browser, spell checking is handled
- entirely by the browser itself. Trilium does not control the browser's
- spellchecker — language selection, dictionaries, and all other settings
- are managed through your browser's preferences.</p>
-<p>The&nbsp;<a class="reference-link" href="#root/_help_jcQVxzYybYgz">Note contextual menu</a>&nbsp;has
- a special behavior in which a right-clicked word (without selection) shows
- the browser's default contextual menu which allows the spellcheck to function.</p>
-<p>The Spell Check settings page in Trilium will indicate that these options
- apply only to desktop builds.</p>
-<h2>Frequently asked questions</h2>
-<h3>Do I need to restart after every change?</h3>
-<p>Yes. Spell check language selection and the custom dictionary are loaded
- once at startup. Any changes require a restart to take effect.</p>
-<h3>Can I use multiple spell check languages at the same time?</h3>
-<p>Yes. Select as many languages as you need from the checklist. The spellchecker
- will accept words from any of the selected languages.</p>
-<h3>My custom words disappeared after syncing to a new device — what happened?</h3>
-<p>On the first launch of a new device, Trilium may import existing local
- dictionary words into the note. If the note already has words from another
- device (via sync), those are preserved. Make sure sync completes before
- restarting the application on a new device.</p>
-<h3>I removed a word from the dictionary note but it's still accepted</h3>
-<p>This is likely due to the OS-level dictionary retaining the word (see <a
- href="#known-limitations">Known limitations</a> above). You can manually
- remove it from your operating system's user dictionary.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Table of contents.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Table of contents.html
deleted file mode 100644
index de81326980..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Table of contents.html
+++ /dev/null
@@ -1,3 +0,0 @@
-<aside class="admonition note">
- <p>This page has been relocated to&nbsp;<a class="reference-link" href="#root/_help_2dcGDhp9WFKb">Outline tab</a>.</p>
-</aside>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Tables.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Tables.html
deleted file mode 100644
index 9a9ad3d5b1..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Tables.html
+++ /dev/null
@@ -1,495 +0,0 @@
-<p>Tables are a powerful feature for&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes,
- since editing them is generally easy.</p>
-<figure class="image image-style-align-right">
- <img style="aspect-ratio:176/204;" src="2_Tables_image.png" width="176"
- height="204">
-</figure>
-<p>To create a table, simply press the table button and select with the mouse
- the desired amount of columns and rows, as indicated in the adjacent figure.</p>
-<p>Since v0.107.0, the same menu starts with an <em>Insert table…</em> item,
- for a table larger than the grid or to type its size instead:</p>
-<ol>
- <li>Click the <span class="tn-icon cke cke-table"></span>button and select <em>Insert table…</em>.
- A small form opens at the cursor.</li>
- <li>Enter the number of <em>Columns</em> (up to 100) and <em>Rows</em> (up to
- 1000). The table can have at most 5000 cells in total, for example 1000
- rows of 5 columns.</li>
- <li>Press <em>Insert</em> or <kbd>Enter</kbd>.</li>
-</ol>
-<p>To close the form without inserting a table, press <kbd>Esc</kbd> or click
- outside it. From the keyboard, <kbd>Tab</kbd> moves between <em>Insert table…</em> and
- the grid while the menu is open.</p>
-<p>On the <a class="reference-link" href="#root/_help_RDslemsQ6gCp">Mobile Frontend</a>,
- the <span class="tn-icon cke cke-table"></span>button opens the form directly,
- without the grid.</p>
-<h2>Formatting toolbar</h2>
-<p>When a table is selected, a special formatting toolbar will appear:</p>
-<img
-src="3_Tables_image.png" width="384" height="100">
-<h2>Context menu</h2>
-<p>Since v0.106.0, right-clicking anywhere inside a table opens a context
- menu with the most common table operations:</p>
-<ul>
- <li><em>Insert row above</em> and <em>Insert row below</em> insert a blank row
- next to the row of the current cell. When the selection spans multiple
- rows, the same number of rows is inserted.</li>
- <li><em>Insert column to the left</em> and <em>Insert column to the right</em> work
- the same way for columns.</li>
- <li>Since v0.107.0, <em>Set as header</em> or <em>Set header up to this row</em>,
- depending on the selection, turns rows into header rows, which always start
- at the top of the table:
- <ul>
- <li><em>Set as header</em> shows when the selection starts at the first row,
- and makes every selected row a header row.</li>
- <li><em>Set header up to this row</em> shows when the selection is in a single
- row below the first, and makes that row and every row above it header rows.</li>
- <li>Neither shows when the selection spans several rows below the first.</li>
- <li>A check mark shows that the rows are already header rows. Choosing the
- item again turns them, and every header row below them, back into regular
- rows. For example, in a table with five header rows, choosing <em>Set header up to this row</em> on
- the third row leaves only the first two as header rows.</li>
- </ul>
- </li>
- <li><em>Merge cells</em> merges the selected cells into one. The selected cells
- must form a rectangle.</li>
- <li><em>Split cell</em> splits each selected cell in two, either <em>Vertically</em> or <em>Horizontally</em>. <em>Unmerge cells</em>,
- in the same submenu, turns each merged cell in the selection back into
- the single cells it covers, keeping its content in the top-left one; cells
- that are not merged stay as they are.</li>
- <li><em>Distribute columns evenly</em> splits the combined width of the columns
- the selection touches equally between them. The other columns and the width
- of the table stay as they are. It needs a selection spanning at least two
- columns; a merged cell counts for every column it covers.</li>
- <li><em>Cut</em>, <em>Copy</em> and <em>Copy as Markdown</em> act on the selected
- cells. Since v0.107.0, <em>Copy</em> and <em>Paste</em> open submenus with
- their variants, such as <em>Copy as Markdown</em> and <em>Paste as plain text</em>;
- clicking <em>Copy</em> or <em>Paste</em> itself still copies or pastes:
- <ul>
- <li>Cutting or copying produces a smaller table holding just the selected
- cells. Pasting it over a cell selection replaces those cells; pasting elsewhere
- inserts it as a table of its own. Cutting clears the cells without removing
- rows or columns.</li>
- <li><em>Copy as Markdown</em> converts the selected cells to a Markdown table.
- A selected header row becomes the Markdown header; without one, an empty
- header row is emitted, since Markdown tables require one.</li>
- </ul>
- </li>
- <li>Since v0.107.0, <em>Paste rows above</em> and <em>Paste rows below</em>,
- in the <em>Paste</em> submenu, paste the clipboard as new rows next to the
- row of the current cell, instead of over the cells from the cursor on.
- They show only when the selection is in a single row, and, like <em>Paste</em>,
- only where the clipboard can be read:
- <ul>
- <li>A copied table becomes one new row for each of its rows, filled from the
- first column. When it has more columns than the table, the table gains
- columns, as with a regular paste. Other content goes in the first cell
- of a single new row.</li>
- <li>The new rows are selected afterwards.</li>
- <li>When merged cells join the row to others, the new rows go above or below
- that whole block of rows.</li>
- </ul>
- </li>
- <li><em>Sort</em>, below the clipboard section, sorts the rows by the column
- of the current cell, in <em>Ascending</em> or <em>Descending</em> order. See <a
- href="#sorting-rows">Sorting rows</a>.</li>
- <li><em>Delete row</em> and <em>Delete column</em>, below <em>Sort</em>, remove
- every row or column the selection touches, even when only some of their
- cells are selected.</li>
- <li><em>Delete table</em> removes the whole table and leaves an empty paragraph
- in its place. In a table nested inside another, only the inner table is
- removed.</li>
- <li>Since v0.107.0, <em>Select</em>, below <em>Delete table</em>, selects the
- cells of every row (<em>Row</em>) or column (<em>Column</em>) the selection
- touches, or every cell of the table (<em>Table</em>). Unlike the <span class="tn-icon cke cke-drag-handle"></span>button,
- which selects the table as a whole, <em>Table</em> selects its cells, so
- cell operations such as <em>Merge cells</em> apply to all of them. In a table
- nested inside another, <em>Table</em> selects only the cells of the inner
- table.</li>
-</ul>
-<p>Right-clicking a cell that is not part of the current selection moves
- the cursor there first, so the menu always applies to the cell under the
- pointer.</p>
-<aside class="admonition note">
- <p>In the browser, Trilium's menu replaces the browser's own context menu
- inside tables. To reach the browser's menu (for example for its spell checking
- suggestions), hold <kbd>Shift</kbd> while right-clicking. The desktop application
- is unaffected, since its menu already includes the spelling suggestions.
- In the browser, the menu also offers <em>Paste</em> only when the page can
- read the clipboard, which requires a secure (HTTPS) context and your permission;
- otherwise, paste with <kbd>Ctrl</kbd>+<kbd>V</kbd>.</p>
-</aside>
-<h2>Navigating a table</h2>
-<ul>
- <li>Using the mouse:
- <ul>
- <li>Click on a cell to focus it.</li>
- <li>Click the&nbsp;<span class="tn-icon cke cke-return-arrow"></span> button
- at the top or the bottom of a table to insert an empty paragraph near it.</li>
- <li>Click the&nbsp;<span style="--tn-color:hsl(0,0%,60%);color:hsl(0,0%,60%);"><span class="tn-icon cke cke-drag-handle"></span></span>button
- at the top-left of the table to select it entirely (for easy copy-pasting
- or cutting) or drag and drop it to relocate the table.</li>
- </ul>
- </li>
- <li>Using the keyboard:
- <ul>
- <li>Use the arrow keys on the keyboard to easily navigate between cells.</li>
- <li>It's also possible to use <kbd>Tab</kbd> to go to the next cell and Shift+Tab
- to go to the previous cell.</li>
- <li>Unlike arrow keys, pressing <kbd>Tab</kbd> at the end of the table (last
- row, last column) will create a new row automatically.</li>
- <li>To select multiple cells, hold <kbd>Shift</kbd> while using the arrow keys.</li>
- </ul>
- </li>
- <li>Using touch:
- <ul>
- <li>Since v0.107.0, touching a table outlines the cell with the cursor, or
- the selected cells, and shows a handle at each corner of the outline.</li>
- <li>To select multiple cells, drag one of the handles across the table. The
- cell at the opposite corner stays selected, so the selection grows or shrinks
- as the finger moves. The note and wide tables scroll when the handle reaches
- the edge of the screen.</li>
- </ul>
- </li>
-</ul>
-<h2>Resizing cells</h2>
-<ul>
- <li>Columns can be resized by hovering the mouse over the border of two adjacent
- cells and dragging it.</li>
- <li>To give several columns the same width, select cells across them and choose <em>Distribute columns evenly</em> from
- the <span class="tn-icon cke cke-table-column"></span>button of the formatting
- toolbar or from the <a href="#context-menu">context menu</a>.</li>
- <li>By default, the row height is not adjustable using the mouse, but it can
- be configured from the cell settings (see below).</li>
- <li>To adjust exactly the width (in pixels or percentages) of a cell, select
- the&nbsp;<span class="tn-icon cke cke-table-cell-properties"></span> button.</li>
-</ul>
-<h3>Resizing with touch</h3>
-<p>Since v0.107.0, touching a table shows a bar at the bottom of the note,
- above the formatting toolbar on mobile. The bar has a segment for each
- column of the table, with a divider at the end of each column. Only the
- divider of the column with the cursor is a handle that resizes; the other
- dividers only mark where the columns meet, so a swipe across them scrolls
- instead. When several cells are selected, each column they cover has a
- handle.</p>
-<ul>
- <li>To resize a column, place the cursor in one of its cells or tap its segment,
- then drag its handle. The table grows or shrinks with the column, and scrolls
- when the handle reaches the edge of the screen. The column snaps to its
- starting width and to the widths of the columns beside it.</li>
- <li>To cancel a resize, drag the handle back to where it started, or touch
- the screen with a second finger.</li>
- <li>To give a column and the next one the same width, double-tap the handle
- between them.</li>
- <li>To select a column, tap its segment. To open the column menu, touch and
- hold the segment.</li>
- <li>To scroll a wide table sideways, swipe along the bar.</li>
-</ul>
-<p>A wide table scrolls a little past its end, so the handle of its last
- column stays away from the edge of the screen, where a swipe navigates
- back.</p>
-<h2>Wide tables</h2>
-<p>Since v0.107.0, a table can be wider than the&nbsp;<a class="reference-link"
- href="#root/_help_t596jLvPrqkS">Content width</a>. Such a table scrolls
- sideways, while the rest of the note keeps its width.</p>
-<ul>
- <li>A new table is as wide as the content. To make it wider, drag the right
- border of its last column past the edge of the content. The border snaps
- to the edge and holds there briefly, so the table is easy to bring back
- to the width of the content.</li>
- <li>To set an exact width, enter a percentage above <code>100%</code> or a width
- in pixels in the&nbsp;<span class="tn-icon cke cke-table-properties"></span> <a
- href="#table-properties">table properties</a>.</li>
- <li>A table whose content needs more room than the note, such as a pasted
- table with many columns, also scrolls instead of stretching the note.</li>
- <li>Wide tables scroll the same way in read-only notes and on shared pages.</li>
- <li>When printing or exporting to PDF, a wide table is shrunk to fit the page.</li>
-</ul>
-<p>Tables inside other blocks, such as block quotes, admonitions, collapsible
- blocks, columns or tabs, are limited to the width of their block and do
- not scroll.</p>
-<h3>Mobile support</h3>
-<p>On the&nbsp;<a class="reference-link" href="#root/_help_RDslemsQ6gCp">Mobile Frontend</a>,
- a table keeps the width it has on a desktop and scrolls sideways, instead
- of squeezing its columns into the width of the screen. The full width of
- a table is the <em>Max content width</em> set in&nbsp;<a class="reference-link"
- href="#root/_help_4TIF1oA4VQRO">Options</a> → <em>Appearance</em> → <em>Content Width</em> on
- the mobile device, 1200 pixels by default. For example, a table set to <code>50%</code> is
- 600 pixels wide.</p>
-<p>To resize columns on mobile, use the bar described in <a href="#resizing-with-touch">Resizing with touch</a>.</p>
-<h2>Long tables</h2>
-<p>Since v0.107.0, the header rows of a table stay visible at the top of
- the note while you scroll through the rest of the table, and leave with
- the end of the table. This also works in read-only notes, on shared pages
- and in wide tables.</p>
-<p>To turn rows into header rows, use <em>Set as header</em> in the <a href="#context-menu">context menu</a>,
- or <em>Header row</em> in the <span class="tn-icon cke cke-table-row"></span> button
- of the formatting toolbar.</p>
-<p>To let header rows scroll away with the rest of the table, turn off <a
- class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a> → <em>Text Notes</em> → <em>Features</em> → <em>Use sticky header rows for tables</em>.
- The setting applies to the current device only, and shared pages keep their
- sticky header rows.</p>
-<h2>Inserting new rows and new columns</h2>
-<ul>
- <li>To insert a new column, click on a desired location, then press the&nbsp;<span
- class="tn-icon cke cke-table-column"></span> button from the formatting
- toolbar and select <em>Insert column left or right.</em>
- </li>
- <li>To insert a new row, click on a desired location, then press the&nbsp;<span
- class="tn-icon cke cke-table-row"></span> button and select <em>Insert row above</em> or <em>below</em>.
- <ul>
- <li>A quicker alternative to creating a new row while at the end of the table
- is to press the <kbd>Tab</kbd> key.</li>
- </ul>
- </li>
- <li>Both operations are also available in the <a href="#context-menu">context menu</a>,
- which inserts as many rows or columns as the selection spans.</li>
-</ul>
-<h2>Moving rows and columns</h2>
-<p>Since v0.106.0, rows and columns can be reordered with the keyboard:</p>
-<ul>
- <li><kbd>Alt</kbd>+<kbd>Up</kbd> and <kbd>Alt</kbd>+<kbd>Down</kbd> move the
- rows touched by the selection up or down.</li>
- <li><kbd>Alt</kbd>+<kbd>Left</kbd> and <kbd>Alt</kbd>+<kbd>Right</kbd> move the
- columns touched by the selection left or right.</li>
-</ul>
-<p>Merged cells are never split by a move. The rows or columns held together
- by a merged cell travel as one block, and moving toward such a block jumps
- over it entirely.</p>
-<p>When the table has a header row, a header row moved below the header area
- becomes a regular row, and a regular row moved into the header area becomes
- a header row. Header columns behave the same way.</p>
-<p>Outside of tables, <kbd>Alt</kbd>+<kbd>Left</kbd> and <kbd>Alt</kbd>+<kbd>Right</kbd> keep
- navigating the note history, and <kbd>Alt</kbd>+<kbd>Up</kbd> and <kbd>Alt</kbd>+<kbd>Down</kbd> keep
- moving the current paragraph.</p>
-<h2>Sorting rows</h2>
-<p>Since v0.107.0, the rows of a table can be sorted by the values of one
- column:</p>
-<ul>
- <li>To sort all the rows, place the cursor in any cell of the column to sort
- by, then select <em>Sort</em> → <em>Ascending</em> or <em>Descending</em> from
- the <a href="#context-menu">context menu</a>. The same items are in the <span
- class="tn-icon bx bx-sort-alt-2"></span>button of the formatting toolbar.</li>
- <li>To sort only some of the rows, select their cells in the column to sort
- by, then sort the same way. Sorting is not available while the selection
- spans more than one column.</li>
-</ul>
-<p>Header rows always stay at the top of the table and are never sorted.
- A sort can be undone with <kbd>Ctrl</kbd>+<kbd>Z</kbd>.</p>
-<h3>How values are compared</h3>
-<p>Each cell is read as plain text, so formatting does not affect the order.
- Trilium then detects what kind of value the cell holds:</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Kind</th>
- <th>Examples</th>
- <th>Compared by</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>Time</td>
- <td><code>15:02</code>, <code>15:02:38</code>, <code>3:02 PM</code>
- </td>
- <td>The time of day.</td>
- </tr>
- <tr>
- <td>Date</td>
- <td><code>2026-09-30</code>, <code>2026-09-30 15:02</code>, <code>30 September 2026</code>, <code>Wednesday, 30 September 2026</code>, <code>2026-09-30T15:02:38+03:00</code>
- </td>
- <td>The date and time.</td>
- </tr>
- <tr>
- <td>Number</td>
- <td><code>12</code>, <code>-3.5</code>, <code>1,234.56</code>, <code>$ 12.04</code>, <code>21 RON</code>, <code>24.5m</code>
- </td>
- <td>The numeric value.</td>
- </tr>
- <tr>
- <td>Text</td>
- <td>Anything else.</td>
- <td>Alphabetically, ignoring case, with numbers inside the text in numeric
- order (<code>Item 9</code> before <code>Item 10</code>). Accents count, so <code>a</code> and <code>á</code> differ.</td>
- </tr>
- <tr>
- <td>Empty</td>
- <td>An empty cell, or one holding only spaces.</td>
- <td>Not compared. Empty cells always go last.</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<p>Ascending order puts times first, then dates, numbers and text. Descending
- order reverses it. Empty cells go last in both directions.</p>
-<p>Numbers, dates and times with the same value are ordered by their text,
- so <code>5 apples</code> comes before <code>5 pears</code>. Rows whose cells
- hold the same text, ignoring case, keep their relative order.</p>
-<ul>
- <li>Dates are also recognized in the formats of the note's language, such
- as <code>30.09.2026</code> or <code>30. September 2026</code> for German, and
- in the format chosen in&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Text Notes</em> → <em>Editor</em> → <em>Date/time format</em> for <a
- href="#root/_help_CohkqWQC1iBv">inserting the date and time</a>.</li>
- <li>A number can start with a currency symbol, such as <code>$</code>, <code>€</code> or <code>£</code>.
- Whatever follows the number, such as a unit, is ignored, so units are not
- converted: <code>1 km</code> sorts before <code>500 m</code>. A cell that
- starts with letters, such as <code>RON 21</code>, is text.</li>
- <li>The decimal separator follows the language of the note: <code>1.500</code> is
- one and a half in English, but one thousand five hundred in German. A comma
- or period that is not followed by exactly three digits is always read as
- a decimal separator, so <code>1,5</code> is one and a half in either language.</li>
- <li>The language of the note set in the&nbsp;<a class="reference-link" href="#root/_help_AlJ73vBCjWDw">Status bar</a>&nbsp;via
- the&nbsp;<span class="tn-icon bx bx-globe"></span> icon, or else the default
- content language. See&nbsp;<a class="reference-link" href="#root/_help_veGu4faJErEM">Content language &amp; Right-to-left support</a>.</li>
-</ul>
-<h3>Merged cells</h3>
-<p>Rows joined by a merged cell are kept together and move as one block.
- The block is sorted by the value in its first row. When the block has more
- than one cell in the sorted column, the other cells do not affect the order,
- and a message says so: <em>Some rows were sorted together because merged cells tie them to each other</em>.</p>
-<p>When the selection covers only part of such a block, the whole block is
- sorted.</p>
-<h2>Merging cells</h2>
-<p>To merge two or more cells together, simply select them via drag &amp;
- drop and press the&nbsp;<span class="tn-icon cke cke-table-merge-cell"></span> button
- from the formatting toolbar.</p>
-<p>More options are available by pressing the arrow next to it:</p>
-<ul>
- <li>Click on a single cell and select Merge cell up/down/right/left to merge
- with an adjacent cell.</li>
- <li>Select <em>Merge selected cells</em> to merge the selected cells, the same
- as pressing the button itself.</li>
- <li>Select <em>Split cell vertically</em> or <em>horizontally</em>, to split
- a cell into multiple cells (can also be used to undo a merge).</li>
- <li>Select <em>Unmerge cells</em> to turn each merged cell in the selection
- back into the single cells it covers, keeping its content in the top-left
- one.</li>
-</ul>
-<p><em>Merge selected cells</em> and <em>Unmerge cells</em> are available since
- v0.107.0. Merging and splitting are also available by right-clicking the
- selected cells, via the <a href="#context-menu">context menu</a>, where <em>Unmerge cells</em> is
- in the <em>Split cell</em> submenu.</p>
-<h2>Table properties</h2>
-<figure class="image image-style-align-right">
- <img style="aspect-ratio:312/311;" src="Tables_image.png" width="312"
- height="311">
-</figure>
-<p>The table properties can be accessed via the&nbsp;<span class="tn-icon cke cke-table-properties"></span> button
- and allows for the following adjustments:</p>
-<ul>
- <li>Border (not the border of the cells, but the outer rim of the table),
- which includes the style (single, double), color and width.</li>
- <li>The background color, with none set by default.</li>
- <li>The width and height of the table in percentage (must end with <code>%</code>)
- or pixels (must end with <code>px</code>).</li>
- <li>The alignment of the table.
- <ul>
- <li>Left or right-aligned, case in which the text will flow next to it.</li>
- <li>Centered, case in which text will avoid the table, regardless of the table
- width.</li>
- </ul>
- </li>
-</ul>
-<p>The table will immediately update to reflect the changes, but the <em>Save</em> button
- must be pressed for the changes to persist.</p>
-<h2>Cell properties</h2>
-<figure class="image image-style-align-right">
- <img style="aspect-ratio:320/386;" src="1_Tables_image.png" width="320"
- height="386">
-</figure>
-<p>Similarly to table properties, the&nbsp;<span class="tn-icon cke cke-table-cell-properties"></span> button
- opens a popup which adjusts the styling of one or more cells (based on
- the user's selection).</p>
-<p>The following options can be adjusted:</p>
-<ul>
- <li>The border style, color and width (same as table properties), but applying
- to the current cell only.</li>
- <li>The background color, with none set by default.</li>
- <li>The width and height of the cell in percentage (must end with <code>%</code>)
- or pixels (must end with <code>px</code>).</li>
- <li>The padding (the distance of the text compared to the cell's borders).</li>
- <li>The alignment of the text, both horizontally (left, centered, right, justified)
- and vertically (top, middle or bottom).</li>
-</ul>
-<p>The cell will immediately update to reflect the changes, but the <em>Save</em> button
- must be pressed for the changes to persist.</p>
-<h2>Border and background colors</h2>
-<p>The border and background colors of tables and cells adapt to the <a href="#root/_help_Wy267RK4M69c">theme</a>,
- the same way as <a href="#root/_help_Gr6xFaF6ioJ5">text colors</a> do. A
- color picked from the palette, chosen with the color picker or typed in
- is shown in a lighter or darker shade that suits the current theme, so
- borders stay visible and text stays readable on the background. The hue
- stays the same, and the table keeps the color as it was picked.</p>
-<p>Colors applied with older versions of Trilium are shown exactly as they
- were picked, until the note is next edited.</p>
-<p>Older browsers that can't adapt colors show them exactly as they were
- picked.</p>
-<h2>Caption</h2>
-<p>Press the&nbsp;<span class="tn-icon cke cke-caption"></span> button to
- insert a caption or a text description of the table, which is going to
- be displayed above the table.</p>
-<h2>Table borders</h2>
-<p>By default, tables will come with a predefined gray border.</p>
-<p>To adjust the borders, follow these steps:</p>
-<ol>
- <li>Select the table.</li>
- <li>In the floating panel, select the <em>Table properties</em> option (<span
- class="tn-icon cke cke-table-properties"></span>).
- <ol>
- <li>Look for the <em>Border</em> section at the top of the newly opened panel.</li>
- <li>This will control the outer borders of the table.</li>
- <li>Select a style for the border. Generally <em>Single</em> is the desirable
- option.</li>
- <li>Select a color for the border.</li>
- <li>Select a width for the border, expressed in pixels.</li>
- </ol>
- </li>
- <li>Select all the cells of the table and then press the <em>Cell properties</em> option
- (<span class="tn-icon cke cke-table-cell-properties"></span>).
- <ol>
- <li>This will control the inner borders of the table, at cell level.</li>
- <li>Note that it's possible to change the borders individually by selecting
- one or more cells, case in which it will only change the borders that intersect
- these cells.</li>
- <li>Repeat the same steps as from step (2).</li>
- </ol>
- </li>
-</ol>
-<h3>Tables with invisible borders</h3>
-<p>Tables can be set to have invisible borders in order to allow for basic
- layouts (columns, grids) of text or <a href="#root/_help_mT0HEkOsz6i1">images</a> without
- the distraction of their border:</p>
-<ol>
- <li>First insert a table with the desired number of columns and rows.</li>
- <li>Select the entire table.</li>
- <li>In <em>Table properties</em>, set:
- <ol>
- <li><em>Style</em> to <em>Single</em>
- </li>
- <li><em>Color</em> to <code>transparent</code>
- </li>
- <li>Width to <code>1px</code>.</li>
- </ol>
- </li>
- <li>In Cell Properties, set the same as on the previous step.</li>
-</ol>
-<h2>Table indentation</h2>
-<p>Since v0.104.1, tables can be indented as a block (the whole table moves,
- rather than just the content of a cell).</p>
-<ol>
- <li>Click the&nbsp;<span style="--tn-color:hsl(0,0%,60%);color:hsl(0,0%,60%);"><span class="tn-icon cke cke-drag-handle"></span></span>button
- to select the entire table. Otherwise, the indentation applies only to
- the current cell's content.</li>
- <li>Press <kbd>Tab</kbd> to increase the indent, or <kbd>Shift</kbd>+<kbd>Tab</kbd> to
- decrease it. Alternatively, use the indentation buttons in the formatting
- toolbar.</li>
-</ol>
-<p>Markdown does not support indented tables, so the indentation is lost
- when converting to Markdown.</p>
-<h2>Markdown import/export</h2>
-<p>Simple tables are exported in GitHub-flavored Markdown format (e.g. a
- series of <code>|</code> items). If the table is found to be more complex
- (it contains HTML elements, has custom sizes or images), the table is converted
- to a HTML one instead.</p>
-<p>Generally formatting loss should be minimal when exported to Markdown
- due to the fallback to HTML formatting.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Tables_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Tables_image.png
deleted file mode 100644
index 5cc9f0b7b3..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Tables_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Text Snippets.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Text Snippets.html
deleted file mode 100644
index 310cc3ca7e..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Text Snippets.html
+++ /dev/null
@@ -1,45 +0,0 @@
-<figure class="image image-style-align-right">
- <img style="aspect-ratio:265/108;" src="Text Snippets_image.png" width="265"
- height="108">
-</figure>
-<p>Text Snippets are closely related to&nbsp;<a class="reference-link" href="#root/_help_KC1HB96bqqHX">Templates</a>,
- but instead of defining the content of an entire note, text snippets are
- pieces of formatted text that can easily be inserted in a text note.</p>
-<h2>Creating a text snippet</h2>
-<p>In the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>: </p>
-<ol>
- <li>Right click a note where to place the text snippet.</li>
- <li>Select <em>Insert child note</em>.</li>
- <li>Select <em>More</em> → <em>Text snippet</em>.</li>
-</ol>
-<p>Afterwards, simply type in the content of the note the desired text. The
- text can be formatted in the same manner as a normal text note.</p>
-<p>The title of the note will become the title of the template. Optionally,
- a description can be added in the&nbsp;<a class="reference-link" href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;section.</p>
-<h2>Inserting a snippet</h2>
-<p>Once a snippet is created, there are two options to insert it:</p>
-<ol>
- <li>From the&nbsp;<a class="reference-link" href="#root/_help_nRhnJkTT8cPs">Formatting toolbar</a>,
- by looking for the&nbsp;<span class="tn-icon cke cke-trilium-template"></span> button.</li>
- <li>Using&nbsp;<a class="reference-link" href="#root/_help_ZlN4nump6EbW">Slash Commands</a>: 
- <ol>
- <li>To look for a specific template, start typing the name of the template
- (its title).</li>
- <li>To look for all the templates, type <code>template</code>.</li>
- </ol>
- </li>
-</ol>
-<aside class="admonition tip">
- <p>A newly created snippet doesn't appear? Generally it takes up to a few
- seconds to refresh the list of templates once you make a change.</p>
- <p>If this doesn't happen, <a href="#root/_help_s8alTXmpFR61">reload the application</a> and <a
- href="#root/_help_wy8So3yZZlH9">report the issue</a>to us.&nbsp;</p>
-</aside>
-<h2>Limitations</h2>
-<ul>
- <li>Whenever a snippet is created, deleted or its title/description are modified,
- all the open text notes will need to be refreshed. This causes a slight
- flash for usually under a second, but it can cause some discomfort.</li>
- <li>Unlike&nbsp;<a class="reference-link" href="#root/_help_KC1HB96bqqHX">Templates</a>,
- the snippets cannot be limited to a particular <a href="#root/_help_9sRHySam5fXb">workspace</a>.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Text Snippets_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Text Snippets_image.png
deleted file mode 100644
index 90b8fbe958..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Text Snippets_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/To-do Lists.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/To-do Lists.html
deleted file mode 100644
index f3780f531e..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/To-do Lists.html
+++ /dev/null
@@ -1,44 +0,0 @@
-<h2>Extended task states</h2>
-<figure class="image image-style-align-left">
- <img style="aspect-ratio:303/264;" src="To-do Lists_image.png" width="303"
- height="264">
-</figure>
-<p>In Trilium, to-do items aren't limited to a simple "done" or "not done."
- Tasks can also be marked as <em>in progress</em> ("doing"), <em>under consideration</em> ("maybe"),
- or <em>cancelled</em> ("won't do"), thus giving a more accurate picture of
- where things actually stand.</p>
-<p>Right-click the checkbox and select the desired state. Alternatively,
- press <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Enter </kbd> to cycle through
- the task states. Tapping or left-clicking the checkbox will always toggle
- between "None" and "Done".</p>
-<p>Task states are fully preserved when converting between&nbsp;<a class="reference-link"
- href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;and&nbsp;<a class="reference-link"
- href="#root/_help_6RM1Q7ppFVoj">Markdown</a>&nbsp;notes, in both directions.</p>
-<h3>Customizing the extended task states</h3>
-<p>Task states are customizable: you can reorder them, create new ones with
- different colors and symbols, or delete the ones you don't need. See&nbsp;<a
- class="reference-link" href="#root/_help_i16PM6A7GXdU">Customizing to-do task states</a>&nbsp;for
- more details.</p>
-<h2>Keyboard shortcuts</h2>
-<p>When at the beginning on an empty paragraph, type the following to insert
- a to-do list:</p>
-<ul>
- <li><code>[ ]</code> for an unchecked item</li>
- <li><code>[x]</code> for a checked item</li>
-</ul>
-<p>Extended task states are supported as well, using its corresponding <em>Markdown symbol</em>.
- These are the defaults but they can be changed if needed (see&nbsp;<a class="reference-link"
- href="#root/_help_i16PM6A7GXdU">Customizing to-do task states</a>):</p>
-<ul>
- <li><code>[/]</code> for “Doing”.</li>
- <li><code>[?]</code> for “Maybe”.</li>
- <li><code>[-]</code> for “Cancelled”.</li>
-</ul>
-<p>To reorder the item under the cursor, press <kbd>Alt</kbd>+<kbd>Up</kbd> or <kbd>Alt</kbd>+<kbd>Down</kbd>.
- To reorder multiple items, select them first.</p>
-<h2>See also</h2>
-<ul>
- <li>To-do lists are meant for small task lists. For more complicated, day-to-day
- task tracking consider using a&nbsp;<a class="reference-link" href="#root/_help_CtBQqbwXDx1w">Kanban Board</a>&nbsp;collection
- instead.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/To-do Lists_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/To-do Lists_image.png
deleted file mode 100644
index 69d45905fd..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/To-do Lists_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text_image.png
deleted file mode 100644
index 6e2befad81..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Web View.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Web View.html
deleted file mode 100644
index 0fa20ca4d3..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Web View.html
+++ /dev/null
@@ -1,37 +0,0 @@
-<h2>Configuration</h2>
-<p>A webview needs to know which URL to render, and it can be provided by
- setting the <code>webViewSrc</code> <a href="#root/_help_zEY4DaJG4YT5">label</a>,
- such as:</p><pre><code class="language-text-x-trilium-auto">#webViewSrc="https://www.wikipedia.org"</code></pre>
-<p>The URL needs to contain the full scheme.</p>
-<h2>Web view on the server vs. Electron</h2>
-<p>When accessing Trilium via a browser instead of the desktop application,
- the web view will still try to render the content of the desired webpage.
- However, since it's running in a browser there are quite a few limitations
- as opposed to the desktop one.</p>
-<p>More specifically, quite a few websites oppose being embedded in another
- website (technically they have a non-permisive <code>X-Frame-Options</code> header).
- This is not bypassable by Trilium so the page will simply fail to render.</p>
-<p>You can diagnose this by right clicking the Trilium web page → Inspect
- (element) and looking in the “Console” tab for errors such as:</p>
-<ul>
- <li><code>Refused to display 'https://www.google.com/' in a frame because it set 'X-Frame-Options' to 'sameorigin'.</code>
- </li>
- <li><code>Refused to frame 'https://duckduckgo.com/' because an ancestor violates the following Content Security Policy directive: "frame-ancestors 'self' https://html.duckduckgo.com".</code>
- </li>
-</ul>
-<p>There are a few websites that do render such as <code>wikipedia.org</code>.</p>
-<p>Do note that we are also applying some sandboxing constraints on the server
- side, so if you have any issues other than the unresolvable <code>X-Frame-Options</code> described
- above, feel free to report them.</p>
-<p>On the desktop side, a different technology is used which bypasses the
- constraints of an <code>iframe</code> (<code>webview</code>).</p>
-<h2>Embedding in other note types</h2>
-<p>Starting with v0.104.0, web views can be embedded into other note types:</p>
-<ul>
- <li><a class="reference-link" href="#root/_help_IF7Q6I9x7zuw">Dashboard</a>
- </li>
- <li><a class="reference-link" href="#root/_help_grjYqerjn243">Canvas</a>
- </li>
- <li><a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;notes
- via&nbsp;<a class="reference-link" href="#root/_help_nBAXQFj20hS1">Include Note</a>.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types_image.png
deleted file mode 100644
index d10e037656..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Quick Start.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Quick Start.html
deleted file mode 100644
index 16904fbdfe..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Quick Start.html
+++ /dev/null
@@ -1,32 +0,0 @@
-<h2>Choose the setup</h2>
-<p><strong>Local only desktop/laptop</strong> - Allows a single instance on
- a desktop and will save the notes locally on that desktop.</p>
-<ul>
- <li><a class="reference-link" href="#root/_help_poXkQfguuA0U">Desktop Installation</a>
- </li>
-</ul>
-<p><strong>Server with web only access</strong> - Installs the application
- on the server and allows access from any web browser on any device, including
- mobile.</p>
-<ol>
- <li><a class="reference-link" href="#root/_help_WOcw2SLH6tbX">Server Installation</a>
- </li>
- <li><a class="reference-link" href="#root/_help_RDslemsQ6gCp">Mobile Frontend</a>&nbsp;(optional)</li>
- <li><a class="reference-link" href="#root/_help_yeEaYqosGLSh">Third-party cloud hosting</a>
- </li>
-</ol>
-<p><strong>Combination of server and desktop/laptop</strong> - Install the
- application on both a server, for web access and data synchronisation,
- and desktop instance(s). This allows all the data to be stored on the server
- and either accessed from the web browser, or the desktop application. The
- desktop application will sync and store the data locally so that it can
- be used when offline.</p>
-<ol>
- <li><a class="reference-link" href="#root/_help_WOcw2SLH6tbX">Server Installation</a>
- </li>
- <li><a class="reference-link" href="#root/_help_RDslemsQ6gCp">Mobile Frontend</a>&nbsp;(optional)</li>
- <li><a class="reference-link" href="#root/_help_poXkQfguuA0U">Desktop Installation</a>
- </li>
- <li><a class="reference-link" href="#root/_help_cbkrhQjrkKrh">Synchronization</a>
- </li>
-</ol>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting.html
deleted file mode 100644
index 65c1181ff9..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting.html
+++ /dev/null
@@ -1,71 +0,0 @@
-<p>Trilium supports creating&nbsp;<a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;notes,
- i.e. notes which allow you to store some programming code and highlight
- it. Special case is JavaScript code notes which can also be executed inside
- Trilium which can in conjunction with&nbsp;<a class="reference-link" href="#root/_help_GLks18SNjxmC">Script API</a>&nbsp;provide
- extra functionality.</p>
-<h2>Architecture Overview</h2>
-<p>To go further I must explain basic architecture of Trilium - in its essence
- it is a classic web application - it has these two main components:</p>
-<ul>
- <li>frontend running in the browser (using HTML, CSS, JavaScript) - this is
- mainly used to interact with the user, display notes etc.</li>
- <li>backend running JavaScript code in node.js runtime - this is responsible
- for e.g. storing notes, encrypting them etc.</li>
-</ul>
-<p>So we have frontend and backend, each with their own set of responsibilities,
- but their common feature is that they both run JavaScript code. Add to
- this the fact, that we're able to create JavaScript&nbsp;<a class="reference-link"
- href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;and we're onto something.</p>
-<h2>Use cases</h2>
-<ul>
- <li><a class="reference-link" href="#root/_help_TjLYAo3JMO8X">"New Task" launcher button</a>
- </li>
-</ul>
-<h2>Action handler</h2>
-<p>Saving the note to the database is backend's responsibility, so we immediately
- pass control to the backend and ask it to create a note. Once this is done,
- we show the newly created note so that the user can set the task title
- and maybe some attributes.</p>
-<h2>Script execution</h2>
-<p>So we have a script which will add the button to the toolbar. But how
- can we execute it? One possibility is to click on the <span class="tn-icon bx bx-play"></span> <em>Execute script</em> button.
- The problem with this is that this UI change is time bound by Trilium runtime
- so when we restart Trilium, button won't be there.</p>
-<p>We need to execute it every time Trilium starts up, but we probably don't
- want to have to manually click on play button on every start up.</p>
-<p>The solution is to give the note the <a href="#root/_help_zEY4DaJG4YT5">label</a> <code>#run=frontendStartup</code> -
- this is one of the "system" labels which Trilium understands. As you might
- guess, this will cause all such labeled script notes to be executed once
- Trilium frontend starts up.</p>
-<p>(<code>#run=frontendStartup</code> does not work for <a href="#root/_help_RDslemsQ6gCp">Mobile frontend</a> -
- if you want to have scripts running there, give the script <code>#run=mobileStartup</code> label).</p>
-<h3>Execute button</h3>
-<p>Runnable code notes (frontend or backend) and saved SQL consoles can optionally
- have a dedicated <span class="tn-icon bx bx-play"></span> execute button
- alongside a description.</p>
-<p>To do so, apply the following <a href="#root/_help_HI6GBBIduIgv">labels</a>:</p>
-<ul>
- <li>A <code>#executeButton</code> with the value of the label being displayed
- as the label of the button.</li>
- <li>An optional <code>#executeDescription</code> which adds explanatory text
- beside it.</li>
-</ul>
-<h2>Autocomplete &amp; linting</h2>
-<p>Starting with Trilium v0.104.0, frontend scripts, backend scripts and
- render notes benefit from an autocomplete system.</p>
-<p>The autocomplete triggers automatically when typing <kbd>.</kbd> or manually
- by pressing <kbd>Ctrl</kbd>+<kbd>Space</kbd>.</p>
-<p>In addition to that, the editor will also display syntax errors and warnings
- such as unreachable code.</p>
-<aside class="admonition note">
- <p>If you notice a false positive in regards with the errors/warnings reported
- or an incorrect or missing API, feel free to <a href="#root/_help_wy8So3yZZlH9">open a issue</a> with
- a code sample.</p>
-</aside>
-<h2>More showcases</h2>
-<p>You can see more scripting with explanation in&nbsp;<a class="reference-link"
- href="#root/_help_5668rwcirq1t">Advanced Showcases</a>.</p>
-<h2>Events</h2>
-<p>See&nbsp;<a class="reference-link" href="#root/_help_GPERMystNGTB">Events</a>.</p>
-<h2>Script API</h2>
-<p>See&nbsp;<a class="reference-link" href="#root/_help_GLks18SNjxmC">Script API</a>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Backend scripts.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Backend scripts.html
deleted file mode 100644
index adcf61a98f..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Backend scripts.html
+++ /dev/null
@@ -1,41 +0,0 @@
-<p>Unlike <a href="#root/_help_yIhgI5H7A2Sm">front-end scripts</a> which run
- on the client / browser-side, back-end scripts run directly on the Node.js
- environment of the Trilium server.</p>
-<p>Back-end scripts can be used both on a&nbsp;<a class="reference-link"
- href="#root/_help_WOcw2SLH6tbX">Server Installation</a>&nbsp;(where it
- will run on the device the server is running on), or on the&nbsp;<a class="reference-link"
- href="#root/_help_poXkQfguuA0U">Desktop Installation</a>&nbsp;(where it
- will run on the PC).</p>
-<aside class="admonition important">
- <p>Starting with v0.104.0, backend scripts are disabled by default to reduce
- the attack surface. See&nbsp;<a class="reference-link" href="#root/_help_fiHicjpHjIRJ">Security</a>&nbsp;for
- more information.</p>
-</aside>
-<h2>Advantages of backend scripts</h2>
-<p>The benefit of backend scripts is that they can be pretty powerful, for
- example to have access to the underlying system, for example it can read
- files or execute processes.</p>
-<p>However, the main benefit of backend scripts is that they have easier
- access to the notes since the information about them is already loaded
- in memory. Whereas on the client, notes have to be manually loaded first.</p>
-<h2>Creating a backend script</h2>
-<p>Create a new&nbsp;<a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;note
- and select the language <em>JavaScript (Trilium backend)</em>, or choose <em>Insert child note</em> → <em>Code</em> → <em>Backend script</em> in
- the&nbsp;<a class="reference-link" href="#root/_help_YtSN43OrfzaA">Note tree contextual menu</a>,
- which does both in one step.</p>
-<h2>Running backend scripts</h2>
-<p>Backend scripts can be either run manually (via the Execute button on
- the script page), or they can be triggered on certain events.</p>
-<p>When a script run manually or from a launcher throws an error, Trilium
- shows a <em>Scripting error</em> notification with the error message and
- a link to the note that failed. If the error comes from a child note the
- script requires, the link points to that child note. Changes the script
- made to notes before the error are rolled back.</p>
-<p>In addition, scripts can be run automatically when the server starts up,
- on a fixed time interval or when a certain event occurs (such as an attribute
- being modified). For more information, see the dedicated&nbsp;<a class="reference-link"
- href="#root/_help_GPERMystNGTB">Events</a>&nbsp;page.</p>
-<h2>Script API</h2>
-<p>Trilium exposes a set of APIs that can be directly consumed by scripts,
- under the <code>api</code> object. For a reference of this API, see&nbsp;<a
- class="reference-link" href="#root/_help_MEtfsqa5VwNi">Backend API</a>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Backend scripts/Backend Events.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Backend scripts/Backend Events.html
deleted file mode 100644
index 45badf57d8..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Backend scripts/Backend Events.html
+++ /dev/null
@@ -1,158 +0,0 @@
-<p><a href="#root/_help_CdNpE2pqjmI6">Script</a> notes can be triggered by
- events. Note that these are backend events and thus relation need to point
- to the "JavaScript (Trilium backend)" code note.</p>
-<h2>Global events</h2>
-<p>Global events are attached to the script note via label. Simply create
- a <code>run</code> label with some of these values and script note will be
- executed once the event occurs.</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Label</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>run</code>
- </td>
- <td>
- <p>Defines on which events script should run. Possible values are:</p>
- <ul>
- <li><code>backendStartup</code> - when Trilium backend starts up</li>
- <li><code>hourly</code> - run once an hour. You can use additional label <code>runAtHour</code> to
- specify at which hour, on the back-end.</li>
- <li><code>daily</code> - run once a day, on the back-end</li>
- </ul>
- </td>
- </tr>
- <tr>
- <td><code>runOnInstance</code>
- </td>
- <td>Specifies that the script should only run on a particular&nbsp;<a class="reference-link"
- href="#root/_help_c5xB8m4g2IY6">Trilium instance</a>.</td>
- </tr>
- <tr>
- <td><code>runAtHour</code>
- </td>
- <td>On which hour should this run. Should be used together with <code>#run=hourly</code>.
- Can be defined multiple times for more runs during the day.</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<p>Frontend scripts also have similar&nbsp;<a class="reference-link" href="#root/_help_irkwjdNtjcxR">Events</a>,
- such as when the application starts.</p>
-<aside class="admonition note">
- <p>One script can be triggered on multiple events, this can be done by adding
- multiple <code>run</code> labels. Separating multiple values by commas <strong>is not</strong> supported.</p>
-</aside>
-<h2>Entity events</h2>
-<p>Other events are bound to some entity, these are defined as <a href="#root/_help_zEY4DaJG4YT5">relations</a> -
- meaning that script is triggered only if note has this script attached
- to it through relations (or it can inherit it).</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Relation</th>
- <th>Trigger condition</th>
- <th>Origin entity (see below)</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>runOnNoteCreation</code>
- </td>
- <td>executes when note is created on backend. Use this relation if you want
- to run the script for all notes created under a specific subtree. In that
- case, create it on the subtree root note and make it inheritable. A new
- note created within the subtree (any depth) will trigger the script.</td>
- <td>The <code>BNote</code> that got created.</td>
- </tr>
- <tr>
- <td><code>runOnChildNoteCreation</code>
- </td>
- <td>executes when new note is created under the note where this relation is
- defined</td>
- <td>The <code>BNote</code> of the child that got created.</td>
- </tr>
- <tr>
- <td><code>runOnNoteTitleChange</code>
- </td>
- <td>executes when note title is changed (includes note creation as well)</td>
- <td>The <code>BNote</code> of the note whose title got changed.</td>
- </tr>
- <tr>
- <td><code>runOnNoteContentChange</code>
- </td>
- <td>executes when note content is changed (includes note creation as well).</td>
- <td>The <code>BNote</code> of the note whose content got changed.</td>
- </tr>
- <tr>
- <td><code>runOnNoteChange</code>
- </td>
- <td>executes when note is changed (includes note creation as well). Does not
- include content changes</td>
- <td>The <code>BNote</code> of the note that got changed.</td>
- </tr>
- <tr>
- <td><code>runOnNoteDeletion</code>
- </td>
- <td>executes when note is being deleted</td>
- <td>The <code>BNote</code> of the note that got (soft) deleted.</td>
- </tr>
- <tr>
- <td><code>runOnBranchCreation</code>
- </td>
- <td>executes when a branch is created. Branch is a link between parent note
- and child note and is created e.g. when cloning or moving note.</td>
- <td>The <code>BBranch</code> that got created.</td>
- </tr>
- <tr>
- <td><code>runOnBranchChange</code>
- </td>
- <td>executes when a branch is updated. (since v0.62)</td>
- <td>The <code>BBranch</code> that got changed.</td>
- </tr>
- <tr>
- <td><code>runOnBranchDeletion</code>
- </td>
- <td>executes when a branch is deleted. Branch is a link between parent note
- and child note and is deleted e.g. when moving note (old branch/link is
- deleted).</td>
- <td>The <code>BBranch</code> that got (soft) deleted.</td>
- </tr>
- <tr>
- <td><code>runOnAttributeCreation</code>
- </td>
- <td>executes when new attribute is created for the note which defines this
- relation</td>
- <td>The <code>BAttribute</code> that got created.</td>
- </tr>
- <tr>
- <td><code>runOnAttributeChange</code>
- </td>
- <td>executes when the attribute is changed of a note which defines this relation.
- This is triggered also when the attribute is deleted</td>
- <td>The <code>BAttribute</code> that got changed.</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<h2>Origin entity</h2>
-<p>When a script is run by an event such as the ones described above, <code>api.originEntity</code> will
- get populated with the note, branch or attribute that triggered the change.</p>
-<p>For example, here's a script with <code>~runOnAttributeChange</code> which
- automatically changes the color of a note based on the value of the <code>mycategory</code> label:</p><pre><code class="language-text-javascript">const attr = api.originEntity;
-if (attr.name !== "mycategory") return;
-const note = api.getNote(attr.noteId);
-if (attr.value === "Health") {
- note.setLabel("color", "green");
-} else {
- note.removeLabel("color");
-}</code></pre>
-<h2>Safe mode</h2>
-<p>While <a href="#root/_help_64ZTlUPgEPtW">safe mode</a> is active, scripts
- with events won't trigger.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Backend scripts/Server-side imports.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Backend scripts/Server-side imports.html
deleted file mode 100644
index 7820ccfe2d..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Backend scripts/Server-side imports.html
+++ /dev/null
@@ -1,7 +0,0 @@
-<p>Older versions of Trilium Notes allowed the use of Common.js module imports
- inside backend scripts, such as:</p><pre><code class="language-text-x-trilium-auto">const isBetween = require('dayjs/plugin/isBetween')
-api.dayjs.extend(isBetween)</code></pre>
-<p>For newer versions, Node.js imports are <strong>not officially supported anymore</strong>,
- since we've added a bundler which makes it more difficult to reuse dependencies.</p>
-<p>Theoretically it's still possible to use imports by manually setting up
- a <code>node_modules</code> in the server directory via <code>npm</code> or <code>pnpm</code>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Breaking changes/v0.102.0 Upgrade to jQuery 4.0.0.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Breaking changes/v0.102.0 Upgrade to jQuery 4.0.0.html
deleted file mode 100644
index 31e2f62176..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Breaking changes/v0.102.0 Upgrade to jQuery 4.0.0.html
+++ /dev/null
@@ -1,13 +0,0 @@
-<p>jQuery 4 removes legacy browser support (such as IE11 support), but it
- also removes some APIs that are considered deprecated such as:</p>
-<blockquote>
- <p><code>jQuery.isArray</code>, <code>jQuery.parseJSON</code>, <code>jQuery.trim</code>, <code>jQuery.type</code>, <code>jQuery.now</code>, <code>jQuery.isNumeric</code>, <code>jQuery.isFunction</code>, <code>jQuery.isWindow</code>, <code>jQuery.camelCase</code>, <code>jQuery.nodeName</code>, <code>jQuery.cssNumber</code>, <code>jQuery.cssProps</code>,
- and <code>jQuery.fx.interval</code>.</p>
- <p>Use native equivalents like <code>Array.isArray()</code>, <code>JSON.parse()</code>, <code>String.prototype.trim()</code>,
- and <code>Date.now()</code> instead.</p>
-</blockquote>
-<p>This may affect custom scripts if they (or the custom jQuery libraries
- used) depend on the deprecated APIs.</p>
-<p>Note that Trilium polyfills <code>jQuery.isArray</code>, <code>isFunction</code> and <code>isPlainObject</code> because
- they were required by one of our dependencies (the autocomplete).</p>
-<p>For more information, consult <a href="https://blog.jquery.com/2026/01/17/jquery-4-0-0/">the official blog post</a>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Breaking changes/v0.103.0 Removal of axios.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Breaking changes/v0.103.0 Removal of axios.html
deleted file mode 100644
index 607ec5427f..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Breaking changes/v0.103.0 Removal of axios.html
+++ /dev/null
@@ -1,26 +0,0 @@
-<p>The <code>api.axios</code> library has been removed from the backend scripting
- API.</p>
-<p>Scripts that attempt to use <code>api.axios</code> will now throw an error
- with migration instructions.</p>
-<h2>Reasoning</h2>
-<p>Axios was marked as deprecated at least since April 2024 in favor of the
- native <code>fetch()</code> API, which is available in both browser and Node.js
- environments. After two years of deprecation, the library was removed following
- the <a href="https://www.malwarebytes.com/blog/news/2026/03/axios-supply-chain-attack-chops-away-at-npm-trust">March 2026 npm supply chain compromise</a>,
- where attackers published malicious versions that deployed a remote access
- trojan. The Trilium's main developer almost got compromised, but <code>pnpm</code> not
- trusting unknown post-install scripts successfully avoided that.</p>
-<h2>Migration</h2>
-<p>Replace <code>api.axios</code> calls with the native <code>fetch()</code> API.</p>
-<h3><code>GET</code> calls</h3>
-<p>Before (Axios):</p><pre><code class="language-text-javascript">const response = await api.axios.get('https://api.example.com/data');
-const data = response.data;</code></pre>
-<p>After (<code>fetch</code>):</p><pre><code class="language-text-javascript">const response = await fetch('https://api.example.com/data');
-const data = await response.json();</code></pre>
-<h3><code>POST</code> calls</h3>
-<p>Before (Axios):</p><pre><code class="language-text-javascript">await api.axios.post('https://api.example.com/data', { key: 'value' });</code></pre>
-<p>After (fetch):</p><pre><code class="language-text-javascript">await fetch('https://api.example.com/data', {
- method: 'POST',
- headers: { 'Content-Type': 'application/json' },
- body: JSON.stringify({ key: 'value' })
-});</code></pre>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Breaking changes/v0.103.0 `cheerio` is now deprecated.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Breaking changes/v0.103.0 `cheerio` is now deprecated.html
deleted file mode 100644
index 9f9ebc3803..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Breaking changes/v0.103.0 `cheerio` is now deprecated.html
+++ /dev/null
@@ -1,18 +0,0 @@
-<p>The <code>api.cheerio</code> library is deprecated and will be removed in
- a future version.</p>
-<aside class="admonition note">
- <p><code>cheerio</code> was removed in v0.106.0. See <a class="reference-link"
- href="#root/_help_kTx7WqLdZ3Ry">v0.106.0: Removal of cheerio</a> for the
- full migration guide.</p>
-</aside>
-<h2>Reasoning</h2>
-<p>Cheerio is only used for the scripting API while the server internally
- uses <code>node-html-parser</code> for HTML parsing. Removing <code>cheerio</code> reduces
- bundle size and maintenance overhead.</p>
-<h2>Migration</h2>
-<p>Before (<code>cheerio</code>):</p><pre><code class="language-text-javascript">const $ = api.cheerio.load(html);
-const title = $('h1').text();
-const links = $('a').map((i, el) =&gt; $(el).attr('href')).get();</code></pre>
-<p>After (<code>htmlParser</code>):</p><pre><code class="language-text-javascript">const root = api.htmlParser.parse(html);
-const title = root.querySelector('h1')?.textContent;
-const links = root.querySelectorAll('a').map(a =&gt; a.getAttribute('href'));</code></pre>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Breaking changes/v0.104.0 Disabling the Node integration in Electron.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Breaking changes/v0.104.0 Disabling the Node integration in Electron.html
deleted file mode 100644
index 80bd934e46..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Breaking changes/v0.104.0 Disabling the Node integration in Electron.html
+++ /dev/null
@@ -1,36 +0,0 @@
-<h2>Introduction</h2>
-<p>Before v0.104.0, code executed at renderer level (e.g. front-end scripts)
- could directly require <code>@electron/remote</code> or even Node.js APIs
- (e.g. <code>process</code> or <code>fs</code>). While this makes them powerful,
- it also exposes a significant attack surface — any XSS or untrusted script
- in a note becomes remote code execution on the host.</p>
-<p>To mitigate this, the client-side no longer has access to these APIs and
- everything must go through the&nbsp;<a class="reference-link" href="#root/_help_GFXVHyblVN3d">Electron API</a>&nbsp;instead.</p>
-<aside
-class="admonition note">
- <p>If this API change is causing issues with some of your front-end scripts,
- consider:</p>
- <ul>
- <li>Interacting with&nbsp;<a class="reference-link" href="#root/_help_SPirpZypehBG">Backend scripts</a>&nbsp;which
- have a greater degree of freedom.</li>
- <li><a href="#root/_help_wy8So3yZZlH9">Reporting</a> it as a feature request.</li>
- </ul>
-</aside>
-<h2>Overview of the API</h2>
-<p>The Frontend and Backend APIs reside in a global variable, <code>api</code>,
- that can be used anywhere in the script. For example, to display a message
- to the user the following front-end script can be used:</p><pre><code class="language-text-javascript">api.showMessage("Hello world.");</code></pre>
-<p>The Electron API is different: it lives on <code>window.electronApi</code> (exposed
- by the desktop preload script), not on <code>api</code>, and is only available
- in the Electron desktop build. Frontend scripts that use it should guard
- with <code>if (window.electronApi)</code> so they degrade cleanly in the
- browser and standalone (WASM) builds.</p><pre><code class="language-text-javascript">window.electronApi?.window.setZoomFactor(1.2);</code></pre>
-<h2>Additional protection</h2>
-<p>Some of the APIs have additional safe-guards built in which prevent unauthorized
- access.</p>
-<p>The <code>shell</code> group is the most heavily validated: <code>openExternal</code> is
- restricted to an allowlisted set of URL schemes (blocking <code>file:</code>, <code>smb:</code>,
- Follina-class schemes, etc.), <code>openPath</code> must resolve under the
- Trilium data directory or temporary directory, and <code>downloadURL</code> is
- locked to the app's own origin. Invalid input throws on the main side rather
- than being silently passed through.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Breaking changes/v0.106.0 Removal of cheerio.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Breaking changes/v0.106.0 Removal of cheerio.html
deleted file mode 100644
index 6576b7b27f..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Breaking changes/v0.106.0 Removal of cheerio.html
+++ /dev/null
@@ -1,107 +0,0 @@
-<p>The <code>api.cheerio</code> library has been removed from the backend scripting
- API.</p>
-<p>Scripts that attempt to use <code>api.cheerio</code> will now throw an error
- with migration instructions.</p>
-<h2>Reasoning</h2>
-<p><code>cheerio</code> was deprecated in v0.103.0 in favor of <code>api.htmlParser</code> (<a
- href="https://github.com/taoqf/node-fast-html-parser">node-html-parser</a>),
- which Trilium already uses for all of its own HTML parsing. The scripting
- API was the only place that still needed <code>cheerio</code>.</p>
-<p>Shipping both parsers was costly, because <code>cheerio</code> was loaded
- at startup on every platform. It added roughly 1.35 MB of bundled code
- to the server and desktop builds, and roughly 370 kB to the in-browser
- build, where it was loaded into the database worker before the application
- could start.</p>
-<h2>Migration</h2>
-<p>Replace <code>api.cheerio</code> calls with <code>api.htmlParser</code>.
- Note that <code>api.htmlParser</code> returns plain elements rather than
- a wrapped collection, so there is no <code>$</code> object and no chaining.</p>
-<h3>Reading values</h3>
-<p>Before (<code>cheerio</code>):</p><pre><code class="language-text-javascript">const $ = api.cheerio.load(html);
-const title = $('h1').text();
-const links = $('a').map((i, el) =&gt; $(el).attr('href')).get();</code></pre>
-<p>After (<code>htmlParser</code>):</p><pre><code class="language-text-javascript">const root = api.htmlParser.parse(html);
-const title = root.querySelector('h1')?.textContent;
-const links = root.querySelectorAll('a').map(a =&gt; a.getAttribute('href'));</code></pre>
-<h3>Modifying the document</h3>
-<p>Before (<code>cheerio</code>):</p><pre><code class="language-text-javascript">const $ = api.cheerio.load(html);
-$('a').each((i, el) =&gt; {
- $(el).attr('href', '#root/' + noteId);
- $(el).addClass('reference-link');
-});
-note.setContent($('body').html());</code></pre>
-<p>After (<code>htmlParser</code>):</p><pre><code class="language-text-javascript">const root = api.htmlParser.parse(html);
-for (const el of root.querySelectorAll('a')) {
- el.setAttribute('href', '#root/' + noteId);
- el.classList.add('reference-link');
-}
-note.setContent(root.toString());</code></pre>
-<h3>Equivalent operations</h3>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th><code>cheerio</code>
- </th>
- <th><code>htmlParser</code>
- </th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>api.cheerio.load(html)</code>
- </td>
- <td><code>api.htmlParser.parse(html)</code>
- </td>
- </tr>
- <tr>
- <td><code>$('sel')</code>
- </td>
- <td><code>root.querySelectorAll('sel')</code>
- </td>
- </tr>
- <tr>
- <td><code>$('sel').first()</code>
- </td>
- <td><code>root.querySelector('sel')</code>
- </td>
- </tr>
- <tr>
- <td><code>$el.text()</code>
- </td>
- <td><code>el.textContent</code>
- </td>
- </tr>
- <tr>
- <td><code>$el.html()</code>
- </td>
- <td><code>el.innerHTML</code>
- </td>
- </tr>
- <tr>
- <td><code>$el.attr('name')</code>
- </td>
- <td><code>el.getAttribute('name')</code>
- </td>
- </tr>
- <tr>
- <td><code>$el.attr('name', value)</code>
- </td>
- <td><code>el.setAttribute('name', value)</code>
- </td>
- </tr>
- <tr>
- <td><code>$el.addClass('name')</code>
- </td>
- <td><code>el.classList.add('name')</code>
- </td>
- </tr>
- <tr>
- <td><code>$('body').html()</code>
- </td>
- <td><code>root.toString()</code>
- </td>
- </tr>
- </tbody>
- </table>
-</figure>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Breaking changes/v0.107.0 Removal of the old layout.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Breaking changes/v0.107.0 Removal of the old layout.html
deleted file mode 100644
index a6fe0d88c9..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Breaking changes/v0.107.0 Removal of the old layout.html
+++ /dev/null
@@ -1,193 +0,0 @@
-<p>The <em>New layout</em> is a series of UI/UX changes that were introduced
- in v0.101.0 that heavily change both existing UI elements, as well as adding
- some new ones. The goal of this new layout is to modernize the application
- and to make it more intuitive but at the same time to reduce clutter.</p>
-<p>Starting with v0.107.0, the old layout has been <strong>completely removed</strong>.
- This page serves as migration instructions to better understand what changed.</p>
-<h2>Newly introduced features</h2>
-<ul>
- <li>At the bottom of the window there is a new bar called the&nbsp;<a class="reference-link"
- href="#root/_help_AlJ73vBCjWDw">Status bar</a>. This bar houses multiple
- items such as the Breadcrumb navigation and information and settings about
- the current note, such as the <a href="#root/_help_veGu4faJErEM">content language</a> and&nbsp;<a
- class="reference-link" href="#root/_help_zEY4DaJG4YT5">Attributes</a>.</li>
- <li>When a new&nbsp;<a class="reference-link" href="#root/_help_iPIMuisry3hd">Text</a>&nbsp;note
- is created empty, a&nbsp;<a class="reference-link" href="#root/_help_m3VlURMSeOrd">New note type switcher</a>&nbsp;appears
- under the title making it easy to switch to a different note type, template
- or collection.</li>
- <li><a class="reference-link" href="#root/_help_B5dihXRDksTk">Note badges</a>&nbsp;appear
- at the right of the note title and indicate states such as read-only, shared
- notes as well as corresponding actions (temporarily marking a note as editable,
- viewing the sharing note, etc.). These replace some of the floating buttons.</li>
- <li><a class="reference-link" href="#root/_hidden/_options/_optionsTextNotes">Text Notes</a>&nbsp;have
- a new&nbsp;inline title&nbsp;which has a bigger text and display the creation
- and modification dates which collapses back to a smaller title when scrolling.</li>
- <li>The following sections have been made collapsible and get displayed under
- the <a href="#root/_help_l7pigIGu01K2">note title</a>:
- <ul>
- <li><a class="reference-link" href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>
- <ul>
- <li>The keyboard shortcut previously used to trigger the promoted attributes
- ribbon tab (which was no longer working) has been repurposed to toggle
- the promoted attributes instead.</li>
- </ul>
- </li>
- <li><em>Edited Notes</em> (now renamed to <em>Notes edited on this day</em>),
- which appears for&nbsp;<a class="reference-link" href="#root/_help_l0tKav7yLHGF">Day Notes</a>&nbsp;is
- now shown underneath the title.
- <ul>
- <li>Whether the section is collapsed or not depends on the choice in&nbsp;<a
- class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→
- Appearance.</li>
- </ul>
- </li>
- <li><em>Search Properties</em>, which appears for the full&nbsp;<a class="reference-link"
- href="#root/_help_eIg8jdvaoNNd">Search</a>&nbsp;and&nbsp;<a class="reference-link"
- href="#root/_help_m523cpzocqaD">Saved Search</a>.</li>
- </ul>
- </li>
- <li><a class="reference-link" href="#root/_help_Bsm4fyzPJkSc">Save status indicator</a>&nbsp;which
- appears in the&nbsp;<a class="reference-link" href="#root/_help_B5dihXRDksTk">Note badges</a>&nbsp;area&nbsp;and
- indicates when there are unsaved changes.</li>
-</ul>
-<h2>Changing to the existing layout</h2>
-<h3>Removal of the ribbon</h3>
-<p>The most significant change is the removal of the ribbon. All the actions
- and options from the ribbon were integrated in other places in the application.</p>
-<p>Here's how all the different tabs that were once part of the ribbon are
- available in the new layout:</p>
-<ul>
- <li>“Formatting toolbar” was relocated to the top of the page.
- <ul>
- <li>Instead of having one per split, now there is a single formatting toolbar
- per tab. This allows more space for the toolbar items.</li>
- </ul>
- </li>
- <li>“Owned attributes” and “Inherited attributes” were merged and moved to
- the status bar region (displayed one above the other).</li>
- <li>“Basic Properties” were integrated in the&nbsp;<a class="reference-link"
- href="#root/_help_8YBEPzcpUgxw">Note menu</a>&nbsp;menu.
- <ul>
- <li>The only exception here is the Language combo box which can now be found
- in the status bar (top-right of the screen).</li>
- </ul>
- </li>
- <li>“File” and “Image” tabs
- <ul>
- <li>The buttons were moved to the right of the note title, as dedicated entries
- in&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a>.</li>
- <li>The info section has been merged into the <em>Note info</em> section of
- the status bar.</li>
- </ul>
- </li>
- <li>Edited notes
- <ul>
- <li>Moved underneath the title, displayed under a collapsible area and the
- notes are represented as badges/chips.</li>
- <li>Whether the section is expanded or collapsed depends on the <em>Expand “Notes edited on this day” on day notes</em> setting
- from Options → Appearance → <em>User Interface</em>.</li>
- </ul>
- </li>
- <li>Search definition tab
- <ul>
- <li>Moved underneath the title under a collapsible area.</li>
- <li>Expanded by default for new searches, collapsed for saved searches.</li>
- </ul>
- </li>
- <li>The Note map is now in the <span class="tn-icon bx bx-dots-horizontal-rounded"></span> Note
- actions menu.
- <ul>
- <li>Instead of opening into a panel in the ribbon, the note map now opens
- in the sidebar, in the&nbsp;<a class="reference-link" href="#root/_help_KRlZFoIH0j6p">Connections tab</a>&nbsp;where
- it can also be maximized.</li>
- </ul>
- </li>
- <li>“Note info” tab was moved to a small <span class="tn-icon bx bx-info-circle"></span> icon
- in the status bar.</li>
- <li>“Similar notes” tab
- <ul>
- <li>Instead of opening into a panel in the ribbon, the similar notes are now
- shown in the sidebar, in the&nbsp;<a class="reference-link" href="#root/_help_KRlZFoIH0j6p">Connections tab</a>.</li>
- <li><code>similarNotesWidgetDisabled</code> no longer has any effect.</li>
- </ul>
- </li>
- <li>The Collection properties tab were relocated under the note title and
- grouped into:
- <ul>
- <li>A combo box to quickly switch between views.</li>
- <li>Individual settings for the current view in a submenu.</li>
- </ul>
- </li>
- <li>Some smaller ribbon tabs were converted to badges that appear near the
- note title in the breadcrumb section:
- <ul>
- <li>Original URL indicator for clipped web pages (<code>#pageUrl</code>).</li>
- <li>SQL and script <span class="tn-icon bx bx-play"></span> execute buttons.</li>
- </ul>
- </li>
-</ul>
-<aside class="admonition note">
- <p>The ribbon keyboard shortcuts (e.g. <code>toggleRibbonTabClassicEditor</code>)
- have been repurposed and renamed (<em>Focus Formatting Toolbar</em>, <em>Toggle Owned Attributes</em>, <em>Show Note Map</em>,
- etc.) to work on the new layout, where they will toggle the appropriate
- panel.</p>
-</aside>
-<h3>Removal of the floating buttons</h3>
-<p>Most of the buttons were relocated to the right of the note title, in
- the&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a>&nbsp;area,
- with the exception of:</p>
-<ul>
- <li>The Edit button is replaced by the <span class="tn-icon bx bx-lock-alt"></span> <em>Read-only</em> badge
- near the note title, which makes the note temporarily editable when clicked.</li>
- <li><em>Backlinks</em> are now displayed in the sidebar, in the&nbsp;<a class="reference-link"
- href="#root/_help_KRlZFoIH0j6p">Connections tab</a>.
- <ul>
- <li>Alternatively, the backlinks count is displayed in the status bar and
- when clicked the sidebar opens at the right section.</li>
- </ul>
- </li>
- <li>Relation map zoom buttons are now part of the relation map itself.</li>
- <li>Export image to PNG/SVG are now in the Note actions menu, in the <em>Export as image</em> option.</li>
-</ul>
-<h3>Changes to the sidebar</h3>
-<p>The sidebar (also known as the right pane) also received some important
- changes.</p>
-<p>Most importantly, v0.105.0 splits the sidebar into multiple tabs with
- additional functionality:</p>
-<ul>
- <li><a class="reference-link" href="#root/_help_2dcGDhp9WFKb">Outline tab</a>,
- which gathers the table of contents and highlights lists.</li>
- <li><a class="reference-link" href="#root/_help_uNtgN0cUKEBc">Attributes tab</a>,
- which provides a graphical method of editing labels, relations and (promoted)
- attribute definitions.</li>
- <li>A dedicated&nbsp;<a class="reference-link" href="#root/_help_LrKznOtw9cQD">AI chat tab</a>.</li>
- <li><a class="reference-link" href="#root/_help_KRlZFoIH0j6p">Connections tab</a>,
- which groups together the note map, note paths, backlinks and similar notes.</li>
-</ul>
-<p>The previous iteration of the sidebar would appear contextually, depending
- on whether there are any items to be displayed. This caused occasional
- content shifts when moving between two panes in a split view. In the new
- layout, the sidebar acts more like the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>&nbsp;pane,
- remaining visible even if there is nothing to display.</p>
-<p>As such:</p>
-<ul>
- <li>The <em>Table of Contents</em> card in Text Notes options (minimum number
- of headings) is gone. The &nbsp;shows the table of contents whatever the
- number of headings.</li>
- <li><code>#toc</code> / <code>#toc=show</code> / <code>#toc=hide</code> no longer
- have any effect.</li>
- <li><code>#hideHighlightWidget</code> no longer has any effect. The highlight
- categories are still set globally, from the <span class="tn-icon bx bx-cog"></span> menu
- of the Highlights list or Text Notes options, but they can't be hidden
- for a single note.</li>
-</ul>
-<p>In order to toggle the sidebar, there is a new <span class="tn-icon bx bx-sidebar bx-flip-horizontal"></span> button
- on the top-right side of the screen, near the window buttons (on Windows
- and Linux).</p>
-<p>Now each section of the sidebar (e.g. “Table of Contents”, “Highlights
- list”) is individually collapsible and will remember whether it was collapsed.</p>
-<p>Some sidebar items also have their own menu in the title. For example,
- the highlights filter can be adjusted directly from the <span class="tn-icon bx bx-cog"></span> menu
- of the Highlights list.&nbsp;</p>
-<p>Custom widgets are still supported. For custom scripts, the <span class="tn-icon bx bx-dots-vertical-rounded"></span> menu
- allows quick navigation to the corresponding script note.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Common concepts/Script bundles.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Common concepts/Script bundles.html
deleted file mode 100644
index 576861c7f5..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Common concepts/Script bundles.html
+++ /dev/null
@@ -1,46 +0,0 @@
-<p>For both&nbsp;<a class="reference-link" href="#root/_help_HcABDtFCkbFN">Render Note</a>&nbsp;and
- more complicated scripts, it's generally useful to split the code into
- multiple&nbsp;<a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;notes.</p>
-<p>When a script is run, the sub-children of the script being run (or the&nbsp;<a
- class="reference-link" href="#root/_help_HcABDtFCkbFN">Render Note</a>)
- are checked for children. If the children are Code notes of the corresponding
- type (front-end or backend) as the code being run, they will be evaluated
- as well.</p>
-<p>The collection of a script and its child notes is called a <em>bundle</em>.
- A child note inside a bundle is called a <em>module</em>.</p>
-<p>As a basic example of dependencies, consider the following note structure:</p>
-<ul>
- <li>
- <p><em>Script with dependency</em>
- </p><pre><code class="language-text-javascript">api.log(MyMath.sum(2, 2));</code></pre>
- <ul>
- <li>
- <p><em>MyMath</em>
- </p><pre><code class="language-text-javascript">module.exports = {
- sum(a, b) {
- return a + b;
- }
-};</code></pre>
- </li>
- </ul>
- </li>
-</ul>
-<p>When <em>Script with dependency</em> is run, it will detect <em>MyMath</em> as
- a submodule and provide the result of its <code>module.exports</code> object
- into a global object with the same name as the note.</p>
-<aside class="admonition note">
- <p>If the note contains spaces or special characters, they will be stripped.
- For example <code>My Nice Note!</code> becomes <code>MyNiceNote</code>.</p>
-</aside>
-<h2>Alternative syntax</h2>
-<p>Instead of providing an object to <code>module.exports</code>, it's also
- possible to add fields individually:</p><pre><code class="language-text-javascript">module.exports.sum = (a, b) =&gt; a + b;
-module.exports.subtract = (a, b) =&gt; a - b;</code></pre>
-<h2>Ignoring a code script from a bundle</h2>
-<p>To ignore a script from being included in a bundle (e.g. if it's unrelated
- to the parent script note), apply the <code>#disableInclusion</code> label.</p>
-<h2>Sharing a module across multiple bundles</h2>
-<p>Modules can be reused across multiple scripts by simply cloning the shared
- module between two modules (see&nbsp;<a class="reference-link" href="#root/_help_IakOLONlIfGI">Cloning Notes</a>).</p>
-<p>Optionally, a separate note can be used to contain all the different reusable
- modules for an easy way to discover them.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics.html
deleted file mode 100644
index 54652b97fb..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics.html
+++ /dev/null
@@ -1,57 +0,0 @@
-<p>Front-end scripts are custom JavaScript notes that are run on the client
- (browser environment)</p>
-<p>There are four flavors of front-end scripts:</p>
-<figure class="table">
- <table>
- <tbody>
- <tr>
- <td>Regular scripts</td>
- <td>These are run with the current app and note context. These can be run
- either manually or automatically on start-up.</td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_MgibgPcfeuGz">Custom Widgets</a>
- </td>
- <td>These can introduce new UI elements in various positions, such as near
- the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>,
- content area or even the&nbsp;<a class="reference-link" href="#root/_help_RnaPdbciOfeq">Right Sidebar</a>.</td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_4Gn3psZKsfSm">Launch Bar Widgets</a>
- </td>
- <td>Similar to&nbsp;<a class="reference-link" href="#root/_help_MgibgPcfeuGz">Custom Widgets</a>,
- but dedicated to the&nbsp;<a class="reference-link" href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>.
- These can simply introduce new buttons or graphical elements to the bar.</td>
- </tr>
- <tr>
- <td><a class="reference-link" href="#root/_help_HcABDtFCkbFN">Render Note</a>
- </td>
- <td>This allows rendering custom content inside a note, using either HTML
- or Preact JSX.</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<p>For more advanced behaviors that do not require a user interface (e.g.
- batch modifying notes), see&nbsp;<a class="reference-link" href="#root/_help_SPirpZypehBG">Backend scripts</a>.</p>
-<h2>Scripts</h2>
-<p>Scripts don't have any special requirements. They can be run manually
- using the <em>Execute</em> button on the code note or they can be run automatically,
- see&nbsp;<a class="reference-link" href="#root/_help_irkwjdNtjcxR">Frontend Events</a>.</p>
-<h2>Widgets</h2>
-<p>Widgets require a certain format in order for Trilium to be able to integrate
- them into the UI.</p>
-<ul>
- <li>For legacy widgets, the script note must export a <code>BasicWidget</code> or
- a derived one (see&nbsp;<a class="reference-link" href="#root/_help_GhurYZjh8e1V">Note context aware widget</a>&nbsp;or&nbsp;<a
- class="reference-link" href="#root/_help_M8IppdwVHSjG">Right pane widget</a>).</li>
- <li>For Preact widgets, a built-in helper called <code>defineWidget</code> needs
- to be used.</li>
-</ul>
-<p>For more information, see&nbsp;<a class="reference-link" href="#root/_help_MgibgPcfeuGz">Custom Widgets</a>.</p>
-<h2>Script API</h2>
-<p>The front-end API of Trilium is available to all scripts running in the
- front-end context as global variable <code>api</code>. For a reference of
- the API, see&nbsp;<a class="reference-link" href="#root/_help_Q2z6av6JZVWm">Frontend API</a>.</p>
-<h3>Tutorial</h3>
-<p>For more information on building widgets, take a look at <a href="#root/_help_SynTBQiBsdYJ">Widget Basics</a>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets.html
deleted file mode 100644
index 6234d1c3ad..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets.html
+++ /dev/null
@@ -1,219 +0,0 @@
-<p>Custom widgets are a special subset of scripts that render graphical elements
- in certain parts of the application. These can be used to add new functionality
- to the Trilium application.</p>
-<h2>Preact with JSX vs. vanilla jQuery</h2>
-<p>In older versions of Trilium, custom widgets were exclusively written
- in a combination of jQuery with Trilium's internal widget architecture
- (e.g., <code>BasicWidget</code>, <code>NoteContextAwareWidget</code>).</p>
-<p>Starting with v0.101.0, custom widgets can also be written in JSX using
- the&nbsp;<a class="reference-link" href="#root/_help_KLsqhjaqh1QW">Preact</a>&nbsp;framework.
- Both legacy and Preact widgets have the same capabilities, with a single
- difference:</p>
-<ul>
- <li>Preact widgets are content-sized by default whereas legacy widgets need <code>this.contentSized()</code> applied
- in the constructor. For more information, see the corresponding section
- in&nbsp;<a class="reference-link" href="#root/_help_gMkgcLJ6jBkg">Troubleshooting</a>.</li>
-</ul>
-<p>Wherever possible, widget examples will be both in the legacy and Preact
- format.</p>
-<h2>Creating a custom widget</h2>
-<p>The quickest way is <em>Insert child note</em> → <em>Code</em> → <em>Widget</em> in
- the&nbsp;<a class="reference-link" href="#root/_help_YtSN43OrfzaA">Note tree contextual menu</a>.
- It creates a JSX note with the <code>#widget</code> label and a minimal Preact
- widget to start from.</p>
-<p>To set one up by hand instead:</p>
-<ol>
- <li>Create a&nbsp;<a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;note.</li>
- <li>Set the language to:
- <ol>
- <li>JavaScript (frontend) for legacy widgets using jQuery.</li>
- <li>JSX for Preact widgets. You might need to go to Options → Code to enable
- the language first.</li>
- </ol>
- </li>
- <li>Apply the <code>#widget</code> <a href="#root/_help_HI6GBBIduIgv">label</a>.</li>
-</ol>
-<h2>Getting started with a simple example</h2>
-<p>Let's start by creating a widget that shows a message near the content
- area. Follow the previous section to create a code note, and use the following
- content.</p>
-<div class="trilium-tabs">
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-react"></span>&nbsp;Preact</p>
- <div class="trilium-tab-panel"><pre><code class="language-text-x-trilium-auto">import { defineWidget } from "trilium:preact";
-
-export default defineWidget({
- parent: "center-pane",
- render: () =&gt; &lt;span&gt;Center pane from Preact.&lt;/span&gt;
-});</code></pre>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-javascript"></span>&nbsp;Legacy</p>
- <div class="trilium-tab-panel"><pre><code class="language-text-x-trilium-auto">class HelloCenterPane extends api.BasicWidget {
-
- constructor() {
- super();
- this.contentSized();
- }
-
- get parentWidget() { return "center-pane" }
-
- doRender() {
- this.$widget = $("&lt;span&gt;Center pane&lt;/span&gt;");
- }
-
-}
-
-module.exports = new HelloCenterPane();</code></pre>
- </div>
- </section>
-</div>
-<p><a href="#root/_help_s8alTXmpFR61">Refresh the application</a> and the
- widget should appear underneath the content area.</p>
-<h2>Widget location (parent widget)</h2>
-<p>A widget can be placed in one of the following sections of the applications:</p>
-<figure
-class="table">
- <table class="ck-table-resized">
- <colgroup>
- <col style="width:15.59%;">
- <col style="width:30.42%;">
- <col style="width:16.68%;">
- <col style="width:37.31%;">
- </colgroup>
- <thead>
- <tr>
- <th>Value for <code>parentWidget</code>
- </th>
- <th>Description</th>
- <th>Sample widget</th>
- <th>Special requirements</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <th><code>left-pane</code>
- </th>
- <td>Appears within the same pane that holds the&nbsp;<a class="reference-link"
- href="#root/_help_oPVyFC7WL2Lp">Note Tree</a>.</td>
- <td>Same as above, with only a different <code>parentWidget</code>.</td>
- <td>None.</td>
- </tr>
- <tr>
- <th><code>center-pane</code>
- </th>
- <td>In the content area. If a split is open, the widget will span all of the
- splits.</td>
- <td>See example above.</td>
- <td>None.</td>
- </tr>
- <tr>
- <th><code>note-detail-pane</code>
- </th>
- <td>
- <p>In the content area, inside the note detail area. If a split is open,
- the widget will be contained inside the split.</p>
- <p>This is ideal if the widget is note-specific.</p>
- </td>
- <td><a class="reference-link" href="#root/_help_GhurYZjh8e1V">Note context aware widget</a>
- </td>
- <td>
- <ul>
- <li>The widget must export a <code>class</code> and not an instance of the class
- (e.g. <code>no new</code>) because it needs to be multiplied for each note,
- so that splits work correctly.</li>
- <li>Since the <code>class</code> is exported instead of an instance, the <code>parentWidget</code> getter
- must be <code>static</code>, otherwise the widget is ignored.</li>
- </ul>
- </td>
- </tr>
- <tr>
- <th><code>right-pane</code>
- </th>
- <td>In the&nbsp;<a class="reference-link" href="#root/_help_RnaPdbciOfeq">Right Sidebar</a>,
- as a dedicated section.</td>
- <td><a class="reference-link" href="#root/_help_M8IppdwVHSjG">Right pane widget</a>
- </td>
- <td>
- <ul>
- <li>Although not mandatory, it's best to use a <code>RightPanelWidget</code> instead
- of a <code>BasicWidget</code> or a <code>NoteContextAwareWidget</code>.</li>
- </ul>
- </td>
- </tr>
- </tbody>
- </table>
-</figure>
-<p>To position the widget somewhere else, just change the value passed to <code>get parentWidget()</code> for
- legacy widgets or the <code>parent</code> field for Preact. Do note that
- some positions such as <code>note-detail-pane</code> and <code>right-pane</code> have
- special requirements that need to be accounted for (see the table above).</p>
-<h2>Multiple widgets in a single note</h2>
-<p>A widget note usually returns one widget, but it can also return an array
- of them. This is useful when several widgets share code or state, since
- they can all live in the same note instead of being split across notes
- that need a shared module.</p>
-<p>Each widget of the array is registered on its own, so they can have different
- parents and positions. A widget that is missing its <code>parentWidget</code> (or <code>parent</code> for
- Preact) is reported as an error without affecting the other widgets of
- the note.</p>
-<div class="trilium-tabs">
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-react"></span>&nbsp;Preact</p>
- <div class="trilium-tab-panel"><pre><code class="language-text-x-trilium-auto">import { defineWidget } from "trilium:preact";
-
-export default [
- defineWidget({
- parent: "left-pane",
- render: () =&gt; &lt;span&gt;Left pane from Preact.&lt;/span&gt;
- }),
- defineWidget({
- parent: "right-pane",
- render: () =&gt; &lt;span&gt;Right pane from Preact.&lt;/span&gt;
- })
-];</code></pre>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-javascript"></span>&nbsp;Legacy</p>
- <div class="trilium-tab-panel"><pre><code class="language-text-x-trilium-auto">class TreeWidget extends api.BasicWidget {
- get parentWidget() { return "left-pane"; }
- doRender() { this.$widget = $("&lt;span&gt;Left pane&lt;/span&gt;"); }
-}
-
-class SidebarWidget extends api.BasicWidget {
- get parentWidget() { return "right-pane"; }
- doRender() { this.$widget = $("&lt;span&gt;Right pane&lt;/span&gt;"); }
-}
-
-module.exports = [ new TreeWidget(), new SidebarWidget() ];</code></pre>
- </div>
- </section>
-</div>
-<h2>Launch bar widgets</h2>
-<p>Launch bar widgets are similar to <em>Custom widgets</em> but are specific
- to the&nbsp;<a class="reference-link" href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>.
- See&nbsp;<a class="reference-link" href="#root/_help_4Gn3psZKsfSm">Launch Bar Widgets</a>&nbsp;for
- more information.</p>
-<h2>Custom position</h2>
-<p>The position of a custom widget is defined via a <code>position</code> integer.</p>
-<div
-class="trilium-tabs">
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-react"></span>&nbsp;Preact</p>
- <div class="trilium-tab-panel"><pre><code class="language-text-x-trilium-auto">export default defineWidget({
- // [...]
- position: 10
-});</code></pre>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-javascript"></span>&nbsp;Legacy</p>
- <div class="trilium-tab-panel"><pre><code class="language-text-x-trilium-auto">class MyWidget extends api.BasicWidget {
- // [..
- get position() { return 10; }
-}</code></pre>
- </div>
- </section>
-</div>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/CSS.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/CSS.html
deleted file mode 100644
index 481a6d62b7..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/CSS.html
+++ /dev/null
@@ -1,18 +0,0 @@
-<h2>Classic widgets</h2>
-<p>In <code>doRender()</code>:<sup><a href="#fn1saoftmefpp">[1]</a></sup>
-</p><pre><code class="language-text-x-trilium-auto">this.cssBlock(`#my-widget {
- position: absolute;
- bottom: 40px;
- left: 60px;
- z-index: 1;
-}`);</code></pre>
-<h2>Preact widgets</h2>
-<p>See the dedicated page:&nbsp;<a class="reference-link" href="#root/_help_Sg9GrCtyftZf">CSS</a>.</p>
-<ol>
- <li>
- <p><sup><strong><a href="#fnref1saoftmefpp">^</a></strong></sup>
- </p>
- <p>Reference: <a href="https://trilium.rocks/X7pxYpiu0lgU">https://trilium.rocks/X7pxYpiu0lgU</a>
- </p>
- </li>
-</ol>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/Note context aware widget.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/Note context aware widget.html
deleted file mode 100644
index d0da3c3354..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/Note context aware widget.html
+++ /dev/null
@@ -1,45 +0,0 @@
-<p>Note context-aware widgets are a different type of widget which automatically
- react to changes in the current note.</p>
-<p>Important aspects:</p>
-<ul>
- <li>The widget must export a <code>class</code> and not an instance of the class
- (e.g. <code>no new</code>) because it needs to be multiplied for each note,
- so that splits work correctly.</li>
- <li>Since the <code>class</code> is exported instead of an instance, the <code>parentWidget</code> getter
- must be <code>static</code>, otherwise the widget is ignored.</li>
-</ul>
-<h2>Example displaying the current note title</h2>
-<p>This is a note context-aware widget that simply displays the name the
- current note.&nbsp;</p>
-<h3>Classic example</h3><pre><code class="language-text-x-trilium-auto">class HelloNoteDetail extends api.NoteContextAwareWidget {
-
- constructor() {
- super();
- this.contentSized();
- }
-
- doRender() {
- this.$widget = $("&lt;div&gt;");
- }
-
- async refreshWithNote(note) {
- this.$widget.text("Current note: " + note.title);
- }
-
- static get parentWidget() { return "note-detail-pane" }
- get position() { return 10 }
-
-}
-
-module.exports = HelloNoteDetail;</code></pre>
-<h3>Preact (v0.101.0+)</h3><pre><code class="language-text-x-trilium-auto">import { defineWidget, useNoteContext, useNoteProperty } from "trilium:preact";
-
-export default defineWidget({
- parent: "note-detail-pane",
- position: 10,
- render: () =&gt; {
- const { note } = useNoteContext();
- const title = useNoteProperty(note, "title");
- return &lt;span&gt;Current note JSX: {title}&lt;/span&gt;;
- }
-});</code></pre>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/Right pane widget.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/Right pane widget.html
deleted file mode 100644
index 270afb8626..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/Right pane widget.html
+++ /dev/null
@@ -1,115 +0,0 @@
-<h3>Title widget</h3>
-<p>This is an example of a context-aware widget which displays the title
- of the current note:</p><pre><code class="language-text-x-trilium-auto">class NoteTitleWidget extends api.RightPanelWidget {
-
- get widgetTitle() { return "Note title"; }
- get parentWidget() { return "right-pane" }
-
- doRenderBody() {
- this.$body.empty();
- if (this.note) {
- this.$body.append($("&lt;div&gt;").text(this.note.title));
- }
- }
-
- async refreshWithNote() {
- this.doRenderBody();
- }
-}
-
-module.exports = new NoteTitleWidget();</code></pre>
-<h3>Clock</h3>
-<p>A simple widget which will show the current time, as an example on how
- to dynamically change the content of the widget periodically.</p>
-<div class="trilium-tabs">
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-react"></span>&nbsp;Preact</p>
- <div class="trilium-tab-panel"><pre><code class="language-text-x-trilium-auto">import { defineWidget, RightPanelWidget, useEffect, useState } from "trilium:preact";
-
-export default defineWidget({
- parent: "right-pane",
- position: 1,
- render() {
- const [ time, setTime ] = useState();
- useEffect(() =&gt; {
- const interval = setInterval(() =&gt; {
- setTime(new Date().toLocaleString());
- }, 1000);
- return () =&gt; clearInterval(interval);
- });
- return (
- &lt;RightPanelWidget id="clock-jsx" title="Clock (JSX)"&gt;
- &lt;p&gt;The time is: {time}&lt;/p&gt;
- &lt;/RightPanelWidget&gt;
- );
- }
-});</code></pre>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-javascript"></span>&nbsp;Legacy</p>
- <div class="trilium-tab-panel"><pre><code class="language-text-x-trilium-auto">const template = `&lt;div&gt;&lt;/div&gt;`;
-
-class ToDoListWidget extends api.RightPanelWidget {
-
- get widgetTitle() { return "Clock"; }
- get parentWidget() { return "right-pane" }
-
- async doRenderBody() {
- if (!this.timer) {
- this.timer = setInterval(() =&gt; {
- this.$body.empty().append(`The time is: &lt;span&gt;${new Date().toLocaleString()}&lt;/span&gt;`);
- }, 1000);
- }
-
- this.$body.empty().append(`The time is: &lt;span&gt;${new Date().toLocaleString()}&lt;/span&gt;`);
- }
-}
-
-module.exports = new ToDoListWidget();</code></pre>
- </div>
- </section>
-</div>
-<h2>Altering the position within the sidebar</h2>
-<p>By default, the sidebar items are displayed in the order they are found
- by the application when searching for <code>#widget</code> notes.</p>
-<p>It is possible to make a widget appear higher or lower up, by adjusting
- its <code>position</code> property:</p>
-<div class="trilium-tabs">
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-react"></span>&nbsp;Preact</p>
- <div class="trilium-tab-panel"><pre><code class="language-text-javascript">import { defineWidget, RightPanelWidget, useEffect, useState } from "trilium:preact";
-
-export default defineWidget({
- /* [...] */
- position: 20,
- render() {
- /* [...] */
- }
-});</code></pre>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-javascript"></span>&nbsp;Legacy</p>
- <div class="trilium-tab-panel"><pre><code class="language-text-javascript">class MyWidget extends api.RightPanelWidget {
-
- get position() { return 20 };
-
-}</code></pre>
- </div>
- </section>
-</div>
-<p>Generally the default position starts from 10 and increases by 10 with
- each item, including the default Table of Contents and Highlights list.</p>
-<h2>Key highlights for legacy widgets</h2>
-<ul>
- <li><code>doRender</code> must not be overridden, instead <code>doRenderBody()</code> has
- to be overridden.
- <ul>
- <li><code>doRenderBody</code> can optionally be <code>async</code>.</li>
- </ul>
- </li>
- <li><code>parentWidget()</code> must be set to <code>“rightPane”</code>.</li>
- <li><code>widgetTitle()</code> getter can optionally be overriden, otherwise
- the widget will be displayed as “Untitled widget”.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/Troubleshooting.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/Troubleshooting.html
deleted file mode 100644
index 04c18f44bc..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/Troubleshooting.html
+++ /dev/null
@@ -1,15 +0,0 @@
-<h2>Why is my widget clipped by other UI elements</h2>
-<p>For performance and layout reasons, the size of widgets in Trilium is
- independent from its children. At CSS level, this means that the widget
- container has <code>contain: size</code> applied to it.</p>
-<p>This works well if the widget has a fixed size (or based on its parent
- container), however to make a widget resize to fit its content, apply the
- following change:</p><pre><code class="language-text-x-diff">class MyWidget extends api.RightPanelWidget {
-
-+ constructor() {
-+ super();
-+ this.contentSized();
-+ }
-
-}</code></pre>
-<p>Alternatively apply <code>contain: none</code> to its CSS.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/Widget Basics.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/Widget Basics.html
deleted file mode 100644
index 15dca6bdc9..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/Widget Basics.html
+++ /dev/null
@@ -1,95 +0,0 @@
-<p>This guide will walk you through creating a basic widget inside Trilium.
- By following these steps, you'll learn how to build a simple UI element
- that interacts with the user.</p>
-<h3>Step 1: The Basic Widget Structure</h3>
-<p>To start, we'll create the most basic widget possible. Here's a simple
- example:</p><pre><code class="language-text-x-trilium-auto">class MyWidget extends api.BasicWidget {
- get position() { return 1; }
- get parentWidget() { return "left-pane"; }
-
- doRender() {
- this.$widget = $("&lt;div id='my-widget'&gt;");
- return this.$widget;
- }
-}
-
-module.exports = new MyWidget();</code></pre>
-<p>To implement this widget:</p>
-<ol>
- <li>Create a new <code>JS Frontend</code> note in Trilium and paste in the code
- above.</li>
- <li>Assign the <code>#widget</code> <a href="#root/_help_zEY4DaJG4YT5">attribute</a> to
- the <a href="#root/_help_BFs8mudNFgCS">note</a>.</li>
- <li>Restart Trilium or reload the window.</li>
-</ol>
-<p>To verify that the widget is working, open the developer tools (<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>I</kbd>)
- and run <code>document.querySelector("#my-widget")</code>. If the element
- is found, the widget is functioning correctly. If <code>undefined</code> is
- returned, double-check that the <a href="#root/_help_BFs8mudNFgCS">note</a> has
- the <code>#widget</code> <a href="#root/_help_zEY4DaJG4YT5">attribute</a>.</p>
-<h3>Step 2: Adding an UI Element</h3>
-<p>Next, let's improve the widget by adding a button to it.</p><pre><code class="language-text-x-trilium-auto">const template = `&lt;div id="my-widget"&gt;&lt;button&gt;Click Me!&lt;/button&gt;&lt;/div&gt;`;
-
-class MyWidget extends api.BasicWidget {
- get position() {return 1;}
- get parentWidget() {return "left-pane"}
-
- doRender() {
- this.$widget = $(template);
- return this.$widget;
- }
-}
-
-module.exports = new MyWidget();</code></pre>
-<p>After making this change, reload Trilium. You should now see a button
- in the top-left corner of the left pane.</p>
-<h3>Step 3: Styling the Widget</h3>
-<p>To make the button more visually appealing and position it correctly,
- we'll apply some custom styling. Trilium includes <a href="https://boxicons.com">Box Icons</a>,
- which we'll use to replace the button text with an icon. For example the <span
- class="tn-icon bx bxs-magic-wand"></span> <code>bx bxs-magic-wand</code> icon.</p>
-<p>Here's the updated template:</p><pre><code class="language-text-x-trilium-auto">const template = `&lt;div id="my-widget"&gt;&lt;button class="tree-floating-button bx bxs-magic-wand tree-settings-button"&gt;&lt;/button&gt;&lt;/div&gt;`;</code></pre>
-<p>Next, we'll adjust the button's position using CSS:</p><pre><code class="language-text-x-trilium-auto">class MyWidget extends api.BasicWidget {
- get position() { return 1; }
- get parentWidget() { return "left-pane"; }
-
- doRender() {
- this.$widget = $(template);
- this.cssBlock(`#my-widget {
- position: absolute;
- bottom: 40px;
- left: 60px;
- z-index: 1;
- }`);
- return this.$widget;
- }
-}
-
-module.exports = new MyWidget();</code></pre>
-<p>After reloading Trilium, the button should now appear at the bottom left
- of the left pane, alongside other action buttons.</p>
-<h3>Step 4: Adding User Interaction</h3>
-<p>Let’s make the button interactive by showing a message when it’s clicked.
- We'll use the <code>api.showMessage</code> method from the <a href="#root/_help_GLks18SNjxmC">Script API</a>.</p><pre><code class="language-text-x-trilium-auto">class MyWidget extends api.BasicWidget {
- get position() { return 1; }
- get parentWidget() { return "left-pane"; }
-
- doRender() {
- this.$widget = $(template);
- this.cssBlock(`#my-widget {
- position: absolute;
- bottom: 40px;
- left: 60px;
- z-index: 1;
- }`);
- this.$widget.find("button").on("click", () =&gt; api.showMessage("Hello World!"));
- return this.$widget;
- }
-}
-
-module.exports = new MyWidget();</code></pre>
-<p>For the list of possible values for <code>parentWidget()</code>, see&nbsp;<a
- class="reference-link" href="#root/_help_MgibgPcfeuGz">Custom Widgets</a>.&nbsp;</p>
-<p><a href="#root/_help_s8alTXmpFR61">Reload</a> the application one last
- time. When you click the button, a "Hello World!" message should appear,
- confirming that your widget is fully functional.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/Word count widget.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/Word count widget.html
deleted file mode 100644
index dc0c49c3c2..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/Word count widget.html
+++ /dev/null
@@ -1,91 +0,0 @@
-<aside class="admonition tip">
- <p>This widget is also present in new installations in the&nbsp;<a class="reference-link"
- href="#root/_help_6tZeKvSHEUiB">Demo Notes</a>.</p>
-</aside>
-<p>Create a&nbsp;<a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;note
- of type JavaScript (Trilium frontend) and <strong>give it a</strong> <code>#widget</code> <strong>label</strong>.</p><pre><code class="language-text-x-trilium-auto">/*
- * This defines a custom widget which displays number of words and characters in a current text note.
- * To be activated for a given note, add label 'wordCount' to the note, you can also make it inheritable and thus activate it for the whole subtree.
- *
- * See it in action in "Books" and its subtree.
- */
-const TPL = `&lt;div style="padding: 10px; border-top: 1px solid var(--main-border-color); contain: none;"&gt;
- &lt;strong&gt;Word count: &lt;/strong&gt;
- &lt;span class="word-count"&gt;&lt;/span&gt;
-
- &amp;nbsp;
-
- &lt;strong&gt;Character count: &lt;/strong&gt;
- &lt;span class="character-count"&gt;&lt;/span&gt;
-&lt;/div`;
-
-class WordCountWidget extends api.NoteContextAwareWidget {
- get position() { return 100; } // higher value means position towards the bottom/right
-
- get parentWidget() { return 'center-pane'; }
-
- doRender() {
- this.$widget = $(TPL);
- this.$wordCount = this.$widget.find('.word-count');
- this.$characterCount = this.$widget.find('.character-count');
- return this.$widget;
- }
-
- async refreshWithNote(note) {
- if (note.type !== 'text' || !note.hasLabel('wordCount')) {
- // show widget only on text notes and when marked with 'wordCount' label
- this.toggleInt(false); // hide
-
- return;
- }
-
- this.toggleInt(true); // display
-
- const {content} = await note.getNoteComplement();
-
- const text = $(content).text(); // get plain text only
-
- const counts = this.getCounts(text);
-
- this.$wordCount.text(counts.words);
- this.$characterCount.text(counts.characters);
- }
-
- getCounts(text) {
- const chunks = text
- .split(/[\s-+:,/\\]+/)
- .filter(chunk =&gt; chunk !== '');
-
- let words;
-
- if (chunks.length === 1 &amp;&amp; chunks[0] === '') {
- words = 0;
- }
- else {
- words = chunks.length;
- }
-
- const characters = chunks.join('').length;
-
- return {words, characters};
- }
-
- async entitiesReloadedEvent({loadResults}) {
- if (loadResults.isNoteContentReloaded(this.noteId)) {
- this.refresh();
- }
- }
-}
-
-module.exports = new WordCountWidget();</code></pre>
-<p>After you make changes it is necessary to <a href="#root/_help_s8alTXmpFR61">restart Trilium</a> so
- that the layout can be rebuilt.</p>
-<p>The widget only activates on text notes that have the <code>#wordCount</code> label.
- This label can be a <a href="#root/_help_hrZ1D00cLbal">reference link</a> to
- enable the widget for an entire subtree.</p>
-<p>At the bottom of the note you can see the resulting widget:</p>
-<figure
-class="image">
- <img style="aspect-ratio:792/603;" src="Word count widget_image.png" width="792"
- height="603">
-</figure>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/Word count widget_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/Word count widget_image.png
deleted file mode 100644
index 2f1e5e5fd3..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Custom Widgets/Word count widget_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Examples/Downloading responses from Google Forms.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Examples/Downloading responses from Google Forms.html
deleted file mode 100644
index c6911fb883..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Examples/Downloading responses from Google Forms.html
+++ /dev/null
@@ -1,37 +0,0 @@
-<p>This tutorial showcases a basic integration with Google Forms, where we
- are able to download the responses of a form using the “Link to Sheets"
- functionality.</p>
-<p>Note that the link will be publicly accessible to everyone (however the
- link is in a hard-to-guess format such as <code>https://docs.google.com/spreadsheets/d/e/2PACX-1vTA8NU2_eZFhc8TFadCZPreBfvP7un8IHd6J0SchrLLw3ueGmntNZjwRmsH2ZRcp1pJYDAzMz1FmFaj/pub?output=csv</code>).
- Make sure you are not accidentally publishing sensitive information.</p>
-<h2>Obtaining the CSV link</h2>
-<ol>
- <li>Open the Google Forms in a browser.</li>
- <li>Select the “Responses” tab and click on “Link to Sheets”.</li>
- <li>Select “Create a new spreadsheet” and press “Create”.</li>
- <li>In Google Sheets, select File → Share → Publish to web.</li>
- <li>In the “Publish to the web” screen, make sure the “Link” tab is selected
- and instead of “Web page”, select “Comma-separated values (.csv)”.</li>
- <li>Copy the given link which will be used for the upcoming script.</li>
-</ol>
-<h2>Creating the script</h2>
-<p>Create a “JS Frontend” script:</p><pre><code class="language-text-x-trilium-auto">const CSV_URL = "https://docs.google.com/spreadsheets/d/e/2PACX-1vTiwooLV2whjCSVa49dJ99p_G3_qhqHHRqttMjYCJVfLXVdTgUSNJu5K0rpqmaHYF2k7Vofi3o7gW82/pub?output=csv";
-
-async function fetchData() {
- try {
- const response = await fetch(CSV_URL);
- return await response.text();
- } catch (e) {
- api.showError(e.message);
- }
-}
-
-const data = await fetchData();
-console.log(data);
-// Do something with the data.</code></pre>
-<p>Note that the data will be received as a string and there is no library
- to do the CSV parsing for us. To do a very simple parsing of CSV:</p><pre><code class="language-text-x-trilium-auto">const content = data
- .split("\n")
- .slice(1)
- .map((row) =&gt; row.split(","));</code></pre>
-<p>This will return the data as an array of arrays.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Examples/New Task launcher button.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Examples/New Task launcher button.html
deleted file mode 100644
index df140bd7d0..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Examples/New Task launcher button.html
+++ /dev/null
@@ -1,133 +0,0 @@
-<aside class="admonition warning">
- <p>This documentation is outdated, as it refers to using the deprecated <code>addButtonToToolbar</code> API
- which will only create widgets for desktop.</p>
- <p>Instead, a custom launcher widget can be created using the&nbsp;<a class="reference-link"
- href="#root/_help_4Gn3psZKsfSm">Launch Bar Widgets</a>&nbsp;documentation.</p>
-</aside>
-<p>In this example we are going to extend the functionality of&nbsp;<a class="reference-link"
- href="#root/_help_xYjQUYhpbUEW">Task Manager</a>&nbsp;showcase (which comes
- by default with Trilium) by adding a button in the&nbsp;<a class="reference-link"
- href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>&nbsp; (<span class="tn-icon bx bx-task"></span>)
- to create a new task automatically and open it.</p>
-<h2>Creating the note</h2>
-<ol>
- <li>First, create a new&nbsp;<a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;note
- type with the <em>JavaScript (Trilium frontend)</em> language.</li>
- <li>Define the <code>#run=frontendStartup</code> label in&nbsp;<a class="reference-link"
- href="#root/_help_zEY4DaJG4YT5">Attributes</a>.</li>
-</ol>
-<h2>Content of the script</h2>
-<p>Copy-paste the following script:</p><pre><code class="language-text-javascript">api.addButtonToToolbar({
- title: "New task",
- icon: "task",
- shortcut: "alt+n",
- action: async () =&gt; {
- const taskNoteId = await api.runOnBackend(() =&gt; {
- const todoRootNote = api.getNoteWithLabel("taskTodoRoot");
- const resp = api.createTextNote(todoRootNote.noteId, "New task", "")
- return resp.note.noteId;
- });
-
- await api.waitUntilSynced();
- await api.activateNewNote(taskNoteId);
- }
-});</code></pre>
-<h2>Testing the functionality</h2>
-<p>Since we set the script to be run on start-up, all we need to do is to <a
- href="#root/_help_s8alTXmpFR61">refresh the application</a>.</p>
-<h2>Understanding how the script works</h2>
-<figure class="table">
- <table class="ck-table-resized">
- <colgroup>
- <col style="width:50%;">
- <col style="width:50%;">
- </colgroup>
- <tbody>
- <tr>
- <td><pre><code class="language-text-x-trilium-auto">api.addButtonToToolbar({
- title: "New task",
- icon: "task",
- shortcut: "alt+n",
- action: async () =&gt; {
- // [...]
- }
-});</code></pre>
- </td>
- <td>
- <p>This uses the <a href="#root/_help_yIhgI5H7A2Sm">Front-end API</a> to create
- a icon in the&nbsp;<a class="reference-link" href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>,
- by specifying:</p>
- <ul>
- <li>A title</li>
- <li>A corresponding boxicons icon (without the <code>bx-</code> prefix).</li>
- <li>Optionally, a keyboard shortcut to assign to it.</li>
- <li>The action, which will be executed when the button is pressed.</li>
- </ul>
- </td>
- </tr>
- <tr>
- <td><pre><code class="language-text-x-trilium-auto">const taskNoteId = await api.runOnBackend(() =&gt; {
- // Shown below.
- return resp.note.noteId;
-});</code></pre>
- </td>
- <td>
- <ul>
- <li>This portion of code is actually executed on the server (backend) and
- not on the client (i.e. browser).
- <ul>
- <li>The reason is that the creating notes is the responsibility of the server.</li>
- </ul>
- </li>
- <li>Here we can also see that it is possible to return results from the server
- execution and read them in the client (<code>taskNoteId</code>).</li>
- </ul>
- </td>
- </tr>
- <tr>
- <td><pre><code class="language-text-x-trilium-auto">const todoRootNote = api.getNoteWithLabel("taskTodoRoot");</code></pre>
- </td>
- <td>
- <ul>
- <li>Here we identify a note with the <a href="#root/_help_zEY4DaJG4YT5">label</a> <code>#taskTodoRoot</code>.
- This is how the&nbsp;<a class="reference-link" href="#root/_help_xYjQUYhpbUEW">Task Manager</a>&nbsp;showcase
- knows where to place all the different tasks.</li>
- <li>Normally this might return a <code>null</code> value if no such note could
- be identified, but error handling is outside the scope of this example.&nbsp;</li>
- </ul>
- </td>
- </tr>
- <tr>
- <td><pre><code class="language-text-x-trilium-auto">const resp = api.createTextNote(todoRootNote.noteId, "New task", "")</code></pre>
- </td>
- <td>
- <ul>
- <li>We create a new child note within the to-do root note (first argument)
- with the title “New task" (second argument) and no content by default (third
- argument).</li>
- </ul>
- </td>
- </tr>
- <tr>
- <td><pre><code class="language-text-x-trilium-auto">await api.waitUntilSynced();</code></pre>
- </td>
- <td>
- <ul>
- <li>Back on the client, since we created a new note on the server, we now
- need to wait for the change to be reflected in the client.</li>
- </ul>
- </td>
- </tr>
- <tr>
- <td><pre><code class="language-text-x-trilium-auto">await api.activateNewNote(taskNoteId);</code></pre>
- </td>
- <td>
- <ul>
- <li>Since we know the <a href="#root/_help_m1lbrzyKDaRB">ID</a> of the newly
- created note, all we have to do now is to show this note to the user.</li>
- </ul>
- </td>
- </tr>
- </tbody>
- </table>
-</figure>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Examples/Using promoted attributes to configure scripts.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Examples/Using promoted attributes to configure scripts.html
deleted file mode 100644
index 5c86155b4b..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Examples/Using promoted attributes to configure scripts.html
+++ /dev/null
@@ -1,40 +0,0 @@
-<p>A good use case of promoted attributes is to easily define the various
- parameters a script might need, for example an input and output note if
- it's processing data, or a checkbox to define a particular change in behavior
- for the script.</p>
-<p>
- <img src="Using promoted attributes to configure scripts_image.png">
-</p>
-<h2>Using check boxes to toggle flags</h2>
-<p>Instead of asking the user to modify a boolean value in the script, it's
- much more intuitive to use a checkbox for it as a promoted attribute.</p>
-<p>To do so, first define the promoted attribute:</p><pre><code class="language-text-x-trilium-auto">#label:groupByExtension="promoted,alias=Group by extension,single,boolean"</code></pre>
-<p>Then use it:</p><pre><code class="language-text-javascript">const byExtension = api.currentNote.getLabelValue("groupByExtension") === "true";
-if (byExtension) {
- // Do something.
-}</code></pre>
-<p>This will work equally well in both front-end and back-end scripts.</p>
-<h2>Using relations to select notes</h2>
-<p>One common use case for a script is to read data from another note and
- perhaps output its result in another note. To do so we need to define the
- following promoted attributes:</p><pre><code class="language-text-x-trilium-auto">#relation:input="promoted,alias=Input,single" #relation:output="promoted,alias=Output,single"</code></pre>
-<p>Once we have this, we can add some basic error handling to ensure that
- the fields are completed by the user:</p><pre><code class="language-text-javascript">const inputNoteId = api.currentNote.getRelationValue("input");
-if (!inputNoteId) {
- api.showError("Missing input.");
- return;
-}
-
-const outputNoteId = api.currentNote.getRelationValue("output");
-if (!outputNoteId) {
- api.showError("Missing output.");
- return;
-}</code></pre>
-<p>Note that here we are using <code>api.showError</code> which is only available
- for frontend notes. If you are writing a backend note, simply remove <code>api.showError</code> but
- the user will no feedback on why the script did not execute properly.</p>
-<p>Afterwards we can simply read the note and do something with it:</p><pre><code class="language-text-javascript">const note = api.getNote(inputNoteId);
-if (!note) {
- return;
-}
-const content = note.getContent().toString("utf-8");</code></pre>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Examples/Using promoted attributes to configure scripts_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Examples/Using promoted attributes to configure scripts_image.png
deleted file mode 100644
index a260503562..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Examples/Using promoted attributes to configure scripts_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Frontend Events.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Frontend Events.html
deleted file mode 100644
index 2f84216e2d..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Frontend Events.html
+++ /dev/null
@@ -1,21 +0,0 @@
-<p>Front-end scripts can be run automatically on certain triggering conditions.</p>
-<p>To do so, set the <code>run</code> <a href="#root/_help_HI6GBBIduIgv">label</a> to
- either:</p>
-<ul>
- <li><code>frontendStartup</code> - when Trilium frontend starts up (or is refreshed),
- but not on mobile.</li>
- <li><code>mobileStartup</code> - when Trilium frontend starts up (or is refreshed),
- on mobile.</li>
-</ul>
-<aside class="admonition note">
- <p>One script can be triggered on multiple events, this can be done by adding
- multiple <code>run</code> labels. Separating multiple values by commas <strong>is not</strong> supported.</p>
-</aside>
-<p>Backend scripts have more powerful triggering conditions, for example
- they can run automatically on a hourly or daily basis, but also on events
- such as when a note is created or an attribute is modified. See the server-side&nbsp;<a
- class="reference-link" href="#root/_help_GPERMystNGTB">Events</a>&nbsp;for
- more information.</p>
-<h2>Safe mode</h2>
-<p>While <a href="#root/_help_64ZTlUPgEPtW">safe mode</a> is active, scripts
- with events won't trigger.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Launch Bar Widgets.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Launch Bar Widgets.html
deleted file mode 100644
index fd0c88654e..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Launch Bar Widgets.html
+++ /dev/null
@@ -1,37 +0,0 @@
-<p>Launch bar widgets are a subset of&nbsp;<a class="reference-link" href="#root/_help_MgibgPcfeuGz">Custom Widgets</a>&nbsp;that
- can be used to render custom buttons and widgets inside the&nbsp;<a class="reference-link"
- href="#root/_help_xYmIYSP6wE3F">Launch Bar</a>.</p>
-<h2>Creating a launch bar widget for the desktop layout</h2>
-<p>Unlike&nbsp;<a class="reference-link" href="#root/_help_MgibgPcfeuGz">Custom Widgets</a>,
- the process of setting up a launch bar widget is slightly different:</p>
-<ol>
- <li>Create a Code note of type <em>JavaScript (front-end)</em> or JSX (for Preact-based
- widgets).
- <ul>
- <li>The script itself uses the same concepts as&nbsp;<a class="reference-link"
- href="#root/_help_MgibgPcfeuGz">Custom Widgets</a>, including the use of
- a <code>NoteContextAwareWidget</code> or a <code>BasicWidget</code> (according
- to needs).</li>
- <li>As examples in both legacy and Preact format, see&nbsp;<a class="reference-link"
- href="#root/_help_IPArqVfDQ4We">Note Title Widget</a>&nbsp;and&nbsp;<a
- class="reference-link" href="#root/_help_gcI7RPbaNSh3">Analog Watch</a>.</li>
- </ul>
- </li>
- <li>Don't set <code>#widget</code>, as that attribute is reserved for&nbsp;<a
- class="reference-link" href="#root/_help_MgibgPcfeuGz">Custom Widgets</a>.</li>
- <li>In the&nbsp;<a class="reference-link" href="#root/_help_x3i7MxGccDuM">Global menu</a>,
- select <em>Configure launchbar</em>.</li>
- <li>In the <em>Visible Launchers</em> section, select <em>Add a custom widget</em>.</li>
- <li>Give the newly created launcher a name (and optionally a name).</li>
- <li>In the&nbsp;<a class="reference-link" href="#root/_help_OFXdgB2nNk1F">Promoted Attributes</a>&nbsp;section,
- modify the <em>widget</em> field to point to the newly created note.</li>
- <li><a href="#root/_help_s8alTXmpFR61">Refresh</a> the UI.</li>
-</ol>
-<h2>Mobile layout</h2>
-<p>Custom launch bar widgets are also supported on the&nbsp;<a class="reference-link"
- href="#root/_help_RDslemsQ6gCp">Mobile Frontend</a>. To do so:</p>
-<ol>
- <li>Go to&nbsp;<a class="reference-link" href="#root/_help_x3i7MxGccDuM">Global menu</a>&nbsp;→ <em>Advanced</em> → <em>Show Hidden Subtree</em>.</li>
- <li>Look for <em>Mobile Launch Bar</em> and follow the same creation mechanism
- as in the previous section.</li>
-</ol>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Launch Bar Widgets/Analog Watch.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Launch Bar Widgets/Analog Watch.html
deleted file mode 100644
index db3b084a5f..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Launch Bar Widgets/Analog Watch.html
+++ /dev/null
@@ -1,84 +0,0 @@
-<figure class="image">
- <img style="aspect-ratio:1007/94;" src="Analog Watch_image.png" width="1007"
- height="94">
-</figure>
-<p>This is a more intricate example of a basic widget, which displays an
- analog watch in the launch bar. Unlike note-context aware widgets, basic
- widgets don't react to note navigation.</p><pre><code class="language-text-javascript">const TPL = `
-&lt;div class="analog-watch" style="
- position: relative;
- height: 38px;
- width: 38px;
- border-radius: 50%;
- background: white;
- border: 2px solid #444;
- flex-shrink: 0;
-"&gt;
- &lt;!-- hour hand --&gt;
- &lt;div class="hand hour" style="
- position: absolute;
- left: 50%;
- top: 50%;
- width: 3px;
- height: 10px;
- background: #333;
- transform-origin: bottom center;
- "&gt;&lt;/div&gt;
-
- &lt;!-- minute hand --&gt;
- &lt;div class="hand minute" style="
- position: absolute;
- left: 50%;
- top: 50%;
- width: 2px;
- height: 13px;
- background: #111;
- transform-origin: bottom center;
- "&gt;&lt;/div&gt;
-
- &lt;!-- second hand --&gt;
- &lt;div class="hand second" style="
- position: absolute;
- left: 50%;
- top: 50%;
- width: 1px;
- height: 15px;
- background: red;
- transform-origin: bottom center;
- "&gt;&lt;/div&gt;
-&lt;/div&gt;
-`;
-
-class AnalogWatchWidget extends api.BasicWidget {
- doRender() {
- this.$widget = $(TPL);
-
- const hourHand = this.$widget.find('.hand.hour')[0];
- const minuteHand = this.$widget.find('.hand.minute')[0];
- const secondHand = this.$widget.find('.hand.second')[0];
-
- const update = () =&gt; {
- const now = new Date();
- const sec = now.getSeconds();
- const min = now.getMinutes();
- const hour = now.getHours();
-
- const secDeg = sec * 6;
- const minDeg = min * 6 + sec * 0.1;
- const hourDeg = (hour % 12) * 30 + min * 0.5;
-
- secondHand.style.transform = `translate(-50%, -100%) rotate(${secDeg}deg)`;
- minuteHand.style.transform = `translate(-50%, -100%) rotate(${minDeg}deg)`;
- hourHand.style.transform = `translate(-50%, -100%) rotate(${hourDeg}deg)`;
- };
-
- update();
- this._interval = setInterval(update, 1000);
- }
-
- cleanup() {
- if (this._interval) clearInterval(this._interval);
- }
-}
-
-module.exports = new AnalogWatchWidget();</code></pre>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Launch Bar Widgets/Analog Watch_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Launch Bar Widgets/Analog Watch_image.png
deleted file mode 100644
index 809488185c..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Launch Bar Widgets/Analog Watch_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Launch Bar Widgets/Note Title Widget.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Launch Bar Widgets/Note Title Widget.html
deleted file mode 100644
index 079a4521f6..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Launch Bar Widgets/Note Title Widget.html
+++ /dev/null
@@ -1,57 +0,0 @@
-<figure class="image">
- <img style="aspect-ratio:1007/94;" src="Note Title Widget_image.png" width="1007"
- height="94">
-</figure>
-<p>This is an example of a note context-aware widget, which reacts to the
- currently opened note and refreshes automatically as the user navigates
- through the notes.</p>
-<p>In this example, the title of the note is displayed. It works best on
- the <a href="#root/_help_x0JgW8UqGXvq">horizontal layout</a>.</p>
-<div class="trilium-tabs">
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-react"></span>&nbsp;Preact</p>
- <div class="trilium-tab-panel"><pre><code class="language-text-x-trilium-auto">import { defineLauncherWidget, useActiveNoteContext } from "trilium:preact";
-
-export default defineLauncherWidget({
- render: () =&gt; {
- const { note } = useActiveNoteContext();
- return &lt;div style={{
- display: "flex",
- height: "53px",
- width: "fit-content",
- fontSize: "0.75em",
- alignItems: "center",
- flexShrink: 0
- }}&gt;{note?.title}&lt;/div&gt;;
- }
-});</code></pre>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-javascript"></span>&nbsp;Legacy</p>
- <div class="trilium-tab-panel"><pre><code class="language-text-javascript">const TPL = `\
-&lt;div style="
- display: flex;
- height: 53px;
- width: fit-content;
- font-size: 0.75em;
- contain: none;
- align-items: center;
- flex-shrink: 0;
- padding: 0 1em;
-"&gt;&lt;/div&gt;`;
-
-class NoteTitleWidget extends api.NoteContextAwareWidget {
- doRender() {
- this.$widget = $(TPL);
- }
-
- async refreshWithNote(note) {
- this.$widget.text(note.title);
- }
-}
-
-module.exports = new NoteTitleWidget();</code></pre>
- </div>
- </section>
-</div>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Launch Bar Widgets/Note Title Widget_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Launch Bar Widgets/Note Title Widget_image.png
deleted file mode 100644
index 6320bd8f17..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Launch Bar Widgets/Note Title Widget_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Preact.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Preact.html
deleted file mode 100644
index da9d4bbe28..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Preact.html
+++ /dev/null
@@ -1,60 +0,0 @@
-<p>Since v0.101.0, Trilium integrates Preact for front-end scripting, including
- support for JSX.</p>
-<p>Preact can be used for:</p>
-<ul>
- <li><a class="reference-link" href="#root/_help_HcABDtFCkbFN">Render Note</a>,
- where a JSX code note is used instead of a HTML one.</li>
- <li><a class="reference-link" href="#root/_help_MgibgPcfeuGz">Custom Widgets</a>,
- where JSX can be used to replace the old, jQuery-based mechanism.</li>
-</ul>
-<p>To get started, the first step is to enable JSX in the list of Code languages.
- Go to Options → Code Notes and check the “JSX” language. Afterwards, proceed
- with the documentation in either&nbsp;<a class="reference-link" href="#root/_help_HcABDtFCkbFN">Render Note</a>&nbsp;or&nbsp;<a
- class="reference-link" href="#root/_help_MgibgPcfeuGz">Custom Widgets</a>,
- which will both have a section on how to use the new Preact integration.</p>
-<aside
-class="admonition important">
- <p>The documentation assumes prior knowledge with React or Preact. As a starting
- point, consider the <a href="https://www.freecodecamp.org/learn/front-end-development-libraries-v9/">FreeCodeCamp course on Front End Development Libraries</a> or
- the <a href="https://preactjs.com/tutorial/">Preact Tutorial</a>.</p>
-</aside>
-<h2>Import/exports</h2>
-<p>When using Preact with JSX, there is a special syntax which provides ES-like
- imports. This <code>import</code> syntax makes way for a more intuitive that
- doesn't make use of global objects and paves the way for better auto-completion
- support that might be introduced in the future.&nbsp;</p>
-<h3>API imports</h3>
-<p>Instead of:</p><pre><code class="language-text-jsx">api.showMessage("Hello");</code></pre>
-<p>the JSX version looks like this:</p><pre><code class="language-text-jsx">import { showMessage } from "trilium:api";
-showMessage("hello");</code></pre>
-<h3>Preact API imports (hooks, components)</h3>
-<p>There's a new&nbsp;<a class="reference-link" href="#root/_help_GLks18SNjxmC">Script API</a>&nbsp;dedicated
- to Preact, which provides shared components that are also used by Trilium
- internally as well as hooks, for example.</p><pre><code class="language-text-jsx">import { useState } from "trilium:preact";
-const [ myState, setMyState ] = useState("Hi");</code></pre>
-<h3>Exporting</h3>
-<p>JSX notes can export a component for use in&nbsp;<a class="reference-link"
- href="#root/_help_HcABDtFCkbFN">Render Note</a>&nbsp;or for&nbsp;<a class="reference-link"
- href="#root/_help_Bqde6BvPo05g">Component libraries</a>: </p><pre><code class="language-text-jsx">export default function() {
- return (
- &lt;&gt;
- &lt;p&gt;Hello world.&lt;/p&gt;
- &lt;/&gt;
- );
-}</code></pre>
-<h3>Import/export are not required</h3>
-<p>These imports are syntactic sugar meant to replace the usage for the <code>api</code> global
- object (see&nbsp;<a class="reference-link" href="#root/_help_GLks18SNjxmC">Script API</a>).&nbsp;</p>
-<aside
-class="admonition note">
- <p>The <code>import</code> and <code>export</code> syntax work only for JSX notes.
- Standard/jQuery code notes still need to use the <code>api</code> global
- and <code>module.exports</code>.</p>
-</aside>
-<h2>Under the hood</h2>
-<p>Unlike JavaScript, JSX requires pre-processing to turn it into JavaScript
- (just like TypeScript). To do so, Trilium uses <a href="https://github.com/alangpierce/sucrase">Sucrase</a>,
- a JavaScript library which processes the JSX to pure JavaScript. The processing
- is done each time a script is run (for widgets this happens at every program
- startup). If you notice any performance degradation due to long compilation,
- consider <a href="#root/_help_wy8So3yZZlH9">reporting the issue</a> to us.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Preact/Built-in components.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Preact/Built-in components.html
deleted file mode 100644
index 4814a9ded3..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Preact/Built-in components.html
+++ /dev/null
@@ -1,41 +0,0 @@
-<figure class="image image_resized" style="width:54.58%;">
- <img style="aspect-ratio:896/712;" src="Built-in components_image.png"
- width="896" height="712">
- <figcaption>A partial screenshot from the Widget showcase example (see below).</figcaption>
-</figure>
-<p>Trilium comes with its own set of Preact components, some of which are
- also available to&nbsp;<a class="reference-link" href="#root/_help_MgibgPcfeuGz">Custom Widgets</a>&nbsp;and&nbsp;<a
- class="reference-link" href="#root/_help_HcABDtFCkbFN">Render Note</a>.</p>
-<p>To use these components, simply import them from <code>trilium:preact</code>:</p><pre><code class="language-text-jsx">import { ActionButton, Button, LinkButton } from "trilium:preact";</code></pre>
-<p>and then use them:</p><pre><code class="language-text-jsx">export default function MyRenderNote() {
- const onClick = () =&gt; showMessage("A button was pressed");
-
- return (
- &lt;&gt;
- &lt;h2&gt;Buttons&lt;/h2&gt;
- &lt;div style={{ display: "flex", gap: "1em", alignItems: "center" }}&gt;
- &lt;ActionButton icon="bx bx-rocket" text="Action button" onClick={onClick} /&gt;
- &lt;Button icon="bx bx-rocket" text="Simple button" onClick={onClick} /&gt;
- &lt;LinkButton text="Link button" onClick={onClick} /&gt;
- &lt;/div&gt;
- &lt;/&gt;
- )
-}</code></pre>
-<h2>Widget showcase</h2>
-<aside class="admonition tip">
- <p>Starting with v0.101.0, the widget showcase is also available in the&nbsp;<a
- class="reference-link" href="#root/_help_6tZeKvSHEUiB">Demo Notes</a>.</p>
-</aside>
-<p>This is a&nbsp;<a class="reference-link" href="#root/_help_HcABDtFCkbFN">Render Note</a>&nbsp;example
- with JSX that shows most of the built-in components that are accessible
- to custom widgets and JSX render notes.</p>
-<p>To use it, simply:</p>
-<ol>
- <li>Create a render note.</li>
- <li>Create a child code note of JSX type with the content of this file:&nbsp;<a
- class="reference-link" href="#root/_help_i9B4IW7b6V6z">Widget showcase</a>
- </li>
- <li>Set the <code>~renderNote</code> relation of the parent note to the child
- note.</li>
- <li>Refresh the render note to see the results.</li>
-</ol>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Preact/Built-in components/Widget showcase.jsx b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Preact/Built-in components/Widget showcase.jsx
deleted file mode 100644
index 934707a34e..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Preact/Built-in components/Widget showcase.jsx
+++ /dev/null
@@ -1,220 +0,0 @@
-import {
- ActionButton, Button, LinkButton,
- Admonition, Collapsible,
- FormCheckbox, FormDropdownList, FormFileUploadButton, FormGroup, FormRadioGroup, FormTextArea,
- FormTextBox, FormToggle, Slider, RawHtml, LoadingSpinner, Icon,
- ColorPicker,
- Dropdown, FormListItem, FormDropdownDivider, FormDropdownSubmenu,
- NoteAutocomplete, NoteLink, Modal,
- Table,
- CKEditor,
- useEffect, useState
-} from "trilium:preact";
-import { showMessage } from "trilium:api";
-
-export default function() {
- const [ time, setTime ] = useState();
- const lorem = "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aliquam accumsan eu odio non gravida. Pellentesque ornare, arcu condimentum molestie dignissim, nibh turpis ultrices elit, eget elementum nunc erat at erat. Maecenas vehicula consectetur elit, nec fermentum elit venenatis eu.";
- useEffect(() => {
- const interval = setInterval(() => setTime(new Date().toLocaleString()), 1000);
- return () => clearInterval(interval);
- }, []);
-
- return (
- <div style={{ padding: 20, display: "flex", flexDirection: "column", gap: "1em" }}>
- <h1>Widget showcase</h1>
-
- <Buttons />
- <Admonition type="note">
- <strong>Admonition</strong><br />
- {lorem}
- </Admonition>
-
- <Collapsible title="Collapsible" initiallyExpanded>
- {lorem}
- </Collapsible>
-
- <FormElements />
- <NoteElements />
- <ModalSample />
- <DropdownSample />
- <CollectionViews />
- </div>
- );
-}
-
-function Buttons() {
- const onClick = () => showMessage("A button was pressed");
-
- return (
- <>
- <h2>Buttons</h2>
- <div style={{ display: "flex", gap: "1em", alignItems: "center" }}>
- <ActionButton icon="bx bx-rocket" text="Action button" onClick={onClick} />
- <Button icon="bx bx-rocket" text="Simple button" onClick={onClick} />
- <LinkButton text="Link button" onClick={onClick} />
- </div>
- </>
- )
-}
-
-function FormElements() {
- const [ checkboxChecked, setCheckboxChecked ] = useState(false);
- const [ dropdownValue, setDropdownValue ] = useState("key-1");
- const [ radioGroupValue, setRadioGroupValue ] = useState("key-1");
- const [ sliderValue, setSliderValue ] = useState(50);
- const [ color, setColor ] = useState("#43a047");
-
- return (
- <>
- <h2>Form elements</h2>
- <div style={{ display: "grid", gridTemplateColumns: "1fr 1fr 1fr", gap: "1em" }}>
- <FormGroup name="checkbox" label="Checkbox">
- <FormCheckbox label="Checkbox" currentValue={checkboxChecked} onChange={setCheckboxChecked} />
- </FormGroup>
- <FormGroup name="toggle" label="Toggle">
- <FormToggle switchOnName="Off" switchOffName="On" currentValue={checkboxChecked} onChange={setCheckboxChecked} />
- </FormGroup>
- <FormGroup name="dropdown" label="Dropdown">
- <FormDropdownList
- values={[
- { key: "key-1", name: "First item" },
- { key: "key-2", name: "Second item" },
- { key: "key-3", name: "Third item" },
- ]}
- currentValue={dropdownValue} onChange={setDropdownValue}
- keyProperty="key" titleProperty="name"
- />
- </FormGroup>
- <FormGroup name="radio-group" label="Radio group">
- <FormRadioGroup
- values={[
- { value: "key-1", label: "First item" },
- { value: "key-2", label: "Second item" },
- { value: "key-3", label: "Third item" },
- ]}
- currentValue={radioGroupValue} onChange={setRadioGroupValue}
- />
- </FormGroup>
- <FormGroup name="text-box" label="Text box">
- <FormTextBox
- placeholder="Type something..."
- currentValue="" onChange={(newValue) => {}}
- />
- </FormGroup>
- <FormGroup name="text-area" label="Text area">
- <FormTextArea
- placeholder="Type something bigger..."
- currentValue="" onChange={(newValue) => {}}
- />
- </FormGroup>
- <FormGroup name="color-picker" label="Color picker">
- <ColorPicker currentValue={color} onChange={setColor} />
- </FormGroup>
- <FormGroup name="slider" label="Slider">
- <Slider
- min={1} max={100}
- value={sliderValue} onChange={setSliderValue}
- />
- </FormGroup>
- <FormGroup name="file-upload" label="File upload">
- <FormFileUploadButton
- text="Upload"
- onChange={(files) => {
- const file = files?.[0];
- if (!file) return;
- showMessage(`Got file "${file.name}" of size ${file.size} B and type ${file.type}.`);
- }}
- />
- </FormGroup>
- <FormGroup name="icon" label="Icon">
- <Icon icon="bx bx-smile" />
- </FormGroup>
- <FormGroup name="loading-spinner" label="Loading spinner">
- <LoadingSpinner />
- </FormGroup>
- <FormGroup name="raw-html" label="Raw HTML">
- <RawHtml html="<strong>Hi</strong> <em>there</em>" />
- </FormGroup>
- </div>
- </>
- )
-}
-
-function NoteElements() {
- const [ noteId, setNoteId ] = useState("");
-
- return (
- <div>
- <h2>Note elements</h2>
-
- <FormGroup name="note-autocomplete" label="Note autocomplete">
- <NoteAutocomplete
- placeholder="Select a note"
- noteId={noteId} noteIdChanged={setNoteId}
- />
- </FormGroup>
-
- <FormGroup name="note-link" label="Note link">
- {noteId
- ? <NoteLink notePath={noteId} showNoteIcon />
- : <span>Select a note first</span>}
- </FormGroup>
- </div>
- );
-}
-
-function ModalSample() {
- const [ shown, setShown ] = useState(false);
-
- return (
- <>
- <h2>Modal</h2>
- <Button text="Open modal" onClick={() => setShown(true)} />
- <Modal title="Modal title" size="md" show={shown} onHidden={() => setShown(false)}>
- Modal goes here.
- </Modal>
- </>
- )
-}
-
-function DropdownSample() {
- return (
- <>
- <h2>Dropdown menu</h2>
- <Dropdown text="Dropdown" hideToggleArrow>
- <FormListItem icon="bx bx-cut">Cut</FormListItem>
- <FormListItem icon="bx bx-copy">Copy</FormListItem>
- <FormListItem icon="bx bx-paste">Paste</FormListItem>
- <FormDropdownDivider />
- <FormDropdownSubmenu title="Submenu">
- <FormListItem>More items</FormListItem>
- </FormDropdownSubmenu>
- </Dropdown>
- </>
- )
-}
-
-function CollectionViews() {
- return (
- <>
- <h2>Collection views</h2>
- <p>
- A generic <code>Table</code> (Tabulator) is available. A <code>Calendar</code>
- {" "}(FullCalendar) component is also exposed, but it requires you to pass a
- {" "}<code>plugins</code> array to render a view, so it is not demonstrated here.
- </p>
- <Table
- layout="fitColumns"
- columns={[
- { title: "Name", field: "name" },
- { title: "Progress", field: "progress" }
- ]}
- data={[
- { id: 1, name: "First task", progress: "80%" },
- { id: 2, name: "Second task", progress: "20%" }
- ]}
- />
- </>
- )
-}
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Preact/Built-in components_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Preact/Built-in components_image.png
deleted file mode 100644
index cf59bbefd0..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Preact/Built-in components_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Preact/CSS.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Preact/CSS.html
deleted file mode 100644
index 6f623f07bd..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Preact/CSS.html
+++ /dev/null
@@ -1,12 +0,0 @@
-<h2>Inline styles</h2><pre><code class="language-text-jsx">&lt;div style={{
- display: "flex",
- height: "53px",
- width: "fit-content",
- fontSize: "0.75em",
- alignItems: "center",
- flexShrink: 0
-}}&gt;/* [...] */&lt;/div&gt;</code></pre>
-<h2>Custom CSS file</h2>
-<p>Simply create a&nbsp;<a class="reference-link" href="#root/_help_AlhDUqhENtH7">Custom app-wide CSS</a>.
- Make sure the class names are unique enough to not intersect with other
- UI elements, consider adding a prefix (e.g. <code>x-mywidget-</code>).</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Preact/Component libraries.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Preact/Component libraries.html
deleted file mode 100644
index b9ff602eca..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Preact/Component libraries.html
+++ /dev/null
@@ -1,54 +0,0 @@
-<p>Using the concept of&nbsp;<a class="reference-link" href="#root/_help_hA834UaHhSNn">Script bundles</a>,
- it's possible to create components that are shared for multiple widgets
- or&nbsp;<a class="reference-link" href="#root/_help_HcABDtFCkbFN">Render Note</a>.</p>
-<h2>Exporting a single component</h2>
-<p>This is generally useful for big components.</p>
-<p>Here's an example child hierarchy using&nbsp;<a class="reference-link"
- href="#root/_help_HcABDtFCkbFN">Render Note</a>: </p>
-<ul>
- <li><em>My render note</em>
- <br>Note type: Render Note
- <br>Link <code>~renderNote</code> to the child note (<em>Render note with subcomponents</em>)
- <ul>
- <li>
- <p><em>Render note with subcomponents</em>
- <br>Type: JSX</p><pre><code class="language-text-jsx">export default function() {
- return (
- &lt;MyComponent /&gt;
- );
-}</code></pre>
- <ul>
- <li>
- <p><em>MyComponent</em>
- <br>Type: Code / JSX</p><pre><code class="language-text-jsx">export default function MyComponent() {
- return &lt;p&gt;Hi&lt;/p&gt;;
-}</code></pre>
- </li>
- </ul>
- </li>
- </ul>
- </li>
-</ul>
-<h2>Multiple components per note</h2>
-<p>To export multiple components, use the <code>export</code> keyword next
- to each of the function components.</p>
-<p>Here's how a sub-note called <code>MyComponents</code> would look like:</p><pre><code class="language-text-jsx">export function MyFirstComponent() {
- return &lt;p&gt;First&lt;/p&gt;;
-}
-
-export function MySecondComponent() {
- return &lt;p&gt;Bar&lt;/p&gt;;
-}</code></pre>
-<p>Then in its parent note:</p><pre><code class="language-text-jsx">const { MyFirstComponent, MySecondComponent } = MyComponents;
-
-export default function() {
- return (
- &lt;&gt;
- &lt;MyFirstComponent /&gt;
- &lt;MySecondComponent /&gt;
- &lt;/&gt;
- );
-}</code></pre>
-<p>Alternatively, it's also possible to use the components directly without
- assigning them to a <code>const</code> first:</p><pre><code class="language-text-jsx">&lt;MyComponents.MyFirstComponent /&gt;
-&lt;MyComponents.MySecondComponent /&gt;</code></pre>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Preact/Hooks.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Preact/Hooks.html
deleted file mode 100644
index 957719addc..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Frontend Basics/Preact/Hooks.html
+++ /dev/null
@@ -1,33 +0,0 @@
-<h2>Standard Preact hooks</h2>
-<p>All standard Preact hooks are available as an import in <code>trilium:api</code>.</p>
-<p>For example:</p><pre><code class="language-text-jsx">import { useState } from "trilium:preact";
-const [ myState, setMyState ] = useState("Hi");</code></pre>
-<h2>Custom hooks</h2>
-<p>Trilium comes with a large set of custom hooks for Preact, all of which
- are also available to custom widgets and&nbsp;<a class="reference-link"
- href="#root/_help_HcABDtFCkbFN">Render Note</a>.</p>
-<h3><code>useNoteContext</code></h3>
-<p>As a replacement to&nbsp;<a class="reference-link" href="#root/_help_GhurYZjh8e1V">Note context aware widget</a>,
- Preact exposes the current note context in the <code>useNoteContext</code> hook:</p><pre><code class="language-text-jsx">import { defineWidget, useNoteContext, useNoteProperty } from "trilium:preact";
-
-export default defineWidget({
- parent: "note-detail-pane",
- position: 10,
- render: () =&gt; {
- const { note } = useNoteContext();
- const title = useNoteProperty(note, "title");
- return &lt;span&gt;Current note JSX: {title}&lt;/span&gt;;
- }
-});</code></pre>
-<p>Note that the custom widget must be inside the content area (so note detail
- widget) for this to work properly, especially when dealing with splits.</p>
-<h3><code>useActiveNoteContext</code></h3>
-<p><code>useActiveNoteContext</code> is an alternative to <code>useNoteContext</code> which
- works even if the widget is not within the note detail section and it automatically
- switches the note context as the user is navigating around between tabs
- and splits.</p>
-<h3><code>useNoteProperty</code></h3>
-<p>This hook allows “listening” for changes to a particular property of a <code>FNote</code>,
- such as the <code>title</code> or <code>type</code> of a note. The benefit
- from using the hook is that it actually reacts to changes, for example
- if the note title or type is changed.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Logging.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Logging.html
deleted file mode 100644
index 341170aec3..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Logging.html
+++ /dev/null
@@ -1,25 +0,0 @@
-<p>Both front-end and back-end notes can log messages for debugging.</p>
-<h2>UI logging via <code>api.log</code></h2>
-<figure class="image image-style-align-center image_resized" style="width:57.74%;">
- <img style="aspect-ratio:749/545;" src="Logging_image.png" width="749"
- height="545">
-</figure>
-<p>The API log feature integrates with the script editor and it displays
- all the messages logged via <code>api.log</code>. This works for both back-end
- and front-end scripts.</p>
-<p>The API log panel will appear at the bottom of a note (including in&nbsp;<a
- class="reference-link" href="#root/_help_ZjLYv08Rp3qC">Quick edit</a>)
- after executing a script that uses <code>api.log</code>. It can be dismissed
- temporarily by pressing the close button in the top-right of the panel.</p>
-<p>Apart from strings, an object can be passed as well in which case it will
- be pretty-formatted if possible (e.g. recursive objects are not supported).</p>
-<h2>Console logging</h2>
-<p>For logs that are not directly visible to the user, the standard <code>console.log</code> can
- be used as well.</p>
-<ul>
- <li>For front-end scripts, the log will be shown in the Developer Tools (also
- known as Inspect).</li>
- <li>For back-end scripts, the log will be shown in the server output while
- running but <strong>will not</strong> be visible in the&nbsp;<a class="reference-link"
- href="#root/_help_bnyigUA2UK7s">Backend (server) logs</a>.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Logging_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Logging_image.png
deleted file mode 100644
index 29933ba172..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Logging_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Script API.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Script API.html
deleted file mode 100644
index e015c02004..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Script API.html
+++ /dev/null
@@ -1,19 +0,0 @@
-<p>For <a href="#root/_help_CdNpE2pqjmI6">script code notes</a>, Trilium offers
- an API that gives them access to various features of the application.</p>
-<p>There are two APIs:</p>
-<ul>
- <li>One for the front-end scripts:&nbsp;<a class="reference-link" href="#root/_help_Q2z6av6JZVWm">Frontend API</a>
- </li>
- <li>One for the back-end scripts:&nbsp;<a class="reference-link" href="#root/_help_MEtfsqa5VwNi">Backend API</a>
- </li>
-</ul>
-<p>In both cases, the API resides in a global variable, <code>api</code>,
- that can be used anywhere in the script.</p>
-<p>For example, to display a message to the user the following front-end
- script can be used:</p><pre><code class="language-text-x-trilium-auto">api.showMessage("Hello world.");</code></pre>
-<aside
-class="admonition note">
- <p><strong>Note</strong>
- <br>The Script API is currently experimental and may undergo changes in future
- updates.</p>
-</aside>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Script API/Backend API.dat b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Script API/Backend API.dat
deleted file mode 100644
index e69de29bb2..0000000000
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Script API/Day.js.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Script API/Day.js.html
deleted file mode 100644
index fb2a26948e..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Script API/Day.js.html
+++ /dev/null
@@ -1,37 +0,0 @@
-<p>Day.js is a date manipulation library that's used by Trilium, but it's
- also shared with both front-end and back-end scripts. For more information
- about the library itself, consult the <a href="https://day.js.org/en/">official documentation</a>.</p>
-<h2>How to use</h2>
-<p>The <code>dayjs</code> method is provided directly in the <code>api</code> global:</p><pre><code class="language-text-javascript">const date = api.dayjs();
-api.log(date.format("YYYY-MM-DD"));</code></pre>
-<h2>Plugins</h2>
-<p>Day.js uses a modular, plugin-based architecture. Generally these plugins
- must be imported, but this process doesn't work inside Trilium scripts
- due to the use of a bundler.</p>
-<p>Since v0.100.0, the same set of plugins is available for both front-end
- and back-end scripts.</p>
-<p>The following Day.js plugins are directly integrated into Trilium:</p>
-<ul>
- <li><a href="https://day.js.org/docs/en/plugin/advanced-format">AdvancedFormat</a>
- </li>
- <li><a href="https://day.js.org/docs/en/plugin/duration">Duration</a>, since
- v0.100.0.</li>
- <li><a href="https://day.js.org/docs/en/plugin/is-between">IsBetween</a>
- </li>
- <li><a href="https://day.js.org/docs/en/plugin/iso-week">IsoWeek</a>
- </li>
- <li><a href="https://day.js.org/docs/en/plugin/is-same-or-after">IsSameOrAfter</a>
- </li>
- <li><a href="https://day.js.org/docs/en/plugin/is-same-or-before">IsSameOrBefore</a>
- </li>
- <li><a href="https://day.js.org/docs/en/plugin/quarter-of-year">QuarterOfYear</a>
- </li>
- <li><a href="https://day.js.org/docs/en/plugin/utc">UTC</a>
- </li>
-</ul>
-<aside class="admonition note">
- <p>If another Day.js plugin might be needed for scripting purposes, feel
- free to open a feature request for it. Depending on the size of the plugin
- and the potential use of it inside the Trilium code base, it has a chance
- of being integrated.</p>
-</aside>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Script API/Electron API.dat b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Script API/Electron API.dat
deleted file mode 100644
index e69de29bb2..0000000000
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Script API/Frontend API/FNote.dat b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Script API/Frontend API/FNote.dat
deleted file mode 100644
index e69de29bb2..0000000000
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Security.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Security.html
deleted file mode 100644
index 80ee80f99c..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Scripting/Security.html
+++ /dev/null
@@ -1,31 +0,0 @@
-<p>Starting with v0.104.0, some features in Trilium are intentionally disabled
- in order to reduce the attack surface:</p>
-<ul>
- <li><a class="reference-link" href="#root/_help_SPirpZypehBG">Backend scripts</a>,
- which can run processes on the server, access the file system or bypass
- security measures.</li>
- <li><a class="reference-link" href="#root/_help_YKWqdJhzi2VY">SQL Console</a>,
- which can be used to exfiltrate important data such as the document secret
- or cause irreparable damage to the database.</li>
- <li><a class="reference-link" href="#root/_help_swSFivWk6KkA">Network Access</a>&nbsp;for
- the&nbsp;<a class="reference-link" href="#root/_help_poXkQfguuA0U">Desktop Installation</a>.</li>
-</ul>
-<p>To activate any of them, there are three variants:</p>
-<ul>
- <li>For the desktop app, go to&nbsp;<a class="reference-link" href="#root/_help_4TIF1oA4VQRO">Options</a>&nbsp;→ <em>Security</em> and
- toggle the desired option.
- <ul>
- <li>This will prompt a system dialog confirming the change. Note that scripts
- could potentially call this confirmation dialog as well, make sure to accept
- it only if enabling any of these features is required.</li>
- <li>The settings page will be available for the server-side as well, but the
- options need to be manually toggled using the other mechanisms described
- here.</li>
- <li>This works by setting a separate configuration file in the&nbsp;<a class="reference-link"
- href="#root/_help_tAassRL4RSQL">Data directory</a>.</li>
- </ul>
- </li>
- <li>In <a href="#root/_help_Gzjqa934BdH4">config.ini</a>, set the corresponding
- option under the <code>Security</code> group.</li>
- <li>Or use environment variables (e.g. <code>TRILIUM_SECURITY_BACKEND_SCRIPTING_ENABLED=true</code>).</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Creating a custom theme.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Creating a custom theme.html
deleted file mode 100644
index 5dd006bad9..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Creating a custom theme.html
+++ /dev/null
@@ -1,62 +0,0 @@
-<h2>Step 1. Find a place to place the themes</h2>
-<p>Organization is an important aspect of managing a knowledge base. When
- developing a new theme or importing an existing one it's a good idea to
- keep them into one place.</p>
-<p>As such, the first step is to create a new note to gather all the themes.</p>
-<p>
- <img src="Creating a custom theme_5_Creating a custom theme_im.png">
-</p>
-<h2>Step 2. Create the theme</h2>
-<figure class="table">
- <table>
- <tbody>
- <tr>
- <td>
- <img src="Creating a custom theme_3_Creating a custom theme_im.png">
- </td>
- <td>Themes are code notes with a special attribute. Start by creating a new
- code note.</td>
- </tr>
- <tr>
- <td>
- <img src="Creating a custom theme_1_Creating a custom theme_im.png">
- </td>
- <td>Then change the note type to a CSS code.</td>
- </tr>
- <tr>
- <td>
- <img src="Creating a custom theme_Creating a custom theme_im.png">
- </td>
- <td>In the attributes of the note (the&nbsp;<span class="tn-icon bx bx-list-check"></span> button
- in the&nbsp;<a class="reference-link" href="#root/_help_AlJ73vBCjWDw">Status bar</a>),
- define the <code>#appTheme</code> attribute to point to any desired name.
- This is the name that will show up in the appearance section in settings.</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<h2>Step 3. Define the theme's CSS</h2>
-<p>As a very simple example we will change the background color of the launcher
- pane to a shade of blue.</p>
-<p>To alter the different variables of the theme:</p><pre><code class="language-text-css">:root {
- --launcher-pane-background-color: #0d6efd;
-}</code></pre>
-<h2>Step 4. Activating the theme</h2>
-<p>Refresh the application (Ctrl+Shift+R is a good way to do so) and go to
- settings. You should see the newly created theme:</p>
-<p>
- <img src="Creating a custom theme_2_Creating a custom theme_im.png">
-</p>
-<p>Afterwards the application will refresh itself with the new theme:</p>
-<p>
- <img src="Creating a custom theme_4_Creating a custom theme_im.png">
-</p>
-<p>Do note that the theme will be based off of the legacy theme. To override
- that and base the theme on the Modern theme, see&nbsp;<a class="reference-link"
- href="#root/_help_WFGzWeUK6arS">Customize the Next theme</a>.</p>
-<h2>Step 5. Making changes</h2>
-<p>Simply go back to the note and change according to needs. To apply the
- changes to the current window, press <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>R</kbd> to
- refresh.</p>
-<p>It's a good idea to keep two windows, one for editing and the other one
- for previewing the changes.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Creating an icon pack.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Creating an icon pack.html
deleted file mode 100644
index 75c7a77fe6..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Creating an icon pack.html
+++ /dev/null
@@ -1,274 +0,0 @@
-<aside class="admonition note">
- <p>This page explains, step‑by‑step, how to create a custom icon pack. For
- a general description of how to use already existing icon packs, see&nbsp;<a
- class="reference-link" href="#root/_help_gOKqSJgXLcIj">Icon Packs</a>.</p>
-</aside>
-<p>First read the quick flow to get the overall steps. After that there is
- a concrete example (Phosphor) with a small Node.js script you can run to
- generate the manifest.</p>
-<h2>Quick flow (what you need to do)</h2>
-<ol>
- <li>Verify the icon set is a font (one of: .woff2, .woff, .ttf).</li>
- <li>Obtain a list that maps icon names to Unicode code points (often provided
- as a JSON like <code>selection.json</code> or a CSS file).</li>
- <li>Create a manifest JSON that maps icon ids to glyphs and search terms.</li>
- <li>Create a Trilium note of type Code, set language to JSON, paste the manifest
- as the note content.</li>
- <li>Upload the font file as an attachment to the same note (MIME type must
- be <code>font/woff2</code>, <code>font/woff</code>, or <code>font/ttf</code> and
- role <code>file</code>).</li>
- <li>Add the label <code>#iconPack=&lt;prefix&gt;</code> to the note (prefix:
- letters, digits, hyphen, underscore and non-ASCII characters only).</li>
- <li>Refresh the client and verify the icon pack appears in the icon selector.</li>
-</ol>
-<h2>Verify the icon set</h2>
-<p>The first step is to analyze if the icon set being packed can be integrated
- into Trilium.</p>
-<p>Trilium only supports <strong>font-based icon sets</strong>, with the following
- formats:</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Extension</th>
- <th>MIME type</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>.woff2</code>
- </td>
- <td><code>font/woff2</code>
- </td>
- <td>Recommended due to great compression (low size).</td>
- </tr>
- <tr>
- <td><code>.woff</code>
- </td>
- <td><code>font/woff</code>
- </td>
- <td>Higher compatibility, but the font file is bigger.</td>
- </tr>
- <tr>
- <td><code>.ttf</code>
- </td>
- <td><code>font/ttf</code>
- </td>
- <td>Most common, but highest font size.</td>
- </tr>
- </tbody>
- </table>
-</figure>
-<p>Trilium <strong>does not</strong> support the following formats:</p>
-<ul>
- <li>SVG-based fonts.</li>
- <li>Individual SVGs.</li>
- <li><code>.eot</code> fonts (legacy and proprietary).</li>
- <li>Duotone icons, since it requires a special CSS format that Trilium doesn't
- support.</li>
- <li>Any other font format not specified in the <em>Supported formats</em> section.</li>
-</ul>
-<p>In this case, the font must be manually converted to one of the supported
- formats (ideally <code>.woff2</code>).</p>
-<h2>Manifest format</h2>
-<p>The manifest is a JSON object with an <code>icons</code> map. Each entry
- key is the CSS/class id you will use (Trilium uses the CSS class when rendering).
- Value object:</p>
-<ul>
- <li>glyph: the single character (the glyph) — can be the escaped Unicode (e.g.
- "\ue9c2") or the literal character.</li>
- <li>terms: array of search aliases; the first term is used as display name
- in the selector.</li>
-</ul>
-<p>Example minimal manifest:</p><pre><code class="language-text-x-trilium-auto">{
- "icons": {
- "ph-acorn": {
- "glyph": "\uea3f",
- "terms": ["acorn", "nut"]
- },
- "ph-book": {
- "glyph": "\uea40",
- "terms": ["book", "read"]
- }
- }
-}</code></pre>
-<aside class="admonition note">
- <ul>
- <li>You can supply glyph as the escaped <code>\uXXXX</code> sequence or as the
- actual UTF‑8 character. The CSS form (<code>\ea3f</code>, as written in
- a stylesheet's <code>content</code>) is accepted too, so glyphs copied out
- of the font's own CSS work as they stand.</li>
- <li>It is also possible to use the unescaped glyph inside the JSON. It will
- appear strange (e.g. ), but it will be rendered properly regardless.</li>
- <li>The manifest keys (e.g. <code>ph-acorn</code>) should match the class names
- used by the font (prefix + name is a common pattern).</li>
- <li>Like the prefix, a manifest key becomes a CSS class name, so it can contain
- only letters, digits, hyphens, underscores and non-ASCII characters. Punctuation
- and whitespace (e.g. <code>ph.acorn</code> or <code>ph acorn</code>) are not
- usable as class names; icons with such a key are skipped and an error is
- logged in&nbsp;<a class="reference-link" href="#root/_help_bnyigUA2UK7s">Backend (server) logs</a>,
- while the rest of the pack still loads.</li>
- </ul>
-</aside>
-<h2>Concrete example: Phosphor Icons</h2>
-<p><a href="https://phosphoricons.com/">Phosphor Icons</a> provide a <code>selection.json</code> that
- includes <code>properties.code</code> (the codepoint) and <code>properties.name</code> (the
- icon name). The goal: convert that into Trilium's manifest.</p>
-<p>Sample <code>selection.json</code> excerpt:</p><pre><code class="language-text-x-trilium-auto">{
- "icons": [
- {
- "icon": {
- "paths": [ /* [...] */ ],
- "grid": 0,
- "attrs": [{}],
- "isMulticolor": false,
- "isMulticolor2": false,
- "tags": ["acorn"]
- },
- "attrs": [{}],
- "properties": {
- "id": 0,
- "order": 1513,
- "name": "acorn",
- "code": 60314,
- "ligatures": "acorn",
- "prevSize": 16
- },
- "setIdx": 0,
- "setId": 0,
- "iconIdx": 0
- },
- /* [...] */
- ]
-}</code></pre>
-<details class="trilium-collapsible" open="">
- <summary>A tiny Node.js script to produce the manifest</summary>
- <p>Place <code>selection.json</code> in the same directory and run with Node
- 20+):</p><pre><code class="language-text-javascript">import { join } from "node:path";
-import { readFileSync, writeFileSync } from "node:fs";
-
-function processIconPack(packName) {
- const path = join(packName);
- const selectionMeta = JSON.parse(readFileSync(join(path, "selection.json"), "utf-8"));
- const icons = {};
-
- for (const icon of selectionMeta.icons) {
- let name = icon.properties.name;
- if (name.endsWith(`-${packName}`)) {
- name = name.split("-").slice(0, -1).join("-");
- }
-
- const id = `ph-${name}`;
- icons[id] = {
- glyph: `${String.fromCharCode(icon.properties.code)}`,
- terms: [ name ]
- };
- }
-
- writeFileSync("manifest.json", JSON.stringify(icons, null, 2), "utf8");
- console.log("manifest.json created");
-}
-
-processIconPack("light");</code></pre>
- <p>What to do with the script:</p>
- <ul>
- <li>Put <code>selection.json</code> and <code>build-manifest.js</code> in a folder.</li>
- <li>Run: node build-manifest.js</li>
- <li>The script writes <code>manifest.json</code> — open it, verify contents,
- then copy into a Trilium Code note (language: JSON).</li>
- </ul>
-</details>
-<aside class="admonition tip">
- <p><strong>Mind the escape format when processing CSS</strong>
- </p>
- <p>The Unicode escape syntax is different in CSS (<code>"\ea3f"</code>) when
- compared to JSON (<code>"\uea3f"</code>). Notice how the JSON escape is <code>\u</code> and
- not <code>\</code>. Both forms are accepted: keep the CSS escape by writing
- the backslash itself as <code>"\\ea3f"</code> in the JSON, or convert it
- to the JSON escape <code>"\uea3f"</code>.</p>
- <p>As a more compact alternative, provide the un-escaped character directly,
- as UTF-8 is supported.</p>
-</aside>
-<h3>Assigning the prefix</h3>
-<p>Before an icon pack can be used, it needs to have a prefix defined. This
- prefix uniquely identifies the icon pack so that it can be used throughout
- the application.</p>
-<p>To do so, Trilium makes use of the same format that was used for the internal
- icon pack (Boxicons). For example, when an icon from Boxicons is set, it
- looks like this: <code>#iconClass="bx bxs-sushi"</code>. In this case, the
- icon pack prefix is <code>bx</code> and the icon class name is <code>bxs-sushi</code>.</p>
-<p>In order for an icon pack to be recognized, the prefix must be specified
- in the <code>#iconPack</code> label.&nbsp;</p>
-<p>For our example with Phosphor Icons, we can use the <code>ph</code> prefix
- since it also matches the prefix set in the original CSS. So in this case
- it would be <code>#iconPack=ph</code>.</p>
-<aside class="admonition important">
- <p>The prefix must consist of only letters, digits, hyphens, underscores
- and non-ASCII characters. If the prefix doesn't match these constraints,
- the icon pack will be ignored and an error will be logged in&nbsp;<a class="reference-link"
- href="#root/_help_bnyigUA2UK7s">Backend (server) logs</a>.</p>
-</aside>
-<h2>Creating the Trilium icon pack note</h2>
-<ol>
- <li>Create a note of type <em>Code</em>.</li>
- <li>Set the language to <em>JSON</em>.</li>
- <li>Rename the note. The name of the note will also be the name of the icon
- pack as displayed in the list of icons.</li>
- <li>Copy and paste the manifest generated in the previous step as the content
- of this note.</li>
- <li>Go to the <a href="#root/_help_0vhv7lsOLy82">note attachment</a> and upload
- the font file (in <code>.woff2</code>, <code>.woff</code>, <code>.ttf</code>)
- format.
- <ol>
- <li>Trilium identifies the font to use from attachments via the MIME type,
- make sure the MIME type is displayed correctly after uploading the attachment
- (for example <code>font/woff2</code>).</li>
- <li>Make sure the <code>role</code> appears as <code>file</code>, otherwise the
- font will not be identified.</li>
- <li>Multiple attachments are supported, but only one font will actually be
- used in Trilium's order of preference: <code>.woff2</code>, <code>.woff</code>, <code>.ttf</code>.
- As such, there's not much reason to upload more than one font per icon
- pack.</li>
- </ol>
- </li>
- <li>Add label: <code>#iconPack=&lt;prefix&gt;</code> (for Phosphor example: <code>#iconPack=ph</code>).</li>
-</ol>
-<h3>Final steps</h3>
-<ul>
- <li><a href="#root/_help_s8alTXmpFR61">Refresh the client</a>
- <ul>
- <li>Change the icon of the note and look for the <em>Filter</em> icon in the
- top-right side.</li>
- <li>Check if the new icon pack is displayed there and click on it to see the
- full list of icons.</li>
- <li>Go through most of the items to look for issues such as missing icon,
- wrong names (some icons have aliases/terms that can cause issues).</li>
- </ul>
- </li>
- <li>Optionally, assign an icon from the new icon pack to this note. This icon
- will be used in the icon pack filter for a visual distinction.</li>
- <li>The icon pack can then be <a href="#root/_help_mHbBMPDPkVV5">exported as ZIP</a> in
- order to be distributed to other users.
- <ul>
- <li>It's important to note that icon packs are considered “unsafe” by default,
- so “Safe mode” must be disabled when importing the ZIP.</li>
- <li>Consider linking new users to the&nbsp;<a class="reference-link" href="#root/_help_gOKqSJgXLcIj">Icon Packs</a>&nbsp;documentation
- in order to understand how to import and use an icon pack.</li>
- </ul>
- </li>
-</ul>
-<h3>Troubleshooting</h3>
-<p>If the icon pack doesn't show up, look through the&nbsp;<a class="reference-link"
- href="#root/_help_bnyigUA2UK7s">Backend (server) logs</a>&nbsp;for clues.</p>
-<ul>
- <li>One example is if the font could not be retrieved: <code>ERROR: Icon pack is missing WOFF/WOFF2/TTF attachment: Boxicons v3 400 (dup) (XRzqDQ67fHEK)</code>.</li>
- <li>Make sure the prefix is unique and not already taken by some other icon
- pack. When there are two icon packs with the same prefix, only one is used.
- The server logs will indicate if this situation occurs.</li>
- <li>Make sure the prefix consists only of letters, digits, hyphens, underscores
- and non-ASCII characters.</li>
- <li>If the pack loads but individual icons are missing, check the logs for <code>Skipping icon '&lt;key&gt;' of icon pack</code> —
- that key uses characters outside the allowed set and needs renaming in
- the manifest.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Custom app-wide CSS.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Custom app-wide CSS.html
deleted file mode 100644
index a12566c195..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Custom app-wide CSS.html
+++ /dev/null
@@ -1,66 +0,0 @@
-<p>It is possible to provide a CSS file to be used regardless of the theme
- set by the user.</p>
-<p>The quickest way to create one is <em>Insert child note</em> → <em>Code</em> → <em>Custom CSS</em> in
- the&nbsp;<a class="reference-link" href="#root/_help_YtSN43OrfzaA">Note tree contextual menu</a>.</p>
-<p>Alternatively, create a&nbsp;<a class="reference-link" href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;note
- manually, set the language to CSS and apply the <code>#appCss</code> label.</p>
-<h2>Seeing the changes</h2>
-<p>Adding a new <em>app CSS note</em> or modifying an existing one does not
- immediately apply changes. To see the changes, press Ctrl+Shift+R to refresh
- the page first.</p>
-<h2>Sample use cases</h2>
-<h3>Customizing the printing stylesheet</h3>
-<aside class="admonition tip">
- <p>Since v0.99.2, it's no longer possible to use <code>#appCss</code> to customize
- the printing CSS, since the printing is now done in an isolated environment.</p>
- <p>However, it's still possible to customize the CSS via <code>~printCss</code>;
- see&nbsp;<a class="reference-link" href="#root/_help_NRnIZmSMc5sj">Printing &amp; Exporting as PDF</a>&nbsp;for
- more information.</p>
-</aside>
-<h3>Per-workspace styles</h3>
-<p>When using&nbsp;<a class="reference-link" href="#root/_help_9sRHySam5fXb">Workspaces</a>,
- it can be helpful to create a visual distinction between notes in different
- workspaces.</p>
-<p>To do so:</p>
-<ol>
- <li>In the note with <code>#workspace</code>, add an inheritable attribute <code>#cssClass(inheritable)</code> with
- a value that uniquely identifies the workspace (say <code>my-workspace</code>).</li>
- <li>Anywhere in the note structure, create a CSS note with <code>#appCss</code>.</li>
-</ol>
-<h4>Change the color of the icons in the&nbsp;<a class="reference-link" href="#root/_help_oPVyFC7WL2Lp">Note Tree</a></h4><pre><code class="language-text-x-trilium-auto">.fancytree-node.my-workspace.fancytree-custom-icon {
- color: #ff0000;
-}</code></pre>
-<h4>Change the color of the note title and the icon</h4>
-<p>To change the color of the note title and the icon (above the content):</p><pre><code class="language-text-x-trilium-auto">.note-split.my-workspace .note-icon-widget button.note-icon,
-.note-split.my-workspace .note-title-widget input.note-title {
- color: #ff0000;
-}</code></pre>
-<h4>Add a watermark to the note content</h4>
-<figure class="image image-style-align-right image_resized" style="width:39.97%;">
- <img style="aspect-ratio:641/630;" src="Custom app-wide CSS_image.png"
- width="641" height="630">
-</figure>
-<ol>
- <li>Insert an image in any note and take the URL of the image.</li>
- <li>Use the following CSS, adjusting the <code>background-image</code> and <code>width</code> and <code>height</code> to
- the desired values.</li>
-</ol><pre><code class="language-text-x-trilium-auto">.note-split.my-workspace .scrolling-container:after {
- position: fixed;
- content: "";
- background-image: url("/api/attachments/Rvm3zJNITQI1/image/logo.png");
- background-size: contain;
- background-position: center;
- background-repeat: no-repeat;
- width: 237px;
- height: 44px;
- bottom: 1em;
- right: 1em;
- opacity: 0.5;
- z-index: 0;
-}</code></pre>
-<h2>Limitations</h2>
-<p>Some parts of the application can't be styled directly via custom CSS
- because they are rendered in an isolated mode (shadow DOM), more specifically:</p>
-<ul>
- <li>The slides in a&nbsp;<a class="reference-link" href="#root/_help_zP3PMqaG71Ct">Presentation</a>.</li>
-</ul>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Custom app-wide CSS_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Custom app-wide CSS_image.png
deleted file mode 100644
index 225fcc24f5..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Custom app-wide CSS_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Customize the Next theme.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Customize the Next theme.html
deleted file mode 100644
index b55796c3fd..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Customize the Next theme.html
+++ /dev/null
@@ -1,20 +0,0 @@
-<p>By default, any custom theme will be based on the legacy light theme.
- To use the TriliumNext theme instead, add the <code>#appThemeBase=next</code> attribute
- onto the existing theme. The <code>appTheme</code> attribute must also be
- present.</p>
-<p>
- <img src="Customize the Next theme_image.png">
-</p>
-<p>The <code>appThemeBase</code> label can be set to one of the following values:</p>
-<ul>
- <li><code>next</code>, for the TriliumNext (auto light or dark mode).</li>
- <li><code>next-light</code>, for the always light mode of the TriliumNext.</li>
- <li><code>next-dark</code>, for the always dark mode of the TriliumNext.</li>
- <li>Any other value is ignored and will use the legacy white theme instead.</li>
-</ul>
-<h2>Overrides</h2>
-<p>Do note that the TriliumNext theme has a few more overrides than the legacy
- theme. Due to that, it is recommended to use <code>#trilium-app</code> with
- a next theme instead of the <code>:root</code> of a legacy theme.</p><pre><code class="language-text-css">#trilium-app {
- --launcher-pane-background-color: #0d6efd;
-}</code></pre>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Customize the Next theme_image.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Customize the Next theme_image.png
deleted file mode 100644
index e397c87dc0..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Customize the Next theme_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Reference.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Reference.html
deleted file mode 100644
index 2b3ecea403..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Reference.html
+++ /dev/null
@@ -1,242 +0,0 @@
-<h2>Detecting mobile vs. desktop</h2>
-<p>The mobile layout is different than the one on the desktop. Use <code>body.mobile</code> and <code>body.desktop</code> to
- differentiate between them.</p><pre><code class="language-text-css">body.mobile #root-widget {
- /* Do something on mobile */
-}
-
-body.desktop #root-widget {
- /* Do something on desktop */
-}</code></pre>
-<p>Do note that there is also a “tablet mode” in the mobile layout. For that
- particular case media queries are required:</p><pre><code class="language-text-css">@media (max-width: 991px) {
- #launcher-pane {
- /* Do something on mobile layout */
- }
-}
-
-
-
-@media (min-width: 992px) {
- #launcher-pane {
- /* Do something on mobile tablet + desktop layout */
- }
-}</code></pre>
-<h2>Detecting horizontal vs. vertical layout</h2>
-<p>The user can select between vertical layout (the classical one, where
- the launcher bar is on the left) and a horizontal layout (where the launcher
- bar is on the top and tabs are full-width).</p>
-<p>Different styles can be applied by using classes at <code>body</code> level:</p><pre><code class="language-text-css">body.layout-vertical #left-pane {
- /* Do something */
-}
-
-body.layout-horizontal #center-pane {
- /* Do something else */
-}</code></pre>
-<p>The two different layouts use different containers (but they are present
- in the DOM regardless of the user's choice), for example <code>#horizontal-main-container</code> and <code>#vertical-main-container</code> can
- be used to customize the background of the content section.</p>
-<h2>Detecting platform (Windows, macOS) or Electron</h2>
-<div class="trilium-tabs">
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-windows"></span>&nbsp;Windows</p>
- <div class="trilium-tab-panel"><pre><code class="language-text-css">body.platform-win32 {
- background: red;
-}</code></pre>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-apple"></span>&nbsp;macOS</p>
- <div class="trilium-tab-panel"><pre><code class="language-text-css">body.platform-darwin {
- background: red;
-}</code></pre>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bx-windows"></span>&nbsp;Electron (desktop app)</p>
- <div
- class="trilium-tab-panel">
- <p>To distinguish between a&nbsp;<a class="reference-link" href="#root/_help_poXkQfguuA0U">Desktop Installation</a>&nbsp;and
- a&nbsp;<a class="reference-link" href="#root/_help_WOcw2SLH6tbX">Server Installation</a>:</p><pre><code class="language-text-x-trilium-auto">body.electron {
- background: blue;
-}</code></pre>
- <p>Can be chained with Windows/macOS detections (e.g. <code>body.electron.platform-win32</code>).</p>
- </div>
- </section>
-</div>
-<h3>Native title bar</h3>
-<p>It's possible to detect if the user has selected the native title bar
- or the custom title bar by querying against <code>body</code>:</p><pre><code class="language-text-x-trilium-auto">body.electron.native-titlebar {
- /* Do something */
-}
-
-body.electron:not(.native-titlebar) {
- /* Do something else */
-}</code></pre>
-<h3>Native window buttons</h3>
-<p>When running under Electron with native title bar off, a feature was introduced
- to use the platform-specific window buttons such as the semaphore on macOS.</p>
-<p>See <a href="https://github.com/TriliumNext/Notes/pull/702">Native title bar buttons by eliandoran · Pull Request #702 · TriliumNext/Notes</a> for
- the original implementation of this feature, including screenshots.</p>
-<div
-class="trilium-tabs">
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-windows"></span>&nbsp;Windows</p>
- <div class="trilium-tab-panel">
- <p>The colors of the native window button area can be adjusted using a RGB
- hex color:</p><pre><code class="language-text-x-trilium-auto">body {
- --native-titlebar-foreground: #ffffff;
- --native-titlebar-background: #ff0000;
-}</code></pre>
- <p>It is also possible to use transparency at the cost of reduced hover colors
- using a RGBA hex color:</p><pre><code class="language-text-x-trilium-auto">body {
- --native-titlebar-background: #ff0000aa;
-}</code></pre>
- <p>Note that the value is read when the window is initialized and then it
- is refreshed only when the user changes their light/dark mode preference.</p>
- </div>
- </section>
- <section class="trilium-tab">
- <p class="trilium-tab-title"><span class="tn-icon bx bxl-apple"></span>&nbsp;macOS</p>
- <div class="trilium-tab-panel">
- <p>On macOS the semaphore window buttons are enabled by default when the
- native title bar is disabled. The offset of the buttons can be adjusted
- using:</p><pre><code class="language-text-css">body {
- --native-titlebar-darwin-x-offset: 12;
- --native-titlebar-darwin-y-offset: 14 !important;
-}</code></pre>
- </div>
- </section>
-</div>
-<h3>Background/transparency effects on Windows (Mica)</h3>
-<p>Windows 11 offers a special background/transparency effect called Mica,
- which can be enabled by themes by setting the <code>--background-material</code> variable
- at <code>body</code> level:</p><pre><code class="language-text-css">body.electron.platform-win32 {
- --background-material: tabbed;
-}</code></pre>
-<p>The value can be either <code>tabbed</code> (especially useful for the horizontal
- layout) or <code>mica</code> (ideal for the vertical layout).</p>
-<p>Do note that the Mica effect is applied at <code>body</code> level and the
- theme needs to make the entire hierarchy (semi-)transparent in order for
- it to be visible. Use the TrilumNext theme as an inspiration.</p>
-<h2>Note icons, tab workspace accent color</h2>
-<p>Theme capabilities are small adjustments done through CSS variables that
- can affect the layout or the visual aspect of the application.</p>
-<p>In the tab bar, to display the icons of notes instead of the icon of the
- workspace:</p><pre><code class="language-text-css">:root {
- --tab-note-icons: true;
-}</code></pre>
-<p>When a workspace is hoisted for a given tab, it is possible to get the
- background color of that workspace, for example to apply a small strip
- on the tab instead of the whole background color:</p><pre><code class="language-text-css">.note-tab .note-tab-wrapper {
- --tab-background-color: initial !important;
-}
-
-.note-tab .note-tab-wrapper::after {
- content: "";
- position: absolute;
- top: 0;
- left: 0;
- right: 0;
- height: 3px;
- background-color: var(--workspace-tab-background-color);
-}</code></pre>
-<h2>Custom fonts</h2>
-<p>The recommended way of using customized fonts is to import a font directly
- in Trilium. See&nbsp;<a class="reference-link" href="#root/_help_w4rMEhJsALlA">Personalizing the font</a>&nbsp;for
- information on how to do so.</p>
-<p>Alternatively, for a theme providing its own font, <a href="#root/_help_d3fAXQ2diepH">Custom resource providers</a> can
- be used: Import a font into Trilium and assign it <code>#customResourceProvider=fonts/myfont.ttf</code> and
- then import the font in CSS via <code>/custom/fonts/myfont.ttf</code>. Use <code>../../../custom/fonts/myfont.ttf</code> if
- you run your Trilium server on a different path than <code>/</code>.</p>
-<h2>Dark and light themes</h2>
-<p>A light theme needs to have the following CSS:</p><pre><code class="language-text-css">:root {
- --theme-style: light;
-}</code></pre>
-<p>if the theme is dark, then <code>--theme-style</code> needs to be <code>dark</code>.
- A dark <code>--theme-style</code> also tells the Dark Reader browser extension
- to leave the page alone.</p>
-<p>If the theme is auto (e.g. supports both light or dark based on <code>prefers-color-scheme</code>)
- it must also declare (in addition to setting <code>--theme-style</code> to
- either <code>light</code> or <code>dark</code>):</p><pre><code class="language-text-css">:root {
-
- --theme-style-auto: true;
-
-}</code></pre>
-<p>This will affect the behavior of the Electron application by informing
- the operating system of the color preference (e.g. background effects will
- appear correct on Windows).</p>
-<h2>Adaptive text and table colors</h2>
-<p>Colors applied in a text note, from the font color and background color
- buttons (see&nbsp;<a class="reference-link" href="#root/_help_Gr6xFaF6ioJ5">General formatting</a>)
- or from the table and cell properties (see&nbsp;<a class="reference-link"
- href="#root/_help_NdowYOC1GFKS">Tables</a>), are shown in a shade that
- suits the theme: the hue stays, while the lightness and the saturation
- are kept within limits. A theme can change these limits, for example if
- its page background is much darker or lighter than the one of the built-in
- themes:</p><pre><code class="language-text-css">:root {
- --adaptive-text-light-max-lightness: 35;
- --adaptive-text-dark-min-lightness: 80;
-}</code></pre>
-<p>Each variable is named <code>--adaptive-&lt;role&gt;-&lt;light|dark&gt;-&lt;limit&gt;</code>:</p>
-<ul>
- <li>The role is <code>text</code> (font color), <code>background</code> (font
- background color), <code>table-border</code> or <code>table-background</code> (tables
- and cells).</li>
- <li><code>light</code> or <code>dark</code> is the kind of theme the limit applies
- to, as declared by <code>--theme-style</code>.</li>
- <li>The limit is <code>min-lightness</code> or <code>max-lightness</code> (the
- CIELAB lightness, from 0 for black to 100 for white), or <code>max-chroma</code> (how
- saturated the color can be; <code>150</code> sets no practical limit). Each
- value must be a plain number, otherwise the colors lose their adaptation.</li>
-</ul>
-<p>The defaults are:</p>
-<figure class="table">
- <table>
- <thead>
- <tr>
- <th>Role</th>
- <th>Light themes</th>
- <th>Dark themes</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td><code>text</code>
- </td>
- <td><code>max-lightness: 40</code>, <code>max-chroma: 150</code>
- </td>
- <td><code>min-lightness: 75</code>, <code>max-chroma: 55</code>
- </td>
- </tr>
- <tr>
- <td><code>background</code>
- </td>
- <td><code>min-lightness: 90</code>, <code>max-chroma: 20</code>
- </td>
- <td><code>max-lightness: 30</code>, <code>max-chroma: 30</code>
- </td>
- </tr>
- <tr>
- <td><code>table-border</code>
- </td>
- <td><code>max-lightness: 60</code>, <code>max-chroma: 150</code>
- </td>
- <td><code>min-lightness: 47</code>, <code>max-chroma: 150</code>
- </td>
- </tr>
- <tr>
- <td><code>table-background</code>
- </td>
- <td><code>min-lightness: 90</code>, <code>max-chroma: 20</code>
- </td>
- <td><code>max-lightness: 30</code>, <code>max-chroma: 30</code>
- </td>
- </tr>
- </tbody>
- </table>
-</figure>
-<p>The limits apply while a note is displayed, so a change to them affects
- every note at once. The note itself keeps each color as it was picked,
- in its <code>color</code>, <code>background-color</code> or <code>border-color</code> style,
- and a second time in a <code>--tn-color</code>, <code>--tn-background</code> or <code>--tn-border-color</code> variable,
- which the adaptation reads.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting.html
deleted file mode 100644
index 073fe1dbd3..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting.html
+++ /dev/null
@@ -1,53 +0,0 @@
-<p>While Trilium is actively maintained and stable, encountering bugs is
- possible.</p>
-<h2>General Quick Fix</h2>
-<p>The first step in troubleshooting is often a restart.</p>
-<p>If you experience an UI issue, the frontend may have entered an inconsistent
- state. Reload the application by pressing <kbd>Ctrl</kbd> + <kbd>R</kbd>.
- This will reload the frontend.</p>
-<p>If the issue persists or appears to be a backend problem, restart the
- entire application. For the desktop (Electron) build, simply close and
- reopen the window. If you're using a Docker build, restart the container.</p>
-<h2>Reporting Bugs</h2>
-<p>Reporting bugs is highly valuable. Here are some tips:</p>
-<ul>
- <li>Use GitHub issues for reporting: <a href="https://github.com/TriliumNext/Trilium/issues">https://github.com/TriliumNext/Trilium/issues</a>
- </li>
- <li>Refer to the <a href="#root/_help_qzNzp9LYQyPT">error logs</a> page for
- information on providing necessary details.</li>
-</ul>
-<details class="trilium-collapsible" open="">
- <summary>Broken Note Crashes Trilium</summary>
- <p>Certain problems, such as rendering a note with a faulty script, can cause
- Trilium to crash. If Trilium attempts to reload the problematic note upon
- restart, it will continue to crash.</p>
- <p>To resolve this, use the <code>TRILIUM_START_NOTE_ID</code> environment
- variable to reset the open tabs to a single specified note ID (e.g., <code>root</code>).
- In Linux, you can set it as follows:</p><pre><code class="language-text-x-trilium-auto">TRILIUM_START_NOTE_ID=root ./trilium</code></pre>
-</details>
-<details class="trilium-collapsible" open="">
- <summary>Broken Script Prevents Application Startup</summary>
- <p>If a custom script causes Trilium to crash, and it is set as a startup
- script or in an active <a href="#root/_help_MgibgPcfeuGz">custom widget</a>,
- start Triliumin "safe mode" to prevent any custom scripts from executing:</p><pre><code class="language-text-x-trilium-auto">TRILIUM_SAFE_MODE=true ./trilium</code></pre>
- <p>Depending on your Trilium distribution, you may have pre-made scripts
- available: <code>trilium-safe-mode.bat</code> and <code>trilium-safe-mode.sh</code>.</p>
- <p>Once Trilium starts, locate and fix or delete the problematic note.</p>
-</details>
-<details class="trilium-collapsible" open="">
- <summary>Sync and Consistency Checks</summary>
- <p>Trilium periodically verifies the logical consistency of the database
- (e.g., ensuring every note has a parent). If inconsistencies are detected,
- you will be notified via the UI.</p>
- <p>In such cases, file a bug report and attach an <a href="#root/_help_x59R8J8KV5Bp">anonymized database</a> if
- necessary.</p>
-</details>
-<details class="trilium-collapsible" open="">
- <summary>Restoring Backup</summary>
- <p>Trilium makes regular automatic backups. If issues become severe, you
- can <a href="#root/_help_ODY7qQn5m2FT">restore from a backup</a>.</p>
-</details>
-<details class="trilium-collapsible" open="">
- <summary>Forgotten Password</summary>
- <p>See&nbsp;<a class="reference-link" href="#root/_help_lwAX5SvbrK2g">Resetting your password</a>.</p>
-</details>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Anonymized Database.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Anonymized Database.html
deleted file mode 100644
index 1ae7334bf2..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Anonymized Database.html
+++ /dev/null
@@ -1,29 +0,0 @@
-<p>
- <img src="Anonymized Database_image.png">
-</p>
-<p>In certain scenarios, understanding the structure of a database is crucial
- for troubleshooting issues. However, sharing your actual <a href="#root/_help_wX4HbRucYSDD">database</a> file
- with personal notes is not advisable. To address this, Trilium offers a
- feature to anonymize the database. This feature can be accessed via Menu
- -&gt; Options -&gt; Advanced tab.</p>
-<p>This feature creates a copy of your database with all sensitive data removed.
- Specifically, it strips out note titles, contents, revisions, history,
- and some non-system attributes while retaining the overall structure and
- metadata, such as modification dates. After anonymization, the database
- undergoes a <a href="https://sqlite.org/lang_vacuum.html">vacuuming process</a> to
- ensure no sensitive data remnants remain in the file. The anonymized database
- is saved in the <code>anonymized</code> directory within the <a href="#root/_help_tAassRL4RSQL">data directory</a>,
- making it safe to share with bug reports.</p>
-<p>This will create a copy of your document and remove all sensitive data
- (currently note titles, contents, revisions, history and some of the options,
- and non-system attributes) while leaving all structure and metadata (e.g.
- date of last change). After this is done, the database is <a href="https://sqlite.org/lang_vacuum.html">VACUUMed</a> to
- make sure there's no stale sensitive data in the document file. The resulting
- file is stored in <code>anonymized</code> directory (placed in the <a href="#root/_help_tAassRL4RSQL">data directory</a>).
- You can safely attach it to a bug report.</p>
-<h2>Command Line Anonymization</h2>
-<p>If your <a href="#root/_help_wX4HbRucYSDD">database</a> is corrupted to
- the point where Trilium cannot start, the anonymization process can still
- be executed via the command line:</p><pre><code class="language-text-x-trilium-auto">node src/anonymize.js</code></pre>
-<p>Run this command from the directory containing Trilium's source files,
- typically found in the <code>resources/app</code> directory for desktop builds.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Error logs.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Error logs.html
deleted file mode 100644
index e2e58b86e8..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Error logs.html
+++ /dev/null
@@ -1,23 +0,0 @@
-<p>It's important to provide all available error logs together with bug reports.</p>
-<p>There are two types of error logs, both of which are useful when reporting
- bugs.</p>
-<ul>
- <li><a class="reference-link" href="#root/_help_bnyigUA2UK7s">Backend (server) logs</a>
- </li>
- <li><a class="reference-link" href="#root/_help_9yEHzMyFirZR">Frontend logs</a>
- </li>
-</ul>
-<h2>Providing sensitive data</h2>
-<p>If you don't feel comfortable attaching the logs or anything sensitive
- to the public GitHub issues, feel free to contact the devs in our Matrix <a
- href="https://github.com/TriliumNext/Trilium#-discuss-with-us">support channel</a>.</p>
-<p>Use this email to also provide anything which could assist in analysing
- the bug - e.g. files/images/ZIPs being imported or <a href="#root/_help_x59R8J8KV5Bp">anonymized database</a>.</p>
-<h3>Exporting note subtree for reproduction</h3>
-<p>Often times, bugs manifest themselves in specific notes and having them
- would greatly ease reproduction and fixing.</p>
-<p>In such case, please export the relevant note subtree by right-clicking
- it on the left tree, choosing Export - HTML as ZIP:</p>
-<p>
- <img src="Error logs_error-logs-export-subtree.png">
-</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Error logs/Backend (server) logs.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Error logs/Backend (server) logs.html
deleted file mode 100644
index 8a4b186f51..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Error logs/Backend (server) logs.html
+++ /dev/null
@@ -1,40 +0,0 @@
-<h2>Accessing via the backend log</h2>
-<p>In the&nbsp;<a class="reference-link" href="#root/_help_x3i7MxGccDuM">Global menu</a>,
- go to <em>Advanced</em> → <em>Show backend log</em>. This will display the
- current backend log (i.e. today's), with the historical information available
- only on disk (see below).</p>
-<p>Interaction since v0.104.0:</p>
-<ul>
- <li>The file can be downloaded as a text file using the&nbsp;<span class="tn-icon bx bx-download"></span> button
- in the&nbsp;<a class="reference-link" href="#root/_help_8YBEPzcpUgxw">Note menu</a>&nbsp;area.</li>
- <li>The file can also be searched just like a normal&nbsp;<a class="reference-link"
- href="#root/_help_6f9hih2hXXZk">Code</a>&nbsp;note.</li>
-</ul>
-<h2>Location on the disk</h2>
-<p>Backend logs are stored on the file system. To find them, open the&nbsp;<a
- class="reference-link" href="#root/_help_tAassRL4RSQL">Data directory</a>,
- go to the <code>log</code> subdirectory and find the latest log file, e.g. <code>trilium-2022-12-14.log</code>.&nbsp;</p>
-<h2>Reporting backend bugs</h2>
-<p>You can attach the whole file to the bug report (preferable) or open it
- and copy-paste only the last lines / lines you believe are relevant.</p>
-<h2>Customizing the retention of logs</h2>
-<p>The backend logs are fully managed by the Trilium server. By default the
- last 90 days worth of logs are kept; the logs older than that are deleted
- in order to reduce the space consumption.</p>
-<p>It's possible to change the retention period by modifying the&nbsp;<a
- class="reference-link" href="#root/_help_Gzjqa934BdH4">Configuration (config.ini or environment variables)</a>&nbsp;via
- the <code>.ini</code> file:</p><pre><code class="language-text-x-trilium-auto">[Logging]
-retentionDays=7</code></pre>
-<p>Or via the environment variable <code>TRILIUM_LOGGING_RETENTION_DAYS</code>.</p>
-<p>Special cases:</p>
-<ul>
- <li>Positive values indicate the number of days worth of logs to keep</li>
- <li>A value of 0 results with the default value (90 days) to be used</li>
- <li>Negative values (e.g. <code>-1</code>) result with all logs to be kept,
- irrespective how ancient and numerous (and</li>
-</ul>
-<aside class="admonition note">
- <p>If you set the retention days to a low number, you might notice that not
- all the log files are being deleted. This is because a minimum number of
- logs (7 at the time of writing) is maintained at all times.</p>
-</aside>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Error logs/Frontend logs.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Error logs/Frontend logs.html
deleted file mode 100644
index 46b5be53a6..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Error logs/Frontend logs.html
+++ /dev/null
@@ -1,20 +0,0 @@
-<p>To provide frontend logs, we need to open the Developer Console. Often
- the easiest way is to press <kbd>Ctrl</kbd>-<kbd>Shift</kbd>-<kbd>I</kbd> which
- should work in most browsers (and desktop app). Make sure that the error
- producing action happened right before you copy&amp;paste the errors, the
- console is cleared on app restart.</p>
-<p>If that doesn't work, then:</p>
-<ul>
- <li>in Trilium desktop app, go to top-left menu button -&gt; Advanced -&gt;
- Open Dev Tools</li>
- <li>In Firefox/Chrome right-click anywhere in the page and click Inspect:</li>
-</ul>
-<p>
- <img src="Frontend logs_error-logs-firefox-context-men.png">
-</p>
-<p>Once you have Dev Tools open, click on "Console" tab:</p>
-<p>
- <img src="Frontend logs_image.png">
-</p>
-<p>Copy-paste (or screenshot) the logs. It's better to provide not just errors,
- but the whole log, which might provide context while analyzing the bug.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Error logs/Frontend logs_error-logs-firefox-context-men.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Error logs/Frontend logs_error-logs-firefox-context-men.png
deleted file mode 100644
index a6c45bb436..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Error logs/Frontend logs_error-logs-firefox-context-men.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Error logs_error-logs-export-subtree.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Error logs_error-logs-export-subtree.png
deleted file mode 100644
index 65abe49999..0000000000
Binary files a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Error logs_error-logs-export-subtree.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Refreshing the application.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Refreshing the application.html
deleted file mode 100644
index 1eace412d5..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Refreshing the application.html
+++ /dev/null
@@ -1,3 +0,0 @@
-<p>Some changes to the application will not take effect immediately and as
- such it might require to manually reload or refresh the application.</p>
-<p>To do so, simply press <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>R</kbd>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Reporting issues.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Reporting issues.html
deleted file mode 100644
index 20e8aae89f..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Reporting issues.html
+++ /dev/null
@@ -1,3 +0,0 @@
-<p>Go to <a href="https://github.com/TriliumNext/Trilium/issues">Issues · TriliumNext/Trilium</a> and
- press “New issue”.</p>
-<p>If you are reporting a bug, select “Bug Report” and fill in the details.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Synchronization fails with 504 Gateway Timeout.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Synchronization fails with 504 Gateway Timeout.html
deleted file mode 100644
index 0799b33f1a..0000000000
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Synchronization fails with 504 Gateway Timeout.html
+++ /dev/null
@@ -1,13 +0,0 @@
-<p>Synchronization can sometimes take a long amount of time in order to compute
- the items that require update. When running behind a reverse proxy, the
- request can time out.</p>
-<p>The solution is to increase the timeout at proxy level.</p>
-<h2>Nginx</h2>
-<p>Add the following to the configuration file:</p><pre><code class="language-text-x-nginx-conf">proxy_connect_timeout 300;
-proxy_send_timeout 300;
-proxy_read_timeout 300;
-send_timeout 300;</code></pre>
-<p>And restart the server.</p>
-<p>See&nbsp;<a href="#root/_help_ud6MShXL4WpO">Nginx Proxy Setup</a>&nbsp;for
- more information about the Nginx setup.</p>
-<p>If it still doesn't work, try increasing the timeout.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/hidden.html b/apps/server/src/assets/doc_notes/en/hidden.html
deleted file mode 100644
index 2174733857..0000000000
--- a/apps/server/src/assets/doc_notes/en/hidden.html
+++ /dev/null
@@ -1,3 +0,0 @@
-<p>Hidden tree is used to record various application-level data which can stay most of the time hidden from the user view.</p>
-
-<p>Make sure you know what you're doing. Incorrect changes in this subtree might potentially crash the application.</p>
diff --git a/apps/server/src/assets/doc_notes/en/launchbar_command_launcher.html b/apps/server/src/assets/doc_notes/en/launchbar_command_launcher.html
deleted file mode 100644
index 68eb051a24..0000000000
--- a/apps/server/src/assets/doc_notes/en/launchbar_command_launcher.html
+++ /dev/null
@@ -1 +0,0 @@
-<p>Keyboard shortcut for this launcher action can be configured in Options -> Shortcuts.</p>
diff --git a/apps/server/src/assets/doc_notes/en/launchbar_history_navigation.html b/apps/server/src/assets/doc_notes/en/launchbar_history_navigation.html
deleted file mode 100644
index bf44115725..0000000000
--- a/apps/server/src/assets/doc_notes/en/launchbar_history_navigation.html
+++ /dev/null
@@ -1,3 +0,0 @@
-<p>Back and Forward buttons allow you to move in the navigation history.</p>
-
-<p>These launchers are active only in the desktop build and will be ignored in the server edition where you can use the native browser navigation buttons instead.</p>
diff --git a/apps/server/src/assets/doc_notes/en/launchbar_intro.html b/apps/server/src/assets/doc_notes/en/launchbar_intro.html
deleted file mode 100644
index cac5224e90..0000000000
--- a/apps/server/src/assets/doc_notes/en/launchbar_intro.html
+++ /dev/null
@@ -1,11 +0,0 @@
-<p>Welcome to the Launchbar configuration.</p>
-
-<p>You can do the following things here:</p>
-
-<ul>
- <li>Move available launchers to the visible list (thus putting them into the launchbar) by dragging them</li>
- <li>Move visible launchers to the available list (thus hiding them from the launchbar) by dragging them</li>
- <li>You can reorder the items in the lists by dragging</li>
- <li>You can create new launchers by right-clicking on the "Visible launchers" folder</li>
- <li>If you want to get back to the default setup, you can find "reset" in the context menu.</li>
-</ul>
diff --git a/apps/server/src/assets/doc_notes/en/launchbar_note_launcher.html b/apps/server/src/assets/doc_notes/en/launchbar_note_launcher.html
deleted file mode 100644
index 8d4d15b059..0000000000
--- a/apps/server/src/assets/doc_notes/en/launchbar_note_launcher.html
+++ /dev/null
@@ -1,9 +0,0 @@
-<p>You can define the following attributes:</p>
-
-<ol>
- <li><code>target</code> - note which should be opened upon activating the launcher</li>
- <li><code>hoistedNote</code> - optional, will change the hoisted note before opening the target note</li>
- <li><code>keyboardShortcut</code> - optional, pressing the keyboard shortcut will open the note</li>
-</ol>
-
-<p>Launchbar displays the title / icon from the launcher, which does not necessarily mirror those of the target note.</p>
diff --git a/apps/server/src/assets/doc_notes/en/launchbar_quick_search.html b/apps/server/src/assets/doc_notes/en/launchbar_quick_search.html
deleted file mode 100644
index 79945ab2c8..0000000000
--- a/apps/server/src/assets/doc_notes/en/launchbar_quick_search.html
+++ /dev/null
@@ -1,2 +0,0 @@
-<p>The <a href="#root/_help_Ms1nauBra7gq" target="_blank">quick search bar</a> is displayed only on the horizontal layout, since it is already visible by default in the vertical layout.</p>
-<p>For more information, see <a href="#root/_help_x0JgW8UqGXvq" target="_blank">Vertical and horizontal layout</a>.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/launchbar_script_launcher.html b/apps/server/src/assets/doc_notes/en/launchbar_script_launcher.html
deleted file mode 100644
index 49e315487e..0000000000
--- a/apps/server/src/assets/doc_notes/en/launchbar_script_launcher.html
+++ /dev/null
@@ -1,12 +0,0 @@
-<p>Script launcher can execute a script (code note) connected via <code>~script</code> relation.</p>
-
-<ol>
- <li><code>script</code> - relation to the script note which should be executed upon launcher activation</li>
- <li><code>keyboardShortcut</code> - optional, pressing the keyboard shortcut will activate the launcher</li>
-</ol>
-
-<h4>Example script</h4>
-
-<pre>
-api.showMessage("Current note is " + api.getActiveContextNote().title);
-</pre>
diff --git a/apps/server/src/assets/doc_notes/en/launchbar_spacer.html b/apps/server/src/assets/doc_notes/en/launchbar_spacer.html
deleted file mode 100644
index 720899a73e..0000000000
--- a/apps/server/src/assets/doc_notes/en/launchbar_spacer.html
+++ /dev/null
@@ -1,6 +0,0 @@
-<p>Spacer allows you to visually group launchers. You can configure it in the promoted attributes:</p>
-
-<ul>
- <li><code>baseSize</code> - defines size in pixels (if there's enough space)</li>
- <li><code>growthFactor</code> - set to 0 if you want the spacer to be of constant <code>baseSize</code>, with positive value it will grow.</li>
-</ul>
diff --git a/apps/server/src/assets/doc_notes/en/launchbar_widget_launcher.html b/apps/server/src/assets/doc_notes/en/launchbar_widget_launcher.html
deleted file mode 100644
index 3df3afa9c9..0000000000
--- a/apps/server/src/assets/doc_notes/en/launchbar_widget_launcher.html
+++ /dev/null
@@ -1,34 +0,0 @@
-<p>Please define the target widget note in the promoted attributes. The widget will be used to render the launchbar icon.</p>
-
-<h4>Example launchbar widget</h4>
-
-<pre>
-const TPL = `&lt;div style="height: 53px; width: 53px;"&gt;&lt;/div&gt;`;
-
-class ExampleLaunchbarWidget extends api.NoteContextAwareWidget {
- doRender() {
- this.$widget = $(TPL);
- }
-
- async refreshWithNote(note) {
- this.$widget.css("background-color", this.stringToColor(note.title));
- }
-
- stringToColor(str) {
- let hash = 0;
- for (let i = 0; i < str.length; i++) {
- hash = str.charCodeAt(i) + ((hash << 5) - hash);
- }
-
- let color = '#';
- for (let i = 0; i < 3; i++) {
- const value = (hash >> (i * 8)) & 0xFF;
- color += ('00' + value.toString(16)).substr(-2);
- }
-
- return color;
- }
-}
-
-module.exports = new ExampleLaunchbarWidget();
-</pre>
diff --git a/apps/server/src/assets/doc_notes/en/share.html b/apps/server/src/assets/doc_notes/en/share.html
deleted file mode 100644
index 499cf35e87..0000000000
--- a/apps/server/src/assets/doc_notes/en/share.html
+++ /dev/null
@@ -1 +0,0 @@
-<p>Here you can find all shared notes.</p>
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/system_state.html b/apps/server/src/assets/doc_notes/en/system_state.html
deleted file mode 100644
index ee0c7b024d..0000000000
--- a/apps/server/src/assets/doc_notes/en/system_state.html
+++ /dev/null
@@ -1,3 +0,0 @@
-<p>This is a built-in task state and cannot be edited or removed.</p>
-
-<p>Only its position can be changed, which determines its order in the checkbox toolbar and the keyboard cycle.</p>
diff --git a/apps/server/src/assets/doc_notes/en/task_state.html b/apps/server/src/assets/doc_notes/en/task_state.html
deleted file mode 100644
index cca9e253b5..0000000000
--- a/apps/server/src/assets/doc_notes/en/task_state.html
+++ /dev/null
@@ -1,21 +0,0 @@
-<p>This note defines a to-do task state. The note's icon is displayed inside checkboxes to represent this state, and the note's title serves as its display name.</p>
-
-<p>The state is configured through the following promoted attributes:</p>
-
-<ul>
- <li>
- <code>Identifier</code> — required. The internal name stored as metadata within the note markup.
- Only letters, digits, <code>-</code> and <code>_</code> are permitted.
-
- <p class="admonition warning">
- Prefix the identifiers of your custom task states with an underscore <code>_</code> or a hyphen <code>-</code> to avoid clashes with task states that may be introduced in future versions of Trilium.
- </p>
-
- Examples: <code>_postponed</code>, <code>_awaiting-feedback</code>, <code>_validated</code>.</li>
- <li><code>Markdown symbol</code> — the single character used to represent the state when exporting to Markdown; for example, <code>/</code> produces <code>- [/]</code>.</li>
- <li><code>Counts as completed</code> — when enabled, a task in this state is treated as completed.</li>
- <li><code>Color</code> — the checkbox color for this state.</li>
- <li><code>Hidden from toolbar</code> — when enabled, the state is excluded from the state list and the keyboard cycle. Notes already using it continue to render correctly.</li>
-</ul>
-
-<p class="admonition warning">Changes take effect after the application is reloaded.</p>
diff --git a/apps/server/src/assets/doc_notes/en/task_states.html b/apps/server/src/assets/doc_notes/en/task_states.html
deleted file mode 100644
index dc78f575a9..0000000000
--- a/apps/server/src/assets/doc_notes/en/task_states.html
+++ /dev/null
@@ -1,5 +0,0 @@
-<p>This note contains the task states available for to-do checkboxes in the text editor. Each child note represents a single state.</p>
-
-<p>States can be added, modified, reordered, or removed. To add a new state, create a child note and configure its promoted attributes.</p>
-
-<p class="admonition warning">Changes take effect after the application is reloaded.</p>
diff --git a/apps/server/src/assets/doc_notes/en/user_hidden.html b/apps/server/src/assets/doc_notes/en/user_hidden.html
deleted file mode 100644
index 4925502446..0000000000
--- a/apps/server/src/assets/doc_notes/en/user_hidden.html
+++ /dev/null
@@ -1 +0,0 @@
-<p>This note serves as a subtree reserved for data produced by user scripts which should otherwise not freely create data in the hidden subtree.</p>
diff --git a/apps/server/src/assets/help/help_content.json b/apps/server/src/assets/help/help_content.json
new file mode 100644
index 0000000000..6a4c01d697
--- /dev/null
+++ b/apps/server/src/assets/help/help_content.json
@@ -0,0 +1,288 @@
+{
+ "_help_BOCnjTMBCoxW": "<p>This section presents the most important changes by version. For a full set of changes, please consult the change log of each release. For purposes of brevity, beta versions are skipped and the features gathered to the nearest stable version.</p><ul><li>v0.105.0:<ul><li>Text notes now have a&nbsp;<a class=\"reference-link\" href=\"#root/_help_VRoP0g1uHHc2\">In-editor AI assistant</a>&nbsp;for quick proof-reading and other text-based operations that don't require a full chat.</li></ul></li><li>v0.101.0:<ul><li>A&nbsp;new layout&nbsp;has been introduced, making significant modifications to the UI/UX such as integrating the ribbon and the floating buttons into other UI elements and introducing new functionality such as the&nbsp;<a class=\"reference-link\" href=\"#root/_help_I6p2a06hdnL6\">Breadcrumb</a>.</li></ul></li><li>v0.97.0:<ul><li>Books are now&nbsp;<a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>.</li><li><a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a>&nbsp;is a new collection type displaying notes and attributes in an editable grid.</li><li><a class=\"reference-link\" href=\"#root/_help_ZjLYv08Rp3qC\">Quick edit</a>&nbsp;is introduced, adding a new way to edit notes in a popup instead of opening a new tab. It also integrates well with&nbsp;<a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>.</li></ul></li><li>v0.96.0:<ul><li><a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;gain premium features thanks to a collaboration with the CKEditor team:<ul><li><a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a></li><li><a class=\"reference-link\" href=\"#root/_help_pwc194wlRzcH\">Text Snippets</a></li></ul></li></ul></li><li>v0.95.0:<ul><li>A more friendly theme was introduced for&nbsp;<a class=\"reference-link\" href=\"#root/_help_R9pX4DGra2Vt\">Sharing</a>, with search, expandable tree, night mode and more.</li></ul></li><li>v0.94.0:<ul><li>Added integration with&nbsp;<a class=\"reference-link\" href=\"#root/_help_GBBMSlVSOIGP\">AI</a>&nbsp;(using self-hosted LLMs such as Ollama or industry standards such as ChatGPT).</li></ul></li><li>v0.92.5:<ul><li>Windows binaries are now signed.</li><li><a class=\"reference-link\" href=\"#root/_help_7DAiwaf8Z7Rz\">Multi-factor authentication with TOTP</a>&nbsp;was introduced.</li></ul></li><li>v0.92.4:<ul><li>macOS binaries are now signed.</li><li><a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes can now have adjustable&nbsp;<a class=\"reference-link\" href=\"#root/_help_veGu4faJErEM\">Content language &amp; Right-to-left support</a>.</li><li><a class=\"reference-link\" href=\"#root/_help_NRnIZmSMc5sj\">Printing &amp; Exporting as PDF</a></li><li><a class=\"reference-link\" href=\"#root/_help_rC3pL2aptaRE\">Zen mode</a></li><li><a class=\"reference-link\" href=\"#root/_help_xWbu3jpNWapp\">Calendar</a>, allowing notes to be displayed in a monthly grid based on start and end dates.</li></ul></li><li>v0.91.5:<ul><li>Significant improvements for mobile.</li><li><a class=\"reference-link\" href=\"#root/_help_AgjCISero73a\">Footnotes</a>&nbsp;are now supported in&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes.</li><li>Mermaid diagrams can now be inserted inline within&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes.</li><li>The TriliumNext theme is introduced, bringing a more modern design to the application.</li><li><a class=\"reference-link\" href=\"#root/_help_81SGnPGMk7Xc\">Geo Map</a>, displaying notes as markers on a geographical map for easy trip planning.</li></ul></li><li>v0.90.8:<ul><li>A new note type was introduced:&nbsp;<a class=\"reference-link\" href=\"#root/_help_gBbsAeiuUxI5\">Mind Map</a></li></ul></li></ul>",
+ "_help_poXkQfguuA0U": "<p>To install Trilium on your desktop, follow these steps:</p><ol><li><strong>Download the Latest Release</strong>: Obtain the appropriate binary release for your operating system from the <a href=\"https://github.com/TriliumNext/Trilium/releases/latest\">latest release page</a> on GitHub.</li><li><strong>Extract the Package</strong>: Unzip the downloaded package to a location of your choice.</li><li><strong>Run the Application</strong>: Launch Trilium by executing the <code>trilium</code> executable found within the unzipped folder.</li></ol><h2>Installing from Flathub</h2><p>On Linux, Trilium is also available on <a href=\"https://flathub.org/en/apps/org.triliumnotes.Trilium\">Flathub</a>, for both x86_64 and ARM (aarch64). Install it from your software center (e.g. GNOME Software or KDE Discover), or from a terminal:</p><pre><code class=\"language-text-x-sh\">flatpak install flathub org.triliumnotes.Trilium</code></pre><p>Updates arrive through the software center or <code>flatpak update</code>, like any other Flatpak.</p><p>The Flathub version runs in a sandbox and keeps its <a href=\"#root/_help_tAassRL4RSQL\">data directory</a> in <code>~/.var/app/org.triliumnotes.Trilium/data/trilium-data</code>. It cannot see the data directory of a <code>.deb</code>, <code>.rpm</code>, AppImage or <code>.zip</code> installation (<code>~/.local/share/trilium-data</code>), so it starts with an empty database. To bring existing notes over:</p><ol><li><p>Close Trilium, in both the old installation and the Flatpak.</p></li><li><p>Copy the old data directory into the sandbox:</p><pre><code class=\"language-text-x-sh\">mkdir -p ~/.var/app/org.triliumnotes.Trilium/data\ncp -a ~/.local/share/trilium-data ~/.var/app/org.triliumnotes.Trilium/data/</code></pre></li><li><p>Start the Flatpak version.</p></li></ol><p>If <code>~/.var/app/org.triliumnotes.Trilium/data/trilium-data</code> already exists because the Flatpak version was started before, remove or rename it first.</p><h2>Startup Scripts</h2><p>Trilium offers various startup scripts to customize your experience:</p><ul><li><code>trilium-no-cert-check</code>: Starts Trilium without validating <a href=\"#root/_help_l2VkvOwUNfZj\">TLS certificates</a>, useful if connecting to a server with a self-signed certificate.<ul><li>Alternatively, set the <code>NODE_TLS_REJECT_UNAUTHORIZED=0</code> environment variable before starting Trilium.</li></ul></li><li><code>trilium-portable</code>: Launches Trilium in portable mode, where the <a href=\"#root/_help_tAassRL4RSQL\">data directory</a> is created within the application's directory, making it easy to move the entire setup. Electron's internal data (caches, dictionaries, etc.) is also stored within the data directory, so no files are written to the system's roaming profile.</li><li><code>trilium-safe-mode</code>: Boots Trilium in \"safe mode,\" disabling any startup scripts that might cause the application to crash.</li></ul><h2>Synchronization</h2><p>For Trilium desktop users who wish to synchronize their data with a server instance, refer to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_cbkrhQjrkKrh\">Synchronization</a>&nbsp;guide for detailed instructions.</p>",
+ "_help_nRqcgfTb97uV": "<p>Sometimes, setting up a <a href=\"#root/_help_WOcw2SLH6tbX\">dedicated server installation</a> is not feasible. The desktop application ships with a fully functional server instance by default.</p><p>For security reasons, this feature is <strong>not enabled</strong> by default. To enable it, enable <em>Network access</em> in&nbsp;<a class=\"reference-link\" href=\"#root/_help_fiHicjpHjIRJ\">Security</a>.</p><p>After enabling network access and restarting the application, you can access this web interface locally by navigating to <a href=\"http://localhost:37840/login\">http://localhost:37840/login</a>.</p><aside class=\"admonition note\"><p>The server embedded in the desktop application will only run as long as the desktop application itself is running. So closing the application will also close the server. To overcome this, you can try hiding the application in the system tray.</p></aside><h2>Mobile interface</h2><p>By default, this will display the desktop user interface, even on mobile. To switch to the mobile version, simply go to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a>&nbsp;and select “Switch to the mobile version”.</p><h2>Allowing the port externally on Windows with Windows Defender Firewall</h2><p>First, find out the IP of your desktop server by running <code>ipconfig</code> in your local terminal. Then try accessing <code>http://&lt;ip&gt;:37840/login</code> on another device. If it doesn't work, then most likely the port is blocked by your operating system's firewall.</p><p>If you use Windows Defender Firewall:</p><ol><li>Go to Windows's start menu and look for “Windows Defender Firewall with Advanced Security”.</li><li>Go to “Inbound Rules” on the left tree, and select “New Rule” in the “Actions” sidebar on the right.</li><li>Select “Port” and press “Next”.</li><li>Type in <code>37840</code> in the “Specific local ports” section and then press “Next”.</li><li>Leave “Allow the connection” checked and press “Next”.</li><li>Configure the networks to apply to (check all if unsure) and then press “Next”.</li><li>Add an appropriate name to the rule (e.g. “Trilium Notes”) and press “Finish”.</li></ol><aside class=\"admonition warning\"><p>Since v0.104.0, the port used by Trilium is accessible only on <code>localhost</code>. To enable across the local network, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_swSFivWk6KkA\">Network Access</a>.</p></aside>",
+ "_help_Rp0q8bSP6Ayl": "<p>The desktop version of Trilium supports all three main operating systems:</p><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-windows\"></span>&nbsp;Windows</p><div class=\"trilium-tab-panel\"><ul><li>Windows 11 is officially supported.</li><li>Windows on ARM is also supported</li></ul></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-tux\"></span>&nbsp;Linux</p><div class=\"trilium-tab-panel\"><ul><li>Most modern distributions are supported, including NixOS.</li><li>ARM is supported in <code>aarch64</code> (no ARM v7 support).</li></ul></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-apple\"></span>&nbsp;macOS</p><div class=\"trilium-tab-panel\"><ul><li>Minimum supported operating system: macOS Ventura</li><li>Both Intel and Apple Silicon devices are supported.</li></ul></div></section></div>",
+ "_help_Un4wj2Mak2Ky": "<p>Since TriliumNext 0.94.1, the desktop and server applications can be built using <a href=\"https://nixos.org/\">Nix</a>.</p><h2>System requirements</h2><p>Installation of Nix on Mac or Linux (<a href=\"https://nixos.org/download/\">download page</a>). About 3-4 gigabytes of additional storage space, for build artifacts.</p><h2>Run directly</h2><p>Using <a href=\"https://nix.dev/manual/nix/stable/command-ref/new-cli/nix3-run.html\">nix run</a>, the desktop app can be started as: <code>nix run github:TriliumNext/Trilium/v0.95.0</code></p><p>Running the server requires explicitly specifying the desired package: <code>nix run github:TriliumNext/Trilium/v0.95.0#server</code></p><p>Instead of a version (<code>v0.95.0</code> above), you can also specify a commit hash (or a branch name). This makes it easy to test development builds.</p><h2>Install on NixOS</h2><p>Add to your <code>flake.nix</code>:</p><pre><code class=\"language-text-x-trilium-auto\">{\n inputs = {\n nixpkgs.url = # ...;\n trilium-notes = {\n url = \"github:TriliumNext/Trilium/v0.95.0\";\n inputs.nixpkgs.follows = \"nixpkgs\";\n };\n };\n\n outputs =\n {\n self,\n # ...\n trilium-notes,\n ...\n }:\n {\n nixosConfigurations = {\n \"nixos\" = nixpkgs.lib.nixosSystem {\n system = \"x86_64-linux\";\n modules = [\n ./configuration.nix\n ];\n specialArgs = {\n inherit\n trilium-notes\n ;\n };\n };\n };\n };\n}\n</code></pre><p>Add to your <code>configuration.nix</code>:</p><pre><code class=\"language-text-x-trilium-auto\">{\n # ...\n trilium-notes,\n ...\n}:\n\n{\n # ...\n\n services.trilium-server.package = trilium-notes.packages.x86_64-linux.server;\n\n environment.systemPackages = [\n trilium-notes.packages.x86_64-linux.desktop\n ];\n}</code></pre><p>The flake aims to be compatible with the latest NixOS stable and unstable.</p>",
+ "_help_swSFivWk6KkA": "<p>Prior to v0.104.0, the <a href=\"#root/_help_poXkQfguuA0U\">desktop application</a> would also open a network port so that it can offer access to&nbsp;<a class=\"reference-link\" href=\"#root/_help_pgxEVkzLl1OP\">ETAPI (REST API)</a>&nbsp;or even use it as a web server (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_nRqcgfTb97uV\">Using the desktop application as a server</a>).</p><p>In order to reduce the attack surface, Trilium now enables these services only for the local device (e.g. <code>localhost</code>) instead of serving them over the LAN.</p><p>To better understand what is affected, refer to the following table:</p><figure class=\"table\"><table><thead><tr><th>Feature</th><th>Network access OFF</th><th>Network access ON</th></tr></thead><tbody><tr><td><a class=\"reference-link\" href=\"#root/_help_MtPxeAWVAzMg\">Web Clipper</a></td><td>🔒️ <code>localhost</code> only (still accessible to the browser extension on the same device)</td><td>🌐 <code>localhost</code> + LAN</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_pgxEVkzLl1OP\">ETAPI (REST API)</a></td><td>🔒️ <code>localhost</code> only</td><td>🌐 <code>localhost</code> + LAN</td></tr><tr><td><a href=\"#root/_help_GBBMSlVSOIGP\">LLM MCP</a> (only if enabled in settings)</td><td>🔒️ <code>localhost</code> only (needs auth)</td><td>🌐 <code>localhost</code> + LAN (needs auth)</td></tr><tr><td><a href=\"#root/_help_nRqcgfTb97uV\">Web app</a></td><td>❌️ completely disabled (403), only the desktop app is usable.</td><td>🌐 <code>localhost</code> + LAN</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_R9pX4DGra2Vt\">Sharing</a>&nbsp;notes</td><td>❌️ completely disabled (403), if you are using&nbsp;<a class=\"reference-link\" href=\"#root/_help_cbkrhQjrkKrh\">Synchronization</a>&nbsp;this will still work as part of the <a href=\"#root/_help_WOcw2SLH6tbX\">server</a>.</td><td>🌐 <code>localhost</code> + LAN</td></tr></tbody></table></figure>",
+ "_help_7iwde4lsKc6O": "<aside class=\"admonition note\"><p>Automatic startup and better integration with the system tray was introduced in v0.104.0. Versions prior to that only have the system tray option which could be found in&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Others</em>.</p></aside><h2>Tray icon</h2><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:332/71;\" src=\"{{helpAssets}}/User%20Guide/Installation%20%26%20Setup/Desktop%20Installation/Tray%20icon%20%26%20automatic%20startup_image.png\" width=\"332\" height=\"71\"></figure><p>The desktop application has native integration with the system tray on all operating systems.</p><p>The tray icon is enabled by default, but it can be toggled from&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Desktop</em>.</p><p>The tray icon has the following functionality:</p><ul><li>When clicked, the last window is hidden (minimized to the tray icon). Clicking it again will reveal that window.</li><li>Right clicking reveals the following options:<ul><li>Each window can be individually shown or hidden, identified by their active note.</li><li>New windows can be opened.</li><li>A new note can be created directly, which will be created in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_S0Fos78ZfcY7\">Note Inbox</a>&nbsp;(or&nbsp;<a class=\"reference-link\" href=\"#root/_help_l0tKav7yLHGF\">Day Notes</a>&nbsp;if an inbox is not available).</li><li>Today's day note can be opened.</li><li>Bookmarks and recent notes are displayed in a sub-menu and clicking them navigates to that note.</li><li>Quitting the application.</li></ul></li></ul><h3>Closing to system tray</h3><p>This is an option which is not enabled by default and it allows a specific behavior: instead of exiting the application when the last window has been closed, the last window is instead hidden with the tray icon remaining available.</p><p>This option requires the tray icon to be enabled, otherwise it has no effect.</p><h2>Automatic startup</h2><p>Two options control the automatic startup functionality in&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Startup</em>:</p><ul><li>When <em>Launch on startup</em> is enabled, the application will automatically start up when logging into the current user.<ul><li>Note that on Linux support depends on the desktop environment. Feel free to <a href=\"#root/_help_wy8So3yZZlH9\">report</a> any issues.</li></ul></li><li>If <em>Start minimized to tray</em> is also enabled, the application will start up in the background and can be revealed from the tray icon.<ul><li>This only applies if <em>Launch on startup</em> is enabled, manual starts are not impacted by this option.</li></ul></li></ul><h3>Linux: custom launch command for packagers</h3><p>On Linux, <em>Launch on startup</em> writes a <code>trilium.desktop</code> entry to the user's autostart directory (<code>$XDG_CONFIG_HOME/autostart</code>, usually <code>~/.config/autostart</code>). Its <code>Exec</code> line points to the AppImage when running from one, or to the running executable otherwise.</p><p>Distribution packages that run Trilium on a system-wide Electron (for example <code>electron /usr/lib/trilium/app.asar</code>) cannot rely on the running executable, since it is the bare Electron binary, which starts without Trilium. Such packages can set the <code>TRILIUM_LAUNCH_EXEC</code> environment variable, typically in their wrapper script, to the full command that starts Trilium:</p><pre><code class=\"language-text-x-trilium-auto\">export TRILIUM_LAUNCH_EXEC='electron \"/usr/lib/trilium/app.asar\"'</code></pre><p>The value is written to the <code>Exec</code> line as-is, so any paths containing spaces must already be quoted. When <em>Start minimized to tray</em> is enabled, <code>--start-hidden</code> is appended to it. <code>TRILIUM_LAUNCH_EXEC</code> takes precedence over both the AppImage path and the running executable.</p>",
+ "_help_hvRfsDr591WP": "<h2>Trilium only shows a blank window</h2><p>Trilium uses Electron which is based on Chromium (the open-source alternative to Google Chrome); in order to improve performance it makes use of <em>GPU acceleration</em>. In some cases, a GPU incompatibility (especially on older models of integrated graphics) can cause nothing to render at all, resulting in a blank window.&nbsp;</p><p>To bypass this, try running Trilium with the following command line argument:</p><pre><code class=\"language-text-x-trilium-auto\">trilium --disable-gpu</code></pre><p>If that doesn't work, try the following commands as well:</p><ul><li><code>trilium --disable-gpu-compositing</code></li><li><code>ELECTRON_OZONE_PLATFORM_HINT=x11 trilium</code> (this one forces the rendering to X11 on Wayland)</li></ul><p>If Trilium renders fine after this, Trilium offers a built-in option to disable GPU acceleration: go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Appearance</em>, look for the <em>Performance</em> section and then uncheck <em>Hardware acceleration (GPU)</em>.</p>",
+ "_help_WOcw2SLH6tbX": "<p>This guide outlines the steps to install Trilium on your own server. You might consider this option if you want to set up <a href=\"#root/_help_cbkrhQjrkKrh\">synchronization</a> or use Trilium in a browser - accessible from anywhere.</p><h2>Installation Options</h2><p>There are several ways to install Trilium on a server, each with its own advantages:</p><ul><li><strong>Recommended</strong>: <a href=\"#root/_help_rWX5eY045zbE\">Docker Installation</a> - Available for <strong>AMD64</strong> and <strong>ARM</strong> architectures.</li><li><a href=\"#root/_help_3tW6mORuTHnB\">Packaged Server Installation</a></li><li><a href=\"https://www.pikapods.com/pods?run=trilium-next\">PikaPods managed hosting</a></li><li><a href=\"#root/_help_J1Bb6lVlwU5T\">Manual Installation</a></li><li><a href=\"#root/_help_DCmT6e7clMoP\">Kubernetes</a></li><li><a href=\"https://www.cloudron.io/store/com.github.trilium.cloudronapp.html\">Cloudron</a></li><li><a href=\"https://homelabos.com/docs/software/trilium/\">HomelabOS</a></li><li><a href=\"#root/_help_moVgBcoxE3EK\">NixOS Module</a></li></ul><p>The server installation includes both web and <a href=\"#root/_help_RDslemsQ6gCp\">mobile frontends</a>.</p><h2>Configuration</h2><p>After setting up your server installation, you may want to configure settings such as the port or enable <a href=\"#root/_help_l2VkvOwUNfZj\">TLS</a>. Configuration is managed via the Trilium <code>config.ini</code> file, which is located in the <a href=\"#root/_help_tAassRL4RSQL\">data directory</a> by default. To begin customizing your setup, copy the provided <code>config-sample.ini</code> file with default values to <code>config.ini</code>.</p><p>You can also review the <a href=\"#root/_help_Gzjqa934BdH4\">configuration</a> file to provide all <code>config.ini</code> values as environment variables instead.</p><h3>Config Location</h3><p>By default, <code>config.ini</code>, the <a href=\"#root/_help_wX4HbRucYSDD\">database</a>, and other important Trilium data files are stored in the <a href=\"#root/_help_tAassRL4RSQL\">data directory</a>. If you prefer a different location, you can change it by setting the <code>TRILIUM_DATA_DIR</code> environment variable:</p><pre><code class=\"language-text-x-trilium-auto\">export TRILIUM_DATA_DIR=/home/myuser/data/my-trilium-data</code></pre><h3>Disabling Authentication</h3><p>See&nbsp;<a class=\"reference-link\" href=\"#root/_help_0hzsNCP31IAB\">Authentication</a>.</p><h2>Reverse Proxy Setup</h2><p>To configure a reverse proxy for Trilium, you can use either <strong>nginx</strong> or <strong>Apache</strong>. You can also check out the documentation stored in the Reverse proxy folder.</p><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">nginx</p><div class=\"trilium-tab-panel\"><p>Add the following configuration to your <code>nginx</code> setup to proxy requests to Trilium:</p><pre><code class=\"language-text-x-trilium-auto\">location /trilium/ {\n proxy_pass http://127.0.0.1:8080/;\n proxy_http_version 1.1;\n proxy_set_header Upgrade $http_upgrade;\n proxy_set_header Connection 'upgrade';\n proxy_set_header Host $host;\n proxy_cache_bypass $http_upgrade;\n}</code></pre><p>To avoid limiting the size of payloads, include this in the <code>server {}</code> block:</p><pre><code class=\"language-text-x-trilium-auto\"># Set to 0 for unlimited. Default is 1M.\nclient_max_body_size 0;</code></pre></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">Apache</p><div class=\"trilium-tab-panel\"><p>For an Apache setup, refer to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_fDLvzOx29Pfg\">Apache using Docker</a>&nbsp;guide.</p></div></section></div>",
+ "_help_3tW6mORuTHnB": "<p>This is essentially Trilium sources + node modules + node.js runtime packaged into one 7z file.</p><h2>Steps</h2><ul><li>SSH into your server</li><li>use <code>wget</code> (or <code>curl</code>) to download latest <code>TriliumNotes-Server-[VERSION]-linux-x64.tar.xz</code> (copy link from <a href=\"https://github.com/TriliumNext/Trilium/releases\">release page</a>, notice <code>-Server</code> suffix) on your server.</li><li>unpack the archive, e.g. using <code>tar -xf -d TriliumNotes-Server-[VERSION]-linux-x64.tar.xz</code></li><li><code>cd trilium-linux-x64-server</code></li><li><code>./trilium.sh</code></li><li>you can open the browser and open http://[your-server-hostname]:8080 and you should see Trilium initialization page</li></ul><p>The problem with above steps is that once you close the SSH connection, the Trilium process is terminated. To avoid that, you have two options:</p><ul><li>Kill it (with e.g. <kbd>Ctrl</kbd> + <kbd>C</kbd>) and run again like this: <code>nohup ./trilium.sh &amp;</code>. (nohup keeps the process running in the background, <code>&amp;</code> runs it in the background)</li><li>Configure systemd to automatically run Trilium in the background on every boot</li></ul><h2>Configure Trilium to auto-run on boot with systemd</h2><ul><li>After downloading, extract and move Trilium:</li></ul><pre><code class=\"language-text-x-trilium-auto\">tar -xvf TriliumNotes-Server-[VERSION]-linux-x64.tar.xz\nsudo mv trilium-linux-x64-server /opt/trilium</code></pre><ul><li>Create the service:</li></ul><pre><code class=\"language-text-x-trilium-auto\">sudo nano /etc/systemd/system/trilium.service</code></pre><ul><li>Paste this into the file (replace the user and group as needed):</li></ul><pre><code class=\"language-text-x-trilium-auto\">[Unit]\nDescription=Trilium Daemon\nAfter=syslog.target network.target\n\n[Service]\nUser=xxx\nGroup=xxx\nType=simple\nExecStart=/opt/trilium/trilium.sh\nWorkingDirectory=/opt/trilium/\n\nTimeoutStopSec=20\n# KillMode=process leads to error, according to https://www.freedesktop.org/software/systemd/man/systemd.kill.html\nRestart=always\n\n[Install]\nWantedBy=multi-user.target</code></pre><ul><li>Save the file (CTRL-S) and exit (CTRL-X)</li><li>Enable and launch the service:</li></ul><pre><code class=\"language-text-x-trilium-auto\">sudo systemctl enable --now -q trilium</code></pre><ul><li>You can now open a browser to http://[your-server-hostname]:8080 and you should see the Trilium initialization page.</li></ul><h2>Simple auto-update for Server</h2><p>The script is available in&nbsp;<a class=\"reference-link\" href=\"#root/_help_ZNAjFcxqHr9V\">Simple auto-update for server</a>.</p><ul><li><p>Run as the same User Trilium runs.</p><ul><li>If you run as <code>root</code> please remove <code>sudo</code> from the commands.</li></ul></li><li><p>Requires <code>jq</code>:</p><pre><code class=\"language-text-x-sh\">apt install jq</code></pre></li></ul><p>It will stop the service above, overwrite everything (expecting no <code>config.ini</code>), and start service. It also creates a version file in the Trilium directory so it updates only with a newer version.</p><h2>Common issues</h2><h3>Outdated glibc</h3><pre><code class=\"language-text-x-trilium-auto\">Error: /usr/lib64/libstdc++.so.6: version `GLIBCXX_3.4.21' not found (required by /var/www/virtual/.../node_modules/@mlink/scrypt/build/Release/scrypt.node)\n at Object.Module._extensions..node (module.js:681:18)\n at Module.load (module.js:565:32)\n at tryModuleLoad (module.js:505:12)</code></pre><p>If you get an error like this, you need to either upgrade your glibc (typically by upgrading to up-to-date distribution version) or use some other <a href=\"#root/_help_WOcw2SLH6tbX\">server installation</a> method.</p><h2>TLS</h2><p>Don't forget to <a href=\"#root/_help_l2VkvOwUNfZj\">configure TLS</a>, which is required for secure usage!</p>",
+ "_help_ZNAjFcxqHr9V": "#!/bin/bash\n\n# Configuration\nREPO=\"TriliumNext/Trilium\"\nPATTERN=\"TriliumNotes-Server-.*-linux-x64.tar.xz\"\nDOWNLOAD_DIR=\"/var/tmp/trilium_download\"\nOUTPUT_DIR=\"/opt/trilium\"\nSERVICE_NAME=\"trilium\"\nVERSION_FILE=\"$OUTPUT_DIR/version.txt\"\n\n# Ensure dependencies are installed\ncommand -v curl >/dev/null 2>&1 || { echo \"Error: curl is required\"; exit 1; }\ncommand -v jq >/dev/null 2>&1 || { echo \"Error: jq is required\"; exit 1; }\ncommand -v tar >/dev/null 2>&1 || { echo \"Error: tar is required\"; exit 1; }\n\n# Create download directory\nmkdir -p \"$DOWNLOAD_DIR\" || { echo \"Error: Cannot create $DOWNLOAD_DIR\"; exit 1; }\n\n# Get the latest release version\nLATEST_VERSION=$(curl -sL https://api.github.com/repos/$REPO/releases/latest | jq -r '.tag_name')\nif [ -z \"$LATEST_VERSION\" ]; then\n echo \"Error: Could not fetch latest release version\"\n exit 1\nfi\n\n# Check current installed version (from version.txt or existing tarball)\nCURRENT_VERSION=\"\"\nif [ -f \"$VERSION_FILE\" ]; then\n CURRENT_VERSION=$(cat \"$VERSION_FILE\")\nelif [ -f \"$DOWNLOAD_DIR/TriliumNotes-Server-$LATEST_VERSION-linux-x64.tar.xz\" ]; then\n CURRENT_VERSION=\"$LATEST_VERSION\"\nfi\n\n# Compare versions\nif [ \"$CURRENT_VERSION\" = \"$LATEST_VERSION\" ]; then\n echo \"Latest version ($LATEST_VERSION) is already installed\"\n exit 0\nfi\n\n# Download the latest release\nLATEST_URL=$(curl -sL https://api.github.com/repos/$REPO/releases/latest | jq -r \".assets[] | select(.name | test(\\\"$PATTERN\\\")) | .browser_download_url\")\nif [ -z \"$LATEST_URL\" ]; then\n echo \"Error: No asset found matching pattern '$PATTERN'\"\n exit 1\nfi\n\nFILE_NAME=$(basename \"$LATEST_URL\")\nFILE_PATH=\"$DOWNLOAD_DIR/$FILE_NAME\"\n\n# Download if not already present\nif [ -f \"$FILE_PATH\" ]; then\n echo \"Latest release $FILE_NAME already downloaded\"\nelse\n curl -LO --output-dir \"$DOWNLOAD_DIR\" \"$LATEST_URL\" || { echo \"Error: Download failed\"; exit 1; }\n echo \"Downloaded $FILE_NAME to $DOWNLOAD_DIR\"\nfi\n\n# Extract the tarball\nEXTRACT_DIR=\"$DOWNLOAD_DIR/extracted\"\nmkdir -p \"$EXTRACT_DIR\"\ntar -xJf \"$FILE_PATH\" -C \"$EXTRACT_DIR\" || { echo \"Error: Extraction failed\"; exit 1; }\n\n# Find the extracted directory (e.g., TriliumNotes-Server-0.97.2-linux-x64)\nINNER_DIR=$(find \"$EXTRACT_DIR\" -maxdepth 1 -type d -name \"TriliumNotes-Server-*-linux-x64\" | head -n 1)\nif [ -z \"$INNER_DIR\" ]; then\n echo \"Error: Could not find extracted directory matching TriliumNotes-Server-*-linux-x64\"\n exit 1\nfi\n\n# Stop the trilium-server service\nif systemctl is-active --quiet \"$SERVICE_NAME\"; then\n echo \"Stopping $SERVICE_NAME service...\"\n sudo systemctl stop \"$SERVICE_NAME\" || { echo \"Error: Failed to stop $SERVICE_NAME\"; exit 1; }\nfi\n\n# Copy contents to /opt/trilium, overwriting existing files\necho \"Copying contents from $INNER_DIR to $OUTPUT_DIR...\"\nsudo mkdir -p \"$OUTPUT_DIR\"\nsudo cp -r \"$INNER_DIR\"/* \"$OUTPUT_DIR\"/ || { echo \"Error: Copy failed\"; exit 1; }\necho \"$LATEST_VERSION\" | sudo tee \"$VERSION_FILE\" >/dev/null\necho \"Files copied to $OUTPUT_DIR\"\n\n# Start the trilium-server service\necho \"Starting $SERVICE_NAME service...\"\nsudo systemctl start \"$SERVICE_NAME\" || { echo \"Error: Failed to start $SERVICE_NAME\"; exit 1; }\n\n# Clean up\nrm -rf \"$EXTRACT_DIR\"\necho \"Cleanup complete. Trilium updated to $LATEST_VERSION.\"",
+ "_help_rWX5eY045zbE": "<p>Official docker images are published on docker hub for <strong>AMD64</strong>, <strong>ARMv7</strong> and <strong>ARM64/v8</strong>: <a href=\"https://hub.docker.com/r/triliumnext/trilium/\">https://hub.docker.com/r/triliumnext/trilium/</a></p><h2>Prerequisites</h2><p>Ensure Docker is installed on your system.</p><p>If you need help installing Docker, reference the <a href=\"https://docs.docker.com/engine/install/\">Docker Installation Docs</a></p><p>By default, the container starts as root, prepares the data directory and then runs Trilium as an unprivileged user. It can also run entirely without root, as described in <em>Running as a non-root user</em> below.</p><aside class=\"admonition warning\"><p>If you're using a SMB/CIFS share or folder as your Trilium data directory, <a href=\"https://github.com/TriliumNext/Notes/issues/415#issuecomment-2344824400\">you'll need</a> to add the mount options of <code>nobrl</code> and <code>noperm</code> when mounting your SMB share.</p></aside><h2>Running with Docker Compose</h2><h3>Grab the latest docker-compose.yml:</h3><pre><code class=\"language-text-x-trilium-auto\">wget https://raw.githubusercontent.com/TriliumNext/Trilium/master/docker-compose.yml</code></pre><p>Optionally, edit the <code>docker-compose.yml</code> file to configure the container settings prior to starting it. Unless configured otherwise, the data directory will be <code>trilium-data</code> next to <code>docker-compose.yml</code> and the container will be accessible at port 8080.</p><p>To keep the data somewhere else, edit the <code>volumes</code> entry in <code>docker-compose.yml</code> and change the host path before the colon (for example <code>- /srv/trilium-data:/home/node/trilium-data</code>). Leave the path after the colon unchanged.</p><h3>Start the container:</h3><p>Run the following command to start the container in the background:</p><pre><code class=\"language-text-x-trilium-auto\">docker compose up -d</code></pre><h2>Running without Docker Compose / Further Configuration</h2><h3>Pulling the Docker Image</h3><p>To pull the image, use the following command, replacing <code>[VERSION]</code> with the desired version or tag, such as <code>v0.91.6</code> or just <code>latest</code>. (See published tag names at <a href=\"https://hub.docker.com/r/triliumnext/trilium/tags\">https://hub.docker.com/r/triliumnext/trilium/tags</a>.):</p><pre><code class=\"language-text-x-trilium-auto\">docker pull triliumnext/trilium:v0.91.6</code></pre><p><strong>Warning:</strong> Avoid using the \"latest\" tag, as it may automatically upgrade your instance to a new minor version, potentially disrupting sync setups or causing other issues.</p><h3>Preparing the Data Directory</h3><p>Trilium requires a directory on the host system to store its data. This directory must be mounted into the Docker container with write permissions.</p><h3>Running the Docker Container</h3><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">Local Access Only</p><div class=\"trilium-tab-panel\"><p>Run the container to make it accessible only from the localhost. This setup is suitable for testing or when using a proxy server like Nginx or Apache.</p><pre><code class=\"language-text-x-sh\">sudo docker run -t -i -p 127.0.0.1:8080:8080 \\\n\t-v ~/trilium-data:/home/node/trilium-data \\\n\ttriliumnext/trilium:[VERSION]</code></pre><ol><li>Verify the container is running using <code>docker ps</code>.</li><li>Access Trilium via a web browser at <code>127.0.0.1:8080</code>.</li></ol></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">Local Network Access</p><div class=\"trilium-tab-panel\"><p>To make the container accessible only on your local network, first create a new Docker network:</p><pre><code class=\"language-text-x-sh\">docker network create -d macvlan -o parent=eth0 --subnet 192.168.2.0/24 --gateway 192.168.2.254 --ip-range 192.168.2.252/27 mynet</code></pre><p>Then, run the container with the network settings:</p><pre><code class=\"language-text-x-sh\">docker run --net=mynet -d -p 127.0.0.1:8080:8080 -v ~/trilium-data:/home/node/trilium-data triliumnext/trilium:-latest</code></pre><p>To set a different user ID (UID) and group ID (GID) for the saved data, use the <code>USER_UID</code> and <code>USER_GID</code> environment variables:</p><pre><code class=\"language-text-x-sh\">docker run --net=mynet -d -p 127.0.0.1:8080:8080 -e \"USER_UID=1001\" -e \"USER_GID=1001\" -v ~/trilium-data:/home/node/trilium-data triliumnext/trilium:-latest</code></pre><p>Find the local IP address using <code>docker inspect [container_name]</code> and access the service from devices on the local network.</p><pre><code class=\"language-text-x-sh\">docker ps\ndocker inspect [container_name]</code></pre></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">Global Access</p><div class=\"trilium-tab-panel\"><p>To allow access from any IP address, run the container as follows:</p><pre><code class=\"language-text-x-sh\">docker run -d -p 0.0.0.0:8080:8080 \\\n\t-v ~/trilium-data:/home/node/trilium-data \\\n\ttriliumnext/trilium:[VERSION]</code></pre><p>Stop the container with <code>docker stop &lt;CONTAINER ID&gt;</code>, where the container ID is obtained from <code>docker ps</code>.</p></div></section></div><h3>Custom Data Directory</h3><p>For a custom data directory, use:</p><pre><code class=\"language-text-x-trilium-auto\">-v ~/YourOwnDirectory:/home/node/trilium-data triliumnext/trilium:[VERSION]</code></pre><p>If you want to run your instance in a non-default way, please use the volume switch as follows: <code>-v ~/YourOwnDirectory:/home/node/trilium-data triliumnext/trilium:&lt;VERSION&gt;</code>. It is important to be aware of how Docker works for volumes, with the first path being your own and the second the one to virtually bind to. <a href=\"https://docs.docker.com/storage/volumes/\">https://docs.docker.com/storage/volumes/</a> The path before the colon is the host directory, and the path after the colon is the container's path. More details can be found in the <a href=\"https://docs.docker.com/storage/volumes/\">Docker Volumes Documentation</a>.</p><h2>Reverse Proxy</h2><ol><li><a href=\"#root/_help_ud6MShXL4WpO\">Nginx</a></li><li><a href=\"#root/_help_fDLvzOx29Pfg\">Apache</a></li></ol><h3>Note on timezones</h3><p>If you are having timezone issues and you are not using docker-compose, you may need to add a <code>TZ</code> environment variable with the <a href=\"https://en.wikipedia.org/wiki/List_of_tz_database_time_zones\">TZ identifier</a> of your local timezone.</p><h3>Other environment variables</h3><p>For the complete list of environment variables Trilium reads (network settings, authentication, sync, etc.), see&nbsp;<a class=\"reference-link\" href=\"#root/_help_Gzjqa934BdH4\">Configuration (config.ini or environment variables)</a>.</p><h2>Running as a non-root user</h2><p>By default, the container starts as root, gives the data directory to the <code>node</code> user (UID and GID <code>1000</code>, or the values of <code>USER_UID</code> and <code>USER_GID</code>) and then runs Trilium as that user. Some environments do not allow a container to start as root at all, for example rootless Docker or Podman, or Kubernetes with <code>runAsNonRoot</code>. Starting with v0.107.0, the same image can run entirely as a non-root user instead.</p><p>To run Trilium as a non-root user, set the user with Docker's <code>--user</code> flag:</p><pre><code class=\"language-text-x-sh\">docker run -d -p 8080:8080 --user 1000:1000 -v /srv/trilium-data:/home/node/trilium-data triliumnext/trilium:[VERSION]</code></pre><p>With Docker Compose, add <code>user:</code> to the service in <code>docker-compose.yml</code>:</p><pre><code class=\"language-text-x-yaml\">services:\n trilium:\n user: \"1000:1000\"</code></pre><p>The image also runs with a read-only root filesystem and without any capabilities, for example with <code>--read-only --tmpfs /tmp --cap-drop ALL --security-opt no-new-privileges</code>.</p><p>Without root, the container cannot change the ownership of files, so:</p><ul><li><p>The data directory on the host must exist and belong to that user before the container starts. If the directory is missing, Docker creates it as root, and Trilium cannot write to it. For example:</p><pre><code class=\"language-text-x-sh\">mkdir -p /srv/trilium-data\nsudo chown 1000:1000 /srv/trilium-data</code></pre></li><li><p>A named volume instead of a host directory only works for UID <code>1000</code>: Docker gives a new volume the owner of the image's data directory, which is the <code>node</code> user.</p></li><li><p><code>USER_UID</code> and <code>USER_GID</code> are ignored. The user comes from <code>--user</code> or <code>user:</code> alone.</p></li></ul><p>If Trilium cannot use its data directory, it stops at startup and prints which directory or files it cannot use, who owns them, and the command that fixes it.</p><aside class=\"admonition note\"><p>An installation that ran as root leaves its files owned by UID <code>1000</code>, or by <code>USER_UID</code> if it was set. To switch it to <code>--user</code>, either use that same UID, or give the data directory to the new user first, for example with <code>sudo chown -R 1001:1001 /srv/trilium-data</code>.</p></aside>",
+ "_help_moVgBcoxE3EK": "<p>This page describes configuring the Trilium module included in NixOS.</p><h2>Requirements</h2><p><a href=\"https://nixos.org/\">NixOS</a> installation.</p><h2>Configuration</h2><p>Add this to your <code>configuration.nix</code>:</p><pre><code class=\"language-text-x-trilium-auto\">services.trilium-server.enable = true;\n\n# default data directory: /var/lib/trilium\n#services.trilium-server.dataDir = \"/var/lib/trilium-sync-server\";\n\n# default bind address: 127.0.0.1, port 8080\n#services.trilium-server.host = \"0.0.0.0\";\n#services.trilium-server.port = 12783;</code></pre><p>Uncomment any option you would like to change.</p><p>See the <a href=\"https://search.nixos.org/options?channel=unstable&amp;from=0&amp;size=50&amp;sort=relevance&amp;type=packages&amp;query=trilium-server\">NixOS options list</a> for more options (including nginx reverse proxy configuration).</p>",
+ "_help_J1Bb6lVlwU5T": "<aside class=\"admonition warning\"><p>This page describes manually installing Trilium on your server. <strong>Note that this is a not well supported way to install Trilium, problems may appear, information laid out here is quite out of date. It is recommended to use either</strong>&nbsp;<a class=\"reference-link\" href=\"#root/_help_rWX5eY045zbE\">Docker Server Installation</a>&nbsp;<strong>or</strong>&nbsp;<a class=\"reference-link\" href=\"#root/_help_3tW6mORuTHnB\">Packaged server installation</a><strong>.</strong></p></aside><h2>Requirements</h2><p>Trilium is a node.js application. Supported (tested) version of node.js is latest 14.X.X and 16.X.X. Trilium might work with older versions as well.</p><p>You can check your node version with this command (node.js needs to be installed):</p><pre><code class=\"language-text-x-trilium-auto\">node --version</code></pre><p>If your Linux distribution has only an outdated version of node.js, you can take a look at the installation instruction on node.js website, which covers most popular distributions.</p><h3>Dependencies</h3><p>There are some dependencies required. You can see command for Debian and its derivatives (like Ubuntu) below:</p><pre><code class=\"language-text-x-trilium-auto\">sudo apt install libpng16-16 libpng-dev pkg-config autoconf libtool build-essential nasm libx11-dev libxkbfile-dev</code></pre><h2>Installation</h2><h3>Download</h3><p>You can either download source code zip/tar from <a href=\"https://github.com/TriliumNext/Trilium/releases/latest\">https://github.com/TriliumNext/Trilium/releases/latest</a>.</p><p>For the latest version including betas, clone Git repository <strong>from</strong> <code>main</code> <strong>branch</strong> with:</p><pre><code class=\"language-text-x-trilium-auto\">git clone -b main https://github.com/triliumnext/trilium.git</code></pre><h2>Installation</h2><pre><code class=\"language-text-x-trilium-auto\">cd trilium\n\n# download all node dependencies\nnpm install\n\n# make sure the better-sqlite3 binary is there\nnpm rebuild\n\n# bundles &amp; minifies frontend JavaScript\nnpm run webpack</code></pre><h2>Run</h2><pre><code class=\"language-text-x-trilium-auto\">cd trilium\n\n# using nohup to make sure trilium keeps running after user logs out\nnohup TRILIUM_ENV=dev node src/www &amp;</code></pre><p>The application by default starts up on port 8080, so you can open your browser and navigate to <a href=\"http://localhost:8080\">http://localhost:8080</a> to access Trilium (replace \"localhost\" with your hostname).</p><h2>TLS</h2><p>Don't forget to <a href=\"#root/_help_l2VkvOwUNfZj\">configure TLS</a> which is required for secure usage!</p>",
+ "_help_DCmT6e7clMoP": "<p>As Trilium can be run in Docker it also can be deployed in Kubernetes. You can either use our Helm chart, a community Helm chart, or roll your own Kubernetes deployment.</p><p>The recommended way is to use a Helm chart.</p><h2>Root privileges</h2><p>By default, the Trilium container starts as root, gives the data directory to UID and GID <code>1000:1000</code> and then runs Trilium with those reduced privileges, so no init container is needed to fix the permissions. To use a different UID and GID, set the <code>USER_UID</code> and <code>USER_GID</code> environment variables.</p><p>Starting with v0.107.0, the container can also run without root, which a <code>restricted</code> Pod Security Standard requires. Set the user in the pod's security context, and <code>fsGroup</code> so that Kubernetes gives the volume to that group:</p><pre><code class=\"language-text-x-yaml\">securityContext:\n runAsUser: 1000\n runAsGroup: 1000\n runAsNonRoot: true\n fsGroup: 1000</code></pre><p>In that mode <code>USER_UID</code> and <code>USER_GID</code> are ignored. See the section on running as a non-root user in&nbsp;<a class=\"reference-link\" href=\"#root/_help_rWX5eY045zbE\">Using Docker</a> for what the data directory needs.</p><h2>Helm Charts</h2><p><a href=\"https://github.com/TriliumNext/helm-charts\">Official Helm chart</a> from TriliumNext Unofficial helm chart by <a href=\"https://github.com/ohdearaugustin\">ohdearaugustin</a>: <a href=\"https://github.com/ohdearaugustin/charts\">https://github.com/ohdearaugustin/charts</a></p><h2>Adding a Helm repository</h2><p>Below is an example of how</p><pre><code class=\"language-text-x-trilium-auto\">helm repo add trilium https://triliumnext.github.io/helm-charts\n\"trilium\" has been added to your repositories</code></pre><h2>How to install a chart</h2><p>After reviewing the <a href=\"https://github.com/TriliumNext/helm-charts/blob/main/charts/trilium/values.yaml\"><code>values.yaml</code></a> from the Helm chart, modifying as required and then creating your own:</p><pre><code class=\"language-text-x-trilium-auto\">helm install --create-namespace --namespace trilium trilium trilium/trilium -f values.yaml</code></pre><p>For more information on using Helm, please refer to the Helm documentation, or create a Discussion in the TriliumNext GitHub Organization.</p>",
+ "_help_klCWNks3ReaQ": "<p>Trilium does not support multiple users. In order to have two or more persons with their own set of notes, multiple server instances must be set up. It is also not possible to use multiple <a href=\"#root/_help_cbkrhQjrkKrh\">sync</a> servers.</p><p>To allow multiple server instances on a single physical server:</p><ul><li><p>For&nbsp;<a class=\"reference-link\" href=\"#root/_help_3tW6mORuTHnB\">Packaged version for Linux</a>&nbsp;or&nbsp;<a class=\"reference-link\" href=\"#root/_help_J1Bb6lVlwU5T\">Manually</a>, if starting the server manually just specify a different port and data directory per instance:</p><pre><code class=\"language-text-x-trilium-auto\">TRILIUM_NETWORK_PORT=8080 TRILIUM_DATA_DIR=/path/to/your/data-dir-A /opt/trilium/trilium.sh</code></pre><p>For a second instance:</p><pre><code class=\"language-text-x-trilium-auto\">TRILIUM_NETWORK_PORT=8081 TRILIUM_DATA_DIR=/path/to/your/data-dir-B /opt/trilium/trilium.sh</code></pre><p>If using <code>systemd</code>, then set the <a href=\"https://serverfault.com/questions/413397/how-to-set-environment-variable-in-systemd-service\">environment variables in the service configuration</a>.</p></li><li><p>For&nbsp;<a class=\"reference-link\" href=\"#root/_help_rWX5eY045zbE\">Using Docker</a>, simply use two different containers, each with their own port binding and data directory.</p></li><li><p>For&nbsp;<a class=\"reference-link\" href=\"#root/_help_moVgBcoxE3EK\">On NixOS</a>, the only possible way is to use Docker OCI containers or at least one NixOS container with its own service definition.</p></li></ul><p>For support or additional context, see the related <a href=\"https://github.com/orgs/TriliumNext/discussions/1642#discussioncomment-12768808\">GitHub Discussion</a>.</p>",
+ "_help_vcjrb3VVYPZI": "<p>Trilium is typically exposed to the internet behind a <strong>reverse proxy</strong>, which handles TLS termination, presents a single public entry point, and (optionally) lets you host multiple instances under one domain. Trilium itself keeps running on plain HTTP on its local port; the proxy sits in front of it.</p><p>This section collects provider-specific guides and the configuration that applies regardless of which proxy you use.</p><h2>Provider guides</h2><ul><li><a class=\"reference-link\" href=\"#root/_help_ud6MShXL4WpO\">Nginx</a></li><li><a class=\"reference-link\" href=\"#root/_help_5ERVJb9s4FRD\">Traefik</a></li><li><a class=\"reference-link\" href=\"#root/_help_fDLvzOx29Pfg\">Apache using Docker</a></li></ul><h2>Applies to every proxy</h2><p>Regardless of the proxy you choose, make sure of the following:</p><ul><li><strong>Forward the WebSocket upgrade.</strong> Trilium uses a WebSocket for synchronization and live UI updates. Your proxy must pass the <code>Upgrade</code> and <code>Connection</code> headers through, otherwise the client will appear to load but never receive updates.</li><li><strong>Configure the trusted proxy.</strong> So that Trilium sees the real client IP (for rate limiting, logging, and secure cookies) rather than the proxy's address. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_LLzSMXACKhUs\">Trusted proxy</a>.</li><li><strong>Terminate TLS at the proxy.</strong> See&nbsp;<a class=\"reference-link\" href=\"#root/_help_l2VkvOwUNfZj\">HTTPS (TLS)</a>.</li></ul><h2>Putting an authentication proxy in front of Trilium</h2><p>Some setups place a <strong>forward-auth / SSO layer</strong> (Authelia, Authentik, oauth2-proxy, or an OIDC plugin) at the proxy so that <em>every</em> request must pass an interactive login first.</p><p>This <strong>breaks synchronization and initial setup.</strong> Sync is a machine-to-machine process that runs unattended in the background — it has no browser and cannot complete an interactive login challenge. When the proxy intercepts a sync request, it returns its HTML login page instead of the expected JSON, and the client fails with an error such as:</p><pre><code class=\"language-text-x-trilium-auto\">Sync failed: Request to GET https://trilium.example.com/api/setup/status failed,\nerror: Unexpected token '&lt;', \"&lt;!doctype \"... is not valid JSON\n</code></pre><p>There are two ways to resolve this:</p><ul><li><strong>Preferred, use Trilium's built-in authentication.</strong> Don't gate Trilium at the proxy at all. Trilium can authenticate the web interface itself, including via <a href=\"#root/_help_x1lQNKQBqLcA\">OpenID Connect</a>. This leaves the sync endpoints free to authenticate the way they're designed to.</li><li><strong>Exempt the sync endpoints from the proxy's authentication.</strong> If you must keep auth at the proxy, exclude these paths from the forward-auth check:<ul><li><code>/api/setup/*</code></li><li><code>/api/login/sync</code></li><li><code>/api/sync/*</code></li></ul></li></ul><aside class=\"admonition note\"><p>This is safe: Trilium authenticates these endpoints itself. Sync uses a challenge-free HMAC handshake based on a shared secret, and the one-time setup seed request is password-protected — so exempting them at the proxy does not expose unauthenticated access to your data.</p></aside><p>An example for Nginx, where <code>/auth</code> is your forward-auth endpoint:</p><pre><code class=\"language-text-x-trilium-auto\">server {\n # ... TLS, server_name, etc. ...\n\n # Sync and setup endpoints authenticate themselves — skip forward-auth.\n location ~ ^/api/(sync|login/sync|setup) {\n auth_request off;\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header X-Forwarded-Proto $scheme;\n proxy_set_header Upgrade $http_upgrade;\n proxy_set_header Connection \"upgrade\";\n proxy_pass http://trilium;\n }\n\n # Everything else goes through forward-auth.\n location / {\n auth_request /auth;\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header X-Forwarded-Proto $scheme;\n proxy_set_header Upgrade $http_upgrade;\n proxy_set_header Connection \"upgrade\";\n proxy_pass http://trilium;\n }\n}</code></pre>",
+ "_help_ud6MShXL4WpO": "<p>Configure Nginx proxy and HTTPS. The operating system here is Ubuntu.</p><h2>Installing Nginx</h2><p>Download Nginx and remove Apache2</p><pre><code class=\"language-text-x-trilium-auto\">sudo apt-get install nginx\nsudo apt-get remove apache2</code></pre><h2>Build the configuration file</h2><ol><li><p>First, create the configuration file:</p><pre><code class=\"language-text-x-trilium-auto\">cd /etc/nginx/conf.d\nvim default.conf</code></pre></li><li><p>Fill the file with the context shown below, part of the setting show be changed. Then you can enjoy your web with HTTPS forced and proxy.</p><pre><code class=\"language-text-x-trilium-auto\"># This part configures, where your Trilium server is running\nupstream trilium {\n zone trilium 64k;\n server 127.0.0.1:8080; # change it to a different hostname and port if non-default is used\n keepalive 2;\n}\n\n# This part is for proxy and HTTPS configure\nserver {\n listen 443 ssl;\n server_name trilium.example.net; #change trilium.example.net to your domain without HTTPS or HTTP.\n ssl_certificate /etc/ssl/note/example.crt; #change /etc/ssl/note/example.crt to your path of crt file.\n ssl_certificate_key /etc/ssl/note/example.net.key; #change /etc/ssl/note/example.net.key to your path of key file.\n ssl_session_cache builtin:1000 shared:SSL:10m;\n ssl_protocols TLSv1 TLSv1.1 TLSv1.2;\n ssl_ciphers HIGH:!aNULL:!eNULL:!EXPORT:!CAMELLIA:!DES:!MD5:!PSK:!RC4;\n ssl_prefer_server_ciphers on;\n access_log /var/log/nginx/access.log; #check the path of access.log, if it doesn't fit your file, change it\n\n location / {\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header X-Forwarded-Proto $scheme;\n proxy_set_header Upgrade $http_upgrade;\n proxy_set_header Connection \"upgrade\";\n proxy_pass http://trilium;\n proxy_read_timeout 90;\n }\n}\n\n# This part is for HTTPS forced\nserver {\n listen 80;\n server_name trilium.example.net; # change to your domain\n return 301 https://$server_name$request_uri;\n}</code></pre></li></ol><h2>Serving under a different path</h2><p>Alternatively if you want to serve the instance under a different path (useful e.g. if you want to serve multiple instances), update the location block like so:</p><ul><li>update the location with your desired path (make sure to not leave a trailing slash \"/\", if your <code>proxy_pass</code> does not end on a slash as well)</li><li>add the <code>proxy_cookie_path</code> directive with the same path: this allows you to stay logged in at multiple instances at the same time.</li></ul><pre><code class=\"language-text-x-trilium-auto\"> location /trilium/instance-one {\n rewrite /trilium/instance-one/(.*) /$1 break;\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header X-Forwarded-Proto $scheme;\n proxy_set_header Upgrade $http_upgrade;\n proxy_set_header Connection \"upgrade\";\n proxy_pass http://trilium;\n proxy_cookie_path / /trilium/instance-one\n proxy_read_timeout 90;\n }</code></pre><h2>Configuring the trusted proxy</h2><p>After setting up a reverse proxy, make sure to configure the&nbsp;<a class=\"reference-link\" href=\"#root/_help_LLzSMXACKhUs\">Trusted proxy</a>.</p>",
+ "_help_fDLvzOx29Pfg": "<p>This tutorial assumes that you have created a DNS A record for <code>trilium.yourdomain.com</code> that you want to use for your Trilium server.</p><h2>Docker setup</h2><p>Download docker image and create container</p><pre><code class=\"language-text-x-trilium-auto\"> docker pull triliumnext/trilium:[VERSION]\n docker create --name trilium -t -p 127.0.0.1:8080:8080 -v ~/trilium-data:/home/node/trilium-data triliumnext/trilium:[VERSION]</code></pre><h2>Configuring the Apache proxy</h2><ol><li><p>Enable apache proxy modules</p><pre><code class=\"language-text-x-trilium-auto\"> a2enmod ssl\n a2enmod proxy\n a2enmod proxy_http\n a2enmod proxy_wstunnel</code></pre></li><li><p>Create a new let's encrypt certificate</p><pre><code class=\"language-text-x-trilium-auto\"> sudo certbot certonly -d trilium.mydomain.com</code></pre><p>Choose standalone (2) and note the location of the created certificates (typically /etc/letsencrypt/live/...)</p></li><li><p>Create a new virtual host file for apache (you may want to use <code>apachectl -S</code> to determine the server root location, mine is /etc/apache2)</p><pre><code class=\"language-text-x-trilium-auto\"> sudo nano /etc/apache2/sites-available/trilium.yourdomain.com.conf</code></pre><p>Paste (and customize) the following text into the configuration file</p><pre><code class=\"language-text-x-trilium-auto\"> \n ServerName http://trilium.yourdomain.com\n RewriteEngine on\n RewriteRule ^ https://%{SERVER_NAME}%{REQUEST_URI} [END,QSA,R=permanent]\n \n \n ServerName https://trilium.yourdomain.com\n RewriteEngine On\n RewriteCond %{HTTP:Connection} Upgrade [NC]\n RewriteCond %{HTTP:Upgrade} websocket [NC]\n RewriteRule /(.*) ws://localhost:8080/$1 [P,L]\n AllowEncodedSlashes NoDecode\n ProxyPass / http://localhost:8080/ nocanon\n ProxyPassReverse / http://localhost:8080/\n SSLCertificateFile /etc/letsencrypt/live/trilium.yourdomain.com/fullchain.pem\n SSLCertificateKeyFile /etc/letsencrypt/live/trilium.yourdomain.com/privkey.pem\n Include /etc/letsencrypt/options-ssl-apache.conf\n </code></pre></li><li><p>Enable the virtual host with <code>sudo a2ensite trilium.yourdomain.com.conf</code></p></li><li><p>Reload apache2 with <code>sudo systemctl reload apache2</code></p></li></ol><h2>Configuring the trusted proxy</h2><p>After setting up a reverse proxy, make sure to configure the&nbsp;<a class=\"reference-link\" href=\"#root/_help_LLzSMXACKhUs\">Trusted proxy</a>.</p><h2>Setup the systemd service to start up the server</h2><p>Create and enable a systemd service to start the docker container on boot</p><ol><li><p>Create a new empty file called <code>/lib/systemd/system/trilium.service</code> with the contents</p><pre><code class=\"language-text-x-trilium-auto\"> [Unit]\n Description=Trilium Server\n Requires=docker.service\n After=docker.service\n\n [Service]\n Restart=always\n ExecStart=/usr/bin/docker start -a trilium\n ExecStop=/usr/bin/docker stop -t 2 trilium\n\n [Install]\n WantedBy=local.target</code></pre></li><li><p>Install, enable and start service</p><pre><code class=\"language-text-x-trilium-auto\"> sudo systemctl daemon-reload\n sudo systemctl enable trilium.service\n sudo systemctl start trilium.service</code></pre></li></ol>",
+ "_help_LLzSMXACKhUs": "<p>If you are running the Trilium server under a <a href=\"#root/_help_vcjrb3VVYPZI\">reverse proxy</a>, it's important to configure it as a trusted proxy so that the application can correctly identify the real IP address of the clients (for authentication and rate limiting purposes).</p><p>To do so, simply modify&nbsp;<a class=\"reference-link\" href=\"#root/_help_Gzjqa934BdH4\">Configuration (config.ini or environment variables)</a>&nbsp;and set:</p><pre><code class=\"language-text-x-trilium-auto\">[Network]\ntrustedReverseProxy=true</code></pre><p>This will use the left-most IP in the <code>X-Forwarded-For</code> header. Alternatively, instead of <code>true</code> use the IP address of the reverse proxy or Express.js shortcuts such as:</p><pre><code class=\"language-text-x-trilium-auto\">loopback(127.0.0.1/8, ::1/128), linklocal(169.254.0.0/16, fe80::/10), uniquelocal(10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, fc00::/7)</code></pre><p>For more information, consult <a href=\"https://expressjs.com/en/guide/behind-proxies.html\">Express behind proxies</a>.</p>",
+ "_help_5ERVJb9s4FRD": "<p>The goal of this article is to configure Traefik proxy and HTTPS. See <a href=\"https://github.com/TriliumNext/Trilium/issues/7768#issuecomment-3539165814\">#7768</a> for reference.</p><h2>Breaking change in Traefik 3.6.4</h2><p>Traefik 3.6.4 introduced a <a href=\"https://doc.traefik.io/traefik/migrate/v3/#encoded-characters-in-request-path\">breaking change</a> regarding how percent-encoded characters are handled in URLs. Trilium puts the title of an image or attachment in its URL path, so one whose title contains <code>#</code> or <code>/</code> is requested at a path such as <code>/api/images/…/diagram%231.png</code>. Traefik rejects these paths with HTTP 400, and the image does not load. Search is not affected, because it sends its text in a query parameter.</p><p>The easiest solution is to update to Traefik 3.6.7 or later which reverts this configuration change. Alternatively, the configuration can be changed according to the section below.</p><details class=\"trilium-collapsible\"><summary>Configuration change</summary><p>To solve this, the Traefik <a href=\"https://doc.traefik.io/traefik/getting-started/configuration-overview/#the-install-configuration\"><strong>static</strong> configuration</a> must be modified in order to allow those characters:</p><pre><code class=\"language-text-x-yaml\">entryPoints:\n web:\n http:\n encodedCharacters:\n allowEncodedSlash: true\n allowEncodedHash: true</code></pre><aside class=\"admonition tip\"><p>If images still fail to load, you might need to enable more encoded character groups. For more information, see <a href=\"https://github.com/TriliumNext/Trilium/issues/7968\">the relevant GitHub issue</a>; feel free to report your findings.</p></aside></details><h3>Build the docker-compose file</h3><p>Setting up Traefik as reverse proxy requires setting the following labels:</p><pre><code class=\"language-text-x-yaml\"> labels:\n - traefik.enable=true\n - traefik.http.routers.trilium.entrypoints=https\n - traefik.http.routers.trilium.rule=Host(`trilium.mydomain.tld`)\n - traefik.http.routers.trilium.tls=true\n - traefik.http.routers.trilium.service=trilium\n - traefik.http.services.trilium.loadbalancer.server.port=8080\n # scheme must be HTTP instead of the usual HTTPS because Trilium listens on HTTP internally\n - traefik.http.services.trilium.loadbalancer.server.scheme=http\n - traefik.docker.network=proxy\n # forward HTTP to HTTPS\n - traefik.http.routers.trilium.middlewares=trilium-headers@docker\n - traefik.http.middlewares.trilium-headers.headers.customrequestheaders.X-Forwarded-Proto=https</code></pre><h3>Setup needed environment variables</h3><p>After setting up a reverse proxy, make sure to configure the&nbsp;<a class=\"reference-link\" href=\"#root/_help_LLzSMXACKhUs\">Trusted proxy</a>.</p><h3>Example <code>docker-compose.yaml</code></h3><pre><code class=\"language-text-x-yaml\">services:\n trilium:\n image: triliumnext/trilium\n container_name: trilium\n networks:\n - traefik-proxy\n environment:\n - TRILIUM_NETWORK_TRUSTEDREVERSEPROXY=my-traefik-host-ip # e.g., 172.18.0.0/16\n volumes:\n - /path/to/data:/home/node/trilium-data\n - /etc/timezone:/etc/timezone:ro\n - /etc/localtime:/etc/localtime:ro\n labels:\n - traefik.enable=true\n - traefik.http.routers.trilium.entrypoints=https\n - traefik.http.routers.trilium.rule=Host(`trilium.mydomain.tld`)\n - traefik.http.routers.trilium.tls=true\n - traefik.http.routers.trilium.service=trilium\n - traefik.http.services.trilium.loadbalancer.server.port=8080\n # scheme must be HTTP instead of the usual HTTPS because of how trilium works\n - traefik.http.services.trilium.loadbalancer.server.scheme=http\n - traefik.docker.network=traefik-proxy\n # Tell Trilium the original request was HTTPS\n - traefik.http.routers.trilium.middlewares=trilium-headers@docker\n - traefik.http.middlewares.trilium-headers.headers.customrequestheaders.X-Forwarded-Proto=https\n\nnetworks:\n traefik-proxy:\n external: true</code></pre>",
+ "_help_l2VkvOwUNfZj": "<p>Configuring TLS is essential for <a href=\"#root/_help_WOcw2SLH6tbX\">server installation</a> in Trilium. This guide details the steps to set up TLS within Trilium itself.</p><aside class=\"admonition tip\"><p>While Trilium supports HTTPS on its own, it's generally a good idea to use a <a href=\"#root/_help_vcjrb3VVYPZI\">reverse proxy</a> instead with TLS termination. You can follow a <a href=\"https://www.digitalocean.com/community/tutorials/how-to-secure-nginx-with-let-s-encrypt-on-ubuntu-20-04\">guide like this</a> for such setups.</p></aside><h2>Obtaining a TLS Certificate</h2><p>You have two options for obtaining a TLS certificate:</p><ul><li><strong>Recommended</strong>: Obtain a TLS certificate signed by a root certificate authority. For personal use, <a href=\"https://letsencrypt.org\">Let's Encrypt</a> is an excellent choice. It is free, automated, and straightforward. Certbot can facilitate automatic TLS setup.</li><li>Generate a self-signed certificate. This option is not recommended due to the additional complexity of importing the certificate into all machines connecting to the server.</li></ul><h2>Modifying <code>config.ini</code></h2><p>Once you have your certificate, modify the <code>config.ini</code> file in the <a href=\"#root/_help_tAassRL4RSQL\">data directory</a> to configure Trilium to use it:</p><pre><code class=\"language-text-x-trilium-auto\">[Network]\nport=8080\n# Set to true for TLS/SSL/HTTPS (secure), false for HTTP (insecure).\nhttps=true\n# Path to the certificate (run \"bash bin/generate-cert.sh\" to generate a self-signed certificate).\n# Relevant only if https=true\ncertPath=/[username]/.acme.sh/[hostname]/fullchain.cer\nkeyPath=/[username]/.acme.sh/[hostname]/example.com.key</code></pre><p>You can also review the <a href=\"#root/_help_Gzjqa934BdH4\">configuration</a> file to provide all <code>config.ini</code> values as environment variables instead. For example, you can configure TLS using environment variables:</p><pre><code class=\"language-text-x-trilium-auto\">export TRILIUM_NETWORK_HTTPS=true\nexport TRILIUM_NETWORK_CERTPATH=/path/to/cert.pem\nexport TRILIUM_NETWORK_KEYPATH=/path/to/key.pem</code></pre><p>The above example shows how this is set up in an environment where the certificate was generated using Let's Encrypt's ACME utility. Your paths may differ. For Docker installations, ensure these paths are within a volume or another directory accessible by the Docker container, such as <code>/home/node/trilium-data/[DIR IN DATA DIRECTORY]</code>.</p><p>After configuring <code>config.ini</code>, restart Trilium and access the hostname using \"https\".</p><h2>Self-Signed Certificate</h2><p>If you opt to use a self-signed certificate for your server instance, note that the desktop instance will not trust it by default.</p><p>To bypass this, disable certificate validation by setting the following environment variable (for Linux):</p><pre><code class=\"language-text-x-trilium-auto\">export NODE_TLS_REJECT_UNAUTHORIZED=0\ntrilium</code></pre><p>Trilium provides scripts to start in this mode, such as <code>trilium-no-cert-check.bat</code> for Windows.</p><p><strong>Warning</strong>: Disabling TLS certificate validation is insecure. Proceed only if you fully understand the implications.</p>",
+ "_help_0hzsNCP31IAB": "<h2>Disabling authentication</h2><p>If you are running Trilium on <code>localhost</code> only or if authentication is handled by another component, you can disable Trilium’s authentication by adding the following to <code>config.ini</code>:</p><pre><code class=\"language-text-x-trilium-auto\">[General]\nnoAuthentication=true</code></pre><p>Disabling authentication will bypass even the&nbsp;<a class=\"reference-link\" href=\"#root/_help_7DAiwaf8Z7Rz\">Multi-Factor Authentication</a>&nbsp;since v0.94.1.</p><h2>Understanding how the session works</h2><p>Once logged into Trilium, the application will store this information about the login into a cookie on the browser, but also as a session on the server.</p><p>If “Remember me” is checked, then the login will expire in 21 days. This period can be adjusted by modifying the <code>Session.cookieMaxAge</code> value in <code>config.ini</code>. For example, to have the session expire in one day:</p><pre><code class=\"language-text-x-trilium-auto\">[Session]\ncookieMaxAge=86400</code></pre><p>When “Remember me” is unchecked, the behavior is different. At client/browser level the authentication does not have any expiration date, but it will be automatically cleared as soon as the user closes the browser. Nevertheless, the server will also dismiss this authentication in around 24 hours from the <em>last interaction with the application</em>.</p><h2>Viewing active sessions</h2><p>The login sessions are now stored in the same&nbsp;<a class=\"reference-link\" href=\"#root/_help_wX4HbRucYSDD\">Database</a>&nbsp;as the user data. In order to view which sessions are active, open the&nbsp;<a class=\"reference-link\" href=\"#root/_help_YKWqdJhzi2VY\">SQL Console</a>&nbsp;and run the following query:</p><pre><code class=\"language-text-x-trilium-auto\">SELECT * FROM sessions</code></pre><p>Expired sessions are periodically cleaned by the server, generally an hourly interval.</p><h2>See also</h2><ul><li><a class=\"reference-link\" href=\"#root/_help_7DAiwaf8Z7Rz\">Multi-Factor Authentication</a></li></ul>",
+ "_help_lwAX5SvbrK2g": "<aside class=\"admonition important\"><p>If you forget your password:</p><ul><li>Protected notes are irretrievable without the password.</li><li>Unprotected notes can be recovered.</li></ul></aside><p>There are two options, both involving access to the device that is running your server.</p><h3>By disabling authentication</h3><ol><li>See&nbsp;<a class=\"reference-link\" href=\"#root/_help_0hzsNCP31IAB\">Authentication</a>&nbsp;on how to disable the authentication.</li><li>Restart the server.</li><li>Go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ Password → Reset password.</li><li>Re-enable authentication by following step (1) in reverse.</li><li>Restart the server.</li><li>Log in with the new password.</li></ol><h3>By altering the database</h3><ol><li><p>Access the <a href=\"#root/_help_wX4HbRucYSDD\">database</a> file in the <a href=\"#root/_help_tAassRL4RSQL\">data directory</a>. Open the <code>document.db</code> file with an SQLite client (e.g., <a href=\"https://sqlitebrowser.org/\">DB Browser</a>).</p></li><li><p>Execute the following queries:</p><pre><code class=\"language-text-x-trilium-auto\">UPDATE options SET value = '77/twC5O00cuQgNC63VK32qOKKYwj21ev3jZDXoytVU=' WHERE name = 'passwordVerificationSalt';\nUPDATE options SET value = '710BMasZCAgibzIc07X4P9Q4TeBd4ONnqJOho+pWcBM=' WHERE name = 'passwordDerivedKeySalt';\nUPDATE options SET value = 'Eb8af1/T57b89lCRuS97tPEl4CwxsAWAU7YNJ77oY+s=' WHERE name = 'passwordVerificationHash';\nUPDATE options SET value = 'QpC8XoiYYeqHPtHKRtbNxfTHsk+pEBqVBODYp0FkPBa22tlBBKBMigdLu5GNX8Uu' WHERE name = 'encryptedDataKey';</code></pre></li><li><p>After executing the changes, commit/write the changes. <strong>This sets the password to</strong> <code>**password**</code><strong>, allowing you to log in again.</strong></p></li><li><p>Go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Password</em> → <em>Change password</em> and replace the unsafe password.</p></li></ol><h2>Handling protected notes</h2><p>When the password is reset, the protected notes are permanently lost due to the fact that they are encrypted with your password so there is no way for Trilium to recover them.</p><p>For pre-existing protected notes (now unrecoverable), consider deleting them or exporting the unprotected notes. Then, delete <code>document.db</code> and start fresh.</p>",
+ "_help_7DAiwaf8Z7Rz": "<p>Multi-factor authentication (MFA) is a security process that requires users to provide two or more verification factors to gain access to a system, application, or account. This adds an extra layer of protection beyond just using a password.</p><p>By requiring more than one verification method, MFA helps reduce the risk of unauthorized access, even if someone has obtained your password. It’s highly recommended for securing sensitive information stored in your notes.</p><h2>Relationship to OpenID Connect (OIDC)</h2><p>Multi-factor authentication makes your Trilium login safer by requiring an additional proof of identity apart from your password.&nbsp;<a class=\"reference-link\" href=\"#root/_help_x1lQNKQBqLcA\">Signing in with OpenID Connect</a>&nbsp;is a different concept which delegates your authentication to an external provider (e.g. your Google provider, or a self-hosted one such as Authelia). These authentication providers might provide their own security features such as TOTP or passkeys.</p><h2>Time-based one-time password (TOTP)</h2><p>TOTP (Time-Based One-Time Password) is a security feature that generates a unique, temporary code on your device, like a smartphone, which changes every 30 seconds. You use this code, along with your password, to log into your account, making it much harder for anyone else to access them.</p><ol><li>Go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Password &amp; Auth.</em></li><li>Make sure <em>Sign-in with</em> has <em>Local password</em> selected.</li><li>In the <em>Two-factor authentication</em> section, press <em>Set up.</em></li><li>Scan the QR code or manually enter the code in your authenticator app.</li><li>Enter the verification code from your authenticator app to confirm that the setup was successful and press <em>Verify &amp; continue</em>.</li><li>Save the recovery codes, then tick the confirmation and press <em>Finish setup</em>.</li><li>Re-login will be required after TOTP setup is finished (After you refreshing the page).</li></ol><h2>Recovery codes</h2><p>Recovery codes can be used in place of the TOTP if you lose access to your authenticator. Trilium provides 8 different recovery codes, each recovery code can be used once.</p><p>To use a recovery code, simply login with your password and use the recovery code as the security token.</p><p>The initial set of recovery codes is generated when setting up your TOTP for the first time. They can be regenerated at any time by going to &nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Password &amp; Auth</em> and pressing the <em>Regenerate recovery codes</em> button. This will generate a new set of recovery codes while at the same time disabling the previous ones.</p>",
+ "_help_x1lQNKQBqLcA": "<p>OpenID is a standardized way to let you log into websites using an account from another service, like Google or Authelia, to verify your identity.</p><p>When OpenID is activated, the password-based authentication in Trilium is replaced with a button that connects using your provider. This means that the configuration of&nbsp;<a class=\"reference-link\" href=\"#root/_help_7DAiwaf8Z7Rz\">Multi-factor authentication with TOTP</a>&nbsp;no longer takes effect, since your provider has to handle any multi-factor authentication.</p><h2>Setup</h2><p>Setting up authentication with OpenID connect is a two-step process:</p><ol><li>First the Trilium server must be configured with information about your authentication provider such as the URL, client ID and secret.</li><li>Second, the user must connect from options to create a link between the account on the provider and the one Trilium has.</li></ol><h3>Configuring the authentication provider</h3><ol><li><p>First, make sure the authentication provider (e.g. Google, Authelia) is configured properly. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_IgkTHSaFfq6A\">Setting up with various providers</a>&nbsp;for concrete examples.</p><ol><li>The redirect URL of Trilium is <code>https://&lt;your-trilium-domain&gt;/callback</code>.</li><li>You should obtain the base URL, client ID and client secret.</li></ol></li><li><p>Set the following information using&nbsp;<a class=\"reference-link\" href=\"#root/_help_Gzjqa934BdH4\">Configuration (config.ini or environment variables)</a>:</p><figure class=\"table\"><table><thead><tr><th>Configuration</th><th><code>config.ini</code> in <code>[MultiFactorAuthentication]</code> section</th><th>Environment variable</th><th>Description</th></tr></thead><tbody><tr><td>Base URL*</td><td><code>oauthBaseUrl</code></td><td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHBASEURL</code></td><td>The URL of your Trilium instance (e.g. <code>https://example.com</code>).</td></tr><tr><td>Client ID*</td><td><code>oauthClientId</code></td><td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHCLIENTID</code></td><td>The client ID from your provider configuration.</td></tr><tr><td>Client Secret*</td><td><code>oauthClientSecret</code></td><td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHCLIENTSECRET</code></td><td>The client secret from your provider configuration.</td></tr><tr><td>Client auth method</td><td><code>oauthClientAuthMethod</code></td><td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHCLIENTAUTHMETHOD</code></td><td>Token-endpoint auth method: <code>client_secret_basic</code> or <code>client_secret_post</code>. Empty auto-detects. &nbsp;Only needed if sign-in fails with a <code>WWW-Authenticate</code> or <code>invalid_client</code> error.</td></tr><tr><td>ID token algorithm</td><td><code>oauthIdTokenSigningAlg</code></td><td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHIDTOKENSIGNINGALG</code></td><td><span style=\"color:rgb(32,32,32);\">The algorithm your provider signs ID tokens with, e.g.</span> <code>RS256</code><span style=\"color:rgb(32,32,32);\">,</span> <code>EdDSA</code><span style=\"color:rgb(32,32,32);\">,</span> <code>ES256</code><span style=\"color:rgb(32,32,32);\">. Empty auto-detects from the provider. Only needed if sign-in fails with an</span> <code>unexpected JWT alg</code> <span style=\"color:rgb(32,32,32);\">error.</span></td></tr></tbody></table></figure><p>Asterisk (*) marks a required field</p></li><li><p>The default OAuth issuer is Google. To use other services such as Authentik or Auth0, you can configure the settings via <code>oauthIssuerBaseUrl</code>, <code>oauthIssuerName</code>, and <code>oauthIssuerIcon</code> in the <code>config.ini</code> file. Alternatively, these values can be set using environment variables:</p><figure class=\"table\"><table><thead><tr><th>Configuration</th><th><code>config.ini</code> in <code>[MultiFactorAuthentication]</code> section</th><th>Environment variable</th><th>Description</th></tr></thead><tbody><tr><td>Issuer base URL</td><td><code>oauthIssuerBaseUrl</code></td><td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHISSUERBASEURL</code></td><td>Either the issuer itself (<code>https://auth.example.com</code>) or a full discovery URL (<code>https://auth.example.com/.well-known/openid-configuration</code>). <br> <br>A URL containing <code>/.well-known/</code> is used as-is<span style=\"color:rgb(32,32,32);\">, which is convenient when your provider hands you a discovery URL to copy. A trailing slash may be included or omitted; Trilium matches whichever spelling the provider advertises.</span> <br> <br>Use the full form when your provider advertises an issuer that differs from the path serving its discovery document, such as Authentik in \"global\" issuer mode.</td></tr><tr><td>Issuer name</td><td><code>oauthIssuerName</code></td><td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHISSUERNAME</code></td><td>The name of your authentication provider, used for reference on the login screen and in settings. Default is “Google”.</td></tr><tr><td>Issuer icon</td><td><code>oauthIssuerIcon</code></td><td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHISSUERICON</code></td><td>Optionally, the URL to a logo of the provider. By default it will try to obtain the favicon from the website, so it's optional.</td></tr></tbody></table></figure><p>All the fields here are optional, since the default OAuth issuer is Google.</p></li><li><p>Optionally, tune the following advanced settings. All are optional and have sensible defaults:</p><figure class=\"table\"><table><thead><tr><th>Configuration</th><th><code>config.ini</code> in <code>[MultiFactorAuthentication]</code> section</th><th>Environment variable</th><th>Description</th></tr></thead><tbody><tr><td>HTTP timeout</td><td><code>oauthHttpTimeout</code></td><td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHHTTPTIMEOUT</code></td><td>Timeout in milliseconds for the provider HTTP requests (discovery, token exchange, userinfo). Defaults to <code>30000</code> (30s). Raise this if your provider cold-starts slowly and you are occasionally asked to sign in twice. Minimum accepted value is <code>500</code>.</td></tr><tr><td>Scopes</td><td><code>oauthScope</code></td><td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHSCOPE</code></td><td>Space-separated list of OIDC scopes requested at login. Defaults to <code>openid profile email</code>. <code>openid</code> is required and is prepended automatically if you omit it.</td></tr></tbody></table></figure><p>The OIDC session lifetime is automatically bound to Trilium's own session cookie lifetime (the <code>cookieMaxAge</code> setting in the <code>[Session]</code> section, 21 days by default), so a single sign-in stays valid for as long as your Trilium session does rather than expiring early on the OIDC library's shorter internal defaults.</p></li><li><p>Restart the server so that the changes are applied.</p></li></ol><aside class=\"admonition note\"><p>Legacy environment variables are also supported: <code>TRILIUM_OAUTH_BASE_URL</code>, <code>TRILIUM_OAUTH_CLIENT_ID</code>, <code>TRILIUM_OAUTH_CLIENT_SECRET</code>, and for customizing the provider: <code>TRILIUM_OAUTH_ISSUER_BASE_URL</code>, <code>TRILIUM_OAUTH_ISSUER_NAME</code>, <code>TRILIUM_OAUTH_ISSUER_ICON</code>, <code>TRILIUM_OAUTH_HTTP_TIMEOUT</code>, <code>TRILIUM_OAUTH_SCOPE</code>, <code>TRILIUM_OAUTH_CLIENT_AUTH_METHOD</code>, <code>TRILIUM_OAUTH_ID_TOKEN_SIGNING_ALG</code>.</p></aside><h2>Connecting to the authentication provider</h2><p>Once the server has been configured at the previous step, the next step is to create a link between your account on the authentication provider and the Trilium instance. This makes sure that only you can access the Trilium instance, and not just any other valid account.</p><p>To do so:</p><ol><li>Go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Password &amp; Auth.</em></li><li>In the <em>Sign-in with</em> field, choose <em>OpenID Connect provider.</em></li><li>In the <em>OpenID Connect</em> section, look for the <em>Connect account</em> (<span class=\"tn-icon bx bx-log-in\"></span>) button.</li><li>This will redirect you to your authentication provider, where you can sign in or confirm the action if needed.</li><li>Once you are authenticated you will be redirected back to the Trilium application.</li></ol><h2>Logging out</h2><p>When logging out of Trilium, a request is made to the authentication provider to log out from there as well. This feature depends on the authentication provider, so it may not be honored (Google and Authelia are known cases in which they don't respect the logout feature).</p><h2>Switching providers</h2><p>When switching providers (e.g. going from Google to Authelia), it's important to take the following steps:</p><ol><li>Go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Password &amp; Auth</em>.</li><li>In the <em>OpenID Connect</em> section, press the <em>Disconnect</em> (<span class=\"tn-icon bx bx-trash\"></span>) button.</li><li>Wait for the section to indicate that you are disconnected.</li><li>Change the configuration pointing to the new provider.</li><li>Restart your server.</li><li>Repeat the normal steps to connect to the authentication provider.</li></ol><p>Failing to disconnect before switching providers might temporarily lock you in, as you will not be able to login (credentials won't match). Should this happen:</p><ol><li>Modify the server configuration again to your old provider.</li><li>Restart the server and follow the disconnect instructions above.</li><li>Modify the server configuration again to your new provider.</li><li>Restart again the server.</li></ol><h2>Deactivating OpenID Connect temporarily</h2><p>To disable the OpenID Connect authentication and instead rely on the local password temporarily, you must:</p><ol><li>Modify the <code>config.ini</code> or environment variables (depending on how you set up the provider information) and temporarily deactivate the multi-factor authentication section by renaming <code>[MultiFactorAuthentication]</code> to something else (e.g. <code>[MultiFactorAuthentication.bak]</code>.</li><li>Restart the server for the changes to take effect.</li></ol><h2>Troubleshooting</h2><h3>Setup fails with a <code>WWW-Authenticate</code> or <code>invalid_client</code> error</h3><p>Your provider disagrees with Trilium about how client credentials should be sent to the token endpoint. Set <code>oauthClientAuthMethod</code> to <code>client_secret_post</code> (or <code>client_secret_basic</code> if it's already set to post) and restart. Providers vary: some reject <code>client_secret_post</code> outright because the method is fixed when the client is registered (e.g. Authelia), so if one value doesn't work, try the other.</p><h3>Setup fails with <code>invalid user</code></h3><p>If you are running behind a <a href=\"#root/_help_vcjrb3VVYPZI\">reverse proxy</a>, a buffer overflow can also cause this issue. Here is a sample fix for&nbsp;<a class=\"reference-link\" href=\"#root/_help_ud6MShXL4WpO\">Nginx</a>: </p><pre><code class=\"language-text-x-trilium-auto\">proxy_buffer_size 128k;\nproxy_buffers 4 256k;\nproxy_busy_buffers_size 256k;</code></pre><h3>Setup fails with an <code>unexpected JWT alg</code> error</h3><p>Depending on your version the message reads <code>unexpected JWT \"alg\" header parameter</code> or <code>unexpected JWT alg received, expected RS256, got: EdDSA</code>. Both mean the same thing: your provider signs ID tokens with an algorithm other than RS256. Pocket ID (Ed25519) and Kanidm (ES256) do this.</p><p>From v0.104.2 Trilium detects the algorithm from your provider automatically, and the log records the outcome (<code>OAuth: the issuer does not sign ID tokens with RS256; expecting ES256</code>). If detection can't reach the provider it falls back to RS256, so check that the issuer URL is correct and reachable first. Should it still fail, set <code>oauthIdTokenSigningAlg</code> explicitly to the algorithm your provider uses.</p><h3>Setup fails with <code>OAUTH_RESPONSE_IS_NOT_CONFORM</code></h3><p>Make sure the base URL is correct and that the identity provider actually supports OpenID Connect. Some providers such as GitHub offer only OAuth 2.0.</p>",
+ "_help_IgkTHSaFfq6A": "<p>This page contains instructions on how to set up&nbsp;<a class=\"reference-link\" href=\"#root/_help_x1lQNKQBqLcA\">Signing in with OpenID Connect</a>&nbsp;with various providers such as Authelia, GitLab, Google.</p><aside class=\"admonition note\"><p>While the configuration reference is correct and up to date, the steps to create the OAuth application might differ slightly as providers change their UI.</p></aside><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">Authelia</p><div class=\"trilium-tab-panel\"><ol><li><p>Generate a client secret:</p><pre><code class=\"language-text-x-trilium-auto\">authelia crypto hash generate pbkdf2 --variant sha512 --random --random.length 72 --random.charset rfc3986\n</code></pre><p><code>Random Password</code> goes to Trilium, <code>Digest</code> (the <code>$pbkdf2-sha512$…</code> string) goes to Authelia.</p></li><li><p>Add a client under <code>identity_providers.oidc.clients</code> in Authelia's <code>configuration.yml</code>, replacing <code>&lt;server&gt;</code> with the URL of your Trilium instance:</p><pre><code class=\"language-text-x-yaml\">identity_providers:\n oidc:\n clients:\n - client_id: 'trilium'\n client_name: 'Trilium'\n client_secret: '&lt;Digest&gt;'\n public: false\n authorization_policy: 'two_factor'\n redirect_uris:\n - 'https://&lt;server&gt;/callback'\n scopes:\n - 'openid'\n - 'profile'\n - 'email'</code></pre><p>Unlike GitLab, <code>client_id</code> is a name you choose rather than one the provider generates.</p></li><li><p>Restart Authelia.</p></li></ol><p>Adjust <code>config.ini</code>, using the <code>Random Password</code> from step 1:</p><pre><code class=\"language-text-x-trilium-auto\">[MultiFactorAuthentication]\noauthBaseUrl=https://&lt;server&gt;\noauthClientId=&lt;ClientId&gt;\noauthClientSecret=&lt;RandomPassword&gt;\noauthIssuerBaseUrl=https://&lt;server&gt;\noauthIssuerName=Authelia</code></pre><aside class=\"admonition important\"><p>Do <strong>not</strong> set <code>oauthClientAuthMethod</code> for Authelia. It defaults confidential clients to <code>client_secret_basic</code> and rejects any other method with <code>invalid_client</code>, which is the default Trilium already uses. This is the opposite of the GitLab case below.</p></aside></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-gitlab\"></span>&nbsp;GitLab</p><div class=\"trilium-tab-panel\"><ol><li>Go to user settings on <a href=\"https://gitlab.com/-/user_settings/applications\">gitlab.com</a> or your own self-hosted instance.</li><li>Press <em>Add new application</em>.</li><li>Give it a name (e.g. Trilium).</li><li>Set <em>Redirect URI</em> to <code>https://&lt;server&gt;/callback</code></li><li>Make sure <em>Confidential</em> is checked and <em>Device authorization grant</em> is unchecked.</li><li>Under scopes, check <em>openid</em>, <em>profile</em> and <em>email</em> (they should be near the end).</li><li>Save the application and copy the <em>Application ID</em> and <em>Secret</em>.</li></ol><p>Adjust <code>config.ini</code> as follows, replacing <code>&lt;ApplicationId&gt;</code> and <code>&lt;Secret&gt;</code> with the values from the last step as well as the <code>&lt;server&gt;</code> with a URL to your Trilium instance.</p><pre><code class=\"language-text-x-trilium-auto\">[MultiFactorAuthentication]\noauthBaseUrl=https://&lt;server&gt;\noauthClientId=&lt;ApplicationId&gt;\noauthClientSecret=&lt;Secret&gt;\noauthIssuerBaseUrl=https://gitlab.com\noauthIssuerName=GitLab\noauthClientAuthMethod=client_secret_post\n</code></pre><aside class=\"admonition important\"><p>If you are using a self-hosted instance of GitLab, make sure to also update <code>oauthIssuerBaseUrl</code>, and keep the <code>oauthClientAuthMethod</code> line above.</p><p>GitLab's token endpoint does not decode credentials sent via HTTP Basic, so without <code>oauthClientAuthMethod</code>, sign-in fails with a <code>server responded with a challenge in the WWW-Authenticate HTTP Header</code> error. Trilium applies this automatically for <code>gitlab.com</code>, but a self-hosted issuer URL cannot be detected.</p></aside></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">Kanidm</p><div class=\"trilium-tab-panel\"><ol><li><p>Create the client, add the redirect URL and grant the scopes, replacing <code>&lt;server&gt;</code> with the URL of your Trilium instance and <code>&lt;group&gt;</code> with an existing Kanidm group whose members may sign in:</p><pre><code class=\"language-text-x-trilium-auto\">kanidm system oauth2 create trilium \"Trilium\" \"https://&lt;server&gt;\"\nkanidm system oauth2 add-redirect-url trilium \"https://&lt;server&gt;/callback\"\nkanidm system oauth2 update-scope-map trilium &lt;group&gt; openid profile email</code></pre><p>The <code>openid</code> scope is mandatory; without it Kanidm treats the client as plain OAuth 2.0.</p></li><li><p>Read the client secret:</p><pre><code class=\"language-text-x-trilium-auto\">kanidm system oauth2 show-basic-secret trilium</code></pre></li></ol><p>Adjust <code>config.ini</code> as follows, replacing <code>&lt;idm&gt;</code> with the URL of your Kanidm instance and <code>&lt;BasicSecret&gt;</code> with the value from step 2:</p><pre><code class=\"language-text-x-trilium-auto\">[MultiFactorAuthentication]\noauthBaseUrl=https://&lt;server&gt;\noauthClientId=trilium\noauthClientSecret=&lt;BasicSecret&gt;\noauthIssuerBaseUrl=https://&lt;idm&gt;/oauth2/openid/trilium\noauthIssuerName=Kanidm</code></pre><p>The client name you chose in step 1 is both the client ID and the last path segment of the issuer URL, so the two must match.</p><aside class=\"admonition important\"><p>Kanidm signs ID tokens with ES256, not RS256. Trilium detects this from the provider on v0.105.0 and later, so no extra configuration is needed. Do <strong>not</strong> run <code>kanidm system oauth2 warning-enable-legacy-crypto</code>, it downgrades the client to RS256 and disables ES256 entirely. On older Trilium versions sign-in fails with an <code>unexpected JWT alg</code> error.</p></aside></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">Pocket ID</p><div class=\"trilium-tab-panel\"><aside class=\"admonition important\"><p>Pocket ID is passwordless, signing in requires a passkey. Register one and confirm you can sign in to Pocket ID itself <em>before</em> switching Trilium over to OpenID Connect, otherwise you may find yourself unable to authenticate at either end.</p></aside><ol><li>Sign in to Pocket ID as an administrator and go to <em>OIDC Clients</em> → <em>Add OIDC Client</em>.</li><li>Give it a name (e.g. Trilium).</li><li>Set <em>Callback URLs</em> to <code>https://&lt;server&gt;/callback</code>, replacing <code>&lt;server&gt;</code> with the URL of your Trilium instance.</li><li>Save, then copy the <em>Client ID</em>, <em>Client Secret</em> and <em>OIDC Discovery URL</em>.</li></ol><p>Adjust <code>config.ini</code> as follows, using the values from step 4:</p><pre><code class=\"language-text-x-trilium-auto\">[MultiFactorAuthentication]\noauthBaseUrl=https://&lt;server&gt;\noauthClientId=&lt;ClientID&gt;\noauthClientSecret=&lt;ClientSecret&gt;\noauthIssuerBaseUrl=&lt;OIDCDiscoveryURL&gt;\noauthIssuerName=Pocket ID</code></pre><aside class=\"admonition note\"><p>Pocket ID gives you an <em>OIDC Discovery URL</em> ending in <code>/.well-known/openid-configuration</code>. On v0.105.0 and later you can paste it as-is. On earlier versions, remove that suffix and use only the part before it.</p></aside><aside class=\"admonition important\"><p>Pocket ID generates an RS256 signing key on first start, which works without further configuration. If you rotate it to Ed25519 (<code>pocket-id key-rotate --alg EdDSA --crv Ed25519</code>), ID tokens are signed with EdDSA instead. Trilium detects this automatically on v0.105.0 and later; older versions fail with <code>unexpected JWT alg received, expected RS256, got: EdDSA</code>.</p></aside></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span style=\"--tn-color:#e64d4d;color:#e64d4d;\"><span class=\"tn-icon bx bx-x\"></span>&nbsp;GitHub</span></p><div class=\"trilium-tab-panel\"><p>GitHub cannot be used as an identity provider because it is plain OAuth 2.0 and not OpenID Connect, so it will fail with <code>OAUTH_RESPONSE_IS_NOT_CONFORM</code>.</p></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-google\"></span>&nbsp;Google</p><div class=\"trilium-tab-panel\"><ol><li>Go to <a href=\"https://console.cloud.google.com/auth/clients\">Google Cloud's Clients</a> dashboard and select <em>Create client</em>.</li><li>For <em>Application type,</em> select <em>Web application</em>.</li><li>In <em>Authorized redirect URIs</em>, set &nbsp;<code>https://&lt;server&gt;/callback</code>.</li><li>Press <em>Create</em> and copy <em>Client ID</em> and <em>Client secret</em>.</li></ol><p>Adjust <code>config.ini</code> as follows, replacing <code>&lt;ClientID&gt;</code> and <code>&lt;ClientSecret&gt;</code> with the values from the last step as well as the <code>&lt;server&gt;</code> with a URL to your Trilium instance.</p><pre><code class=\"language-text-x-trilium-auto\">[MultiFactorAuthentication]\noauthBaseUrl=https://&lt;server&gt;\noauthClientId=&lt;ClientID&gt;\noauthClientSecret=&lt;ClientSecret&gt;</code></pre></div></section></div>",
+ "_help_yeEaYqosGLSh": "<p>As an alternative to <a href=\"#root/_help_Dgg7bR3b6K9j\">hosting your own Trilium instance</a>, there are two services out there that provide out of the box support for Trilium.</p><aside class=\"admonition important\"><p><strong>Disclaimer</strong>: The Trilium Notes project and maintainers are not directly affiliated with either of the projects.</p><p>PikaPods have gracefully offered us free credits for testing purposes.</p></aside><h2>Cloud instance providers</h2><h3>PikaPods</h3><ol><li>Go to <a href=\"https://www.pikapods.com\">pikapods.com</a> &nbsp;and sign up.</li><li>In the “Available Apps” section, look for \"TriliumNext<br>&nbsp;and select “Run your own”.</li><li>Follow the on-screen instructions to set up your own cloud hosted instance.</li></ol><p>PikaPods generally updates their Trilium instances to the latest version within a two-week interval after a new version is released.</p><h2>Matching your version with the cloud instance</h2><p>Please note that once you set up&nbsp;<a class=\"reference-link\" href=\"#root/_help_cbkrhQjrkKrh\">Synchronization</a>&nbsp;between a cloud instance and <a href=\"#root/_help_poXkQfguuA0U\">desktop</a> clients, it's important that the version of the desktop application and the server match up.</p><p>When setting up a cloud instance, it's best to check the version of the server by accessing it via a web browser and going to the <em>About</em> section. It's best that both the desktop and the server have the same <em>App version</em>; however it's generally OK to update the desktop to a newer version than the server if it has the same <em>Sync version</em>.</p><p>If the <em>Sync version</em> between the server and the desktop application doesn't match, synchronization will not work.</p>",
+ "_help_iGTnKjubbXkA": "<ul><li>Using Docker, the server can be run on Windows, Linux and macOS devices.</li><li>Native binaries are provided for Linux x64 and ARM (<code>aarch64</code>).</li></ul><h2>Legacy ARM support</h2><p>The Docker builds also provide <code>linux/arm/v7</code> and <code>linux/arm/v8</code> platforms. These platforms are considered legacy since Trilium uses Node.js version 24 which have <a href=\"https://github.com/nodejs/node/commit/6682861d6f\">officially downgraded support</a> for these platforms to “experimental”.</p><p>As a result, Trilium needs to use Node.js 22 for these versions. As soon as soon Node.js 22 will no longer be compatible, support for <code>armv7</code> and <code>armv8</code> will be dropped entirely.</p><p>Regardless of upstream support, these platforms are supported on a best-effort basis and are not officially supported by the Trilium development team. Bug reports are accepted but they will not be treated with priority; contributions are welcome.</p>",
+ "_help_cbkrhQjrkKrh": "<p>Trilium is an offline-first note-taking application that stores all data locally on the desktop client. However, it also offers the option to set up synchronization with a server instance, allowing multiple desktop clients to sync with a central server. This creates a star-shaped topology:</p><p><img src=\"{{helpAssets}}/User%20Guide/Installation%20%26%20Setup/Synchronization_image.jpg\"></p><p>In this setup, a central server (referred to as the <em>sync server</em>) and multiple <em>client</em> (or <em>desktop</em>) instances synchronize with the sync server. Once configured, synchronization is automatic and ongoing, requiring no manual intervention.</p><h2>Setting Up Synchronization</h2><h3>Security Considerations</h3><p>Setting up the server securely is critical and can be complex. It is crucial to use a valid <a href=\"#root/_help_l2VkvOwUNfZj\">TLS certificate</a> (HTTPS) rather than an unencrypted HTTP connection to ensure security and avoid potential vulnerabilities.</p><h3>Synchronizing a Desktop Instance with a Sync Server</h3><p>This method is used when you already have a desktop instance of Trilium and want to set up a sync server on your web host.</p><ol><li><strong>Server Deployment</strong>: Ensure your server instance is deployed but uninitialized.</li><li><strong>Desktop Configuration</strong>: Open your desktop instance, navigate to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Sync</em> → <em>Sync server</em>, and set the <em>Server address</em> to your sync server's address.<ul><li>Note that the sync server can also be overridden through&nbsp;<a class=\"reference-link\" href=\"#root/_help_Gzjqa934BdH4\">Configuration (config.ini or environment variables)</a>, case in which that value takes precedence. If that's the case, a field called <em>Server in use</em> indicates it.</li></ul></li><li><strong>Testing Sync</strong>: Click the <em>Test sync</em> button to verify the connection to the sync server.<ul><li>If successful, the client will start pushing all data to the server instance.</li><li>This process may take some time, but you can continue using Trilium. Periodically check the server instance to confirm when the sync is complete. Once finished, you should see the login screen on the server.</li></ul></li></ol><h3>Synchronizing a Desktop Instance from a Sync Server</h3><p>This method is used when you already have a sync server and want to configure a new desktop instance to sync with it.</p><ol><li><strong>Desktop Setup</strong>: Follow the <a href=\"#root/_help_poXkQfguuA0U\">desktop installation page</a>.</li><li><strong>Initial Configuration</strong>: When prompted, choose the option to set up sync with a sync server.</li></ol><p><img src=\"{{helpAssets}}/User%20Guide/Installation%20%26%20Setup/Synchronization_sync-init.png\" alt=\"screenshot of the sync from server setup page\"></p><ol><li><strong>Server Details</strong>: Configure the Trilium server address and enter the correct username and password for authentication.</li><li><strong>Finish Setup</strong>: Click the \"Finish setup\" button. If successful, you will see the following screen:</li></ol><p><img src=\"{{helpAssets}}/User%20Guide/Installation%20%26%20Setup/Synchronization_sync-in-progress.png\" alt=\"screenshot of the sync page\"></p><p>Once synchronization is complete, you will be automatically redirected to the Trilium application.</p><h3>Desktop-to-desktop sync</h3><p>This method allows two desktop instances to synchronize between each other without requiring a&nbsp;<a class=\"reference-link\" href=\"#root/_help_WOcw2SLH6tbX\">Server Installation</a>.</p><aside class=\"admonition warning\"><p>Since v0.104.0, LAN access needs to be enabled to allow this sync to function. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_swSFivWk6KkA\">Network Access</a>&nbsp;for information on how to do so.</p></aside><h2>Proxy Configuration</h2><p>Two proxy setups are supported:</p><ul><li><strong>Explicit Proxy Configuration</strong>: Set the proxy server in Options / Sync. Only unauthenticated proxy servers are supported.</li><li><strong>System Proxy Settings</strong>: If no proxy server is explicitly configured, Trilium will use the system proxy settings.</li></ul><h2>Troubleshooting</h2><h3>Date/Time Synchronization</h3><p>For successful synchronization, both client and server must have the same date and time, with a tolerance of up to five minutes.</p><h3>Certificate Issues</h3><p>When using TLS, Trilium will verify the server certificate. If verification fails (e.g., due to self-signed certificates or certain corporate proxies), you can run the Trilium client with the <code>NODE_TLS_REJECT_UNAUTHORIZED</code> environment variable set to <code>0</code>:</p><pre><code class=\"language-text-x-trilium-auto\">export NODE_TLS_REJECT_UNAUTHORIZED=0</code></pre><p>This will disable TLS certificate verification, significantly reducing security and exposing the setup to MITM attacks. It is strongly recommended to use a valid signed server certificate. Newer Trilium versions include a script called <code>trilium-no-cert-check.sh</code> for this purpose.</p><h3>Conflict Resolution</h3><p>If you edit the same note on multiple instances before synchronization, Trilium resolves conflicts by retaining the newer change and discarding the older one. The older version remains accessible in <a href=\"#root/_help_vZWERwf8U3nx\">note revisions</a>, allowing data recovery if needed.</p><h3>Hash Check</h3><p>After each synchronization, Trilium computes a hash of all synced data on both the client and the sync server. If there is a discrepancy, Trilium will automatically initiate a recovery mechanism to resolve the issue.</p>",
+ "_help_RDslemsQ6gCp": "<figure class=\"image image-style-align-right image_resized\" style=\"width:33.52%;\"><img style=\"aspect-ratio:1242/2688;\" src=\"{{helpAssets}}/User%20Guide/Installation%20%26%20Setup/Mobile%20Frontend_IMG_1765.PNG\" width=\"1242\" height=\"2688\"></figure><p>Trilium has a mobile web frontend which is optimized for touch based devices - smartphones and tablets. It is activated automatically during login process based on browser detection.</p><p>Mobile frontend is limited in features compared to the full desktop version. See below for more details on this.</p><h2>Layout basics</h2><p>Unlike the desktop version, the mobile version has a slightly different UI meant to better fit the constrained screens of a mobile phone.</p><p>Here is a non-exhaustive list of differences between the desktop version and the mobile one:</p><ul><li>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;is displayed as a sidebar. To display the sidebar, press the button in the top-left of the screen.<ul><li>There is also a swipe gesture that can be done from the left of the screen, but the browser's navigation gesture interferes with it most of the time (depending on the platform).</li><li>Press and hold a note to display the&nbsp;<a class=\"reference-link\" href=\"#root/_help_YtSN43OrfzaA\">Note tree contextual menu</a>.</li></ul></li><li>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_Ms1nauBra7gq\">Quick search</a>&nbsp;bar is also displayed at the top of the note tree.</li><li>The full&nbsp;<a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>&nbsp;function can be triggered either from either the&nbsp;<a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a>&nbsp;or from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>, if configured.</li><li>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>&nbsp;is displayed at the bottom of the screen.<ul><li>The launch bar uses a different configuration for icons than the desktop version. See the dedicated page for more information on how to configure it.</li></ul></li><li>Most of the note-related actions are grouped in the horizontal dots icon on the top-right of the note.</li><li>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_3seOhtN8uLIY\">Tabs</a>&nbsp;are grouped under a tab switcher in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>, where the tabs are displayed in a full-screen grid with preview for easy switching, as well as additional options such as reopening closed tabs.</li><li>Since v0.100.0,&nbsp;<a class=\"reference-link\" href=\"#root/_help_luNhaphA37EO\">Split View</a>&nbsp;can also be used in mobile view, but with a maximum of two panes at once. The splits are displayed vertically instead of horizontally.</li></ul><h2>Installing as a PWA</h2><p>The mobile view can be set up as a PWA. While this does not offer any offline capabilities, it will display the application in full-screen and makes it easy to access via your mobile phone's home screen.</p><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-apple\"></span>&nbsp;iOS with Safari</p><div class=\"trilium-tab-panel\"><ol><li>Open your default web browser and access your Trilium instance.</li><li>Login.</li><li>Press the […] button in the bottom-right of the screen and select Share.</li><li>Scroll down to reveal the full list of items and choose <em>Add to Home Screen</em>.</li><li>Press <em>Add</em> and the web app will be available.</li></ol></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-chrome\"></span>&nbsp;Android with Google Chrome</p><div class=\"trilium-tab-panel\"><aside class=\"admonition important\"><p>Google Chrome requires the server to be served over HTTPS in order to display in full-screen. If using HTTP, the app will appear like a normal web page (similar to a bookmark).</p></aside><ol><li>Open your default web browser and access your Trilium instance.</li><li>Login.</li><li>Press the three vertical dots icon in the top-right of the screen and select <em>Add to Home screen.</em></li><li>Select the <em>Install</em> option.</li><li>Select an appropriate name.</li><li>The web app will appear as an application, not on the home screen.</li></ol></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">Android with Brave</p><div class=\"trilium-tab-panel\"><aside class=\"admonition important\"><p>Brave requires the server to be served over HTTPS in order to display in full-screen. If using HTTP, the app will appear like a normal web page (similar to a bookmark).</p></aside><ol><li>Open your default web browser and access your Trilium instance.</li><li>Login.</li><li>Press the three vertical dots icon in the bottom-right of the screen and select <em>Add to Home screen</em>.</li><li>Press the <em>Install</em> option.</li><li>The web app will appear as an application, not on the home screen.</li></ol></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">Samsung Browser</p><div class=\"trilium-tab-panel\"><ol><li>Open your default web browser and access your Trilium instance.</li><li>Login.</li><li>Press the hamburger menu in the bottom-right of the screen.</li><li>Select <em>Add to</em>, followed by <em>Home screen</em>.</li><li>Press <em>Add</em> and the web app will appear on the home page.</li></ol></div></section></div><h2>Testing via the desktop application</h2><p>If you are running Trilium without a dedicated <a href=\"#root/_help_WOcw2SLH6tbX\">server installation</a>, you can still test the mobile application using the desktop application. For more information, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_nRqcgfTb97uV\">Using the desktop application as a server</a>. To access it go to <code>http://&lt;ip&gt;:37840/login?mobile</code> .</p><h2>Forcing mobile/desktop frontend</h2><p>Trilium decides automatically whether to use mobile or desktop front-end. If this is not appropriate, you can use <code>?mobile</code> or <code>?desktop</code> query param on <strong>login</strong> page (Note: you might need to log out).</p><p>Alternatively, simply select <em>Switch to Mobile/Desktop Version</em> in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a>.</p><h2>Scripting</h2><p>You can alter the behavior with&nbsp;<a class=\"reference-link\" href=\"#root/_help_CdNpE2pqjmI6\">Scripting</a>, just like for normal frontend. For script notes to be executed, they need to have labeled <code>#run=mobileStartup</code>.</p><p>Custom&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>&nbsp;widgets are also supported.</p>",
+ "_help_MtPxeAWVAzMg": "<p><img src=\"{{helpAssets}}/User%20Guide/Installation%20%26%20Setup/Web%20Clipper_image.png\"></p><p>Trilium Web Clipper is a web browser extension which allows user to clip text, screenshots, whole pages and short notes and save them directly to Trilium Notes.</p><h2>Supported browsers</h2><p>Trilium Web Clipper officially supports the following web browsers:</p><ul><li>Mozilla Firefox, using Manifest v2.</li><li>Google Chrome, using Manifest v3. Theoretically the extension should work on other Chromium-based browsers as well, but they are not officially supported.</li></ul><h2>Obtaining the extension</h2><p>The extension is available from the official browser web stores:</p><ul><li><strong>Firefox</strong>: <a href=\"https://addons.mozilla.org/firefox/addon/trilium-notes-web-clipper/\">Trilium Web Clipper on Firefox Add-ons</a></li><li><strong>Chrome</strong>: <a href=\"https://chromewebstore.google.com/detail/trilium-web-clipper/ofoiklieachadcaeffficgjaajojpkpi\">Trilium Web Clipper on Chrome Web Store</a></li></ul><h2>Functionality</h2><ul><li>select text and clip it with the right-click context menu</li><li>click on an image or link and save it through context menu</li><li>save whole page from the popup or context menu</li><li>save a PDF that the browser shows, as a file note</li><li>save a screenshot of an area you select, of the visible part of the page or of the whole page, from either popup or context menu</li><li>create short text note from popup</li></ul><h2>The popup</h2><p>Clicking the extension's button in the browser toolbar opens its popup:</p><ul><li><p>The popup shows what will be saved from the current page: the note's title, which can be edited before saving, the website, and below them a preview, which starts with a box for your own note and the page's description. A switch above the preview chooses what to save, among what the page offers:</p><ul><li><em>Selection</em>, when text is selected on the page: <em>Save selection</em> saves it into the note of that page's clippings, as the context menu does.</li><li><em>Page</em>: <em>Save page to Trilium</em> saves the page's text and images. A smaller switch at the top of the preview chooses how much of the page to keep: <em>Article</em> keeps only the page's main text, without its menus, sidebars and footers, and <em>Whole page</em> keeps everything the page shows. <em>Whole page</em> is for pages that are not an article (such as a gallery or a page of cards), where <em>Article</em> can leave out part of the content; the preview shows what each one keeps. <em>Article</em> is unavailable on a page where Trilium finds no article. The author the page names shows under the description, marked by the <span class=\"tn-icon bx bx-user\"></span> icon. It can be edited or cleared before saving, or written in when the page names none, and is saved in the <code>#pageAuthor</code> label of the note. When the page states when it was published, that date shows under the author, marked by the <span class=\"tn-icon bx bx-calendar\"></span> icon, and is saved in the <code>#publishedDate</code> label of the note. When it states when it was last modified, that date shows below, marked by the <span class=\"tn-icon bx bx-history\"></span> icon, and is saved in the <code>#modifiedDate</code> label.</li><li><em>PDF</em>, when the tab shows a PDF in the browser's viewer: <em>Save PDF to Trilium</em> downloads the PDF and saves it as a file note, which Trilium opens in its&nbsp;<a class=\"reference-link\" href=\"#root/_help_XJGJrpu7F9sh\">PDFs</a> viewer. Only the title and the description can be edited, since a file note has no text of its own for your note. The page's address is saved in the note's <code>#pageUrl</code> label and the PDF's file name in <code>#originalFileName</code>. Saving a PDF needs Trilium v0.107.0 or later.</li><li><em>Bookmark</em>, always: there is no preview, and <em>Save bookmark</em> saves a link to the page with your note as the content of the note. Left empty, the title stays the page's title.</li></ul><p>The box for your note, marked by the <span class=\"tn-icon bx bx-info-circle\"></span> icon, has the cursor when the popup opens, so a note (such as why the page is worth keeping) can be typed right away. It grows with its text, and keeps it when switching between <em>Selection</em>, <em>Page</em> and <em>Bookmark</em>. A note on a selection or a page is saved above the clipped content, in a <em>Note</em> admonition. Left empty, nothing is added. <kbd>Ctrl</kbd>+<kbd>Enter</kbd> in any of the popup's fields saves, whichever is chosen.</p><p>The description, marked by the <span class=\"tn-icon bx bx-align-left\"></span> icon, comes from the page's <code>description</code> meta tag, or the one it gives social sites. It can be edited or cleared before saving, or written in when the page has none, and is saved in the <code>#pageDescription</code> label of the note. Clippings saved with the keyboard shortcuts or the context menu, screenshots and images included, get the description as the page gives it. Each clipping that brings a description updates the label. The description, the author and the dates are shown by clicking the <em>Web clip</em> badge next to the title of the note (see <a class=\"reference-link\" href=\"#root/_help_B5dihXRDksTk\">Note badges</a>).</p><p>The popup opens on the selection if there is one, otherwise on <em>Page</em>, showing the article, or the whole page when the page has no article. On a PDF, it opens on <em>PDF</em>. On a page that shows nothing to save, it opens on <em>Bookmark</em> and says so. The keyboard shortcuts and the context menu still save right away, without a preview: saving the whole page that way saves the article, the whole page when the page has no article, or the PDF when the tab shows one.</p></li><li><p>Pages the extension cannot access (the browser's own pages, the extension stores, and pages that were open before the extension was installed until they are reloaded) cannot be saved or captured, so the popup says so in place of the preview, and only <em>All tabs</em> remains available there.</p></li><li><p>Below the preview, a row of buttons offers the other actions: <em>Area</em> (a screenshot of an area you select), <em>Visible</em> (a screenshot of the visible part of the page), <em>Full page</em> (a screenshot of the whole page) and <em>All tabs</em> (saves the links of every tab in the current window as a list of <a class=\"reference-link\" href=\"#root/_help_UmgZAfcltxkS\">Link Previews</a>, or of plain links when <em>Autogenerate link previews</em> is turned off). Hovering over a button shows its full name and, if it has one, its keyboard shortcut.</p></li><li><p><em>Full page</em> scrolls through the page, takes a screenshot of each part and joins them into one image, then scrolls back to where the page was. The scrollbars are hidden while it does, so they do not appear in the image. Stay on the tab until it is saved: switching to another tab stops the screenshot. A header that stays at the top of the window appears once, at the top of the image, and headings that stick while scrolling appear where they are in the page. Other elements that stay in place while scrolling (such as cookie banners and chat buttons) are left out, while a background that fills the whole window repeats on every screen. In Firefox, the page is captured without scrolling through it, which is faster: such a background then appears only at the top, and images that the page loads only once they are scrolled into view can be missing. A long page is saved as several images, one below the other in the note. A page longer than 100 screens is cut off there, and the message after saving says so. Screenshots keep their full height in Trilium: <em>Resize image</em> (under <em>Automatically compress images</em> in Options → Media) limits only their width.</p></li><li><p>The popup stays open while Trilium saves, which can take a few seconds for a long page or a large PDF, and the other actions wait until it is done. The bar at the top of the popup then says, in green, that the clipping was saved (in place of the notice that the page was already clipped), with <em>Open note</em> to open it in Trilium (and, after <em>All tabs</em>, <em>Close saved tabs</em>), or, in red, why it could not be saved. The same clipping cannot be saved twice by accident: the save button stays disabled until another mode is chosen. <em>Crop</em> is the exception: the popup closes so that an area of the page can be selected, and the notification on the page reports the outcome.</p></li><li><p>If the current page was already clipped, a notice at the top offers to open the note in Trilium.</p></li><li><p>If Trilium cannot be found, the popup explains why instead of showing the actions, with buttons to look for Trilium again and to open the options.</p></li><li><p>The bottom of the popup shows whether the extension is connected to Trilium, as a colored dot (green when connected, amber when the versions are not compatible, red when Trilium was not found) next to a description of the connection, followed by the buttons for the extension's options and for this help page. A button to check the connection again appears next to them when hovering over the bar, and stays visible while Trilium cannot be reached or is not compatible.</p></li></ul><h2>Location of clippings</h2><p>Trilium will save these clippings as a new child note under a \"clipper inbox\" note.</p><p>By default, that's the&nbsp;<a class=\"reference-link\" href=\"#root/_help_l0tKav7yLHGF\">Day Notes</a>&nbsp;but you can override that by setting the <a href=\"#root/_help_zEY4DaJG4YT5\">label</a> <code>clipperInbox</code>, on any other note.</p><p>Further clippings of the same kind from the same page are added to the note created by the first one, even on a later day or after that note was moved out of the clipper inbox. The note stays where it is and is not cloned back into the inbox. A PDF is the exception: each save creates a new file note, since the PDF can have changed since it was last saved.</p><p>The icon of a clipped note shows what was saved:</p><ul><li><span class=\"tn-icon bx bx-paperclip\"></span> a selection, a screenshot or a link from the context menu;</li><li><span class=\"tn-icon bx bx-globe\"></span> a page (<em>Article</em> or <em>Whole page</em>);</li><li><span class=\"tn-icon bx bx-bookmark\"></span> a bookmark;</li><li><span class=\"tn-icon bx bx-window-alt\"></span> the tabs of a window.</li></ul><p>The icon is derived from the note's <code>#clipType</code> label, so setting an <code>#iconClass</code> label on the note replaces it. A saved PDF has the icon of a PDF file, like any other PDF in Trilium.</p><h2>Embedded videos</h2><p>A YouTube video embedded in a clipped page is saved as a <a class=\"reference-link\" href=\"#root/_help_UmgZAfcltxkS\">Link Previews</a> embed, with the video's title and thumbnail. As with a link preview added in the editor, the video plays only when clicked. Other embedded content (such as videos from other websites) is not saved.</p><p>The popup's preview shows each such video as a chip with the YouTube icon and the video's short link, and leaves out the embedded content that will not be saved.</p><h2>Keyboard shortcuts</h2><p>Keyboard shortcuts are available for most functions:</p><ul><li>Save selected text: <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>S</kbd> (Mac: <kbd>⌘</kbd>+<kbd>⇧</kbd>+<kbd>S</kbd>)</li><li>Save whole page: <kbd>Alt</kbd>+<kbd>Shift</kbd>+<kbd>S</kbd> (Mac: <kbd>⌥</kbd>+<kbd>⇧</kbd>+<kbd>S</kbd>)</li><li>Save a screenshot of an area: <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>E</kbd> (Mac: <kbd>⌘</kbd>+<kbd>⇧</kbd>+<kbd>E</kbd>)</li><li>Save all tabs of the current window: no default shortcut, but one can be assigned as described below.</li><li>Save a screenshot of the whole page: no default shortcut, but one can be assigned as described below.</li></ul><p>To set custom shortcuts, follow the directions for your browser.</p><ul><li><strong>Firefox</strong>: <code>about:addons</code> → Gear icon ⚙️ → Manage extension shortcuts</li><li><strong>Chrome</strong>: <code>chrome://extensions/shortcuts</code></li></ul><aside class=\"admonition note\"><p>On Firefox, the default shortcuts interfere with some browser features. As such, the keyboard combinations will not trigger the Web Clipper action. To fix this, simply change the keyboard shortcut to something that works. The defaults will be adjusted in future versions.</p></aside><h2>Configuration</h2><p>The extension needs to connect to a running Trilium instance. By default, it looks for the desktop application on port 37840 of the local computer. If the desktop application runs on a different port (for example because it was started with the <code>TRILIUM_PORT</code> environment variable), enter that port in the extension's options. The extension checks for Trilium again every minute, or right away when pressing the refresh button at the bottom of its popup.</p><p>It's also possible to configure the <a href=\"#root/_help_WOcw2SLH6tbX\">server</a> address if you don't run the desktop application, or want it to work without the desktop application running.</p><p>To connect to a server, enter its address and your password in the extension's options and press <em>Login to the server instance</em>. If the server uses <a href=\"#root/_help_7DAiwaf8Z7Rz\">multi-factor authentication</a>, also fill in <em>Authentication code</em> with the current code from your authenticator app (or one of your recovery codes); otherwise leave it empty. The password and the code are used only once, to obtain a token for the extension, and are not stored.</p><h3>When a clipping fails</h3><p>After each clipping made with a keyboard shortcut or the context menu, a notification in the corner of the page confirms that it was saved, with a link to open the new note in Trilium. A clipping made from the popup reports in the popup instead, unless the popup was closed before it was saved. If the clipping could not be saved, the message says why instead:</p><ul><li>Trilium was not found: start the desktop application, or check the server address and token in the extension's options.</li><li>The versions of Trilium and the extension are not compatible: update the one the message names.</li><li>Trilium rejected the request: the message includes the reason Trilium gave.</li><li>The popup could not reach the extension's background script, or it gave no answer: close the popup and open it again. If the extension was just updated or reloaded, reload the page as well.</li><li>A PDF could not be saved: Trilium is older than v0.107.0, the website refused to send the PDF again, or the PDF is larger than 100 MB. The extension downloads the PDF with the browser's cookies for that website, so a PDF behind a login can be saved while you are logged in.</li></ul><p>The extension downloads the images of a clipping itself, so that they are stored in Trilium together with the note. If some of them cannot be downloaded (for example because the website refuses the request), the clipping is still saved, and the notification says how many images are missing. Those images keep their address on the original website: Trilium tries to download them once more if <em>Download images automatically</em> is enabled in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Media</em>, and otherwise the note shows them from the website for as long as it serves them.</p><p>The notification is shown on the page itself, so it does not appear on pages where extensions cannot run (such as the browser's own settings pages, the extension stores and Firefox's PDF viewer). A clipping saved from the popup on such a page still reports in the popup.</p><h2>Testing development versions</h2><p>Development versions are version pre-release versions, generally meant for testing purposes. These are not available in the Google or Firefox web stores, but can be downloaded from either:</p><ul><li><a href=\"https://github.com/TriliumNext/Trilium/releases\">GitHub Releases</a> by looking for releases starting with <em>Web Clipper.</em></li><li>Artifacts in GitHub Actions, by looking for the <a href=\"https://github.com/TriliumNext/Trilium/actions/workflows/web-clipper.yml\"><em>Deploy web clipper extension</em> workflow</a>. Once a workflow run is selected, the ZIP files are available in the <em>Artifacts</em> section, under the name <code>web-clipper-extension</code>.</li></ul><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-chrome\"></span>&nbsp;Chrome</p><div class=\"trilium-tab-panel\"><ol><li>Download <code>trilium-web-clipper-[x.y.z]-chrome.zip</code>.</li><li>Extract the archive.</li><li>In Chrome, navigate to <code>chrome://extensions/</code></li><li>Toggle <em>Developer Mode</em> in top-right of the page.</li><li>Press the <em>Load unpacked</em> button near the header.</li><li>Point to the extracted directory from step (2).</li></ol></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-firefox\"></span>&nbsp;Firefox</p><div class=\"trilium-tab-panel\"><aside class=\"admonition warning\"><p>Firefox prevents installation of unsigned packages in the “retail” version. To be able to install extensions from disk, consider using <em>Firefox Developer Edition</em> or a non-branded version of Firefox (e.g. <em>GNU IceCat</em>).</p><p>One time, go to <code>about:config</code> and change <code>xpinstall.signatures.required</code> to <code>false</code>.</p></aside><ol><li>Navigate to <code>about:addons</code>.</li><li>Select <em>Extensions</em> in the left-side navigation.</li><li>Press the <em>Gear</em> icon on the right of the <em>Manage Your Extensions</em> title.</li><li>Select <em>Install Add-on From File…</em></li><li>Point it to <code>trilium-web-clipper-[x.y.z]-firefox.zip</code>.</li><li>Press the <em>Add</em> button to confirm.</li></ol></div></section></div><h2>Credits</h2><p>Some parts of the code are based on the <a href=\"https://github.com/laurent22/joplin/tree/master/Clipper\">Joplin Notes browser extension</a>.</p>",
+ "_help_n1lujUxCwipy": "<p>This document outlines the steps required to upgrade Trilium to a new release version.</p><h2>How to Upgrade</h2><p>Trilium does not support built-in automatic upgrades; all updates must be performed manually. The upgrade process varies depending on the installation method:</p><ul><li><a href=\"#root/_help_rWX5eY045zbE\"><strong>Docker Server Installation</strong></a>: Pull the new image and restart the container.</li><li><strong>Other Installations</strong>: Download the latest version from the <a href=\"https://github.com/TriliumNext/Trilium/releases/latest\">release page</a> and replace the existing application files.</li></ul><h2>Database Compatibility and Migration</h2><p>Upon startup, Trilium will automatically migrate the <a href=\"#root/_help_wX4HbRucYSDD\">database</a> to the new version. Note that after migration, older versions of Trilium will be unable to read the database. If you need to revert to a previous version of Trilium and its database, you can restore the <a href=\"#root/_help_ODY7qQn5m2FT\">backup</a> that is created prior to migration.</p><h2>Sync Compatibility</h2><p>The <a href=\"#root/_help_cbkrhQjrkKrh\">synchronization</a> protocol used by Trilium is versioned, requiring all members of the sync cluster to use the same protocol version. Therefore, when upgrading to a new version, you may need to upgrade all instances in the sync cluster. Changes to the sync protocol version are typically indicated on the release page.</p>",
+ "_help_ODY7qQn5m2FT": "<p>Trilium supports simple backup scheme where it saves copy of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_wX4HbRucYSDD\">Database</a>&nbsp;on these events:</p><ul><li>once a day</li><li>once a week</li><li>once a month</li><li>before DB migration to newer version</li></ul><p>So in total you'll have at most 4 backups from different points in time which should protect you from various problems. These backups are stored by default in <code>backup</code> directory placed in the <a href=\"#root/_help_tAassRL4RSQL\">data directory</a>.</p><p>This is only very basic backup solution, and you're encouraged to add some better backup solution - e.g. backing up the&nbsp;<a class=\"reference-link\" href=\"#root/_help_wX4HbRucYSDD\">Database</a>&nbsp;to cloud / different computer etc.</p><p>Note that&nbsp;<a class=\"reference-link\" href=\"#root/_help_cbkrhQjrkKrh\">Synchronization</a>&nbsp;provides also some backup capabilities by its nature of distributing the data to other computers.</p><h2>Creating a backup</h2><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bx-desktop\"></span>&nbsp;On the desktop app &amp; web client</p><div class=\"trilium-tab-panel\"><ol><li>Go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Backup</em> and press the <em>Backup now</em> button.</li><li>The backup creation process may take a few moments, especially for larger databases. A notification will inform you when the backup is complete.</li><li>The backup will be saved as <code>backup-now</code> in the <em>Existing backups</em> list, where you can download it.</li></ol></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bx-globe\"></span>&nbsp;On the standalone client</p><div class=\"trilium-tab-panel\"><ol><li>Go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Backup</em> and press the <em>Download backup</em> button.</li><li>You will be prompted to restart the app. Confirm, and the app will restart automatically.</li><li>Set a <em>backup name</em> or <em>password</em> (both optional), then press <em>Continue</em>.</li><li>Press the <em>Generate and download</em> button and wait for the download to complete.</li><li>Once you confirm the download is saved on your device, press <em>Finish</em> to complete</li></ol></div></section></div><h2>Downloading a backup</h2><ul><li><strong>Desktop and web client</strong>: to download an existing backup, navigate to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Backup</em> → <em>Existing backups</em> and select <em>Download</em> (<span class=\"tn-icon bx bx-download\"></span>).</li><li><strong>Standalone client</strong>: automatic backups are not supported in this version. You can manually create and download a backup by going to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Backup</em> → <em>Download backup</em>.</li></ul><h2>Restoring a backup</h2><ul><li><strong>For a new Trilium instance</strong>: When setting up a new Trilium instance, use the <em>Restore from backup</em> option in the setup menu to guide you through restoring your existing backup.</li><li><strong>For an existing Trilium instance</strong>: To restore a backup and replace your current database, go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Backup</em> and click <em>Restore a backup</em>. You will be prompted to restart the app for the restoration process to begin. After restarting, you can choose to back up the existing database before overwriting it. Note: For the web client, use the Start Over feature (&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Database</em> → <em>Start over</em> (<span class=\"tn-icon bx bx-reset\"></span>)) to switch to the setup screen and restore a backup.</li></ul><p>Next, select the backup file (.db or .tnbackup) from your device. The web client is optimized for handling large backups and is resilient to unstable network conditions, similar to the desktop application.</p><p>If your database is encrypted, you will be prompted to enter the password used for encrypting the backup file. Without the correct password, decryption and restoration cannot proceed.</p><p>Restoring a backup may take some time, depending on its size. Once it completes, Trilium will open the freshly restored database.</p><h3>The alternative way for restoring a backup</h3><p>Let's assume you want to restore the weekly backup (only in .db format, .tnbackup files are not supported by this method), here's how to do it:</p><ul><li>find <a href=\"#root/_help_tAassRL4RSQL\">data directory</a> Trilium uses - easy way is to open \"About Trilium Notes\" (<span class=\"tn-icon bx bx-info-circle\"></span>) from \"Menu\" in upper left corner and looking at \"data directory\"<ul><li>I'll refer to <code>~/trilium-data</code> as data directory from now on</li></ul></li><li>find <code>~/trilium-data/backup/backup-weekly.db</code> - this is the&nbsp;<a class=\"reference-link\" href=\"#root/_help_wX4HbRucYSDD\">Database</a>&nbsp;backup.</li><li>at this point stop/kill Trilium</li><li>delete <code>~/trilium-data/document.db</code>, <code>~/trilium-data/document.db-wal</code> and <code>~/trilium-data/document.db-shm</code> (latter two files are auto generated)</li><li>copy and rename this <code>~/trilium-data/backup/backup-weekly.db</code> to <code>~/trilium-data/document.db</code></li><li>make sure that the file is writable, e.g. with <code>chmod 600 document.db</code></li><li>start Trilium again</li></ul><aside class=\"admonition warning\"><p>If you have configured sync then you need to do it across all members of the sync cluster, otherwise older version (restored backup) of the document will be detected and synced to the newer version.</p></aside><h2>Changing the backup location in Trilium (desktop only)</h2><p>Starting with version 0.105, the Trilium desktop client allows users to change the directory where backups are stored. Follow these steps to specify a custom backup directory:</p><ol><li>Navigate to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Backup</em> → <em>Backup location</em>.</li><li>Click the <em>Select location</em> button.</li><li>Choose any writable directory on your file system. This could include network shares, depending on your operating system.</li></ol><p>Once you set a custom directory, all manual and automatic backups will be saved there. If the selected directory becomes unavailable, backups may fail or revert to the default location.</p><aside class=\"admonition tip\"><p>For better privacy when using unsafe backup locations, you can enable backup encryption, which makes the backup file unreadable without the correct password.</p></aside><h2>Backup encryption</h2><p>Trilium can secure the entire content of the database backup, ensuring it remains unreadable unless the correct password is provided. This is particularly useful for storing backups in unsecured locations, like network shares, unencrypted external drives, or cloud services.&nbsp;</p><p>Encrypted database backups use the Trilium Backup Container (.tnbackup) format, which relies on AES-256-GCM. This authenticated encryption mode scrambles the data and generates a tag confirming it hasn't been altered. The password itself isn't directly used as the key; it's processed through scrypt, a key derivation function designed to be slow and memory-intensive, making brute-force password guessing difficult even with powerful hardware. Each backup also receives a random 16-byte salt, ensuring that the same password never produces the same encryption key twice. Additionally, critical metadata such as chunk order, length, and header flags are cryptographically bound into the encryption (via \"additional authenticated data\"), preventing undetected tampering like reorder, truncate, or splice operations.</p><h3>Enabling backup encryption</h3><p>To enable encryption for automatic backups in the Desktop application:</p><ol><li>Go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Backup</em> → <em>Backup options</em>.</li><li>Click on <em>Turn on encryption</em> and set a password.</li></ol><p>Once encryption is enabled, all newly created backups (both automatic and manual) will be encrypted with the specified password. Backups created prior to enabling encryption will remain unsecured.</p><p>You can change the password anytime using the <em>Change password</em> button. The new password will apply to backups created after the change.</p><p>To disable encryption, uncheck&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Backup</em> → <em>Enable encryption</em>.</p><aside class=\"admonition note\"><p>On some systems, a keyring may not be available for Trilium to securely store the encryption password. In such cases, the encryption option is disabled.</p></aside><h2>Backup compression</h2><p>Database backups can be optionally compressed to minimize storage footprint. This method is effective primarily when the database consists largely of text content. However, media files (images, videos, audio), along with PDF, ODF, and DOCX files, are already compressed in their original formats and won't benefit from further compression.</p><p>Compressed backups are stored using the Trilium Backup Container (.tnbackup), employing RFC 1952 GZIP compression.</p><aside class=\"admonition warning\"><p><strong>Note:</strong> Compression increases the time required for backup creation and restoration. It may also lead to higher CPU usage during automatic backups, potentially draining the battery faster on battery-powered devices. Enable this option only if necessary.</p></aside><h3>Enabling Backup Compression (Desktop Only)</h3><p>To enable compression for new automatic and manual backups, navigate to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Backup</em> → <em>Backup options</em> and toggle <em>Enable compression</em> to on.</p><h2>Disabling backup</h2><p>Although this is not recommended, it is possible to disable backup in <code>config.ini</code> in the <a href=\"#root/_help_tAassRL4RSQL\">data directory</a>:</p><pre><code class=\"language-text-x-trilium-auto\">[General]\n... some other configs\n# set to true to disable backups (e.g. because of limited space on server)\nnoBackup=true</code></pre><p>You can also review the <a href=\"#root/_help_Gzjqa934BdH4\">configuration</a> file to provide all <code>config.ini</code> values as environment variables instead.</p><p>See <a href=\"https://github.com/TriliumNext/Trilium/blob/master/config-sample.ini\">sample config</a>.</p>",
+ "_help_tAassRL4RSQL": "<p>Data directory contains:</p><ul><li><code>document.db</code> - <a href=\"#root/_help_wX4HbRucYSDD\">database</a></li><li><code>config.ini</code> - instance level settings like port on which the Trilium application runs</li><li><code>backup</code> - contains automatically <a href=\"#root/_help_ODY7qQn5m2FT\">backup</a> of documents</li><li><code>log</code> - contains application log files</li></ul><h2>Location of the data directory</h2><p>Easy way how to find out which data directory Trilium uses is to look at the \"About Trilium Notes\" dialog (from \"Menu\" in upper left corner):</p><p><img src=\"{{helpAssets}}/User%20Guide/Installation%20%26%20Setup/Data%20directory_image.jpg\"></p><p>Here's how the location is decided:</p><p>Data directory is normally named <code>trilium-data</code> and it is stored in:</p><ul><li><code>/home/[user]/.local/share</code> for Linux</li><li><code>/home/[user]/.var/app/org.triliumnotes.Trilium/data</code> for the Flathub version on Linux</li><li><code>C:\\Users\\[user]\\AppData\\Roaming</code> for Windows Vista and up</li><li><code>/Users/[user]/Library/Application Support</code> for Mac OS</li><li>user's home is a fallback if some of the paths above don't exist</li><li>user's home is also a default setup for [[docker|Docker server installation]]</li></ul><p>If you want to back up your Trilium data, just backup this single directory - it contains everything you need.</p><h3>Changing the location of data directory</h3><p>If you want to use some other location for the data directory than the default one, you may change it via <code>TRILIUM_DATA_DIR</code> environment variable to some other location:</p><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-windows\"></span>&nbsp;Windows</p><div class=\"trilium-tab-panel\"><ol><li>Press the&nbsp;<span class=\"tn-icon bx bxl-windows\"></span> key on your keyboard.</li><li>Search and select <em>Edit the system variables</em>.</li><li>Press the <em>Environment Variables…</em> button in the bottom-right of the newly opened screen.</li><li>On the top section (<em>User variables for [user]</em>), press the <em>New…</em> button.</li><li>In the <em>Variable name</em> field insert <code>TRILIUM_DATA_DIR</code>.</li><li>Press the <em>Browse Directory…</em> button and select the new directory where to store the database.</li><li>Close all the windows by pressing the <em>OK</em> button for each of them.</li></ol></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-tux\"></span>&nbsp;Linux</p><div class=\"trilium-tab-panel\"><p>Trilium reads <code>TRILIUM_DATA_DIR</code> when it starts, so the variable must be set in the environment that launches it.</p><aside class=\"admonition note\"><p>Setting the variable does not move existing notes. To keep them, close Trilium and copy the old data directory to the new location first. Trilium creates the last folder of the path if it is missing, but not its parent folders.</p></aside><p><strong>Desktop application (.deb, .rpm, AppImage or .zip)</strong></p><p>To use the new location however Trilium is started (from the application menu, a desktop shortcut, at login or from a terminal), set the variable for the whole session:</p><ol><li><p>Create the file <code>~/.config/environment.d/trilium.conf</code> with the following content, using the full path (<code>~</code> is not expanded in this file):</p><pre><code class=\"language-text-x-trilium-auto\">TRILIUM_DATA_DIR=/home/myuser/data/my-trilium-data</code></pre></li><li><p>Log out and log back in.</p></li></ol><p>This works on desktops started by <code>systemd</code>, which covers most distributions running GNOME or KDE Plasma. On other systems, add the following line to <code>~/.profile</code> instead, then log out and log back in:</p><pre><code class=\"language-text-x-sh\">export TRILIUM_DATA_DIR=\"$HOME/data/my-trilium-data\"</code></pre><p>The same line in <code>~/.bashrc</code> (or your shell's equivalent) only applies when Trilium is started from a terminal, not from the application menu.</p><p><strong>Flatpak (Flathub)</strong></p><p>The Flathub version runs in a sandbox that cannot see the rest of the file system, so it needs access to the folder as well as the variable:</p><pre><code class=\"language-text-x-sh\">flatpak override --user \\\n --env=TRILIUM_DATA_DIR=/home/myuser/data/my-trilium-data \\\n --filesystem=/home/myuser/data/my-trilium-data:create \\\n org.triliumnotes.Trilium</code></pre><p>To return to the default location, run <code>flatpak override --user --reset org.triliumnotes.Trilium</code>. This also removes any other overrides set for Trilium.</p><p><strong>Server running as a systemd service</strong></p><p>Add an <code>Environment=</code> line to the <code>[Service]</code> section of the unit file described in&nbsp;<a class=\"reference-link\" href=\"#root/_help_3tW6mORuTHnB\">Packaged version for Linux</a>:</p><pre><code class=\"language-text-x-trilium-auto\">[Service]\nEnvironment=TRILIUM_DATA_DIR=/var/lib/trilium-data</code></pre><p>Then reload and restart the service:</p><pre><code class=\"language-text-x-sh\">sudo systemctl daemon-reload\nsudo systemctl restart trilium</code></pre><p>The user set in <code>User=</code> must be able to write to the folder. For Docker, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_rWX5eY045zbE\">Using Docker</a>&nbsp;instead.</p></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-apple\"></span>&nbsp;macOS</p><div class=\"trilium-tab-panel\"><p>You need to create a <code>.plist</code> file under <code>~/Library/LaunchAgents</code> to load it properly each login.</p><p>To load it manually, you need to use <code>launchctl setenv TRILIUM_DATA_DIR &lt;yourpath&gt;</code></p><p>Here is a pre-defined template, where you just need to add your path to:</p><pre><code class=\"language-text-xml\">&lt;?xml version=\"1.0\" encoding=\"UTF-8\"?&gt;\n&lt;!DOCTYPE plist PUBLIC \"-//Apple//DTD PLIST 1.0//EN\" \"http://www.apple.com/DTDs/PropertyList-1.0.dtd\"&gt;\n&lt;plist version=\"1.0\"&gt;\n&lt;dict&gt;\n &lt;key&gt;Label&lt;/key&gt;\n &lt;string&gt;set.trilium.env&lt;/string&gt;\n &lt;key&gt;RunAtLoad&lt;/key&gt;\n &lt;true/&gt;\n &lt;key&gt;ProgramArguments&lt;/key&gt;\n &lt;array&gt;\n &lt;string&gt;/bin/launchctl&lt;/string&gt;\n &lt;string&gt;setenv&lt;/string&gt;\n &lt;string&gt;TRILIUM_DATA_DIR&lt;/string&gt;\n &lt;string&gt;/Users/YourUserName/Library/Application Support/trilium-data&lt;/string&gt;\n &lt;/array&gt;\n&lt;/dict&gt;\n&lt;/plist&gt;\n</code></pre></div></section></div><h3>Create a script to run with specific data directory</h3><p>An alternative to globally setting environment variable is to run only the Trilium Notes with this environment variable. This then allows for different setup styles like two <a href=\"#root/_help_wX4HbRucYSDD\">database</a> instances or \"portable\" installation.</p><p>To do this in Unix-based systems simply run <code>trilium</code> like this:</p><pre><code class=\"language-text-x-trilium-auto\">TRILIUM_DATA_DIR=/home/myuser/data/my-trilium-data trilium</code></pre><p>You can then save the above command as a shell script on your path for convenience.</p><h2>Electron user data directory (desktop only)</h2><p>When running the desktop application, Electron stores internal data (caches, spell-check dictionaries, session storage, etc.) separately from the Trilium data directory. By default this goes to the system's application data folder (e.g. <code>%APPDATA%</code> on Windows), which may be undesirable in corporate environments with roaming profiles or when running in portable mode.</p><p>To keep Electron data out of the system's roaming profile, set the <code>TRILIUM_ELECTRON_DATA_DIR</code> environment variable to an explicit path. The <code>trilium-portable</code> script does this automatically, pointing it to <code>trilium-electron-data/</code> next to the application.</p><h2>Fine-grained directory/path location</h2><p>Apart from the data directory, some of the subdirectories of it can be moved elsewhere by changing an environment variable:</p><figure class=\"table\"><table><thead><tr><th>Environment variable</th><th>Default value</th><th>Description</th></tr></thead><tbody><tr><td><code>TRILIUM_DOCUMENT_PATH</code></td><td><code>${TRILIUM_DATA_DIR}/document.db</code></td><td>Path to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_wX4HbRucYSDD\">Database</a>&nbsp;(storing all notes and metadata).</td></tr><tr><td><code>TRILIUM_BACKUP_DIR</code></td><td><code>${TRILIUM_DATA_DIR}/backup</code></td><td>Directory where automated&nbsp;<a class=\"reference-link\" href=\"#root/_help_ODY7qQn5m2FT\">Backup</a>&nbsp;databases are stored.</td></tr><tr><td><code>TRILIUM_LOG_DIR</code></td><td><code>${TRILIUM_DATA_DIR}/log</code></td><td>Directory where daily&nbsp;<a class=\"reference-link\" href=\"#root/_help_bnyigUA2UK7s\">Backend (server) logs</a>&nbsp;are stored.</td></tr><tr><td><code>TRILIUM_TMP_DIR</code></td><td><code>${TRILIUM_DATA_DIR}/tmp</code></td><td>Directory where temporary files are stored (for example when opening in an external app).</td></tr><tr><td><code>TRILIUM_ANONYMIZED_DB_DIR</code></td><td><code>${TRILIUM_DATA_DIR}/anonymized-db</code></td><td>Directory where a&nbsp;<a class=\"reference-link\" href=\"#root/_help_x59R8J8KV5Bp\">Anonymized Database</a>&nbsp;is stored.</td></tr><tr><td><code>TRILIUM_RESOURCES_DIR</code></td><td><code>${TRILIUM_DATA_DIR}/resources</code></td><td>Directory where <a class=\"reference-link\" href=\"#root/_help_ebyr7ES2SwOW\">Downloaded resources</a> are stored, such as the speech recognition models.</td></tr><tr><td><code>TRILIUM_CONFIG_INI_PATH</code></td><td><code>${TRILIUM_DATA_DIR}/config.ini</code></td><td>Path to&nbsp;<a class=\"reference-link\" href=\"#root/_help_Gzjqa934BdH4\">Configuration (config.ini or environment variables)</a>&nbsp;file.</td></tr><tr><td><code>TRILIUM_ELECTRON_DATA_DIR</code></td><td>System appData</td><td>Directory for Electron internal data (caches, spell-check dictionaries, etc.). Set this in portable mode to avoid writing to the system profile (desktop only).</td></tr></tbody></table></figure>",
+ "_help_ebyr7ES2SwOW": "<p>Downloaded resources are large files that some features need but that do not ship with Trilium, such as the speech recognition models used to transcribe meetings. Trilium downloads them the first time a feature needs them, and keeps them on the device for later use.</p><p>Currently, only&nbsp;<a class=\"reference-link\" href=\"#root/_help_Y84QCbArmK3z\">Meeting transcription</a>&nbsp;on the desktop application uses downloaded resources:</p><figure class=\"table\"><table><thead><tr><th>Resource</th><th>Size</th><th>License</th><th>Used for</th></tr></thead><tbody><tr><td>Parakeet TDT 0.6B v3 (standard)</td><td>0.6 GB</td><td>CC-BY-4.0</td><td>Recognizing speech, with the <em>Standard</em> model.</td></tr><tr><td>Parakeet TDT 0.6B v3 (high accuracy)</td><td>2.4 GB</td><td>CC-BY-4.0</td><td>Recognizing speech, with the <em>High accuracy</em> model.</td></tr><tr><td>Silero VAD</td><td>0.6 MB</td><td>MIT</td><td>Detecting when someone speaks.</td></tr><tr><td>TitaNet</td><td>40 MB</td><td>Apache-2.0</td><td>Telling speakers apart, while <em>Identify speakers</em> is on.</td></tr></tbody></table></figure><h2>Downloading resources</h2><p>When a feature needs resources that are not on the device yet, Trilium asks before downloading them. The dialog lists each resource with what it is used for, where it is downloaded from, its license and its size, followed by the total download size and the free space on the disk.</p><ul><li>To start the download, press <em>Download</em>. Each resource shows its progress, and the feature continues once all of them are downloaded.</li><li>To stop the download, press <em>Cancel</em> or close the dialog. The files already downloaded are kept, and the next download continues where this one stopped, even within a large file.</li><li>If the disk does not have enough free space, the dialog says so and the download cannot be started.</li></ul><p>Every file is checked against a checksum built into Trilium before it is used, so a file that was damaged or altered during the download is discarded.</p><aside class=\"admonition note\"><p>Downloaded resources are not synchronized. Each device that uses a feature downloads its resources separately, even when the notes are kept in sync through <a class=\"reference-link\" href=\"#root/_help_cbkrhQjrkKrh\">Synchronization</a>.</p></aside><h2>Managing downloaded resources</h2><p>To see the downloaded resources, go to <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Downloaded resources</em>. Each resource that was downloaded, or partly downloaded by an interrupted download, is listed with the space it takes on the disk and its status. Below the list, <em>Space used</em> shows the space they take in total, and how much free space is left on the disk.</p><ul><li>To open the folder of a resource, press the <span class=\"tn-icon bx bx-folder-open\"></span> button (desktop only).</li><li>To delete a resource, press the <span class=\"tn-icon bx bx-trash\"></span> button. If a feature needs it again, it is downloaded again.</li></ul><p>The list also shows, faded out, anything else in the resources folder:</p><ul><li><em>Older version</em>: the files of an earlier version of a resource. When a resource is updated, the new version is downloaded into a new folder, and the old one is left behind.</li><li><em>Not used</em>: a resource that no feature of this installation uses, for example one downloaded by a feature that was removed.</li><li><em>Unknown</em>: any other file or folder, for example one copied there by hand.</li></ul><p>These can be deleted in the same way.</p><aside class=\"admonition warning\"><p>If a server and a desktop application share the same data directory, a resource used by only one of them shows as <em>Not used</em> in the other. Deleting it there removes it for both.</p></aside><h2>Location</h2><p>The resources are stored in the <code>resources</code> folder of the <a class=\"reference-link\" href=\"#root/_help_tAassRL4RSQL\">Data directory</a>, one folder per resource. To store them elsewhere, set the <code>TRILIUM_RESOURCES_DIR</code> environment variable to another folder before starting Trilium.</p><h2>Installing without an Internet connection</h2><p>To install a resource on a device that cannot download it, copy its folder from the <code>resources</code> folder of a device that already has it into the same place on the other device. The next time a feature asks to download it, press <em>Download</em>: the files already in place are checked against their checksums and kept, and only the missing ones are downloaded.</p>",
+ "_help_x0JgW8UqGXvq": "<p>Trilium supports two different layouts, based on your preference.</p><h3>Vertical layout</h3><p>The vertical layout is Trilium's original layout:</p><ul><li>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>&nbsp;is positioned on the left side of the screen, with buttons being laid out vertically.</li><li>The tab bar is at the top, but to the right of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.</li><li>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_Ms1nauBra7gq\">Quick search</a>&nbsp;is at the top of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.</li><li>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;can be collapsed by pressing the&nbsp;<span class=\"tn-icon bx bx-chevrons-left\"></span> button at the bottom of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>.</li><li>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a>&nbsp;can be accessed via the&nbsp;<span class=\"tn-icon cke cke-trilium\"></span> icon at the top of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>.</li></ul><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/1_Vertical%20and%20horizontal%20layout_image.jpg\"></p><h3>Horizontal layout</h3><p>The horizontal layout is a more traditional layout, since it bears similarity with other applications. In this mode:</p><ul><li>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>&nbsp;is at the top of the screen, with the buttons laid horizontally.</li><li>The tab bar is at the top of the screen, but now covers the entirety of the width, allowing for more tabs to be displayed at once.</li><li>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_Ms1nauBra7gq\">Quick search</a>&nbsp;is now part of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>. It can be moved around according to preference and even removed if needed.</li><li>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;can be collapsed by pressing the small&nbsp;<span class=\"tn-icon bx bx-sidebar\"></span> button to the left of the first tab.</li><li>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a>&nbsp;can be accessed via the&nbsp;<span class=\"tn-icon bx bx-menu\"></span> button at the end of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>.</li></ul><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Vertical%20and%20horizontal%20layout_image.jpg\"></p><h2>Changing the layout</h2><p>Go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;and look for the <em>Appearance</em> option on the left. Then look for the <em>Layout</em> section, where there is the possibility to switch between the two available layouts.</p><p>Clicking an option will immediately apply the selected layout by reloading the window.</p>",
+ "_help_x3i7MxGccDuM": "<p>The global menu configures the current window (zoom, keeping the window on top) and offers access to some more advanced options.</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Global%20menu_image.jpg\"></p><h2>Accessing the global menu</h2><p>See&nbsp;<a href=\"#root/_help_x0JgW8UqGXvq\">Vertical and horizontal layout</a>&nbsp;since the position of the global menu is changed based on which layout has been selected.</p>",
+ "_help_oPVyFC7WL2Lp": "<p>This page explains how to manipulate the note tree in TriliumNext, focusing on moving notes.</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tree_image.jpg\"></p><h2>Drag and Drop</h2><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tree_drag-and-drop.gif\" alt=\"Drag and drop example\"></p><p>You can easily rearrange the note tree by dragging and dropping notes, as demonstrated in the example above.</p><h3>Importing files</h3><p>A file or archive can easily be imported into Trilium just by dragging it inside the note tree.</p><p>Note that a drag &amp; drop always imports with <em>safe import</em> on, meaning that some features such as scripts are disabled in the upcoming notes. To bypass that, use the dedicated <a href=\"#root/_help_mHbBMPDPkVV5\">import</a> feature (right click → <em>Import into note</em>).</p><p>Unlike the import dialog, the drag &amp; drop also has some basic auto-detection of the import. For example, dragging a .zip file with a <code>.obsidian</code> folder in it will automatically trigger a dedicated&nbsp;<a class=\"reference-link\" href=\"#root/_help_iWD7wiIuMtgV\">Obsidian</a>&nbsp;import.</p><h2>Keyboard Manipulation</h2><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tree_move-note-with-keyboard.gif\" alt=\"Example of using keyboard keys to move a note\">Trilium offers efficient keyboard-based manipulation using the following <a href=\"#root/_help_A9Oc6YKKc65v\">shortcuts</a>:</p><ul><li><kbd>Ctrl</kbd> + <kbd>↑</kbd> and <kbd>Ctrl</kbd> +<kbd>↓</kbd>: Move the note up or down in the order.</li><li><kbd>Ctrl</kbd>+<kbd>←</kbd>: Move the note up in the hierarchy by changing its parent to the note's grandparent.</li><li><kbd>Ctrl</kbd>+<kbd>→</kbd>: Move the note down in the hierarchy by setting its parent to the note currently above it (this action is best understood through a demo or hands-on experience).</li><li><kbd>←</kbd> and <kbd>→</kbd>: Expand and collapse a sub-tree.</li></ul><h2>Context Menu</h2><p>You can also move notes using the familiar cut and paste functions available in the context menu, or with the associated keyboard <a href=\"#root/_help_A9Oc6YKKc65v\">shortcuts</a>: <code>CTRL-C</code> ( <a href=\"#root/_help_IakOLONlIfGI\">copy</a>), <kbd>Ctrl</kbd> + <kbd>X</kbd> (cut) and <kbd>Ctrl</kbd> + <kbd>V</kbd> (paste).</p><p>See&nbsp;<a class=\"reference-link\" href=\"#root/_help_YtSN43OrfzaA\">Note tree contextual menu</a>&nbsp;for more information.</p><h2>Tree Settings</h2><p>Click the tree icon in the tree toolbar to open the tree settings popup. It contains the following options:</p><ul><li><em>Hide archived notes</em>: When enabled, archived notes are not shown in the tree.</li><li><em>Automatically collapse notes</em>: When enabled, notes are collapsed after a period of inactivity to keep the tree tidy.</li><li><em>Follow active note</em>: When enabled (default), the tree automatically scrolls and expands parent nodes to keep the currently active note visible. When disabled, the tree is fully detached from navigation — only the background highlight of the active note is updated, but the tree viewport and its expanded/collapsed state are never changed by navigation. Use the crosshair button to manually jump the tree to the active note at any time.</li></ul><h2>Keyboard shortcuts</h2><p>The note tree comes with multiple keyboard shortcuts to make editing faster, consult the dedicated&nbsp;<a class=\"reference-link\" href=\"#root/_help_DvdZhoQZY9Yd\">Keyboard shortcuts</a>&nbsp;section.</p>",
+ "_help_YtSN43OrfzaA": "<figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:269/608;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tree/1_Note%20tree%20contextual%20menu_image.png\" width=\"269\" height=\"608\"></figure><p>The <em>note tree menu</em> can be accessed by right-clicking in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.</p><h2>Interaction</h2><p>The contextual menu can operate:</p><ul><li>On a single note, by right clicking it in the note tree.</li><li>On multiple notes, by selecting them first. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_yTjUdsOi4CIE\">Multiple selection</a>&nbsp;on how to do so.<ul><li>When right clicking, do note that usually the note being right clicked is also included in the affected notes, regardless of whether it was selected or not.</li></ul></li></ul><h2>Available options</h2><aside class=\"admonition note\"><p>When multiple notes are selected, only a subset of notes will be active. The ones that do support multiple notes will mention this in the list below.</p></aside><p>The most frequent actions stand side by side at the top of the menu, each as an icon over its name. Use <kbd>←</kbd> and <kbd>→</kbd>, or <kbd>↑</kbd> and <kbd>↓</kbd>, to move between them.</p><ul><li><strong>Cut</strong><ul><li>Will place the given notes in clipboard.</li><li>Use one of the two paste functions (or the keyboard shortcuts) to move them to the desired location.</li></ul></li><li><strong>Clone</strong><ul><li>Will place the given notes in clipboard.</li><li>Use one of the two paste functions (or the keyboard shortcuts) to copy them to the desired location.</li><li>Note that the copy function here works according to the <a class=\"reference-link\" href=\"#root/_help_IakOLONlIfGI\">Cloning Notes</a> functionality (i.e. the note itself will be present in two locations at once, and editing it in one place will edit it everywhere).</li><li>To simply create a duplicate note that can be modified independently, look for <em>Duplicate</em>.</li></ul></li><li><strong>Paste into</strong><ul><li>Pastes the notes in clipboard as child notes of the right-clicked one.</li><li>Shown only after notes have been cut or cloned.</li></ul></li><li><strong>Paste after</strong><ul><li>Pastes the notes in clipboard underneath the right-clicked one.</li><li>Shown only after notes have been cut or cloned.</li></ul></li><li><strong>Delete…</strong><ul><li>Will delete the given notes, asking for confirmation first.</li><li>In the dialog, the following options can be configured:<ul><li><em>Delete also all clones</em> to ensure that the note will be deleted everywhere if it has been placed into multiple locations (see <a class=\"reference-link\" href=\"#root/_help_IakOLONlIfGI\">Cloning Notes</a>).</li><li><em>Erase notes permanently</em> will ensure that the note cannot be recovered from <a class=\"reference-link\" href=\"#root/_help_r5JGHN99bVKn\">Recent Changes</a>.</li></ul></li></ul></li></ul><p>The rest of the menu lists its options one per row:</p><ul><li><strong>Open note</strong><ul><li>Clicking it opens the note in a new <a href=\"#root/_help_3seOhtN8uLIY\">tab</a>.</li><li>Hovering it or clicking its arrow opens a submenu with the places the note can be opened in: <em>Open in a new tab</em>, <em>Open in a new split</em> (to the right of the note, within the current tab) and <em>Open in a new window</em>.</li></ul></li><li><strong>Quick edit</strong><ul><li>Opens the note in <a class=\"reference-link\" href=\"#root/_help_ZjLYv08Rp3qC\">Quick edit</a>, over the current one.</li></ul></li><li><strong>Hoist note</strong><ul><li>Will focus the note tree on this note. See <a class=\"reference-link\" href=\"#root/_help_OR8WJ7Iz9K4U\">Note Hoisting</a> for more information.</li></ul></li><li><strong>Insert note after</strong><ul><li>Allows easy creation of a note with a specified <a href=\"#root/_help_KSZ04uQ2D1St\">note type</a>.</li><li>The <em>Code</em> submenu starts with the scripting notes, each a code note set up for its role: <em>Custom CSS</em> (with <code>#appCss</code>), <em>Widget</em> (with <code>#widget</code> and a starting skeleton) and <em>Backend script</em>. The enabled code languages follow.</li><li><a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a> are grouped in the <em>Collection</em> submenu. The note types created less often, the <a class=\"reference-link\" href=\"#root/_help_B2ORr7OVEZtc\">Snippets</a> and the AI quick action are in the <em>More</em> submenu.</li><li><a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a> will also be present (if any) at the end of the list.</li><li>To find an entry quickly, type into the search box at the top of the submenu, or just start typing while the submenu is open. The submenu then lists every matching entry, including those inside its own submenus (such as a code language or a collection), each with the submenu it comes from. Use <kbd>↑</kbd> and <kbd>↓</kbd> to pick a match, <kbd>Enter</kbd> to create it, and <kbd>Esc</kbd> to clear the search.</li><li>The note will be added on the same level of hierarchy as the note selected.</li></ul></li><li><strong>Insert child note</strong><ul><li>Same as <em>Insert note after</em>, but the note will be created as a child of the selected note.</li></ul></li><li><strong>Move to…</strong><ul><li>Will display a modal to specify where to move the desired notes.</li></ul></li><li><strong>Clone to…</strong><ul><li>Will display a modal to specify where to <a href=\"#root/_help_IakOLONlIfGI\">clone</a> the desired notes.</li></ul></li><li><strong>Duplicate</strong><ul><li>Creates a copy of the note and its descendants, placed right after the original.</li><li>When the note has child notes, the item also has an arrow, set apart by a divider. Hovering the item or clicking the arrow opens a submenu:<ul><li><em>Note and its children</em> does the same as clicking <em>Duplicate</em>.</li><li><em>This note only</em> copies the note with its content and attributes, but without any of its child notes. Links and relations to the original children keep pointing at them.</li></ul></li><li>This process is different from <a class=\"reference-link\" href=\"#root/_help_IakOLONlIfGI\">Cloning Notes</a> since the duplicated note can be edited independently from the original.</li><li>An alternative to this, if done regularly, would be <a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>.</li></ul></li><li><strong>Archive/Unarchive</strong><ul><li>Marks a note as <a href=\"#root/_help_MKmLg5x6xkor\">archived</a>.</li><li>If the note is already archived, it will be unarchived instead.</li><li>Multiple notes can be selected as well. However, all the selected notes must be in the same state (archived or not), otherwise the option will be disabled.</li></ul></li><li><strong>Protect subtree/Unprotect subtree</strong><ul><li>On a note that is not protected, <em>Protect subtree</em> marks this note and all of its descendants as protected. On a protected note, the item reads <em>Unprotect subtree</em> and unprotects them instead. See <a class=\"reference-link\" href=\"#root/_help_bwg0e8ewQMak\">Protected Notes</a> for more information.</li><li>Hovering the item or clicking its arrow opens a submenu with both actions, for instance to unprotect the protected notes below a note that is not protected itself.</li></ul></li><li><strong>Import into note…</strong><ul><li>Opens the <a href=\"#root/_help_mHbBMPDPkVV5\">import</a> dialog and places the imported notes as child notes of the selected one.</li></ul></li><li><strong>Export…</strong><ul><li>Opens the <a href=\"#root/_help_mHbBMPDPkVV5\">export</a> dialog for the selected notes.</li></ul></li><li><strong>Search in subtree</strong><ul><li>Opens a full&nbsp;<a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>&nbsp;with it preconfigured to only look into this note and its descendants (the <em>Ancestor</em> field).</li></ul></li></ul><h2>Advanced options</h2><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:231/263;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tree/Note%20tree%20contextual%20menu_image.png\" width=\"231\" height=\"263\"></figure><p>The advanced options menu offers some of the less frequently used actions for notes.</p><p>To access these options, first look for the <em>Advanced</em> option at the bottom of the contextual menu to reveal a sub-menu with:</p><ul><li><strong>Apply bulk actions…</strong><ul><li>Opens the&nbsp;<a class=\"reference-link\" href=\"#root/_help_ivYnonVFBxbQ\">Bulk Actions</a>&nbsp;dialog, to apply actions such as adding labels or moving notes to multiple notes at once (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_yTjUdsOi4CIE\">Multiple selection</a>).</li></ul></li><li><strong>Edit branch prefix…</strong><ul><li>Opens a dialog to assign a name to be able to distinguish <a href=\"#root/_help_IakOLONlIfGI\">clones</a>, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_TBwsyfadTA18\">Branch prefix</a>&nbsp;for more information.</li></ul></li><li><strong>Convert to attachment…</strong><ul><li>Converts the selected notes to&nbsp;<a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>&nbsp;of their parent notes.</li><li>This functional is most useful when dealing with image&nbsp;<a class=\"reference-link\" href=\"#root/_help_W8vYD3Q1zjCR\">File</a>&nbsp;notes that were imported from an external source or an older version of Trilium.</li></ul></li><li><strong>Expand subtree</strong><ul><li>Expands all the child notes in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.</li></ul></li><li><strong>Collapse subtree</strong><ul><li>Collapses all the child notes in the note tree.</li></ul></li><li><strong>Sort by…</strong><ul><li>Opens a dialog to sort all the child notes of the selected note.</li><li>The sorting is done only once, there is an automatic sorting mechanism as well that can be set using&nbsp;<a class=\"reference-link\" href=\"#root/_help_zEY4DaJG4YT5\">Attributes</a>.</li><li>See&nbsp;<a class=\"reference-link\" href=\"#root/_help_aGlEvb9hyDhS\">Sorting Notes</a>&nbsp;for more information.</li></ul></li><li><strong>Copy note path to clipboard</strong><ul><li>Copies a URL fragment representing the full path to this branch for a note, such as <code>#root/Hb2E70L7HPuf/4sRFgMZhYFts/2IVuShedRJ3U/LJVMvKXOFv7n</code>.</li><li>The URL to manually create&nbsp;<a class=\"reference-link\" href=\"#root/_help_QEAPj01N5f7w\">Links</a>&nbsp;within notes, or for note&nbsp;<a class=\"reference-link\" href=\"#root/_help_wArbEsdSae6g\">Navigation</a>.</li></ul></li><li><strong>Recent changes in subtree</strong><ul><li>This will open&nbsp;<a class=\"reference-link\" href=\"#root/_help_r5JGHN99bVKn\">Recent Changes</a>, but filtered to only the changes related to this note or one of its descendants.</li></ul></li></ul>",
+ "_help_yTjUdsOi4CIE": "<p>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, it's possible to select multiple notes at one time. This won't affect the currently displayed note, but it allows to do batch operations.</p><h2>Types of multiple selection</h2><figure class=\"image image-style-align-right image_resized\" style=\"width:28.54%;\"><img style=\"aspect-ratio:335/306;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tree/Multiple%20selection_image.png\" width=\"335\" height=\"306\"></figure><h3>Selecting notes one by one</h3><p>To individually select each note, press the <kbd>Alt</kbd> key and click on the note to be selected.</p><p>The selected notes will be indicated via a different background color and an icon.</p><h3>Selecting notes in a sequence</h3><figure class=\"image image-style-align-right image_resized\" style=\"width:29.24%;\"><img style=\"aspect-ratio:233/205;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tree/Multiple%20selection_image.jpg\" width=\"233\" height=\"205\"></figure><p>When notes are in a sequence (e.g. one underneath the other), the entire selection can be made just by selecting the first and the last item instead of individually clicking all the notes.</p><p>To do so, first select the note to start the selection with. Then hold <kbd>Shift</kbd> and click on the note to end the selection with. All the notes between the start and the end note will be selected as well.</p><h2>Selected notes vs. active note</h2><p>There is a distinction between <em>selected notes</em> and the <em>active note</em>:</p><ul><li><em>Selected notes</em> are simply the notes that were selected in the multiple section process (i.e. either via <kbd>Alt</kbd> or <kbd>Shift</kbd>).</li><li>The <em>active note</em> is simply the note that whose content is being displayed to the right of the tree.<ul><li><p>Visually, it's identified in the tree by having a different background color and a subtle shadow.</p></li><li><p>The active note can also be selected case in which the icon and background will also change:</p><img class=\"image_resized\" style=\"aspect-ratio:317/223;width:35.1%;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tree/1_Multiple%20selection_image.png\" width=\"317\" height=\"223\"></li></ul></li></ul>",
+ "_help_DvdZhoQZY9Yd": "<p>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;comes with multiple keyboard shortcuts to make editing faster:</p><h2>Navigation within the tree</h2><ul><li><kbd><span>↑</span></kbd> and <kbd><span>↑</span></kbd> to navigate between notes.</li><li><kbd><span>←</span></kbd> to collapse a note with children, or <kbd><span>→</span></kbd> to expand it.</li><li><kbd><span>←</span></kbd> on a note with no children to navigate to its parent.</li></ul><h2>Opening notes</h2><ul><li><kbd>Click</kbd> to open the note in the current tab.</li><li><kbd>Ctrl</kbd>+<kbd>Click</kbd> or <kbd>Middle click</kbd> to open the note in a new tab.</li><li><kbd>Ctrl</kbd>+<kbd>Right click</kbd> to open the note in&nbsp;<a class=\"reference-link\" href=\"#root/_help_ZjLYv08Rp3qC\">Quick edit</a>.</li></ul><h2>Clipboard management</h2><ul><li><kbd>Ctrl</kbd>+<kbd>C</kbd> to copy one or more notes based on selection (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_IakOLONlIfGI\">Cloning Notes</a>).</li><li><kbd>Ctrl</kbd>+<kbd>X</kbd> to cut one or more notes (for moving them).</li><li><kbd>Ctrl</kbd>+<kbd>V</kbd> to paste them somewhere (which results in a copy or move based on the shortcut used).</li></ul><h2>Moving notes</h2><ul><li><kbd>Ctrl</kbd> + <kbd><span>↑</span></kbd> , <kbd>Ctrl</kbd> + <kbd><span>↓</span></kbd> - move note up/down in the note list.</li><li><kbd>Ctrl</kbd> + <kbd><span>←</span></kbd> - move note up in the note tree.</li><li><kbd>Ctrl</kbd>+<kbd><span>→</span></kbd> - move note down in the note tree.</li><li><kbd>Del</kbd> - deletes note and optionally its subtree (asked in the dialog).</li></ul><h2>Multiple selection</h2><p>See&nbsp;<a class=\"reference-link\" href=\"#root/_help_yTjUdsOi4CIE\">Multiple selection</a>&nbsp;for more information about how selection works.</p><ul><li><kbd>Alt</kbd>+<kbd>Click</kbd> – add a single note to the current selection.</li><li><kbd>Shift</kbd>+<kbd>Click</kbd> – select a range of notes, starting from the current note (the highlighted one) to the one that is being clicked.</li><li><kbd>Shift</kbd>+<kbd><span>↑</span></kbd>, <kbd>Shift</kbd>+<kbd><span>↓</span></kbd> – multi-select not above/below.</li><li><kbd>Ctrl</kbd>+<kbd>A</kbd> – select all notes in the current level</li></ul>",
+ "_help_wyaGBBQrl4i3": "<figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:328/45;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tree/1_Hiding%20the%20subtree_image.png\" width=\"328\" height=\"45\"><figcaption>An example of a collection with a relatively large number of children that are hidden from the tree.</figcaption></figure><p>The tree works well when the notes are structured in a hierarchy so that the number of items stays small. When a note has a large number of notes (in the order of thousands or tens of thousands), two problems arise:</p><ul><li>Navigating between notes becomes cumbersome and the tree itself gets cluttered with a large amount of notes.</li><li>The large amount of notes can slow down the application considerably.</li></ul><p>Since v0.102.0, Trilium allows the tree to hide the child notes of particular notes. This works for both&nbsp;<a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>&nbsp;and normal notes.</p><h2>Interaction</h2><p>When the subtree of a note is hidden, there are a few subtle changes:</p><ul><li>To indicate that the subtree is hidden, the note will not have an expand button and it will display the number of children to the right.</li><li>It's not possible to add a new note directly from the tree.<ul><li>For&nbsp;<a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>, it's best to use the built-in mechanism to create notes (for example by creating a new point on a geo-map, or by adding a new row in a table).</li><li>For normal notes, it's still possible to create children via other means such as using the&nbsp;<a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>&nbsp;system.</li></ul></li><li>Notes can be dragged from outside the note, case in which they will be cloned into it.<ul><li>Instead of switching to the child notes that were copied, the parent note is highlighted instead.</li><li>A notification will indicate this behavior.</li></ul></li><li>Similarly, features such as cut/copy and then paste into the note will also work.</li></ul><h2>Spotlighting</h2><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:322/83;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tree/Hiding%20the%20subtree_image.png\" width=\"322\" height=\"83\"></figure><p>Even if the subtree of a note is hidden, if a child note manages to become active, it will still appear inside the tree in a special state called <em>spotlighted</em>.</p><p>During this state, the note remains under its normal hierarchy, so that its easy to tell its location. In addition, this means that:</p><ul><li>The note position is clearly visible when using the&nbsp;<a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>.</li><li>The note can still be operated on from the tree, such as adding a&nbsp;<a class=\"reference-link\" href=\"#root/_help_TBwsyfadTA18\">Branch prefix</a>&nbsp;or moving it outside the collection.</li></ul><p>The note appears in italics to indicate its temporary display. When switching to another note, the spotlighted note will disappear.</p><aside class=\"admonition note\"><p>Only one note can be highlighted at the time. When working with multiple notes such as dragging them into the collection, no note will be spotlighted. This is intentional to avoid displaying a partial state of the subtree.</p></aside><h2>Working with collections</h2><p>For large collections, it can be helpful to hide their child notes for performance reasons or de-cluttering the tree.</p><p>To toggle this behavior:</p><ul><li>Open the collection and in&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>, look for <em>Hide child notes in tree</em>.</li><li>Right click the collection note in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;and select <em>Advanced</em> → <em>Show subtree</em>.</li></ul><h2>Working with normal notes</h2><p>It's possible to hide the subtree for normal notes as well, not just collections. To do so, right click the note in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;and select <em>Advanced</em> → <em>Hide subtree.</em></p>",
+ "_help_3seOhtN8uLIY": "<figure class=\"image image-style-align-center\"><img style=\"aspect-ratio:1119/43;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Tabs_image.png\" width=\"1119\" height=\"43\"></figure><p>In Trilium, tabs allow easy switching between notes.</p><h2>Layout</h2><p>Depending on the&nbsp;<a class=\"reference-link\" href=\"#root/_help_x0JgW8UqGXvq\">Vertical and horizontal layout</a>:</p><ul><li>For the vertical layout, the tabs will be placed at the top but to the right of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.</li><li>For the horizontal layout, the tabs will be placed at the top in full-width, above the&nbsp;<a href=\"#root/_help_oPVyFC7WL2Lp\">note tree</a>, allowing for more tabs to be comfortably displayed.</li></ul><h2>Interaction</h2><ul><li>To create a new tab, press the&nbsp;<span class=\"tn-icon bx bx-plus\"></span> button that is to the right of the last tab.</li><li>To close a tab, press the corresponding&nbsp;<span class=\"tn-icon bx bx-x\"></span> button.</li><li>For multitasking, tabs can be used alongside&nbsp;<a class=\"reference-link\" href=\"#root/_help_luNhaphA37EO\">Split View</a>. Each tab can have one or more notes, displayed horizontally.</li><li>Tabs can be reordered by drag-and-dropping it into a new position.</li><li>An existing tab can be displayed in a new window by dragging the tab upwards or downwards. It is not possible to combine tabs back into another window.</li></ul><h2>Keyboard interaction</h2><p>Since tabs are a commonly used feature, there are multiple keyboard shortcuts that can be used:</p><ul><li><kbd>Ctrl</kbd>+<kbd>T</kbd> to open a new tab.</li><li><kbd>Ctrl</kbd>+<kbd>W</kbd> to close the current tab.</li><li><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>T</kbd> to reopen the last closed tab.</li><li><kbd>Ctrl</kbd>+<kbd>Tab</kbd> and <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Tab</kbd> to go to the next or previous tab.</li><li><kbd>Ctrl</kbd>+<kbd>1</kbd>, <kbd>Ctrl</kbd>+<kbd>2</kbd>, up to <kbd>Ctrl</kbd>+<kbd>9</kbd> to activate the first, second and up to ninth tab.</li><li>There is also a shortcut to go to the last tab, but it is not assigned a key by default.</li></ul><h2>Mobile</h2><figure class=\"image image-style-align-right image_resized\" style=\"width:34.12%;\"><img style=\"aspect-ratio:1242/2688;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Tabs_IMG_1767.PNG\" width=\"1242\" height=\"2688\"></figure><p>Tabs are also supported on the&nbsp;<a class=\"reference-link\" href=\"#root/_help_RDslemsQ6gCp\">Mobile Frontend</a>.</p><p>Since v0.102.0, the tabs are displayed by pressing the dedicated tab switcher button in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>. In this view the tabs are laid out on a grid with a preview of the note content.</p><p>The context menu button at the top-right of the popup allows creating a new tab, reopening the last closed tab and closing all the tabs.</p><p><a class=\"reference-link\" href=\"#root/_help_luNhaphA37EO\">Split View</a>s are also indicated in the tab switcher, with two titles displayed in a tab.</p><aside class=\"admonition note\"><p>Versions prior to v0.102.0 also supported tabs, but they were displayed directly above the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>. The decision to use a more mobile-like tab switcher was taken because the original tab bar could not support many tabs at once and the new design better aligns with how mobile applications handle tabs.</p></aside>",
+ "_help_xYmIYSP6wE3F": "<h2>Position of the Launch bar</h2><p>On desktop, depending on the layout selected, the launcher bar will either be on the left side of the screen with buttons displayed vertically or at the top of the screen. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_x0JgW8UqGXvq\">Vertical and horizontal layout</a>&nbsp;for more information.</p><p>On mobile, the launch bar will always be at the bottom.</p><p>If there are too many items in the launch bar to fit the screen, it will become scrollable.</p><h2>Terminology</h2><ul><li><strong>Launcher</strong>: a button that can be (or is) displayed on the launch bar.</li><li><strong>Available Launcher</strong>: a launcher that is not displayed on the launch bar, but can be added.</li><li><strong>Visible Launcher</strong>: a launcher that is currently displayed on the launch bar.</li></ul><h2>Configuring the desktop Launch bar</h2><p>There are two ways to configure the launch bar:</p><ul><li>Right click in the empty space between launchers on the launch bar and select <em>Configure Launchbar…</em></li><li>Click on the&nbsp;<a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a>&nbsp;and select <em>Configure Launchbar</em>.</li></ul><p>This will open a new tab with the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;listing the launchers.</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Launch%20Bar_image.jpg\"></p><p>Expanding <em>Available Launchers</em> section will show the list of launchers that are not displayed on the launch bar. The <em>Visible Launchers</em> will show the ones that are currently displayed.</p><h2>Configuring the mobile launch bar</h2><p>The launch bar on mobile uses a different configuration from the desktop one. The reasoning is that not all desktop icons are available on mobile, and fewer icons fit on a mobile screen.</p><p>To configure the launch bar on mobile, go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a>&nbsp;and select <em>Configure Launchbar</em>.</p><p>The configure the mobile launch bar while on the desktop (especially useful to configure more complicated launchers such as scripts or custom widgets), go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a>&nbsp;→ Advanced → Show Hidden Subtree and look for the <em>Mobile Launch Bar</em> section. While in the hidden subtree, it's also possible to drag launchers between the <em>Mobile Launch Bar</em> and (Desktop) <em>Launch Bar</em> sections.</p><h3>Adding/removing and reordering launchers</h3><p>To display a new launcher in the launch bar, first look for it in the <em>Available Launchers</em> section. Then right click it and select <em>Move to visible launchers</em>. It is also possible to drag and drop the item manually.</p><p>Similarly, to remove it from the launch bar, simply look for it in <em>Visible Launchers</em> then right click it and select <em>Move to available launchers</em> or use drag-and-drop.</p><p>Drag-and-drop the items in the&nbsp;tree&nbsp;in order to change their order. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;for more interaction options, including using keyboard shortcuts.</p><h2>Customizing the launcher</h2><ul><li>The icon of a launcher can be changed just like a normal note. See&nbsp;<a href=\"#root/_help_p9kXRFAkwN4o\">note icons</a>&nbsp;for more information.</li><li>The title of the launcher can also be changed.</li></ul><h3>Resetting</h3><p>Resetting allows restoring the original configuration of Trilium for the launcher bar, or for a portion of it. Simply right click a launcher (or even the entire <em>Launch Bar</em> section) and select <em>Reset</em> to bring it back to the original state.</p><h3>Creating new launchers / types of launchers</h3><p>Right click either the <em>Available launchers</em> or <em>Visible launchers</em> sections and select one of the options:</p><ol><li><p><strong>Note Launcher</strong><br>A note launcher will simply navigate to a specified note.</p><ol><li>Set the <code>target</code> promoted attribute to the note to navigate to.</li><li>Optionally, set <code>hoistedNote</code> to hoist a particular note. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_OR8WJ7Iz9K4U\">Note Hoisting</a>&nbsp;for more information.</li><li>Optionally, set a <code>keyboardShortcut</code> to trigger the launcher.</li></ol></li><li><p><strong>Script Launcher</strong><br>An advanced launcher which will run a script upon pressing. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_CdNpE2pqjmI6\">Scripting</a>&nbsp;for more information.</p><ol><li>Set <code>script</code> to point to the desired script to run.</li><li>Optionally, set a <code>keyboardShortcut</code> to trigger the launcher.</li></ol></li><li><p><strong>Custom Widget</strong></p><p>Allows defining a custom widget to be rendered inside the launcher. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_SynTBQiBsdYJ\">Widget Basics</a>&nbsp;for more information.</p></li><li><p><strong>Spacers</strong><br>Launchers that create some distance between other launchers for better visual distinction.</p></li></ol><p>Launchers are configured via predefined&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>.</p>",
+ "_help_8YBEPzcpUgxw": "<figure class=\"image image-style-align-right image_resized\" style=\"width:25.95%;\"><img style=\"aspect-ratio:402/988;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Note%20menu_image.png\" width=\"402\" height=\"988\"></figure><p>The note menu contains various actions and configurations for the current note. It can be found in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_1P8QXI5edXNd\">Note buttons</a>&nbsp;area (to the right of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_l7pigIGu01K2\">Title</a>).</p><p>Every split has a note menu of its own, which acts on the note displayed in that split. Entries that don't apply to the current note are still listed but grayed out, while entries that only exist for some notes (described in <em>Note-specific entries</em>) appear only on those notes.</p><h2>Navigating the note</h2><ul><li><span class=\"tn-icon bx bx-search\"></span>&nbsp;<em>Search in note</em> opens the&nbsp;<a class=\"reference-link\" href=\"#root/_help_McngOG2jbUWX\">Search in note</a>&nbsp;bar, to find and replace text inside the current note. On the desktop application, the same bar opens with <kbd>Ctrl</kbd>+<kbd>F</kbd>.<ul><li>It is available on&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>,&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>,&nbsp;<a class=\"reference-link\" href=\"#root/_help_gBbsAeiuUxI5\">Mind Map</a>&nbsp;and&nbsp;<a class=\"reference-link\" href=\"#root/_help_GWHEkY4I4OE3\">Spreadsheets</a>&nbsp;notes,&nbsp;<a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>, PDF files, and any note displayed as&nbsp;<a class=\"reference-link\" href=\"#root/_help_4FahAwuGTAwC\">Note source</a>.</li></ul></li><li><span class=\"tn-icon bx bx-paperclip\"></span>&nbsp;<em>Note attachments</em> switches the note to the list of its&nbsp;<a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>, where they can be uploaded, opened, downloaded, renamed or deleted.</li><li><span class=\"tn-icon bx bxs-network-chart\"></span>&nbsp;<em>Note map</em> opens the&nbsp;<a class=\"reference-link\" href=\"#root/_help_KRlZFoIH0j6p\">Connections tab</a>&nbsp;of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>, which shows the&nbsp;<a class=\"reference-link\" href=\"#root/_help_BCkXAVs63Ttv\">Note Map (Link map, Tree map)</a>&nbsp;centered on the current note.</li></ul><h2>Note properties</h2><p>The toggles in this section take effect immediately:</p><ul><li><span class=\"tn-icon bx bx-share-alt\"></span>&nbsp;<em>Shared</em> publishes the note via&nbsp;<a class=\"reference-link\" href=\"#root/_help_R9pX4DGra2Vt\">Sharing</a>, by cloning it into the <em>Shared Notes</em> tree.<ul><li>Turning it off removes the clone from that tree. If the note exists only as a shared note, Trilium asks for confirmation, since unsharing it deletes it.</li><li>The toggle is unavailable on the root note, on the <em>Shared Notes</em> note itself, and on system notes.</li></ul></li><li><span class=\"tn-icon bx bx-lock-alt\"></span>&nbsp;<em>Protect the note</em> encrypts the note, turning it into one of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_bwg0e8ewQMak\">Protected Notes</a>. If no protected session is active, Trilium asks for the password first. Only the current note is affected, not its children.</li><li><span class=\"tn-icon bx bx-bookmark\"></span>&nbsp;<em>Bookmark</em> adds the note to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_u3YFHC9tQlpm\">Bookmarks</a>&nbsp;that are displayed in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>, or removes it from them.</li><li><span class=\"tn-icon bx bx-copy-alt\"></span>&nbsp;<em>Template</em> marks the note as one of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>&nbsp;(by adding the <code>#template</code> label), which makes it available when creating a new note.</li><li><span class=\"tn-icon bx bx-expand-horizontal\"></span>&nbsp;<em>Full width</em> lets the note use the whole width of the window instead of the limit set in&nbsp;<a class=\"reference-link\" href=\"#root/_help_t596jLvPrqkS\">Content width</a>&nbsp;by adding the <code>#fullContentWidth</code> label. It is not listed for note types that are always displayed at full width.</li></ul><p>The two submenus in this section:</p><ul><li><span class=\"tn-icon bx bx-file\"></span>&nbsp;<em>Note type</em> changes the type of the note to any of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_KSZ04uQ2D1St\">Note Types</a>; the current one is checked. If the note already has content, Trilium asks for confirmation first, since the content generally doesn't carry over.&nbsp;<a class=\"reference-link\" href=\"#root/_help_jludwdW7N4hg\">Converting between note types</a>.<ul><li>For a&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;note, the language is chosen in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_AlJ73vBCjWDw\">Status bar</a>&nbsp;instead.</li></ul></li><li><span class=\"tn-icon bx bx-edit-alt\"></span>&nbsp;<em>Editable</em> controls when the note opens as read-only (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_CoFPLs3dRlXc\">Read-Only Notes</a>):<ul><li><em>Auto</em> (the default): the note is editable, unless it is long enough to be opened as read-only automatically.</li><li><em>Read-only</em>: the note always opens as read-only, but can still be edited after pressing <em>Edit note</em>.</li><li><em>Always Editable</em>: the note is always editable, regardless of its length.</li></ul></li></ul><h2>Importing, exporting and printing</h2><ul><li><span class=\"tn-icon bx bx-import\"></span>&nbsp;<em>Import files</em> opens the import dialog, which imports files as children of the current note. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_mHbBMPDPkVV5\">Import &amp; Export</a>. It is unavailable on&nbsp;<a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a>&nbsp;notes.</li><li><span class=\"tn-icon bx bx-export\"></span>&nbsp;<em>Export note</em> opens the export dialog with <em>Only this note</em> selected; select <em>This note &amp; all descendants</em> there to export the whole subtree.</li><li><span class=\"tn-icon bx bx-printer\"></span><em>Print note…</em> prints the note. On the desktop application this entry reads <em>Print/export to PDF…</em> and can also save the note as a PDF file. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_NRnIZmSMc5sj\">Printing &amp; Exporting as PDF</a>, including which note types and collections can be printed.</li></ul><p>Some note types add their own export formats right below <em>Export note</em>:</p><ul><li><span class=\"tn-icon bx bxs-file-image\"></span><em>Export as image</em>, on&nbsp;<a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a>&nbsp;and&nbsp;<a class=\"reference-link\" href=\"#root/_help_gBbsAeiuUxI5\">Mind Map</a>&nbsp;notes, downloads the diagram as <em>PNG (raster)</em> or <em>SVG (vector)</em>.</li><li><span class=\"tn-icon bx bxs-spreadsheet\"></span><em>Export to Excel (.xlsx)</em> and <em>Export to CSV (.csv)</em>, on&nbsp;<a class=\"reference-link\" href=\"#root/_help_GWHEkY4I4OE3\">Spreadsheets</a>, download the spreadsheet in those formats.</li></ul><h2>Revisions</h2><p>These entries manage the&nbsp;<a class=\"reference-link\" href=\"#root/_help_vZWERwf8U3nx\">Note Revisions</a>&nbsp;of the note:</p><ul><li><span class=\"tn-icon bx bx-history\"></span><em>Note revisions…</em> opens the revisions dialog, where previous versions can be previewed, compared with the current one, downloaded or restored.</li><li><span class=\"tn-icon bx bx-save\"></span><em>Save revision</em> saves a revision of the note right away, instead of waiting for the next automatic snapshot.</li><li><span class=\"tn-icon bx bx-purchase-tag\"></span><em>Save named revision…</em> also saves a revision right away, but first asks for a short description of the changes, which is shown in the revisions dialog.</li></ul><h2>Note-specific entries</h2><p>The following entries only appear on some notes:</p><ul><li><span class=\"tn-icon bx bx-pencil\"></span><em>Edit note</em> appears at the top of the menu when the note is currently read-only. It enables editing until the note is closed.</li><li><span class=\"tn-icon bx bx-align-justify\"></span><em>Word wrap</em> appears at the top of the menu on&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;notes, and sets whether long lines wrap in this note:<ul><li><em>Auto</em> (the default) follows&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Code Notes</em> → <em>Wrap lines in code notes</em>.</li><li><em>On</em> and <em>Off</em> override it for this note only, by setting the <code>#wrapLines</code> label.</li></ul></li><li><span class=\"tn-icon bx bx-paperclip\"></span><em>Convert into attachment</em> appears on an image note that has no children and a single parent which is a&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;note. After a confirmation, it turns the image into an attachment of its parent note and opens it there. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>.</li><li><span class=\"tn-icon bx bx-extension\"></span><em>Re-render note</em> appears on a&nbsp;<a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a>, and runs its script again to refresh the output.</li><li><span class=\"tn-icon bx bx-cog\"></span><em>Board properties</em> appears on a&nbsp;<a class=\"reference-link\" href=\"#root/_help_CtBQqbwXDx1w\">Kanban Board</a>, and configures its columns, card attributes and card templates.</li><li><span class=\"tn-icon bx bx-cog\"></span><em>Calendar properties</em> appears on a&nbsp;<a class=\"reference-link\" href=\"#root/_help_xWbu3jpNWapp\">Calendar</a> that creates events, and configures its event templates.</li><li><span class=\"tn-icon bx bx-cog\"></span><em>Geo map properties</em> appears on a&nbsp;<a class=\"reference-link\" href=\"#root/_help_81SGnPGMk7Xc\">Geo Map</a>, and configures its map settings and the image of an <a href=\"#root/_help_ZRDXGc0nAIh4\">image map</a>.</li><li><span class=\"tn-icon bx bx-cog\"></span><em>Table properties</em> appears on a <a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a>, and configures which notes it shows.</li></ul><h2>Advanced</h2><p>The <span class=\"tn-icon bx bx-wrench\"></span><em>Advanced</em> submenu groups the actions that are needed less often:</p><ul><li><p><span class=\"tn-icon bx bx-file-find\"></span><em>Open note externally</em> (desktop application only) saves the note to a temporary file and opens it in the application that the operating system associates with it. Trilium watches the file, and offers to upload the modified version back into the note. It is unavailable on&nbsp;<a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>&nbsp;and&nbsp;<a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a>&nbsp;notes.</p></li><li><p><span class=\"tn-icon bx bx-customize\"></span><em>Open note custom</em> (desktop application only, Windows and Linux) works like <em>Open note externally</em>, but lets you pick the application to open the file with.</p></li><li><p><span class=\"tn-icon bx bx-code\"></span><em>Note source</em> shows the&nbsp;<a class=\"reference-link\" href=\"#root/_help_4FahAwuGTAwC\">Note source</a>, the content of the note exactly as it is stored.</p></li><li><p><span class=\"tn-icon bx bxl-markdown\"></span><em>Convert to Markdown Note</em> (on text notes) and <em>Convert to Text Note</em> (on Markdown notes) switch the note between rich text and Markdown. After a confirmation, Trilium saves a revision and converts the content; the revision allows going back if some formatting was lost. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_jludwdW7N4hg\">Converting between note types</a>.</p></li><li><p><span class=\"tn-icon bx bx-collapse-alt\"></span><em>Compress images</em> opens a dialog that reduces the size of the images in the note. It lists the images found and how much space they take, and offers to:</p><ul><li>Resize the images larger than a chosen size.</li><li>Keep, or compress, JPEG images.</li><li>Keep, optimize, or convert to JPEG the PNG images.</li><li><em>Process child notes as well</em>, to include the images of the notes beneath this one.</li></ul><p>Compressing cannot be undone. Images can also be compressed automatically on upload, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_mT0HEkOsz6i1\">Images</a>.</p></li><li><p><span class=\"tn-icon bx bx-text\"></span><em>View OCR text</em> (on image and file notes) shows the text extracted from the note via&nbsp;<a class=\"reference-link\" href=\"#root/_help_TiQbQDgP8L5t\">Text Extraction (OCR)</a>. If the note has not been processed yet, the dialog offers to <em>Process OCR</em>.</p></li><li><p><span class=\"tn-icon bx bx-world\"></span><em>Open note on server</em> (desktop application only, listed when&nbsp;<a class=\"reference-link\" href=\"#root/_help_cbkrhQjrkKrh\">Synchronization</a>&nbsp;is configured) opens the same note on the sync server, in the web browser.</p></li></ul><h2>Deleting the note</h2><p><span class=\"tn-icon bx bx-trash\"></span><em>Delete note</em> opens the deletion dialog for the current note and its subtree. The dialog lists the notes that will be deleted and the relations that will be broken, and offers to:</p><ul><li>Also delete the other clones of the note, if it is cloned elsewhere. Otherwise, only the current placement is removed and the note stays in its other locations. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_IakOLONlIfGI\">Cloning Notes</a>.</li><li><em>Erase permanently</em> instead of the usual soft deletion. This cannot be undone.</li></ul><p>Notes deleted without erasing can be brought back, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_5Ct4MAJTS4tQ\">Restoring Deleted Notes</a>.</p><h2>Limitations</h2><ul><li>The note menu is not available on launchers.</li><li>On the notes of&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;and of the in-app help, most entries are grayed out, since these notes cannot be imported into, deleted or have revisions. Of the two, only the in-app help can be exported, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_mHbBMPDPkVV5\">Import &amp; Export</a>.</li><li>The <a href=\"#note-properties\">Note properties</a> section is only listed when the note itself is displayed, not its&nbsp;<a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>&nbsp;or its&nbsp;<a class=\"reference-link\" href=\"#root/_help_4FahAwuGTAwC\">Note source</a>.</li><li>In&nbsp;<a class=\"reference-link\" href=\"#root/_help_ZjLYv08Rp3qC\">Quick edit</a>, <em>Search in note</em>, <em>Note map</em>, <em>Full width</em> and <em>Convert into attachment</em> are not listed.</li></ul><h2>Mobile support</h2><p>On the&nbsp;<a class=\"reference-link\" href=\"#root/_help_RDslemsQ6gCp\">Mobile Frontend</a>, the note menu opens as a sheet from the bottom of the screen. Besides the entries above, it contains the items that the desktop layout places elsewhere:</p><ul><li><em>Backlinks</em> and <em>Note paths</em>, at the top, which open the&nbsp;<a class=\"reference-link\" href=\"#root/_help_wfGXLmm7x27z\">Backlinks</a>&nbsp;and the other locations of the note.</li><li>The custom buttons of the note type (such as <span class=\"tn-icon bx bx-download\"></span><em>Download</em> on a&nbsp;<a class=\"reference-link\" href=\"#root/_help_W8vYD3Q1zjCR\">File</a>).</li><li><em>Insert child note</em>, which creates a note under the current one.</li><li><em>Create new split</em> and <em>Close this pane</em>, to manage the&nbsp;<a class=\"reference-link\" href=\"#root/_help_luNhaphA37EO\">Split View</a>.</li><li><em>Note attributes</em>, which opens the attributes of the note.</li><li>On&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes, the content language (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_veGu4faJErEM\">Content language &amp; Right-to-left support</a>); on&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;notes, the language of the code.</li><li><em>Note info</em> and&nbsp;<a class=\"reference-link\" href=\"#root/_help_xWtq5NUHOwql\">Similar Notes</a>.</li><li><em>Note map</em> opens the map in a popup instead of the right sidebar.</li></ul>",
+ "_help_1P8QXI5edXNd": "<p>The note buttons is an area at the top-right of a note with a few buttons:</p><ul><li>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>&nbsp;which offers commands for the note or its subtree, such as import, export, viewing the&nbsp;<a href=\"#root/_help_4FahAwuGTAwC\">Note source code</a>&nbsp;or&nbsp;<a href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>.</li><li><a class=\"reference-link\" href=\"#root/_help_luNhaphA37EO\">Split View</a>&nbsp;controls<ul><li><span class=\"tn-icon bx bx-dock-right\"></span>&nbsp;to open a new split</li><li><span class=\"tn-icon bx bx-chevron-right\"></span>/<span class=\"tn-icon bx bx-chevron-left\"></span> to move the pane around</li><li><span class=\"tn-icon bx bx-x\"></span>&nbsp;to close the pane.</li></ul></li><li>On some note types such as&nbsp;<a class=\"reference-link\" href=\"#root/_help_W8vYD3Q1zjCR\">File</a>&nbsp;and images, there are dedicated buttons (e.g.&nbsp;<span class=\"tn-icon bx bx-download\"></span> to download the file locally).</li></ul>",
+ "_help_4TIF1oA4VQRO": "<figure class=\"image image-style-align-center\"><img style=\"aspect-ratio:1189/709;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Options_image.png\" width=\"1189\" height=\"709\"></figure><p>The Options section allows the configuration of the TriliumNext client and server.</p><h2>Entering options</h2><p>The Options can be accessed via:</p><ul><li>The&nbsp;<a href=\"#root/_help_x3i7MxGccDuM\">Global menu</a>, by selecting the <em>Options</em> item.</li><li>The&nbsp;<span class=\"tn-icon bx bx-cog\"></span> button in the&nbsp;<a href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>&nbsp;which can optionally be hidden if not desirable.</li><li>Optionally, a keyboard shortcut can be defined, but it is not assigned by default.</li><li>By clicking on this link:&nbsp;<a class=\"reference-link\" href=\"#root/_hidden/_options\">Options</a>.</li></ul><p>Once in the options section, simply select one of the option categories using the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.</p><h2>Exiting options</h2><p>When entering the options, they are opened in a new <a href=\"#root/_help_3seOhtN8uLIY\">tab</a>. To close them, simply close the tab.</p><h2>Options when using sync</h2><p>When using&nbsp;<a class=\"reference-link\" href=\"#root/_help_cbkrhQjrkKrh\">Synchronization</a>, some of the options will be kept in sync across all the devices while others can be changed independently.</p><p>Generally, the options that relate to appearance are intentionally kept not synced in order to allow per-client customization (layout orientation, theme, vertical/horizontal layout, code block themes).</p>",
+ "_help_luNhaphA37EO": "<p>In Trilium, is possible to work with two or more notes side-by-side.</p><figure class=\"image image-style-align-center\"><img style=\"aspect-ratio:1398/1015;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Split%20View_2_Split%20View_image.png\" width=\"1398\" height=\"1015\"></figure><h2>Interactions</h2><ul><li>Press the&nbsp;<span class=\"tn-icon bx bx-dock-right\"></span> button to the right of a note's title to open a new split to the right of it.<ul><li>It is possible to have as many splits as desired, simply press again the button.</li><li>Only horizontal splits are possible, vertical or drag &amp; dropping is not supported.</li></ul></li><li>When at least one split is open, press the&nbsp;<span class=\"tn-icon bx bx-x\"></span> button next to it to close it.</li><li>Use the&nbsp;<span class=\"tn-icon bx bx-chevron-right\"></span> or the&nbsp;<span class=\"tn-icon bx bx-chevron-left\"></span> button to move around the splits.</li><li>Creating, closing and moving a split can also be triggered from a <a href=\"#root/_help_A9Oc6YKKc65v\">keyboard shortcut</a> (<em>Create New Split</em>, <em>Close Active Split</em>, <em>Move Split Left</em> and <em>Move Split Right</em>, all unassigned by default) or through the <a href=\"#root/_help_F1r9QtzQLZqm\">command palette</a>.</li><li>The focus can be moved from one split to the one next to it with the <em>Focus Split to the Left</em> and <em>Focus Split to the Right</em> actions, which stop at either end of the tab instead of continuing into the next tab. They are unassigned by default as well.</li><li>Each <a href=\"#root/_help_3seOhtN8uLIY\">tab</a> has its own split view configuration (e.g. one tab can have two notes in a split view, whereas the others are one-note views).<ul><li>The tab's title will indicate all the note titles, in the order of the splits from the left to right and separated by a bullet symbol.</li><li>The tab's icon will indicate the icon of the last active split, which will be automatically focused when clicking on the tab.</li></ul></li></ul><h2>Splits and the note tree &amp; hoisting</h2><p>Clicking on the content of a split will focus that split. While focused, the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;will also indicate the note that is being edited.</p><p>It is possible for each of the splits to have their own&nbsp;<a class=\"reference-link\" href=\"#root/_help_OR8WJ7Iz9K4U\">Note Hoisting</a>.</p><p>When a new split is created, it will share the same note hoisting as the previous one. An easy solution to this is to simply hoist the notes after the split is created.</p><p>This is generally quite useful for reorganizing notes from one place to the other, by hoisting the old place in the first split and hoisting the new place to the second one. This will allow easy cut and paste without the tree jumping around from switching between notes.</p><h2>Mobile support</h2><p>Since v0.100.0, it's possible to have a split view on the mobile view as well, with the following differences from the desktop version of the split:</p><ul><li>On smartphones, the split views are laid out vertically (one on the top and one on the bottom), instead of horizontally as on the desktop.</li><li>There can be only one split open per tab.</li><li>It's not possible to resize the two split panes.</li><li>When the keyboard is opened, the active note will be “maximized”, thus allowing for more space even when a split is open. When the keyboard is closed, the splits become equal in size again.</li></ul><p>Interaction:</p><ul><li>To create a new split, click the three dots button on the right of the note title and select <em>Create new split</em>.<ul><li>This option will only be available if there is no split already open in the current tab.</li></ul></li><li>To close a split, click the three dots button on the right of the note title and select <em>Close this pane</em>.<ul><li>Note that this option will only be available on the second note in the split (the one at the bottom on smartphones, the one on the right on tablets).</li></ul></li><li>When long-pressing a link, a contextual menu will show up with an option to <em>Open note in a new split</em>.<ul><li>If there's already a split, the option will replace the existing split instead.</li></ul></li></ul>",
+ "_help_RnaPdbciOfeq": "<figure class=\"image\"><img style=\"aspect-ratio:1990/1168;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Right%20Sidebar_image.png\" width=\"1990\" height=\"1168\"></figure><p>The right sidebar displays specific content for the current note. The sidebar is grouped into multiple tabs:</p><ul><li><a class=\"reference-link\" href=\"#root/_help_2dcGDhp9WFKb\">Outline tab</a>, which displays the table of contents, highlights and other navigation-related sections depending on the note type.</li><li><a class=\"reference-link\" href=\"#root/_help_uNtgN0cUKEBc\">Attributes tab</a>, which provides a visual editor for the current note's&nbsp;<a class=\"reference-link\" href=\"#root/_help_zEY4DaJG4YT5\">Attributes</a>.</li><li><a class=\"reference-link\" href=\"#root/_help_LrKznOtw9cQD\">AI chat tab</a>, which uses the&nbsp;<a class=\"reference-link\" href=\"#root/_help_GBBMSlVSOIGP\">AI</a>&nbsp;integration to chat, with optional access to the current note.</li><li><a class=\"reference-link\" href=\"#root/_help_KRlZFoIH0j6p\">Connections tab</a>, which groups together the note map, note paths, backlinks and similar notes.</li></ul><h2>Toggling the right sidebar</h2><p>There are two ways to toggle the right sidebar:</p><ul><li>Via the&nbsp;<span class=\"tn-icon bx bx-sidebar bx-flip-horizontal\"></span> icon near the title bar, which toggles whether the sidebar is docked.</li><li>Via the <em>Toggle right pane</em> <a href=\"#root/_help_A9Oc6YKKc65v\">keyboard shortcut</a>, which is not assigned by default.</li></ul><h2>Peeking the sidebar</h2><p>There is a small strip near the right edge of the app which shows an arrow icon.</p><ul><li>When the sidebar is hidden, pressing the edge will <em>peek</em> the sidebar.<ul><li>In this mode the sidebar is shown temporarily above the content, without shifting the content of your notes.</li><li>Clicking outside the sidebar while in peek mode will simply hide the sidebar. Same goes for the X button and clicking on the right edge.</li><li>Pressing the pin icon will dock the sidebar.</li></ul></li><li>When the sidebar is docked, pressing the edge will hide the sidebar (similar to the toggle icon at the top).</li></ul>",
+ "_help_2dcGDhp9WFKb": "<p>The Outline tab appears in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>&nbsp;and displays the headings and highlights for the current note.</p><h2>Table of contents</h2><p>The table of contents displays the titles / headings in the current note and allows easy navigation.</p><p>The following note types are supported:</p><ul><li><a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a></li><li><a class=\"reference-link\" href=\"#root/_help_6RM1Q7ppFVoj\">Markdown</a></li><li><a class=\"reference-link\" href=\"#root/_help_XJGJrpu7F9sh\">PDFs</a></li><li><a class=\"reference-link\" href=\"#root/_help_GBBMSlVSOIGP\">AI</a>&nbsp;chat notes</li><li>The pages of the in-app documentation</li></ul><figure class=\"image image-style-align-right image_resized\" style=\"width:47%;\"><img style=\"aspect-ratio:556/205;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Right%20Sidebar/1_Outline%20tab_image.png\" width=\"556\" height=\"205\"></figure><h3>Interaction</h3><ul><li>Clicking on a heading will scroll the document to the position of the heading.</li><li>As the document is scrolled, the heading being read is highlighted and the list scrolls to keep it in view. If that heading is hidden inside a collapsed section, the collapsed heading is highlighted instead.</li><li>Nested items can be collapsed by pressing the corresponding&nbsp;<span class=\"tn-icon bx bx-chevron-down\"></span> button.</li></ul><h2>Highlights</h2><figure class=\"image image-style-align-right image_resized\" style=\"width:46.04%;\"><img style=\"aspect-ratio:489/240;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Right%20Sidebar/Outline%20tab_image.png\" width=\"489\" height=\"240\"></figure><p>Similar to the&nbsp;table of contents, but instead of headings this feature will list highlighted text from a text note and allow easy navigation to them.</p><p>Unlike table of contents which supports multiple note types, the highlights are specific to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes.</p><p>Highlighted text is defined as:</p><ul><li>Bold text.</li><li>Italic text.</li><li>Underlined text.</li><li>Text with a foreground color set.</li><li>Text with a background color/highlight set.</li></ul><h3>Interaction</h3><ul><li>Clicking on a highlighted text will scroll the document to its position.</li></ul><h3>Configuration</h3><ul><li>Globally, it's possible to toggle the display of each category of highlighted text (as defined above)&nbsp;<ul><li>Pressing the gear button in the top-right part of the section will reveal a menu to toggle between the highlight categories.</li><li>Alternatively, they can be changed by going to&nbsp;<a class=\"reference-link\" href=\"#root/_hidden/_options/_optionsTextNotes\">Text Notes</a>&nbsp;settings and looking for the <em>Highlights List</em> section.</li></ul></li></ul><h2>PDF-specific outline</h2><p>When&nbsp;<a class=\"reference-link\" href=\"#root/_help_XJGJrpu7F9sh\">PDFs</a>&nbsp;are opened in Trilium, the&nbsp;<a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>&nbsp;is augmented with PDF-specific navigation, with the following features:</p><ul><li>Table of contents/outline<ul><li>All the headings and “bookmarks” will be displayed hierarchically.</li><li>The heading on the current page is also highlighted (note that it can be slightly offset depending on how many headings are on the same page).</li><li>Clicking on a heading will jump to the corresponding position in the PDF.</li></ul></li><li>Pages<ul><li>A preview of all the pages with a small thumbnail.</li><li>Clicking on a page will automatically navigate to that page.</li><li>Right-clicking a page and selecting <em>Copy reference</em> copies a link that opens the PDF at that page.</li></ul></li><li>Annotations<ul><li>Highlight and comment annotations are listed here.</li><li>Right-clicking an annotation and selecting <em>Copy reference</em> copies a link that opens the PDF at that annotation.</li></ul></li><li>Attachments<ul><li>If the PDF has its own attachments (not to be confused with Trilium's&nbsp;<a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>), they will be displayed in a list.</li><li>Some information such as the name and size of the attachment are displayed.</li><li>It's possible to download the attachment by clicking on the download button.</li></ul></li><li>Layers<ul><li>A less common feature, if the PDF has toggle-able layers, these layers will be displayed in a list here.</li><li>It's possible to toggle the visibility for each individual layer.</li></ul></li></ul>",
+ "_help_uNtgN0cUKEBc": "<figure class=\"image image-style-align-right image_resized\" style=\"width:34.71%;\"><img style=\"aspect-ratio:596/1688;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Right%20Sidebar/Attributes%20tab_image.png\" width=\"596\" height=\"1688\"></figure><p>The attributes tab provides a more graphical way to view and edit <a href=\"#root/_help_zEY4DaJG4YT5\">attributes</a>.</p><h2>Sections</h2><p>The following information is displayed in sections:</p><ul><li><em>Owned attributes</em>, contains a list of the attributes that belong to this note.</li><li><em>Inherited attributes</em> are attributes that apply to the current note but come through&nbsp;<a class=\"reference-link\" href=\"#root/_help_bwZpz2ajCEwO\">Attribute Inheritance</a>.</li><li><em>Definitions</em> describe the type of attributes and are used in&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>&nbsp;and&nbsp;<a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a>&nbsp;collections.</li></ul><h2>Owned attributes</h2><p>Every item is structured as such:</p><ul><li>The icon of each item indicates whether it's a <a href=\"#root/_help_HI6GBBIduIgv\">label</a> (<span class=\"tn-icon bx bx-hash\"></span>) or a <a href=\"#root/_help_Cq5X6iKQop6R\">relation</a> (<span class=\"tn-icon bx bx-transfer\"></span>, link to another note).</li><li>The first text is the name of the label.</li><li>The value of the attribute is displayed after the name, if present.<ul><li>The value is shown in a graphical way: a relation's value is a clickable note link; a color label shows a color chip.</li></ul></li></ul><p>System attributes (that have a special meaning in Trilium) show a small <span class=\"tn-icon bx bx-cog\"></span> cog near the icon and are grouped separately from the user-defined ones.</p><p>Interaction:</p><ul><li>Clicking on the item (apart from the value and links) reveals a dedicated popup where the name, value and&nbsp;<a class=\"reference-link\" href=\"#root/_help_bwZpz2ajCEwO\">Attribute Inheritance</a>&nbsp;can be defined.</li><li>The value of the attributes can be edited in-place:<ul><li>The input box follows the type defined in a corresponding label definition (date, color, dropdown, numbers), as well as for system attributes that have a specific type (e.g. <code>color</code>).</li><li>For labels, clicking on the value edits its in-place.<ul><li>Press <kbd>Enter</kbd> to confirm or click outside the input box, or <kbd>Esc</kbd> to dismiss.</li><li>For multi-line text, <kbd>Ctrl</kbd>+<kbd>Enter</kbd> confirms whereas <kbd>Enter</kbd> creates a newline.</li></ul></li><li>For checkbox attributes, clicking on the checkbox will toggle its state.</li><li>For labels without a value, a value can be added by clicking on the <em>No value</em> text which appears while the mouse is hovered on the item.</li><li>For relations, there is a dedicated <span class=\"tn-icon bx bx-pencil\"></span> button instead.</li></ul></li><li>An attribute can be deleted by pressing the <span class=\"tn-icon bx bx-trash\"></span> button to its right, which only appears while hovered. A confirmation screen is displayed first to ensure the attribute is not accidentally deleted.</li></ul><p>Attributes can be added in two ways:</p><ul><li>A new label, relation or attribute definition can be added from the <span class=\"tn-icon bx bx-plus\"></span> button near the title of the section. This shows the full detail popup.</li><li>To quickly add a label or a relation directly from the sidebar, click the <em>Add attribute</em> (<span class=\"tn-icon bx bx-plus\"></span>) item at the end of the list.<ul><li>The name field will be focused first. By default, a label will be created instead but it can be toggled to a relation by typing <kbd>~</kbd> or pressing the <span class=\"tn-icon bx bx-hash\"></span> icon (similarly, typing <code>#</code> will switch back to a label instead of a relation).</li><li>Once the name is filled, press <kbd>Enter</kbd> to continue to the value. Type in a value if desired and then press <kbd>Enter</kbd> again to create the attribute.</li><li>Clicking outside the editor will also create the attribute, but only if a name is specified.</li></ul></li></ul><h2>Inherited attributes</h2><p>Inherited labels or relations are shown in the same fashion as <em>Owned attributes</em>.</p><p>The only differences are:</p><ul><li>To the right of the inherited attribute there is a link to the note where the attribute comes from, as well as an <span class=\"tn-icon bx bx-sitemap\"></span> icon to indicate that it's inheritable.</li><li>Clicking on an inherited attribute will reveal the same popup as owned attributes, but it is not editable. To edit it, first navigate to the note where the attribute is defined.</li></ul><h2>Definitions</h2><p>For attribute definition (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>):</p><ul><li>The icon indicates the type of the attribute (text, number).<ul><li>If an attribute is promoted, it has a small <span class=\"tn-icon bx bx-chevron-up\"></span> chevron icon overlaid on top of it.</li></ul></li><li>The name indicates the name of the attribute it defines (without the <code>label:</code> or <code>relation:</code> prefix).</li><li>To the right of the name a short summary is displayed which indicates the display name (alias), whether it has multiple values or an inverse relation.</li><li>Clicking on a definition reveals a popup, where the name, type, display name and other aspects can be configured.</li><li>A new label or relation definition can be added from the <span class=\"tn-icon bx bx-plus\"></span> button near the title of the section.</li><li>For inherited definition, there is a link to the note where the definition comes from, as well as an <span class=\"tn-icon bx bx-sitemap\"></span> icon to indicate that it's inherited.</li></ul><h2>Mobile</h2><p>The attributes can also be edited visually on mobile, but not as part of the sidebar. Go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>&nbsp;and select <em>Note attributes</em>.</p>",
+ "_help_LrKznOtw9cQD": "<p>Once the&nbsp;<a class=\"reference-link\" href=\"#root/_help_GBBMSlVSOIGP\">AI</a>&nbsp;integration is activated, a <em>Chat</em> entry will appear in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>.</p><ul><li>Unlike the dedicated note type, the side bar has optional access to the current note, making it easy to ask for information or modifications to a note without having to search for the note first.<ul><li>To toggle whether the current note is visible to the AI, simply click on the file icon at the bottom of the chat interface.</li></ul></li><li>On the top-right of the sidebar there are three buttons:<ul><li>Create a new conversation.</li><li>Go to a previous conversation</li><li>Save the current conversation as a dedicated note in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_l0tKav7yLHGF\">Day Notes</a>, which turns it into a dedicated chat note.</li></ul></li></ul><aside class=\"admonition note\"><p>The sidebar chats are stored in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_2mUhVmZK8RF3\">Hidden Notes</a>&nbsp;and can be seen in the <em>AI Chat History</em> section.</p></aside>",
+ "_help_KRlZFoIH0j6p": "<figure class=\"image image-style-align-right image_resized\" style=\"width:33.35%;\"><img style=\"aspect-ratio:490/1801;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Right%20Sidebar/Connections%20tab_image.png\" width=\"490\" height=\"1801\"></figure><p>The connections tab groups together all the information about the current note and how it relates to other notes, in four different sections.</p><aside class=\"admonition note\"><p>It's generally best to keep only the desired sections expanded as each of the sections have to retrieve additional data that might not otherwise be needed. While collapsed, the sections do not retrieve any additional data.</p></aside><h2>Note map</h2><p>The note map displays a graph which shows the relation between the current notes and other notes on the hierarchy. There are two types of visualizations, which can be selected from the top-right part of the section:</p><ul><li>The <em>Link map</em> (<span class=\"tn-icon bx bx-network-chart\"></span>), which displays the <a href=\"#root/_help_Cq5X6iKQop6R\">relations</a> between notes.</li><li>The <em>Tree map</em> (<span class=\"tn-icon bx bx-sitemap\"></span>), which displays the hierarchical structure.</li></ul><p>The sidebar will remember which visualization is selected, as a global option. Note that note maps also have a <code>#mapType</code> which describes which visualization to use, but the sidebar deliberately ignores that to keep consistency when switching between notes.</p><p>The map can also be expanded by pressing the <span class=\"tn-icon bx bx-expand-alt\"></span> button in the top-right of the section. When expanded, the map is displayed in a separate dialog. Alternatively, all other sections can be collapsed, which will make the note map taller and the sidebar can be dragged to make for more lateral space.</p><p>The note map view inside the sidebar is deliberately more compact in order to fit the space: the link map would also show notes that don't have a link to the current note from the hierarchy (creating a cloud of dots) but this is only shown while the map is expanded. Similarly, the link strength and pin configuration buttons are not displayed here.</p><p>See also:</p><ul><li>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_bdUJEHsAPYQR\">Note Map</a>&nbsp;note type</li><li><a class=\"reference-link\" href=\"#root/_help_BCkXAVs63Ttv\">Note Map (Link map, Tree map)</a>&nbsp;for more information on the concept as a whole.</li></ul><h2>Note paths</h2><p>The note paths section displays the locations in which the current note is <a href=\"#root/_help_IakOLONlIfGI\">cloned</a>. Each segment of the note path is clickable, in order to navigate to that note or clone. The root note is shown as its icon, the same as in the <a class=\"reference-link\" href=\"#root/_help_I6p2a06hdnL6\">Breadcrumb</a>; hovering it shows its title.</p><p>A new clone can be created from the <span class=\"tn-icon bx bx-duplicate\"></span> button at the top-right.</p><h2>Backlinks</h2><p>Backlinks list the notes that refer to the current note, as well as a preview of the content where the reference to the note is made.</p><p>For more information, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_wfGXLmm7x27z\">Backlinks</a>.</p><h2>Similar notes</h2><p>Displays a list of notes that appear similar based on the content of the notes and their attributes. For more information, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_xWtq5NUHOwql\">Similar Notes</a>.</p>",
+ "_help_r5JGHN99bVKn": "<figure class=\"image image-style-align-center image_resized\" style=\"width:50%;\"><img style=\"aspect-ratio:988/572;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Recent%20Changes_image.png\" width=\"988\" height=\"572\"></figure><h2>Accessing the recent changes</h2><ul><li>For an overview of the changes across all documents, press the&nbsp;<span class=\"tn-icon bx bx-history\"></span> button in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>.<ul><li>If there is a <a href=\"#root/_help_OR8WJ7Iz9K4U\">hoisted note</a> or a <a href=\"#root/_help_9sRHySam5fXb\">workspace</a>, the list of recent changes will be limited to the descendents of the hoisted note, or the workspace.</li></ul></li><li>To limit the list of recent changes to a note and its descendants, look for the corresponding option in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_YtSN43OrfzaA\">Note tree contextual menu</a>&nbsp;→ Advanced.</li></ul><h2>Interaction</h2><ul><li>Notes which were changed will appear in reverse chronological order (latest update first).</li><li>The title of the note is displayed, as well as the note path. Clicking on the note title will dismiss the dialog and navigate to that particular note.</li><li>Deleted notes will also be listed here, at their time of deletion. Press the <em>Undelete</em> link next to them in order to recover them.</li></ul>",
+ "_help_ny318J39E5Z0": "<p>Zoom applies to the entire UI, including text.</p><p>On the desktop application, use the&nbsp;<a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a>&nbsp;to zoom in/out.</p><p>On both web browser and the desktop, the keyboard shortcuts <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>+</kbd> and <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>-</kbd> can be used.</p><h2>Adjusting the text size instead</h2><p>As an alternative to the zoom, the text size can be individually adjusted by going to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Appearance</em>.</p>",
+ "_help_lgKX7r3aL30x": "<figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:505/261;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tooltip_image.png\" width=\"505\" height=\"261\"></figure><p>The note tooltip is a convenience feature which displays a popup when hovering over an <a href=\"#root/_help_hrZ1D00cLbal\">internal link</a> to another note.</p><p>The following information is displayed:</p><ul><li>The note path, at the top of the popup.</li><li>The title of the note.<ul><li>Clicking on the title will open the note in the current tab.</li><li>Holding <kbd>Ctrl</kbd> pressed while clicking the title will open in a new tab instead of the current one.</li></ul></li><li>A snippet of the content will be displayed as well.</li><li>A button to <a href=\"#root/_help_ZjLYv08Rp3qC\">quickly edit</a> the note in a popup.</li></ul><p>For a link to an <a href=\"#root/_help_0vhv7lsOLy82\">attachment</a>, the tooltip shows the attachment instead: its title after the path of the note that owns it, a line giving its size (for example <em>Attachment • 20.59 MiB</em>), a preview of its content where one is available, and the quick edit button opening the attachment.</p><p>The tooltip can be found in multiple places, including:</p><ul><li>In&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes, when hovering over&nbsp;<a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>&nbsp;.</li><li><a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>: <ul><li><a class=\"reference-link\" href=\"#root/_help_81SGnPGMk7Xc\">Geo Map View</a>, when hovering over a marker.</li><li><a class=\"reference-link\" href=\"#root/_help_xWbu3jpNWapp\">Calendar View</a>, when hovering over an event.</li><li><a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table View</a>, when hovering over a note title, or over a <a href=\"#root/_help_Cq5X6iKQop6R\">relation</a>.</li></ul></li></ul>",
+ "_help_SL5f1Auq7sVN": "<p>Split view is a feature of&nbsp;<a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a>&nbsp;and&nbsp;<a class=\"reference-link\" href=\"#root/_help_6RM1Q7ppFVoj\">Markdown</a>&nbsp;notes which displays both the source code on one side and the preview of the content on the other.</p><p><a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a>&nbsp;also allow changing between a horizontal or a vertical split, to accommodate for the various sizes of diagrams.</p><h2>Display modes and interaction</h2><p>The split comes with three different display modes which can be toggled from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_1P8QXI5edXNd\">Note buttons</a>&nbsp;area:</p><ul><li><span class=\"tn-icon bx bxs-dock-left\"></span>&nbsp;<em>(Split view)</em>, in which both the source code is available on one side and can be edited, and the preview is available on the other side.<ul><li>In this mode, the size of either the source pane or the preview pane can be adjusted by dragging the small border between them.</li></ul></li><li><span class=\"tn-icon bx bx-code\"></span>&nbsp;(<em>Source view)</em> which shows the source code on the entire screen for a more focused editing experience.</li><li><span class=\"tn-icon bx bx-show\"></span>&nbsp;<em>(Preview)</em> which displays only the rendering of the diagram or text in full screen, especially useful for read-only notes.</li></ul><p>The display node is stored at note level.</p><h2>Relation to read-only notes</h2><p>If a note is marked as <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a>, the source view will not be editable. While in preview mode, marking a note as read-only has no effect since the preview itself is not editable.</p>",
+ "_help_t596jLvPrqkS": "<p>Some note types (such as&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;and saved search) intentionally limit the width of the content.</p><p>This might appear surprising at first, but the idea is to make text fit well on wider screens without appearing distorted. This is especially the case if the document contains&nbsp;<a class=\"reference-link\" href=\"#root/_help_mT0HEkOsz6i1\">Images</a>, tables or other width-dependent elements.</p><h2>Configuring the content width and alignment</h2><p>The content width is expressed in pixels and can be changed from&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Appearance</em> → <em>Content Width</em> and adjusting the <em>Max content width</em> section.</p><p>To effectively disable the content width limitation, simply set the width to a value larger than your screen size (e.g. 9999).</p><p>By default, the content is aligned to the left, but it can be centered horizontally by checking <em>Keep content centered</em> from the same section as the content width.</p><h2>Adjusting at note level</h2><p>For notes with large elements such as&nbsp;<a class=\"reference-link\" href=\"#root/_help_NdowYOC1GFKS\">Tables</a>, it sometimes makes sense to avoid the content width without affecting other notes. To do so:</p><ul><li>Go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>&nbsp;and toggle <em>Full width</em>.</li><li>Or manually apply the <code>fullContentWidth</code> <a href=\"#root/_help_HI6GBBIduIgv\">label</a> to the note.</li></ul><p>Since v0.107.0, a single table can also be made wider than the content width, in which case it scrolls sideways. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_NdowYOC1GFKS\">Tables</a>.</p><aside class=\"admonition note\"><p>Some <a href=\"#root/_help_KSZ04uQ2D1St\">note types</a> are full width by default, such as the&nbsp;<a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a>. In that case the <em>Full width</em> toggle will not be displayed and the label will have no effect.</p></aside><h2>Shared notes</h2><p>On a <a href=\"#root/_help_R9pX4DGra2Vt\">shared page</a>, a text note is shown at a fixed reading width, whatever the width configured in Options, and the navigation tree, the content and the table of contents are kept together in a column centered on a wide screen. A note with <code>fullContentWidth</code>, or of a type that is full width in the application, uses the whole width of the window there, with the navigation tree and the table of contents at its edges.</p>",
+ "_help_jcQVxzYybYgz": "<figure class=\"image image-style-align-right image_resized\" style=\"width:44.65%;\"><img style=\"aspect-ratio:514/291;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Note%20contextual%20menu_image.png\" width=\"514\" height=\"291\"></figure><p>Right-clicking the content of some note types such as&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;or&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;reveals a contextual menu.</p><h2>Features</h2><ul><li>On the&nbsp;<a class=\"reference-link\" href=\"#root/_help_poXkQfguuA0U\">Desktop Installation</a>, the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oBo3iHIZnbG2\">Spell Check</a>&nbsp;suggestions are shown when right clicking on a misspelled word.</li><li>The selected text can be searched either with a search engine (configured from&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>) or <a href=\"#root/_help_eIg8jdvaoNNd\">inside Trilium</a>.</li><li>Basic clipboard functionality (cut, copy, paste).</li><li>Copying the selected text as&nbsp;<a class=\"reference-link\" href=\"#root/_help_Oau6X9rCuegd\">Markdown</a>.</li><li>Performing quick operations using the&nbsp;<a class=\"reference-link\" href=\"#root/_help_VRoP0g1uHHc2\">In-editor AI assistant</a>.</li></ul><h2>Differences between desktop and web</h2><p>The <a href=\"#root/_help_WOcw2SLH6tbX\">web version</a> behaves slightly different due to limitations imposed by web browsers:</p><ul><li>When no text is selected or a word is right-clicked, the browser's default contextual menu is displayed.<ul><li>This is intentional since it preserves the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oBo3iHIZnbG2\">Spell Check</a>&nbsp;functionality.</li></ul></li><li>When a text is selected, a reduced menu is displayed instead which features only the functionality that is available within the browser version<ul><li><em>Paste</em> is not available since the browser doesn't expose it, use <kbd>Ctrl</kbd>+<kbd>V</kbd> instead.</li><li>The browser menu can be triggered anyway by pressing <kbd>Shift</kbd> + <kbd>Right click</kbd>.</li></ul></li></ul>",
+ "_help_AlJ73vBCjWDw": "<p>The status bar displays information about the current note and allows changing settings related to it such as configuring the language or attributes.</p><h2>Layout and interaction</h2><p>On the left side, the&nbsp;<a class=\"reference-link\" href=\"#root/_help_I6p2a06hdnL6\">Breadcrumb</a>&nbsp;is displayed which indicates the current note as well as its parent notes and allows for quick navigation throughout the hierarchy.</p><p>On the right side, specific sections will show depending on the type of the current note.</p><ol><li>For&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;notes, the language mode of the note is indicated (e.g. JavaScript, plain text), as well as allowing easy switching to another mode.</li><li>For&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes, the content language is displayed and can be changed, thus configuring the spell-check and the right-to-left support.<ol><li>Note that this applies to the entire note and not the selection, unlike some text editors.</li></ol></li><li>If a note is placed in multiple places in the tree (cloned), the number of the note paths will be displayed.<ol><li>Clicking it opens a popup with the full list of note paths, from which the note can also be cloned to a new location. The same list is available in the sidebar's&nbsp;<a class=\"reference-link\" href=\"#root/_help_KRlZFoIH0j6p\">Connections tab</a>.</li></ol></li><li>If a note has attachments, their number will be displayed.<ol><li>Clicking on it will reveal the list of attachments in a new tab.</li></ol></li><li>If a note is linked from other text notes (backlinks), the number of backlinks will be displayed.<ol><li>Clicking on it opens a popup with the list of notes that link to this note, as well as an excerpt of where the note is referenced. The same list is available in the sidebar's&nbsp;<a class=\"reference-link\" href=\"#root/_help_KRlZFoIH0j6p\">Connections tab</a>.</li></ol></li></ol><p>Regardless of note type, the following items will always be displayed if there is a note:</p><ol><li>Note info, which displays:<ol><li>The creation/modification date of the note.</li><li>The type and MIME of the note.</li><li>The note ID.</li><li>An estimation of the note size of the note itself and its children.</li><li>A button to reveal the Similar notes in the sidebar's&nbsp;<a class=\"reference-link\" href=\"#root/_help_KRlZFoIH0j6p\">Connections tab</a>.</li></ol></li></ol><aside class=\"admonition note\"><p>When pressing a button which reveals the&nbsp;<a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>, it has a specific behavior if the sidebar is hidden: the sidebar will be peeked instead of docked. Regardless the sidebar will be switched to the appropriate tab and the corresponding section will be highlighted.</p></aside>",
+ "_help_I6p2a06hdnL6": "<figure class=\"image\"><img style=\"aspect-ratio:1150/27;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Breadcrumb_image.png\" width=\"1150\" height=\"27\"></figure><p>The breadcrumb allows quickly viewing the note hierarchy of the current note and navigating through it.</p><p>It is part of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_AlJ73vBCjWDw\">Status bar</a>, displayed in the bottom-left of the screen.</p><h2>Layout and Interaction</h2><ul><li>If a note or workspace is hoisted, a badge will appear on the left-most side.<ul><li>Clicking on the badge will un-hoist the note/workspace.</li></ul></li><li>The left-most icon represents the root note, or the hoisted note or workspace.<ul><li>Clicking the icon will jump to the root note.</li><li>Right clicking the icon will display a menu that allows opening the note in a new tab, split, etc.</li></ul></li><li>Each segment shows the title of a note in the current note hierarchy.<ul><li>Clicking the icon will jump to that note.</li><li>Right clicking will open a menu with multiple options such as opening the note in a different tab/split/window, hoisting, moving/cloning the note, duplicating as well as changing the color of the note.</li></ul></li><li>Clicking the arrow next to each segment will reveal the child notes of the segment on the left.<ul><li>Clicking on an icon will navigate to that particular note.</li><li>It's also possible to create a new child note from here.</li><li>The menu can optionally hide the archived notes.</li></ul></li><li>If the current note is deep within a hierarchy, the segments will collapse into a […] button in order not to occupy too much space.<ul><li>Clicking this button will display each collapsed entry as a menu item. Clicking on it will navigate to that particular note.</li></ul></li><li>Right clicking on an empty space to the right of the breadcrumb (before the other status bar items) will reveal another menu that allows:<ul><li>Toggling whether archived notes are displayed in the breadcrumb and in the note tree.</li><li>Copying the current note path to clipboard.</li></ul></li></ul>",
+ "_help_BFs8mudNFgCS": "<p>Note is a central entity in Trilium. Main attributes of note are <a href=\"#root/_help_l7pigIGu01K2\">title</a> and content.</p><h3>Note types</h3><p>The main note type is a rich-text note type called&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>. For diagrams and drawing there is&nbsp;<a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a>&nbsp;and&nbsp;<a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a>.</p><p>There are also more complex note types such as&nbsp;<a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a>,&nbsp;<a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a>&nbsp;that usually go hand-in-hand with&nbsp;<a class=\"reference-link\" href=\"#root/_help_CdNpE2pqjmI6\">Scripting</a>.</p><p>In Trilium there's no specific \"folder\" note type. Any note can have children and thus be a folder. To make a note that only shows its children, like a folder in other applications, use a <a class=\"reference-link\" href=\"#root/_help_8QqnMzx393bx\">Grid View</a> or <a class=\"reference-link\" href=\"#root/_help_mULW0Q3VojwY\">List View</a> collection. See also <a class=\"reference-link\" href=\"#root/_help_i6dbnitykE5D\">FAQ</a>.</p><h3>Root note</h3><p>There's one special note called \"root note\" which is root of the note tree. All other notes are placed below it in the structure.</p><h3>Tree structure</h3><p>Importantly, note itself doesn't carry information on its placement in note tree. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_IakOLONlIfGI\">Cloning Notes</a>&nbsp;for details.</p><p>Tree structure of notes can resemble file system - but compared to that notes in Trilium can act as both file and directory - meaning that note can both have its own content and have children. \"Leaf note\" is a note which doesn't have any children.</p><h3>Deleting / undeleting notes</h3><p>When you delete a note in Trilium, it is actually only marked for deletion (soft-delete) - the actual content, title, attributes etc. are not deleted, only hidden.</p><p>Within (by default) 7 days, it is possible to undelete these soft-deleted notes - open the&nbsp;<a class=\"reference-link\" href=\"#root/_help_r5JGHN99bVKn\">Recent Changes</a>&nbsp;dialog, and you will see a list of all modified notes including the deleted ones. Notes available for undeletion have a link to do so. This is kind of \"trash can\" functionality known from e.g. Windows.</p><p>Clicking an undelete will recover the note, its content and attributes - note should be just as before being deleted. This action will also undelete note's children which have been deleted in the same action.</p><p>To be able to undelete a note, it is necessary that deleted note's parent must be undeleted (otherwise there's no place where we can undelete it to). This might become a problem when you delete more notes in succession - the solution is then undelete in the reverse order of your deletion.</p><p>After the 7 days (configurable) the notes will be \"erased\" - their title, content, revisions and attributes will be erased, and it will not be possible anymore to recover them (unless you restore a&nbsp;<a class=\"reference-link\" href=\"#root/_help_ODY7qQn5m2FT\">Backup</a>).</p><h2>See also</h2><ul><li><a class=\"reference-link\" href=\"#root/_help_CoFPLs3dRlXc\">Read-Only Notes</a></li></ul>",
+ "_help_l7pigIGu01K2": "<p>Alongside its content, the <strong>title</strong> is one of the two main attributes of a <a href=\"#root/_help_BFs8mudNFgCS\">note</a>. It's the short, human-readable name shown in the editable field at the top of every note, and it's what identifies the note throughout the interface (in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, in tabs, in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_I6p2a06hdnL6\">Breadcrumb</a>&nbsp;and win&nbsp;<a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>.</p><p>Internally, notes are identified by a unique&nbsp;<a class=\"reference-link\" href=\"#root/_help_m1lbrzyKDaRB\">Note ID</a>&nbsp;rather than by their title, so the title is purely for your benefit. This has a few consequences:</p><ul><li><strong>Titles don't have to be unique.</strong> You can have any number of notes that share the same title without conflict.</li><li><strong>Renaming a note never breaks links to it.</strong> Links between notes point at the underlying note, so changing a title leaves existing links intact (they'll simply display the new title).</li><li><strong>The title can be left empty.</strong> Notes with no title display a placeholder (<em>type note's title here…</em>) but are otherwise perfectly valid.</li></ul><p>In addition:</p><ul><li>There is no limitation on the length of the title, however in exports the title might get trimmed.</li><li>There are no forbidden symbols, unsupported characters will get trimmed when exporting.</li><li>When exporting to a ZIP file, a meta file will contain the full title which will be recognized by Trilium when importing again.</li></ul><h2>Inline title</h2><p><a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes have a special title bar behavior in which the <a href=\"#root/_help_l7pigIGu01K2\">note title</a> is initially displayed in a larger font, while also displaying additional information such as the creation and the modification date.</p><p>Whenever the title is scrolled past, the fixed title is shown instead.</p><p>Note types that take the entirety of the screen, such as&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;and&nbsp;<a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a>, will always have only the fixed title bar.</p><p>Under the note title, the&nbsp;<a class=\"reference-link\" href=\"#root/_help_m3VlURMSeOrd\">New note type switcher</a>&nbsp;appears if the note is empty.</p><figure class=\"image\"><img style=\"aspect-ratio:899/122;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Notes/Title_image.png\" width=\"899\" height=\"122\"><figcaption>The <em>Inline title</em>, which is displayed at the top of the note and can be scrolled past.</figcaption></figure><figure class=\"image\"><img style=\"aspect-ratio:910/104;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Notes/1_Title_image.png\" width=\"910\" height=\"104\"><figcaption>The fixed title bar. The title only appears after scrolling past the <em>Inline title</em>.</figcaption></figure><h3>Editing the title</h3><p>To rename a note, simply click into the title field and type. Changes are saved automatically as you type.</p><p>You can also begin editing the title directly from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;by selecting a note and pressing <kbd>Enter</kbd> (see <em>Edit note title</em> in&nbsp;<a class=\"reference-link\" href=\"#root/_help_A9Oc6YKKc65v\">Keyboard Shortcuts</a>), which focuses the title field for the active note.</p><aside class=\"admonition note\"><p>Titles may contain any characters, including Unicode and emoji. For security, any HTML in the title is stripped automatically, so the title is always treated as plain text.</p></aside><h3>Easily navigating between the title and the content</h3><p>When the cursor is in the title field, pressing <kbd>Enter</kbd> moves focus into the note's content. For&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes this also inserts a fresh empty paragraph at the very top of the document, so you can start writing immediately — much like other note-taking apps.</p><p>This makes it possible to create a note, type its title, press <kbd>Enter</kbd>, and continue straight into the body without reaching for the mouse.</p><h3>Working with new notes</h3><p>When you create a new note it's given a default title (<em>new note</em>) which is pre-selected, so you can type a name right away to replace it. The default title for new notes can be customized per-section — see&nbsp;<a class=\"reference-link\" href=\"#root/_help_47ZrP6FNuoG8\">Default Note Title</a>.</p><p>If you decide you don't want the note after all, pressing <kbd>Escape</kbd> while the title of a freshly created note is still focused will discard it.</p><h3>Automatically generated titles</h3><p>Some notes get their titles assigned automatically rather than typed:</p><ul><li><strong>Day, week, month and year notes</strong> in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_l0tKav7yLHGF\">Day Notes</a>&nbsp;are named from a configurable date pattern.</li><li><a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a>&nbsp;notes are named after the search they perform.</li><li>When a note is duplicated, a suffix is appended to the copy's title to tell it apart from the original.</li></ul><h3>Protected notes</h3><p>For&nbsp;<a class=\"reference-link\" href=\"#root/_help_bwg0e8ewQMak\">Protected Notes</a>, the title is <em>not</em> encrypted — only the content is. The title therefore remains visible in the tree and tabs even when no protected session is active. While locked, however, the title field is read-only and cannot be edited until you enter your password.</p><p>The titles of&nbsp;<a class=\"reference-link\" href=\"#root/_help_bwg0e8ewQMak\">Protected Notes</a>&nbsp;are encrypted along with their content. Before entering your password, Trilium cannot decrypt the title, so it is shown as <code>[protected]</code> in instead and the title cannot be modified.</p><p>Once you enter your password and a protected session is active, the real title is decrypted and displayed, and becomes editable again.</p>",
+ "_help_p9kXRFAkwN4o": "<h2>Icons</h2><figure class=\"image image-style-align-right image_resized\" style=\"width:48.4%;\"><img style=\"aspect-ratio:1089/995;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Notes/Note%20Icons%20%26%20Colors_image.png\" width=\"1089\" height=\"995\"></figure><p>Icons are useful for distinguishing notes and are displayed near the note title, as well as in various places such as the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>,&nbsp;<a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>&nbsp;or the&nbsp;<a class=\"reference-link\" href=\"#root/_help_F1r9QtzQLZqm\">Jump to &amp; command palette</a>.</p><p>While editing a note, click on the icon next to the title to bring up a chooser gallery.</p><p>Icons can be inherited through the use of&nbsp;<a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>, or&nbsp;<a class=\"reference-link\" href=\"#root/_help_bwZpz2ajCEwO\">Attribute Inheritance</a>.</p><aside class=\"admonition note\"><p>At the technical level, they are set by the <code>iconClass</code> attribute which adds a CSS class to the note. For example <code>#iconClass=\"bx bx-calendar\"</code> will show a calendar instead of the default page or folder icon. Looking up and remembering the CSS class names is not necessary.</p></aside><h2>Colors</h2><p>Notes can also carry a custom color. Similar to the note icon, this color will be shown in various places such as the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;and&nbsp;<a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>.</p><p>To set a custom color, right click on the note in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;and select a predefined color from there or use the color picker (last option).</p><p>Alternatively, a custom color can be set manually through the <code>#color</code> <a href=\"#root/_help_HI6GBBIduIgv\">label</a>, whose value must be a valid hex color including the leading <code>#</code> (e.g. <code>#ff0000</code> for red). This color can be carried over across multiple notes via&nbsp;<a class=\"reference-link\" href=\"#root/_help_bwZpz2ajCEwO\">Attribute Inheritance</a>.</p>",
+ "_help_0vhv7lsOLy82": "<p>A <a href=\"#root/_help_BFs8mudNFgCS\">note</a> in Trilium can <em>own</em> one or more attachments, which can be either images or files. These attachments can be displayed or linked within the note that owns them.</p><p>This can be especially useful to include dependencies for your <a href=\"#root/_help_CdNpE2pqjmI6\">scripts</a>. The&nbsp;<a class=\"reference-link\" href=\"#root/_help_R7abl2fc6Mxi\">Weight Tracker</a>&nbsp;shows how to use <a href=\"https://chartjs.org/\">chartjs</a> which is attached to the script note.</p><p>Each note exclusively owns its attachments, meaning attachments cannot be shared or linked from one note to another. If an attachment link is copied to a different note, the attachment itself is duplicated, and the copies are managed independently thereafter.</p><p>Attachments, especially image files, are the recommended method for embedding visuals in notes. It is important to link image attachments within the text of the owning note; otherwise, they will be automatically deleted after a configurable timeout period if not referenced.</p><h2>Types of attachments</h2><p>There are two different types of attachment:</p><ul><li><em>User content</em>, representing files or images that are uploaded and part of the content of the note.</li><li><em>System attachments</em> which are used internally by Trilium and can be of multiple types, including:<ul><li><a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>&nbsp;to store information about views such as the column information for the&nbsp;<a class=\"reference-link\" href=\"#root/_help_CtBQqbwXDx1w\">Kanban Board</a>.</li><li>Icons and cover images for&nbsp;<a class=\"reference-link\" href=\"#root/_help_UmgZAfcltxkS\">Link Previews</a>.</li><li>Debug information for some importers such as&nbsp;<a class=\"reference-link\" href=\"#root/_help_GnhlmrATVqcH\">Microsoft OneNote</a>&nbsp;(only if the debug flag was enabled at import time).</li></ul></li></ul><p>The system attachments are displayed at the end of the attachments list, in a dedicated section (<em>Generated by Trilium</em>).</p><h2>Attaching files from a text note</h2><p>To attach files to a&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;note and embed them in its content, press the <span class=\"tn-icon cke cke-paper-clip\"></span><em>Attach file</em> button in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>, next to the <span class=\"tn-icon cke cke-image-upload\"></span>image upload button, and select one or more files (see <em>Embedding an attachment</em> below). The arrow beside the button lists the same action as <em>Attach and embed file</em>, followed by <em>Attach file as a link</em>, which links the files instead. Both actions are also available as <em>Attach file as a link</em> and <em>Attach and embed file</em> in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a>.</p><p>When files are attached as links:</p><ul><li>Each file becomes an attachment of the note, and a link to it is inserted at the cursor. Several files produce several links, separated by a space.</li><li>While a file uploads, its link shows the file name and a toast shows the progress.</li><li>Pictures appear as links rather than images, and are attached exactly as they are, without being compressed. To display a picture in the text, use the image upload button instead (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_mT0HEkOsz6i1\">Images</a>).</li></ul><p>Dragging a file that is not a picture from the file explorer onto the text also attaches it and inserts a link to it.</p><h2>Acting on an attachment link</h2><p>Right-clicking a link to an attachment shows the ways to open it, followed by actions on the attachment: opening it externally, downloading it, uploading a new revision, renaming or deleting it, and converting it into a note.</p><p>Links follow changes to their attachment: renaming it updates the title they show, and deleting it removes them from the text notes open for editing at that moment. Converting it into a note turns its links into links to the new note.</p><h2>Embedding an attachment</h2><p>An attachment can be shown in the text instead of linked, the way&nbsp;<a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>&nbsp;shows a note: a picture is displayed, a PDF, a video or a document is previewed, and a code or text file is shown with syntax highlighting. An embedded code file can also be edited in place (see <em>Editing an include in place</em> in&nbsp;<a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>).</p><ul><li>To attach files and embed them straight away, press the <span class=\"tn-icon cke cke-paper-clip\"></span><em>Attach file</em> button. Each file gets an embed of its own, which shows the file name while the file uploads.</li><li>To embed an attachment that is already linked, right-click a link to it in a text note being edited and select <em>Convert link to an embed</em>, at the end of the menu.</li><li>A drawing canvas, inserted with <span class=\"tn-icon bx bx-pen\"></span><em>Drawing canvas</em> in the <span class=\"tn-icon cke cke-plus\"></span><em>Insert</em> menu, is an embed of a <code>Canvas.excalidraw</code> attachment that can be drawn on in place. An attached Excalidraw file (<code>.excalidraw</code>) is embedded as a drawing canvas too (see <em>Drawing canvases</em> in&nbsp;<a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>).</li><li>An embed gets the box size that suits the attachment, as a new included note does (see <em>Box sizes</em> there). To change its size, select the embed and use the box size menu in its toolbar, or the <em>Size</em> submenu of its <span class=\"tn-icon bx bx-dots-vertical-rounded\"></span><em>More actions</em> menu. A <em>Small</em>, <em>Medium</em> or <em>Expandable</em> embed can also be resized by dragging its handles (see <em>Resizing</em> there).</li><li>An embed can have a caption, as an included note can (see <em>Caption</em> there).</li><li>To show only the attachment, select the embed and press the&nbsp;<span class=\"tn-icon bx bx-window-alt\"></span> (<em>Show title)</em> button in its toolbar, as for an included note (see <em>Title</em> there).</li><li>To open the attachment in a new tab, press the&nbsp;<span class=\"tn-icon bx bx-link-external\"></span> (<em>Open in new tab)</em> button at the end of the embed's title.</li><li>An embed of size <em>Tiny</em> shows only the title of the attachment and its size, in a single row. Its buttons are <span class=\"tn-icon bx bx-file-find\"></span><em>Open externally</em> and <span class=\"tn-icon bx bx-download\"></span><em>Download</em>.</li><li>To show an embed of size <em>Medium</em> or <em>Full</em> on the whole screen, press the&nbsp;<span class=\"tn-icon bx bx-fullscreen\"></span> (<em>Fullscreen)</em> button at the end of its title. To return, press&nbsp;<span class=\"tn-icon bx bx-exit\"></span> (<em>Exit fullscreen)</em> in the top-right corner, or <kbd>Esc</kbd>.</li><li>To turn the embed back into a link, select it and press the <span class=\"tn-icon cke cke-link\"></span><em>Convert to link</em> button in its toolbar. <em>Convert to link</em> also ends the menu that right-clicking the title row of the embed or pressing its <span class=\"tn-icon bx bx-dots-vertical-rounded\"></span><em>More actions</em> button opens.</li></ul><p>An embed follows its attachment like a link does. Converting the attachment into a note turns the embed into an included note. In a <a href=\"#root/_help_R9pX4DGra2Vt\">shared note</a>, an embedded picture is displayed with its caption, a drawing canvas as a picture of the drawing, and any other attachment, or a picture in a <em>Tiny</em> embed, appears as a link to download it.</p><h2>Converting notes to attachments</h2><p><a class=\"reference-link\" href=\"#root/_help_W8vYD3Q1zjCR\">File</a>&nbsp;notes can be easily converted to attachments of the parent note.</p><p>To do so:</p><ul><li>For a single note, press the context menu from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>&nbsp;and select <em>Convert into attachment</em>.</li><li>For multiple notes, select the given notes in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, right click → Advanced → <em>Convert to attachment…</em>.</li></ul><h2>Attachment previews</h2><p>Attachments share the same content preview for images, videos, PDFs, etc. as the&nbsp;<a class=\"reference-link\" href=\"#root/_help_W8vYD3Q1zjCR\">File</a>&nbsp;note type.</p>",
+ "_help_IakOLONlIfGI": "<h2>Motivation</h2><p>Trilium's core feature is the ability to structure your notes into hierarchical tree-like structure.</p><p>It is expected then that you'll have an elaborate and deep note hierarchy - each subtree will represent a more refined and specialized view of your knowledge base.</p><p>This is a pretty powerful approach, but it also carries a hidden assumption that each \"subtopic\" is \"owned\" by one parent. I'll illustrate this with an example - let's say my basic structure is this:</p><ul><li>Technology<ul><li>Programming<ul><li>Kotlin</li><li>JavaScript</li></ul></li><li>Operating systems<ul><li>Linux</li><li>Windows</li></ul></li></ul></li></ul><p>Now, I'm starting to learn about <a href=\"https://en.wikipedia.org/wiki/Bash_(Unix_shell)\">Bash</a> and would like to create notes related to this topic. But now I'm facing a problem of where to categorize this. The issue here is that Bash is both a programming language and a tool (shell) very much tied into Linux. It seems it belongs to both of these, I can't (and don't want to) choose one over the other.</p><h2>Solution</h2><p>The solution to the problem shown above is to allow notes to have multiple parents.</p><p>I call these \"clones\", but that is a bit misleading - there's no original and cloned note - the notes in both of the parents categories are identical.</p><p>Another misleading thing about \"cloning\" is that it suggests that a copy of the note has been made. That's not really true, the note itself stays in just one original, it is just referenced in multiple places in the tree hierarchy. So changing it in one category changes it in all the others, because they're all the same note.</p><p>Here's the final structure with cloning:</p><ul><li>Technology<ul><li>Programming<ul><li>Kotlin</li><li>JavaScript</li><li>Bash<ul><li>some sub-notes ...</li></ul></li></ul></li><li>Operating systems<ul><li>Linux<ul><li>Bash<ul><li>some sub-notes ...</li></ul></li></ul></li><li>Windows</li></ul></li></ul></li></ul><p>So now the \"Bash\" subtree appears on multiple locations in the hierarchy. Both the Bash subtrees are the same and contain the same sub-categories and notes.</p><h3>Demo</h3><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Notes/Cloning%20Notes_create-clone.gif\"></p><p>In the demo, you can see how a clone can be created using the context menu. It's possible to do this also using the Add Link dialog or with <kbd>Ctrl</kbd>+<kbd>C</kbd> and <kbd>Ctrl</kbd>+<kbd>V</kbd> <a href=\"#root/_help_A9Oc6YKKc65v\">keyboard shortcuts</a>.</p><p>You can view the list of all available clones:</p><ul><li>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_AlJ73vBCjWDw\">Status bar</a>, by looking for the&nbsp;<span class=\"tn-icon bx bx-directions\"></span> icon.</li><li>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_KRlZFoIH0j6p\">Connections tab</a>&nbsp;of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>, by looking at the <em>Note paths</em> section.</li></ul><p>Titles of cloned notes in the tree view have an asterisk to the right to easily see that the note is also placed into some other location.</p><h2>Deleting notes/clones</h2><p>With clones, it might not be immediately obvious how deleting works.</p><p>If you try to delete a note, it works like this:</p><ol><li>if the note has multiple clones, delete just this clone and leave the actual note (and its other clones) as it is.</li><li>if this note doesn't have any other clones, delete the note<ul><li>Run the whole process starting with 1. on all note's children notes</li></ul></li></ol>",
+ "_help_TBwsyfadTA18": "<p>Since a single note can appear into multiple places in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;via a process called&nbsp;<a class=\"reference-link\" href=\"#root/_help_IakOLONlIfGI\">Cloning Notes</a>, it's recommended to choose a generalized name that fits into all locations instead of something more specific to avoid confusion.</p><p>In some cases this isn't possible so Trilium provides \"branch prefixes\", which is shown before the note name in the tree and as such provides a specific kind of context.</p><p>The prefix is location-specific, so it's displayed only in the note tree.</p>",
+ "_help_bwg0e8ewQMak": "<p>Trilium is designed to store a wide variety of data, including sensitive information such as personal journals, credentials, or confidential documents. To safeguard this type of content, Trilium offers the option to protect notes, which involves the following measures:</p><ul><li><strong>Encryption:</strong> Protected notes are encrypted using a key derived from your password. This ensures that without the correct password, protected notes remain indecipherable. Even if someone gains access to your Trilium <a href=\"#root/_help_wX4HbRucYSDD\">database</a>, they won't be able to read your encrypted notes.</li><li><strong>Time-limited access:</strong> To access protected notes, you must first enter your password, which decrypts the note for reading and writing. However, after a specified period of inactivity (10 minutes by default), the note is unloaded from memory, requiring you to re-enter your password to access it again.<ul><li>The session timeout is extended automatically while you're interacting with the protected note, so if you're actively editing, the session remains open. However, if you switch to an unprotected note, the session timer starts, and the session expires after 10 minutes of inactivity unless you return to the protected notes.</li></ul></li><li><strong>Protection scope:</strong> Protected notes ensure the confidentiality of their content and partially their integrity. While unauthorized users cannot read or edit protected notes, they can still delete or move them outside of the protected session.</li></ul><h2>Using Protected Notes</h2><p>By default, notes are unprotected. To protect a note, simply click on the shield icon next to the note's title, as shown here:</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Notes/Protected%20Notes_protecting-note.gif\" alt=\"example animation of unlocking protected notes\"></p><h2>What is Encrypted?</h2><p>Trilium encrypts the data within protected notes but not their metadata. Specifically:</p><p><strong>Encrypted:</strong></p><ul><li>Note title</li><li>Note content</li><li>Images</li><li>File attachments</li></ul><p><strong>Not encrypted:</strong></p><ul><li>Note structure (i.e., it remains visible that there are protected notes)</li><li>Metadata, such as the last modified date</li><li><a href=\"#root/_help_zEY4DaJG4YT5\">Attributes</a></li></ul><h2>Encryption Details</h2><p>The following steps outline how encryption and decryption work in Trilium:</p><ol><li>The user enters a password.</li><li>The password is passed through the <a href=\"https://en.wikipedia.org/wiki/Scrypt\">scrypt</a> algorithm along with a \"password verification\" <a href=\"https://en.wikipedia.org/wiki/Salt_(cryptography)\">salt</a> to confirm that the password is correct.</li><li>The password is then processed again through scrypt with an \"encryption\" salt, which generates a hash.<ul><li>Scrypt is used for <a href=\"https://en.wikipedia.org/wiki/Key_stretching\">key stretching</a> to make the password harder to guess.</li></ul></li><li>The generated hash is used to decrypt the actual <em>data encryption key</em>.<ul><li>The data encryption key is encrypted using <a href=\"https://en.wikipedia.org/wiki/Advanced_Encryption_Standard\">AES-128</a> with a random <a href=\"https://en.wikipedia.org/wiki/Initialization_vector\">IV</a>.</li><li>The data encryption key is randomly generated during the <a href=\"#root/_help_wX4HbRucYSDD\">database</a> initialization and remains constant throughout the document’s lifetime. When the password is changed, only this key is re-encrypted.</li></ul></li><li>The data encryption key is then used to decrypt the actual content of the note, including its title and body.<ul><li>The encryption algorithm used is AES-128 with <a href=\"https://en.wikipedia.org/wiki/Block_cipher_mode_of_operation\">CBC mode</a>, where a unique IV is generated for each encryption operation and stored with the cipher text.</li></ul></li></ol><h2>Sharing Protected Notes</h2><p>Protected notes cannot be shared in the same way as regular notes. Their encryption ensures that only authorized users with the correct password can access them.</p>",
+ "_help_MKmLg5x6xkor": "<p>Archived notes are notes which have <code>archived</code> <a href=\"#root/_help_zEY4DaJG4YT5\">attribute</a> - either directly or <a href=\"#root/_help_bwZpz2ajCEwO\">inherited</a>.</p><p>Such notes are then by default not shown in the autocomplete and in the full text <a href=\"#root/_help_eIg8jdvaoNNd\">search</a>.</p><p>This can be useful for notes which are no longer very useful but still valuable enough to keep around without them getting too much in the way.</p><p>You can control whether archived notes are displayed in the note tree with a setting:</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Notes/Archived%20Notes_hide-archived.png\"></p>",
+ "_help_vZWERwf8U3nx": "<figure class=\"image\"><img style=\"aspect-ratio:2089/1515;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Notes/Note%20Revisions_image.png\" width=\"2089\" height=\"1515\"></figure><p>Trilium supports seamless versioning of notes by storing snapshots (\"revisions\") of notes at regular intervals.</p><p>To display the revisions, press the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>&nbsp;and select <em>Note revisions…</em> (<span class=\"tn-icon bx bx-history\"></span>).</p><h2>Interaction</h2><aside class=\"admonition note\"><p>This documentation matches the redesign of the note revisions dialog on v0.103.0, older versions have a similar dialog but with some differences.</p></aside><ul><li>The full list of revisions are displayed on the left in reverse chronological order.<ul><li>The revisions are grouped by the date the revision was taken.</li><li>This list does not contain the <em>current state</em> of the note, so it is possible to have notes with no revisions/snapshots saved.</li></ul></li><li>The icon of a revision indicates the <em>source</em> of that revision (e.g. a&nbsp;<span class=\"tn-icon bx bx-save\"></span> icon for a manually saved revision).</li><li>Pressing the <span class=\"tn-icon bx bx-dots-horizontal-rounded\"></span> button on the top-right of the dialog displays multiple options, including:<ul><li><span class=\"tn-icon bx bx-save\"></span> Saving a new revision now.</li><li>Checking the interval and limit for this note (see below).</li><li><span class=\"tn-icon bx bx-trash\"></span> Deleting all the revisions of this note.</li></ul></li><li>For supported notes (text, code), changes are highlighted. This behavior can be toggled via the <em>Highlight changes</em> at the top of the dialog.<ul><li>The highlighted changes are relative to the <strong>current state of the note</strong>, not to the revision prior to this one.</li></ul></li><li>For any given revision, the buttons on the top-right allow operating on it:<ul><li><span class=\"tn-icon bx bx-trash\"></span> Deleting the revision.</li><li><span class=\"tn-icon bx bx-download\"></span> Downloading the revision locally.</li><li><span class=\"tn-icon bx bx-history\"></span> Restoring the revision, which replaces the current content of the note with the one from the revision. Another revision is saved containing the current content of the note.</li></ul></li></ul><h2>Named revisions</h2><p>Named revisions are a new feature of Trilium v0.103.0 which allows adding a short description of what the changes in the snapshot contain.</p><p>In the list of note revisions:</p><ul><li>The name of the revision is displayed underneath the time of the revision in the sidebar, as well as at the top of the dialog where it is displayed in full.</li><li>Clicking on the <span class=\"tn-icon bx bx-edit-alt\"></span> edit button near the name of the revision allows it to be changed.</li></ul><p>To create a named revision, either:</p><ul><li>Go to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>, select <em>Save named revision…</em> (<span class=\"tn-icon bx bx-purchase-tag\"></span>), enter the name of revision and confirm.</li><li>Use the corresponding <a href=\"#root/_help_A9Oc6YKKc65v\">keyboard shortcut</a> or the&nbsp;<a class=\"reference-link\" href=\"#root/_help_F1r9QtzQLZqm\">Jump to &amp; command palette</a>&nbsp;command with the same name.</li><li>Save a revision normally, and adjust the name afterwards from the note revision list.</li></ul><h2>When revisions are saved</h2><p>Revisions are saved:</p><ul><li>Automatically at a fixed interval. This behavior can be configured (see below).</li><li>Manually, by:<ul><li>Going to the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> and selecting <em>Save revision</em> (<span class=\"tn-icon bx bx-save\"></span>).</li><li>Using the <em>Force Save Revision</em> <a href=\"#root/_help_A9Oc6YKKc65v\">keyboard shortcut</a>.</li><li>In the <em>Note Revisions</em> dialog, pressing the <span class=\"tn-icon bx bx-dots-horizontal-rounded\"></span> button in the top-right and selecting <em>Save a revision now</em>.</li></ul></li></ul><p>Additionally, revisions can also come from somewhere else, and this is indicated via the icon of the revision:</p><ul><li><span class=\"tn-icon bx bx-code-alt\"></span> Generated externally, by&nbsp;<a class=\"reference-link\" href=\"#root/_help_pgxEVkzLl1OP\">ETAPI (REST API)</a>.</li><li><span class=\"tn-icon bx bx-bot\"></span> A modification created by&nbsp;<a class=\"reference-link\" href=\"#root/_help_GBBMSlVSOIGP\">AI</a>.</li><li><span class=\"tn-icon bx bx-history\"></span> A revision is restored, causing the existing note content to be saved as a revision to prevent potential data loss.</li></ul><h4>Snapshot interval</h4><p>Time interval of taking note snapshot is configurable in the Options → Other dialog. This provides a trade-off between more revisions and more data to store.</p><p>To turn off note versioning for a particular note (or sub-tree), add <code>disableVersioning</code> <a href=\"#root/_help_zEY4DaJG4YT5\">label</a> to the note.</p><h4>Maximum revisions</h4><p>The limit on the number of note snapshots can be configured in the Options → Other dialog. The note revision snapshot number limit refers to the maximum number of revisions that can be saved for each note. Where -1 means no limit, 0 means delete all revisions. You can set the maximum revisions for a single note through the <code>versioningLimit=X</code> label.</p><p>The note limit will not take effect immediately; it will only apply when the note is modified.</p><p>You can click the <em>Erase now</em> button under <em>Erase excess revision snapshots</em> to apply the changes immediately.</p>",
+ "_help_aGlEvb9hyDhS": "<h2>Manual sorting</h2><p>You can sort notes by right-clicking the parent note in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;and selecting Advanced -&gt; Sort notes by ... This will sort existing notes, but will not automatically sort future notes added to this parent note.</p><p>The sorting dialog allows:</p><ul><li>Sorting by title, creation or modification date, or by the value of a label on the child notes.</li><li>Sorting by several such criteria in turn, each ascending or descending: the next level only decides between notes the previous ones left equal.</li><li>Ensuring folders are displayed at the top.</li><li>Natural sort, based on the sorting rules of a particular language.</li></ul><h2>Automatic/Permanent Sorting</h2><p>Child notes can be automatically sorted by attaching specific <a href=\"#root/_help_zEY4DaJG4YT5\">labels</a> to the parent note:</p><figure class=\"table\"><table><thead><tr><th>Label</th><th>Description</th></tr></thead><tbody><tr><td><code>#sorted</code></td><td><p>Keeps child notes sorted by title alphabetically.</p><p>When given a value, it will sort by other criteria instead: a comma-separated list of levels, each <code>title</code>, <code>dateCreated</code>, <code>dateModified</code> or the name of a label on the child notes, optionally followed by <code>asc</code> or <code>desc</code>, as in a search's <code>orderBy</code>. For example <code>#sorted=\"priority desc, dueDate\"</code> sorts by priority, highest first, and notes of equal priority by due date. A child note without a level's label sorts after every child that has it, whichever direction the level runs in. When neither note has the label, the next level decides.</p></td></tr><tr><td><code>#sortDirection</code></td><td><p>If <code>sorted</code> is applied, specifies the direction of the sort:</p><ul><li><code>ASC</code>, ascending (default)</li><li><code>DESC</code>, descending</li></ul><p>A level of <code>sorted</code> followed by its own <code>asc</code> or <code>desc</code> keeps that direction regardless.</p></td></tr><tr><td><code>#sortFoldersFirst</code></td><td>If <code>sorted</code> is applied, folders (notes with children) will be sorted as a group at the top (at the bottom when <code>#sortDirection</code> is <code>desc</code>), and the rest will be sorted.</td></tr><tr><td><code>#sortNatural</code></td><td>Sort numbers naturally instead of alphabetically, so 2 comes before 10.</td></tr><tr><td><code>#sortLocale</code></td><td>The language code driving the natural sort (e.g. <code>zh-CN</code>, <code>de</code>). Only meaningful together with <code>#sortNatural</code>.</td></tr><tr><td><code>#top</code></td><td>If <code>sorted</code> is applied to the parent note, keeps given note on top in its parent.</td></tr><tr><td><code>#bottom</code></td><td>If <code>sorted</code> is applied to the parent note, keeps given note on bottom in its parent.</td></tr></tbody></table></figure><p>Sorting is done by comparing note properties or specific labels on child notes. There are four sorting levels, with the first having the highest priority. Lower priority levels are applied only if higher priority comparisons result in equality.</p><ol><li><strong>Top Label Sorting</strong>: Child notes with the <code>#top</code> label will appear at the top of the folder.</li><li><strong>Bottom Label Sorting</strong>: (Introduced in Trilium 0.62) Child notes with the <code>#bottom</code> label will appear at the bottom of the folder.</li><li><strong>Property/Label-Based Sorting</strong>: Sorting is based on the parent note's <code>#sorted</code> label:<ul><li><strong>Default Sorting</strong>: If <code>#sorted</code> has no value, notes are sorted alphabetically.</li><li><strong>Property Sorting</strong>: If <code>#sorted</code> is set to <code>title</code>, <code>dateModified</code>, or <code>dateCreated</code>, notes are sorted based on the specified property.</li><li><strong>Label Sorting</strong>: If <code>#sorted</code> has any other value, this value is treated as the name of a child note's label, and sorting is based on the values of this label. For example, setting <code>#sorted=myOrder</code> on the parent note and using <code>#myOrder=001</code>, <code>#myOrder=002</code>, etc., on child notes.</li><li><strong>Multi-Level Sorting</strong>: Several of the above can be combined, separated by commas; each level is applied only where the previous ones are equal. Every level can carry its own direction as a word after the name, <code>asc</code> or <code>desc</code>, otherwise it follows <code>#sortDirection</code>. For example <code>#sorted=\"priority desc, area, dateCreated\"</code> sorts by priority, highest first, then by area, then by creation date.</li></ul></li><li><strong>Alphabetical Sorting</strong>: Used as a last resort when other criteria result in equality.</li></ol><p>All comparisons are made string-wise (e.g., \"1\" &lt; \"2\" or \"2020-10-10\" &lt; \"2021-01-15\", but also \"2\" &gt; \"10\").</p>",
+ "_help_NRnIZmSMc5sj": "<figure class=\"image\"><img style=\"aspect-ratio:2023/1488;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Notes/Printing%20%26%20Exporting%20as%20PDF_image.png\" width=\"2023\" height=\"1488\"><figcaption>Screenshot of the Print preview functionality introduced in v0.103.0.</figcaption></figure><p>Trilium allows printing notes to a real printer, or generating a structured PDF for a single note or for multiple notes through&nbsp;<a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>.</p><p>Note that not all note types are printable as of now. We do plan to increase the coverage of supported note types in the future.</p><p>Printing and exporting as PDF are not perfect. Due to technical limitations, and sometimes even browser or Electron glitches the text might appear cut off in some circumstances.&nbsp;</p><h2>Printing a note or exporting as PDF on the desktop</h2><aside class=\"admonition note\"><p>Versions prior to v0.103.0 had two different options, one for printing and another one for exporting to PDF. With the introduction of the print preview, these functions have been unified.</p></aside><p>On the desktop application of Trilium it is possible to export a note as PDF. To print a note:</p><ul><li>Press the menu button in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>&nbsp;and select <em>Print note</em>.</li><li>Alternatively, printing can be triggered from a <a href=\"#root/_help_A9Oc6YKKc65v\">keyboard shortcut</a> (unassigned by default) or through the <a href=\"#root/_help_F1r9QtzQLZqm\">command palette</a>.</li></ul><p>This will trigger the print preview screen next.</p><h3>Print preview &amp; print options</h3><p>The print preview dialog allows the following printing options to be adjusted:</p><ul><li>The printer to use<ul><li><em>Save as PDF</em> generates a PDF that is structured (maintains a table of contents, keeps the text selectable). Prefer this over other virtual PDF printers that ship with the operating system.</li></ul></li><li>Page orientation: <em>Portrait</em> (default) or <em>Landscape</em>.</li><li>Page size</li><li>Scale the entire content from 10% to 200% to improve the fit within the page.</li><li>Margins, which can be removed completely or adjusted individually for all the four edges.</li><li>Print only a subset of pages. Individual page numbers are separated by colons and hyphen-based ranges are supported (e.g. 3-5 for pages 3 to 5).</li></ul><p>Additional interaction:</p><ul><li><em>Print using system dialog</em> allows setting more options that are otherwise not available in Trilium.</li></ul><p>If the note cannot be rendered with the current options, or stops making progress for 30 seconds, the preview is replaced by an error message. Adjust the options to try again.</p><aside class=\"admonition note\"><p>Most of the options here (except printer &amp; which pages to print) are managed at note level through&nbsp;<a class=\"reference-link\" href=\"#root/_help_zEY4DaJG4YT5\">Attributes</a>&nbsp;(such as <code>#printLandscape</code>, <code>#printPageSize</code>, <code>#printScale</code>, <code>#printMargins</code>).</p><p>This means that the print settings will be restored when printing the same note. There are no default settings that can be configured for all the notes, but this can be achieved via <a href=\"#root/_help_bwZpz2ajCEwO\">inheritable attributes</a>.</p></aside><h2>Printing on the browser</h2><p>This feature allows printing of notes. It works on both the desktop client, but also on the web.</p><p>To print a note, click the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>&nbsp;and select <em>Print note</em>. Depending on the size and type of the note, this can take up to a few seconds. Afterwards you will be redirected to the system/browser printing dialog.</p><p>On the server or PWA (mobile), the option is not available due to technical constraints and it will be hidden.</p><h2>Reporting issues with the rendering</h2><p>Should you encounter any visual issues in the resulting PDF file (e.g. a table does not fit properly, there is cut off text, etc.) feel free to <a href=\"#root/_help_wy8So3yZZlH9\">report the issue</a>. In this case, it's best to offer a sample note (click on the&nbsp;<span class=\"tn-icon cke cke-three-vertical-dots\"></span> button, select <em>Export note</em> → <em>This note and all of its descendants</em> → <em>HTML in ZIP archive</em>). Make sure not to accidentally leak any personal information.</p><p>Consider adjusting font sizes and using <a href=\"#root/_help_CohkqWQC1iBv\">page breaks</a> to work around the layout.</p><aside class=\"admonition tip\"><p>Although direct export as PDF is not available in the browser version of the application, it's still possible to generate a PDF by selecting the <em>Print</em> option instead and selecting “Save to PDF” as the printer (depending on the browser). Generally, Mozilla Firefox has better printing capabilities.</p></aside><h3>Automatic opening of the file</h3><p>When the PDF is exported, it is automatically opened with the system default application for easy preview.</p><p>Note that if you are using Linux with the GNOME desktop environment, sometimes the default application might seem incorrect (such as opening in GIMP). This is because it uses Gnome's “Recommended applications” list.</p><p>To solve this, you can change the recommended application for PDFs via this command line. First, list the available applications via <code>gio mime application/pdf</code> and then set the desired one. For example to use GNOME's Evince:</p><pre><code class=\"language-text-x-trilium-auto\">gio mime application/pdf</code></pre><h2>Printing multiple notes</h2><p>Since v0.100.0, it is possible to print more than one note at the time by using&nbsp;<a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>:</p><ol><li>First create a collection.</li><li>Configure it to use&nbsp;<a class=\"reference-link\" href=\"#root/_help_mULW0Q3VojwY\">List View</a>.</li><li>Print the collection note normally.</li></ol><p>The resulting collection will contain all the children of the collection, while maintaining the hierarchy.</p><aside class=\"admonition note\"><p>Not all note types are supported when printing or exporting to PDF. When an unsupported note is encountered, it is skipped. At the end, if any of the notes were skipped, a message will be displayed with the possibility of viewing the full list of skipped notes. The same limitations as the ones described in <em>Constraints &amp; limitations</em> apply.</p></aside><h2>Keyboard shortcut</h2><p>It's possible to trigger both printing and export as PDF from the keyboard by going to&nbsp;<em>Keyboard shortcuts</em>&nbsp;in&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;and assigning a key combination for:</p><ul><li><em>Print Active Note</em></li><li><em>Export Active Note as PDF</em></li></ul><h2>Constraints &amp; limitations</h2><p>Not all&nbsp;<a class=\"reference-link\" href=\"#root/_help_KSZ04uQ2D1St\">Note Types</a>&nbsp;are supported when printing, in which case the <em>Print</em> and <em>Export as PDF</em> options will be disabled.</p><ul><li>For&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes, font, background and table colors are printed in the shades of light themes, whatever the current theme (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_Gr6xFaF6ioJ5\">General formatting</a>).</li><li>For&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;notes:<ul><li>Line numbers are not printed.</li><li>Syntax highlighting is enabled, however a default theme (Visual Studio) is enforced.</li></ul></li><li>A <a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a> is printed as it is displayed, without running its script again, once its <code>~renderNote</code> relation is set.</li><li>For&nbsp;<a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>, the following are supported:<ul><li><a class=\"reference-link\" href=\"#root/_help_mULW0Q3VojwY\">List View</a>, allowing to print multiple notes at once while preserving hierarchy (similar to a book).</li><li><a class=\"reference-link\" href=\"#root/_help_zP3PMqaG71Ct\">Presentation</a>, where each slide/sub-note is displayed.<ul><li>Most note types are supported, especially the ones that have an image representation such as&nbsp;<a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a>&nbsp;and&nbsp;<a class=\"reference-link\" href=\"#root/_help_gBbsAeiuUxI5\">Mind Map</a>.</li></ul></li><li><a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a>, where the table is rendered in a print-friendly way.<ul><li>Tables that are too complex (especially if they have multiple columns) might not fit properly, however tables with a large number of rows are supported thanks to pagination.</li><li>Consider printing in landscape mode, or using <code>#printLandscape</code> if exporting to PDF.</li></ul></li><li>The rest of the collections are not supported, but we plan to add support for all the collection types at some point.</li></ul></li><li>Using&nbsp;<a class=\"reference-link\" href=\"#root/_help_AlhDUqhENtH7\">Custom app-wide CSS</a>&nbsp;for printing is no longer supported, instead a custom <code>printCss</code> relation needs to be used (see below).</li></ul><h2>Customizing the print CSS</h2><p>As an advanced use case, it's possible to customize the CSS used for printing such as adjusting the fonts, sizes or margins. Note that&nbsp;<a class=\"reference-link\" href=\"#root/_help_AlhDUqhENtH7\">Custom app-wide CSS</a>&nbsp;will not work for printing.</p><p>To do so:</p><ul><li>Create a CSS <a href=\"#root/_help_6f9hih2hXXZk\">code note</a>.</li><li>On the note being printed, apply the <code>~printCss</code> relation to point to the newly created CSS code note.</li><li>To apply the CSS to multiple notes, consider using <a href=\"#root/_help_bwZpz2ajCEwO\">inheritable attributes</a> or&nbsp;<a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>.</li></ul><p>For example, to change the font of the document from the one defined by the theme or the user to a serif one:</p><pre><code class=\"language-text-x-trilium-auto\">body {\n\t--print-font-family: serif;\n --print-font-size: 11pt;\n}</code></pre><aside class=\"admonition important\"><p>When altering <code>--print-font-family</code>, make sure the change is done at <code>body</code> level and not <code>:root</code>, since otherwise it won't be picked up due to specificity rules.</p></aside><p>To remark:</p><ul><li>Multiple CSS notes can be add by using multiple <code>~printCss</code> relations.</li><li>If the note pointing to the <code>printCss</code> doesn't have the right note type or mime type, it will be ignored.</li><li>If migrating from a previous version where&nbsp;<a class=\"reference-link\" href=\"#root/_help_AlhDUqhENtH7\">Custom app-wide CSS</a>, there's no need for <code>@media print {</code>  since the style-sheet is used only for printing.</li></ul><h2>Under the hood</h2><p>Both printing and exporting as PDF use the same mechanism: a note is rendered individually in a separate webpage that is then sent to the browser or the Electron application either for printing or exporting as PDF.</p><p>The webpage that renders a single note can actually be accessed in a web browser. For example <code>http://localhost:8080/#root/WWRGzqHUfRln/RRZsE9Al8AIZ?ntxId=0o4fzk</code> becomes <code>http://localhost:8080/?print#root/WWRGzqHUfRln/RRZsE9Al8AIZ</code>.</p><p>Accessing the print note in a web browser allows for easy debugging to understand why a particular note doesn't render well. The mechanism for rendering is similar to the one used in&nbsp;<a class=\"reference-link\" href=\"#root/_help_0ESUbbAxVnoK\">Note List</a>.</p>",
+ "_help_CoFPLs3dRlXc": "<p>Some note types such as&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>,&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;notes and even some of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>&nbsp;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.</p><h2>Automatic read-only mode</h2><p>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.</p><p>This behavior can be disabled on a per-note basis, by following the instructions of the next section.</p><p>In addition, it's possible to change the number of characters at which the automatic read-only mode will trigger in&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;by going to the options for&nbsp;<a class=\"reference-link\" href=\"#root/_hidden/_options/_optionsTextNotes\">Text Notes</a>&nbsp;and&nbsp;<a class=\"reference-link\" href=\"#root/_hidden/_options/_optionsCodeNotes\">Code Notes</a>.</p><h2>Changing a note's read-only behavior</h2><p>A note's read-only behavior can be changed via&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>&nbsp;→ <em>Editable.</em> The following options are possible:</p><ul><li><strong>Auto</strong><br>This is the default behavior in which the note will be editable by default, unless it becomes large enough to trigger read-only mode.</li><li><strong>Read-only</strong><br>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.</li><li><strong>Always Editable</strong><br>This option will bypass the automatic read-only activation for this particular note. It's useful for large notes that are frequently edited.</li></ul><p>If the <em>Editable</em> section is missing from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>, then the note type does not support read-only mode.</p><h3>Manually setting the options</h3><p>Apart from using the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>&nbsp;as previously mentioned, it's also possible to use <a href=\"#root/_help_zEY4DaJG4YT5\">labels</a> to change the behavior:</p><ul><li>To set as read-only, apply the <code>readOnly</code> label to the note.</li><li>To disable automatic read-only (always editable), apply the <code>autoReadOnlyDisabled</code> label.</li></ul><h2>Temporarily editing a read-only note</h2><p>When accessing a read-only note, it's possible to temporarily edit it pressing the <em>Read-only</em> badge.</p><p>When pressed, the note will become editable but will become read-only again after navigating to a different note.</p><p>The pages of the built-in user guide are an exception: they are part of Trilium itself and cannot be edited, not even temporarily. Their <em>Read-only</em> badge cannot be pressed, the note menu does not offer to edit them, and their attributes are shown in the right sidebar without a way to change them.</p>",
+ "_help_0ESUbbAxVnoK": "<figure class=\"image\"><img style=\"aspect-ratio:990/590;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Notes/Note%20List_image.png\" width=\"990\" height=\"590\"></figure><p>When a note has one or more child notes, they will be listed at the end of the note for easy navigation.</p><h2>Configuration</h2><ul><li>To hide the note list for a particular note, simply apply the <code>hideChildrenOverview</code> <a href=\"#root/_help_zEY4DaJG4YT5\">label</a>.</li><li>For some view types, such as Grid view, only a subset of notes will be displayed and pagination can be used to navigate through all of them for performance reasons. To adjust the number of notes per page, set <code>pageSize</code> to the desired number.</li></ul><h2>View types</h2><p>The view types dictate how the child notes are represented. By default, the notes will be displayed in a grid, however there are also some other view types available.</p><p>Generally the view type can only be changed from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>, but it can also be changed manually on any type of note using the <code>#viewType</code> <a href=\"#root/_help_HI6GBBIduIgv\">label</a>.</p>",
+ "_help_S0Fos78ZfcY7": "<p>The inbox is the default destination for quickly captured notes. When a note is created without picking a location first, it lands in the inbox. This makes it easy to quickly capture notes and sort them later.</p><h2>Where the inbox is used</h2><ul><li>The <em>New note</em> button in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>.</li><li>The global <em>Create note into inbox</em> shortcut (default <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>P</kbd>).</li><li>The <em>New note</em> action in the <a href=\"#root/_help_7iwde4lsKc6O\">tray icon menu</a>.</li><li>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_MtPxeAWVAzMg\">Web Clipper</a>&nbsp;extension.</li><li>The <em>Create note</em> option offered when a search finds no match, in&nbsp;<a class=\"reference-link\" href=\"#root/_help_F1r9QtzQLZqm\">Jump to &amp; command palette</a>, in an empty tab and in the <code>@</code> completion of a text note.</li></ul><h2>Setting a note inbox</h2><p>To create a note inbox, apply the <code>#inbox</code> <a href=\"#root/_help_HI6GBBIduIgv\">label</a> to it.</p><p>Only one note should carry this label. If there are multiple notes, only one will be used by the application.</p><aside class=\"admonition note\"><p>If there is no inbox note, Trilium will fall back to today's <a href=\"#root/_help_l0tKav7yLHGF\">day note</a>, creating it and its calendar ancestors as needed. If the journal has been removed altogether, the note is created at the top level instead of a new journal being built for it.</p></aside><h2>Workspace inboxes</h2><p>Each <a href=\"#root/_help_9sRHySam5fXb\">workspace</a> can have its own inbox, set via the <code>#workspaceInbox</code> label.</p><p>When a new note is created while hoisted in a workspace, the location is determined in the following order:</p><ul><li>A note carrying the <code>#workspaceInbox</code> label in that workspace.</li><li>A note carrying the <code>#inbox</code> within that workspace.</li><li>Today's <a href=\"#root/_help_l0tKav7yLHGF\">day note</a>, if the workspace has a <code>#workspaceCalendarRoot</code>.</li><li>The workspace root note itself.</li></ul>",
+ "_help_5Ct4MAJTS4tQ": "<p>Deleted notes are listed in the <em>Deleted Notes</em> dialog (<a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a> → <em>Show Deleted Notes</em>) and can be restored by pressing the <em>undelete</em> link.</p><p>If a note has child notes, they will be restored along with it. Should the original location no longer exist (e.g. the parent has been deleted), the note will be restored into the default location for new notes (<a class=\"reference-link\" href=\"#root/_help_S0Fos78ZfcY7\">Note Inbox</a>).</p><aside class=\"admonition note\"><p>When a note is hoisted in the tree, the dialog will only display notes deleted from the subtree of that hoisted note.</p></aside><p>To permanently erase deleted notes and clear the list, press the three-dots menu and select <em>Erase deleted notes now</em>.</p><p>Deleted notes are permanently erased after a certain amount of time (7 days by default). To change this interval, press the three-dots menu and select <em>Deleted Notes Settings</em>.</p>",
+ "_help_m3VlURMSeOrd": "<p>When an empty&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;note is created, a note type switcher will appear below the&nbsp;inline&nbsp;<a class=\"reference-link\" href=\"#root/_help_l7pigIGu01K2\">Title</a>. Apart from changing the note type, it's also possible to apply a <a href=\"#root/_help_KC1HB96bqqHX\">template</a>:</p><ul><li><span class=\"tn-icon bx bxl-markdown\"></span>&nbsp;<em>Markdown</em> and&nbsp;<span class=\"tn-icon bx bx-pen\"></span> <em>Canvas</em> switch the note to that type in one click.</li><li><span class=\"tn-icon bx bx-code\"></span>&nbsp;<em>Code</em> lists the scripting notes (<em>Custom CSS</em>, <em>Widget</em> and <em>Backend script</em>), then the enabled code languages.</li><li><span class=\"tn-icon bx bx-book\"></span>&nbsp;<em>Collection</em> and <span class=\"tn-icon bx bx-copy-alt\"></span><em>Template</em> list the collections and the templates.</li><li><span class=\"tn-icon bx bx-dots-vertical-rounded\"></span>&nbsp;<em>All types</em> displays the same menu as <em>Insert note after</em> in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_YtSN43OrfzaA\">Note tree contextual menu</a>, with every note type and template.</li></ul><p>Typing while the&nbsp;<span class=\"tn-icon bx bx-code\"></span> <em>Code</em>,&nbsp;<span class=\"tn-icon bx bx-copy-alt\"></span> <em>Template</em> or&nbsp;<span class=\"tn-icon bx bx-dots-vertical-rounded\"></span> <em>All types</em> menu is open narrows it down to the matching entries.</p><p>The switcher will disappear as soon as a text is entered.</p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Notes/New%20note%20type%20switcher_image.png\" width=\"735\" height=\"143\">",
+ "_help_B5dihXRDksTk": "<p>Note badges appear near the fixed note title and indicate important information about the note such as whether it is read-only. Some of the badges are also interactive.</p><figure class=\"image\"><img style=\"aspect-ratio:910/49;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Notes/Note%20badges_image.png\" width=\"910\" height=\"49\"></figure><p>The following badges are available:</p><ul><li><span class=\"tn-icon bx bx-lock-alt\"></span>&nbsp;<strong>Read-only badge</strong>, which will be shown if the note is not editable due to either automatic read-only or manual read-only. Clicking on the badge will temporarily edit the note. On the pages of the built-in user guide, which cannot be edited, the badge does nothing when clicked.</li><li><span class=\"tn-icon bx bx-share-alt\"></span>&nbsp;<strong>Share badge</strong>, which will indicate that the current note is shared. The badge will also indicate if the share is on the local network (for the desktop application without&nbsp;<a class=\"reference-link\" href=\"#root/_help_cbkrhQjrkKrh\">Synchronization</a>&nbsp;set up) or publicly accessible (for the server).</li><li><span class=\"tn-icon bx bx-globe\"></span>&nbsp;<strong>Web clip badge</strong>, which will indicate if the note was clipped using the&nbsp;<a class=\"reference-link\" href=\"#root/_help_MtPxeAWVAzMg\">Web Clipper</a>. The badge acts as a link, so it can be clicked on to navigate to the page or right clicked for more options. When the clipper also saved the page's description, its author, or the dates it was published and last updated, clicking the badge shows these details instead, with a link to the page at the top.</li><li><span class=\"tn-icon bx bx-play\"></span>&nbsp;<strong>Execute badge</strong>, for <a href=\"#root/_help_CdNpE2pqjmI6\">scripts</a> or <a href=\"#root/_help_YKWqdJhzi2VY\">saved SQL queries</a> which have an execute button or a description.</li><li>For&nbsp;<a class=\"reference-link\" href=\"#root/_help_YzMcWlCVeW09\">Active content</a>&nbsp;(e.g. scripts, styles), a dedicated badge will be shown indicating the type of note and with an option to easily enable or disable it.</li></ul>",
+ "_help_Bsm4fyzPJkSc": "<p><img class=\"image-style-align-right\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Notes/Save%20status%20indicator_image.png\" width=\"168\" height=\"47\">To the right of the note title, a temporary indicator appears after making a change to the document which shows whether the document has been saved.</p><p>It indicates the following states:</p><ul><li><span class=\"tn-icon bx bx-pencil\"></span>&nbsp;<em>Unsaved</em>, if the changes will be saved soon.</li><li><span class=\"tn-icon bx bx-loader\"></span>&nbsp;<em>Saving</em>, if the changes are being saved.</li><li><span class=\"tn-icon bx bx-check\"></span>&nbsp;<em>Saved</em>, if all the changes were successfully saved to the server.</li><li><span class=\"tn-icon bx bx-error\"></span>&nbsp;<em>Error</em>, if the changes could not be saved, for example due to a communication server with the server.</li></ul><p>After all changes have been saved, the indicator will hide automatically after a few seconds.</p>",
+ "_help_kBrnXNG3Hplm": "<p>This page explains the basic concepts related to the tree structure of notes in TriliumNext.</p><h2>Note</h2><p>A note is the central entity in TriliumNext. For more details, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_BFs8mudNFgCS\">Notes</a>.</p><h2>Branch</h2><p>A branch describes the placement of a note within the note tree. Essentially, it is a tuple of <code>parentNoteId</code> and <code>noteId</code>, indicating that the given note is placed as a child under the specified parent note.</p><p>Each note can have multiple branches, meaning any note can be placed in multiple locations within the tree. This concept is referred to as&nbsp;<a class=\"reference-link\" href=\"#root/_help_IakOLONlIfGI\">Cloning Notes</a>.</p><h2>Prefix</h2><p>A prefix is a branch-specific title modifier for a note. If you place your note in two different locations within the tree and want to alter the title slightly in one of those placements, you can use a prefix.</p><p>To edit a prefix, right-click on the note in the tree pane and select <em>Edit branch prefix</em>.</p><p>The prefix is not part of the note itself and is not encrypted when the note is protected. This can be useful if you want part of the title to remain visible in the tree for easier navigation, even when the note is protected.</p><h2>Subtree</h2><p>A subtree consists of a particular note (the subtree root) and all its children and descendants. Some operations, such as exporting, work on entire subtrees.</p>",
+ "_help_MMiBEQljMQh2": "<p>One of the Trilium's goals is to provide fast and comfortable navigation between notes.</p><h2>Backwards and forward</h2><p>You can use alt-left and alt-right to move back and forward in history of viewed pages.</p><p>This works identically to browser backwards / forwards, it's actually using built-in browser support for this.</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Navigation/Note%20Navigation_image.jpg\"></p><h2>Jump to note</h2><p>This is useful to quickly find and view arbitrary notes - click on <code>Jump to</code> button on the top or press <kbd>Ctrl</kbd> + <kbd>J</kbd> . Then type part of the note name and autocomplete will help you pick the desired note.</p><p>See&nbsp;<a class=\"reference-link\" href=\"#root/_help_F1r9QtzQLZqm\">Jump to Note</a>&nbsp;for more information.</p>",
+ "_help_Ms1nauBra7gq": "<figure class=\"image image-style-align-center\"><img style=\"aspect-ratio:659/256;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Navigation/Quick%20search_image.png\" width=\"659\" height=\"256\"></figure><p>The <em>Quick search</em> function does a full-text search (that is, it searches through the content of notes and not just the title of a note) and displays the result in an easy-to-access manner.</p><p>The alternative to the quick search is the&nbsp;<a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>&nbsp;function, which opens in a dedicated tab and has support for advanced queries.</p><p>For even faster navigation, it's possible to use&nbsp;<a class=\"reference-link\" href=\"#root/_help_F1r9QtzQLZqm\">Jump to &amp; command palette</a>&nbsp;which will only search through the note titles instead of the content.</p><h2>Layout</h2><p>Based on the&nbsp;<a class=\"reference-link\" href=\"#root/_help_x0JgW8UqGXvq\">Vertical and horizontal layout</a>, the quick search is placed:</p><ul><li>On the vertical layout, it is displayed right above the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.</li><li>On the horizontal layout, it is displayed in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>, where it can be positioned just like any other icon.</li></ul><h2>Search Features</h2><p>Quick search includes the following features:</p><h3>Content Previews</h3><p>Search results now display a 200-character preview of the note content below the note title. This preview shows the context where your search terms appear, making it easier to identify the right note without opening it.</p><h3>All results in one list</h3><p>Quick search lists up to 200 matching notes in a single scrollable list, so the scrollbar shows how many results there are and how far through them you are.</p><h3>Continuing in the full search</h3><p>To refine a query with the options of the full <a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>, click <em>Show in full search</em> below the results, or press <kbd>Ctrl</kbd>+<kbd>Enter</kbd> in the search field. The full search opens in a new tab with the same query. The button stays below the list, however far the results are scrolled.</p><h3>Visual Features</h3><ul><li><strong>Highlighting</strong>: Search terms appear in bold with accent colors</li><li><strong>Separation</strong>: Results are separated with dividers</li><li><strong>Theme Support</strong>: Highlighting colors adapt to light/dark themes</li></ul><h3>Search Behavior</h3><p>Quick search uses progressive search:</p><ol><li>Shows exact matches first</li><li>Includes fuzzy matches when exact results are fewer than 5</li><li>Exact matches appear before fuzzy matches</li></ol><h3>Search Scope</h3><p>Quick search covers only the subtree you are currently working in:</p><ul><li>Without hoisting, it covers the whole note tree.</li><li>Under a <a href=\"#root/_help_OR8WJ7Iz9K4U\">hoisted note</a> or inside a <a href=\"#root/_help_9sRHySam5fXb\">workspace</a>, it covers only that subtree.</li><li>Notes that exist only in the hidden tree, such as the built-in help pages and the launch bar configuration, are not returned. Hoist into the help to search it, or use <a href=\"#root/_help_F1r9QtzQLZqm\">Jump to…</a>, which searches titles across the hidden tree.</li></ul><p>To search the whole database while hoisted, use the full&nbsp;<a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>&nbsp;and leave <em>Ancestor</em> field empty.</p><h3>Keyboard Navigation</h3><ul><li>Press <kbd>Enter</kbd> in the search field to search, or to refresh the results already shown.</li><li>Press <kbd>Down</kbd> in the search field to move to the first result, then <kbd>Up</kbd> and <kbd>Down</kbd> to move between results. <kbd>Up</kbd> on the first result returns to the search field.</li><li>Press <kbd>Page Down</kbd> and <kbd>Page Up</kbd> to move through the results a page at a time.</li><li>Press <kbd>Enter</kbd> on a result to open it.</li><li>Press <kbd>Ctrl</kbd>+<kbd>Enter</kbd> to open the query in the full search.</li><li>Press <kbd>Escape</kbd> to close the results.</li></ul><p>To see these shortcuts on screen, click the <kbd>?</kbd> button below the results, or press <kbd>Alt</kbd>+<kbd>F1</kbd> while the search field is focused.</p><h2>Using Quick Search</h2><ol><li><strong>Typo tolerance</strong>: Search finds results despite minor typos</li><li><strong>Content previews</strong>: 200-character snippets show match context</li><li><strong>Specific terms</strong>: Specific search terms return more focused results</li><li><strong>Match locations</strong>: Bold text indicates where matches occur</li></ol><h2>Quick Search - Exact Match Operator</h2><p>Quick Search shares the same search engine as the full&nbsp;<a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>, so the exact match operator (<code>=</code>) behaves identically in both. Start your query with <code>=</code> (no space after it) to switch from the default \"contains\" behavior to exact whole-word or phrase matching.</p><p><strong>What</strong> <code>**=**</code> <strong>actually does:</strong> it finds notes where the title or content contains your term as a <strong>whole word or phrase</strong>, ignoring surrounding punctuation. It does <strong>not</strong> require the whole note to equal your term, and it does <strong>not</strong> do substring or fuzzy matching.</p><figure class=\"table\"><table><thead><tr><th>Query</th><th>Example note content</th><th>Matches?</th><th>Why</th></tr></thead><tbody><tr><td><code>sync</code></td><td><code>synchronize the database now</code></td><td>Yes</td><td>default search matches the substring</td></tr><tr><td><code>=sync</code></td><td><code>see (sync) mode</code></td><td>Yes</td><td><code>=</code> matches the whole word <code>sync</code>, punctuation ignored</td></tr><tr><td><code>=sync</code></td><td><code>synchronize the database now</code></td><td>No</td><td><code>=</code> never matches substrings</td></tr><tr><td><code>=\"project plan\"</code></td><td><code>the (project plan) is ready to share</code></td><td>Yes</td><td>quote a multi-word phrase to match it exactly</td></tr></tbody></table></figure><p>The search is case- and diacritic-insensitive. For the complete explanation of the three matching modes, fuzzy operators and relevance ranking, see <a href=\"#root/_help_eIg8jdvaoNNd\">How search matches your text</a> in the full Search documentation.</p><h3>Limitations</h3><ul><li>The <code>=</code> operator must be at the very beginning of the search query.</li><li>A space immediately after <code>=</code> is treated as a regular search.</li><li>Multiple <code>=</code> operators (like <code>==example</code>) are treated as regular text search.</li></ul><h3>Related Features</h3><ul><li>For attribute, property, boolean and ordering queries, use the full <a href=\"#root/_help_eIg8jdvaoNNd\">Search</a> functionality.</li><li>For fuzzy matching (finding results despite typos), use the <code>~=</code> or <code>~*</code> operators in the full search.</li><li>For partial matches with wildcards, use operators like <code>*=*</code>, <code>=*</code>, or <code>*=</code> in the full search.</li></ul>",
+ "_help_F1r9QtzQLZqm": "<figure class=\"image image-style-align-center\"><img style=\"aspect-ratio:991/403;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Navigation/1_Jump%20to%20%26%20command%20palette_image.png\" width=\"991\" height=\"403\"></figure><h2>Jump to Note</h2><p>The <em>Jump to Note</em> function allows easy navigation between notes by searching for their title. In addition to that, it can also trigger a full search or create notes.</p><p>To enter the “Jump to” dialog:</p><ul><li>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>, press&nbsp;<span class=\"tn-icon bx bx-send\"></span> button.</li><li>Using the keyboard, press <kbd>Ctrl</kbd> + <kbd>J</kbd>.</li></ul><p>In addition to searching for notes, it is also possible to search for commands. See the dedicated section below for more information.</p><h3>Interaction</h3><ul><li>By default, when there is no text entered it will display the most recent notes.</li><li>Using the keyboard, use the up or down arrow keys to navigate between items. Press <kbd>Enter</kbd> to open the desired note.</li><li>If the note doesn't exist, it's possible to create it by typing the desired note title and selecting one of two options:<ul><li><em>Create note</em> places it in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_S0Fos78ZfcY7\">Note Inbox</a>: the note labelled <code>#inbox</code>, today's&nbsp;<a class=\"reference-link\" href=\"#root/_help_l0tKav7yLHGF\">Day Notes</a>&nbsp;if there is none, or the top level if there is no journal either. While hoisted into a&nbsp;<a class=\"reference-link\" href=\"#root/_help_9sRHySam5fXb\">Workspaces</a>, the workspace's own inbox is used, then today's day note if the workspace has a <code>#workspaceCalendarRoot</code>, otherwise the workspace root itself. The option names the destination, so it is always visible before the note is created.</li><li><em>Create child note</em> places it under the note that is currently open.</li></ul></li><li>When the title search does not find a note, the bar below the results offers two ways to search further. It stays below the list, however far the results are scrolled. Both are hidden while the field is empty or lists commands.<ul><li>The <em>Include note contents</em> switch searches the content of the notes as well as their titles, and lists what it finds in place of the current results, without leaving the dialog. It stays on while the query changes, until it is switched off. Press <kbd>Shift</kbd>+<kbd>Enter</kbd> to switch it from the keyboard.</li><li><em>Show in full search</em> opens the query in the full <a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>, in a new tab, where its options can refine it. Press <kbd>Ctrl</kbd>+<kbd>Enter</kbd> to run it from the keyboard.</li></ul></li><li>To see the keys the results answer to, click the <kbd>?</kbd> button below the results, or press <kbd>Alt</kbd>+<kbd>F1</kbd> while the search field is focused.</li><li>On a wide enough desktop window, the note highlighted in the results is previewed on their right: its path, title, attributes and the start of its content. The preview follows the highlight as it moves through the results, and is left out for the command palette.</li><li>The options to create a note are listed after the notes. When no note matches, the list says so above them. <kbd>Enter</kbd> opens the note that matches best, or creates the note when none matches. Otherwise, press <kbd>↑</kbd> from the first note to reach the options to create a note.</li></ul><h2>Recent notes</h2><p>Jump to note also has the ability to show the list of recently viewed / edited notes and quickly jump to it.</p><p>To access this functionality, click on <code>Jump to</code> button on the top. By default, (when nothing is entered into autocomplete), this dialog will show the list of recent notes.</p><p>The recent notes are grouped by when they were last visited: <em>Today</em>, <em>Yesterday</em>, <em>Past 7 days</em>, <em>Past 30 days</em> and <em>Older</em>. The same list, with the same groups, opens in any note field that is focused while empty.</p><h2>Command Palette</h2><figure class=\"image image-style-align-center\"><img style=\"aspect-ratio:982/524;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Navigation/Jump%20to%20%26%20command%20palette_image.png\" width=\"982\" height=\"524\"></figure><p>The command palette is a feature which allows easy execution of various commands that can be found throughout the application, such as from menus or keyboard shortcuts. This feature integrates directly into the “Jump to” dialog.</p><h3>Interaction</h3><p>To trigger the command palette:</p><ul><li>Press <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>J</kbd> to display the command palette directly.</li><li>If in the “Jump to” dialog, type <code>&gt;</code> in the search to switch to the command palette.</li></ul><p>Interaction:</p><ul><li>Type a few words to filter between commands.</li><li>Use the up and down arrows on the keyboard or the mouse to select a command.</li><li>Press <kbd>Enter</kbd> to execute the command.</li></ul><p>To exit the command palette:</p><ul><li>Remove the <code>&gt;</code> in the search to go back to the note search.</li><li>Press <kbd>Esc</kbd> to dismiss the dialog entirely.</li></ul><h3>Options available</h3><p>Currently the following options are displayed:</p><ul><li>Most of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_A9Oc6YKKc65v\">Keyboard Shortcuts</a>&nbsp;have an entry, with the exception of those that are too specific to be run from a dialog.</li><li>Some additional options which are not yet available as keyboard shortcuts, but can be accessed from various menus such as: exporting a note, showing attachments, searching for notes or configuring the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>.</li></ul><h3>Limitations</h3><p>Currently it's not possible to define custom actions that are displayed in the command palette. In the future this might change by integrating the options in the launch bar, which can be customized if needed.</p>",
+ "_help_eIg8jdvaoNNd": "<figure class=\"image\"><img style=\"aspect-ratio:987/725;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Navigation/Search_image.png\" width=\"987\" height=\"725\"></figure><p>Note search enables you to find notes by searching for text in the title, content, or <a href=\"#root/_help_zEY4DaJG4YT5\">attributes</a> of the notes. You also have the option to save your searches, which will create a special search note which is visible on your navigation tree and contains the search results as sub-items.</p><h2>Types of search</h2><p>There are multiple types of searches, all using the same search mechanism and query language:</p><ul><li><a class=\"reference-link\" href=\"#root/_help_Ms1nauBra7gq\">Quick search</a>&nbsp;which can be found in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>&nbsp;for small one-off searches.<ul><li>The results are shown in a popup and it has an infinite scroll.</li></ul></li><li><em>Full search</em> is the more advanced search mechanism.<ul><li>The results are displayed in a separate page and it has multiple advanced features (search script, fast search, include archived notes, order by, limit).</li><li><a class=\"reference-link\" href=\"#root/_help_ivYnonVFBxbQ\">Bulk Actions</a>&nbsp;such as adding a label/relation can be applied to the results.</li><li>The results are paginated and they can be displayed in any&nbsp;<a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>&nbsp;view (e.g. grid, list, calendar, table).</li></ul></li><li>Some&nbsp;<a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>&nbsp;such as board view have a dedicated search bar which applies to that collection.<ul><li>In this case, the results are displayed directly in the collection instead of a popup and they are limited to the collection but the query language remains the same.</li></ul></li></ul><aside class=\"admonition note\"><p><a href=\"#root/_help_F1r9QtzQLZqm\">Jump to note</a> is a similar concept but it's mainly used to search for notes by title, not by content. Nevertheless, it also features a way to search in full text if the results are unsatisfactory.</p></aside><h2>Accessing the search</h2><ul><li>From the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>, look for the dedicated <span class=\"tn-icon bx bx-search\"></span> search button.</li><li>To limit the search to a note and its children, select <em>Search in subtree</em> (<span class=\"tn-icon bx bx-search\"></span>) from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_YtSN43OrfzaA\">Note tree contextual menu</a>&nbsp;or press <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>S</kbd>.</li><li>Go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_F1r9QtzQLZqm\">Jump to &amp; command palette</a>, look for something then press <em>Show in full search</em> below the results (or <kbd>Ctrl</kbd>+<kbd>Enter</kbd>).</li></ul><h2>Interaction</h2><p>To search for notes, click on the <span class=\"tn-icon bx bx-search\"></span> icon in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a> or press the keyboard <a href=\"#root/_help_A9Oc6YKKc65v\">shortcut</a>.</p><ol><li>Set the text to search for in the <em>Search string</em> field.<ol><li>Apart from searching for words literally, there is also the possibility to search for attributes or properties of notes.</li><li>See the examples below for more information.</li></ol></li><li>To limit the search to a note and its sub-children, set a note in <em>Ancestor</em>.<ol><li>This value is also pre-filled if the search is triggered from a <a href=\"#root/_help_OR8WJ7Iz9K4U\">hoisted note</a> or a <a href=\"#root/_help_9sRHySam5fXb\">workspace</a>.</li><li>To search the entire database, keep the value empty.</li></ol></li><li>To limit the search to only a few levels of hierarchy (e.g. look in sub-children but not in sub-sub-children of a note), set the <em>depth</em> field to one of the provided values.</li><li>In addition to that, the search can be configured via the <em>Add search option</em> buttons, as described in the follow-up section.</li><li>Press <em>Search</em> (<span class=\"tn-icon bx bx-search\"></span>) to trigger the search. The results are displayed below the search configuration pane.</li><li>The <em>Search &amp; Execute actions</em> (<span class=\"tn-icon bx bxs-zap\"></span>) button is only relevant if at least one action has been added (as described in the section below).</li><li>The <em>Save to note</em> (<span class=\"tn-icon bx bx-save\"></span>) button will create a new note with the search configuration. For more information, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a>.</li></ol><h2>Features</h2><h3>Autocomplete</h3><p>To help with the syntax, Trilium offers an autocomplete functionality which can be triggered by pressing <kbd>Ctrl</kbd>+<kbd>Space</kbd>.</p><p>Some suggestions also open on their own as you type: label and relation names after <code>#</code> and <code>~</code>, fields after <code>.</code>, operators, values, and notes after <code>@</code>. Keywords such as <code>and</code>, <code>or</code>, <code>not</code>, <code>orderBy</code> and <code>limit</code> appear only on <kbd>Ctrl</kbd>+<kbd>Space</kbd>, since a plain word is usually a search term.</p><p>No suggestion is selected when a list opens on its own, so <kbd>Enter</kbd> runs the search as typed. To insert a suggestion, select it with <kbd>Down</kbd> and press <kbd>Enter</kbd>. The list opened with <kbd>Ctrl</kbd>+<kbd>Space</kbd> and the notes after <code>@</code> open on the best match instead, so <kbd>Enter</kbd> inserts it.</p><p>The autocomplete offers:</p><ul><li>Basic operators such as <code>*=</code> and keywords (<code>limit</code>, <code>not</code>).</li><li>Fields for object-like fields such as <code>note</code> or <code>~relation</code>, triggered by typing <code>.</code>.</li><li>Contextual enumerations such as <code>note.type = \"</code> or <code>note.mime = \"</code>.</li><li><a href=\"#root/_help_HI6GBBIduIgv\">Label</a> names by typing <code>#</code>.<ul><li>A small gear on the name's icon indicates a system attribute.</li><li>After typing the label name, the value is also autocompleted with values that are present in the database.</li></ul></li><li><a href=\"#root/_help_Cq5X6iKQop6R\">Relation</a> names by typing <code>~</code>.</li><li><a href=\"#root/_help_m1lbrzyKDaRB\">Note ID</a>s can be inserted easily by typing <code>@</code> and looking for a note.<ul><li>If the note ID is under a valid syntax, it will be shown as a chip of the note instead of the raw ID.</li><li>This is especially useful for queries that make use of the note ID such as searching by template: <code>~template.noteId = @</code></li></ul></li></ul><h3>Syntax highlighting</h3><p>The search input features syntax highlighting, making recognized fields such as <code>note.</code> and operators like <code>NOT</code> stand out.</p><h3>Error highlighting &amp; linting</h3><p>The search is also checked for errors in two phases, which will be displayed as a red squiggle:</p><ul><li>Linter errors which identify common error patterns and also provide a way to fix them.</li><li>Search errors which are checked by the server, without indicating the exact place the error occurred.</li></ul><p>An error the search only runs into while running, such as an operator that note content cannot be searched with, is shown in a <em>Search error</em> card instead: below the search string, or at the top of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_Ms1nauBra7gq\">Quick search</a>&nbsp;results.</p><h3>Multiline</h3><p>Long or complicated searches can be formatted by using newlines, similar to SQL queries. Newlines are treated just like spaces.</p><p>To add a new line, press <kbd>Shift</kbd>+<kbd>Enter</kbd>.</p><aside class=\"admonition note\"><p>Multiline is available only for the full search, other inputs such as the quick search or the collection filter are single line.</p></aside><h2>Search options</h2><p>Click on which search option to apply from the <em>Add search option</em> section.</p><ul><li>For each search option selected, the search configuration will update to reveal the entry. Each search option will have its own configuration.</li><li>To remove a search option, simply press the <span class=\"tn-icon bx bx-x\"></span> button to the right of it.</li></ul><p>The options available are:</p><ol><li><span class=\"tn-icon bx bx-code\"></span> Search script<ol><li>This feature allows writing a&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;note that will handle the search on its own.</li></ol></li><li><span class=\"tn-icon bx bx-run\"></span> Fast search<ol><li>The search will not look into the content of the notes, but it will still look into note titles and attributes, relations (based on the search query).</li><li>This method can speed up the search considerably for large <a href=\"#root/_help_wX4HbRucYSDD\">databases</a>.</li></ol></li><li><span class=\"tn-icon bx bx-archive\"></span> Include archived<ol><li><a class=\"reference-link\" href=\"#root/_help_MKmLg5x6xkor\">Archived Notes</a>&nbsp;will also be included in the results, whereas otherwise they would be ignored.</li></ol></li><li><span class=\"tn-icon bx bx-arrow-from-top\"></span> Order by<ol><li>Allows changing the criteria for ordering the results, for example to order by creation date or alphabetically instead of by relevancy (default).</li><li>It's also possible to change the order (ascending or descending) of the results.</li></ol></li><li><span class=\"tn-icon bx bx-stop\"></span> Limit<ol><li>Limits the results to a given maximum.</li><li>This can help if the number of results would otherwise be high, at the cost of not being able to view all the results.</li></ol></li><li><span class=\"tn-icon bx bx-bug\"></span> Debug<ol><li>This will print additional information in the server log (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_qzNzp9LYQyPT\">Error logs</a>), regarding how the search expression was parsed.</li><li>This function is especially useful after understanding the search functionality in detail, in order to determine why a complex search query is not working as expected.</li></ol></li><li><span class=\"tn-icon bx bxs-zap\"></span> Action<ol><li>Apart from just searching, it is also possible to apply actions such as to add a label or a relation to the notes that have been matched by the search.</li><li>Unlike other search configurations, here it's possible to apply the same action multiple times (i.e. in order to be able to apply multiple labels to notes).</li><li>The actions given are the same as the ones in&nbsp;<a class=\"reference-link\" href=\"#root/_help_ivYnonVFBxbQ\">Bulk Actions</a>, which is an alternative for operating directly with notes within the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.</li><li>After defining the actions, first press <em>Search</em> to check the matched notes and then press <em>Search &amp; Execute actions</em> to trigger the actions.</li></ol></li></ol><h2>Viewing search results</h2><p>Results appear below the search pane as a list of <strong>snippet cards</strong>. Each card shows the note title and a short excerpt of the text that matched.</p><p>The search will also highlight the words from the title or content that matched:</p><ul><li>With a solid underlined green for a direct match;</li><li>With a dotted underline orange for a partial match (matched by the fuzzy search).</li></ul><p>In addition:&nbsp;</p><ul><li>The <strong>total number of results</strong> is always shown, so you can immediately tell how broad a query is.</li><li>A <strong>page-size selector</strong> lets you choose how many results to display per page. Your choice is remembered and synced across your devices (stored in the <code>searchResultsPageSize</code> option), so you do not have to reset it on every device.</li><li><strong>Clicking a result</strong> opens the note and jumps straight to the first match. The in-note find bar opens pre-filled with the first word of your search, so you can step through its matches with the find controls. To have the find bar look for a whole phrase instead, put the phrase in quotes in the search, e.g. <code>\"The Lord of the Rings\"</code>. In read-only notes, the other words of the search are highlighted as well.</li><li><em>Open all results in new tabs</em> (<span class=\"tn-icon bx bx-window-open\"></span>, the button above the results) opens every result in a tab of its own, up to 50. Each tab opens on its first match with the find bar pre-filled, as when clicking a result.</li><li>If a match is inside a <strong>collapsed section</strong> (for example a folded heading), that section is expanded automatically so the match is visible.</li></ul><h2>Simple Note Search Examples</h2><ul><li><code>rings tolkien</code>: Full-text search to find notes containing both \"rings\" and \"tolkien\".</li><li><code>\"The Lord of the Rings\" Tolkien</code>: Full-text search where \"The Lord of the Rings\" must match exactly.</li><li><code>note.content *=* rings OR note.content *=* tolkien</code>: Find notes containing \"rings\" or \"tolkien\" in their content.</li><li><code>towers #book</code>: Combine full-text and attribute search to find notes containing \"towers\" and having the \"book\" label. Writing <code>towers AND #book</code> does the same; to search for the word \"and\" itself, put it in quotes.</li><li><code>c#</code> or <code>towers#book</code>: A <code>#</code> or <code>~</code> inside a word is part of the text, so these find notes containing \"c#\" or \"towers#book\". To start a label or relation, put a space before it.</li><li><code>towers #book or #author</code>: Search for notes containing \"towers\" and having either the \"book\" or \"author\" label.</li><li><code>towers #!book</code>: Search for notes containing \"towers\" and not having the \"book\" label.</li><li><code>#book #publicationYear = 1954</code>: Find notes with the \"book\" label and \"publicationYear\" set to 1954.</li><li><code>#genre *=* fan</code>: Find notes with the \"genre\" label containing the substring \"fan\". Additional operators include <code>*=*</code> for \"contains\", <code>=*</code> for \"starts with\", <code>*=</code> for \"ends with\", and <code>!=</code> for \"is not equal to\".</li><li><code>#book #publicationYear &gt;= 1950 #publicationYear &lt; 1960</code>: Use numeric operators to find all books published in the 1950s.</li><li><code>#dateNote &gt;= TODAY-30</code>: Find notes with the \"dateNote\" label within the last 30 days. Supported date values include NOW +- seconds, TODAY +- days, MONTH +- months, YEAR +- years.</li><li><code>~author.title *=* Tolkien</code>: Find notes related to an author whose title contains \"Tolkien\".</li><li><code>#publicationYear %= '19[0-9]{2}'</code>: Use the '%=' operator to match a regular expression (regex). This feature has been available since Trilium 0.52.</li><li><code>note.content %= '\\\\d{2}:\\\\d{2} (PM|AM)'</code>: Find notes that mention a time. Backslashes in a regex must be escaped.</li></ul><h2>Advanced Use Cases</h2><ul><li><code>~author.relations.son.title = 'Christopher Tolkien'</code>: Search for notes with an \"author\" relation to a note that has a \"son\" relation to \"Christopher Tolkien\". This can be modeled with the following note structure:<ul><li>Books<ul><li>Lord of the Rings<ul><li>label: “book”</li><li>relation: “author” points to “J. R. R. Tolkien” note</li></ul></li></ul></li><li>People<ul><li>J. R. R. Tolkien<ul><li>relation: “son” points to \"Christopher Tolkien\" note</li><li>Christopher Tolkien</li></ul></li></ul></li></ul></li><li><code>~author.title *= Tolkien OR (#publicationDate &gt;= 1954 AND #publicationDate &lt;= 1960)</code>: Use boolean expressions and parentheses to group expressions.</li><li><code>towers (#genre = fantasy OR #genre = scifi)</code>: A group can open the expression part directly, without a <code>#</code> or <code>~</code> before the parenthesis. Here it finds notes containing \"towers\" whose genre is fantasy or scifi.</li><li><code>note.parents.title = 'Books'</code>: Find notes with a parent named \"Books\".</li><li><code>note.parents.parents.title = 'Books'</code>: Find notes with a grandparent named \"Books\".</li><li><code>note.ancestors.title = 'Books'</code>: Find notes with an ancestor named \"Books\".</li><li><code>note.children.title = 'sub-note'</code>: Find notes with a child named \"sub-note\".</li><li><code>note.links.title = 'Tolkien'</code>: Find notes linking to a note named \"Tolkien\".</li><li><code>note.backlinks.title = 'Reading list'</code>: Find the notes that \"Reading list\" links to.</li><li>A link is a relation you created, such as <code>~author</code>, or one that content creates: an internal link (<code>~internalLink</code>), an image (<code>~imageLink</code>), an included note (<code>~includeNoteLink</code>) or a relation map connection (<code>~relationMapLink</code>). Relations that configure a note, such as <code>~template</code> or a saved search's <code>~ancestor</code>, are not links.</li></ul><p>See also&nbsp;<a class=\"reference-link\" href=\"#root/_help_Oxyb6jOjjVNL\">Under the hood</a>&nbsp;for more syntax references.</p><h3>Search with Note Properties</h3><p>Notes have properties that can be used in searches, such as <code>noteId</code>, <code>dateModified</code>, <code>dateCreated</code>, <code>isProtected</code>, <code>type</code>, <code>title</code>, <code>text</code>, <code>content</code>, <code>rawContent</code>, <code>ownedLabelCount</code>, <code>labelCount</code>, <code>ownedRelationCount</code>, <code>relationCount</code>, <code>ownedRelationCountIncludingLinks</code>, <code>relationCountIncludingLinks</code>, <code>ownedAttributeCount</code>, <code>attributeCount</code>, <code>targetRelationCount</code>, <code>targetRelationCountIncludingLinks</code>, <code>parentCount</code>, <code>childrenCount</code>, <code>isArchived</code>, <code>contentSize</code>, <code>noteSize</code>, and <code>revisionCount</code>.</p><p>These properties can be accessed via the <code>note.</code> prefix, e.g., <code>note.type = code AND note.mime = 'application/json'</code>.</p><h3>Order by and Limit</h3><pre><code class=\"language-text-x-trilium-auto\">#author=Tolkien orderBy #publicationDate desc, note.title limit 10</code></pre><p>This example will:</p><ol><li>Find notes with the author label \"Tolkien\".</li><li>Order the results by <code>publicationDate</code> in descending order.</li><li>Use <code>note.title</code> as a secondary ordering if publication dates are equal.</li><li>Limit the results to the first 10 notes.</li></ol><h3>Negation</h3><p>Some queries can only be expressed with negation:</p><pre><code class=\"language-text-x-trilium-auto\">#book AND not(note.ancestors.title = 'Tolkien')</code></pre><p>This query finds all book notes not in the \"Tolkien\" subtree.</p><h2>Under the Hood</h2><p>See the <a href=\"#root/_help_Oxyb6jOjjVNL\">dedicated page</a> to understand how progressive search works in Trilium, as well as some advanced use cases.</p><h2>Auto-Trigger Search from URL</h2><p>You can open Trilium and automatically trigger a search by including the search <a href=\"https://meyerweb.com/eric/tools/dencoder/\">url encoded</a> string in the URL:</p><p><code>http://localhost:8080/#?searchString=abc</code></p><h2>Search Configuration</h2><h3>Parameters</h3><figure class=\"table\"><table><thead><tr><th>Parameter</th><th>Value</th><th>Description</th></tr></thead><tbody><tr><td><code>MIN_FUZZY_TOKEN_LENGTH</code></td><td>3</td><td>Minimum characters the <code>~=</code> and <code>~*</code> operators accept</td></tr><tr><td><code>MAX_EDIT_DISTANCE</code></td><td>2</td><td>Ceiling on character changes, reached only by 7+ character terms; shorter terms allow fewer. See the <em>Fuzzy tolerance</em> section above</td></tr><tr><td><code>RESULT_SUFFICIENCY_THRESHOLD</code></td><td>5</td><td>Minimum exact results before fuzzy fallback</td></tr><tr><td><code>MAX_CONTENT_SIZE</code></td><td>10MB</td><td>Maximum note content size for search processing</td></tr></tbody></table></figure><h3>Limits</h3><ul><li>Searched note content is limited to 10MB per note to prevent performance issues</li><li>Notes exceeding this limit will still be included in title and attribute searches</li><li>Terms of 3 characters or fewer are matched exactly; typo tolerance starts at 4 characters</li></ul>",
+ "_help_Oxyb6jOjjVNL": "<h2>Progressive Search Strategy</h2><p>Trilium uses a progressive search strategy that performs exact matching first, then adds fuzzy matching when needed.</p><p>The search has three phases:</p><ol><li><strong>Phase 1 - Exact Matching</strong>: When you search, Trilium first looks for exact matches of your search terms. This handles the vast majority of searches (90%+) and returns results almost instantly.</li><li><strong>Phase 2 - Fuzzy Fallback</strong>: If Phase 1 doesn't find enough high-quality results (fewer than 5 results with good relevance scores), Trilium automatically adds fuzzy matching to find results with typos or spelling variations.</li><li><strong>Result Ordering</strong>: Exact matches always appear before fuzzy matches, regardless of individual scores. This ensures that when you search for \"project\", notes containing the exact word \"project\" will appear before notes containing similar words like \"projects\" or \"projection\".</li></ol><h3>Progressive Search Behavior</h3><ul><li><strong>Speed</strong>: Most searches complete using only exact matching</li><li><strong>Ordering</strong>: Exact matches appear before fuzzy matches</li><li><strong>Fallback</strong>: Fuzzy matching activates when exact matches return fewer than 5 results</li><li><strong>Identification</strong>: Results indicate whether they are exact or fuzzy matches</li></ul><h2>Search Performance</h2><p>Search system specifications:</p><ul><li>Content size limit: 10MB per note (previously 50KB)</li><li>Edit distance calculations for fuzzy matching</li><li>Infinite scrolling in Quick Search</li></ul><h2>Label and Relation Shortcuts</h2><p>The \"full\" syntax for searching by labels is:</p><pre><code class=\"language-text-x-trilium-auto\">note.labels.publicationYear = 1954</code></pre><p>For relations:</p><pre><code class=\"language-text-x-trilium-auto\">note.relations.author.title *=* Tolkien</code></pre><p>However, common label and relation searches have shortcut syntax:</p><pre><code class=\"language-text-x-trilium-auto\">#publicationYear = 1954\n~author.title *=* Tolkien</code></pre><h2>Separating Full-Text and Attribute Parts</h2><p>Search syntax allows combining full-text search with attribute-based search. For example, <code>tolkien #book</code> contains:</p><ol><li>Full-text tokens - <code>tolkien</code></li><li>Attribute expressions - <code>#book</code></li></ol><p>Trilium detects the separation between full text search and attribute/property search by looking for certain special characters or words that denote attributes and properties (e.g., #, ~, note.). If you need to include these in full-text search, escape them with a backslash so they are processed as regular text:</p><pre><code class=\"language-text-x-trilium-auto\">\"note.txt\" \n\\#hash \n#myLabel = 'Say \"Hello World\"'</code></pre><h2>Escaping Special Characters</h2><p>Special characters can be enclosed in quotes or escaped with a backslash to be used in full-text search:</p><pre><code class=\"language-text-x-trilium-auto\">\"note.txt\"\n\\#hash\n#myLabel = 'Say \"Hello World\"'</code></pre><p>Three types of quotes are supported: single, double, and backtick.</p><h2>Type Coercion</h2><p>Label values are technically strings but can be coerced for numeric comparisons:</p><pre><code class=\"language-text-x-trilium-auto\">note.dateCreated =* '2019-05'</code></pre><p>This finds notes created in May 2019. Numeric operators like <code>#publicationYear &gt;= 1960</code> convert string values to numbers for comparison.</p>",
+ "_help_WbjlujkUhEb5": "<p>The single most common source of confusion is that the <code>=</code> sign means two <em>different</em> things depending on where it appears. Read this section once and the rest of search becomes predictable.</p><p>There are three matching modes:</p><figure class=\"table\"><table><thead><tr><th>Mode</th><th>How you trigger it</th><th>What it matches</th><th>Substring?</th><th>Fuzzy (typos)?</th></tr></thead><tbody><tr><td><strong>Default</strong></td><td>type words with no prefix</td><td>whole words <em>and</em> substrings, anywhere in title, content or attributes, relevance-ranked</td><td>Yes</td><td>Yes</td></tr><tr><td><strong>Exact full-text</strong></td><td>a leading <code>=</code> (e.g. <code>=sync</code>)</td><td>the exact whole word or phrase, ignoring surrounding punctuation</td><td>No</td><td>No</td></tr><tr><td><strong>Attribute / property equality</strong></td><td><code>=</code> inside a <code>#label=value</code> or <code>note.property=value</code> clause</td><td>the <em>entire</em> attribute or property value, exactly</td><td>No</td><td>No</td></tr></tbody></table></figure><h3>Default matching (no prefix)</h3><p><strong>Rule:</strong> typing words with no prefix finds notes that contain those words anywhere in the title, content or attributes, as whole words or as substrings. The closest matches are ranked first.</p><figure class=\"table\"><table><thead><tr><th>Query</th><th>Example note content</th><th>Matches?</th><th>Why</th></tr></thead><tbody><tr><td><code>sync</code></td><td><code>please sync the folders</code></td><td>Yes (ranked higher)</td><td>contains the exact word <code>sync</code></td></tr><tr><td><code>sync</code></td><td><code>synchronize the database now</code></td><td>Yes (ranked lower)</td><td><code>sync</code> is a substring of <code>synchronize</code></td></tr></tbody></table></figure><h3>Exact match with the <code>=</code> prefix</h3><p><strong>Rule:</strong> a leading <code>=</code> switches the full-text search to exact matching. It finds the whole word or phrase only, ignoring surrounding punctuation, with <strong>no</strong> substring and <strong>no</strong> fuzzy matching. Use it when a normal search returns too many near-matches.</p><figure class=\"table\"><table><thead><tr><th>Query</th><th>Example note content</th><th>Matches?</th><th>Why</th></tr></thead><tbody><tr><td><code>=sync</code></td><td><code>see (sync) mode</code></td><td>Yes</td><td><code>(sync)</code> is the whole word <code>sync</code>; punctuation is ignored</td></tr><tr><td><code>=sync</code></td><td><code>in sync, then continue</code></td><td>Yes</td><td><code>sync,</code> is the whole word <code>sync</code></td></tr><tr><td><code>=sync</code></td><td><code>he said \"sync\" out loud</code></td><td>Yes</td><td><code>\"sync\"</code> is the whole word <code>sync</code></td></tr><tr><td><code>=sync</code></td><td><code>synchronize the database now</code></td><td>No</td><td><code>=</code> never matches substrings</td></tr><tr><td><code>=sync</code></td><td><code>please send the file</code></td><td>No</td><td><code>=</code> never matches typos / fuzzy</td></tr></tbody></table></figure><p>To match an exact <strong>phrase</strong>, quote it after the <code>=</code> (single, double or backtick quotes all work). The phrase must appear as consecutive words, but punctuation between or around them is ignored:</p><figure class=\"table\"><table><thead><tr><th>Query</th><th>Example note (title or content)</th><th>Matches?</th><th>Why</th></tr></thead><tbody><tr><td><code>=\"project plan\"</code></td><td>title <code>Project Plan</code></td><td>Yes</td><td>the title is exactly the phrase</td></tr><tr><td><code>=\"project plan\"</code></td><td><code>the (project plan) is ready to share</code></td><td>Yes</td><td>the consecutive phrase appears; punctuation is ignored</td></tr><tr><td><code>=\"project plan\"</code></td><td><code>the plan for this project is late</code></td><td>No</td><td>the words are present but not consecutive</td></tr></tbody></table></figure><h3>Attribute and property equality (<code>=</code>, <code>!=</code>)</h3><p><strong>Rule:</strong> when <code>=</code> compares an attribute or property, as in <code>#label=value</code> or <code>note.title=value</code>, it is <strong>strict full-value equality</strong>: the <em>whole</em> value must equal what you typed, ignoring case and diacritics. This is <strong>not</strong> word matching. <code>!=</code> inverts it.</p><p>The examples below assume four notes: <em>Austria</em> (<code>#capital=Vienna</code>), <em>Somewhere</em> (<code>#capital=Vienna Austria</code>), <em>Czech Republic</em> (<code>#capital=Prague</code>) and <em>Switzerland</em> (<code>#capital=Zürich</code>).</p><figure class=\"table\"><table><thead><tr><th>Query</th><th>Example label value</th><th>Matches?</th><th>Why</th></tr></thead><tbody><tr><td><code>#capital=Vienna</code></td><td><code>Vienna</code></td><td>Yes</td><td>the whole value equals <code>Vienna</code></td></tr><tr><td><code>#capital=Vienna</code></td><td><code>Vienna Austria</code></td><td>No</td><td>the whole value is <code>Vienna Austria</code>, not <code>Vienna</code></td></tr><tr><td><code>#capital=\"Vienna Austria\"</code></td><td><code>Vienna Austria</code></td><td>Yes</td><td>quote a multi-word value to match it in full</td></tr><tr><td><code>#capital=Zurich</code></td><td><code>Zürich</code></td><td>Yes</td><td>equality ignores diacritics</td></tr><tr><td><code>#capital!=Vienna</code></td><td><code>Prague</code></td><td>Yes</td><td><code>!=</code> matches every value that is not <code>Vienna</code></td></tr><tr><td><code>#capital!=Vienna</code></td><td><code>Vienna</code></td><td>No</td><td><code>!=</code> excludes the exact value</td></tr></tbody></table></figure><blockquote><p><strong>Quick search relaxes this.</strong> The <a href=\"#root/_help_Ms1nauBra7gq\">Quick search</a> bar and autocomplete treat an attribute <code>=</code> as \"contains\", so <code>#capital=Vienna</code> typed there also matches <code>Vienna Austria</code>. The strict full-value equality described here applies only in the full Search.</p></blockquote><h3>Fuzzy operators (<code>~=</code> and <code>~*</code>)</h3><p><strong>Rule:</strong> the fuzzy operators tolerate typos. <code>~=</code> (fuzzy-equals) matches a value that is a close whole-word variant of your term. <code>~*</code> (fuzzy-contains) matches when your term appears anywhere inside the value, either as a fragment or as a near-miss. Both work on note properties such as <code>note.title</code> and <code>note.content</code>, and on labels (<code>#label</code>). Fuzzy operators accept terms of at least 3 characters, though how many typos each term tolerates depends on its length — see <em>Fuzzy tolerance</em> below.</p><p>The examples assume a note titled <code>Books</code> carrying the label <code>#author=Tolkien</code>, and a note whose content is <code>learn programming today</code>.</p><figure class=\"table\"><table><thead><tr><th>Query</th><th>Example value</th><th>Matches?</th><th>Why</th></tr></thead><tbody><tr><td><code>note.title ~= boks</code></td><td>title <code>Books</code></td><td>Yes</td><td>one edit away from <code>books</code></td></tr><tr><td><code>#author ~= tolkein</code></td><td>author <code>Tolkien</code></td><td>Yes</td><td><code>tolkein</code> is a typo of <code>tolkien</code></td></tr><tr><td><code>note.content ~* progr</code></td><td><code>learn programming today</code></td><td>Yes</td><td><code>progr</code> is a fragment of <code>programming</code></td></tr><tr><td><code>note.content ~* programing</code></td><td><code>learn programming today</code></td><td>Yes</td><td><code>programing</code> is one edit from <code>programming</code></td></tr></tbody></table></figure><h3>Fuzzy tolerance</h3><p><strong>Rule:</strong> how many typos are tolerated depends on the <strong>length</strong> of your search term. Short terms must match exactly, because a single edit is enough to turn one short word into an unrelated one; longer terms have greater tolerance.</p><figure class=\"table\"><table><thead><tr><th>Term length</th><th>Edits allowed</th></tr></thead><tbody><tr><td>1–3 characters</td><td>0 (exact only)</td></tr><tr><td>4–6 characters</td><td>1</td></tr><tr><td>7+ characters</td><td>2</td></tr></tbody></table></figure><figure class=\"table\"><table><thead><tr><th>Query</th><th>Term length</th><th>Example note content</th><th>Matches?</th><th>Why</th></tr></thead><tbody><tr><td><code>cat</code></td><td>3</td><td><code>a bright red car</code></td><td>No</td><td>No edits are allowed below 4 characters, so <code>cat</code> does not reach <code>car</code></td></tr><tr><td><code>carr</code></td><td>4</td><td><code>a blue debit card</code></td><td>Yes</td><td>1 edit is within budget for 4–6 character terms</td></tr><tr><td><code>ceck</code></td><td>4</td><td><code>the latest tech trends</code></td><td>No</td><td><code>ceck</code>→<code>tech</code> needs 2 edits; only 1 is allowed at this length</td></tr><tr><td><code>combinef</code></td><td>8</td><td><code>the values were combined together</code></td><td>Yes</td><td><code>combinef</code>→<code>combined</code> is 1 edit; up to 2 are allowed at 7+ characters</td></tr></tbody></table></figure><h3>Relevance ranking</h3><p><strong>Rule:</strong> results are ordered by <em>how well</em> they match, not merely whether they match. Exact whole-word and phrase matches rank above substring and fuzzy matches, and a note where your words appear as a consecutive phrase outranks one where they are scattered.</p><figure class=\"table\"><table><thead><tr><th>Query</th><th>Ranked higher</th><th>Ranked lower</th><th>Why</th></tr></thead><tbody><tr><td><code>sync</code></td><td><code>please sync the folders</code></td><td><code>synchronize the database now</code></td><td>exact word beats substring</td></tr><tr><td><code>you and me</code></td><td><code>I like you and me as a phrase</code></td><td><code>the menu is here and you know it</code></td><td>consecutive phrase beats scattered words</td></tr></tbody></table></figure><h3>What is searchable</h3><p>A search looks at more than the visible body text. All of the following are indexed and searchable:</p><ul><li>note titles,</li><li>note body content,</li><li>labels and relations (<a href=\"#root/_help_zEY4DaJG4YT5\">attributes</a>),</li><li>link URLs and the titles/descriptions of link previews,</li><li>the titles of notes that a note reference-links to.</li></ul><p>The last point is the least obvious: if a note's only content is a reference link to another note, searching for that other note's <strong>title</strong> still finds the linking note.</p><figure class=\"table\"><table><thead><tr><th>Query</th><th>Setup</th><th>Matches?</th><th>Why</th></tr></thead><tbody><tr><td><code>special topic</code></td><td>a note whose only content is a reference link to a note titled <code>Special Topic</code></td><td>Yes, and the linked target ranks first</td><td>the target's title is indexed into the linking note's searchable text</td></tr><tr><td><code>special</code></td><td>the same note (only a reference link to <code>Special Topic</code>)</td><td>Yes, one word from the target's title is enough</td><td>the indexed title is normalized just like body text, so even one lowercased word matches</td></tr><tr><td><code>zurich</code></td><td>a note whose only content is a reference link to a note titled <code>Zürich</code></td><td>Yes</td><td>the indexed title has its accents normalized, so the plain form matches the accented title</td></tr></tbody></table></figure><h3>Diacritics</h3><p><strong>Rule:</strong> accents are normalized on both sides, so an accented word and its plain form match each other.</p><figure class=\"table\"><table><thead><tr><th>Query</th><th>Example note content</th><th>Matches?</th></tr></thead><tbody><tr><td><code>ktory</code></td><td><code>slovo ktorý znamena nieco</code></td><td>Yes</td></tr><tr><td><code>ktorý</code></td><td><code>the word ktory appears here</code></td><td>Yes</td></tr></tbody></table></figure><h3>Regular expressions (<code>%=</code>)</h3><p><strong>Rule:</strong> the <code>%=</code> operator matches a property or label value against a regular expression.</p><figure class=\"table\"><table><thead><tr><th>Query</th><th>Example note content</th><th>Matches?</th></tr></thead><tbody><tr><td><code>note.content %= 'colou?r'</code></td><td><code>my favorite color of all</code></td><td>Yes</td></tr><tr><td><code>note.content %= 'colou?r'</code></td><td><code>my favourite colour of all</code></td><td>Yes</td></tr></tbody></table></figure>",
+ "_help_u3YFHC9tQlpm": "<p>Frequently used notes can be bookmarked, which will make them appear in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>&nbsp;for easy access.</p><h2>Configuring the launch bar</h2><p>If bookmarks don't appear in the launch bar, then most likely the bookmark section has been hidden. Go to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>&nbsp;configuration from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a>&nbsp;and ensure <em>Bookmarks</em> is in the <em>Visible Launchers</em> section.</p><h2>Bookmark folder</h2><p>Space in the left panel is limited, and you might want to bookmark many items. One possible solution is to bookmark a folder, so it shows its children:</p><p>To do this, bookmark a folder and assign it the <code>#bookmarkFolder</code> label.</p><h2>Mobile</h2><p>On mobile, bookmarks are only displayed starting with v0.102.0. Because of the more constrained screen size, the bookmarks are grouped under a single icon instead of displaying them as separate icons.</p><p>When pressed, a menu will appear listing all the bookmarks. Bookmark folders are also supported and will appear as sub-menus.</p>",
+ "_help_OR8WJ7Iz9K4U": "<p>Hoisting is a standard outliner feature which allows you to focus on (or \"zoom into\") a specific note and its subtree by hiding all parent and sibling notes. Demo:</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Navigation/Note%20Hoisting_note-hoisting.gif\"></p><p>In addition to showing only this subtree, this also narrows both full text search and <a href=\"#root/_help_MMiBEQljMQh2\">“jump to note”</a> to just notes present in hoisted subtree.</p><p>See also <a href=\"#root/_help_9sRHySam5fXb\">Workspace</a> which extends this feature.</p>",
+ "_help_ZjLYv08Rp3qC": "<figure class=\"image image-style-align-right image_resized\" style=\"width:53.13%;\"><img style=\"aspect-ratio:895/694;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Navigation/Quick%20edit_image.png\" width=\"895\" height=\"694\"></figure><p><em>Quick edit</em> provides an alternative to the standard tab-based navigation and editing.</p><p>Instead of clicking on a note which switches the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;to the newly selected note, or navigating between two different&nbsp;<a class=\"reference-link\" href=\"#root/_help_3seOhtN8uLIY\">Tabs</a>, the <em>Quick edit</em> feature opens as a popup window that can be easily dismissed.</p><p>This feature is also well integrated with&nbsp;<a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>&nbsp;such as the calendar view, which makes it easy to edit entries without having to go back and forth between the child note and the calendar.</p><h2>Feature highlights</h2><ul><li>All note types are supported, including&nbsp;<a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>.</li><li>Note that the&nbsp;<a class=\"reference-link\" href=\"#root/_help_0ESUbbAxVnoK\">Note List</a>&nbsp;will not be displayed, except for notes of type&nbsp;<a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>.</li><li>For&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes, depending on user preference, both the floating and classic editors are supported. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>.</li><li>The title and the note and the icon are editable, just like a normal tab.</li><li>The note's actions and its menu are shown in the header of the popup, as in the title row of a tab.<ul><li>When other notes link to the note, a button with a link icon lists the <a class=\"reference-link\" href=\"#root/_help_wfGXLmm7x27z\">Backlinks</a>. Pressing one opens that note in the popup.</li><li>The menu items that only work in a tab are not shown: <em>Search in note</em>, <em>Note map</em>, <em>Full width</em> and <em>Convert into attachment</em>.</li><li>A help page opened from the popup, such as through the help button of the note type, opens in a second popup on top of it. Closing that popup returns to the note being edited.</li></ul></li><li>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>&nbsp;are also displayed.<ul><li>This integrates well with&nbsp;<a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>&nbsp;where there are predefined attributes such as the <em>Start date</em> and <em>End date</em>, allowing for easy editing.</li></ul></li></ul><h2>Accessing the quick edit</h2><ul><li>From the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>:<ul><li>Right click on a note and select <em>Quick edit</em>.</li><li>or, press <kbd>Ctrl</kbd>+<kbd>Right click</kbd> on a note.</li></ul></li><li>On&nbsp;<a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>: <ul><li>Right click and select <em>Quick edit</em>.</li><li>or, press <kbd>Ctrl</kbd>+<kbd>Right click</kbd> on the link.</li></ul></li><li>On a&nbsp;<a class=\"reference-link\" href=\"#root/_help_lgKX7r3aL30x\">Note Tooltip</a>, press the quick edit icon.</li><li>In&nbsp;<a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>:<ul><li>For&nbsp;<a class=\"reference-link\" href=\"#root/_help_xWbu3jpNWapp\">Calendar</a>:<ul><li>Clicking on an event will open that event for quick editing.</li><li>If the calendar is for the&nbsp;<a class=\"reference-link\" href=\"#root/_help_l0tKav7yLHGF\">Day Notes</a>&nbsp;root, clicking on the day number will open the popup for that day note.</li></ul></li><li>For&nbsp;<a class=\"reference-link\" href=\"#root/_help_81SGnPGMk7Xc\">Geo Map</a>:<ul><li>Clicking on a marker will open that marker, but only if the map is in read-only mode.</li></ul></li></ul></li></ul><h2>Handling of read-only notes</h2><p>The Quick edit feature has a unique behavior for&nbsp;<a class=\"reference-link\" href=\"#root/_help_CoFPLs3dRlXc\">Read-Only Notes</a>: </p><ul><li>If the note is read-only due to performance reasons (auto read-only), then the note is made editable for quick editing.</li><li>If the note has been manually set to read-only, then the note is read-only to prevent accidental change.<ul><li>In this case, the note can still be edited by on-screen instructions.</li></ul></li></ul>",
+ "_help_9sRHySam5fXb": "<p>Workspace is a concept built up on top of <a href=\"#root/_help_OR8WJ7Iz9K4U\">note hoisting</a>. It is based on the idea that a user has several distinct spheres of interest. An example might be \"Personal\" and \"Work\", these two spheres are quite distinct and don't interact together. When I focus on Work, I don't really care about personal notes.</p><p>So far workspace consists of these features:</p><ul><li><p><a href=\"#root/_help_OR8WJ7Iz9K4U\">note hoisting</a> - you can \"zoom\" into a workspace subtree to focus only on the relevant notes</p></li><li><p>easy entering of workspace:&nbsp;</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Navigation/1_Workspaces_image.jpg\"></p></li><li><p>visual identification of workspace in tabs:<br><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Navigation/Workspaces_image.jpg\"></p></li></ul><h3>Configuration</h3><figure class=\"table\"><table><thead><tr><th>Label</th><th>Description</th></tr></thead><tbody><tr><td><code>workspace</code></td><td>Marks this note as a workspace, button to enter the workspace is controlled by this</td></tr><tr><td><code>workspaceIconClass</code></td><td>defines box icon CSS class which will be used in tab when hoisted to this note</td></tr><tr><td><code>workspaceTabBackgroundColor</code></td><td>CSS color used in the note tab when hoisted to this note, use any CSS color format, e.g. \"lightblue\" or \"#ddd\". See <a href=\"https://www.w3schools.com/cssref/css_colors.asp\">https://www.w3schools.com/cssref/css_colors.asp</a>.</td></tr><tr><td><code>workspaceCalendarRoot</code></td><td>Marking a note with this label will define a new per-workspace calendar for&nbsp;<a class=\"reference-link\" href=\"#root/_help_l0tKav7yLHGF\">Day Notes</a>. If there's no such note, the global calendar will be used.</td></tr><tr><td><code>workspaceTemplate</code></td><td>This note will appear in the selection of available template when creating new note, but only when hoisted into a workspace containing this template</td></tr><tr><td><code>workspaceSearchHome</code></td><td>new search notes will be created as children of this note when hoisted to some ancestor of this workspace note</td></tr><tr><td><code>workspaceInbox</code></td><td>Default inbox location for new notes when hoisted to some ancestor of this workspace note. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_S0Fos78ZfcY7\">Note Inbox</a>&nbsp;for more information.</td></tr></tbody></table></figure>",
+ "_help_xWtq5NUHOwql": "<figure class=\"image image-style-align-right image_resized\" style=\"width:50.46%;\"><img style=\"aspect-ratio:538/290;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Navigation/Similar%20Notes_image.png\" width=\"538\" height=\"290\"></figure><p>The Similar Notes feature tries to identify notes that relate to the current note by looking at the content of the notes, their relationships, as well as the date they were created.</p><p>To access the list of similar notes:</p><ul><li>Go to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_KRlZFoIH0j6p\">Connections tab</a>&nbsp;in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>&nbsp;and look for the corresponding section.</li><li>Alternatively, press the&nbsp;<span class=\"tn-icon bx bx-info-circle\"></span> in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_AlJ73vBCjWDw\">Status bar</a>&nbsp;and select <em>Show similar notes</em> which will open a pane at the bottom.</li></ul><h2>Interaction</h2><ul><li>Hover over a note to see a short preview of the note.</li><li>Click over a note to open it in the current view.</li><li><kbd>Ctrl</kbd> + click a note to open it in a separate tab.</li></ul>",
+ "_help_McngOG2jbUWX": "<figure class=\"image image_resized\" style=\"width:100%;\"><img style=\"aspect-ratio:898/93;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Navigation/Search%20in%20note_image.png\" width=\"898\" height=\"93\"></figure><p>Local search allows you to search within the currently displayed note.&nbsp;</p><h2>Alternatives</h2><ul><li>Pressing <kbd>Ctrl</kbd>+<kbd>F</kbd> while in a browser while not focused in a&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;or a&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;note will trigger the browser's native search. This will also find text that is part of Trilium's UI.</li><li>Pressing <kbd>Ctrl</kbd>+<kbd>F</kbd> in a&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;note will reveal&nbsp;<a class=\"reference-link\" href=\"#root/_help_MI26XDLSAlCD\">CKEditor</a>'s search functionality.</li></ul><h2>Accessing the search</h2><ul><li>On desktop, press<kbd>Ctrl</kbd> + <kbd>F</kbd>.</li><li>From the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>, look for the context menu and select <em>Search in note</em>.</li></ul><h2>Interaction</h2><ul><li>Finding:<ul><li>Fill in the <em>Find in text…</em> with the text to search for.</li><li>The search will be executed automatically in the background.</li><li>Use up and down arrows of the text box to navigate between results.</li></ul></li><li>Replacing:<ul><li>Fill in the <em>Find in text</em>… field with the text to replace.</li><li>Fill in the <em>Replace with…</em> field the text to replace it with.</li><li>Press <em>Replace</em> to replace only the current result.</li><li>Press <em>Replace all</em> to replace all of them at once.</li></ul></li><li>Options:<ul><li><em>Case sensitive</em> – the search will distinguish upper case characters from lower case (e.g. searching for Hello will not match <code>hello</code>).</li><li><em>Match words</em> - the search will find only exact word matches (e.g. searching for <code>Java</code> will not match <code>JavaScript</code>).</li></ul></li></ul>",
+ "_help_A9Oc6YKKc65v": "<p>This is supposed to be a complete list of keyboard shortcuts. Note that some of these may work only in certain contexts (e.g. in tree pane or note editor).</p><h2>Configuring keyboard shortcuts</h2><p>It is also possible to configure most keyboard shortcuts in&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Shortcuts</em>.</p><p>On the&nbsp;<a class=\"reference-link\" href=\"#root/_help_poXkQfguuA0U\">Desktop Installation</a>, it's also possible to make shortcuts global by pressing on the globe icon near the key combination, which makes the shortcut work even without Trilium being in focus.</p><h3>Keyboard layouts</h3><p>Shortcuts follow the characters printed on the keys of the active keyboard layout. On a French AZERTY keyboard, for example, <kbd>Ctrl</kbd>+<kbd>Z</kbd> is the key labeled Z.</p><p>On a layout that doesn't type Latin letters, such as Russian, Greek or Hebrew, a key that types a letter of that alphabet counts as the key at the same position on a US QWERTY keyboard. <kbd>Ctrl</kbd>+<kbd>J</kbd> is then the key that types <code>о</code> on a Russian keyboard, so shortcuts keep working without switching the layout first.</p><p>Keys that type punctuation still follow their own character. On a Russian keyboard, the key that types <code>.</code> triggers <kbd>Ctrl</kbd>+<kbd>.</kbd>, not the shortcut of the US key at its position.</p><h2>Shortcut reference</h2><aside class=\"admonition note\"><p>All these shortcuts indicate the default key-bindings which can be changed individually from&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Shortcuts.</em></p></aside><h3>Tree</h3><p>See the corresponding section:&nbsp;<a class=\"reference-link\" href=\"#root/_help_DvdZhoQZY9Yd\">Keyboard shortcuts</a></p><h3>Note navigation</h3><ul><li><kbd>Alt</kbd>+<kbd>←</kbd>, <kbd>Alt</kbd>+<kbd>→</kbd> – go back / forwards in the history</li><li><kbd>Ctrl</kbd>+<kbd>J</kbd> – show <a href=\"#root/_help_MMiBEQljMQh2\">\"Jump to\" dialog</a></li><li><kbd>Ctrl</kbd>+<kbd>.</kbd> – scroll to current note (useful when you scroll away from your note or your focus is currently in the editor)</li><li><kbd>Backspace</kbd> – jumps to parent note</li><li><kbd>Alt</kbd>+<kbd>C</kbd> – collapse whole note tree</li><li><kbd>Alt</kbd>+<kbd>-</kbd> (alt with minus sign) – collapse subtree (if some subtree takes too much space on tree pane you can collapse it)</li><li>you can define a <a href=\"#root/_help_zEY4DaJG4YT5\">label</a> <code>#keyboardShortcut</code> with e.g. value <code>Ctrl + I</code> . Pressing this keyboard combination will then bring you to the note on which it is defined. Note that Trilium must be reloaded/restarted (<kbd>Ctrl</kbd>+<kbd>R</kbd> ) for changes to be in effect.</li></ul><p>See demo of some of these features in <a href=\"#root/_help_MMiBEQljMQh2\">note navigation</a>.</p><h3>Tabs</h3><ul><li><kbd>Ctrl</kbd> + <kbd>🖱 Left click</kbd> – (or middle mouse click) on note link opens note in a new tab</li></ul><p>Only in desktop (electron build):</p><ul><li><kbd>Ctrl</kbd>+<kbd>T</kbd> – opens empty tab</li><li><kbd>Ctrl</kbd>+<kbd>W</kbd> – closes active tab</li><li><kbd>Ctrl</kbd>+<kbd>Tab</kbd> – activates next tab</li><li><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Tab</kbd> – activates previous tab</li></ul><h3>Splits</h3><p><a class=\"reference-link\" href=\"#root/_help_luNhaphA37EO\">Split View</a>&nbsp;can also be controlled through keyboard actions, such as:</p><ul><li>Creating a new split</li><li>Closing the active split</li><li>Moving a split left/right</li><li>Focusing the split to the left/right.</li></ul><p>All these keyboard shortcuts do not have a default set, go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Shortcuts</em> and look for the <em>Split View</em> category.</p><h3>Context menus</h3><p>Every context menu can be operated from the keyboard, however it was opened, for example with the <kbd>Menu</kbd> key in a text note to reach the spelling suggestions. These keys are fixed and cannot be changed in the options.</p><ul><li><kbd>↑</kbd>, <kbd>↓</kbd> – move to the previous / next item, skipping disabled ones and wrapping around at either end</li><li><kbd>Home</kbd>, <kbd>End</kbd> – move to the first / last item</li><li><kbd>→</kbd> – open the submenu of the current item, or move to the next column in a submenu laid out in columns</li><li><kbd>←</kbd> – move to the previous column, or close the submenu and go back to its item</li><li><kbd>Enter</kbd> or <kbd>Space</kbd> – run the current item, or open its submenu</li><li><kbd>Esc</kbd> – close the innermost submenu, then the menu itself</li><li>typing the first letters of an item – jump to the next item whose title starts with them</li></ul><p>With a right-to-left language, <kbd>←</kbd> and <kbd>→</kbd> swap roles.</p><h3>Creating notes</h3><ul><li><kbd>Ctrl</kbd>+<kbd>O</kbd> – creates new note after the current note</li><li><kbd>Ctrl</kbd>+<kbd>P</kbd> – creates new sub-note into current note</li><li><kbd>F2</kbd> – edit the&nbsp;<a class=\"reference-link\" href=\"#root/_help_TBwsyfadTA18\">Branch prefix</a>&nbsp;of current note clone</li></ul><h3>Editing notes</h3><aside class=\"admonition note\"><p>For keyboard shortcuts specific to&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes, refer to&nbsp;<a class=\"reference-link\" href=\"#root/_help_oiVPnW8QfnvS\">Keyboard shortcuts</a>&nbsp;and&nbsp;<a class=\"reference-link\" href=\"#root/_help_QrtTYPmdd1qq\">Markdown-like formatting</a>.</p></aside><ul><li>Enter in tree pane switches from tree pane into note title. Enter from note title switches focus to text editor. <kbd>Ctrl</kbd>+<kbd>.</kbd> switches back from editor to tree pane.</li><li><kbd>Ctrl</kbd>+<kbd>.</kbd> – jump away from the editor to tree pane and scroll to current note</li></ul><h3>Runtime shortcuts</h3><p>These are hooked in Electron to be similar to native browser keyboard shortcuts.</p><ul><li><kbd>F5</kbd>, <kbd>Ctrl</kbd>+<kbd>R</kbd> – reloads Trilium front-end</li><li><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd> – show developer tools</li><li><kbd>Ctrl</kbd>+<kbd>F</kbd> – show search dialog</li><li><kbd>Ctrl</kbd>+<kbd>-</kbd> – zoom out</li><li><kbd>Ctrl</kbd>+<kbd>=</kbd> – zoom in</li></ul><h3>Other</h3><ul><li><kbd>Alt</kbd>+<kbd>O</kbd> – show SQL console (use only if you know what you're doing)</li><li><kbd>Alt</kbd>+<kbd>M</kbd> – distraction-free mode - display only note editor, everything else is hidden</li><li><kbd>F11 </kbd> – toggle full screen</li><li><kbd>Ctrl</kbd>+<kbd>S</kbd> – toggle <a href=\"#root/_help_eIg8jdvaoNNd\">search</a> form in tree pane</li><li><kbd>Alt</kbd>+<kbd>A</kbd> – show note <a href=\"#root/_help_zEY4DaJG4YT5\">attributes</a> dialog</li></ul>",
+ "_help_Wy267RK4M69c": "<h2>Default Themes</h2><p>Trilium comes with a couple pre-installed color themes, with the default being a light theme. To switch to a dark theme or any other available theme, navigate to the <span class=\"tn-icon bx bx-cog\"></span> Options menu (accessible via the app icon in the top-left corner), select the Appearance tab, and choose your preferred theme.</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Themes_dark-theme.png\" alt=\"Dark Theme\"></p><p>While a dark theme is active, Trilium asks the Dark Reader browser extension not to darken the page a second time. Dark Reader still darkens the light themes. After switching from a dark theme to a light one, reload the page (<kbd>Ctrl</kbd>+<kbd>R</kbd>) for Dark Reader to take effect again.</p><h2>Creating Custom CSS Themes</h2><p>Trilium supports custom user themes, allowing you to personalize the application's appearance. To create a custom theme, follow these steps:</p><ol><li><strong>Create a CSS Code Note</strong>: Start by creating a new <a href=\"#root/_help_6f9hih2hXXZk\">code note</a> with the <code>CSS</code> type.</li><li><strong>Annotate with</strong> <code>#appTheme</code>: Add the <a href=\"#root/_help_zEY4DaJG4YT5\">attribute</a> <code>#appTheme=my-theme-name</code> to your note, where <code>my-theme-name</code> is the name of your custom theme.</li><li><strong>Define Your Styles</strong>: Write your custom CSS within the note.</li></ol><details class=\"trilium-collapsible\" open=\"\"><summary>Example of a custom theme</summary><pre><code class=\"language-text-x-trilium-auto\">@font-face {\n font-family: 'Raleway';\n font-style: normal;\n font-weight: 400;\n src: url('/custom/fonts/raleway.woff2') format('woff2');\n}\n\n:root {\n --main-font-family: 'Raleway' !important;\n --main-font-size: normal;\n --tree-font-family: inherit;\n --tree-font-size: normal;\n --detail-font-family: inherit;\n --detail-font-size: normal;\n --detail-text-font-family: 'Garamond' !important;\n\n --main-background-color: #404552;\n --main-text-color: #AFB8C6;\n --main-border-color: #AFB8C6;\n --accented-background-color: #383C4A;\n --more-accented-background-color: #2F343F;\n --header-background-color: #383C4A;\n --button-background-color: #2F343F;\n --button-disabled-background-color: #404552;\n --button-border-color: #333;\n --button-text-color: #AFB8C6;\n --button-border-radius: 2px;\n --primary-button-background-color: #6c757d;\n --primary-button-text-color: white;\n --primary-button-border-color: #6c757d;\n --muted-text-color: #86919F;\n --input-text-color: #AFB8C6;\n --input-background-color: #404552;\n --hover-item-text-color: white;\n --hover-item-background-color: #4877B1;\n --active-item-text-color: white;\n --active-item-background-color: #4877B1;\n --menu-text-color: #AFB8C6;\n --menu-background-color: #383C4A;\n --tooltip-background-color: #383C4A;\n --link-color: lightskyblue;\n --modal-background-color: #404552;\n --modal-backdrop-color: black;\n --scrollbar-border-color: rgba(175, 184, 198, 0.5);\n}\n\nbody .note-detail-text {\n font-size: 120%;\n}\n\nbody .CodeMirror {\n filter: invert(100%) hue-rotate(180deg);\n}</code></pre><p>&nbsp;</p></details><p>&nbsp;</p><h3>Activating Your Custom Theme</h3><p>Once you've created your custom theme:</p><ol><li>Go to \"Menu\" -&gt; \"Options\" (<span class=\"tn-icon bx bx-cog\"></span>) -&gt; \"Appearance.\"</li><li>In the theme selection dropdown, you should see your custom theme listed under the name you provided with the <code>#appTheme</code> <a href=\"#root/_help_zEY4DaJG4YT5\">label</a>.</li><li>Select your custom theme to activate it.</li></ol><p>If you make changes to your theme, press Ctrl + R to reload the frontend and apply your updates.</p><h3>Sharing and Importing Themes</h3><p>Custom themes can be exported as <code>.tar</code> archives, which can be shared with other users. However, be cautious when importing themes from untrusted sources, as they may contain executable scripts that could pose security risks.</p><p>An example user theme, <em>Steel Blue</em>, is available in the demo document.</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Themes_steel-blue.png\" alt=\"Steel Blue Theme\"></p><h3>Using Custom CSS for Specific Purposes</h3><p>In addition to full themes, Trilium allows for custom CSS that isn't tied to a theme. This can be particularly useful in scripting contexts, where you might want to modify specific UI elements, such as changing the colors of notes in the tree view.</p><h3>Applying Custom CSS</h3><p>To use custom CSS:</p><ol><li><strong>Create a CSS Code Note</strong>: Create a new&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;note with the <code>CSS</code> type.</li><li><strong>Add the</strong> <code>appCss</code> <strong>Label</strong>: Annotate the note with the <code>#appCss</code> <a href=\"#root/_help_zEY4DaJG4YT5\">label</a>.</li><li><strong>Write Your CSS</strong>: Add your custom CSS rules to the note.</li></ol><p>For example:</p><pre><code class=\"language-text-x-trilium-auto\">/* Custom CSS to style specific elements */\n.tree-item {\n color: #ff6347; /* Change tree item color */\n}</code></pre><p>When Trilium's frontend starts, all notes labeled with <code>appCss</code> are automatically included in the style element of the HTML page.</p><p>After making changes, press Ctrl + R to reload the frontend and apply your new styles.</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Themes_image.jpg\"></p><h3>Styling Specific Notes in the Tree</h3><p>To apply specific styles to certain notes in the tree:</p><ul><li><strong>Use the</strong> <code>cssClass</code> <strong>Attribute</strong>: Add the <code>cssClass</code> <a href=\"#root/_help_zEY4DaJG4YT5\">attribute</a> to a note, and assign it a value representing the desired CSS class.</li><li><strong>Define an</strong> <code>iconClass</code>: You can also define a custom icon for a note using the <code>iconClass</code> attribute, selecting from <a href=\"https://boxicons.com\">Box Icons</a> or your own custom classes.</li></ul><p>For example, if you want to style notes of a specific type, such as notes containing PNG images, you can target them with classes like <code>type-image mime-image-png</code>.</p><h3>User-Provided Themes</h3><p>A gallery of user-created themes is available, showcasing the variety of customizations that the Trilium community has developed. For more information, check the&nbsp;<a class=\"reference-link\" href=\"#root/_help_VbjZvtUek0Ln\">Theme Gallery</a>.</p><h3>Asset Path Management</h3><p>When referencing built-in assets like images in your custom themes or CSS, you can avoid hardcoding version numbers by using the <code>vX</code> alias. For example, instead of specifying <code>/assets/v0.57.0-beta/images/icon-grey.png</code>, you can use <code>/assets/vX/images/icon-grey.png</code> to keep your theme compatible with future versions of Trilium.</p>",
+ "_help_VbjZvtUek0Ln": "<p>These are user-created themes which were made publicly available:</p><h2>Legacy Themes</h2><p>These themes may or may not be compatible with the latest versions of TriliumNext and are based on the original/legacy theme.</p><figure class=\"table\"><table><thead><tr><th>Theme</th><th>Author</th></tr></thead><tbody><tr><td><a href=\"https://github.com/tobealive/trilium-midnight-theme\">Midnight</a></td><td><a href=\"https://github.com/tobealive\">tobealive</a></td></tr><tr><td><a href=\"https://github.com/tobealive/trilum-eote-theme\">EOTE</a></td><td><a href=\"https://github.com/tobealive\">tobealive</a></td></tr><tr><td><a href=\"https://github.com/Abourass/TriliumThemes\">Trilium Themes</a></td><td><a href=\"https://github.com/Abourass\">Abourass</a></td></tr><tr><td><a href=\"https://github.com/ZMonk91/Material-Dark-Trilium\">MaterialDark</a></td><td><a href=\"https://github.com/ZMonk91\">ZMonk91</a></td></tr><tr><td><a href=\"https://github.com/jaroet/trilium-theme-lightslategray\">lightslategray</a></td><td><a href=\"https://github.com/jaroet\">jaroet</a></td></tr><tr><td><a href=\"https://github.com/raphwriter/trilium-theme-melon\">melon-4</a></td><td><a href=\"https://github.com/raphwriter\">raphwriter</a></td></tr><tr><td><a href=\"https://github.com/Engr-AllanG/trilium-themes\">Neon_Dark</a></td><td><a href=\"https://github.com/Engr-AllanG\">Engr-AllanG</a></td></tr><tr><td><a href=\"https://github.com/Engr-AllanG/trilium-themes\">Coder_Dark</a></td><td><a href=\"https://github.com/Engr-AllanG\">Engr-AllanG</a></td></tr><tr><td><a href=\"https://github.com/idelem/trilium-theme-velvet\">velvet</a></td><td><a href=\"https://github.com/idelem\">idelem</a></td></tr><tr><td><a href=\"https://github.com/SADAVA/trilium-notes-theme-dark-plus\">Dark Plus</a></td><td><a href=\"https://github.com/SADAVA\">SADAVA</a></td></tr><tr><td><a href=\"https://github.com/WKSu/trilium-solarized-theme\">Solarized</a></td><td><a href=\"https://github.com/WKSu\">WKSu</a></td></tr><tr><td><a href=\"https://github.com/en3r0/Trilium-Nord-Theme\">Nord</a></td><td><a href=\"https://github.com/en3r0\">en3r0</a></td></tr><tr><td><a href=\"https://github.com/AllanZyne/trilium-bear-theme\">Bear Note Light</a></td><td><a href=\"https://github.com/AllanZyne\">AllanZyne</a></td></tr><tr><td><a href=\"https://github.com/AllanZyne/trilium-bear-theme\">Bear Note Dark</a></td><td><a href=\"https://github.com/AllanZyne\">AllanZyne</a></td></tr><tr><td><a href=\"https://github.com/Sebiann/miku-hatsune-trilium-theme\">Miku Hatsune</a></td><td><a href=\"https://github.com/Sebiann\">Sebiann</a></td></tr><tr><td><a href=\"https://github.com/cwilliams5/Midnight-Trilium-Dark-Mode\">Midnight</a></td><td><a href=\"https://github.com/cwilliams5\">cwilliams5</a></td></tr><tr><td><a href=\"https://github.com/SiriusXT/trilium-theme-blue\">Blue</a> (light)</td><td><a href=\"https://github.com/SiriusXT\">SiriusXT</a></td></tr><tr><td><a href=\"https://github.com/SiriusXT/trilium-theme-blue\">Blue</a> (dark)</td><td><a href=\"https://github.com/SiriusXT\">SiriusXT</a></td></tr></tbody></table></figure><aside class=\"admonition tip\"><p>If you would like to add your theme to this gallery, write a new post in <a href=\"https://github.com/TriliumNext/Trilium/discussions/categories/show-and-tell\">👐 Show and tell</a>.</p></aside>",
+ "_help_gOKqSJgXLcIj": "<figure class=\"image image-style-align-right image_resized\" style=\"width:45.14%;\"><img style=\"aspect-ratio:854/649;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Themes/Icon%20Packs_image.png\" width=\"854\" height=\"649\"></figure><p>By default, Trilium comes with a set of icons called Boxicons v2. Since v0.102.0, custom icon packs allow a wider selection of icons for notes.</p><p>Icon packs are specific to Trilium, so they must either be created from scratch (see below) or imported from a ZIP file from a third-party developer.</p><h2>Sample icon packs</h2><p>The Trilium team maintains a few icon packs that are not shipped with Trilium. These icon packs can be found on the official website on the <a href=\"https://triliumnotes.org/resources\">Resources page</a>.</p><h2>Importing an existing icon pack</h2><aside class=\"admonition note\"><p><strong>Icon packs are third-party content</strong></p><p>Apart from the <a href=\"https://triliumnotes.org/resources\">sample icon packs</a>, the Trilium maintainers are not responsible for keeping icon packs up to date. If you have an issue with a specific icon pack, then the issue must be reported to the third-party developer responsible for it, not the Trilium team.</p></aside><p>To import an icon pack:</p><ol><li>Ideally, create a dedicated spot in your note tree where to place the icon packs.</li><li>Right click the note where to put it and select <em>Import into note</em>.</li><li>Uncheck <em>Safe import</em>.</li><li>Select <em>Import</em>.</li><li><a href=\"#root/_help_s8alTXmpFR61\">Refresh the application</a>.</li></ol><aside class=\"admonition warning\"><p>Since <em>Safe import</em> is disabled, make sure you trust the source as it could contain dangerous third-party scripts. One good way to check if the icon pack is safe is to manually extract the .zip and inspect the file contents. Icon packs should only contain a font file and a JSON file. Other files (especially scripts) are to be considered harmful.</p></aside><h2>Creating an icon pack</h2><p>Creating an icon pack requires some scripting knowledge outside Trilium in order to generate the list of icons. For information, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_g1mlRoU8CsqC\">Creating an icon pack</a>.</p><h2>Using an icon from an icon pack</h2><p>After <a href=\"#root/_help_s8alTXmpFR61\">refreshing the application</a>, the icon pack should be enabled by default. To test this, simply select an existing note or create a new one and try to change the note icon.</p><p>There should be a <em>Filter</em> button to the right of the search bar in the icon list. Clicking it allows filtering by icon pack and the newly imported icon pack should be displayed there.</p><aside class=\"admonition note\"><p>If the icon pack is missing from that list, then most likely there's something wrong with it.</p><ul><li>Try checking the&nbsp;<a class=\"reference-link\" href=\"#root/_help_bnyigUA2UK7s\">Backend (server) logs</a>&nbsp;for clues and make sure that the icon pack has the <code>#iconPack</code> <a href=\"#root/_help_HI6GBBIduIgv\">label</a> with a value assigned to it (a prefix).</li><li>Icon packs that are <a href=\"#root/_help_bwg0e8ewQMak\">protected</a> are ignored.</li></ul></aside><h2>Integration with the share and export functionality</h2><p>Custom icon packs are also supported by the&nbsp;<a class=\"reference-link\" href=\"#root/_help_R9pX4DGra2Vt\">Sharing</a>&nbsp;feature, where they will be shown in the note tree. However, in order for an icon pack to be visible to the share function, the icon pack note must also be shared.</p><p>If you are using a custom share theme, make sure it supports the <code>iconPackCss</code>, otherwise icons will not show up. Check the original share template source code for reference.</p><p>Custom icon packs will also be preserved when&nbsp;<a class=\"reference-link\" href=\"#root/_help_ycBFjKrrwE9p\">Exporting static HTML for web publishing</a>. In this case, there's no requirement to make the icon pack shared.</p><h2>What happens if I remove an icon pack</h2><p>If an icon pack is removed or disabled (by removing or altering its <code>#iconPack</code> label), all the notes that use this icon pack will show in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;with no icon. This won't cause any issues apart from looking strange.</p><p>The solution is to replace the icons with some else, try using&nbsp;<a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>&nbsp;which supports bulk actions, to identify the notes with the now deleted icon pack (by looking for the prefix) and changing or removing their <code>iconClass</code>.</p>",
+ "_help_w4rMEhJsALlA": "<h2>Using different fonts</h2><p>Trilium comes by default with its own font (<em>Inter</em>), but the font can be adjusted in&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Appearance</em>, by checking <em>Use different fonts</em> in the <em>Fonts</em> section.</p><p>The font can be personalized for the following areas of the application:</p><ul><li>Interface text, for most of the UI (menus, toolbars, dialogs).</li><li><a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.</li><li>Document text, for the actual content of the notes (especially for&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes).</li><li>Monospace text, e.g. for&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;notes and&nbsp;<a class=\"reference-link\" href=\"#root/_help_QxEyIjRBizuC\">Code blocks</a>.</li></ul><p>Each area also has its own <em>Size</em>. The note tree and document sizes are relative to the interface size, so changing the interface size moves them along with it.</p><p>The list of fonts contains the following items:</p><ul><li><strong>Generic fonts</strong><ul><li><em>Theme defined</em> which uses the font that is embedded with the current <a href=\"#root/_help_Wy267RK4M69c\">theme</a>. For example on the default modern theme, the font is <em>Inter</em>. This does not require the font to be installed.</li><li><em>System default</em> which uses a combination of fonts that works best for the <a href=\"#root/_help_poXkQfguuA0U\">desktop app</a>. For example on Windows it will use <em>Segoe UI</em>.</li><li>Generic font selections for fonts with serifs (e.g. <em>Times New Roman</em>-like), no serifs and monospace.</li></ul></li><li><strong>Web fonts</strong> which appear on the&nbsp;<a class=\"reference-link\" href=\"#root/_help_WOcw2SLH6tbX\">Server Installation</a>, which is a predefined list of fonts and grouped into Sans-serif, serif, monospace and handwriting. The fonts that are not supported by your system (i.e. not installed) are not displayed.</li><li><strong>System fonts</strong> which appear on the&nbsp;<a class=\"reference-link\" href=\"#root/_help_poXkQfguuA0U\">Desktop Installation</a>. Unlike the server fonts which are predefined, the system fonts are listed from your operating system.</li><li><strong>Custom fonts</strong>, allowing any font to be used provided it's imported into Trilium. See the section below for more information.</li></ul><p>Font changes take effect after a reload; the section offers a <em>Reload to apply changes</em> button once something has been changed.</p><h2>Custom fonts</h2><p>A font file imported into Trilium can be used by the application itself, without writing any CSS.</p><h3>Adding a font</h3><ol><li>Import the font file, by dragging it into the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;or through <em>Import into note</em>. TrueType (<code>.ttf</code>), OpenType (<code>.otf</code>) and Web Open Font Format (<code>.woff</code>, <code>.woff2</code>) files are recognized; the note takes the font's name without its extension and is marked with a font icon (an “A” icon).</li><li>Select the resulting note where a preview of a font will be displayed: a specimen line to type your own text into, a slider for its size, a preview in multiple sizes, and the Latin character set.</li><li>Turn on <em>In font picker</em> above the specimen.</li><li>In&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Appearance</em> → <em>Fonts</em>, the font is now offered under <em>Custom fonts</em>, ahead of the built-in families, and can be set for any of the four areas.</li></ol><aside class=\"admonition note\"><p>Embedded OpenType (<code>.eot</code>) files and TrueType collections (<code>.ttc</code>) cannot be drawn by the browser, so they are treated as ordinary files: no preview, and no entry in the picker.</p></aside><h3>How custom fonts behave</h3><ul><li>Each entry is named after its note, so renaming the note renames the entry. The setting refers to the note itself rather than to its name, and keeps working across a rename.</li><li>The font file is an ordinary note, so&nbsp;<a class=\"reference-link\" href=\"#root/_help_cbkrhQjrkKrh\">Synchronization</a>&nbsp;carries it to your other devices. The choice of font is not synced: appearance settings are deliberately kept per-device, so on another device the font is already there and only needs to be selected again.</li><li>A font kept in a <a href=\"#root/_help_bwg0e8ewQMak\">protected note</a> can only be previewed and used while the protected session is open.</li></ul><p>For theme authors, a font can also be embedded in a theme's CSS through&nbsp;<a class=\"reference-link\" href=\"#root/_help_d3fAXQ2diepH\">Custom Resource Providers</a>, which is the route to take when the font should come with the theme rather than be chosen in the settings.</p><h3>Downloading from Google Fonts</h3><p>A large selection of fonts can be easily retrieved from Google Fonts, as follows:</p><ol><li>Go to <a href=\"https://fonts.google.com\">https://fonts.google.com</a>.</li><li>Search for a desired font.</li><li>Press <em>Get font</em> in the top right.</li><li>Check that the list of fonts on the left side corresponds to your selection.</li><li>Press <em>Download all</em>.</li><li>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, create a note where to store the new fonts.</li><li>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, drag-and-drop the .zip file directly onto the newly created note and follow the steps from the previous section.</li></ol><h2>Programming ligatures</h2><p>Some fonts support programming ligatures, which will turn character combinations such as <code>!=</code> into <code>≠</code> or <code>-&gt;</code> as <code>→</code> in&nbsp;<a class=\"reference-link\" href=\"#root/_help_QxEyIjRBizuC\">Code blocks</a>&nbsp;and&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;notes.</p><p>These are only a display affordance, so copying the text is not affected. Regardless, this feature can be disabled in Trilium by unchecking <em>Programming ligatures</em> in the font settings.</p>",
+ "_help_mHbBMPDPkVV5": "<p>To import a note:</p><ul><li>The easiest way to import is to simply drag &amp; drop a file or an archive into the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.<ul><li>This will automatically detect some formats such as&nbsp;<a class=\"reference-link\" href=\"#root/_help_iWD7wiIuMtgV\">Obsidian</a>.</li><li><em>Safe import</em> is automatically on to prevent accidental running of foreign scripts.</li></ul></li><li>To configure an import, there is a dedicated dialog which can be accessed from either&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;→ <em>Import into note</em> or&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>&nbsp;→ <em>Import into note</em>.<ul><li>This feature allows for dedicated importers for others apps such as&nbsp;<a class=\"reference-link\" href=\"#root/_help_iWD7wiIuMtgV\">Obsidian</a>&nbsp;or&nbsp;<a class=\"reference-link\" href=\"#root/_help_GnhlmrATVqcH\">Microsoft OneNote</a>.</li><li><em>Safe import</em> as well as other options can be configured from the collapsed <em>Options</em> section at the bottom.</li></ul></li></ul><p>To export a note, right click the note in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;and select <em>Export</em>. Similarly, in&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>&nbsp;there is a <em>Export note</em> option.</p><h2>Supported formats</h2><p>Trilium natively supports the following formats for both import and export.</p><ul><li>HTML:<ul><li>This is the main format used by Trilium, where standard tags are used to represent basic formatting and layout (e.g. <code>&lt;strong&gt;</code>, <code>&lt;table&gt;</code>, <code>&lt;pre&gt;</code>).</li><li>Note that HTML is not a standardized format so some more specific features such as admonitions or&nbsp;<a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>&nbsp;might not be supported by other applications.</li><li>The notes can also be exported as <a href=\"#root/_help_ycBFjKrrwE9p\">static HTML that can be used for web publishing</a>.</li></ul></li><li><a class=\"reference-link\" href=\"#root/_help_Oau6X9rCuegd\">Markdown</a><ul><li>Most of the formatting is preserved, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_rJ9grSgoExl9\">Supported syntax</a>.</li></ul></li><li>OPML (Outliner Interchange Format)<ul><li>Supports both OPML v1.0 for plain text and v2.0 with HTML support.</li></ul></li></ul><p>To import from other applications such as OneNote, Notion and others, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_ckZ2uNWQmVeX\">Importing data from other applications</a>.</p><h2>Maximum import size</h2><p>Versions prior to v0.104.0 had an upload limit of 250 MiB that could be bypassed via a <code>TRILIUM_NO_UPLOAD_LIMIT</code> environment variable; with v0.104.0 this limit was removed.</p><p>Nevertheless, there is still a limit for the maximum size of a <strong>single item</strong> (whether it's a&nbsp;<a class=\"reference-link\" href=\"#root/_help_W8vYD3Q1zjCR\">File</a>, an&nbsp;<a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>&nbsp;or even a&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;note). The limit is approximately 374 MiB and it's determined by the&nbsp;<a class=\"reference-link\" href=\"#root/_help_cbkrhQjrkKrh\">Synchronization</a>&nbsp;protocol. Attempts to import such large files will be refused.</p><p>During large imports or exports, memory consumption might spike but it will remain somewhere around the 2 gigabyte mark. Tested with a 2.4 GB database with ~21k notes.</p><aside class=\"admonition important\"><p>For the&nbsp;<a class=\"reference-link\" href=\"#root/_help_poXkQfguuA0U\">Desktop Installation</a>, there are two distinct import mechanisms:</p><ul><li>A quick import, from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.</li><li>The import dialog (via right click in the note tree → <em>Import into note</em> or from&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>).</li></ul><p>When dealing with large files (multi-gigabyte), prefer using the import dialog as it has a special mechanism which makes sure that the file is read directly from disk rather than uploaded again.</p></aside><h2>Exporting the root note</h2><p>The root note is the top-most note. Exporting it behaves just like any other note: right click on it in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;and select <em>Export</em>.</p><p>Starting with v0.104.0, when a root note is imported, it will be imported as a child of your existing root note. This behavior makes sure that the import cannot change or overwrite your existing notes.</p><p>You can easily move the notes onto the root using the tree's&nbsp;<a class=\"reference-link\" href=\"#root/_help_yTjUdsOi4CIE\">Multiple selection</a>&nbsp;and delete the redundant root note.</p><figure class=\"table\"><table><thead><tr><th scope=\"col\">Before</th><th scope=\"col\">After</th></tr></thead><tbody><tr><td><ul><li>root<ul><li>one</li><li>two</li></ul></li></ul></td><td><ul><li>root (existing)<ul><li>root (from import)<ul><li>one</li><li>two</li></ul></li></ul></li></ul></td></tr></tbody></table></figure><aside class=\"admonition tip\"><p>Instead of exporting full ZIPs (including the root note), consider using <a href=\"#root/_help_ODY7qQn5m2FT\">backups</a> instead. Backups always contain the entire structure, as well as additional information a ZIP export does not have: maintains note IDs, contains the options/tokens and handle&nbsp;<a class=\"reference-link\" href=\"#root/_help_bwg0e8ewQMak\">Protected Notes</a>&nbsp;better.</p></aside><h2>Exporting the User Guide</h2><p>The in-app User Guide can be exported like any other note: right click one of its pages or chapters in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> and select <em>Export</em>, or use&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Export note</em>.</p><ul><li>Exporting a chapter with <em>This note &amp; all descendants</em> writes the pictures and files of each page as its attachments. Importing that archive creates an ordinary copy that you can edit, with its pictures and the links between its pages working.</li><li>Exporting a single page with <em>Only this note</em> embeds its pictures in the exported file.</li></ul>",
+ "_help_Oau6X9rCuegd": "<p>Trilium supports Markdown for both import and export, while trying to keep compatibility as high as possible.</p><h2>Import</h2><h3>Clipboard import</h3><p>If you want to import just a chunk of markdown from clipboard, you can do it from editor block menu:</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Import%20%26%20Export/Markdown_markdown-inline-import.gif\"></p><h3>File import</h3><p>You can also import Markdown files from files:</p><ul><li>single markdown file (with .md extension)</li><li>whole tree of markdown files (packaged into <a href=\"https://en.wikipedia.org/wiki/Tar_(computing)\">.zip</a> archive)<ul><li>Markdown files need to be packaged into ZIP archive because browser can't read directories, only single files.</li><li>You can use e.g. <a href=\"https://www.7-zip.org\">7-zip</a> to package directory of markdown files into the ZIP file</li></ul></li></ul><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Import%20%26%20Export/Markdown_markdown-file-import.gif\"></p><h2>Export</h2><h3>Subtree export</h3><p>You can export whole subtree to ZIP archive which will have directory structured modelled after subtree structure:</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Import%20%26%20Export/Markdown_markdown-export-subtree.gif\"></p><h3>Single note export</h3><p>If you want to export just single note without its subtree, you can do it from Note actions menu:</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Import%20%26%20Export/Markdown_markdown-export-note.gif\"></p><h3>Exporting protected notes</h3><p>If you want to export protected notes, enter a protected session first! This will export the notes in an unencrypted form, so if you reimport into Trilium, make sure to re-protect these notes.</p><h2>Supported syntax</h2><p>See the dedicated page:&nbsp;<a class=\"reference-link\" href=\"#root/_help_rJ9grSgoExl9\">Supported syntax</a></p>",
+ "_help_rJ9grSgoExl9": "<p><a href=\"https://github.github.com/gfm/\">GitHub-Flavored Markdown</a> is the main syntax that Trilium is following.</p><h2>Images</h2><p>When exporting, images are usually kept in the basic Markdown syntax but will use the HTML syntax if the image has a custom width. Figures are always embedded as HTML.</p><h2>Tables</h2><p>Simple tables are supported with the Markdown syntax. If the table is too complex or contains elements that would render as HTML, the table is also rendered as HTML.</p><h2>Links</h2><p>Standard Markdown links are supported.</p><p>Trilium internal links (that mirror a note's title and display its icon) are embedded as HTML in order to preserve the information on import.</p><h2>Math equations</h2><p>Both inline and display equations are supported, using the <code>$</code> and <code>$$</code> syntaxes.</p><h2>Admonitions</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-trilium-auto\">&gt; [!NOTE]\n&gt; This is a note.\n\n&gt; [!TIP]\n&gt; This is a tip.\n\n&gt; [!IMPORTANT]\n&gt; This is a very important information.\n\n&gt; [!CAUTION]\n&gt; This is a caution.</code></pre><p>There are currently no plans of supporting alternative admonition syntaxes such as <code>!!! note</code>.</p><h2>Tabs</h2><p>Tabs use the syntax of <a href=\"https://squidfunk.github.io/mkdocs-material/reference/content-tabs/\">Material for MkDocs</a>: each tab starts with a <code>=== \"Title\"</code> line, followed by its content indented by four spaces. Consecutive tabs form one tabs block, and <code>===!</code> starts a new block right after another one:</p><pre><code class=\"language-text-x-trilium-auto\">=== \"Windows\"\n\n Run the **installer**.\n\n=== \"Linux\"\n\n Use the package.\n\n===! \"Another block\"\n\n This tab starts a separate tabs block.</code></pre><p>Tabs can be nested by indenting the inner tabs inside the content of a tab. A tab title is plain text, so its formatting is not kept on export. For how tabs blocks work in a text note, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_EK2ckIZ74tbT\">Content tabs</a>.</p><h2>Wikilinks</h2><p>Basic support for wikilinks has been added in v0.96.0:</p><ul><li><code>[[foo/bar]]</code> will look for the <code>bar.md</code> file in the <code>foo</code> directory and turn it into an internal link.</li><li><code>![[foo/baz.png]]</code> will look for the <code>baz.png</code> file in the <code>foo</code> directory and turn it into an image.</li></ul><p>This feature is import-only, which means that it will turn wikilinks into Trilium-compatible syntax, but it will not export Trilium Notes into Markdown files with this syntax.</p><aside class=\"admonition important\"><p>The path to pages in wikilinks is resolved relatively to the <em>import root</em> and not the current directory of the note. This is to be inline with other platforms that use wikilinks such as SilverBullet.</p><p>The root path of the import is determined as follows:</p><ul><li>If there is a single directory within the archive at root level, then that directory is considered the root.</li><li>If there are multiple files &amp; directories at root level, then the archive root (containing all of these items) is considered the root.</li></ul></aside><h2>Highlights</h2><p>Background highlights are supported in two ways:</p><ul><li><p>The Markdown <code>==</code> extension which is supported by other Markdown-based applications such as Obsidian:</p><pre><code class=\"language-text-x-trilium-auto\">==highlighted==</code></pre></li><li><p>The canonical HTML representation of highlights, as supported by Trilium:</p><pre><code class=\"language-text-html\">&lt;span style=\"background-color:hsl(0,0%,100%);\"&gt;Highlighted&lt;/span&gt;</code></pre></li></ul><p>When the yellow highlight is used, import/export prefers the <code>==</code> syntax whereas the canonical HTML reprepresentation is used otherwise.</p>",
+ "_help_ckZ2uNWQmVeX": "<p>Starting with version v0.104.0, Trilium's importer was expanded to application-specific imports. Unlike the standard HTML or&nbsp;<a class=\"reference-link\" href=\"#root/_help_Oau6X9rCuegd\">Markdown</a>&nbsp;import/export, these importers are tailored to support the features and note structure of a particular application.</p><h2>Supported applications</h2><ul><li><a class=\"reference-link\" href=\"#root/_help_GnhlmrATVqcH\">Microsoft OneNote</a>, by connecting to your account using Microsoft Graph.</li><li><a class=\"reference-link\" href=\"#root/_help_Y5mKeJ6dsCld\">Notion</a>, via a ZIP export.</li><li><a class=\"reference-link\" href=\"#root/_help_nhQVuO4zvIxi\">Google Keep</a>, via a ZIP export from <em>Google Takeout</em> (Keep has no dedicated export mechanism).</li><li><a class=\"reference-link\" href=\"#root/_help_syuSEKf2rUGr\">Evernote</a>, via an ENEX export.</li><li><a class=\"reference-link\" href=\"#root/_help_83zmPBJRgfnW\">Anytype</a>, via a JSON export.</li><li><a class=\"reference-link\" href=\"#root/_help_iWD7wiIuMtgV\">Obsidian</a>, via a ZIP of the vault.</li></ul><h2>Importing data from another application</h2><p>To import from an application, there are two ways to access the import dialog:</p><ul><li>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, right click on a note and select <em>Import into note</em>.</li><li>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>, select <em>Import files</em>.</li></ul><p>A list of supported applications will appear at the top, each with their own configuration. Simply click one and proceed with the on-screen instructions.</p><h2>Acknowledgement</h2><ul><li>Trilium's importer is inspired by Obsidian's <a href=\"https://github.com/obsidianmd/obsidian-importer\">Importer plugin</a> (licensed under the MIT license), for example regarding the OneNote connection process or the Notion ID management.</li></ul>",
+ "_help_GnhlmrATVqcH": "<p>Trilium allows importing from OneNote. Currently the only mechanism supported is via the Microsoft Graph API which requires you to authenticate in a browser in order for the notes to be obtained by Trilium.</p><h2>Import process</h2><ol><li>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, right click and select <em>Import into note</em>.</li><li>In the <em>Import from</em> section, select&nbsp;<span class=\"tn-icon tn-brand tn-brand-onenote\"></span> <em>OneNote</em>.</li><li>Press the <em>Connect</em> button:<ol><li>On the desktop app, you will be redirected to Microsoft's authentication screen where you can log into your account.</li><li>On the web app, the process is slightly more involved as it requires copying the code to clipboard, accessing the link, pasting the code and then signing in once more.</li></ol></li><li>After the connection is successful, you should be able to see a list of sections that can be imported. Simply check the ones to import and press the <em>Import selected</em> button.</li><li>Wait for the import to finish.</li></ol><h2>Supported features</h2><p>The following features are preserved by Trilium during the import process:</p><ul><li>Basic formatting (bold, italic, underline, strikethrough, subscript, super script, font sizes, headings, colors, highlights).<ul><li>Black-colored text is intentionally stripped to allow it to work in dark themes.</li></ul></li><li>Inline code is automatically detected and formatted. Paragraphs that use the Code style are also converted to&nbsp;<a class=\"reference-link\" href=\"#root/_help_QxEyIjRBizuC\">Code blocks</a>.<ul><li>Unfortunately the indentation of the code might be lost because the information is simply not present in the data from the Microsoft API.</li></ul></li><li><a class=\"reference-link\" href=\"#root/_help_S6Xx8QIWTV66\">Lists</a>&nbsp;with different bullet types.</li><li><a class=\"reference-link\" href=\"#root/_help_NdowYOC1GFKS\">Tables</a><ul><li>Cell backgrounds are preserved, including a best-effort hue correction because the colors returned by the Graph API are sometimes incorrect.</li><li>Cell widths are also preserved proportionally, with the only difference that tables in Trilium have a percentage-based width, not fixed pixel sizes.</li></ul></li><li>Images and&nbsp;<a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>.<ul><li>Screen clippings are also properly supported since v0.104.1, displaying their timestamp as a figure caption.</li></ul></li><li>To-do lists</li><li>Hand-drawing is preserved and displayed as an SVG image inside the note<ul><li>OneNote's default color (black) is special since it also renders as white for dark themes. Since v0.104.1, this is also supported by using a special SVG tweak which reacts to light/dark themes.</li></ul></li><li>Links between other imported pages are converted to&nbsp;<a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>&nbsp;if the text of the link matches the name of the page, or plain links otherwise. If the pages are not part of the import, the original <code>onenote:</code> link is kept.</li><li>Tags (apart from to-do lists) are preserved by converting them to <a href=\"#root/_help_hD8GawVuazff\">inline icons</a>, which are searchable by the icon's name and can be recolored like any other icon. Some icons are turned into emojis instead.</li></ul><p>Regarding the note structure:</p><ul><li>The order of the pages within a section is maintained.</li><li>Sub-pages and section groups are maintained by nesting notes in a hierarchical structure.</li><li>Creation and modification of both notes and sections is preserved. The order of section or section groups is not preserved (see limitations).</li></ul><h2>Error management and reporting</h2><p>The OneNote importer uses Microsoft's Graph API which handles the HTML export (that we later post-process for Trilium use). The Graph API itself has to process the OneNote pages before sending them to us, and as such it's a time-consuming operation that is directly proportional to the number of notes and the complexity/size of the notes.</p><p>The Graph API throttles access if it detects too many operations. The importer takes that into account, but sometimes this means that most of the time is spent waiting for the Graph API to unblock access rather than actually importing data.</p><p>In addition, some pages may fail at the Graph API level due to an internal timeout on their side or other issues. Trilium will try to refetch pages in order to avoid that but sometimes pages cannot be retrieved even after multiple retries. In that case, the importer will still create a corresponding note in Trilium but with an error report instead of a content. This preserves&nbsp;<a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>&nbsp;and makes it easy to identify and manually fix the pages that failed.</p><p>At the end of the import, the top-level note called <em>OneNote</em> <em>import</em> will contain information about how the import went:</p><ul><li>The number of notes imported;</li><li>The success rate;</li><li>A list of notes that could not be imported, as well as the failure reason;</li><li>Pages whose images/attachments failed to download</li><li>How long the import spent waiting out throttling.</li></ul><p>To avoid cases in which the import is fundamentally broken (e.g. an expired sign-in), the import will error out if it fails to import 6 pages in a row.</p><h2>Attributes</h2><p>Pages imported from OneNote have a few built-in <a href=\"#root/_help_HI6GBBIduIgv\">labels</a>:</p><ul><li><code>oneNotePageId</code>, with the corresponding page ID in OneNote. This can be used to identify the original OneNote page. Trilium doesn't use it in any way at this moment.</li><li><code>oneNoteImportFailed</code> attached to notes that couldn't be imported. This can be used to quickly&nbsp;<a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>&nbsp;for failed notes.</li></ul><h2>Limitations</h2><h3>Regarding OneNote's freehand structure</h3><p>OneNote is fundamentally different to Trilium in structure because it allows freehand drawing to coexist with text, and text boxes can be placed anywhere in the document (e.g. a common use case is to have columns). Trilium has a document flow mechanism for&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes which means that it can't be freely positioned.</p><p>To cope with this difference, Trilium will flatten the text structure into normal paragraphs. The paragraphs will be ordered visually based on the original position of the text boxes, but their horizontal position will not be preserved. Parallel text such as columns may appear interleaved which can cause problems.</p><p>In addition, drawing in OneNote can be interleaved with text boxes. Text notes in Trilium do not allow for this feature, so all drawing will appear at the end. For some use cases (diagrams, for example) this will work fine, but if you have highlights or other text-dependent drawings they will appear out of order.</p><aside class=\"admonition note\"><p>There are plans to support drawing-heavy notes that interleave with text boxes by converting them to a&nbsp;<a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a>&nbsp;instead.</p></aside><h3>Password-protected sections</h3><p>OneNote supports encryption at section level; when importing a notebook that contains these password-protection sections, Trilium will not be able to read the content of password-protected sections so they will appear empty. This is not a limitation of Trilium, the information is simply not available from the source (Graph API).</p><p>The section itself is kept for reference and all the sections that could not be imported will be shown in the report (the top-level note called <em>OneNote import</em>).</p><p>To unprotect a section in OneNote Desktop, right click on the protected section → <em>Password Protect This Section</em> and press <em>Remove Password</em> and sync. Then re-import either only the protected sections or remove everything and start the import from scratch.</p><h2>Other limitations</h2><p>The following are known limitations due to how the information comes from the import (Microsoft Graph API), which means that they cannot be fixed.</p><ul><li>The order of the sections (and section groups) is not available, the sections are ordered by creation date instead.</li><li>Revision history.</li><li>Paragraph indentation, as well as code block indentation.</li><li>Section colors.</li><li>Drawings inside titles, the title might appear incomplete or “Untitled”.</li></ul><h2>Reporting issues</h2><p>When importing notes, you might find that some text is not rendered properly or the structure is not properly maintained. As long as this issue is not a fundamental issue (like the issue with freehand text not being preserved exactly), it's a good idea to <a href=\"#root/_help_wy8So3yZZlH9\">report it</a>.</p><p>When reporting, make sure that you provide the following information:</p><ul><li>Import again the section, checking the debug checkbox before importing. This preserves the original document (and the hand-drawing data if any) as it came through from OneNote's cloud API so that it can be used for comparison.</li><li>Export only the affected page as ZIP, making sure not to accidentally expose any sensitive information.</li><li>Take screenshots of how the note looked like in OneNote and how it ends up in Trilium.</li><li>Attach the ZIP and the screenshots to the issue report.</li></ul>",
+ "_help_LpvyEIBIAAj7": "<p>OneNote's <em>Tags</em> functionality is imported in Trilium as&nbsp;<a class=\"reference-link\" href=\"#root/_help_hD8GawVuazff\">Icons</a>&nbsp;using the default icon pack or emojis (if there is no suitable replacement).</p><aside class=\"admonition important\"><p>Custom tags are not supported by OneNote's Graph API so Trilium cannot import them.</p></aside><h3>Decorative tags</h3><p>These remain formatted as paragraphs, with the glyph prepended to the text. A paragraph can carry several tags at once, in which case their glyphs stack.</p><figure class=\"table\"><table><thead><tr><th>OneNote tag</th><th><code>data-tag</code></th><th>Imported as</th><th>Searchable as</th></tr></thead><tbody><tr><td>Important</td><td><code>important</code></td><td><span class=\"tn-icon bx bx-star\"></span></td><td><code>star</code></td></tr><tr><td>Critical</td><td><code>critical</code></td><td><span class=\"tn-icon bx bx-error-circle\"></span></td><td><code>error-circle</code></td></tr><tr><td>Question</td><td><code>question</code></td><td><span class=\"tn-icon bx bx-help-circle\"></span></td><td><code>help-circle</code></td></tr><tr><td>Highlight</td><td><code>highlight</code></td><td><span class=\"tn-icon bx bx-highlight\"></span></td><td><code>highlight</code></td></tr><tr><td>Definition</td><td><code>remember-for-later</code></td><td><span class=\"tn-icon bx bx-pin\"></span></td><td><code>pin</code></td></tr><tr><td>Remember for later</td><td><code>remember-for-later</code></td><td><span class=\"tn-icon bx bx-pin\"></span></td><td><code>pin</code></td></tr><tr><td>Remember for blog</td><td><code>remember-for-blog</code></td><td><span class=\"tn-icon bx bx-edit\"></span></td><td><code>edit</code></td></tr><tr><td>Idea</td><td><code>idea</code></td><td><span class=\"tn-icon bx bx-bulb\"></span></td><td><code>bulb</code></td></tr><tr><td>Password</td><td><code>password</code></td><td><span class=\"tn-icon bx bx-key\"></span></td><td><code>key</code></td></tr><tr><td>Contact</td><td><code>contact</code></td><td><span class=\"tn-icon bx bx-user\"></span></td><td><code>user</code></td></tr><tr><td>Address</td><td><code>address</code></td><td><span class=\"tn-icon bx bx-home\"></span></td><td><code>home</code></td></tr><tr><td>Phone number</td><td><code>phone-number</code></td><td><span class=\"tn-icon bx bx-phone\"></span></td><td><code>phone</code></td></tr><tr><td>Web site to visit</td><td><code>web-site-to-visit</code></td><td><span class=\"tn-icon bx bx-globe\"></span></td><td><code>globe</code></td></tr><tr><td>Source for article</td><td><code>source-for-article</code></td><td><span class=\"tn-icon bx bx-news\"></span></td><td><code>news</code></td></tr><tr><td>Send in email</td><td><code>send-in-email</code></td><td><span class=\"tn-icon bx bx-envelope\"></span></td><td><code>envelope</code></td></tr><tr><td>Movie to see</td><td><code>movie-to-see</code></td><td><span class=\"tn-icon bx bx-movie\"></span></td><td><code>movie</code></td></tr><tr><td>Book to read</td><td><code>book-to-read</code></td><td><span class=\"tn-icon bx bx-book\"></span></td><td><code>book</code></td></tr><tr><td>Music to listen to</td><td><code>music-to-listen-to</code></td><td><span class=\"tn-icon bx bx-music\"></span></td><td><code>music</code></td></tr><tr><td>Project A</td><td><code>project-a</code></td><td>🅰️</td><td>🅰️</td></tr><tr><td>Project B</td><td><code>project-b</code></td><td>🅱️</td><td>🅱️</td></tr></tbody></table></figure><h3>Check box tags</h3><p>These become&nbsp;<a class=\"reference-link\" href=\"#root/_help_fASfBrYnquKU\">To-do Lists</a>, with the glyph inside the item with the tick state preserved:</p><figure class=\"table\"><table><thead><tr><th>OneNote tag</th><th><code>data-tag</code></th><th>Imported as</th><th>Searchable as</th></tr></thead><tbody><tr><td>To Do</td><td><code>to-do</code></td><td><em>(none)</em></td><td>—</td></tr><tr><td>To Do priority 1</td><td><code>to-do-priority-1</code></td><td>1️⃣</td><td>1️⃣</td></tr><tr><td>To Do priority 2</td><td><code>to-do-priority-2</code></td><td>2️⃣</td><td>2️⃣</td></tr><tr><td>Discuss with Person A</td><td><code>discuss-with-person-a</code></td><td><span class=\"tn-icon bx bx-message-rounded\"></span></td><td><code>message-rounded</code></td></tr><tr><td>Discuss with Person B</td><td><code>discuss-with-person-b</code></td><td><span class=\"tn-icon bx bx-message-rounded\"></span></td><td><code>message-rounded</code></td></tr><tr><td>Discuss with manager</td><td><code>discuss-with-manager</code></td><td><span class=\"tn-icon bx bx-conversation\"></span></td><td><code>conversation</code></td></tr><tr><td>Schedule meeting</td><td><code>schedule-meeting</code></td><td><span class=\"tn-icon bx bx-calendar\"></span></td><td><code>calendar</code></td></tr><tr><td>Call back</td><td><code>call-back</code></td><td><span class=\"tn-icon bx bx-phone-call\"></span></td><td><code>phone-call</code></td></tr><tr><td>Client request</td><td><code>client-request</code></td><td><span class=\"tn-icon bx bx-clipboard\"></span></td><td><code>clipboard</code></td></tr></tbody></table></figure>",
+ "_help_Y5mKeJ6dsCld": "<p>Trilium can import ZIP exports from Notion while preserving structure and formatting.</p><h2>Import process</h2><p>In Notion, there are two ways to export data:</p><ul><li>To export a single page (and optionally its sub-pages):<ul><li>Select the page to export.</li><li>Press the […] button at the top-right of the window and select <em>Export</em>.</li><li>Ensure the following options are set:<ul><li>Export format: HTML</li><li>Page content: Everything</li><li>Include subpages: On</li><li>Create folders for subpages: On</li></ul></li><li>Press the Export button.</li><li>Wait for the download to finish.</li></ul></li><li>To export an entire workspace, press your user name badge at top-left and select <em>Settings</em>.<ul><li>In the left section, look for the <em>Workspace</em> category and select <em>General</em>.</li><li>In the <em>General</em> settings page, look for the <em>Export</em> section and press the <em>Export</em> button corresponding to <em>Workspace content</em>.</li><li>Ensure the following options are set:<ul><li>Export format: HTML</li><li>Page content: Everything</li><li>Include subpages: On</li><li>Create folders for subpages: On</li></ul></li><li>Press the Export button.</li><li>Wait for the download to finish. Depending on the size of your workspace it might take a while. You will get a downloadable copy via email if takes too long.</li></ul></li></ul><p>In Trilium Notes:</p><ol><li>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, right click and select <em>Import into note</em> (<span class=\"tn-icon bx bx-import\"></span>).</li><li>In the <em>Import from</em> section, select&nbsp;<span class=\"tn-icon tn-brand tn-brand-notion\"></span> <em>Notion</em>.</li><li>Upload the ZIP obtained in the previous step.</li></ol><h2>Supported features</h2><p>The following features are preserved by Trilium during the import process:</p><ul><li>Basic formatting (bold, italic, underline, strikethrough, headings, colors, highlights).</li><li><a class=\"reference-link\" href=\"#root/_help_S6Xx8QIWTV66\">Lists</a></li><li>To-do lists</li><li><a class=\"reference-link\" href=\"#root/_help_mT0HEkOsz6i1\">Images</a>&nbsp;and&nbsp;<a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>.</li><li>Toggle sections<ul><li>Nested toggle sections are also supported.</li><li>Toggle headings are stripped of their toggle button and become normal headings instead.</li></ul></li><li><a class=\"reference-link\" href=\"#root/_help_YfYAtQBcfo5V\">Math Equations</a>&nbsp;(inline or block)</li><li><a class=\"reference-link\" href=\"#root/_help_UmgZAfcltxkS\">Link Previews</a><ul><li>The icon and image of the links need to be retrieved online since the exports don't carry the images. This operation is done only if <em>Download images automatically</em> is enabled in&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Media</em>.</li></ul></li><li><a class=\"reference-link\" href=\"#root/_help_QxEyIjRBizuC\">Code blocks</a>, with a best-effort attempt to restore the language.</li><li><a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a></li><li>Links between other imported pages are converted to&nbsp;<a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>&nbsp;if they are part of the same import.</li><li>Databases are imported as&nbsp;<a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>&nbsp;(see below).</li><li><a href=\"#root/_help_NwBbFdNZ9h7O\">Admonitions</a> are preserved, including its emoji (added as part of the content).</li><li>Columns are imported as transparent <a href=\"#root/_help_NdowYOC1GFKS\">tables</a>, preserving the column definition.</li><li>Table of content blocks are <em>removed</em>, as the table of contents is already present in the sidebar (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_BFvAtE74rbP6\">Table of contents</a>), as well as in shared notes.</li></ul><h2>Databases</h2><p>Notion databases are imported into&nbsp;<a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>, where each item of the database is saved as a page in the collection. Through the use of <a href=\"#root/_help_bwZpz2ajCEwO\">inherited</a>&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>, most of the page properties in Notion are preserved by the import.</p><p>The resulting collection will be&nbsp;<a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a>&nbsp;regardless of the original view the database was exported in. That's because the active view is not saved in the export and the table collection is the most compatible with Notion.</p><figure class=\"table\"><table><thead><tr><th scope=\"col\">Notion type</th><th scope=\"col\">Trilium</th></tr></thead><tbody><tr><td>Text / Select / Status / Place</td><td>Single-valued <code>text</code> label</td></tr><tr><td>Number</td><td>Single-valued <code>number</code> label for plain numbers. Formatted values (currency, percent, thousands separators) are normalized to a bare number, e.g. <code>$1,200.50</code> → <code>1200.50</code>.</td></tr><tr><td>ID</td><td>Single-valued <code>number</code> or <code>text</code> label (depending on whether a prefix is configured)</td></tr><tr><td>Multi-select</td><td>One text label per option (multi)</td></tr><tr><td>URL / Email / Phone</td><td><code>url</code> label (<code>mailto:</code>, <code>tel:</code> prefix)</td></tr><tr><td>Date</td><td><ul><li><code>datetime</code> if at least one has time.</li><li><code>date</code> if only dates.</li><li>Two attributes if any of the dates have an end date.</li></ul></td></tr><tr><td>Checkbox</td><td><code>boolean</code> label (<code>true</code>/<code>false</code>).</td></tr><tr><td>Person</td><td>One text label per user (multi)</td></tr><tr><td>Created by / Edited by</td><td>Single-valued <code>text</code> label</td></tr><tr><td>Created time / Last edited time</td><td>Assigned to the note's creation and modification date.</td></tr><tr><td>Relation</td><td>Mapped to <a href=\"#root/_help_Cq5X6iKQop6R\">relations</a>, each link resolved to its target note via the existing cross-page map; targets outside the import are dropped.</td></tr><tr><td>Files &amp; Media</td><td>The files are preserved as attachments, and a link to them is prepended to the content of the note for visibility.</td></tr><tr><td>Formulas / Rollup</td><td><p>A <code>text</code>, <code>number</code> or <code>boolean</code> label depending on the value. Dates are rendered as <code>text</code> because the export doesn't offer any type information.</p><p>The Notion export does not preserve the formula/rollup configuration itself, instead it just exports the value.</p></td></tr><tr><td>Button / Verification / any other type</td><td>Unsupported, they will be dropped from the import.</td></tr></tbody></table></figure><aside class=\"admonition note\"><p><strong>Technical information</strong></p><p>Every page property that can be preserved according to the table above is saved as a label or relation to the corresponding note (except for creation and modification dates which are saved at note level).</p><p>To maintain a similar UX to Notion, every property is also turned into&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>&nbsp;at collection level. This also makes the columns visible in the table collection. The promoted attributes are made inheritable so that they appear when navigating in the child notes as well.</p><p>The names of the labels are intentionally converted to <code>camelCase</code> to match Trilium's conventions, but the full name of the column is preserved through the <em>Alias</em> mechanism of promoted attributes.</p></aside><h2>Limitations</h2><h3>Missing data from the import</h3><p>The following information is not preserved by the import because it is not available in the export so it cannot be restored:</p><ul><li>The order of the pages and sub-pages.</li><li>Creation/modification dates are restored only when the page includes Created time / Last edited time properties (collection or not); otherwise the import time is used.</li></ul><h3>Cover images and page icon</h3><p>The page icon or emoji is not preserved, with created notes having the default icon. The cover image is not imported at all.</p><h2>Reporting issues</h2><p>When importing your Notion workspace, you might find issues in how a note is imported; in that case consider <a href=\"#root/_help_wy8So3yZZlH9\">reporting</a> it.</p><p>When reporting such an issue make sure to provide the following information:</p><ul><li>A .zip export of the original Notion note (and children if applicable). This allows us to reproduce the issue.</li><li>A screenshot with how it originally looked like before the import and how it looks after the import.</li></ul>",
+ "_help_nhQVuO4zvIxi": "<p>Trilium can import notes from Google Keep, preserving their structure and formatting.</p><h2>Import process</h2><p>Google Keep has no native export process, but Google Takeout allows you to download a ZIP of all the notes.</p><p>The first step is to download your Google Keep information:</p><ol><li>Navigate to <a href=\"https://takeout.google.com/\">takeout.google.com</a>.</li><li>In the <em>Create a new export</em> section, press <em>Deselect all.</em></li><li>In the list of data to export, check <em>Keep</em>.</li><li>Scroll all the way down and choose <em>Next step</em>.</li><li>In <em>Choose file type, frequency &amp; destination</em> make sure the following options are set:<ol><li><em>Transfer to</em> is set to <em>Send download link via email</em>.</li><li><em>Frequency</em> is set to <em>Export once</em>.</li><li><em>File type</em> is set to <em>.zip</em>.</li><li><em>File size</em> can remain set to <em>2 GB</em>.</li></ol></li><li>Press <em>Create export</em> and wait for the export to finish.</li></ol><p>Then in Trilium Notes:</p><ol><li>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, right click and select <em>Import into note</em>.</li><li>In the <em>Import from</em> section, select&nbsp;<span class=\"tn-icon tn-brand tn-brand-google-keep\"></span> <em>Google Keep</em>.</li><li>Upload the ZIP obtained in the previous step.</li></ol><h2>Supported features</h2><ul><li>Basic formatting (bold, italic, underline)</li><li><a href=\"#root/_help_p9kXRFAkwN4o\">Note color</a></li><li>Note titles are maintained, if present.<ul><li>In Google Keep it's common for notes not to have a title, case in which the date and time of the note are used as a title.</li></ul></li><li>To-do lists</li><li><a class=\"reference-link\" href=\"#root/_help_mT0HEkOsz6i1\">Images</a>&nbsp;and&nbsp;<a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>.</li><li>Creation and modification dates are preserved.</li></ul><h2>Limitations</h2><p>Currently the following information is not imported:</p><ul><li>Labels are disregarded.</li><li>Pinned, archived or trashed state is not preserved, all notes are treated the same.</li></ul><h2>Reporting issues</h2><p>When importing your notes from Google Keep, you might encounter some issues with how the notes are imported, or there might be some missing information. In this case, consider <a href=\"#root/_help_wy8So3yZZlH9\">reporting it</a>.</p><p>When reporting such an issue make sure to provide the following information:</p><ul><li>A sample of the note is required to better understand what happened.<ul><li>Because Google Keep has no per-note export, extract the Google Takeout ZIP and copy the files corresponding to the problematic note (<code>.html</code>, <code>.json</code> and any attachments if you are able to identify them).</li></ul></li><li>A screenshot with how it originally looked like before the import and how it looks after the import.</li></ul>",
+ "_help_syuSEKf2rUGr": "<p>Trilium can import ENEX files, which are used by Evernote for backup/export. One ENEX file represents the content (notes and resources) of one notebook.</p><h2>Import process</h2><p>The first step is to export the data from Evernote:</p><ul><li>To export a single notebook:<ul><li>In the left sidebar, select <em>Notebooks</em>.</li><li>If you have a notebook stack, expand it.</li><li>Right click on a notebook and select <em>Export notebook</em>.</li><li>Make sure the following options are set:<ul><li>File format is set to <em>ENEX format</em>.</li><li>All the options in <em>Export note attributes</em> are checked.</li></ul></li></ul></li><li>To export a bunch of notes (up to 100 notes):<ul><li>In the left sidebar, select <em>Notes</em>.</li><li>In the list of notes, <kbd>Ctrl</kbd>-click individual notes to select them. Alternatively, click on a note and then <kbd>Shift</kbd>-click a more distant note to select all the notes in between.</li><li>At the bottom there should be a floating bar with some options. Select […] → <em>Export.</em></li><li>Make sure the following options are set:<ul><li>File format is set to <em>ENEX format</em>.</li><li>All the options in <em>Export note attributes</em> are checked.</li></ul></li></ul></li><li>To export a single note:<ul><li>Select the note.</li><li>In the top-right, press the […] button and select <em>Export</em>.</li><li>Make sure the following options are set:<ul><li>File format is set to <em>ENEX format</em>.</li><li>All the options in <em>Export note attributes</em> are checked.</li></ul></li></ul></li></ul><aside class=\"admonition tip\"><p>To export multiple notebooks in bulk, consider using a third-party CLI tool called <a href=\"https://github.com/vzhd1701/evernote-backup\">evernote-backup</a></p></aside><p>Once you have your ENEX files, do the following to import them in Trilium:</p><ol><li>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, right click and select <em>Import into note</em>.</li><li>In the <em>Import from</em> section, select&nbsp;<span class=\"tn-icon tn-brand tn-brand-evernote\"></span> <em>Evernote</em>.</li><li>During the import, you will see \"Import in progress\" message. If the import is successful, the message will change to “Import finished successfully” and then disappear.</li><li>We recommend you to check the imported notes and their attachments to verify that you haven’t lost any data.</li></ol><h2>Supported features</h2><p>The following features are preserved by Trilium during the import process:</p><ul><li>Basic formatting (bold, italic, underline, strikethrough, colors, highlights, superscript, subscript, text alignment, inline code).</li><li>The hierarchy of headings (these are shifted to start with H2 because H1 is reserved for note title, see&nbsp;<a href=\"#root/_help_Gr6xFaF6ioJ5\">Headings</a>)</li><li>To-do lists. The new task format is collapsed to standard to-do lists</li><li><a class=\"reference-link\" href=\"#root/_help_mT0HEkOsz6i1\">Images</a>&nbsp;and&nbsp;<a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a></li><li><a class=\"reference-link\" href=\"#root/_help_S6Xx8QIWTV66\">Lists</a>&nbsp;(with bullets or with numbers)</li><li><a class=\"reference-link\" href=\"#root/_help_NdowYOC1GFKS\">Tables</a></li><li>Block quotes</li><li><a href=\"#root/_help_NwBbFdNZ9h7O\">Admonitions</a> are preserved, including its emoji (added as part of the content).</li><li><a class=\"reference-link\" href=\"#root/_help_QxEyIjRBizuC\">Code blocks</a>, with a best-effort attempt to restore the language.</li><li><a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a></li><li><a class=\"reference-link\" href=\"#root/_help_YfYAtQBcfo5V\">Math Equations</a></li><li>Toggle sections</li><li>External links</li><li>Internal links are re-written to&nbsp;<a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>&nbsp;if the target note is part of the same import.</li></ul><h2>Limitations</h2><ul><li>The size limit of one import is 250Mb. If the total size of your files is larger, you can increase the&nbsp;<a href=\"#root/_help_WOcw2SLH6tbX\">upload limit</a>, or divide your files, and run the import as many times as necessary.</li><li>All resources (except for images) are created as notes’ attachments.</li><li>If you have HTML inside ENEX files, the HTML formatting may be broken or lost after import in Trilium. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_wy8So3yZZlH9\">Reporting issues</a>.</li></ul><h3>Links to other notes</h3><p>Since v0.104.0, the ENEX importer tries to recreate links to other notes automatically by converting their Evernote-specific URLs to Trilium's&nbsp;<a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>.</p><p>Since the ENEX format does not provide the unique ID of notes, the note references are determined via their note title.</p><p>Limitations:</p><ul><li>Only notes that are part of the same import will have their links rewritten to reference links, to avoid linking to the wrong note.</li><li>If there are to notes with the same name, internal links will not be created to avoid pointing to the wrong note.</li><li>Links that couldn't be rewritten (e.g. referring to a missing/duplicate note) will be kept with their original <code>evernote://</code> URL.</li><li>It will not fix links to anchors and links to notes that you renamed in Evernote after you created the links.</li></ul><h4>Post-processing notes</h4><aside class=\"admonition tip\"><p>This script allows rewriting links after the import has been done, and it should also allow finding links between two different imports.</p></aside><p>If you want to restore the internal links in Trilium after you import all of your ENEX files, you can use or adapt this custom script:&nbsp;<a class=\"reference-link\" href=\"#root/_help_dj3j8dG4th4l\">Process internal links by title</a></p><p>The script does the following:</p><ol><li>It finds all Evernote internal links.</li><li>For each one, it checks if its link text matches a note title, and if yes, it replaces the Evernote link with an internal Trilium link. If not, it leaves the Evernote link in place.</li><li>If it finds more than one note with a matching note title, it leaves the Evernote link in place.</li><li>It outputs the results in a log that you can see in the respective code note in Trilium.</li></ol><p>The script has the following limitations:</p><ul><li>It will not fix links to anchors and links to notes that you renamed in Evernote after you created the links.</li><li>Some note titles might not be well identified, even if they exist. This is especially the case if the note title contains some special characters. Should this be problematic, consider&nbsp;<a class=\"reference-link\" href=\"#root/_help_wy8So3yZZlH9\">Reporting issues</a>.</li></ul><h2>Reporting issues</h2><p>When importing your Evernote notebooks, you might find issues in how a note is imported; in that case consider <a href=\"#root/_help_wy8So3yZZlH9\">reporting</a> it.</p><p>When reporting such an issue make sure to provide the following information:</p><ul><li>A <code>.enex</code> export of the original note. This allows us to reproduce the issue.</li><li>A screenshot with how it originally looked like before the import and how it looks after the import.</li></ul>",
+ "_help_dj3j8dG4th4l": "const query = `note.type = \"text\" and note.content *=* \"evernote:///view/\"`;\nconst notes = api.searchForNotes(query);\n\nfor (const note of notes) {\n api.log(`Processing note ${note.title}...`);\n \n const content = note.getContent();\n const root = api.htmlParser.parse(content);\n \n for (const el of root.querySelectorAll(\"a\")) {\n const url = el.getAttribute(\"href\");\n if (!url?.startsWith(\"evernote:///\")) continue;\n\n const text = el.textContent;\n const matchingNotes = api.searchForNotes(`note.title = \"${text}\"`);\n if (matchingNotes.length === 0) {\n api.log(`No matching notes for \"${text}...\"`);\n continue;\n }\n\n if (matchingNotes.length > 1) {\n api.log(`Found multiple matching notes for \"${text}\". Skipping.`);\n continue;\n }\n\n const matchingNote = matchingNotes[0];\n \n api.log(`Found matching note: ${matchingNote.title} ${matchingNote.noteId}`);\n el.setAttribute(\"href\", `#root/${matchingNote.noteId}`);\n el.classList.add(\"reference-link\");\n }\n note.setContent(root.toString()); \n}\n",
+ "_help_83zmPBJRgfnW": "<p>Starting with v0.104.0, Trilium is able to import data from Anytype from JSON imports which preserve most of the formatting and the metainformation.</p><h2>Import process</h2><p>The first step is to export the data from Anytype:</p><ul><li>To export a single page:<ul><li>Select the page to export.</li><li>Press the […] at the top-right of the window and select <em>Export</em>.</li><li>Ensure the following options are set:<ul><li>Export format: Any-Block</li><li>File Format: JSON</li><li>Zip archive: On</li><li>Include linked objects: On</li><li>Include files: On</li><li>Include archived objects: On</li></ul></li></ul></li><li>To export an entire channel:<ul><li>Select the desired channel from the left bar.</li><li>Underneath the channel icon in the left sidebar, press the name of the channel with an arrow and select <em>Channel Settings</em>.</li><li>In the left sidebar, look for the <em>Integrations</em> section and select <em>Export</em>.</li><li>Press <em>Any-Block</em>.</li><li>Ensure the following options are set:<ul><li>File Format: JSON</li><li>Zip archive: On</li><li>Include files: On</li><li>Include archived objects: On</li></ul></li></ul></li></ul><p>In Trilium Notes:</p><ol><li>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, right click and select <em>Import into note</em>.</li><li>In the <em>Import from</em> section, select&nbsp;<span class=\"tn-icon tn-brand tn-brand-anytype\"></span> <em>Anytype</em>.</li><li>Upload the ZIP.</li></ol><aside class=\"admonition note\"><p>Exporting collections individually can sometimes miss information that would otherwise be picked up from an export of the entire channel. The reason is that Anytype leaves out some information when exporting individual pages/collections.</p></aside><h2>Supported features</h2><p>The following features are preserved by Trilium during the import process:</p><ul><li>Basic formatting (bold, italic, underline, strikethrough, headings, colors, highlights, inline code).</li><li><a class=\"reference-link\" href=\"#root/_help_S6Xx8QIWTV66\">Lists</a>&nbsp;(numbered or bullet)</li><li><a class=\"reference-link\" href=\"#root/_help_mT0HEkOsz6i1\">Images</a>&nbsp;and files are handled as&nbsp;<a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>.</li><li>To-do lists</li><li>Toggle sections</li><li><a class=\"reference-link\" href=\"#root/_help_NdowYOC1GFKS\">Tables</a></li><li>Inline&nbsp;<a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a></li><li><a class=\"reference-link\" href=\"#root/_help_YfYAtQBcfo5V\">Math Equations</a></li><li>Highlight blocks are imported as block quotes.</li><li><a class=\"reference-link\" href=\"#root/_help_QxEyIjRBizuC\">Code blocks</a>, with a best-effort attempt to restore the language.</li><li>Links between other imported pages are converted to&nbsp;<a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>&nbsp;if they are part of the same import.<ul><li>Applies to both block links and inline links.</li></ul></li><li>Collections are imported as&nbsp;Trilium-native&nbsp;<a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>&nbsp;(see below).<ul><li>Files inside collections are imported as&nbsp;<a class=\"reference-link\" href=\"#root/_help_W8vYD3Q1zjCR\">File</a>&nbsp;notes.</li></ul></li><li>Dividers (line, dots) are imported as horizontal rules.</li><li><a href=\"#root/_help_NwBbFdNZ9h7O\">Admonitions</a> are preserved, including its emoji (added as part of the content).</li><li>Creation and modification date of pages is preserved.</li></ul><h2>Collections</h2><p>Collections created in Anytype are imported on a best-effort basis, preserving both the view mode and the page properties as&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>.</p><p>The following view modes are supported:</p><ul><li>List as&nbsp;<a class=\"reference-link\" href=\"#root/_help_mULW0Q3VojwY\">List View</a></li><li>Gallery as&nbsp;<a class=\"reference-link\" href=\"#root/_help_8QqnMzx393bx\">Grid View</a></li><li><a class=\"reference-link\" href=\"#root/_help_xWbu3jpNWapp\">Calendar</a>, preserving the attribute which identifies the date.</li><li><a class=\"reference-link\" href=\"#root/_help_CtBQqbwXDx1w\">Kanban Board</a>, preserving the board group column.</li><li><a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a>, also used as fallback for unsupported collection layouts.</li></ul><p>The following types are supported:</p><figure class=\"table\"><table><thead><tr><th scope=\"col\">Anytype property type</th><th scope=\"col\">Trilium</th></tr></thead><tbody><tr><td>Text / Select</td><td>Single-valued <code>text</code> label</td></tr><tr><td>Number</td><td>Single-valued <code>number</code> label</td></tr><tr><td>Multi-select</td><td>One <code>text</code> label per option (multi)</td></tr><tr><td>Date / Date with time</td><td><ul><li><code>datetime</code> if the time is included.</li><li><code>date</code> if only dates.</li></ul></td></tr><tr><td>File</td><td>The files are preserved as attachments, and a link to them is prepended to the content of the note for visibility.</td></tr><tr><td>Checkbox</td><td><code>boolean</code> label (<code>true</code>/<code>false</code>).</td></tr><tr><td>URL / Email / Phone</td><td><code>url</code> label (<code>mailto:</code>, <code>tel:</code> prefix)</td></tr></tbody></table></figure><h2>Reporting issues</h2><p>When importing your Anytype notes, you might find issues in how a note is imported; in that case consider <a href=\"#root/_help_wy8So3yZZlH9\">reporting</a> it.</p><p>When reporting such an issue make sure to provide the following information:</p><ul><li>A .zip export of the original note (and children if applicable). This allows us to reproduce the issue.</li><li>A screenshot with how it originally looked like before the import and how it looks after the import.</li></ul>",
+ "_help_iWD7wiIuMtgV": "<p>Although Obsidian was indirectly supported through the standard&nbsp;<a class=\"reference-link\" href=\"#root/_help_Oau6X9rCuegd\">Markdown</a>&nbsp;import, its vault structure is distinct enough to warrant its own dedicated import channel.</p><h2>Import process</h2><p>The first step is to obtain a .zip of your Obsidian vault:</p><ol><li>First, identify where your Obsidian vault is located. The easiest way to do so is to open Obsidian and right clicking the name of the vault at the bottom of the left sidebar and then selecting <em>Show in system explorer</em>.</li><li>In your system explorer, right click the directory containing your Obsidian vault and compress it to a ZIP file (e.g. on Windows, <em>Compress To</em> → <em>ZIP</em>).</li></ol><aside class=\"admonition tip\"><p>When zipping, you can either ZIP the outer folder of the vault, or the contents of the vault as Trilium will automatically determine the position of the vault in the archive via the <code>.obsidian</code> directory.</p></aside><p>Then, in Trilium Notes:</p><ol><li>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, right click and select <em>Import into note</em>.</li><li>In the <em>Import from</em> section, select&nbsp;<span class=\"tn-icon tn-brand tn-brand-obsidian\"></span> <em>Obsidian</em>.</li><li>Upload the ZIP obtained in the previous step.</li></ol><p>Alternatively, simply drag &amp; drop the .zip archive in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;and Trilium will auto-detect it as an Obsidian import provided there is a <code>.obsidian</code> directory. If not, follow the previous steps instead.</p><h2>Supported features</h2><p>The following features are preserved by Trilium during the import process:</p><ul><li>Folder hierarchy is preserved.</li><li>Basic Markdown formatting (bold, italic, underline, strikethrough, headings).</li><li>Specific Obsidian formatting (highlighting).</li><li><a class=\"reference-link\" href=\"#root/_help_S6Xx8QIWTV66\">Lists</a></li><li>To-do lists</li><li><a class=\"reference-link\" href=\"#root/_help_mT0HEkOsz6i1\">Images</a>&nbsp;and&nbsp;<a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a><ul><li>Non-Markdown files in the Vault are treated as attachments by default if they are referenced by at least one note.</li><li>Otherwise, they will be imported as&nbsp;<a class=\"reference-link\" href=\"#root/_help_W8vYD3Q1zjCR\">File</a>&nbsp;notes.</li></ul></li><li>Transclusions are converted to&nbsp;<a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>&nbsp;or&nbsp;<a class=\"reference-link\" href=\"#root/_help_mT0HEkOsz6i1\">Images</a>&nbsp;(depending on type).</li><li><a class=\"reference-link\" href=\"#root/_help_YfYAtQBcfo5V\">Math Equations</a>&nbsp;(inline or block)</li><li><a class=\"reference-link\" href=\"#root/_help_QxEyIjRBizuC\">Code blocks</a>, with a best-effort attempt to restore the language.</li><li>Links between pages are converted to&nbsp;<a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>.</li><li>Callouts are converted to Trilium's <a href=\"#root/_help_NwBbFdNZ9h7O\">Admonitions</a>.<ul><li>Obsidian has many more types of callouts (<code>tldr</code>, <code>question</code>, <code>attention</code>), these are all mapped to one of Trilium's existing admonition types (e.g. Note, Tip, Important).</li><li>Custom titles are kept and shown as a bold line at the top of the admonition, since there is no concept of admonition title in Trilium.</li><li>Foldable callouts are imported expanded and without a fold marker.</li></ul></li><li>Notes created by the <a href=\"https://github.com/zsviczian/obsidian-excalidraw-plugin\"><em>Excalidraw</em></a> community plugin for Obsidian are converted to&nbsp;<a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a>&nbsp;(same underlying technology).<ul><li>Note that custom features introduced by that plugin will not be supported.</li></ul></li><li>Modification date is preserved via the information obtained from the .zip archive, creation date is not recoverable so it's kept the same as the modification date.</li></ul><h2>Properties</h2><p>Properties are Obsidian's equivalent of&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>. One of the core differences between the two is where the property information is stored (i.e. name and type): in Obsidian everything is stored at vault level and shared across all notes, whereas in Trilium each page can have individual promoted attributes, shared through&nbsp;<a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>&nbsp;or&nbsp;<a class=\"reference-link\" href=\"#root/_help_bwZpz2ajCEwO\">Attribute Inheritance</a>.</p><p>Another important difference is that promoted attributes in Trilium are always displayed, even if empty. In Obsidian, these are simply suggested when creating a new property.</p><p>To reconcile all these differences, properties are converted to&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>&nbsp;at note level.</p><p>The following note types are supported:</p><figure class=\"table\"><table><thead><tr><th>Obsidian type</th><th>Trilium</th></tr></thead><tbody><tr><td>Text or not defined</td><td>Single-valued <code>text</code> label</td></tr><tr><td>Number</td><td>Single-valued <code>number</code> label</td></tr><tr><td>Multitext</td><td>Multi-valued <code>text</code> label</td></tr><tr><td>Checkbox</td><td><code>boolean</code> label (<code>true</code>/<code>false</code>).</td></tr><tr><td>Date</td><td><code>date</code></td></tr><tr><td>Date &amp; Time</td><td><code>datetime</code></td></tr></tbody></table></figure><h3>Special properties</h3><p>Obsidian has a few reserved property names, which are treated differently in Trilium as well:</p><ul><li><code>tags</code>, where every tag is turned into its own <a href=\"#root/_help_HI6GBBIduIgv\">label</a> (e.g. <code>#one</code>, <code>#two</code> when <code>tags: [ one, two ]</code>).</li><li><code>aliases</code> are simply mapped to individual <code>#alias</code> labels</li><li><code>cssclasses</code>, <code>publish</code>, <code>permalink</code> are ignored.</li></ul><h2>Limitations</h2><ul><li>Comments (<code>%%</code> syntax) are simply stripped.</li><li>Obsidian <em>bases</em> functionality is not preserved.<ul><li>The closest equivalent in Trilium would be&nbsp;<a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>&nbsp;but they work fundamentally different because bases don't store particular notes, they act more like a&nbsp;<a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a>&nbsp;with a collection view.</li><li>Since the base query format is quite different to Trilium's&nbsp;<a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>&nbsp;syntax, it's unlikely they'll ever be supported.</li><li>When a base is encountered, it is simply ignored from the import.</li></ul></li><li>Canvases are not imported.<ul><li>Theoretically they could map to either&nbsp;<a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a>&nbsp;or&nbsp;<a class=\"reference-link\" href=\"#root/_help_iRwzGnHPzonm\">Relation Map</a>&nbsp;but they are too different to reconcile.</li></ul></li><li>Links<ul><li>Links to a specific heading in another note will still point to the right note, but the heading anchor will be dropped.</li><li>Dangling links (pointing to a note that doesn't exist) and ambiguous links (same base name in 2+ notes) are unwrapped to plain text.</li></ul></li></ul>",
+ "_help_rC3pL2aptaRE": "<p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/2_Zen%20mode_image.png\"></p><p>Screenshot of Zen Mode activated on a Windows 11 system with native title bar off and background effects on.</p><p>When Zen Mode is activated (pictured on the side), most of the user interface of Trilium is hidden away in order to be able to focus on the content, whether it's for reading or writing.</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/1_Zen%20mode_image.png\"></p><p>Screenshot of the Zen Mode option in the global menu.</p><h2>Activating &amp; deactivating</h2><p>The Zen Mode can be activated by accessing the global menu and selecting the “Zen Mode” option:</p><p>Aside from the global menu, it's also possible to activate this mode by using a keyboard shortcut (which is <kbd>F9</kbd> since TriliumNext 0.92.5 and <kbd>Alt</kbd>+<kbd>Z</kbd> for older versions). Look for <code>toggleZenMode</code> in the shortcut configuration.</p><p>Once Zen Mode is activated, all the UI elements of the application will be hidden away, including the global menu. In that case, the Zen Mode can be deactivated either by pressing the&nbsp;<span class=\"tn-icon bx bxs-yin-yang\"></span> icon in the top-right corner of the window or by pressing the keyboard combination again.</p><p>Do note that, by design, activating or deactivating the Zen Mode applies only to the current window. Restarting the application will also disable the Zen Mode.</p><h2>Moving the window around</h2><p>If “Native title bar” is activated, then the operating system's default title bar can be used to drag the window around. If deactivated, the window can still be moved by dragging the mouse across the top part of the window where the note titles are.</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Zen%20mode_image.png\"></p><p>Screenshot of two notes side-by-side while Zen Mode is active, on Windows 11 with background effects off.</p><h2>Split windows and tabs</h2><p>Tabs are completely hidden, however it's still possible to use keyboard shortcuts such as <code>firstTab</code> (<kbd>Ctrl</kbd>+<kbd>1</kbd> by default), <code>secondTab</code> (<kbd>Ctrl</kbd>+<kbd>2</kbd> by default). There are also some newer shortcuts such as <code>activateNextTab</code> (<kbd>Ctrl</kbd>+<kbd>Tab</kbd>) or <code>activatePreviousTab</code> (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Tab</kbd>) that allow easy navigation, however make sure that they are configured properly in the settings.</p><p>For the split view of notes, there are no keyboard shortcuts at the time of writing, but it's still possible to have them in Zen Mode by creating the split while the Zen Mode is off and then reactivating it afterwards.</p>",
+ "_help_YzMcWlCVeW09": "<p><em>Active content</em> is a generic name for powerful features in Trilium, these range from customizing the UI to advanced scripting that can alter your notes or even your PC.</p><h2>Safe import</h2><p>Active content problem of safety, especially when this active content comes from a third-party such as if it is downloaded from a website and then imported into Trilium.</p><p>When <a href=\"#root/_help_mHbBMPDPkVV5\">importing</a> .zip archives into Trilium, <em>safe mode</em> is active by default which will try to prevent untrusted code from executing. For example, a <a href=\"#root/_help_MgibgPcfeuGz\">custom widget</a> needs the <code>#widget</code> <a href=\"#root/_help_HI6GBBIduIgv\">label</a> in order to function; safe import works by renaming that label to <code>#disabled:widget</code>.</p><h2>Safe mode</h2><p>Sometimes active content can cause issues with the UI or the server, preventing it from functioning properly.&nbsp;<a class=\"reference-link\" href=\"#root/_help_64ZTlUPgEPtW\">Safe mode</a>&nbsp;allows starting Trilium in such a way that active content is not loaded by default at start-up, allowing the user to fix the problematic scripts or widgets.</p><h2>Types of active content</h2><p>These are the types of active content in Trilium, along with a few examples of what untrusted content of that type could cause:</p><figure class=\"table\"><table><thead><tr><th>Name</th><th>Disabled on a safe <a href=\"#root/_help_mHbBMPDPkVV5\">import</a></th><th>Description</th><th>Potential risks of untrusted code</th></tr></thead><tbody><tr><td><a href=\"#root/_help_yIhgI5H7A2Sm\">Front-end scripts</a></td><td>Yes</td><td>Allow running arbitrary code on the client (UI) of Trilium, which can alter the user interface.</td><td>A malicious script can execute server-side code, access un-encrypted notes or change their contents.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_MgibgPcfeuGz\">Custom Widgets</a></td><td>Yes</td><td>Can add new UI features to Trilium, for example by adding a new section in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>.</td><td>The UI can be altered in such a way that it can be used to extract sensitive information or it can simply cause the application to crash.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_SPirpZypehBG\">Backend scripts</a></td><td>Yes</td><td>Can run custom code on the server of Trilium (Node.js environment), with full access to the notes and the database.</td><td>Has access to all the unencrypted notes, but with full access to the database it can completely destroy the data. It also has access to execute other applications or alter the files and folders on the server).</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_1vHRoWCEjj0L\">Web View</a></td><td>Yes</td><td>Displays a website inside a note.</td><td>Can point to a phishing website which can collect the data (for example on a log in page).</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a></td><td>Yes</td><td>Renders custom content inside a note, such as a dashboard or a new editor that is not officially supported by Trilium.</td><td>Can affect the UI similar to front-end scripts or custom widgets since the scripts are not completely encapsulated, or they can act similar to a web view where they can collect data entered by the user.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_AlhDUqhENtH7\">Custom app-wide CSS</a></td><td>No</td><td>Can alter the layout and style of the UI using CSS, applied regardless of theme.</td><td>Generally less problematic than the rest of active content, but a badly written CSS can affect the layout of the application, requiring the use of&nbsp;<a class=\"reference-link\" href=\"#root/_help_64ZTlUPgEPtW\">Safe mode</a>&nbsp;to be able to use the application.</td></tr><tr><td><a href=\"#root/_help_pKK96zzmvBGf\">Custom themes</a></td><td>No</td><td>Can change the style of the entire UI.</td><td>Similar to custom app-wide CSS.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_gOKqSJgXLcIj\">Icon Packs</a></td><td>No</td><td>Introduces new icons that can be used for notes.</td><td>Generally are more contained and less prone to cause issues, but they can cause performance issues (for example if the icon pack has millions of icons in it).</td></tr></tbody></table></figure><h2>Active content badge</h2><p>If a note is considered to have active content, a badge is shown in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_B5dihXRDksTk\">Note badges</a>&nbsp;area. Clicking the badge will reveal a menu with various options related to that content type, for example to open the documentation or to configure the execution of scripts.</p><p>For some active content types, such as backend scripts with custom triggering conditions a toggle button will appear. This makes it possible to easily disable scripts or widgets, but also to re-enable them if an import was made with safe mode active.</p>",
+ "_help_s3YCWHBfmYuM": "<h2>Choose the setup</h2><p><strong>Local only desktop/laptop</strong> - Allows a single instance on a desktop and will save the notes locally on that desktop.</p><ul><li><a class=\"reference-link\" href=\"#root/_help_poXkQfguuA0U\">Desktop Installation</a></li></ul><p><strong>Server with web only access</strong> - Installs the application on the server and allows access from any web browser on any device, including mobile.</p><ol><li><a class=\"reference-link\" href=\"#root/_help_WOcw2SLH6tbX\">Server Installation</a></li><li><a class=\"reference-link\" href=\"#root/_help_RDslemsQ6gCp\">Mobile Frontend</a>&nbsp;(optional)</li><li><a class=\"reference-link\" href=\"#root/_help_yeEaYqosGLSh\">Third-party cloud hosting</a></li></ol><p><strong>Combination of server and desktop/laptop</strong> - Install the application on both a server, for web access and data synchronisation, and desktop instance(s). This allows all the data to be stored on the server and either accessed from the web browser, or the desktop application. The desktop application will sync and store the data locally so that it can be used when offline.</p><ol><li><a class=\"reference-link\" href=\"#root/_help_WOcw2SLH6tbX\">Server Installation</a></li><li><a class=\"reference-link\" href=\"#root/_help_RDslemsQ6gCp\">Mobile Frontend</a>&nbsp;(optional)</li><li><a class=\"reference-link\" href=\"#root/_help_poXkQfguuA0U\">Desktop Installation</a></li><li><a class=\"reference-link\" href=\"#root/_help_cbkrhQjrkKrh\">Synchronization</a></li></ol>",
+ "_help_i6dbnitykE5D": "<h2>Inspiration for the name “Trilium”</h2><blockquote><p>Naming software is hard. I lived in Ontario when I first started the project and Trillium (the flower) is sort of a provincial logo, many institutions in Ontario are named \"Trillium [something]\". So I kept hearing/reading it almost everyday, I liked the sound of it and its nature motif, so I just reused it.</p><p><em>– Zadam (original Trilium maintainer)</em></p></blockquote><aside class=\"admonition note\"><p>Despite the fact that the Trillium flower has two “l\"s, the Trilium application only has one.</p></aside><h2>How do I create a folder?</h2><p>Trilium has no separate folder type: any note can have child notes, so any note can act as a folder. A note can hold its own content and have children at the same time, unlike a file system, which separates files from directories.</p><p>To organize notes into a folder:</p><ol><li>Create a note that acts as the folder, for example \"Projects\".</li><li>Right-click it in the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> and select <em>Insert child note</em>, or hover over it and press the <span class=\"tn-icon bx bx-plus\"></span> button.</li><li>To move existing notes into it, drag them onto it in the tree.</li></ol><p>The children of a note are listed at the end of its content (see <a class=\"reference-link\" href=\"#root/_help_0ESUbbAxVnoK\">Note List</a>).</p><p>If you want the note to look like a folder, with no content of its own and only its children shown, make it a collection instead: right-click in the tree, select <em>Insert child note</em> → <em>Collection</em>, then choose <a class=\"reference-link\" href=\"#root/_help_8QqnMzx393bx\">Grid View</a> or <a class=\"reference-link\" href=\"#root/_help_mULW0Q3VojwY\">List View</a>. See <a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a> for the other views, such as tables, boards and calendars.</p><h2>macOS support</h2><p>Originally, Trilium Notes considered the macOS build unsupported. TriliumNext commits to make the experience on macOS as good as possible.</p><p>if you find any platform-specific issues, feel free to <a href=\"#root/_help_wy8So3yZZlH9\">report them</a>.</p><h2>Translation / localisation support</h2><p>The original Trilium Notes application did not support multiple languages. Since we believe that internationalisation is a core part of an application, we have added support for it.</p><p>Contributions to translations are welcome.</p><h2>Multi-user support</h2><p>Common request is to allow multiple users collaborate, share notes etc. So far I'm resisting this because of these reasons:</p><ul><li>it's a huge feature, or rather a Pandora's box of collaboration features like user management, permissions, conflict resolution, real-time editing of a note by multiple people etc. This would be a huge amount of work. Trilium Notes is project made mostly by one person in free time and that's unlikely to change in the future.</li><li>given its size it would probably pivot the attention away from my main focus which is a personal note-taking</li><li>the assumption that only single person has access to the app simplifies many things, or just outright makes them possible. In multi-user app, our <a href=\"#root/_help_CdNpE2pqjmI6\">scripting</a>support would be a XSS security hole, while with the single user assumption it's an endless customizable tool.</li></ul><h2>How to open multiple documents in one Trilium instance</h2><p>This is normally not supported - one Trilium process can open only a single instance of a <a href=\"#root/_help_wX4HbRucYSDD\">database</a>. However, you can run two Trilium processes (from one installation), each connected to a separate document. To achieve this, you need to set a location for the <a href=\"#root/_help_tAassRL4RSQL\">data directory</a> in the <code>TRILIUM_DATA_DIR</code> environment variable and separate port on <code>TRILIUM_PORT</code> environment variable. How to do that depends on the platform, in Unix-based systems you can achieve that by running command such as this:</p><pre><code class=\"language-text-x-sh\">TRILIUM_DATA_DIR=/home/me/path/to/data/dir TRILIUM_PORT=12345 trilium </code></pre><p>You can save this command into a <code>.sh</code> script file or make an alias. Do this similarly for a second instance with different data directory and port.</p><h2>Can I use Dropbox / Google Drive / OneDrive to sync data across multiple computers.</h2><p>No.</p><p>These general purpose sync apps are not suitable to sync database files which are open and being worked on by another application. The result is that they will corrupt the database file, resulting in data loss and this message in the Trilium logs:</p><pre><code class=\"language-text-x-trilium-auto\">SqliteError: database disk image is malformed</code></pre><p>The only supported way to sync Trilium's data across the network is to use a <a href=\"#root/_help_cbkrhQjrkKrh\">sync/web server</a>.</p><h2>Why database instead of flat files?</h2><p>Trilium stores notes in a <a href=\"#root/_help_wX4HbRucYSDD\">database</a> which is an SQLite database. People often ask why doesn't Trilium rather use flat files for note storage - it's fair question since flat files are easily interoperable, work with SCM/git etc.</p><p>Short answer is that file systems are simply not powerful enough for what we want to achieve with Trilium. Using filesystem would mean fewer features with probably more problems.</p><p>More detailed answer:</p><ul><li><a href=\"#root/_help_IakOLONlIfGI\">clones</a> are what you might call \"hard directory link\" in filesystem lingo, but this concept is not implemented in any filesystem</li><li>filesystems make a distinction between directory and file while there's intentionally no such difference in Trilium</li><li>files are stored in no particular order and user can't change this</li><li>Trilium allows storing note <a href=\"#root/_help_zEY4DaJG4YT5\">attributes</a> which could be represented in extended user attributes but their support differs greatly among different filesystems / operating systems</li><li>Trilium makes links / relations between different notes which can be quickly retrieved / navigated (e.g. for <a href=\"#root/_help_BCkXAVs63Ttv\">note map</a>). There's no such support in file systems which means these would have to be stored in some kind of side-car files (mini-databases).</li><li>Filesystems are generally not transactional. While this is not completely required for a note-taking application, having transactions make it way easier to keep notes and their metadata in predictable and consistent state.</li></ul><h2>Search-related Questions</h2><h3>Why does search sometimes find results with typos?</h3><p>Trilium uses a progressive search strategy that includes fuzzy matching when exact matches return fewer than 5 results. This finds notes despite minor typos in your search query. You can use fuzzy search operators (<code>~=</code> for fuzzy exact match and <code>~*</code> for fuzzy contains). See the&nbsp;<a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>&nbsp;documentation for details.</p><h3>How can I search for notes when I'm not sure of the exact spelling?</h3><p>Use the fuzzy search operators:</p><ul><li><code>#title ~= \"projct\"</code> - finds notes with titles like \"project\" despite the typo</li><li><code>note.content ~* \"algoritm\"</code> - finds content containing \"algorithm\" or similar words</li></ul><h3>Why do some search results appear before others with lower scores?</h3><p>Trilium places exact matches before fuzzy matches. When you search for \"project\", notes containing exactly \"project\" appear before notes with variations like \"projects\" or \"projection\", regardless of other scoring factors.</p><h3>How can I make my searches faster?</h3><ol><li>Use the \"Fast search\" option to search only titles and attributes (not content)</li><li>Limit search scope using the \"Ancestor\" field</li><li>Set a result limit to prevent loading too many results</li><li>For large databases, consider archiving old notes to reduce search scope</li></ol>",
+ "_help_KSZ04uQ2D1St": "<p>One of the core features of Trilium is that it supports multiple types of notes, depending on the need.</p><h2>Creating a new note with a different type via the note tree</h2><p>The default note type in Trilium (e.g. when creating a new note) is&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>, since it's for general use.</p><p>To create a new note of a different type, head to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;and right click an existing note where to place the new one and select:</p><ul><li><em>Insert note after</em>, to put the new note underneath the one selected.</li><li><em>Insert child note</em>, to insert the note as a child of the selected note.</li></ul><p>The note types created less often,&nbsp;<a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a>,&nbsp;<a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a>,&nbsp;<a class=\"reference-link\" href=\"#root/_help_1vHRoWCEjj0L\">Web View</a>&nbsp;and&nbsp;<a class=\"reference-link\" href=\"#root/_help_bdUJEHsAPYQR\">Note Map</a>, are in the <em>More</em> submenu.</p><p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types_image.png\"></p><h2>Creating a new note of a different type via add link or new tab</h2><ul><li>When adding a <a href=\"#root/_help_QEAPj01N5f7w\">link</a> in a&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;note, type the desired title of the new note and press Enter. Afterwards the type of the note will be asked.</li><li>Similarly, when creating a new tab, type the desired title and press Enter.</li></ul><p>The note type is chosen from the same menu as in the note tree, with its submenus (code languages, snippets, collections and the note types created less often) and its search box: type to narrow the list, then press <kbd>Enter</kbd> to create the first match. <kbd>Enter</kbd> right away creates a Text note.</p><h2>Changing the type of a note</h2><p>It is possible to change the type of a note after it has been created via&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>&nbsp;→ <em>Note type</em>. This feature can also be used to edit the <a href=\"#root/_help_4FahAwuGTAwC\">source of a note</a>.</p><aside class=\"admonition note\"><p>Note that it's generally a good idea to change the note type only if the note is empty</p></aside><h2>Supported note types</h2><p>The following note types are supported by Trilium:</p><figure class=\"table\"><table><thead><tr><th>Note Type</th><th>Description</th></tr></thead><tbody><tr><td><a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a></td><td>The default note type, which allows for rich text formatting, images, admonitions and right-to-left support.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a></td><td>Uses a mono-space font and can be used to store larger chunks of code or plain text than a text note, and has better syntax highlighting.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a></td><td>Stores the information about a search (the search text, criteria, etc.) for later use. Can be used for quick filtering of a large amount of notes, for example. The search can easily be triggered.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_iRwzGnHPzonm\">Relation Map</a></td><td>Allows easy creation of notes and relations between them. Can be used for mainly relational data such as a family tree.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_bdUJEHsAPYQR\">Note Map</a></td><td>Displays the relationships between the notes, whether via relations or their hierarchical structure.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a></td><td>Used in&nbsp;<a class=\"reference-link\" href=\"#root/_help_CdNpE2pqjmI6\">Scripting</a>, it displays the HTML content of another note. This allows displaying any kind of content, provided there is a script behind it to generate it.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a></td><td>Displays the children of the note either as a grid, a list, or for a more specialized case: a calendar.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <br> <br>Generally useful for easy reading of short notes.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a></td><td>Displays diagrams such as bar charts, flow charts, state diagrams, etc. Requires a bit of technical knowledge since the diagrams are written in a specialized format.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a></td><td>Allows easy drawing of sketches, diagrams, handwritten content. Uses the same technology behind <a href=\"https://excalidraw.com\">excalidraw.com</a>.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_1vHRoWCEjj0L\">Web View</a></td><td>Displays the content of an external web page, similar to a browser.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_gBbsAeiuUxI5\">Mind Map</a></td><td>Easy for brainstorming ideas, by placing them in a hierarchical layout.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_81SGnPGMk7Xc\">Geo Map</a></td><td>Displays the children of the note as a geographical map, one use-case would be to plan vacations. It even has basic support for tracks. Notes can also be created from it.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_W8vYD3Q1zjCR\">File</a></td><td>Represents an uploaded file such as PDFs, images, video or audio files.</td></tr></tbody></table></figure>",
+ "_help_iPIMuisry3hd": "<p>The default note type in Trilium, text notes allow for rich formatting, tables, images, admonitions and a handful of other features.</p><h2>Formatting bars</h2><p>Most of the interaction with text notes is done via the built-in toolbars. Depending on preference, there are two different layouts:</p><ul><li>The <em>Floating toolbar</em> is hidden by default and only appears when needed. In this mode there are actually two different toolbars:<br><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/1_Text_image.png\" width=\"496\" height=\"91\"><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/2_Text_image.png\" width=\"812\" height=\"114\"></li><li>A toolbar that appears when text is selected. This provides text-level formatting such as bold, italic, text colors, inline code, etc.<br><em><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text_image.png\" width=\"1109\" height=\"124\"></em></li></ul><p>Fore more information see&nbsp;<a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>.</p><h2>Features and formatting</h2><p>Here's a list of various features supported by text notes:</p><figure class=\"table\"><table><thead><tr><th>Dedicated article</th><th>Feature</th></tr></thead><tbody><tr><td><a class=\"reference-link\" href=\"#root/_help_Gr6xFaF6ioJ5\">General formatting</a></td><td><ul><li>Headings (section titles, paragraph)</li><li>Font size</li><li>Bold, italic, underline, strike-through</li><li>Superscript, subscript</li><li>Font color &amp; background color</li><li>Remove formatting</li></ul></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_S6Xx8QIWTV66\">Lists</a></td><td><ul><li>Bulleted lists</li><li>Numbered lists</li><li>To-do lists</li></ul></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_NwBbFdNZ9h7O\">Block quotes &amp; admonitions</a></td><td><ul><li>Block quotes</li><li>Admonitions</li></ul></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_NdowYOC1GFKS\">Tables</a></td><td><ul><li>Basic tables</li><li>Merging cells</li><li>Styling tables and cells.</li><li>Table captions</li></ul></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_UYuUB1ZekNQU\">Developer-specific formatting</a></td><td><ul><li>Inline code</li><li>Code blocks</li><li>Keyboard shortcuts</li></ul></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_AgjCISero73a\">Footnotes</a></td><td><ul><li>Footnotes</li></ul></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_mT0HEkOsz6i1\">Images</a></td><td><ul><li>Images</li></ul></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_QEAPj01N5f7w\">Links</a></td><td><ul><li>External links</li><li>Internal Trilium links</li></ul></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a></td><td><ul><li>Include note</li></ul></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_klC3ilXa9kUE\">Block references</a></td><td><ul><li>Links to blocks of a note</li><li>Including blocks of a note</li></ul></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_CohkqWQC1iBv\">Insert buttons</a></td><td><ul><li>Symbols</li><li><a class=\"reference-link\" href=\"#root/_help_YfYAtQBcfo5V\">Math Equations</a></li><li>Mermaid diagrams</li><li>Horizontal ruler</li><li>Page break</li></ul></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_dEHYtoWWi8ct\">Other features</a></td><td><ul><li>Indentation<ul><li>Markdown import</li></ul></li><li><a class=\"reference-link\" href=\"#root/_help_2x0ZAX9ePtzV\">Cut to subnote</a></li></ul></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_gLt3vA97tMcp\">Premium features</a></td><td><ul><li><a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a></li><li><a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a></li><li><a class=\"reference-link\" href=\"#root/_help_5wZallV2Qo1t\">Format Painter</a></li></ul></td></tr></tbody></table></figure><h2>Read-Only vs. Editing Mode</h2><p>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&nbsp;<a class=\"reference-link\" href=\"#root/_help_CoFPLs3dRlXc\">Read-Only Notes</a>.</p><h2>Keyboard shortcuts</h2><p>There are numerous keyboard shortcuts to format the text without having to use the mouse. For a reference of all the key combinations, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_A9Oc6YKKc65v\">Keyboard Shortcuts</a>. In addition, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_QrtTYPmdd1qq\">Markdown-like formatting</a>&nbsp;as an alternative to the keyboard shortcuts.</p><h2>Content width</h2><p>For readability purposes on wider screens, the width of text notes is limited via a configurable option. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_t596jLvPrqkS\">Content width</a>&nbsp;for more information.</p><h2>Converting to a Markdown note</h2><p>Text notes can be converted to&nbsp;<a class=\"reference-link\" href=\"#root/_help_6RM1Q7ppFVoj\">Markdown</a>&nbsp;notes. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_jludwdW7N4hg\">Converting between note types</a>.</p><h2>Technical details</h2><p>For the text editing functionality, Trilium uses a commercial product (with an open-source base) called&nbsp;<a class=\"reference-link\" href=\"#root/_help_MI26XDLSAlCD\">CKEditor</a>. This brings the benefit of having a powerful WYSIWYG (What You See Is What You Get) editor.</p>",
+ "_help_oSuaNgyyKnhu": "<aside class=\"admonition note\"><p>This feature used to be called <em>Bookmarks</em> (as it is the official name in the editor we are using), but in order not to collide with the concept of&nbsp;<a class=\"reference-link\" href=\"#root/_help_u3YFHC9tQlpm\">Bookmarks</a>, we have renamed it to <em>Anchors.</em></p></aside><p>Anchors allows creating <a href=\"#root/_help_QEAPj01N5f7w\">links</a> to a certain part of a note, such as referencing a particular heading or section within a note.</p><p>This feature was introduced in TriliumNext v0.94.0 and augmented in v0.103.0 to support linking across notes.</p><h2>Interaction</h2><ul><li>To create a anchor:<ul><li>Place the cursor at the desired position where to place the anchor.</li><li>Look for the&nbsp;<span class=\"tn-icon bx bx-plus\"></span> button in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>, and then press the&nbsp;<span class=\"tn-icon cke cke-bookmark\"></span> button.</li><li>Alternatively, use&nbsp;<a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a>&nbsp;and look for <em>anchor</em>.</li></ul></li><li>To place a link to a anchor:<ul><li>Place the cursor at the desired position of the link.</li><li>From the <a href=\"#root/_help_QEAPj01N5f7w\">link</a> pane, select the <em>Anchors</em> section and select the desired anchor.</li></ul></li></ul><h2>Linking across notes</h2><p>Trilium v0.103.0 introduces cross-note Anchors, which makes it possible to create&nbsp;<a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>&nbsp;which point to a specific anchor in that document.</p><h3>Compatibility with documents from previous versions</h3><p>For notes created prior to Trilium v0.103.0, you might notice that the Anchors might not be identified. This limitation is intentional in order not to have to re-process all the notes, looking for anchors.</p><p>To fix this, simply go that note and make any change (e.g. inserting a space), this will trigger the recalculation of the links.</p><h3>Linking to anchors through the <em>Add link</em> dialog</h3><ol><li>Create an anchor in the target note using the same process as described above.</li><li>In another note, press <kbd>Ctrl</kbd>+<kbd>L</kbd> to insert an internal link. Select the target note containing Anchors.</li><li>If the target note contains Anchors, a section will appear underneath the note selector with the list of Anchors.</li><li>Add the link normally.</li></ol><p>Clicking on a reference link pointing to a anchor will automatically scroll to the desired section.</p><h3>Linking to anchors through the bookmark toolbar</h3><ol><li>Create an anchor in the target note using the same process as described above.</li><li>Click on the anchor to reveal the anchor's floating toolbar.</li><li>Click on the <span class=\"tn-icon cke cke-trilium-copy\"></span> <em>Copy anchor reference link</em> button.</li><li>Go to the note where to insert the link and press <kbd>Ctrl</kbd>+<kbd>V</kbd>.</li></ol><aside class=\"admonition note\"><p>Use this method only to insert&nbsp;<a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>&nbsp;between two documents. To link to an anchor on the same note, use the <em>Insert link</em> dialog (<kbd>Ctrl</kbd>+<kbd>K</kbd>) and select the <em>Anchors</em> item instead.</p></aside>",
+ "_help_oI7GoyilXXAr": "<h2>Automatic replacements</h2><p>As you type in a text note, certain character sequences are replaced with the typographic symbol they represent. Typing <code>(c)</code> gives you <code>©</code>, <code>...</code> gives you <code>…</code>, and <code>\"quote\"</code> gives you <code>“quote”</code>.</p><p>These replacements are not applied inside code blocks or inline code, and pasted text is never affected, only text you type. If you have pasted a code snippet, or written one inside a code block, its characters are left exactly as they are.</p><h3>Undoing a replacement</h3><p>Once an automatic replacement takes place, it can be undone by:</p><ul><li>Pressing <kbd>Backspace</kbd> immediately after a replacement undoes it and restores what you typed.<ul><li>Note that this consumes the undo, so a further <kbd>Ctrl</kbd>+<kbd>Z</kbd> might delete your typed text.</li><li>Pressing <kbd>Space</kbd> or changing the cursor position disables this functionality.</li></ul></li><li>Pressing <kbd>Ctrl</kbd>+<kbd>Z</kbd>, which works even after pressing space.</li></ul><h3>Replacement groups &amp; configuration</h3><p>Each group can be turned off in&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Text notes</em> → <em>Automatic replacements</em>.</p><figure class=\"table\"><table><thead><tr><th>Group</th><th>What it replaces</th></tr></thead><tbody><tr><td>Punctuation</td><td><code>...</code> with an ellipsis (<code>…</code>), and <code>--</code> and <code>---</code> <em>surrounded by spaces</em> with an en dash (<code>–</code>) and an em dash (<code>—</code>)</td></tr><tr><td>Mathematical symbols</td><td>fractions such as <code>1/2</code> with <code>½</code>, and the operators <code>&lt;=</code>, <code>&gt;=</code>, <code>!=</code>, <code>&lt;-</code> and <code>-&gt;</code> with <code>≤</code>, <code>≥</code>, <code>≠</code>, <code>←</code> and <code>→</code></td></tr><tr><td>Copyright and trademark</td><td><code>(c)</code>, <code>(r)</code> and <code>(tm)</code> with <code>©</code>, <code>®</code> and <code>™</code></td></tr><tr><td>Quotation marks</td><td>straight quotes with typographic ones — see below</td></tr></tbody></table></figure><h2>Quotation marks</h2><p>Quotation marks are configured separately from the rest, with one setting for the <strong>double</strong> quote key and one for the <strong>single</strong> quote key, because which pair belongs on which key differs between conventions: British typography traditionally sets a quotation in <code>‘…’</code> where American sets it in <code>“…”</code>.</p><p>Each offers:</p><ul><li><em>Based on the note's content language</em> (the default) — English gives <code>“quote”</code>, German <code>„quote“</code>, French <code>« quote »</code>, Japanese <code>「quote」</code>. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_veGu4faJErEM\">Content language &amp; Right-to-left support</a>&nbsp;for how a note's language is decided.</li><li><em>Disabled,</em> straight quotes stay straight.</li><li>A specific pair_:_ <code>“…”</code>, <code>‘…’</code>, <code>„…“</code>, <code>„…”</code>, <code>«…»</code>, <code>« … »</code>, <code>‹…›</code>, <code>「…」</code>, <code>『…』</code>. Choosing one applies it to every note, regardless of its content language.</li></ul><h2>Custom replacements</h2><p>You can add your own under&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Text notes</em> → <em>Automatic replacements</em> → <em>Custom replacements</em>. Type the text to replace and the replacement, then press Enter. Existing ones are shown as chips and removed with the × on each.</p><p>A custom replacement is applied when the text is typed as a whole word and followed by a space, so longer words that begin with it are left alone — a <code>TN</code> replacement does not rewrite the end of <code>BTN</code>, and <code>TNT</code> can still be typed.</p><p>Capitalization follows what you type, unless the replacement has capitals of its own:</p><figure class=\"table\"><table><thead><tr><th><strong>Replacement you defined</strong></th><th><strong>You type</strong></th><th><strong>You get</strong></th></tr></thead><tbody><tr><td><code>teh</code> → <code>the</code></td><td><code>teh</code> / <code>Teh</code> / <code>TEH</code></td><td><code>the</code> / <code>The</code> / <code>THE</code></td></tr><tr><td><code>TN</code> → <code>Trilium Notes</code></td><td><code>TN</code> or <code>tn</code></td><td><code>Trilium Notes</code> (unchanged, it has capitals)</td></tr></tbody></table></figure><p>Of note:</p><ul><li>The text to replace is matched literally; it is not a pattern.</li><li>Typing a \"text to replace\" that already exists in the list of replacements will update the existing one instead. It's not possible to have multiple replacements for the same text.</li><li>The same “text to replace” with different capitalization (e.g. <code>TN</code> and <code>tn</code> co-existing) doesn't work because it would interfere with the capitalization rules above.</li></ul><h2>Characters that only look replaced (ligatures)</h2><p>If you see <code>!=</code> displayed as <code>≠</code> or <code>-&gt;</code> as <code>→</code> inside a code block, that is not a replacement since replacements never run there (unless a code block is applied to an existing text). It is a <em>font ligature</em>: the default monospace font draws certain character pairs as a single symbol. The underlying text is unchanged, and copying it out gives you back <code>!=</code> and <code>-&gt;</code>.</p><p>This can be turned off with&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a><em>→ Appearance → Fonts → Programming ligatures.</em></p>",
+ "_help_NwBbFdNZ9h7O": "<h2>Block quotes</h2><p>As the name suggests, block quotes can be useful to cite one or more paragraphs.</p><p>To create a block quote, press&nbsp;<span class=\"tn-icon cke cke-quote\"></span> from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>. It's also possible to type <kbd>&gt;</kbd>, followed by a space to create one (but only if the cursor is at the beginning of a line).</p><p>Inside the quote block, other block items can be inserted such as tables, images, or even other block quotes or admonitions.</p><h2>Admonitions</h2><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><figure class=\"image image-style-align-center\"><img style=\"aspect-ratio:959/547;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/1_Block%20quotes%20%26%20admonitions_image.png\" width=\"959\" height=\"547\"></figure><p>From a functional point of view, admonitions act very similarly to a block quote, just with different styling. This includes the ability to insert other elements in it such as headings, tables, images, etc.</p><h3>Inserting a new admonition</h3><p>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>:</p><p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Block%20quotes%20%26%20admonitions_image.png\"></p><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>&nbsp; followed by any text, case in which a default admonition type will appear (note) with the entered text inside it.</p><h3>Interaction</h3><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><h3>Types of admonitions</h3><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><h3>Markdown support</h3><p>See&nbsp;<a class=\"reference-link\" href=\"#root/_help_rJ9grSgoExl9\">Supported syntax</a>.</p>",
+ "_help_klC3ilXa9kUE": "<p>Block references are <a href=\"#root/_help_QEAPj01N5f7w\">links</a> to a block of a text note, such as a paragraph, a heading, a list item or a table, or to a range of consecutive blocks. A block reference can be pasted in another note as a link, or turned into an <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a> that shows only the referenced blocks.</p><h2>Copying a reference</h2><ol><li>Place the cursor in the block to reference. To reference several consecutive blocks, select them.</li><li>Right-click the block handle, the sequence of dots to the left of the block (see <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>). Alternatively, right-click the text and open the <em>Copy</em> submenu.</li><li>Select <em>Copy reference to this block</em>, or <em>Copy reference to these blocks</em> for a selection. The referenced blocks flash briefly.</li><li>Go to the note where to insert the link and press <kbd>Ctrl</kbd>+<kbd>V</kbd>.</li></ol><p>Inside a <a class=\"reference-link\" href=\"#root/_help_EK2ckIZ74tbT\">Content tabs</a> block, the reference points to the whole block. To link to a single tab, use <em>Copy link to tab</em> instead. Inside a <a class=\"reference-link\" href=\"#root/_help_wYDzQ1fBFgfT\">Multicolumn layout</a>, the reference points to the blocks in the column, and an include shows them without the layout around them.</p><p>The link shows the title of the note, followed by the beginning of the referenced text. A link to blocks of the same note shows only the beginning of the referenced text.</p><p>If the note is <a href=\"#root/_help_R9pX4DGra2Vt\">shared</a>, the menu of the block handle also offers <em>Copy public link to this block</em>. It copies the web address of the shared page with the reference added, to send to people who read the note outside Trilium. Opening the address scrolls the shared page to the referenced blocks and flashes them.</p><p>The <em>Paste</em> submenu of the context menu offers two more ways to insert a copied reference:</p><ul><li><em>Paste reference as a link</em> inserts only the link, even when the reference was copied as plain text or along with other content.</li><li><em>Paste reference as an excerpt</em> inserts an include of the referenced blocks, as described below.</li></ul><p>In a browser, the context menu of the text editor opens only when right-clicking selected text. Elsewhere the browser shows its own menu.</p><h2>Following a reference</h2><p>Clicking a block reference opens the note, scrolls to the referenced blocks and flashes them. If a referenced block was deleted, an error message is shown instead, along with the blocks of the range that still exist.</p><h2>Including the referenced blocks</h2><p>To show the referenced blocks inside another note, right-click the link in a note being edited and select <em>Convert link to note excerpt</em>, or paste the copied reference with <em>Paste</em> → <em>Paste reference as an excerpt</em>. The include shows only the referenced blocks, not the rest of the note, and marks them with an <em>Excerpt</em> badge in its title. It starts at the <em>Full</em> box size, so all the referenced blocks are visible. To see the whole note, press the <span class=\"tn-icon bx bx-link-external\"></span> button in the same title, which opens the note in a new tab. Converting the include back to a link keeps the reference.</p><p>To edit the referenced blocks without leaving the note, press the <span class=\"tn-icon bx bx-pencil\"></span> <em>Edit excerpt</em> button in the title of the include, or turn on <em>Editable</em> (<span class=\"tn-icon bx bx-edit-alt\"></span>) in its toolbar, as for any <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>. Press the button again to stop editing. The changes are saved to the referenced blocks, and the rest of the note stays as it is. The button is grayed out where the blocks cannot be edited, such as in a read-only note. An excerpt has no <em>Fullscreen</em> button.</p><p>If a referenced block was deleted, the include shows <em>Broken reference</em>.</p><h2>Limitations</h2><ul><li>References can be copied only from a note being edited, and not in the mobile layout.</li><li>An include of a range that covers only part of a list or a quote, such as from its second item to a paragraph after it, cannot be edited in place.</li><li>Deleting a block breaks the references to it.</li><li>Block references are not kept when exporting to Markdown. On a <a href=\"#root/_help_R9pX4DGra2Vt\">shared page</a>, a block reference opens the whole note.</li></ul>",
+ "_help_4n4oQUVbnOxa": "<p>Collapsible blocks are sections of content that can be expanded and collapsed, letting you hide detail until it's needed.</p><p>A collapsible block consists of:</p><ul><li><strong>An always-visible header</strong>, containing:<ul><li><strong>An arrow</strong> that expands or collapses the block when clicked.</li><li><strong>A summary line</strong> that acts as the block's title. With the cursor in the summary line, press <kbd>Ctrl</kbd>+<kbd>Enter</kbd> to expand or collapse the block.</li><li><strong>A drag handle</strong> for repositioning the block within the note.</li></ul></li><li><strong>The body</strong>, which is hidden while the block is collapsed. It can hold any kind of content, including nested collapsible blocks. To break out of a collapsible block and continue typing outside it, press <kbd>Enter</kbd> twice at the end of the block.</li></ul><p>You can use the arrow keys to move freely with the cursor between the summary line, the block's body, and the text around the block.</p><h2>Inserting a collapsible block</h2><p>In the formatting bar, go to <em>Insert</em> → <em>Collapsible Block</em>.</p><aside class=\"admonition tip\"><p>Place multiple collapsible blocks one after another to create an accordion, where each block can be expanded or collapsed independently.</p></aside>",
+ "_help_veGu4faJErEM": "<p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Content%20language%20%26%20Right-to-left%20support_image.jpg\"></p><p>The content language determines:</p><ul><li>The spell-checking of the note, when in a browser. The desktop installation has a dedicated spellchecking section.</li><li>Whether the text is displayed from right-to-left, for languages such as Arabic, Hebrew, etc.</li><li>How typed quotes are <a href=\"#root/_help_oI7GoyilXXAr\">automatically replaced</a> (e.g. English uses <code>“text”</code>, whereas some languages use <code>«text»</code>). This applies only if&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Text</em> → <em>Single/Double quotation marks</em> is set to <em>Based on note's content language</em>.</li><li>Which languages are offered by the&nbsp;<a class=\"reference-link\" href=\"#root/_help_VRoP0g1uHHc2\">In-editor AI assistant</a>&nbsp;for translation.</li><li>The language and the text direction the content is marked with on a <a href=\"#root/_help_R9pX4DGra2Vt\">shared page</a>, which screen readers and browsers follow.</li></ul><h2>Setting the language of a single note</h2><p>To set the language of the content of a&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;note, there is a language selector in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_AlJ73vBCjWDw\">Status bar</a>&nbsp;indicated by a&nbsp;<span class=\"tn-icon bx bx-globe\"></span> icon.</p><h2>Adjusting the list of languages</h2><p>By default there will be no language configured, they can be configured by going to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ Language &amp; Region or by selecting the <em>Configure languages</em> item when setting the language.</p><h2>Default content language</h2><p>Notes that do not have a language of their own follow&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Language &amp; Region</em> → <em>Default content language</em>. It is set to English initially, and can be set to any content language, or to <em>Based on the application's language</em>.</p><p>If a note has a language set, it always takes precedence over the default.</p>",
+ "_help_EK2ckIZ74tbT": "<p>Content tabs group several titled panels of content into one block that shows a single panel at a time. They suit content that comes in variants (such as installation steps for each operating system or the same snippet in several programming languages).</p><p>A tabs block consists of:</p><ul><li><strong>A single row of tab titles</strong>, above the panel or, when the tabs are aligned at the bottom, below it. The title of the panel that is showing is highlighted.</li><li><strong>The panel of the active tab.</strong> A panel can hold any kind of content (including nested tabs blocks).</li></ul><h2>Inserting a tabs block</h2><ul><li>In the formatting bar, go to <em>Insert</em> → <em>Tabs</em>.</li><li>Alternatively, type <code>/tabs</code> and press <kbd>Enter</kbd>, as described in&nbsp;<a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a>.</li></ul><p>A new block contains two tabs, named “Tab 1” and “Tab 2”. Any content that was selected prior to inserting the tabs will be moved into the first tab. The title of the first tab is selected, so typing replaces it.</p><h2>Scrolling through the titles</h2><p>When the titles of a block do not fit on their row, a <span class=\"tn-icon bx bx-chevron-left\"></span> button and a <span class=\"tn-icon bx bx-chevron-right\"></span> button appear at its ends:</p><ul><li>To scroll the titles, click one of the buttons. Holding a button down scrolls the titles continuously until it is released.</li><li>On a touch screen, the titles can also be swiped sideways.</li></ul><p>Whenever another tab is shown (for example by clicking its title, by moving the cursor into it or by following a link to it), the row scrolls so that its whole title is visible. This works the same while editing, in read-only notes and on shared pages.</p><h2>Editing tabs</h2><ul><li>To show a tab, click its title or move the cursor into it.</li><li>To move from a title into its panel, press <kbd>Enter</kbd>.</li><li>The label of a tab can be formatted just like normal text, including support for&nbsp;<a class=\"reference-link\" href=\"#root/_help_hD8GawVuazff\">Icons</a>.</li></ul><p>While the cursor is inside a tabs block, a toolbar appears above it with the following buttons:</p><ul><li><span class=\"tn-icon cke cke-plus\"></span>&nbsp;<em>(Add tab)</em> inserts a tab after the current one and selects its title.</li><li><span class=\"tn-icon cke cke-remove\"></span>&nbsp;<em>(Remove tab)</em> removes the current tab. Removing the last tab removes the whole block.</li><li><span class=\"tn-icon cke cke-chevron-right bx-flip-horizontal\"></span>&nbsp;<em>(Move tab left)</em> and&nbsp;<span class=\"tn-icon cke cke-chevron-right\"></span> (<em>Move tab right)</em> change the order of the tabs.</li><li><span class=\"tn-icon cke cke-link\"></span>&nbsp;<em>(Copy link to tab)</em> copies a link to the current tab, as described below.</li><li><span class=\"tn-icon cke cke-trilium-tabs\"></span>&nbsp;<em>(Tab alignment)</em> places the tab titles above the panel (<em>Align tabs at top</em>, the default) or below it (<em>Align tabs at bottom</em>).</li></ul><p>The tab that is showing is not saved with the note: every tabs block opens on its first tab.</p><h3>Adding tabs</h3><p>While the cursor is in a tab, either in its title or in its panel, you can use these key combinations:</p><ul><li><kbd>Ctrl</kbd> + <kbd>Enter</kbd>: Add a tab after the current one.</li><li><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Enter</kbd>: Add a tab before the current one.</li></ul><p>The new tab is shown and its title is selected, so typing replaces it.</p><p><kbd>Ctrl</kbd> + <kbd>Enter</kbd> keeps its usual function on a link, in a to-do item and in the title of a collapsible block, and <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Enter</kbd> in a to-do item.</p><h3>Reordering tabs</h3><p>While the cursor is in a tab, either in its title or in its panel, you can use these key combinations:</p><ul><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Right</kbd>: Move the tab to the right.</li><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Left</kbd>: Move the tab to the left.</li><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Home</kbd>: Make it the first tab.</li><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>End</kbd>: Make it the last tab.</li></ul><h2>Moving content between tabs</h2><p>To move content to another tab, select it in the panel, and then use these key combinations:</p><ul><li><kbd>Ctrl</kbd> + <kbd>Right</kbd>: Move to the tab on the right.</li><li><kbd>Ctrl</kbd> + <kbd>Left</kbd>: Move to the tab on the left.</li><li><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>End</kbd>: Move to the last tab.</li><li><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Home</kbd>: Move to the first tab.</li></ul><p>The tab that receives the content is shown, with the content still selected, so pressing the key again moves it on to the next tab. Paragraphs, list items, tables and other blocks move whole, even when only part of them is selected. Content moved to a tab on the left goes to the end of that tab, and content moved to a tab on the right goes to its start, so it keeps its place in the reading order.</p><p>Without a selection, or with a selection in a tab title, these keys keep their usual function: moving the cursor by word, or selecting up to the start or end of the tab.</p><p>When a tabs block and a <a class=\"reference-link\" href=\"#root/_help_wYDzQ1fBFgfT\">Multicolumn layout</a> are nested in one another, the key combinations act on the one closest to the cursor.</p><h2>Reading tabs</h2><p>In&nbsp;<a class=\"reference-link\" href=\"#root/_help_CoFPLs3dRlXc\">Read-Only Notes</a>&nbsp;and on&nbsp;<a class=\"reference-link\" href=\"#root/_help_R9pX4DGra2Vt\">Sharing</a>, tabs blocks work as tabs as well:</p><ul><li>To show a tab, click its title, or focus it and press <kbd>Enter</kbd> or <kbd>Space</kbd>.</li><li>To move between the titles of a block, use the arrow keys, <kbd>Home</kbd> and <kbd>End</kbd>.</li></ul><p>A tab without a title shows “Tab title” in place of one.</p><p>In read-only notes, a title too long for its tab fades out where it is cut off. To read the rest of it, swipe it sideways or drag it with the mouse.</p><h2>Linking to a tab</h2><p>A link can point to a single tab, much like a link to a block (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_klC3ilXa9kUE\">Block references</a>):</p><ol><li>Place the cursor in the tab, either in its title or in its panel.</li><li>Press <em>Copy link to tab</em> (<span class=\"tn-icon cke cke-link\"></span>) in the toolbar of the tabs block. Alternatively, right-click the text and select <em>Copy</em> → <em>Copy link to this tab</em>. The tab flashes briefly.</li><li>Go to the note where to insert the link and press <kbd>Ctrl</kbd>+<kbd>V</kbd>.</li></ol><p>The link shows the title of the note, followed by the title of the tab. Clicking it opens the note, shows the tab and flashes it. As with any block reference, the link can be turned into an&nbsp;<a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>&nbsp;that shows only that tab.</p><p>Links to a tab can be copied only from a note being edited. On a <a href=\"#root/_help_R9pX4DGra2Vt\">shared page</a>, such a link opens the whole note.</p><h2>Content in hidden tabs</h2><p>Content inside a tab that is not showing is still reachable (both while editing and while reading). The tab that holds it is shown when:</p><ul><li>searching the note with <kbd>Ctrl</kbd>+<kbd>F</kbd> highlights a match inside it;</li><li>a link points to an anchor or a block inside it (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_oSuaNgyyKnhu\">Anchors</a>&nbsp;and&nbsp;<a class=\"reference-link\" href=\"#root/_help_klC3ilXa9kUE\">Block references</a>);</li><li>an entry of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_BFvAtE74rbP6\">Table of contents</a>&nbsp;or the&nbsp;<a class=\"reference-link\" href=\"#root/_help_AxshuNRegLAv\">Highlights list</a>&nbsp;points inside it;</li><li>on a shared page, the address of the page points to a heading or an anchor inside it.</li></ul><p>Tab titles are not headings, so they do not appear in the table of contents; headings inside a panel do.</p><h2>Printing and exporting</h2><ul><li>When printing or <a href=\"#root/_help_NRnIZmSMc5sj\">exporting to PDF</a>, every tab is printed, one after another, each with its title above its panel, whatever the tab alignment.</li><li>Markdown export and import write tabs blocks in the content tabs syntax of Material for MkDocs, described in&nbsp;<a class=\"reference-link\" href=\"#root/_help_rJ9grSgoExl9\">Supported syntax</a>.&nbsp;<a class=\"reference-link\" href=\"#root/_help_6RM1Q7ppFVoj\">Markdown</a>&nbsp;notes use the same syntax, show the blocks as tabs in their preview and insert them with <code>/tabs</code>. That syntax has no tab alignment, so tabs aligned at the bottom are exported as regular tabs.</li><li>Anywhere the tabs cannot work as tabs (such as an HTML export opened elsewhere), a tabs block reads as a sequence of titled sections.</li></ul>",
+ "_help_2x0ZAX9ePtzV": "<figure class=\"image image_resized image-style-align-right\" style=\"width:64.63%;\"><img style=\"aspect-ratio:812/585;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Cut%20to%20subnote_cut-to-subnote.gif\" width=\"812\" height=\"585\"></figure><p>When editing a document that becomes too large, you can split it into sub-notes:</p><ol><li>Select the desired text and cut it to the clipboard.</li><li>Create a new sub-note and name it.</li><li>Paste the content from the clipboard into the sub-note.</li></ol><p>Trilium can automate this process. Select some text within the note, and in the selection toolbar, click the scissors icon for the \"cut &amp; pasted selection to sub-note\" action. The heading is automatically detected and the new sub-note is named accordingly. You can also assign a keyboard shortcut for this action. This functionality is available through the block toolbar icon.</p>",
+ "_help_UYuUB1ZekNQU": "<h3>Inline code</h3><p>Inline code formats text using a monospace font to indicate technical content in a sentence such as code, paths, etc.</p><p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Developer-specific%20formatting_image.png\"></p><p>Example of inline code being used to illustrate file system paths as well as shell commands (<code>git</code> in this case).</p><p>To insert an inline code:</p><ul><li>Via the&nbsp;<a href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>, look for the&nbsp;<span class=\"tn-icon cke cke-code\"></span> button.</li><li>Type `code` where <code>code</code> is the desired text to be automatically formatted as inline code.</li><li>Paste a single line copied from Visual Studio Code. See <a href=\"#root/_help_QxEyIjRBizuC\">Code blocks</a> for pasting several lines.</li></ul><h3>Code blocks</h3><p>Code blocks display a snippet of code as a dedicated block:</p><p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/1_Developer-specific%20formatting_image.jpg\"></p><p>A code block with JavaScript syntax highlight enabled.</p><p>Note that these are not meant for very large portions of code. Use the dedicated&nbsp;<a href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;note type instead.</p><p>See the dedicated documentation for more information:&nbsp;<a href=\"#root/_help_QxEyIjRBizuC\">Code blocks</a></p><h3>Keyboard shortcuts</h3><p>This allows marking a portion of text as a shortcut key.</p><p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Developer-specific%20formatting_image.jpg\"></p><p>To apply this style, press the&nbsp;<span class=\"tn-icon cke cke-trilium-kbd\"></span> button in&nbsp;<span class=\"tn-icon bx bx-text\"></span> group from the&nbsp;<a href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>. On the floating toolbar, the buttons appear when selecting a text.</p><p>Alternatively, press the <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>K</kbd> combination to apply keyboard shortcut formatting to the current text selection.</p><p>The formatting can be removed by pressing again the button (from the UI or from the keyboard), or by using the&nbsp;<span class=\"tn-icon cke cke-remove-format\"></span> <em>Remove formatting</em> button.</p>",
+ "_help_QxEyIjRBizuC": "<p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Developer-specific%20formatting/Code%20blocks_image.jpg\"></p><p>The code blocks feature allows entering pieces of code in text notes.</p><p>Note that this feature is meant for generally small snippets of code. For larger files such as an entire log, see the&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;note type instead.</p><h2>Inserting a code block</h2><ul><li>Via the&nbsp;<a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>, look for the&nbsp;<span class=\"tn-icon cke cke-code-block\"></span> button.<ul><li>Pressing directly on the icon will insert a code block with the language that was selected most recently. If this is the first time a code block is inserted, the language will be “Auto-detected” by default.</li><li>Pressing the arrow next to the icon, which will show a popup with the available languages.</li></ul></li><li>Type <code>```</code> (as in Markdown).<ul><li>Note that it's not possible to specify the language, as it will default to the last selected language.</li></ul></li><li>Paste several lines of code copied from Visual Studio Code.<ul><li>The code block uses the language of the file in Visual Studio Code.</li><li>If that language is not in the list of languages, the code block uses <em>Auto-detected</em>.</li><li>The colors of the Visual Studio Code theme are removed.</li><li>A single line becomes inline code instead of a code block.</li><li>In Firefox, the code block always uses <em>Auto-detected</em>. Firefox can't read the language from Visual Studio Code.</li></ul></li></ul><h2>Exiting out of the code block</h2><ul><li>To exit out of a code block and enter a normal paragraph, move the cursor at the end of the code block and press Enter twice.</li><li>Similarly, to insert a paragraph above the note block, move the cursor at the beginning of the code block and press Enter twice.</li></ul><aside class=\"admonition note\"><p>If you've pasted a code block with a more complex HTML structure, exiting out of the code block by pressing Enter multiple times might not work. In that case the best approach is to delete the code block entirely and use Ctrl+Shift+V (paste as plain text).</p></aside><h2>Syntax highlighting &amp; color schemes</h2><p>Since TriliumNext v0.90.12, Trilium will try to offer syntax highlighting to the code block. Note that the syntax highlighting mechanism is slightly different than the one in&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;notes as different technologies are involved.</p><p>Interaction:</p><ul><li>When the language is set to <em>Auto-detected</em> (by default), Trilium will try to identify the programming language (or similar) that corresponds to the given snippet of text and highlight it. Only the languages enabled in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Code Notes</em> → <em>Available MIME types in the dropdown</em> are considered. If this is problematic, consider changing the language of the code block manually.</li><li>When the language is set to <em>Plain text</em>, there will be no syntax highlighting.</li></ul><p>Note that when editing a text note, syntax highlighting is automatically disabled if the code block is too big (somewhere around 500 lines). In&nbsp;<a class=\"reference-link\" href=\"#root/_help_CoFPLs3dRlXc\">Read-Only Notes</a>, in print and on a <a href=\"#root/_help_R9pX4DGra2Vt\">shared page</a>, a code block of more than 500 lines or 50,000 characters is shown without syntax highlighting. These limits are not configurable.</p><p>In order to configure this new feature, a section has been added in&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Appearance</em> to control the syntax highlighting. There the color scheme can be chosen, from a builtin selection of themes from Highlight.js. <em>VS Code (Light)</em> and <em>VS Code (Dark)</em> use the same colors as the default themes of <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> notes, so a code block and a code note color the same code alike.</p><ul><li>It is possible to disable the syntax highlighting for all the notes by selecting “No syntax highlighting” in the “Color scheme” option.</li><li>Word wrapping is disabled by default, but can be configured from the same section.</li><li>The tab width can also be adjusted from Options.</li></ul><aside class=\"admonition note\"><p><strong>Context regarding syntax highlighting</strong></p><p>In order to achieve the syntax highlight, the Highlight.js library is being used. Do note that support for syntax highlighting in code blocks is not a supported feature of the text editor we are using CKEditor), but rather a hack which makes use of the highlights API (used for highlighting search results for example). Nevertheless, we haven't noticed any major issues during the development of the feature, but feel free to report any issues you might have.</p><p>Most of the work to achieve the syntax highlight itself was already done by <a href=\"https://github.com/antoniotejada\">antoniotejada</a> in <a href=\"https://github.com/antoniotejada/Trilium-SyntaxHighlightWidget\">https://github.com/antoniotejada/Trilium-SyntaxHighlightWidget</a>. On our side we added customization but also additional functionality.</p></aside><h3>Migrating from existing syntax highlight plugins</h3><p>If you are already using a syntax highlighting plugin such as the <a href=\"https://github.com/antoniotejada/Trilium-SyntaxHighlightWidget\">Trilium-SyntaxHighlightWidget</a> we are basing off of, it is important to disable that plugin before upgrading in order for it not to conflict with our implementation.</p><p>Should you encounter any issues after the migration, try running Trilium in safe mode.</p><h2>Changing the language of a code block</h2><p>Simply click anywhere inside the code block and press again the code block button in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>:<br><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Developer-specific%20formatting/Code%20blocks_image.png\"></p><h2>Adjusting the list of languages</h2><p>The code blocks feature shares the list of languages with the&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;note type.</p><p>The supported languages can be adjusted by going to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>, then <em>Code Notes</em> and looking for the <em>Available MIME types in the dropdown</em> section. Simply check any of the items to add them to the list, or uncheck them to remove them from the list.</p><p>Note that the list of languages is not immediately refreshed, you'd have to manually <a href=\"#root/_help_s8alTXmpFR61\">refresh the application</a>.</p><h2>Text replacements and ligatures</h2><p><a class=\"reference-link\" href=\"#root/_help_oI7GoyilXXAr\">Automatic replacements</a>&nbsp;are a feature of text notes which converts some character sequences into another and some of them interfere with programming text, such as the conversion of quotes. While in a code block, the automatic replacements <strong>are not effect</strong>. The only way the automatic replacements can interfere is if the text is typed/pasted before being put in a code block.</p><p>A different feature is <em>programming ligatures</em>, which is simply a display affordance which turns <code>!=</code> into <code>≠</code> or <code>-&gt;</code> as <code>→</code> . These come from the <a href=\"#root/_help_w4rMEhJsALlA\">font</a>. The underlying text is not actually changed, and copying it out gives you back <code>!=</code> and <code>-&gt;</code>.</p><p>Ligatures can be disabled in&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a><em>→ Appearance → Fonts → Programming ligatures.</em></p>",
+ "_help_AgjCISero73a": "<figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:199/187;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Footnotes_image.png\" width=\"199\" height=\"187\"></figure><p>Footnotes are a good place to insert references to a paragraph or details that are displayed at the bottom of the note.</p><h2>Interaction</h2><ul><li>To insert a new footnote, press&nbsp;<span class=\"tn-icon cke cke-trilium-insert-footnote\"></span> (or press the right arrow and select <em>New footnote</em>).</li><li>To insert a reference to an existing footnote, press the right arrow and select <em>Insert footnote</em>, followed by the number of the footnote to insert.</li><li>Hovering over a reference (e.g. <code>[1]</code>) will display the content of the footnote in a tooltip for easy reference.</li><li>Clicking on a reference in the text (e.g. <code>[1]</code>) will navigate to the corresponding footnote.</li><li>Similarly, clicking on the <code>^</code> button of a footnote will navigate to the corresponding reference in the text.</li></ul>",
+ "_help_5wZallV2Qo1t": "<figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:220/76;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Format%20Painter_image.png\" width=\"220\" height=\"76\"></figure><p>The Format Painter is a feature in text notes that allows users to copy the formatting of text (such as <strong>bold</strong>, <em>italic</em>, <del>Strikethrough</del>, etc.) and apply it to other parts of the document. It helps maintain consistent formatting and accelerates the creation of rich content.</p><h2>Usage Instructions</h2><p>Click the text that you want to copy the formatting from and use the <em>Copy formatting</em> toolbar button (<span class=\"tn-icon cke cke-paint-roller\"></span>) to copy the style. Then select the target text with your mouse to apply the formatting.</p><ul><li><strong>To copy the formatting</strong>: Place the cursor inside text with some formatting and click the <em>Copy formatting</em> toolbar button. The mouse cursor changes to indicate the painter is armed.</li><li><strong>To paint with the copied formatting</strong>: Select the target text with your mouse. The formatting is applied when you release the button, and the painter disarms — the cursor returns to normal.</li><li><strong>To cancel without painting</strong>: Click the toolbar button again or press <kbd>Escape</kbd>.</li></ul><h2>Limitations</h2><ol><li>Painting with block-level formatting (like headings or image styles) is not supported yet. This is because, in&nbsp;<a class=\"reference-link\" href=\"#root/_help_MI26XDLSAlCD\">CKEditor</a>, they are considered a part of the content rather than text formatting.</li><li>The painter applies to a selection, not to a word: clicking a single word does not format it. A click only primes the caret, so text you type there takes the copied formatting.</li><li>The painter is one-shot; each paint requires copying the formatting again.</li></ol>",
+ "_help_nRhnJkTT8cPs": "<p>Trilium allows two different editing experiences for text notes, based on your preference.</p><p>The type of formatting toolbar can be changed by going to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;and then looking for the&nbsp;<a class=\"reference-link\" href=\"#root/_hidden/_options/_optionsTextNotes\">Text Notes</a>&nbsp;section. In it, look for the <em>Formatting toolbar</em> category.</p><h2>Floating</h2><p>The floating bar is a more minimalist option, in which the formatting is hidden behind two different popups.</p><h3>Block-level popup</h3><p>The first popup is the block-level popup. This will appear to the left of the current paragraph you are currently editing, as a sequence of dots:<br><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Formatting%20toolbar_image.jpg\"></p><p>Clicking this popup will reveal the formatting options that are specific to the entire paragraph, such as setting a heading, lists, tables, etc.</p><p>The dots are also a drag handle: drag them to move the paragraph, all the selected paragraphs, or a selected element such as an image, a table or an included note to another place in the note. Right-clicking them copies a reference to the paragraph or to the selected paragraphs, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_klC3ilXa9kUE\">Block references</a>.</p><figure class=\"image\"><img style=\"aspect-ratio:1404/156;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/2_Formatting%20toolbar_image.png\" width=\"1404\" height=\"156\"></figure><h3>Inline popup</h3><p>The inline popup appears automatically when selecting a text:</p><figure class=\"image\"><img style=\"aspect-ratio:1008/154;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/1_Formatting%20toolbar_image.png\" width=\"1008\" height=\"154\"></figure><p>All the options here apply only to the selected portion of text, such as changing the font size, or making the text bold.</p><h2>Fixed</h2><p>The fixed formatting offers a more traditional editing paradigm, usually useful if a lot of formatting is needed.</p><p>All the options are combined into a single toolbar that will appear at the above the note. When using&nbsp;<a class=\"reference-link\" href=\"#root/_help_luNhaphA37EO\">Split View</a>, a single toolbar will be available to save space and it acts on the active note.</p><p>The sequence of dots to the left of the current paragraph is still shown, but only as a drag handle: drag it to move the paragraph, all the selected paragraphs, or a selected element such as an image, a table or an included note to another place in the note. Clicking it does not open a popup, and right-clicking it copies a reference to the block, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_klC3ilXa9kUE\">Block references</a>. The drag handle is not shown in the mobile layout.</p><figure class=\"image\"><img style=\"aspect-ratio:1440/60;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Formatting%20toolbar_image.png\" width=\"1440\" height=\"60\"></figure><p>By default, if the toolbar does not fit on the screen, the rest of the options will be grouped into a single option at the end. It is possible to display items on multiple lines by checking the corresponding option in the <em>Formatting toolbar</em> section.</p>",
+ "_help_Gr6xFaF6ioJ5": "<h2>Headings</h2><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:255/284;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/2_General%20formatting_image.png\" width=\"255\" height=\"284\"></figure><p>Trilium provides headings to define sections within text. Headings are numbered from 2 to 6.</p><p>The reason why Heading 1 is missing from the list is that it is being reserved for the title of note.</p><p>To turn a heading back into a normal text, select <em>Paragraph</em> from the list.</p><p>Apart from using the UI, it is also possible to quickly insert headings using the Markdown-like shortcuts:</p><ul><li><code>##</code> for Heading 2</li><li><code>###</code> for Heading 3</li><li><code>####</code> for Heading 4</li><li><code>#####</code> for Heading 5</li><li><code>######</code> for Heading 6</li></ul><h2>Font size</h2><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:363/249;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/General%20formatting_image.png\" width=\"363\" height=\"249\"></figure><p>One way to highlight a portion of text is to increase the size of the font.</p><p>To do so, select some text and choose an option from the <em>Font size</em> (<span class=\"tn-icon cke cke-font-size\"></span>) selector (as pictured to the right).</p><p>Unlike other text editors such as Microsoft Word, the font size is relative (i.e. “Tiny”, “Small” instead of a number like 12).</p><p>Avoid using this feature just to simply make all text bigger. In that case it's generally better to adjust the font size for all notes in&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;or by zooming.</p><h2>Bold, italic, underline, strike-through</h2><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:215/71;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/3_General%20formatting_image.png\" width=\"215\" height=\"71\"></figure><p>Text can be formatted as <strong>Bold,</strong> <em>Italic,</em> Underline or <del>Strike-through</del> via the dedicated buttons (<span class=\"tn-icon cke cke-bold\"></span>, <span class=\"tn-icon cke cke-italic\"></span>, <span class=\"tn-icon cke cke-underline\"></span>, <span class=\"tn-icon cke cke-strikethrough\"></span>) in the formatting toolbar.</p><p>This formatting can be easily removed using the <em>Remove formatting</em> (<span class=\"tn-icon cke cke-remove-format\"></span>) item.</p><p>The following keyboard shortcuts can be used here:</p><ul><li><kbd>Ctrl</kbd>+<kbd>B</kbd> for bold</li><li><kbd>Ctrl</kbd>+<kbd>I</kbd> for italic</li><li><kbd>Ctrl</kbd>+<kbd>U</kbd> for underline</li></ul><p>Alternatively, Markdown-like formatting can be used:</p><ul><li><strong>Bold</strong>: Type <code>**text**</code> or <code>__text__</code></li><li><em>Italic</em>: Type <code>*text*</code> or <code>_text_</code></li><li><del>Strikethrough</del>: Type <code>~~text~~</code></li></ul><h2>Superscript, subscript</h2><p>This allows writing superscript or subscript text.</p><p>This is mostly useful for units of measure (e.g. cm3 for cubic centimeters) and chemical notations (e.g. NaHCO3)</p><p>For mathematical formulas, prefer the&nbsp;<a class=\"reference-link\" href=\"#root/_help_YfYAtQBcfo5V\">Math Equations</a>&nbsp;feature instead.</p><h2>Font color and background color</h2><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:167/204;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/1_General%20formatting_image.png\" width=\"167\" height=\"204\"></figure><p>Selected text can be colored with one of the predefined colors from a palette or any color can be selected using the color picker (<span class=\"tn-icon cke cke-color-palette\"></span>).</p><p>Once there is at least one color defined in the document, it will appear in the list for easy reuse.</p><p>Colors adapt to the <a href=\"#root/_help_Wy267RK4M69c\">theme</a>. Trilium shows each color in a lighter or darker shade that suits the current theme, so the text stays readable after switching between light and dark themes. The hue stays the same: red text is red in both themes, only lighter or darker. This applies to the palette, the color picker and the document colors alike, and to shared notes too. Printed notes and PDF exports always use the shades of light themes, which suit white paper. The note itself keeps the color as it was picked, so an exported note shows it unchanged.</p><p>Colors applied with older versions of Trilium are shown exactly as they were picked, until the note is next edited.</p><p>Older browsers that can't adapt colors show them exactly as they were picked.</p><p>When you paste text copied from a web page in Chrome, Edge or a Chromium-based app (such as Visual Studio Code), Trilium removes the page's styling:</p><ul><li>Text and background colors.</li><li>Fonts and font sizes.</li><li>Table borders, backgrounds and spacing.</li></ul><p>The following formatting is preserved:</p><ul><li>Bold, italic, underline and strikethrough.</li><li>Subscript and superscript.</li><li>Links, code and tables.</li></ul><p>Colors are preserved when pasting from Word, Google Docs or another note.</p><p>To remove either the background or foreground color of a text, select the corresponding formatting button (<span class=\"tn-icon cke cke-font-color\"></span> or <span class=\"tn-icon cke cke-font-background\"></span>) and press <em>Remove color</em> (<span class=\"tn-icon cke cke-eraser\"></span>) or use the <em>Remove formatting</em> (<span class=\"tn-icon cke cke-remove-format\"></span>) toolbar item.</p><h2>Remove formatting</h2><p>The&nbsp;<span class=\"tn-icon cke cke-remove-format\"></span> <em>Remove formatting</em> button is a quick way to eliminate the general formatting styling of a particular text.</p><p>Simply select the text and press the button to remove the formatting (bold, italic, colors, sizes, etc.). If the text does not have any removable formatting, the button will appear disabled.</p><p>Note that heading styles are not taken into consideration, these must be manually changed back to a paragraph according to the <em>Headings</em> section.</p><p>When pasting content that comes with undesired formatting, an alternative to pasting and then removing formatting is pasting as plain text via <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>V</kbd>.</p><h2>Format painter</h2><p>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_5wZallV2Qo1t\">Format Painter</a>&nbsp;allows users to copy the formatting of text (such as bold, italic, Strikethrough, etc.) and apply it to other parts of the document. It helps maintain consistent formatting and accelerates the creation of rich content.</p><h2>Support for Markdown</h2><p>When exported to&nbsp;<a class=\"reference-link\" href=\"#root/_help_Oau6X9rCuegd\">Markdown</a>, most of the general formatting is maintained such as headings, bold, italic, underline, etc.</p>",
+ "_help_AxshuNRegLAv": "<aside class=\"admonition note\"><p>This page has been relocated to&nbsp;<a class=\"reference-link\" href=\"#root/_help_2dcGDhp9WFKb\">Outline tab</a>.</p></aside>",
+ "_help_mT0HEkOsz6i1": "<p>Trilium supports storing and displaying images. Supported formats are PNG, JPEG, GIF, BMP, WebP, AVIF and SVG.</p><p>An image can be uploaded in the form of note's <a href=\"#root/_help_0vhv7lsOLy82\">attachment</a> or as a standalone <a href=\"#root/_help_kBrnXNG3Hplm\">note</a> placed into the <a href=\"#root/_help_kBrnXNG3Hplm\">note tree</a>. Its reference can be copied into a text note, in order to display it in the text itself.</p><h2>Uploading images</h2><p>To add an image to the note:</p><ul><li>Simply drag it from file explorer onto the note editor inside Trilium and the image will be uploaded.</li><li>Alternatively, from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>&nbsp;look for the <span class=\"tn-icon cke cke-image-upload\"></span> <em>Upload image from computer</em> button.</li><li>You can also copy and paste an image from web (see section below).</li></ul><aside class=\"admonition tip\"><p>To link a picture instead of displaying it, attach it with <em>Attach file as a link</em>, from the arrow beside the <span class=\"tn-icon cke cke-paper-clip\"></span><em>Attach file</em> button. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>.</p></aside><h2>Clipboard &amp; automatic download of images</h2><p>Trilium has a special handling for images copied to and pasted from the clipboard.</p><ul><li>For a mix of text and images, the images are downloaded automatically by the server (or desktop app, depending on what is being used).<ul><li>This means that the image must be publicly accessible and reachable from wherever Trilium is running. Inaccessible images will end up as broken images.</li></ul></li><li>If a single image is pasted into Trilium, it will prefer the image that comes in the clipboard. This makes it possible to copy images that Trilium would not otherwise be able to reach, such as Google Chat, Slack, etc.</li><li>When a text with images is copied from Trilium and pasted in another app (such as Microsoft Word or LibreOffice Writer), the images will be preserved.</li></ul><p>The automatic download of images is enabled by default and can be toggled from&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Media</em> → <em>Download images automatically.</em></p><h2>Configuring the images</h2><p>Clicking on an image will reveal a popup with multiple options:<br><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Images_image.png\"></p><h3>Alignment</h3><p>The first set of options configure the alignment are, in order:</p><figure class=\"table\"><table><thead><tr><th>Icon</th><th>Option</th><th>Preview</th><th>Description</th></tr></thead><tbody><tr><td><span class=\"tn-icon cke cke-object-inline\"></span></td><td>Inline</td><td><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Images_image.jpg\"></td><td>As the name suggests, the name can be put inside a paragraph and moved around similarly as if it was a block of text. Use drag &amp; drop or cut-paste to move it around.</td></tr><tr><td><span class=\"tn-icon cke cke-object-center\"></span></td><td>Centered image</td><td><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/1_Images_image.jpg\"></td><td>The image will be displayed as a block and centered, not allowing text in either the left or right of it.</td></tr><tr><td><span class=\"tn-icon cke cke-object-inline-right\"></span></td><td>Wrap text</td><td><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/3_Images_image.jpg\"></td><td>The image will be displayed to the left or the right of the text.</td></tr><tr><td><span class=\"tn-icon cke cke-object-left\"></span></td><td>Block align</td><td><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/2_Images_image.jpg\"></td><td>Similarly to <em>Centered image</em>, the image will be displayed as a block and aligned either to the left or to the right, but not allowing text to flow on either of its sides.</td></tr></tbody></table></figure><h3>Drawing over an image</h3><p>To draw or write over an image, press the <span class=\"tn-icon bx bxs-pen\"></span> <em>Convert image to a drawing canvas</em> button of its toolbar. The image becomes a drawing canvas that shows all of it, locked in place. See the drawing canvases section of <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>.</p><h2>Compression</h2><p>Since Trilium isn't really meant to be primary storage for image data, it attempts to compress and resize (with pretty aggressive settings) uploaded images before storing them to the database. You may then notice some quality degradation. Basic quality settings is available in&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Media</em>.</p><p>If you want to save images in their original resolution, it is recommended to save them as attachment to note (look for the contextual menu in&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>&nbsp;→ <em>Import files</em>).</p><h2>Aligning images side-by-side</h2><p>There are generally two ways to display images side by side:</p><ul><li>If they are roughly the same size, simply make the two images in-line, according to the alignment section above. The images can be dragged &amp; dropped onto the same line.</li><li>If they are on different size, create a <a href=\"#root/_help_NdowYOC1GFKS\">table</a> with invisible borders.</li></ul>",
+ "_help_0Ofbk1aSuVRu": "<figure class=\"image image-style-align-right image_resized\" style=\"width:50.47%;\"><img style=\"aspect-ratio:880/553;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Images/Image%20references_image.png\" width=\"880\" height=\"553\"></figure><p>Image references are an easy way to embed the preview of another note type into a&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;note.</p><h2>Supported note types</h2><ul><li><a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a></li><li><a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a></li><li><a class=\"reference-link\" href=\"#root/_help_gBbsAeiuUxI5\">Mind Map</a></li></ul><h2>Steps</h2><ol><li>Go to one of the supported notes (listed above) and look for the&nbsp;<span class=\"tn-icon bx bx-copy\"></span> button in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_1P8QXI5edXNd\">Note buttons</a>&nbsp;area.</li><li>Go to a&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;note and use the Paste function to insert the reference to that note.</li></ol><h2>Interaction</h2><ul><li>Double-clicking an image reference from a text note will automatically open the target note.</li><li>Clicking an image reference while <kbd>Ctrl</kbd> is pressed will open the target note in a new tab.</li><li>Modifying the target note should also update the image reference. If that doesn't happen, consider&nbsp;<a class=\"reference-link\" href=\"#root/_help_s8alTXmpFR61\">Refreshing the application</a>.</li></ul>",
+ "_help_VRoP0g1uHHc2": "<figure class=\"image image-style-align-center image_resized\" style=\"width:76.29%;\"><img style=\"aspect-ratio:1479/865;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/In-editor%20AI%20assistant_image.png\" width=\"1479\" height=\"865\"></figure><p>The AI assistant works on the text you are already writing: select a passage and have it rewritten, translated or turned into a table, or ask for new content at the cursor. Unlike the <a href=\"#root/_help_LrKznOtw9cQD\">AI chat</a>, it does not open a conversation window, the result is previewed in place and only enters the note when you accept it.</p><h2>Requirements</h2><p>The assistant is only available once at least one provider is configured in&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>AI / LLM</em>, with at least one model selected for it. Until then the toolbar entry is not shown at all.</p><h2>Accessing the AI assistant</h2><p>To access the AI assistant:</p><ul><li>Look for the&nbsp;<span class=\"tn-icon cke cke-trilium-ai\"></span> button in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>. Press the button itself to enter the <em>Ask AI</em> mode or press the arrow key next to it to access the quick commands and the model selection.</li><li>Look for <em>AI assistant</em> or any of the <em>AI</em>-prefixed quick commands in&nbsp;<a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a>.</li><li>Press <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>K</kbd>.</li><li>Select a text and choose the <em>AI assistant</em> option in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_jcQVxzYybYgz\">Note contextual menu</a>.</li></ul><h2>What the assistant works on</h2><figure class=\"table\"><table><thead><tr><th>Situation</th><th>What is sent</th></tr></thead><tbody><tr><td>Text is selected</td><td>The selection.</td></tr><tr><td>Nothing is selected, and you pick a quick action</td><td>The paragraph the cursor is in.</td></tr><tr><td>Nothing is selected, and you type your own prompt</td><td>Nothing, the response is new content written at the cursor.</td></tr></tbody></table></figure><p>In all cases the assistant also sends the text before and after the target, so that the model can tell what it is writing into: asked to <em>Continue writing</em> or to summarize, a model that can only see the selected words is guessing at the document around them. This surrounding text is context only, it is never rewritten.</p><aside class=\"admonition important\"><p>That means a single run sends more than the passage you highlighted. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_cRRrdZjgyhNc\">Privacy</a>&nbsp;for exactly what leaves your machine.</p></aside><h2>Quick actions</h2><p>The arrow beside the toolbar button opens a menu of ready-made instructions, grouped by what they do.</p><ul><li>The <em>Reformat</em> actions produce real Trilium content rather than plain text: <em>Diagram</em> inserts a Mermaid diagram, <em>Callout</em> an admonition, and <em>Collapsible</em> a collapsible block.</li><li>The <em>Translate</em> group lists the <a href=\"#root/_help_veGu4faJErEM\">content languages</a> you have enabled, or a predefined list if no content languages are set. It can be filled from within the editor, the last entry of the submenu opens the language configuration directly.</li></ul><p>Actions that need something to work on are greyed out when there is nothing to work on (for example an empty paragraph with no selection).</p><h2>Asking for something specific</h2><p>Choosing <em>Ask AI…</em> (<span class=\"tn-icon bx bx-message-square-dots\"></span>) opens a prompt where you can describe the change in your own words, for example: \"make this less formal\", \"add a row for 2024\", \"write an intro paragraph for this section\". Press <kbd>Enter</kbd> or the <span class=\"tn-icon cke cke-arrow-up\"></span> send button to run it.</p><p>Once a response arrives you can keep going in the same prompt, and the assistant treats it as a conversation rather than as a fresh request: after <em>Translate this to German</em>, asking for <em>make it shorter</em> shortens the German, not the original.</p><h2>Reviewing the result</h2><p>The response streams in as it is generated, and can be interrupted at any point by pressing the <em>Stop</em> (<span class=\"tn-icon cke cke-stop\"></span>) button; whatever arrived before that stays usable.</p><p>Nothing is written into the note until you say so. The review offers:</p><ul><li><em>Result</em>, which displays the response as it will be inserted.</li><li><em>Changes</em>, which displays an inline diff against the original, with insertions and deletions marked. When the model rewrote the passage rather than editing it, the review opens on <em>Result</em> instead: a diff of two texts with little in common is harder to read than the answer itself.</li><li><em>Try again</em> (<span class=\"tn-icon cke cke-refresh\"></span>), to re-run the same instruction.</li><li><em>Replace</em>, which substitutes the original passage</li><li><em>Insert below</em>, which keeps the original and adds the response after it.</li></ul><p>Trilium also reports the model that produced it, the tokens consumed and, for providers that report it, the price.</p><p>If you ask for a correction and there is nothing to correct, the assistant will indicate it instead of showing a blank diff.</p><h2>Choosing the model</h2><p>The bottom of the quick actions menu shows which model the assistant runs on, and lets you pick another from the models you selected in&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>AI / LLM</em>, grouped by provider.</p><p>The model can also be changed while asking for something specific, or after the assistant has generated its response (i.e. if the response needs a better model).</p><p>This choice is separate from the model used by the chat, and is remembered across notes and devices. Left unset, the assistant follows the first configured provider.</p>",
+ "_help_mVEYwt20exhO": "<p><em>Quick actions</em> are a feature of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_VRoP0g1uHHc2\">In-editor AI assistant</a>&nbsp;for&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes which automatically triggers an LLM suggestion based on a defined prompt. The built-in quick actions come with a predefined prompt, but it is also possible to define your own quick actions.</p><h2>Creating a custom quick action</h2><p>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>: </p><ol><li>Right-click the note where you want to place the quick action.</li><li>Select <em>Insert child note</em>.</li><li>Select <em>More</em> → <em>AI Quick Action</em>. The entry appears only when AI is enabled.</li></ol><p>Afterwards, simply type in the content of the note the desired prompt. The text can be formatted in the same manner as a normal text note and it will be passed to the LLM as Markdown.</p><p>The title of the note will become the title of the quick action.</p><p>Of note:</p><ul><li><a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;notes work too.</li><li>An empty note is ignored.</li><li><a class=\"reference-link\" href=\"#root/_help_MKmLg5x6xkor\">Archived Notes</a>&nbsp;are also excluded.</li></ul><h2>Using a quick action</h2><p>Once a quick action is defined, the action will appear under the <em>Quick Actions</em> dropdown in a group called <em>Custom</em>.</p>",
+ "_help_nBAXQFj20hS1": "<p>Text notes can \"include\" another note as a read-only widget or an interactive widget, depending on the type of note.</p><p>This can be useful for e.g. including a dynamically generated chart (from scripts &amp; \"render HTML\" note) or other more advanced use cases.</p><h2>Including a note</h2><p>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>, look for the&nbsp;<span class=\"tn-icon cke cke-trilium-note\"></span> button. There is also a keyboard shortcut defined for it but it is not allocated by default.</p><p>To include a note that is already linked, right-click a reference link to it in a text note being edited and select <em>Convert link to an included note</em>, at the end of the menu. The include gets the box size that suits the note, as one added from the button does.</p><p>An <a href=\"#root/_help_0vhv7lsOLy82\">attachment</a> can be included the same way, from the context menu of a link to it (see <em>Embedding an attachment</em> there).</p><p>A link to blocks of a text note is converted the same way, with <em>Convert link to note excerpt</em>, and the include then shows only those blocks. See <a class=\"reference-link\" href=\"#root/_help_klC3ilXa9kUE\">Block references</a>.</p><h2>Box sizes</h2><p>The box size sets how much of the included note is shown.</p><ul><li><em>Tiny</em> shows a single row instead of the content: the note's icon, its title with the path to the note above it, and buttons to act on the note. The included note is never rendered, so wherever the note is shown outside the editor, such as in print, in a tooltip or on a shared page, a <em>Tiny</em> include appears as a link to the included note.</li><li><em>Small</em> and <em>Medium</em> show the content in a box of limited height. Text scrolls inside the box, while a picture, a diagram or a video is scaled down to fit it.</li><li><em>Full</em> shows the whole content.</li><li><em>Expandable</em> shows only the title until its <span class=\"tn-icon bx bx-chevron-right\"></span> arrow is pressed. In a read-only note, a click anywhere on the title row other than its buttons and link expands or collapses it as well.</li></ul><p>A new include gets the size that suits what it shows:</p><ul><li><em>Tiny</em> for a note or an attachment that has no preview, such as a relation map or an archive.</li><li><em>Small</em> for audio.</li><li><em>Full</em> for a code note or a code file, such as a <code>.js</code>, <code>.py</code> or <code>.txt</code> attachment, and for an excerpt of the blocks of a text note.</li><li><em>Medium</em> for anything else.</li></ul><p>The dialog that includes a note selects that size once the note is picked, and you can choose another one there. To change the size later, select the include and use the <em>Box size</em> menu in its toolbar, or the <em>Size</em> submenu of its <em>More actions</em> menu.</p><h2>Resizing</h2><p>A <em>Small</em>, <em>Medium</em> or <em>Expandable</em> include can be resized to any width and height. A <em>Tiny</em> or <em>Full</em> include always fits its content.</p><ul><li>To resize an include, select it and drag the handle in its bottom-right corner. To change only the width or only the height, drag the middle of its right or bottom edge instead, where a touch screen shows a handle too. In right-to-left text, the handle is in the bottom-left corner and the width changes from the left edge.</li><li>Resizing works with a mouse, a pen or a finger.</li><li>While the height changes, moving the handle near the top or the bottom of the note scrolls the note.</li><li>An include narrower than the note is centered, so changing its width moves both of its sides. Making it as wide as the note returns it to the full width.</li><li>To cancel a resize, press <kbd>Esc</kbd> before releasing the handle.</li><li>To reset the size, double-click the corner handle, or double-tap it on a touch screen. Double-clicking the right or bottom edge resets only the width or the height.</li><li>Choosing a box size resets the height. Choosing <em>Tiny</em> or <em>Full</em> resets the width too.</li><li>While an <em>Expandable</em> include is collapsed, only its width can be changed.</li></ul><h2>Caption</h2><p>An include can have a caption, shown centered at the bottom of its box. The caption is part of the text note, so it can be formatted like the rest of the text, for example in bold or with a link.</p><ul><li>To add a caption, select the include, press the <span class=\"tn-icon cke cke-caption\"></span> <em>Toggle caption on</em> button in its toolbar and type the caption.</li><li>To remove the caption, press the same button again. Pressing it once more brings back the text it had, as long as the note stays open.</li><li>A <em>Tiny</em> include has no caption. Switching an include to <em>Tiny</em> removes its caption, and switching it back to a larger size restores the caption, as long as the note stays open.</li><li>An <em>Expandable</em> include shows its caption under the title while the content is collapsed, and under the content once it is expanded.</li></ul><h2>Title</h2><p>The title row of an include links to the included note and holds its buttons. To show only the content, select the include and press the <span class=\"tn-icon bx bx-window-alt\"></span> <em>Show title</em> button in its toolbar. Pressing it again shows the title.</p><ul><li>While the title is hidden, the <span class=\"tn-icon cke cke-three-vertical-dots\"></span> <em>More actions</em> button in the toolbar of the include opens the menu of the included note.</li><li>A <em>Tiny</em> or <em>Expandable</em> include always shows its title, and its toolbar has no <em>Show title</em> button.</li></ul><h2>Opening an included note</h2><p>To open an included note in a new tab, press the <span class=\"tn-icon bx bx-link-external\"></span> <em>Open in new tab</em> button at the end of its title. An embedded attachment has the same button.</p><p>The <span class=\"tn-icon bx bx-dots-vertical-rounded\"></span> <em>More actions</em> button at the end of the title row opens the same menu as right-clicking anywhere on the title row: the other places to open the note in and, for an embedded attachment, the actions on the attachment.</p><p>In a note being edited, the menu also has the commands of the include's toolbar: the <em>Size</em> submenu, <em>Show title</em> and <em>Show caption</em>, each checked while it is in effect, and <em>Convert to link</em> at the end. A drawing canvas, an included text or code note and an embedded code file also have <em>Editable</em>, above <em>Size</em>. For an embedded attachment they follow its first group of actions; for an included note they end the menu.</p><p>To show an include of size <em>Medium</em> or <em>Full</em> on the whole screen, press the <span class=\"tn-icon bx bx-fullscreen\"></span> <em>Fullscreen</em> button at the end of its title. An excerpt of the blocks of a note has an <span class=\"tn-icon bx bx-pencil\"></span> <em>Edit excerpt</em> button there instead; see <a class=\"reference-link\" href=\"#root/_help_klC3ilXa9kUE\">Block references</a>. To return, press <span class=\"tn-icon bx bx-exit\"></span> <em>Exit fullscreen</em> in the top-right corner, or <kbd>Esc</kbd>.</p><p>A <em>Tiny</em> include has these buttons instead, followed by the same <em>More actions</em> button:</p><ul><li>For a note, <span class=\"tn-icon bx bx-edit\"></span> <em>Quick edit</em> opens the note in&nbsp;<a class=\"reference-link\" href=\"#root/_help_ZjLYv08Rp3qC\">Quick edit</a>, and <span class=\"tn-icon bx bx-link-external\"></span> <em>Open in new tab</em> opens it in a new tab.</li><li>For an embedded attachment, <span class=\"tn-icon bx bx-file-find\"></span> <em>Open externally</em> opens the file in another application, and <span class=\"tn-icon bx bx-download\"></span> <em>Download</em> downloads it. The size of the file is shown under its title.</li></ul><h2>Converting an include to a link</h2><p>To replace an include with a link to the included note, select it and press the <span class=\"tn-icon cke cke-link\"></span> <em>Convert to link</em> button in its toolbar, or choose <em>Convert to link</em> at the end of its <em>More actions</em> menu. An embedded attachment turns into a link to the attachment the same way.</p><h2>Included notes in the share functionality</h2><p>If a <a href=\"#root/_help_R9pX4DGra2Vt\">shared note</a> contains one or more included notes, they will be displayed in the content of the note as if they were part of the note itself. The caption of an include is shown under the included content. A <em>Tiny</em> include is shown as a link to the included note instead, and so is an include that would show a note already shown around it, such as a note that includes itself. The same goes for a printed or exported note.</p><p>For this to work, the included notes must also be shared, otherwise they will not be shown. However, the included notes can still be hidden from the note tree via <code>#shareHiddenFromTree</code>.</p><h2>Interactive notes</h2><p>Since v0.104.0, included notes might become interactive depending on their note type:</p><ul><li><a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>&nbsp;(e.g.&nbsp;<a class=\"reference-link\" href=\"#root/_help_81SGnPGMk7Xc\">Geo Map</a>) will render fully interactive, including creating new notes.</li><li><a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a>&nbsp;will also display the results.</li><li><a class=\"reference-link\" href=\"#root/_help_1vHRoWCEjj0L\">Web View</a>&nbsp;provides an interactive preview of the website.</li></ul><h2>Included images</h2><p>An included image, whether an image note or an image attachment, is shown in the image viewer, which zooms and pans it:</p><ul><li>To zoom, press the <span class=\"tn-icon bx bx-plus-circle\"></span> <em>Zoom in</em> and <span class=\"tn-icon bx bx-minus-circle\"></span> <em>Zoom out</em> buttons in the bottom-right corner of the image, or pinch on a touch screen. The percentage between them resets the zoom.</li><li>To zoom with the mouse wheel, click the image first. Until then, the mouse wheel scrolls the note.</li><li>To pan an image that is zoomed in, drag it. At its fitted size, dragging the image on a touch screen scrolls the note.</li><li>To return to the fitted size, double-click the image.</li></ul><p>In a <em>Small</em> or <em>Medium</em> box, the image is scaled down to fit the height of the box. In fullscreen, it fits the screen.</p><h2>Editing an include in place</h2><p>An included text note, an included code note and an embedded code file such as a <code>.js</code>, <code>.py</code> or <code>.txt</code> attachment can be edited without leaving the note that includes them. A code note or file is shown with syntax highlighting until then.</p><ul><li>To edit, select the include and turn on the <span class=\"tn-icon bx bx-edit-alt\"></span> <em>Editable</em> button at the start of its toolbar, or check <em>Editable</em> in its <span class=\"tn-icon cke cke-three-vertical-dots\"></span> <em>More actions</em> menu. Turn <em>Editable</em> off to return to the preview.</li><li>While an included text note has the focus, the formatting toolbar applies to it. The notes it includes in turn stay read-only.</li><li>Code is edited in the same code editor as a <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> note, with its theme, indentation and line wrapping settings.</li><li>The changes are saved as you type, to the included note or to the attachment, as they would be in its own tab.</li><li>An include of <a class=\"reference-link\" href=\"#root/_help_klC3ilXa9kUE\">Block references</a> edits only the referenced blocks.</li><li>Editing is not available in a <a href=\"#root/_help_CoFPLs3dRlXc\">read-only note</a>, for an included note marked <code>#readOnly</code>, or for an attachment of another note.</li></ul><h2>Drawing canvases</h2><p>A drawing canvas is an Excalidraw canvas, like the one of a <a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a> note, drawn directly in the text note. It is not a note of its own: the drawing is kept in a <code>Canvas.excalidraw</code> <a href=\"#root/_help_0vhv7lsOLy82\">attachment</a> of the text note and is saved together with the text.</p><ul><li>To insert a drawing canvas, open the <span class=\"tn-icon cke cke-plus\"></span> <em>Insert</em> menu of the <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a> and choose <span class=\"tn-icon bx bx-pen\"></span> <em>Drawing canvas</em>, above <em>Mermaid diagram</em>. It is also available as <em>Drawing canvas</em> in the <a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a>. The canvas is added empty and editable, in a <em>Medium</em> box with its title hidden, and takes the focus, ready for drawing.</li><li>To draw or write over an image, select the image and press the <span class=\"tn-icon bx bxs-pen\"></span> <em>Convert image to a drawing canvas</em> button of its toolbar. The image is replaced by an editable drawing canvas in a <em>Medium</em> box, with its title hidden and the focus in it. The image sits at its original size in the middle of the canvas, zoomed so that all of it shows, and is locked so that it cannot be selected or moved by accident. While it is locked, the canvas can be zoomed in on the image but not zoomed out past it or scrolled beyond its edges. To move or resize the image anyway, right-click it and choose <em>Unlock</em>. The caption of the image is kept, but not its alignment or link. Only an image on its own line can be converted, not one inside a paragraph. Undo brings the image back.</li><li>An Excalidraw file (<code>.excalidraw</code>) attached with the <span class=\"tn-icon cke cke-paper-clip\"></span><em>Attach file</em> button becomes a drawing canvas too, in a <em>Medium</em> box titled with the file name. It starts with <em>Editable</em> off, so the drawing shows but cannot be changed until <em>Editable</em> is turned on (see below).</li><li>To draw on a canvas that does not have the focus, click it first. Until then, touch gestures scroll the note. The canvas then has the tools, menus and keyboard shortcuts of a Canvas note. The toolbars, the menus and the properties of the selected shapes show only while the canvas has the focus, so elsewhere the drawing reads like a picture in the text.</li><li>The mouse wheel and the touchpad scroll the note over a canvas too, as over the text. To zoom, use the zoom buttons of the canvas toolbar; to move around the drawing, use the <span class=\"tn-icon bx bxs-hand\"></span> <em>Hand</em> tool. In fullscreen, the mouse wheel moves and zooms the drawing instead.</li><li>The canvas toolbar replaces the Excalidraw menu: <em>Export image</em>, <em>Find on canvas</em>, <em>Library</em> and <em>Help</em> are at the end of its <span class=\"tn-icon bx bx-category\"></span> <em>More tools</em> menu. In fullscreen, the Excalidraw menu shows again.</li><li>A new drawing has the background color of the note. A background chosen from the Excalidraw menu replaces it.</li><li>To protect a finished drawing from accidental changes, select it and turn off the <span class=\"tn-icon bx bx-edit-alt\"></span> <em>Editable</em> button at the start of its toolbar, or uncheck <em>Editable</em> in its <span class=\"tn-icon cke cke-three-vertical-dots\"></span> <em>More actions</em> menu. The drawing then shows as a still picture, at the zoom and position it had, and can no longer be changed, zoomed or moved. To draw again, turn <em>Editable</em> back on.</li><li>The box sizes, resizing, the caption and the title work as for an included note, but the toolbar of a drawing leaves the box size, <em>Show title</em> and <em>Convert to link</em> to its <em>More actions</em> menu.</li><li>In the desktop layout, Excalidraw keeps its desktop interface however small the box is. In the mobile layout, a narrow or short box switches it to a compact interface. For more room, choose <em>Full</em>, or show the title and press <span class=\"tn-icon bx bx-fullscreen\"></span> <em>Fullscreen</em>.</li><li>Pictures added to the drawing are stored in the same attachment. A converted image is kept as an image attachment of the note instead, named with a generated code.</li><li>In a <a href=\"#root/_help_CoFPLs3dRlXc\">read-only note</a>, the drawing shows as a still picture too.</li><li>On a <a href=\"#root/_help_R9pX4DGra2Vt\">shared page</a>, the drawing is shown as a picture at its own size, whatever the size of its box, in light or dark colors to match the page. Each change to the drawing saves this picture as an SVG image attachment of the note, also named with a generated code.</li></ul><h3>Limitations</h3><ul><li>The Excalidraw shape library is not saved for a drawing canvas.</li><li>Outside the editor, for example in a tooltip, when printing or in the list of attachments, the drawing is shown as a picture.</li><li>A drawing has no picture for shared pages until its first change, except one converted from an image. Until then, for example for an attached <code>.excalidraw</code> file, a shared page shows a link to download the drawing instead.</li><li>In Safari, the picture of a drawing on a shared page follows the light or dark appearance of the system rather than the theme chosen on the page.</li><li>A copy of a drawing canvas pasted in the same note shares the drawing with the original, so a change to one shows in the other only after the note is opened again. A copy pasted in another note gets a drawing of its own.</li></ul>",
+ "_help_CohkqWQC1iBv": "<p>Press the&nbsp;<span class=\"tn-icon cke cke-plus\"></span> button in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>&nbsp;to reveal special inserable items and blocks such as symbols, Math expressions and separators.</p><h2>Bookmarks</h2><p>See the dedicated&nbsp;<a class=\"reference-link\" href=\"#root/_help_oSuaNgyyKnhu\">Anchors</a>&nbsp;section.</p><h2>Emoji</h2><figure class=\"image image-style-align-right image_resized\" style=\"width:42.4%;\"><img style=\"aspect-ratio:366/410;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Insert%20buttons_plus.png\" width=\"366\" height=\"410\"></figure><p>This feature allows inserting Unicode emoji characters. Simply select a category and a desired emoji to insert it.</p><p>Emojis can also be searched by their English name and the skin tone can be selected via a combo box to the right.</p><p>There is also the possibility of inserting emojis directly by typing <code>:</code> followed by a name of an emoji, triggering the display of a list of emojis. Simply use the arrow keys to select one and press <kbd>Enter</kbd> or <kbd>Tab</kbd> to insert it.</p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/1_Insert%20buttons_plus.png\" width=\"272\" height=\"187\"><h2>Symbols</h2><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:346/322;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Insert%20buttons_image.png\" width=\"346\" height=\"322\"></figure><p>Pressing the&nbsp;<span class=\"tn-icon cke cke-special-characters\"></span> button will reveal a popup window displaying a list of characters that are generally more difficult to insert directly from the keyboard, such as a subset of emojis, quotation characters, etc.</p><p>Interaction:</p><ul><li>Click on a character to insert it at the current cursor position.</li><li>The window can be dragged around by the top bar where the title is, to avoid it getting in the way of the text.</li><li>Click on the <em>Category</em> selector to filter the characters.</li></ul><h2>Multicolumn layout</h2><p>See the dedicated&nbsp;<a class=\"reference-link\" href=\"#root/_help_wYDzQ1fBFgfT\">Multicolumn layout</a>&nbsp;page.</p><h2>Math equations</h2><p>See the dedicated&nbsp;<a class=\"reference-link\" href=\"#root/_help_YfYAtQBcfo5V\">Math Equations</a>&nbsp;page.</p><h2>Drawing canvas</h2><p>Choose <span class=\"tn-icon bx bx-pen\"></span> <em>Drawing canvas</em> to draw on an Excalidraw canvas inside the text. See <em>Drawing canvases</em> in <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>.</p><h2>Mermaid diagram</h2><p>Press the&nbsp;<span class=\"tn-icon cke cke-trilium-mermaid-insert\"></span> button to create an inline Mermaid diagram.</p><p>This feature is quite similar to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a>&nbsp;note types and is meant as an alternative to it for simple diagrams. For more complex diagrams, use the&nbsp;<a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>&nbsp;feature for a dedicated Mermaid note.</p><figure class=\"image\"><img style=\"aspect-ratio:1174/358;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/2_Insert%20buttons_image.png\" width=\"1174\" height=\"358\"></figure><h2>Horizontal ruler</h2><p>This feature will display a horizontal line, generally useful to separate different sections of the text. To do so, press the&nbsp;<span class=\"tn-icon cke cke-horizontal-line\"></span> button in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>.</p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/1_Insert%20buttons_image.png\" width=\"502\" height=\"95\"><p>Alternatively, it's possible to insert a horizontal ruler by typing <code>---</code>.</p><h2>Page break</h2><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:371/79;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/3_Insert%20buttons_image.png\" width=\"371\" height=\"79\"></figure><p>Page breaks provide a way to force the next paragraph or block (table, image, etc.) to be displayed onto the next page when printing (either to a real printer to <a href=\"#root/_help_NRnIZmSMc5sj\">when exporting to PDF</a>).</p><p>Page breaks are marked in the editor with the words <em>Page break</em>, but they will not actually be shown when printed.</p><ul><li>To insert a page break, press the&nbsp;<span class=\"tn-icon cke cke-page-break\"></span> in the formatting toolbar.</li><li>To insert many page breaks at once, insert a page break first, click on it and press <kbd>Ctrl</kbd>+<kbd>C</kbd>. Then use <kbd>Ctrl</kbd>+<kbd>V</kbd>, to paste as many times as needed.</li></ul><h2>Date and time</h2><p>The <span class=\"tn-icon cke cke-trilium-date-time\"></span> button inserts the current date and time at the cursor, replacing the selected text if there is any. The inserted text takes the formatting of the text around it, so a date inserted inside bold text is bold too.</p><ul><li>To insert the date in the default format, press the button itself or press <kbd>Alt</kbd>+<kbd>T</kbd>.</li><li>To insert it in another format, press the arrow next to the button and pick a format from the list. Each entry shows the current date and time in that format: the default one, the date or the time alone, the date written out, and ISO 8601.</li><li>The same formats are offered by the <a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a>: type <code>/date</code>, <code>/time</code>, <code>/now</code> or <code>/today</code>. The <em>Insert date/time</em> entry uses the default format, and shows what it inserts underneath; the other entries show their output in the title.</li></ul><p>The default format can be changed in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Text Notes</em> → <em>Editor</em> → <em>Date/time format</em>, using <a href=\"https://day.js.org/docs/en/display/format\">Day.js format tokens</a> (for example <code>DD.MM.YYYY HH:mm</code>).</p><h2>Icons</h2><p>Icons just like the ones for the <a href=\"#root/_help_p9kXRFAkwN4o\">note icon</a> can be inserted in text. For more information see&nbsp;<a class=\"reference-link\" href=\"#root/_help_hD8GawVuazff\">Icons</a>.</p>",
+ "_help_hD8GawVuazff": "<p>Icons just like the <a href=\"#root/_help_hD8GawVuazff\">note icons</a> can be inserted in the content of a note, including from any other <a href=\"#root/_help_gOKqSJgXLcIj\">custom icon packs</a>.</p><h2>Features</h2><ul><li>The icon can be formatted through the<a class=\"reference-link\" href=\"#root/_help_Gr6xFaF6ioJ5\">General formatting</a>&nbsp;tools of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>:<ul><li>Foreground/icon color</li><li>Background color/highlight</li><li>Font size</li></ul></li><li>Custom&nbsp;<a class=\"reference-link\" href=\"#root/_help_gOKqSJgXLcIj\">Icon Packs</a>&nbsp;are also supported.<ul><li>For emojis, prefer the Emoji functionality from&nbsp;<a class=\"reference-link\" href=\"#root/_help_CohkqWQC1iBv\">Insert buttons</a>.</li></ul></li><li>When an icon is clicked a floating toolbar appears with the following functions:<ul><li><span class=\"tn-icon bx bx-sticker\"></span>&nbsp;which changes the icon.</li><li><span class=\"tn-icon bx bx-reflect-horizontal\"></span>&nbsp;which applies transforms: rotate (90 / 180 / 270) and flip horizontal/vertical. Only one transform can be used per icon.</li></ul></li></ul><h2>Usage</h2><ul><li>The in-app help/user guide makes use of these icons in order to illustrate buttons in the UI.</li><li>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_GnhlmrATVqcH\">Microsoft OneNote</a>&nbsp;importer also makes use of them for the&nbsp;<a class=\"reference-link\" href=\"#root/_help_LpvyEIBIAAj7\">Tags</a>.</li></ul><h2>Inserting an icon</h2><p>There are two ways to insert an icon:</p><ul><li>Via the&nbsp;<a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>&nbsp;look for the&nbsp;<span class=\"tn-icon bx bx-plus\"></span> icon and then the&nbsp;<span class=\"tn-icon bx bx-sticker\"></span> icon.</li><li>Via&nbsp;<a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a>, type <code>/icon</code>.</li></ul><p>An icon picker will appear, search for an icon and click it to insert it in the document.</p><h2>Finding notes by their icons</h2><p>An icon can be <a href=\"#root/_help_eIg8jdvaoNNd\">searched</a>. A note containing a&nbsp;<span class=\"tn-icon bx bx-star\"></span> icon can be found by searching for <code>star</code>, or its <code>iconClass</code> (<code>bx-star</code>).</p><p>To find the name of the icon, hover the mouse over an icon while in the icon picker.</p><h2>Markdown rendering</h2><p>When exporting to&nbsp;<a class=\"reference-link\" href=\"#root/_help_Oau6X9rCuegd\">Markdown</a>, the item will render as raw HTML representation of the icon as is used by Trilium:</p><pre><code class=\"language-text-html\">&lt;span class=\"tn-icon bx bx-star\"&gt;&lt;/span&gt;</code></pre>",
+ "_help_oiVPnW8QfnvS": "<h2>Trilium-specific shortcuts</h2><figure class=\"table\"><table><thead><tr><th>Action</th><th>PC</th><th>Mac</th></tr></thead><tbody><tr><td>Bring up inline formatting toolbar (arrow keys ←,→ to navigate, Enter to apply)</td><td>Alt+F10</td><td>⌥+F10</td></tr><tr><td>Bring up block formatting toolbar</td><td>Alt+F10</td><td>⌥+F10</td></tr><tr><td>Create <a href=\"#root/_help_QEAPj01N5f7w\">external link</a></td><td>Ctrl+K</td><td>⌘+K</td></tr><tr><td>Create <a href=\"#root/_help_QEAPj01N5f7w\">internal (note) link</a></td><td>Ctrl+L</td><td>⌘+L</td></tr><tr><td>Inserts current date and time at caret position</td><td>Alt+T</td><td>⌥+T</td></tr><tr><td>Increase paragraph indentation</td><td>Tab</td><td>⇥</td></tr><tr><td>Decrease paragraph indentation</td><td>Shift + Tab</td><td>⇧ + ⇥</td></tr><tr><td>Mark selected text as <a href=\"#root/_help_UYuUB1ZekNQU\">keyboard shortcut</a></td><td>Ctrl + Alt + K</td><td>⌘+ ⌥+ K</td></tr><tr><td>Insert&nbsp;<a class=\"reference-link\" href=\"#root/_help_YfYAtQBcfo5V\">Math Equations</a></td><td>Ctrl + M</td><td>⌘+ M</td></tr><tr><td>Move blocks (lists, paragraphs, etc.) up</td><td>Ctrl+↑</td><td>⌘+↑</td></tr><tr><td>Alt+↑</td><td>⌥+↑</td><td></td></tr><tr><td>Move blocks (lists, paragraphs, etc.) down</td><td>Ctrl+↑</td><td>⌘+↑</td></tr><tr><td>Alt+↓</td><td>⌥+↓</td><td></td></tr><tr><td>Move the selected content to another column of a <a class=\"reference-link\" href=\"#root/_help_wYDzQ1fBFgfT\">Multicolumn layout</a></td><td>Ctrl+←, Ctrl+→, Ctrl+Shift+Home, Ctrl+Shift+End</td><td>⌘+←, ⌘+→, ⌘+⇧+Home, ⌘+⇧+End</td></tr><tr><td>Move the current column of a multicolumn layout</td><td>Ctrl+Alt+←, Ctrl+Alt+→, Ctrl+Alt+Home, Ctrl+Alt+End</td><td>⌘+⌥+←, ⌘+⌥+→, ⌘+⌥+Home, ⌘+⌥+End</td></tr><tr><td>Add a column after or before the current one in a multicolumn layout</td><td>Ctrl+Enter, Ctrl+Shift+Enter</td><td>⌘+Enter, ⌘+⇧+Enter</td></tr><tr><td>Move the selected content to another tab in <a class=\"reference-link\" href=\"#root/_help_EK2ckIZ74tbT\">Content tabs</a></td><td>Ctrl+←, Ctrl+→, Ctrl+Shift+Home, Ctrl+Shift+End</td><td>⌘+←, ⌘+→, ⌘+⇧+Home, ⌘+⇧+End</td></tr><tr><td>Move the current tab of a tabs block</td><td>Ctrl+Alt+←, Ctrl+Alt+→, Ctrl+Alt+Home, Ctrl+Alt+End</td><td>⌘+⌥+←, ⌘+⌥+→, ⌘+⌥+Home, ⌘+⌥+End</td></tr><tr><td>Add a tab after or before the current one in a tabs block</td><td>Ctrl+Enter, Ctrl+Shift+Enter</td><td>⌘+Enter, ⌘+⇧+Enter</td></tr></tbody></table></figure><h2>Common shortcuts</h2><aside class=\"admonition tip\"><p>This section of keyboard shortcuts presents a subset of the keyboard shortcuts as supported by the editor technology we are using,&nbsp;<a class=\"reference-link\" href=\"#root/_help_MI26XDLSAlCD\">CKEditor</a>. The shortcuts were taken from the <a href=\"https://ckeditor.com/docs/ckeditor5/latest/features/accessibility.html#keyboard-shortcuts\">official documentation</a>. Note that not all the shortcuts in the original documentation are applicable (due to using a different configuration).</p></aside><h3>Content editing</h3><figure class=\"table\"><table><thead><tr><th>Action</th><th>PC</th><th>Mac</th></tr></thead><tbody><tr><td>Insert a hard break (a new paragraph)</td><td>Enter</td><td></td></tr><tr><td>Insert a soft break (a <code>&lt;br&gt;</code> element)</td><td>Shift+Enter</td><td>⇧Enter</td></tr><tr><td>Copy selected content</td><td>Ctrl+C</td><td>⌘C</td></tr><tr><td>Paste content</td><td>Ctrl+V</td><td>⌘V</td></tr><tr><td>Paste content as plain text</td><td>Ctrl+Shift+V</td><td>⌘⇧V</td></tr><tr><td>Undo</td><td>Ctrl+Z</td><td>⌘Z</td></tr><tr><td>Redo</td><td>Ctrl+Y, Ctrl+Shift+Z</td><td>⌘Y, ⌘⇧Z</td></tr><tr><td>Bold text</td><td>Ctrl+B</td><td>⌘B</td></tr><tr><td>Change text case</td><td>Shift+F3</td><td>⇧F3 (may require Fn)</td></tr><tr><td>Create link</td><td>Ctrl+K</td><td>⌘K</td></tr><tr><td>Move out of a link</td><td>←←, →→</td><td></td></tr><tr><td>Move out of an inline code style</td><td>←←, →→</td><td></td></tr><tr><td>Select all</td><td>Ctrl+A</td><td>⌘A</td></tr><tr><td>Find in the document</td><td>Ctrl+F</td><td>⌘F</td></tr><tr><td>Copy text formatting</td><td>Ctrl+Shift+C</td><td>⌘⇧C</td></tr><tr><td>Paste text formatting</td><td>Ctrl+Shift+V</td><td>⌘⇧V</td></tr><tr><td>Italic text</td><td>Ctrl+I</td><td>⌘I</td></tr><tr><td>Strikethrough text</td><td>Ctrl+Shift+X</td><td>⌘⇧X</td></tr><tr><td>Underline text</td><td>Ctrl+U</td><td>⌘U</td></tr><tr><td>Revert autoformatting action</td><td>Backspace</td><td></td></tr></tbody></table></figure><h3>Interacting with blocks</h3><p>Blocks are images, tables, blockquotes, annotations.</p><figure class=\"table\"><table><thead><tr><th>Action</th><th>PC</th><th>Mac</th></tr></thead><tbody><tr><td>Insert a new paragraph directly after a widget</td><td>Enter</td><td></td></tr><tr><td>Insert a new paragraph directly before a widget</td><td>Shift+Enter</td><td>⇧Enter</td></tr><tr><td>Move the caret to allow typing directly before a widget</td><td>↑, ←</td><td></td></tr><tr><td>Move the caret to allow typing directly after a widget</td><td>↓, →</td><td></td></tr><tr><td>After entering a nested editable, move the selection to the closest ancestor widget. For example: move from an image caption to the whole image widget.</td><td>Tab then Esc</td><td></td></tr></tbody></table></figure><p>Specifically for lists:</p><figure class=\"table\"><table><thead><tr><th>Action</th><th>PC</th><th>Mac</th></tr></thead><tbody><tr><td>Increase list item indent</td><td>⇥</td><td></td></tr><tr><td>Decrease list item indent</td><td>Shift+⇥</td><td>⇧⇥</td></tr></tbody></table></figure><p>In tables:</p><figure class=\"table\"><table><thead><tr><th>Action</th><th>PC</th><th>Mac</th></tr></thead><tbody><tr><td>Move the selection to the next cell</td><td>⇥</td><td></td></tr><tr><td>Move the selection to the previous cell</td><td>Shift+⇥</td><td>⇧⇥</td></tr><tr><td>Insert a new table row (when in the last cell of a table)</td><td>⇥</td><td></td></tr><tr><td>Navigate through the table</td><td>↑, →, ↓, ←</td><td></td></tr></tbody></table></figure><h3>General UI shortcuts</h3><figure class=\"table\"><table><thead><tr><th>Action</th><th>PC</th><th>Mac</th></tr></thead><tbody><tr><td>Close contextual balloons, dropdowns, and dialogs</td><td>Esc</td><td></td></tr><tr><td>Open the accessibility help dialog</td><td>Alt+0</td><td>⌥0</td></tr><tr><td>Move focus between form fields (inputs, buttons, etc.)</td><td>⇥, Shift+⇥</td><td>⇥, ⇧⇥</td></tr><tr><td>Move focus to the toolbar, navigate between toolbars</td><td>Alt+F10</td><td>⌥F10 (may require Fn)</td></tr><tr><td>Navigate through the toolbar or menu bar</td><td>↑, →, ↓, ←</td><td></td></tr><tr><td>Navigate to the next focusable field or an element outside the editor</td><td>Tab, Shift+Tab</td><td></td></tr><tr><td>Execute the currently focused button. Executing buttons that interact with the editor content moves the focus back to the content.</td><td>Enter, Space</td><td></td></tr><tr><td>Move focus in and out of an active dialog window</td><td>Ctrl+F6</td><td>⌘F6 (may require Fn)</td></tr></tbody></table></figure>",
+ "_help_UmgZAfcltxkS": "<p>Link previews turn a pasted URL into a rich, metadata-aware widget that can be displayed in three visual modes:</p><h2>Display modes</h2><p>A link preview can be displayed in one of three modes:</p><ul><li><strong>Inline</strong> — a link showing the site's favicon and page title (quite similar to&nbsp;<a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>). Use this when you want the link to flow with the surrounding paragraph.</li><li><strong>Card</strong> — a block-level preview with thumbnail, title, description, and site name. Use this when the link is the focus of a paragraph.</li><li><strong>Embed</strong> — a block-level interactive embed.<ul><li>Currently supported for YouTube videos, which render interactively (via an <code>iframe</code>).</li><li>To prevent unwanted remote requests, the video is shown only after clicking on it first.</li></ul></li></ul><div class=\"trilium-multicolumn-layout\" data-trilium-column-ratios=\"1-1-1\"><div class=\"trilium-multicolumn-column\"><figure class=\"image image_resized\" style=\"width:100%;\"><img style=\"aspect-ratio:251/42;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Link%20Previews_image.png\" width=\"251\" height=\"42\"><figcaption><em>Inline</em> link preview</figcaption></figure></div><div class=\"trilium-multicolumn-column\"><figure class=\"image image_resized\" style=\"width:100%;\"><img style=\"aspect-ratio:1217/196;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/2_Link%20Previews_image.png\" width=\"1217\" height=\"196\"><figcaption><em>Card</em> link preview</figcaption></figure></div><div class=\"trilium-multicolumn-column\"><figure class=\"image image_resized\" style=\"width:100%;\"><img style=\"aspect-ratio:994/563;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/1_Link%20Previews_image.png\" width=\"994\" height=\"563\"><figcaption><em>Embed</em> link preview</figcaption></figure></div></div><h2>Inserting a link preview</h2><p>There are three ways to create one:</p><h3>1. By pasting a URL</h3><p>A link preview is automatically created:</p><ul><li>By pasting the URL and pressing <kbd>Space</kbd>. This will create an <em>inline</em> link preview.</li><li>When at the start of a new paragraph, pressing <kbd>Enter</kbd> will create a <em>card</em> or an <em>embed</em> for YouTube URLs.</li></ul><p>To undo an automatic link preview, press <kbd>Ctrl</kbd>+<kbd>Z</kbd> immediately afterwards which keeps it as a plain link instead. Alternatively, once a link preview was created, click on the link and select <em>Plain link</em> from the link preview toolbar.</p><p>This automatic conversion can be disabled by going to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Text Notes</em> and unchecking <em>Autogenerate link previews</em> from the <em>Features</em> section.</p><p>If the link is not accessible to the Trilium server (or the network request fails for any other reason), it will not be converted to a link preview.</p><aside class=\"admonition note\"><p>A URL is only auto-converted when the pasted text <em>is</em> the URL. Links with a display name (e.g. <a href=\"https://triliumnotes.org\">Trilium Notes website</a>) are left as plain links.</p></aside><h3>2. By using the \"Link preview\" toolbar button</h3><p>Click <em>Link preview</em> (<span class=\"tn-icon cke cke-trilium-link-preview\"></span>) in the formatting toolbar to open the <em>Link preview</em> popup. Paste the URL and choose the type of preview.</p><h3>3. By saving browser tabs from the Web Clipper</h3><p>When the&nbsp;<a class=\"reference-link\" href=\"#root/_help_MtPxeAWVAzMg\">Web Clipper</a>&nbsp;saves the tabs of a window, each tab becomes an <em>inline</em> link preview showing the title and favicon the browser displays for it. Because this data comes from the browser, pages behind a login keep their real title, and the Trilium server does not contact the saved pages.</p><p>When <em>Autogenerate link previews</em> is turned off, the tabs are saved as a list of plain links instead.</p><h2>Altering an existing link preview</h2><p>Click on an inserted link preview to select it, and a small toolbar will appear with the following options:</p><ul><li>The normal link operations (opening in a new tab, copying the link, unlinking).</li><li>A button to edit the title of the link preview. This is especially useful if the title is hidden behind a login screen.</li><li>A way to switch between the link preview modes (Inline, Card or Embed) as well as to convert it to a normal link instead.<ul><li>The Embed option is only enabled when the URL points to a supported service (YouTube today).</li></ul></li></ul><h2>Where the preview data comes from</h2><p>When you insert a link preview, Trilium fetches metadata once and stores it inside the note's HTML:</p><ul><li><strong>YouTube URLs</strong> — title, channel name, and thumbnail are fetched via YouTube's public oEmbed endpoint.</li><li><strong>All other URLs</strong> — Trilium fetches the page and reads OpenGraph tags (<code>og:title</code>, <code>og:description</code>, <code>og:image</code>, <code>og:site_name</code>), falling back to the page's <code>&lt;title&gt;</code> and <code>&lt;meta name=\"description\"&gt;</code>. The site's favicon is downloaded and inlined.</li></ul><p>Because the data is stored in the note itself, link previews continue to render correctly when you reopen the note, share/publish it, or export to HTML — without any further network requests.</p><p>The metadata is captured <strong>at insertion time</strong> and is not automatically refreshed. If the linked page later changes its title or thumbnail, you'll need to re-insert the link to pick up the new values. To refresh a link, simply create it again.</p><p>When accessing a&nbsp;<a class=\"reference-link\" href=\"#root/_help_WOcw2SLH6tbX\">Server Installation</a>, the data is fetched from the remote URL by the server and not the client.</p><h2>Known limitations</h2><ul><li>The Embed display mode currently only supports YouTube. Other video and media platforms fall back to a Card preview.</li><li>Pages that block automated fetches may produce a minimal preview (hostname only).</li><li>Link previews require the Trilium server to reach the target URL, so they won't generate previews for pages on networks the server can't see.</li></ul>",
+ "_help_QEAPj01N5f7w": "<p>There are two types of links:</p><ul><li><a class=\"reference-link\" href=\"#root/_help_3IDVtesTQ8ds\">External links</a>, for standard hyperlinks to websites or other resources.</li><li><a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>&nbsp;for links to other notes within Trilium.<ul><li>The list of notes that refer to a particular note is called&nbsp;<a class=\"reference-link\" href=\"#root/_help_wfGXLmm7x27z\">Backlinks</a>.</li></ul></li></ul><h2>Note map</h2><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>",
+ "_help_3IDVtesTQ8ds": "<p>An external link is a standard web link targeting for example a website. For example, <a href=\"https://en.wikipedia.org/wiki/South_China_Sea\">https://en.wikipedia.org/wiki/South_China_Sea</a> is an external link to a Wikipedia page.</p><p>To create a link without a custom text:</p><ul><li>Press&nbsp;<span class=\"tn-icon cke cke-link\"></span> in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>:<ul><li>A popup will appear, type or paste the URL in the box.</li><li>Press <kbd>Enter</kbd> or the check mark icon to confirm.</li></ul></li><li>Alternatively, press <kbd>Ctrl</kbd>+<kbd>K</kbd> to trigger the aforementioned popup.</li><li>A simpler way is to paste the raw link and press space to turn it automatically into a link.</li></ul><p>To create a link with a custom text:</p><ul><li>First, type and select the text which will be turned into a link.</li><li>Follow the previous steps to open the link interface (via the formatting toolbar, or <kbd>Ctrl</kbd>+<kbd>K</kbd>).</li><li>Alternatively, simply paste (<kbd>Ctrl</kbd>+<kbd>V</kbd>) over the selected text to turn it into a link.</li></ul><p>Once a link is inserted:</p><ul><li>The text inside the link can be changed if needed but the link itself will remain.</li><li>To modify the link, click on the link to display the popup and press the&nbsp;<span class=\"tn-icon cke cke-pencil\"></span> <em>Edit link</em> button.</li><li>To remove a link, click on it and press the&nbsp;<span class=\"tn-icon cke cke-unlink\"></span> <em>Unlink</em> button.</li></ul><p>You can follow external link by either double clicking (will open new tab/window) it or right clicking on them and choosing \"Open in new tab\".</p>",
+ "_help_hrZ1D00cLbal": "<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&nbsp;<span class=\"tn-icon cke cke-trilium\"></span> button underneath the&nbsp;<span class=\"tn-icon cke cke-plus\"></span> menu in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>.</li><li>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 either <em>Create note</em>, which places it in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_S0Fos78ZfcY7\">Note Inbox</a>&nbsp;(today's day note, or the top level, when no inbox is set), or <em>Create child note</em>, which places it under the note being edited.</li></ol><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><ol><li>This is sometimes also called \"reference link\".</li><li>The title of this link cannot be changed. Instead, it will always show the current title of the linked note.</li><li>The icon of the linked note will also be displayed.</li><li>If the linked note is deleted, the link keeps the last title it showed, in red and with a <span class=\"tn-icon bx bx-x\"></span> icon instead of the note icon. Clicking it while editing opens the <em>Fix link</em> dialog, which searches for that title; picking a note, or creating a new one, replaces the link with one to that note.</li></ol></li><li><em>Link title can be changed arbitrarily</em><ol><li>This will create a traditional hyperlink, where the text of the link can be different from the note title.</li></ol></li></ol><h2>In-place linking</h2><p>You can also insert internal links “inline” by using the <code>@</code> symbol:</p><ol><li>Type <code>@</code> in a text note, which will open the note search menu.</li><li>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 note</em> or <em>Create child note</em>, as described above.</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>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>In a text note, paste the link by pressing <kbd>Ctrl</kbd> + <kbd>V</kbd>.</li></ol>",
+ "_help_wfGXLmm7x27z": "<p>A link points from one note to another; a <em>backlink</em> is that same connection seen from the other end: the list of notes that refer to the current one.</p><p>Backlinks are maintained automatically and are read-only from this side. A backlink disappears when the note that created it removes the link; it cannot be deleted from the note being pointed at.</p><h2>What counts as a backlink</h2><p>Any&nbsp;<a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>&nbsp;pointing at the current note, which covers two rather different cases:</p><ul><li>Relations that Trilium maintains on your behalf.<ul><li>The most common is <code>internalLink</code>, created whenever a note refers to another one through&nbsp;<a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>&nbsp;in its text.</li><li>Embedded images (<code>imageLink</code>), relation map connections (<code>relationMapLink</code>) and note inclusions (<code>includeNoteLink</code>) work the same way.</li></ul></li><li>Relations you define yourself.<ul><li>If another note has <code>~author</code> pointing at the current note, that note is listed here as well.</li></ul></li></ul><p>Relations coming from a&nbsp;<a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a>&nbsp;are excluded, since a search stores an <code>ancestor</code> relation that would otherwise list every one of its results as a backlink.</p><aside class=\"admonition note\"><p>Only some note types have their content scanned for links:&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>,&nbsp;<a class=\"reference-link\" href=\"#root/_help_6RM1Q7ppFVoj\">Markdown</a>,&nbsp;<a class=\"reference-link\" href=\"#root/_help_iRwzGnHPzonm\">Relation Map</a>&nbsp;and&nbsp;<a class=\"reference-link\" href=\"#root/_help_GBBMSlVSOIGP\">AI</a>&nbsp;chats. A link written inside a&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;note is not registered and will not appear as a backlink on the target note. A relation set manually on a code note does still count.</p></aside><h2>How entries are displayed</h2><p>Each entry names the note the reference comes from, followed by one of:</p><ul><li><strong>An excerpt</strong> of the surrounding content, with the link itself highlighted. This is available for&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes and for&nbsp;<a class=\"reference-link\" href=\"#root/_help_GBBMSlVSOIGP\">AI</a>&nbsp;chat notes. Roughly 200 characters of context are quoted around the link, trimmed with an ellipsis where the surrounding text is longer, and images are left out.</li><li><strong>The name of the relation</strong>, for every other note type where the source cannot be quoted. This is the case for&nbsp;<a class=\"reference-link\" href=\"#root/_help_iRwzGnHPzonm\">Relation Map</a>&nbsp;notes and for any note carrying a relation you defined yourself.</li></ul><p>A note is listed once per reference it makes, so a note that links to the current one three times occupies three rows.</p><p>Of note:</p><ul><li>For AI chat notes, only the assistant's own prose is quoted. A chat that reached the note purely through tool calls has nothing to quote and is listed by relation name instead.</li><li>Excerpts are only generated for roughly the first 50 sources. On a heavily referenced note, the remaining entries fall back to showing the relation name.</li></ul><h2>Where backlinks are shown</h2><ul><li>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_KRlZFoIH0j6p\">Connections tab</a>&nbsp;of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>, as a dedicated section.</li><li>As a badge in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_AlJ73vBCjWDw\">Status bar</a>&nbsp;showing the number of backlinks. The badge only appears when the note is being read normally (not in a revision or attachment view) and when there is at least one backlink; pressing it opens the section above.</li><li>In&nbsp;<a class=\"reference-link\" href=\"#root/_help_ZjLYv08Rp3qC\">Quick edit</a>, as a button with a link icon in the header of the popup, under the same conditions; its tooltip gives the number of backlinks. Pressing a backlink opens that note in the popup.</li><li>Incoming links are also drawn on the link map, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_BCkXAVs63Ttv\">Note Map (Link map, Tree map)</a>.</li></ul>",
+ "_help_S6Xx8QIWTV66": "<p>There are three types of lists supported by text notes:</p><ul><li><span class=\"tn-icon cke cke-bulleted-list\"></span>&nbsp;Bulleted lists (also known as unordered lists).</li><li><span class=\"tn-icon cke cke-numbered-list\"></span>&nbsp;Numbered lists (or ordered lists).</li><li><span class=\"tn-icon cke cke-todo-list\"></span>&nbsp;To-do lists</li></ul><p>For bulleted and numbered lists, it's possible to configure an alternative marker such as squares or Roman numbering by pressing the&nbsp;<span class=\"tn-icon cke cke-dropdown-arrow\"></span> icon. For numbered lists, it's also possible to specify the number to start at or whether to count in reverse order.</p><h2>Keyboard interaction</h2><ul><li>To create a new list:<ul><li>Bulleted list: Start a line with <code>*</code> or <code>-</code> followed by a space;</li><li>Numbered list: Start a line with <code>1.</code> or <code>1)</code> followed by a space;</li><li>To-do list: Start a line with <code>- [ ]</code> for an unchecked item or <code>[x]</code> for a checked item.</li></ul></li><li>To create a new item in the list, press <kbd>Enter</kbd>.</li><li>To create a blank line within a list item, press <kbd>Shift</kbd>+<kbd>Enter</kbd>.</li><li>To exit out of the list, press <kbd>Enter</kbd> twice.</li><li>To merge two lists, simply delete the gap between them.</li><li>To create nested lists, simply use the&nbsp;<span class=\"tn-icon cke cke-indent\"></span> button (see <em>Indentation</em> in&nbsp;<a class=\"reference-link\" href=\"#root/_help_dEHYtoWWi8ct\">Other features</a>) or the <kbd>Tab</kbd> key. To decrease the nesting level for the current element, press <kbd>Shift</kbd>+<kbd>Tab</kbd>.</li></ul><h2>Headings, code blocks within lists</h2><p>It possible to add content-level blocks such as headings, code blocks, tables within lists, as follows:</p><figure class=\"table\"><table><tbody><tr><td>1</td><td><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/2_Lists_image.jpg\"></td><td>First, create a list.</td></tr><tr><td>2</td><td><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/4_Lists_image.jpg\"></td><td>Press Enter to create a new list item.</td></tr><tr><td>3</td><td><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/1_Lists_image.jpg\"></td><td>Press Backspace to get rid of the bullet point. Notice the cursor position.</td></tr><tr><td>4</td><td><img class=\"image_resized\" style=\"aspect-ratio:676/112;width:98.29%;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/5_Lists_image.jpg\" width=\"676\" height=\"112\"></td><td>At this point, insert any desired block-level item such as a code block.</td></tr><tr><td>5</td><td><img class=\"image_resized\" style=\"aspect-ratio:675/129;width:94.22%;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/3_Lists_image.jpg\" width=\"675\" height=\"129\"></td><td>To continue with a new bullet point, press Enter until the cursor moves to a new blank position.</td></tr><tr><td>6</td><td><img class=\"image_resized\" style=\"aspect-ratio:675/129;width:100%;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Lists_image.jpg\" width=\"675\" height=\"129\"></td><td>Press Enter once more to create the new bullet.</td></tr></tbody></table></figure><p>The same principle applies to all three list types (bullet, numbered and to-do).</p><h2>To-do lists</h2><p>See&nbsp;<a class=\"reference-link\" href=\"#root/_help_fASfBrYnquKU\">To-do Lists</a>.</p><h2>Collapsible lists</h2><p>Starting with Trilium v0.104.0, it is possible to collapse nested list items. This applies to bullet lists, numbered lists as well as to-do lists.</p><p>To collapse or expand a list item that has nested sub-items:</p><ul><li>Using the mouse, move the cursor over the list item and an arrow will appear to its left. Clicking it will toggle between collapsed and expanded.</li><li>For bullet lists and numbered lists, it's also possible to click directly on the marker (e.g. the bullet or the number) instead of on the arrow to collapse or expand it. This won't work for to-do lists since this would toggle the to-do instead.</li><li>Press <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Enter</kbd> which will toggle the collapse/expand state for the item at the cursor position.</li></ul><p>Of note:</p><ul><li>Collapsed items always show the arrow to indicate its state.</li><li>The collapsed state is saved at note level and synced across instances, which means that it will restore after a refresh or reopening of the application.</li><li>The collapsed state is also persisted in&nbsp;<a class=\"reference-link\" href=\"#root/_help_mHbBMPDPkVV5\">Import &amp; Export</a>, but only for the HTML format. Markdown exports will not preserve the collapse state.</li><li>Collapsible bullets only exist in the context of editable text notes. Read-only lists will always be fully expanded.</li><li>The list items will auto-expand on edit to avoid typing in a hidden area.</li></ul>",
+ "_help_QrtTYPmdd1qq": "<p>Markdown-like formatting allows inserting some basic formatting by typing the Markdown equivalent. Note that this does not mean that&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes supports Markdown, these are just some convenience shortcuts.</p><p>To import more complex formatting into text notes, consider using the <a href=\"#root/_help_dEHYtoWWi8ct\"><em>Import from Markdown</em></a> function. For fully-fleged Markdown notes imports, consider using the dedicated <a href=\"#root/_help_Oau6X9rCuegd\">import</a> function.</p><ul><li>For <a href=\"#root/_help_Gr6xFaF6ioJ5\">headings:</a><ul><li><code>##</code> for Heading 2 (the first-level heading is reserved for the note title).</li><li><code>###</code> for Heading 3</li><li><code>####</code> for Heading 4</li><li><code>#####</code> for Heading 5</li><li><code>######</code> for Heading 6</li></ul></li><li>For&nbsp;<a class=\"reference-link\" href=\"#root/_help_Gr6xFaF6ioJ5\">General formatting</a>:<ul><li><strong>Bold</strong>: Type <code>**text**</code> or <code>__text__</code></li><li><em>Italic</em>: Type <code>*text*</code> or <code>_text_</code></li><li><del>Strikethrough</del>: Type <code>~~text~~</code></li></ul></li><li>For&nbsp;<a class=\"reference-link\" href=\"#root/_help_S6Xx8QIWTV66\">Lists</a>:<ul><li>Bulleted list: Start a line with <code>*</code> or <code>-</code> followed by a space;</li><li>Numbered list: Start a line with <code>1.</code> or <code>1)</code> followed by a space;</li><li>To-do list: Start a line with <code>[ ]</code> for an unchecked item or <code>[x]</code> for a checked item.</li></ul></li><li>For <a href=\"#root/_help_NwBbFdNZ9h7O\">block quotes</a>, press <code>&gt;</code>, followed by a space.</li><li>For&nbsp;<a class=\"reference-link\" href=\"#root/_help_QxEyIjRBizuC\">Code blocks</a>, type <code>```</code>.</li><li>For a <a href=\"#root/_help_dEHYtoWWi8ct\">horizontal line</a>, type <code>---</code>.</li><li>For <a href=\"#root/_help_NwBbFdNZ9h7O\">admonitions</a>:<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><li>Starting any other text with <code>!!!</code> will insert a note admonition with the text inside of it.</li></ul></li><li>For <a href=\"#root/_help_CohkqWQC1iBv\">emojis</a>, type <code>:</code> followed by an emoji name to trigger an auto-completion.</li></ul><p>If auto-formatting is not desirable, press <kbd>Ctrl</kbd> + <kbd>Z</kbd> to revert the text to its original form.</p>",
+ "_help_YfYAtQBcfo5V": "<figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:350/193;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Math%20Equations_image.png\" width=\"350\" height=\"193\"></figure><p>Within text notes, it's possible to enter mathematical equations using the&nbsp;<span class=\"tn-icon cke cke-trilium-math\"></span> button from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>&nbsp;(generally found under the&nbsp;<a class=\"reference-link\" href=\"#root/_help_CohkqWQC1iBv\">Insert buttons</a>).</p><p>By default, the math dialog includes a MathLive visual editor and a TeX field. Disable <em>MathLive visual editor</em> under Options → Text Notes → Features to use only the TeX field and preview.</p><p>Enabling <em>Display mode</em> will render the equation slightly bigger (especially if using big operators such as summation, or fractions) and center it. Display mode equations will act as blocks (i.e. like paragraphs, or tables) and can be inserted for example in lists. Non-display equations can be part of the text.</p><h2>Keyboard shortcuts</h2><p>If inserting equations frequently, using the <kbd>Ctrl</kbd>+<kbd>M</kbd> keyboard shortcut can be more comfortable. Alternatively, type <code>$$</code> or <code>\\[</code> to trigger the popup directly.</p><p>There is currently no quick way to turn an already typed-out equation, such as surrounding it with <code>$</code> or pressing <kbd>Ctrl</kbd>+<kbd>M</kbd>.</p><h2>Supported math features</h2><p>Technically we are using the KaTeX library which allows for a subset of the TeX format. To see the full list of supported features, consult the <a href=\"https://katex.org/docs/supported\">Supported Functions</a> and the <a href=\"https://katex.org/docs/support_table\">Support Table</a> from the official documentation.</p><h2>Markdown support</h2><p>Math equations will be preserved when exporting to or importing from Markdown, surrounded by <code>$</code> characters for inline math expressions, and <code>$$</code> for display mode.</p><p>If you notice any issue with the Markdown import/export for equations, feel free to <a href=\"#root/_help_wy8So3yZZlH9\">report</a> it while providing the equation that causes issues.</p><h2>Formatting the equation</h2><p>It is possible to customize the font size and foreground color for both inline and display-mode equations, just like any other text. For inline equations, the background color/highlight can also be adjusted.</p>",
+ "_help_wYDzQ1fBFgfT": "<p>A multicolumn layout arranges content in two to four columns, side by side. A column can hold any kind of content, including tables, images and another multicolumn layout.</p><h2>Inserting a layout</h2><ul><li>In the formatting bar, go to <em>Insert</em> → <span class=\"tn-icon cke cke-trilium-multicolumn\"></span> <em>Multiple column layout</em> to insert a layout with two columns. Its submenu offers <em>2 columns</em>, <em>3 columns</em> and <em>4 columns</em>.</li><li>Alternatively, type <code>/columns</code> and choose <em>2 columns layout</em>, <em>3 columns layout</em> or <em>4 columns layout</em>, as described in&nbsp;<a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a>.</li></ul><p>The columns of a new layout have equal widths. If text is selected when the layout is inserted, the selection moves into the first column.</p><h2>Changing the columns</h2><h3>Changing the layout</h3><p>While the cursor is inside a layout, a toolbar appears above it with a button that shows the current layout. Clicking it opens a row of figures, one for each available layout; hovering over a figure shows its number of columns and their widths:</p><figure class=\"table\"><table><thead><tr><th>Columns</th><th>Widths</th></tr></thead><tbody><tr><td>2</td><td>50%-50%, 25%-75%, 75%-25%</td></tr><tr><td>3</td><td>33%-33%-33%, 25%-50%-25%</td></tr><tr><td>4</td><td>25%-25%-25%-25%</td></tr></tbody></table></figure><ul><li>Choosing a layout with more columns adds empty columns at the end.</li><li>Choosing a layout with fewer columns removes the last columns and moves their content to the end of the last remaining column.</li></ul><h3>Adding columns</h3><p>While the cursor is in a column, you can use these key combinations:</p><ul><li><kbd>Ctrl</kbd> + <kbd>Enter</kbd>: Add a column after the current one.</li><li><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Enter</kbd>: Add a column before the current one.</li></ul><p>The new column is empty and the cursor moves into it. All the columns then have equal widths. A layout has at most four columns, so the keys do nothing in a layout that already has four.</p><p><kbd>Ctrl</kbd> + <kbd>Enter</kbd> keeps its usual function on a link, in a to-do item and in the title of a collapsible block, and <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Enter</kbd> in a to-do item.</p><h3>Reordering columns</h3><p>While the cursor is anywhere inside a column, you can use these key combinations:</p><ul><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Right</kbd>: Move the column to the right.</li><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Left</kbd>: Move the column to the left.</li><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Home</kbd>: Make it the first column.</li><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>End</kbd>: Make it the last column.</li></ul><p>In a layout with two columns of different widths, the column keeps its width.</p><h2>Moving content between columns</h2><p>To move content to another column, select it, and then use these key combinations:</p><ul><li><kbd>Ctrl</kbd> + <kbd>Right</kbd>: Move to the column on the right.</li><li><kbd>Ctrl</kbd> + <kbd>Left</kbd>: Move to the column on the left.</li><li><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>End</kbd>: Move to the last column.</li><li><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Home</kbd>: Move to the first column.</li></ul><p>Paragraphs, list items, tables and other blocks move whole, even when only part of them is selected. Content moved to a column on the left goes to the end of that column, and content moved to a column on the right goes to its start, so it keeps its place in the reading order.</p><p>Without a selection, these keys keep their usual function: moving the cursor by word, or selecting up to the start or end of the column.</p><p>When a layout and <a class=\"reference-link\" href=\"#root/_help_EK2ckIZ74tbT\">Content tabs</a> are nested in one another, the key combinations act on the one closest to the cursor.</p><h2>Removing a layout</h2><ul><li>To remove the layout but keep its content, click the <span class=\"tn-icon cke cke-remove\"></span> <em>Remove layout</em> button in the layout's toolbar. The content of the columns is placed one after another where the layout was, and empty columns are left out.</li><li>To delete the layout together with its content, click the handle at its top-left corner to select it, then press <kbd>Delete</kbd>.</li></ul><h2>Narrow screens</h2><p>When a layout has too little room for its columns (narrower than about 500 pixels, such as on a phone), the columns are stacked one below the other. While editing, alternating background colors tell the columns apart. This applies to each layout on its own, so a layout inside a narrow column is stacked while the outer one stays side by side.</p><h2>Printing and exporting</h2><ul><li>When printing or <a href=\"#root/_help_NRnIZmSMc5sj\">exporting to PDF</a>, the columns are printed side by side.</li><li>Markdown has no columns, so Markdown export keeps the layout and each column as HTML <code>&lt;div&gt;</code> tags, with the content of each column written as Markdown between them. Importing the file back restores the layout. Markdown viewers that don't support HTML show the content of the columns one after another.</li></ul>",
+ "_help_dEHYtoWWi8ct": "<h2>Indentation</h2><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:201/124;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/1_Other%20features_image.png\" width=\"201\" height=\"124\"></figure><p>Paragraphs can be indented using the following buttons from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>:</p><ul><li>Press&nbsp;<span class=\"tn-icon cke cke-indent\"></span> to increase the indentation of the current paragraph by one. Can be pressed multiple times if needed.</li><li>Press&nbsp;<span class=\"tn-icon cke cke-outdent\"></span> to decrease the indentation of a current paragraph. The button will be disabled if it is already at the minimum indentation level.</li><li>For convenience, keyboard shortcuts are also available. Press <kbd>Tab</kbd> to indent or <kbd>Shift</kbd>+<kbd>Tab</kbd> to decrease the indentation. These shortcuts work even if the cursor is not at the beginning of a paragraph or a list.</li><li>Apart from paragraphs, the indent button is also enabled in&nbsp;<a class=\"reference-link\" href=\"#root/_help_S6Xx8QIWTV66\">Lists</a>&nbsp;(for nesting) and&nbsp;<a class=\"reference-link\" href=\"#root/_help_NdowYOC1GFKS\">Tables</a>.</li></ul><p>When indented paragraphs or headings are copied and pasted as plain text, for example into a <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> note or another application, each indentation level becomes a tab at the start of the line. A copy that stays within a single paragraph contains only its text, without the indentation.</p><p>The reverse also works: when plain text is pasted into a text note, each paragraph whose lines all start with tabs is indented by one level per tab. Pasting into a code block keeps the tabs as they are.</p><h2>Markdown import</h2><p>If the clipboard contains Markdown text, it can be easily imported into text notes. Simply copy a Markdown-formatted text and press the&nbsp;<span class=\"tn-icon cke cke-trilium-markdown-mark\"></span> to insert its visual representation.</p><p>Note that this only works with raw Markdown (e.g. <code># Heading 1</code> to generate a heading) and not the visual representation of the Markdown (e.g. as in the preview pane of an application). In that case, simply use the paste function which already accepts HTML-formatted content.</p><p>This is mostly useful for snippets of text, for entire Markdown documents use the dedicated&nbsp;<a class=\"reference-link\" href=\"#root/_help_Oau6X9rCuegd\">Markdown</a>&nbsp;import/export function.</p><p>If accessing Trilium with a web browser, the Markdown import action will ask for the content to be inserted into a dedicated screen since it does not have access to the clipboard.</p><h2>Cut to subnote</h2><p>The&nbsp;<span class=\"tn-icon cke cke-trilium-scissors\"></span> button will create a child note with the selected text. For more information, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_2x0ZAX9ePtzV\">Cut to subnote</a>.</p><h2>Find and replace</h2><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:394/203;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Other%20features_image.png\" width=\"394\" height=\"203\"></figure><p>The&nbsp;<span class=\"tn-icon cke cke-find-replace\"></span> button will open the editor's dedicated search and replace functionality.</p><p>Alternatively, the <kbd>Ctrl</kbd>+<kbd>F</kbd> combination can be pressed to show the dialog.</p>",
+ "_help_gLt3vA97tMcp": "<p>The text editor we are using is called&nbsp;<a class=\"reference-link\" href=\"#root/_help_MI26XDLSAlCD\">CKEditor</a>&nbsp;which has an open-source core, but it's also a commercial product which offers <a href=\"https://ckeditor.com/docs/trial/latest/index.html\">premium features</a>.</p><p>Prior to v0.105.0, Trilium used the following premium features as part of a signed agreement between the CKEditor and the Trilium team:</p><ul><li><a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a></li><li><a class=\"reference-link\" href=\"#root/_help_pwc194wlRzcH\">Text Snippets</a></li><li><a class=\"reference-link\" href=\"#root/_help_5wZallV2Qo1t\">Format Painter</a></li></ul><p>Starting with v0.105.0, those features have been completely rewritten as custom CKEditor plugins, licensed under AGPL-3.0.</p><h2>Lookalikes</h2><p>There are some premium CK features that look like Trilium's built-in functionality but they are completely different:</p><ul><li><a class=\"reference-link\" href=\"#root/_help_VRoP0g1uHHc2\">In-editor AI assistant</a></li><li><a class=\"reference-link\" href=\"#root/_help_YfYAtQBcfo5V\">Math Equations</a>&nbsp;which uses a third-party plugin that has been adapted for Trilium.</li></ul>",
+ "_help_ZlN4nump6EbW": "<figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:419/571;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Slash%20Commands_image.png\" width=\"419\" height=\"571\"></figure><p>Slash commands is a feature of&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes which allows easily accessing commonly used commands simply by using the keyboard, without having to remember dedicated&nbsp;<a class=\"reference-link\" href=\"#root/_help_A9Oc6YKKc65v\">Keyboard Shortcuts</a>.</p><h2>Interaction</h2><ul><li>As the name suggests, to trigger the slash commands simply press the / key to trigger it. Note that this can be anywhere in a paragraph as long as it's not part of the word, if it doesn't show up simply press a space and press the / key again.</li><li>Use ↑ and ↓ keys to navigate between options.</li><li>By default, the full list of commands is displayed.</li><li>To search, simply start typing: commands are found by their title or by other names they go by (for example <code>h2</code> for <em>Heading 2</em>).</li><li>To trigger the highlighted action, press Enter or Tab.</li></ul><h2>Integration with other features</h2><p>Apart from the common set of commands, some features are specially integrated with the slash commands:</p><ul><li>For <a href=\"#root/_help_NwBbFdNZ9h7O\">admonitions</a>, each admonition type (e.g. note, tip) will be individually displayed.</li><li>Every&nbsp;<a class=\"reference-link\" href=\"#root/_help_pwc194wlRzcH\">Text Snippets</a>&nbsp;will also appear individually, making it easy to insert them.</li><li><a class=\"reference-link\" href=\"#root/_help_VRoP0g1uHHc2\">In-editor AI assistant</a>: dedicated <em>Ask AI</em> item as well as all the predefined and <a href=\"#root/_help_mVEYwt20exhO\">custom quick actions</a>.</li></ul>",
+ "_help_oBo3iHIZnbG2": "<p>Trilium supports spell checking for your notes. How it works depends on whether you're using the <strong>desktop application</strong> (Electron) or accessing Trilium through a <strong>web browser</strong>.</p><h2>Desktop</h2><p>The desktop app uses Chromium's built-in spellchecker. You can configure it from <em>Options</em> → <em>Spell Check</em>.</p><h3>Enabling spell check</h3><p>Toggle <em>Check spelling</em> to enable or disable the spellchecker. A restart is required for changes to take effect — use the restart button at the bottom of the section.</p><h3>Choosing languages</h3><p>When spell check is enabled, a <em>Spell Check Languages</em> section appears listing all languages available on your system. Select one or more languages by checking the boxes. The spellchecker will accept words that are valid in <em>any</em> of the selected languages.</p><p>The available languages depend on your operating system's installed language packs. For example, on Windows you can add languages through <em>Options</em> → <em>Time &amp; Language</em> → <em>Language &amp; Region</em> → <em>Add a language</em>.</p><aside class=\"admonition note\"><p>The changes take effect only after restarting the application.</p></aside><h3>Custom dictionary</h3><aside class=\"admonition tip\"><p>This function is available starting with Trilium v0.103.0.</p></aside><p>Words you add to the dictionary (e.g. via the right-click context menu → \"Add to dictionary\") are stored in a <strong>synced note</strong> inside Trilium. This means your custom dictionary automatically syncs across all your devices.</p><p>You can view and edit the dictionary directly from <em>Settings</em> → <em>Spell Check</em> → <em>Custom Dictionary</em> → <em>Edit dictionary</em>. This opens the underlying note, which contains one word per line. You can add, remove, or modify entries as you like.</p><aside class=\"admonition note\"><p>Changes to the custom dictionary (whether from the editor or the context menu) take effect after restarting the application.</p></aside><h4>How the custom dictionary works</h4><ul><li>When you right-click a misspelled word and choose \"Add to dictionary\", the word is saved both to Electron's local spellchecker and to the synced dictionary note.</li><li>On startup, Trilium loads all words from the dictionary note into the spellchecker session.</li><li>If Trilium detects words in Electron's local dictionary but the dictionary note is empty (e.g. on first use), it performs a <strong>one-time import</strong> of those words into the note.</li><li>Words that are in Electron's local dictionary but <em>not</em> in the note (e.g. you removed them manually) are cleaned up from the local dictionary on startup.</li></ul><h4>Known limitations</h4><p>On Windows and macOS, Electron delegates \"Add to dictionary\" to the operating system's user dictionary. This means:</p><ul><li>Words added via the context menu are also written to the OS-level dictionary (e.g. <code>%APPDATA%\\Microsoft\\Spelling\\&lt;language&gt;\\default.dic</code> on Windows).</li><li><strong>Removing a word</strong> from the Trilium dictionary note prevents it from being loaded into the spellchecker on next startup, but does <em>not</em> remove it from the OS dictionary. The word may still be accepted by the OS spellchecker until you remove it from the OS dictionary manually.</li></ul><h2>Web browser</h2><p>When accessing Trilium through a web browser, spell checking is handled entirely by the browser itself. Trilium does not control the browser's spellchecker — language selection, dictionaries, and all other settings are managed through your browser's preferences.</p><p>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_jcQVxzYybYgz\">Note contextual menu</a>&nbsp;has a special behavior in which a right-clicked word (without selection) shows the browser's default contextual menu which allows the spellcheck to function.</p><p>The Spell Check settings page in Trilium will indicate that these options apply only to desktop builds.</p><h2>Frequently asked questions</h2><h3>Do I need to restart after every change?</h3><p>Yes. Spell check language selection and the custom dictionary are loaded once at startup. Any changes require a restart to take effect.</p><h3>Can I use multiple spell check languages at the same time?</h3><p>Yes. Select as many languages as you need from the checklist. The spellchecker will accept words from any of the selected languages.</p><h3>My custom words disappeared after syncing to a new device — what happened?</h3><p>On the first launch of a new device, Trilium may import existing local dictionary words into the note. If the note already has words from another device (via sync), those are preserved. Make sure sync completes before restarting the application on a new device.</p><h3>I removed a word from the dictionary note but it's still accepted</h3><p>This is likely due to the OS-level dictionary retaining the word (see <a href=\"#known-limitations\">Known limitations</a> above). You can manually remove it from your operating system's user dictionary.</p>",
+ "_help_BFvAtE74rbP6": "<aside class=\"admonition note\"><p>This page has been relocated to&nbsp;<a class=\"reference-link\" href=\"#root/_help_2dcGDhp9WFKb\">Outline tab</a>.</p></aside>",
+ "_help_NdowYOC1GFKS": "<p>Tables are a powerful feature for&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes, since editing them is generally easy.</p><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:176/204;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/2_Tables_image.png\" width=\"176\" height=\"204\"></figure><p>To create a table, simply press the table button and select with the mouse the desired amount of columns and rows, as indicated in the adjacent figure.</p><p>Since v0.107.0, the same menu starts with an <em>Insert table…</em> item, for a table larger than the grid or to type its size instead:</p><ol><li>Click the <span class=\"tn-icon cke cke-table\"></span>button and select <em>Insert table…</em>. A small form opens at the cursor.</li><li>Enter the number of <em>Columns</em> (up to 100) and <em>Rows</em> (up to 1000). The table can have at most 5000 cells in total, for example 1000 rows of 5 columns.</li><li>Press <em>Insert</em> or <kbd>Enter</kbd>.</li></ol><p>To close the form without inserting a table, press <kbd>Esc</kbd> or click outside it. From the keyboard, <kbd>Tab</kbd> moves between <em>Insert table…</em> and the grid while the menu is open.</p><p>On the <a class=\"reference-link\" href=\"#root/_help_RDslemsQ6gCp\">Mobile Frontend</a>, the <span class=\"tn-icon cke cke-table\"></span>button opens the form directly, without the grid.</p><h2>Formatting toolbar</h2><p>When a table is selected, a special formatting toolbar will appear:</p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/3_Tables_image.png\" width=\"384\" height=\"100\"><h2>Context menu</h2><p>Since v0.106.0, right-clicking anywhere inside a table opens a context menu with the most common table operations:</p><ul><li><em>Insert row above</em> and <em>Insert row below</em> insert a blank row next to the row of the current cell. When the selection spans multiple rows, the same number of rows is inserted.</li><li><em>Insert column to the left</em> and <em>Insert column to the right</em> work the same way for columns.</li><li>Since v0.107.0, <em>Set as header</em> or <em>Set header up to this row</em>, depending on the selection, turns rows into header rows, which always start at the top of the table:<ul><li><em>Set as header</em> shows when the selection starts at the first row, and makes every selected row a header row.</li><li><em>Set header up to this row</em> shows when the selection is in a single row below the first, and makes that row and every row above it header rows.</li><li>Neither shows when the selection spans several rows below the first.</li><li>A check mark shows that the rows are already header rows. Choosing the item again turns them, and every header row below them, back into regular rows. For example, in a table with five header rows, choosing <em>Set header up to this row</em> on the third row leaves only the first two as header rows.</li></ul></li><li><em>Merge cells</em> merges the selected cells into one. The selected cells must form a rectangle.</li><li><em>Split cell</em> splits each selected cell in two, either <em>Vertically</em> or <em>Horizontally</em>. <em>Unmerge cells</em>, in the same submenu, turns each merged cell in the selection back into the single cells it covers, keeping its content in the top-left one; cells that are not merged stay as they are.</li><li><em>Distribute columns evenly</em> splits the combined width of the columns the selection touches equally between them. The other columns and the width of the table stay as they are. It needs a selection spanning at least two columns; a merged cell counts for every column it covers.</li><li><em>Cut</em>, <em>Copy</em> and <em>Copy as Markdown</em> act on the selected cells. Since v0.107.0, <em>Copy</em> and <em>Paste</em> open submenus with their variants, such as <em>Copy as Markdown</em> and <em>Paste as plain text</em>; clicking <em>Copy</em> or <em>Paste</em> itself still copies or pastes:<ul><li>Cutting or copying produces a smaller table holding just the selected cells. Pasting it over a cell selection replaces those cells; pasting elsewhere inserts it as a table of its own. Cutting clears the cells without removing rows or columns.</li><li><em>Copy as Markdown</em> converts the selected cells to a Markdown table. A selected header row becomes the Markdown header; without one, an empty header row is emitted, since Markdown tables require one.</li></ul></li><li>Since v0.107.0, <em>Paste rows above</em> and <em>Paste rows below</em>, in the <em>Paste</em> submenu, paste the clipboard as new rows next to the row of the current cell, instead of over the cells from the cursor on. They show only when the selection is in a single row, and, like <em>Paste</em>, only where the clipboard can be read:<ul><li>A copied table becomes one new row for each of its rows, filled from the first column. When it has more columns than the table, the table gains columns, as with a regular paste. Other content goes in the first cell of a single new row.</li><li>The new rows are selected afterwards.</li><li>When merged cells join the row to others, the new rows go above or below that whole block of rows.</li></ul></li><li><em>Sort</em>, below the clipboard section, sorts the rows by the column of the current cell, in <em>Ascending</em> or <em>Descending</em> order. See <a href=\"#sorting-rows\">Sorting rows</a>.</li><li><em>Delete row</em> and <em>Delete column</em>, below <em>Sort</em>, remove every row or column the selection touches, even when only some of their cells are selected.</li><li><em>Delete table</em> removes the whole table and leaves an empty paragraph in its place. In a table nested inside another, only the inner table is removed.</li><li>Since v0.107.0, <em>Select</em>, below <em>Delete table</em>, selects the cells of every row (<em>Row</em>) or column (<em>Column</em>) the selection touches, or every cell of the table (<em>Table</em>). Unlike the <span class=\"tn-icon cke cke-drag-handle\"></span>button, which selects the table as a whole, <em>Table</em> selects its cells, so cell operations such as <em>Merge cells</em> apply to all of them. In a table nested inside another, <em>Table</em> selects only the cells of the inner table.</li></ul><p>Right-clicking a cell that is not part of the current selection moves the cursor there first, so the menu always applies to the cell under the pointer.</p><aside class=\"admonition note\"><p>In the browser, Trilium's menu replaces the browser's own context menu inside tables. To reach the browser's menu (for example for its spell checking suggestions), hold <kbd>Shift</kbd> while right-clicking. The desktop application is unaffected, since its menu already includes the spelling suggestions. In the browser, the menu also offers <em>Paste</em> only when the page can read the clipboard, which requires a secure (HTTPS) context and your permission; otherwise, paste with <kbd>Ctrl</kbd>+<kbd>V</kbd>.</p></aside><h2>Navigating a table</h2><ul><li>Using the mouse:<ul><li>Click on a cell to focus it.</li><li>Click the&nbsp;<span class=\"tn-icon cke cke-return-arrow\"></span> button at the top or the bottom of a table to insert an empty paragraph near it.</li><li>Click the&nbsp;<span style=\"--tn-color:hsl(0,0%,60%);color:hsl(0,0%,60%);\"><span class=\"tn-icon cke cke-drag-handle\"></span></span> button at the top-left of the table to select it entirely (for easy copy-pasting or cutting) or drag and drop it to relocate the table.</li></ul></li><li>Using the keyboard:<ul><li>Use the arrow keys on the keyboard to easily navigate between cells.</li><li>It's also possible to use <kbd>Tab</kbd> to go to the next cell and Shift+Tab to go to the previous cell.</li><li>Unlike arrow keys, pressing <kbd>Tab</kbd> at the end of the table (last row, last column) will create a new row automatically.</li><li>To select multiple cells, hold <kbd>Shift</kbd> while using the arrow keys.</li></ul></li><li>Using touch:<ul><li>Since v0.107.0, touching a table outlines the cell with the cursor, or the selected cells, and shows a handle at each corner of the outline.</li><li>To select multiple cells, drag one of the handles across the table. The cell at the opposite corner stays selected, so the selection grows or shrinks as the finger moves. The note and wide tables scroll when the handle reaches the edge of the screen.</li></ul></li></ul><h2>Resizing cells</h2><ul><li>Columns can be resized by hovering the mouse over the border of two adjacent cells and dragging it.</li><li>To give several columns the same width, select cells across them and choose <em>Distribute columns evenly</em> from the <span class=\"tn-icon cke cke-table-column\"></span>button of the formatting toolbar or from the <a href=\"#context-menu\">context menu</a>.</li><li>By default, the row height is not adjustable using the mouse, but it can be configured from the cell settings (see below).</li><li>To adjust exactly the width (in pixels or percentages) of a cell, select the&nbsp;<span class=\"tn-icon cke cke-table-cell-properties\"></span> button.</li></ul><h3>Resizing with touch</h3><p>Since v0.107.0, touching a table shows a bar at the bottom of the note, above the formatting toolbar on mobile. The bar has a segment for each column of the table, with a divider at the end of each column. Only the divider of the column with the cursor is a handle that resizes; the other dividers only mark where the columns meet, so a swipe across them scrolls instead. When several cells are selected, each column they cover has a handle.</p><ul><li>To resize a column, place the cursor in one of its cells or tap its segment, then drag its handle. The table grows or shrinks with the column, and scrolls when the handle reaches the edge of the screen. The column snaps to its starting width and to the widths of the columns beside it.</li><li>To cancel a resize, drag the handle back to where it started, or touch the screen with a second finger.</li><li>To give a column and the next one the same width, double-tap the handle between them.</li><li>To select a column, tap its segment. To open the column menu, touch and hold the segment.</li><li>To scroll a wide table sideways, swipe along the bar.</li></ul><p>A wide table scrolls a little past its end, so the handle of its last column stays away from the edge of the screen, where a swipe navigates back.</p><h2>Wide tables</h2><p>Since v0.107.0, a table can be wider than the&nbsp;<a class=\"reference-link\" href=\"#root/_help_t596jLvPrqkS\">Content width</a>. Such a table scrolls sideways, while the rest of the note keeps its width.</p><ul><li>A new table is as wide as the content. To make it wider, drag the right border of its last column past the edge of the content. The border snaps to the edge and holds there briefly, so the table is easy to bring back to the width of the content.</li><li>To set an exact width, enter a percentage above <code>100%</code> or a width in pixels in the&nbsp;<span class=\"tn-icon cke cke-table-properties\"></span> <a href=\"#table-properties\">table properties</a>.</li><li>A table whose content needs more room than the note, such as a pasted table with many columns, also scrolls instead of stretching the note.</li><li>Wide tables scroll the same way in read-only notes and on shared pages.</li><li>When printing or exporting to PDF, a wide table is shrunk to fit the page.</li></ul><p>Tables inside other blocks, such as block quotes, admonitions, collapsible blocks, columns or tabs, are limited to the width of their block and do not scroll.</p><h3>Mobile support</h3><p>On the&nbsp;<a class=\"reference-link\" href=\"#root/_help_RDslemsQ6gCp\">Mobile Frontend</a>, a table keeps the width it has on a desktop and scrolls sideways, instead of squeezing its columns into the width of the screen. The full width of a table is the <em>Max content width</em> set in&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Appearance</em> → <em>Content Width</em> on the mobile device, 1200 pixels by default. For example, a table set to <code>50%</code> is 600 pixels wide.</p><p>To resize columns on mobile, use the bar described in <a href=\"#resizing-with-touch\">Resizing with touch</a>.</p><h2>Long tables</h2><p>Since v0.107.0, the header rows of a table stay visible at the top of the note while you scroll through the rest of the table, and leave with the end of the table. This also works in read-only notes, on shared pages and in wide tables.</p><p>To turn rows into header rows, use <em>Set as header</em> in the <a href=\"#context-menu\">context menu</a>, or <em>Header row</em> in the <span class=\"tn-icon cke cke-table-row\"></span> button of the formatting toolbar.</p><p>To let header rows scroll away with the rest of the table, turn off <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Text Notes</em> → <em>Features</em> → <em>Use sticky header rows for tables</em>. The setting applies to the current device only, and shared pages keep their sticky header rows.</p><h2>Inserting new rows and new columns</h2><ul><li>To insert a new column, click on a desired location, then press the&nbsp;<span class=\"tn-icon cke cke-table-column\"></span> button from the formatting toolbar and select <em>Insert column left or right.</em></li><li>To insert a new row, click on a desired location, then press the&nbsp;<span class=\"tn-icon cke cke-table-row\"></span> button and select <em>Insert row above</em> or <em>below</em>.<ul><li>A quicker alternative to creating a new row while at the end of the table is to press the <kbd>Tab</kbd> key.</li></ul></li><li>Both operations are also available in the <a href=\"#context-menu\">context menu</a>, which inserts as many rows or columns as the selection spans.</li></ul><h2>Moving rows and columns</h2><p>Since v0.106.0, rows and columns can be reordered with the keyboard:</p><ul><li><kbd>Alt</kbd>+<kbd>Up</kbd> and <kbd>Alt</kbd>+<kbd>Down</kbd> move the rows touched by the selection up or down.</li><li><kbd>Alt</kbd>+<kbd>Left</kbd> and <kbd>Alt</kbd>+<kbd>Right</kbd> move the columns touched by the selection left or right.</li></ul><p>Merged cells are never split by a move. The rows or columns held together by a merged cell travel as one block, and moving toward such a block jumps over it entirely.</p><p>When the table has a header row, a header row moved below the header area becomes a regular row, and a regular row moved into the header area becomes a header row. Header columns behave the same way.</p><p>Outside of tables, <kbd>Alt</kbd>+<kbd>Left</kbd> and <kbd>Alt</kbd>+<kbd>Right</kbd> keep navigating the note history, and <kbd>Alt</kbd>+<kbd>Up</kbd> and <kbd>Alt</kbd>+<kbd>Down</kbd> keep moving the current paragraph.</p><h2>Sorting rows</h2><p>Since v0.107.0, the rows of a table can be sorted by the values of one column:</p><ul><li>To sort all the rows, place the cursor in any cell of the column to sort by, then select <em>Sort</em> → <em>Ascending</em> or <em>Descending</em> from the <a href=\"#context-menu\">context menu</a>. The same items are in the <span class=\"tn-icon bx bx-sort-alt-2\"></span>button of the formatting toolbar.</li><li>To sort only some of the rows, select their cells in the column to sort by, then sort the same way. Sorting is not available while the selection spans more than one column.</li></ul><p>Header rows always stay at the top of the table and are never sorted. A sort can be undone with <kbd>Ctrl</kbd>+<kbd>Z</kbd>.</p><h3>How values are compared</h3><p>Each cell is read as plain text, so formatting does not affect the order. Trilium then detects what kind of value the cell holds:</p><figure class=\"table\"><table><thead><tr><th>Kind</th><th>Examples</th><th>Compared by</th></tr></thead><tbody><tr><td>Time</td><td><code>15:02</code>, <code>15:02:38</code>, <code>3:02 PM</code></td><td>The time of day.</td></tr><tr><td>Date</td><td><code>2026-09-30</code>, <code>2026-09-30 15:02</code>, <code>30 September 2026</code>, <code>Wednesday, 30 September 2026</code>, <code>2026-09-30T15:02:38+03:00</code></td><td>The date and time.</td></tr><tr><td>Number</td><td><code>12</code>, <code>-3.5</code>, <code>1,234.56</code>, <code>$ 12.04</code>, <code>21 RON</code>, <code>24.5m</code></td><td>The numeric value.</td></tr><tr><td>Text</td><td>Anything else.</td><td>Alphabetically, ignoring case, with numbers inside the text in numeric order (<code>Item 9</code> before <code>Item 10</code>). Accents count, so <code>a</code> and <code>á</code> differ.</td></tr><tr><td>Empty</td><td>An empty cell, or one holding only spaces.</td><td>Not compared. Empty cells always go last.</td></tr></tbody></table></figure><p>Ascending order puts times first, then dates, numbers and text. Descending order reverses it. Empty cells go last in both directions.</p><p>Numbers, dates and times with the same value are ordered by their text, so <code>5 apples</code> comes before <code>5 pears</code>. Rows whose cells hold the same text, ignoring case, keep their relative order.</p><ul><li>Dates are also recognized in the formats of the note's language, such as <code>30.09.2026</code> or <code>30. September 2026</code> for German, and in the format chosen in&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Text Notes</em> → <em>Editor</em> → <em>Date/time format</em> for <a href=\"#root/_help_CohkqWQC1iBv\">inserting the date and time</a>.</li><li>A number can start with a currency symbol, such as <code>$</code>, <code>€</code> or <code>£</code>. Whatever follows the number, such as a unit, is ignored, so units are not converted: <code>1 km</code> sorts before <code>500 m</code>. A cell that starts with letters, such as <code>RON 21</code>, is text.</li><li>The decimal separator follows the language of the note: <code>1.500</code> is one and a half in English, but one thousand five hundred in German. A comma or period that is not followed by exactly three digits is always read as a decimal separator, so <code>1,5</code> is one and a half in either language.</li><li>The language of the note set in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_AlJ73vBCjWDw\">Status bar</a>&nbsp;via the&nbsp;<span class=\"tn-icon bx bx-globe\"></span> icon, or else the default content language. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_veGu4faJErEM\">Content language &amp; Right-to-left support</a>.</li></ul><h3>Merged cells</h3><p>Rows joined by a merged cell are kept together and move as one block. The block is sorted by the value in its first row. When the block has more than one cell in the sorted column, the other cells do not affect the order, and a message says so: <em>Some rows were sorted together because merged cells tie them to each other</em>.</p><p>When the selection covers only part of such a block, the whole block is sorted.</p><h2>Merging cells</h2><p>To merge two or more cells together, simply select them via drag &amp; drop and press the&nbsp;<span class=\"tn-icon cke cke-table-merge-cell\"></span> button from the formatting toolbar.</p><p>More options are available by pressing the arrow next to it:</p><ul><li>Click on a single cell and select Merge cell up/down/right/left to merge with an adjacent cell.</li><li>Select <em>Merge selected cells</em> to merge the selected cells, the same as pressing the button itself.</li><li>Select <em>Split cell vertically</em> or <em>horizontally</em>, to split a cell into multiple cells (can also be used to undo a merge).</li><li>Select <em>Unmerge cells</em> to turn each merged cell in the selection back into the single cells it covers, keeping its content in the top-left one.</li></ul><p><em>Merge selected cells</em> and <em>Unmerge cells</em> are available since v0.107.0. Merging and splitting are also available by right-clicking the selected cells, via the <a href=\"#context-menu\">context menu</a>, where <em>Unmerge cells</em> is in the <em>Split cell</em> submenu.</p><h2>Table properties</h2><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:312/311;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Tables_image.png\" width=\"312\" height=\"311\"></figure><p>The table properties can be accessed via the&nbsp;<span class=\"tn-icon cke cke-table-properties\"></span> button and allows for the following adjustments:</p><ul><li>Border (not the border of the cells, but the outer rim of the table), which includes the style (single, double), color and width.</li><li>The background color, with none set by default.</li><li>The width and height of the table in percentage (must end with <code>%</code>) or pixels (must end with <code>px</code>).</li><li>The alignment of the table.<ul><li>Left or right-aligned, case in which the text will flow next to it.</li><li>Centered, case in which text will avoid the table, regardless of the table width.</li></ul></li></ul><p>The table will immediately update to reflect the changes, but the <em>Save</em> button must be pressed for the changes to persist.</p><h2>Cell properties</h2><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:320/386;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/1_Tables_image.png\" width=\"320\" height=\"386\"></figure><p>Similarly to table properties, the&nbsp;<span class=\"tn-icon cke cke-table-cell-properties\"></span> button opens a popup which adjusts the styling of one or more cells (based on the user's selection).</p><p>The following options can be adjusted:</p><ul><li>The border style, color and width (same as table properties), but applying to the current cell only.</li><li>The background color, with none set by default.</li><li>The width and height of the cell in percentage (must end with <code>%</code>) or pixels (must end with <code>px</code>).</li><li>The padding (the distance of the text compared to the cell's borders).</li><li>The alignment of the text, both horizontally (left, centered, right, justified) and vertically (top, middle or bottom).</li></ul><p>The cell will immediately update to reflect the changes, but the <em>Save</em> button must be pressed for the changes to persist.</p><h2>Border and background colors</h2><p>The border and background colors of tables and cells adapt to the <a href=\"#root/_help_Wy267RK4M69c\">theme</a>, the same way as <a href=\"#root/_help_Gr6xFaF6ioJ5\">text colors</a> do. A color picked from the palette, chosen with the color picker or typed in is shown in a lighter or darker shade that suits the current theme, so borders stay visible and text stays readable on the background. The hue stays the same, and the table keeps the color as it was picked.</p><p>Colors applied with older versions of Trilium are shown exactly as they were picked, until the note is next edited.</p><p>Older browsers that can't adapt colors show them exactly as they were picked.</p><h2>Caption</h2><p>Press the&nbsp;<span class=\"tn-icon cke cke-caption\"></span> button to insert a caption or a text description of the table, which is going to be displayed above the table.</p><h2>Table borders</h2><p>By default, tables will come with a predefined gray border.</p><p>To adjust the borders, follow these steps:</p><ol><li>Select the table.</li><li>In the floating panel, select the <em>Table properties</em> option (<span class=\"tn-icon cke cke-table-properties\"></span>).<ol><li>Look for the <em>Border</em> section at the top of the newly opened panel.</li><li>This will control the outer borders of the table.</li><li>Select a style for the border. Generally <em>Single</em> is the desirable option.</li><li>Select a color for the border.</li><li>Select a width for the border, expressed in pixels.</li></ol></li><li>Select all the cells of the table and then press the <em>Cell properties</em> option (<span class=\"tn-icon cke cke-table-cell-properties\"></span>).<ol><li>This will control the inner borders of the table, at cell level.</li><li>Note that it's possible to change the borders individually by selecting one or more cells, case in which it will only change the borders that intersect these cells.</li><li>Repeat the same steps as from step (2).</li></ol></li></ol><h3>Tables with invisible borders</h3><p>Tables can be set to have invisible borders in order to allow for basic layouts (columns, grids) of text or <a href=\"#root/_help_mT0HEkOsz6i1\">images</a> without the distraction of their border:</p><ol><li>First insert a table with the desired number of columns and rows.</li><li>Select the entire table.</li><li>In <em>Table properties</em>, set:<ol><li><em>Style</em> to <em>Single</em></li><li><em>Color</em> to <code>transparent</code></li><li>Width to <code>1px</code>.</li></ol></li><li>In Cell Properties, set the same as on the previous step.</li></ol><h2>Table indentation</h2><p>Since v0.104.1, tables can be indented as a block (the whole table moves, rather than just the content of a cell).</p><ol><li>Click the&nbsp;<span style=\"--tn-color:hsl(0,0%,60%);color:hsl(0,0%,60%);\"><span class=\"tn-icon cke cke-drag-handle\"></span></span> button to select the entire table. Otherwise, the indentation applies only to the current cell's content.</li><li>Press <kbd>Tab</kbd> to increase the indent, or <kbd>Shift</kbd>+<kbd>Tab</kbd> to decrease it. Alternatively, use the indentation buttons in the formatting toolbar.</li></ol><p>Markdown does not support indented tables, so the indentation is lost when converting to Markdown.</p><h2>Markdown import/export</h2><p>Simple tables are exported in GitHub-flavored Markdown format (e.g. a series of <code>|</code> items). If the table is found to be more complex (it contains HTML elements, has custom sizes or images), the table is converted to a HTML one instead.</p><p>Generally formatting loss should be minimal when exported to Markdown due to the fallback to HTML formatting.</p>",
+ "_help_pwc194wlRzcH": "<figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:265/108;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Text%20Snippets_image.png\" width=\"265\" height=\"108\"></figure><p>Text Snippets are closely related to&nbsp;<a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>, but instead of defining the content of an entire note, text snippets are pieces of formatted text that can easily be inserted in a text note.</p><h2>Creating a text snippet</h2><p>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>: </p><ol><li>Right click a note where to place the text snippet.</li><li>Select <em>Insert child note</em>.</li><li>Select <em>More</em> → <em>Text snippet</em>.</li></ol><p>Afterwards, simply type in the content of the note the desired text. The text can be formatted in the same manner as a normal text note.</p><p>The title of the note will become the title of the template. Optionally, a description can be added in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>&nbsp;section.</p><h2>Inserting a snippet</h2><p>Once a snippet is created, there are two options to insert it:</p><ol><li>From the&nbsp;<a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>, by looking for the&nbsp;<span class=\"tn-icon cke cke-trilium-template\"></span> button.</li><li>Using&nbsp;<a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a>: <ol><li>To look for a specific template, start typing the name of the template (its title).</li><li>To look for all the templates, type <code>template</code>.</li></ol></li></ol><aside class=\"admonition tip\"><p>A newly created snippet doesn't appear? Generally it takes up to a few seconds to refresh the list of templates once you make a change.</p><p>If this doesn't happen, <a href=\"#root/_help_s8alTXmpFR61\">reload the application</a> and <a href=\"#root/_help_wy8So3yZZlH9\">report the issue</a>to us.&nbsp;</p></aside><h2>Limitations</h2><ul><li>Whenever a snippet is created, deleted or its title/description are modified, all the open text notes will need to be refreshed. This causes a slight flash for usually under a second, but it can cause some discomfort.</li><li>Unlike&nbsp;<a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>, the snippets cannot be limited to a particular <a href=\"#root/_help_9sRHySam5fXb\">workspace</a>.</li></ul>",
+ "_help_fASfBrYnquKU": "<h2>Extended task states</h2><figure class=\"image image-style-align-left\"><img style=\"aspect-ratio:303/264;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/To-do%20Lists_image.png\" width=\"303\" height=\"264\"></figure><p>In Trilium, to-do items aren't limited to a simple \"done\" or \"not done.\" Tasks can also be marked as <em>in progress</em> (\"doing\"), <em>under consideration</em> (\"maybe\"), or <em>cancelled</em> (\"won't do\"), thus giving a more accurate picture of where things actually stand.</p><p>Right-click the checkbox and select the desired state. Alternatively, press <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Enter </kbd> to cycle through the task states. Tapping or left-clicking the checkbox will always toggle between \"None\" and \"Done\".</p><p>Task states are fully preserved when converting between&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;and&nbsp;<a class=\"reference-link\" href=\"#root/_help_6RM1Q7ppFVoj\">Markdown</a>&nbsp;notes, in both directions.</p><h3>Customizing the extended task states</h3><p>Task states are customizable: you can reorder them, create new ones with different colors and symbols, or delete the ones you don't need. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_i16PM6A7GXdU\">Customizing to-do task states</a>&nbsp;for more details.</p><h2>Keyboard shortcuts</h2><p>When at the beginning on an empty paragraph, type the following to insert a to-do list:</p><ul><li><code>[ ]</code> for an unchecked item</li><li><code>[x]</code> for a checked item</li></ul><p>Extended task states are supported as well, using its corresponding <em>Markdown symbol</em>. These are the defaults but they can be changed if needed (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_i16PM6A7GXdU\">Customizing to-do task states</a>):</p><ul><li><code>[/]</code> for “Doing”.</li><li><code>[?]</code> for “Maybe”.</li><li><code>[-]</code> for “Cancelled”.</li></ul><p>To reorder the item under the cursor, press <kbd>Alt</kbd>+<kbd>Up</kbd> or <kbd>Alt</kbd>+<kbd>Down</kbd>. To reorder multiple items, select them first.</p><h2>See also</h2><ul><li>To-do lists are meant for small task lists. For more complicated, day-to-day task tracking consider using a&nbsp;<a class=\"reference-link\" href=\"#root/_help_CtBQqbwXDx1w\">Kanban Board</a>&nbsp;collection instead.</li></ul>",
+ "_help_6f9hih2hXXZk": "<p>Trilium supports creating \"code\" notes, i.e. notes which contain some sort of formal code - be it programming language (C++, JavaScript), structured data (JSON, XML) or other types of codes (CSS etc.).</p><p>This can be useful for a few things:</p><ul><li>computer programmers can store code snippets as notes with syntax highlighting</li><li>JavaScript code notes can be executed inside Trilium for some extra functionality<ul><li>we call such JavaScript code notes \"scripts\" – see&nbsp;<a class=\"reference-link\" href=\"#root/_help_CdNpE2pqjmI6\">Scripting</a></li></ul></li><li>JSON, XML etc. can be used as storage for structured data (typically used in conjunction with scripting)</li></ul><p>For shorter snippets of code that can be embedded in&nbsp;<a href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes, see&nbsp;<a href=\"#root/_help_QxEyIjRBizuC\">Code blocks</a>.</p><p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Code_image.jpg\"></p><h2>Creating a code note</h2><p>In the <a href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, right-click a note and select <em>Insert child note</em> or <em>Insert note after</em>, then:</p><ul><li>To create a plain text code note, select <em>Code</em>.</li><li>To create a code note in a given language, hover <em>Code</em> and select the language. The list shows the languages enabled in the options (see below), and ends with <em>Configure code notes...</em>, which opens them.</li></ul><h2>Adjusting the language of a code note</h2><p>To change the language of a code note, look for the&nbsp;<span class=\"tn-icon bx bx-code\"></span> icon in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_AlJ73vBCjWDw\">Status bar</a>. When clicked it will reveal the list of available languages (which can be customized according to the section below). The menu also features a search bar to quickly filter, and icons to visually distinguish some of the programming languages.</p><p>On the&nbsp;<a class=\"reference-link\" href=\"#root/_help_RDslemsQ6gCp\">Mobile Frontend</a>, the same list is available in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>&nbsp;→ <em>Change language mode</em>.</p><h2>Adjusting the list of languages</h2><p>Trilium supports syntax highlighting for many languages, but by default displays only some of them. The supported languages can be adjusted by going to&nbsp;<a href=\"#root/_help_4TIF1oA4VQRO\">Options</a>, then <em>Code Notes</em> and looking for the <em>Available MIME types in the dropdown</em> section. Simply check any of the items to add them to the list, or un-check them to remove them from the list.</p><p>Note that the list of languages is not immediately refreshed, you'd have to manually <a href=\"#root/_help_s8alTXmpFR61\">refresh the application</a>.</p><p>The list of languages is also shared with the&nbsp;<a href=\"#root/_help_QxEyIjRBizuC\">Code blocks</a>&nbsp;feature of&nbsp;<a href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes.</p><h2>Word wrap</h2><p>Long lines can be displayed on multiple lines:</p><ul><li>Globally for all code notes, from&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Code Notes.</em></li><li>For a particular note, by going to the menu in&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>&nbsp;and selecting <em>Word wrap</em> and selecting the appropriate option:<ul><li><em>Auto</em>, to respect the global word wrap for code notes.</li><li><em>On</em> or <em>Off</em>, to change the state of the word wrap for this note regardless of the global option.</li></ul></li></ul><aside class=\"admonition note\"><p>Word wrapping can also be adjusted at note level through the <code>#wrapLines</code> <a href=\"#root/_help_HI6GBBIduIgv\">label</a>, which can also be inherited.</p></aside><h2>Adjusting options using the status bar</h2><p>The status bar at the bottom of the editor shows the current indentation settings and language. Clicking on the indentation indicator opens a menu with three sections:</p><ol><li><em>Indent Using</em> — switch between Spaces and Tabs (<code>#indentWithTabs</code>). If a per-note override is active, a \"Reset to default\" option appears.</li><li><em>Display Width</em> — choose from preset widths (1, 2, 3, 4, 6, 8). Changes are saved as a per-note <code>#tabWidth</code> label.</li><li><em>Re-indent Content To</em> — convert existing indentation to a different style. For example, re-indent a file from 4 spaces to 2 spaces, or from spaces to tabs. This rewrites the leading whitespace on every line while preserving alignment remainders.</li></ol><p>Clicking the language indicator lets you change the note's MIME type. As in the <em>Note type</em> selector, typing narrows the list of languages.</p><h3>Re-indentation</h3><p>When you re-indent content, the editor:</p><ul><li>Measures the visual column width of each line's leading whitespace using the current style</li><li>Calculates indent levels and any alignment remainder</li><li>Rebuilds the leading whitespace in the target style</li><li>Preserves non-leading whitespace, blank lines, and content without indentation</li></ul><h2>Color schemes</h2><p>Since Trilium 0.94.0 the colors of code notes can be customized by going&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ Code Notes and looking for the <em>Appearance</em> section.</p><aside class=\"admonition note\"><p><strong>Why are there only a few themes whereas the code block themes for text notes have a lot?</strong><br>The reason is that Code notes use a different technology than the one used in Text notes, and as such there is a more limited selection of themes. If you find a CodeMirror 6 (not 5) theme that you would like to use, let us know and we might consider adding it to the set of default themes. There is no possibility of adding new themes (at least for now), since the themes are defined in JavaScript and not at CSS level.</p></aside><h2>Programming ligatures</h2><p>If you see <code>!=</code> displayed as <code>≠</code> or <code>-&gt;</code> as <code>→</code> inside a code note, those are <em>font ligature</em>: the default monospace font draws certain character pairs as a single symbol. The underlying text is not changed by Trilium (unlike text notes which have&nbsp;<a class=\"reference-link\" href=\"#root/_help_oI7GoyilXXAr\">Automatic replacements</a>), and copying it out gives you back <code>!=</code> and <code>-&gt;</code>.</p><p>This can be turned off with&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a><em>→ Appearance → Fonts → Programming ligatures</em>.</p><h2>Virtual keyboard behavior</h2><p>When using a virtual keyboard, keyboard suggestions and corrections are controlled as follows:</p><ul><li>For&nbsp;<a class=\"reference-link\" href=\"#root/_help_6RM1Q7ppFVoj\">Markdown</a>&nbsp;and plain text code notes, the autocorrect is <strong>on</strong>, as well as automatic capitalization.</li><li>For all the other code notes, the autocorrect is off in order to avoid issues when typing code.</li></ul><aside class=\"admonition note\"><p>Not all browsers and platforms respect this value, so the keyboard suggestions might appear without autocorrecting or the browser might disregard this and autocorrect anyway.</p></aside>",
+ "_help_m523cpzocqaD": "<p>Trilium allows you to save common searches as notes within the note tree. The search results will appear as sub-notes under these \"saved search\" notes. Here is an example of how it works:</p><figure class=\"image image-style-align-center image_resized\" style=\"width:50%;\"><img style=\"aspect-ratio:812/585;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Saved%20Search_saved-search.gif\" width=\"812\" height=\"585\"></figure><p>A saved search runs when you open it, and when you expand it in the note tree. A saved search in a tab that is not shown, such as a background tab restored at startup, runs when you switch to that tab. Its results stay until you run the search again with the <em>Search</em> button of the search parameters. If the query has an error, it appears as a notification.</p><p>In&nbsp;<a class=\"reference-link\" href=\"#root/_help_64ZTlUPgEPtW\">Safe mode</a>, and when the request fails, the search does not run on its own. Press <em>Search now</em> to run it.</p><p>Once a search is saved, the <em>Search parameters</em> is still available underneath the&nbsp;<a class=\"reference-link\" href=\"#root/_help_l7pigIGu01K2\">Title</a>&nbsp;in order to be able to change the settings later on but it will appear collapsed by default.</p><h2>Location</h2><p>By default, saved searches are stored in the day note. However, you can designate a different note to store saved searches by marking it with the <code>#searchHome</code> label. Additionally, for <a href=\"#root/_help_9sRHySam5fXb\">workspaces</a>, you can use the <code>#workspaceSearchHome</code> label to specify a storage location for saved searches within that workspace.</p>",
+ "_help_iRwzGnHPzonm": "<p>Relation map is a type of&nbsp;note&nbsp;which visualizes notes and their <a href=\"#root/_help_zEY4DaJG4YT5\">relations</a>.</p><h2>Interaction</h2><ul><li>To create a new note and add it to the map, press the <span class=\"tn-icon bx bx-note\"></span> <em>Add note</em> button at the bottom of the map, then click anywhere on the map to place it there.<ul><li>While the map waits for the click, a translucent box follows the mouse to show where the note will go. To cancel, press the button again (now labeled <em>Cancel</em>) or press <kbd>Esc</kbd>.</li><li>The note is created as a child of the map, with the default title of a new note. It opens in the note panel (see below) with its title selected, so you can type its name straight away.</li></ul></li><li>An existing note can also be dragged from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>. It will be placed at the position it's dragged on.<ul><li>Multiple notes can also be dragged via&nbsp;<a class=\"reference-link\" href=\"#root/_help_yTjUdsOi4CIE\">Multiple selection</a>. The notes will be positioned near the dragged position without overlapping.</li><li>The dragged note can be a sub-child of the map, or it can be at any arbitrary position.</li></ul></li><li>Notes can also be pasted onto the map. Copy or cut them in the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, then click the map and press <kbd>Ctrl</kbd>+<kbd>V</kbd>, or right click an empty part of the map and select <em>Paste note(s)</em>.<ul><li>With <kbd>Ctrl</kbd>+<kbd>V</kbd>, the notes are placed under the mouse, or in the middle of the map if the mouse is not over it. From the right click menu, they are placed where the menu was opened.</li><li>Copied notes stay where they are in the tree. Cut notes are moved under the map, as if they had been pasted into it in the tree.</li><li>Links to notes, such as an <a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a> copied from a text note, can be pasted the same way. If the clipboard holds no link to a note, the notes last copied or cut in the tree are pasted.</li><li>The right click menu of an empty part of the map also has <em>Add note</em>, which creates a new note where the menu was opened.</li></ul></li><li>To create a relationship, hold the mouse on the dot on the right of a note and then:<ul><li>Drag it over another note to create a relationship pointing from the first note to the second one.</li><li>Drag over the same note to create a self-referencing relationship (represented as a loop).</li><li>Once dragged, a popover next to the relationship asks for its name. Type a new name and press <kbd>Enter</kbd>, or pick a relation name already in use from the suggestions. To cancel, press <kbd>Esc</kbd>, close the popover or click elsewhere on the map.</li></ul></li><li>Each note is shown as a card with its icon and title, colored in the note's color the same way as the cards of a <a class=\"reference-link\" href=\"#root/_help_CtBQqbwXDx1w\">Kanban Board</a>.</li><li>Hovering a note highlights its relationships, in the note's color if it has one, and fades the other relationships.</li><li>To view or edit a note, click it on the map. This opens the note panel (see below).<ul><li>To open the note in a new tab instead, <kbd>Ctrl</kbd>+click it or click it with the middle mouse button. <kbd>Shift</kbd>+click opens it in a new window. The right click menu offers the same options.</li></ul></li><li>To edit the title of a note, change its color or delete it (either from the map, or delete it completely), right click the note.</li><li>To rename or delete a relationship, right click it and select the corresponding option.</li><li>On a <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a> map, notes cannot be moved and relationships cannot be drawn, renamed or deleted. The right click menu of a note only offers to open it, and a relationship has no right click menu.</li><li>To move around the map, drag an empty part of it, and zoom with the mouse wheel or the <span class=\"tn-icon bx bx-minus-circle\"></span> and <span class=\"tn-icon bx bx-plus-circle\"></span> buttons at the bottom-right corner. Clicking the zoom percentage goes back to 100%, and <span class=\"tn-icon bx bx-scan\"></span> <em>Fit to view</em> zooms and pans so that all the notes are visible.<ul><li>Once the map has been clicked, the arrow keys or <kbd>W</kbd> <kbd>A</kbd> <kbd>S</kbd> <kbd>D</kbd> pan it, and <kbd>+</kbd> and <kbd>-</kbd> zoom it. The <kbd>?</kbd> button at the top-right corner of the map lists all its keyboard shortcuts.</li></ul></li></ul><h2>Note panel</h2><p>When a note on the map is clicked, a panel opens to the right of the map and the note is highlighted. If the panel would cover the note, or the note is partly off-screen, the map pans to bring it into view. The panel contains:</p><ul><li>The title and icon of the note, both editable.</li><li>A <span class=\"tn-icon bx bx-expand-alt\"></span> button to expand the panel over the whole map, and to restore it afterwards.</li><li>Buttons to interact with the note:<ul><li><span class=\"tn-icon bx bx-log-in\"></span> Open the note in the current tab, or, through the <span class=\"tn-icon bx bx-dots-horizontal-rounded\"></span> menu, in a new tab, split, window or the quick edit popup.</li><li>A <span class=\"tn-icon bx bx-palette\"></span> color picker to change the color of the note.</li><li>A <span class=\"tn-icon bx bx-trash\"></span> button to remove the note from the map, which can optionally delete the note as well.</li></ul></li><li>The <a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a> of the note, if any.</li><li>The note's content, which can be edited directly from the panel.</li></ul><p>The color picker and the remove button are not shown if the map is read-only.</p><p>Clicking another note on the map switches the panel to it. Similarly, clicking an <a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a> inside the panel switches the panel to that note, as long as it is on the map.</p><p>To close the panel, press the <span class=\"tn-icon bx bx-x\"></span> button at its top-right, click an empty part of the map, or press <kbd>Esc</kbd>.</p><p>On mobile, the note opens as a dialog over the whole screen instead of a panel.</p><h2>Development process demo</h2><p>This is a basic example how you can create simple diagram using relation maps:</p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Relation%20Map_relation-map-dev-process.png\" width=\"934\" height=\"667\"><p>And this is how you can create it:</p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Relation%20Map_relation-map-dev-process-demo.gif\" width=\"812\" height=\"585\"><p>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 <a href=\"#root/_help_zEY4DaJG4YT5\">relations</a>between notes and name them. That's all!</p><p>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 \"<a href=\"#root/_help_zEY4DaJG4YT5\">relations</a>\".</p><h2>Family demo</h2><p>This is more complicated demo using some advanced concepts. Resulting diagram is here:</p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Relation%20Map_relation-map-family.png\" width=\"941\" height=\"758\"><p>This is how you get to it:</p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Relation%20Map_relation-map-family-demo.gif\" width=\"812\" height=\"585\"><p>There are several steps here:</p><ul><li>we start with empty relation map and two existing notes representing Prince Philip and Queen Elizabeth II. These two notes already have <code>isPartnerOf</code> <a href=\"#root/_help_zEY4DaJG4YT5\">relations</a>defined.<ul><li>There are actually two \"inverse\" relations (one from Philip to Elizabeth and one from Elizabeth to Philip)</li></ul></li><li>we drag both notes to relation map and place to suitable position. Notice how the existing <code>isPartnerOf</code> relations are displayed.</li><li>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).</li><li>we create two new relations <code>isChildOf</code> targeting both Philip and Elizabeth<ul><li>now there's something unexpected - we can also see the relation to display another <code>hasChild</code> relation. This is because there's a <a href=\"#root/_help_OFXdgB2nNk1F\">relation definition</a> which puts <code>isChildOf</code> as an \"<a href=\"#root/_help_OFXdgB2nNk1F\">inverse</a>\" relation of <code>hasChildOf</code> (and vice versa) and thus it is created automatically.</li></ul></li><li>we create another note for Princess Diana and create <code>isPartnerOf</code> relation from Charles. Again notice how the relation has arrows both ways - this is because <code>isPartnerOf</code> definition specifies its inverse relation as again \"isPartnerOf\" so the opposite relation is created automatically.</li><li>as the last step we pan &amp; zoom the map to fit better to window dimensions.</li></ul><p>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 <a href=\"#root/_help_wX4HbRucYSDD\">demo notes</a>.</p><h2>Details</h2><p>You can specify which relations should be displayed with comma delimited names of relations in <code>displayRelations</code> label.</p><p>Alternatively, you can specify comma delimited list of relation names in <code>hideRelations</code> which will display all relations, except for the ones defined in the label.</p><h2>See also</h2><ul><li><a class=\"reference-link\" href=\"#root/_help_bdUJEHsAPYQR\">Note Map</a>&nbsp;is a similar concept.</li></ul>",
+ "_help_bdUJEHsAPYQR": "<figure class=\"image image_resized\" style=\"width:72.68%;\"><img style=\"aspect-ratio:1311/1271;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Note%20Map_image.png\" width=\"1311\" height=\"1271\"></figure><p>A Note map is a note type which displays a standalone version of the feature of the same name:&nbsp;<a class=\"reference-link\" href=\"#root/_help_BCkXAVs63Ttv\">Note Map (Link map, Tree map)</a>. Consult that page for more information on how the note map works and what it displays.</p><p>Once created, the note map will display the relations between notes. Only the notes that are part of the parent of the note map will be displayed (including their children).</p><h2>Root note</h2><p>The root note defines the starting point of the graph, from which the relations and the hierarchy are derived from.</p><p>There are three possible root notes:</p><ul><li>The default root note is the parent note of the note map.</li><li>To use the currently <a href=\"#root/_help_OR8WJ7Iz9K4U\">hoisted note</a> instead, set the <code>mapRootNoteId</code> label to <code>hoisted</code>.</li><li>To use a specific note instead, set <code>mapRootNoteId</code> to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_m1lbrzyKDaRB\">Note ID</a>&nbsp;of the desired note.</li></ul><h2>Customization</h2><p>The note map can be customized using the following&nbsp;<a class=\"reference-link\" href=\"#root/_help_HI6GBBIduIgv\">Labels</a>:</p><figure class=\"table\"><table><thead><tr><th>Label</th><th>Description</th></tr></thead><tbody><tr><td><code>#mapIncludeRelation</code></td><td>Comma-delimited relation names to include from the note map.</td></tr><tr><td><code>#mapExcludeRelation</code></td><td>Comma-delimited relation names to exclude from the note map.</td></tr><tr><td><code>#mapRootNoteId</code></td><td>The ID of the note the map roots from, or <code>hoisted</code>. See the root note section above for more information.</td></tr></tbody></table></figure>",
+ "_help_HcABDtFCkbFN": "<figure class=\"image\"><img style=\"aspect-ratio:601/216;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Render%20Note_image.png\" width=\"601\" height=\"216\"></figure><p>Render Note is a special case of <a href=\"#root/_help_yIhgI5H7A2Sm\">front-end scripting</a> which allows rendering custom content inside a note. This makes it possible to create custom dashboards, or to use a custom note editor.</p><p>The content can either be a vanilla HTML, or Preact JSX.</p><h2>Creating a render note</h2><ol><li>Create a&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;note with the:<ol><li>HTML language for the legacy/vanilla method, with what needs to be displayed (for example <code>&lt;p&gt;Hello world.&lt;/p&gt;</code>).</li><li>JSX for the Preact-based approach (see below).</li></ol></li><li>Create a&nbsp;<a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a>.</li><li>Assign the <code>renderNote</code> <a href=\"#root/_help_zEY4DaJG4YT5\">relation</a> to point at the previously created code note.</li></ol><h2>Legacy scripting using jQuery</h2><p>A static HTML is generally not enough for&nbsp;<a class=\"reference-link\" href=\"#root/_help_CdNpE2pqjmI6\">Scripting</a>. The next step is to automatically change parts of the note using JavaScript.</p><p>For a simple example, we are going to create a render note that displays the current date in a field.</p><p>To do so, first create an HTML code note with the following content:</p><pre><code class=\"language-text-html\">&lt;h1&gt;Current date &amp; time&lt;/h1&gt;\nThe current date &amp; time is &lt;span class=\"date\"&gt;&lt;/span&gt;</code></pre><p>Now we need to add the script. Create another&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>, but this time of JavaScript (frontend) language. Make sure the newly created note is a direct child of the HTML note created previously; with the following content:</p><pre><code class=\"language-text-javascript\">const $dateEl = api.$container.find(\".date\");\n$dateEl.text(new Date());</code></pre><p>Now create a render note at any place and set its <code>~renderNote</code> relation to point to the HTML note. When the render note is accessed it will display:</p><blockquote><p><strong>Current date &amp; time</strong><br>The current date &amp; time is Sun Apr 06 2025 15:26:29 GMT+0300 (Eastern European Summer Time)</p></blockquote><h2>Dynamic content using Preact &amp; JSX</h2><p>As a more modern alternative to jQuery, it's possible to use Preact &amp; JSX to render pages. Since JSX is a superset of JavaScript, there's no need to provide a HTML anymore.</p><p>Here are the steps to creating a simple render note:</p><ol><li><p>Create a note of type&nbsp;<a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a>.</p></li><li><p>Create a child&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;note with JSX as the language.<br>As an example, use the following content:</p><pre><code class=\"language-text-x-trilium-auto\">export default function() {\n return (\n &lt;&gt;\n &lt;p&gt;Hello world.&lt;/p&gt;\n &lt;/&gt;\n );\n}</code></pre></li><li><p>In the parent render note, define a <code>~renderNote</code> relation pointing to the newly created child.</p></li><li><p>Refresh the render note and it should display a “Hello world” message.</p></li></ol><h2>Refreshing the note</h2><p>It's possible to refresh the note via:</p><ul><li>The&nbsp;<span class=\"tn-icon bx bx-refresh\"></span> button in&nbsp;the&nbsp;<a class=\"reference-link\" href=\"#root/_help_1P8QXI5edXNd\">Note buttons</a>&nbsp;area.</li><li>The “Render active note” <a href=\"#root/_help_A9Oc6YKKc65v\">keyboard shortcut</a> (not assigned by default).</li></ul><h2>Printing</h2><p>A render note can be printed or exported as PDF from the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> once its <code>~renderNote</code> relation is set (see <a class=\"reference-link\" href=\"#root/_help_NRnIZmSMc5sj\">Printing &amp; Exporting as PDF</a>). Unlike other notes, it is printed exactly as it is displayed: the script does not run again, so what was typed, selected or loaded in the note is kept.</p><ul><li>The content is laid out again at the width of the page, so elements sized by the script for the screen (such as charts) might not fit.</li><li>Scrolling areas, such as a table in a scrolling container, are printed at their full height, without a scrollbar.</li><li>To adjust the layout for printing, use a <code>~printCss</code> relation.</li><li>The light colors are used for printing, whatever the current theme.</li></ul><p>When a render note is printed as part of a <a class=\"reference-link\" href=\"#root/_help_mULW0Q3VojwY\">List View</a> collection, or from another view such as its attachments, it is not on screen, so its script runs again for the print. In a collection, the output is printed without the note's own styles.</p><h2>Examples</h2><ul><li><a class=\"reference-link\" href=\"#root/_help_R7abl2fc6Mxi\">Weight Tracker</a>&nbsp;which is present in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_6tZeKvSHEUiB\">Demo Notes</a>.</li></ul>",
+ "_help_s1aBHPd79XYj": "<aside class=\"admonition tip\"><p>For a quick understanding of the Mermaid syntax, see&nbsp;<a class=\"reference-link\" href=\"{{helpAssets}}/User%20Guide/Note%20Types/Mermaid%20Diagrams/Syntax%20reference.dat\">Syntax reference</a>&nbsp;(official documentation).</p></aside><figure class=\"image\"><img style=\"aspect-ratio:1464/915;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Mermaid%20Diagrams_image.png\" width=\"1464\" height=\"915\"></figure><p>Trilium supports Mermaid, which adds support for various diagrams such as flowchart, sequence diagram, class diagram, state diagram, pie charts, etc., all using a text description of the chart instead of manually drawing the diagram.</p><p>This note type is a split view, meaning that both the source code and a preview of the document are displayed side-by-side. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_SL5f1Auq7sVN\">Note types with split view</a>&nbsp;for more information.</p><h2>Sample diagrams</h2><p>Starting with v0.103.0, Mermaid diagrams no longer start with a sample flowchart, but instead a pane at the bottom will show all the supported diagrams with sample code for each:</p><ul><li>Simply click on any of the samples to apply it.</li><li>The pane will disappear as soon as something is typed in the code editor or a sample is selected. To make it appear again, simply remove the content of the note.</li></ul><h2>Layouts</h2><p>Depending on the chart being edited and user preference, there are two layouts supported by the Mermaid note type:</p><ul><li>Horizontal, where the source code (editable part) is on the left side of the screen and the preview is to the right.</li><li>Vertical, where the source code is at the bottom of the screen and the preview is at the top.</li></ul><p>It's possible to switch between the two layouts at any time by pressing the&nbsp;<span class=\"tn-icon bx bxs-dock-left\"></span> icon in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_1P8QXI5edXNd\">Note buttons</a>.</p><h2>Interaction</h2><ul><li>The source code of the diagram (in Mermaid format) is displayed on the left or bottom side of the note (depending on the layout).<ul><li>Changing the diagram code will refresh automatically the diagram.</li></ul></li><li>The preview of the diagram is displayed at the right or top side of the note (depending on the layout):<ul><li>There are dedicated buttons at the bottom-right of the preview to control the zoom in, zoom out or fit the diagram.</li><li>The preview can be moved around by holding the left mouse button and dragging.</li><li>Zooming can also be done by using the scroll wheel.</li><li>The zoom and position on the preview will remain fixed as the diagram changes, to be able to work more easily with large diagrams.</li><li>Double-clicking the preview resets the zoom/position.</li><li>The preview can also be focused by clicking on it, case in which keyboard shortcuts can be used:<ul><li><kbd>+</kbd> or <kbd>E</kbd> to zoom in, <kbd>-</kbd> or <kbd>Q</kbd> to zoom out.</li><li><kbd>/</kbd> to reset the zoom/position.</li><li>Arrow keys or <kbd>W</kbd> <kbd>A</kbd> <kbd>S</kbd> <kbd>D</kbd> to pan. Holding <kbd>Shift</kbd> pans faster.</li></ul></li></ul></li><li>The size of the source/preview panes can be adjusted by hovering over the border between them and dragging it with the mouse.</li><li>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_1P8QXI5edXNd\">Note buttons</a>:<ul><li>The source/preview can be laid out left-right (via <span class=\"tn-icon bx bxs-dock-left\"></span>) or bottom-top (via <span class=\"tn-icon bx bxs-dock-bottom\"></span>).</li><li>Press the&nbsp;<span class=\"tn-icon bx bx-copy\"></span> (<em>Copy image reference to the clipboard</em>) to be able to insert the image representation of the diagram into a text note. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_0Ofbk1aSuVRu\">Image references</a>&nbsp;for more information.</li></ul></li><li>To export the diagram as either SVG or PNG, go to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_1P8QXI5edXNd\">Note buttons</a>&nbsp;and select <em>Export as image</em>:<ul><li>Select <em>SVG (vector)</em> to download a scalable/vector rendering of the diagram. Can be used to present the diagram without degrading when zooming.</li><li>Select <em>PNG (raster)</em> to download a normal image (at 1x scale, raster) of the diagram. Can be used to send the diagram in more traditional channels such as e-mail.</li></ul></li><li>The note can be marked as <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a>, case in which it switches by default to the preview (although it can be switched back using the source/preview buttons) and the source is no longer editable.</li></ul><h2>Errors in the diagram</h2><p>If there is an error in the source code, the error will be displayed in an information pane.</p><p>During the state of an error, the diagram will no longer be rendered and the previously working diagram will remain in the preview section.</p>",
+ "_help_RH6yLjjWJHof": "<p>Mermaid supports a different layout engine which supports slightly more complex diagrams, called the <a href=\"https://eclipse.dev/elk/\">Eclipse Layout Kernel (ELK)</a>. Trilium has support for these as well, but it's not enabled by default.</p><p>In order to activate ELK for any diagram, insert the following YAML frontmatter right at the beginning of the diagram:</p><pre><code class=\"language-text-x-yaml\">---\nconfig:\n layout: elk\n---</code></pre><figure class=\"table\"><table><thead><tr><th>With ELK off</th><th>With ELK on</th></tr></thead><tbody><tr><td><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Mermaid%20Diagrams/ELK%20layout_ELK%20off.svg\"></td><td><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Mermaid%20Diagrams/ELK%20layout_ELK%20on.svg\"></td></tr></tbody></table></figure>",
+ "_help_grjYqerjn243": "<figure class=\"image\"><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Canvas_image.png\" alt=\"grafik\"></figure><p>Canvas notes use the Excalidraw library to allow handwritten notes with mouse, pen or touch on an infinite canvas. It also supports basic diagramming, text and graphics input.</p><h2>Interaction</h2><ul><li>The note can be togged <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a> from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>.</li></ul><h2>Embedding notes</h2><p>Since v0.104.0, Canvas supports embedding notes in a similar fashion to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>&nbsp;functionality for&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes.</p><p>To embed a note:</p><ul><li>From the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, drag the item onto the canvas.</li><li>Manually, by choosing <em>More tools</em> → <em>Web Embed</em> and pasting the link to the note (e.g. <code>root/MujWAc9fQ1nj</code>).</li></ul><p>Embedding notes in the canvas follows the same rules as&nbsp;<a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>: some notes are rendered as images (e.g.&nbsp;<a class=\"reference-link\" href=\"#root/_help_gBbsAeiuUxI5\">Mind Map</a>), whereas some render fully interactive such as&nbsp;<a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>.</p><h2>Linking to a note</h2><ol><li>From the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;right click the note to be linked and selected <em>Advanced → Copy note path to the clipboard</em>.</li><li>In the canvas note, right click an element and select <em>Add link</em> (or press <kbd>Ctrl</kbd>+<kbd>K</kbd>). Paste the link and press <kbd>Enter</kbd>.</li><li>A&nbsp;<span class=\"tn-icon bx bx-link-external\"></span> icon will appear at the top-right of the element which will navigate to the linked note when clicked.</li></ol><h2>Drawing in a text note</h2><p>To draw inside a&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;note instead of in a note of its own, insert a drawing canvas with <span class=\"tn-icon bx bx-pen\"></span><em>Drawing canvas</em> in the <span class=\"tn-icon cke cke-plus\"></span><em>Insert</em> menu. See <em>Drawing canvases</em> in&nbsp;<a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>.</p>",
+ "_help_1vHRoWCEjj0L": "<h2>Configuration</h2><p>A webview needs to know which URL to render, and it can be provided by setting the <code>webViewSrc</code> <a href=\"#root/_help_zEY4DaJG4YT5\">label</a>, such as:</p><pre><code class=\"language-text-x-trilium-auto\">#webViewSrc=\"https://www.wikipedia.org\"</code></pre><p>The URL needs to contain the full scheme.</p><h2>Web view on the server vs. Electron</h2><p>When accessing Trilium via a browser instead of the desktop application, the web view will still try to render the content of the desired webpage. However, since it's running in a browser there are quite a few limitations as opposed to the desktop one.</p><p>More specifically, quite a few websites oppose being embedded in another website (technically they have a non-permisive <code>X-Frame-Options</code> header). This is not bypassable by Trilium so the page will simply fail to render.</p><p>You can diagnose this by right clicking the Trilium web page → Inspect (element) and looking in the “Console” tab for errors such as:</p><ul><li><code>Refused to display 'https://www.google.com/' in a frame because it set 'X-Frame-Options' to 'sameorigin'.</code></li><li><code>Refused to frame 'https://duckduckgo.com/' because an ancestor violates the following Content Security Policy directive: \"frame-ancestors 'self' https://html.duckduckgo.com\".</code></li></ul><p>There are a few websites that do render such as <code>wikipedia.org</code>.</p><p>Do note that we are also applying some sandboxing constraints on the server side, so if you have any issues other than the unresolvable <code>X-Frame-Options</code> described above, feel free to report them.</p><p>On the desktop side, a different technology is used which bypasses the constraints of an <code>iframe</code> (<code>webview</code>).</p><h2>Embedding in other note types</h2><p>Starting with v0.104.0, web views can be embedded into other note types:</p><ul><li><a class=\"reference-link\" href=\"#root/_help_IF7Q6I9x7zuw\">Dashboard</a></li><li><a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a></li><li><a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes via&nbsp;<a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>.</li></ul>",
+ "_help_gBbsAeiuUxI5": "<figure class=\"image image-style-align-center\"><img style=\"aspect-ratio:892/675;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Mind%20Map_image.png\" width=\"892\" height=\"675\"></figure><p>The mindmap allows for easy jotting down of ideas and storing them in a hierarchical fashion.</p><h2>Terminology</h2><ul><li>A <strong>node</strong> is a single idea, represented differently based on depth (filled rounded rectangle for the root note, unfilled rectangles for sub-ideas, lines only for sub-sub-ideas).</li><li>The <strong>root node</strong> is the top-most node from which all other nodes derive, displayed as a filled rectangle. There can only be a single root node.</li></ul><h2>Interaction</h2><ul><li>To create a new node at the same level as the current one, press <kbd>Enter</kbd>, enter the desired text and then press <kbd>Enter</kbd> once again to confirm.</li><li>Similarly, to create a sub-node, press <kbd>Tab</kbd>, enter the desired text and then press <kbd>Enter</kbd>.</li><li>To create a parent, use <kbd>Ctrl</kbd>+<kbd>Enter</kbd> instead.</li><li>To remove a node, press <kbd>Delete</kbd>.</li><li>To move a node up or down, press <kbd>Page Up</kbd> or <kbd>Page Down</kbd>.</li><li>To adjust the font size, color of the text or background or to add a link, click on a node and use the floating panel that appears to the right.</li><li>To select one or more notes, drag and drop across the map.</li><li>Right click the node to bring a contextual menu with options such as creating new nodes, focusing on a particular notes or creating links between them.</li><li>Use the buttons at the top-left to change the positioning of the nodes relative to the root node (to the left, to the right, or to both sides).</li><li>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_1P8QXI5edXNd\">Note buttons</a>&nbsp;area, an <a href=\"#root/_help_0Ofbk1aSuVRu\">image reference</a> can be copied by pressing the&nbsp;<span class=\"tn-icon bx bx-copy\"></span> button, to paste the mind map in a text note.</li><li>From the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>, the diagram can be exported either as SVG (vectorial) or PNG (raster) by selecting <em>Export as image</em>.</li><li>The note can be set as <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a> which will disable all editing features.</li></ul>",
+ "_help_W8vYD3Q1zjCR": "<p>The <em>File</em> note type can be used to attach various external files such as images, videos or PDF documents.</p><h2>Uploading a file</h2><p>Since these files come from an external source, it is not possible to create a <em>File</em> note type directly:</p><ul><li>Drag a file into the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.</li><li>Right click a note and select <em>Import into note</em> and point it to one of the supported files.</li></ul><h2>Supported file types</h2><h3>PDFs</h3><p>PDFs can be uploaded to Trilium and they will display a live preview with full support for various features such as table of contents, annotations, as well as remembering the last page read. For more information, see the dedicated&nbsp;<a class=\"reference-link\" href=\"#root/_help_XJGJrpu7F9sh\">PDFs</a>&nbsp;page.</p><h2>Office documents</h2><p>Trilium offers previews for Office documents such as Word (<code>.docx</code>), Excel (<code>.xlsx</code>) and PowerPoint (<code>.pptx</code>). For more information, see the dedicated&nbsp;<a class=\"reference-link\" href=\"#root/_help_KG48zgNY31NW\">Office documents</a>.</p><h3>Images</h3><figure class=\"image image-style-align-center image_resized\" style=\"width:50%;\"><img style=\"aspect-ratio:879/766;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/2_File_image.png\" width=\"879\" height=\"766\"></figure><p>Interaction:</p><ul><li>An <a href=\"#root/_help_0Ofbk1aSuVRu\">image reference</a> can be copied by pressing the&nbsp;<span class=\"tn-icon bx bx-copy\"></span> icon from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_1P8QXI5edXNd\">Note buttons</a>&nbsp;area, which allows pasting it in a&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;note.</li></ul><h3>Videos</h3><p>See&nbsp;<a class=\"reference-link\" href=\"#root/_help_AjqEeiDUOzj4\">Audio &amp; Video</a>.</p><h3>Audio</h3><figure class=\"image image-style-align-center image_resized\" style=\"width:50%;\"><img style=\"aspect-ratio:850/243;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/1_File_image.png\" width=\"850\" height=\"243\"></figure><p>Adding a supported audio file will reveal a basic audio player that can be used to play it.</p><p>Interactions:</p><ul><li>The audio can be played/paused using the dedicated button.</li><li>Dragging the mouse across, or clicking the progress bar will seek through the song.</li><li>The volume can be set.</li><li>The playback speed can be adjusted via the contextual menu next to the volume.</li></ul><h3>Text files</h3><figure class=\"image image-style-align-center image_resized\" style=\"width:50%;\"><img style=\"aspect-ratio:926/347;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/File_image.png\" width=\"926\" height=\"347\"></figure><p>Files that are identified as containing text will show a preview of their content. One common use case for this type of file is to embed text files whose content is not necessarily of interest to the user, such as third-party libraries or generated content, that can then be downloaded if needed.</p><p>Note that generally text files will be <a href=\"#root/_help_mHbBMPDPkVV5\">imported</a> as either&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;or&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;notes. To bypass this behavior and create a <em>File</em> note type, use the <em>Import into note</em> feature and uncheck <em>Import HTML, Markdown and TXT as text notes</em>, as well as <em>Import recognized code files as code notes</em>.&nbsp;</p><p>Since one of the use cases for having files instead of notes is to display large files, the content preview is limited to a relatively small amount of characters. To view the full file, consider opening it in an external application.</p><h3>GPS tracks</h3><p>Trilium displays information about GPS tracks in <code>.gpx</code> format, such as the distance, duration, elevation profile, tracks, markers.</p><p>When a <code>.gpx</code> note is dropped in a&nbsp;<a class=\"reference-link\" href=\"#root/_help_81SGnPGMk7Xc\">Geo Map</a>, the track itself will also be displayed on the map.</p><figure class=\"image\"><img style=\"aspect-ratio:1500/807;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/4_File_image.png\" width=\"1500\" height=\"807\"></figure><h3>Fonts</h3><p>Supported font formats will show an interactive preview of the font:</p><ul><li>A field to type in a custom text.</li><li>A slider to change the font size of the preview.</li><li>A preview of the text at the given size.</li><li>A sampling of various font sizes for this font.</li><li>The Latin alphabet.</li></ul><p>Additionally, enabling <em>In font picker</em> will make the font available in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Appearance</em> font selection. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_w4rMEhJsALlA\">Personalizing the font</a>&nbsp;for more information.</p><h3>Unknown file types</h3><figure class=\"image image-style-align-center image_resized\" style=\"width:50%;\"><img style=\"aspect-ratio:532/240;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/3_File_image.png\" width=\"532\" height=\"240\"></figure><p>If the file could not be identified as any of the supported file types from above, it will be treated as an unknown file. In this case, all the default interactions will be available such as downloading or opening the file externally, but there will be no preview of the content.</p><h2>Interaction</h2><ul><li>Regardless of the file type, a series of buttons will be displayed in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>&nbsp;area.<ul><li><span class=\"tn-icon bx bx-download\"></span>&nbsp;(Download), which will download the file for local use.</li><li><span class=\"tn-icon bx bx-link-external\"></span>&nbsp;(Open), will will open the file with the system-default application.</li><li><span class=\"tn-icon bx bx-folder-open\"></span>&nbsp;(Upload new revision) to replace the file with a new one.</li></ul></li><li>It is <strong>not</strong> possible to change the note type of a <em>File</em> note.</li><li>Convert into an <a href=\"#root/_help_0vhv7lsOLy82\">attachment</a> from the <a href=\"#root/_help_8YBEPzcpUgxw\">note menu</a>.</li></ul><h2>Relation with other notes</h2><ul><li><p>Files are also displayed in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_0ESUbbAxVnoK\">Note List</a>&nbsp;based on their type:</p><img class=\"image_resized\" style=\"aspect-ratio:853/315;width:50%;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/5_File_image.png\" width=\"853\" height=\"315\"></li><li><p>Non-image files can be embedded into text notes as read-only widgets via the&nbsp;<a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>&nbsp;functionality.</p></li><li><p>Image files can be embedded into text notes like normal images via&nbsp;<a class=\"reference-link\" href=\"#root/_help_0Ofbk1aSuVRu\">Image references</a>.</p></li></ul><h2>File size limit</h2><p>An individual file cannot be bigger than 374 MiB. For more information see <em>Maximum import size</em> in&nbsp;<a class=\"reference-link\" href=\"#root/_help_mHbBMPDPkVV5\">Import &amp; Export</a>.</p>",
+ "_help_XJGJrpu7F9sh": "<figure class=\"image image_resized\" style=\"width:74.34%;\"><img style=\"aspect-ratio:1360/698;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/File/PDFs_image.png\" width=\"1360\" height=\"698\"></figure><p>PDFs file can be uploaded in Trilium, where they will be displayed without the need to download them first.</p><p>Since v0.102.0, PDFs will be rendered using Trilium's built-in PDF viewer, which is a customization of <a href=\"https://mozilla.github.io/pdf.js/\">Mozilla's PDF.js viewer</a> (also built-in in the Mozilla Firefox browser). Versions prior to that render PDFs using the browser's default PDF viewer.</p><h2>Features</h2><ul><li>The last page viewed and scroll position is maintained in between restarts or note navigations.</li><li>Annotations (text, highlights) as well as comments. These are saved automatically.</li><li>Forms can be filled.</li><li>Can be printed or downloaded.</li><li>Can be saved as a <a href=\"#root/_help_KC1HB96bqqHX\">template</a> and the content of the PDF will be copied over to the new note. This is especially useful in combination with annotations or filled forms.</li><li>Integrates with the&nbsp;<a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>&nbsp;by displaying the list of pages with thumbnails, table of contents and a listing of the annotations.</li><li>Basic support for signatures (the hand-drawn ones, not proper digital signatures), similar to annotations. Signatures are stored and can be reused across multiple documents (up to 5).</li></ul><h2>Storing last position and settings</h2><p>For every PDF, Trilium will remember the following information:</p><ul><li>The current page.</li><li>The scroll position, within the current page.</li><li>The rotation of the page.</li></ul><p>This makes it useful when reading large documents since the position is remembered automatically. This happens in the background, however it's recorded only a few seconds after stopping any scroll actions.</p><aside class=\"admonition tip\"><p>Technically, the information about the scroll position and rotation is stored in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>&nbsp;section, in a dedicated attachment called <code>pdfHistory.json</code>.</p></aside><h2>Annotations</h2><p>Since v0.102.0 it's possible to annotate PDFs. To do so, look for the annotation buttons on the right side of the PDF toolbar (<img src=\"{{helpAssets}}/User%20Guide/Note%20Types/File/1_PDFs_image.png\" width=\"120\" height=\"32\">).</p><p>Since v0.103.0:</p><ul><li>Annotations are disabled if the note is marked as&nbsp;<a class=\"reference-link\" href=\"#root/_help_CoFPLs3dRlXc\">Read-Only Notes</a>.</li><li>Comments can also be added, which is similar to highlights but also attach a text.</li><li>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>&nbsp;also displays a list of annotations (highlights, comments).</li></ul><h3>Supported annotations</h3><p>The following annotation methods are supported:</p><ul><li><strong>Highlight</strong><br>Allows highlighting text with one of the predefined colors.<ul><li>The thickness is also adjustable.</li><li>It's also possible to highlight the blank space, turning the feature more into a thicker pen.</li></ul></li><li><strong>Text</strong><br>Allows adding arbitrary text, with a custom color and size.</li><li><strong>Pen</strong><br>Allows free drawing on the document, with variable color, thickness and opacity.</li><li><strong>Image</strong><br>Allows inserting images from outside Trilium directly into the document.</li></ul><h3>Editing existing annotations</h3><p>Although annotations are stored in the PDF itself, they can be edited. To edit an annotation, press one of the annotation buttons from the previous section to enter edit mode and click on an existing annotation. This will reveal a toolbar with options to customize the annotation (e.g. to change a color), as well as the possibility to remove it.</p><h3>How are annotations stored</h3><p>Annotations are stored directly in the PDF. When modifications are made, Trilium will replace the PDF with the new one.</p><p>Since modifications are automatically saved, there's no need to manually save the document after making modifications to the annotations.</p><p>The benefit of “baked-in annotations” is that they are also accessible if downloading (for external use outside Trilium) or sharing the note.</p><p>The downside is that the entire PDF needs to be sent back to the server, which can slow down performance for larger documents. If you encounter any issues from this system, feel free to <a href=\"#root/_help_wy8So3yZZlH9\">report it</a>.</p><h2>Linking to a page or an annotation</h2><p>A link can open a PDF at a given page, or at one of its annotations. To create one:</p><ul><li>To link to a page, right-click the page in the <em>Pages</em> section of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>&nbsp;and select <em>Copy reference</em>.</li><li>To link to an annotation, right-click it in the <em>Annotations</em> section of the sidebar and select <em>Copy reference</em>.</li></ul><p>Pasted into a text note, the reference becomes one of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>, showing the title of the PDF followed by the page (<em>Page 5</em>), or by <em>Annotation on page 5</em> for a reference to an annotation. Clicking it opens the PDF and scrolls to the page or to the annotation.</p><p>A reference to an annotation also carries its page, so a link to an annotation that was deleted still opens the right page.</p><aside class=\"admonition note\"><p>An annotation drawn since the PDF was opened does not have a permanent identifier until the PDF is opened again, so a reference copied for it points at its page only.</p></aside><h2>Filling out forms</h2><p>Similar to annotations, forms are also supported by Trilium since v0.102.0. If the document has fields that can be filled-in, they will be indicated with a colored background.</p><p>Simply type text in the forms and they will be automatically saved.</p><h2>Sidebar navigation</h2><p>See the dedicated section on PDFs in&nbsp;<a class=\"reference-link\" href=\"#root/_help_2dcGDhp9WFKb\">Outline tab</a>.</p><h2>Share functionality</h2><p>PDFs can also be shared using the&nbsp;<a class=\"reference-link\" href=\"#root/_help_R9pX4DGra2Vt\">Sharing</a>&nbsp;feature. This will also use Trilium's customized PDF viewer.</p><p>If you are using a reverse proxy on your server with strict access limitations for the share functionality, make sure that <code>[host].com/pdfjs</code> directory is accessible. Note that this directory is outside the <code>/share</code> route as it's common with the rest of the application.</p><h2>OCR</h2><p>PDFs are eligible for&nbsp;<a class=\"reference-link\" href=\"#root/_help_TiQbQDgP8L5t\">Text Extraction (OCR)</a>, which means that their text can be used in&nbsp;<a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>.</p>",
+ "_help_AjqEeiDUOzj4": "<figure class=\"image image-style-align-right image_resized\" style=\"width:61.8%;\"><img style=\"aspect-ratio:953/587;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/File/Audio%20%26%20Video_image.png\" width=\"953\" height=\"587\"></figure><p>Starting with v0.103.0, Trilium has a custom media player for both video and audio files, which offers more features than the built-in player.</p><p>Versions prior to v0.103.0 also support media, but using the built-in player.</p><p>The file is streamed directly, so when accessing the note from a server it doesn't have to download the entire file to start playing it.</p><h2>Note on large media files</h2><p>Although Trilium offers support for media files, it is generally not meant to be used with very large files. Uploading large media will cause the&nbsp;<a class=\"reference-link\" href=\"#root/_help_wX4HbRucYSDD\">Database</a>&nbsp;to balloon, as well as any&nbsp;<a class=\"reference-link\" href=\"#root/_help_ODY7qQn5m2FT\">Backup</a>&nbsp;of it. In addition, there might be slowdowns when first uploading the files. Otherwise, a large database should not impact the general performance of Trilium significantly.</p><h2>Supported formats</h2><p>Trilium uses the built-in media decoding mechanism of the browser (or Electron/Chromium when running on the desktop). Starting with v0.103.0, a message will be displayed instead when a media format is not supported.</p><h2>Interactions</h2><p>To play/pause, simply click anywhere on the media. For video files, the controls at the bottom will hide automatically after playing, simply move the mouse to show them again.</p><p>The bottom bar has the following features:</p><ul><li>A track bar to seek across the media. Audio files up to 60 MB will display a waveform seekbar, to give a visual overview of the track's structure: silences, pauses, and louder segments.</li><li>On the left of the track bar, the current time is indicated.</li><li>On the right of the track bar, the remaining time is indicated.</li><li>On the left side there are buttons to:<ul><li>Adjust the playback speed (e.g. 0.5x, 1x).</li><li>Play mode (applies to all media from the parent note):<ul><li>Play once — play the media until it ends, then stop.</li><li>Loop — replay the media automatically once it ends.</li><li>Play next — when the current item ends, continue with the next one in the same parent note until the last item finishes.</li></ul></li><li>Rotate the video by 90 degrees (video only).</li></ul></li><li>In the center:<ul><li>Previous media — jumps to the previous media: the nearest media note above the current one in the tree (within the same parent note) in the case of media notes, or the previous media attachment.</li><li>Go back by 10s</li><li>Play/pause</li><li>Go forward by 10s</li><li>Next media — jumps to the next media: the nearest media note below the current one in the tree (within the same parent note) in the case of media notes, or the next media attachment.</li></ul></li><li>On the right side:<ul><li>Mute button</li><li>Volume adjustment</li><li>Full screen (video only)</li><li>Zoom to fill, which will crop the video so that it fills the entire window (video only).</li><li>Picture-in-picture, if the browser supports it (video only).</li></ul></li></ul><h2>Including media in notes</h2><figure class=\"image\"><img style=\"aspect-ratio:1395/145;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/File/1_Audio%20%26%20Video_image.png\" width=\"1395\" height=\"145\"><figcaption>An audio note include (configured to the \"Small\" size).</figcaption></figure><p><a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;and&nbsp;<a class=\"reference-link\" href=\"#root/_help_6RM1Q7ppFVoj\">Markdown</a>&nbsp;notes can embed an interactive media player directly in the note content. To do so, include the audio or video file:</p><ul><li><strong>Text notes:</strong> in the formatting toolbar, click <em>Insert</em> → <em>Include</em>.</li><li><strong>Markdown notes:</strong> type <code>/include</code> press <kbd>Enter</kbd>.</li></ul><p>Then select the audio/video file note to be included.</p><h2>Keyboard shortcuts</h2><p>The following keyboard shortcuts are supported by the media player:</p><figure class=\"table\"><table><tbody><tr><td><kbd>Space</kbd></td><td>Play/pause</td></tr><tr><td><kbd>Left arrow key</kbd></td><td>Go back by 10s</td></tr><tr><td><kbd>Right arrow key</kbd></td><td>Go forward by 10s</td></tr><tr><td><kbd>Ctrl</kbd> + <kbd>Left arrow key</kbd></td><td>Go back by 1 min</td></tr><tr><td><kbd>Ctrl</kbd> + <kbd>Right arrow key</kbd></td><td>Go right by 1 min</td></tr><tr><td><kbd>Page Up</kbd></td><td>Navigate to the previous media</td></tr><tr><td><kbd>Page Down</kbd></td><td>Navigate to the next media</td></tr><tr><td><kbd>F</kbd></td><td>Toggle full-screen</td></tr><tr><td><kbd>M</kbd></td><td>Mute/unmute</td></tr><tr><td><kbd>Home</kbd></td><td>Go to the beginning of the media</td></tr><tr><td><kbd>End</kbd></td><td>Go to the end of the media</td></tr><tr><td><kbd>Up</kbd></td><td>Increase volume by 5%</td></tr><tr><td><kbd>Down</kbd></td><td>Decrease volume by 5%</td></tr><tr><td><kbd>Alt+F1</kbd> (customizable)</td><td>Show this list of keyboard shortcuts on screen.</td></tr></tbody></table></figure>",
+ "_help_KG48zgNY31NW": "<p>Since v0.105.0, office documents stored in Trilium display an inline preview of their content, without the need to download them or open them in an external application.</p><h2>Supported formats</h2><ul><li>Microsoft Office formats: Word (<code>.docx</code>), Excel (<code>.xlsx</code>) and PowerPoint (<code>.pptx</code>).</li><li>The OpenDocument alternatives to the previous formats (Text, Spreadsheet, Presentation), created by editors such as LibreOffice and OpenOffice.</li><li><a href=\"https://en.wikipedia.org/wiki/Rich_Text_Format\">Rich Text Format (RTF)</a>.</li><li><a href=\"https://en.wikipedia.org/wiki/EPUB\">EPUB</a> e-books.</li></ul><aside class=\"admonition note\"><p>Older Microsoft Office formats (<code>.doc</code>, <code>.xls</code>, <code>.ppt</code>) are not supported.</p></aside><h2>How it works</h2><p>The document is converted to a simplified representation on the server and rendered as read-only content, similar to a&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;note.</p><p>The preview generally preserves:</p><ul><li>Headings, paragraphs and text alignment.</li><li>Text formatting: bold, italic, underline, strikethrough, subscript/superscript, text and highlight colors, fonts and font sizes.</li><li>Bulleted and numbered lists.</li><li>Tables, including merged cells and cell background colors.</li><li>Embedded images.</li><li>Links and footnotes.</li></ul><p>To keep links readable regardless of the theme, the default hyperlink color applied automatically by word processors is ignored; links that were deliberately given a custom color by the author keep it.</p><h2>Limitations</h2><ul><li>The preview is read-only. To edit the document, download it or open it in an external application; the content of the note is not affected by the preview. Alternatively copy and paste it into a text note.</li><li>The preview is a simplified rendering: complex layouts (columns, text boxes, headers and footers), charts and the precise styling of table borders are not reproduced.</li><li>Documents larger than 20 MB are not previewed, to keep the server responsive. The usual download and open actions remain available.</li><li>If the document cannot be converted, a notice is displayed instead and the file can still be downloaded or opened externally.</li></ul><h2>Relation with other features</h2><ul><li>The same preview is used when an office document is displayed in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_0ESUbbAxVnoK\">Note List</a>&nbsp;or embedded in a text note via&nbsp;<a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>, as well as for office documents stored as&nbsp;<a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>.</li><li>Independently of the preview, the text content of office documents is also extracted in the background so that it can be found with&nbsp;<a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>&nbsp;via&nbsp;<a class=\"reference-link\" href=\"#root/_help_TiQbQDgP8L5t\">Text Extraction (OCR)</a>.</li><li><code>.csv</code> and <code>.xlsx</code> files can be converted to&nbsp;<a class=\"reference-link\" href=\"#root/_help_GWHEkY4I4OE3\">Spreadsheets</a>&nbsp;via the <a href=\"#root/_help_mHbBMPDPkVV5\">import</a> function.</li></ul>",
+ "_help_GWHEkY4I4OE3": "<figure class=\"image\"><img style=\"aspect-ratio:1102/573;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Spreadsheets_image.png\" width=\"1102\" height=\"573\"></figure><aside class=\"admonition important\"><p>Spreadsheets are a new type of note introduced in v0.103.0 and are currently considered experimental/beta. As such, expect major changes to occur to this note type.</p></aside><p>Spreadsheets provide a familiar experience to Microsoft Excel or LibreOffice Calc, with support for formulas, data validation and text formatting.</p><h2>Spreadsheets vs. collections</h2><p>There is a slight overlap between spreadsheets and the&nbsp;<a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a>&nbsp;collection. In general the table collection is useful to track meta-information about notes (for example a collection of people and their birthdays), whereas spreadsheets are quite useful for calculations since they support formulas.</p><p>Spreadsheets also benefit from a wider range of features such as data validation, formatting and can work on a relatively large dataset.</p><h2>Data intercompatibility (import/export)</h2><p>Starting with v0.104.0, Trilium provides a level of data intercompatibility between the internal format (Univer) and the following formats:</p><ul><li>Microsoft Excel (.xlsx)<ul><li>Preserves basic formatting (fonts, sizes, borders, backgrounds).</li><li>Formulas are preserved, but note that not all Excel functions are supported and vice-versa with Univer.</li><li>Images (cell-bound or floating), without preserving rotation.</li><li>Supports multi-sheets natively.</li></ul></li><li>Comma-Separated Values (.csv)<ul><li>Since it's a text-based format, any formatting is lost.</li><li>Formulas are evaluated and turned into their final value instead.</li><li>Multi-sheets spreadsheets are exported as a single ZIP containing a CSV file per sheet.</li></ul></li></ul><p>Both <a href=\"#root/_help_mHbBMPDPkVV5\">import and export</a> are supported, as follows:</p><ul><li>To import a file, simply drag it into the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;and it will be converted into a spreadsheet note.<ul><li>To avoid this behavior (e.g. to import a .xlsx file as an actual&nbsp;<a class=\"reference-link\" href=\"#root/_help_W8vYD3Q1zjCR\">File</a>), uncheck the corresponding option in the <a href=\"#root/_help_mHbBMPDPkVV5\">Import dialog</a>.</li><li>Multiple files can be imported at the same time, including a mixture of .csv and .xlsx files. Folder structure can be preserved by using a .zip file.</li></ul></li><li>Unlike importing, exporting is on a per-note basis:<ul><li>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>, choose the <em>Export to Excel</em> or <em>Export to CSV</em> options.</li><li>If exported as a single file via&nbsp;<a class=\"reference-link\" href=\"#root/_help_mHbBMPDPkVV5\">Import &amp; Export</a>, the resulting file will be a custom <code>.triliumsheet</code> file that preserves the spreadsheet as-is.<ul><li>The export is intentionally a different process than the normal&nbsp;<a class=\"reference-link\" href=\"#root/_help_mHbBMPDPkVV5\">Import &amp; Export</a>&nbsp;functionality because it does conversion to multiple formats with varying degrees of compatibility.</li></ul></li></ul></li></ul><p>Cells pasted from Excel or another application keep their formatting except for the font, so they use the spreadsheet's font like the rest of the cells.</p><aside class=\"admonition important\"><p>Import &amp; export for both .xlsx and .csv files are supported on a best-effort basis. It does not support advanced features (data validation, scripting, etc.). If you notice a particular issue, it can be <a href=\"#root/_help_wy8So3yZZlH9\">reported</a>, however all bug reports must contain a sample file in order to be taken into consideration.</p></aside><h2>Supported features</h2><p>The spreadsheet has support for the following features:</p><ul><li>Since v0.104.0, images that can be either inside a cell or floating above.<ul><li>The images are saved as&nbsp;<a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>&nbsp;for performance reasons.</li><li>The image upload respects the same compression settings as text&nbsp;<a class=\"reference-link\" href=\"#root/_help_mT0HEkOsz6i1\">Images</a>.</li></ul></li><li>Filtering</li><li>Sorting</li><li>Data validation</li><li>Conditional formatting</li><li>Notes / annotations</li><li>Find / replace</li></ul><p>We might consider adding <a href=\"https://docs.univer.ai/guides/sheets/features/filter\">other features</a> from Univer at some point. If there is a particular feature that can be added easily, it can be discussed over <a href=\"#root/_help_wy8So3yZZlH9\">GitHub Issues</a>.</p><h3>Share functionality</h3><p>Spreadsheets can be <a href=\"#root/_help_R9pX4DGra2Vt\">shared</a>, case in which a best-effort HTML rendering of the spreadsheet is done:</p><ul><li>Preserves basic formatting.</li><li>Cells with formulas display the precalculated value instead of the formula.</li></ul><p>Since v0.104.0:</p><ul><li>Numbers and dates are properly formatted.</li><li>Images are shown inside a cell or floating above, including rotation.</li></ul><p>For more advanced use cases, this will most likely not work as intended. Feel free to <a href=\"#root/_help_wy8So3yZZlH9\">report issues</a>, but keep in mind that we might not be able to have a complete feature parity with all the features of Univer.</p><h2>Features not supported yet</h2><h3>Regarding Pro features</h3><p>Univer spreadsheets also feature a <a href=\"https://univer.ai/pro\">Pro plan</a> which adds quite a lot of functionality such as charts, printing, pivot tables, export, etc.</p><p>As the Pro plan needs a license, Trilium does not support any of the premium features. Theoretically, pro features can be used in trial mode with some limitations, we might explore this direction at some point.</p><h3>Planned features</h3><p>There are a few features that are already planned but are not supported yet:</p><ul><li>Trilium-specific formulas (e.g. to obtain the title of a note).</li><li>User-defined formulas</li><li>Cross-workbook calculation</li></ul><p>If you would like us to work on these features, consider <a href=\"https://triliumnotes.org/en/support-us\">supporting us</a>.</p><h3>Mobile support</h3><p>Versions prior to v0.104.0 have no dedicated mobile support, which means that the interaction is difficult without a mouse and keyboard. Starting with v0.104.0 we integrate Univer's mobile plugin, which introduces feature such as drag to pan which makes the interface more usable on mobile.</p>",
+ "_help_6RM1Q7ppFVoj": "<p>Trilium has always supported Markdown through its <a href=\"#root/_help_Oau6X9rCuegd\">import feature</a>, however the file was either transformed to a&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;note (converted to Trilium's internal HTML format) or saved as a&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;note with only syntax highlight.</p><p>This note type is a split view, meaning that both the source code and a preview of the document are displayed side-by-side. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_SL5f1Auq7sVN\">Note types with split view</a>&nbsp;for more information.</p><h2>Rationale</h2><p>The goal of this note type is to fill a gap: rendering Markdown but not altering its structure or its whitespace which would inevitably change otherwise through import/export.</p><p>Even if Markdown is now specially treated by having a preview mechanism, Trilium remains at its core a WYSWYG editor so Markdown will not replace text notes.</p><aside class=\"admonition note\"><p>Feature requests regarding the Markdown implementation will be considered, but if they are outside the realm of Trilium, they will not be implemented. One of the core aspects of the Markdown integration is that it reuses components that are already available through other features of the application.</p></aside><h2>Features</h2><h3>Source view pane</h3><ul><li>Syntax highlighting for the Markdown syntax.</li><li>Nested syntax highlighting for code inside code blocks.</li><li>When editing larger documents, the preview scrolls along with the source editor.</li></ul><h3>Preview pane</h3><p>The following features are supported by Trilium's Markdown format and will show up in the preview pane:</p><ul><li><p>All standard and GitHub-flavored syntax (basic formatting, tables, blockquotes).</p></li><li><p>Basic HTML is also supported (e.g. collapsible blocks using <code>&lt;details&gt;</code> and <code>&lt;summary&gt;</code>).</p></li><li><p>Code blocks with syntax highlight.</p><ul><li>The language must be specified for syntax highlight to be applied (e.g. <code>```js</code>).</li><li>Code blocks will respect the text wrapping from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;section in&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>.</li></ul></li><li><p><a class=\"reference-link\" href=\"#root/_help_NwBbFdNZ9h7O\">Block quotes &amp; admonitions</a></p></li><li><p><a class=\"reference-link\" href=\"#root/_help_YfYAtQBcfo5V\">Math Equations</a>&nbsp;(both inline and block)</p></li><li><p><a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a>&nbsp;using <code>```mermaid</code></p></li><li><p><a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>&nbsp;(no built-in Markdown syntax, but HTML syntax works just fine):</p><pre><code class=\"language-text-html\">&lt;figure class=\"include-note\" data-note-id=\"vJDjQm0VK8Na\" data-box-size=\"expandable\"&gt;\n &lt;figcaption&gt;An optional caption, with &lt;strong&gt;HTML&lt;/strong&gt; formatting&lt;/figcaption&gt;\n&lt;/figure&gt;</code></pre><ul><li>The caption is optional. Markdown is not processed inside the HTML block, so format the caption with HTML tags.</li><li>Includes written as <code>&lt;section class=\"include-note\"&gt;</code>, the syntax of earlier versions, still work.</li><li>These can also be quickly created via the <code>/include</code> command or via a dedicated keyboard shortcut (not assigned by default).</li></ul></li><li><p><a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>&nbsp;via its HTML syntax, or through a <em>Wikilinks</em>-like format (only&nbsp;<a class=\"reference-link\" href=\"#root/_help_m1lbrzyKDaRB\">Note ID</a>):</p><pre><code class=\"language-text-x-trilium-auto\">[[Hg8TS5ZOxti6]]</code></pre></li><li><p>To-do lists with extended task states:</p><figure class=\"table\"><table class=\"ck-table-resized\" style=\"border-style:none;\"><colgroup><col style=\"width:80.6%;\"><col style=\"width:19.4%;\"></colgroup><tbody><tr><td><pre><code class=\"language-text-x-markdown\">- [ ] None\n- [/] Doing\n- [X] Done\n- [?] Maybe\n- [-] Cancelled</code></pre></td><td><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:218/221;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Markdown_image.png\" width=\"218\" height=\"221\"></figure></td></tr></tbody></table></figure><p>Task states are customizable: you can reorder them, create new ones with different colors and symbols, or delete the ones you don't need. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_i16PM6A7GXdU\">Customizing to-do task states</a>&nbsp;for more details.</p><p>Note that to-do items with task states other than \"None\" and \"Done\" are Trilium-specific and may not work well with other Markdown software.</p></li><li><p><a class=\"reference-link\" href=\"#root/_help_AgjCISero73a\">Footnotes</a>&nbsp;are also supported via the corresponding Markdown syntax:</p><pre><code class=\"language-text-x-trilium-auto\">This is [^1], while this is [^2].\n\n[^1]: the first footnote\n[^2]: the second footnote</code></pre><ul><li>These can also be quickly created using the <code>/footnote</code> command.</li></ul></li><li><p>Page breaks for&nbsp;<a class=\"reference-link\" href=\"#root/_help_NRnIZmSMc5sj\">Printing &amp; Exporting as PDF</a>:</p><pre><code class=\"language-text-x-trilium-auto\">&lt;div class=\"page-break\"&gt;&lt;/div&gt;</code></pre></li><li><p>Highlights (background color) are supported both via the <code>==</code> Markdown syntax, as well as the canonical HTML representation in Trilium:</p><pre><code class=\"language-text-x-trilium-auto\">==highlighted==\n&lt;span style=\"background-color:#e5e64d;--tn-background:#e5e64d;\"&gt;Highlighted&lt;/span&gt;</code></pre></li></ul><h3>Links</h3><p>Multiple types of links are supported:</p><ul><li><p>Web URLs can be written with the standard Markdown syntax:</p><pre><code class=\"language-text-x-trilium-auto\">[Wikipedia](https://www.wikipedia.org)</code></pre></li><li><p><a href=\"#root/_help_hrZ1D00cLbal\">Reference link</a> to other notes with dynamic title, either by manually entering the note ID or via the <em>Add link</em> dialog:</p><pre><code class=\"language-text-x-trilium-auto\">[[B9oMG6rFvvfq]]</code></pre></li><li><p><a href=\"#root/_help_hrZ1D00cLbal\">Reference link</a> to other notes with a custom text:</p><pre><code class=\"language-text-x-trilium-auto\">[This is a link](#root/LhtnZxtVsUMp)</code></pre></li></ul><p>To create a link, either:</p><ul><li>Type it manually using the syntax described above.</li><li>Use the <em>Add link</em> dialog by pressing <kbd>Ctrl</kbd>+<kbd>L</kbd> or typing the <code>/link</code> command.</li></ul><p><a class=\"reference-link\" href=\"#root/_help_UmgZAfcltxkS\">Link Previews</a>&nbsp;are also rendered, but there is no mechanism to insert them automatically as of now, they have to be copied from a&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;note instead.</p><h3>Keyboard shortcuts</h3><p>The Markdown notes share some of the keyboard shortcuts from&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes:</p><ul><li><em>Cut to note</em> (<kbd>Ctrl</kbd>+<kbd>X</kbd>) which cuts the selection into a new child note.</li><li><em>Add link</em> (<kbd>Ctrl</kbd>+<kbd>L</kbd>) which shows the dialog to create external or reference links.</li><li><em>Date/time</em> (<kbd>Alt</kbd>+<kbd>T</kbd>) which respects the same formatting as text notes.</li><li><em>Include note</em> (not assigned by default), which triggers the same dialog to insert notes as the one for text notes.</li></ul><p>In addition, the following formatting keyboard shortcuts are available:</p><ul><li><kbd>Ctrl</kbd>+<kbd>B</kbd> to toggle <strong>bold</strong>.</li><li><kbd>Ctrl</kbd>+<kbd>I</kbd> to toggle <em>italic</em>.</li><li><kbd>Ctrl</kbd>+<kbd>M</kbd> to wrap the current selection in an inline math (<code>$</code>).</li><li><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>X</kbd> to toggle <del>strikethrough</del>.</li></ul><h3>Images &amp; attachments</h3><p>Images can be inserted into the document in four different methods:</p><ul><li>Drag &amp; drop directly into the editor area.</li><li>Pasting an image from clipboard.</li><li>Pasting a reference to another <a href=\"#root/_help_0vhv7lsOLy82\">attachment</a> (e.g. <em>Copy reference to clipboard</em> button).</li><li>Use the <code>/image</code> slash command.</li></ul><p>An image reference to an attachment looks like this:</p><pre><code class=\"language-text-x-trilium-auto\">![Name.jpeg](api/attachments/z50RceuHXe9J/image/image)</code></pre><h3>Auto-completion</h3><h4>Slash commands</h4><p>Just like&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes, Markdown notes support a selection of slash commands:</p><ul><li>Inserting the current date &amp; time (<code>/date</code>).</li><li><a href=\"#root/_help_nBAXQFj20hS1\">Including</a> another note (<code>/include</code>).</li><li>Uploading and inserting an image (<code>/image</code>).</li><li>Inserting a note link (<code>/link</code>).</li><li>Inserting a math equation block (<code>/math</code>).</li><li>Inserting a <a href=\"#root/_help_AgjCISero73a\">footnote</a> (<code>/footnote</code>).</li><li>Inserting a <a href=\"#root/_help_s1aBHPd79XYj\">Mermaid</a> diagram (<code>/mermaid</code>), with one variant per sample template (e.g. <code>/mermaid:flowchart</code>).</li><li>Inserting a collapsible block (<code>/collapsible</code>).</li><li>Inserting <a href=\"#root/_help_rJ9grSgoExl9\">tabs</a> (<code>/tabs</code>).</li><li>Inserting a page break for printing (<code>/page-break</code>).</li><li>Inserting a table (<code>/table</code>).</li><li>Creating admonitions (e.g. <code>/tip</code>, <code>/note</code>, <code>/important</code>, <code>/caution</code>, <code>/warning</code>).</li><li>Inserting task items (<code>/todo:&lt;state&gt;</code>, e.g. <code>/todo:done</code>), one per configured task state.</li><li>Inserting code snippets (<code>/snippet:&lt;name&gt;</code>) from your Markdown/plain-text snippet notes.</li></ul><p>The list shows each command by its title, as in Text notes. Typing a command's title, its keyword (as listed above) or a related word such as <code>latex</code> or <code>grid</code> finds it.</p><p>Note that slash commands only work outside of code blocks and inline code.</p><h4>Linking notes with <code>@</code> or <code>[[</code></h4><p>As in&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes, typing <code>@</code> at the start of a line or after a space opens the note search. Picking a note replaces what was typed with a link to it in the Wikilinks-like format (<code>[[noteId]]</code>), which the preview shows as an&nbsp;<a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>&nbsp;with the note's title.</p><p>The search runs on everything typed after the <code>@</code>, spaces included, so a title such as <code>@My meeting notes</code> can be typed out; press <kbd>Esc</kbd> to close the list and go on writing. If no note fits, the list offers to create one, as a child of the Markdown note or in the inbox; the link is inserted once the note is created.</p><p>You can also start typing the link directly: <code>[[</code> opens the same list, and closing the brackets yourself dismisses it. To change where an existing link points, place the cursor inside it and pick another note.</p><p>Like slash commands, <code>@</code> and <code>[[</code> do nothing inside code blocks and inline code.</p><p>In the editor, a <code>[[noteId]]</code> link shows as the note's icon and title, so you can tell which note it points to without looking up its ID. Clicking it, or moving the cursor next to it, shows the link as written so it can be edited. Links inside code blocks and inline code are left as they are.</p><h4>Code block language auto-completion</h4><p>Starting with v0.104.0, typing ``` to insert a code block will automatically open a list of suggested language types which have syntax highlighting.</p><p>The list of languages matches the one for&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;notes set in&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>, it's not the full list of languages supported by Trilium.</p><h3>Other features</h3><ul><li>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_BFvAtE74rbP6\">Table of contents</a>&nbsp;will be displayed in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>&nbsp;based on the Markdown-level headings.</li></ul><h3>Shared notes</h3><p>When a Markdown note is <a href=\"#root/_help_R9pX4DGra2Vt\">shared publicly</a>, it will be rendered with extended formatting just like&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes.</p><p>Most of the features described previously should be supported. If you face any issues, feel free to <a href=\"#root/_help_wy8So3yZZlH9\">report it</a> alongside a sample Markdown file.</p><h2>Creating Markdown notes</h2><p>There are two ways to create a Markdown note:</p><ol><li>Create a new note (e.g. in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>) and select the type <em>Markdown</em>, just like all the other note types.</li><li>Create a note of type&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;and select as the language either <em>Markdown</em> or <em>GitHub-Flavored Markdown</em>. This maintains compatibility with your existing notes prior to the introduction of this feature.</li></ol><aside class=\"admonition note\"><p>There is no distinction between the new Markdown note type and code notes of type Markdown; internally both are represented as&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;notes with one of the following MIME types:</p><ul><li><code>text/markdown</code></li><li><code>text/x-markdown</code></li><li><code>text/x-gfm</code> (GitHub Flavored Markdown)</li></ul></aside><h2>Import/export</h2><h3>Import</h3><p>By default, when importing a single Markdown file it automatically gets converted to a&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;note. To avoid that and have it imported as a Markdown note instead:</p><ul><li>Right click the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;and select <em>Import into note</em>.</li><li>Select the file normally.</li><li>Uncheck <em>Import HTML, Markdown and TXT as text notes if it's unclear from the metadata</em>.</li></ul><p>When importing a Trilium ZIP, it will preserve the Markdown type without converting to text notes thanks to the meta-information in it.</p><h3>Exporting</h3><p>When exporting Markdown files, the extension is preserved and the content remains the same as in the source view (with some small exceptions such as handling of attachments).</p><p>When exporting Markdown files as ZIP, choosing HTML or Markdown as the export format makes no difference as that only affects&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes.</p><p>If the Markdown note contains attachments, a ZIP export will rewrite the links to attachments so that they are replaced with a relative path to the attachment. On import, the links are re-written back.</p><h2>Conversion between text notes and Markdown notes</h2><p><a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes can be converted into Markdown notes and vice versa. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_jludwdW7N4hg\">Converting between note types</a>.</p><h2>Sync-scrolling &amp; block highlight</h2><p>When scrolling through the editing pane, the preview pane will attempt to synchronize its position to make it easier to see the preview.</p><p>In addition, the block in the preview matching the position of the cursor in the source view will appear slightly highlighted.</p><p>The sync is currently one-way only, scrolling the preview will not synchronize the position of the editor.</p><p>This feature cannot be disabled as of now; if the scrolling feels distracting, consider temporarily switching to the editor mode and then switching to preview mode when ready.</p><aside class=\"admonition note\"><p>This feature of synchronizing the scroll is based on blocks but it's provided on a best-effort basis since our underlying Markdown library doesn't support this feature natively, so we had to implement our own algorithm. Feel free to <a href=\"#root/_help_wy8So3yZZlH9\">report issues</a>, but always provide a sample Markdown file to be able to reproduce it.</p></aside>",
+ "_help_jludwdW7N4hg": "<p>A note's type may be converted to another:</p><ul><li><a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes to&nbsp;<a class=\"reference-link\" href=\"#root/_help_6RM1Q7ppFVoj\">Markdown</a>&nbsp;notes</li><li>Markdown notes to Text notes</li></ul><p>Before conversion, a revision is saved automatically, so you can restore the original or recover any missing elements from it if the conversion produces undesired results. Read more about&nbsp;<a class=\"reference-link\" href=\"#root/_help_vZWERwf8U3nx\">Note Revisions</a>.</p><h2>Converting individual notes</h2><h3>Markdown to Text Note</h3><p>Markdown notes can be converted to Text Notes with negligible loss of formatting fidelity.</p><p>To do so, go to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Advanced</em> and select <em>Convert to Text Note</em>.</p><h3>Text Note to Markdown</h3><aside class=\"admonition warning\"><p>Since Markdown does not support all the capabilities of Text notes, this conversion is lossy in terms of formatting: some formatting may be lost, and some unsupported elements may even be dropped. It's strongly recommended that you inspect the content for any information that might have gone missing after the conversion.</p></aside><p>To convert a text note to Markdown, go to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Advanced</em> and select <em>Convert to Markdown Note</em>.</p><h2>Converting multiple notes</h2><p>A note type conversion can also be performed on an entire subtree or a set of multiple notes using&nbsp;<a class=\"reference-link\" href=\"#root/_help_ivYnonVFBxbQ\">Bulk Actions</a>.</p>",
+ "_help_GTwFsgaA0lCt": "<p>Collections are a unique type of note that don't have content, but instead display their child notes in various presentation methods.</p><h2>Main collections</h2><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bx-calendar\"></span>&nbsp;Calendar</p><div class=\"trilium-tab-panel\"><p><a class=\"reference-link\" href=\"#root/_help_xWbu3jpNWapp\">Calendar</a>&nbsp;displays a week, month or year calendar with the notes being shown as events. New events can be added easily by dragging across the calendar.</p><figure class=\"image\"><img style=\"aspect-ratio:1651/810;\" src=\"{{helpAssets}}/User%20Guide/Collections_collection_calendar.webp\" width=\"1651\" height=\"810\"></figure></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bx-table\"></span>&nbsp;Table</p><div class=\"trilium-tab-panel\"><p><a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a>&nbsp;displays each note as a row in a table, with&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>&nbsp;being shown as well. This makes it easy to visualize attributes of notes, as well as making them easily editable.</p><figure class=\"image\"><img style=\"aspect-ratio:1643/647;\" src=\"{{helpAssets}}/User%20Guide/Collections_collection_table.webp\" width=\"1643\" height=\"647\"></figure></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bx-columns\"></span>&nbsp;Kanban Board</p><div class=\"trilium-tab-panel\"><p><a class=\"reference-link\" href=\"#root/_help_CtBQqbwXDx1w\">Kanban Board</a>&nbsp;displays notes in columns, grouped by the value of a label. Items and columns can easily be created or dragged around to change their status.</p><figure class=\"image\"><img style=\"aspect-ratio:1174/850;\" src=\"{{helpAssets}}/User%20Guide/Collections_collection_board.webp\" width=\"1174\" height=\"850\"></figure></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bx-map-alt\"></span>&nbsp;Geo Map</p><div class=\"trilium-tab-panel\"><p><a class=\"reference-link\" href=\"#root/_help_81SGnPGMk7Xc\">Geo Map</a>&nbsp;which displays a geographical map in which the notes are represented as pins on the map. New markers can be easily added by pointing on the map. In addition <a href=\"#root/_help_C2H9HK4BzwG7\">shapes</a> such as paths, rectangles and circles can be added, as well as GPX tracks.</p><figure class=\"image\"><img style=\"aspect-ratio:844/639;\" src=\"{{helpAssets}}/User%20Guide/Collections_collection_geomap.webp\" width=\"844\" height=\"639\"></figure></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bx-slideshow\"></span>&nbsp;Presentation</p><div class=\"trilium-tab-panel\"><p><a class=\"reference-link\" href=\"#root/_help_zP3PMqaG71Ct\">Presentation</a>&nbsp;which shows each note as a slide and can be presented full-screen with smooth transitions or exported to PDF for sharing.</p><figure class=\"image\"><img style=\"aspect-ratio:1120/763;\" src=\"{{helpAssets}}/User%20Guide/Collections_collection_presentation.webp\" width=\"1120\" height=\"763\"></figure></div></section></div><h2>Classic collections</h2><p>Classic collections are read-only mode and compiles the contents of all child notes into one continuous view. This makes it ideal for reading extensive information broken into smaller, manageable segments.</p><ul><li><a class=\"reference-link\" href=\"#root/_help_8QqnMzx393bx\">Grid View</a>&nbsp;which is the default presentation method for child notes (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_0ESUbbAxVnoK\">Note List</a>), where the notes are displayed as tiles with their title and content being visible.</li><li><a class=\"reference-link\" href=\"#root/_help_mULW0Q3VojwY\">List View</a>&nbsp;is similar to&nbsp;<a class=\"reference-link\" href=\"#root/_help_8QqnMzx393bx\">Grid View</a>, but it displays the notes one under the other with the content being expandable/collapsible, but also works recursively.</li></ul><p>Classic collections make use of pagination to support a large number of notes. The size of a page can be customized via <code>pageSize</code>.</p><h2>Creating a new collection</h2><p>To create a new collection, right-click a note in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;and select <em>Insert child note</em> → <em>Collection</em> → the desired type.</p><p>By default, collections come with a default configuration and sometimes even sample notes. To create a collection completely from scratch:</p><ol><li>Create a new note of type <em>Text</em> (or any type).</li><li>Change the <a href=\"#root/_help_KSZ04uQ2D1St\">note type</a> to <em>Collection</em>.</li><li>In&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>, select the desired view type.</li><li>Consult the help page of the corresponding view type in order to understand how to configure them.</li></ol><h2>Configuration</h2><p>To change the configuration of a collection or even switch to a different collection (e.g. from Kanban Board to a Calendar), see the&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>&nbsp;bar at the top of the note.</p><h2>Archived notes</h2><p>By default, <a href=\"#root/_help_MKmLg5x6xkor\">archived notes</a> will not be shown in collections. This behavior can be changed by going to&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>&nbsp;and checking <em>Show archived notes</em>.</p><p>Archived notes will be generally indicated by being greyed out as opposed to the normal ones.</p><h2>Hiding the child notes from the note tree</h2><p>For collections with a large number of items, it can be helpful to hide the items from the note tree for performance reasons and to reduce clutter. This is especially useful for standalone collections, such as a geomap or a task board.</p><p>To do so, go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>&nbsp;and select <em>Hide child notes in tree</em>.</p><h2>Advanced use cases</h2><h3>Adding a description to a collection</h3><p>To add a text before the collection, for example to describe it:</p><ol><li>Create a new collection.</li><li>Change the <a href=\"#root/_help_KSZ04uQ2D1St\">note type</a> from <em>Collection</em> to <em>Text</em>.</li></ol><p>Now the text will be displayed above while still maintaining the collection view.</p><p>The only downside to this method is that&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>&nbsp;will not be shown anymore. In this case, modify the attributes manually or switch back temporarily to the <em>Collection</em> type for configuration purposes.</p><h3>Using saved search</h3><p>Collections, by default, only display the child notes. However, it is possible to use the&nbsp;<a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>&nbsp;functionality to display notes all across the tree, with advanced querying functionality.</p><p>To do so, simply start a&nbsp;<a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>&nbsp;and go to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>&nbsp;and select a desired type of collection. To keep the search-based collection, use a&nbsp;<a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a>.</p><aside class=\"admonition important\"><p>While in search, none of the collections will not display the child notes of the search results. The reason is that the search might hit a note multiple times, causing an exponential rise in the number of results.</p></aside><h2>Under the hood</h2><p>Collections by themselves are simply notes with no content that rely on the&nbsp;<a class=\"reference-link\" href=\"#root/_help_0ESUbbAxVnoK\">Note List</a>&nbsp;mechanism (the one that lists the children notes at the bottom of a note) to display information.</p><p>By default, new collections use predefined&nbsp;<a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>&nbsp;that are stored safely in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_2mUhVmZK8RF3\">Hidden Notes</a>&nbsp;to define some basic configuration such as the type of view, but also some&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>&nbsp;to make editing easier.</p><p>Collections don't store their configuration (e.g. the position on the map, the hidden columns in a table) in the content of the note itself, but as attachments.</p>",
+ "_help_xWbu3jpNWapp": "<figure class=\"image\"><img style=\"aspect-ratio:2016/1413;\" src=\"{{helpAssets}}/User%20Guide/Collections/1_Calendar_image.png\" width=\"2016\" height=\"1413\"></figure><p>The Calendar view will display each child note in a calendar that has a start date and optionally an end date, as an event.</p><p>The Calendar view has multiple display modes:</p><ul><li>Month view, where the entire month is displayed and all-day events can be inserted. Both time-specific events and all-day events are listed.</li><li>Week view, where all the 7 days of the week (or 5 if the weekends are hidden) are displayed in columns. This mode allows entering and displaying time-specific events, not just all-day events.</li><li>Day view, which views only a single day. Especially useful for heavy agendas or mobile views.</li><li>List view, which displays all the events of a given month in sequence.</li><li>Year view, which displays the entire year for quick reference.</li></ul><p>Unlike other Collection view types, the Calendar view also allows some kind of interaction, such as moving events around as well as creating new ones.</p><h2>Creating a calendar</h2><p>Right click on an existing note in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;and select <em>Insert child note</em> → <em>Collection</em> → <em>Calendar</em>.</p><h2>Creating a new event/note</h2><p>To create a new event:</p><ul><li>First, click the desired day (month &amp; year views) or the desired timeslot (day view).</li><li>Alternatively, drag across multiple days (or time slots) to set both the start and end date.</li></ul><p>In either cases, a small popup will show with a prompt for a title and the date &amp; time of the event that will be created. The date and time can be changed there the same way as in the popup view of an existing event (see below).</p><p>At this point, the event hasn't been created yet to protect against accidental clicks. Add a title optionally and press the <em>Create</em> button. If no title is provided, the event will follow the&nbsp;<a class=\"reference-link\" href=\"#root/_help_47ZrP6FNuoG8\">Default Note Title</a>&nbsp;rules.</p><p>The <span class=\"tn-icon bx bx-detail\"></span> template field below the date and time shows the note type or template the event's note is made from. To make the event from another one, press the field and select it from the list; the calendar remembers the choice for the next event. Select <em>More templates…</em> to change which templates are listed (see <a href=\"#event-templates\">Event templates</a>). The date and time entered for the event replace any dates and times the template carries.</p><p>To give the event a time before creating it (for example, after clicking a day in the month view), press <em>Add time</em> and set the start and end time; the duration is shown to the right of them. To make the event all-day again, press the <span class=\"tn-icon bx bx-x\"></span> button at the end of the row. Adding or removing a time keeps the dates, so an event can start at a time on one day and end at a time on another (for example, a night shift). Changing the start date or time moves the end by the same amount, keeping the duration. An empty end date means the event ends on the day it starts; setting the end time before the start time moves the end date to the next day.</p><p>After creating the event, it will show up on the calendar. To edit the content of the event (including recurrence), click on it to bring it into the popup view.</p><aside class=\"admonition note\"><p>Creating new notes from the calendar will respect the <code>~child:template</code> relation if set on the Collection note.</p></aside><h2>Interacting with events</h2><ul><li>Hovering the mouse over an event will display information about the note.<br><img src=\"{{helpAssets}}/User%20Guide/Collections/4_Calendar_image.png\"></li><li>Left clicking the event will open a&nbsp;dedicated popup to quickly configure the event or edit its note content.</li><li>Right click will offer more options including opening the note in a new split or window.</li><li>Drag and drop an event on the calendar to move it to another day.</li><li>The length of an event can be changed by placing the mouse to the right edge of the event and dragging the mouse around.</li></ul><p>On a <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a> calendar, events can't be dragged, resized or created, their context menu only offers the places to open them in, and the button to pin the current date is hidden. Switching between the month, week and day views still works, but the choice isn't saved.</p><h3>Popup view</h3><p>When an event is clicked, a popup will show near the event which contains the following inforamtion:</p><ul><li>The title and icon of the event, both editable.</li><li>Buttons to interact with the event:<ul><li>Open the event in the same pane, new tab, etc.</li><li>Color picker to change the color of the event.</li><li>Button to remove the event from the calendar, which can optionally delete its corresponding note.</li></ul></li><li>Calendar-specific features:<ul><li>The start date and, for an event spanning several days, the end date.</li><li>The start and end time with the duration to the right of them, and a <span class=\"tn-icon bx bx-x\"></span> button that removes the time, making the event all-day. An all-day event shows an <em>Add time</em> button instead.</li><li>A full recurrence editor, opened from the dropdown below the time, to have the same event show up weekly, monthly, etc.</li></ul></li><li>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>&nbsp;of the marker, if any.</li><li>The note's content which can be edited directly from the panel.</li></ul><p>To dismiss the popup:</p><ul><li>Press the X button at the top-right of the popup.</li><li>In the calendar, press anywhere outside the popup.</li><li>Or simply press the <kbd>Escape</kbd> key.</li></ul><p>It is possible to switch between events by clicking on them even when the popup view is already open.</p><p>Events can have&nbsp;<a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>&nbsp;between them and clicking on such a link will automatically navigate the calendar to the right date and the popup view to the new note.</p><h2>Interaction on mobile</h2><p>When Trilium is on mobile, the interaction with the calendar is slightly different:</p><ul><li>Clicking on an event displays the popup view, which allows editing the event.</li><li>Long-presing an event triggers the contextual menu, including the option to open in&nbsp;<a class=\"reference-link\" href=\"#root/_help_ZjLYv08Rp3qC\">Quick edit</a>.</li><li>To insert a new event, touch and hold the empty space. When successful, the empty space will become colored to indicate the selection.<ul><li>Before releasing, drag across multiple spaces to create multi-day events.</li><li>When released, a prompt will appear to enter the note title.</li></ul></li><li>To move an existing event, touch and hold the event until the empty space near it will become colored.<ul><li>At this point the event can be dragged across other days on the calendar.</li><li>Or the event can be resized by tapping on the small circle to the right end of the event.</li><li>To exit out of editing mode, simply tap the empty space anywhere on the calendar.</li></ul></li></ul><h2>Configuring the calendar view</h2><p>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>, it's possible to:</p><ul><li>Hide weekends from the week view.</li><li>Display week numbers on the calendar.</li><li>Set the slot duration (the length of each time row in day/week view).</li><li>Set the slot label interval (how often time labels appear on the axis in day/week view).</li></ul><p>The same settings are also listed under <em>General</em> in the <span class=\"tn-icon bx bx-cog\"></span> <em>Calendar properties</em> dialog (see <a href=\"#event-templates\">Event templates</a> for how to open it). The time slots are listed there whichever view the calendar is in. Its <em>Included notes</em> section sets whether archived notes are shown and how deep the calendar looks for events (see <a href=\"#limiting-the-depth\">Limiting the depth</a>).</p><h3>Event templates</h3><p>By default, a new event is a&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> note. To make events from other note types, or from&nbsp;<a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a> with predefined content and attributes (such as a color), open the <span class=\"tn-icon bx bx-cog\"></span> <em>Calendar properties</em> dialog from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> or from the settings menu of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>, and find <em>Event templates</em>. Here you can:</p><ul><li>Include a note type or note template already created in your knowledge base by pressing the <span class=\"tn-icon bx bx-list-plus\"></span> <em>Add existing template</em> button and then selecting the desired note type or template.</li><li>Create a new template by pressing the <span class=\"tn-icon bx bx-plus\"></span> <em>Create a new template</em> button. The template is created as a child of the calendar, and is not shown as an event.</li><li>Press the <span class=\"tn-icon bx bx-x\"></span> button to remove a template from the list. The template is removed only from the list, not deleted.</li><li>Press the <span class=\"tn-icon bx bx-dots-vertical-rounded\"></span> button of a custom template to edit, open in a new window, duplicate, or delete it.</li><li>Drag a template by its handle to reorder the list shown when creating an event.</li></ul><p>The dialog is not available on a read-only calendar, or on a calendar marked with <code>#calendarRoot</code> or <code>#workspaceCalendarRoot</code> (see <a href=\"#using-with-the-journal--calendar\">Using with the Journal / calendar</a>).</p><h3>Event attributes</h3><p>Events can show the values of their attributes below their title, in the month view, and in the week and day views for all-day events and for timed ones tall enough to hold them. To choose which attributes are shown, open the <span class=\"tn-icon bx bx-cog\"></span> <em>Calendar properties</em> dialog (see <a href=\"#event-templates\">Event templates</a> for how to open it) and find <em>Event attributes</em>. It lists the <a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a> the calendar defines, and those its events define themselves. Here you can:</p><ul><li>Turn an attribute on to show it on the events. New attributes are hidden until you turn them on, which keeps the calendar from getting cluttered.</li><li>Drag an attribute by its handle to change the order in which the events show them.</li><li>Create a new attribute, which is shown on the events right away, or edit or delete one the calendar defines.</li></ul><p>The dates, times and recurrence of the events are not listed, as the calendar always shows them itself.</p><p>If an event has a <code>#calendar:displayedAttributes</code> label, including one inherited from the calendar, the attributes listed in that label are shown instead.</p><h2>Configuring the calendar using attributes</h2><p>The following attributes can be added to the Collection type:</p><figure class=\"table\"><table><thead><tr><th>Name</th><th>Description</th></tr></thead><tbody><tr><td><code>#calendar:hideWeekends</code></td><td>When present (regardless of value), it will hide Saturday and Sundays from the calendar.</td></tr><tr><td><code>#calendar:weekNumbers</code></td><td>When present (regardless of value), it will show the number of the week on the calendar.</td></tr><tr><td><code>#calendar:initialDate</code></td><td>Change the date the calendar opens on. When not present, the calendar opens on the current date.</td></tr><tr><td><code>#calendar:view</code></td><td><p>Which view to display in the calendar:</p><ul><li><code>timeGridDay</code> for the <em>day</em> view;</li><li><code>timeGridWeek</code> for the <em>week</em> view;</li><li><code>dayGridMonth</code> for the <em>month</em> view;</li><li><code>multiMonthYear</code> for the <em>year</em> view;</li><li><code>listMonth</code> for the <em>list</em> view.</li></ul><p>Any other value will be dismissed and the default view (month) will be used instead.</p><p>The value of this label is automatically updated when changing the view using the UI buttons.</p></td></tr><tr><td><code>#calendar:slotDuration</code></td><td>Sets how long each timeslot is on the calendar. Defaults to <code>00:15:00</code> (15 minutes). Must have the format \"HH:MM:SS\". For example, to create timeslots for every 10 minutes, you would set <code>#calendar:slotDuration=\"00:10:00\"</code>.</td></tr><tr><td><code>#calendar:slotLabelInterval</code></td><td>Sets how often the timeslots on the calendar should be labeled. Defaults to <code>01:00:00</code> (1 hour). Must have the format \"HH:MM:SS\". For example, to label timeslots every 30 minutes, you would set <code>#calendar:slotLabelInterval=\"00:30:00\"</code>.</td></tr><tr><td><code>~child:template</code></td><td>Defines the template for newly created notes in the calendar (via dragging or clicking).</td></tr></tbody></table></figure><p>In addition, the first day of the week can be either Sunday or Monday and can be adjusted from the application settings.</p><h2>Configuring the calendar events using attributes</h2><p>For each note of the calendar, the following attributes can be used:</p><figure class=\"table\"><table><thead><tr><th>Name</th><th>Description</th></tr></thead><tbody><tr><td><code>#startDate</code></td><td>The date the event starts, which will display it in the calendar. The format is <code>YYYY-MM-DD</code> (year, month and day separated by a minus sign).</td></tr><tr><td><code>#endDate</code></td><td>Similar to <code>startDate</code>, mentions the end date if the event spans across multiple days. The date is inclusive, so the end day is also considered. The attribute can be missing for single-day events.</td></tr><tr><td><code>#startTime</code></td><td>The time the event starts at. If this value is missing, then the event is considered a full-day event. The format is <code>HH:MM</code> (hours in 24-hour format and minutes).</td></tr><tr><td><code>#endTime</code></td><td>Similar to <code>startTime</code>, it mentions the time at which the event ends (in relation with <code>endDate</code> if present, or <code>startDate</code>).</td></tr><tr><td><code>#recurrence</code></td><td>This is an optional CalDAV <code>RRULE</code> string that if present, determines whether a task should repeat or not. Note that it does not include the <code>DTSTART</code> attribute, which is derived from the <code>#startDate</code> and <code>#startTime</code> directly. For examples of valid <code>RRULE</code> strings see <a href=\"https://icalendar.org/rrule-tool.html\">https://icalendar.org/rrule-tool.html</a></td></tr><tr><td><code>#color</code></td><td>Displays the event with a specified color (named such as <code>red</code>, <code>gray</code> or hex such as <code>#FF0000</code>). This will also change the color of the note in other places such as the note tree.</td></tr><tr><td><code>#calendar:color</code></td><td><strong>❌️ Removed since v0.100.0. Use</strong> <code>#color</code> <strong>instead.</strong>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <br> <br>Similar to <code>#color</code>, but applies the color only for the event in the calendar and not for other places such as the note tree.</td></tr><tr><td><code>#iconClass</code></td><td>If present, the icon of the note will be displayed to the left of the event title.</td></tr><tr><td><code>#calendar:title</code></td><td>Changes the title of an event to point to an attribute of the note other than the title, can either a label or a relation (without the <code>#</code> or <code>~</code> symbol). See <em>Use-cases</em> for more information.</td></tr><tr><td><code>#calendar:titleTemplate</code></td><td>Changes the title an event is displayed with on the calendar, filled in again for every occurrence of a repeating event. See <em>Use-cases</em> for displaying an age on a birthday.</td></tr><tr><td><code>#calendar:displayedAttributes</code></td><td>Takes precedence over the <a href=\"#event-attributes\">Event attributes</a> chosen in the calendar's properties. Allows displaying the value of one or more attributes in the calendar, in the order given, like this:&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <br> <br><img src=\"{{helpAssets}}/User%20Guide/Collections/6_Calendar_image.png\"> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <br> <br><code>#weight=\"70\" #Mood=\"Good\" #calendar:displayedAttributes=\"weight,Mood\"</code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <br> <br>It can also be used with relations, case in which it will display the title of the target note:&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <br> <br><code>~assignee=@My assignee #calendar:displayedAttributes=\"assignee\"</code></td></tr><tr><td><code>#calendar:startDate</code></td><td>Allows using a different label to represent the start date, other than <code>startDate</code> (e.g. <code>expiryDate</code>). The label name <strong>must not be</strong> prefixed with <code>#</code>. If the label is not defined for a note, the default will be used instead.</td></tr><tr><td><code>#calendar:endDate</code></td><td>Similar to <code>#calendar:startDate</code>, allows changing the attribute which is being used to read the end date.</td></tr><tr><td><code>#calendar:startTime</code></td><td>Similar to <code>#calendar:startDate</code>, allows changing the attribute which is being used to read the start time.</td></tr><tr><td><code>#calendar:endTime</code></td><td>Similar to <code>#calendar:startDate</code>, allows changing the attribute which is being used to read the end time.</td></tr></tbody></table></figure><h2>How the calendar works</h2><p><img src=\"{{helpAssets}}/User%20Guide/Collections/8_Calendar_image.png\"></p><p>The calendar displays all the child notes of the Collection that have a <code>#startDate</code>. An <code>#endDate</code> can optionally be added.</p><p>A text note with a start date is shown with the <span class=\"tn-icon bx bx-calendar-event\"></span> icon in the note tree and elsewhere, unless it has an icon of its own (set with <code>#iconClass</code>). The start date is read from the label <code>#calendar:startDate</code> names, if any.</p><p>The start date &amp; end date can easily be edited from the calendar collection itself by clicking on the event. To edit the date while in the event note itself, the following attributes can be added to the Collection note:</p><pre><code class=\"language-text-x-trilium-auto\">#viewType=calendar #label:startDate(inheritable)=\"promoted,alias=Start Date,single,date\"\n#label:endDate(inheritable)=\"promoted,alias=End Date,single,date\"\n#hidePromotedAttributes </code></pre><p>This will result in:</p><p><img src=\"{{helpAssets}}/User%20Guide/Collections/7_Calendar_image.png\"></p><p>When not used in a Journal, the calendar is recursive. That is, it will look for events not just in its child notes but also in the children of these child notes.</p><h3>Limiting the depth</h3><p>To limit how deep the calendar looks for events, set <em>Maximum nesting depth</em> under <em>Included notes</em> in the <span class=\"tn-icon bx bx-cog\"></span><em>Calendar properties</em> dialog (see <a href=\"#event-templates\">Event templates</a> for how to open it), or the <code>#maxNestingDepth</code> label: <code>0</code> shows only the child notes, <code>1</code> adds their children, and so on. Without a value, events are looked for at every level. The setting doesn't apply in a Journal.</p><h2>Recurrence</h2><p>The built in calendar view also supports repeating tasks (e.g. every week, every month as well as more complex recurrency rules).</p><p>Starting with v0.105.0, recurrence can be directly edited from the calendar by clicking on an event and then selecting the <em>Repeats</em> option.</p><h3>Custom recurrence using a subset of RRULE</h3><p>If the existing recurrence editor from the event popup is not sufficient, more complex rules can be manually set via the <code>#recurrence</code> label.</p><p>For example, to make a note repeat on the calendar:</p><ul><li>Every Day - <code>#recurrence=\"FREQ=DAILY;INTERVAL=1\"</code></li><li>Every 3 days - <code>#recurrence=\"FREQ=DAILY;INTERVAL=3\"</code></li><li>Every week - <code>#recurrence=\"FREQ=WEEKLY;INTERVAL=1\"</code></li><li>Every 2 weeks on Monday, Wednesday and Friday - <code>#recurrence=\"FREQ=WEEKLY;INTERVAL=2;BYDAY=MO,WE,FR\"</code></li><li>Every 3 months - <code>#recurrence=\"FREQ=MONTHLY;INTERVAL=3\"</code></li><li>Every 2 months on the First Sunday - <code>#recurrence=\"FREQ=MONTHLY;INTERVAL=2;BYDAY=1SU\"</code></li><li>Every month on the Last Friday - <code>#recurrence=\"FREQ=MONTHLY;INTERVAL=1;BYDAY=-1FR\"</code></li></ul><p>For other examples of valid <code>RRULE</code> strings see <a href=\"https://icalendar.org/rrule-tool.html\">https://icalendar.org/rrule-tool.html</a></p><p>Note that the recurrence string does not include the <code>DTSTART</code> attribute as defined in the iCAL specifications. This is derived directly from the <code>startDate</code> and <code>startTime</code> attributes</p><p>If you want to override the label the calendar uses to fetch the recurrence string, you can use the <code>#calendar:recurrence</code> attribute. For example, you can set <code>#calendar:recurrence=taskRepeats</code>. Then you can set your recurrence string like <code>#taskRepeats=\"FREQ=DAILY;INTERVAL=1\"</code></p><p>Also note that the recurrence label can be made promoted as with the start and end dates.&nbsp;</p><aside class=\"admonition warning\"><p>If the recurrence string is not valid, a toast will be shown with the note ID and title of the note with the erroneous recurrence message. This note will not be added to the calendar</p></aside><h2>Customizing the slot duration and label interval</h2><p>Time slots in day and week views can be customized from&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a></p><ul><li><em>Slot duration</em> controls how tall each time slot is on the calendar (essentially the smallest unit of time the grid is divided into).<ul><li>A shorter duration means more rows and finer granularity; a longer one means fewer, chunkier rows.</li><li>The default is one row every 15 minutes.</li></ul></li><li><em>Label interval</em> controls how often a time label appears on the left-hand axis.<ul><li>This is independent of the slot size: you can have very small slots but only label every hour to keep the axis readable.</li><li>The default is a time label shown every hour.</li></ul></li></ul><aside class=\"admonition note\"><p>These values can also be customized directly via the <code>#calendar:slotDuration</code> and <code>#calendar:slotLabelInterval</code> <a href=\"#root/_help_HI6GBBIduIgv\">labels</a>. Both values use <code>HH:mm:ss</code> format. Hours can go up to <code>24</code> (<code>24:00:00</code>), while minutes and seconds must be between <code>00</code> and <code>59</code>. The minimum meaningful duration is 1 minute (<code>00:01:00</code>).</p></aside><h2>Use-cases</h2><h3>Using with the Journal / calendar</h3><p>It is possible to integrate the calendar view into the Journal with day notes. In order to do so change the note type of the Journal note (calendar root) to Collection and then select the Calendar View.</p><p>While in journal mode, the popup editor will not show dates, recurrence, colors or removal, since day notes aren't editable events.</p><p>Based on the <code>#calendarRoot</code> (or <code>#workspaceCalendarRoot</code>) attribute, the calendar will know that it's in a calendar and apply the following:</p><ul><li>The calendar events are now rendered based on their <code>dateNote</code> attribute rather than <code>startDate</code>.</li><li>Interactive editing such as dragging over an empty era or resizing an event is no longer possible.</li><li>Clicking on the empty space on a date will automatically open that day's note or create it if it does not exist.</li><li>Direct children of a day note will be displayed on the calendar despite not having a <code>dateNote</code> attribute. Children of the child notes will not be displayed.</li></ul><img src=\"{{helpAssets}}/User%20Guide/Collections/5_Calendar_image.png\" width=\"1217\" height=\"724\"><h3>Using a different attribute as event title</h3><p><img class=\"image-style-align-right\" src=\"{{helpAssets}}/User%20Guide/Collections/2_Calendar_image.png\" width=\"445\" height=\"124\">By default, events are displayed on the calendar by their note title. However, it is possible to configure a different attribute to be displayed instead.</p><p>To do so, assign <code>#calendar:title</code> to the child note (not the calendar/Collection note), with the value being <code>name</code> where <code>name</code> can be any label (make not to add the <code>#</code> prefix). The attribute can also come through inheritance such as a template attribute. If the note does not have the requested label, the title of the note will be used instead.</p><pre><code class=\"language-text-x-trilium-auto\">#startDate=2025-02-11 #endDate=2025-02-13 #name=\"My vacation\" #calendar:title=\"name\"</code></pre><h3>Using a relation attribute as event title</h3><p><img class=\"image-style-align-right image_resized\" style=\"aspect-ratio:294/151;width:21.22%;\" src=\"{{helpAssets}}/User%20Guide/Collections/3_Calendar_image.png\" width=\"294\" height=\"151\">Similarly to using an attribute, use <code>#calendar:title</code> and set it to <code>name</code> where <code>name</code> is the name of the relation to use.</p><p>Moreover, if there are more relations of the same name, they will be displayed as multiple events coming from the same note.</p><pre><code class=\"language-text-x-trilium-auto\">#startDate=2025-02-14 #endDate=2025-02-15 ~for=@John Smith ~for=@Jane Doe #calendar:title=\"for\"</code></pre><p><img class=\"image-style-align-left\" src=\"{{helpAssets}}/User%20Guide/Collections/Calendar_image.png\" width=\"296\" height=\"150\">Note that it's even possible to have a <code>#calendar:title</code> on the target note (e.g. “John Smith”) which will try to render an attribute of it. Note that it's not possible to use a relation here as well for safety reasons (an accidental recursion &nbsp;of attributes could cause the application to loop infinitely).</p><pre><code class=\"language-text-x-trilium-auto\">#calendar:title=\"shortName\" #shortName=\"John S.\"</code></pre><h3>Displaying an age on a recurring event</h3><p>A birthday or an anniversary repeats every year, and what is interesting about each occurrence is the number of years it marks. To display it:</p><ol><li>Set the event's start date to the original date (for example, the date of birth).</li><li>Click the event, then select the <em>Repeats</em> dropdown.</li><li>Select <em>Yearly</em> and check <em>Show the number of years in the title</em>.</li></ol><p>The event is then displayed as “John Smith (35)” in 2025, “John Smith (36)” in 2026, and so on. Only the calendar is affected; the note keeps its own title.</p><p>The checkbox sets the <code>#calendar:titleTemplate</code> label, which sets the title an event is displayed with and is filled in again for every occurrence the recurrence rule produces:</p><pre><code class=\"language-text-x-trilium-auto\">#startDate=1990-05-12 #recurrence=\"FREQ=YEARLY\" #calendar:titleTemplate=\"${title} (${years})\"</code></pre><p>To word the title differently, edit the label directly. The checkbox is then disabled, as it is when the template is inherited, so that it never overwrites a template of your own.</p><p>The following values can be used in the template:</p><figure class=\"table\"><table><thead><tr><th>Value</th><th>Description</th></tr></thead><tbody><tr><td><code>${title}</code></td><td>The title the event would otherwise be displayed with: the note title, or the attribute <code>#calendar:title</code> points to.</td></tr><tr><td><code>${years}</code></td><td>The whole years between <code>#startDate</code> and the occurrence being displayed. It is <code>0</code> on the first occurrence.</td></tr><tr><td><code>${date}</code></td><td>The date of the occurrence being displayed, as a <a href=\"https://day.js.org/docs/en/display/format\">day.js</a> object. For example, <code>${date.format('YYYY')}</code>.</td></tr><tr><td><code>${startDate}</code></td><td>The date the event starts on, in the same form. For example, <code>${startDate.format('YYYY')}</code>.</td></tr></tbody></table></figure><p>To use the same template for every event of a calendar, make the label inheritable on the Collection note:</p><pre><code class=\"language-text-x-trilium-auto\">#calendar:titleTemplate(inheritable)=\"${title} (${years})\"</code></pre><aside class=\"admonition note\"><p>A template that cannot be read — an unknown value, or an expression other than a value and the <code>format</code> call shown above — leaves the event with its plain title and reports the reason in the browser console.</p></aside>",
+ "_help_2FvYrpmOXm29": "<figure class=\"image\"><img style=\"aspect-ratio:1050/259;\" src=\"{{helpAssets}}/User%20Guide/Collections/Table_image.png\" width=\"1050\" height=\"259\"></figure><p>The table view displays information in a grid, where the rows are individual notes and the columns are&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>. In addition, values are editable.</p><h2>How it works</h2><p>The tabular structure is represented as such:</p><ul><li>Each child note is a row in the table.</li><li>If child rows also have children, they will be displayed under an expander (nested notes).</li><li>Each column is a <a href=\"#root/_help_OFXdgB2nNk1F\">promoted attribute</a> that is defined on the Collection note.<ul><li>Actually, both promoted and unpromoted attributes are supported, but it's a requirement to use a label/relation definition.</li><li>The promoted attributes are usually defined as inheritable in order to show up in the child notes, but it's not a requirement.</li></ul></li><li>If there are multiple attribute definitions with the same <code>name</code>, only one will be displayed.</li><li>If an attribute definition has multiple values, they will all be grouped under a single column, with chips indicating individual values.</li></ul><p>There are also a few predefined columns:</p><ul><li>The current item number, identified by the <code>#</code> symbol.<ul><li>This simply counts the note and is affected by sorting.</li></ul></li><li><a class=\"reference-link\" href=\"#root/_help_m1lbrzyKDaRB\">Note ID</a>, representing the unique ID used internally by Trilium</li><li>The title of the note.</li></ul><h2>Interaction</h2><h3>Creating a new table</h3><p>Right click on an existing note in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;and select <em>Insert child note</em> → <em>Collection</em> → <em>Table</em>.</p><h3>Adding columns</h3><p>Each column is a <a href=\"#root/_help_OFXdgB2nNk1F\">promoted or unpromoted attribute</a> that is defined on the Collection note.</p><p>To create a new column, either:</p><ul><li>Press <em>Add new column</em> at the bottom of the table.</li><li>Right click on an existing column and select Add column to the left/right.</li><li>Right click on the empty space of the column header and select <em>Label</em> or <em>Relation</em> in the <em>New column</em> section.</li></ul><h3>Adding new rows</h3><p>Each row is actually a note that is a child of the Collection note.</p><p>To create a new note, either:</p><ul><li>Press <em>Add new row</em> at the bottom of the table.</li><li>Right click on an existing row and select <em>Insert row above, Insert child note</em> or <em>Insert row below</em>.</li></ul><p>By default it will try to edit the title of the newly created note.</p><p>Alternatively, the note can be created from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;or <a href=\"#root/_help_CdNpE2pqjmI6\">scripting</a>.</p><h3>Context menu</h3><p>There are multiple menus:</p><ul><li>Right clicking on a column, allows:<ul><li>Sorting by the selected column and resetting the sort.</li><li>Hiding the selected column or adjusting the visibility of every column.</li><li>Adding new columns to the left or the right of the column.</li><li>Editing the current column.</li><li>Deleting the current column.</li></ul></li><li>Right clicking on the space to the right of the columns, allows:<ul><li>Adjusting the visibility of every column.</li><li>Adding new columns.</li></ul></li><li>Right clicking on a row, allows:<ul><li>Opening the corresponding note of the row in a new tab, split, window or quick editing it.</li><li>Inserting a new note above or below the selected row. These options are only enabled if the table is not sorted.</li><li>Inserting a new child note for the selected row.</li><li>Deleting the row.</li></ul></li></ul><h3>Editing data</h3><p>Simply click on a cell within a row to change its value. The change will not only reflect in the table, but also as an attribute of the corresponding note.</p><ul><li>The editing will respect the type of the promoted attribute, by presenting a normal text box, a number selector or a date selector for example.</li><li>It also possible to change the title of a note.</li><li>Editing relations is also possible<ul><li>Simply click on a relation and it will become editable. Enter the text to look for a note and click on it.</li><li>To remove a relation, remove the title of the note from the text box and click outside the cell.</li></ul></li></ul><h3>Editing columns</h3><p>It is possible to edit a column by right clicking it and selecting <em>Edit column…</em> This will basically change the label/relation definition at the collection level.</p><p>If the <em>Name</em> field of a column is changed, this will trigger a batch operation in which the corresponding label/relation will be renamed in all the children.</p><h3>Read-only tables</h3><p>On a <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a> table, the cells can't be edited and the rows can't be dragged. The <em>New row</em> and <em>New column</em> buttons are hidden, and the context menus offer only what leaves the notes as they are: sorting and hiding columns, and opening the notes. Columns can still be resized and reordered, but the layout isn't saved. The <em>Table properties</em> dialog isn't available.</p><h2>Working with the data</h2><h3>Sorting by column</h3><p>By default, the order of the notes matches the order in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>. However, it is possible to sort the data by the values of a column:</p><ul><li>To do so, simply click on a column.</li><li>To switch between ascending or descending sort, simply click again on the same column. The arrow next to the column will indicate the direction of the sort.</li><li>To disable sorting and fall back to the original order, right click any column on the header and select <em>Clear sorting.</em></li></ul><h3>Reordering and hiding columns</h3><ul><li>Columns can be reordered by dragging the header of the columns.</li><li>Columns can be hidden or shown by right clicking on a column and clicking the item corresponding to the column.</li></ul><h3>Reordering rows</h3><p>Notes can be dragged around to change their order. To do so, move the mouse over the three vertical dots near the number row and drag the mouse to the desired position.</p><p>This will also change the order of the note in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.</p><p>Reordering does have some limitations:</p><ul><li>If the parent note has <code>#sorted</code>, reordering will be disabled.</li><li>If using nested tables, then reordering will also be disabled.</li><li>Currently, it's possible to reorder notes even if column sorting is used, but the result might be inconsistent.</li></ul><h3>Nested trees</h3><p>If the child notes of the collection also have their own child notes, then they will be displayed in a hierarchy.</p><p>Next to the title of each element there will be a button to expand or collapse. By default, all items are expanded.</p><p>Since nesting is not always desirable, it is possible to limit the nesting to a certain number of levels or even disable it completely. To do so, go to <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Table properties</em> and set <em>Maximum nesting depth</em> (under the <em>Included notes</em> section), or set the <code>#maxNestingDepth</code> <a href=\"#root/_help_HI6GBBIduIgv\">label</a> of the collection:</p><ul><li><code>0</code> disables nesting, showing only the children of the collection.</li><li><code>1</code> also shows their children, <code>2</code> the level below that, and so on.</li><li>Removing the label shows every level again.</li></ul><p>Limitations:</p><ul><li>While in this mode, it's not possible to reorder notes.</li></ul><h2>Limitations</h2><ul><li>There is no support to filter the rows by a certain criteria. Consider using the table view in search for that use case.</li></ul><h2>Use in search</h2><p>The table view can be used in a&nbsp;<a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a>&nbsp;by adding the <code>#viewType=table</code> attribute.</p><p>Unlike when used in a Collection, saved searches are not limited to the sub-hierarchy of a note and allows for advanced queries thanks to the power of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>.</p><p>However, there are also some limitations:</p><ul><li>It's not possible to reorder notes.</li><li>It's not possible to add a new row.</li></ul><p>Columns are supported, by being defined as&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>&nbsp;to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a>&nbsp;note.</p><p>Editing is also supported.</p>",
+ "_help_CtBQqbwXDx1w": "<p>The Board view lets you arrange subnotes as cards on a <a href=\"https://en.wikipedia.org/wiki/Kanban_board\">Kanban board</a>.</p><h2>Creating a Kanban board</h2><p>Right-click an existing note in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, select <em>Insert child note</em> → <em>Collection</em> → <em>Kanban Board</em>.</p><h2>How it works</h2><p>When you first create a collection of the <em>Board</em> type, a few subnotes are created, each with a <code>#status</code> label set. The board then groups each note by the value of its status attribute.</p><p>Notes are displayed recursively, so even grandchildren and more deeply nested notes will be displayed. However, unlike the&nbsp;<a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a>, the notes are not displayed hierarchically.</p><p>To limit how deep the board looks, go to <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em> and set <em>Maximum nesting depth</em> (under the <em>Included notes</em> section), or apply the <code>#maxNestingDepth</code> label to the board note: <code>0</code> shows only the children, <code>1</code> adds their children, and so on. Without a value, every level is shown.</p><h2>Working with columns</h2><h3>Creating columns</h3><p>You can create a new column by pressing the <span class=\"tn-icon bx bx-plus\"></span> <em>Add column</em> button located after the last column.</p><p>Enter the new name (which must not match another column), optionally select an icon by pressing the circle at the start of the text box, and then press the (+) button or <kbd>Enter</kbd>. Click or tap outside the text box, or press <kbd>Esc</kbd>, to dismiss it.</p><p>Columns can also be added from a context menu:</p><ul><li>To add a column at the end of the board, right-click an empty area of the board and select <span class=\"tn-icon bx bx-columns\"></span> <em>Add new column</em>.</li><li>To add a column next to an existing one, open its column menu and select <span class=\"tn-icon bx bx-columns\"></span> <em>Add new column</em> → <em>Before</em> (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Enter</kbd>) or <em>After</em> (<kbd>Ctrl</kbd>+<kbd>Enter</kbd>).</li></ul><p>Once a board is set up, the <em>Add column</em> button can be hidden. To do so, go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em> and turn off <em>Show the \"Add column\" button</em> (under the <em>General</em> section), or apply the <code>#board:hideAddColumn</code> label to the board note. Columns can still be added from the context menus above.</p><h3>Reordering columns</h3><p>The order of the columns can be changed at any time. There are several ways to do this:</p><ul><li><strong>Using touch or a mouse:</strong> Touch and hold the column header, or click and hold it with the mouse. Drag the column left or right until it reaches the desired location, and then release it.</li><li><strong>Using the keyboard:</strong> While the keyboard focus is anywhere inside the column, you can use these key combinations. If the column header itself is focused, you can omit <kbd>Alt</kbd>:<ul><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Right</kbd>: Move the column to the right.</li><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Left</kbd>: Move the column to the left.</li><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Home</kbd>: Make it the first column.</li><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>End</kbd>: Make it the last column.</li></ul></li><li><em>Using the column menu:</em> Open the column menu and use the&nbsp;<span class=\"tn-icon bx bx-horizontal-left\"></span> <em>Move column</em> submenu.</li></ul><h3>Renaming and recoloring columns</h3><p>To change the name of a column, open the column menu and select&nbsp;<span class=\"tn-icon bx bx-edit-alt\"></span> <em>Rename column</em>, or press <kbd>F2</kbd> while the column header is selected.</p><p>From the same menu, you can tint the column with a different color by using the color palette at the bottom of the menu.</p><h3>Collapsing and expanding columns</h3><h4>Collapsing</h4><p>A column can be collapsed (minimized) to occupy less space on the screen and make the board look less cluttered. This is particularly useful for columns that are not frequently used, or when you want to focus on only a few columns and keep the rest out of sight.</p><p>To collapse a column:</p><ul><li><strong>Using a mouse:</strong> Double-click the column header.</li><li><strong>Using touch:</strong> Tap the column header, and then press the&nbsp;<span class=\"tn-icon bx bx-collapse-horizontal\"></span> button on the side toolbar.</li><li><strong>Using the keyboard:</strong> Focus the column header, and then press <kbd>Space</kbd>.</li></ul><p>Alternatively, you can use the&nbsp;<span class=\"tn-icon bx bx-collapse-horizontal\"></span> <em>Collapse column</em> command from the column menu.</p><p>Once a column is collapsed, its cards are no longer visible, but the column can still receive cards from other columns:</p><ul><li><strong>Drop cards onto a collapsed column:</strong> The cards will be moved to the column (at the bottom if manual sorting is enabled).</li><li><strong>Hold cards over a collapsed column for a few seconds:</strong> The column will expand, allowing you to drop the cards at the desired position (if manual sorting is enabled) or peek at the other cards before deciding whether to drop them.</li><li><strong>Move a card to a collapsed column using the keyboard:</strong> The column will temporarily expand to reveal the moved card. You can then continue moving the selected cards up or down, or to another column.</li></ul><p>Collapsed columns can still be reordered, and their menus remain available.</p><p>A collapsed column shows its title vertically, read from the bottom up. If any column title on the board contains Chinese, Japanese or Korean characters, the titles of all collapsed columns read from the top down instead, so that those characters stay upright.</p><h4>Expanding</h4><p>You can restore a collapsed column so that its content is visible again in the following ways:</p><ul><li><strong>Using a mouse:</strong> Click the collapsed column.</li><li><strong>Using touch:</strong> Tap the collapsed column, and then press the&nbsp;<span class=\"tn-icon bx bx-expand-horizontal\"></span> button on the side toolbar.</li><li><strong>Using the keyboard:</strong> Move the focus to the collapsed column, and then press <kbd>Space</kbd>.</li></ul><h4>Keeping a column collapsed</h4><p>By default, once a column is expanded, it remains expanded. However, you can configure a column to collapse again after you finish working with it. To activate this behavior, open the column menu and check&nbsp;<span class=\"tn-icon bx bx-lock-alt\"></span> <em>Keep the column collapsed</em>.</p><p>A column configured to remain collapsed will expand like any other collapsed column, but only temporarily, until another column is focused.</p><h4>Collapsing and expanding all columns</h4><p>You can expand or collapse all columns at once by using the&nbsp;<span class=\"tn-icon bx bx-collapse-alt\"></span> (collapse) and&nbsp;<span class=\"tn-icon bx bx-expand-alt\"></span> (expand) buttons. On the desktop, these buttons are located at the bottom of the screen; on the mobile interface, they are in the header.</p><h3>Sorting cards within a column</h3><p>By default, the cards in a column are sorted manually by moving them up and down. You can also keep them sorted automatically, using customizable criteria for each column. To customize the sorting options, open the column menu → <em>Sort</em>. The following options are available:</p><ul><li><span class=\"tn-icon bx bx-collection\"></span>&nbsp;<em>Board's default</em>: Use the default sorting order (initially manual for new boards).</li><li><span class=\"tn-icon bx bx-move-vertical\"></span>&nbsp;<em>Manually</em>: Sort cards by manually moving them up and down.</li><li><span class=\"tn-icon bx bx-text\"></span>&nbsp;<em>Title</em>: Sort cards by title.</li><li><span class=\"tn-icon bx bx-calendar-plus\"></span>&nbsp;<em>Creation date &amp; time</em>: Sort cards by the creation date and time of the note represented by each card. If a card was created from an existing note, the date and time will match the original creation date and time of that note, not when the card was added to the board.</li><li>Any custom attribute: Any card attribute (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_zEY4DaJG4YT5\">Attributes</a>) can be used as a sorting criterion.</li><li><span class=\"tn-icon bx bx-sort-up\"></span>&nbsp;<em>Ascending</em>: Sort from smallest to largest (A to Z, 0 to 9, or oldest to newest).</li><li><span class=\"tn-icon bx bx-sort-down\"></span>&nbsp;<em>Descending</em>: Sort in reverse order, from largest to smallest.</li></ul><aside class=\"admonition important\"><p>The card order you set is preserved after you switch away from manual sorting. When you switch back to manual sorting, the cards will be in the same order in which you arranged them.</p></aside><h4>How card attributes are sorted</h4><p>When cards are sorted by an attribute, they are ordered according to the following rules:</p><figure class=\"table\"><table><thead><tr><th>Attribute type</th><th>Sort order (ascending)</th></tr></thead><tbody><tr><td>Text, Multi-line text, URL, Email, Phone</td><td>A to Z, 0 to 9</td></tr><tr><td>Number</td><td>lowest → greatest</td></tr><tr><td>Date, Date &amp; time</td><td>oldest → newest</td></tr><tr><td>Time</td><td>earliest hour (closest to 0) → latest hour (closest to 24)</td></tr><tr><td>Checkbox</td><td>unchecked → checked</td></tr><tr><td>Select</td><td>The order in which the options are declared.&nbsp;&nbsp;&nbsp;&nbsp; <br>For example, a select attribute declared with “Low”, “Medium”, and “High” options will be sorted as follows: Low → Medium → High.</td></tr><tr><td>Color</td><td>Grays → colors. Colors are ordered by their color-wheel <a href=\"https://en.wikipedia.org/wiki/Hue\">hue</a> angle (from 0° to 360°).</td></tr></tbody></table></figure><p>Relation attributes are ordered according to the title of the target note.</p><p>Cards with attributes that have no value set are always sorted at the end of the column, regardless of whether the sort order is ascending or descending. If an attribute holds more than one value, only the first value is used for sorting.</p><h4>Configuring the default sorting options</h4><p>Every new column uses the <em>Board's default</em> sorting option, which is initially set to manual sorting on new boards. However, the default can be changed to any other sorting criterion and direction. To configure it, go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em> → <em>Default card order</em> (under the <em>General</em> section).</p><p>Once the default is changed, all columns set to the <em>Board's default</em> sorting option will follow the new sorting options.</p><p>Columns using a sorting option other than <em>Board's default</em> will not be affected by the new default. To override all columns so that they use the default sorting options, use the <em>Reset sorting options to default for all columns</em> command in <em>Board properties</em>.</p><aside class=\"admonition warning\"><p>Using the <code>#sorted</code> attribute on Kanban boards <strong>is no longer recommended</strong>, because it applies to every column and prevents manual sorting. Instead, use <code>#board:sortColumns</code>, which is designed exclusively for board collections and can take one of the following values: <code>title</code>, <code>creationDate</code>, or <code>attr:_&lt;attribute name&gt;_</code>, for example, <code>#board:sortColumns=attr:dueDate</code>. Using the <code>#board:sortColumnsDescending</code> label will switch to descending order.</p></aside><h3>Setting a limit</h3><p>For each column, you can limit the number of cards it contains (also known as a WIP limit). Once the limit is exceeded, the column displays a visual warning to indicate that it is over its limit.</p><p>To enable the limit, go to the column menu →&nbsp;<span class=\"tn-icon bx bx-tachometer\"></span> <em>Set limit</em>, and then:</p><ul><li>Turn on the <em>Warn for exceeding the column capacity</em> toggle.</li><li>Enter the desired limit in the <em>Maximum number of cards in the column</em> text box.</li><li>Press the <em>Set limit</em> button.</li></ul><p>A column that has reached its limit can still accept new cards. Blocking new cards is not supported and most likely never will be, due to the way Trilium works: cards are regular notes, and the attributes used to group them into columns can be set from anywhere in the app, outside the board control. As a result, enforcing the limit would not be consistent.</p><h3>Archiving a column</h3><p>If you want to hide a column from the board without deleting it, you can archive it by opening the column menu →&nbsp;<span class=\"tn-icon bx bx-archive-in\"></span> <em>Archive column</em>. Archiving a column does not set the archived flag (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_MKmLg5x6xkor\">Archived Notes</a>) on the notes corresponding to its cards.</p><p>To show archived columns again, go to&nbsp;<span class=\"tn-icon bx bx-cog\"></span> <em>Collection options</em> and toggle&nbsp;<span class=\"tn-icon bx bx-archive-in\"></span> <em>Show archived notes</em>, or turn on <em>Show archived cards and columns</em> in <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em> (under the <em>Included notes</em> section). Archived columns will appear faded. To restore one, open its column menu and select&nbsp;<span class=\"tn-icon bx bx-archive-out\"></span> <em>Unarchive column</em>.</p><h3>Deleting a column</h3><p>You can delete a column by opening the column menu →&nbsp;<span class=\"tn-icon bx bx-trash\"></span> <em>Delete column</em>, or by pressing <kbd>Delete</kbd> when a column header is focused, and then confirming. This removes the column from the board and unsets the grouping attribute for each note represented by a card in that column. If the column contains cards, the confirmation also offers to delete their notes instead of keeping them.</p><p>The inbox column is not deleted this way. Its menu entry is&nbsp;<span class=\"tn-icon bx bx-trash\"></span> <em>Remove inbox column</em>, and <kbd>Delete</kbd> on its header hides the inbox without changing any card.</p><h3>The inbox column</h3><p>The inbox column is a special column containing cards that are not assigned to another column. It is particularly useful when you switch an existing collection containing child notes to a board collection. The inbox column turns all child notes into cards that you can quickly distribute among the other columns. It can also act as a backlog where you can keep new cards that might eventually become part of the board.</p><p>The inbox column is hidden by default. To show it, go to&nbsp;<span class=\"tn-icon bx bx-cog\"></span> <em>Collection options</em> and toggle <em>Show inbox column</em>. The inbox column is distinguishable by its transparent background. It is always the first column and cannot be moved. It does not support a card limit. Otherwise, it operates like a regular column: its title, icon, and color can be changed; it can be sorted manually or automatically; and it can be collapsed.</p><p>You can also show the inbox column by applying the <code>#board:showInbox</code> label (read more about&nbsp;<a class=\"reference-link\" href=\"#root/_help_zEY4DaJG4YT5\">Attributes</a>) to the board note.</p><p>Optionally, the inbox column can also list nested notes from the board collection's subtree. To enable this, open the column menu and check&nbsp;<span class=\"tn-icon bx bx-subdirectory-right\"></span> <em>Include nested notes</em>.</p><h3>Changing the width of columns</h3><p>There are three predefined widths for board columns: narrow (default), medium, and wide. To change the width, open the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em> → <em>Column width</em> (under the <em>General</em> section). This option applies to every column on the board, except in the mobile version.</p><p>The same option is also available through the <code>#board:columnWidth</code> label (read more about&nbsp;<a class=\"reference-link\" href=\"#root/_help_zEY4DaJG4YT5\">Attributes</a>) on the board note, which accepts “<code>narrow</code>”, “<code>medium</code>”, or “<code>wide</code>” as its value.</p><p>You can also redefine these three widths by using custom app CSS (read more about&nbsp;<a class=\"reference-link\" href=\"#root/_help_AlhDUqhENtH7\">Custom app-wide CSS</a>) and assigning the desired pixel values as follows:</p><pre><code class=\"language-text-x-trilium-auto\">#trilium-app {\n --board-column-width-narrow: 275px;\n --board-column-width-medium: 325px;\n --board-column-width-wide: 400px;\n}</code></pre><h2>Working with cards</h2><h3>Creating a new card</h3><p>To create a new card, press the <span class=\"tn-icon bx bx-plus\"></span> <em>New card</em> button located at the bottom of each column. To create a new card above or below a specific card, right-click or hold that card, and then select&nbsp;<span class=\"tn-icon bx bx-list-plus bx-flip-vertical\"></span> <em>Insert new above</em> or&nbsp;<span class=\"tn-icon bx bx-list-plus\"></span> <em>Insert new below</em> from the context menu. Alternatively, press <kbd>Shift</kbd> + <kbd>Enter</kbd> to create a new card above the focused card, or <kbd>Enter</kbd> to create one below it.</p><p>Next, type the title of the new card, and then press the&nbsp;<span class=\"tn-icon bx bx-plus-circle\"></span> button or <kbd>Enter</kbd> to complete it. Tap or click anywhere outside the text box to dismiss it. You can also select a different icon and card template. To learn more about card templates, see Card templates (learn more about&nbsp;<a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>).</p><p>After the card is created, you can tap or click it, or press <kbd>Space</kbd>, to edit the note content.</p><p>When using the&nbsp;<span class=\"tn-icon bx bx-plus\"></span> <em>New card</em> button, cards are always created at the end of the column. To create the card at the top of the column, right-click or hold the&nbsp;<span class=\"tn-icon bx bx-plus-circle\"></span> button and select&nbsp;<span class=\"tn-icon bx bx-vertical-top\"></span> <em>Create at top</em>. When using keyboard shortcuts, focus the column header and press <kbd>Enter</kbd> to create a new card at the start of the column, or <kbd>Shift</kbd> + <kbd>Enter</kbd> to create one at the end.</p><h3>Adding an existing note as a card</h3><p>Any note in your knowledge base can be represented as a card on a board. To add an existing note to your board, create a new card but do not enter a title. Instead, press the&nbsp;<span class=\"tn-icon bx bx-folder-open\"></span> button. Alternatively, use the&nbsp;<span class=\"tn-icon bx bx-folder-open\"></span> <em>Add an existing note as a card</em> command from the column menu.</p><p>In the dialog that opens, search for the note by name, and then press the <em>Add to column</em> button to insert it. Alternatively, you can drag any note from the tree and drop it at the desired position on the board.</p><p>If the target note is already in the board collection's subtree, it will already be listed in the <strong>inbox column</strong>.</p><aside class=\"admonition important\"><p>Notes added to the board are cloned, not duplicated. This means that changes to their titles, content, and attributes on the board are reflected in their original locations as well. Learn more about cloned notes.</p></aside><h3>Selecting multiple cards</h3><p>When working with a board, you may need to perform operations on multiple cards at once, such as moving them to another column, setting attributes or colors, deleting them, or archiving them.</p><p>You can select multiple cards in the following ways:</p><ul><li><strong>Using a mouse and keyboard:</strong><ul><li>To add a card to the selection, hold <kbd>Ctrl</kbd> and click the card. Repeat this for other cards until all the desired cards are selected. Clicking a selected card again while holding <kbd>Ctrl</kbd> will deselect it.</li><li>If the cards you want to select form a continuous sequence within a column, hold <kbd>Shift</kbd>, click the first card in the sequence, and then click the last card.</li><li>Press <kbd>Esc</kbd> to clear the selection.</li></ul></li><li><strong>On mobile:</strong><ol><li>To enter selection mode, tap the&nbsp;<span class=\"tn-icon bx bx-select-multiple\"></span> button at the top of the screen. A selection toolbar will appear in the header, displaying “0 cards selected”.</li><li>Tap the cards you want to select. If you tap a selected card again, it will be deselected. To select all cards in a column, press the&nbsp;<span class=\"tn-icon bx bx-list-check\"></span> button on the selection toolbar. To clear the selection, press the&nbsp;<span class=\"tn-icon bx bx-x\"></span> button.</li><li>Use the side toolbar to apply actions to the selected cards.</li></ol></li><li><strong>Using only the keyboard:</strong><ul><li>To add the currently focused card to the selection, press <kbd>Ctrl</kbd> + <kbd>Space</kbd>. Repeat this for the other cards you want to select. Pressing <kbd>Ctrl</kbd> + <kbd>Space</kbd> again on a selected card will deselect it.</li><li>To select a continuous sequence of cards within a column, hold <kbd>Shift</kbd> and use the <kbd>Up</kbd> and <kbd>Down</kbd> arrow keys to expand or shrink the selection.</li><li>To select every card in the column the focus is in, press <kbd>Ctrl</kbd> + <kbd>A</kbd>. The same action is available from the column menu, as <span class=\"tn-icon bx bx-selection\"></span> <em>Select all cards</em>.</li><li>Press <kbd>Esc</kbd> to clear the selection.</li></ul></li></ul><h3>Moving cards between columns</h3><p>To move one or more cards to another column, use one of the following methods:</p><h4>Using touch or a mouse</h4><p>Touch and hold the card, or click and hold it with the mouse, and then drag it to the desired column. If the column uses manual sorting, you can also position the card relative to the other cards.</p><aside class=\"admonition tip\"><p>To drag a card outside the board, for example to the note tree, another split, or another window, hold <kbd>Ctrl</kbd> and then start dragging.</p></aside><p>If the target column is collapsed, you can drop the card onto its header to move it into that column (at the end if manually sorted), without expanding it. However, if you want to reveal its cards before dropping, hold the card over the column for a few seconds; the column will then expand.</p><aside class=\"admonition tip\"><p><strong>You can quickly drop a card at the start or end of a column.</strong></p><p>Drop the card above the column while the “Drop as the first card” hint is displayed to make it the first card in that column. Alternatively, drop it below the column while the “Drop as the last card” hint is displayed to make it the last card.</p></aside><h4>Using the keyboard</h4><p>You can also use keyboard shortcuts to move the selected card or cards between columns:</p><ul><li><kbd>Ctrl</kbd> + <kbd>Right</kbd>: Move to the next column.</li><li><kbd>Ctrl</kbd> + <kbd>Left</kbd>: Move to the previous column.</li><li><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Right</kbd>: Move to the last column.</li><li><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Left</kbd>: Move to the first column.</li></ul><h4>Using the context menu</h4><p>To quickly move a card to another column, open the card's context menu and select the destination column. The menu lists the first seven columns; on a wider board, the remaining ones are grouped under <em>More…</em>.</p><h3>Reordering cards within a column</h3><p>Cards within a column can be freely reordered unless the column uses a sorting option other than manual. To reposition a card, drag it as described in the <strong>Moving cards between columns</strong> section and drop it at the desired position.</p><p>Alternatively, you can use keyboard shortcuts to move the selected card or cards:</p><ul><li><kbd>Ctrl</kbd> + <kbd>Up</kbd>: Move up.</li><li><kbd>Ctrl</kbd> + <kbd>Down</kbd>: Move down.</li><li><kbd>Ctrl</kbd> + <kbd>Home</kbd>: Move to the top of the column.</li><li><kbd>Ctrl</kbd> + <kbd>End</kbd>: Move to the end of the column.</li></ul><p>If multiple cards are selected, the keyboard shortcuts work only if the selection consists of a continuous sequence of cards.</p><h3>Editing a card</h3><p>Every card on a board is a regular note. To edit the note associated with a card, click or tap the card, or press <kbd>Space</kbd> when the card is selected. The note will open in a Quick Edit dialog, where you can modify it. You can also open the note in a new tab, split, or window by using the&nbsp;<span class=\"tn-icon bx bx-link-external\"></span> <em>Open note</em> submenu in the card's context menu. To open the note in a new tab on the desktop version, you can also click or tap the&nbsp;<span class=\"tn-icon bx bx-link-external\"></span> <em>Open note</em> menu item directly, without opening its submenu.</p><p>To change the title or icon of a card, use one of the following methods:</p><ul><li><strong>Using a mouse:</strong> Place the mouse pointer over the card, and then click the&nbsp;<span class=\"tn-icon bx bx-rename\"></span> button.</li><li><strong>On mobile:</strong> Hold the card until the side toolbar appears, and then tap the&nbsp;<span class=\"tn-icon bx bx-rename\"></span> button.</li><li><strong>Using the keyboard:</strong> Select a card, and then press <kbd>F2</kbd>.</li><li><em>Using the context menu:</em> Open the card's context menu and select&nbsp;<span class=\"tn-icon bx bx-rename\"></span> <em>Edit title &amp; icon</em>.</li></ul><p>You can then enter a new name and select another icon. To move the keyboard focus from the title field to the icon selector, press <kbd>Shift</kbd> + <kbd>Tab</kbd>. Click or tap anywhere outside the card, or press <kbd>Enter</kbd>, to apply the change. Press <kbd>Esc</kbd> to discard the changes.</p><p>Each card can be tinted with a different color. Open the card's context menu and select the desired color. If no color is assigned, the card inherits the column color.</p><aside class=\"admonition important\"><p>The title, icon, and color of a card are the same as those of the corresponding note. If that note exists in multiple locations in the tree, any change to its title, icon, or color on the board will apply in those locations as well, not only on the board.</p></aside><h3>Archiving a card</h3><p>A card can be hidden from the board without deleting it by using the&nbsp;<span class=\"tn-icon bx bx-archive-in\"></span> <em>Archive note</em> command from the card's context menu.</p><p>To show archived cards again, go to&nbsp;<span class=\"tn-icon bx bx-cog\"></span> <em>Collection options</em> and toggle&nbsp;<span class=\"tn-icon bx bx-archive-in\"></span> <em>Show archived notes</em>, or turn on <em>Show archived cards and columns</em> in <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em> (under the <em>Included notes</em> section). Archived cards will appear faded. To restore one, open its context menu and select&nbsp;<span class=\"tn-icon bx bx-archive-out\"></span> <em>Unarchive note</em>.</p><aside class=\"admonition warning\"><p>Archiving a card sets the <code>#archived</code> flag on its note. If the note exists in multiple locations in the tree, it will appear archived in those locations as well. Read more about&nbsp;<a class=\"reference-link\" href=\"#root/_help_MKmLg5x6xkor\">Archived Notes</a>.</p></aside><h3>Deleting a card</h3><p>You can remove one or more cards from the board and delete their associated notes by using the&nbsp;<span class=\"tn-icon bx bx-trash\"></span> <em>Delete note…</em> command from the card's context menu, or by pressing <kbd>Shift</kbd> + <kbd>Delete</kbd>. On mobile, hold the card until the side toolbar appears, and then tap the&nbsp;<span class=\"tn-icon bx bx-trash\"></span> button.</p><h4>Removing a card from the board without deleting the note</h4><p>To remove a card from the board's columns while keeping its note, open the card's context menu and select&nbsp;<span class=\"tn-icon bx bx-task-x\"></span> <em>Remove from column</em>, or press <kbd>Delete</kbd>. On mobile, hold the card until the side toolbar appears, and then tap the&nbsp;<span class=\"tn-icon bx bx-task-x\"></span> button.</p><p>This command is not available when the inbox column is enabled. Instead, drag the card to the inbox column to achieve the same result.</p><p>The note remains in the board collection but is not assigned to any column. To see it on the board again, enable the inbox column.</p><aside class=\"admonition note\"><p>Under the hood, removing a card simply unsets the note's grouping attribute.</p></aside><h3>Working with custom card attributes</h3><p>By default, the face of a card displays a minimal set of information: the title, icon, and color. In some cases, this may not provide enough useful information at a glance. You can extend the card to display extra information, called card attributes, such as a due date, priority, completion status, or any other information you need. Card attributes use the same principles as&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>.</p><h4>Creating a new attribute</h4><p>To create a new attribute, follow these steps:</p><ol><li>Go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em>, find the <em>Card attributes</em> section, and then press the&nbsp;<span class=\"tn-icon bx bx-plus\"></span> <em>Create a new attribute</em> button.</li><li>Enter a name for the attribute. This is the internal name used by Trilium, so do not use spaces or special characters.</li><li>Select a type (text, number, checkbox, and so on).</li><li>Set the display name. This is the name shown on the card.</li><li>Press <em>Save &amp; close</em>.</li></ol><aside class=\"admonition note\"><p>For each newly created attribute, Trilium creates an attribute definition on the board collection note. A card displays the attributes declared as inheritable on the board note, as well as any attribute the card gets a definition for from elsewhere, for example through&nbsp;<a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>&nbsp;or another parent note it is cloned under. Attributes that only the cards define are listed after the board's own.</p></aside><p>Here is an example of the attributes you can define for a typical Kanban board used to track tasks:</p><figure class=\"table\"><table><thead><tr><th>Attribute name</th><th>Attribute type</th><th>Attribute display name</th></tr></thead><tbody><tr><td>dueDate</td><td>Date &amp; Time</td><td>Due date</td></tr><tr><td>priority</td><td>Select (options: Low, Medium, High, Urgent)</td><td>Priority</td></tr><tr><td>done</td><td>Checkbox</td><td>Done</td></tr></tbody></table></figure><h4>Modifying the values of custom attributes</h4><p>To set the value of a custom attribute, click or tap the card, and then enter or select the desired value in the dialog header.</p><p>For attributes of the “select” or “checkbox” type, you can quickly change the value by using the card's context menu under the <em>Attributes</em> section.</p><h4>Reordering, hiding, redefining, and deleting custom attributes</h4><p>Go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em>. Under the <em>Card attributes</em> section, you can:</p><ul><li>Hold the <strong>=</strong> handle shown beside an attribute, and then drag the item up or down to reorder the attributes. This determines the order in which the attributes are displayed on the card.</li><li>Turn off the toggle to hide an attribute from the card's face. The attribute remains available when you edit the card. For the current grouping attribute, the toggle is disabled.</li><li>Press the&nbsp;<span class=\"tn-icon bx bxs-edit\"></span> button to modify the definition of an attribute.</li><li>Press the&nbsp;<span class=\"tn-icon bx bx-trash\"></span> button to delete the attribute and all its values from every note in the board collection.</li></ul><p>Attributes that the cards get from a template or another parent note can be reordered and hidden here, but not modified or deleted. Edit them on the note that defines them.</p><p>If cards define an attribute with the same name but a different type or different select options, for example through two different templates, or if a card overrides the board's definition with its own, the attribute is marked <em>Multiple definitions</em>. Such an attribute is sorted as text and does not appear in the card's context menu.</p><h3>Managing card templates</h3><p>When you create a new card, Trilium offers four templates by default: <em>Text</em>, <em>Markdown</em>, <em>Canvas</em>, and <em>Spreadsheet</em>. You can customize this list to include other note types or custom templates with predefined placeholder content and prefilled card attributes.</p><p>To customize the card templates, go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em> and find <em>Card templates</em>. Here you can:</p><ul><li>Include a note type or note template already created in your knowledge base by pressing the&nbsp;<span class=\"tn-icon bx bx-list-plus\"></span> <em>Add existing template</em> button and then selecting the desired note type or template.</li><li>Create a new template by pressing the&nbsp;<span class=\"tn-icon bx bx-plus\"></span> <em>Create a new template</em> button. The template editor will open, where you can define the icon, title, default attribute values, and default content. The note template will be created as a child of the board collection.</li><li>Press the&nbsp;<span class=\"tn-icon bx bx-x\"></span> button to remove a template from the list. The template is removed only from the list, not deleted from your knowledge base. You can add it again using&nbsp;<span class=\"tn-icon bx bx-list-plus\"></span> <em>Add existing template</em>.</li><li>Press the&nbsp;<span class=\"tn-icon bx bx-dots-vertical-rounded\"></span> button to open a dropdown that lets you edit, open in a new window, duplicate, or delete a template. This button is visible only for custom note templates.</li><li>Hold the <strong>=</strong> handle shown beside a template, and then drag the item up or down to reorder the templates. This determines the order in which templates are listed in the template dropdown when you create a new card. You can move the most frequently used templates to the top for faster access.</li></ul><h3>Grouping cards</h3><p>On a board, cards are grouped into columns. The column to which a card belongs is determined by the value of the <strong>grouping attribute</strong>, which is a regular attribute of the card's note.</p><p>By default, boards use the <strong>Status</strong> attribute as the grouping attribute. When you move a card to a column called “Waiting on Customer”, the card's Status attribute is set to “Waiting on Customer”.</p><aside class=\"admonition note\"><p>Under the hood, the Status attribute is declared on the board collection note with the name <code>status</code>. It is a select-type attribute that is inheritable and promoted. Each select option becomes a column, and each new column created on the board extends the list of options.</p></aside><h4>Creating a new grouping attribute</h4><p>To quickly create a new grouping attribute:</p><ol><li>Open the&nbsp;<span class=\"tn-icon bx bx-category-alt\"></span> <em>Group by</em> dropdown in the board header and select&nbsp;<span class=\"tn-icon bx bx-plus\"></span> <em>Create a new attribute</em>.</li><li>Fill in the <em>Name</em> field. This is used internally by Trilium, so do not use spaces or special characters.</li><li>Enter the <em>Display name</em>. This is the attribute name shown in the dropdown list.</li><li>Press <em>Save &amp; close</em>.</li></ol><aside class=\"admonition tip\"><p>Because the grouping attribute is a regular card attribute, you can also create it in <em>Board properties</em>. Make sure you set the attribute type to “select”.</p></aside><h4>Switching the grouping attribute</h4><p>Switching the grouping attribute lets you view your cards by priority, category, or any other custom grouping attribute. You can switch the grouping attribute at any time by using the&nbsp;<span class=\"tn-icon bx bx-category-alt\"></span> <em>Group by</em> dropdown in the board header. You can also change it using the <code>#board:groupBy=&lt;_attribute name_&gt;</code> label.</p><aside class=\"admonition warning\"><p>The order of cards in manually sorted columns corresponds to their positions within the board collection subtree. This means that the card order is shared across all views, regardless of the grouping attribute. Reordering notes in one view will also reorder them in other views that use a different grouping attribute.</p></aside><h4>Deleting a grouping attribute</h4><p>To delete a grouping attribute, go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em>, find the attribute under the <em>Card attributes</em> section, and press the corresponding&nbsp;<span class=\"tn-icon bx bx-trash\"></span> button.</p><h4>Grouping by relations</h4><p>A more advanced use case is grouping by <a href=\"#root/_help_Cq5X6iKQop6R\">Relations</a>.</p><p>In this mode:</p><ul><li>The columns represent the <em>target notes</em> of a relation.</li><li>When creating a new column, you select a note instead of entering a column name.</li><li>The column icon matches the target note.</li><li>Moving notes between columns changes their relations.</li><li>Renaming an existing column changes the target note for all notes in that column.</li></ul><p>Using relations instead of labels has several benefits:</p><ul><li>The status or grouping of notes is visible outside the Kanban board, for example, on the&nbsp;<a class=\"reference-link\" href=\"#root/_help_bdUJEHsAPYQR\">Note Map</a>.</li><li>A column takes its title and icon from the target note, so renaming that note anywhere in the tree renames the column.</li></ul><p>To use relations for grouping:</p><ol><li><p>Create a Kanban board from scratch rather than from a template.</p></li><li><p>Assign <code>#viewType=board #hidePromotedAttributes</code> to emulate the default template.</p></li><li><p>Set <code>#board:groupBy</code> to the name of a relation, <strong>including the</strong> <code>~</code> <strong>prefix</strong> (for example, <code>~status</code>).</p></li><li><p>Optionally, use&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>&nbsp;to make changing the status within the note easier:</p><pre><code class=\"language-text-x-trilium-auto\">#relation:status(inheritable)=\"promoted,alias=Status,single\"</code></pre></li></ol><h2>Searching and filtering the board</h2><p>You can search for cards using the search box at the top of the board. Enter your keywords, and then press the&nbsp;<span class=\"tn-icon bx bx-search\"></span> button in the search field or press <kbd>Enter</kbd>. Only cards whose titles, content, or attribute values match the query will be displayed. Columns without results will be temporarily collapsed to make room for the matching cards. Press the&nbsp;<span class=\"tn-icon bx bx-x\"></span> button in the search field to clear the search and display all cards again.</p><h3>Advanced filtering</h3><p>If you need to refine the view to display only cards matching specific criteria beyond a regular text search, you can use Trilium's search query syntax. Here are some example queries:</p><p>Display only cards whose <strong>Priority</strong> attribute is set to “Low”:</p><pre><code class=\"language-text-x-trilium-auto\">#priority=Low</code></pre><p>Display only cards whose <strong>Issue Category</strong> is set to “Software” and whose <strong>Site</strong> is set to either “Office” or “Factory”:</p><pre><code class=\"language-text-x-trilium-auto\">#issueCategory=\"Software\" AND (#site=\"Office\" OR #site=\"Factory\")</code></pre><p>Display only cards with a <strong>Due Date</strong> in the next seven days that are not yet marked as <strong>Done</strong>:</p><pre><code class=\"language-text-x-trilium-auto\">#dueDate &gt;= TODAY AND #dueDate &lt;= TODAY+7 AND #!done</code></pre><p>The filter persists even after you close the tab. When you reopen the collection, the filter remains active until you clear the search query by using the&nbsp;<span class=\"tn-icon bx bx-x\"></span> button.</p><h2>Linking to a column or a card</h2><p>You can create a link that opens the board and points out a specific column or card. Open the column menu or the card’s context menu, select&nbsp;<span class=\"tn-icon bx bx-copy\"></span> <em>Copy reference</em>, and then paste the link where you need it.</p><p>In a text note, the pasted link displays the title, icon, and color of the column or card it points to. In a Markdown or code note, the plain link address is pasted instead. Opening the link scrolls the board to the column or card and focuses it. If the column belongs to a different grouping attribute, the board switches to that attribute first.</p><h2>Read-only boards</h2><p>A board marked as <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a> only shows its cards. It has no buttons to add a card or a column, column and card titles can't be renamed, and column icons can't be changed. Cards and columns can't be dragged, moved or deleted with the keyboard, and notes dragged in from the note tree aren't added. The context menus of a card or a column keep only the entries that change nothing, such as opening the note or <span class=\"tn-icon bx bx-copy\"></span> <em>Copy reference</em>, and the board's own menu doesn't open. The cards can still be grouped by another attribute, but the choice isn't saved, and no new grouping attribute can be created.</p>",
+ "_help_81SGnPGMk7Xc": "<figure class=\"image\"><img style=\"aspect-ratio:1561/1149;\" src=\"{{helpAssets}}/User%20Guide/Collections/Geo%20Map_image.png\" width=\"1561\" height=\"1149\"></figure><p>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.</p><h2>Features</h2><ul><li>Add markers on the map, which can be customized with icons, colors and text.</li><li>Search the notes already on the map, and look up places anywhere in the world.</li><li>Turn a place the map already shows into a marker by clicking it.</li><li>Draw paths, areas, rectangles and circles onto the map.</li><li>Display tracks on the map using <code>.gpx</code> files.</li><li>Show your own location on the map and follow it as you move.</li><li>3D view of the map, which displays buildings when using a vector map.</li></ul><h2>System requirements</h2><p>Starting with v0.105.0, the geomap uses MapLibre GL which requires WebGL v1 support. In general, most devices will support it because browsers/Electron can render it in software if needed.</p><p>If the map could not be drawn because WebGL could not be initialized, an error message will appear instead of the map (<em>This map can't be drawn because WebGL isn't available…</em>).</p><p>The button that shows your location is offered only when Trilium is reached over HTTPS, in the desktop application or in the mobile application. Browsers refuse to share the location of a device with a page served over plain HTTP, so on such a server the button does not appear.</p><h2>Interaction</h2><ul><li>At the top-left there is the search bar. It searches the notes already on the map, and it can also search for places online when you ask it to. While you move through the results of a search, a counter with previous (<span class=\"tn-icon bx bx-chevron-left\"></span>) and next (<span class=\"tn-icon bx bx-chevron-right\"></span>) buttons appears under it.</li><li>At the bottom-center there is a central toolbar which provides editing features: adding new markers on the map (<span class=\"tn-icon bx bx-pin\"></span>) and importing GPX tracks (<span class=\"tn-icon bx bx-trip\"></span>).</li><li>At the bottom-right there are the viewport items:<ul><li>Zoom in/out (<span class=\"tn-icon bx bx-plus-circle\"></span> / <span class=\"tn-icon bx bx-minus-circle\"></span>)<ul><li>On mobile these are hidden, use pinch to zoom instead.</li><li>On desktop, alternatively use the scroll wheel to adjust the zoom.</li></ul></li><li>A <span class=\"tn-icon bx bx-current-location\"></span> button that shows your location on the map and follows it (see <em>Going to your location</em> below).</li><li><span class=\"tn-icon bx bx-fullscreen\"></span> Full screen button which focuses the entire map onto the screen, while still allowing for edits.</li></ul></li><li>At the top-center (on desktop, or left-center on mobile and in split views) there are the drawing tools such as paths, areas, rectangles and circles.<ul><li>When the map is read-only, the toolbar is not shown.</li></ul></li></ul><h2>Creating a new geo map</h2><p>Right click on an existing note in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;and select <em>Insert child note</em> → <em>Collection</em> → <em>Geo Map</em>.</p><p>By default the map will be empty and will show the entire world.</p><h2>Repositioning the map</h2><ul><li>Click and drag the map in order to move across the map.</li><li>Use the mouse wheel, two-finger gesture on a touchpad or the +/- buttons on the bottom-right to adjust the zoom.</li></ul><p>The position on the map and the zoom are saved inside the map note and restored when visiting again the note.</p><p>A map that has no position saved yet is framed around the markers it contains when you open it, so they are all in view without having to go looking for them. A map that contains no markers shows the whole world instead.</p><p>In practice this applies to maps whose markers were added externally, by a script or through&nbsp;<a class=\"reference-link\" href=\"#root/_help_pgxEVkzLl1OP\">ETAPI (REST API)</a>. When you add markers yourself you have already moved the map to reach the place you are marking, and that movement saves a position.</p><h2>Going to your location</h2><p>Press the <em>Show your location</em> (<span class=\"tn-icon bx bx-current-location\"></span>) button at the bottom-right of the map, beside the zoom buttons. The first time, the browser or the operating system asks whether Trilium may know where the device is. In the desktop application the operating system's location settings decide.</p><p>The map then moves to where the device is and marks it with a blue dot. A lighter circle around the dot shows how accurate the position is: a phone with GPS gives a dot on the street, while a computer located through its network connection can give a circle that covers a neighbourhood. The map follows the dot as it moves, and the button stays pressed while it does.</p><p>Dragging the map stops it from following. The dot stays and keeps moving, and pressing the button again brings the map back to it. Pressing the button while the map is following turns the dot off.</p><p>Click the dot to see its coordinates in the panel a searched place is shown in. From there the position can be kept as a marker (see <em>Keeping a place as a marker</em>). Clicking the lighter circle around the dot is a click on the map.</p><p>If the position cannot be found, a message says so and the button keeps waiting for one; press it again to stop. If you refuse the permission, the button is disabled until the map is opened again. To allow it after all, change the permission for Trilium in the browser or in the system's location settings.</p><p>Your position is not stored in the note, and Trilium does not send it anywhere on its own. Moving the map there does what any other pan or zoom does: the tile provider behind the map's style sees the coordinates of the area now on screen. The map does remember where you left it, as it does after any other movement, so a map you have taken to your location opens there the next time.</p><h2>Searching the map</h2><p>The search bar at the top-left of the map searches in two places. It always searches the notes that are already on the map. It can also search for places online, but only when you ask it to.</p><h3>Searching the notes already on the map</h3><p>Type in the search bar, and the notes on the map are matched by their title as you type. Accents are ignored, both in what you type and in the titles, so <code>zurich</code> finds <em>Zürich Hauptbahnhof</em>. Each word is searched for on its own, so <code>hotel paris</code> finds <em>Paris Hotel</em>. Notes without a <code>#geolocation</code> attribute are not offered, since there would be nowhere to go. Drawn shapes and GPS tracks are offered, even though they carry no such attribute: selecting one brings the whole shape or route into view.</p><p>If more notes match than the list can show, you are offered the ones closest to the area you are viewing.</p><h3>Searching for places online</h3><p>Looking up a place sends what you typed to a third-party service. For this reason, it never happens while you type. Instead, the last row of the result list offers the search. That row reads <em>Search online for \"…\"</em>, with the name of the service below it. The search runs only when you press that row or select it with Enter.</p><p>Trilium uses Nominatim, the place search run by the OpenStreetMap Foundation. It needs no account and no API key. Its name is shown on every row that belongs to it: the row that offers the search, the row that says a search is running, and the row that reports that nothing was found or that the service could not be reached.</p><p>The search prefers the area you are viewing. Places inside the current view are searched for first and listed above the others. If you search for a shop while looking at your own town, you therefore find the branch in that town, and not one with the same name on another continent. The view is always treated as at least 25 km across, so a search made while zoomed into a single street still covers the town around it.</p><h3>Going to a point</h3><p>If you type or paste coordinates into the search bar, a <em>Go to</em> row is offered above all the other results. Selecting it moves the map to that exact spot and marks it. You can then keep it as a marker, in the same way you keep a place found by searching.</p><p>Points are untitled by default; the corresponding note opens with the default name selected so it can be easily replaced. If the map has a&nbsp;<a class=\"reference-link\" href=\"#root/_help_47ZrP6FNuoG8\">Default Note Title</a>&nbsp;label, the marker is named by that template instead.</p><p>The supported forms are:</p><ul><li>A plain pair, such as <code>45.9432, 24.9668</code>. This is what Google Maps and OpenStreetMap both give you when you ask for the coordinates of a place, and it is also what the <code>#geolocation</code> attribute holds.</li><li>The <code>geo:</code> link that the map itself offers for a place, through the <em>Open location</em> action.</li><li>The address of a place on Google Maps or OpenStreetMap, pasted whole.</li></ul><p>A pair that is not a place on Earth, such as <code>1234, 5678</code>, is not offered.</p><h3>Reading the results</h3><p>Results are gathered under headings, and each group is ordered by distance from the middle of the map:</p><ul><li><em>On this map</em>: notes that are already on the map, whatever their distance.</li><li><em>Nearby</em>: places found within about 25 km of the view.</li><li><em>Far away</em>: all the other places.</li></ul><p>The headings only appear when at least two of the three groups contain something. Every row that has a position shows how far away it is, in kilometres or miles according to your locale. A place found online shows its name on the first line and its address on the second.</p><h3>Selecting a result</h3><p>Selecting a note already on the map moves to its marker and opens the note beside the map, as clicking the marker would.</p><p>Selecting a place found online moves the map to it and marks it with a temporary pin. The pin has a different color from the map's own markers. The map is fitted to the area that the place covers, so a country fills the view, while a house is shown at street level. Some places have a boundary, such as a country, a county or a park. When the service reports one, that boundary is outlined under the pin.</p><p>A panel then opens with the place's full address and its coordinates: in the top-right corner on desktop, and at the bottom of the map on mobile, where the top is kept for the search bar and the result counter. Pressing the coordinates copies them to the clipboard.</p><h3>Keeping a place as a marker</h3><p>Press <em>Add as marker</em> in that panel to keep the place. A child note is created under the map. It takes the name of the place, as well as the icon, which matches the kind of place it is. Its <code>#geolocation</code> attribute is already set. The note opens beside the map, so you can edit it straight away. The temporary pin disappears, because the place is now a marker like any other.</p><p>The button is not offered on a map that cannot be edited, where the panel can still be read.</p><p>Press the panel's close button, or the Escape key, to send the place away without keeping it. The pin goes with it.</p><h3>Stepping through the results</h3><p>Once you select a result, a counter appears under the search bar, with a previous (<span class=\"tn-icon bx bx-chevron-left\"></span>) and a next (<span class=\"tn-icon bx bx-chevron-right\"></span>) button. These buttons move through everything the search offered, in the order it was listed. You can therefore compare several results without opening the list again. Pressing the counter itself moves the map back to the current result, which is useful after you have moved the map away from it.</p><h3>The keyboard</h3><ul><li><kbd>Enter</kbd> runs the online search when its row is the one selected, and otherwise moves to the highlighted result. Pressed after a result has been taken, it brings the list back.</li><li><kbd>Escape</kbd> closes the result list, and closes the place panel.</li><li>Returning to the search bar reopens the list it was showing.</li><li>The <span class=\"tn-icon bx bx-x\"></span> button at the end of the bar empties it, which also takes a searched place, its pin and its panel off the map.</li></ul><h2>Adding a marker using the map</h2><h3>Adding a new note using the <em>Add marker</em> button</h3><ol><li><p>To create a marker, first navigate to the desired point on the map. Then press the <em>Add marker</em> (<span class=\"tn-icon bx bx-pin\"></span>) button at the center-bottom of the map.</p></li><li><p>Once pressed, the map will enter in the insert mode, as illustrated by the notification. Additionally, a preview of the marker will be shown at the cursor position.</p><p>Simply click the point on the map where to place the marker. To cancel, press either the &nbsp;Escape key or press again the <em>Add marker</em> button.</p></li><li><p>Once clicked, the marker will show up on the map and a popup will show to the right with the title already selected to be changed.</p></li></ol><h3>Adding a new note using the contextual menu</h3><ol><li>Right click anywhere on the map, where to place the newly created marker (and corresponding note).</li><li>Select <em>Add a marker at this location</em> (<span class=\"tn-icon bx bx-pin\"></span>).</li><li>Once clicked on a position on the map, the marker will show up on the map and a popup will show to the right with the title already selected to be changed.</li></ol><h3>Adding an existing note from the note tree</h3><ol><li>Select the desired note in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.</li><li>Hold the mouse on the note and drag it to the map to the desired location.</li><li>The map should be updated with the new marker.</li></ol><p>This works for:</p><ul><li>Notes that are not part of the geo map, case in which a <a href=\"#root/_help_IakOLONlIfGI\">clone</a> will be created.</li><li>Notes that are a child of the geo map but not yet positioned on the map.</li><li>Notes that are a child of the geo map and also positioned, case in which the marker will be relocated to the new position.</li></ul><aside class=\"admonition note\"><p>Dragging existing notes only works if the map is in editing mode. See the <em>Read-only</em> section for more information.</p></aside><h3>Adding a note from a place the map already shows</h3><p>When a vector map style is used, the map itself draws the shops, cafés, museums and other places around the area being viewed. Once the map is zoomed in far enough for these to be drawn, they can be clicked:</p><ol><li>Look for the places drawn in orange. This is the same color used for a place found by searching. These are the places you can click. They are drawn almost solid, while the other places on the map stay a faint grey.</li><li>Rest the mouse on one of them. Its name appears above it, and the mouse cursor changes to a pointer. The map draws these places as icons without names, so you read a name by hovering over it. If all the names were shown at once, they would crowd out the titles of your own markers.</li><li>Click it. The same panel used for a place found by searching appears. It shows the name of the place and its coordinates, and a pin is placed on the map.</li><li>Press <em>Add as marker</em> to keep it. The note is created with the name of the place as its title, and with the icon that matches the kind of place it is.</li></ol><p>Places are read from the map data that has already been downloaded, so clicking one does not send anything to the internet.</p><p>Some things to keep in mind:</p><ul><li>Places with no name in the map data, such as benches or parking spaces, show no name and cannot be clicked. Clicking them does nothing, just like clicking an empty part of the map.</li><li>The map's own markers come first. If a marker covers a place, clicking it opens the note and not the place.</li><li>This does not work with the raster (OpenStreetMap) style, because its places are part of the map image. It also does not work with the <em>Neutrino</em> style, which draws no places.</li><li>In read-only mode you can still click a place and read it, but you cannot keep it as a marker.</li></ul><h2>How the location of the markers is stored</h2><p>The location of a marker is stored in the <code>#geolocation</code> attribute of the child notes:</p><p>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.</p><p>On an image map, the position is stored in <code>#mapPosition</code> instead (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_ZRDXGc0nAIh4\">Image maps</a>).</p><h2>Repositioning markers</h2><p>Once a marker is set, it can be repositioned using one of the two ways:</p><ul><li>By right clicking the marker and selecting <em>Move to another location</em> (<span class=\"tn-icon bx bx-move\"></span>).</li><li>By clicking the marker to open the popup and selecting the <em>Move to another location</em> (<span class=\"tn-icon bx bx-move\"></span>) button underneath the title bar.</li></ul><p>After clicking the button to move the marker, click at the desired position on the map to replace it. To cancel the operation, press Escape.</p><aside class=\"admonition note\"><p>If the map is locked for editing (see below), the map needs to be unlocked before moving the marker.</p></aside><h2>Interaction with the markers, tracks or shapes</h2><ul><li>Hovering over a marker will display a&nbsp;<a class=\"reference-link\" href=\"#root/_help_lgKX7r3aL30x\">Note Tooltip</a>&nbsp;with the content of the note it belongs to.<ul><li>Clicking on the note title in the tooltip will navigate to the note in the current view.</li></ul></li><li>Right-clicking the marker will open a contextual menu (as described below).</li><li>Clicking a marker will focus on the marker and display a dedicated popup with the details. This works regardless of whether the map is editable or not.</li></ul><h3>Popup view</h3><p>When a marker, a <a href=\"#root/_help_C2H9HK4BzwG7\">shape</a>, or track is clicked, a popup will open to the right which contains the following information:</p><ul><li>The title and icon of the marker, both editable.</li><li>An indicator for the coordinates (<span class=\"tn-icon bx bx-crosshair\"></span>); clicking it will copy the coordinates to clipboard.</li><li>A <span class=\"tn-icon bx bx-expand-alt\"></span> button to maximize the popup.</li><li>Buttons to interact with the current item:<ul><li><span class=\"tn-icon bx bx-log-in\"></span> Open the marker in the same pane, or use <span class=\"tn-icon bx bx-dots-horizontal-rounded\"></span> to open it in a new tab, split, etc.</li><li>A <span class=\"tn-icon bx bx-map-alt\"></span> button to open the location in a dedicated application (e.g. Google Maps on mobile).</li><li><span class=\"tn-icon bx bx-palette\"></span> Color picker to change the color of the marker.</li><li><span class=\"tn-icon bx bx-move\"></span> Markers can also be moved, unlike tracks or shapes (which need to be redrawn).</li><li><span class=\"tn-icon bx bx-trash\"></span> Button to remove the marker from the map, which can optionally delete its corresponding note.<ul><li>Removing a marker without deleting the note will only remove its <code>#geolocation</code> attribute (case in which the coordinates have to be manually added back in in order to get the note to show on the map again).</li><li>Similarly, removing a shape will remove its <code>#geoShape</code> attribute.</li></ul></li></ul></li><li>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>&nbsp;of the marker, if any.</li><li>The note's content which can be edited directly from the panel.</li></ul><p>To dismiss the popup:</p><ul><li>Press the X button at the top-right of the popup.</li><li>In the map, press anywhere outside the popup.</li><li>Or simply press the Escape key.</li></ul><p>When a marker is clicked, the map will automatically adjust the viewport so that the marker is still visible with the popup open. The currently selected marker is shown slightly bigger.</p><p>It is possible to switch between markers by clicking on them even when the popup view is already open.</p><p>Markers can have&nbsp;<a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>&nbsp;between them and clicking on such a link will automatically adjust the viewport and the popup view to the new note.</p><h3>Contextual menu</h3><p>It's possible to press the right mouse button to display a contextual menu.</p><ol><li>If right-clicking an empty section of the map (not on a marker), it allows to:<ol><li><span class=\"tn-icon bx bx-crosshair\"></span> Displays the latitude and longitude. Clicking this option will copy them to the clipboard.</li><li><span class=\"tn-icon bx bx-map-alt\"></span> Open the location using an external application (if the operating system supports it).</li><li><span class=\"tn-icon bx bx-pin\"></span> Adding a new marker at that location.</li></ol></li><li>If right-clicking on a marker, it allows to:<ol><li><span class=\"tn-icon bx bx-crosshair\"></span> Displays the latitude and longitude. Clicking this option will copy them to the clipboard.</li><li><span class=\"tn-icon bx bx-map-alt\"></span> Open the location using an external application (if the operating system supports it).</li><li>Open the note in a new tab, split or window.</li><li><span class=\"tn-icon bx bx-move\"></span> Move the marker to another location.</li><li><span class=\"tn-icon bx bx-trash\"></span> Button to remove the marker from the map, which can optionally delete its corresponding note. Removing a marker without deleting the note will only remove its <code>#geolocation</code> attribute (case in which the coordinates have to be manually added back in in order to get the note to show on the map again).</li></ol></li><li>Shapes can also be right-clicked and the menu is similar to markers except they cannot be moved.</li></ol><h3>Icon and color</h3><figure class=\"image image-style-align-right image_resized\" style=\"width:47.42%;\"><img style=\"aspect-ratio:885/321;\" src=\"{{helpAssets}}/User%20Guide/Collections/3_Geo%20Map_image.png\" width=\"885\" height=\"321\"></figure><p>The markers will have the same icon as the note.</p><p>It's possible to add a custom color to a marker by assigning them a <code>#color</code> attribute such as <code>#color=green</code>.</p><p>This also applies to tracks and <a href=\"#root/_help_C2H9HK4BzwG7\">shapes</a>.</p><aside class=\"admonition note\"><p>The color as it will be displayed on the map might be slightly tinted in order to make the text or icon more legible.</p></aside><h3>Adding the coordinates manually</h3><p>Searching for the place is usually quicker (see <em>Searching the map</em> above). The steps below remain useful for a coordinate that is already to hand, or for a place the search cannot find.</p><p>In a nutshell, create a child note and set the <code>#geolocation</code> attribute to the coordinates.</p><p>The value of the attribute is made up of the latitude and longitude separated by a comma.</p><h4>Adding from Google Maps</h4><ol><li>In Google Maps, on the web:<ol><li>Look for a desired location, right click on it and a context menu will show up.</li><li>Simply click on the first item displaying the coordinates and they will be copied to clipboard.</li></ol></li><li>In Trilium, create a child note under the map.</li><li>Then paste the value inside the text box into the <code>#geolocation</code> attribute of a child note of the map (don't forget to surround the value with a <code>\"</code> character).</li></ol><h4>Adding from OpenStreetMap</h4><p>Similarly to the Google Maps approach:</p><ol><li>Go to any location on openstreetmap.org and right click to bring up the context menu. Select the <em>Show address</em> item.</li><li>The address will be visible in the top-left of the screen, in the place of the search bar.&nbsp;Select the coordinates and copy them into the clipboard.</li><li>Simply paste the value inside the text box into the <code>#geolocation</code> attribute of a child note of the map and then it should be displayed on the map.</li></ol><h2>Drawing shapes on the map</h2><p>See the dedicated&nbsp;<a class=\"reference-link\" href=\"#root/_help_C2H9HK4BzwG7\">Drawing shapes</a>&nbsp;page.</p><h2>Using an image instead of the world map</h2><p>A geo map can be drawn over an image of your own, such as a floor plan or a fantasy map, with markers placed in the image's pixels. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_ZRDXGc0nAIh4\">Image maps</a>.</p><h2>Adding GPS tracks (.gpx)</h2><figure class=\"image\"><img style=\"aspect-ratio:1566/1155;\" src=\"{{helpAssets}}/User%20Guide/Collections/1_Geo%20Map_image.png\" width=\"1566\" height=\"1155\"></figure><p>Trilium can display GPS tracks on the geo map, in the form of <code>.gpx</code> files.</p><p>To add a track, either:</p><ol><li>Drag &amp; drop a <code>.gpx</code> file inside the geo map in the note tree.<ol><li>In order for the file to be recognized as a GPS track, it needs to show up as <code>application/gpx+xml</code> in the <em>File type</em> field.</li></ol></li><li>Press the <em>Add a GPS track from a GPX file</em> (<span class=\"tn-icon bx bx-trip\"></span>) button which will directly prompt for a GPX file and import it as a subnote of the collection.</li></ol><p>When going back to the map, the track should now be visible.</p><p>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 <code>color</code> of the note. The end marker is displayed with a distinct icon.</p><p>If the track file contains multiple tracks, they will all be displayed as well as markers. Trilium will also split a single track that happens to have non-continuous points.</p><p>If the GPX contains waypoints, they will also be displayed, including their names.</p><p>When the track is clicked, the entire route is brought into view, as well as the right popup will indicate details about the track such as distance, duration and the elevation map. This information is also displayed when clicking the <code>.gpx</code> note itself.</p><p>When clicking on the markers of a track (whether it's the start or stop builtin markers, or custom markers that are part of the track), only that marker is brought into view, as opposed to the entire route.</p><h2>Read-only mode</h2><p>When a map is <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a> all editing features will be disabled such as:</p><ul><li>The <em>Add marker</em> (<span class=\"tn-icon bx bx-pin\"></span>) button at the bottom of the map.</li><li>Repositioning markers.</li><li>Editing from the contextual menu (removing locations or adding new items).</li><li>Keeping a place as a marker, whether you found it by searching or clicked it on the map. You can still search and click, and you can still look at a place and copy its coordinates.</li><li>Drawing <a href=\"#root/_help_C2H9HK4BzwG7\">shapes</a>.</li><li>The <em>Geo map properties</em> dialog; its entry is hidden from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>.</li></ul><p>To set a map as read-only, go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>&nbsp;→ <em>Editable</em> → <em>Read-only</em>.</p><h2>Configuration</h2><h3>Map Style</h3><p>The styling of the map can be adjusted in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>, under <em>Background</em> in the <em>Geo map properties</em> dialog, or manually via the <code>#map:style</code> attribute.</p><p>The geo map comes with two different types of styles:</p><ul><li>Raster styles<ul><li>For these styles the map is represented as a grid of images at different zoom levels. This is the traditional way OpenStreetMap used to work.</li><li>Zoom is slightly restricted.</li><li>Currently, the only raster theme is the original OpenStreetMap style.</li></ul></li><li>Vector styles<ul><li>Vector styles are not represented as images, but as geometrical shapes. This makes the rendering much smoother, especially when zooming and looking at the building edges, for example.</li><li>The map can be zoomed in much further.</li><li>These come in various styles that are both light (Colorful, Graybeard, Neutrino) and dark (Eclipse, Shadow).</li><li>The vector styles come from <a href=\"https://versatiles.org/\">VersaTiles</a>, a free and open-source project providing map tiles based on OpenStreetMap.</li><li>The VersaTiles layers also provide 3D building information (see below).</li></ul></li></ul><p>The default theme is Versatiles Colorful (vector).</p><h4>3D view with buildings</h4><figure class=\"image\"><img style=\"aspect-ratio:2727/1642;\" src=\"{{helpAssets}}/User%20Guide/Collections/2_Geo%20Map_image.png\" width=\"2727\" height=\"1642\"></figure><p>Trilium v0.105.0 introduces a 3D view, courtesy of MapLibre GL. To enter 3D mode, simply press the <em>3D</em> button at the bottom-right of the map or press Ctrl and drag across the map.</p><p>The buildings will only appear from zoom 14 onwards to avoid lag.</p><aside class=\"admonition note\"><p>To get 3D buildings, make sure you are using the <em>VersaTiles</em> styles which provide the building informatia via the <code>versatiles-shortbread</code> source.</p></aside><h3>Custom map style / tiles</h3><p>Starting with v0.102.0 it is possible to use custom tile sets, but only in raster format.</p><p>To use one:</p><ol><li>Open the <em>Geo map properties</em> dialog from the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>.</li><li>Under <em>Background</em>, set <em>Type</em> to <em>Custom tileset</em>.</li><li>In <em>Tile URL</em>, enter the address of the tile set, with <code>{z}</code>, <code>{x}</code> and <code>{y}</code> where the zoom level and the position of the tile go. For example, to use Esri.NatGeoWorldMap, enter <a href=\"https://server.arcgisonline.com/ArcGIS/rest/services/NatGeo_World_Map/MapServer/tile/%7Bz%7D/%7By%7D/%7Bx%7D\"><code>https://server.arcgisonline.com/ArcGIS/rest/services/NatGeo_World_Map/MapServer/tile/{z}/{y}/{x}</code></a>. The URL is saved once you leave the field; a URL that doesn't start with <code>http://</code> or <code>https://</code>, or that lacks one of the three placeholders, is not saved. A map drawn over an image keeps its image until a URL is saved.</li><li>If the tiles are dark, turn on <em>Dark tileset</em>, which draws the marker titles in a light color so that they remain readable.</li></ol><p>Additionally:</p><ul><li>Hi-DPI tiles are supported via the <code>{r}</code> placeholder.</li><li>Servers that number their tiles by quadkey are supported via the <code>{quadkey}</code> placeholder, in place of <code>{z}</code>, <code>{x}</code> and <code>{y}</code>.</li></ul><p>To go back to a built-in style, set <em>Type</em> back to <em>Vector &amp; Raster</em>. The tile set is switched off rather than removed: its label is renamed to <code>#disabled:map:style</code>, so setting <em>Type</em> to <em>Custom tileset</em> again brings back the same URL. A tile set inherited from a parent note or a template is overridden by the default style instead.</p><p>The tile set can also be set manually: the URL goes in the <code>#map:style</code> <a href=\"#root/_help_HI6GBBIduIgv\">label</a>, and the <code>#map:darkStyle</code> label marks it as dark. <code>#map:darkStyle</code> also overrides the built-in styles.</p><aside class=\"admonition note\"><p>For a list of tile sets, see the <a href=\"https://leaflet-extras.github.io/leaflet-providers/preview/\">Leaflet Providers preview</a> page. Select a desired tile set and just copy the URL from the <em>Plain JavaScript</em> example.</p></aside><p>Custom vector map support is planned, but not yet implemented.</p><h3>Other options</h3><p>The following options can be configured either via the&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>, by clicking on the settings (<span class=\"tn-icon bx bx-cog\"></span>) button. Alternatively, each of these options also have a corresponding <a href=\"#root/_help_HI6GBBIduIgv\">label</a> that can be set manually.</p><ul><li>Scale, which illustrates the scale of the map in either kilometers or miles in the bottom-left of the map.<ul><li>The unit is determined by the <em>Formatting locale</em> option in <em>Language &amp; Region</em>.</li></ul></li><li>The name of the markers is displayed by default underneath the pin on the map. Since v0.102.0, it is possible to hide these labels which increases the performance and decreases clutter when there are many markers on the map.</li><li>v0.105.0 also introduces a feature called <em>Group nearby markers</em> which will cluster multiple markers together at low zoom.<ul><li>The clusters display the number of items they contain. The color also changes based on the count.</li><li>Clicking on a cluster will automatically zoom in so that the individual markers that make up the cluster are now visible.</li></ul></li></ul><p>The same options are also listed under <em>General</em> in the <span class=\"tn-icon bx bx-cog\"></span><em>Geo map properties</em> dialog, opened from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> or from the settings menu of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>. Its <em>Included notes</em> section sets whether archived notes are shown and the <em>Maximum nesting depth</em> (see below), and its <em>Background</em> section holds the map style, the URL of a custom tile set when <em>Type</em> is set to <em>Custom tileset</em> (see above), or, with <em>Type</em> set to <em>Custom image</em>, draws the map over an image of your own instead, as described in&nbsp;<a class=\"reference-link\" href=\"#root/_help_ZRDXGc0nAIh4\">Image maps</a>.</p><p>The map shows the notes of its whole subtree, not only its children. <em>Maximum nesting depth</em> (<code>#maxNestingDepth</code>) limits how deep below the map it looks: <code>0</code> shows only the children, <code>1</code> adds their children, and so on. Without a value, every level is shown.</p>",
+ "_help_C2H9HK4BzwG7": "<p>The following shapes can be drawn on the map: a path, an area, a rectangle or a circle.</p><p>Unlike markers, the title of the shape is not displayed directly on the map but it will be displayed when hovered.</p><p>The shape will also be drawn in the <a href=\"#root/_help_p9kXRFAkwN4o\">color of the note</a>, if set.&nbsp;</p><h2>Drawing a shape on the map</h2><p>To draw a shape, use the toolbar that appears in the top-center area on desktop and on the left-center on mobile and in split view.</p><p>Once a shape is drawn, it cannot be moved or modified. To do so, simply remove the shape and draw another one instead.</p><h3>Drawing a path or an area</h3><ol><li>Press the <em>Draw a path on the map</em> (<span class=\"tn-icon bx bx-vector\"></span>) or <em>Draw an area on the map</em> (<span class=\"tn-icon bx bx-shape-polygon\"></span>) button. The button stays held down while the tool is armed, and a notification describes what to do.</li><li>Click on the map once for each point. The shape is previewed as it grows.</li><li>Finish it by pressing <kbd>Enter</kbd>. A path can also be finished by clicking its last point again, and an area by clicking the corner it started from. A path needs at least two points and an area at least three.</li></ol><h3>Drawing a rectangle or a circle</h3><ol><li>Press the <em>Draw a rectangle on the map</em> (<span class=\"tn-icon bx bx-shape-square\"></span>) or <em>Draw a circle on the map</em> (<span class=\"tn-icon bx bx-shape-circle\"></span>) button.</li><li>Click once to set the first corner, or the center of the circle. Click a second time at the opposite corner, or at the distance the circle should reach.</li><li>Instead of two clicks you can drag from one to the other. This also works on mobile and other touch-based apps.</li></ol><h3>Finishing and cancelling</h3><p>To give up on a shape while drawing it, press <kbd>Escape</kbd> or press the tool's button again. Whatever has been drawn so far is discarded.</p><p>The tool is deactivated once a shape is finished, so drawing a second shape requires another button press.</p><h2>Interaction</h2><p>Once a shape is created:</p><ul><li>Clicking a shape opens the standard panel which allows changing the title, the content and with buttons to open the note or remove it.<ul><li>When clicking, a marker takes priority over the shape.</li></ul></li><li>Right-clicking a shape opens a contextual menu similar to the one for markers, which allows opening the corresponding note or removing the shape.</li><li>Typing in the map's search bar finds shapes by their title, as it does markers. Selecting one brings the whole shape into view.</li></ul><h2>How shapes are represented</h2><p>Shapes are represented quite similarly to markers, which means each shape is a note. The information about the same is stored using a <a href=\"#root/_help_HI6GBBIduIgv\">label</a> called <code>geoShape</code>.</p>",
+ "_help_ZRDXGc0nAIh4": "<p>An image map is a geo map drawn over an image of your own instead of a world map, such as a floor plan, a fantasy map for a tabletop game, or a diagram to annotate. Markers and shapes work as they do on a geo map, but their positions are measured on the image instead of in latitude and longitude: in the image's own pixels, or in a coordinate system of your choosing, such as the one a video game uses.</p><h2>Creating an image map</h2><ol><li>Upload the image as a note of its own, for example by dragging the file into the note tree. PNG, JPEG, WebP and GIF images are supported; SVG images are not.</li><li>Create a geo map, or open an existing one.</li><li>Open the <span class=\"tn-icon bx bx-cog\"></span><em>Geo map properties</em> dialog from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> or from the settings menu of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>.</li><li>Under <em>Background</em>, set <em>Type</em> to <em>Custom image</em>, then choose the image note in <em>Image note</em>. The list only offers image notes in a format the map can draw (PNG, JPEG, WebP or GIF), and shows all of them before anything is typed.</li></ol><p>The map then shows the image instead of the world map and opens with the whole image in view. To go back to a world map, set <em>Type</em> back to <em>Vector &amp; Raster</em>. The image is switched off rather than removed: its relation is renamed to <code>~disabled:map:image</code>, so setting <em>Type</em> to <em>Custom image</em> again brings back the same image, with its coordinates. An image that the geo map inherits from a parent note or a template can only be switched off on the note that holds it.</p><p>The image note is stored in a <code>~map:image</code> <a href=\"#root/_help_Cq5X6iKQop6R\">relation</a> of the geo map, which can also be added by hand.</p><h2>Image size</h2><p>Images are resized when they are uploaded, so by default the image of a map is at most 2000 pixels on its longer side, which can be too coarse for a detailed map. To keep an image at a higher resolution, do one of the following before uploading it:</p><ul><li>In <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Media</em>, raise <em>Max image dimensions</em> or turn off <em>Automatically compress images</em>.</li><li>Upload it through the <em>Import</em> dialog with <em>Compress images</em> unchecked.</li></ul><p>An image that was already uploaded keeps its size; upload it again after changing the settings.</p><p>The image is drawn as a single picture by the graphics card, which limits how large it can be. Images up to 4096 pixels on their longer side are safe on practically every device, and most computers handle up to 16384 pixels. On a device whose graphics card cannot hold the image, the markers and shapes still appear but the image itself does not. The <em>Geo map properties</em> dialog warns about an image larger than 4096 pixels, and about one that can't be used at all, such as an SVG image.</p><h2>Interaction</h2><p>Adding, moving and removing markers, drawing shapes, the popup view and the contextual menu work as described for the&nbsp;<a class=\"reference-link\" href=\"#root/_help_81SGnPGMk7Xc\">Geo Map</a>. The camera stays over the image and can zoom in up to four times past the image's own resolution.</p><p>The features that only make sense on a real map are not available on an image map:</p><ul><li>Searching the map and searching for places online.</li><li>Going to your location.</li><li>Adding GPS tracks.</li><li>Clicking the places the base map shows.</li><li>The 3D buildings.</li><li>Opening a location in an external map application.</li></ul><p>The look of the marker titles follows the image: if the image is dark, turn on <em>Dark image</em> under <em>Background</em> in the <em>Geo map properties</em> dialog, so that the titles are drawn in a light color. This sets the <code>#map:darkStyle</code> label.</p><p>The <em>Map style</em> setting doesn't apply to an image map, so it's hidden from the settings menu of the collection while the map has an image.</p><h2>Choosing the coordinate system</h2><p>By default, positions are measured in pixels of the image at its original size, from its top-left corner, with <code>x</code> growing to the right and <code>y</code> growing downwards.</p><p>To use coordinates of your own instead, open the <em>Geo map properties</em> dialog, set <em>Coordinates</em> under <em>Background</em> to <em>Custom</em>, and enter the coordinates of the image's <em>Top-left corner</em> and <em>Bottom-right corner</em>. Switching to <em>Custom</em> starts from the image's size in pixels, so the markers stay where they are until the corners are changed; for that reason, <em>Custom</em> can only be chosen once the image has loaded. All positions are then read and written in those coordinates, including the ones shown in the contextual menu and in the popup view. To go back to pixels, set <em>Coordinates</em> to <em>Image pixels</em>. Corners that the geo map inherits from a parent note or a template can only be removed on the note that holds them; entering other corners on this map overrides them.</p><p>The corners are stored in the <code>#map:imageBounds</code> label of the geo map as <code>x,y x,y</code>, with a space between the two corners, which can also be set by hand. For example:</p><ul><li>A screenshot of a game map that covers <code>x</code> from -512 to 512 and <code>y</code> from -512 to 512, with <code>y</code> growing downwards: <code>#map:imageBounds=-512,-512 512,512</code>. Coordinates copied from the game can then be pasted directly into <code>#mapPosition</code>.</li><li>A world whose <code>y</code> grows upwards, with the origin in the middle of the image: <code>#map:imageBounds=-2000,1000 2000,-1000</code>. A top-left <code>y</code> larger than the bottom-right one is what flips the axis.</li><li>A floor plan measured in meters: <code>#map:imageBounds=0,0 24,12</code>.</li></ul><p>The two axes don't have to use the same scale. A circle is always measured in the map's own units, so it appears as an ellipse when the units are stretched differently along the two axes.</p><p>Corners that share an <code>x</code> or a <code>y</code> don't span an area: the dialog doesn't save them, and a label holding them, or a value that cannot be read, is ignored and the pixels of the image are used instead.</p><h2>Coordinate rulers</h2><p>Enabling <em>Show scale</em> in the collection properties draws rulers along the edges of the image instead of a distance scale. Round values of the map's coordinates are marked with ticks along all four edges, labeled along the top and left ones, with faint grid lines across the image. The spacing follows the zoom level, and the values follow <code>#map:imageBounds</code> when it is set.</p><p>The rulers are drawn on the image itself, so they move out of view along with its edges when zooming in. The grid lines remain visible across the image.</p><h2>How the positions are stored</h2><p>Because positions are stored in different labels from the ones of a geo map, the same note can be placed both on a geo map and on an image map.</p><figure class=\"table\"><table><thead><tr><th>Label</th><th>Content</th></tr></thead><tbody><tr><td><code>#mapPosition</code></td><td>The position of a marker, as <code>x,y</code>, for example <code>#mapPosition=320,145</code>.</td></tr><tr><td><code>#mapShape</code></td><td>A shape, in the same format as <code>#geoShape</code> (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_C2H9HK4BzwG7\">Drawing shapes</a>) but with <code>x,y</code> pairs, and a circle's radius in the map's units, for example <code>#mapShape=circle:400,300 50</code>.</td></tr></tbody></table></figure><p>The positions belong to the coordinate system, not to the image. When replacing the image with a different one, for example a higher-resolution copy, keep <code>#map:imageBounds</code> describing the area the new image covers and every marker stays in place. With <em>Image pixels</em>, the positions are pixels, so an image of a different size moves the markers relative to what the image shows; to avoid that, switch <em>Coordinates</em> to <em>Custom</em> before replacing the image, which keeps the size of the old one (<code>0,0 &lt;width&gt;,&lt;height&gt;</code>) as the corners.</p><aside class=\"admonition tip\"><p>To draw freely over an image instead of placing notes on it, consider a&nbsp;<a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a>.</p></aside>",
+ "_help_zP3PMqaG71Ct": "<figure class=\"image\"><img style=\"aspect-ratio:1120/763;\" src=\"{{helpAssets}}/User%20Guide/Collections/Presentation_image.png\" width=\"1120\" height=\"763\"></figure><p>The Presentation view allows the creation of slideshows directly from within Trilium.</p><h3>Creating a new presentation</h3><p>Right click on an existing note in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;and select <em>Insert child note</em> → <em>Collection</em> → <em>Presentation</em>.</p><h2>How it works</h2><ul><li>Each slide is a child note of the collection.</li><li>The order of the child notes determines the order of the slides.</li><li>Unlike traditional presentation software, slides can be laid out both horizontally and vertically (see below for more information).</li><li>Direct children will be laid out horizontally and the children of those will be laid out vertically. Children deeper than two levels of nesting are ignored.</li></ul><h2>Interaction and navigation</h2><p>In the floating toolbar (top-right):</p><ul><li><span class=\"tn-icon bx bx-edit\"></span> <em>Edit this slide</em> button to go to the corresponding note of the current slide. A <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a> presentation doesn't show it.</li><li>Press the <span class=\"tn-icon bx bx-grid-horizontal\"></span> Overview button (or the <kbd>O</kbd> key) to show a birds-eye view of the slides. Press the button again to disable it.</li><li>Press the <span class=\"tn-icon bx bx-fullscreen\"></span> “Start presentation” button to show the presentation in full-screen.</li></ul><p>The following keyboard shortcuts are supported:</p><ul><li>Press <kbd>←</kbd> and <kbd>→</kbd> (or <kbd>H</kbd> and <kbd>L</kbd>) to go to the slide on the left or on the right (horizontal).</li><li>Press <kbd>↑</kbd> and <kbd>↓</kbd> &nbsp;(or <kbd>K</kbd> and <kbd>J</kbd>) to go to the upward or downward slide (vertical).</li><li>Press <kbd>Space</kbd> and <kbd>Shift</kbd> + <kbd>Space</kbd> or &nbsp;to go to the next/previous slide in order.</li><li>And a few more, press <kbd>?</kbd> to display a popup with all the supported keyboard combinations.</li></ul><h2>Vertical slides and nesting</h2><p>Unlike traditional presentation software such as Microsoft PowerPoint, the slides in Trilium can be laid out horizontally or vertically in order to create depth or better organize the slides by topic.</p><p>This horizontal/vertical organization affects transitions (especially on the “slide” transition), however it is most noticeable in navigation.</p><ul><li>Pressing <kbd>←</kbd> and <kbd>→</kbd> will navigate through slides horizontally, thus skipping vertical notes under the current slide. This is useful to skip entire chapters/related slides.</li><li>Pressing <kbd>↑</kbd> and <kbd>↓</kbd> will navigate through the vertical slides at the current level.</li><li>Pressing <kbd>Space</kbd> and <kbd>Shift</kbd> + <kbd>Space</kbd> will go to the next/previous slide in order, regardless of the direction. This is generally the key combination to use when presenting.</li><li>The arrows on the bottom-right of the slide will also reflect this navigation scheme.</li></ul><figure class=\"image image-style-align-right image_resized\" style=\"width:55.57%;\"><img style=\"aspect-ratio:890/569;\" src=\"{{helpAssets}}/User%20Guide/Collections/1_Presentation_image.png\" width=\"890\" height=\"569\"></figure><p>All direct children of the collection will be laid out horizontally. If a direct child also has children, those children will be placed as vertical slides.</p><p>In the following example, the note structure is as follows:</p><ul><li>Presentation collection<ul><li>Trilium Notes (demo page)</li><li>“Introduction” slide<ul><li>“The challenge of personal knowledge management”</li><li>“Note-taking structures”</li></ul></li><li>“Demo &amp; Feature highlights” slide<ul><li>“Really fast installation process”</li><li>Video slide</li></ul></li></ul></li></ul><h2>Customization</h2><p>At collection level, it's possible to adjust:</p><ul><li>The theme of the entire presentation to one of the predefined themes by going to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>&nbsp;and looking for the <em>Theme</em> option.</li><li>It's currently not possible to create custom themes, although it is planned.</li><li>Note that it is note possible to alter the CSS via&nbsp;<a class=\"reference-link\" href=\"#root/_help_AlhDUqhENtH7\">Custom app-wide CSS</a>&nbsp;because the slides are rendered isolated (in a shadow DOM).</li></ul><p>At slide level:</p><ul><li>It's possible to adjust the background color of a slide by using the <a href=\"#root/_help_OFXdgB2nNk1F\">predefined promoted attribute</a> for the color or manually setting <code>#slide:background</code> to a hex color.</li><li>More complex backgrounds can be achieved via gradients. There's no UI for it; it has to be set via <code>#slide:background</code> to a CSS gradient definition such as: <code>linear-gradient(to bottom, #283b95, #17b2c3)</code>.</li></ul><h2>Tips and tricks</h2><ul><li>Text notes generally respect the formatting (bold, italic, foreground and background colors) and font size. Code blocks and tables also work.</li><li>Try using more than just text notes, the presentation uses the same mechanism as <a href=\"#root/_help_R9pX4DGra2Vt\">shared notes</a> and&nbsp;<a class=\"reference-link\" href=\"#root/_help_0ESUbbAxVnoK\">Note List</a>&nbsp;so it should be able to display&nbsp;<a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a>,&nbsp;<a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a>&nbsp;and&nbsp;<a class=\"reference-link\" href=\"#root/_help_gBbsAeiuUxI5\">Mind Map</a>&nbsp;in full-screen (without the interactivity).<ul><li><p>Consider using a transparent background for&nbsp;<a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a>, if the slides have a custom background (go to the hamburger menu in the Canvas, press the button select a custom color and write <code>transparent</code>).</p></li><li><p>For&nbsp;<a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a>, some of them have a predefined background which can be changed via the frontmatter. For example, for XY-charts:</p><pre><code class=\"language-text-x-trilium-auto\">---\nconfig:\n themeVariables:\n xyChart:\n backgroundColor: transparent\n---</code></pre></li></ul></li></ul><h2>Under the hood</h2><p>The Presentation view uses <a href=\"https://revealjs.com/\">Reveal.js</a> to handle the navigation and layout of the slides.</p>",
+ "_help_8QqnMzx393bx": "<figure class=\"image\"><img style=\"aspect-ratio:990/590;\" src=\"{{helpAssets}}/User%20Guide/Collections/Grid%20View_image.png\" width=\"990\" height=\"590\"></figure><p>This view presents the child notes in a grid format, allowing for a more visual navigation experience.</p><p>Each tile contains:</p><ul><li>The title of a note.</li><li>A snippet of the content.</li><li>For empty notes, the sub-children are also displayed, allowing for quick navigation.</li></ul><p>Depending on the type of note:</p><ul><li>For&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes, the text can be slightly scrollable via the mouse wheel to reveal more context.</li><li>For&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;notes, syntax highlighting is applied.</li><li>For&nbsp;<a class=\"reference-link\" href=\"#root/_help_W8vYD3Q1zjCR\">File</a>&nbsp;notes, a preview is made available for audio, video and PDF notes.</li><li>If the note does not have a content, a list of its child notes will be displayed instead.</li></ul><p>The grid view is also used by default in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_0ESUbbAxVnoK\">Note List</a>&nbsp;of every note, making it easy to navigate to children notes.</p><h3>Creating a new table</h3><p>Right click on an existing note in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;and select <em>Insert child note</em> → <em>Collection</em> → <em>Grid View</em>.</p><h2>Configuration</h2><p>Unlike most other view types, the grid view is not actually configurable.</p>",
+ "_help_mULW0Q3VojwY": "<figure class=\"image\"><img style=\"aspect-ratio:1387/758;\" src=\"{{helpAssets}}/User%20Guide/Collections/List%20View_image.png\" width=\"1387\" height=\"758\"></figure><p>List view is similar to&nbsp;<a class=\"reference-link\" href=\"#root/_help_8QqnMzx393bx\">Grid View</a>, but in the list view mode, each note is displayed in a single row with only the title and the icon of the note being visible by the default. By pressing the <span class=\"tn-icon bx bx-chevron-right\"></span> expand button it's possible to view the content of the note, as well as the children of the note (recursively).</p><p>In the example above, the \"Node.js\" note on the left panel contains several child notes. The right panel displays the content of these child notes as a single continuous document.</p><h3>Creating a new table</h3><p>Right click on an existing note in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;and select <em>Insert child note</em> → <em>Collection</em> → <em>List View</em>.</p><h2>Interaction</h2><ul><li>Each note can be expanded or collapsed by clicking on the <span class=\"tn-icon bx bx-chevron-right\"></span> arrow to the left of the title.</li><li>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>, there are buttons to expand (<span class=\"tn-icon bx bx-move-vertical\"></span>) and to collapse (<span class=\"tn-icon bx bx-layer-minus\"></span>) all notes easily.</li></ul><h2>Printing and exporting to PDF</h2><p>Since v0.100.0, list collections can be <a href=\"#root/_help_NRnIZmSMc5sj\">printed or exported to PDF</a>.</p><p>A printed list collection will print all the notes in the collection, in the right order and preserving the full hierarchy.</p><p>If exported to PDF within the desktop application, there is additional functionality:</p><ul><li>The table of contents of the PDF will reflect the structure of the notes.</li><li>Reference and inline links to other notes within the same hierarchy will be functional (will jump to the corresponding page). If a link refers to a note that is not in the printed hierarchy, it will be unlinked.</li></ul><h2>Expanding and collapsing multiple notes at once</h2><p>Apart from individually expanding or collapsing notes, it's also possible to expand or collapse them all at once. To do so, go to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>&nbsp;and look for the corresponding button.</p><p>By default, the <em>Expand</em> (<span class=\"tn-icon bx bx-move-vertical\"></span>) button will only expand the direct children (first level) of the collection. Starting with v0.100.0, it's possible to expand multiple levels of notes using the arrow button next to the button.</p><p>Manually expanded notes will reset if the application/tab is closed and then the collection is visited again. However notes automatically expanded/collapsed via the buttons in&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>&nbsp;will persist.</p><aside class=\"admonition tip\"><p>By design, the UI provides only a handful of levels of depth for expanding notes (direct children, 2-5, all levels). It's also possible to specify any desired depth by manually setting the <a href=\"#root/_help_HI6GBBIduIgv\">corresponding label</a>. For example: <code>#expanded=100</code> to expand up to 100 levels of depth.</p></aside><aside class=\"admonition note\"><p>From a performance standpoint, the List collection is efficient since it does not load child notes unless the notes are actually expanded. Expanding the list for a significantly large hierarchy can cause slow-downs.</p></aside>",
+ "_help_CssoWBu8I7jF": "<figure class=\"image\"><img style=\"aspect-ratio:1177/98;\" src=\"{{helpAssets}}/User%20Guide/Collections/Collection%20Properties_image.png\" width=\"1177\" height=\"98\"></figure><p>The <em>Collection Properties</em> is a toolbar that is displayed at the top of every <a href=\"#root/_help_GTwFsgaA0lCt\">collection note</a>.</p><p>The collection properties has:</p><ul><li>A quick selector for the view type (e.g. grid, calendar, board).</li><li>A settings button with:<ul><li>Settings for the current view, for example hiding the weekends in a calendar.</li><li>Generic settings for the collection, such as <a href=\"#root/_help_wyaGBBQrl4i3\">hiding the child notes</a> or showing <a href=\"#root/_help_MKmLg5x6xkor\">archived notes</a>.</li></ul></li><li>Specific interactions for the current view, for example month selector and view switcher for the calendar.</li></ul>",
+ "_help_IF7Q6I9x7zuw": "<figure class=\"image\"><img style=\"aspect-ratio:1406/1030;\" src=\"{{helpAssets}}/User%20Guide/Collections/Dashboard_image.png\" width=\"1406\" height=\"1030\"></figure><aside class=\"admonition note\"><p>The dashboard is currently considered beta. This means that it might face some changes in behavior until it is stabilized.</p></aside><p>The dashboard is a collection introduced in Trilium v0.104.0. It is similar to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8QqnMzx393bx\">Grid View</a>&nbsp;collection, but with some key differences:</p><ul><li>The grid layout is not fixed, allowing for tiles of varying widths and heights. The grid has 12 columns and an unlimited number of rows.</li><li>Each widget represents a child note of the collection and can be reordered or resized.</li><li>The grid will distribute the columns evenly to fill the entire screen.<ul><li>If the available space is too low (e.g. in a split or in mobile), the columns are collapsed so that all widgets are displayed one under the other.</li><li>While the columns are collapsed, the widgets cannot be reordered or resized.</li></ul></li><li>Unlike the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8QqnMzx393bx\">Grid View</a>, the widgets are not clickable which allows them to be interactive.</li></ul><h2>Types of widgets</h2><p>The dashboard uses the same rendering mechanism as the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8QqnMzx393bx\">Grid View</a>&nbsp;or the&nbsp;<a class=\"reference-link\" href=\"#root/_help_0ESUbbAxVnoK\">Note List</a>, which means every note can be rendered, such as:</p><ul><li>Static content, via&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;or&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>.</li><li>Images via&nbsp;<a class=\"reference-link\" href=\"#root/_help_W8vYD3Q1zjCR\">File</a>,&nbsp;<a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a>,&nbsp;<a class=\"reference-link\" href=\"#root/_help_gBbsAeiuUxI5\">Mind Map</a>.</li><li>Interactive widgets via&nbsp;<a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a>.</li><li>Web pages can be displayed via&nbsp;<a class=\"reference-link\" href=\"#root/_help_1vHRoWCEjj0L\">Web View</a>&nbsp;and refreshed via the context menu.</li><li><a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>&nbsp;render interactively inside the dashboard</li></ul><aside class=\"admonition tip\"><p>Interactive widgets through the use of&nbsp;<a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a>&nbsp;is the highlighted use case of the dashboard. Using the&nbsp;<a class=\"reference-link\" href=\"#root/_help_GBBMSlVSOIGP\">AI</a>&nbsp;chat, these widgets can be easily created as the AI is instructed in how to write them.</p></aside><h2>Adding new widgets</h2><p>There are two ways to add widgets to a dashboard:</p><ul><li>Create a child note of any type, the dashboard will automatically pick it up and add it onto the grid.</li><li>From the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, drag an existing note onto the dashboard and it will be placed there. This will <a href=\"#root/_help_IakOLONlIfGI\">clone</a> the note into the collection.</li></ul><h2>Read-only dashboards</h2><p>On a <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a> dashboard, the widgets can't be moved or resized, notes dragged from the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> aren't added, and the menu of a widget no longer offers to remove it.</p>",
+ "_help_BgmBlOIl72jZ": "<p>While Trilium is actively maintained and stable, encountering bugs is possible.</p><h2>General Quick Fix</h2><p>The first step in troubleshooting is often a restart.</p><p>If you experience an UI issue, the frontend may have entered an inconsistent state. Reload the application by pressing <kbd>Ctrl</kbd> + <kbd>R</kbd>. This will reload the frontend.</p><p>If the issue persists or appears to be a backend problem, restart the entire application. For the desktop (Electron) build, simply close and reopen the window. If you're using a Docker build, restart the container.</p><h2>Reporting Bugs</h2><p>Reporting bugs is highly valuable. Here are some tips:</p><ul><li>Use GitHub issues for reporting: <a href=\"https://github.com/TriliumNext/Trilium/issues\">https://github.com/TriliumNext/Trilium/issues</a></li><li>Refer to the <a href=\"#root/_help_qzNzp9LYQyPT\">error logs</a> page for information on providing necessary details.</li></ul><details class=\"trilium-collapsible\" open=\"\"><summary>Broken Note Crashes Trilium</summary><p>Certain problems, such as rendering a note with a faulty script, can cause Trilium to crash. If Trilium attempts to reload the problematic note upon restart, it will continue to crash.</p><p>To resolve this, use the <code>TRILIUM_START_NOTE_ID</code> environment variable to reset the open tabs to a single specified note ID (e.g., <code>root</code>). In Linux, you can set it as follows:</p><pre><code class=\"language-text-x-trilium-auto\">TRILIUM_START_NOTE_ID=root ./trilium</code></pre></details><details class=\"trilium-collapsible\" open=\"\"><summary>Broken Script Prevents Application Startup</summary><p>If a custom script causes Trilium to crash, and it is set as a startup script or in an active <a href=\"#root/_help_MgibgPcfeuGz\">custom widget</a>, start Triliumin \"safe mode\" to prevent any custom scripts from executing:</p><pre><code class=\"language-text-x-trilium-auto\">TRILIUM_SAFE_MODE=true ./trilium</code></pre><p>Depending on your Trilium distribution, you may have pre-made scripts available: <code>trilium-safe-mode.bat</code> and <code>trilium-safe-mode.sh</code>.</p><p>Once Trilium starts, locate and fix or delete the problematic note.</p></details><details class=\"trilium-collapsible\" open=\"\"><summary>Sync and Consistency Checks</summary><p>Trilium periodically verifies the logical consistency of the database (e.g., ensuring every note has a parent). If inconsistencies are detected, you will be notified via the UI.</p><p>In such cases, file a bug report and attach an <a href=\"#root/_help_x59R8J8KV5Bp\">anonymized database</a> if necessary.</p></details><details class=\"trilium-collapsible\" open=\"\"><summary>Restoring Backup</summary><p>Trilium makes regular automatic backups. If issues become severe, you can <a href=\"#root/_help_ODY7qQn5m2FT\">restore from a backup</a>.</p></details><details class=\"trilium-collapsible\" open=\"\"><summary>Forgotten Password</summary><p>See&nbsp;<a class=\"reference-link\" href=\"#root/_help_lwAX5SvbrK2g\">Resetting your password</a>.</p></details>",
+ "_help_wy8So3yZZlH9": "<p>Go to <a href=\"https://github.com/TriliumNext/Trilium/issues\">Issues · TriliumNext/Trilium</a> and press “New issue”.</p><p>If you are reporting a bug, select “Bug Report” and fill in the details.</p>",
+ "_help_x59R8J8KV5Bp": "<p><img src=\"{{helpAssets}}/User%20Guide/Troubleshooting/Anonymized%20Database_image.jpg\"></p><p>In certain scenarios, understanding the structure of a database is crucial for troubleshooting issues. However, sharing your actual <a href=\"#root/_help_wX4HbRucYSDD\">database</a> file with personal notes is not advisable. To address this, Trilium offers a feature to anonymize the database. This feature can be accessed via Menu -&gt; Options -&gt; Advanced tab.</p><p>This feature creates a copy of your database with all sensitive data removed. Specifically, it strips out note titles, contents, revisions, history, and some non-system attributes while retaining the overall structure and metadata, such as modification dates. After anonymization, the database undergoes a <a href=\"https://sqlite.org/lang_vacuum.html\">vacuuming process</a> to ensure no sensitive data remnants remain in the file. The anonymized database is saved in the <code>anonymized</code> directory within the <a href=\"#root/_help_tAassRL4RSQL\">data directory</a>, making it safe to share with bug reports.</p><p>This will create a copy of your document and remove all sensitive data (currently note titles, contents, revisions, history and some of the options, and non-system attributes) while leaving all structure and metadata (e.g. date of last change). After this is done, the database is <a href=\"https://sqlite.org/lang_vacuum.html\">VACUUMed</a> to make sure there's no stale sensitive data in the document file. The resulting file is stored in <code>anonymized</code> directory (placed in the <a href=\"#root/_help_tAassRL4RSQL\">data directory</a>). You can safely attach it to a bug report.</p><h2>Command Line Anonymization</h2><p>If your <a href=\"#root/_help_wX4HbRucYSDD\">database</a> is corrupted to the point where Trilium cannot start, the anonymization process can still be executed via the command line:</p><pre><code class=\"language-text-x-trilium-auto\">node src/anonymize.js</code></pre><p>Run this command from the directory containing Trilium's source files, typically found in the <code>resources/app</code> directory for desktop builds.</p>",
+ "_help_qzNzp9LYQyPT": "<p>It's important to provide all available error logs together with bug reports.</p><p>There are two types of error logs, both of which are useful when reporting bugs.</p><ul><li><a class=\"reference-link\" href=\"#root/_help_bnyigUA2UK7s\">Backend (server) logs</a></li><li><a class=\"reference-link\" href=\"#root/_help_9yEHzMyFirZR\">Frontend logs</a></li></ul><h2>Providing sensitive data</h2><p>If you don't feel comfortable attaching the logs or anything sensitive to the public GitHub issues, feel free to contact the devs in our Matrix <a href=\"https://github.com/TriliumNext/Trilium#-discuss-with-us\">support channel</a>.</p><p>Use this email to also provide anything which could assist in analysing the bug - e.g. files/images/ZIPs being imported or <a href=\"#root/_help_x59R8J8KV5Bp\">anonymized database</a>.</p><h3>Exporting note subtree for reproduction</h3><p>Often times, bugs manifest themselves in specific notes and having them would greatly ease reproduction and fixing.</p><p>In such case, please export the relevant note subtree by right-clicking it on the left tree, choosing Export - HTML as ZIP:</p><p><img src=\"{{helpAssets}}/User%20Guide/Troubleshooting/Error%20logs_error-logs-export-subtree.png\"></p>",
+ "_help_bnyigUA2UK7s": "<h2>Accessing via the backend log</h2><p>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a>, go to <em>Advanced</em> → <em>Show backend log</em>. This will display the current backend log (i.e. today's), with the historical information available only on disk (see below).</p><p>Interaction since v0.104.0:</p><ul><li>The file can be downloaded as a text file using the&nbsp;<span class=\"tn-icon bx bx-download\"></span> button in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>&nbsp;area.</li><li>The file can also be searched just like a normal&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;note.</li></ul><h2>Location on the disk</h2><p>Backend logs are stored on the file system. To find them, open the&nbsp;<a class=\"reference-link\" href=\"#root/_help_tAassRL4RSQL\">Data directory</a>, go to the <code>log</code> subdirectory and find the latest log file, e.g. <code>trilium-2022-12-14.log</code>.&nbsp;</p><h2>Reporting backend bugs</h2><p>You can attach the whole file to the bug report (preferable) or open it and copy-paste only the last lines / lines you believe are relevant.</p><h2>Customizing the retention of logs</h2><p>The backend logs are fully managed by the Trilium server. By default the last 90 days worth of logs are kept; the logs older than that are deleted in order to reduce the space consumption.</p><p>It's possible to change the retention period by modifying the&nbsp;<a class=\"reference-link\" href=\"#root/_help_Gzjqa934BdH4\">Configuration (config.ini or environment variables)</a>&nbsp;via the <code>.ini</code> file:</p><pre><code class=\"language-text-x-trilium-auto\">[Logging]\nretentionDays=7</code></pre><p>Or via the environment variable <code>TRILIUM_LOGGING_RETENTION_DAYS</code>.</p><p>Special cases:</p><ul><li>Positive values indicate the number of days worth of logs to keep</li><li>A value of 0 results with the default value (90 days) to be used</li><li>Negative values (e.g. <code>-1</code>) result with all logs to be kept, irrespective how ancient and numerous (and</li></ul><aside class=\"admonition note\"><p>If you set the retention days to a low number, you might notice that not all the log files are being deleted. This is because a minimum number of logs (7 at the time of writing) is maintained at all times.</p></aside>",
+ "_help_9yEHzMyFirZR": "<p>To provide frontend logs, we need to open the Developer Console. Often the easiest way is to press <kbd>Ctrl</kbd>-<kbd>Shift</kbd>-<kbd>I</kbd> which should work in most browsers (and desktop app). Make sure that the error producing action happened right before you copy&amp;paste the errors, the console is cleared on app restart.</p><p>If that doesn't work, then:</p><ul><li>in Trilium desktop app, go to top-left menu button -&gt; Advanced -&gt; Open Dev Tools</li><li>In Firefox/Chrome right-click anywhere in the page and click Inspect:</li></ul><p><img src=\"{{helpAssets}}/User%20Guide/Troubleshooting/Error%20logs/Frontend%20logs_error-logs-firefox-context-men.png\"></p><p>Once you have Dev Tools open, click on \"Console\" tab:</p><p><img src=\"{{helpAssets}}/User%20Guide/Troubleshooting/Error%20logs/Frontend%20logs_image.jpg\"></p><p>Copy-paste (or screenshot) the logs. It's better to provide not just errors, but the whole log, which might provide context while analyzing the bug.</p>",
+ "_help_vdlYGAcpXAgc": "<p>Synchronization can sometimes take a long amount of time in order to compute the items that require update. When running behind a reverse proxy, the request can time out.</p><p>The solution is to increase the timeout at proxy level.</p><h2>Nginx</h2><p>Add the following to the configuration file:</p><pre><code class=\"language-text-x-nginx-conf\">proxy_connect_timeout 300;\nproxy_send_timeout 300;\nproxy_read_timeout 300;\nsend_timeout 300;</code></pre><p>And restart the server.</p><p>See&nbsp;<a href=\"#root/_help_ud6MShXL4WpO\">Nginx Proxy Setup</a>&nbsp;for more information about the Nginx setup.</p><p>If it still doesn't work, try increasing the timeout.</p>",
+ "_help_s8alTXmpFR61": "<p>Some changes to the application will not take effect immediately and as such it might require to manually reload or refresh the application.</p><p>To do so, simply press <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>R</kbd>.</p>",
+ "_help_7NfNr5pZpVKV": "<h2>Step 1. Find a place to place the themes</h2><p>Organization is an important aspect of managing a knowledge base. When developing a new theme or importing an existing one it's a good idea to keep them into one place.</p><p>As such, the first step is to create a new note to gather all the themes.</p><p><img src=\"{{helpAssets}}/User%20Guide/Theme%20development/Creating%20a%20custom%20theme_5_Creating%20a%20custom%20theme_im.jpg\"></p><h2>Step 2. Create the theme</h2><figure class=\"table\"><table><tbody><tr><td><img src=\"{{helpAssets}}/User%20Guide/Theme%20development/Creating%20a%20custom%20theme_3_Creating%20a%20custom%20theme_im.jpg\"></td><td>Themes are code notes with a special attribute. Start by creating a new code note.</td></tr><tr><td><img src=\"{{helpAssets}}/User%20Guide/Theme%20development/Creating%20a%20custom%20theme_1_Creating%20a%20custom%20theme_im.jpg\"></td><td>Then change the note type to a CSS code.</td></tr><tr><td><img src=\"{{helpAssets}}/User%20Guide/Theme%20development/Creating%20a%20custom%20theme_Creating%20a%20custom%20theme_im.jpg\"></td><td>In the attributes of the note (the&nbsp;<span class=\"tn-icon bx bx-list-check\"></span> button in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_AlJ73vBCjWDw\">Status bar</a>), define the <code>#appTheme</code> attribute to point to any desired name. This is the name that will show up in the appearance section in settings.</td></tr></tbody></table></figure><h2>Step 3. Define the theme's CSS</h2><p>As a very simple example we will change the background color of the launcher pane to a shade of blue.</p><p>To alter the different variables of the theme:</p><pre><code class=\"language-text-css\">:root {\n\t--launcher-pane-background-color: #0d6efd;\n}</code></pre><h2>Step 4. Activating the theme</h2><p>Refresh the application (Ctrl+Shift+R is a good way to do so) and go to settings. You should see the newly created theme:</p><p><img src=\"{{helpAssets}}/User%20Guide/Theme%20development/Creating%20a%20custom%20theme_2_Creating%20a%20custom%20theme_im.jpg\"></p><p>Afterwards the application will refresh itself with the new theme:</p><p><img src=\"{{helpAssets}}/User%20Guide/Theme%20development/Creating%20a%20custom%20theme_4_Creating%20a%20custom%20theme_im.jpg\"></p><p>Do note that the theme will be based off of the legacy theme. To override that and base the theme on the Modern theme, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_WFGzWeUK6arS\">Customize the Next theme</a>.</p><h2>Step 5. Making changes</h2><p>Simply go back to the note and change according to needs. To apply the changes to the current window, press <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>R</kbd> to refresh.</p><p>It's a good idea to keep two windows, one for editing and the other one for previewing the changes.</p>",
+ "_help_WFGzWeUK6arS": "<p>By default, any custom theme will be based on the legacy light theme. To use the TriliumNext theme instead, add the <code>#appThemeBase=next</code> attribute onto the existing theme. The <code>appTheme</code> attribute must also be present.</p><p><img src=\"{{helpAssets}}/User%20Guide/Theme%20development/Customize%20the%20Next%20theme_image.png\"></p><p>The <code>appThemeBase</code> label can be set to one of the following values:</p><ul><li><code>next</code>, for the TriliumNext (auto light or dark mode).</li><li><code>next-light</code>, for the always light mode of the TriliumNext.</li><li><code>next-dark</code>, for the always dark mode of the TriliumNext.</li><li>Any other value is ignored and will use the legacy white theme instead.</li></ul><h2>Overrides</h2><p>Do note that the TriliumNext theme has a few more overrides than the legacy theme. Due to that, it is recommended to use <code>#trilium-app</code> with a next theme instead of the <code>:root</code> of a legacy theme.</p><pre><code class=\"language-text-css\">#trilium-app {\n\t--launcher-pane-background-color: #0d6efd;\n}</code></pre>",
+ "_help_WN5z4M8ASACJ": "<h2>Detecting mobile vs. desktop</h2><p>The mobile layout is different than the one on the desktop. Use <code>body.mobile</code> and <code>body.desktop</code> to differentiate between them.</p><pre><code class=\"language-text-css\">body.mobile #root-widget {\n\t/* Do something on mobile */\n}\n\nbody.desktop #root-widget {\n\t/* Do something on desktop */\n}</code></pre><p>Do note that there is also a “tablet mode” in the mobile layout. For that particular case media queries are required:</p><pre><code class=\"language-text-css\">@media (max-width: 991px) {\n #launcher-pane {\n /* Do something on mobile layout */\n }\n}\n\n\n\n@media (min-width: 992px) {\n #launcher-pane {\n /* Do something on mobile tablet + desktop layout */\n }\n}</code></pre><h2>Detecting horizontal vs. vertical layout</h2><p>The user can select between vertical layout (the classical one, where the launcher bar is on the left) and a horizontal layout (where the launcher bar is on the top and tabs are full-width).</p><p>Different styles can be applied by using classes at <code>body</code> level:</p><pre><code class=\"language-text-css\">body.layout-vertical #left-pane {\n\t/* Do something */\n}\n\nbody.layout-horizontal #center-pane {\n\t/* Do something else */\t\n}</code></pre><p>The two different layouts use different containers (but they are present in the DOM regardless of the user's choice), for example <code>#horizontal-main-container</code> and <code>#vertical-main-container</code> can be used to customize the background of the content section.</p><h2>Detecting platform (Windows, macOS) or Electron</h2><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-windows\"></span>&nbsp;Windows</p><div class=\"trilium-tab-panel\"><pre><code class=\"language-text-css\">body.platform-win32 {\n\tbackground: red;\n}</code></pre></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-apple\"></span>&nbsp;macOS</p><div class=\"trilium-tab-panel\"><pre><code class=\"language-text-css\">body.platform-darwin {\n\tbackground: red;\n}</code></pre></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bx-windows\"></span>&nbsp;Electron (desktop app)</p><div class=\"trilium-tab-panel\"><p>To distinguish between a&nbsp;<a class=\"reference-link\" href=\"#root/_help_poXkQfguuA0U\">Desktop Installation</a>&nbsp;and a&nbsp;<a class=\"reference-link\" href=\"#root/_help_WOcw2SLH6tbX\">Server Installation</a>:</p><pre><code class=\"language-text-x-trilium-auto\">body.electron {\n\tbackground: blue;\n}</code></pre><p>Can be chained with Windows/macOS detections (e.g. <code>body.electron.platform-win32</code>).</p></div></section></div><h3>Native title bar</h3><p>It's possible to detect if the user has selected the native title bar or the custom title bar by querying against <code>body</code>:</p><pre><code class=\"language-text-x-trilium-auto\">body.electron.native-titlebar {\n\t/* Do something */\n}\n\nbody.electron:not(.native-titlebar) {\n\t/* Do something else */\n}</code></pre><h3>Native window buttons</h3><p>When running under Electron with native title bar off, a feature was introduced to use the platform-specific window buttons such as the semaphore on macOS.</p><p>See <a href=\"https://github.com/TriliumNext/Notes/pull/702\">Native title bar buttons by eliandoran · Pull Request #702 · TriliumNext/Notes</a> for the original implementation of this feature, including screenshots.</p><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-windows\"></span>&nbsp;Windows</p><div class=\"trilium-tab-panel\"><p>The colors of the native window button area can be adjusted using a RGB hex color:</p><pre><code class=\"language-text-x-trilium-auto\">body {\n\t--native-titlebar-foreground: #ffffff;\n\t--native-titlebar-background: #ff0000;\n}</code></pre><p>It is also possible to use transparency at the cost of reduced hover colors using a RGBA hex color:</p><pre><code class=\"language-text-x-trilium-auto\">body {\n\t--native-titlebar-background: #ff0000aa;\n}</code></pre><p>Note that the value is read when the window is initialized and then it is refreshed only when the user changes their light/dark mode preference.</p></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-apple\"></span>&nbsp;macOS</p><div class=\"trilium-tab-panel\"><p>On macOS the semaphore window buttons are enabled by default when the native title bar is disabled. The offset of the buttons can be adjusted using:</p><pre><code class=\"language-text-css\">body {\n --native-titlebar-darwin-x-offset: 12;\n --native-titlebar-darwin-y-offset: 14 !important;\n}</code></pre></div></section></div><h3>Background/transparency effects on Windows (Mica)</h3><p>Windows 11 offers a special background/transparency effect called Mica, which can be enabled by themes by setting the <code>--background-material</code> variable at <code>body</code> level:</p><pre><code class=\"language-text-css\">body.electron.platform-win32 {\n\t--background-material: tabbed; \n}</code></pre><p>The value can be either <code>tabbed</code> (especially useful for the horizontal layout) or <code>mica</code> (ideal for the vertical layout).</p><p>Do note that the Mica effect is applied at <code>body</code> level and the theme needs to make the entire hierarchy (semi-)transparent in order for it to be visible. Use the TrilumNext theme as an inspiration.</p><h2>Note icons, tab workspace accent color</h2><p>Theme capabilities are small adjustments done through CSS variables that can affect the layout or the visual aspect of the application.</p><p>In the tab bar, to display the icons of notes instead of the icon of the workspace:</p><pre><code class=\"language-text-css\">:root {\n\t--tab-note-icons: true;\n}</code></pre><p>When a workspace is hoisted for a given tab, it is possible to get the background color of that workspace, for example to apply a small strip on the tab instead of the whole background color:</p><pre><code class=\"language-text-css\">.note-tab .note-tab-wrapper {\n --tab-background-color: initial !important;\n}\n\n.note-tab .note-tab-wrapper::after {\n content: \"\";\n position: absolute;\n top: 0;\n left: 0;\n right: 0;\n height: 3px;\n background-color: var(--workspace-tab-background-color);\n}</code></pre><h2>Custom fonts</h2><p>The recommended way of using customized fonts is to import a font directly in Trilium. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_w4rMEhJsALlA\">Personalizing the font</a>&nbsp;for information on how to do so.</p><p>Alternatively, for a theme providing its own font, <a href=\"#root/_help_d3fAXQ2diepH\">Custom resource providers</a> can be used: Import a font into Trilium and assign it <code>#customResourceProvider=fonts/myfont.ttf</code> and then import the font in CSS via <code>/custom/fonts/myfont.ttf</code>. Use <code>../../../custom/fonts/myfont.ttf</code> if you run your Trilium server on a different path than <code>/</code>.</p><h2>Dark and light themes</h2><p>A light theme needs to have the following CSS:</p><pre><code class=\"language-text-css\">:root {\n\t--theme-style: light;\n}</code></pre><p>if the theme is dark, then <code>--theme-style</code> needs to be <code>dark</code>. A dark <code>--theme-style</code> also tells the Dark Reader browser extension to leave the page alone.</p><p>If the theme is auto (e.g. supports both light or dark based on <code>prefers-color-scheme</code>) it must also declare (in addition to setting <code>--theme-style</code> to either <code>light</code> or <code>dark</code>):</p><pre><code class=\"language-text-css\">:root {\n\n --theme-style-auto: true;\n\n}</code></pre><p>This will affect the behavior of the Electron application by informing the operating system of the color preference (e.g. background effects will appear correct on Windows).</p><h2>Adaptive text and table colors</h2><p>Colors applied in a text note, from the font color and background color buttons (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_Gr6xFaF6ioJ5\">General formatting</a>) or from the table and cell properties (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_NdowYOC1GFKS\">Tables</a>), are shown in a shade that suits the theme: the hue stays, while the lightness and the saturation are kept within limits. A theme can change these limits, for example if its page background is much darker or lighter than the one of the built-in themes:</p><pre><code class=\"language-text-css\">:root {\n --adaptive-text-light-max-lightness: 35;\n --adaptive-text-dark-min-lightness: 80;\n}</code></pre><p>Each variable is named <code>--adaptive-&lt;role&gt;-&lt;light|dark&gt;-&lt;limit&gt;</code>:</p><ul><li>The role is <code>text</code> (font color), <code>background</code> (font background color), <code>table-border</code> or <code>table-background</code> (tables and cells).</li><li><code>light</code> or <code>dark</code> is the kind of theme the limit applies to, as declared by <code>--theme-style</code>.</li><li>The limit is <code>min-lightness</code> or <code>max-lightness</code> (the CIELAB lightness, from 0 for black to 100 for white), or <code>max-chroma</code> (how saturated the color can be; <code>150</code> sets no practical limit). Each value must be a plain number, otherwise the colors lose their adaptation.</li></ul><p>The defaults are:</p><figure class=\"table\"><table><thead><tr><th>Role</th><th>Light themes</th><th>Dark themes</th></tr></thead><tbody><tr><td><code>text</code></td><td><code>max-lightness: 40</code>, <code>max-chroma: 150</code></td><td><code>min-lightness: 75</code>, <code>max-chroma: 55</code></td></tr><tr><td><code>background</code></td><td><code>min-lightness: 90</code>, <code>max-chroma: 20</code></td><td><code>max-lightness: 30</code>, <code>max-chroma: 30</code></td></tr><tr><td><code>table-border</code></td><td><code>max-lightness: 60</code>, <code>max-chroma: 150</code></td><td><code>min-lightness: 47</code>, <code>max-chroma: 150</code></td></tr><tr><td><code>table-background</code></td><td><code>min-lightness: 90</code>, <code>max-chroma: 20</code></td><td><code>max-lightness: 30</code>, <code>max-chroma: 30</code></td></tr></tbody></table></figure><p>The limits apply while a note is displayed, so a change to them affects every note at once. The note itself keeps each color as it was picked, in its <code>color</code>, <code>background-color</code> or <code>border-color</code> style, and a second time in a <code>--tn-color</code>, <code>--tn-background</code> or <code>--tn-border-color</code> variable, which the adaptation reads.</p>",
+ "_help_AlhDUqhENtH7": "<p>It is possible to provide a CSS file to be used regardless of the theme set by the user.</p><p>The quickest way to create one is <em>Insert child note</em> → <em>Code</em> → <em>Custom CSS</em> in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_YtSN43OrfzaA\">Note tree contextual menu</a>.</p><p>Alternatively, create a&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;note manually, set the language to CSS and apply the <code>#appCss</code> label.</p><h2>Seeing the changes</h2><p>Adding a new <em>app CSS note</em> or modifying an existing one does not immediately apply changes. To see the changes, press Ctrl+Shift+R to refresh the page first.</p><h2>Sample use cases</h2><h3>Customizing the printing stylesheet</h3><aside class=\"admonition tip\"><p>Since v0.99.2, it's no longer possible to use <code>#appCss</code> to customize the printing CSS, since the printing is now done in an isolated environment.</p><p>However, it's still possible to customize the CSS via <code>~printCss</code>; see&nbsp;<a class=\"reference-link\" href=\"#root/_help_NRnIZmSMc5sj\">Printing &amp; Exporting as PDF</a>&nbsp;for more information.</p></aside><h3>Per-workspace styles</h3><p>When using&nbsp;<a class=\"reference-link\" href=\"#root/_help_9sRHySam5fXb\">Workspaces</a>, it can be helpful to create a visual distinction between notes in different workspaces.</p><p>To do so:</p><ol><li>In the note with <code>#workspace</code>, add an inheritable attribute <code>#cssClass(inheritable)</code> with a value that uniquely identifies the workspace (say <code>my-workspace</code>).</li><li>Anywhere in the note structure, create a CSS note with <code>#appCss</code>.</li></ol><h4>Change the color of the icons in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a></h4><pre><code class=\"language-text-x-trilium-auto\">.fancytree-node.my-workspace.fancytree-custom-icon {\n color: #ff0000;\n}</code></pre><h4>Change the color of the note title and the icon</h4><p>To change the color of the note title and the icon (above the content):</p><pre><code class=\"language-text-x-trilium-auto\">.note-split.my-workspace .note-icon-widget button.note-icon,\n.note-split.my-workspace .note-title-widget input.note-title {\n color: #ff0000;\n}</code></pre><h4>Add a watermark to the note content</h4><figure class=\"image image-style-align-right image_resized\" style=\"width:39.97%;\"><img style=\"aspect-ratio:641/630;\" src=\"{{helpAssets}}/User%20Guide/Theme%20development/Custom%20app-wide%20CSS_image.png\" width=\"641\" height=\"630\"></figure><ol><li>Insert an image in any note and take the URL of the image.</li><li>Use the following CSS, adjusting the <code>background-image</code> and <code>width</code> and <code>height</code> to the desired values.</li></ol><pre><code class=\"language-text-x-trilium-auto\">.note-split.my-workspace .scrolling-container:after {\n position: fixed;\n content: \"\";\n background-image: url(\"/api/attachments/Rvm3zJNITQI1/image/logo.png\");\n background-size: contain;\n background-position: center;\n background-repeat: no-repeat;\n width: 237px;\n height: 44px;\n bottom: 1em;\n right: 1em;\n opacity: 0.5;\n z-index: 0;\n}</code></pre><h2>Limitations</h2><p>Some parts of the application can't be styled directly via custom CSS because they are rendered in an isolated mode (shadow DOM), more specifically:</p><ul><li>The slides in a&nbsp;<a class=\"reference-link\" href=\"#root/_help_zP3PMqaG71Ct\">Presentation</a>.</li></ul>",
+ "_help_g1mlRoU8CsqC": "<aside class=\"admonition note\"><p>This page explains, step‑by‑step, how to create a custom icon pack. For a general description of how to use already existing icon packs, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_gOKqSJgXLcIj\">Icon Packs</a>.</p></aside><p>First read the quick flow to get the overall steps. After that there is a concrete example (Phosphor) with a small Node.js script you can run to generate the manifest.</p><h2>Quick flow (what you need to do)</h2><ol><li>Verify the icon set is a font (one of: .woff2, .woff, .ttf).</li><li>Obtain a list that maps icon names to Unicode code points (often provided as a JSON like <code>selection.json</code> or a CSS file).</li><li>Create a manifest JSON that maps icon ids to glyphs and search terms.</li><li>Create a Trilium note of type Code, set language to JSON, paste the manifest as the note content.</li><li>Upload the font file as an attachment to the same note (MIME type must be <code>font/woff2</code>, <code>font/woff</code>, or <code>font/ttf</code> and role <code>file</code>).</li><li>Add the label <code>#iconPack=&lt;prefix&gt;</code> to the note (prefix: letters, digits, hyphen, underscore and non-ASCII characters only).</li><li>Refresh the client and verify the icon pack appears in the icon selector.</li></ol><h2>Verify the icon set</h2><p>The first step is to analyze if the icon set being packed can be integrated into Trilium.</p><p>Trilium only supports <strong>font-based icon sets</strong>, with the following formats:</p><figure class=\"table\"><table><thead><tr><th>Extension</th><th>MIME type</th><th>Description</th></tr></thead><tbody><tr><td><code>.woff2</code></td><td><code>font/woff2</code></td><td>Recommended due to great compression (low size).</td></tr><tr><td><code>.woff</code></td><td><code>font/woff</code></td><td>Higher compatibility, but the font file is bigger.</td></tr><tr><td><code>.ttf</code></td><td><code>font/ttf</code></td><td>Most common, but highest font size.</td></tr></tbody></table></figure><p>Trilium <strong>does not</strong> support the following formats:</p><ul><li>SVG-based fonts.</li><li>Individual SVGs.</li><li><code>.eot</code> fonts (legacy and proprietary).</li><li>Duotone icons, since it requires a special CSS format that Trilium doesn't support.</li><li>Any other font format not specified in the <em>Supported formats</em> section.</li></ul><p>In this case, the font must be manually converted to one of the supported formats (ideally <code>.woff2</code>).</p><h2>Manifest format</h2><p>The manifest is a JSON object with an <code>icons</code> map. Each entry key is the CSS/class id you will use (Trilium uses the CSS class when rendering). Value object:</p><ul><li>glyph: the single character (the glyph) — can be the escaped Unicode (e.g. \"\\ue9c2\") or the literal character.</li><li>terms: array of search aliases; the first term is used as display name in the selector.</li></ul><p>Example minimal manifest:</p><pre><code class=\"language-text-x-trilium-auto\">{\n \"icons\": {\n \"ph-acorn\": {\n \"glyph\": \"\\uea3f\",\n \"terms\": [\"acorn\", \"nut\"]\n },\n \"ph-book\": {\n \"glyph\": \"\\uea40\",\n \"terms\": [\"book\", \"read\"]\n }\n }\n}</code></pre><aside class=\"admonition note\"><ul><li>You can supply glyph as the escaped <code>\\uXXXX</code> sequence or as the actual UTF‑8 character. The CSS form (<code>\\ea3f</code>, as written in a stylesheet's <code>content</code>) is accepted too, so glyphs copied out of the font's own CSS work as they stand.</li><li>It is also possible to use the unescaped glyph inside the JSON. It will appear strange (e.g. ), but it will be rendered properly regardless.</li><li>The manifest keys (e.g. <code>ph-acorn</code>) should match the class names used by the font (prefix + name is a common pattern).</li><li>Like the prefix, a manifest key becomes a CSS class name, so it can contain only letters, digits, hyphens, underscores and non-ASCII characters. Punctuation and whitespace (e.g. <code>ph.acorn</code> or <code>ph acorn</code>) are not usable as class names; icons with such a key are skipped and an error is logged in&nbsp;<a class=\"reference-link\" href=\"#root/_help_bnyigUA2UK7s\">Backend (server) logs</a>, while the rest of the pack still loads.</li></ul></aside><h2>Concrete example: Phosphor Icons</h2><p><a href=\"https://phosphoricons.com/\">Phosphor Icons</a> provide a <code>selection.json</code> that includes <code>properties.code</code> (the codepoint) and <code>properties.name</code> (the icon name). The goal: convert that into Trilium's manifest.</p><p>Sample <code>selection.json</code> excerpt:</p><pre><code class=\"language-text-x-trilium-auto\">{\n \"icons\": [\n {\n \"icon\": {\n \"paths\": [ /* [...] */ ],\n \"grid\": 0,\n \"attrs\": [{}],\n \"isMulticolor\": false,\n \"isMulticolor2\": false,\n \"tags\": [\"acorn\"]\n },\n \"attrs\": [{}],\n \"properties\": {\n \"id\": 0,\n \"order\": 1513,\n \"name\": \"acorn\",\n \"code\": 60314,\n \"ligatures\": \"acorn\",\n \"prevSize\": 16\n },\n \"setIdx\": 0,\n \"setId\": 0,\n \"iconIdx\": 0\n },\n /* [...] */\n ]\n}</code></pre><details class=\"trilium-collapsible\" open=\"\"><summary>A tiny Node.js script to produce the manifest</summary><p>Place <code>selection.json</code> in the same directory and run with Node 20+):</p><pre><code class=\"language-text-javascript\">import { join } from \"node:path\";\nimport { readFileSync, writeFileSync } from \"node:fs\";\n\nfunction processIconPack(packName) {\n const path = join(packName);\n const selectionMeta = JSON.parse(readFileSync(join(path, \"selection.json\"), \"utf-8\"));\n const icons = {};\n\n for (const icon of selectionMeta.icons) {\n let name = icon.properties.name;\n if (name.endsWith(`-${packName}`)) {\n name = name.split(\"-\").slice(0, -1).join(\"-\");\n }\n\n const id = `ph-${name}`;\n icons[id] = {\n glyph: `${String.fromCharCode(icon.properties.code)}`,\n terms: [ name ]\n };\n }\n\n writeFileSync(\"manifest.json\", JSON.stringify(icons, null, 2), \"utf8\");\n console.log(\"manifest.json created\");\n}\n\nprocessIconPack(\"light\");</code></pre><p>What to do with the script:</p><ul><li>Put <code>selection.json</code> and <code>build-manifest.js</code> in a folder.</li><li>Run: node build-manifest.js</li><li>The script writes <code>manifest.json</code> — open it, verify contents, then copy into a Trilium Code note (language: JSON).</li></ul></details><aside class=\"admonition tip\"><p><strong>Mind the escape format when processing CSS</strong></p><p>The Unicode escape syntax is different in CSS (<code>\"\\ea3f\"</code>) when compared to JSON (<code>\"\\uea3f\"</code>). Notice how the JSON escape is <code>\\u</code> and not <code>\\</code>. Both forms are accepted: keep the CSS escape by writing the backslash itself as <code>\"\\\\ea3f\"</code> in the JSON, or convert it to the JSON escape <code>\"\\uea3f\"</code>.</p><p>As a more compact alternative, provide the un-escaped character directly, as UTF-8 is supported.</p></aside><h3>Assigning the prefix</h3><p>Before an icon pack can be used, it needs to have a prefix defined. This prefix uniquely identifies the icon pack so that it can be used throughout the application.</p><p>To do so, Trilium makes use of the same format that was used for the internal icon pack (Boxicons). For example, when an icon from Boxicons is set, it looks like this: <code>#iconClass=\"bx bxs-sushi\"</code>. In this case, the icon pack prefix is <code>bx</code> and the icon class name is <code>bxs-sushi</code>.</p><p>In order for an icon pack to be recognized, the prefix must be specified in the <code>#iconPack</code> label.&nbsp;</p><p>For our example with Phosphor Icons, we can use the <code>ph</code> prefix since it also matches the prefix set in the original CSS. So in this case it would be <code>#iconPack=ph</code>.</p><aside class=\"admonition important\"><p>The prefix must consist of only letters, digits, hyphens, underscores and non-ASCII characters. If the prefix doesn't match these constraints, the icon pack will be ignored and an error will be logged in&nbsp;<a class=\"reference-link\" href=\"#root/_help_bnyigUA2UK7s\">Backend (server) logs</a>.</p></aside><h2>Creating the Trilium icon pack note</h2><ol><li>Create a note of type <em>Code</em>.</li><li>Set the language to <em>JSON</em>.</li><li>Rename the note. The name of the note will also be the name of the icon pack as displayed in the list of icons.</li><li>Copy and paste the manifest generated in the previous step as the content of this note.</li><li>Go to the <a href=\"#root/_help_0vhv7lsOLy82\">note attachment</a> and upload the font file (in <code>.woff2</code>, <code>.woff</code>, <code>.ttf</code>) format.<ol><li>Trilium identifies the font to use from attachments via the MIME type, make sure the MIME type is displayed correctly after uploading the attachment (for example <code>font/woff2</code>).</li><li>Make sure the <code>role</code> appears as <code>file</code>, otherwise the font will not be identified.</li><li>Multiple attachments are supported, but only one font will actually be used in Trilium's order of preference: <code>.woff2</code>, <code>.woff</code>, <code>.ttf</code>. As such, there's not much reason to upload more than one font per icon pack.</li></ol></li><li>Add label: <code>#iconPack=&lt;prefix&gt;</code> (for Phosphor example: <code>#iconPack=ph</code>).</li></ol><h3>Final steps</h3><ul><li><a href=\"#root/_help_s8alTXmpFR61\">Refresh the client</a><ul><li>Change the icon of the note and look for the <em>Filter</em> icon in the top-right side.</li><li>Check if the new icon pack is displayed there and click on it to see the full list of icons.</li><li>Go through most of the items to look for issues such as missing icon, wrong names (some icons have aliases/terms that can cause issues).</li></ul></li><li>Optionally, assign an icon from the new icon pack to this note. This icon will be used in the icon pack filter for a visual distinction.</li><li>The icon pack can then be <a href=\"#root/_help_mHbBMPDPkVV5\">exported as ZIP</a> in order to be distributed to other users.<ul><li>It's important to note that icon packs are considered “unsafe” by default, so “Safe mode” must be disabled when importing the ZIP.</li><li>Consider linking new users to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_gOKqSJgXLcIj\">Icon Packs</a>&nbsp;documentation in order to understand how to import and use an icon pack.</li></ul></li></ul><h3>Troubleshooting</h3><p>If the icon pack doesn't show up, look through the&nbsp;<a class=\"reference-link\" href=\"#root/_help_bnyigUA2UK7s\">Backend (server) logs</a>&nbsp;for clues.</p><ul><li>One example is if the font could not be retrieved: <code>ERROR: Icon pack is missing WOFF/WOFF2/TTF attachment: Boxicons v3 400 (dup) (XRzqDQ67fHEK)</code>.</li><li>Make sure the prefix is unique and not already taken by some other icon pack. When there are two icon packs with the same prefix, only one is used. The server logs will indicate if this situation occurs.</li><li>Make sure the prefix consists only of letters, digits, hyphens, underscores and non-ASCII characters.</li><li>If the pack loads but individual icons are missing, check the logs for <code>Skipping icon '&lt;key&gt;' of icon pack</code> — that key uses characters outside the allowed set and needs renaming in the manifest.</li></ul>",
+ "_help_zEY4DaJG4YT5": "<figure class=\"image\"><img style=\"aspect-ratio:1071/146;\" src=\"{{helpAssets}}/User%20Guide/Advanced%20Usage/Attributes_image.png\" width=\"1071\" height=\"146\"></figure><p>In Trilium, attributes are key-value pairs assigned to notes, providing additional metadata or functionality. There are two primary types of attributes:</p><ol><li><p><a class=\"reference-link\" href=\"#root/_help_HI6GBBIduIgv\">Labels</a>&nbsp;can be used for a variety of purposes, such as storing metadata or configuring the behavior of notes. Labels are also searchable, enhancing note retrieval.</p><p>For more information, including predefined labels, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_HI6GBBIduIgv\">Labels</a>.</p></li><li><p><a class=\"reference-link\" href=\"#root/_help_Cq5X6iKQop6R\">Relations</a>&nbsp;define connections between notes, similar to links. These can be used for metadata and scripting purposes.</p><p>For more information, including a list of predefined relations, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_Cq5X6iKQop6R\">Relations</a>.</p></li></ol><p>These attributes play a crucial role in organizing, categorizing, and enhancing the functionality of notes.</p><h2>Types of attributes</h2><p>Conceptually there are two types of attributes (applying to both labels and relations):</p><ol><li><strong>System attributes</strong><br>As the name suggest, these attributes have a special meaning since they are interpreted by Trilium. For example the <code>color</code> attribute will change the color of the note as displayed in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;and links, and <code>iconClass</code> will change the icon of a note.</li><li><strong>User-defined attributes</strong><br>These are free-form labels or relations that can be used by the user. They can be used purely for categorization purposes (especially if combined with&nbsp;<a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>), or they can be given meaning through the use of&nbsp;<a class=\"reference-link\" href=\"#root/_help_CdNpE2pqjmI6\">Scripting</a>.</li></ol><p>In practice, Trilium makes no direct distinction of whether an attribute is a system one or a user-defined one. A label or relation is considered a system attribute if it matches one of the built-in names (e.g. like the aforementioned <code>iconClass</code>). Keep this in mind when creating &nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>&nbsp;in order not to accidentally alter a system attribute (unless intended).</p><h2>Viewing the list of attributes</h2><p>Both the labels and relations for the current note are displayed in:</p><ul><li>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>, in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_uNtgN0cUKEBc\">Attributes tab</a>&nbsp;with a grid-like view.</li><li>A more advanced option, in&nbsp;<a class=\"reference-link\" href=\"#root/_help_AlJ73vBCjWDw\">Status bar</a>&nbsp;→&nbsp;<span class=\"tn-icon bx bx-list-check\"></span> (<em>Attributes</em>) where the attributes are displayed in a textual way, making it easy to copy them around or make batch modifications.<ul><li>In the list of attributes, labels are prefixed with the <code>#</code> character whereas relations are prefixed with the <code>~</code> character.</li></ul></li></ul><h2>Attribute Definitions and Promoted Attributes</h2><p><a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>&nbsp;create a form-like editing experience for attributes, which makes it easy to enhancing the organization and management of attributes</p><h2>Multiplicity</h2><p>Attributes in Trilium can be \"multi-valued\", meaning multiple attributes with the same name can co-exist. This can be combined with&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>&nbsp;to easily add them.</p><h2>Attribute Inheritance</h2><p>Trilium supports attribute inheritance, allowing child notes to inherit attributes from their parents. For more information, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_bwZpz2ajCEwO\">Attribute Inheritance</a>.</p>",
+ "_help_HI6GBBIduIgv": "<p>A label is an <a href=\"#root/_help_zEY4DaJG4YT5\">attribute</a> of a note which has a name and optionally a value.</p><h2>Common use cases</h2><ul><li><strong>Metadata for personal use</strong>: Assign labels with optional values for categorization, such as <code>#year=1999</code>, <code>#genre=\"sci-fi\"</code>, or <code>#author=\"Neal Stephenson\"</code>. This can be combined with&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>&nbsp;to make their display more user-friendly.</li><li><strong>Configuration</strong>: Labels can configure advanced features or settings (see reference below).</li><li><strong>Scripts and Plugins</strong>: Used to tag notes with special metadata, such as the \"weight\" attribute in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_R7abl2fc6Mxi\">Weight Tracker</a>.</li></ul><h2>Creating a label using the visual editor</h2><ol><li>Go to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_uNtgN0cUKEBc\">Attributes tab</a>&nbsp;in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>.</li><li>Press the&nbsp;<span class=\"tn-icon bx bx-plus\"></span> (Add attribute) button at the end of the list, or via the&nbsp;<span class=\"tn-icon bx bx-plus\"></span> button at the top-right of the section → <em>Add new label</em>.</li></ol><p>While in the visual editor:</p><ul><li>Set the desired name.</li><li>Optionally, set the value of the label. Labels can exist without a value.</li><li>Children can inherit this relation, click the relation and check <em>Inheritable</em>. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_bwZpz2ajCEwO\">Attribute Inheritance</a>&nbsp;for more information.</li></ul><aside class=\"admonition tip\"><p>Alternatively, press <kbd>Alt</kbd>+<kbd>L</kbd> which will open the attribute details (same view as when an existing attribute is clicked) in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_AlJ73vBCjWDw\">Status bar</a>.</p></aside><h2>Creating a label manually</h2><p>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_AlJ73vBCjWDw\">Status bar</a>, press the&nbsp;<span class=\"tn-icon bx bx-list-check\"></span> button to show the list of the attributes.</p><ul><li>Click the input box to focus it.</li><li>To create a label called <code>myLabel</code> with no value, simply type <code>#myLabel</code>.</li><li>To create a label called <code>myLabel</code> with a value <code>value</code>, simply type <code>#myLabel=value</code>.</li><li>If the value contains spaces, then the text must be quoted: <code>#myLabel=\"Hello world\"</code>.</li><li>If the string contains quotes (regardless of whether it has spaces), then the text must be quoted with apostrophes instead: <code>#myLabel='Hello \"world\"'</code>.</li><li>To create an inheritable label called <code>myLabel</code>, simply write <code>#myLabel(inheritable)</code> for no value or <code>#myLabel(inheritable)=value</code> if there is a value.</li></ul><h2>Predefined labels</h2><p>This is a list of labels that Trilium natively supports.</p><aside class=\"admonition tip\"><p>Some labels presented here end with a <code>*</code>. That means that there are multiple labels with the same prefix, consult the specific page linked in the description of that label for more information.</p></aside><figure class=\"table\"><table><thead><tr><th>Label</th><th>Description</th></tr></thead><tbody><tr><td><code>disableVersioning</code></td><td>Disables automatic creation of&nbsp;<a class=\"reference-link\" href=\"#root/_help_vZWERwf8U3nx\">Note Revisions</a>&nbsp;for a particular note. Useful for e.g. large, but unimportant notes - e.g. large JS libraries used for scripting.</td></tr><tr><td><code>versioningLimit</code></td><td>Limits the maximum number of&nbsp;<a class=\"reference-link\" href=\"#root/_help_vZWERwf8U3nx\">Note Revisions</a>&nbsp;for a particular note, overriding the global settings.</td></tr><tr><td><code>calendarRoot</code></td><td>Marks the note which should be used as root for&nbsp;<a class=\"reference-link\" href=\"#root/_help_l0tKav7yLHGF\">Day Notes</a>. Only one should be marked as such.</td></tr><tr><td><code>archived</code></td><td>Hides notes from default search results and dialogs. Archived notes can optionally be hidden in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.</td></tr><tr><td><code>excludeFromExport</code></td><td>Excludes this note and its children when exporting.</td></tr><tr><td><code>run</code>, <code>runOnInstance</code>, <code>runAtHour</code></td><td>See&nbsp;<a class=\"reference-link\" href=\"#root/_help_GPERMystNGTB\">Backend Events</a>.</td></tr><tr><td><code>disableInclusion</code></td><td>Scripts with this label won't be included into parent script execution.</td></tr><tr><td><code>sorted</code>, <code>sortDirection</code>, <code>sortFoldersFirst</code>, <code>sortNatural</code>, <code>sortLocale</code>, <code>top</code>, <code>bottom</code></td><td>Manages automatic/permanent sorting. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_aGlEvb9hyDhS\">Sorting Notes</a>.</td></tr><tr><td><code>hidePromotedAttributes</code></td><td>Hide&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>&nbsp;on this note. Generally useful when defining inherited attributes, but the parent note doesn't need them.</td></tr><tr><td><code>readOnly</code></td><td>Marks a note to always be <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a>, if it's a supported note (text, code, mermaid).</td></tr><tr><td><code>autoReadOnlyDisabled</code></td><td>Disables automatic <a href=\"#root/_help_CoFPLs3dRlXc\">read-only mode</a> for the given note.</td></tr><tr><td><code>appCss</code></td><td>Marks CSS notes which are loaded into the Trilium application and can thus be used to modify Trilium's looks. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_AlhDUqhENtH7\">Custom app-wide CSS</a>&nbsp;for more info.</td></tr><tr><td><code>appTheme</code></td><td>Marks CSS notes which are full Trilium themes and are thus available in Trilium options. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_pKK96zzmvBGf\">Theme development</a>&nbsp;for more information.</td></tr><tr><td><code>appThemeBase</code></td><td>Set to <code>next</code>, <code>next-light</code>, or <code>next-dark</code> to use the corresponding TriliumNext theme (auto, light or dark) as the base for a custom theme, instead of the legacy one. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_WFGzWeUK6arS\">Customize the Next theme</a>&nbsp;for more information.</td></tr><tr><td><code>customFont</code></td><td>Marks a font as selectable in the Options → Appearance font selection. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_w4rMEhJsALlA\">Personalizing the font</a>.</td></tr><tr><td><code>cssClass</code></td><td>Value of this label is then added as CSS class to the node representing given note in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>. This can be useful for advanced theming. Can be used in template notes.</td></tr><tr><td><code>iconClass</code></td><td>value of this label is added as a CSS class to the icon on the tree which can help visually distinguish the notes in the tree. Example might be bx bx-home - icons are taken from boxicons. Can be used in template notes.</td></tr><tr><td><code>pageSize</code></td><td>Specifies the number of items per page in&nbsp;<a class=\"reference-link\" href=\"#root/_help_0ESUbbAxVnoK\">Note List</a>.</td></tr><tr><td><code>customRequestHandler</code></td><td>See&nbsp;<a class=\"reference-link\" href=\"#root/_help_J5Ex1ZrMbyJ6\">Custom Request Handler</a>.</td></tr><tr><td><code>customResourceProvider</code></td><td>See&nbsp;<a class=\"reference-link\" href=\"#root/_help_d3fAXQ2diepH\">Custom Resource Providers</a>.</td></tr><tr><td><code>widget</code></td><td>Marks this note as a custom widget which will be added to the Trilium component tree. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_MgibgPcfeuGz\">Custom Widgets</a>&nbsp;for more information.</td></tr><tr><td><code>searchHome</code></td><td>New search notes will be created as children of this note (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a>).</td></tr><tr><td><code>workspace</code> and related attributes</td><td>See&nbsp;<a class=\"reference-link\" href=\"#root/_help_9sRHySam5fXb\">Workspaces</a>.</td></tr><tr><td><code>inbox</code></td><td>Default inbox location for new notes. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_S0Fos78ZfcY7\">Note Inbox</a>&nbsp;for more information.</td></tr><tr><td><code>sqlConsoleHome</code></td><td>Default location of&nbsp;<a class=\"reference-link\" href=\"#root/_help_YKWqdJhzi2VY\">SQL Console</a>&nbsp;saved queries.</td></tr><tr><td><code>bookmarked</code></td><td>Indicates this note is a <a href=\"#root/_help_u3YFHC9tQlpm\">bookmark</a>.</td></tr><tr><td><code>bookmarkFolder</code></td><td>Note with this label will appear in bookmarks as folder (allowing access to its children). See&nbsp;<a class=\"reference-link\" href=\"#root/_help_u3YFHC9tQlpm\">Bookmarks</a>&nbsp;for more information.</td></tr><tr><td><code>share*</code></td><td>See the attribute reference in&nbsp;<a class=\"reference-link\" href=\"#root/_help_R9pX4DGra2Vt\">Sharing</a>.</td></tr><tr><td><code>displayRelations</code>, <code>hideRelations</code></td><td>Comma delimited names of relations which should be displayed/hidden in a&nbsp;<a class=\"reference-link\" href=\"#root/_help_iRwzGnHPzonm\">Relation Map</a>&nbsp;(both the note type and the&nbsp;<a class=\"reference-link\" href=\"#root/_help_BCkXAVs63Ttv\">Note Map (Link map, Tree map)</a>&nbsp;general functionality).</td></tr><tr><td><code>titleTemplate</code></td><td>Default title of notes created as children of this note. This value is evaluated as a JavaScript string and thus can be enriched with dynamic content via the injected <code>now</code> and <code>parentNote</code> variables.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <br> <br>See&nbsp;<a class=\"reference-link\" href=\"#root/_help_47ZrP6FNuoG8\">Default Note Title</a>&nbsp;for more info.</td></tr><tr><td><code>template:titleTemplate</code></td><td>Set on a template note: default title of notes created from the template, taking precedence over the parent's <code>titleTemplate</code>. Evaluated the same way as <code>titleTemplate</code>. See <a class=\"reference-link\" href=\"#root/_help_47ZrP6FNuoG8\">Default Note Title</a>.</td></tr><tr><td><code>template</code></td><td>This note will appear in the selection of available template when creating new note. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>&nbsp;for more information.</td></tr><tr><td><code>color</code></td><td>defines color of the note in note tree, links etc. Use any valid CSS color value like 'red' or #a13d5f&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <br>Note: this color may be automatically adjusted when displayed to ensure sufficient contrast with the background.</td></tr><tr><td><code>keyboardShortcut</code></td><td>Defines a keyboard shortcut which will immediately jump to this note. Example: 'ctrl+alt+e'. Requires frontend reload for the change to take effect.</td></tr><tr><td><code>keepCurrentHoisting</code></td><td>Opening this link won't change hoisting even if the note is not displayable in the current hoisted subtree.</td></tr><tr><td><code>executeButton</code></td><td>Title of the button which will execute the current code note</td></tr><tr><td><code>executeDescription</code></td><td>Longer description of the current code note displayed together with the execute button</td></tr><tr><td><code>excludeFromNoteMap</code></td><td>Notes with this label will be hidden from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_bdUJEHsAPYQR\">Note Map</a>.</td></tr><tr><td><code>newNotesOnTop</code></td><td>New notes will be created at the top of the parent note, not on the bottom.</td></tr><tr><td><code>hideChildrenOverview</code></td><td>Hides the&nbsp;<a class=\"reference-link\" href=\"#root/_help_0ESUbbAxVnoK\">Note List</a>&nbsp;for that particular note.</td></tr><tr><td><code>subtreeHidden</code></td><td>Hides all child notes of this note from the tree, displaying a badge with the count of hidden children. Children remain accessible via search or direct links.</td></tr><tr><td><code>printLandscape</code></td><td>When exporting to PDF, changes the orientation of the page to landscape instead of portrait.</td></tr><tr><td><code>printPageSize</code></td><td>When exporting to PDF, changes the size of the page. Supported values: <code>A0</code>, <code>A1</code>, <code>A2</code>, <code>A3</code>, <code>A4</code>, <code>A5</code>, <code>A6</code>, <code>Legal</code>, <code>Letter</code>, <code>Tabloid</code>, <code>Ledger</code>.</td></tr><tr><td><code>printScale</code>, <code>printMargins</code></td><td>Additional printing options, generally configured through the&nbsp;<a class=\"reference-link\" href=\"#root/_help_NRnIZmSMc5sj\">Printing &amp; Exporting as PDF</a>&nbsp;dialog.</td></tr><tr><td><code>geolocation</code></td><td>Indicates the latitude and longitude of a note, to be displayed in a&nbsp;<a class=\"reference-link\" href=\"#root/_help_81SGnPGMk7Xc\">Geo Map</a>.</td></tr><tr><td><code>geoShape</code></td><td>Indicates the coordinates for the points of a <a href=\"#root/_help_C2H9HK4BzwG7\">shapec</a> drawn on the&nbsp;<a class=\"reference-link\" href=\"#root/_help_81SGnPGMk7Xc\">Geo Map</a>&nbsp;(e.g. area, rectangle, circle).</td></tr><tr><td><code>map:*</code></td><td>Defines specific options for the&nbsp;<a class=\"reference-link\" href=\"#root/_help_81SGnPGMk7Xc\">Geo Map</a>.</td></tr><tr><td><code>calendar:*</code></td><td>Defines specific options for the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xWbu3jpNWapp\">Calendar</a>.</td></tr><tr><td><code>viewType</code></td><td>Sets the view of child notes (e.g. grid or list). See&nbsp;<a class=\"reference-link\" href=\"#root/_help_0ESUbbAxVnoK\">Note List</a>&nbsp;for more information.</td></tr><tr><td><code>webViewSrc</code></td><td>Defines the URL of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_1vHRoWCEjj0L\">Web View</a>.</td></tr><tr><td><code>tabWidth</code>, <code>indentWithTabs</code>, <code>wrapLines</code></td><td>Per-note Code editor settings: indentation width, indent with tabs vs. spaces, and word wrapping. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>.</td></tr><tr><td><code>datePattern</code>, <code>weekPattern</code>, <code>monthPattern</code>, <code>quarterPattern</code>, <code>yearPattern</code></td><td>Customizes the title naming pattern of day / week / month / quarter / year notes. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_l0tKav7yLHGF\">Day Notes</a>.</td></tr><tr><td><code>enableWeekNote</code>, <code>enableQuarterNote</code></td><td>Enables optional week and quarter notes in the calendar hierarchy; set on the calendar root. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_l0tKav7yLHGF\">Day Notes</a>.</td></tr><tr><td><code>fullContentWidth</code></td><td>Expands the note to the full editor width, ignoring the configured content width (useful for wide tables). See&nbsp;<a class=\"reference-link\" href=\"#root/_help_t596jLvPrqkS\">Content width</a>.</td></tr><tr><td><code>iconPack</code></td><td>Identifies a custom icon pack by its prefix. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_g1mlRoU8CsqC\">Creating an icon pack</a>.</td></tr><tr><td><code>clipperInbox</code></td><td>Overrides the default location where the Web Clipper saves clippings (defaults to the day note). See&nbsp;<a class=\"reference-link\" href=\"#root/_help_MtPxeAWVAzMg\">Web Clipper</a>.</td></tr><tr><td><code>docName</code> , <code>docUrl</code></td><td>Used internally for the in-app help.</td></tr><tr><td><code>aiQuickAction</code></td><td>Defines a custom prompt to be used for the&nbsp;<a class=\"reference-link\" href=\"#root/_help_VRoP0g1uHHc2\">In-editor AI assistant</a>'s quick actions.</td></tr></tbody></table></figure>",
+ "_help_Cq5X6iKQop6R": "<p>A relation is similar to a <a href=\"#root/_help_HI6GBBIduIgv\">label</a>, but instead of having a text value it refers to another note.</p><h2>Common use cases</h2><ul><li><strong>Metadata Relationships for personal use</strong>: For example, linking a book note to an author note.<br>This can be combined with&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>&nbsp;to make their display more user-friendly.</li><li><strong>Configuration</strong>: For configuring some notes such as&nbsp;<a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a>, or configuring&nbsp;<a class=\"reference-link\" href=\"#root/_help_R9pX4DGra2Vt\">Sharing</a>&nbsp;or&nbsp;<a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>&nbsp;(see the list below).</li><li><strong>Scripting</strong>: Attaching scripts to events or conditions related to the note.</li></ul><h2>Creating a relation using the visual editor</h2><ol><li>Go to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_uNtgN0cUKEBc\">Attributes tab</a>&nbsp;in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>.</li><li>Press the&nbsp;<span class=\"tn-icon bx bx-plus\"></span> button (<em>Add a new attribute</em>) to the right of the <em>Owned attributes</em> section.</li><li>Select <em>Add new relation</em> for the relation.</li></ol><p>While in the visual editor, set the desired name and the <em>Target note</em> (the note to point to). Unlike labels, relations cannot exist with a target note.</p><p>Children can inherit this relation, click the relation and check <em>Inheritable</em>. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_bwZpz2ajCEwO\">Attribute Inheritance</a>&nbsp;for more information.</p><aside class=\"admonition tip\"><p>Alternatively, press <kbd>Alt</kbd>+<kbd>L</kbd> which will open the attribute details (same view as when an existing attribute is clicked) in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_AlJ73vBCjWDw\">Status bar</a>.</p></aside><h2>Creating a relation manually</h2><p>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_AlJ73vBCjWDw\">Status bar</a>, press the&nbsp;<span class=\"tn-icon bx bx-list-check\"></span> button to show the list of the attributes.</p><ul><li>To create a relation called <code>myRelation</code>:<ol><li>Click the input box to focus it.</li><li>Type <code>~myRelation=@</code> .</li><li>After this, an autocompletion box should appear.</li><li>Type the title of the note to point to and press <kbd>Enter</kbd> to confirm (or click the desired note).</li><li>Alternatively copy a note from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;and paste it after the <code>=</code> sign (without the <code>@</code> , in this case).</li></ol></li><li>To create an inheritable relation, follow the same steps as previously described but instead of <code>~myRelation</code> write <code>~myRelation(inheritable)</code>.</li></ul><h2>Predefined relations</h2><p>These relations are supported and used internally by Trilium.</p><figure class=\"table\"><table><thead><tr><th>Label</th><th>Description</th></tr></thead><tbody><tr><td><code>runOn*</code></td><td>See&nbsp;<a class=\"reference-link\" href=\"#root/_help_GPERMystNGTB\">Backend Events</a></td></tr><tr><td><code>template</code></td><td>note's attributes will be inherited even without a parent-child relationship, note's content and subtree will be added to instance notes if empty. See documentation for details.</td></tr><tr><td><code>template:newNoteDefaultParent</code></td><td>set on a template note, points to the note under which notes created from the template are placed when no other location is picked; when set several times, the note is cloned into every target. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>.</td></tr><tr><td><code>inherit</code></td><td>note's attributes will be inherited even without a parent-child relationship. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>&nbsp;for a similar concept. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_bwZpz2ajCEwO\">Attribute Inheritance</a>&nbsp;in the documentation.</td></tr><tr><td><code>renderNote</code></td><td>notes of type&nbsp;<a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a>&nbsp;will be rendered using a code note (HTML or script) and it is necessary to point using this relation to which note should be rendered</td></tr><tr><td><code>widget</code></td><td>Used in the context of custom&nbsp;<a class=\"reference-link\" href=\"#root/_help_4Gn3psZKsfSm\">Launch Bar Widgets</a>, to refer to the widget that will be rendered.</td></tr><tr><td><code>shareCss</code></td><td>CSS note which will be injected into the share page. CSS note must be in the shared sub-tree as well. Consider using <code>shareHiddenFromTree</code> and <code>shareOmitDefaultCss</code> as well.</td></tr><tr><td><code>shareJs</code></td><td>JavaScript note which will be injected into the share page. JS note must be in the shared sub-tree as well. Consider using <code>shareHiddenFromTree</code>.</td></tr><tr><td><code>shareHtml</code></td><td>HTML note which will be injected into the share page at locations specified by the <code>shareHtmlLocation</code> label. HTML note must be in the shared sub-tree as well. Consider using <code>shareHiddenFromTree</code>.</td></tr><tr><td><code>shareTemplate</code></td><td>Embedded JavaScript note that will be used as the template for displaying the shared note. Falls back to the default template. Consider using <code>shareHiddenFromTree</code>.</td></tr><tr><td><code>shareFavicon</code></td><td>Favicon note to be set in the shared page. Typically you want to set it to share root and make it inheritable. Favicon note must be in the shared sub-tree as well. Consider using <code>shareHiddenFromTree</code>.</td></tr></tbody></table></figure>",
+ "_help_bwZpz2ajCEwO": "<p>Inheritance refers to the process of having a <a href=\"#root/_help_HI6GBBIduIgv\">label</a> or a <a href=\"#root/_help_Cq5X6iKQop6R\">relation</a> shared across multiple notes, generally in parent-child relations (or anywhere if using templates).</p><h2>Standard Inheritance</h2><p>In Trilium, attributes can be automatically inherited by child notes if they have the <code>isInheritable</code> flag set to <code>true</code>. This means the attribute (a key-value pair) is applied to the note and all its descendants.</p><p>To make an attribute inheritable, simply use the visual editor for&nbsp;<a class=\"reference-link\" href=\"#root/_help_HI6GBBIduIgv\">Labels</a>&nbsp;or&nbsp;<a class=\"reference-link\" href=\"#root/_help_Cq5X6iKQop6R\">Relations</a>. Alternatively, the attribute can be manually defined where <code>#myLabel=value</code> becomes <code>#myLabel(inheritable)=value</code> when inheritable.</p><p>As an example, the <code>archived</code> label can be set to be inheritable, allowing you to hide a whole subtree of notes from searches and other dialogs by applying this label at the top level.</p><p>Standard inheritance forces all the notes that are children (and sub-children) of a note to have that particular label or relation. If there is a need to have some notes not inherit one of the labels, then <em>copying inheritance</em> or <em>template inheritance</em> needs to be used instead.</p><h2>Copying Inheritance</h2><p>Copying inheritance differs from standard inheritance by using a <code>child:</code> prefix in the attribute name. This prefix causes new child notes to automatically receive specific attributes from the parent note. These attributes are independent of the parent and will persist even if the note is moved elsewhere.</p><p>If a parent note has the label <code>#child:exampleAttribute</code>, all newly created child notes (one level deep) will inherit the <code>#exampleAttribute</code> label. This can be useful for setting default properties for notes in a specific section.</p><p>Similarly, for relations use <code>~child:myRelation</code>.</p><p>Due to the way it's designed, copying inheritance cannot be used to cascade infinitely within a hierarchy. For that use case, consider using either standard inheritance or templates.</p><h3>Chained inheritance</h3><p>It is possible to define labels across multiple levels of depth. For example, <code>#child:child:child:foo</code> applied to a root note would create:</p><ul><li><code>#child:child:foo</code> on the first-level children.</li><li><code>#child:foo</code> on the second-level children.</li><li><code>#foo</code> on the third-level children.</li></ul><p>Similarly, use <code>~child:child:child:foo</code> if dealing with relations.</p><p>Do note that same as simple copying inheritance, the changes will not apply retroactively to existing notes in the hierarchy, it will only apply to the newly created notes.</p><h2>Template Inheritance</h2><p>Attributes can also be inherited from&nbsp;<a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>. When a new note is created using a template, it inherits the attributes defined in that template. This is particularly useful for maintaining consistency across notes that follow a similar structure or function.</p>",
+ "_help_OFXdgB2nNk1F": "<figure class=\"image image_resized\" style=\"width:61.4%;\"><img style=\"aspect-ratio:938/368;\" src=\"{{helpAssets}}/User%20Guide/Advanced%20Usage/Attributes/Promoted%20Attributes_image.png\" width=\"938\" height=\"368\"></figure><p>Promoted attributes are <a href=\"#root/_help_zEY4DaJG4YT5\">attributes</a> which are displayed prominently in the UI which allow them to be easily viewed and edited.</p><p>The promoted attributes are shown underneath the&nbsp;<a class=\"reference-link\" href=\"#root/_help_l7pigIGu01K2\">Title</a>&nbsp;of the note, in a collapsible section. For full-height notes such as&nbsp;<a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a>, the promoted attributes are collapsed by default to make room.</p><p>One way of seeing promoted attributes is as a kind of form with several fields. Each field is just regular attribute, the only difference is that they appear on the note itself.</p><p>Attributes can be pretty useful since they allow for querying and script automation etc. but they are also inconveniently hidden. This allows you to select few of the important ones and push them to the front of the user.</p><h2>Attribute definition</h2><figure class=\"image image-style-align-right image_resized\" style=\"width:50%;\"><img style=\"aspect-ratio:885/742;\" src=\"{{helpAssets}}/User%20Guide/Advanced%20Usage/Attributes/2_Promoted%20Attributes_image.png\" width=\"885\" height=\"742\"></figure><p>In order to have promoted attributes, there needs to be a way to define them.</p><p>Technically, attributes are only name-value pairs where both name and value are strings.</p><p>The <em>Attribute definition</em> specifies how should this value be interpreted:</p><ul><li>Is it just string, or is it a date?</li><li>Should we allow multiple values or note?</li><li>Should we <em>promote</em> the attribute or not?</li></ul><h2>Types of attributes</h2><p>Attribute definitions have a dedicated type field which will change how the value will be edited in the promoted attributes section.</p><p>The following types are supported:</p><ul><li><em>Text</em>, the default option which allows any type of text to be edited, similar to normal labels that don't have a type associated.</li><li><em>Multi-line text</em>, similar to a normal text field, but rendered in a bigger text box that also supports writing on multiple lines.</li><li><em>Number</em>, will display as a number input field with up/down arrows.<ul><li>Optionally a <em>precision</em> which sets how many decimals the value steps by and is displayed with.</li></ul></li><li><em>Checkbox</em>, which renders as a checkbox for a true/false value. In the label definition, this type is written as <code>boolean</code>.</li><li><em>Select,</em> which provides a list of user-defined options when editing.<ul><li>The list is not fixed, meaning that new options can be easily added from the promoted attribute.</li><li>Renaming an option does not change the existing values since the value is stored as text. Consider a <a href=\"#root/_help_ivYnonVFBxbQ\">bulk rename</a>.</li><li>The items do not have a custom color or icon. This is intentional as selects are meant to be light-weight. For a more customizable option, consider using&nbsp;<a class=\"reference-link\" href=\"#root/_help_Cq5X6iKQop6R\">Relations</a>&nbsp;instead which use notes as items and those notes can be colorized and also carry an icon.</li></ul></li><li><em>Date,</em> which provides a date picker.</li><li><em>Date &amp; Time,</em> which provides a date &amp; time picker.</li><li><em>Time,</em> which provides a time picker.</li><li><em>URL,</em> which provides a button to open the web address in a new window.</li><li><em>Email</em>, which provides a button to quickly send an email to that address using your operating system's default app.</li><li><em>Phone</em>, which provides a button to quickly call that number using your operating system's default app.</li><li><em>Color</em>, which provides a color picker and a way to remove the value.</li><li><em>Relation</em>, which points to another note and uses&nbsp;<a class=\"reference-link\" href=\"#root/_help_Cq5X6iKQop6R\">Relations</a>&nbsp;instead of&nbsp;<a class=\"reference-link\" href=\"#root/_help_HI6GBBIduIgv\">Labels</a>.</li></ul><aside class=\"admonition note\"><p>For label-based attributes, these types are not enforced by the attribute system, meaning that changing the type afterwards does not guarantee that the values in it correspond to the type (e.g. turning a text into a number).</p></aside><h2>Multiple values</h2><p>When the definition allows multiple values, each value is shown as a chip and a new one is added in the box after them. Press the <span class=\"tn-icon bx bx-x\"></span> on a chip to remove that value.</p><ul><li>For free-form types such as <em>Text</em>, <em>Number</em> or <em>Date</em>, press <kbd>Enter</kbd> (or leave the field) to add what was typed. The same value can be added more than once, for example two payments of the same amount.</li><li>For <em>Select</em>, <em>Checkbox</em> and <em>Relation</em> attributes, a value is picked from the list rather than typed, and each one can be picked only once.</li></ul><h2>Creating a new promoted attribute definition</h2><p>To create a new promoted attribute:</p><ol><li>Go to a note.</li><li>Go to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_uNtgN0cUKEBc\">Attributes tab</a>&nbsp;in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>.</li><li>Press the&nbsp;<span class=\"tn-icon bx bx-plus\"></span> button for the top-most section (<em>Owned attributes</em>).</li><li>Select either <em>Add new label definition…</em> or <em>Add new relation definition…</em>.</li><li>Select the name which will be name of the label or relation that will be created when the promoted attribute is edited.</li><li>Ensure <em>Promoted</em> is checked in order to display it at the top of notes.</li><li>Optionally, choose an <em>Alias</em> which will be displayed next to the promoted attribute instead of the attribute name. Generally it's best to choose a “user-friendly” name since it can contain spaces and other characters which are not supported as attribute names.</li><li>Check <em>Inheritable</em> to apply it to this note and all its descendants. To keep it only for the current note, un-check it.</li><li>Press <em>Save &amp; Close</em> to apply the changes.</li></ol><p>Alternatively, promoted attributes can be created from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_AlJ73vBCjWDw\">Status bar</a>&nbsp;by going to&nbsp;<span class=\"tn-icon bx bx-list-check\"></span> (<em>Attributes</em>), pressing the&nbsp;<span class=\"tn-icon bx bx-plus\"></span> button and selecting <em>Add new label definition…</em>. The resulting attribute can also be copy-pasted or written manually (albeit discouraged).</p><h2>How attribute definitions actually work</h2><p>When a new promoted attribute definition is created, it creates a corresponding label prefixed with either <code>label</code> or <code>relation</code>, depending on the definition type:</p><pre><code class=\"language-text-x-trilium-auto\">#label:myColor(inheritable)=\"promoted,alias=Color,multi,color\"</code></pre><p>The only purpose of the attribute definition is to set up a template. If the attribute was marked as promoted, then it's also displayed to the user for easy editing.</p><figure class=\"table\"><table><tbody><tr><td><figure class=\"image\"><img style=\"aspect-ratio:495/157;\" src=\"{{helpAssets}}/User%20Guide/Advanced%20Usage/Attributes/1_Promoted%20Attributes_image.png\" width=\"495\" height=\"157\"></figure></td><td>Notice how the promoted attribute definition only creates a “Due date” box above the text content.</td></tr><tr><td><figure class=\"image\"><img style=\"aspect-ratio:663/160;\" src=\"{{helpAssets}}/User%20Guide/Advanced%20Usage/Attributes/3_Promoted%20Attributes_image.png\" width=\"663\" height=\"160\"></figure></td><td>Once a value is set by the user, a new label (or relation, depending on the type) is created. The name of the attribute matches one set when creating the promoted attribute.</td></tr></tbody></table></figure><p>So there's one attribute for value and one for definition. But notice how an definition attribute can be made <a href=\"#root/_help_bwZpz2ajCEwO\">Inheritable</a>, meaning that it's also applied to all descendant notes. In this case, the definition used for the whole sub-tree while \"value\" attributes are for each not individually.</p><h2>Using system attributes</h2><p>It's possible to create promoted attributes out of system attributes, to be able to easily alter them.</p><p>Here are a few practical examples:</p><ul><li><a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>&nbsp;already make use of this practice, for example:<ul><li>Calendars add “Start Date”, “End Date”, “Start Time” and “End Time” as promoted attributes. These map to system attributes such as <code>startDate</code> which are then interpreted by the calendar view.</li><li><a class=\"reference-link\" href=\"#root/_help_zP3PMqaG71Ct\">Presentation</a>&nbsp;adds a “Background” promoted attribute for each of the slide to easily be able to customize.</li></ul></li><li>The Trilium documentation (which is edited in Trilium) uses a promoted attribute to be able to easily edit the <code>#shareAlias</code> (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_R9pX4DGra2Vt\">Sharing</a>) in order to form clean URLs.</li><li>If you always edit a particular system attribute such as <code>#color</code>, simply create a promoted attribute for it to make it easier.</li></ul><h3>Inverse relation</h3><p>Some relations always occur in pairs - my favorite example is on the family. If you have a note representing husband and note representing wife, then there might be a relation between those two of <code>isPartnerOf</code>. This is bidirectional relationship - meaning that if a relation is pointing from husband to wife then there should be always another relation pointing from wife to husband.</p><p>Another example is with parent-child relationship. Again these always occur in pairs, but in this case it's not exact same relation - the one going from parent to child might be called <code>isParentOf</code> and the other one going from child to parent might be called <code>isChildOf</code>.</p><p>Relation definition allows you to specify such \"inverse relation\" - for the relation you just define you specify which is the inverse relation. Note that in the second example we should have two relation definitions - one for <code>isParentOf</code> which defines <code>isChildOf</code> as inverse relation and then second relation definition for <code>isChildOf</code> which defines <code>isParentOf</code> as inverse relation.</p><p>What this does internally is that whenever we save a relation which has defined inverse relation, we check that this inverse relation exists on the relation target note. Similarly, when we delete relation, we also delete inverse relation on the target note.</p><h2>See also</h2><ul><li>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a>&nbsp;collection makes heavy use of promoted attributes to define the columns of the table, since they already carry the type information. When made inheritable, it's also easy to change those fields when the child notes are opened.</li></ul>",
+ "_help_KC1HB96bqqHX": "<p>A template in Trilium serves as a predefined structure for other notes, referred to as instance notes. Assigning a template to a note brings three main effects:</p><ol><li><strong>Attribute Inheritance</strong>: All attributes from the template note are <a href=\"#root/_help_bwZpz2ajCEwO\">inherited</a> by the instance notes. Even attributes with <code>#isInheritable=false</code> are inherited by the instance notes, although only inheritable attributes are further inherited by the children of the instance notes.</li><li><strong>Content Duplication</strong>: The content of the template note is copied to the instance note, provided the instance note is empty at the time of template assignment.</li><li><strong>Child Note Duplication</strong>: All child notes of the template are deep-duplicated to the instance note.</li></ol><h2>Example</h2><p>A typical example would be a \"Book\" template note, which might include:</p><ul><li><strong>Promoted Attributes</strong>: Such as publication year, author, etc. (see <a href=\"#root/_help_OFXdgB2nNk1F\">promoted attributes</a>).</li><li><strong>Outline</strong>: An outline for a book review, including sections like themes, conclusion, etc.</li><li><strong>Child Notes</strong>: Additional notes for highlights, summary, etc.</li></ul><p><img src=\"{{helpAssets}}/User%20Guide/Advanced%20Usage/Templates_template.png\" alt=\"Template Example\"></p><h2>Instance Note</h2><p>An instance note is a note related to a template note. This relationship means the instance note's content is initialized from the template, and all attributes from the template are inherited.</p><p>To create an instance note through the UI:</p><p><img src=\"{{helpAssets}}/User%20Guide/Advanced%20Usage/Templates_template-create-instance-note.png\" alt=\"show child note templates\"></p><p>For the template to appear in the menu, the template note must have the <code>#template</code> label. Do not confuse this with the <code>~template</code> relation, which links the instance note to the template note. If you use <a href=\"#root/_help_9sRHySam5fXb\">workspaces</a>, you can also mark templates with <code>#workspaceTemplate</code> to display them only in the workspace.</p><p>Templates can also be added or changed after note creation by creating a <code>~template</code> relation pointing to the desired template note.&nbsp;</p><p>To specify a template for child notes, you can use a <code>~child:template</code> relation pointing to the appropriate template note. There is no limit to the depth of the hierarchy — you can use <code>~child:child:template</code>, <code>~child:child:child:template</code>, and so on.</p><aside class=\"admonition important\"><p>Changing the template hierarchy after the parent note is created will not retroactively apply to newly created child notes.<br>For example, if you initially use <code>~child:template</code> and later switch to <code>~child:child:template</code>, it will not automatically apply the new template to the grandchild notes. Only the structure present at the time of note creation is considered.</p></aside><h2>Default parent for new notes</h2><p>A template can gather the notes created from it in one place, instead of having them land wherever they happen to be created. To do so, add a <code>~template:newNoteDefaultParent</code> relation to the template note, pointing at the note that should hold the instances, for example a <em>Person</em> template pointing to a <em>People</em> note.</p><p>Adding the relation several times places the new note in every target, as&nbsp;<a class=\"reference-link\" href=\"#root/_help_IakOLONlIfGI\">Cloning Notes</a>. The relation can also be inherited (e.g. from a folder holding several templates), in which case a relation owned by the template itself replaces the inherited one. The default parent is only inherited from the template's ancestors in the tree: a template created from another template does not adopt that template's default parent.</p><p>The default parent is used whenever a note is created from the template through the <em>Choose note type</em> dialog:</p><ul><li>Via <code>@</code>-completion in a&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;note</li><li>Via the <em>Create note</em> or <em>Create child note</em> options of the note search (new tab or&nbsp;<a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>), but only if the default/empty location is set.</li></ul><p>Creating an instance note from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;context menu (<em>Insert child note</em>, <em>Insert note after</em>) still creates it at the chosen place.</p><p>Unlike the&nbsp;<a class=\"reference-link\" href=\"#root/_help_S0Fos78ZfcY7\">Note Inbox</a>, which holds quickly captured notes until they are sorted, the default parent is meant as the instances' permanent location.</p><h2>Regarding note types</h2><p>By default, newly created notes are&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes. If a parent note defines a <code>child:template</code> pointing to a template of a different type (e.g. a Code note), the behavior depends on how the new note is created:</p><ul><li>If no note type is explicitly chosen (e.g. the + button in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>), the template is applied and the new note takes the type and content of the template.</li><li>If a note type is explicitly selected (e.g.&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;→ <em>Insert note after</em> / <em>Insert child note</em>):<ul><li>If the selected type matches the template's type, the template is applied.</li><li>If the selected type differs, the template is disregarded entirely — the new note is an empty note of the selected type.</li></ul></li></ul><p>Selecting a specific template from the creation menu always takes precedence over <code>child:template</code>.</p><h2>Default title for new notes</h2><p>A template can also give its instances a default title, using the <code>#template:titleTemplate</code> label. See <a class=\"reference-link\" href=\"#root/_help_47ZrP6FNuoG8\">Default Note Title</a> for details.</p><h2>Additional Notes</h2><p>From a visual perspective, templates can define <code>#iconClass</code> and <code>#cssClass</code> attributes, allowing all instance notes (e.g., books) to display a specific icon and CSS style.</p><p>Explore the concept further in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_6tZeKvSHEUiB\">Demo Notes</a>, including examples like the&nbsp;<a class=\"reference-link\" href=\"#root/_help_iRwzGnHPzonm\">Relation Map</a>,&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYjQUYhpbUEW\">Task Manager</a>, and&nbsp;<a class=\"reference-link\" href=\"#root/_help_l0tKav7yLHGF\">Day Notes</a>.</p><p>Additionally, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_47ZrP6FNuoG8\">Default Note Title</a>&nbsp;for creating title templates. A <code>#titleTemplate</code> on a template note is passed on to its instances like any other label, so it names the children of each instance rather than the instances themselves; to name the instances, use <code>#template:titleTemplate</code>.</p>",
+ "_help_B2ORr7OVEZtc": "<p>Snippets let you define reusable pieces of text, Markdown or code that can be quickly inserted into your notes.</p>",
+ "_help_VQjhl61rlWh9": "<p>Markdown Snippets are closely related to&nbsp;<a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>, but instead of defining the content of an entire note, a snippet is a reusable piece of Markdown text that can easily be inserted into a&nbsp;<a class=\"reference-link\" href=\"#root/_help_6RM1Q7ppFVoj\">Markdown</a>&nbsp;note.</p><h2>Creating a Markdown snippet</h2><p>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>: </p><ol><li>Right-click the note where you want to place the snippet.</li><li>Select <em>Insert child note</em>.</li><li>Select <em>More</em> → <em>Markdown snippet</em>.</li></ol><p>Then simply type the desired content into the note.</p><p>The note's title becomes the title of the snippet. Optionally, you can add a description in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>&nbsp;section.</p><h2>Inserting a snippet</h2><p>To insert a snippet, type <code>/snippet</code> and select its title from the dropdown.</p><p><a class=\"reference-link\" href=\"#root/_help_IEgsWp5hHH35\">Code Snippets</a>&nbsp;with their language mode set to \"Plain text\" are also listed here.</p><h2>Limitations</h2><ul><li>Unlike&nbsp;<a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>, snippets cannot be limited to a particular <a href=\"#root/_help_9sRHySam5fXb\">workspace</a>.</li></ul>",
+ "_help_IEgsWp5hHH35": "<p>Code Snippets are closely related to&nbsp;<a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>, but instead of defining the content of an entire note, a snippet is a reusable piece of code that can easily be inserted into a&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;note.</p><h2>Creating a Code snippet</h2><p>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>: </p><ol><li>Right-click the note where you want to place the snippet.</li><li>Select <em>Insert child note</em>.</li><li>Select <em>More</em> → <em>Code snippet</em>.</li></ol><p>Then simply type the desired code into the note and set the correct language mode.</p><p>The note's title becomes the title of the snippet. Optionally, you can add a description in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>&nbsp;section.</p><h2>Inserting a snippet</h2><p>To insert a snippet, type <code>/snippet</code> and select its title from the dropdown.</p><aside class=\"admonition important\"><p>Only code snippets whose language mode matches the current code note are listed. For example, a CSS code note shows only CSS snippets, not JavaScript ones. The exception is snippets set to \"Plain text\", which are available in&nbsp;<a class=\"reference-link\" href=\"#root/_help_6RM1Q7ppFVoj\">Markdown</a>&nbsp;notes and any code note regardless of its language mode.</p></aside><h2>Limitations</h2><ul><li>Unlike&nbsp;<a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>, snippets cannot be limited to a particular <a href=\"#root/_help_9sRHySam5fXb\">workspace</a>.</li></ul>",
+ "_help_BCkXAVs63Ttv": "<p>Note map is a visualization of connections between notes. This provides an insight into a structure (\"web\") of notes.</p><p>There are two types of note map:</p><ul><li>Link Map, which shows relations between notes.</li><li>Note Map, which shows the hierarchical tree structure.</li></ul><h2>Accessing the note map</h2><p>The note map comes into multiple flavors:</p><ul><li>The note map is available in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_KRlZFoIH0j6p\">Connections tab</a>&nbsp;in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>, in the <em>Note map</em> section.<ul><li>It can also be accessed by going to&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>&nbsp;→ <em>Note map</em>, which will focus the sidebar at the right section.</li></ul></li><li>To display a full-screen note map, there is a <a href=\"#root/_help_bdUJEHsAPYQR\">dedicated note type</a> with the same name.</li><li>To view the global note map (of all the notes in the knowledge base), there is a dedicated <em>Note map</em> button in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>.</li></ul><h2>Terminology and structure</h2><ul><li>Each note is represented as a <em>node</em> in the graph, with the title displayed underneath.<ul><li>When the map is zoomed out, the title can still be viewed by hovering over the node.</li><li>The <a href=\"#root/_help_p9kXRFAkwN4o\">icon and color</a> of the note are respected.</li></ul></li><li>The root node is the reference point for which the relations and hierarchical structure are displayed.<ul><li>When accessing the note map through the&nbsp;<a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>, the root node is the current note.</li><li>When using a dedicated&nbsp;<a class=\"reference-link\" href=\"#root/_help_bdUJEHsAPYQR\">Note Map</a>&nbsp;note, the root note can be either the parent note, the currently <a href=\"#root/_help_OR8WJ7Iz9K4U\">hoisted</a> note or a specific note. See the note type documentation for more information.</li></ul></li></ul><h2>Interaction</h2><ul><li>Nodes can be dragged around, but they will return to their original position once released.<ul><li>To have the notes remain in the same position as they were dragged, press the <em>Fix nodes</em> button. The position of the notes is not saved, so it will return to normal once you navigate to another note or restart the application.</li></ul></li><li>When hovering over a node, the adjacent relations and nodes are highlighted.</li><li>The distance between nodes can be adjusted via the slider in the bottom-left. Similarly, this value is not saved.</li><li>To zoom, use the mouse wheel, pinch on a touch screen, or press the <span class=\"tn-icon bx bx-plus-circle\"></span> and <span class=\"tn-icon bx bx-minus-circle\"></span> buttons in the bottom-right corner.<ul><li>To bring the whole map back into view, press the <span class=\"tn-icon bx bx-scan\"></span> <em>Fit to view</em> button next to them.</li><li>The zoom buttons are not shown on mobile, where pinching zooms instead. The <em>Fit to view</em> button is always shown.</li></ul></li><li><a class=\"reference-link\" href=\"#root/_help_MKmLg5x6xkor\">Archived Notes</a>&nbsp;are generally ignored by the note map in order to reduce clutter. There is one exception: if the root note is also archived, then all archived notes are displayed too.</li></ul><h2>Link Map</h2><img src=\"{{helpAssets}}/User%20Guide/Advanced%20Usage/Note%20Map%20(Link%20map%2C%20Tree%20map)_image.png\" width=\"1425\" height=\"1093\"><p>The link map is a visualization of links and&nbsp;<a class=\"reference-link\" href=\"#root/_help_Cq5X6iKQop6R\">Relations</a>&nbsp;incoming to and outgoing from a particular note.</p><p>The map indicates the following types of relations:</p><ul><li><a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>&nbsp;between notes.</li><li><a class=\"reference-link\" href=\"#root/_help_Cq5X6iKQop6R\">Relations</a></li></ul><p>The link map will also show unlinked notes that are part of the hierarchy as a cloud of unconnected dots. On the&nbsp;<a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>&nbsp;deliberately omits this in order to save some space, but they will be revealed once the map is maximized.</p><h2>Tree Map</h2><p>Shows hierarchical map of notes:</p><figure class=\"image\"><img style=\"aspect-ratio:1420/1490;\" src=\"{{helpAssets}}/User%20Guide/Advanced%20Usage/1_Note%20Map%20(Link%20map%2C%20Tree%20map)_image.png\" width=\"1420\" height=\"1490\"></figure><h2>See also</h2><ul><li>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&nbsp;<a class=\"reference-link\" href=\"#root/_help_bdUJEHsAPYQR\">Note Map</a>&nbsp;for more information.</li><li><a class=\"reference-link\" href=\"#root/_help_iRwzGnHPzonm\">Relation Map</a>&nbsp;is a similar concept, with some differences:<ul><li>note map is automatically generated while relation map must be created manually</li><li>relation map is a type of note while a link map is just virtual visualization</li></ul></li></ul>",
+ "_help_R9pX4DGra2Vt": "<p>Trilium allows you to share selected notes as <strong>publicly accessible</strong> read-only documents. This feature is particularly useful for publishing content directly from your Trilium notes, making it accessible to others online.</p><figure class=\"image\"><img style=\"aspect-ratio:1144/660;\" src=\"{{helpAssets}}/User%20Guide/Advanced%20Usage/Sharing_image.png\" width=\"1144\" height=\"660\"></figure><h2>Features, interaction and limitations</h2><ul><li>Searching by note title.</li><li>Light and dark mode, following the visitor's system setting by default, also while the page is open. The visitor can pick <em>Light</em>, <em>Dark</em> or <em>System</em> with the buttons at the top of the navigation pane; the choice is remembered by the browser.</li><li>A layout centered on wide screens, with the navigation tree and the table of contents at either side of the content, and a mobile-friendly layout on narrow ones. There, the navigation tree slides in from the menu button in the header, and lists the headings of the current page below its entry (at the top of the pane, for a page the tree does not show).</li><li>Collapsible tree with the same note icons as the application. It keeps the sections the visitor expanded and its scroll position while they move between the pages of the site, and shows the current note.</li><li>Customizable logo.</li><li>Quick navigation buttons (previous and next note).</li><li>Notes that hide their children from the tree with <code>#subtreeHidden</code> (such as a <a class=\"reference-link\" href=\"#root/_help_CtBQqbwXDx1w\">Kanban Board</a>) show a badge counting them in place of listing them. The page of one of those children shows only that child below its parent, and the previous and next buttons skip them.</li><li>The subpages of a text or code note shown below its content as cards, as in the application. Each card shows the icon of the subpage and the start of its text (or its <code>#shareDescription</code>), or, for a subpage without text, links to its own first subpages. The cards can be hidden with <code>#hideChildrenOverview</code>.</li><li>Displaying the date of the last update of the note, written out in the application's language.</li><li>Marking the page with the application's language and its text direction, and the content of the note with its own <a href=\"#root/_help_veGu4faJErEM\">content language</a>, for screen readers and right-to-left text.</li></ul><h3>By note type</h3><figure class=\"table\"><table class=\"ck-table-resized\"><colgroup><col style=\"width:19.92%;\"><col style=\"width:41.66%;\"><col style=\"width:38.42%;\"></colgroup><thead><tr><th>&nbsp;</th><th>Supported features</th><th>Limitations</th></tr></thead><tbody><tr><th><a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a></th><td><ul><li>Table of contents.</li><li>A link next to each heading, shown while the pointer is over the heading. Clicking it shows the address of the section in the address bar of the browser and copies it, to share a link to the section.</li><li>Syntax highlight of code blocks, in the language selected for each block and in the colors of the VS Code light or dark theme, following the page's mode. For “Auto-detected” blocks, the language is guessed among the ones enabled in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Code Notes</em>; a language not enabled there is not highlighted.</li><li>Rendering for math equations.</li><li><a href=\"#root/_help_nBAXQFj20hS1\">Including notes</a> (only if the included notes are also shared).</li><li>Drawing canvases, shown as pictures at their own size.</li><li>Mermaid diagrams in code blocks, drawn in the page's light or dark mode and redrawn when the visitor switches it.</li></ul></td><td>&nbsp;</td></tr><tr><th><a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a></th><td><ul><li>Basic support (displaying the contents of the note in a monospace font).</li></ul></td><td><ul><li>No syntax highlight.</li></ul></td></tr><tr><th><a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a></th><td>Not supported.</td><td>&nbsp;</td></tr><tr><th><a class=\"reference-link\" href=\"#root/_help_iRwzGnHPzonm\">Relation Map</a></th><td>Not supported.</td><td>&nbsp;</td></tr><tr><th><a class=\"reference-link\" href=\"#root/_help_bdUJEHsAPYQR\">Note Map</a></th><td>Not supported.</td><td>&nbsp;</td></tr><tr><th><a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a></th><td>Not supported.</td><td>&nbsp;</td></tr><tr><th><a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a></th><td><ul><li>The child notes are shown as cards, or as a list when the view type of the collection is <em>List</em>. Each shows its icon and the start of its text (or its <code>#shareDescription</code>), or, for a child note without text, links to its own first child notes.</li></ul></td><td><ul><li>The calendar, table, board, geo map, dashboard and presentation view types are shown as in the app, but read-only.</li></ul></td></tr><tr><th><a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a></th><td><ul><li>The diagram is drawn in the page's light or dark mode and redrawn when the visitor switches it. In browsers with JavaScript disabled, the image saved when the note was last edited is shown instead, and the source of the diagram can be expanded below it.</li><li>The diagram fills the page and can be zoomed with the <span class=\"tn-icon bx bx-minus-circle\"></span> and <span class=\"tn-icon bx bx-plus-circle\"></span> buttons in its bottom corner or with the mouse wheel, between 50% and 1000% of its fitted size, and on touch screens by pinching. Clicking the percentage between the buttons, or double-clicking the diagram, shows it whole again. The diagram can be panned by dragging it.</li></ul></td><td>&nbsp;</td></tr><tr><th><a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a></th><td><ul><li>The diagram is displayed as a vector image.</li></ul></td><td><ul><li>No further interaction supported.</li></ul></td></tr><tr><th><a class=\"reference-link\" href=\"#root/_help_1vHRoWCEjj0L\">Web View</a></th><td>Not supported.</td><td>&nbsp;</td></tr><tr><th><a class=\"reference-link\" href=\"#root/_help_gBbsAeiuUxI5\">Mind Map</a></th><td>The diagram is displayed as a vector image.</td><td><ul><li>No further interaction supported.</li></ul></td></tr><tr><th><a class=\"reference-link\" href=\"#root/_help_81SGnPGMk7Xc\">Geo Map</a></th><td>Not supported.</td><td>&nbsp;</td></tr><tr><th><a class=\"reference-link\" href=\"#root/_help_W8vYD3Q1zjCR\">File</a></th><td>Basic interaction (downloading the file).</td><td><ul><li>No further interaction supported.</li></ul></td></tr></tbody></table></figure><p>While the sharing feature is powerful, it has some limitations:</p><ul><li><strong>Code Notes</strong>: No syntax highlighting.</li><li><strong>Static Note Tree</strong></li><li><strong>Protected Notes</strong>: Cannot be shared.</li><li><strong>Include Notes</strong>: Not supported.</li></ul><p>Some of these limitations may be addressed in future updates.</p><h2>Prerequisites</h2><p>To use the sharing feature, you must have a&nbsp;<a class=\"reference-link\" href=\"#root/_help_WOcw2SLH6tbX\">Server Installation</a>&nbsp;of Trilium. This is necessary because the notes will be hosted from the server.</p><h2>Sharing a note</h2><ol><li><p><strong>Enable Sharing</strong>: To share a note, toggle the <code>Shared</code> switch within the note's interface. Once sharing is enabled, an URL will appear, which you can click to access the shared note.</p><p><img src=\"{{helpAssets}}/User%20Guide/Advanced%20Usage/Sharing_share-single-note.png\" alt=\"Share Note\"></p></li><li><p><strong>Access the Shared Note</strong>: The link provided will open the note in your browser. If your server is not configured with a public IP, the URL will refer to <code>localhost (127.0.0.1)</code>.</p></li></ol><h2>Sharing a note subtree</h2><p>When you share a note, you actually share the entire subtree of notes beneath it. If the note has child notes, they will also be included in the shared content. For example, sharing the \"Formatting\" subtree will display a page with basic navigation for exploring all the notes within that subtree.</p><h2>Viewing and managing shared notes</h2><p>You can view a list of all shared notes by clicking on \"Show Shared Notes Subtree\" in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a>. This allows you to manage and navigate through all the notes you have made public.</p><h2>Security considerations</h2><ul><li>Shared notes are published on the open internet and can be accessed by anyone with the URL unless the notes are password-protected.</li><li>The URL's randomness does not provide security, so it is crucial not to share sensitive information through this feature.</li><li>Trilium takes precautions to protect your publicly shared instance from leaking information for non-shared notes, including opening a separate read-only connection to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_wX4HbRucYSDD\">Database</a>. Depending on your threat model, it might make more sense to use&nbsp;<a class=\"reference-link\" href=\"#root/_help_ycBFjKrrwE9p\">Exporting static HTML for web publishing</a>&nbsp;and use battle-tested web servers such as Nginx or Apache to serve static content.</li></ul><h3>Password protection</h3><p>To protect shared notes with a username and password, you can use the <code>#shareCredentials</code> attribute. Add this label to the note with the format <code>#shareCredentials=\"username:password\"</code>. To protect an entire subtree, make sure the label is <a href=\"#root/_help_bwZpz2ajCEwO\">inheritable</a>.</p><h2>Advanced sharing options</h2><h3>Customizing the appearance of shared notes</h3><p>The default design should be a good starting point, but you can customize it using your own CSS:</p><ul><li><strong>Custom CSS</strong>: Link a CSS&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;note to the shared page by adding a <code>~shareCss</code> relation to the note. If you want this style to apply to the entire subtree, make the label inheritable. You can hide the CSS code note from the tree navigation by adding the <code>#shareHiddenFromTree</code> label.</li><li><strong>Omitting Default CSS</strong>: For extensive styling changes, use the <code>#shareOmitDefaultCss</code> label to avoid conflicts with Trilium's <a href=\"#root/_help_Wy267RK4M69c\">default stylesheet</a>.</li></ul><h3>Adding JavaScript</h3><p>You can inject custom JavaScript into the shared note using the <code>~shareJs</code> relation. This allows you to access note attributes or traverse the note tree using the <code>fetchNote()</code> API, which retrieves note data based on its ID.</p><h3>Adding custom HTML</h3><p>You can inject custom HTML snippets into specific locations of the shared page using the <code>~shareHtml</code> relation. The HTML note should contain the raw HTML content you want to inject, and you can control where it appears by adding the <code>#shareHtmlLocation</code> label to the HTML snippet note itself.</p><p>The <code>#shareHtmlLocation</code> label accepts values in the format <code>location:position</code>:</p><ul><li><strong>Locations</strong>: <code>head</code>, <code>body</code>, <code>content</code></li><li><strong>Positions</strong>: <code>start</code>, <code>end</code></li></ul><p>For example:</p><ul><li><code>#shareHtmlLocation=head:start</code> - Injects HTML at the beginning of the <code>&lt;head&gt;</code> section</li><li><code>#shareHtmlLocation=head:end</code> - Injects HTML at the end of the <code>&lt;head&gt;</code> section (default)</li><li><code>#shareHtmlLocation=body:start</code> - Injects HTML at the beginning of the <code>&lt;body&gt;</code> section</li><li><code>#shareHtmlLocation=content:start</code> - Injects HTML at the beginning of the content area</li><li><code>#shareHtmlLocation=content:end</code> - Injects HTML at the end of the content area</li></ul><p>If no location is specified, the HTML will be injected at <code>content:end</code> by default.</p><p>Example:</p><pre><code class=\"language-text-javascript\">const currentNote = await fetchNote();\nconst parentNote = await fetchNote(currentNote.parentNoteIds[0]);\n\nfor (const attr of parentNote.attributes) {\n console.log(attr.type, attr.name, attr.value);\n}</code></pre><h3>Custom share templates</h3><p>To completely redesign the share, it is possible to create or use an existing <a href=\"#root/_help_Ad7Ku5gOHrDU\">custom share template</a>.</p><h3>Creating human-readable URL aliases</h3><p>Shared notes typically have URLs like <code>http://domain.tld/share/knvU8aJy4dJ7</code>, where the last part is the note's ID. You can make these URLs more user-friendly by adding the <code>#shareAlias</code> label to individual notes (e.g., <code>#shareAlias=highlighting</code>). This will change the URL to <code>http://domain.tld/share/highlighting</code>. The URL with the note's ID keeps working and redirects to the alias.</p><p><strong>Important</strong>:</p><ol><li>Ensure that aliases are unique.</li><li>Using slashes (<code>/</code>) within aliases to create subpaths is not supported.</li></ol><aside class=\"admonition tip\"><ul><li>To easily identify pages that don't have a share alias, run a&nbsp;<a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>&nbsp;with <code>#!shareAlias</code>.</li><li>To be able to enter the share alias faster, consider using&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>&nbsp;(for example <code>#label:shareAlias(inheritable)=\"promoted,alias=Slug,single,text\"</code>).</li></ul></aside><h3>Setting a custom favicon</h3><p>To customize the favicon for your shared pages, create a relation <code>~shareFavicon</code> pointing to a file note containing the favicon (e.g., in <code>.ico</code> format).</p><h3>Sharing a note as the root</h3><p>You can designate a specific note or folder as the root of your shared content by adding the <code>#shareRoot</code> label. This note will be linked when visiting <code>[http://domain.tld/share](http://domain/share)</code>, making it easier to use Trilium as a fully-fledged website.</p><aside class=\"admonition tip\"><p>Consider combining this with the <code>#shareIndex</code> label, which will display a list of all shared notes.</p></aside><h3>Displaying an index of shared notes</h3><p>When accessing a share, the sub-notes will be displayed in a tree on the left. But since multiple note trees can be shared, it might be useful to display a list of all the different share trees.</p><p>To do so, create a shared text note and apply the <code>shareIndex</code> label. When viewed, the list of shared roots will be displayed at the bottom of the note.</p><h3>Linking to an external website</h3><p>Sometimes it's useful to include a link to an external website alongside your shared notes — for example in the shared navigation or in an index. To do so, add the <code>#shareExternalLink</code> label to a note, with the target URL as its value (e.g. <code>#shareExternalLink=\"https://example.com\"</code>).</p><p>Any link pointing to this note will then redirect to the external website and open in a new browser tab, instead of opening the note's own shared page. Opening the note's shared URL by its ID also redirects to the external website. This applies to:</p><ul><li>the listing produced by the <code>#shareIndex</code> label;</li><li>the navigation tree of the shared site;</li><li>the \"Subpages\" list shown under a parent note;</li><li>inline links to this note from within other shared notes.</li></ul><p>The URL must be absolute and include the scheme (e.g. <code>https://</code>).</p><aside class=\"admonition note\"><p>The note still exists in the share tree and its own page remains reachable by its direct URL — the label only changes how links to it behave.</p></aside><h2>Attribute reference</h2><figure class=\"table\"><table class=\"ck-table-resized\"><colgroup><col style=\"width:18.38%;\"><col style=\"width:81.62%;\"></colgroup><thead><tr><th>Attribute</th><th>Description</th></tr></thead><tbody><tr><td><code>#shareHiddenFromTree</code></td><td>this note is hidden from the left navigation tree, from its parent's list of subpages, from shared note maps and from the share's search, but still accessible with its URL</td></tr><tr><td><code>#shareExternalLink</code></td><td>when a link points to this note (from the share index, a subpage list, or an inline link in another shared note), it redirects to the given external URL in a new tab instead of the note's shared page. Value is the absolute URL, e.g. <code>https://example.com</code>.</td></tr><tr><td><code>#shareAlias</code></td><td>define an alias using which the note will be available under <code>https://your_trilium_host/share/[your_alias]</code></td></tr><tr><td><code>#shareOmitDefaultCss</code></td><td>default share page CSS will be omitted. Use when you make extensive styling changes.</td></tr><tr><td><code>#shareRoot</code></td><td>marks note which is served on /share root.</td></tr><tr><td><code>#shareDescription</code></td><td>define text to be added to the HTML meta tag for description. It also describes the note in the list of subpages of its parent, in place of the start of its text.</td></tr><tr><td><code>#shareRaw</code></td><td>Note will be served in its raw format, without HTML wrapper. See also&nbsp;<a class=\"reference-link\" href=\"#root/_help_Qjt68inQ2bRj\">Serving directly the content of a note</a>&nbsp;for an alternative method without setting an attribute.</td></tr><tr><td><code>#shareDisallowRobotIndexing</code></td><td><p>Indicates to web crawlers that the page should not be indexed of this note by:</p><ul><li>Setting the <code>X-Robots-Tag: noindex</code> HTTP header.</li><li>Setting the <code>noindex, follow</code> meta tag.</li></ul></td></tr><tr><td><code>#shareCredentials</code></td><td>require credentials to access this shared note. Value is expected to be in format <code>username:password</code>. Don't forget to make this inheritable to apply to child-notes/images.</td></tr><tr><td><code>#shareIndex</code></td><td>Note with this label will list all roots of shared notes.</td></tr><tr><td><code>#shareHtmlLocation</code></td><td>defines where custom HTML injected via <code>~shareHtml</code> relation should be placed. Applied to the HTML snippet note itself. Format: <code>location:position</code> where location is <code>head</code>, <code>body</code>, or <code>content</code> and position is <code>start</code> or <code>end</code>. Defaults to <code>content:end</code>.</td></tr></tbody></table></figure><h3>Customizing logo</h3><p>It's possible to adjust the logo which is displayed above the navigation tree (in the header, on a narrow screen).</p><figure class=\"table\"><table><thead><tr><th>Attribute</th><th>Description</th></tr></thead><tbody><tr><td><code>~shareLogo</code></td><td>Relation set to an image to use as logo. The image must be part of the share tree (it can be hidden if needed). Without it, the logo is the icon of the shared root note.</td></tr><tr><td><code>#shareLogoWidth</code></td><td>The width of the logo, as a number without unit. With <code>#shareLogoHeight</code>, it sets the proportions of the logo, which is shown 32 pixels wide. Default is <code>53</code>.</td></tr><tr><td><code>#shareLogoHeight</code></td><td>The height of the logo, as a number without unit. With <code>#shareLogoWidth</code>, it sets the proportions of the logo. Default is <code>40</code>.</td></tr><tr><td><code>#shareRootLink</code></td><td>URL to navigate to when the logo is pressed.</td></tr></tbody></table></figure><h3>Customizing OpenGraph</h3><p>A meta-property is left out of the page when its attribute is not set. Without an image, link previews use a small card.</p><figure class=\"table\"><table><thead><tr><th>Attribute</th><th>Description</th></tr></thead><tbody><tr><td><code>#shareOpenGraphColor</code></td><td>This adjusts the <code>theme-color</code> meta-property.</td></tr><tr><td><code>#shareOpenGraphURL</code></td><td>This adjusts the <code>og:url</code> and <code>twitter:url</code> meta-properties. It is also the address a relative <code>og:image</code> is completed with, so it should be the public address of the shared site, such as <code>https://example.com/share/</code>.</td></tr><tr><td><code>#shareOpenGraphDomain</code></td><td>Adjusts the <code>twitter:domain</code> meta-property.</td></tr><tr><td><code>#shareOpenGraphImage</code>&nbsp; <br><code>~shareOpenGraphImage</code></td><td>Can be either a label with the address of an image, or a relation to an image&nbsp;<a class=\"reference-link\" href=\"#root/_help_W8vYD3Q1zjCR\">File</a>. This controls the <code>og:image</code> meta-property. Sites that show a preview of the link load the image from their own servers, so a relative address, which the relation always gives, is completed with <code>#shareOpenGraphURL</code>; without it, the image does not show in such previews.</td></tr></tbody></table></figure><h2>Credits</h2><p>Since v0.95.0, a new theme was introduced (and enabled by default) which greatly improves the visual aspect of the Share feature, as well as its functionality (such as mobile support, dark/light mode, collapsible tree, etc.). This theme is an adaptation of the <a href=\"https://github.com/zerebos/trilium.rocks\">Trilium Rocks!</a> by <a href=\"https://github.com/zerebos\">zerebos</a>.</p>",
+ "_help_Qjt68inQ2bRj": "<p>When accessing a shared note, Trilium will render it as a web page. Sometimes it's desirable to serve the content directly so that it can be used in a script or downloaded by the user.</p><figure class=\"table\"><table><thead><tr><th>A note displayed as a web page (HTML)</th><th>A note displayed as a raw format</th></tr></thead><tbody><tr><td><figure class=\"image\"><img style=\"aspect-ratio:738/275;\" src=\"{{helpAssets}}/User%20Guide/Advanced%20Usage/Sharing/Serving%20directly%20the%20content%20of%20a%20note_image.png\" width=\"738\" height=\"275\"></figure></td><td><img src=\"{{helpAssets}}/User%20Guide/Advanced%20Usage/Sharing/Serving%20directly%20the%20content%20of%20a%20note_image.jpg\"></td></tr></tbody></table></figure><h2>By adding an attribute to the note</h2><p>Simply add the <code>#shareRaw</code> attribute and the note will always be rendered <em>raw</em> when accessed from the share URL.</p><h2>By altering the URL</h2><p>Append <code>?raw</code> to the URL to display a note in its raw format regardless of whether the <code>#shareRaw</code> attribute is added on the note.</p><p><img src=\"{{helpAssets}}/User%20Guide/Advanced%20Usage/Sharing/Serving%20directly%20the%20content%20of%20a%20note_image.jpg\"></p>",
+ "_help_ycBFjKrrwE9p": "<p>As described in&nbsp;<a class=\"reference-link\" href=\"#root/_help_R9pX4DGra2Vt\">Sharing</a>, Trilium can act as a public server in which the shared notes are displayed in read-only mode. While this can work in most cases, it's generally not meant for high-traffic websites and since it's running on a Node.js server it can be potentially exploited.</p><p>Another alternative is to generate static HTML files (just like other static site generators such as <a href=\"https://www.mkdocs.org/\">MkDocs</a>). Since the normal HTML ZIP export does not contain any styling or additional functionality, Trilium provides a way to export the same layout and style as the&nbsp;<a class=\"reference-link\" href=\"#root/_help_R9pX4DGra2Vt\">Sharing</a>&nbsp;function into static HTML files.</p><p>Apart from the enhanced security, these HTML files are also easy to deploy on “serverless” deployments such as GitHub Pages or CloudFlare Pages and cache very easily.</p><aside class=\"admonition tip\"><p>Trilium's documentation, available at <a href=\"https://docs.triliumnotes.org/\">docs.triliumnotes.org</a> is built using this function of exporting to static HTML files which are then deployed automatically to CloudFlare Pages.</p><p>The process is <a href=\"https://github.com/TriliumNext/Trilium/blob/main/apps/edit-docs/src/build-docs.ts\">automated</a> by importing the Markdown documentation and exporting it via a script to the static web format.</p></aside><h2>Differences from normal sharing</h2><p>Apart from normal&nbsp;<a class=\"reference-link\" href=\"#root/_help_R9pX4DGra2Vt\">Sharing</a>, exporting to static HTML files comes with a few subtle differences:</p><ul><li>The URL structure is different. Where in normal sharing it's something along the way of <code>example.com/share/noteid</code>, the notes follow an hierarchical structure, such as <code>docs.triliumnotes.org/user-guide/concepts/navigation/tree-concepts</code>.</li><li>The <code>favicon.ico</code> is not handled automatically, it needs to be manually added on the server after the export is generated.</li><li>The “Last updated” for notes is not available.</li><li>The search functionality works slightly different since the normal one requires an active API to work. In the static export, search still works but uses a different mechanism so results might be different.</li></ul><h2>Differences from normal .zip export</h2><ul><li>The name of the files/URLs will prefer <code>shareAlias</code> to allow for clean URLs.</li><li>The export requires a functional web server as the pages will not render properly if accessed locally via a web browser due to the use of module scripts.</li><li>The directory structure is also slightly different:<ul><li>A normal HTML export results in an index file and a single directory.</li><li>Instead, for static exporting the top-root level becomes the index file and the child directories are on the root instead.</li><li>This makes it possible to easily publish to a website, without forcing everything but the root note to be in a sub-directory.</li></ul></li></ul><h2>Testing locally</h2><p>As mentioned previously, the exported static pages require a website to function. In order to test locally, a web server needs to be used.</p><p>One example is to use the Node.js-based <a href=\"https://www.npmjs.com/package/http-server\"><code>http-server</code></a> which can be installed via:</p><pre><code class=\"language-text-x-trilium-auto\">npm i -g http-server</code></pre><p>Once installed simply:</p><ol><li>Extract the exported .zip file.</li><li>Inside the extracted directory, run <code>http-server</code>.</li><li>Access the indicated address (e.g. <a href=\"http://localhost:8080\">http://localhost:8080</a>).</li></ol><h2>Automation</h2><p><a class=\"reference-link\" href=\"#root/_help_pgxEVkzLl1OP\">ETAPI (REST API)</a>&nbsp;could potentially be used to automate an export on a scheduled task.</p>",
+ "_help_sLIJ6f1dkJYW": "<p>It might be desirable to only expose the share functionality of Trilium to the Internet, and keep the application accessible only within a local network or via VPN.</p><p>To do so, a reverse proxy is required.</p><h2>Caddy</h2><pre><code class=\"language-text-x-trilium-auto\">http://domain.com {\n reverse_proxy /share http://localhost:8080/share\n}</code></pre><p>This is for newer versions where the share functionality is isolated, for older versions it's required to also include <code>/assets</code>.<a href=\"#fn2b8mg20aol8\"><sup>[1]</sup></a></p><ol><li><p><a href=\"#fnref2b8mg20aol8\"><strong><sup>^</sup></strong></a></p><p><a href=\"https://github.com/orgs/TriliumNext/discussions/7341#discussioncomment-14679897\">https://github.com/orgs/TriliumNext/discussions/7341#discussioncomment-14679897</a></p></li></ol>",
+ "_help_Ad7Ku5gOHrDU": "<aside class=\"admonition note\"><p>This topic of creating share templates is considered advanced and requires JavaScript/EJS knowledge.</p><p>The default share template should cover most normal uses.</p></aside><p>For full control over the HTML structure of a shared page — beyond what custom CSS, JS, or HTML snippets allow — you can replace the page template entirely using the <code>~shareTemplate</code> relation.</p><p>To do so:</p><ol><li>Create a&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;note with the language <em>Embedded JavaScript</em> (EJS).</li><li>For a shared note to apply the newly created template, apply the <code>~shareTemplate</code> relation pointing to the note created at step (1). Make use of&nbsp;<a class=\"reference-link\" href=\"#root/_help_bwZpz2ajCEwO\">Attribute Inheritance</a>&nbsp;to apply it to multiple shared notes.</li></ol><p>There are two important constraints to be aware of:</p><ul><li>Because EJS templates execute arbitrary server-side JavaScript, <code>~shareTemplate</code> only takes effect when backend scripting is enabled. If it is disabled (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_fiHicjpHjIRJ\">Security</a>), the relation is ignored and the default template is used. For the same reason, <strong>only apply templates from notes you trust</strong>.</li><li>The template note must be part of the shared subtree (just like <code>~shareCss</code>, <code>~shareJs</code>) in order for it to be loaded. To prevent it from being shown in the navigation, apply <code>#shareHiddenFromTree</code> to it.</li></ul><h2>Content of the share template</h2><p>Use the <a href=\"https://github.com/TriliumNext/Notes/blob/develop/packages/share-theme/src/templates/page.ejs\">original template</a> as reference when creating a new share template.</p><h2>Available variables</h2><p>Your template is rendered with a context object exposing the note and its rendering environment. The most useful values are:</p><figure class=\"table\"><table><thead><tr><th>Variable</th><th>Description</th></tr></thead><tbody><tr><td><code>note</code></td><td>The note being rendered. Use it to read attributes (<code>note.getLabelValue(...)</code>), <code>note.title</code>, child notes, etc.</td></tr><tr><td><code>content</code></td><td>The note's already-rendered HTML content, as a string.</td></tr><tr><td><code>header</code></td><td>Extra HTML to place in the document head for this note (used by some note types).</td></tr><tr><td><code>isEmpty</code></td><td><code>true</code> when the note has no content of its own.</td></tr><tr><td><code>head</code></td><td>The values of the page's <code>&lt;head&gt;</code>: <code>title</code> (the note's title, followed by the site's), <code>description</code> (<code>#shareDescription</code>), <code>noIndex</code> (<code>#shareDisallowRobotIndexing</code>) and <code>openGraph</code> with <code>url</code>, <code>domain</code>, <code>image</code>, <code>color</code> and <code>card</code> (<code>summary_large_image</code> with an image, <code>summary</code> without). A value whose label is not set is <code>null</code>. <code>metaTags</code> lists the description, OpenGraph and Twitter <code>&lt;meta&gt;</code> tags of the values that are set, each with <code>attribute</code> (<code>name</code> or <code>property</code>), <code>key</code> and <code>content</code>.</td></tr><tr><td><code>logo</code></td><td>The site logo above the navigation tree and, on a narrow screen, in the header: <code>href</code> (<code>#shareRootLink</code>, otherwise the site's root page), <code>image</code> (the <code>~shareLogo</code> image, or <code>null</code>), <code>icon</code> (the icon classes of the site's root note, shown when there is no <code>image</code>), and <code>width</code> and <code>height</code> for the image.</td></tr><tr><td><code>navigation</code></td><td>The navigation tree of the site: its visible pages, each with <code>title</code>, <code>href</code>, <code>isExternal</code>, <code>type</code>, <code>icon</code>, <code>isActive</code> (the page being shown), <code>isExpanded</code> (that page or one of its ancestors) and <code>children</code>.</td></tr><tr><td><code>contentClasses</code></td><td>The classes of the content element: <code>type-&lt;note type&gt;</code>, <code>ck-content</code> for text and Markdown notes, <code>full-height</code> for a note that takes the whole page (such as a PDF, a web view, a calendar, a geo map or an image), and <code>no-content</code> when the note has no content of its own.</td></tr><tr><td><code>childLinks</code></td><td>The links to the note's visible children, each with <code>title</code>, <code>href</code>, <code>isExternal</code>, <code>type</code>, <code>icon</code> (its icon classes), <code>excerpt</code> (its <code>#shareDescription</code> or the start of its text, with a line break between paragraphs, or <code>null</code>) and <code>children</code> (when it has no excerpt, its first ten visible children, each with <code>title</code>, <code>href</code>, <code>isExternal</code> and <code>icon</code>). Empty for a note that is not a collection, a text note or a code note, for a note that takes the whole page, and with <code>#hideChildrenOverview</code>.</td></tr><tr><td><code>childLinksLayout</code></td><td>How the default template lays <code>childLinks</code> out: <code>list</code> for a collection whose view type is list, <code>grid</code> otherwise.</td></tr><tr><td><code>prevNext</code></td><td>The pages before and after the note in the navigation tree, as <code>previous</code> and <code>next</code>, each with <code>title</code> and <code>href</code>, or <code>null</code>. Both <code>null</code> for a note that takes the whole page.</td></tr><tr><td><code>language</code></td><td>The languages of the page: <code>page</code> with the <code>lang</code> and <code>dir</code> of the application's language, and <code>content</code> with those of the note's content language, or <code>null</code> when they are the same.</td></tr><tr><td><code>lastUpdated</code></td><td>When the note was last changed, as <code>iso</code> for a <code>&lt;time&gt;</code> element and as <code>text</code> in the application's language, or <code>null</code>, which it also is for a note that takes the whole page.</td></tr><tr><td><code>showTitle</code></td><td>Whether the default template shows the note's title above the content. Always <code>true</code>.</td></tr><tr><td><code>titleIcon</code></td><td>The icon classes of the note, which the default template shows beside the title in a row of its own for a note that takes the whole page; <code>null</code> for any other note.</td></tr><tr><td><code>snippets</code></td><td>The HTML of the <code>~shareHtml</code> snippets for each location, such as <code>snippets[\"head:end\"]</code>. Every location is present, empty when no snippet goes there.</td></tr><tr><td><code>subRoot</code></td><td>The root of the shared subtree as <code>{ note, branch }</code> — handy for a site-wide title or logo.</td></tr><tr><td><code>cssToLoad</code> / <code>jsToLoad</code></td><td>Arrays of stylesheet / script URLs the default theme would inject (includes anything added via <code>~shareCss</code> / <code>~shareJs</code>).</td></tr><tr><td><code>faviconUrl</code> / <code>logoUrl</code></td><td>Resolved favicon and logo URLs. Without <code>~shareLogo</code>, <code>logoUrl</code> is the Trilium logo.</td></tr><tr><td><code>fontPreloads</code></td><td>The icon fonts to preload, each with <code>href</code> and <code>type</code> (the font's media type): Boxicons, and the icon packs used by the logo, the navigation tree or the subpages. The default template adds a <code>&lt;link rel=\"preload\" as=\"font\" crossorigin&gt;</code> for each, so that the icons do not appear only after the first paint.</td></tr><tr><td><code>isStatic</code></td><td><code>true</code> during a static HTML export, <code>false</code> for a live server render.</td></tr><tr><td><code>t</code></td><td>The <code>i18next</code> translation function.</td></tr><tr><td><code>utils</code></td><td>Helper utilities such as <code>slugify()</code> and <code>stripTags()</code>.</td></tr></tbody></table></figure><h2>Error handling</h2><p>If your template throws an error while rendering, Trilium logs the error and quietly falls back to the default template, so a broken template never takes the shared page down.</p><h2>Splitting a template into partials</h2><p>A template can pull in other EJS notes as partials. Create them as <strong>child notes</strong> of the template note (each also a <code>code</code> / <code>application/x-ejs</code> note) and reference them by title:</p><pre><code class=\"language-text-x-trilium-auto\">&lt;%- include(\"header\") %&gt;\n\n&lt;main&gt;\n &lt;h1&gt;&lt;%= note.title %&gt;&lt;/h1&gt;\n &lt;%- content %&gt;\n&lt;/main&gt;\n\n&lt;%- include(\"footer\") %&gt;\n</code></pre><p>Here <code>header</code> and <code>footer</code> are the titles of child notes of the template. Only direct children are resolvable, and they must be EJS code notes.</p>",
+ "_help_5668rwcirq1t": "<p>Trilium offers advanced functionality through <a href=\"#root/_help_CdNpE2pqjmI6\">Scripts</a> and <a href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>. To illustrate these features, we've prepared several showcases available in the <a href=\"#root/_help_wX4HbRucYSDD\">demo notes</a>:</p><ul><li><a href=\"#root/_help_iRwzGnHPzonm\">Relation Map</a></li><li><a href=\"#root/_help_l0tKav7yLHGF\">Day Notes</a></li><li><a href=\"#root/_help_R7abl2fc6Mxi\">Weight Tracker</a></li><li><a href=\"#root/_help_xYjQUYhpbUEW\">Task Manager</a></li></ul><p>It's important to note that these examples are not natively supported by Trilium out of the box; instead, they demonstrate what you can build within Trilium.</p>",
+ "_help_l0tKav7yLHGF": "<p>A common pattern in note-taking is that a lot of notes will be centered around a certain date - e.g. you have some tasks which needs to be done on a certain date, you have meeting minutes from a certain date, you have your thoughts etc. and it all revolves around a date on which they occurred. For this reason, it makes sense to create a certain \"day workspace\" which will centralize all those notes relevant for a certain date.</p><p>For this, Trilium provides a concept of \"day note\". Trilium semi-automatically generates a single note for each day. Under this note you can save all those relevant notes.</p><p>Select an existing day note, and the menubar contains a calendar widget. Select any day to create a note for that day.&nbsp;</p><p><img src=\"{{helpAssets}}/User%20Guide/Advanced%20Usage/Advanced%20Showcases/Day%20Notes_image.jpg\"></p><p>This pattern works well also because of <a href=\"#root/_help_IakOLONlIfGI\">Cloning Notes</a> functionality - note can appear in multiple places in the note tree, so besides appearing under day note, it can also be categorized into other notes.</p><h2>Demo</h2><p><img src=\"{{helpAssets}}/User%20Guide/Advanced%20Usage/Advanced%20Showcases/Day%20Notes_image.png\"></p><p>You can see the structure of day notes appearing under \"Journal\" note - there's a note for the whole year 2025, under it, you have \"03 - March\" which then contains \"09 - Monday\". This is our \"day note\" which contains some text in its content and also has some child notes (some of them are from <a href=\"#root/_help_xYjQUYhpbUEW\">Task manager</a>).</p><p>You can also notice how this day note has <a href=\"#root/_help_OFXdgB2nNk1F\">promoted attribute</a> \"weight\" where you can track your daily weight. This data is then used in <a href=\"#root/_help_R7abl2fc6Mxi\">Weight tracker</a>.</p><h2>Edited notes</h2><p>When a day note is opened, a collapsible section will appear underneath the&nbsp;<a class=\"reference-link\" href=\"#root/_help_l7pigIGu01K2\">Title</a>&nbsp;showing the notes edited on that day.</p><h2>Week Note and Quarter Note</h2><p>Week and quarter notes are disabled by default, since it might be too much for some people. To enable them, you need to set <code>#enableWeekNote</code> and <code>#enableQuarterNote</code> attributes on the root calendar note, which is identified by <code>#calendarRoot</code> label. Week note is affected by the first week of year option. Be careful when you already have some week notes created, it will not automatically change the existing week notes and might lead to some duplicates.</p><h2>Templates</h2><p>Trilium provides <a href=\"#root/_help_KC1HB96bqqHX\">template</a> functionality, and it could be used together with day notes.</p><p>You can define one of the following relations on the root of the journal (identified by <code>#calendarRoot</code> label):</p><ul><li>yearTemplate</li><li>quarterTemplate (if <code>#enableQuarterNote</code> is set)</li><li>monthTemplate</li><li>weekTemplate (if <code>#enableWeekNote</code> is set)</li><li>dateTemplate</li></ul><p>All of these are relations. When Trilium creates a new note for year or month or date, it will take a look at the root and attach a corresponding <code>~template</code> relation to the newly created role. Using this, you can e.g. create your daily template with e.g. checkboxes for daily routine etc.</p><h3>Migrate from old template usage</h3><p>If you have been using Journal prior to version v0.93.0, the previous template pattern likely used was <code>~child:template=</code>.<br>To transition to the new system:</p><ol><li>Set up the new template pattern in the Calendar root note.</li><li>Use <a href=\"#root/_help_ivYnonVFBxbQ\">Bulk Actions</a> to remove <code>child:template</code> and <code>child:child:template</code> from all notes under the Journal (calendar root).</li><li>Ensure that all old template patterns are fully removed to prevent conflicts with the new setup.</li></ol><h2>Naming pattern</h2><p>You can customize the title of generated journal notes by defining a <code>#datePattern</code>, <code>#weekPattern</code>, <code>#monthPattern</code>, <code>#quarterPattern</code> and <code>#yearPattern</code> attribute on a root calendar note (identified by <code>#calendarRoot</code> label). The naming pattern replacements follow a level-up compatibility - each level can use replacements from itself and all levels above it. For example, <code>#monthPattern</code> can use month, quarter and year replacements, while <code>#weekPattern</code> can use week, month, quarter and year replacements. But it is not possible to use week replacements in <code>#monthPattern</code>.</p><h3>Date pattern</h3><p>It's possible to customize the title of generated date notes by defining a <code>#datePattern</code> attribute on a root calendar note (identified by <code>#calendarRoot</code> label). Following are possible values:</p><ul><li><code>{isoDate}</code> results in an ISO 8061 formatted date (e.g. \"2025-03-09\" for March 9, 2025)</li><li><code>{dateNumber}</code> results in a number like <code>9</code> for the 9th day of the month, <code>11</code> for the 11th day of the month</li><li><code>{dateNumberPadded}</code> results in a number like <code>09</code> for the 9th day of the month, <code>11</code> for the 11th day of the month</li><li><code>{ordinal}</code> is replaced with the ordinal date (e.g. 1st, 2nd, 3rd) etc.</li><li><code>{weekDay}</code> results in the full day name (e.g. <code>Monday</code>)</li><li><code>{weekDay3}</code> is replaced with the first 3 letters of the day, e.g. Mon, Tue, etc.</li><li><code>{weekDay2}</code> is replaced with the first 2 letters of the day, e.g. Mo, Tu, etc.</li></ul><p>The default is <code>{dateNumberPadded} - {weekDay}</code></p><h3>Week pattern</h3><p>It is also possible to customize the title of generated week notes through the <code>#weekPattern</code> attribute on the root calendar note. The options are:</p><ul><li><code>{weekNumber}</code> results in a number like <code>9</code> for the 9th week of the year, <code>11</code> for the 11th week of the year</li><li><code>{weekNumberPadded}</code> results in a number like <code>09</code> for the 9th week of the year, <code>11</code> for the 11th week of the year</li><li><code>{shortWeek}</code> results in a short week string like <code>W9</code> for the 9th week of the year, <code>W11</code> for the 11th week of the year</li><li><code>{shortWeek3}</code> results in a short week string like <code>W09</code> for the 9th week of the year, <code>W11</code> for the 11th week of the year</li></ul><p>The default is <code>Week {weekNumber}</code></p><h3>Month pattern</h3><p>It is also possible to customize the title of generated month notes through the <code>#monthPattern</code> attribute on the root calendar note. The options are:</p><ul><li><code>{isoMonth}</code> results in an ISO 8061 formatted month (e.g. \"2025-03\" for March 2025)</li><li><code>{monthNumber}</code> results in a number like <code>9</code> for September, and <code>11</code> for November</li><li><code>{monthNumberPadded}</code> results in a number like <code>09</code> for September, and <code>11</code> for November</li><li><code>{month}</code> results in the full month name (e.g. <code>September</code> or <code>October</code>)</li><li><code>{shortMonth3}</code> is replaced with the first 3 letters of the month, e.g. Jan, Feb, etc.</li><li><code>{shortMonth4}</code> is replaced with the first 4 letters of the month, e.g. Sept, Octo, etc.</li></ul><p>The default is <code>{monthNumberPadded} - {month}</code></p><h3>Quarter pattern</h3><p>It is also possible to customize the title of generated quarter notes through the <code>#quarterPattern</code> attribute on the root calendar note. The options are:</p><ul><li><code>{quarterNumber}</code> results in a number like <code>1</code> for the 1st quarter of the year</li><li><code>{shortQuarter}</code> results in a short quarter string like <code>Q1</code> for the 1st quarter of the year</li></ul><p>The default is <code>Quarter {quarterNumber}</code></p><h3>Year pattern</h3><p>It is also possible to customize the title of generated year notes through the <code>#yearPattern</code> attribute on the root calendar note. The options are:</p><ul><li><code>{year}</code> results in the full year (e.g. <code>2025</code>)</li></ul><p>The default is <code>{year}</code></p><h2>Implementation</h2><p>Trilium has some special support for day notes in the form of <a href=\"https://triliumnext.github.io/Notes/backend_api/BackendScriptApi.html\">backend Script API</a> - see e.g. getDayNote() function.</p><p>Day (and year, month) notes are created with a label - e.g. <code>#dateNote=\"2025-03-09\"</code> this can then be used by other scripts to add new notes to day note etc.</p>",
+ "_help_R7abl2fc6Mxi": "<p><img src=\"{{helpAssets}}/User%20Guide/Advanced%20Usage/Advanced%20Showcases/Weight%20Tracker_image.jpg\"></p><p>The <code>Weight Tracker</code> is a <a href=\"#root/_help_GLks18SNjxmC\">Script API</a> showcase present in the <a href=\"#root/_help_wX4HbRucYSDD\">demo notes</a>.</p><p>By adding <code>weight</code> as a <a href=\"#root/_help_OFXdgB2nNk1F\">promoted attribute</a> in the <a href=\"#root/_help_KC1HB96bqqHX\">template</a> from which <a href=\"#root/_help_l0tKav7yLHGF\">day notes</a> are created, you can aggregate the data and plot weight change over time.</p><h2>Implementation</h2><p>The <code>Weight Tracker</code> note in the screenshot above is of the type <code>Render Note</code>. That type of note doesn't have any useful content itself. Instead it is a placeholder where a <a href=\"#root/_help_CdNpE2pqjmI6\">script</a> can render its output.</p><p>Scripts for <code>Render Notes</code> are defined in a <a href=\"#root/_help_zEY4DaJG4YT5\">relation</a> called <code>~renderNote</code>. In this example, it's the <code>Weight Tracker</code>'s child <code>Implementation</code>. The Implementation consists of two <a href=\"#root/_help_6f9hih2hXXZk\">code notes</a> that contain some HTML and JavaScript respectively, which load all the notes with a <code>weight</code> attribute and display their values in a chart.</p><p>To actually render the chart, we're using a third party library called <a href=\"https://www.chartjs.org/\">chart.js</a>which is imported as an attachment, since it's not built into Trilium.</p><h3>Code</h3><p>Here's the content of the script which is placed in a <a href=\"#root/_help_6f9hih2hXXZk\">code note</a> of type <code>JS Frontend</code>:</p><pre><code class=\"language-text-x-trilium-auto\">async function getChartData() {\n const days = await api.runOnBackend(async () =&gt; {\n const notes = api.getNotesWithLabel('weight');\n const days = [];\n\n for (const note of notes) {\n const date = note.getLabelValue('dateNote');\n const weight = parseFloat(note.getLabelValue('weight'));\n\n if (date &amp;&amp; weight) {\n days.push({ date, weight });\n }\n }\n\n days.sort((a, b) =&gt; a.date &gt; b.date ? 1 : -1);\n\n return days;\n });\n\n const datasets = [\n {\n label: \"Weight (kg)\",\n backgroundColor: 'red',\n borderColor: 'red',\n data: days.map(day =&gt; day.weight),\n fill: false,\n spanGaps: true,\n datalabels: {\n display: false\n }\n }\n ];\n\n return {\n datasets: datasets,\n labels: days.map(day =&gt; day.date)\n };\n}\n\nconst ctx = $(\"#canvas\")[0].getContext(\"2d\");\n\nnew chartjs.Chart(ctx, {\n type: 'line',\n data: await getChartData()\n});</code></pre><h2>How to remove the Weight Tracker button from the top bar</h2><p>In the link map of the <code>Weight Tracker</code>, there is a note called <code>Button</code>. Open it and delete or comment out its contents. The <code>Weight Tracker</code> button will disappear after you restart Trilium.</p>",
+ "_help_xYjQUYhpbUEW": "<p>Task Manager is a <a href=\"#root/_help_OFXdgB2nNk1F\">promoted attributes</a> and <a href=\"#root/_help_CdNpE2pqjmI6\">scripts</a>showcase present in the <a href=\"#root/_help_wX4HbRucYSDD\">demo notes</a>.</p><h2>Demo</h2><p><img src=\"{{helpAssets}}/User%20Guide/Advanced%20Usage/Advanced%20Showcases/Task%20Manager_task-manager.png\"></p><p>Task Manager manages outstanding (TODO) tasks and finished tasks (non-empty doneDate attribute). Outstanding tasks are further categorized by location and arbitrary tags - whenever you change tag attribute in the task note, this task is then automatically moved to appropriate location.</p><p>Task Manager also integrates with <a href=\"#root/_help_l0tKav7yLHGF\">day notes</a> - notes are <a href=\"#root/_help_IakOLONlIfGI\">cloned</a> into day note to both todoDate note and doneDate note (with <a href=\"#root/_help_kBrnXNG3Hplm\">prefix</a> of either \"TODO\" or \"DONE\").</p><h2>Implementation</h2><p>New tasks are created in the TODO note which has <code>~child:template</code> <a href=\"#root/_help_zEY4DaJG4YT5\">relation</a>(see <a href=\"#root/_help_bwZpz2ajCEwO\">attribute inheritance</a>) pointing to the task template.</p><h3>Attributes</h3><p>Task template defines several <a href=\"#root/_help_OFXdgB2nNk1F\">promoted attributes</a> - todoDate, doneDate, tags, location. Importantly it also defines <code>~runOnAttributeChange</code> relation - <a href=\"#root/_help_GPERMystNGTB\">event</a> handler which is run on attribute change. This <a href=\"#root/_help_CdNpE2pqjmI6\">script</a> handles when e.g. we fill out the doneDate attribute - meaning the task is done and should be moved to \"Done\" note and removed from TODO, locations and tags.</p><h3>New task button</h3><p>There's also \"button\" note which contains simple script which adds a button to create new note (task) in the TODO note.</p><pre><code class=\"language-text-x-trilium-auto\">api.addButtonToToolbar({\n title: 'New task',\n icon: 'check',\n shortcut: 'alt+n',\n action: async () =&gt; {\n // creating notes is backend (server) responsibility so we need to pass\n // the control there\n const taskNoteId = await api.runOnBackend(async () =&gt; {\n const todoRootNote = await api.getNoteWithLabel('taskTodoRoot');\n const {note} = await api.createNote(todoRootNote.noteId, 'new task', '');\n\n return note.noteId;\n });\n\n // we got an ID of newly created note and we want to immediatelly display it\n await api.activateNewNote(taskNoteId);\n }\n});</code></pre><h3>CSS</h3><p>In the demo screenshot above you may notice that TODO tasks are in red color and DONE tasks are green.</p><p>This is done by having this CSS <a href=\"#root/_help_6f9hih2hXXZk\">code note</a> which defines extra CSS classes:</p><pre><code class=\"language-text-x-trilium-auto\">span.fancytree-node.todo .fancytree-title {\n color: red !important;\n}\n\nspan.fancytree-node.done .fancytree-title {\n color: green !important;\n}</code></pre><p>This <a href=\"#root/_help_6f9hih2hXXZk\">code note</a> has <code>#appCss</code> <a href=\"#root/_help_zEY4DaJG4YT5\">label</a>which is recognized by Trilium on startup and loaded as CSS into the application.</p><p>Second part of this functionality is based in event handler described above which assigns <code>#cssClass</code> label to the task to either \"done\" or \"todo\" based on the task status.</p>",
+ "_help_i16PM6A7GXdU": "<p>Trilium features customizable to-do list task states. To customize them, go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Text Notes</em> → <em>Related settings</em> → <em>Custom checkbox states for to-do lists</em>. Alternatively, right-click a checkbox in an editable text note and click the pencil icon.</p><aside class=\"admonition warning\"><p>Changes take effect only after restarting the application.</p></aside><h2>Creating a new task state</h2><p>Click the plus icon next to Task States in the left-side pane, then define the task details as described in the next section.</p><h2>Editing a task state</h2><p>Selecting any state other than \"None\" and \"Done\" (which cannot be modified) from the side pane reveals the following editable fields:</p><ul><li><em>Icon</em> (required): The symbol shown inside the checkbox. You can pick an icon just as you would for any regular note, including from custom icon packs.</li><li><em>Title</em> (required): The name of the task state shown in the UI. For example: \"Doing\", \"Postponed\".</li><li><em>Identifier</em> (required): A short name for the state, using only letters, digits, \"<code>-</code>\" and \"<code>_</code>\". It is stored as metadata in the note's markup and used to identify the task state. Two task states cannot share the same identifier.<br>Prefix the identifiers of your custom task states with an underscore \"<code>_</code>\" or a hyphen \"<code>-</code>\" to avoid clashes with task states that may be introduced in future versions of Trilium.</li><li><em>Markdown symbol</em>: A single character used to represent the state in Markdown syntax. For example, \"<code>#</code>\" creates a task state that can be applied in Markdown using \" <code>- [#]</code> \". Make sure no other task state uses the same symbol.</li><li><em>Counts as completed</em>: If checked, the task is treated as completed.</li><li><em>Color</em>: The color of the checkbox. Its lightness and saturation are adjusted automatically to match the current color scheme or theme.</li><li><em>Hidden from toolbar</em>: The state is not listed in the UI. This is useful when you want existing notes to keep rendering the state correctly but no longer need to apply it yourself.</li></ul><aside class=\"admonition note\"><p>The task definition details are validated at startup. If errors are found, a toast provides the details and the affected task definition is ignored.</p></aside><h2>Reordering task states</h2><p>To change the order in which task states appear in the UI and when cycling through them with the keyboard, simply reorder the states in the side pane (or tree panel, if it's the case).</p><h2>Deleting task states</h2><p>Any task state other than \"None\" and \"Done\" can be deleted.</p><p>Once deleted, to-do items using that state will no longer display the custom checkbox. They fall back to either a \"None\" or \"Done\" state, depending on the state's \"Counts as completed\" setting. The identifier and title remain stored in the note until you set the checkbox to a new state.</p><h2>Transferring notes with custom task states between Trilium database instances</h2><p>Exporting notes to another Trilium database instance preserves the task states of to-do items, but does not include the custom task definitions. As a result, the destination instance won't know how to render the checkbox unless you recreate the task state there with the same identifier and Markdown symbol.</p><aside class=\"admonition note\"><p>This is a known limitation of the current version. If there is enough interest in the community for transferring notes between Trilium database instances more easily, the Trilium team may consider a better state definition mechanism.</p></aside>",
+ "_help_J5Ex1ZrMbyJ6": "<p>Trilium provides a mechanism for <a href=\"#root/_help_CdNpE2pqjmI6\">scripts</a> to open a public REST endpoint. This opens a way for various integrations with other services - a simple example would be creating new note from Slack by issuing a slash command (e.g. <code>/trilium buy milk</code>).</p><h2>Create note from outside Trilium</h2><p>Let's take a look at an example. The goal is to provide a REST endpoint to which we can send title and content and Trilium will create a note.</p><p>We'll start with creating a JavaScript backend <a href=\"#root/_help_6f9hih2hXXZk\">code note</a> containing:</p><pre><code class=\"language-text-x-trilium-auto\">const {req, res} = api;\nconst {secret, title, content} = req.body;\n\nif (req.method == 'POST' &amp;&amp; secret === 'secret-password') {\n // notes must be saved somewhere in the tree hierarchy specified by a parent note. \n // This is defined by a relation from this code note to the \"target\" parent note\n // alternatively you can just use constant noteId for simplicity (get that from \"Note Info\" dialog of the desired parent note)\n const targetParentNoteId = api.currentNote.getRelationValue('targetNote');\n \n const {note} = api.createTextNote(targetParentNoteId, title, content);\n const notePojo = note.getPojo();\n\n res.status(201).json(notePojo);\n}\nelse {\n res.send(400);\n}</code></pre><p>This script note has also following two attributes:</p><ul><li>label <code>#customRequestHandler</code> with value <code>create-note</code></li><li>relation <code>~targetNote</code> pointing to a note where new notes should be saved</li></ul><h3>Explanation</h3><p>Let's test this by using an HTTP client to send a request:</p><pre><code class=\"language-text-x-trilium-auto\">POST http://your-trilium-server/custom/create-note\nContent-Type: application/json\n\n{\n \"secret\": \"secret-password\",\n \"title\": \"hello\",\n \"content\": \"world\"\n}+++++++++++++++++++++++++++++++++++++++++++++++</code></pre><p>Notice the <code>/custom</code> part in the request path - Trilium considers any request with this prefix as \"custom\" and tries to find a matching handler by looking at all notes which have <code>customRequestHandler</code> <a href=\"#root/_help_zEY4DaJG4YT5\">label</a>. Value of this label then contains a regular expression which will match the request path (in our case trivial regex \"create-note\").</p><p>Trilium will then find our code note created above and execute it. <code>api.req</code>, <code>api.res</code> are set to <a href=\"https://expressjs.com/en/api.html#req\">request</a> and <a href=\"https://expressjs.com/en/api.html#res\">response</a>objects from which we can get details of the request and also respond.</p><p>In the code note we check the request method and then use trivial authentication - keep in mind that these endpoints are by default totally unauthenticated, and you need to take care of this yourself.</p><p>Once we pass these checks we will just create the desired note using <a href=\"#root/_help_GLks18SNjxmC\">Script API</a>.</p><h2>Custom resource provider</h2><p>Another common use case is that you want to just expose a file note - in such case you create label <code>customResourceProvider</code> (value is again path regex).</p><p>For more information, see&nbsp;<a href=\"#root/_help_d3fAXQ2diepH\">Custom Resource Providers</a>.</p><h2>Advanced concepts</h2><p><code>api.req</code> and <code>api.res</code> are Express.js objects - you can always look into its <a href=\"https://expressjs.com/en/api.html\">documentation</a> for details.</p><h3>Parameters</h3><p>REST request paths often contain parameters in the URL, e.g.:</p><pre><code class=\"language-text-x-trilium-auto\">http://your-trilium-server/custom/notes/123</code></pre><p>The last part is dynamic so the matching of the URL must also be dynamic - for this reason the matching is done with regular expressions. Following <code>customRequestHandler</code> value would match it:</p><pre><code class=\"language-text-x-trilium-auto\">notes/([0-9]+)</code></pre><p>Additionally, this also defines a matching group with the use of parenthesis which then makes it easier to extract the value. The matched groups are available in <code>api.pathParams</code>:</p><pre><code class=\"language-text-x-trilium-auto\">const noteId = api.pathParams[0];</code></pre><p>Often you also need query params (as in e.g. <code>http://your-trilium-server/custom/notes?noteId=123</code>), you can get those with standard express <code>req.query.noteId</code>.</p>",
+ "_help_d3fAXQ2diepH": "<p>A custom resource provider allows any file imported into Trilium (images, fonts, stylesheets) to be publicly accessible via a URL.</p><p>A potential use case for this is to add embed a custom font alongside a theme.</p><h2>Steps for creating a custom resource provider</h2><ol><li>Import a file such as an image or a font into Trilium by drag &amp; drop.</li><li>Set the <a href=\"#root/_help_HI6GBBIduIgv\">label</a> <code>#customResourceProvider</code> to <code>hello</code>.</li><li>To test if it is working, use a browser to navigate to <code>&lt;protocol&gt;://&lt;host&gt;/custom/hello</code> (where <code>&lt;protocol&gt;</code> is either <code>http</code> or <code>https</code> based on your setup, and <code>&lt;host&gt;</code> is the host or IP to your Trilium server instance). If you are running the TriliumNext application without a server, use <code>http://localhost:37840</code> as the base URL.</li><li>If everything went well, at the previous step the browser should have downloaded the file uploaded in the first step.</li></ol><p>Instead of <code>hello</code>, the name can be:</p><ul><li>A path, such as <code>fonts/Roboto.ttf</code>, which would be accessible via <code>&lt;host&gt;/custom/fonts/Roboto.ttf</code>.</li><li>As a more advanced use case, a regular expression to match multiple routes, such as <code>hello/.*</code> which will be accessible via <code>/custom/hello/1</code>, <code>/custom/hello/2</code>, <code>/custom/hello/world</code>, etc.</li></ul><h2>Using it in a theme</h2><p>For example, if you have a custom font to be imported by the theme, first upload a font file into Trilium and assign it the <code>#customResourceProvider=fonts/myfont.ttf</code> attribute.</p><p>Then modify the theme CSS to point to:</p><pre><code class=\"language-text-css\">@font-face {\n\tfont-family: customFont;\n\tsrc: url(\"/custom/fonts/myfont.ttf\");\n}\n\ndiv {\n\tfont-family: customFont;\n}</code></pre>",
+ "_help_pgxEVkzLl1OP": "<aside class=\"admonition tip\"><p>For a quick start, consult the&nbsp;<a class=\"reference-link\" href=\"{{helpAssets}}/User%20Guide/Advanced%20Usage/ETAPI%20(REST%20API)/API%20Reference.dat\">API Reference</a>.</p></aside><p>ETAPI is Trilium's public/external REST API. It is available since Trilium v0.50.</p><h2>API clients</h2><p>As an alternative to calling the API directly, there are client libraries to simplify this</p><ul><li><a href=\"https://github.com/Nriver/trilium-py\">trilium-py</a>, you can use Python to communicate with Trilium.</li></ul><h2>Obtaining a token</h2><p>All operations with the REST API have to be authenticated using a token. You can get this token either from Options -&gt; ETAPI or programmatically using the <code>/auth/login</code> REST call (see the <a href=\"https://github.com/TriliumNext/Trilium/blob/master/src/etapi/etapi.openapi.yaml\">spec</a>).</p><h2>Authentication</h2><h3>Via the <code>Authorization</code> header</h3><pre><code class=\"language-text-x-trilium-auto\">GET https://myserver.com/etapi/app-info\nAuthorization: ETAPITOKEN</code></pre><p>where <code>ETAPITOKEN</code> is the token obtained in the previous step.</p><p>For compatibility with various tools, it's also possible to specify the value of the <code>Authorization</code> header in the format <code>Bearer ETAPITOKEN</code> (since 0.93.0).</p><h3>Basic authentication</h3><p>Since v0.56 you can also use basic auth format:</p><pre><code class=\"language-text-x-trilium-auto\">GET https://myserver.com/etapi/app-info\nAuthorization: Basic BATOKEN</code></pre><ul><li>Where <code>BATOKEN = BASE64(username + ':' + password)</code> - this is a standard Basic Auth serialization</li><li>Where <code>username</code> is \"etapi\"</li><li>And <code>password</code> is the generated ETAPI token described above.</li></ul><p>Basic Auth is meant to be used with tools which support only basic auth.</p><h2>Interaction using Bash scripts</h2><p>It is possible to write simple Bash scripts to interact with Trilium. As an example, here's how to obtain the HTML content of a note:</p><pre><code class=\"language-text-x-trilium-auto\">#!/usr/bin/env bash\n\n# Configuration\nTOKEN=z1vA4fkGxjOR_ZXLrZeqHEFOv65yV3882iFCRtNIK9k9iWrHliITNSLQ=\nSERVER=http://localhost:8080\n\n# Download a note by ID\nNOTE_ID=\"i6ra4ZshJhgN\"\ncurl \"$SERVER/etapi/notes/$NOTE_ID/content\" -H \"Authorization: $TOKEN\" </code></pre><p>Make sure to replace the values of:</p><ul><li><code>TOKEN</code> with your ETAPI token.</li><li><code>SERVER</code> with the correct protocol, host name and port to your Trilium instance.</li><li><code>NOTE_ID</code> with an existing note ID to download.</li></ul><p>As another example, to obtain a .zip export of a note and place it in a directory called <code>out</code>, simply replace the last statement in the script with:</p><pre><code class=\"language-text-x-trilium-auto\">curl -H \"Authorization: $TOKEN\" \\\n\t-X GET \"$SERVER/etapi/notes/$NOTE_ID/export\" \\\n --output \"out/$NOTE_ID.zip\"</code></pre><h2>Uploading binary content</h2><p>A JSON request body can only carry text, so the <code>content</code> field of <code>POST /etapi/attachments</code> stores exactly the string it receives. To upload an image, a PDF or any other binary file, send the raw bytes to the content endpoint with the <code>application/octet-stream</code> content type. The same applies to the content of a note (<code>PUT /etapi/notes/{noteId}/content</code>).</p><p>To attach a file to a note, create the attachment without content, then upload the file to it:</p><pre><code class=\"language-text-x-trilium-auto\">ATTACHMENT_ID=$(curl -s -X POST \"$SERVER/etapi/attachments\" \\\n -H \"Authorization: $TOKEN\" \\\n -H \"Content-Type: application/json\" \\\n -d \"{\\\"ownerId\\\": \\\"$NOTE_ID\\\", \\\"role\\\": \\\"file\\\", \\\"mime\\\": \\\"application/pdf\\\", \\\"title\\\": \\\"report.pdf\\\", \\\"position\\\": 10}\" \\\n | jq -r .attachmentId)\n\ncurl -X PUT \"$SERVER/etapi/attachments/$ATTACHMENT_ID/content\" \\\n -H \"Authorization: $TOKEN\" \\\n -H \"Content-Type: application/octet-stream\" \\\n --data-binary @report.pdf</code></pre><p>Use <code>--data-binary</code> rather than <code>-d</code>, which strips line breaks from the file. For an image, set <code>role</code> to <code>image</code> and <code>mime</code> to the image's type, such as <code>image/png</code>.</p>",
+ "_help_47ZrP6FNuoG8": "<p>When a new note is created, its name is by default \"new note\". In some cases, it can be desirable to have a different or even a dynamic default note title.</p><p>For this use case, Trilium (since v0.52) supports <code>#titleTemplate</code> <a href=\"#root/_help_zEY4DaJG4YT5\">label</a>. You can create such a label for a given note, assign it a value, and this value will be used as a default title when creating child notes. As with other labels, you can make it inheritable to apply recursively, and you can even place it on the root note to have it applied globally everywhere.</p><p>As an example use case, imagine you collect books you've read in a given year like this:</p><ul><li>2022 Books<ul><li>Neal Stephenson: Anathem, 2008</li><li>Franz Kafka: Die Verwandlung, 1915</li></ul></li></ul><p>Now, to the parent note \"2022 Books\" you can assign label <code>#titleTemplate=\"[Author name]: [Book title], [Publication year]\"</code>.</p><p>And all children of \"2022 Books\" will be created with initial title \"[Author name]: [Book title], [Publication year]\". There's no artificial intelligence here, the idea is to just prompt you to manually fill in the pieces of information into the note title by yourself.</p><h2>Titles set by a template</h2><p>A template can name the notes created from it, wherever they are created. To do so, add a <code>#template:titleTemplate</code> label to the template note, for example <code>#template:titleTemplate=\"Meeting ${now.format('YYYY-MM-DD')}\"</code> on a <em>Meeting</em> template.</p><ul><li>It applies both when the template is picked explicitly and when it comes from a parent's <code>~child:template</code>. See <a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>.</li><li>It takes precedence over the parent's <code>#titleTemplate</code>. A title typed in by the user always wins.</li><li>It can be inherited from the template's ancestors in the tree (for example, a folder holding several templates), in which case a label owned by the template itself takes precedence. A note created from a template and later marked as a template does not keep that template's title.</li><li>Its value is evaluated the same way as <code>#titleTemplate</code>, with <code>parentNote</code> being the parent of the new note.</li></ul><h2>Dynamic value</h2><p>The value of <code>#titleTemplate</code> is evaluated at the point of note's creation as a JavaScript string, which means it can be enriched with the help of JS string interpolation with dynamic data.</p><p>Second variable injected is <code>parentNote</code> which gives access to the parent <a href=\"{{helpAssets}}/User%20Guide/Scripting/Script%20API/Frontend%20API/FNote.dat\"><code>FNote</code></a>.</p><p>See also&nbsp;<a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>&nbsp;which provides similar capabilities, including default note's content.</p><h3>Examples</h3><ul><li>Imagine you collect server outage incidents and write some notes. It looks like this:<ul><li>Incidents<ul><li>2022-05-09: System crash</li><li>2022-05-15: Backup delay</li></ul></li><li>You can automatize the date assignment by assigning a label <code>#titleTemplate=\"${now.format('YYYY-MM-DD')}: \"</code> to the parent note \"Incidents\". Whenever a new child note is created, the title template is evaluated with the injected <a href=\"https://day.js.org/docs/en/display/format\">now</a> object.</li></ul></li><li>To use a parent's attribute in the title of new notes: <code>#titleTemplate=\"${parentNote.getLabelValue('authorName')}'s literary works\"</code></li><li>To mirror the parent's note title: <code>${parentNote.title}</code></li></ul>",
+ "_help_wX4HbRucYSDD": "<p>Your Trilium data is stored in a <a href=\"https://www.sqlite.org\">SQLite</a> database which contains all notes, tree structure, metadata, and most of the configuration. The database file is named <code>document.db</code> and is stored in the application's default&nbsp;<a href=\"#root/_help_tAassRL4RSQL\">Data directory</a>.</p><h2>Demo Notes</h2><p>When first starting Trilium, it will provide a set of notes to showcase various features of the application.</p><p>For more information see&nbsp;<a class=\"reference-link\" href=\"#root/_help_6tZeKvSHEUiB\">Demo Notes</a>.</p><h2>Manually Modifying the Database</h2><p>Trilium provides a lot of flexibility, and with it, opportunities for advanced users to tweak it. If you need to explore or modify the database directly, you can use a tool such as <a href=\"https://sqlitebrowser.org/\">SQLite Browser</a> to work directly on the database file.</p><p>See&nbsp;<a href=\"#root/_help_oyIAJ9PvvwHX\">Manually altering the database</a>&nbsp;for more information.</p><h2>How to Reset the Database</h2><p>If you want to start again and:</p><ul><li>Create and switch to a new blank knowledge base</li><li>Use a different knowledge base synced from a server or desktop application</li><li>Restore a backup</li></ul><p>You can navigate to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Database</em> and click the <em>Start over</em> button. You'll be prompted to restart the application, with the option to back up your current database before proceeding.</p><aside class=\"admonition important\"><p>For the web client, Trilium cannot restart automatically. You'll need to manually restart the server/container and then reload the web application.</p></aside><p>After restarting, the setup screen will appear. You can choose to back up your existing database, then proceed with the setup menu as if it's a new installation. The existing database will only be overwritten after selecting to create a new database, sync with a server, or restore from a backup.</p><h3>The Legacy Method</h3><p>If you are experimenting with Trilium and want to return it to its original state, you can do that by deleting the current database. When you restart the application, it will generate a new database containing the original demo notes.</p><p>To delete the database, simply go to the <a href=\"#root/_help_tAassRL4RSQL\">data directory</a> and delete the <code>document.db</code> file (and any other files starting with <code>document.db</code>).</p><p>If you do not need to preserve any configurations that might be stored in the <code>config.ini</code> file, you can just delete all of the <a href=\"#root/_help_tAassRL4RSQL\">data directory's</a> contents to fully restore the application to its original state. You can also review the <a href=\"#root/_help_Gzjqa934BdH4\">configuration</a> file to provide all <code>config.ini</code> values as environment variables instead.</p>",
+ "_help_oyIAJ9PvvwHX": "<p>There are some situations where modifying the SQLite database that Trilium uses is desirable.</p><p>If you are doing any advanced development or troubleshooting where you manually modify the database, you might want to consider creating backups of your <code>document.db</code> file.</p><h2>Modifying it internally using the SQL Console</h2><p>The SQL Console is Trilium's built-in database editor.</p><p>See&nbsp;<a class=\"reference-link\" href=\"#root/_help_YKWqdJhzi2VY\">SQL Console</a>.</p><h2>Externally modifying the database</h2><p>Sometimes the SQL Console cannot be used (for example if the application cannot start).</p><p>When making external modifications, consider closing the desktop application. If modifying the server database, then stop the service or Docker container.</p><h3>Using DB Browser for SQLite</h3><p>DB Browser for SQLite is a cross-platform editor that can be used to alter the database using a graphical user interface.</p><p>To do so:</p><ol><li>In the main menu, select File → Open database… and navigate to the database in the&nbsp;<a href=\"#root/_help_tAassRL4RSQL\">Data directory</a>.</li><li>Select the <em>Execute SQL</em> tab.</li><li>Type in the desired SQL statement.</li><li>Press the \"Play\" button in the toolbar underneath the \"Execute SQL\" tab (or F5 key).</li><li>Press \"Write Changes\" in the main toolbar.</li><li>Close the application or close the database.</li></ol><p><img src=\"{{helpAssets}}/User%20Guide/Advanced%20Usage/Database/Manually%20altering%20the%20database_image.jpg\"></p><h3>Using the SQLite CLI</h3><p>First, start the SQLite 3 CLI by specifying the path to the database:</p><pre><code class=\"language-text-x-trilium-auto\">sqlite3 ~/.local/share/trilium-data/document.db</code></pre><ul><li>In the prompt simply type the statement and make sure it ends with a <code>;</code> character.</li><li>To exit, simply type <code>.quit</code> and enter.</li></ul>",
+ "_help_YKWqdJhzi2VY": "<aside class=\"admonition important\"><p>Starting with v0.104.0, backend scripts are disabled by default to reduce the attack surface. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_fiHicjpHjIRJ\">Security</a>&nbsp;for more information.</p></aside><p>The SQL Console is Trilium's built-in database editor.</p><p>It can be accessed by going to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a>&nbsp;→ Advanced → Open SQL Console.</p><p><img src=\"{{helpAssets}}/User%20Guide/Advanced%20Usage/Database/Manually%20altering%20the%20database/SQL%20Console_image.jpg\"></p><h3>Interaction</h3><ul><li>Hovering the mouse over one of the tables listed at the top of the document will show the columns and their data type.</li><li>Only one SQL statement can be run at once.</li><li>To run the statement, press the <em>Execute</em> icon.</li><li>For queries that return a result, the data will displayed in a table.</li><li>For statements (e.g. <code>INSERT</code>, <code>UPDATE</code>), the number of affected rows is displayed.</li></ul><figure class=\"image\"><img style=\"aspect-ratio:1124/571;\" src=\"{{helpAssets}}/User%20Guide/Advanced%20Usage/Database/Manually%20altering%20the%20database/SQL%20Console_image.png\" width=\"1124\" height=\"571\"></figure><h3>Interacting with the table</h3><p>After executing a query, a table with the results will be displayed:</p><ul><li>Clicking on a column allows sorting ascending or descending.</li><li>Underneath each column there is an input field which allows filtering by text.</li><li>Press <kbd>Ctrl</kbd>+<kbd>C</kbd> to copy the current cell to clipboard.</li><li>Multiple cells can be selected by dragging or by holding <kbd>Shift</kbd> + arrow keys</li><li>Results are paginated for performance reasons. The controls at the bottom of the table can be used to navigate through pages.</li></ul><h3>Saved SQL console</h3><p>SQL queries or commands can be saved into a dedicated note.</p><p>To do so, simply write the query and press the&nbsp;<span class=\"tn-icon bx bx-save\"></span> button. Once saved, the note will appear in&nbsp;<a class=\"reference-link\" href=\"#root/_help_l0tKav7yLHGF\">Day Notes</a>&nbsp;by default. It is possible to change the default location of saved queries by assigning a <code>#sqlConsoleHome</code> <a href=\"#root/_help_HI6GBBIduIgv\">label</a>.</p><p>The note can be locked for editing by pressing the <em>Lock</em> button in the note actions section near the title bar. When editing is locked, the SQL statement is hidden from view.</p>",
+ "_help_6tZeKvSHEUiB": "<p>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:</p><ul><li><a class=\"reference-link\" href=\"#root/_help_iRwzGnHPzonm\">Relation Map</a></li><li><a class=\"reference-link\" href=\"#root/_help_l0tKav7yLHGF\">Day Notes</a></li><li><a class=\"reference-link\" href=\"#root/_help_R7abl2fc6Mxi\">Weight Tracker</a></li><li><a class=\"reference-link\" href=\"#root/_help_xYjQUYhpbUEW\">Task Manager</a></li><li><a class=\"reference-link\" href=\"#root/_help_Wy267RK4M69c\">Themes</a></li></ul><h3>Restoring Demo Notes</h3><p>There are some cases in which you may want to restore the original demo notes. For example, if you experimented with some of the more advanced features and want to see the original reference, or if you simply want to explore the latest version of the demo notes, which might showcase new features.</p><p>You can easily restore the demo notes by using Trilium's built-in import feature by importing them:</p><ul><li>Download <a href=\"https://github.com/TriliumNext/Trilium/raw/refs/heads/main/apps/server/src/assets/db/demo.zip\">the .zip archive</a> with the latest version of the demo notes</li><li>Right click on any note in your tree under which you would like the demo notes to be imported</li><li>Click \"Import into note…\"</li><li>Select the .zip archive to import it</li></ul>",
+ "_help_Gzjqa934BdH4": "<p>Trilium supports configuration via a file named <code>config.ini</code> and environment variables. This document provides a comprehensive reference for all configuration options.</p><h2>Location of the configuration file</h2><p>The configuration file is not located in the same directory as the application. Instead, the <code>config.ini</code> is located in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_tAassRL4RSQL\">Data directory</a>. As such, the configuration file is only available after starting the application and creating a database.</p><h2>Configuration Precedence</h2><p>Configuration values are loaded in the following order of precedence (highest to lowest):</p><ol><li><strong>Environment variables</strong> (checked first)</li><li><strong>config.ini file values</strong></li><li><strong>Default values</strong></li></ol><h2>Environment Variable Patterns</h2><p>Trilium supports multiple environment variable patterns for flexibility. The primary pattern is: <code>TRILIUM_[SECTION]_[KEY]</code></p><p>Where:</p><ul><li><code>SECTION</code> is the INI section name in UPPERCASE</li><li><code>KEY</code> is the camelCase configuration key converted to UPPERCASE (e.g., <code>instanceName</code> → <code>INSTANCENAME</code>)</li></ul><p>Additionally, shorter aliases are available for common configurations (see Alternative Variables section below).</p><h2>Environment Variable Reference</h2><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">General</p><div class=\"trilium-tab-panel\"><figure class=\"table\"><table><thead><tr><th>Environment Variable</th><th>Type</th><th>Default</th><th>Description</th></tr></thead><tbody><tr><td><code>TRILIUM_GENERAL_INSTANCENAME</code></td><td>string</td><td>\"\"</td><td>Instance name for API identification</td></tr><tr><td><code>TRILIUM_GENERAL_NOAUTHENTICATION</code></td><td>boolean</td><td>false</td><td>Disable authentication (server only)</td></tr><tr><td><code>TRILIUM_GENERAL_NOBACKUP</code></td><td>boolean</td><td>false</td><td>Disable automatic backups</td></tr><tr><td><code>TRILIUM_GENERAL_NODESKTOPICON</code></td><td>boolean</td><td>false</td><td>Disable desktop icon creation</td></tr><tr><td><code>TRILIUM_GENERAL_READONLY</code></td><td>boolean</td><td>false</td><td>Enable read-only mode</td></tr></tbody></table></figure></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">Network</p><div class=\"trilium-tab-panel\"><figure class=\"table\"><table><thead><tr><th>Environment Variable</th><th>Type</th><th>Default</th><th>Description</th></tr></thead><tbody><tr><td><code>TRILIUM_NETWORK_HOST</code></td><td>string</td><td>\"0.0.0.0\"</td><td>Server host binding</td></tr><tr><td><code>TRILIUM_NETWORK_PORT</code></td><td>string</td><td>\"8080\"</td><td>Server port</td></tr><tr><td><code>TRILIUM_NETWORK_HTTPS</code></td><td>boolean</td><td>false</td><td>Enable HTTPS</td></tr><tr><td><code>TRILIUM_NETWORK_CERTPATH</code></td><td>string</td><td>\"\"</td><td>SSL certificate path</td></tr><tr><td><code>TRILIUM_NETWORK_KEYPATH</code></td><td>string</td><td>\"\"</td><td>SSL key path</td></tr><tr><td><code>TRILIUM_NETWORK_TRUSTEDREVERSEPROXY</code></td><td>boolean/string</td><td>false</td><td>Reverse proxy trust settings</td></tr><tr><td><code>TRILIUM_NETWORK_CORSALLOWORIGIN</code></td><td>string</td><td>\"\"</td><td>CORS allowed origins</td></tr><tr><td><code>TRILIUM_NETWORK_CORSALLOWMETHODS</code></td><td>string</td><td>\"\"</td><td>CORS allowed methods</td></tr><tr><td><code>TRILIUM_NETWORK_CORSALLOWHEADERS</code></td><td>string</td><td>\"\"</td><td>CORS allowed headers</td></tr><tr><td><code>TRILIUM_NETWORK_CORSRESOURCEPOLICY</code></td><td>string</td><td>same-origin</td><td>CORS Resource Policy allows same-origin/same-site/cross-origin as values, will error if not</td></tr></tbody></table></figure></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">Session</p><div class=\"trilium-tab-panel\"><figure class=\"table\"><table><thead><tr><th>Environment Variable</th><th>Type</th><th>Default</th><th>Description</th></tr></thead><tbody><tr><td><code>TRILIUM_SESSION_COOKIEMAXAGE</code></td><td>integer</td><td>1814400</td><td>Session cookie max age in seconds (21 days)</td></tr></tbody></table></figure></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">Sync</p><div class=\"trilium-tab-panel\"><figure class=\"table\"><table><thead><tr><th>Environment Variable</th><th>Type</th><th>Default</th><th>Description</th></tr></thead><tbody><tr><td><code>TRILIUM_SYNC_SYNCSERVERHOST</code></td><td>string</td><td>\"\"</td><td>Sync server host URL</td></tr><tr><td><code>TRILIUM_SYNC_SYNCSERVERTIMEOUT</code></td><td>string</td><td>\"120000\"</td><td>Sync server timeout in milliseconds</td></tr><tr><td><code>TRILIUM_SYNC_SYNCPROXY</code></td><td>string</td><td>\"\"</td><td>Sync proxy URL</td></tr></tbody></table></figure></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">MultiFactorAuthentication</p><div class=\"trilium-tab-panel\"><p>See&nbsp;<a class=\"reference-link\" href=\"#root/_help_x1lQNKQBqLcA\">Signing in with OpenID Connect</a>.</p></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">Logging</p><div class=\"trilium-tab-panel\"><figure class=\"table\"><table><thead><tr><th>Environment Variable</th><th>Type</th><th>Default</th><th>Description</th></tr></thead><tbody><tr><td><code>TRILIUM_LOGGING_RETENTIONDAYS</code></td><td>integer</td><td>90</td><td>Number of days to retain log files</td></tr></tbody></table></figure></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">Development</p><div class=\"trilium-tab-panel\"><figure class=\"table\"><table><thead><tr><th>Environment Variable</th><th>Type</th><th>Default</th><th>Description</th></tr></thead><tbody><tr><td><code>TRILIUM_MANUAL_DB_MIGRATION</code></td><td>boolean</td><td>false</td><td>If <code>true</code>, the application will not start if automatic database migrations are pending and would modify the database schema.</td></tr></tbody></table></figure></div></section></div><details class=\"trilium-collapsible\"><summary>Alternative environment variables</summary><p>The following alternative environment variable names are also supported and work identically to their longer counterparts.</p><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">Network CORS</p><div class=\"trilium-tab-panel\"><ul><li><code>TRILIUM_NETWORK_CORS_ALLOW_ORIGIN</code> (alternative to <code>TRILIUM_NETWORK_CORSALLOWORIGIN</code>)</li><li><code>TRILIUM_NETWORK_CORS_ALLOW_METHODS</code> (alternative to <code>TRILIUM_NETWORK_CORSALLOWMETHODS</code>)</li><li><code>TRILIUM_NETWORK_CORS_ALLOW_HEADERS</code> (alternative to <code>TRILIUM_NETWORK_CORSALLOWHEADERS</code>)</li><li><code>TRILIUM_NETWORK_CORS_RESOURCE_POLICY</code> (alternative to <code>TRILIUM_NETWORK_CORSRESOURCEPOLICY</code>)</li></ul></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">Sync</p><div class=\"trilium-tab-panel\"><ul><li><code>TRILIUM_SYNC_SERVER_HOST</code> (alternative to <code>TRILIUM_SYNC_SYNCSERVERHOST</code>)</li><li><code>TRILIUM_SYNC_SERVER_TIMEOUT</code> (alternative to <code>TRILIUM_SYNC_SYNCSERVERTIMEOUT</code>)</li><li><code>TRILIUM_SYNC_SERVER_PROXY</code> (alternative to <code>TRILIUM_SYNC_SYNCPROXY</code>)</li></ul></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">OAuth/MFA</p><div class=\"trilium-tab-panel\"><ul><li><code>TRILIUM_OAUTH_BASE_URL</code> (alternative to <code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHBASEURL</code>)</li><li><code>TRILIUM_OAUTH_CLIENT_ID</code> (alternative to <code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHCLIENTID</code>)</li><li><code>TRILIUM_OAUTH_CLIENT_SECRET</code> (alternative to <code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHCLIENTSECRET</code>)</li><li><code>TRILIUM_OAUTH_ISSUER_BASE_URL</code> (alternative to <code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHISSUERBASEURL</code>)</li><li><code>TRILIUM_OAUTH_ISSUER_NAME</code> (alternative to <code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHISSUERNAME</code>)</li><li><code>TRILIUM_OAUTH_ISSUER_ICON</code> (alternative to <code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHISSUERICON</code>)</li><li><code>TRILIUM_OAUTH_HTTP_TIMEOUT</code> (alternative to <code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHHTTPTIMEOUT</code>)</li><li><code>TRILIUM_OAUTH_SCOPE</code> (alternative to <code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHSCOPE</code>)</li></ul></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">Logging</p><div class=\"trilium-tab-panel\"><ul><li><code>TRILIUM_LOGGING_RETENTION_DAYS</code> (alternative to <code>TRILIUM_LOGGING_RETENTIONDAYS</code>)</li></ul></div></section></div></details><h2>Boolean Values</h2><p>Boolean environment variables accept the following values:</p><ul><li><strong>True</strong>: <code>\"true\"</code>, <code>\"1\"</code>, <code>1</code></li><li><strong>False</strong>: <code>\"false\"</code>, <code>\"0\"</code>, <code>0</code></li><li>Any other value defaults to <code>false</code></li></ul><h2>Using Environment Variables</h2><p>Both naming patterns are fully supported and can be used interchangeably:</p><ul><li>The longer format follows the section/key pattern for consistency with the INI file structure</li><li>The shorter alternatives provide convenience for common configurations</li><li>You can use whichever format you prefer - both are equally valid</li></ul><h2>Examples</h2><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-docker\"></span>&nbsp;Docker Compose</p><div class=\"trilium-tab-panel\"><pre><code class=\"language-text-x-yaml\">services:\n trilium:\n image: triliumnext/trilium\n environment:\n # Using full format\n TRILIUM_GENERAL_INSTANCENAME: \"My Trilium Instance\"\n TRILIUM_NETWORK_PORT: \"8080\"\n TRILIUM_NETWORK_CORSALLOWORIGIN: \"https://myapp.com\"\n TRILIUM_SYNC_SYNCSERVERHOST: \"https://sync.example.com\"\n TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHBASEURL: \"https://auth.example.com\"\n \n # Or using shorter alternatives (equally valid)\n # TRILIUM_NETWORK_CORS_ALLOW_ORIGIN: \"https://myapp.com\"\n # TRILIUM_SYNC_SERVER_HOST: \"https://sync.example.com\"\n # TRILIUM_OAUTH_BASE_URL: \"https://auth.example.com\"</code></pre></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-tux\"></span>&nbsp;Linux Shell</p><div class=\"trilium-tab-panel\"><pre><code class=\"language-text-x-trilium-auto\"># Using either format\nexport TRILIUM_GENERAL_NOAUTHENTICATION=false\nexport TRILIUM_NETWORK_HTTPS=true\nexport TRILIUM_NETWORK_CERTPATH=/path/to/cert.pem\nexport TRILIUM_NETWORK_KEYPATH=/path/to/key.pem\nexport TRILIUM_LOGGING_RETENTIONDAYS=30\n\n# Start Trilium\nnpm start</code></pre></div></section></div><h2>config.ini Reference</h2><p>For the complete list of configuration options and their INI file format, please review the <a href=\"https://github.com/TriliumNext/Trilium/blob/main/apps/server/src/assets/config-sample.ini\">config-sample.ini</a> file in the Trilium repository.</p>",
+ "_help_c5xB8m4g2IY6": "<p>A Trilium instance represents a server. If&nbsp;<a class=\"reference-link\" href=\"#root/_help_cbkrhQjrkKrh\">Synchronization</a>&nbsp;is set up, since multiple servers are involved (the one from the desktop client and the one the synchronisation is set up with), sometimes it can be useful to distinguish the instance you are running on.</p><h2>Setting the instance name</h2><p>To set up a name for the instance, modify the <code>config.ini</code>:</p><pre><code class=\"language-text-x-trilium-auto\">[General]\ninstanceName=Hello</code></pre><h2>Distinguishing the instance on back-end</h2><p>Use <code>api.getInstanceName()</code> to obtain the instance name of the current server, as specified in the config file or in environment variables.</p><h2>Limiting script runs based on instance</h2><p>For a script that is run periodically or on a certain event, it's possible to limit it to certain instances without having to change the code. Just add <code>runOnInstance</code> and set as the value the instance name where the script should run. To run on multiple named instances, simply add the label multiple times.</p>",
+ "_help_LWtBjFej3wX3": "<p>By default, Trilium cannot be accessed in web browsers by requests coming from other domains/origins than Trilium itself.&nbsp;</p><p>However, it is possible to manually configure <a href=\"https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/CORS\">Cross-Origin Resource Sharing (CORS)</a> since Trilium v0.93.0 using environment variables or <code>config.ini</code>, as follows:</p><figure class=\"table\"><table><thead><tr><th>CORS Header</th><th>Corresponding environment variable</th><th>Corresponding option in <code>config.ini</code> variables in the <code>Network</code> section</th></tr></thead><tbody><tr><td><code>Access-Control-Allow-Origin</code></td><td><code>TRILIUM_NETWORK_CORS_ALLOW_ORIGIN</code></td><td><code>corsAllowOrigin</code></td></tr><tr><td><code>Access-Control-Allow-Methods</code></td><td><code>TRILIUM_NETWORK_CORS_ALLOW_METHODS</code></td><td><code>corsAllowMethods</code></td></tr><tr><td><code>Access-Control-Allow-Headers</code></td><td><code>TRILIUM_NETWORK_CORS_ALLOW_HEADERS</code></td><td><code>corsAllowHeaders</code></td></tr></tbody></table></figure>",
+ "_help_ivYnonVFBxbQ": "<figure class=\"image\"><img style=\"aspect-ratio:1425/644;\" src=\"{{helpAssets}}/User%20Guide/Advanced%20Usage/Bulk%20Actions_image.png\" width=\"1425\" height=\"644\"></figure><p>The <em>Bulk Actions</em> dialog makes it easy to apply changes to multiple notes at once, ranging from simple actions such as adding or removing a label to being executing custom scripts.</p><h2>Interaction</h2><ul><li>The first step is to select the notes in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>. It's possible to apply bulk actions to:<ul><li>A single note (and potentially its child notes) simply by clicking on it (with a left click or a right click).</li><li>Multiple notes. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_yTjUdsOi4CIE\">Multiple selection</a>&nbsp;on how to do so.</li></ul></li><li>Right click in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;and select <em>Advanced</em> → <em>Apply bulk actions</em>.</li><li>The <em>Selected notes</em> section at the top of the dialog lists the notes the actions apply to. When many notes are selected, only the first few are shown; click <em>+N more</em> to show the rest.<ul><li>To leave a note out without changing the selection in the note tree, press the <span class=\"tn-icon bx bx-x\"></span> button on its entry. The last remaining note cannot be removed.</li></ul></li><li>By default, only the selected notes will be affected. To also include all the descendants of the notes, turn on <em>Include descendants of the selected notes</em>. The number of affected notes, shown below that option, updates to reflect the change.</li><li>To add an action, click <em>Add action</em> (<span class=\"tn-icon bx bx-plus\"></span>) at the bottom of the <em>Chosen actions</em> section and pick one from the menu. Hovering over an entry shows a short description of what it does; a detailed description of each is available in the next section.<ul><li>Each chosen action appears as an entry in the <em>Chosen actions</em> section, with its own configuration.</li><li>To remove an action, simply press the <span class=\"tn-icon bx bx-x\"></span> button to the right of it.</li><li>It is possible to apply multiple actions of the same type, such as adding multiple types.</li><li>The fields for a label or relation name suggest the names already used in the database as you type, marking the ones Trilium itself attaches a meaning to.</li><li>The value field of <em>Add label</em> and <em>Update label value</em> suggests the values the named label already has in the database.</li></ul></li><li>When all the actions are defined, press the <em>Apply to N notes</em> button to trigger all of them at once. The button names the number of notes that will be affected, and stays disabled until at least one action is added.<ul><li>If an action is missing a field it needs, such as the name of the label to rename, the dialog does not run and points out the empty field instead.</li></ul></li><li>For convenience, the last bulk action configuration is saved for further use and will be restored when entering the dialog again.</li></ul><h2>Actions</h2><h3>Labels</h3><p>These actions operate the&nbsp;<a class=\"reference-link\" href=\"#root/_help_HI6GBBIduIgv\">Labels</a>&nbsp;of a note. Except for <em>Add label</em>, they only affect labels set directly on the note; inherited labels are left unchanged.</p><ul><li><strong>Add label</strong><ul><li>For each note, it creates a <a href=\"#root/_help_HI6GBBIduIgv\">label</a> of the given name. Keep the <em>New value</em> field empty to create a label without a value, or complete it to assign a value.</li><li>The label is added even if the note already has one of the same name, so the note ends up with both. To change the value of an existing label instead, use <em>Update label value</em>.</li></ul></li><li><strong>Update label value</strong><ul><li>For each note, if it has a <a href=\"#root/_help_HI6GBBIduIgv\">label</a> of the given name, it will change its value to the specified one. Leave <em>New value</em> field empty to create a label without a value.</li><li>Notes without the label will not be affected.</li></ul></li><li><em><strong>Rename label</strong></em><ul><li>For each note, if it has a <a href=\"#root/_help_HI6GBBIduIgv\">label</a> of the given name, it will be renamed/replaced with a label of the new name. The value of the label (if present) will be kept intact.</li><li>Notes without the label will not be affected.</li></ul></li><li><strong>Delete label</strong><ul><li>For each note, if it has a label of a given name, it will be deleted (regardless of whether it has a value or not).</li><li>Notes without the label will not be affected.</li></ul></li></ul><h3>Relations</h3><p>These actions operate the&nbsp;<a class=\"reference-link\" href=\"#root/_help_Cq5X6iKQop6R\">Relations</a>&nbsp;of a note. Except for <em>Add relation</em>, they only affect relations set directly on the note; inherited relations are left unchanged.</p><ul><li><strong>Add relation</strong><ul><li>For each note, it will create a relation pointing to the given note.</li><li>The relation is added even if the note already has one of the same name.</li></ul></li><li><strong>Update relation target</strong><ul><li>For each note, it will modify a relation to point to the newly given note.</li><li>Notes without this relation will not be affected.</li></ul></li><li><strong>Rename relation</strong><ul><li>For each note, if it has a relation of the given name, it will be renamed/replaced with a relation of the new name. The target note of the relation will be kept intact.</li><li>Notes without this relation will not be affected.</li></ul></li><li><strong>Delete relation</strong><ul><li>For each note, if it has a relation of the given name, it will be deleted.</li><li>Notes without this relation will not be affected.</li></ul></li></ul><h3>Notes</h3><ul><li><strong>Rename note</strong><ul><li>For each note, it will change the title of the note to the given one.</li><li>The title can contain expressions between <code>${</code> and <code>}</code>, which are filled in for each note. They can read the note's properties, such as <code>${note.title}</code>, <code>${note.noteId}</code> or <code>${note.type}</code>, and call <code>getLabelValue('name')</code>, <code>getRelationValue('name')</code> or, on a date such as <code>dateCreatedObj</code>, <code>format('…')</code>. For example:<ul><li><code>NEW: ${note.title}</code> will prefix all notes with <code>NEW:</code> .</li><li><code>${note.dateCreatedObj.format('MM-DD:')}: ${note.title}</code> will prefix the note titles with each note's creation date (in month-day format).</li></ul></li><li>Only property access and those methods are allowed, not arbitrary JavaScript. While typing, the field completes the expressions, underlines one that is not allowed and shows the resulting title for the first selected note.</li></ul></li><li><strong>Move note</strong><ul><li>For each note, it will be moved to the specified parent note.</li><li>A note with several parents is cloned to the new parent instead, since it is not clear which of its places to remove.</li><li>A note that cannot be placed there, such as a parent of the target note, stays where it is.</li><li>As an alternative for less complex situations, the notes can be moved directly from within the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;via cut → paste or via the contextual menu.</li></ul></li><li><strong>Convert note</strong><ul><li>This allows a note to be converted from one type to another:<ul><li><strong>Text Notes → Markdown Notes</strong> — each&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;note is converted to a&nbsp;<a class=\"reference-link\" href=\"#root/_help_6RM1Q7ppFVoj\">Markdown</a>&nbsp;note. Since Markdown does not support all the formatting capabilities of Text Notes, some formatting may be lost and some unsupported elements may even be dropped.</li><li><strong>Markdown Notes → Text Notes</strong> — each&nbsp;<a class=\"reference-link\" href=\"#root/_help_6RM1Q7ppFVoj\">Markdown</a>&nbsp;note is converted to a&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;Note.</li></ul></li><li>For each converted note, a revision is saved automatically, allowing you to restore the original or recover any missing elements from it.</li></ul></li><li><strong>Save revision</strong><ul><li>Automatically creates a revision of each note. Optionally, a name can be assigned to this revision. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_vZWERwf8U3nx\">Note Revisions</a>.</li></ul></li><li><strong>Delete note</strong><ul><li>For each note, it will be deleted, including all of its clones and any child notes that are not cloned elsewhere.</li><li>Deleted notes can be restored from <em>Recent changes</em> until they are erased.</li><li>As an alternative for less complex situations, the notes can be removed directly from within the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;by selecting them and pressing <kbd>Delete</kbd>.</li></ul></li><li><strong>Delete note revisions</strong><ul><li>This will permanently erase all the&nbsp;<a class=\"reference-link\" href=\"#root/_help_vZWERwf8U3nx\">Note Revisions</a>&nbsp;of the notes. Unlike deleted notes, erased revisions cannot be restored.</li></ul></li></ul><h3>Others</h3><ul><li><strong>Execute script</strong><ul><li>For more complex scenarios, it is possible to type in a JavaScript expression in order to apply the necessary changes.</li><li>The script runs on the server once for each note, with that note available as <code>note</code> and the backend script API as <code>api</code>. The field completes both as you type and underlines mistakes, as the editor of a backend script note does.</li><li>Examples:<ul><li><p>To apply a suffix (<code>- suffix</code> in this example), to the note title:</p><pre><code class=\"language-text-javascript\">note.title = note.title + \" - suffix\";</code></pre></li><li><p>To alter attributes of a note based on another attribute, such as setting the <code>#shareAlias</code> label to the title of the note:</p><pre><code class=\"language-text-javascript\">note.setLabel(\"shareAlias\", note.title)</code></pre></li></ul></li></ul></li></ul>",
+ "_help_4FahAwuGTAwC": "<h2>Understanding the source code of the different notes</h2><p>Internally, the structure of the content of each note is different based on the&nbsp;<a class=\"reference-link\" href=\"#root/_help_KSZ04uQ2D1St\">Note Types</a>.</p><p>For example:</p><ul><li><a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes&nbsp;are represented internally as HTML, using the&nbsp;<a class=\"reference-link\" href=\"#root/_help_MI26XDLSAlCD\">CKEditor</a>&nbsp;representation. Note that due to the custom plugins, some HTML elements are specific to Trilium only, for example the admonitions.</li><li><a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;notes&nbsp;are plain text and are represented internally as-is.</li><li><a class=\"reference-link\" href=\"#root/_help_81SGnPGMk7Xc\">Geo Map</a>&nbsp;notes contain only minimal information (viewport, zoom) as a JSON.</li><li><a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a>&nbsp;notes are represented as JSON, with Trilium's own information alongside with&nbsp;<a href=\"#root/_help_1YeN2MzFUluU\">Excalidraw</a>'s internal JSON representation format.</li><li><a class=\"reference-link\" href=\"#root/_help_gBbsAeiuUxI5\">Mind Map</a>&nbsp;notes are represented as JSON, with the internal format of&nbsp;<a href=\"#root/_help_1YeN2MzFUluU\">MindElixir</a>.</li></ul><p>Note that some information is also stored as&nbsp;<a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>. For example&nbsp;<a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a>&nbsp;notes use the attachments feature to store the custom libraries, and alongside with&nbsp;<a class=\"reference-link\" href=\"#root/_help_gBbsAeiuUxI5\">Mind Map</a>&nbsp;and other similar note types it stores an SVG representation of the content for use in other features such as including in other notes, shared notes, etc.</p><p>Here's part of the HTML representation of this note, as it's stored in the database (but prettified).</p><pre><code class=\"language-text-x-trilium-auto\">&lt;h2&gt;\n\tUnderstanding the source code of the different notes\n&lt;/h2&gt;\n&lt;p&gt;\n\tInternally, the structure of the content of each note is different based on the&amp;nbsp;\n\t&lt;a class=\"reference-link\" href=\"#root/_help_KSZ04uQ2D1St\"&gt;\n\t\tNote Types\n\t&lt;/a&gt;\n\t.\n&lt;/p&gt;</code></pre><h2>Viewing the source code</h2><p>It is possible to view the source code of a note by pressing the contextual menu in&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>&nbsp;and selecting <em>Note source</em>.</p><p><img src=\"{{helpAssets}}/User%20Guide/Advanced%20Usage/Note%20source_image.png\"></p><p>The source code will be displayed in a new tab.</p><p>For some note types, such as text notes and JSON notes, the source code is also formatted in order to be more easily readable.</p><h2>Modifying the source code</h2><p>It is possible to modify the source code of a note directly, however not via the <em>Note source</em> functionality.&nbsp;</p><p>To do so:</p><ol><li>Change the note type from the real note type (e.g. Canvas, Geo Type) to Code (plain text) or the corresponding format such as JSON or HTML.</li><li>Confirm the warning about changing the note type.</li><li>The source code will appear, make the necessary modifications.</li><li>Change the note type back to the real note type.</li></ol><aside class=\"admonition warning\"><p>Depending on the changes made, there is a risk that the note will not render properly. It's best to save a revision before making any big changes.</p><p>If the note does not render properly, modify the source code again or revert to a prior revision. Since the error handling for unexpected changes might not always be perfect, it be required to refresh the application.</p></aside>",
+ "_help_1YeN2MzFUluU": "<p>One core aspect of Trilium that allows it to have support for multiple&nbsp;<a href=\"#root/_help_KSZ04uQ2D1St\">Note Types</a>&nbsp;is the fact that it makes use of various off-the-shelf or reusable libraries.</p><p>This page showcases some of the technologies used, for a better understanding of how Trilium works but also to credit the developers of that particular technology.</p><h2>CKEditor</h2><p>CKEditor is the editor behind&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes, as well as integrated in various facets of the application such as the attribute editor in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_AlJ73vBCjWDw\">Status bar</a>&nbsp;or the chat box in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_GBBMSlVSOIGP\">AI</a>&nbsp;sidebar or notes.</p><p>For more information see&nbsp;<a class=\"reference-link\" href=\"#root/_help_MI26XDLSAlCD\">CKEditor</a>.</p><h2>Excalidraw</h2><p><a href=\"https://excalidraw.com/\">Excalidraw</a> is the technology behind the&nbsp;<a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a>&nbsp;notes. The source code of the library is available on <a href=\"https://github.com/excalidraw/excalidraw\">GitHub</a>.</p><p>We are using an unmodified version of it, so it shares the same <a href=\"https://github.com/excalidraw/excalidraw/issues\">issues</a> as the original.</p><h2>MapLibre GL JS</h2><p>Trilium v0.105.0 introduces <a href=\"https://github.com/maplibre/maplibre-gl-js\">MapLibre GL JS</a> for the&nbsp;<a class=\"reference-link\" href=\"#root/_help_81SGnPGMk7Xc\">Geo Map</a>&nbsp;collection, which brings improved performance by using graphical acceleration (WebGL). Trilium ships its own track parsing logic as well as most of the UI such as the right panel.</p><h2>MindElixir</h2><p>MindElixir is the library we are using for&nbsp;<a class=\"reference-link\" href=\"#root/_help_gBbsAeiuUxI5\">Mind Map</a>&nbsp;note types. The main library is available on <a href=\"https://github.com/SSShooter/mind-elixir-core/issues\">GitHub as mind-elixir-core</a>.</p><p>Trilium ships its own UI which covers the toolbars, the contextual menu, the zoom buttons and the right panel that shows when clicking a node.</p><h2>FullCalendar</h2><p><a href=\"https://fullcalendar.io/\">FullCalendar</a> is the technology behind the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xWbu3jpNWapp\">Calendar</a>&nbsp;collection, providing the various views (day, week, month, year) and the event management. Trilium also ships its own UI in the form of the popup that appears when editing, as well as the header that appears in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>.</p><p>Licensed under the MIT license.</p>",
+ "_help_MI26XDLSAlCD": "<h2>Editor core</h2><p>The CKEditor is the WYSIWYG (standing for What You See Is What You Get) editor behind&nbsp;<a href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes.</p><p>Their website is <a href=\"https://ckeditor.com/\">ckeditor.com</a>.</p><p>CKEditor by itself is a commercial product, but the core is open-source. As described in <a href=\"https://ckeditor.com/docs/ckeditor5/latest/features/index.html\">its documentation</a>, the editor supports quite a large number of features. Do note that not all the features are enabled in Trilium.</p><h2>Premium features</h2><p>CKEditor ships some plugins as premium (slash commands, templates, AI integration). Initially Trilium (since v0.96.0) shipped some of them like slash commands as part of a license grant from CKEditor to the Trilium Notes developers.</p><p>In v0.105.0 we've decided to replace those premium plugins with our own open-source implementations. This also means that we can better tailor those plugins to the Trilium app.</p><h2>Plugins</h2><p>The CKEditor ecosystem is quite extensible, in the sense that custom plugins can be written to extend the functionality of the editor beyond its original scope.</p><p>Trilium makes use of such features:</p><ul><li>The math feature is added by a version of <a href=\"https://github.com/isaul32/ckeditor5-math\">isaul32/ckeditor5-math: Math feature for CKEditor 5.</a> modified by us to fit our needs.</li><li>We also make use of modified upstream plugins such as <a href=\"https://github.com/ckeditor/ckeditor5-mermaid\">ckeditor/ckeditor5-mermaid</a> to allow inline Mermaid code.</li><li><a href=\"https://github.com/mlewand/ckeditor5-keyboard-marker\">mlewand/ckeditor5-keyboard-marker: Plugin adds support for the keyboard input element (<code>&lt;kbd&gt;</code>) to CKEditor 5.</a></li><li>A modified version of <a href=\"https://github.com/ThomasAitken/ckeditor5-footnotes\">ThomasAitken/ckeditor5-footnotes: Footnotes plugin for CKEditor5</a> to allow footnotes.</li></ul><p>Apart from that, Trilium also has its own set of specific plugins such as:</p><ul><li><a class=\"reference-link\" href=\"#root/_help_2x0ZAX9ePtzV\">Cut to subnote</a></li><li><a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a></li><li>Mentions, for linking pages.</li><li><a class=\"reference-link\" href=\"#root/_help_Oau6X9rCuegd\">Markdown</a></li><li><a href=\"#root/_help_QEAPj01N5f7w\">Reference links</a></li><li><a href=\"#root/_help_NwBbFdNZ9h7O\">Admonitions</a>, we ended up creating our own plugin but <a href=\"https://github.com/aarkue/ckeditor5-admonition\">aarkue/ckeditor5-admonition</a> was a good inspiration (including the toolbar icon).</li></ul>",
+ "_help_m1lbrzyKDaRB": "<p>Whereas some applications use file names to uniquely identify notes, Trilium uses the concept of Note ID.</p><p>Generally, the Note ID is a 12-character long alphanumeric sequence (including both lower and upper case letter) that is randomly generated for each new note.</p><h2>How does the import/export affect the note IDs</h2><p>When notes are exported, their note ID is kept in the metadata of the export. However when they are imported back in, a new note ID is generated for all the notes. This also includes other entities that are part of the import/export process such as&nbsp;<a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>.</p><h2>Note collisions</h2><p>Since the Note ID is a fixed-width randomly generated number, due to the <a href=\"https://en.wikipedia.org/wiki/Pigeonhole_principle\">pigeonhole principle</a>, there is a possibility that a newly created note will have the same ID as an existing note.</p><p>Since the note ID is alphanumeric and the length is 12 we have&nbsp;<span class=\"math-tex\">\\(62^{12}\\)</span>&nbsp;unique IDs. However since we are generating them randomly, we can use a collision calculator such as the one for <a href=\"https://alex7kom.github.io/nano-nanoid-cc/?alphabet=0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz&amp;size=12&amp;speed=1000&amp;speedUnit=hour\">Nano ID</a> to determine that we'd need to create 1000 notes per hour every hour for 9 centuries in order to have at least 1% probability of a note collision.</p><p>As such, Trilium does not take any explicit action against potential note collisions, similar to other software that makes uses of unique hashes such as <a href=\"https://stackoverflow.com/questions/10434326/hash-collision-in-git\">Git</a>. If one would theoretically occur, what would most likely happen is that the existing note will be replaced by the new one.</p>",
+ "_help_2mUhVmZK8RF3": "<figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:263/445;\" src=\"{{helpAssets}}/User%20Guide/Advanced%20Usage/Hidden%20Notes_image.png\" width=\"263\" height=\"445\"></figure><p>For easy extensibility, a lot of features in Trilium make use of actual notes to store information as opposed to having them stored in a separate location in the database. This allows some functions such as&nbsp;<a class=\"reference-link\" href=\"#root/_help_zEY4DaJG4YT5\">Attributes</a>,&nbsp;<a class=\"reference-link\" href=\"#root/_help_Cq5X6iKQop6R\">Relations</a>&nbsp;or even&nbsp;<a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>&nbsp;and&nbsp;<a class=\"reference-link\" href=\"#root/_help_QEAPj01N5f7w\">Links</a>&nbsp;to be able to operate on them.</p><p>As the name suggests, these notes are hidden to the user by default to prevent cluttering the note tree and to prevent them from being accidentally deleted.</p><p>The hidden notes are stored in the user's&nbsp;<a class=\"reference-link\" href=\"#root/_help_wX4HbRucYSDD\">Database</a>&nbsp;just like normal notes, but they have a unique&nbsp;<a class=\"reference-link\" href=\"#root/_help_m1lbrzyKDaRB\">Note ID</a>&nbsp;which allows them to be distinguished from the normal ones.</p><h2>Accessing the hidden note tree</h2><p>From the&nbsp;<a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a>, select <em>Advanced</em> → <em>Show Hidden Subtree</em>.</p><h2>Contents of the hidden note tree</h2><p>Here is a brief summary of all the notes within the hidden tree:</p><figure class=\"table\"><table class=\"ck-table-resized\"><colgroup><col style=\"width:19.93%;\"><col style=\"width:80.07%;\"></colgroup><thead><tr><th>Note</th><th>Description</th></tr></thead><tbody><tr><td><a class=\"reference-link\" href=\"#root/_hidden/_globalNoteMap\">Note Map</a></td><td><p>This note is actually opened when the&nbsp;<a class=\"reference-link\" href=\"#root/_help_bdUJEHsAPYQR\">Note Map</a>&nbsp;feature that is accessed from the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>.</p><p>It is possible to create any child notes in it without any additional meaning. For example, it can be used to store a list of note maps which can be linked to from other notes or <a href=\"#root/_help_u3YFHC9tQlpm\">bookmarked</a>.</p></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_hidden/_sqlConsole\">SQL Console History</a></td><td><p>When SQL queries or commands are executed in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_YKWqdJhzi2VY\">SQL Console</a>, they are stored here, grouped by month. Only the query is stored and not the results.</p><p>This section can be accessed without going to the hidden tree by simply going to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a>&nbsp;and selecting Advanced → Open SQL Console History.</p><p>Notes can be added as children of this tree, but it's generally not recommended to do so to not interfere with the normal history process.</p></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_hidden/_search\">Search History</a></td><td><p>Whenever a search is executed from the full&nbsp;<a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>, the query will be stored here, grouped by month. Only the search parameters are stored and not the results themselves.</p><p>This section can be accessed without going to the hidden tree by simply going to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a>&nbsp;and selecting Advanced → Open Search History.</p><p>Notes can be added as children of this tree, but it's generally not recommended to do so to not interfere with the normal history process.</p></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_hidden/_bulkAction\">Bulk Action</a></td><td><p>This section is used for&nbsp;<a class=\"reference-link\" href=\"#root/_help_ivYnonVFBxbQ\">Bulk Actions</a>. The last configuration for bulk actions will be stored as part of this note, each action in its own <code>action</code> label.</p><p>Notes can be added as children of this tree, but there won't be any benefit in doing so.</p></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_hidden/_backendLog\">Backend Log</a></td><td><p>This note corresponds to the backend log feature (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_qzNzp9LYQyPT\">Error logs</a>).</p><p>This item can be accessed without going to the hidden try by going to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a>&nbsp;and selecting Advanced → Show backend log.</p></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_hidden/_userHidden\">User Hidden</a></td><td>This section can be used by <a href=\"#root/_help_CdNpE2pqjmI6\">scripts</a> to create their own notes that should not be directly visible to the user. The note can be identified by scripts by its unique ID: <code>_userHidden</code></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_hidden/_lbTplRoot\">Launch Bar Templates</a></td><td><p>This section contains the templates for the creation of launchers in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>. It is not possible to create child notes here.</p><p>Theoretically some of the notes here can be customized, but there's not much benefit to be had in doing so.</p></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_hidden/_share\">Shared Notes</a></td><td><p>This tree lists all of the notes that are <a href=\"#root/_help_R9pX4DGra2Vt\">shared</a> publicly. It can be useful to track down which notes are shared regardless of their position in the note tree.</p><p>This section can be accessed without going to the hidden tree simply by going to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a>&nbsp;and selecting <em>Show Shared Notes Subtree</em>.</p><p>Sub-notes cannot be created here.</p></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_hidden/_lbRoot\">Launch Bar</a></td><td><p>The tree contains both available and displayed items of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>.</p><p>This section can be accessed without going to the hidden tree by:</p><ul><li>Going to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a>&nbsp;and selecting <em>Configure Launchbar…</em>.</li><li>Right-clicking an empty space on the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>&nbsp;and selecting <em>Configure Launchbar…</em>.</li></ul><p>Sub-notes cannot be created here.</p></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_hidden/_options\">Options</a></td><td><p>This section stores the list of&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>.</p><p>This section can be accessed without going to the hidden tree by:</p><ul><li>Going to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a>&nbsp;and selecting <em>Options</em>.</li><li>Pressing the dedicated Options icon in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>.</li></ul></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_hidden/_lbMobileRoot\">Mobile Launch Bar</a></td><td><p>This is very similar to the <em>Launch Bar</em>, but is dedicated for the mobile UI only.</p><p>Accessing it outside the <em>Launch Bar</em> is the same as the Launch Bar, but needs to be done so from the mobile interface.</p></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_hidden/_help\">User Guide</a></td><td>This is where the User Guide appears in the note tree. Its notes are not stored in the database: Trilium builds them from files that ship with the application each time it starts, so they cannot be edited, moved or cloned, and they are not synchronized.</td></tr></tbody></table></figure>",
+ "_help_uYF7pmepw27K": "<p>The Trilium Metrics API provides comprehensive monitoring data about your Trilium instance, designed for external monitoring systems like Prometheus.</p><h2>Endpoint</h2><ul><li><strong>URL</strong>: <code>/etapi/metrics</code></li><li><strong>Method</strong>: <code>GET</code></li><li><strong>Authentication</strong>: ETAPI token required</li><li><strong>Default Format</strong>: Prometheus text format</li></ul><h2>Authentication</h2><p>You need an ETAPI token to access the metrics endpoint. Get one by:</p><pre><code class=\"language-text-x-trilium-auto\"># Get an ETAPI token\ncurl -X POST http://localhost:8080/etapi/auth/login \\\n -H \"Content-Type: application/json\" \\\n -d '{\"password\": \"your_password\"}'\n</code></pre><h2>Usage</h2><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">Prometheus Format (Default)</p><div class=\"trilium-tab-panel\"><pre><code class=\"language-text-x-trilium-auto\">curl -H \"Authorization: YOUR_ETAPI_TOKEN\" \\\n http://localhost:8080/etapi/metrics\n</code></pre><p>Returns metrics in Prometheus text format:</p><pre><code class=\"language-text-x-trilium-auto\"># HELP trilium_info Trilium instance information\n# TYPE trilium_info gauge\ntrilium_info{version=\"0.91.6\",db_version=\"231\",node_version=\"v18.17.0\"} 1 1701432000\n\n# HELP trilium_notes_total Total number of notes including deleted\n# TYPE trilium_notes_total gauge\ntrilium_notes_total 1234 1701432000</code></pre></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">JSON Format</p><div class=\"trilium-tab-panel\"><pre><code class=\"language-text-x-trilium-auto\">curl -H \"Authorization: YOUR_ETAPI_TOKEN\" \\\n \"http://localhost:8080/etapi/metrics?format=json\"\n</code></pre><p>Returns detailed metrics in JSON format for debugging or custom integrations.</p></div></section></div><h2>Available Metrics</h2><h3>Instance Information</h3><ul><li><code>trilium_info</code> - Version and build information with labels</li></ul><h3>Database Metrics</h3><ul><li><code>trilium_notes_total</code> - Total notes (including deleted)</li><li><code>trilium_notes_deleted</code> - Number of deleted notes</li><li><code>trilium_notes_active</code> - Number of active notes</li><li><code>trilium_notes_protected</code> - Number of protected notes</li><li><code>trilium_attachments_total</code> - Total attachments</li><li><code>trilium_attachments_active</code> - Active attachments</li><li><code>trilium_revisions_total</code> - Total note revisions</li><li><code>trilium_branches_total</code> - Active branches</li><li><code>trilium_attributes_total</code> - Active attributes</li><li><code>trilium_blobs_total</code> - Total blob records</li><li><code>trilium_etapi_tokens_total</code> - Active ETAPI tokens</li><li><code>trilium_embeddings_total</code> - Note embeddings (if available)</li></ul><h3>Categorized Metrics</h3><ul><li><code>trilium_notes_by_type{type=\"text|code|image|file\"}</code> - Notes by type</li><li><code>trilium_attachments_by_type{mime_type=\"...\"}</code> - Attachments by MIME type</li></ul><h3>Statistics</h3><ul><li><code>trilium_database_size_bytes</code> - Database size in bytes</li><li><code>trilium_oldest_note_timestamp</code> - Timestamp of oldest note</li><li><code>trilium_newest_note_timestamp</code> - Timestamp of newest note</li><li><code>trilium_last_modified_timestamp</code> - Last modification timestamp</li></ul><h2>Prometheus Configuration</h2><p>Add to your <code>prometheus.yml</code>:</p><pre><code class=\"language-text-x-trilium-auto\">scrape_configs:\n - job_name: 'trilium'\n static_configs:\n - targets: ['localhost:8080']\n metrics_path: '/etapi/metrics'\n bearer_token: 'YOUR_ETAPI_TOKEN'\n scrape_interval: 30s\n</code></pre><h2>Error Responses</h2><ul><li><code>400</code> - Invalid format parameter</li><li><code>401</code> - Missing or invalid ETAPI token</li><li><code>500</code> - Internal server error</li></ul><h2>Grafana Dashboard</h2><figure class=\"image\"><img style=\"aspect-ratio:2594/1568;\" src=\"{{helpAssets}}/User%20Guide/Advanced%20Usage/1_Metrics_image.png\" width=\"2594\" height=\"1568\"></figure><p>You can also use the Grafana Dashboard that has been created for TriliumNext - just take the JSON from&nbsp;<a class=\"reference-link\" href=\"#root/_help_bOP3TB56fL1V\">grafana-dashboard.json</a>&nbsp;and then import the dashboard, following these screenshots:</p><figure class=\"image\"><img style=\"aspect-ratio:1881/282;\" src=\"{{helpAssets}}/User%20Guide/Advanced%20Usage/2_Metrics_image.png\" width=\"1881\" height=\"282\"></figure><p>Then paste the JSON, and hit load:</p><figure class=\"image\"><img style=\"aspect-ratio:1055/830;\" src=\"{{helpAssets}}/User%20Guide/Advanced%20Usage/Metrics_image.png\" width=\"1055\" height=\"830\"></figure>",
+ "_help_bOP3TB56fL1V": "{\n \"annotations\": {\n \"list\": [\n {\n \"builtIn\": 1,\n \"datasource\": {\n \"type\": \"grafana\",\n \"uid\": \"-- Grafana --\"\n },\n \"enable\": true,\n \"hide\": true,\n \"iconColor\": \"rgba(0, 211, 255, 1)\",\n \"name\": \"Annotations & Alerts\",\n \"type\": \"dashboard\"\n }\n ]\n },\n \"editable\": true,\n \"fiscalYearStartMonth\": 0,\n \"graphTooltip\": 1,\n \"id\": 549,\n \"links\": [],\n \"panels\": [\n {\n \"collapsed\": false,\n \"gridPos\": {\n \"h\": 1,\n \"w\": 24,\n \"x\": 0,\n \"y\": 0\n },\n \"id\": 100,\n \"panels\": [],\n \"title\": \"🏠 Trilium Overview\",\n \"type\": \"row\"\n },\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"description\": \"Current Trilium version and build information\",\n \"fieldConfig\": {\n \"defaults\": {\n \"color\": {\n \"mode\": \"thresholds\"\n },\n \"custom\": {\n \"align\": \"auto\",\n \"cellOptions\": {\n \"type\": \"auto\"\n },\n \"filterable\": false,\n \"inspect\": false\n },\n \"mappings\": [],\n \"thresholds\": {\n \"mode\": \"absolute\",\n \"steps\": [\n {\n \"color\": \"green\"\n }\n ]\n }\n },\n \"overrides\": []\n },\n \"gridPos\": {\n \"h\": 6,\n \"w\": 12,\n \"x\": 0,\n \"y\": 1\n },\n \"id\": 101,\n \"options\": {\n \"cellHeight\": \"sm\",\n \"footer\": {\n \"countRows\": false,\n \"fields\": \"\",\n \"reducer\": [\n \"sum\"\n ],\n \"show\": false\n },\n \"showHeader\": true\n },\n \"pluginVersion\": \"12.0.1\",\n \"targets\": [\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"expr\": \"trilium_info{job=~'$job',instance=~'$instance'}\",\n \"format\": \"table\",\n \"instant\": true,\n \"refId\": \"A\"\n }\n ],\n \"title\": \"📋 Instance Information\",\n \"transformations\": [\n {\n \"id\": \"organize\",\n \"options\": {\n \"excludeByName\": {\n \"Time\": true,\n \"Value\": true,\n \"__name__\": true,\n \"instance\": true,\n \"job\": true\n },\n \"indexByName\": {},\n \"renameByName\": {\n \"build_date\": \"Build Date\",\n \"build_revision\": \"Git Revision\",\n \"db_version\": \"DB Version\",\n \"node_version\": \"Node.js\",\n \"sync_version\": \"Sync Version\",\n \"version\": \"Version\"\n }\n }\n }\n ],\n \"type\": \"table\"\n },\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"description\": \"Database file size in human-readable format\",\n \"fieldConfig\": {\n \"defaults\": {\n \"color\": {\n \"mode\": \"thresholds\"\n },\n \"mappings\": [],\n \"thresholds\": {\n \"mode\": \"absolute\",\n \"steps\": [\n {\n \"color\": \"green\"\n },\n {\n \"color\": \"yellow\",\n \"value\": 500000000\n },\n {\n \"color\": \"red\",\n \"value\": 1000000000\n }\n ]\n },\n \"unit\": \"decbytes\"\n },\n \"overrides\": []\n },\n \"gridPos\": {\n \"h\": 6,\n \"w\": 6,\n \"x\": 12,\n \"y\": 1\n },\n \"id\": 102,\n \"options\": {\n \"colorMode\": \"background\",\n \"graphMode\": \"area\",\n \"justifyMode\": \"center\",\n \"orientation\": \"auto\",\n \"percentChangeColorMode\": \"standard\",\n \"reduceOptions\": {\n \"calcs\": [\n \"lastNotNull\"\n ],\n \"fields\": \"\",\n \"values\": false\n },\n \"showPercentChange\": false,\n \"textMode\": \"auto\",\n \"wideLayout\": true\n },\n \"pluginVersion\": \"12.0.1\",\n \"targets\": [\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"expr\": \"trilium_database_size_bytes{job=~'$job',instance=~'$instance'}\",\n \"refId\": \"A\"\n }\n ],\n \"title\": \"💾 Database Size\",\n \"type\": \"stat\"\n },\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"description\": \"Total active notes in your Trilium instance\",\n \"fieldConfig\": {\n \"defaults\": {\n \"color\": {\n \"mode\": \"thresholds\"\n },\n \"mappings\": [],\n \"thresholds\": {\n \"mode\": \"absolute\",\n \"steps\": [\n {\n \"color\": \"green\"\n },\n {\n \"color\": \"yellow\",\n \"value\": 1000\n },\n {\n \"color\": \"red\",\n \"value\": 5000\n }\n ]\n },\n \"unit\": \"short\"\n },\n \"overrides\": []\n },\n \"gridPos\": {\n \"h\": 6,\n \"w\": 6,\n \"x\": 18,\n \"y\": 1\n },\n \"id\": 103,\n \"options\": {\n \"colorMode\": \"background\",\n \"graphMode\": \"area\",\n \"justifyMode\": \"center\",\n \"orientation\": \"auto\",\n \"percentChangeColorMode\": \"standard\",\n \"reduceOptions\": {\n \"calcs\": [\n \"lastNotNull\"\n ],\n \"fields\": \"\",\n \"values\": false\n },\n \"showPercentChange\": false,\n \"textMode\": \"auto\",\n \"wideLayout\": true\n },\n \"pluginVersion\": \"12.0.1\",\n \"targets\": [\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"expr\": \"trilium_notes_active{job=~'$job',instance=~'$instance'}\",\n \"refId\": \"A\"\n }\n ],\n \"title\": \"📝 Active Notes\",\n \"type\": \"stat\"\n },\n {\n \"collapsed\": false,\n \"gridPos\": {\n \"h\": 1,\n \"w\": 24,\n \"x\": 0,\n \"y\": 7\n },\n \"id\": 200,\n \"panels\": [],\n \"title\": \"📊 Key Metrics\",\n \"type\": \"row\"\n },\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"description\": \"Total notes including deleted ones\",\n \"fieldConfig\": {\n \"defaults\": {\n \"color\": {\n \"mode\": \"palette-classic\"\n },\n \"custom\": {\n \"hideFrom\": {\n \"legend\": false,\n \"tooltip\": false,\n \"viz\": false\n }\n },\n \"mappings\": [],\n \"unit\": \"short\"\n },\n \"overrides\": []\n },\n \"gridPos\": {\n \"h\": 8,\n \"w\": 6,\n \"x\": 0,\n \"y\": 8\n },\n \"id\": 201,\n \"options\": {\n \"legend\": {\n \"displayMode\": \"list\",\n \"placement\": \"bottom\",\n \"showLegend\": true,\n \"values\": []\n },\n \"pieType\": \"pie\",\n \"reduceOptions\": {\n \"calcs\": [\n \"lastNotNull\"\n ],\n \"fields\": \"\",\n \"values\": false\n },\n \"tooltip\": {\n \"hideZeros\": false,\n \"mode\": \"single\",\n \"sort\": \"none\"\n }\n },\n \"pluginVersion\": \"12.0.1\",\n \"targets\": [\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"expr\": \"trilium_notes_active{job=~'$job',instance=~'$instance'}\",\n \"legendFormat\": \"Active Notes\",\n \"refId\": \"A\"\n },\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"expr\": \"trilium_notes_deleted{job=~'$job',instance=~'$instance'}\",\n \"legendFormat\": \"Deleted Notes\",\n \"refId\": \"B\"\n },\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"expr\": \"trilium_notes_protected{job=~'$job',instance=~'$instance'}\",\n \"legendFormat\": \"Protected Notes\",\n \"refId\": \"C\"\n }\n ],\n \"title\": \"📝 Notes Distribution\",\n \"type\": \"piechart\"\n },\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"description\": \"Breakdown of attachments by MIME type\",\n \"fieldConfig\": {\n \"defaults\": {\n \"color\": {\n \"mode\": \"palette-classic\"\n },\n \"custom\": {\n \"hideFrom\": {\n \"legend\": false,\n \"tooltip\": false,\n \"viz\": false\n }\n },\n \"mappings\": [],\n \"unit\": \"short\"\n },\n \"overrides\": []\n },\n \"gridPos\": {\n \"h\": 8,\n \"w\": 6,\n \"x\": 6,\n \"y\": 8\n },\n \"id\": 202,\n \"options\": {\n \"legend\": {\n \"displayMode\": \"list\",\n \"placement\": \"bottom\",\n \"showLegend\": true,\n \"values\": []\n },\n \"pieType\": \"donut\",\n \"reduceOptions\": {\n \"calcs\": [\n \"lastNotNull\"\n ],\n \"fields\": \"\",\n \"values\": false\n },\n \"tooltip\": {\n \"hideZeros\": false,\n \"mode\": \"single\",\n \"sort\": \"none\"\n }\n },\n \"pluginVersion\": \"12.0.1\",\n \"targets\": [\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"expr\": \"trilium_attachments_by_type{job=~'$job',instance=~'$instance'}\",\n \"legendFormat\": \"{{mime_type}}\",\n \"refId\": \"A\"\n }\n ],\n \"title\": \"🖼️ Attachments by Type\",\n \"type\": \"piechart\"\n },\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"description\": \"Distribution of notes by their content type\",\n \"fieldConfig\": {\n \"defaults\": {\n \"color\": {\n \"mode\": \"palette-classic\"\n },\n \"custom\": {\n \"hideFrom\": {\n \"legend\": false,\n \"tooltip\": false,\n \"viz\": false\n }\n },\n \"mappings\": [],\n \"unit\": \"short\"\n },\n \"overrides\": []\n },\n \"gridPos\": {\n \"h\": 8,\n \"w\": 12,\n \"x\": 12,\n \"y\": 8\n },\n \"id\": 203,\n \"options\": {\n \"legend\": {\n \"displayMode\": \"table\",\n \"placement\": \"right\",\n \"showLegend\": true,\n \"values\": [\n \"value\",\n \"percent\"\n ]\n },\n \"pieType\": \"donut\",\n \"reduceOptions\": {\n \"calcs\": [\n \"lastNotNull\"\n ],\n \"fields\": \"\",\n \"values\": false\n },\n \"tooltip\": {\n \"hideZeros\": false,\n \"mode\": \"single\",\n \"sort\": \"none\"\n }\n },\n \"pluginVersion\": \"12.0.1\",\n \"targets\": [\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"expr\": \"trilium_notes_by_type{job=~'$job',instance=~'$instance'}\",\n \"legendFormat\": \"{{type}}\",\n \"refId\": \"A\"\n }\n ],\n \"title\": \"📄 Notes by Content Type\",\n \"type\": \"piechart\"\n },\n {\n \"collapsed\": false,\n \"gridPos\": {\n \"h\": 1,\n \"w\": 24,\n \"x\": 0,\n \"y\": 16\n },\n \"id\": 300,\n \"panels\": [],\n \"title\": \"📈 Trends & Time Series\",\n \"type\": \"row\"\n },\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"description\": \"Growth of notes over time\",\n \"fieldConfig\": {\n \"defaults\": {\n \"color\": {\n \"mode\": \"palette-classic\"\n },\n \"custom\": {\n \"axisBorderShow\": false,\n \"axisCenteredZero\": false,\n \"axisColorMode\": \"text\",\n \"axisLabel\": \"\",\n \"axisPlacement\": \"auto\",\n \"barAlignment\": 0,\n \"barWidthFactor\": 0.6,\n \"drawStyle\": \"line\",\n \"fillOpacity\": 20,\n \"gradientMode\": \"hue\",\n \"hideFrom\": {\n \"legend\": false,\n \"tooltip\": false,\n \"viz\": false\n },\n \"insertNulls\": false,\n \"lineInterpolation\": \"smooth\",\n \"lineWidth\": 3,\n \"pointSize\": 8,\n \"scaleDistribution\": {\n \"type\": \"linear\"\n },\n \"showPoints\": \"auto\",\n \"spanNulls\": false,\n \"stacking\": {\n \"group\": \"A\",\n \"mode\": \"none\"\n },\n \"thresholdsStyle\": {\n \"mode\": \"off\"\n }\n },\n \"mappings\": [],\n \"thresholds\": {\n \"mode\": \"absolute\",\n \"steps\": [\n {\n \"color\": \"green\"\n }\n ]\n },\n \"unit\": \"short\"\n },\n \"overrides\": [\n {\n \"matcher\": {\n \"id\": \"byName\",\n \"options\": \"Active Notes\"\n },\n \"properties\": [\n {\n \"id\": \"color\",\n \"value\": {\n \"fixedColor\": \"blue\",\n \"mode\": \"fixed\"\n }\n }\n ]\n },\n {\n \"matcher\": {\n \"id\": \"byName\",\n \"options\": \"Total Notes\"\n },\n \"properties\": [\n {\n \"id\": \"color\",\n \"value\": {\n \"fixedColor\": \"green\",\n \"mode\": \"fixed\"\n }\n }\n ]\n }\n ]\n },\n \"gridPos\": {\n \"h\": 8,\n \"w\": 12,\n \"x\": 0,\n \"y\": 17\n },\n \"id\": 301,\n \"options\": {\n \"legend\": {\n \"calcs\": [\n \"last\",\n \"max\"\n ],\n \"displayMode\": \"table\",\n \"placement\": \"bottom\",\n \"showLegend\": true\n },\n \"tooltip\": {\n \"hideZeros\": false,\n \"mode\": \"multi\",\n \"sort\": \"desc\"\n }\n },\n \"pluginVersion\": \"12.0.1\",\n \"targets\": [\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"expr\": \"trilium_notes_active{job=~'$job',instance=~'$instance'}\",\n \"legendFormat\": \"Active Notes\",\n \"refId\": \"A\"\n },\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"expr\": \"trilium_notes_total{job=~'$job',instance=~'$instance'}\",\n \"legendFormat\": \"Total Notes\",\n \"refId\": \"B\"\n }\n ],\n \"title\": \"📈 Notes Growth Over Time\",\n \"type\": \"timeseries\"\n },\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"description\": \"Attachment storage trends\",\n \"fieldConfig\": {\n \"defaults\": {\n \"color\": {\n \"mode\": \"palette-classic\"\n },\n \"custom\": {\n \"axisBorderShow\": false,\n \"axisCenteredZero\": false,\n \"axisColorMode\": \"text\",\n \"axisLabel\": \"\",\n \"axisPlacement\": \"auto\",\n \"barAlignment\": 0,\n \"barWidthFactor\": 0.6,\n \"drawStyle\": \"line\",\n \"fillOpacity\": 20,\n \"gradientMode\": \"hue\",\n \"hideFrom\": {\n \"legend\": false,\n \"tooltip\": false,\n \"viz\": false\n },\n \"insertNulls\": false,\n \"lineInterpolation\": \"smooth\",\n \"lineWidth\": 3,\n \"pointSize\": 8,\n \"scaleDistribution\": {\n \"type\": \"linear\"\n },\n \"showPoints\": \"auto\",\n \"spanNulls\": false,\n \"stacking\": {\n \"group\": \"A\",\n \"mode\": \"none\"\n },\n \"thresholdsStyle\": {\n \"mode\": \"off\"\n }\n },\n \"mappings\": [],\n \"thresholds\": {\n \"mode\": \"absolute\",\n \"steps\": [\n {\n \"color\": \"green\"\n }\n ]\n },\n \"unit\": \"short\"\n },\n \"overrides\": [\n {\n \"matcher\": {\n \"id\": \"byName\",\n \"options\": \"Active Attachments\"\n },\n \"properties\": [\n {\n \"id\": \"color\",\n \"value\": {\n \"fixedColor\": \"purple\",\n \"mode\": \"fixed\"\n }\n }\n ]\n },\n {\n \"matcher\": {\n \"id\": \"byName\",\n \"options\": \"Total Attachments\"\n },\n \"properties\": [\n {\n \"id\": \"color\",\n \"value\": {\n \"fixedColor\": \"orange\",\n \"mode\": \"fixed\"\n }\n }\n ]\n }\n ]\n },\n \"gridPos\": {\n \"h\": 8,\n \"w\": 12,\n \"x\": 12,\n \"y\": 17\n },\n \"id\": 302,\n \"options\": {\n \"legend\": {\n \"calcs\": [\n \"last\",\n \"max\"\n ],\n \"displayMode\": \"table\",\n \"placement\": \"bottom\",\n \"showLegend\": true\n },\n \"tooltip\": {\n \"hideZeros\": false,\n \"mode\": \"multi\",\n \"sort\": \"desc\"\n }\n },\n \"pluginVersion\": \"12.0.1\",\n \"targets\": [\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"expr\": \"trilium_attachments_active{job=~'$job',instance=~'$instance'}\",\n \"legendFormat\": \"Active Attachments\",\n \"refId\": \"A\"\n },\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"expr\": \"trilium_attachments_total{job=~'$job',instance=~'$instance'}\",\n \"legendFormat\": \"Total Attachments\",\n \"refId\": \"B\"\n }\n ],\n \"title\": \"📎 Attachments Growth Over Time\",\n \"type\": \"timeseries\"\n },\n {\n \"collapsed\": false,\n \"gridPos\": {\n \"h\": 1,\n \"w\": 24,\n \"x\": 0,\n \"y\": 25\n },\n \"id\": 400,\n \"panels\": [],\n \"title\": \"🔧 Advanced Metrics\",\n \"type\": \"row\"\n },\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"description\": \"Number of branches connecting notes\",\n \"fieldConfig\": {\n \"defaults\": {\n \"color\": {\n \"mode\": \"thresholds\"\n },\n \"mappings\": [],\n \"thresholds\": {\n \"mode\": \"absolute\",\n \"steps\": [\n {\n \"color\": \"green\"\n }\n ]\n },\n \"unit\": \"short\"\n },\n \"overrides\": []\n },\n \"gridPos\": {\n \"h\": 4,\n \"w\": 6,\n \"x\": 0,\n \"y\": 26\n },\n \"id\": 401,\n \"options\": {\n \"colorMode\": \"value\",\n \"graphMode\": \"none\",\n \"justifyMode\": \"center\",\n \"orientation\": \"auto\",\n \"percentChangeColorMode\": \"standard\",\n \"reduceOptions\": {\n \"calcs\": [\n \"lastNotNull\"\n ],\n \"fields\": \"\",\n \"values\": false\n },\n \"showPercentChange\": false,\n \"textMode\": \"auto\",\n \"wideLayout\": true\n },\n \"pluginVersion\": \"12.0.1\",\n \"targets\": [\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"expr\": \"trilium_branches_total{job=~'$job',instance=~'$instance'}\",\n \"refId\": \"A\"\n }\n ],\n \"title\": \"🌳 Total Branches\",\n \"type\": \"stat\"\n },\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"description\": \"Number of note attributes\",\n \"fieldConfig\": {\n \"defaults\": {\n \"color\": {\n \"mode\": \"thresholds\"\n },\n \"mappings\": [],\n \"thresholds\": {\n \"mode\": \"absolute\",\n \"steps\": [\n {\n \"color\": \"green\"\n }\n ]\n },\n \"unit\": \"short\"\n },\n \"overrides\": []\n },\n \"gridPos\": {\n \"h\": 4,\n \"w\": 6,\n \"x\": 6,\n \"y\": 26\n },\n \"id\": 402,\n \"options\": {\n \"colorMode\": \"value\",\n \"graphMode\": \"none\",\n \"justifyMode\": \"center\",\n \"orientation\": \"auto\",\n \"percentChangeColorMode\": \"standard\",\n \"reduceOptions\": {\n \"calcs\": [\n \"lastNotNull\"\n ],\n \"fields\": \"\",\n \"values\": false\n },\n \"showPercentChange\": false,\n \"textMode\": \"auto\",\n \"wideLayout\": true\n },\n \"pluginVersion\": \"12.0.1\",\n \"targets\": [\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"expr\": \"trilium_attributes_total{job=~'$job',instance=~'$instance'}\",\n \"refId\": \"A\"\n }\n ],\n \"title\": \"🏷️ Attributes\",\n \"type\": \"stat\"\n },\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"description\": \"Number of note revisions\",\n \"fieldConfig\": {\n \"defaults\": {\n \"color\": {\n \"mode\": \"thresholds\"\n },\n \"mappings\": [],\n \"thresholds\": {\n \"mode\": \"absolute\",\n \"steps\": [\n {\n \"color\": \"green\"\n }\n ]\n },\n \"unit\": \"short\"\n },\n \"overrides\": []\n },\n \"gridPos\": {\n \"h\": 4,\n \"w\": 6,\n \"x\": 12,\n \"y\": 26\n },\n \"id\": 403,\n \"options\": {\n \"colorMode\": \"value\",\n \"graphMode\": \"none\",\n \"justifyMode\": \"center\",\n \"orientation\": \"auto\",\n \"percentChangeColorMode\": \"standard\",\n \"reduceOptions\": {\n \"calcs\": [\n \"lastNotNull\"\n ],\n \"fields\": \"\",\n \"values\": false\n },\n \"showPercentChange\": false,\n \"textMode\": \"auto\",\n \"wideLayout\": true\n },\n \"pluginVersion\": \"12.0.1\",\n \"targets\": [\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"expr\": \"trilium_revisions_total{job=~'$job',instance=~'$instance'}\",\n \"refId\": \"A\"\n }\n ],\n \"title\": \"🔄 Revisions\",\n \"type\": \"stat\"\n },\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"description\": \"Number of ETAPI tokens\",\n \"fieldConfig\": {\n \"defaults\": {\n \"color\": {\n \"mode\": \"thresholds\"\n },\n \"mappings\": [],\n \"thresholds\": {\n \"mode\": \"absolute\",\n \"steps\": [\n {\n \"color\": \"green\"\n }\n ]\n },\n \"unit\": \"short\"\n },\n \"overrides\": []\n },\n \"gridPos\": {\n \"h\": 4,\n \"w\": 6,\n \"x\": 18,\n \"y\": 26\n },\n \"id\": 404,\n \"options\": {\n \"colorMode\": \"value\",\n \"graphMode\": \"none\",\n \"justifyMode\": \"center\",\n \"orientation\": \"auto\",\n \"percentChangeColorMode\": \"standard\",\n \"reduceOptions\": {\n \"calcs\": [\n \"lastNotNull\"\n ],\n \"fields\": \"\",\n \"values\": false\n },\n \"showPercentChange\": false,\n \"textMode\": \"auto\",\n \"wideLayout\": true\n },\n \"pluginVersion\": \"12.0.1\",\n \"targets\": [\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"expr\": \"trilium_etapi_tokens_total{job=~'$job',instance=~'$instance'}\",\n \"refId\": \"A\"\n }\n ],\n \"title\": \"🔑 API Tokens\",\n \"type\": \"stat\"\n },\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"description\": \"Various storage and system metrics\",\n \"fieldConfig\": {\n \"defaults\": {\n \"color\": {\n \"mode\": \"palette-classic\"\n },\n \"custom\": {\n \"axisBorderShow\": false,\n \"axisCenteredZero\": false,\n \"axisColorMode\": \"text\",\n \"axisLabel\": \"\",\n \"axisPlacement\": \"auto\",\n \"barAlignment\": 0,\n \"barWidthFactor\": 0.6,\n \"drawStyle\": \"line\",\n \"fillOpacity\": 10,\n \"gradientMode\": \"none\",\n \"hideFrom\": {\n \"legend\": false,\n \"tooltip\": false,\n \"viz\": false\n },\n \"insertNulls\": false,\n \"lineInterpolation\": \"linear\",\n \"lineWidth\": 2,\n \"pointSize\": 5,\n \"scaleDistribution\": {\n \"type\": \"linear\"\n },\n \"showPoints\": \"auto\",\n \"spanNulls\": false,\n \"stacking\": {\n \"group\": \"A\",\n \"mode\": \"none\"\n },\n \"thresholdsStyle\": {\n \"mode\": \"off\"\n }\n },\n \"mappings\": [],\n \"thresholds\": {\n \"mode\": \"absolute\",\n \"steps\": [\n {\n \"color\": \"green\"\n }\n ]\n },\n \"unit\": \"short\"\n },\n \"overrides\": [\n {\n \"matcher\": {\n \"id\": \"byName\",\n \"options\": \"Recent Notes\"\n },\n \"properties\": [\n {\n \"id\": \"color\",\n \"value\": {\n \"fixedColor\": \"yellow\",\n \"mode\": \"fixed\"\n }\n }\n ]\n }\n ]\n },\n \"gridPos\": {\n \"h\": 8,\n \"w\": 12,\n \"x\": 0,\n \"y\": 30\n },\n \"id\": 405,\n \"options\": {\n \"legend\": {\n \"calcs\": [\n \"last\"\n ],\n \"displayMode\": \"table\",\n \"placement\": \"bottom\",\n \"showLegend\": true\n },\n \"tooltip\": {\n \"hideZeros\": false,\n \"mode\": \"multi\",\n \"sort\": \"desc\"\n }\n },\n \"pluginVersion\": \"12.0.1\",\n \"targets\": [\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"expr\": \"trilium_blobs_total{job=~'$job',instance=~'$instance'}\",\n \"legendFormat\": \"Blob Records\",\n \"refId\": \"A\"\n },\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"expr\": \"trilium_recent_notes_total{job=~'$job',instance=~'$instance'}\",\n \"legendFormat\": \"Recent Notes\",\n \"refId\": \"B\"\n },\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"expr\": \"trilium_embeddings_total{job=~'$job',instance=~'$instance'}\",\n \"legendFormat\": \"Embeddings\",\n \"refId\": \"C\"\n },\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"expr\": \"trilium_embedding_providers_total{job=~'$job',instance=~'$instance'}\",\n \"legendFormat\": \"Embedding Providers\",\n \"refId\": \"D\"\n }\n ],\n \"title\": \"📊 Storage & System Metrics\",\n \"type\": \"timeseries\"\n },\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"description\": \"Timeline showing when content was created and last modified\",\n \"fieldConfig\": {\n \"defaults\": {\n \"color\": {\n \"mode\": \"palette-classic\"\n },\n \"custom\": {\n \"axisBorderShow\": false,\n \"axisCenteredZero\": false,\n \"axisColorMode\": \"text\",\n \"axisLabel\": \"\",\n \"axisPlacement\": \"auto\",\n \"barAlignment\": 0,\n \"barWidthFactor\": 0.6,\n \"drawStyle\": \"points\",\n \"fillOpacity\": 0,\n \"gradientMode\": \"none\",\n \"hideFrom\": {\n \"legend\": false,\n \"tooltip\": false,\n \"viz\": false\n },\n \"insertNulls\": false,\n \"lineInterpolation\": \"linear\",\n \"lineWidth\": 1,\n \"pointSize\": 8,\n \"scaleDistribution\": {\n \"type\": \"linear\"\n },\n \"showPoints\": \"always\",\n \"spanNulls\": false,\n \"stacking\": {\n \"group\": \"A\",\n \"mode\": \"none\"\n },\n \"thresholdsStyle\": {\n \"mode\": \"off\"\n }\n },\n \"mappings\": [],\n \"thresholds\": {\n \"mode\": \"absolute\",\n \"steps\": [\n {\n \"color\": \"green\"\n }\n ]\n },\n \"unit\": \"dateTimeAsIso\"\n },\n \"overrides\": []\n },\n \"gridPos\": {\n \"h\": 8,\n \"w\": 12,\n \"x\": 12,\n \"y\": 30\n },\n \"id\": 406,\n \"options\": {\n \"legend\": {\n \"calcs\": [],\n \"displayMode\": \"list\",\n \"placement\": \"bottom\",\n \"showLegend\": true\n },\n \"tooltip\": {\n \"hideZeros\": false,\n \"mode\": \"single\",\n \"sort\": \"none\"\n }\n },\n \"pluginVersion\": \"12.0.1\",\n \"targets\": [\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"expr\": \"trilium_oldest_note_timestamp{job=~'$job',instance=~'$instance'} * 1000\",\n \"legendFormat\": \"Oldest Note\",\n \"refId\": \"A\"\n },\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"expr\": \"trilium_newest_note_timestamp{job=~'$job',instance=~'$instance'} * 1000\",\n \"legendFormat\": \"Newest Note\",\n \"refId\": \"B\"\n },\n {\n \"datasource\": {\n \"uid\": \"${datasource}\"\n },\n \"expr\": \"trilium_last_modified_timestamp{job=~'$job',instance=~'$instance'} * 1000\",\n \"legendFormat\": \"Last Modified\",\n \"refId\": \"C\"\n }\n ],\n \"title\": \"⏰ Content Timeline\",\n \"type\": \"timeseries\"\n }\n ],\n \"preload\": false,\n \"refresh\": \"1m\",\n \"schemaVersion\": 41,\n \"tags\": [\n \"trilium\",\n \"notes\",\n \"monitoring\",\n \"enhanced\"\n ],\n \"templating\": {\n \"list\": [\n {\n \"current\": {\n \"text\": \"myprom\",\n \"value\": \"PA04845DA3A4B088E\"\n },\n \"includeAll\": false,\n \"label\": \"Datasource\",\n \"name\": \"datasource\",\n \"options\": [],\n \"query\": \"prometheus\",\n \"refresh\": 1,\n \"regex\": \"//\",\n \"type\": \"datasource\"\n },\n {\n \"allValue\": \".*\",\n \"current\": {\n \"text\": \"All\",\n \"value\": \"$__all\"\n },\n \"datasource\": {\n \"UID\": \"\",\n \"type\": \"\"\n },\n \"includeAll\": true,\n \"label\": \"Job\",\n \"multi\": true,\n \"name\": \"job\",\n \"options\": [],\n \"query\": \"query_result(up)\",\n \"refresh\": 1,\n \"regex\": \"/job=\\\"([^\\\"]+)\\\"/\",\n \"sort\": 1,\n \"type\": \"query\"\n },\n {\n \"allValue\": \".*\",\n \"current\": {\n \"text\": [\n \"All\"\n ],\n \"value\": [\n \"$__all\"\n ]\n },\n \"datasource\": {\n \"type\": \"prometheus\",\n \"uid\": \"${datasource}\"\n },\n \"includeAll\": true,\n \"label\": \"Instance\",\n \"multi\": true,\n \"name\": \"instance\",\n \"options\": [],\n \"query\": \"trilium_database_size_bytes\",\n \"refresh\": 1,\n \"regex\": \"/instance=\\\"([^\\\"]+)\\\"/\",\n \"sort\": 1,\n \"type\": \"query\"\n }\n ]\n },\n \"time\": {\n \"from\": \"now-1h\",\n \"to\": \"now\"\n },\n \"timepicker\": {},\n \"timezone\": \"browser\",\n \"title\": \"TriliumNext Dashboard\",\n \"uid\": \"06993f9b-a477-4723-bf18-47743393b382\",\n \"version\": 5\n}",
+ "_help_64ZTlUPgEPtW": "<p>Safe mode is triggered by setting the <code>TRILIUM_SAFE_MODE</code> environment variable to a truthy value, usually <code>1</code>.</p><p>In each artifact there is a <code>trilium-safe-mode.sh</code> (or <code>.bat</code>) script to enable it.</p><p>What it does:</p><ul><li>Disables <code>customWidget</code> launcher types in <code>app/widgets/containers/launcher.js</code>.</li><li>Disables the running of <code>mobileStartup</code> or <code>frontendStartup</code> scripts.</li><li>Displays the root note instead of the previously saved session.</li><li>Does not run a <a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a> when it is opened; press <em>Search now</em> to run it.</li><li>Disables the running of <code>backendStartup</code>, <code>hourly</code>, <code>daily</code> scripts and checks for the hidden subtree.</li></ul>",
+ "_help_HAIOFBoYIIdO": "<p>Nightly releases are versions built every day, containing the latest improvements and bugfixes, directly from the main development branch. These versions are generally useful in preparation for a release, to ensure that there are no significant bugs that need to be addressed first, or they can be used to confirm whether a particular bug is fixed or feature is well implemented.</p><h2>Regarding the stability</h2><p>Despite being on a development branch, generally the main branch is pretty stable since PRs are tested before they are merged. If you notice any issues, feel free to report them either via a ticket or via the Matrix.</p><h2>Downloading the nightly release manually</h2><p>Go to <a href=\"https://github.com/TriliumNext/Trilium/releases/tag/nightly\">github.com/TriliumNext/Trilium/releases/tag/nightly</a> and look for the artifacts starting with <code>TriliumNotes-main</code>. Choose the appropriate one for your platform (e.g. <code>windows-x64.zip</code>).</p><p>Depending on your use case, you can either test the portable version or even use the installer.</p><aside class=\"admonition note\"><p>If you choose the installable version (e.g. the .exe on Windows), it will replace your stable installation.</p></aside><aside class=\"admonition important\"><p>By default, the nightly uses the same database as the production version. Generally you could easily downgrade if needed. However, if there are changes to the database or sync version, it will not be possible to downgrade without having to restore from a backup.</p></aside><h2>Automatically download and install the latest nightly</h2><p>This is pretty useful if you are a beta tester that wants to periodically update their version:</p><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-tux\"></span>&nbsp;Ubuntu (Bash)</p><div class=\"trilium-tab-panel\"><pre><code class=\"language-text-x-sh\">#!/usr/bin/env bash\n\nname=TriliumNotes-linux-x64-nightly.deb\nrm -f $name*\nwget https://github.com/TriliumNext/Trilium/releases/download/nightly/$name\nsudo apt-get install ./$name\nrm $name</code></pre></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-windows\"></span>&nbsp;Windows (PowerShell)</p><div class=\"trilium-tab-panel\"><pre><code class=\"language-application-x-powershell\">if ($env:PROCESSOR_ARCHITECTURE -eq \"ARM64\") {\n $arch = \"arm64\";\n} else {\n $arch = \"x64\";\n}\n\n$exeUrl = \"https://github.com/TriliumNext/Trilium/releases/download/nightly/TriliumNotes-main-windows-$($arch).exe\";\nWrite-Host \"Downloading $($exeUrl)\"\n\n# Generate a unique path in the temp dir\n$guid = [guid]::NewGuid().ToString()\n$destination = Join-Path -Path $env:TEMP -ChildPath \"$guid.exe\"\n\ntry {\n $ProgressPreference = 'SilentlyContinue'\n Invoke-WebRequest -Uri $exeUrl -OutFile $destination\n $process = Start-Process -FilePath $destination\n} catch {\n Write-Error \"An error occurred: $_\"\n} finally {\n # Clean up\n if (Test-Path $destination) {\n Remove-Item -Path $destination -Force\n }\n}</code></pre></div></section></div>",
+ "_help_ZmT9ln8XJX2o": "<aside class=\"admonition warning\"><p>This functionality is still in preview, expect possible issues or even the feature disappearing completely.<br>Feel free to <a href=\"#root/_help_wy8So3yZZlH9\">report</a> any issues you might have.</p></aside><p>The read-only database is an alternative to&nbsp;<a class=\"reference-link\" href=\"#root/_help_R9pX4DGra2Vt\">Sharing</a>&nbsp;notes. Although the share functionality works pretty well to publish pages to the Internet in a wiki, blog-like format it does not offer the full functionality behind Trilium (such as the advanced&nbsp;<a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>&nbsp;or the interactivity behind&nbsp;<a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>&nbsp;or the various&nbsp;<a class=\"reference-link\" href=\"#root/_help_KSZ04uQ2D1St\">Note Types</a>).</p><p>When the database is in read-only mode, the Trilium application can be used as normal, but editing is disabled and changes are made in-memory only.</p><h2>What it does</h2><ul><li>All notes are read-only, without the possibility of editing them.</li><li>Features that would normally alter the database such as the list of recent notes are disabled.</li></ul><h2>Limitations</h2><ul><li>Some features might “slip through” and still end up creating a note, for example.<ul><li>However, the database is still read-only, so all modifications will be reset if the server is restarted.</li><li>Whenever this occurs, <code>ERROR: read-only DB ignored</code> will be shown in the logs.</li></ul></li></ul><h2>Setting a database as read-only</h2><p>First, make sure the database is initialized (e.g. the first set up is complete). Then modify the <a href=\"#root/_help_Gzjqa934BdH4\">config.ini</a> by looking for the <code>[General]</code> section and adding a new <code>readOnly</code> field:</p><pre><code class=\"language-text-x-trilium-auto\">[General]\nreadOnly=true</code></pre><p>If your server is already running, restart it to apply the changes.</p><p>Similarly, to disable read-only remove the line or set it to <code>false</code>.</p>",
+ "_help_TiQbQDgP8L5t": "<p>Optical Character Recognition is the process in which the text from images or PDFs is extracted.</p><h2>Built-in support</h2><p>Since v0.103.0, Trilium has built-in support for OCR. The extracted text can be:</p><ul><li>Integrated with&nbsp;<a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>, to quickly find the image or file based on snippets of text.</li><li>Integrated with the&nbsp;<a class=\"reference-link\" href=\"#root/_help_GBBMSlVSOIGP\">AI</a>&nbsp;feature, which allows the agent to access the content of a non-text note.</li><li>Manually accessed for other purposes (e.g. copying into a note or sending it somewhere else).</li></ul><h2>Supported formats</h2><p>OCR in Trilium supports the following formats:</p><h3>Images</h3><ul><li>Both <a href=\"#root/_help_W8vYD3Q1zjCR\">individual image notes</a> and <a href=\"#root/_help_mT0HEkOsz6i1\">attachments in text files</a> are supported.</li><li>Supported formats:<ul><li>JPEG</li><li>PNG</li><li>GIF (only non-animated)</li><li>BMP</li><li>WebP</li></ul></li><li>Note that this feature works best for computer-rendered text rather than handwriting.</li><li>The underlying technology is Tesseract.js.</li></ul><h3>PDFs</h3><p>The PDF extraction supports:</p><ul><li>PDFs with text information (e.g. a PDF created by a browser or a word processing application), in which the text is extracted.</li><li>Scanned PDFs, and other PDFs whose text cannot be selected (such as documents whose text was converted to outlines), in which the text is extracted through an OCR process.</li><li>Mixed PDFs, containing both text and images with text content.</li></ul><p>Note that OCR extraction is limited to 50 pages per PDF, pages containing text information (not as an image) are not subject to this limitation.</p><aside class=\"admonition note\"><p>Text extraction for scanned PDFs using OCR was introduced in v0.106.0. If a scanned PDF was already processed by an earlier version, reprocess it individually via <em>Process OCR</em>; batch processing only handles files that haven't been OCR'd yet.</p></aside><h3>Office documents</h3><p>The text will be extracted from the following file formats:</p><ul><li>Microsoft Word documents</li><li>Microsoft Excel documents<ul><li>Only the raw text information, the cell structure is not maintained.</li><li>Values are extracted raw, so searching for dates will not work. The OpenDocument alternative will actually extract the properly formatted value.</li></ul></li><li>Microsoft PowerPoint documents</li><li>The OpenDocument alternatives to the previous formats (Text, Spreadsheet, Presentation), created by editors such as LibreOffice and OpenOffice.</li><li><a href=\"https://en.wikipedia.org/wiki/Rich_Text_Format\">Rich Text Format (RTF)</a>, since v0.104.0.</li><li><a href=\"https://en.wikipedia.org/wiki/EPUB\">EPUB</a>, since v0.104.1.</li></ul><h2>Configuring and triggering OCR</h2><p>The OCR can be configured by going to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→&nbsp;<a class=\"reference-link\" href=\"#root/_hidden/_options/_optionsMedia\">Media</a>&nbsp;and looking for the <em>Text Extraction (OCR)</em> section.</p><p>There are three ways to trigger the OCR:</p><ul><li>By enabling <em>Auto-process new files</em> which will process only the notes or attachments created after enabling the option, existing files will remain unprocessed.</li><li>By pressing <em>Start Batch Processing</em> which will process all the existing notes.</li><li>By manually requesting for an image or file to have its text extracted, regardless of whether the automatic processing is enabled or not.</li></ul><h3>Minimum confidence</h3><p>When extracting text from an image, there is a certain level of confidence which indicates whether the extracted text appears relevant.</p><p>When the minimum confidence is set to a low percentage, the text extraction can interpret symbols and drawings incorrectly resulting in garbled text.</p><p>If the extracted text for a note or an attachment quality is lower than the minimum confidence, the OCR is disregarded.</p><h2>Language management</h2><p>OCR needs to be aware of the language of the content in order for it to work correctly. The reason is that each language has its own data which needs to be downloaded, and accents or other symbols will not be supported by the default language.</p><p>To configure the languages that are supported by the OCR, simply go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→&nbsp;<a class=\"reference-link\" href=\"#root/_hidden/_options/_optionsLocalization\">Language &amp; Region</a>&nbsp;and adjust the <em>Content languages</em>.</p><p>When there are no content languages defined, the user interface <em>Language</em> is used instead.</p><p>After making this change, the automatic processing or manual reprocessing will take into consideration the new languages.</p><p>To enforce the detection in a particular language for a given note, use the <code>language</code> <a href=\"#root/_help_zEY4DaJG4YT5\">attribute</a>, similar to <a href=\"#root/_help_veGu4faJErEM\">text content language</a>. For&nbsp;<a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>, it's not possible to manually adjust the language.</p><aside class=\"admonition note\"><p>The trained data for each language is not packaged with Trilium, as that would require a significant amount of space that might not be otherwise needed. As such, when the trained data will be downloaded automatically via <a href=\"https://github.com/naptha/tesseract.js/\">Tesseract.js</a>.</p><p>The downloaded trained data is located in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_tAassRL4RSQL\">Data directory</a>, in the <code>ocr-cache</code> directory.</p></aside><h2>Viewing extracted content for a single note</h2><p>To access the extracted content of a note:</p><ul><li>For&nbsp;<a class=\"reference-link\" href=\"#root/_help_W8vYD3Q1zjCR\">File</a>&nbsp;notes, go to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>&nbsp;→ <em>Advanced</em> → <em>View OCR Text</em>.</li><li>For&nbsp;<a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>&nbsp;(e.g.&nbsp;<a class=\"reference-link\" href=\"#root/_help_mT0HEkOsz6i1\">Images</a>&nbsp;in&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;notes), double-click the attachment to view the details, press the […] button at the left and select <em>View extracted text (OCR)</em>.</li></ul><p>This section allows:</p><ul><li>Viewing the extracted text, which can be copied elsewhere if needed or just to check the quality of the extraction.</li><li>If the note has not been extracted yet, pressing <em>Process OCR</em> will process it in the background. If the extraction confidence is lower than the minimum confidence, there will be a notification.</li><li>Similarly, if the minimum confidence was changed in settings, it is possible to press the <em>Process OCR</em> button again to extract the text again.</li></ul>",
+ "_help_GBBMSlVSOIGP": "<p>Trilium can connect to a large language model and use it as an assistant that works directly on your notes: ask questions about the note you're reading, have it draft or restructure content, or get it to write scripts and widgets for you.</p><p>The integration is off by default and does nothing until you enable it and configure a provider; Trilium ships no model of its own. The provider you pick decides how your notes travel: a cloud API billed per use, a subscription you already pay for, or a model running on your own hardware, in which case nothing leaves the machine. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_bkPZAMT7d2sR\">Providers</a>&nbsp;for what each involves, and&nbsp;<a class=\"reference-link\" href=\"#root/_help_cRRrdZjgyhNc\">Privacy</a>&nbsp;for exactly what gets sent.</p><p>Once enabled, the assistant is available as:</p><ul><li>As a dedicated note type, it can read and modify notes through tools, which you can switch off per conversation if you would rather it only saw what you type.</li><li>A panel in the right sidebar, which acts similarly to the dedicated note type but it also has optional access to the current note.</li><li>An&nbsp;<a class=\"reference-link\" href=\"#root/_help_VRoP0g1uHHc2\">In-editor AI assistant</a>&nbsp;which comes with builtin actions that operate over selected text (such as proof-reading, summarizing), as well as&nbsp;<a class=\"reference-link\" href=\"#root/_help_mVEYwt20exhO\">Custom AI quick actions</a>.</li></ul><h2>Feature highlights</h2><ul><li>Chat-based interface with live streaming of the messages.</li><li>Provides the AI context with the note currently being looked at.</li><li>Tools to alter note content, create new notes, etc.</li><li>Statistics regarding context window use and pricing per message.</li><li>Attachments for multi-modal chat (images, text files, PDFs).</li><li>Optional MCP to allow external chat tools (e.g. Claude Code) to operate on notes within Trilium.</li></ul><h2>Sample use-cases</h2><ul><li>Create any type of&nbsp;<a class=\"reference-link\" href=\"#root/_help_MgibgPcfeuGz\">Custom Widgets</a>.</li><li>Easily create a&nbsp;<a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a>, e.g. <em>Create for me a render note which allows me to play tic-tac-toe. Make sure to use Preact instead of the legacy jQuery.</em></li><li>Create widgets for a&nbsp;<a class=\"reference-link\" href=\"#root/_help_IF7Q6I9x7zuw\">Dashboard</a>, such as a calculator, a stopwatch, a pomodoro timer.</li></ul><aside class=\"admonition note\"><p>Claude Sonnet is known to produce very good frontend or backend scripts with little guidance, as the AI has been instructed in how to produce them.</p></aside><h2>LLM Providers</h2><p>Trilium supports four different types of providers:</p><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bx-cloud\"></span>&nbsp;Cloud</p><div class=\"trilium-tab-panel\"><p>Pay-per use with an API key which is billed separately from any subscription you might already have.</p><ul><li><span class=\"tn-icon tn-brand tn-brand-anthropic\"></span>&nbsp;Anthropic Claude</li><li><span class=\"tn-icon tn-brand tn-brand-openai\"></span>&nbsp;OpenAI GPT</li><li><span class=\"tn-icon tn-brand tn-brand-gemini\"></span>&nbsp;Google Gemini</li><li><span class=\"tn-icon tn-brand tn-brand-deepseek\"></span>&nbsp;DeepSeek</li></ul></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bx-coin\"></span>&nbsp;Subscription-based</p><div class=\"trilium-tab-panel\"><p>Reuses an existing subscription instead of paying per use.</p><ul><li><span class=\"tn-icon tn-brand tn-brand-claude\"></span>&nbsp;<a href=\"#root/_help_eFhxp9laTW1S\">Claude Code</a></li><li><span class=\"tn-icon tn-brand tn-brand-github-copilot\"></span>&nbsp;<a href=\"#root/_help_eFhxp9laTW1S\">GitHub Copilot</a></li><li><span class=\"tn-icon tn-brand tn-brand-antigravity\"></span>&nbsp;<a href=\"#root/_help_eFhxp9laTW1S\">Google Antigravity</a></li><li><span class=\"tn-icon tn-brand tn-brand-codex\"></span>&nbsp;<a href=\"#root/_help_eFhxp9laTW1S\">OpenAI Codex</a></li></ul></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bx-network-chart\"></span>&nbsp;Local/self-hosted</p><div class=\"trilium-tab-panel\"><ul><li><span class=\"tn-icon tn-brand tn-brand-ollama\"></span>&nbsp;Ollama</li><li><span class=\"tn-icon tn-brand tn-brand-lmstudio\"></span>&nbsp;LM Studio</li></ul></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bx-code-curly\"></span>&nbsp;Custom endpoints</p><div class=\"trilium-tab-panel\"><p>For other providers that are not directly supported by Trilium, either local or hosted (e.g. OpenRouter, Groq, Mistral).</p></div></section></div><aside class=\"admonition tip\"><p>For more information about each provider, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_bkPZAMT7d2sR\">Providers</a>. See the dedicated&nbsp;<a class=\"reference-link\" href=\"#root/_help_cRRrdZjgyhNc\">Privacy</a>&nbsp;to better understand what data is sent to providers.</p></aside><h2>Enabling the AI integration</h2><p>To enable the AI integration, simply go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>AI / LLM</em> and press the toggle in the top-right of the dialog and configure a provider.</p><h2>Creating a new chat</h2><p>There are two different chat interfaces:</p><ul><li>One in the sidebar.</li><li>A dedicated note type.</li></ul><h3>The sidebar interface</h3><h3>The dedicated note type</h3><p>The dedicated chat note is similar to the sidebar interface, but it makes longer conversations more comfortable to read.</p><p>Unlike the sidebar, the AI will not be aware of the current note it's in.</p><h3>Templates</h3><p>Chat notes can be set as&nbsp;<a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>&nbsp;to make them easily reusable. The entire conversation history is kept, allowing a basic form of specialization for the LLM with the existing chat acting like a system prompt.&nbsp;</p><h3>Model selection</h3><p>When a provider is configured in&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>, the next step is to select the models that will be available for the chat.</p><p>The models are retrieved dynamically from the provider, only when the model selection list is visible. To alter the list of models, simply press the Edit button in the model selection box.</p><p>Pricing information is displayed for known models. The pricing information (price per million tokens) is embedded in the application (using a subset of LiteLLM's data) and is updated with new versions of Trilium. Local providers are considered free, whereas custom endpoint providers don't offer any pricing information.</p><h2>Features</h2><h3>Web search</h3><p>The AI can optionally search the web to find more information about a specific topic.&nbsp;</p><p>Where the search comes from is chosen in the <em>Web search</em> submenu of the <span class=\"tn-icon bx bx-shield-quarter\"></span><em>Tools</em> menu next to the model selector at the bottom of the chat, whose row shows the source in use:</p><ul><li><em>Disabled</em> turns web search off for this chat.</li><li><em>Use the model's built-in search</em>, the default, lets the model search with its provider's own search. Anthropic, OpenAI and Google Gemini models have one, as do Claude Code, Google Antigravity and OpenAI Codex. DeepSeek, Ollama, LM Studio and custom endpoints don't, so this choice is disabled for their models.</li><li>A search provider (Brave Search, Tavily, Exa, Serper, Perplexity or SearXNG) searches through that service instead, whichever model is answering. Search providers are added in the <em>Search Providers</em> section of the AI settings, which <em>Manage search providers</em> at the bottom of the submenu opens. The browser version can't use Brave Search, Exa or Perplexity, whose services refuse requests made from a web page, so they're shown disabled there.</li></ul><p>To use SearXNG, enable its JSON output by adding <code>json</code> to the search formats in the instance's <code>settings.yml</code>. SearXNG turns JSON off by default, and without it every search fails.</p><pre><code class=\"language-text-x-yaml\">search:\n formats:\n - html\n - json</code></pre><p>SearXNG doesn't use API keys, so leave the API key empty. Fill it in only if your instance sits behind a proxy that requires a token; Trilium sends it as a bearer token in the <code>Authorization</code> header.</p><p>Whether web search is on is kept per chat; the search source is shared by all chats. A choice the current model can't use stays in the menu, disabled; hover the <span class=\"tn-icon bx bx-info-circle\"></span>icon next to it to see why. Claude Code, GitHub Copilot, Google Antigravity and OpenAI Codex run their own tools, so they can't use a search provider.</p><p>In the chat, a search run through a search provider shows that provider's logo at the start of its line instead of the <span class=\"tn-icon bx bx-search\"></span>magnifier; hover the logo to see the provider's name.</p><p>With a search provider, the model can also read the pages it finds, or a link you give it, as text: Trilium fetches the page itself and hands the model up to its first 20,000 characters. Addresses on your own machine or network are refused. In the browser version most sites don't allow being read this way, so reading a page there usually fails.</p><h3>Thinking</h3><p>Some models reason before they answer. While the model is thinking, its reasoning is shown in full under a spinner; once it is done, it folds into a collapsible <em>Thought process</em> line above the reply.</p><p>How much a model thinks is set per chat, in one of two ways depending on the model:</p><ul><li>Most models have an <span class=\"tn-icon bx bx-brain\"></span><em>Extended thinking</em> button, next to the <span class=\"tn-icon bx bx-shield-quarter\"></span><em>Tools</em> button.</li><li>Models that offer several levels of reasoning (DeepSeek V4, OpenAI Codex, Antigravity) have a <span class=\"tn-icon bx bx-brain\"></span>reasoning effort dropdown next to the model selector instead. <em>None</em>, where offered, turns thinking off; higher levels give better answers to hard questions, but take longer and cost more.</li></ul><aside class=\"admonition note\"><p>The effort dropdown only appears once Trilium knows the model's levels. For a DeepSeek provider set up with an earlier version of Trilium, edit the provider in the model selection box and press <em>Save</em> once.</p></aside><h3>Note access (tools)</h3><p>Tools allow the agentic AI to understand and operate on notes directly within your Trilium instance.</p><p>This feature is on by default. To turn it off, press the <span class=\"tn-icon bx bx-shield-quarter\"></span><em>Tools</em> button next to the model selector at the bottom of the chat and switch off <em>Note access</em>. The <em>Tools</em> button is highlighted while note access or web search is on.</p><p>Here are a few tools that Trilium provides for the LLM:</p><ul><li>At note level:<ul><li>Search for notes</li><li>Get the metadata or content of a note.</li><li>Edit a note<ul><li>There are multiple mechanism for the LLM to edit a note: completely by re-writing it, find/replace of a text sequence or append.</li><li>When re-writing a note, the LLM can also change its type (for example from a text note to a code note) or the language of a code note, rewriting the content to match.</li><li>Whenever the AI makes a change, a <a href=\"#root/_help_vZWERwf8U3nx\">revision</a> is saved to be able to revert any unwanted changes.</li></ul></li><li>Create a new note<ul><li>Asked for a drawing, the LLM can create an SVG image note, or turn an existing note into one. It can write only SVG images, not other formats such as PNG.</li></ul></li><li>Rename or delete a note.</li></ul></li><li>At attribute level:<ul><li>Get the full list of attributes, or a specific attribute.</li><li>Set the value of an attribute.<ul><li>An attribute that runs code, such as <code>#run</code>, <code>#widget</code> or <code>~renderNote</code>, is saved with a <code>disabled:</code> prefix (for example <code>#disabled:widget</code>), the same way a safe import disables it (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_YzMcWlCVeW09\">Active content</a>). If the note already had that attribute enabled, the AI removes it, so none of it runs until you enable the new value. The AI tells you which note it is on; review the code, then enable it with the toggle next to the active content badge beside the note's title or, for a&nbsp;<a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a>, the <em>Enable render note</em> button in the note.</li></ul></li><li>Delete an attribute.</li></ul></li><li>At tree level:<ul><li>Get the direct children of a note.</li><li>Get the entire subtree of a note.</li><li>Move or clone a note somewhere else.</li></ul></li><li>For&nbsp;<a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>:<ul><li>Get metadata for an attachment.</li><li>Get the content of an attachment.</li></ul></li><li>Skills (see the dedicated section).</li></ul><p>Each tool the AI uses appears in the chat as a single line naming the tool and the note or query it worked on; a renamed note shows its previous title struck through, a deleted note its title struck through, a moved note where it was moved from and to, an attribute the AI read, set or deleted as a pill (struck through once deleted), an attachment by its title, note and size, and a web page the AI read as a link. A line folds open only when there is something to read inline: the notes a search found, the pages a web search found, the icons an icon search found, the type, attributes or start of the content of a note the AI read, all the attributes of a note, the text of an attachment or of a web page, the User Guide pages the AI looked up or its table of contents (both open in the help panel), the children or the whole subtree of a note, what the AI wrote into a note it created, rewrote or added to, the changes of an edit, or the reason a tool failed. A search names on its line the part of the tree it is confined to, if any, and also shows how many notes it found and how many of the matches the AI asked for; each note it lists opens with a click. To see exactly what the AI sent to a tool and what it got back, hover the line and press the <span class=\"tn-icon bx bx-code-alt\"></span>button next to it; on touch screens the button is always shown.</p><p>When the reply stops moving for a couple of seconds while the AI is still at work, for example while it reads what a tool returned, a <em>Still working…</em> line appears under it until the next part of the reply arrives.</p><h4>Approving tool calls</h4><p>Before the AI runs a tool, the chat asks whether to allow it. The tool's line is marked with a <span class=\"tn-icon bx bxs-hand\"></span>icon and has <em>Allow</em> and <em>Deny</em> buttons below it. When the call would write to a note, the line opens on the text it would write or the changes of an edit. The reply waits until you answer.</p><ul><li>To let the call run, press <em>Allow</em>.</li><li>To stop asking about a tool for the rest of the chat, open the menu next to <em>Allow</em> and choose to always allow that tool for this chat. The call runs, and so do the other calls of that tool still waiting and every later one in this chat. Other tools keep asking, and a new chat asks again.</li><li>To refuse it, press <em>Deny</em>. The AI is told that you declined, and its reply carries on without the call, which is marked <em>denied</em>.</li><li>Stopping the reply denies every call that is still waiting.</li></ul><p>To make a chat ask about a tool again, open the <span class=\"tn-icon bx bx-shield-quarter\"></span><em>Tools</em> menu at the bottom of the chat and, under <em>Allowed in this chat</em>, press the tool. The submenu is shown once the chat has allowed a tool.</p><p>Which calls ask depends on the chat's permission mode, chosen in the <span class=\"tn-icon bx bx-shield-quarter\"></span><em>Tools</em> menu under <em>Permissions</em>:</p><ul><li><em>Always ask</em>: every call asks, including the ones that only read (searching notes, or reading a note or an attachment).</li><li><em>Ask before changes</em>: the calls that only read run on their own, and the ones that change your notes (creating, editing, renaming, moving or deleting a note, and setting or deleting an attribute) ask.</li><li><em>Don't ask</em>: every call runs without asking, changes included.</li></ul><p>A new chat starts in the mode you picked last, in any chat, or in <em>Ask before changes</em> until you pick one. Picking <em>Don't ask</em> therefore carries over to the next chat too.</p><p>A tool allowed for the chat runs without asking in every mode. So does looking something up in what ships with Trilium (its User Guide, the skill sheets that teach the AI Trilium's search syntax and note types, and the icons), since it reads none of your notes. Searching the web and reading a web page never ask either: turning on web search in the <em>Tools</em> menu is what allows them, whether the model searches on its own or through a search provider.</p><aside class=\"admonition note\"><p>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_eFhxp9laTW1S\">Subscription-based providers</a>&nbsp;(Claude Code, GitHub Copilot, Google Antigravity and OpenAI Codex) ask like any other provider.</p></aside><aside class=\"admonition note\"><p>Most changes you allow can be undone: a deleted note can be restored, and an edit reverted from its revision. Setting an attribute is harder to undo, since attributes have no history.</p></aside><aside class=\"admonition note\"><p>Gemini can't use its built-in search while note access is on. While it is, the built-in search choice in the <em>Tools</em> menu is disabled and says why; a search provider works with note access on.</p></aside><h3>Attachments</h3><p>Since Trilium v0.140.0,&nbsp;<a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>&nbsp;allow for multi-modal chat:</p><ul><li>Raster image (sent as vision input, except for SVGs) with the following supported formats: PNG, JPEG, GIF, WebP.</li><li>PDFs, sent natively to the provider (supported by Anthropic, OpenAI and Google).</li><li>SVG images (sent as raw HTML).</li><li>Text files.</li></ul><p>Not every model reads every kind of attachment: DeepSeek reads no PDFs, and images only with its vision models; OpenAI Codex, GitHub Copilot and Google Antigravity read images but no PDFs. For such a model:</p><ul><li>The attach button offers only the kinds the model reads, and a pasted or dropped file it can't read is not attached.</li><li>After switching to such a model, an attachment it can't read is marked with a <span class=\"tn-icon bx bx-error\"></span>warning, and the message can't be sent until the attachment is removed or another model is selected.</li><li>An attachment sent in an earlier message reaches the model as its name only, such as <code>[attached file: report.pdf]</code>, so it can tell you it doesn't see the content.</li></ul><p>To upload an attachment:</p><ul><li>Press the dedicated <em>Attach</em> button (paperclip icon) underneath the text box.</li><li>Paste an image directly from clipboard using Ctrl+V.</li></ul><p>Once one or more attachments are uploaded, they will appear directly above the text box:</p><ul><li>Images have a small thumbnail for easy identifications.</li><li>Every attachment can be deleted by pressing their corresponding X button.</li></ul><p>Clicking an image or a PDF, either its chip above the text box or where it appears in a sent message, opens it in a viewer: an image can be zoomed and panned there, a PDF read page by page. The button next to the viewer's close button opens the original file in a new browser tab. <kbd>Ctrl</kbd>-clicking instead opens an image in a new browser tab, and a PDF as an attachment in a new Trilium tab.</p><p>When an attachment is present, the LLM is instructed to consider the attachment with priority, even if it has access to the current note.</p><aside class=\"admonition note\"><p>Currently Trilium doesn't pre-process the attachments (e.g. via&nbsp;<a class=\"reference-link\" href=\"#root/_help_TiQbQDgP8L5t\">Text Extraction (OCR)</a>) before sending them to the LLM provider.</p></aside><h3>Mentions</h3><p>Mentions are a way to insert references to notes other than the current note, using the same mechanism as&nbsp;<a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>. To refer to another note, simply type @ followed by the name of the note to reference.</p><p>This feature is mostly helpful when note tools are enabled, otherwise the LLM will have no way to access the given note.</p><h3>Skills</h3><p>Skills in Trilium are specialized instruction sets that help the AI be more productive by understanding how Trilium.</p><p>These skills are not loaded by default to avoid an increased consumption of tokens, but the AI can load them on-demand if <em>Note tools</em> are enabled.</p><p>The following skills are built-in:</p><ul><li>Search syntax: understands the full syntax of&nbsp;<a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>.</li><li>Backend scripting: to be able to write proper&nbsp;<a class=\"reference-link\" href=\"#root/_help_SPirpZypehBG\">Backend scripts</a>.</li><li>Frontend scripting: to be able to write proper <a href=\"#root/_help_yIhgI5H7A2Sm\">front-end scripts</a> (basic scripts, widgets,&nbsp;<a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a>).</li><li>Dashboards: to build a&nbsp;<a class=\"reference-link\" href=\"#root/_help_IF7Q6I9x7zuw\">Dashboard</a>&nbsp;and its widgets, including interactive ones made with a&nbsp;<a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a>.</li></ul><p>When <em>Note tools</em> are enabled the skills will automatically be made available to the AI, so no user interaction is required.</p><aside class=\"admonition note\"><p>Custom skills are currently not supported but they are planned.</p></aside><h3>MCP</h3><p>Trilium comes with a built-in MCP server which allows you to use an external agent such as Claude Code have access to your database. See the dedicated&nbsp;<a class=\"reference-link\" href=\"#root/_help_KOWBFgsZXJAD\">MCP</a>&nbsp;page for more details.</p><h2>History</h2><h3>Removal in v0.102.0</h3><p>Starting with version v0.102.0, AI/LLM integration has been removed from the Trilium Notes core.</p><p>While a significant amount of effort went into developing this feature, maintaining and supporting it long-term proved to be unsustainable.</p><p>When upgrading to v0.102.0, your Chat notes will be preserved, but instead of the dedicated chat window they will be turned to a normal&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;note, revealing the underlying JSON of the conversation.</p><h3>Reintroduction in v0.103.0</h3><p>Given the recent advancements of the AI scene, we decided to give the LLM integration another try. v0.103.0 introduces a completely new chat system.</p><p>One of the key changes that lead to the reimplementation is that now we are using a library (<a href=\"https://github.com/vercel/ai\">Vercel AI</a>) to manage the inner mechanism and the differences between LLM providers instead of having to implement it on our own.</p>",
+ "_help_bkPZAMT7d2sR": "<p>Providers are added in the <em>Model Providers</em> section of the AI settings, with <em>Add Model Provider</em>. Each one lists the models selected for it, which are the ones the chat offers; a provider with no models selected is not offered in the chat.</p><h2>Cloud providers using API keys</h2><p>Currently, the following cloud providers are supported:</p><ul><li><span class=\"tn-icon tn-brand tn-brand-anthropic\"></span>&nbsp;<a href=\"https://platform.claude.com/settings/workspaces/default/keys\">Anthropic</a></li><li><span class=\"tn-icon tn-brand tn-brand-openai\"></span>&nbsp;OpenAI</li><li><span class=\"tn-icon tn-brand tn-brand-gemini\"></span>&nbsp;Gemini</li><li><span class=\"tn-icon tn-brand tn-brand-deepseek\"></span>&nbsp;DeepSeek</li></ul><p>For all the providers, an API key is needed. Note that this is charged separately from the subscription you might already have (e.g. Claude Pro). If that might be a problem, consider using either a subscription provider (see below) or using it externally via MCP.</p><p>Do note that most other LLM providers (e.g. OpenRouter, Groq, Mistral) can still be used in Trilium via the OpenAI-compatible custom endpoint (see below).</p><p>If you are using a proxy or gateway, you can also configure the base URL, otherwise the default will be used.</p><aside class=\"admonition note\"><p>We don't plan to support all cloud providers, even if the library we are using would theoretically support them. Before opening a PR adding support for a different cloud provider, make sure to discuss it over <a href=\"https://github.com/orgs/TriliumNext/discussions\">GitHub Discussions</a>.</p></aside><aside class=\"admonition important\"><p>See also the dedicated&nbsp;<a class=\"reference-link\" href=\"#root/_help_cRRrdZjgyhNc\">Privacy</a>&nbsp;section to better understand what data is being sent to a cloud provider.</p></aside><h2>Subscription-based providers</h2><p>Trilium integrates multiple&nbsp;<a class=\"reference-link\" href=\"#root/_help_eFhxp9laTW1S\">Subscription-based providers</a>:</p><ul><li><span class=\"tn-icon tn-brand tn-brand-claude\"></span>&nbsp;Claude Code by reusing your CLI.</li><li><span class=\"tn-icon tn-brand tn-brand-github-copilot\"></span>&nbsp;GitHub Copilot by reusing your CLI's ACP.</li><li><span class=\"tn-icon tn-brand tn-brand-antigravity\"></span>&nbsp;Google Antigravity by downloading and setting up an ACP for Trilium.</li><li><span class=\"tn-icon tn-brand tn-brand-codex\"></span>&nbsp;OpenAI Codex by reusing your CLI through an ACP adapter shipped with Trilium.</li></ul><h2>Local/self-hosted providers</h2><p>Local or self-hosted providers are a free alternative which respects your privacy but requires specific hardware.</p><p>Trilium directly supports the following local providers:</p><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon tn-brand tn-brand-ollama\"></span>&nbsp;Ollama</p><div class=\"trilium-tab-panel\"><p>Generally Ollama runs in the background so it should be directly usable in Trilium as long as the models are downloaded (e.g. <code>ollama pull llama3.2</code>).</p></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon tn-brand tn-brand-lmstudio\"></span>&nbsp;LM Studio</p><div class=\"trilium-tab-panel\"><p>The OpenAI-compatible server is <strong>disabled</strong> by default in LM Studio installations. First download your desired models through the graphical interface, then go to <em>Settings</em> → <em>Developer</em> and toggle <em>Developer mode</em>. On the left there will be a new <em>Developer</em> tab, with a toggle to start it up.</p></div></section></div><p>Even for local providers that are not directly supported by Trilium, you can still use a custom endpoint (see below).</p><aside class=\"admonition warning\"><p>When dealing with self-hosted LLM models, depending on the training and the size of the model, the quality of the output may vary. Before <a href=\"#root/_help_wy8So3yZZlH9\">reporting issues</a> regarding the quality of the output (e.g. hallucinating tool calls), consider benchmarking the response against a cloud provider (Claude Sonnet is recommended).</p></aside><h2>Custom endpoints</h2><p>If your desired hosted (e.g. OpenRouter, Groq, Mistral) or local LLM provider is not listed in Trilium, you can use the dedicated <em>OpenAI-compatible</em> provider from the <em>Custom endpoint</em> section.</p><p>This allows you to set the base URL to an OpenAI-compatible API, with an optional API key if required by the service.</p><p>Enter the base URL exactly as the service documents it, including its version path, such as <code>https://api.groq.com/openai/v1</code> or <code>https://open.bigmodel.cn/api/paas/v4</code>. Only a bare host such as <code>http://localhost:8080</code> is completed with <code>/v1</code>.</p><p>For custom endpoints, the pricing of the models is not known so the cost of a conversation will not be displayed; this is especially relevant for hosted providers.</p>",
+ "_help_eFhxp9laTW1S": "<p>Some cloud providers offer a subscription, which has a fixed monthly fee instead of pay-per-use (unlike the API keys).</p><p>In a nutshell, subscription-based providers work by either reusing your existing CLI tools (e.g. Claude Code, GitHub Copilot and OpenAI Codex via ACP) whereas some require installing the ACP server manually (e.g. Google Antigravity). Because they require something to be installed on your device, these providers are not available on Mobile (Android or iOS) or standalone mode.</p><p>See also the dedicated&nbsp;<a class=\"reference-link\" href=\"#root/_help_cRRrdZjgyhNc\">Privacy</a>&nbsp;section to better understand what data is being sent to a cloud provider.</p><h2><span class=\"tn-icon tn-brand tn-brand-claude\"></span>&nbsp;Claude Code</h2><p>To use a subscription:</p><ol><li>First, Claude Code needs to be installed on the machine that runs Trilium. So for a&nbsp;<a class=\"reference-link\" href=\"#root/_help_poXkQfguuA0U\">Desktop Installation</a>, Claude needs to be installed locally and for a&nbsp;<a class=\"reference-link\" href=\"#root/_help_WOcw2SLH6tbX\">Server Installation</a>&nbsp;accessed via a browser, Claude needs to be installed on the server.</li><li>Claude Code must already be authenticated. To do so, run <code>claude</code> in a terminal once, type <code>/login</code> and follow the instructions.</li><li>Go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>AI / LLM</em> and add the Claude Code provider.</li></ol><details class=\"trilium-collapsible\"><summary>How Trilium identifies your Claude Code binary</summary><p>In this order:</p><ul><li>By looking for a <code>TRILIUM_CLAUDE_CODE_PATH</code> environment variable pointing to the Claude binary. This allows overriding the path if needed.</li><li>By looking for <code>claude</code> in your PATH, generally works in most circumstances.</li><li>By asking your login shell for its <code>PATH</code> which lets a desktop install find a CLI installed through <code>nvm</code>, <code>fnm</code>, <code>asdf</code> or Homebrew, since a GUI-launched app doesn't inherit your terminal's environment.</li></ul></details><p>After your provider is set up, you'll benefit from the same features as an API key (note tools, web search, extended thinking, image/PDF attachments, streaming).</p><aside class=\"admonition note\"><p>Trilium intentionally uses your Claude Code binary in order not to have to package a ~250 MB client with it, but this comes at a cost: there is a small risk for a version incompatibility, if the version installed locally doesn't match the one expected by Trilium. Generally it's best to keep both Claude Code and Trilium updated to the latest version.</p></aside><h2><span class=\"tn-icon tn-brand tn-brand-github-copilot\"></span>&nbsp;GitHub Copilot</h2><aside class=\"admonition note\"><p>This subscription-based provider is still in beta. It is safe to use (won't use additional funds and respects the terms of use), but you might experience small issues. Consider&nbsp;<a class=\"reference-link\" href=\"#root/_help_wy8So3yZZlH9\">Reporting issues</a>.</p></aside><p>GitHub Copilot gives access to the models of your GitHub Copilot subscription (Pro, Pro+, Business or Enterprise), without an API key. Usage counts against your Copilot plan.</p><ol><li>Install the GitHub Copilot CLI on the machine that runs Trilium, for example with <code>npm install -g @github/copilot</code>. As with Claude Code, for a&nbsp;<a class=\"reference-link\" href=\"#root/_help_WOcw2SLH6tbX\">Server Installation</a>&nbsp;it needs to be installed on the server.</li><li>Sign in by running <code>copilot login</code> in a terminal once. If you already use GitHub Copilot in another editor on the same machine, that login is reused.</li><li>Go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>AI / LLM</em> and add the GitHub Copilot provider.</li></ol><details class=\"trilium-collapsible\"><summary>How Trilium identifies your Copilot CLI binary</summary><p>In this order:</p><ul><li>By looking for a <code>TRILIUM_COPILOT_PATH</code> environment variable pointing to the Copilot binary.</li><li>By looking for <code>copilot</code> in your PATH.</li><li>By asking your login shell for its <code>PATH</code>, the same as for Claude Code.</li></ul></details><h3>Known limitations</h3><ul><li>The agent can only work with your notes through Trilium's note tools; its own file, shell and web tools are blocked for security reasons.</li><li>Images can be attached to the conversation, PDFs cannot. The LLM should still be able to read PDF notes and attachments via&nbsp;<a class=\"reference-link\" href=\"#root/_help_TiQbQDgP8L5t\">Text Extraction (OCR)</a>&nbsp;when the note tools are enabled.</li></ul><h2><span class=\"tn-icon tn-brand tn-brand-antigravity\"></span>&nbsp;Google Antigravity</h2><aside class=\"admonition note\"><p>This subscription-based provider is still in beta. It is safe to use (won't use additional funds and respects the terms of use), but you might experience small issues. Consider&nbsp;<a class=\"reference-link\" href=\"#root/_help_wy8So3yZZlH9\">Reporting issues</a>.</p></aside><p>Google Antigravity gives access to Gemini models using a Google account (free, Google AI Pro or Google AI Ultra), without an API key. At the time of writing, a free Google account is enough to use it.</p><p>Unlike Claude Code or GitHub Copilot, Google's Antigravity ACP server is not part of the CLI so it needs to be installed manually just for Trilium. The downloaded archive is around 112-334 MB and the extracted size is around 230 MB-2 GB based on the platform.</p><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-windows\"></span>&nbsp;Windows</p><div class=\"trilium-tab-panel\"><ol><li>Download Google's Antigravity ACP server for your platform. The link is shown when adding the provider in&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>AI / LLM</em>. Unpack it on the device that runs Trilium.</li><li>Make it findable by Trilium, either:<ol><li>by adding the unpacked folder to your PATH, or</li><li>by setting a <code>TRILIUM_ANTIGRAVITY_ACP_PATH</code> environment variable pointing to <code>agy_acp_server.exe</code>.</li></ol></li><li>Go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ AI / LLM and add the&nbsp;<span class=\"tn-icon tn-brand tn-brand-antigravity\"></span> <em>Google Antigravity</em> provider. When the list of models is loaded for the first time, the Google sign-in page opens in a browser on the machine running Trilium; finish signing in there.</li></ol></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-tux\"></span>&nbsp;Linux &amp;&nbsp;<span class=\"tn-icon bx bxl-apple\"></span> macOS</p><div class=\"trilium-tab-panel\"><ol><li>Download Google's Antigravity ACP server for your platform. The link is shown when adding the provider in&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>AI / LLM</em>. Unpack it on the device that runs Trilium.</li><li>Make it findable by Trilium, either:<ol><li>by adding the unpacked folder to your PATH, or</li><li>by setting a <code>TRILIUM_ANTIGRAVITY_ACP_PATH</code> environment variable pointing to <code>agy_acp_server.par</code>.</li></ol></li><li>Go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ AI / LLM and add the&nbsp;<span class=\"tn-icon tn-brand tn-brand-antigravity\"></span> <em>Google Antigravity</em> provider. When the list of models is loaded for the first time, the Google sign-in page opens in a browser on the machine running Trilium; finish signing in there.</li></ol></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">NixOS</p><div class=\"trilium-tab-panel\"><ol><li><p>On NixOS, <code>antigravity-acp</code> package is already available but only in <code>nixos-unstable</code> at the time of writing. The easiest method to test it out is to use the <code>nix shell</code> with flakes:</p><pre><code class=\"language-text-x-trilium-auto\">NIXPKGS_ALLOW_UNFREE=1 nix shell --impure github:nixos/nixpkgs/nixos-unstable#antigravity-acp\ntrilium</code></pre></li><li><p>Go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ AI / LLM and add the&nbsp;<span class=\"tn-icon tn-brand tn-brand-antigravity\"></span> <em>Google Antigravity</em> provider. When the list of models is loaded for the first time, the Google sign-in page opens in a browser on the machine running Trilium; finish signing in there.</p></li></ol></div></section></div><aside class=\"admonition note\"><p>Trilium needs <code>curl</code> to use Google Antigravity. It comes with Windows 10 and later, macOS and most Linux distributions.</p></aside><h3>Known limitations</h3><ul><li>The agent can only work with your notes through Trilium's note tools; its own file and shell tools are blocked for security reasons.</li><li>The Antigravity ACP server requires authentication via a login link. The login link needs to be run on the same device, so it might not be possible to set up the provider while using the web version of a Docker installation.&nbsp;<a class=\"reference-link\" href=\"#root/_help_poXkQfguuA0U\">Desktop Installation</a>&nbsp;should work fine.</li><li>Images can be attached to the conversation, PDFs cannot. The LLM should still be able to read PDF notes and attachments via&nbsp;<a class=\"reference-link\" href=\"#root/_help_TiQbQDgP8L5t\">Text Extraction (OCR)</a>&nbsp;when the note tools are enabled.</li><li>The results of tool calls (e.g. reading a note, writing attributes) are not properly displayed because they are not exposed by the ACP server.</li></ul><h2><span class=\"tn-icon tn-brand tn-brand-codex\"></span>&nbsp;OpenAI Codex</h2><aside class=\"admonition note\"><p>This subscription-based provider is still in beta. It is safe to use (won't use additional funds and respects the terms of use), but you might experience small issues. Consider&nbsp;<a class=\"reference-link\" href=\"#root/_help_wy8So3yZZlH9\">Reporting issues</a>.</p></aside><p>OpenAI Codex gives access to the Codex models of your ChatGPT plan (Free, Go, Plus, Pro or Business), without an API key. At the time of writing, a free ChatGPT account is enough to use it. Usage counts against your plan's Codex limits, which are small on the Free plan.</p><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-windows\"></span><span class=\"tn-icon bx bxl-tux\"></span><span class=\"tn-icon bx bxl-apple\"></span>&nbsp;Most platforms</p><div class=\"trilium-tab-panel\"><ol><li>Install the Codex CLI on the machine that runs Trilium, for example with <code>npm install -g @openai/codex</code>. As with Claude Code, for a&nbsp;<a class=\"reference-link\" href=\"#root/_help_WOcw2SLH6tbX\">Server Installation</a>&nbsp;it needs to be installed on the server. Trilium ships the ACP adapter that connects to it, so nothing else is needed.</li><li>Go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>AI / LLM</em> and add the&nbsp;<span class=\"tn-icon tn-brand tn-brand-codex\"></span> <em>OpenAI Codex</em> provider. When the list of models is loaded for the first time, the ChatGPT sign-in page opens in a browser on the machine running Trilium; finish signing in there.</li></ol></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">NixOS</p><div class=\"trilium-tab-panel\"><ol><li><p>On NixOS, Codex is available as the <code>codex</code> package in nixpkgs. The stable channel can lag behind Codex's releases, so a newer version can be taken from <code>nixos-unstable</code>:</p><pre><code class=\"language-text-x-sh\">nix shell github:nixos/nixpkgs/nixos-unstable#codex\ntrilium</code></pre></li><li><p>Go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>AI / LLM</em> and add the&nbsp;<span class=\"tn-icon tn-brand tn-brand-codex\"></span> <em>OpenAI Codex</em> provider. When the list of models is loaded for the first time, the ChatGPT sign-in page opens in a browser on the machine running Trilium; finish signing in there.</p></li></ol></div></section></div><p>Trilium keeps its own Codex sign-in and settings, separate from any Codex CLI you use in a terminal, so an existing <code>codex login</code> is not reused.</p><details class=\"trilium-collapsible\"><summary>How Trilium identifies your Codex CLI binary</summary><p>In this order:</p><ul><li>By looking for a <code>TRILIUM_CODEX_PATH</code> environment variable pointing to the Codex binary.</li><li>By looking for <code>codex</code> in your PATH.</li><li>By asking your login shell for its <code>PATH</code>, the same as for Claude Code.</li></ul></details><aside class=\"admonition note\"><p>Trilium needs <code>curl</code> to use OpenAI Codex, the same as for Google Antigravity: Trilium checks every tool call Codex makes through it. It comes with Windows 10 and later, macOS and most Linux distributions.</p></aside><h3>Known limitations</h3><ul><li>The agent can only work with your notes through Trilium's note tools, and search the web when the chat allows it; its own file, shell and other tools are blocked for security reasons.</li><li>The ChatGPT sign-in opens in a browser on the device running Trilium, so it might not be possible to set up the provider while using the web version of a Docker installation.&nbsp;<a class=\"reference-link\" href=\"#root/_help_poXkQfguuA0U\">Desktop Installation</a>&nbsp;should work fine.</li><li>Images and SVGs can be attached to the conversation, PDFs cannot. The LLM should still be able to read PDF notes and attachments via&nbsp;<a class=\"reference-link\" href=\"#root/_help_TiQbQDgP8L5t\">Text Extraction (OCR)</a>&nbsp;when the note tools are enabled.</li></ul>",
+ "_help_cRRrdZjgyhNc": "<p>Trilium sends nothing to an AI provider until you send a message. Enabling the integration, adding a provider or opening a chat transmits nothing on its own, the one exception is that listing a provider's models sends your API key to that provider, so the list can be fetched.</p><p>Once you send a message or run the&nbsp;<a class=\"reference-link\" href=\"#root/_help_VRoP0g1uHHc2\">In-editor AI assistant</a>, what leaves your machine depends on the provider you chose and on which context options are enabled.</p><h2>Where your notes go</h2><figure class=\"table\"><table><thead><tr><th>Provider type</th><th>Destination</th></tr></thead><tbody><tr><td>Cloud providers</td><td>The provider's servers (Anthropic, OpenAI, Google, DeepSeek)</td></tr><tr><td>Subscription-based</td><td>The provider's servers, via Claude Code running locally</td></tr><tr><td>Local / self-hosted</td><td>Nothing leaves the machine running the model</td></tr><tr><td>Custom endpoint</td><td>Wherever it was pointed, which may be your own hardware or a hosted service</td></tr></tbody></table></figure><p>This is the reason the provider list is grouped this way, and why Trilium pre-selects nothing: the choice of where your note content is sent is made explicitly by you, before anything is sent.</p><aside class=\"admonition note\"><p>The&nbsp;<a class=\"reference-link\" href=\"#root/_help_VRoP0g1uHHc2\">In-editor AI assistant</a>&nbsp;has a model selection of its own, so it may be answered by a different provider than the one in the chat. The row at the bottom of the assistant's menu always names the one being used.</p></aside><h2>What is actually sent</h2><ul><li><strong>Always, with every message</strong><ul><li>The conversation itself: your messages and the assistant's replies, including earlier turns</li><li>Trilium's system prompt describing how to format answers and use tools.</li></ul></li><li><strong>The current note, only when note context is enabled.</strong><ul><li>In the sidebar chat this is the file icon at the bottom; the dedicated chat note type never sends a current note.</li><li>What travels is a metadata block: the note's ID, title, type, creation and modification dates, its parent IDs, the titles of up to 20 children, up to 20 attributes, and a preview of the content.</li><li>Notes above a size threshold send a size hint instead of the text, and the model must call a tool to read further.</li></ul></li><li><strong>Any note the model asks for, when note access is enabled.</strong><ul><li>Tools let the model search your tree and read notes, attributes and attachments beyond the current one.</li><li>It decides what to fetch, and each call waits for you to allow it, unless the chat's permission mode lets reads or every call run on their own, or you allowed that tool for the chat. There is no per-note permission system, so the reachable scope is your whole tree.</li></ul></li><li><strong>Attachments and mentions</strong>, when you add them: images, PDFs and text files are sent to the provider, and an <code>@</code> mention makes that note fetchable.</li><li><strong>Your search query</strong>, when web search is enabled, the model's search terms reach the provider's own search infrastructure, or the search provider chosen in the <em>Tools</em> menu (Brave Search, Tavily, Exa, Serper, Perplexity or your SearXNG instance).</li><li><strong>The pages the model reads</strong>, when web search goes through a search provider: Trilium fetches each page the model asks for from the site itself, so the site sees a request from the machine running Trilium. The page's text is then sent to the model's provider.</li></ul><h2>The in-editor AI assistant</h2><p>A run of the&nbsp;<a class=\"reference-link\" href=\"#root/_help_VRoP0g1uHHc2\">In-editor AI assistant</a>&nbsp;sends a different set than a chat message. For quick actions, it sends it the moment you pick an action, there is no send button to reconsider at. For the free-form <em>Ask AI</em>, there is a dedicated send button and model selector.</p><ul><li><strong>The passage you selected</strong>, or the paragraph the cursor is in when you pick a quick action without selecting anything.</li><li><strong>Up to 1500 characters of the note on each side of that passage</strong>, as plain text. The assistant is told this is context only and must not be rewritten, but it is sent regardless of whether you selected it: a run on a single sentence still transmits the paragraphs around it.</li><li><strong>Where the note sits</strong>: its title and the titles of its parents, as a breadcrumb.</li><li><strong>Trilium's writing-assistant instructions</strong>, which describe the formatting it may produce.</li><li><strong>Earlier turns of the same exchange</strong>, once you follow up on a response.</li></ul><p>No note metadata block is sent, web search is never enabled, and the assistant has no note tools so it can read nothing beyond the text listed above.</p><h2>Protected notes</h2><p>While your <a href=\"#root/_help_bwg0e8ewQMak\">protected session</a> is locked, protected notes send neither title nor content. <strong>While it is unlocked they are treated like any other note,</strong> a note the model reads through a tool is sent to the provider in full. If you keep sensitive material in protected notes, be aware that unlocking them removes that boundary for the duration of the session.</p><p>The same applies to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_VRoP0g1uHHc2\">In-editor AI assistant</a>: it works on whatever is open in the editor, so running it inside an unlocked protected note sends that note's text like any other.</p><h2>What you control</h2><ul><li><strong>Which provider</strong>: the single decision that determines whether anything leaves your machine at all.</li><li><strong>Note access</strong>: turn it off in the <span class=\"tn-icon bx bx-shield-quarter\"></span><em>Tools</em> menu at the bottom of the chat, and the model can read nothing beyond what you type.</li><li><strong>The current note:</strong> the file icon in the sidebar chat.</li><li><strong>Web search:</strong> also in the <em>Tools</em> menu.</li><li><strong>Which tool calls ask first:</strong> the <em>Permissions</em> submenu of the <em>Tools</em> menu. <em>Always ask</em> has every call wait for you, reads included. A new chat starts in the mode you picked last, so a chat after one set to <em>Don't ask</em> asks about nothing either. Until you pick a mode, chats start in <em>Ask before changes</em>, where the AI reads and searches your notes without asking.</li><li><strong>The editor assistant</strong>: it has no per-run toggles. What you control is whether you run it, what you select before you do and which model answers.</li></ul><p>With note access and note context both off, the provider receives only the words you typed.</p><h2>Keeping everything local</h2><p>Adding an Ollama or LM Studio provider keeps every message on the machine running the model, and Trilium marks their models as free because no metered API is involved. The trade-off is quality and hardware: a small local model may fail at tool calls that a cloud model handles, so a local setup that misbehaves is worth benchmarking against a cloud provider before reporting it as a bug.</p><h2>Telemetry &amp; security</h2><p>Trilium itself collects no telemetry from the AI integration.</p><p>Your API key is stored in your database, sent only to the provider it belongs to, and is write-only through the options API so that a malevolent&nbsp;<a class=\"reference-link\" href=\"#root/_help_CdNpE2pqjmI6\">Scripting</a>&nbsp;cannot access it. If you have backend or SQL console access enabled, a malevolent script <strong>could potentially exfiltrate your API keys</strong>.</p><p>The built-in MCP server is off by default. When enabled, every request must carry an ETAPI token, which grants the same full read and write access to your notes as the REST API; treat one like a password. On desktop it is reachable only from <code>localhost</code> unless you turn on&nbsp;<a class=\"reference-link\" href=\"#root/_help_swSFivWk6KkA\">Network Access</a>.</p>",
+ "_help_KOWBFgsZXJAD": "<p><a href=\"https://en.wikipedia.org/wiki/Model_Context_Protocol\">Model Context Protocol</a> allows external chat applications such as Claude Code to have access to the Trilium database.</p><h2>Built-in MCP</h2><p>v0.103.0 comes with a built-in MCP server that is not active by default. To activate it, go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ AI/LLM and toggle the <em>MCP server</em> option.</p><p>Once the MCP is active, simply add the MCP server to your AI assistant. The URL to use is displayed in the <em>Endpoint</em> <em>URL</em> information underneath the MCP toggle.</p><p>Only the HTTP transport is supported, the <code>stdio</code> method is not supported. If that is a blocker, consider using a third-party alternative listed below.</p><p>The tools exposed to the MCP are the same tools that are supported by the internal chat (see the <em>Note access</em> section).</p><h3>Approving tool calls</h3><p>Trilium does not ask for approval of the calls an external assistant makes; that is left to the assistant's own permission settings. To help it decide, each tool tells the assistant whether it only reads your notes, only adds to them (creating a note, cloning it or appending to it), or can overwrite or remove something (editing, renaming, moving or deleting). An assistant that supports these hints can then run reads on their own and ask before changes, the way <em>Ask before changes</em> does in Trilium's chat.</p><h3>Authentication</h3><p>To protect your notes from unauthorized access, the MCP server requires authentication. Generally MCP servers need to support OAuth for authentication, but Trilium uses a simpler mechanism using Bearer tokens.</p><p>To configure authentication, first create an&nbsp;<a class=\"reference-link\" href=\"#root/_help_pgxEVkzLl1OP\">ETAPI (REST API)</a>&nbsp;token by going to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>ETAPI</em>. Then follow the instructions in&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>AI / LLM</em>, by looking at the <em>How to connect an assistant</em> section under MCP.</p><h2>Third-party alternatives</h2><p>The following are alternatives to Trilium's built-in MCP feature. Since Trilium's AI implementation is still experimental, its tooling might not be as mature as external tools.</p><ul><li><a href=\"https://github.com/perfectra1n/triliumnext-mcp\">perfectra1n/triliumnext-mcp</a></li><li><a href=\"https://github.com/tan-yong-sheng/triliumnext-mcp\">tan-yong-sheng/triliumnext-mcp</a></li><li><a href=\"https://github.com/eliassoares/trilium-fastmcp\">eliassoares/trilium-fastmcp</a></li></ul><aside class=\"admonition important\"><p>These solutions are third-party and thus not endorsed or supported directly by the Trilium Notes team. Please address questions and issues on their corresponding repository instead.</p></aside>",
+ "_help_Y84QCbArmK3z": "<aside class=\"admonition important\"><p><strong>Meeting transcription is in beta</strong></p><p>Meeting transcription is a new feature and is still in beta. It has not been tested on every operating system, audio setup and meeting application, so it might fail to capture the audio, miss part of a meeting or behave differently from what this page describes. Before relying on it for an important meeting, try it on a short call first.</p><p>If something does not work, please <a href=\"#root/_help_wy8So3yZZlH9\">report the issue</a>, mentioning your operating system and the meeting application you used. The <em>Keep recordings for troubleshooting</em> option described below keeps what is needed to reproduce a problem.</p></aside><p>Meeting transcription turns a meeting into text while it happens: Trilium listens to your microphone and to what the other participants say through your speakers, and writes down who said what in a new note. Recognition runs entirely on your device, so no audio leaves it.</p><p>Meeting transcription is available only in the desktop application. It is not available when Trilium is accessed through a browser, nor in the mobile application.</p><h2>Enabling meeting transcription</h2><p>Meeting transcription is off by default. To turn it on, go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Transcription</em> and turn on <em>Meeting transcription</em>. This adds the <span class=\"tn-icon bx bx-microphone\"></span> <em>Transcribe meeting</em> button to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>, marked with a <em>Beta</em> badge.</p><p>The speech recognition models are not part of Trilium. The first time you transcribe a meeting, Trilium asks to download them; see&nbsp;<a class=\"reference-link\" href=\"#root/_help_ebyr7ES2SwOW\">Downloaded resources</a> for the sizes and how to manage them. Each device downloads its own copy.</p><h2>Transcribing a meeting</h2><ol><li>Press the <span class=\"tn-icon bx bx-microphone\"></span> <em>Transcribe meeting</em> button in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>.</li><li>If the models are not downloaded yet, confirm the download and wait for it to finish.</li><li>Trilium creates a text note titled with the current date and time (for example <em>Meeting 2026-10-15 14:30</em>) in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_S0Fos78ZfcY7\">Note Inbox</a>, opens it and starts transcribing. While it transcribes, the button turns into a <span class=\"tn-icon bx bx-stop-circle\"></span> <em>Stop transcribing</em> button and shows the time elapsed. Beside it, a reminder asks you to let everyone in the meeting know that it is being transcribed and to ask for their consent; it closes by itself after 10 seconds, or when you click it.</li><li>To end the transcription, press the <span class=\"tn-icon bx bx-stop-circle\"></span> <em>Stop transcribing</em> button. Trilium finishes transcribing what was already said before it stops.</li></ol><p>Only one meeting can be transcribed at a time. The note itself is an ordinary text note: you can take notes in it during the meeting, rename it or move it anywhere in the tree. It carries the <code>#meetingRecording</code> label.</p><p>Trilium tells you when your microphone or the meeting's audio is not being transcribed. It shows a message saying which one and why, the time on the button turns red and the button's tooltip says that some audio is not being transcribed:</p><ul><li><strong>Not captured</strong>: the transcription started without that audio, for example because there is no microphone or because Trilium was not allowed to record the screen and its audio. Connect the microphone or allow the recording, then stop the transcription and start it again.</li><li><strong>No audio</strong>: nothing has arrived from it for 10 seconds, as when its capture hangs. Stop the transcription and start it again; what was transcribed until then is kept.</li><li><strong>Only silence</strong>: it has delivered nothing but silence, for 15 seconds from your microphone or for a minute from the meeting. A microphone muted in your system's settings, or with a mute button of its own, does this. A meeting nobody speaks in for a minute does it too, so this message can be ignored when the others are just quiet.</li></ul><p>Each message shows once. <em>No audio</em> and <em>Only silence</em> clear by themselves once sound arrives again.</p><p>If the transcription stops on its own, for example because the audio could no longer be captured, Trilium shows a message and keeps everything transcribed until then. Closing Trilium during a meeting waits for the transcription to finish first.</p><h2>The transcript</h2><p>The transcript is stored as an <a href=\"#root/_help_0vhv7lsOLy82\">attachment</a> of the meeting note and is shown in a collapsible <em>Transcript</em> section above the note's content. It updates as the meeting goes on, one paragraph per speaker turn, each with the time it started. While the meeting is being transcribed, the header of the <em>Transcript</em> section shows the level of your microphone (<em>Me</em>) and of the meeting's audio (<em>Others</em>), so you can tell that both are being heard, even while the section is collapsed; a source that is not being transcribed is marked <em>Not captured</em>, <em>No audio</em> or <em>Only silence</em>. While someone is talking, <em>Speaking…</em> shows under their name until their words are transcribed. If you are reading the end of the transcript, it scrolls to follow new text.</p><ul><li>What you say into your microphone is labeled <em>Me</em>.</li><li>What the other participants say is labeled <em>Speaker 1</em>, <em>Speaker 2</em> and so on, while <em>Identify speakers</em> is on; otherwise it is labeled <em>Others</em>.</li><li>To name a speaker, click their name, type the new name and press <kbd>Enter</kbd>. The name changes on every turn of that speaker. Press <kbd>Esc</kbd> to cancel, or clear the name to restore the default one.</li><li>To show the transcript with or without hesitations such as \"uh\", \"um\" and stuttered words, press the <span class=\"tn-icon bx bx-eraser\"></span> <em>Hide filler words</em> button above it, which shows as pressed while they are hidden. While they are shown, they are grayed out, so you can see what hiding them would remove. This affects only what is shown; the stored transcript keeps every word.</li><li>To copy the transcript as plain text, press the <span class=\"tn-icon bx bx-copy\"></span> <em>Copy transcript</em> button above it. Each turn is copied with the speaker's name and the time it started, as shown, so the copy leaves out filler words while they are hidden.</li></ul><p>If the meeting note is <a href=\"#root/_help_bwg0e8ewQMak\">protected</a> and the protected session is locked during the meeting, the transcript cannot be saved. Trilium keeps it in memory and saves it once you enter the protected session again, as long as Trilium stays open.</p><h2>Configuration</h2><p>The settings are in&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Transcription</em>, and are shown once <em>Meeting transcription</em> is on.</p><figure class=\"table\"><table><thead><tr><th>Option</th><th>Description</th></tr></thead><tbody><tr><td><em>European languages</em></td><td>The speech recognition model. Both recognize 25 European languages and work out which one is spoken. <em>Standard</em> is a smaller download and runs well on most computers. <em>High accuracy</em> makes fewer mistakes, but is a larger download and needs about 1.6 GB more memory while transcribing. A model is downloaded the first time you transcribe with it.</td></tr><tr><td><em>Identify speakers</em></td><td>Tells the other participants apart and labels each of them separately. Voices are compared only during the meeting: nothing about a voice is stored, and no one is recognized from one meeting to the next. Turn it off if it mixes up voices. The change applies from the next meeting.</td></tr><tr><td><em>Keep recordings for troubleshooting</em></td><td>Keeps the audio of the meeting, the settings used and the transcript as it was produced, so that a problem can be reported and reproduced. It takes about 230 MB per hour of meeting and is never deleted automatically. The folder where they are kept is shown below the option.</td></tr></tbody></table></figure><aside class=\"admonition warning\"><p>Before turning on <em>Keep recordings for troubleshooting</em>, ask everyone in the meeting to agree to being recorded. In several countries and US states, recording a conversation without everyone's consent is a criminal offense. The audio is stored unencrypted, even for protected notes. While the option is on, the tooltip of the <em>Transcribe meeting</em> button says so, and the reminder shown when the transcription starts mentions that the audio is kept.</p></aside><h2>Limitations</h2><ul><li>Meeting transcription needs a speech recognition engine that does not load on every computer, for example on Linux distributions older than Ubuntu 22.04 or Debian 12. Where it does not load, the <em>Transcribe meeting</em> button does not appear, the <em>Transcription</em> options say so, and the log records why.</li><li>The transcript is made from the audio played by your device. A participant whose voice does not come out of your speakers or headphones, for example someone in the same room, is transcribed only as far as your microphone picks them up, and is labeled <em>Me</em>.</li><li>Speaker identification works best with a few clearly distinct voices. Similar voices, many participants or poor call quality can lead to speakers being merged or split.</li><li>Accuracy is lower for languages other than English, and the model can switch to the wrong language for short passages.</li><li>Transcribing uses a noticeable amount of processor time and memory, especially with the <em>High accuracy</em> model.</li></ul>",
+ "_help_CdNpE2pqjmI6": "<p>Trilium supports creating&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;notes, i.e. notes which allow you to store some programming code and highlight it. Special case is JavaScript code notes which can also be executed inside Trilium which can in conjunction with&nbsp;<a class=\"reference-link\" href=\"#root/_help_GLks18SNjxmC\">Script API</a>&nbsp;provide extra functionality.</p><h2>Architecture Overview</h2><p>To go further I must explain basic architecture of Trilium - in its essence it is a classic web application - it has these two main components:</p><ul><li>frontend running in the browser (using HTML, CSS, JavaScript) - this is mainly used to interact with the user, display notes etc.</li><li>backend running JavaScript code in node.js runtime - this is responsible for e.g. storing notes, encrypting them etc.</li></ul><p>So we have frontend and backend, each with their own set of responsibilities, but their common feature is that they both run JavaScript code. Add to this the fact, that we're able to create JavaScript&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;and we're onto something.</p><h2>Use cases</h2><ul><li><a class=\"reference-link\" href=\"#root/_help_TjLYAo3JMO8X\">\"New Task\" launcher button</a></li></ul><h2>Action handler</h2><p>Saving the note to the database is backend's responsibility, so we immediately pass control to the backend and ask it to create a note. Once this is done, we show the newly created note so that the user can set the task title and maybe some attributes.</p><h2>Script execution</h2><p>So we have a script which will add the button to the toolbar. But how can we execute it? One possibility is to click on the <span class=\"tn-icon bx bx-play\"></span> <em>Execute script</em> button. The problem with this is that this UI change is time bound by Trilium runtime so when we restart Trilium, button won't be there.</p><p>We need to execute it every time Trilium starts up, but we probably don't want to have to manually click on play button on every start up.</p><p>The solution is to give the note the <a href=\"#root/_help_zEY4DaJG4YT5\">label</a> <code>#run=frontendStartup</code> - this is one of the \"system\" labels which Trilium understands. As you might guess, this will cause all such labeled script notes to be executed once Trilium frontend starts up.</p><p>(<code>#run=frontendStartup</code> does not work for <a href=\"#root/_help_RDslemsQ6gCp\">Mobile frontend</a> - if you want to have scripts running there, give the script <code>#run=mobileStartup</code> label).</p><h3>Execute button</h3><p>Runnable code notes (frontend or backend) and saved SQL consoles can optionally have a dedicated <span class=\"tn-icon bx bx-play\"></span> execute button alongside a description.</p><p>To do so, apply the following <a href=\"#root/_help_HI6GBBIduIgv\">labels</a>:</p><ul><li>A <code>#executeButton</code> with the value of the label being displayed as the label of the button.</li><li>An optional <code>#executeDescription</code> which adds explanatory text beside it.</li></ul><h2>Autocomplete &amp; linting</h2><p>Starting with Trilium v0.104.0, frontend scripts, backend scripts and render notes benefit from an autocomplete system.</p><p>The autocomplete triggers automatically when typing <kbd>.</kbd> or manually by pressing <kbd>Ctrl</kbd>+<kbd>Space</kbd>.</p><p>In addition to that, the editor will also display syntax errors and warnings such as unreachable code.</p><aside class=\"admonition note\"><p>If you notice a false positive in regards with the errors/warnings reported or an incorrect or missing API, feel free to <a href=\"#root/_help_wy8So3yZZlH9\">open a issue</a> with a code sample.</p></aside><h2>More showcases</h2><p>You can see more scripting with explanation in&nbsp;<a class=\"reference-link\" href=\"#root/_help_5668rwcirq1t\">Advanced Showcases</a>.</p><h2>Events</h2><p>See&nbsp;<a class=\"reference-link\" href=\"#root/_help_GPERMystNGTB\">Events</a>.</p><h2>Script API</h2><p>See&nbsp;<a class=\"reference-link\" href=\"#root/_help_GLks18SNjxmC\">Script API</a>.</p>",
+ "_help_yIhgI5H7A2Sm": "<p>Front-end scripts are custom JavaScript notes that are run on the client (browser environment)</p><p>There are four flavors of front-end scripts:</p><figure class=\"table\"><table><tbody><tr><td>Regular scripts</td><td>These are run with the current app and note context. These can be run either manually or automatically on start-up.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_MgibgPcfeuGz\">Custom Widgets</a></td><td>These can introduce new UI elements in various positions, such as near the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, content area or even the&nbsp;<a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_4Gn3psZKsfSm\">Launch Bar Widgets</a></td><td>Similar to&nbsp;<a class=\"reference-link\" href=\"#root/_help_MgibgPcfeuGz\">Custom Widgets</a>, but dedicated to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>. These can simply introduce new buttons or graphical elements to the bar.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a></td><td>This allows rendering custom content inside a note, using either HTML or Preact JSX.</td></tr></tbody></table></figure><p>For more advanced behaviors that do not require a user interface (e.g. batch modifying notes), see&nbsp;<a class=\"reference-link\" href=\"#root/_help_SPirpZypehBG\">Backend scripts</a>.</p><h2>Scripts</h2><p>Scripts don't have any special requirements. They can be run manually using the <em>Execute</em> button on the code note or they can be run automatically, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_irkwjdNtjcxR\">Frontend Events</a>.</p><h2>Widgets</h2><p>Widgets require a certain format in order for Trilium to be able to integrate them into the UI.</p><ul><li>For legacy widgets, the script note must export a <code>BasicWidget</code> or a derived one (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_GhurYZjh8e1V\">Note context aware widget</a>&nbsp;or&nbsp;<a class=\"reference-link\" href=\"#root/_help_M8IppdwVHSjG\">Right pane widget</a>).</li><li>For Preact widgets, a built-in helper called <code>defineWidget</code> needs to be used.</li></ul><p>For more information, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_MgibgPcfeuGz\">Custom Widgets</a>.</p><h2>Script API</h2><p>The front-end API of Trilium is available to all scripts running in the front-end context as global variable <code>api</code>. For a reference of the API, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_Q2z6av6JZVWm\">Frontend API</a>.</p><h3>Tutorial</h3><p>For more information on building widgets, take a look at <a href=\"#root/_help_SynTBQiBsdYJ\">Widget Basics</a>.</p>",
+ "_help_MgibgPcfeuGz": "<p>Custom widgets are a special subset of scripts that render graphical elements in certain parts of the application. These can be used to add new functionality to the Trilium application.</p><h2>Preact with JSX vs. vanilla jQuery</h2><p>In older versions of Trilium, custom widgets were exclusively written in a combination of jQuery with Trilium's internal widget architecture (e.g., <code>BasicWidget</code>, <code>NoteContextAwareWidget</code>).</p><p>Starting with v0.101.0, custom widgets can also be written in JSX using the&nbsp;<a class=\"reference-link\" href=\"#root/_help_KLsqhjaqh1QW\">Preact</a>&nbsp;framework. Both legacy and Preact widgets have the same capabilities, with a single difference:</p><ul><li>Preact widgets are content-sized by default whereas legacy widgets need <code>this.contentSized()</code> applied in the constructor. For more information, see the corresponding section in&nbsp;<a class=\"reference-link\" href=\"#root/_help_gMkgcLJ6jBkg\">Troubleshooting</a>.</li></ul><p>Wherever possible, widget examples will be both in the legacy and Preact format.</p><h2>Creating a custom widget</h2><p>The quickest way is <em>Insert child note</em> → <em>Code</em> → <em>Widget</em> in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_YtSN43OrfzaA\">Note tree contextual menu</a>. It creates a JSX note with the <code>#widget</code> label and a minimal Preact widget to start from.</p><p>To set one up by hand instead:</p><ol><li>Create a&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;note.</li><li>Set the language to:<ol><li>JavaScript (frontend) for legacy widgets using jQuery.</li><li>JSX for Preact widgets. You might need to go to Options → Code to enable the language first.</li></ol></li><li>Apply the <code>#widget</code> <a href=\"#root/_help_HI6GBBIduIgv\">label</a>.</li></ol><h2>Getting started with a simple example</h2><p>Let's start by creating a widget that shows a message near the content area. Follow the previous section to create a code note, and use the following content.</p><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-react\"></span>&nbsp;Preact</p><div class=\"trilium-tab-panel\"><pre><code class=\"language-text-x-trilium-auto\">import { defineWidget } from \"trilium:preact\";\n\nexport default defineWidget({\n parent: \"center-pane\",\n render: () =&gt; &lt;span&gt;Center pane from Preact.&lt;/span&gt;\n});</code></pre></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-javascript\"></span>&nbsp;Legacy</p><div class=\"trilium-tab-panel\"><pre><code class=\"language-text-x-trilium-auto\">class HelloCenterPane extends api.BasicWidget {\n\n constructor() {\n super();\n this.contentSized();\n }\n\n get parentWidget() { return \"center-pane\" }\n\n doRender() {\n this.$widget = $(\"&lt;span&gt;Center pane&lt;/span&gt;\");\n }\n \n}\n\nmodule.exports = new HelloCenterPane();</code></pre></div></section></div><p><a href=\"#root/_help_s8alTXmpFR61\">Refresh the application</a> and the widget should appear underneath the content area.</p><h2>Widget location (parent widget)</h2><p>A widget can be placed in one of the following sections of the applications:</p><figure class=\"table\"><table class=\"ck-table-resized\"><colgroup><col style=\"width:15.59%;\"><col style=\"width:30.42%;\"><col style=\"width:16.68%;\"><col style=\"width:37.31%;\"></colgroup><thead><tr><th>Value for <code>parentWidget</code></th><th>Description</th><th>Sample widget</th><th>Special requirements</th></tr></thead><tbody><tr><th><code>left-pane</code></th><td>Appears within the same pane that holds the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.</td><td>Same as above, with only a different <code>parentWidget</code>.</td><td>None.</td></tr><tr><th><code>center-pane</code></th><td>In the content area. If a split is open, the widget will span all of the splits.</td><td>See example above.</td><td>None.</td></tr><tr><th><code>note-detail-pane</code></th><td><p>In the content area, inside the note detail area. If a split is open, the widget will be contained inside the split.</p><p>This is ideal if the widget is note-specific.</p></td><td><a class=\"reference-link\" href=\"#root/_help_GhurYZjh8e1V\">Note context aware widget</a></td><td><ul><li>The widget must export a <code>class</code> and not an instance of the class (e.g. <code>no new</code>) because it needs to be multiplied for each note, so that splits work correctly.</li><li>Since the <code>class</code> is exported instead of an instance, the <code>parentWidget</code> getter must be <code>static</code>, otherwise the widget is ignored.</li></ul></td></tr><tr><th><code>right-pane</code></th><td>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>, as a dedicated section.</td><td><a class=\"reference-link\" href=\"#root/_help_M8IppdwVHSjG\">Right pane widget</a></td><td><ul><li>Although not mandatory, it's best to use a <code>RightPanelWidget</code> instead of a <code>BasicWidget</code> or a <code>NoteContextAwareWidget</code>.</li></ul></td></tr></tbody></table></figure><p>To position the widget somewhere else, just change the value passed to <code>get parentWidget()</code> for legacy widgets or the <code>parent</code> field for Preact. Do note that some positions such as <code>note-detail-pane</code> and <code>right-pane</code> have special requirements that need to be accounted for (see the table above).</p><h2>Multiple widgets in a single note</h2><p>A widget note usually returns one widget, but it can also return an array of them. This is useful when several widgets share code or state, since they can all live in the same note instead of being split across notes that need a shared module.</p><p>Each widget of the array is registered on its own, so they can have different parents and positions. A widget that is missing its <code>parentWidget</code> (or <code>parent</code> for Preact) is reported as an error without affecting the other widgets of the note.</p><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-react\"></span>&nbsp;Preact</p><div class=\"trilium-tab-panel\"><pre><code class=\"language-text-x-trilium-auto\">import { defineWidget } from \"trilium:preact\";\n\nexport default [\n defineWidget({\n parent: \"left-pane\",\n render: () =&gt; &lt;span&gt;Left pane from Preact.&lt;/span&gt;\n }),\n defineWidget({\n parent: \"right-pane\",\n render: () =&gt; &lt;span&gt;Right pane from Preact.&lt;/span&gt;\n })\n];</code></pre></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-javascript\"></span>&nbsp;Legacy</p><div class=\"trilium-tab-panel\"><pre><code class=\"language-text-x-trilium-auto\">class TreeWidget extends api.BasicWidget {\n get parentWidget() { return \"left-pane\"; }\n doRender() { this.$widget = $(\"&lt;span&gt;Left pane&lt;/span&gt;\"); }\n}\n\nclass SidebarWidget extends api.BasicWidget {\n get parentWidget() { return \"right-pane\"; }\n doRender() { this.$widget = $(\"&lt;span&gt;Right pane&lt;/span&gt;\"); }\n}\n\nmodule.exports = [ new TreeWidget(), new SidebarWidget() ];</code></pre></div></section></div><h2>Launch bar widgets</h2><p>Launch bar widgets are similar to <em>Custom widgets</em> but are specific to the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_4Gn3psZKsfSm\">Launch Bar Widgets</a>&nbsp;for more information.</p><h2>Custom position</h2><p>The position of a custom widget is defined via a <code>position</code> integer.</p><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-react\"></span>&nbsp;Preact</p><div class=\"trilium-tab-panel\"><pre><code class=\"language-text-x-trilium-auto\">export default defineWidget({\n // [...]\n position: 10\n});</code></pre></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-javascript\"></span>&nbsp;Legacy</p><div class=\"trilium-tab-panel\"><pre><code class=\"language-text-x-trilium-auto\">class MyWidget extends api.BasicWidget {\n\t// [..\n\tget position() { return 10; }\n}</code></pre></div></section></div>",
+ "_help_SynTBQiBsdYJ": "<p>This guide will walk you through creating a basic widget inside Trilium. By following these steps, you'll learn how to build a simple UI element that interacts with the user.</p><h3>Step 1: The Basic Widget Structure</h3><p>To start, we'll create the most basic widget possible. Here's a simple example:</p><pre><code class=\"language-text-x-trilium-auto\">class MyWidget extends api.BasicWidget {\n get position() { return 1; }\n get parentWidget() { return \"left-pane\"; }\n \n doRender() {\n this.$widget = $(\"&lt;div id='my-widget'&gt;\");\n return this.$widget;\n }\n}\n\nmodule.exports = new MyWidget();</code></pre><p>To implement this widget:</p><ol><li>Create a new <code>JS Frontend</code> note in Trilium and paste in the code above.</li><li>Assign the <code>#widget</code> <a href=\"#root/_help_zEY4DaJG4YT5\">attribute</a> to the <a href=\"#root/_help_BFs8mudNFgCS\">note</a>.</li><li>Restart Trilium or reload the window.</li></ol><p>To verify that the widget is working, open the developer tools (<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>I</kbd>) and run <code>document.querySelector(\"#my-widget\")</code>. If the element is found, the widget is functioning correctly. If <code>undefined</code> is returned, double-check that the <a href=\"#root/_help_BFs8mudNFgCS\">note</a> has the <code>#widget</code> <a href=\"#root/_help_zEY4DaJG4YT5\">attribute</a>.</p><h3>Step 2: Adding an UI Element</h3><p>Next, let's improve the widget by adding a button to it.</p><pre><code class=\"language-text-x-trilium-auto\">const template = `&lt;div id=\"my-widget\"&gt;&lt;button&gt;Click Me!&lt;/button&gt;&lt;/div&gt;`;\n\nclass MyWidget extends api.BasicWidget {\n get position() {return 1;}\n get parentWidget() {return \"left-pane\"}\n\n doRender() {\n this.$widget = $(template);\n return this.$widget;\n }\n}\n\nmodule.exports = new MyWidget();</code></pre><p>After making this change, reload Trilium. You should now see a button in the top-left corner of the left pane.</p><h3>Step 3: Styling the Widget</h3><p>To make the button more visually appealing and position it correctly, we'll apply some custom styling. Trilium includes <a href=\"https://boxicons.com\">Box Icons</a>, which we'll use to replace the button text with an icon. For example the <span class=\"tn-icon bx bxs-magic-wand\"></span> <code>bx bxs-magic-wand</code> icon.</p><p>Here's the updated template:</p><pre><code class=\"language-text-x-trilium-auto\">const template = `&lt;div id=\"my-widget\"&gt;&lt;button class=\"tree-floating-button bx bxs-magic-wand tree-settings-button\"&gt;&lt;/button&gt;&lt;/div&gt;`;</code></pre><p>Next, we'll adjust the button's position using CSS:</p><pre><code class=\"language-text-x-trilium-auto\">class MyWidget extends api.BasicWidget {\n get position() { return 1; }\n get parentWidget() { return \"left-pane\"; }\n \n doRender() {\n this.$widget = $(template);\n this.cssBlock(`#my-widget {\n position: absolute;\n bottom: 40px;\n left: 60px;\n z-index: 1;\n }`);\n return this.$widget;\n }\n}\n\nmodule.exports = new MyWidget();</code></pre><p>After reloading Trilium, the button should now appear at the bottom left of the left pane, alongside other action buttons.</p><h3>Step 4: Adding User Interaction</h3><p>Let’s make the button interactive by showing a message when it’s clicked. We'll use the <code>api.showMessage</code> method from the <a href=\"#root/_help_GLks18SNjxmC\">Script API</a>.</p><pre><code class=\"language-text-x-trilium-auto\">class MyWidget extends api.BasicWidget {\n get position() { return 1; }\n get parentWidget() { return \"left-pane\"; }\n \n doRender() {\n this.$widget = $(template);\n this.cssBlock(`#my-widget {\n position: absolute;\n bottom: 40px;\n left: 60px;\n z-index: 1;\n }`);\n this.$widget.find(\"button\").on(\"click\", () =&gt; api.showMessage(\"Hello World!\"));\n return this.$widget;\n }\n}\n\nmodule.exports = new MyWidget();</code></pre><p>For the list of possible values for <code>parentWidget()</code>, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_MgibgPcfeuGz\">Custom Widgets</a>.&nbsp;</p><p><a href=\"#root/_help_s8alTXmpFR61\">Reload</a> the application one last time. When you click the button, a \"Hello World!\" message should appear, confirming that your widget is fully functional.</p>",
+ "_help_GhurYZjh8e1V": "<p>Note context-aware widgets are a different type of widget which automatically react to changes in the current note.</p><p>Important aspects:</p><ul><li>The widget must export a <code>class</code> and not an instance of the class (e.g. <code>no new</code>) because it needs to be multiplied for each note, so that splits work correctly.</li><li>Since the <code>class</code> is exported instead of an instance, the <code>parentWidget</code> getter must be <code>static</code>, otherwise the widget is ignored.</li></ul><h2>Example displaying the current note title</h2><p>This is a note context-aware widget that simply displays the name the current note.&nbsp;</p><h3>Classic example</h3><pre><code class=\"language-text-x-trilium-auto\">class HelloNoteDetail extends api.NoteContextAwareWidget {\n\n constructor() {\n super();\n this.contentSized();\n }\n\n doRender() {\n this.$widget = $(\"&lt;div&gt;\");\n }\n\n async refreshWithNote(note) {\n this.$widget.text(\"Current note: \" + note.title);\n }\n \n static get parentWidget() { return \"note-detail-pane\" } \n get position() { return 10 }\n \n}\n\nmodule.exports = HelloNoteDetail;</code></pre><h3>Preact (v0.101.0+)</h3><pre><code class=\"language-text-x-trilium-auto\">import { defineWidget, useNoteContext, useNoteProperty } from \"trilium:preact\";\n\nexport default defineWidget({ \n parent: \"note-detail-pane\",\n position: 10,\n render: () =&gt; {\n const { note } = useNoteContext();\n const title = useNoteProperty(note, \"title\");\n return &lt;span&gt;Current note JSX: {title}&lt;/span&gt;;\n }\n});</code></pre>",
+ "_help_M8IppdwVHSjG": "<h3>Title widget</h3><p>This is an example of a context-aware widget which displays the title of the current note:</p><pre><code class=\"language-text-x-trilium-auto\">class NoteTitleWidget extends api.RightPanelWidget {\n \n get widgetTitle() { return \"Note title\"; }\n get parentWidget() { return \"right-pane\" }\n\n doRenderBody() {\n this.$body.empty();\n if (this.note) {\n this.$body.append($(\"&lt;div&gt;\").text(this.note.title));\n }\n } \n \n async refreshWithNote() {\n \tthis.doRenderBody();\n }\n}\n\nmodule.exports = new NoteTitleWidget();</code></pre><h3>Clock</h3><p>A simple widget which will show the current time, as an example on how to dynamically change the content of the widget periodically.</p><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-react\"></span>&nbsp;Preact</p><div class=\"trilium-tab-panel\"><pre><code class=\"language-text-x-trilium-auto\">import { defineWidget, RightPanelWidget, useEffect, useState } from \"trilium:preact\";\n\nexport default defineWidget({\n parent: \"right-pane\", \n position: 1,\n render() {\n const [ time, setTime ] = useState();\n useEffect(() =&gt; {\n const interval = setInterval(() =&gt; {\n setTime(new Date().toLocaleString());\n }, 1000);\n return () =&gt; clearInterval(interval);\n }); \n return (\n &lt;RightPanelWidget id=\"clock-jsx\" title=\"Clock (JSX)\"&gt;\n &lt;p&gt;The time is: {time}&lt;/p&gt;\n &lt;/RightPanelWidget&gt;\n );\n }\n});</code></pre></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-javascript\"></span>&nbsp;Legacy</p><div class=\"trilium-tab-panel\"><pre><code class=\"language-text-x-trilium-auto\">const template = `&lt;div&gt;&lt;/div&gt;`;\n\nclass ToDoListWidget extends api.RightPanelWidget {\n \n get widgetTitle() { return \"Clock\"; } \n get parentWidget() { return \"right-pane\" }\n \n async doRenderBody() {\n if (!this.timer) {\n this.timer = setInterval(() =&gt; {\n this.$body.empty().append(`The time is: &lt;span&gt;${new Date().toLocaleString()}&lt;/span&gt;`); \n }, 1000); \n }\n\n this.$body.empty().append(`The time is: &lt;span&gt;${new Date().toLocaleString()}&lt;/span&gt;`);\n } \n}\n\nmodule.exports = new ToDoListWidget();</code></pre></div></section></div><h2>Altering the position within the sidebar</h2><p>By default, the sidebar items are displayed in the order they are found by the application when searching for <code>#widget</code> notes.</p><p>It is possible to make a widget appear higher or lower up, by adjusting its <code>position</code> property:</p><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-react\"></span>&nbsp;Preact</p><div class=\"trilium-tab-panel\"><pre><code class=\"language-text-javascript\">import { defineWidget, RightPanelWidget, useEffect, useState } from \"trilium:preact\";\n\nexport default defineWidget({\n\t/* [...] */\n position: 20,\n render() {\n\t\t/* [...] */\n }\n});</code></pre></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-javascript\"></span>&nbsp;Legacy</p><div class=\"trilium-tab-panel\"><pre><code class=\"language-text-javascript\">class MyWidget extends api.RightPanelWidget {\n\n get position() { return 20 };\n \n}</code></pre></div></section></div><p>Generally the default position starts from 10 and increases by 10 with each item, including the default Table of Contents and Highlights list.</p><h2>Key highlights for legacy widgets</h2><ul><li><code>doRender</code> must not be overridden, instead <code>doRenderBody()</code> has to be overridden.<ul><li><code>doRenderBody</code> can optionally be <code>async</code>.</li></ul></li><li><code>parentWidget()</code> must be set to <code>“rightPane”</code>.</li><li><code>widgetTitle()</code> getter can optionally be overriden, otherwise the widget will be displayed as “Untitled widget”.</li></ul>",
+ "_help_YNxAqkI5Kg1M": "<aside class=\"admonition tip\"><p>This widget is also present in new installations in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_6tZeKvSHEUiB\">Demo Notes</a>.</p></aside><p>Create a&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;note of type JavaScript (Trilium frontend) and <strong>give it a</strong> <code>#widget</code> <strong>label</strong>.</p><pre><code class=\"language-text-x-trilium-auto\">/*\n * This defines a custom widget which displays number of words and characters in a current text note.\n * To be activated for a given note, add label 'wordCount' to the note, you can also make it inheritable and thus activate it for the whole subtree.\n * \n * See it in action in \"Books\" and its subtree.\n */\nconst TPL = `&lt;div style=\"padding: 10px; border-top: 1px solid var(--main-border-color); contain: none;\"&gt;\n &lt;strong&gt;Word count: &lt;/strong&gt;\n &lt;span class=\"word-count\"&gt;&lt;/span&gt;\n\n &amp;nbsp;\n\n &lt;strong&gt;Character count: &lt;/strong&gt;\n &lt;span class=\"character-count\"&gt;&lt;/span&gt;\n&lt;/div`;\n\nclass WordCountWidget extends api.NoteContextAwareWidget {\n get position() { return 100; } // higher value means position towards the bottom/right\n \n get parentWidget() { return 'center-pane'; }\n \n doRender() {\n this.$widget = $(TPL);\n this.$wordCount = this.$widget.find('.word-count');\n this.$characterCount = this.$widget.find('.character-count');\n return this.$widget;\n }\n \n async refreshWithNote(note) {\n if (note.type !== 'text' || !note.hasLabel('wordCount')) { \n // show widget only on text notes and when marked with 'wordCount' label\n this.toggleInt(false); // hide\n \n return;\n }\n \n this.toggleInt(true); // display\n \n const {content} = await note.getNoteComplement();\n \n const text = $(content).text(); // get plain text only\n \n const counts = this.getCounts(text);\n\n this.$wordCount.text(counts.words);\n this.$characterCount.text(counts.characters);\n }\n \n getCounts(text) {\n const chunks = text\n .split(/[\\s-+:,/\\\\]+/)\n .filter(chunk =&gt; chunk !== '');\n \n let words;\n \n if (chunks.length === 1 &amp;&amp; chunks[0] === '') {\n words = 0;\n }\n else {\n words = chunks.length;\n }\n \n const characters = chunks.join('').length;\n \n return {words, characters};\n }\n \n async entitiesReloadedEvent({loadResults}) {\n if (loadResults.isNoteContentReloaded(this.noteId)) {\n this.refresh();\n }\n }\n}\n\nmodule.exports = new WordCountWidget();</code></pre><p>After you make changes it is necessary to <a href=\"#root/_help_s8alTXmpFR61\">restart Trilium</a> so that the layout can be rebuilt.</p><p>The widget only activates on text notes that have the <code>#wordCount</code> label. This label can be a <a href=\"#root/_help_hrZ1D00cLbal\">reference link</a> to enable the widget for an entire subtree.</p><p>At the bottom of the note you can see the resulting widget:</p><figure class=\"image\"><img style=\"aspect-ratio:792/603;\" src=\"{{helpAssets}}/User%20Guide/Scripting/Frontend%20Basics/Custom%20Widgets/Word%20count%20widget_image.png\" width=\"792\" height=\"603\"></figure>",
+ "_help_VqGQnnPGnqAU": "<h2>Classic widgets</h2><p>In <code>doRender()</code>:<sup><a href=\"#fn1saoftmefpp\">[1]</a></sup></p><pre><code class=\"language-text-x-trilium-auto\">this.cssBlock(`#my-widget {\n\tposition: absolute;\n bottom: 40px;\n left: 60px;\n z-index: 1;\n}`);</code></pre><h2>Preact widgets</h2><p>See the dedicated page:&nbsp;<a class=\"reference-link\" href=\"#root/_help_Sg9GrCtyftZf\">CSS</a>.</p><ol><li><p><sup><strong><a href=\"#fnref1saoftmefpp\">^</a></strong></sup></p><p>Reference: <a href=\"https://trilium.rocks/X7pxYpiu0lgU\">https://trilium.rocks/X7pxYpiu0lgU</a></p></li></ol>",
+ "_help_gMkgcLJ6jBkg": "<h2>Why is my widget clipped by other UI elements</h2><p>For performance and layout reasons, the size of widgets in Trilium is independent from its children. At CSS level, this means that the widget container has <code>contain: size</code> applied to it.</p><p>This works well if the widget has a fixed size (or based on its parent container), however to make a widget resize to fit its content, apply the following change:</p><pre><code class=\"language-text-x-diff\">class MyWidget extends api.RightPanelWidget {\n\n+ constructor() {\n+ super();\n+ this.contentSized();\n+ }\n \n}</code></pre><p>Alternatively apply <code>contain: none</code> to its CSS.</p>",
+ "_help_TjLYAo3JMO8X": "<aside class=\"admonition warning\"><p>This documentation is outdated, as it refers to using the deprecated <code>addButtonToToolbar</code> API which will only create widgets for desktop.</p><p>Instead, a custom launcher widget can be created using the&nbsp;<a class=\"reference-link\" href=\"#root/_help_4Gn3psZKsfSm\">Launch Bar Widgets</a>&nbsp;documentation.</p></aside><p>In this example we are going to extend the functionality of&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYjQUYhpbUEW\">Task Manager</a>&nbsp;showcase (which comes by default with Trilium) by adding a button in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>&nbsp; (<span class=\"tn-icon bx bx-task\"></span>) to create a new task automatically and open it.</p><h2>Creating the note</h2><ol><li>First, create a new&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;note type with the <em>JavaScript (Trilium frontend)</em> language.</li><li>Define the <code>#run=frontendStartup</code> label in&nbsp;<a class=\"reference-link\" href=\"#root/_help_zEY4DaJG4YT5\">Attributes</a>.</li></ol><h2>Content of the script</h2><p>Copy-paste the following script:</p><pre><code class=\"language-text-javascript\">api.addButtonToToolbar({\n\ttitle: \"New task\",\n icon: \"task\",\n shortcut: \"alt+n\",\n action: async () =&gt; {\n \tconst taskNoteId = await api.runOnBackend(() =&gt; {\n \tconst todoRootNote = api.getNoteWithLabel(\"taskTodoRoot\");\n const resp = api.createTextNote(todoRootNote.noteId, \"New task\", \"\") \n return resp.note.noteId;\n });\n \n await api.waitUntilSynced();\n await api.activateNewNote(taskNoteId);\n }\n});</code></pre><h2>Testing the functionality</h2><p>Since we set the script to be run on start-up, all we need to do is to <a href=\"#root/_help_s8alTXmpFR61\">refresh the application</a>.</p><h2>Understanding how the script works</h2><figure class=\"table\"><table class=\"ck-table-resized\"><colgroup><col style=\"width:50%;\"><col style=\"width:50%;\"></colgroup><tbody><tr><td><pre><code class=\"language-text-x-trilium-auto\">api.addButtonToToolbar({\n\ttitle: \"New task\",\n icon: \"task\",\n shortcut: \"alt+n\",\n action: async () =&gt; {\n \t// [...]\n }\n});</code></pre></td><td><p>This uses the <a href=\"#root/_help_yIhgI5H7A2Sm\">Front-end API</a> to create a icon in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>, by specifying:</p><ul><li>A title</li><li>A corresponding boxicons icon (without the <code>bx-</code> prefix).</li><li>Optionally, a keyboard shortcut to assign to it.</li><li>The action, which will be executed when the button is pressed.</li></ul></td></tr><tr><td><pre><code class=\"language-text-x-trilium-auto\">const taskNoteId = await api.runOnBackend(() =&gt; {\n // Shown below. \n return resp.note.noteId;\n});</code></pre></td><td><ul><li>This portion of code is actually executed on the server (backend) and not on the client (i.e. browser).<ul><li>The reason is that the creating notes is the responsibility of the server.</li></ul></li><li>Here we can also see that it is possible to return results from the server execution and read them in the client (<code>taskNoteId</code>).</li></ul></td></tr><tr><td><pre><code class=\"language-text-x-trilium-auto\">const todoRootNote = api.getNoteWithLabel(\"taskTodoRoot\");</code></pre></td><td><ul><li>Here we identify a note with the <a href=\"#root/_help_zEY4DaJG4YT5\">label</a> <code>#taskTodoRoot</code>. This is how the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYjQUYhpbUEW\">Task Manager</a>&nbsp;showcase knows where to place all the different tasks.</li><li>Normally this might return a <code>null</code> value if no such note could be identified, but error handling is outside the scope of this example.&nbsp;</li></ul></td></tr><tr><td><pre><code class=\"language-text-x-trilium-auto\">const resp = api.createTextNote(todoRootNote.noteId, \"New task\", \"\")</code></pre></td><td><ul><li>We create a new child note within the to-do root note (first argument) with the title “New task\" (second argument) and no content by default (third argument).</li></ul></td></tr><tr><td><pre><code class=\"language-text-x-trilium-auto\">await api.waitUntilSynced();</code></pre></td><td><ul><li>Back on the client, since we created a new note on the server, we now need to wait for the change to be reflected in the client.</li></ul></td></tr><tr><td><pre><code class=\"language-text-x-trilium-auto\">await api.activateNewNote(taskNoteId);</code></pre></td><td><ul><li>Since we know the <a href=\"#root/_help_m1lbrzyKDaRB\">ID</a> of the newly created note, all we have to do now is to show this note to the user.</li></ul></td></tr></tbody></table></figure>",
+ "_help_7kZPMD0uFwkH": "<p>This tutorial showcases a basic integration with Google Forms, where we are able to download the responses of a form using the “Link to Sheets\" functionality.</p><p>Note that the link will be publicly accessible to everyone (however the link is in a hard-to-guess format such as <code>https://docs.google.com/spreadsheets/d/e/2PACX-1vTA8NU2_eZFhc8TFadCZPreBfvP7un8IHd6J0SchrLLw3ueGmntNZjwRmsH2ZRcp1pJYDAzMz1FmFaj/pub?output=csv</code>). Make sure you are not accidentally publishing sensitive information.</p><h2>Obtaining the CSV link</h2><ol><li>Open the Google Forms in a browser.</li><li>Select the “Responses” tab and click on “Link to Sheets”.</li><li>Select “Create a new spreadsheet” and press “Create”.</li><li>In Google Sheets, select File → Share → Publish to web.</li><li>In the “Publish to the web” screen, make sure the “Link” tab is selected and instead of “Web page”, select “Comma-separated values (.csv)”.</li><li>Copy the given link which will be used for the upcoming script.</li></ol><h2>Creating the script</h2><p>Create a “JS Frontend” script:</p><pre><code class=\"language-text-x-trilium-auto\">const CSV_URL = \"https://docs.google.com/spreadsheets/d/e/2PACX-1vTiwooLV2whjCSVa49dJ99p_G3_qhqHHRqttMjYCJVfLXVdTgUSNJu5K0rpqmaHYF2k7Vofi3o7gW82/pub?output=csv\";\n\nasync function fetchData() {\n try {\n const response = await fetch(CSV_URL);\n return await response.text();\n } catch (e) {\n api.showError(e.message);\n }\n}\n\nconst data = await fetchData();\nconsole.log(data);\n// Do something with the data.</code></pre><p>Note that the data will be received as a string and there is no library to do the CSV parsing for us. To do a very simple parsing of CSV:</p><pre><code class=\"language-text-x-trilium-auto\">const content = data\n\t.split(\"\\n\")\n\t.slice(1)\n\t.map((row) =&gt; row.split(\",\"));</code></pre><p>This will return the data as an array of arrays.</p>",
+ "_help_DL92EjAaXT26": "<p>A good use case of promoted attributes is to easily define the various parameters a script might need, for example an input and output note if it's processing data, or a checkbox to define a particular change in behavior for the script.</p><p><img src=\"{{helpAssets}}/User%20Guide/Scripting/Frontend%20Basics/Examples/Using%20promoted%20attributes%20to%20configure%20scripts_image.png\"></p><h2>Using check boxes to toggle flags</h2><p>Instead of asking the user to modify a boolean value in the script, it's much more intuitive to use a checkbox for it as a promoted attribute.</p><p>To do so, first define the promoted attribute:</p><pre><code class=\"language-text-x-trilium-auto\">#label:groupByExtension=\"promoted,alias=Group by extension,single,boolean\"</code></pre><p>Then use it:</p><pre><code class=\"language-text-javascript\">const byExtension = api.currentNote.getLabelValue(\"groupByExtension\") === \"true\";\nif (byExtension) {\n\t// Do something.\n}</code></pre><p>This will work equally well in both front-end and back-end scripts.</p><h2>Using relations to select notes</h2><p>One common use case for a script is to read data from another note and perhaps output its result in another note. To do so we need to define the following promoted attributes:</p><pre><code class=\"language-text-x-trilium-auto\">#relation:input=\"promoted,alias=Input,single\" #relation:output=\"promoted,alias=Output,single\"</code></pre><p>Once we have this, we can add some basic error handling to ensure that the fields are completed by the user:</p><pre><code class=\"language-text-javascript\">const inputNoteId = api.currentNote.getRelationValue(\"input\");\nif (!inputNoteId) {\n\tapi.showError(\"Missing input.\");\n return;\n}\n\nconst outputNoteId = api.currentNote.getRelationValue(\"output\");\nif (!outputNoteId) {\n api.showError(\"Missing output.\");\n return;\n}</code></pre><p>Note that here we are using <code>api.showError</code> which is only available for frontend notes. If you are writing a backend note, simply remove <code>api.showError</code> but the user will no feedback on why the script did not execute properly.</p><p>Afterwards we can simply read the note and do something with it:</p><pre><code class=\"language-text-javascript\">const note = api.getNote(inputNoteId);\nif (!note) {\n\treturn;\n}\nconst content = note.getContent().toString(\"utf-8\");</code></pre>",
+ "_help_4Gn3psZKsfSm": "<p>Launch bar widgets are a subset of&nbsp;<a class=\"reference-link\" href=\"#root/_help_MgibgPcfeuGz\">Custom Widgets</a>&nbsp;that can be used to render custom buttons and widgets inside the&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>.</p><h2>Creating a launch bar widget for the desktop layout</h2><p>Unlike&nbsp;<a class=\"reference-link\" href=\"#root/_help_MgibgPcfeuGz\">Custom Widgets</a>, the process of setting up a launch bar widget is slightly different:</p><ol><li>Create a Code note of type <em>JavaScript (front-end)</em> or JSX (for Preact-based widgets).<ul><li>The script itself uses the same concepts as&nbsp;<a class=\"reference-link\" href=\"#root/_help_MgibgPcfeuGz\">Custom Widgets</a>, including the use of a <code>NoteContextAwareWidget</code> or a <code>BasicWidget</code> (according to needs).</li><li>As examples in both legacy and Preact format, see&nbsp;<a class=\"reference-link\" href=\"#root/_help_IPArqVfDQ4We\">Note Title Widget</a>&nbsp;and&nbsp;<a class=\"reference-link\" href=\"#root/_help_gcI7RPbaNSh3\">Analog Watch</a>.</li></ul></li><li>Don't set <code>#widget</code>, as that attribute is reserved for&nbsp;<a class=\"reference-link\" href=\"#root/_help_MgibgPcfeuGz\">Custom Widgets</a>.</li><li>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a>, select <em>Configure launchbar</em>.</li><li>In the <em>Visible Launchers</em> section, select <em>Add a custom widget</em>.</li><li>Give the newly created launcher a name (and optionally a name).</li><li>In the&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>&nbsp;section, modify the <em>widget</em> field to point to the newly created note.</li><li><a href=\"#root/_help_s8alTXmpFR61\">Refresh</a> the UI.</li></ol><h2>Mobile layout</h2><p>Custom launch bar widgets are also supported on the&nbsp;<a class=\"reference-link\" href=\"#root/_help_RDslemsQ6gCp\">Mobile Frontend</a>. To do so:</p><ol><li>Go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a>&nbsp;→ <em>Advanced</em> → <em>Show Hidden Subtree</em>.</li><li>Look for <em>Mobile Launch Bar</em> and follow the same creation mechanism as in the previous section.</li></ol>",
+ "_help_IPArqVfDQ4We": "<figure class=\"image\"><img style=\"aspect-ratio:1007/94;\" src=\"{{helpAssets}}/User%20Guide/Scripting/Frontend%20Basics/Launch%20Bar%20Widgets/Note%20Title%20Widget_image.png\" width=\"1007\" height=\"94\"></figure><p>This is an example of a note context-aware widget, which reacts to the currently opened note and refreshes automatically as the user navigates through the notes.</p><p>In this example, the title of the note is displayed. It works best on the <a href=\"#root/_help_x0JgW8UqGXvq\">horizontal layout</a>.</p><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-react\"></span>&nbsp;Preact</p><div class=\"trilium-tab-panel\"><pre><code class=\"language-text-x-trilium-auto\">import { defineLauncherWidget, useActiveNoteContext } from \"trilium:preact\";\n\nexport default defineLauncherWidget({\n render: () =&gt; {\n const { note } = useActiveNoteContext();\n return &lt;div style={{\n display: \"flex\",\n height: \"53px\",\n width: \"fit-content\",\n fontSize: \"0.75em\",\n alignItems: \"center\",\n flexShrink: 0 \n }}&gt;{note?.title}&lt;/div&gt;;\n }\n});</code></pre></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-javascript\"></span>&nbsp;Legacy</p><div class=\"trilium-tab-panel\"><pre><code class=\"language-text-javascript\">const TPL = `\\\n&lt;div style=\"\n display: flex;\n height: 53px;\n width: fit-content;\n font-size: 0.75em;\n contain: none;\n align-items: center;\n flex-shrink: 0;\n padding: 0 1em;\n\"&gt;&lt;/div&gt;`;\n\nclass NoteTitleWidget extends api.NoteContextAwareWidget {\n doRender() {\n this.$widget = $(TPL);\n }\n\n async refreshWithNote(note) {\n this.$widget.text(note.title);\n }\n}\n\nmodule.exports = new NoteTitleWidget();</code></pre></div></section></div>",
+ "_help_gcI7RPbaNSh3": "<figure class=\"image\"><img style=\"aspect-ratio:1007/94;\" src=\"{{helpAssets}}/User%20Guide/Scripting/Frontend%20Basics/Launch%20Bar%20Widgets/Analog%20Watch_image.png\" width=\"1007\" height=\"94\"></figure><p>This is a more intricate example of a basic widget, which displays an analog watch in the launch bar. Unlike note-context aware widgets, basic widgets don't react to note navigation.</p><pre><code class=\"language-text-javascript\">const TPL = `\n&lt;div class=\"analog-watch\" style=\"\n position: relative;\n height: 38px;\n width: 38px;\n border-radius: 50%;\n background: white;\n border: 2px solid #444;\n flex-shrink: 0;\n\"&gt;\n &lt;!-- hour hand --&gt;\n &lt;div class=\"hand hour\" style=\"\n position: absolute;\n left: 50%;\n top: 50%;\n width: 3px;\n height: 10px;\n background: #333;\n transform-origin: bottom center;\n \"&gt;&lt;/div&gt;\n\n &lt;!-- minute hand --&gt;\n &lt;div class=\"hand minute\" style=\"\n position: absolute;\n left: 50%;\n top: 50%;\n width: 2px;\n height: 13px;\n background: #111;\n transform-origin: bottom center;\n \"&gt;&lt;/div&gt;\n\n &lt;!-- second hand --&gt;\n &lt;div class=\"hand second\" style=\"\n position: absolute;\n left: 50%;\n top: 50%;\n width: 1px;\n height: 15px;\n background: red;\n transform-origin: bottom center;\n \"&gt;&lt;/div&gt;\n&lt;/div&gt;\n`;\n\nclass AnalogWatchWidget extends api.BasicWidget {\n doRender() { \n this.$widget = $(TPL);\n\n const hourHand = this.$widget.find('.hand.hour')[0];\n const minuteHand = this.$widget.find('.hand.minute')[0];\n const secondHand = this.$widget.find('.hand.second')[0];\n\n const update = () =&gt; {\n const now = new Date();\n const sec = now.getSeconds();\n const min = now.getMinutes();\n const hour = now.getHours();\n\n const secDeg = sec * 6;\n const minDeg = min * 6 + sec * 0.1;\n const hourDeg = (hour % 12) * 30 + min * 0.5;\n\n secondHand.style.transform = `translate(-50%, -100%) rotate(${secDeg}deg)`;\n minuteHand.style.transform = `translate(-50%, -100%) rotate(${minDeg}deg)`;\n hourHand.style.transform = `translate(-50%, -100%) rotate(${hourDeg}deg)`;\n };\n\n update();\n this._interval = setInterval(update, 1000);\n }\n\n cleanup() {\n if (this._interval) clearInterval(this._interval);\n }\n}\n\nmodule.exports = new AnalogWatchWidget();</code></pre>",
+ "_help_KLsqhjaqh1QW": "<p>Since v0.101.0, Trilium integrates Preact for front-end scripting, including support for JSX.</p><p>Preact can be used for:</p><ul><li><a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a>, where a JSX code note is used instead of a HTML one.</li><li><a class=\"reference-link\" href=\"#root/_help_MgibgPcfeuGz\">Custom Widgets</a>, where JSX can be used to replace the old, jQuery-based mechanism.</li></ul><p>To get started, the first step is to enable JSX in the list of Code languages. Go to Options → Code Notes and check the “JSX” language. Afterwards, proceed with the documentation in either&nbsp;<a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a>&nbsp;or&nbsp;<a class=\"reference-link\" href=\"#root/_help_MgibgPcfeuGz\">Custom Widgets</a>, which will both have a section on how to use the new Preact integration.</p><aside class=\"admonition important\"><p>The documentation assumes prior knowledge with React or Preact. As a starting point, consider the <a href=\"https://www.freecodecamp.org/learn/front-end-development-libraries-v9/\">FreeCodeCamp course on Front End Development Libraries</a> or the <a href=\"https://preactjs.com/tutorial/\">Preact Tutorial</a>.</p></aside><h2>Import/exports</h2><p>When using Preact with JSX, there is a special syntax which provides ES-like imports. This <code>import</code> syntax makes way for a more intuitive that doesn't make use of global objects and paves the way for better auto-completion support that might be introduced in the future.&nbsp;</p><h3>API imports</h3><p>Instead of:</p><pre><code class=\"language-text-jsx\">api.showMessage(\"Hello\");</code></pre><p>the JSX version looks like this:</p><pre><code class=\"language-text-jsx\">import { showMessage } from \"trilium:api\";\nshowMessage(\"hello\");</code></pre><h3>Preact API imports (hooks, components)</h3><p>There's a new&nbsp;<a class=\"reference-link\" href=\"#root/_help_GLks18SNjxmC\">Script API</a>&nbsp;dedicated to Preact, which provides shared components that are also used by Trilium internally as well as hooks, for example.</p><pre><code class=\"language-text-jsx\">import { useState } from \"trilium:preact\";\nconst [ myState, setMyState ] = useState(\"Hi\");</code></pre><h3>Exporting</h3><p>JSX notes can export a component for use in&nbsp;<a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a>&nbsp;or for&nbsp;<a class=\"reference-link\" href=\"#root/_help_Bqde6BvPo05g\">Component libraries</a>: </p><pre><code class=\"language-text-jsx\">export default function() {\n return (\n &lt;&gt;\n &lt;p&gt;Hello world.&lt;/p&gt;\n &lt;/&gt;\n );\n}</code></pre><h3>Import/export are not required</h3><p>These imports are syntactic sugar meant to replace the usage for the <code>api</code> global object (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_GLks18SNjxmC\">Script API</a>).&nbsp;</p><aside class=\"admonition note\"><p>The <code>import</code> and <code>export</code> syntax work only for JSX notes. Standard/jQuery code notes still need to use the <code>api</code> global and <code>module.exports</code>.</p></aside><h2>Under the hood</h2><p>Unlike JavaScript, JSX requires pre-processing to turn it into JavaScript (just like TypeScript). To do so, Trilium uses <a href=\"https://github.com/alangpierce/sucrase\">Sucrase</a>, a JavaScript library which processes the JSX to pure JavaScript. The processing is done each time a script is run (for widgets this happens at every program startup). If you notice any performance degradation due to long compilation, consider <a href=\"#root/_help_wy8So3yZZlH9\">reporting the issue</a> to us.</p>",
+ "_help_Bqde6BvPo05g": "<p>Using the concept of&nbsp;<a class=\"reference-link\" href=\"#root/_help_hA834UaHhSNn\">Script bundles</a>, it's possible to create components that are shared for multiple widgets or&nbsp;<a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a>.</p><h2>Exporting a single component</h2><p>This is generally useful for big components.</p><p>Here's an example child hierarchy using&nbsp;<a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a>: </p><ul><li><em>My render note</em><br>Note type: Render Note<br>Link <code>~renderNote</code> to the child note (<em>Render note with subcomponents</em>)<ul><li><p><em>Render note with subcomponents</em><br>Type: JSX</p><pre><code class=\"language-text-jsx\">export default function() {\n return (\n &lt;MyComponent /&gt; \n );\n}</code></pre><ul><li><p><em>MyComponent</em><br>Type: Code / JSX</p><pre><code class=\"language-text-jsx\">export default function MyComponent() {\n return &lt;p&gt;Hi&lt;/p&gt;;\n}</code></pre></li></ul></li></ul></li></ul><h2>Multiple components per note</h2><p>To export multiple components, use the <code>export</code> keyword next to each of the function components.</p><p>Here's how a sub-note called <code>MyComponents</code> would look like:</p><pre><code class=\"language-text-jsx\">export function MyFirstComponent() {\n return &lt;p&gt;First&lt;/p&gt;;\n}\n\nexport function MySecondComponent() {\n return &lt;p&gt;Bar&lt;/p&gt;;\n}</code></pre><p>Then in its parent note:</p><pre><code class=\"language-text-jsx\">const { MyFirstComponent, MySecondComponent } = MyComponents;\n\nexport default function() {\n return (\n &lt;&gt;\n &lt;MyFirstComponent /&gt;\n &lt;MySecondComponent /&gt;\n &lt;/&gt;\n );\n}</code></pre><p>Alternatively, it's also possible to use the components directly without assigning them to a <code>const</code> first:</p><pre><code class=\"language-text-jsx\">&lt;MyComponents.MyFirstComponent /&gt;\n&lt;MyComponents.MySecondComponent /&gt;</code></pre>",
+ "_help_ykYtbM9k3a7B": "<h2>Standard Preact hooks</h2><p>All standard Preact hooks are available as an import in <code>trilium:api</code>.</p><p>For example:</p><pre><code class=\"language-text-jsx\">import { useState } from \"trilium:preact\";\nconst [ myState, setMyState ] = useState(\"Hi\");</code></pre><h2>Custom hooks</h2><p>Trilium comes with a large set of custom hooks for Preact, all of which are also available to custom widgets and&nbsp;<a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a>.</p><h3><code>useNoteContext</code></h3><p>As a replacement to&nbsp;<a class=\"reference-link\" href=\"#root/_help_GhurYZjh8e1V\">Note context aware widget</a>, Preact exposes the current note context in the <code>useNoteContext</code> hook:</p><pre><code class=\"language-text-jsx\">import { defineWidget, useNoteContext, useNoteProperty } from \"trilium:preact\";\n\nexport default defineWidget({ \n parent: \"note-detail-pane\",\n position: 10,\n render: () =&gt; {\n const { note } = useNoteContext();\n const title = useNoteProperty(note, \"title\");\n return &lt;span&gt;Current note JSX: {title}&lt;/span&gt;;\n }\n});</code></pre><p>Note that the custom widget must be inside the content area (so note detail widget) for this to work properly, especially when dealing with splits.</p><h3><code>useActiveNoteContext</code></h3><p><code>useActiveNoteContext</code> is an alternative to <code>useNoteContext</code> which works even if the widget is not within the note detail section and it automatically switches the note context as the user is navigating around between tabs and splits.</p><h3><code>useNoteProperty</code></h3><p>This hook allows “listening” for changes to a particular property of a <code>FNote</code>, such as the <code>title</code> or <code>type</code> of a note. The benefit from using the hook is that it actually reacts to changes, for example if the note title or type is changed.</p>",
+ "_help_Sg9GrCtyftZf": "<h2>Inline styles</h2><pre><code class=\"language-text-jsx\">&lt;div style={{\n display: \"flex\",\n height: \"53px\",\n width: \"fit-content\",\n fontSize: \"0.75em\",\n alignItems: \"center\",\n flexShrink: 0 \n}}&gt;/* [...] */&lt;/div&gt;</code></pre><h2>Custom CSS file</h2><p>Simply create a&nbsp;<a class=\"reference-link\" href=\"#root/_help_AlhDUqhENtH7\">Custom app-wide CSS</a>. Make sure the class names are unique enough to not intersect with other UI elements, consider adding a prefix (e.g. <code>x-mywidget-</code>).</p>",
+ "_help_RSssb9S3xgSr": "<figure class=\"image image_resized\" style=\"width:54.58%;\"><img style=\"aspect-ratio:896/712;\" src=\"{{helpAssets}}/User%20Guide/Scripting/Frontend%20Basics/Preact/Built-in%20components_image.png\" width=\"896\" height=\"712\"><figcaption>A partial screenshot from the Widget showcase example (see below).</figcaption></figure><p>Trilium comes with its own set of Preact components, some of which are also available to&nbsp;<a class=\"reference-link\" href=\"#root/_help_MgibgPcfeuGz\">Custom Widgets</a>&nbsp;and&nbsp;<a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a>.</p><p>To use these components, simply import them from <code>trilium:preact</code>:</p><pre><code class=\"language-text-jsx\">import { ActionButton, Button, LinkButton } from \"trilium:preact\";</code></pre><p>and then use them:</p><pre><code class=\"language-text-jsx\">export default function MyRenderNote() {\n const onClick = () =&gt; showMessage(\"A button was pressed\");\n \n return (\n &lt;&gt;\n &lt;h2&gt;Buttons&lt;/h2&gt;\n &lt;div style={{ display: \"flex\", gap: \"1em\", alignItems: \"center\" }}&gt;\n &lt;ActionButton icon=\"bx bx-rocket\" text=\"Action button\" onClick={onClick} /&gt;\n &lt;Button icon=\"bx bx-rocket\" text=\"Simple button\" onClick={onClick} /&gt;\n &lt;LinkButton text=\"Link button\" onClick={onClick} /&gt; \n &lt;/div&gt;\n &lt;/&gt;\n )\n}</code></pre><h2>Widget showcase</h2><aside class=\"admonition tip\"><p>Starting with v0.101.0, the widget showcase is also available in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_6tZeKvSHEUiB\">Demo Notes</a>.</p></aside><p>This is a&nbsp;<a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a>&nbsp;example with JSX that shows most of the built-in components that are accessible to custom widgets and JSX render notes.</p><p>To use it, simply:</p><ol><li>Create a render note.</li><li>Create a child code note of JSX type with the content of this file:&nbsp;<a class=\"reference-link\" href=\"#root/_help_i9B4IW7b6V6z\">Widget showcase</a></li><li>Set the <code>~renderNote</code> relation of the parent note to the child note.</li><li>Refresh the render note to see the results.</li></ol>",
+ "_help_i9B4IW7b6V6z": "import {\n ActionButton, Button, LinkButton,\n Admonition, Collapsible,\n FormCheckbox, FormDropdownList, FormFileUploadButton, FormGroup, FormRadioGroup, FormTextArea,\n FormTextBox, FormToggle, Slider, RawHtml, LoadingSpinner, Icon,\n ColorPicker,\n Dropdown, FormListItem, FormDropdownDivider, FormDropdownSubmenu,\n NoteAutocomplete, NoteLink, Modal,\n Table,\n CKEditor,\n useEffect, useState\n} from \"trilium:preact\";\nimport { showMessage } from \"trilium:api\";\n\nexport default function() {\n const [ time, setTime ] = useState();\n const lorem = \"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aliquam accumsan eu odio non gravida. Pellentesque ornare, arcu condimentum molestie dignissim, nibh turpis ultrices elit, eget elementum nunc erat at erat. Maecenas vehicula consectetur elit, nec fermentum elit venenatis eu.\";\n useEffect(() => {\n const interval = setInterval(() => setTime(new Date().toLocaleString()), 1000);\n return () => clearInterval(interval);\n }, []);\n\n return (\n <div style={{ padding: 20, display: \"flex\", flexDirection: \"column\", gap: \"1em\" }}>\n <h1>Widget showcase</h1>\n\n <Buttons />\n <Admonition type=\"note\">\n <strong>Admonition</strong><br />\n {lorem}\n </Admonition>\n\n <Collapsible title=\"Collapsible\" initiallyExpanded>\n {lorem}\n </Collapsible>\n\n <FormElements />\n <NoteElements />\n <ModalSample />\n <DropdownSample />\n <CollectionViews />\n </div>\n );\n}\n\nfunction Buttons() {\n const onClick = () => showMessage(\"A button was pressed\");\n\n return (\n <>\n <h2>Buttons</h2>\n <div style={{ display: \"flex\", gap: \"1em\", alignItems: \"center\" }}>\n <ActionButton icon=\"bx bx-rocket\" text=\"Action button\" onClick={onClick} />\n <Button icon=\"bx bx-rocket\" text=\"Simple button\" onClick={onClick} />\n <LinkButton text=\"Link button\" onClick={onClick} />\n </div>\n </>\n )\n}\n\nfunction FormElements() {\n const [ checkboxChecked, setCheckboxChecked ] = useState(false);\n const [ dropdownValue, setDropdownValue ] = useState(\"key-1\");\n const [ radioGroupValue, setRadioGroupValue ] = useState(\"key-1\");\n const [ sliderValue, setSliderValue ] = useState(50);\n const [ color, setColor ] = useState(\"#43a047\");\n\n return (\n <>\n <h2>Form elements</h2>\n <div style={{ display: \"grid\", gridTemplateColumns: \"1fr 1fr 1fr\", gap: \"1em\" }}>\n <FormGroup name=\"checkbox\" label=\"Checkbox\">\n <FormCheckbox label=\"Checkbox\" currentValue={checkboxChecked} onChange={setCheckboxChecked} />\n </FormGroup>\n <FormGroup name=\"toggle\" label=\"Toggle\">\n <FormToggle switchOnName=\"Off\" switchOffName=\"On\" currentValue={checkboxChecked} onChange={setCheckboxChecked} />\n </FormGroup>\n <FormGroup name=\"dropdown\" label=\"Dropdown\">\n <FormDropdownList\n values={[\n { key: \"key-1\", name: \"First item\" },\n { key: \"key-2\", name: \"Second item\" },\n { key: \"key-3\", name: \"Third item\" },\n ]}\n currentValue={dropdownValue} onChange={setDropdownValue}\n keyProperty=\"key\" titleProperty=\"name\"\n />\n </FormGroup>\n <FormGroup name=\"radio-group\" label=\"Radio group\">\n <FormRadioGroup\n values={[\n { value: \"key-1\", label: \"First item\" },\n { value: \"key-2\", label: \"Second item\" },\n { value: \"key-3\", label: \"Third item\" },\n ]}\n currentValue={radioGroupValue} onChange={setRadioGroupValue}\n />\n </FormGroup>\n <FormGroup name=\"text-box\" label=\"Text box\">\n <FormTextBox\n placeholder=\"Type something...\"\n currentValue=\"\" onChange={(newValue) => {}}\n />\n </FormGroup>\n <FormGroup name=\"text-area\" label=\"Text area\">\n <FormTextArea\n placeholder=\"Type something bigger...\"\n currentValue=\"\" onChange={(newValue) => {}}\n />\n </FormGroup>\n <FormGroup name=\"color-picker\" label=\"Color picker\">\n <ColorPicker currentValue={color} onChange={setColor} />\n </FormGroup>\n <FormGroup name=\"slider\" label=\"Slider\">\n <Slider\n min={1} max={100}\n value={sliderValue} onChange={setSliderValue}\n />\n </FormGroup>\n <FormGroup name=\"file-upload\" label=\"File upload\">\n <FormFileUploadButton\n text=\"Upload\"\n onChange={(files) => {\n const file = files?.[0];\n if (!file) return;\n showMessage(`Got file \"${file.name}\" of size ${file.size} B and type ${file.type}.`);\n }}\n />\n </FormGroup>\n <FormGroup name=\"icon\" label=\"Icon\">\n <Icon icon=\"bx bx-smile\" />\n </FormGroup>\n <FormGroup name=\"loading-spinner\" label=\"Loading spinner\">\n <LoadingSpinner />\n </FormGroup>\n <FormGroup name=\"raw-html\" label=\"Raw HTML\">\n <RawHtml html=\"<strong>Hi</strong> <em>there</em>\" />\n </FormGroup>\n </div>\n </>\n )\n}\n\nfunction NoteElements() {\n const [ noteId, setNoteId ] = useState(\"\");\n\n return (\n <div>\n <h2>Note elements</h2>\n\n <FormGroup name=\"note-autocomplete\" label=\"Note autocomplete\">\n <NoteAutocomplete\n placeholder=\"Select a note\"\n noteId={noteId} noteIdChanged={setNoteId}\n />\n </FormGroup>\n\n <FormGroup name=\"note-link\" label=\"Note link\">\n {noteId\n ? <NoteLink notePath={noteId} showNoteIcon />\n : <span>Select a note first</span>}\n </FormGroup>\n </div>\n );\n}\n\nfunction ModalSample() {\n const [ shown, setShown ] = useState(false);\n\n return (\n <>\n <h2>Modal</h2>\n <Button text=\"Open modal\" onClick={() => setShown(true)} />\n <Modal title=\"Modal title\" size=\"md\" show={shown} onHidden={() => setShown(false)}>\n Modal goes here.\n </Modal>\n </>\n )\n}\n\nfunction DropdownSample() {\n return (\n <>\n <h2>Dropdown menu</h2>\n <Dropdown text=\"Dropdown\" hideToggleArrow>\n <FormListItem icon=\"bx bx-cut\">Cut</FormListItem>\n <FormListItem icon=\"bx bx-copy\">Copy</FormListItem>\n <FormListItem icon=\"bx bx-paste\">Paste</FormListItem>\n <FormDropdownDivider />\n <FormDropdownSubmenu title=\"Submenu\">\n <FormListItem>More items</FormListItem>\n </FormDropdownSubmenu>\n </Dropdown>\n </>\n )\n}\n\nfunction CollectionViews() {\n return (\n <>\n <h2>Collection views</h2>\n <p>\n A generic <code>Table</code> (Tabulator) is available. A <code>Calendar</code>\n {\" \"}(FullCalendar) component is also exposed, but it requires you to pass a\n {\" \"}<code>plugins</code> array to render a view, so it is not demonstrated here.\n </p>\n <Table\n layout=\"fitColumns\"\n columns={[\n { title: \"Name\", field: \"name\" },\n { title: \"Progress\", field: \"progress\" }\n ]}\n data={[\n { id: 1, name: \"First task\", progress: \"80%\" },\n { id: 2, name: \"Second task\", progress: \"20%\" }\n ]}\n />\n </>\n )\n}\n",
+ "_help_irkwjdNtjcxR": "<p>Front-end scripts can be run automatically on certain triggering conditions.</p><p>To do so, set the <code>run</code> <a href=\"#root/_help_HI6GBBIduIgv\">label</a> to either:</p><ul><li><code>frontendStartup</code> - when Trilium frontend starts up (or is refreshed), but not on mobile.</li><li><code>mobileStartup</code> - when Trilium frontend starts up (or is refreshed), on mobile.</li></ul><aside class=\"admonition note\"><p>One script can be triggered on multiple events, this can be done by adding multiple <code>run</code> labels. Separating multiple values by commas <strong>is not</strong> supported.</p></aside><p>Backend scripts have more powerful triggering conditions, for example they can run automatically on a hourly or daily basis, but also on events such as when a note is created or an attribute is modified. See the server-side&nbsp;<a class=\"reference-link\" href=\"#root/_help_GPERMystNGTB\">Events</a>&nbsp;for more information.</p><h2>Safe mode</h2><p>While <a href=\"#root/_help_64ZTlUPgEPtW\">safe mode</a> is active, scripts with events won't trigger.</p>",
+ "_help_SPirpZypehBG": "<p>Unlike <a href=\"#root/_help_yIhgI5H7A2Sm\">front-end scripts</a> which run on the client / browser-side, back-end scripts run directly on the Node.js environment of the Trilium server.</p><p>Back-end scripts can be used both on a&nbsp;<a class=\"reference-link\" href=\"#root/_help_WOcw2SLH6tbX\">Server Installation</a>&nbsp;(where it will run on the device the server is running on), or on the&nbsp;<a class=\"reference-link\" href=\"#root/_help_poXkQfguuA0U\">Desktop Installation</a>&nbsp;(where it will run on the PC).</p><aside class=\"admonition important\"><p>Starting with v0.104.0, backend scripts are disabled by default to reduce the attack surface. See&nbsp;<a class=\"reference-link\" href=\"#root/_help_fiHicjpHjIRJ\">Security</a>&nbsp;for more information.</p></aside><h2>Advantages of backend scripts</h2><p>The benefit of backend scripts is that they can be pretty powerful, for example to have access to the underlying system, for example it can read files or execute processes.</p><p>However, the main benefit of backend scripts is that they have easier access to the notes since the information about them is already loaded in memory. Whereas on the client, notes have to be manually loaded first.</p><h2>Creating a backend script</h2><p>Create a new&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;note and select the language <em>JavaScript (Trilium backend)</em>, or choose <em>Insert child note</em> → <em>Code</em> → <em>Backend script</em> in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_YtSN43OrfzaA\">Note tree contextual menu</a>, which does both in one step.</p><h2>Running backend scripts</h2><p>Backend scripts can be either run manually (via the Execute button on the script page), or they can be triggered on certain events.</p><p>When a script run manually or from a launcher throws an error, Trilium shows a <em>Scripting error</em> notification with the error message and a link to the note that failed. If the error comes from a child note the script requires, the link points to that child note. Changes the script made to notes before the error are rolled back.</p><p>In addition, scripts can be run automatically when the server starts up, on a fixed time interval or when a certain event occurs (such as an attribute being modified). For more information, see the dedicated&nbsp;<a class=\"reference-link\" href=\"#root/_help_GPERMystNGTB\">Events</a>&nbsp;page.</p><h2>Script API</h2><p>Trilium exposes a set of APIs that can be directly consumed by scripts, under the <code>api</code> object. For a reference of this API, see&nbsp;<a class=\"reference-link\" href=\"{{helpAssets}}/User%20Guide/Scripting/Script%20API/Backend%20API.dat\">Backend API</a>.</p>",
+ "_help_fZ2IGYFXjkEy": "<p>Older versions of Trilium Notes allowed the use of Common.js module imports inside backend scripts, such as:</p><pre><code class=\"language-text-x-trilium-auto\">const isBetween = require('dayjs/plugin/isBetween')\napi.dayjs.extend(isBetween)</code></pre><p>For newer versions, Node.js imports are <strong>not officially supported anymore</strong>, since we've added a bundler which makes it more difficult to reuse dependencies.</p><p>Theoretically it's still possible to use imports by manually setting up a <code>node_modules</code> in the server directory via <code>npm</code> or <code>pnpm</code>.</p>",
+ "_help_GPERMystNGTB": "<p><a href=\"#root/_help_CdNpE2pqjmI6\">Script</a> notes can be triggered by events. Note that these are backend events and thus relation need to point to the \"JavaScript (Trilium backend)\" code note.</p><h2>Global events</h2><p>Global events are attached to the script note via label. Simply create a <code>run</code> label with some of these values and script note will be executed once the event occurs.</p><figure class=\"table\"><table><thead><tr><th>Label</th><th>Description</th></tr></thead><tbody><tr><td><code>run</code></td><td><p>Defines on which events script should run. Possible values are:</p><ul><li><code>backendStartup</code> - when Trilium backend starts up</li><li><code>hourly</code> - run once an hour. You can use additional label <code>runAtHour</code> to specify at which hour, on the back-end.</li><li><code>daily</code> - run once a day, on the back-end</li></ul></td></tr><tr><td><code>runOnInstance</code></td><td>Specifies that the script should only run on a particular&nbsp;<a class=\"reference-link\" href=\"#root/_help_c5xB8m4g2IY6\">Trilium instance</a>.</td></tr><tr><td><code>runAtHour</code></td><td>On which hour should this run. Should be used together with <code>#run=hourly</code>. Can be defined multiple times for more runs during the day.</td></tr></tbody></table></figure><p>Frontend scripts also have similar&nbsp;<a class=\"reference-link\" href=\"#root/_help_irkwjdNtjcxR\">Events</a>, such as when the application starts.</p><aside class=\"admonition note\"><p>One script can be triggered on multiple events, this can be done by adding multiple <code>run</code> labels. Separating multiple values by commas <strong>is not</strong> supported.</p></aside><h2>Entity events</h2><p>Other events are bound to some entity, these are defined as <a href=\"#root/_help_zEY4DaJG4YT5\">relations</a> - meaning that script is triggered only if note has this script attached to it through relations (or it can inherit it).</p><figure class=\"table\"><table><thead><tr><th>Relation</th><th>Trigger condition</th><th>Origin entity (see below)</th></tr></thead><tbody><tr><td><code>runOnNoteCreation</code></td><td>executes when note is created on backend. Use this relation if you want to run the script for all notes created under a specific subtree. In that case, create it on the subtree root note and make it inheritable. A new note created within the subtree (any depth) will trigger the script.</td><td>The <code>BNote</code> that got created.</td></tr><tr><td><code>runOnChildNoteCreation</code></td><td>executes when new note is created under the note where this relation is defined</td><td>The <code>BNote</code> of the child that got created.</td></tr><tr><td><code>runOnNoteTitleChange</code></td><td>executes when note title is changed (includes note creation as well)</td><td>The <code>BNote</code> of the note whose title got changed.</td></tr><tr><td><code>runOnNoteContentChange</code></td><td>executes when note content is changed (includes note creation as well).</td><td>The <code>BNote</code> of the note whose content got changed.</td></tr><tr><td><code>runOnNoteChange</code></td><td>executes when note is changed (includes note creation as well). Does not include content changes</td><td>The <code>BNote</code> of the note that got changed.</td></tr><tr><td><code>runOnNoteDeletion</code></td><td>executes when note is being deleted</td><td>The <code>BNote</code> of the note that got (soft) deleted.</td></tr><tr><td><code>runOnBranchCreation</code></td><td>executes when a branch is created. Branch is a link between parent note and child note and is created e.g. when cloning or moving note.</td><td>The <code>BBranch</code> that got created.</td></tr><tr><td><code>runOnBranchChange</code></td><td>executes when a branch is updated. (since v0.62)</td><td>The <code>BBranch</code> that got changed.</td></tr><tr><td><code>runOnBranchDeletion</code></td><td>executes when a branch is deleted. Branch is a link between parent note and child note and is deleted e.g. when moving note (old branch/link is deleted).</td><td>The <code>BBranch</code> that got (soft) deleted.</td></tr><tr><td><code>runOnAttributeCreation</code></td><td>executes when new attribute is created for the note which defines this relation</td><td>The <code>BAttribute</code> that got created.</td></tr><tr><td><code>runOnAttributeChange</code></td><td>executes when the attribute is changed of a note which defines this relation. This is triggered also when the attribute is deleted</td><td>The <code>BAttribute</code> that got changed.</td></tr></tbody></table></figure><h2>Origin entity</h2><p>When a script is run by an event such as the ones described above, <code>api.originEntity</code> will get populated with the note, branch or attribute that triggered the change.</p><p>For example, here's a script with <code>~runOnAttributeChange</code> which automatically changes the color of a note based on the value of the <code>mycategory</code> label:</p><pre><code class=\"language-text-javascript\">const attr = api.originEntity;\nif (attr.name !== \"mycategory\") return;\nconst note = api.getNote(attr.noteId);\nif (attr.value === \"Health\") {\n note.setLabel(\"color\", \"green\");\n} else {\n note.removeLabel(\"color\");\n}</code></pre><h2>Safe mode</h2><p>While <a href=\"#root/_help_64ZTlUPgEPtW\">safe mode</a> is active, scripts with events won't trigger.</p>",
+ "_help_hA834UaHhSNn": "<p>For both&nbsp;<a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a>&nbsp;and more complicated scripts, it's generally useful to split the code into multiple&nbsp;<a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>&nbsp;notes.</p><p>When a script is run, the sub-children of the script being run (or the&nbsp;<a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a>) are checked for children. If the children are Code notes of the corresponding type (front-end or backend) as the code being run, they will be evaluated as well.</p><p>The collection of a script and its child notes is called a <em>bundle</em>. A child note inside a bundle is called a <em>module</em>.</p><p>As a basic example of dependencies, consider the following note structure:</p><ul><li><p><em>Script with dependency</em></p><pre><code class=\"language-text-javascript\">api.log(MyMath.sum(2, 2));</code></pre><ul><li><p><em>MyMath</em></p><pre><code class=\"language-text-javascript\">module.exports = {\n sum(a, b) {\n return a + b;\n }\n};</code></pre></li></ul></li></ul><p>When <em>Script with dependency</em> is run, it will detect <em>MyMath</em> as a submodule and provide the result of its <code>module.exports</code> object into a global object with the same name as the note.</p><aside class=\"admonition note\"><p>If the note contains spaces or special characters, they will be stripped. For example <code>My Nice Note!</code> becomes <code>MyNiceNote</code>.</p></aside><h2>Alternative syntax</h2><p>Instead of providing an object to <code>module.exports</code>, it's also possible to add fields individually:</p><pre><code class=\"language-text-javascript\">module.exports.sum = (a, b) =&gt; a + b;\nmodule.exports.subtract = (a, b) =&gt; a - b;</code></pre><h2>Ignoring a code script from a bundle</h2><p>To ignore a script from being included in a bundle (e.g. if it's unrelated to the parent script note), apply the <code>#disableInclusion</code> label.</p><h2>Sharing a module across multiple bundles</h2><p>Modules can be reused across multiple scripts by simply cloning the shared module between two modules (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_IakOLONlIfGI\">Cloning Notes</a>).</p><p>Optionally, a separate note can be used to contain all the different reusable modules for an easy way to discover them.</p>",
+ "_help_GLks18SNjxmC": "<p>For <a href=\"#root/_help_CdNpE2pqjmI6\">script code notes</a>, Trilium offers an API that gives them access to various features of the application.</p><p>There are two APIs:</p><ul><li>One for the front-end scripts:&nbsp;<a class=\"reference-link\" href=\"#root/_help_Q2z6av6JZVWm\">Frontend API</a></li><li>One for the back-end scripts:&nbsp;<a class=\"reference-link\" href=\"{{helpAssets}}/User%20Guide/Scripting/Script%20API/Backend%20API.dat\">Backend API</a></li></ul><p>In both cases, the API resides in a global variable, <code>api</code>, that can be used anywhere in the script.</p><p>For example, to display a message to the user the following front-end script can be used:</p><pre><code class=\"language-text-x-trilium-auto\">api.showMessage(\"Hello world.\");</code></pre><aside class=\"admonition note\"><p><strong>Note</strong><br>The Script API is currently experimental and may undergo changes in future updates.</p></aside>",
+ "_help_ApVHZ8JY5ofC": "<p>Day.js is a date manipulation library that's used by Trilium, but it's also shared with both front-end and back-end scripts. For more information about the library itself, consult the <a href=\"https://day.js.org/en/\">official documentation</a>.</p><h2>How to use</h2><p>The <code>dayjs</code> method is provided directly in the <code>api</code> global:</p><pre><code class=\"language-text-javascript\">const date = api.dayjs();\napi.log(date.format(\"YYYY-MM-DD\"));</code></pre><h2>Plugins</h2><p>Day.js uses a modular, plugin-based architecture. Generally these plugins must be imported, but this process doesn't work inside Trilium scripts due to the use of a bundler.</p><p>Since v0.100.0, the same set of plugins is available for both front-end and back-end scripts.</p><p>The following Day.js plugins are directly integrated into Trilium:</p><ul><li><a href=\"https://day.js.org/docs/en/plugin/advanced-format\">AdvancedFormat</a></li><li><a href=\"https://day.js.org/docs/en/plugin/duration\">Duration</a>, since v0.100.0.</li><li><a href=\"https://day.js.org/docs/en/plugin/is-between\">IsBetween</a></li><li><a href=\"https://day.js.org/docs/en/plugin/iso-week\">IsoWeek</a></li><li><a href=\"https://day.js.org/docs/en/plugin/is-same-or-after\">IsSameOrAfter</a></li><li><a href=\"https://day.js.org/docs/en/plugin/is-same-or-before\">IsSameOrBefore</a></li><li><a href=\"https://day.js.org/docs/en/plugin/quarter-of-year\">QuarterOfYear</a></li><li><a href=\"https://day.js.org/docs/en/plugin/utc\">UTC</a></li></ul><aside class=\"admonition note\"><p>If another Day.js plugin might be needed for scripting purposes, feel free to open a feature request for it. Depending on the size of the plugin and the potential use of it inside the Trilium code base, it has a chance of being integrated.</p></aside>",
+ "_help_vElnKeDNPSVl": "<p>Both front-end and back-end notes can log messages for debugging.</p><h2>UI logging via <code>api.log</code></h2><figure class=\"image image-style-align-center image_resized\" style=\"width:57.74%;\"><img style=\"aspect-ratio:749/545;\" src=\"{{helpAssets}}/User%20Guide/Scripting/Logging_image.png\" width=\"749\" height=\"545\"></figure><p>The API log feature integrates with the script editor and it displays all the messages logged via <code>api.log</code>. This works for both back-end and front-end scripts.</p><p>The API log panel will appear at the bottom of a note (including in&nbsp;<a class=\"reference-link\" href=\"#root/_help_ZjLYv08Rp3qC\">Quick edit</a>) after executing a script that uses <code>api.log</code>. It can be dismissed temporarily by pressing the close button in the top-right of the panel.</p><p>Apart from strings, an object can be passed as well in which case it will be pretty-formatted if possible (e.g. recursive objects are not supported).</p><h2>Console logging</h2><p>For logs that are not directly visible to the user, the standard <code>console.log</code> can be used as well.</p><ul><li>For front-end scripts, the log will be shown in the Developer Tools (also known as Inspect).</li><li>For back-end scripts, the log will be shown in the server output while running but <strong>will not</strong> be visible in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_bnyigUA2UK7s\">Backend (server) logs</a>.</li></ul>",
+ "_help_IjZS7iK5EXtb": "<p>The <em>New layout</em> is a series of UI/UX changes that were introduced in v0.101.0 that heavily change both existing UI elements, as well as adding some new ones. The goal of this new layout is to modernize the application and to make it more intuitive but at the same time to reduce clutter.</p><p>Starting with v0.107.0, the old layout has been <strong>completely removed</strong>. This page serves as migration instructions to better understand what changed.</p><h2>Newly introduced features</h2><ul><li>At the bottom of the window there is a new bar called the&nbsp;<a class=\"reference-link\" href=\"#root/_help_AlJ73vBCjWDw\">Status bar</a>. This bar houses multiple items such as the Breadcrumb navigation and information and settings about the current note, such as the <a href=\"#root/_help_veGu4faJErEM\">content language</a> and&nbsp;<a class=\"reference-link\" href=\"#root/_help_zEY4DaJG4YT5\">Attributes</a>.</li><li>When a new&nbsp;<a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>&nbsp;note is created empty, a&nbsp;<a class=\"reference-link\" href=\"#root/_help_m3VlURMSeOrd\">New note type switcher</a>&nbsp;appears under the title making it easy to switch to a different note type, template or collection.</li><li><a class=\"reference-link\" href=\"#root/_help_B5dihXRDksTk\">Note badges</a>&nbsp;appear at the right of the note title and indicate states such as read-only, shared notes as well as corresponding actions (temporarily marking a note as editable, viewing the sharing note, etc.). These replace some of the floating buttons.</li><li><a class=\"reference-link\" href=\"#root/_hidden/_options/_optionsTextNotes\">Text Notes</a>&nbsp;have a new&nbsp;inline title&nbsp;which has a bigger text and display the creation and modification dates which collapses back to a smaller title when scrolling.</li><li>The following sections have been made collapsible and get displayed under the <a href=\"#root/_help_l7pigIGu01K2\">note title</a>:<ul><li><a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a><ul><li>The keyboard shortcut previously used to trigger the promoted attributes ribbon tab (which was no longer working) has been repurposed to toggle the promoted attributes instead.</li></ul></li><li><em>Edited Notes</em> (now renamed to <em>Notes edited on this day</em>), which appears for&nbsp;<a class=\"reference-link\" href=\"#root/_help_l0tKav7yLHGF\">Day Notes</a>&nbsp;is now shown underneath the title.<ul><li>Whether the section is collapsed or not depends on the choice in&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ Appearance.</li></ul></li><li><em>Search Properties</em>, which appears for the full&nbsp;<a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>&nbsp;and&nbsp;<a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a>.</li></ul></li><li><a class=\"reference-link\" href=\"#root/_help_Bsm4fyzPJkSc\">Save status indicator</a>&nbsp;which appears in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_B5dihXRDksTk\">Note badges</a>&nbsp;area&nbsp;and indicates when there are unsaved changes.</li></ul><h2>Changing to the existing layout</h2><h3>Removal of the ribbon</h3><p>The most significant change is the removal of the ribbon. All the actions and options from the ribbon were integrated in other places in the application.</p><p>Here's how all the different tabs that were once part of the ribbon are available in the new layout:</p><ul><li>“Formatting toolbar” was relocated to the top of the page.<ul><li>Instead of having one per split, now there is a single formatting toolbar per tab. This allows more space for the toolbar items.</li></ul></li><li>“Owned attributes” and “Inherited attributes” were merged and moved to the status bar region (displayed one above the other).</li><li>“Basic Properties” were integrated in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>&nbsp;menu.<ul><li>The only exception here is the Language combo box which can now be found in the status bar (top-right of the screen).</li></ul></li><li>“File” and “Image” tabs<ul><li>The buttons were moved to the right of the note title, as dedicated entries in&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>.</li><li>The info section has been merged into the <em>Note info</em> section of the status bar.</li></ul></li><li>Edited notes<ul><li>Moved underneath the title, displayed under a collapsible area and the notes are represented as badges/chips.</li><li>Whether the section is expanded or collapsed depends on the <em>Expand “Notes edited on this day” on day notes</em> setting from Options → Appearance → <em>User Interface</em>.</li></ul></li><li>Search definition tab<ul><li>Moved underneath the title under a collapsible area.</li><li>Expanded by default for new searches, collapsed for saved searches.</li></ul></li><li>The Note map is now in the <span class=\"tn-icon bx bx-dots-horizontal-rounded\"></span> Note actions menu.<ul><li>Instead of opening into a panel in the ribbon, the note map now opens in the sidebar, in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_KRlZFoIH0j6p\">Connections tab</a>&nbsp;where it can also be maximized.</li></ul></li><li>“Note info” tab was moved to a small <span class=\"tn-icon bx bx-info-circle\"></span> icon in the status bar.</li><li>“Similar notes” tab<ul><li>Instead of opening into a panel in the ribbon, the similar notes are now shown in the sidebar, in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_KRlZFoIH0j6p\">Connections tab</a>.</li><li><code>similarNotesWidgetDisabled</code> no longer has any effect.</li></ul></li><li>The Collection properties tab were relocated under the note title and grouped into:<ul><li>A combo box to quickly switch between views.</li><li>Individual settings for the current view in a submenu.</li></ul></li><li>Some smaller ribbon tabs were converted to badges that appear near the note title in the breadcrumb section:<ul><li>Original URL indicator for clipped web pages (<code>#pageUrl</code>).</li><li>SQL and script <span class=\"tn-icon bx bx-play\"></span> execute buttons.</li></ul></li></ul><aside class=\"admonition note\"><p>The ribbon keyboard shortcuts (e.g. <code>toggleRibbonTabClassicEditor</code>) have been repurposed and renamed (<em>Focus Formatting Toolbar</em>, <em>Toggle Owned Attributes</em>, <em>Show Note Map</em>, etc.) to work on the new layout, where they will toggle the appropriate panel.</p></aside><h3>Removal of the floating buttons</h3><p>Most of the buttons were relocated to the right of the note title, in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>&nbsp;area, with the exception of:</p><ul><li>The Edit button is replaced by the <span class=\"tn-icon bx bx-lock-alt\"></span> <em>Read-only</em> badge near the note title, which makes the note temporarily editable when clicked.</li><li><em>Backlinks</em> are now displayed in the sidebar, in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_KRlZFoIH0j6p\">Connections tab</a>.<ul><li>Alternatively, the backlinks count is displayed in the status bar and when clicked the sidebar opens at the right section.</li></ul></li><li>Relation map zoom buttons are now part of the relation map itself.</li><li>Export image to PNG/SVG are now in the Note actions menu, in the <em>Export as image</em> option.</li></ul><h3>Changes to the sidebar</h3><p>The sidebar (also known as the right pane) also received some important changes.</p><p>Most importantly, v0.105.0 splits the sidebar into multiple tabs with additional functionality:</p><ul><li><a class=\"reference-link\" href=\"#root/_help_2dcGDhp9WFKb\">Outline tab</a>, which gathers the table of contents and highlights lists.</li><li><a class=\"reference-link\" href=\"#root/_help_uNtgN0cUKEBc\">Attributes tab</a>, which provides a graphical method of editing labels, relations and (promoted) attribute definitions.</li><li>A dedicated&nbsp;<a class=\"reference-link\" href=\"#root/_help_LrKznOtw9cQD\">AI chat tab</a>.</li><li><a class=\"reference-link\" href=\"#root/_help_KRlZFoIH0j6p\">Connections tab</a>, which groups together the note map, note paths, backlinks and similar notes.</li></ul><p>The previous iteration of the sidebar would appear contextually, depending on whether there are any items to be displayed. This caused occasional content shifts when moving between two panes in a split view. In the new layout, the sidebar acts more like the&nbsp;<a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>&nbsp;pane, remaining visible even if there is nothing to display.</p><p>As such:</p><ul><li>The <em>Table of Contents</em> card in Text Notes options (minimum number of headings) is gone. The &nbsp;shows the table of contents whatever the number of headings.</li><li><code>#toc</code> / <code>#toc=show</code> / <code>#toc=hide</code> no longer have any effect.</li><li><code>#hideHighlightWidget</code> no longer has any effect. The highlight categories are still set globally, from the <span class=\"tn-icon bx bx-cog\"></span> menu of the Highlights list or Text Notes options, but they can't be hidden for a single note.</li></ul><p>In order to toggle the sidebar, there is a new <span class=\"tn-icon bx bx-sidebar bx-flip-horizontal\"></span> button on the top-right side of the screen, near the window buttons (on Windows and Linux).</p><p>Now each section of the sidebar (e.g. “Table of Contents”, “Highlights list”) is individually collapsible and will remember whether it was collapsed.</p><p>Some sidebar items also have their own menu in the title. For example, the highlights filter can be adjusted directly from the <span class=\"tn-icon bx bx-cog\"></span> menu of the Highlights list.&nbsp;</p><p>Custom widgets are still supported. For custom scripts, the <span class=\"tn-icon bx bx-dots-vertical-rounded\"></span> menu allows quick navigation to the corresponding script note.</p>",
+ "_help_kTx7WqLdZ3Ry": "<p>The <code>api.cheerio</code> library has been removed from the backend scripting API.</p><p>Scripts that attempt to use <code>api.cheerio</code> will now throw an error with migration instructions.</p><h2>Reasoning</h2><p><code>cheerio</code> was deprecated in v0.103.0 in favor of <code>api.htmlParser</code> (<a href=\"https://github.com/taoqf/node-fast-html-parser\">node-html-parser</a>), which Trilium already uses for all of its own HTML parsing. The scripting API was the only place that still needed <code>cheerio</code>.</p><p>Shipping both parsers was costly, because <code>cheerio</code> was loaded at startup on every platform. It added roughly 1.35 MB of bundled code to the server and desktop builds, and roughly 370 kB to the in-browser build, where it was loaded into the database worker before the application could start.</p><h2>Migration</h2><p>Replace <code>api.cheerio</code> calls with <code>api.htmlParser</code>. Note that <code>api.htmlParser</code> returns plain elements rather than a wrapped collection, so there is no <code>$</code> object and no chaining.</p><h3>Reading values</h3><p>Before (<code>cheerio</code>):</p><pre><code class=\"language-text-javascript\">const $ = api.cheerio.load(html);\nconst title = $('h1').text();\nconst links = $('a').map((i, el) =&gt; $(el).attr('href')).get();</code></pre><p>After (<code>htmlParser</code>):</p><pre><code class=\"language-text-javascript\">const root = api.htmlParser.parse(html);\nconst title = root.querySelector('h1')?.textContent;\nconst links = root.querySelectorAll('a').map(a =&gt; a.getAttribute('href'));</code></pre><h3>Modifying the document</h3><p>Before (<code>cheerio</code>):</p><pre><code class=\"language-text-javascript\">const $ = api.cheerio.load(html);\n$('a').each((i, el) =&gt; {\n $(el).attr('href', '#root/' + noteId);\n $(el).addClass('reference-link');\n});\nnote.setContent($('body').html());</code></pre><p>After (<code>htmlParser</code>):</p><pre><code class=\"language-text-javascript\">const root = api.htmlParser.parse(html);\nfor (const el of root.querySelectorAll('a')) {\n el.setAttribute('href', '#root/' + noteId);\n el.classList.add('reference-link');\n}\nnote.setContent(root.toString());</code></pre><h3>Equivalent operations</h3><figure class=\"table\"><table><thead><tr><th><code>cheerio</code></th><th><code>htmlParser</code></th></tr></thead><tbody><tr><td><code>api.cheerio.load(html)</code></td><td><code>api.htmlParser.parse(html)</code></td></tr><tr><td><code>$('sel')</code></td><td><code>root.querySelectorAll('sel')</code></td></tr><tr><td><code>$('sel').first()</code></td><td><code>root.querySelector('sel')</code></td></tr><tr><td><code>$el.text()</code></td><td><code>el.textContent</code></td></tr><tr><td><code>$el.html()</code></td><td><code>el.innerHTML</code></td></tr><tr><td><code>$el.attr('name')</code></td><td><code>el.getAttribute('name')</code></td></tr><tr><td><code>$el.attr('name', value)</code></td><td><code>el.setAttribute('name', value)</code></td></tr><tr><td><code>$el.addClass('name')</code></td><td><code>el.classList.add('name')</code></td></tr><tr><td><code>$('body').html()</code></td><td><code>root.toString()</code></td></tr></tbody></table></figure>",
+ "_help_YeOa2l7Pu39I": "<h2>Introduction</h2><p>Before v0.104.0, code executed at renderer level (e.g. front-end scripts) could directly require <code>@electron/remote</code> or even Node.js APIs (e.g. <code>process</code> or <code>fs</code>). While this makes them powerful, it also exposes a significant attack surface — any XSS or untrusted script in a note becomes remote code execution on the host.</p><p>To mitigate this, the client-side no longer has access to these APIs and everything must go through the&nbsp;<a class=\"reference-link\" href=\"{{helpAssets}}/User%20Guide/Scripting/Script%20API/Electron%20API.dat\">Electron API</a>&nbsp;instead.</p><aside class=\"admonition note\"><p>If this API change is causing issues with some of your front-end scripts, consider:</p><ul><li>Interacting with&nbsp;<a class=\"reference-link\" href=\"#root/_help_SPirpZypehBG\">Backend scripts</a>&nbsp;which have a greater degree of freedom.</li><li><a href=\"#root/_help_wy8So3yZZlH9\">Reporting</a> it as a feature request.</li></ul></aside><h2>Overview of the API</h2><p>The Frontend and Backend APIs reside in a global variable, <code>api</code>, that can be used anywhere in the script. For example, to display a message to the user the following front-end script can be used:</p><pre><code class=\"language-text-javascript\">api.showMessage(\"Hello world.\");</code></pre><p>The Electron API is different: it lives on <code>window.electronApi</code> (exposed by the desktop preload script), not on <code>api</code>, and is only available in the Electron desktop build. Frontend scripts that use it should guard with <code>if (window.electronApi)</code> so they degrade cleanly in the browser and standalone (WASM) builds.</p><pre><code class=\"language-text-javascript\">window.electronApi?.window.setZoomFactor(1.2);</code></pre><h2>Additional protection</h2><p>Some of the APIs have additional safe-guards built in which prevent unauthorized access.</p><p>The <code>shell</code> group is the most heavily validated: <code>openExternal</code> is restricted to an allowlisted set of URL schemes (blocking <code>file:</code>, <code>smb:</code>, Follina-class schemes, etc.), <code>openPath</code> must resolve under the Trilium data directory or temporary directory, and <code>downloadURL</code> is locked to the app's own origin. Invalid input throws on the main side rather than being silently passed through.</p>",
+ "_help_fqAK6opjUagR": "<p>The <code>api.axios</code> library has been removed from the backend scripting API.</p><p>Scripts that attempt to use <code>api.axios</code> will now throw an error with migration instructions.</p><h2>Reasoning</h2><p>Axios was marked as deprecated at least since April 2024 in favor of the native <code>fetch()</code> API, which is available in both browser and Node.js environments. After two years of deprecation, the library was removed following the <a href=\"https://www.malwarebytes.com/blog/news/2026/03/axios-supply-chain-attack-chops-away-at-npm-trust\">March 2026 npm supply chain compromise</a>, where attackers published malicious versions that deployed a remote access trojan. The Trilium's main developer almost got compromised, but <code>pnpm</code> not trusting unknown post-install scripts successfully avoided that.</p><h2>Migration</h2><p>Replace <code>api.axios</code> calls with the native <code>fetch()</code> API.</p><h3><code>GET</code> calls</h3><p>Before (Axios):</p><pre><code class=\"language-text-javascript\">const response = await api.axios.get('https://api.example.com/data');\nconst data = response.data;</code></pre><p>After (<code>fetch</code>):</p><pre><code class=\"language-text-javascript\">const response = await fetch('https://api.example.com/data');\nconst data = await response.json();</code></pre><h3><code>POST</code> calls</h3><p>Before (Axios):</p><pre><code class=\"language-text-javascript\">await api.axios.post('https://api.example.com/data', { key: 'value' });</code></pre><p>After (fetch):</p><pre><code class=\"language-text-javascript\">await fetch('https://api.example.com/data', {\n method: 'POST',\n headers: { 'Content-Type': 'application/json' },\n body: JSON.stringify({ key: 'value' })\n});</code></pre>",
+ "_help_pAJ0jWz16xFm": "<p>The <code>api.cheerio</code> library is deprecated and will be removed in a future version.</p><aside class=\"admonition note\"><p><code>cheerio</code> was removed in v0.106.0. See <a class=\"reference-link\" href=\"#root/_help_kTx7WqLdZ3Ry\">v0.106.0: Removal of cheerio</a> for the full migration guide.</p></aside><h2>Reasoning</h2><p>Cheerio is only used for the scripting API while the server internally uses <code>node-html-parser</code> for HTML parsing. Removing <code>cheerio</code> reduces bundle size and maintenance overhead.</p><h2>Migration</h2><p>Before (<code>cheerio</code>):</p><pre><code class=\"language-text-javascript\">const $ = api.cheerio.load(html);\nconst title = $('h1').text();\nconst links = $('a').map((i, el) =&gt; $(el).attr('href')).get();</code></pre><p>After (<code>htmlParser</code>):</p><pre><code class=\"language-text-javascript\">const root = api.htmlParser.parse(html);\nconst title = root.querySelector('h1')?.textContent;\nconst links = root.querySelectorAll('a').map(a =&gt; a.getAttribute('href'));</code></pre>",
+ "_help_72dxvnbnkDFY": "<p>jQuery 4 removes legacy browser support (such as IE11 support), but it also removes some APIs that are considered deprecated such as:</p><blockquote><p><code>jQuery.isArray</code>, <code>jQuery.parseJSON</code>, <code>jQuery.trim</code>, <code>jQuery.type</code>, <code>jQuery.now</code>, <code>jQuery.isNumeric</code>, <code>jQuery.isFunction</code>, <code>jQuery.isWindow</code>, <code>jQuery.camelCase</code>, <code>jQuery.nodeName</code>, <code>jQuery.cssNumber</code>, <code>jQuery.cssProps</code>, and <code>jQuery.fx.interval</code>.</p><p>Use native equivalents like <code>Array.isArray()</code>, <code>JSON.parse()</code>, <code>String.prototype.trim()</code>, and <code>Date.now()</code> instead.</p></blockquote><p>This may affect custom scripts if they (or the custom jQuery libraries used) depend on the deprecated APIs.</p><p>Note that Trilium polyfills <code>jQuery.isArray</code>, <code>isFunction</code> and <code>isPlainObject</code> because they were required by one of our dependencies (the autocomplete).</p><p>For more information, consult <a href=\"https://blog.jquery.com/2026/01/17/jquery-4-0-0/\">the official blog post</a>.</p>",
+ "_help_fiHicjpHjIRJ": "<p>Starting with v0.104.0, some features in Trilium are intentionally disabled in order to reduce the attack surface:</p><ul><li><a class=\"reference-link\" href=\"#root/_help_SPirpZypehBG\">Backend scripts</a>, which can run processes on the server, access the file system or bypass security measures.</li><li><a class=\"reference-link\" href=\"#root/_help_YKWqdJhzi2VY\">SQL Console</a>, which can be used to exfiltrate important data such as the document secret or cause irreparable damage to the database.</li><li><a class=\"reference-link\" href=\"#root/_help_swSFivWk6KkA\">Network Access</a>&nbsp;for the&nbsp;<a class=\"reference-link\" href=\"#root/_help_poXkQfguuA0U\">Desktop Installation</a>.</li></ul><p>To activate any of them, there are three variants:</p><ul><li>For the desktop app, go to&nbsp;<a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>&nbsp;→ <em>Security</em> and toggle the desired option.<ul><li>This will prompt a system dialog confirming the change. Note that scripts could potentially call this confirmation dialog as well, make sure to accept it only if enabling any of these features is required.</li><li>The settings page will be available for the server-side as well, but the options need to be manually toggled using the other mechanisms described here.</li><li>This works by setting a separate configuration file in the&nbsp;<a class=\"reference-link\" href=\"#root/_help_tAassRL4RSQL\">Data directory</a>.</li></ul></li><li>In <a href=\"#root/_help_Gzjqa934BdH4\">config.ini</a>, set the corresponding option under the <code>Security</code> group.</li><li>Or use environment variables (e.g. <code>TRILIUM_SECURITY_BACKEND_SCRIPTING_ENABLED=true</code>).</li></ul>",
+ "_help_WFbFXrgnDyyU": "<h3>Trilium Notes</h3><p>Trilium Notes does not collect/send any data from the user's installation, i.e. no analytics, no telemetry etc. The data flows only between user controlled / installed applications, without any intermediary.</p><p>Automatic network activity consists of:</p><ul><li>Trilium periodically queries URL <a href=\"https://github.com/TriliumNext/Trilium/releases\">https://github.com/TriliumNext/Trilium/releases</a> to see if there's a new stable version released. (check only, there's no automatic download and/or installation).</li><li>Trilium will download spelling dictionaries automatically as needed based on language settings</li></ul><h3>Trilium Web Clipper</h3><p>Trilium Web Clipper does not collect/send any data from the user's installation, i.e. no analytics, no telemetry etc. The data flows only between user controlled / installed applications, without any intermediary.</p><h3>Trilium Sender for Android</h3><p>Trilium Sender for Android does not collect/send any data from the user's installation, i.e. no analytics, no telemetry etc. The data flows only between user controlled / installed applications, without any intermediary.</p>",
+ "_help_NcsmUYZRWEW4": "<aside class=\"admonition note\"><p>This article is a description of the original author of Trilium (zadam) in regards with his own knowledge base.</p></aside><p>This page contains description of some of the patterns I use to organize information in my knowledge base. This is meant to give some inspiration of how one might create and structure their knowledge base in general and also specifically in Trilium Notes. It also gives some background and justification for some of the design decisions.</p><h2>Meta patterns</h2><p>Just to be clear, meta patterns are \"patterns of patterns\", i.e. patterns appearing in other patterns.</p><h3>Hierarchical organization of information</h3><p>Basic meta pattern is that I sort notes (units of information) into a hierarchy - I have some \"top level\" notes which represent coarse grained organization, these then split into sub-notes defining finer grained organization and so on. I consider this hierarchical (tree) organization very efficient for organization of large amounts of information. A lot of note taking software (such as Evernote) are frustratingly limited in this regard which limits scalability of the software to large amounts of notes.</p><h4>Scalability</h4><p>It's important to frame the following (meta) patterns with some idea of how large amount of data are we talking about.</p><p>My rule of thumb for estimation of size of personal knowledge base is that you can reasonably produce around 10 notes a day, which is 3650 in a year. I plan to use my knowledge base long term (with or without Trilium Notes), probably decades so you can easily get to number 100 000 or even more. Right now, my personal knowledge base has around 10 000 notes.</p><p>100 000 is a number to which most note taking software doesn't scale well (in both performance and UI). Yet I don't think it's really very much considering a lifetime of knowledge.</p><h4>Lazy hierarchy</h4><p>My approach to creating the hierarchy is being lazy - I don't create the structure first and then fill it with notes, instead I create single note for some specific topic and start using this one note. Once the content starts to grow, and I see how <em>some</em> parts could be split out, I move them out into separate sub notes. As an example I have a book review for <em>The Fellowship of the Ring</em>:</p><ul><li>Book reviews<ul><li>The Fellowship of the Ring</li></ul></li></ul><p>The note contains basic book info (author, publisher etc.), book highlights with the comments and then overall review. Now it turns out there's far too many book highlights and overall review is also rather long, so I want to change the structure to the following:</p><ul><li>Book reviews<ul><li>The Fellowship of the Ring &nbsp; &nbsp; &nbsp;&nbsp;<em>(still contains basic info)</em><ul><li>Highlights</li><li>Review</li></ul></li></ul></li></ul><p>If I used standard text file stored in a filesystem I would soon run into an annoying problem that in order to split out the Highlights and Review into sub-notes I would also have to convert <em>The Fellowship of the Ring</em> from text file into directory and split out all sections of the note into sub-notes. Instead, Trilium treats all notes as equal - both leaf notes and inner notes can have both text content which allows me to sub-structure only content which needs it.</p><h3>Sorting notes into multiple places in the hierarchy</h3><p>While organizing the notes into the hierarchy, you very quickly run into a dilemma - your note seem to belong to two places in the hierarchy equally. As an example - you want to make a note about <a href=\"https://en.wikipedia.org/wiki/Bash_(Unix_shell)\">bash</a> - does it belong to \"OS / Linux\" or \"Programming / Scripting languages\"? This is actually a false dichotomy forced down by the limits of the basic tree hierarchy - the answer is <em>of course it belongs to both</em>. This is the reason why Trilium doesn't use standard tree structure (which requires every note to have exactly one parent), but an extension which allows every note to have several parents, thus effectively allowing it to appear in multiple places in the hierarchy. For lack of better term I call this \"cloning\". The main problem with this term is that it suggests that each clone must have an original, but here all clones are completely equal - effectively there's no original.</p><p>In tech lingo, it might be better to describe it as a <a href=\"https://en.wikipedia.org/wiki/Hard_link\">hard link</a> with an important difference that it is possible to hard link (clone) a directory (inner note).</p><h3>Protected notes</h3><p>I have Trilium Notes opened non-stop. Sometimes I forget to lock my computer when going to the bathroom. Sometimes I let a friend or family member to use my computer for a minute without supervision. They might click on (running) Trilium and inadvertently see a note I really don't want anybody to see (personal diary, credentials). To cover this, Trilium has a concept of \"<a href=\"https://github.com/zadam/trilium/wiki/Protected-notes\">protected notes</a>\" - protected note is encrypted and on top of that requires the user to enter the password every 5 minutes which guarantees that such note can be in a readable state only for small amount of time. Working with ordinary (not protected) notes don't require password so you're not bothered by extra security when it's not needed.</p><h3>Archiving notes</h3><p>Notes can lose relevancy with time - let's say I switch jobs - all the notes specific to the former employer immediately lose most of its import. This doesn't mean I want to delete these notes though - typically I just want them to somehow deprioritize - in Trilium I would do that by assigning an <a href=\"https://github.com/zadam/trilium/wiki/Attribute-inheritance\">inherited</a> <a href=\"https://github.com/zadam/trilium/wiki/Attributes\">label</a> <code>archived</code> to the company root note. The main effect of this label is that all the notes from this sub-tree are filtered out from search results (fast search via note autocomplete is my main <a href=\"https://github.com/zadam/trilium/wiki/Note-navigation\">navigation approach</a>). Apart from this, I also typically move such outdated notes to some less prominent place in the hierarchy.</p><p>I use archivation also for notes which are not very relevant from their creation - an example might be automatically imported reddit comments.</p><p>Sometimes there's no clear <em>category</em> split between relevant and non-relevant notes, in that case I just create \"<em>OLD</em>\" note with <code>archived</code> label and move all irrelevant notes there. So my credentials note might look something like this:</p><ul><li>Credentials<ul><li>Personal<ul><li>OLD &nbsp; &nbsp; &nbsp;&nbsp;<em>(contains a bunch of notes with credentials for services I don't use anymore)</em></li><li>Gmail</li><li>Github</li><li>...</li></ul></li></ul></li></ul><h2>Patterns</h2><h3>Day note</h3><p>Every day has its note which contains or references everything related to the given day. Structure looks like this:</p><ul><li>2018<ul><li>11 - November<ul><li>26 - Monday</li><li>27 - Tuesday<ul><li>subnote 1</li></ul></li></ul></li></ul></li></ul><p>Day note serves as a workspace and note inbox at the same time - it's the default location to create a note when I don't have time to think about proper placement. At the end of the day I typically review my day note and clone the notes into suitable locations in the hierarchy.</p><p>Trilium has this pattern partly built-in - Trilium understands and can create this Year / Month / Day structure semi-automatically (on API call). There's also global keyboard shortcut <code>CTRL-ALT-P</code> which will create new note in the day note.</p><p>What notes do I keep under this day note?</p><ul><li>TODO list for given day (this can be automated - see&nbsp;<a class=\"reference-link\" href=\"#root/_help_xYjQUYhpbUEW\">Task Manager</a>)</li><li>Personal diary</li><li><a href=\"#root/_help_IakOLONlIfGI\">clones</a> of notes I created during this day (which kind of represents what I've been working on).</li><li>I often clone notes (or sub-trees) of e.g. projects I'm working on at given day so they are at hand</li><li>I have some <a href=\"#root/_help_CdNpE2pqjmI6\">scripts</a> which allow me to track certain daily metrics (like weight). These are saved into one daily \"data note\" (actually JSON <a href=\"#root/_help_6f9hih2hXXZk\">code note</a>).<ul><li>I have other scripts which then help me to visualize these data (see a&nbsp;<a class=\"reference-link\" href=\"#root/_help_R7abl2fc6Mxi\">Weight Tracker</a>&nbsp;example)</li><li>I have a script which automatically imports all my comments from reddit into the day note.<ul><li>People are sometimes wondering why. The answer is that I usually put some effort and thought into a comment and that's why I feel it's worth preserving, especially if it can be done automatically.</li></ul></li></ul></li></ul><p>For most notes, this day note placement is <em>secondary</em> and their primary location is somewhere else (e.g. for a book review I've been working on it's <em>Book / Reviews</em>, not the day note). So for this pattern to work, ability to <a href=\"#root/_help_IakOLONlIfGI\">clone</a> notes into multiple places is pretty fundamental.</p><h3>Projects</h3><p><em>Project</em> is pretty self-explanatory, for me specifically it also means being long term (years) - an example of a project might be Trilium Notes or university studies. Given their longevity, projects can be large and deep, but their structure is very domain specific, and I don't see any common patterns. What's pretty clear is they are often widely interconnected with other parts of the knowledge base - e.g. university credentials are cloned from \"Credentials / University\" top level notes and Trilium related blog posts are in \"Blog / [Name of the blog] / Trilium\".</p><p><em>Epics</em> are the same thing as projects, but differ in scope - they are typically several months long and as such are usually placed into a year note (e.g. <em>2018 / Epics</em>). Epics are often of work nature (also cloned into work note) and personal (e.g. currently I have large epic for moving to a different city).</p><p>I don't have a term for short term projects (typically several days long), but continuing the scrum analogy I might call them <em>story</em>. These are often placed directly into day notes and manually moved from one day to another (or place into a month note, e.g. <em>2018 / 11 - November</em>).</p><h3>Credentials</h3><p>I keep all my credentials in the knowledge base, they are sorted into categories - work related, project related, personal per country etc. These notes are of course <a href=\"#root/_help_bwg0e8ewQMak\">protected</a> and are often cloned into other places (e.g. project credentials are cloned into the project itself). This is a pretty important advantage compared to traditional tools like KeePass - all the relevant information is centralized into one place without compromising security.</p><h3>People profiles</h3><p>This might seem creepy to some, but I keep a profile on most people. It contains pretty standard things like date of birth, contacts, address, but also current and previous employments, their hobbies and worldviews and sometimes even important (IM/mail/meatspace) conversations. Just about everything I find notable. It helps to refresh some basic info before meeting people, especially if you haven't been in touch in a while. It gets pretty awkward to ask for the tenth time where do they work for example, because you keep forgetting it.</p><p>Naturally I have a lot of (extended) family members, friends, acquaintances etc. so I need some way to sort them. My main method is to sort them by social circle (work, high school, sports club etc.), sometimes also by their town of residence. Family <em>circle</em> is still too large so the further organization is by <em>clan</em> (as in \"Smiths\"). Some people are members of several such circles, so they are just cloned into multiple places.</p><p>For family specifically it's pretty useful to create a&nbsp;<a class=\"reference-link\" href=\"#root/_help_iRwzGnHPzonm\">Relation Map</a>&nbsp;to visualize relationships:</p><figure class=\"image\"><img style=\"aspect-ratio:941/758;\" src=\"{{helpAssets}}/User%20Guide/Miscellaneous/Patterns%20of%20personal%20knowledge_relation-map-family.png\" width=\"941\" height=\"758\"></figure><h3>Books</h3><p>Of course, I keep standard \"To read\" list. I also keep a record on the books I've read - typically one book has one subtree where the root has some basic info like author, page count, publication date, date started, date finished (in the form of&nbsp;<a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>). I also write a (private) review and keep list of highlights from Kindle, optionally with some commentary, these are usually stored in sub notes (unless they are pretty short).</p><p>To keep the list of books manageable, I sort them per year (of reading them), this also gives me some basic overview of \"reading performance\" for given year. I plan to create a <a href=\"#root/_help_CdNpE2pqjmI6\">script</a> which would show some timeline chart visualizing book attributes <code>dateStarted</code> - <code>dateFinished</code> to have nicer view of my reading sprints and trends.</p><p>Some specific authors also have their own note which contains cloned book reviews, links to interviews and other related resources.</p><p>I have similar system for movies and TV shows, but not as sophisticated.</p><h3>Personal diary</h3><p>This is a place to reflect on events, experiences, new findings etc. This can help you get deeper understanding of your inner self, clarify your thinking and make better decisions as a result.</p><p>I sort personal diary notes directly under <em>day note</em> (explained above), but it can be cloned also to e.g. \"trip note\" (if the diary note is about given trip) or to person's profile (if the person plays a role in the diary note). All my diary notes are <a href=\"#root/_help_bwg0e8ewQMak\">protected</a> since they are usually pretty sensitive.</p><h3>Documents</h3><p>I keep all my personal documents (ID, passport, education certificates ...) scanned in the knowledge base. They are <a href=\"#root/_help_cbkrhQjrkKrh\">synchronized</a> across every PC which provides decent backup and makes them available everywhere.</p><p>Advantage compared to e.g. keeping them in Dropbox or Google Drive is that they are not stored on some 3rd party server and they can be encrypted (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_bwg0e8ewQMak\">Protected Notes</a>).</p><h3>Inventory</h3><p>Inventory contains documents and other relevant importation for my important belongings - e.g. for car you can keep the registration card, maintenance record, related costs etc. I also keep inventory for some items personally important to me - mainly computers, phones, cameras and similar electronics. This can be practical at times but also provides sentimental value.</p><h3>Topic knowledge base</h3><p>This where I store hard \"knowledge\" - summarized topics and findings from different domains. Topics can range from traditional sciences - physics, history, economy to philosophy, mental models, apps (notes about specific apps I use) etc. Of course this is very subjective - given what I do, my Physics sub-tree is pretty sparse compared to my Programming subtree.</p><h3>Work knowledge base</h3><p>I usually keep top level note for the company I currently work at (past jobs are moved elsewhere). I track basic organization of the company (divisions, business units), who is who (<a class=\"reference-link\" href=\"#root/_help_iRwzGnHPzonm\">Relation Map</a>) are again useful for visualization), projects I work at etc.</p><p>There's a number of credentials to various company services I need to use. Companies usually have a bunch of complex processes and tools. I record meeting minutes, link to the company wiki (which is usually difficult to find relevant info). In general there's a lot of company specific information I need to know or need have them at hand in a nice structure I can understand. Often it's just copy pasting and reshuffling of existing information into something more understandable for me.</p><p>From my experience, keeping this makes me more productive and even more importantly dramatically reduces frustration and stress.</p><h2>Conclusion</h2><p>I could probably go on with more patterns (e.g. study notes, travelling), but I think you get the idea. Whatever is important in your life, it probably makes sense to document and track it.</p>",
+ "_help_d1Ap6Pg6IjaJ": "<p>GNU AFFERO GENERAL PUBLIC LICENSE<br>Version 3, 19 November 2007</p><p>Copyright (C) 2007 Free Software Foundation, Inc. <a href=\"https://fsf.org/\">https://fsf.org/</a></p><p>Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.</p><h2>Preamble</h2><p>The GNU Affero General Public License is a free, copyleft license for software and other kinds of works, specifically designed to ensure cooperation with the community in the case of network server software.</p><p>The licenses for most software and other practical works are designed to take away your freedom to share and change the works. By contrast, our General Public Licenses are intended to guarantee your freedom to share and change all versions of a program--to make sure it remains free software for all its users.</p><p>When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for them if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs, and that you know you can do these things.</p><p>Developers that use our General Public Licenses protect your rights with two steps: (1) assert copyright on the software, and (2) offer you this License which gives you legal permission to copy, distribute and/or modify the software.</p><p>A secondary benefit of defending all users' freedom is that improvements made in alternate versions of the program, if they receive widespread use, become available for other developers to incorporate. Many developers of free software are heartened and encouraged by the resulting cooperation. However, in the case of software used on network servers, this result may fail to come about. The GNU General Public License permits making a modified version and letting the public access it on a server without ever releasing its source code to the public.</p><p>The GNU Affero General Public License is designed specifically to ensure that, in such cases, the modified source code becomes available to the community. It requires the operator of a network server to provide the source code of the modified version running there to the users of that server. Therefore, public use of a modified version, on a publicly accessible server, gives the public access to the source code of the modified version.</p><p>An older license, called the Affero General Public License and published by Affero, was designed to accomplish similar goals. This is a different license, not a version of the Affero GPL, but Affero has released a new version of the Affero GPL which permits relicensing under this license.</p><p>The precise terms and conditions for copying, distribution and modification follow.</p><h2>TERMS AND CONDITIONS</h2><h3>0. Definitions.</h3><p>\"This License\" refers to version 3 of the GNU Affero General Public License.</p><p>\"Copyright\" also means copyright-like laws that apply to other kinds of works, such as semiconductor masks.</p><p>\"The Program\" refers to any copyrightable work licensed under this License. Each licensee is addressed as \"you\". \"Licensees\" and \"recipients\" may be individuals or organizations.</p><p>To \"modify\" a work means to copy from or adapt all or part of the work in a fashion requiring copyright permission, other than the making of an exact copy. The resulting work is called a \"modified version\" of the earlier work or a work \"based on\" the earlier work.</p><p>A \"covered work\" means either the unmodified Program or a work based on the Program.</p><p>To \"propagate\" a work means to do anything with it that, without permission, would make you directly or secondarily liable for infringement under applicable copyright law, except executing it on a computer or modifying a private copy. Propagation includes copying, distribution (with or without modification), making available to the public, and in some countries other activities as well.</p><p>To \"convey\" a work means any kind of propagation that enables other parties to make or receive copies. Mere interaction with a user through a computer network, with no transfer of a copy, is not conveying.</p><p>An interactive user interface displays \"Appropriate Legal Notices\" to the extent that it includes a convenient and prominently visible feature that (1) displays an appropriate copyright notice, and (2) tells the user that there is no warranty for the work (except to the extent that warranties are provided), that licensees may convey the work under this License, and how to view a copy of this License. If the interface presents a list of user commands or options, such as a menu, a prominent item in the list meets this criterion.</p><h3>1. Source Code.</h3><p>The \"source code\" for a work means the preferred form of the work for making modifications to it. \"Object code\" means any non-source form of a work.</p><p>A \"Standard Interface\" means an interface that either is an official standard defined by a recognized standards body, or, in the case of interfaces specified for a particular programming language, one that is widely used among developers working in that language.</p><p>The \"System Libraries\" of an executable work include anything, other than the work as a whole, that (a) is included in the normal form of packaging a Major Component, but which is not part of that Major Component, and (b) serves only to enable use of the work with that Major Component, or to implement a Standard Interface for which an implementation is available to the public in source code form. A \"Major Component\", in this context, means a major essential component (kernel, window system, and so on) of the specific operating system (if any) on which the executable work runs, or a compiler used to produce the work, or an object code interpreter used to run it.</p><p>The \"Corresponding Source\" for a work in object code form means all the source code needed to generate, install, and (for an executable work) run the object code and to modify the work, including scripts to control those activities. However, it does not include the work's System Libraries, or general-purpose tools or generally available free programs which are used unmodified in performing those activities but which are not part of the work. For example, Corresponding Source includes interface definition files associated with source files for the work, and the source code for shared libraries and dynamically linked subprograms that the work is specifically designed to require, such as by intimate data communication or control flow between those subprograms and other parts of the work.</p><p>The Corresponding Source need not include anything that users can regenerate automatically from other parts of the Corresponding Source.</p><p>The Corresponding Source for a work in source code form is that same work.</p><h3>2. Basic Permissions.</h3><p>All rights granted under this License are granted for the term of copyright on the Program, and are irrevocable provided the stated conditions are met. This License explicitly affirms your unlimited permission to run the unmodified Program. The output from running a covered work is covered by this License only if the output, given its content, constitutes a covered work. This License acknowledges your rights of fair use or other equivalent, as provided by copyright law.</p><p>You may make, run and propagate covered works that you do not convey, without conditions so long as your license otherwise remains in force. You may convey covered works to others for the sole purpose of having them make modifications exclusively for you, or provide you with facilities for running those works, provided that you comply with the terms of this License in conveying all material for which you do not control copyright. Those thus making or running the covered works for you must do so exclusively on your behalf, under your direction and control, on terms that prohibit them from making any copies of your copyrighted material outside their relationship with you.</p><p>Conveying under any other circumstances is permitted solely under the conditions stated below. Sublicensing is not allowed; section 10 makes it unnecessary.</p><h3>3. Protecting Users' Legal Rights From Anti-Circumvention Law.</h3><p>No covered work shall be deemed part of an effective technological measure under any applicable law fulfilling obligations under article 11 of the WIPO copyright treaty adopted on 20 December 1996, or similar laws prohibiting or restricting circumvention of such measures.</p><p>When you convey a covered work, you waive any legal power to forbid circumvention of technological measures to the extent such circumvention is effected by exercising rights under this License with respect to the covered work, and you disclaim any intention to limit operation or modification of the work as a means of enforcing, against the work's users, your or third parties' legal rights to forbid circumvention of technological measures.</p><h3>4. Conveying Verbatim Copies.</h3><p>You may convey verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice; keep intact all notices stating that this License and any non-permissive terms added in accord with section 7 apply to the code; keep intact all notices of the absence of any warranty; and give all recipients a copy of this License along with the Program.</p><p>You may charge any price or no price for each copy that you convey, and you may offer support or warranty protection for a fee.</p><h3>5. Conveying Modified Source Versions.</h3><p>You may convey a work based on the Program, or the modifications to produce it from the Program, in the form of source code under the terms of section 4, provided that you also meet all of these conditions:</p><ul><li>a) The work must carry prominent notices stating that you modified it, and giving a relevant date.</li><li>b) The work must carry prominent notices stating that it is released under this License and any conditions added under section 7. This requirement modifies the requirement in section 4 to \"keep intact all notices\".</li><li>c) You must license the entire work, as a whole, under this License to anyone who comes into possession of a copy. This License will therefore apply, along with any applicable section 7 additional terms, to the whole of the work, and all its parts, regardless of how they are packaged. This License gives no permission to license the work in any other way, but it does not invalidate such permission if you have separately received it.</li><li>d) If the work has interactive user interfaces, each must display Appropriate Legal Notices; however, if the Program has interactive interfaces that do not display Appropriate Legal Notices, your work need not make them do so.</li></ul><p>A compilation of a covered work with other separate and independent works, which are not by their nature extensions of the covered work, and which are not combined with it such as to form a larger program, in or on a volume of a storage or distribution medium, is called an \"aggregate\" if the compilation and its resulting copyright are not used to limit the access or legal rights of the compilation's users beyond what the individual works permit. Inclusion of a covered work in an aggregate does not cause this License to apply to the other parts of the aggregate.</p><h3>6. Conveying Non-Source Forms.</h3><p>You may convey a covered work in object code form under the terms of sections 4 and 5, provided that you also convey the machine-readable Corresponding Source under the terms of this License, in one of these ways:</p><ul><li>a) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by the Corresponding Source fixed on a durable physical medium customarily used for software interchange.</li><li>b) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by a written offer, valid for at least three years and valid for as long as you offer spare parts or customer support for that product model, to give anyone who possesses the object code either (1) a copy of the Corresponding Source for all the software in the product that is covered by this License, on a durable physical medium customarily used for software interchange, for a price no more than your reasonable cost of physically performing this conveying of source, or (2) access to copy the Corresponding Source from a network server at no charge.</li><li>c) Convey individual copies of the object code with a copy of the written offer to provide the Corresponding Source. This alternative is allowed only occasionally and noncommercially, and only if you received the object code with such an offer, in accord with subsection 6b.</li><li>d) Convey the object code by offering access from a designated place (gratis or for a charge), and offer equivalent access to the Corresponding Source in the same way through the same place at no further charge. You need not require recipients to copy the Corresponding Source along with the object code. If the place to copy the object code is a network server, the Corresponding Source may be on a different server (operated by you or a third party) that supports equivalent copying facilities, provided you maintain clear directions next to the object code saying where to find the Corresponding Source. Regardless of what server hosts the Corresponding Source, you remain obligated to ensure that it is available for as long as needed to satisfy these requirements.</li><li>e) Convey the object code using peer-to-peer transmission, provided you inform other peers where the object code and Corresponding Source of the work are being offered to the general public at no charge under subsection 6d.</li></ul><p>A separable portion of the object code, whose source code is excluded from the Corresponding Source as a System Library, need not be included in conveying the object code work.</p><p>A \"User Product\" is either (1) a \"consumer product\", which means any tangible personal property which is normally used for personal, family, or household purposes, or (2) anything designed or sold for incorporation into a dwelling. In determining whether a product is a consumer product, doubtful cases shall be resolved in favor of coverage. For a particular product received by a particular user, \"normally used\" refers to a typical or common use of that class of product, regardless of the status of the particular user or of the way in which the particular user actually uses, or expects or is expected to use, the product. A product is a consumer product regardless of whether the product has substantial commercial, industrial or non-consumer uses, unless such uses represent the only significant mode of use of the product.</p><p>\"Installation Information\" for a User Product means any methods, procedures, authorization keys, or other information required to install and execute modified versions of a covered work in that User Product from a modified version of its Corresponding Source. The information must suffice to ensure that the continued functioning of the modified object code is in no case prevented or interfered with solely because modification has been made.</p><p>If you convey an object code work under this section in, or with, or specifically for use in, a User Product, and the conveying occurs as part of a transaction in which the right of possession and use of the User Product is transferred to the recipient in perpetuity or for a fixed term (regardless of how the transaction is characterized), the Corresponding Source conveyed under this section must be accompanied by the Installation Information. But this requirement does not apply if neither you nor any third party retains the ability to install modified object code on the User Product (for example, the work has been installed in ROM).</p><p>The requirement to provide Installation Information does not include a requirement to continue to provide support service, warranty, or updates for a work that has been modified or installed by the recipient, or for the User Product in which it has been modified or installed. Access to a network may be denied when the modification itself materially and adversely affects the operation of the network or violates the rules and protocols for communication across the network.</p><p>Corresponding Source conveyed, and Installation Information provided, in accord with this section must be in a format that is publicly documented (and with an implementation available to the public in source code form), and must require no special password or key for unpacking, reading or copying.</p><h3>7. Additional Terms.</h3><p>\"Additional permissions\" are terms that supplement the terms of this License by making exceptions from one or more of its conditions. Additional permissions that are applicable to the entire Program shall be treated as though they were included in this License, to the extent that they are valid under applicable law. If additional permissions apply only to part of the Program, that part may be used separately under those permissions, but the entire Program remains governed by this License without regard to the additional permissions.</p><p>When you convey a copy of a covered work, you may at your option remove any additional permissions from that copy, or from any part of it. (Additional permissions may be written to require their own removal in certain cases when you modify the work.) You may place additional permissions on material, added by you to a covered work, for which you have or can give appropriate copyright permission.</p><p>Notwithstanding any other provision of this License, for material you add to a covered work, you may (if authorized by the copyright holders of that material) supplement the terms of this License with terms:</p><ul><li>a) Disclaiming warranty or limiting liability differently from the terms of sections 15 and 16 of this License; or</li><li>b) Requiring preservation of specified reasonable legal notices or author attributions in that material or in the Appropriate Legal Notices displayed by works containing it; or</li><li>c) Prohibiting misrepresentation of the origin of that material, or requiring that modified versions of such material be marked in reasonable ways as different from the original version; or</li><li>d) Limiting the use for publicity purposes of names of licensors or authors of the material; or</li><li>e) Declining to grant rights under trademark law for use of some trade names, trademarks, or service marks; or</li><li>f) Requiring indemnification of licensors and authors of that material by anyone who conveys the material (or modified versions of it) with contractual assumptions of liability to the recipient, for any liability that these contractual assumptions directly impose on those licensors and authors.</li></ul><p>All other non-permissive additional terms are considered \"further restrictions\" within the meaning of section 10. If the Program as you received it, or any part of it, contains a notice stating that it is governed by this License along with a term that is a further restriction, you may remove that term. If a license document contains a further restriction but permits relicensing or conveying under this License, you may add to a covered work material governed by the terms of that license document, provided that the further restriction does not survive such relicensing or conveying.</p><p>If you add terms to a covered work in accord with this section, you must place, in the relevant source files, a statement of the additional terms that apply to those files, or a notice indicating where to find the applicable terms.</p><p>Additional terms, permissive or non-permissive, may be stated in the form of a separately written license, or stated as exceptions; the above requirements apply either way.</p><h3>8. Termination.</h3><p>You may not propagate or modify a covered work except as expressly provided under this License. Any attempt otherwise to propagate or modify it is void, and will automatically terminate your rights under this License (including any patent licenses granted under the third paragraph of section 11).</p><p>However, if you cease all violation of this License, then your license from a particular copyright holder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally terminates your license, and (b) permanently, if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation.</p><p>Moreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means, this is the first time you have received notice of violation of this License (for any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of the notice.</p><p>Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under this License. If your rights have been terminated and not permanently reinstated, you do not qualify to receive new licenses for the same material under section 10.</p><h3>9. Acceptance Not Required for Having Copies.</h3><p>You are not required to accept this License in order to receive or run a copy of the Program. Ancillary propagation of a covered work occurring solely as a consequence of using peer-to-peer transmission to receive a copy likewise does not require acceptance. However, nothing other than this License grants you permission to propagate or modify any covered work. These actions infringe copyright if you do not accept this License. Therefore, by modifying or propagating a covered work, you indicate your acceptance of this License to do so.</p><h3>10. Automatic Licensing of Downstream Recipients.</h3><p>Each time you convey a covered work, the recipient automatically receives a license from the original licensors, to run, modify and propagate that work, subject to this License. You are not responsible for enforcing compliance by third parties with this License.</p><p>An \"entity transaction\" is a transaction transferring control of an organization, or substantially all assets of one, or subdividing an organization, or merging organizations. If propagation of a covered work results from an entity transaction, each party to that transaction who receives a copy of the work also receives whatever licenses to the work the party's predecessor in interest had or could give under the previous paragraph, plus a right to possession of the Corresponding Source of the work from the predecessor in interest, if the predecessor has it or can get it with reasonable efforts.</p><p>You may not impose any further restrictions on the exercise of the rights granted or affirmed under this License. For example, you may not impose a license fee, royalty, or other charge for exercise of rights granted under this License, and you may not initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging that any patent claim is infringed by making, using, selling, offering for sale, or importing the Program or any portion of it.</p><h3>11. Patents.</h3><p>A \"contributor\" is a copyright holder who authorizes use under this License of the Program or a work on which the Program is based. The work thus licensed is called the contributor's \"contributor version\".</p><p>A contributor's \"essential patent claims\" are all patent claims owned or controlled by the contributor, whether already acquired or hereafter acquired, that would be infringed by some manner, permitted by this License, of making, using, or selling its contributor version, but do not include claims that would be infringed only as a consequence of further modification of the contributor version. For purposes of this definition, \"control\" includes the right to grant patent sublicenses in a manner consistent with the requirements of this License.</p><p>Each contributor grants you a non-exclusive, worldwide, royalty-free patent license under the contributor's essential patent claims, to make, use, sell, offer for sale, import and otherwise run, modify and propagate the contents of its contributor version.</p><p>In the following three paragraphs, a \"patent license\" is any express agreement or commitment, however denominated, not to enforce a patent (such as an express permission to practice a patent or covenant not to sue for patent infringement). To \"grant\" such a patent license to a party means to make such an agreement or commitment not to enforce a patent against the party.</p><p>If you convey a covered work, knowingly relying on a patent license, and the Corresponding Source of the work is not available for anyone to copy, free of charge and under the terms of this License, through a publicly available network server or other readily accessible means, then you must either (1) cause the Corresponding Source to be so available, or (2) arrange to deprive yourself of the benefit of the patent license for this particular work, or (3) arrange, in a manner consistent with the requirements of this License, to extend the patent license to downstream recipients. \"Knowingly relying\" means you have actual knowledge that, but for the patent license, your conveying the covered work in a country, or your recipient's use of the covered work in a country, would infringe one or more identifiable patents in that country that you have reason to believe are valid.</p><p>If, pursuant to or in connection with a single transaction or arrangement, you convey, or propagate by procuring conveyance of, a covered work, and grant a patent license to some of the parties receiving the covered work authorizing them to use, propagate, modify or convey a specific copy of the covered work, then the patent license you grant is automatically extended to all recipients of the covered work and works based on it.</p><p>A patent license is \"discriminatory\" if it does not include within the scope of its coverage, prohibits the exercise of, or is conditioned on the non-exercise of one or more of the rights that are specifically granted under this License. You may not convey a covered work if you are a party to an arrangement with a third party that is in the business of distributing software, under which you make payment to the third party based on the extent of your activity of conveying the work, and under which the third party grants, to any of the parties who would receive the covered work from you, a discriminatory patent license (a) in connection with copies of the covered work conveyed by you (or copies made from those copies), or (b) primarily for and in connection with specific products or compilations that contain the covered work, unless you entered into that arrangement, or that patent license was granted, prior to 28 March 2007.</p><p>Nothing in this License shall be construed as excluding or limiting any implied license or other defenses to infringement that may otherwise be available to you under applicable patent law.</p><h3>12. No Surrender of Others' Freedom.</h3><p>If conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot convey a covered work so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not convey it at all. For example, if you agree to terms that obligate you to collect a royalty for further conveying from those to whom you convey the Program, the only way you could satisfy both those terms and this License would be to refrain entirely from conveying the Program.</p><h3>13. Remote Network Interaction; Use with the GNU General Public License.</h3><p>Notwithstanding any other provision of this License, if you modify the Program, your modified version must prominently offer all users interacting with it remotely through a computer network (if your version supports such interaction) an opportunity to receive the Corresponding Source of your version by providing access to the Corresponding Source from a network server at no charge, through some standard or customary means of facilitating copying of software. This Corresponding Source shall include the Corresponding Source for any work covered by version 3 of the GNU General Public License that is incorporated pursuant to the following paragraph.</p><p>Notwithstanding any other provision of this License, you have permission to link or combine any covered work with a work licensed under version 3 of the GNU General Public License into a single combined work, and to convey the resulting work. The terms of this License will continue to apply to the part which is the covered work, but the work with which it is combined will remain governed by version 3 of the GNU General Public License.</p><h3>14. Revised Versions of this License.</h3><p>The Free Software Foundation may publish revised and/or new versions of the GNU Affero General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns.</p><p>Each version is given a distinguishing version number. If the Program specifies that a certain numbered version of the GNU Affero General Public License \"or any later version\" applies to it, you have the option of following the terms and conditions either of that numbered version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of the GNU Affero General Public License, you may choose any version ever published by the Free Software Foundation.</p><p>If the Program specifies that a proxy can decide which future versions of the GNU Affero General Public License can be used, that proxy's public statement of acceptance of a version permanently authorizes you to choose that version for the Program.</p><p>Later license versions may give you additional or different permissions. However, no additional obligations are imposed on any author or copyright holder as a result of your choosing to follow a later version.</p><h3>15. Disclaimer of Warranty.</h3><p>THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM \"AS IS\" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.</p><h3>16. Limitation of Liability.</h3><p>IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.</p><h3>17. Interpretation of Sections 15 and 16.</h3><p>If the disclaimer of warranty and limitation of liability provided above cannot be given local legal effect according to their terms, reviewing courts shall apply local law that most closely approximates an absolute waiver of all civil liability in connection with the Program, unless a warranty or assumption of liability accompanies a copy of the Program in return for a fee.</p><p>END OF TERMS AND CONDITIONS</p><h2>How to Apply These Terms to Your New Programs</h2><p>If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms.</p><p>To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively state the exclusion of warranty; and each file should have at least the \"copyright\" line and a pointer to where the full notice is found.</p><pre><code class=\"language-text-x-trilium-auto\"> &lt;one line to give the program's name and a brief idea of what it does.&gt;\n Copyright (C) &lt;year&gt; &lt;name of author&gt;\n\n This program is free software: you can redistribute it and/or modify\n it under the terms of the GNU Affero General Public License as\n published by the Free Software Foundation, either version 3 of the\n License, or (at your option) any later version.\n\n This program is distributed in the hope that it will be useful,\n but WITHOUT ANY WARRANTY; without even the implied warranty of\n MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n GNU Affero General Public License for more details.\n\n You should have received a copy of the GNU Affero General Public License\n along with this program. If not, see &lt;https://www.gnu.org/licenses/&gt;.</code></pre><p>Also add information on how to contact you by electronic and paper mail.</p><p>If your software can interact with users remotely through a computer network, you should also make sure that it provides a way for users to get its source. For example, if your program is a web application, its interface could display a \"Source\" link that leads users to an archive of the code. There are many ways you could offer source, and different solutions will be better for different programs; see section 13 for the specific requirements.</p><p>You should also get your employer (if you work as a programmer) or school, if any, to sign a \"copyright disclaimer\" for the program, if necessary. For more information on this, and how to apply and follow the GNU AGPL, see <a href=\"https://www.gnu.org/licenses/\">https://www.gnu.org/licenses/</a>.</p>"
+}
\ No newline at end of file
diff --git a/apps/server/src/assets/help/help_meta.json b/apps/server/src/assets/help/help_meta.json
new file mode 100644
index 0000000000..829a56e2e6
--- /dev/null
+++ b/apps/server/src/assets/help/help_meta.json
@@ -0,0 +1,372 @@
+[
+ {"id":"_help_BOCnjTMBCoxW","title":"Feature Highlights","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/feature-highlights"},{"type":"label","name":"iconClass","value":"bx bx-star"}]},
+ {"id":"_help_Otzi9La2YAUX","title":"Installation & Setup","type":"book","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup"},{"type":"label","name":"iconClass","value":"bx bx-cog"}],"children":[
+ {"id":"_help_poXkQfguuA0U","title":"Desktop Installation","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/desktop"},{"type":"label","name":"iconClass","value":"bx bx-desktop"}],"children":[
+ {"id":"_help_nRqcgfTb97uV","title":"Using the desktop application as a server","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/desktop/desktop-as-server"},{"type":"label","name":"iconClass","value":"bx bx-file"}]},
+ {"id":"_help_Rp0q8bSP6Ayl","title":"System Requirements","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/desktop/system-requirements"},{"type":"label","name":"iconClass","value":"bx bx-chip"}]},
+ {"id":"_help_Un4wj2Mak2Ky","title":"Nix flake","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/desktop/nix-flake"},{"type":"label","name":"iconClass","value":"bx bxl-tux"}]},
+ {"id":"_help_swSFivWk6KkA","title":"Network Access","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/desktop/network-access"},{"type":"label","name":"iconClass","value":"bx bx-network-chart"}]},
+ {"id":"_help_7iwde4lsKc6O","title":"Tray icon & automatic startup","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/desktop/tray-icon-and-startup"},{"type":"label","name":"iconClass","value":"bx bx-file"}]},
+ {"id":"_help_hvRfsDr591WP","title":"Troubleshooting","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/desktop/troubleshooting"},{"type":"label","name":"iconClass","value":"bx bx-file"}]}
+ ]},
+ {"id":"_help_WOcw2SLH6tbX","title":"Server Installation","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server"},{"type":"label","name":"iconClass","value":"bx bx-server"}],"children":[
+ {"id":"_help_Dgg7bR3b6K9j","title":"1. Installing the server","type":"book","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/installation"},{"type":"label","name":"iconClass","value":"bx bx-folder"}],"children":[
+ {"id":"_help_3tW6mORuTHnB","title":"Packaged version for Linux","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/installation/packaged-server"},{"type":"label","name":"iconClass","value":"bx bxl-tux"}],"children":[
+ {"id":"_help_ZNAjFcxqHr9V","title":"Simple auto-update for server","type":"code","attributes":[{"type":"label","name":"iconClass","value":"bx bx-file"}],"mime":"text/x-sh"}
+ ]},
+ {"id":"_help_rWX5eY045zbE","title":"Using Docker","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/installation/docker"},{"type":"label","name":"iconClass","value":"bx bxl-docker"}]},
+ {"id":"_help_moVgBcoxE3EK","title":"On NixOS","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/installation/nixos"},{"type":"label","name":"iconClass","value":"bx bxl-tux"}]},
+ {"id":"_help_J1Bb6lVlwU5T","title":"Manually","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/installation/manual"},{"type":"label","name":"iconClass","value":"bx bx-code-alt"}]},
+ {"id":"_help_DCmT6e7clMoP","title":"Using Kubernetes","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/installation/kubernetes"},{"type":"label","name":"iconClass","value":"bx bxl-kubernetes"}]},
+ {"id":"_help_klCWNks3ReaQ","title":"Multiple server instances","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/installation/multiple-instances"},{"type":"label","name":"iconClass","value":"bx bxs-user-account"}]}
+ ]},
+ {"id":"_help_vcjrb3VVYPZI","title":"2. Reverse proxy","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/reverse-proxy"},{"type":"label","name":"iconClass","value":"bx bx-file"}],"children":[
+ {"id":"_help_ud6MShXL4WpO","title":"Nginx","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/reverse-proxy/nginx"},{"type":"label","name":"iconClass","value":"bx bx-file"}]},
+ {"id":"_help_fDLvzOx29Pfg","title":"Apache using Docker","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/reverse-proxy/apache"},{"type":"label","name":"iconClass","value":"bx bx-file"}]},
+ {"id":"_help_LLzSMXACKhUs","title":"Trusted proxy","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/reverse-proxy/trusted-proxy"},{"type":"label","name":"iconClass","value":"bx bx-file"}]},
+ {"id":"_help_5ERVJb9s4FRD","title":"Traefik","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/reverse-proxy/traefik"},{"type":"label","name":"iconClass","value":"bx bx-file"}]}
+ ]},
+ {"id":"_help_l2VkvOwUNfZj","title":"HTTPS (TLS)","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/https"},{"type":"label","name":"iconClass","value":"bx bx-lock-alt"}]},
+ {"id":"_help_0hzsNCP31IAB","title":"Authentication","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/auth"},{"type":"label","name":"iconClass","value":"bx bx-user"}],"children":[
+ {"id":"_help_lwAX5SvbrK2g","title":"Resetting your password","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/auth/password-reset"},{"type":"label","name":"iconClass","value":"bx bx-key"}]}
+ ]},
+ {"id":"_help_7DAiwaf8Z7Rz","title":"Multi-factor authentication with TOTP","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/mfa"},{"type":"label","name":"iconClass","value":"bx bx-stopwatch"}]},
+ {"id":"_help_Un4wj2Mak2Ky","title":"Nix flake","type":"text","attributes":[{"type":"label","name":"iconClass","value":"bx bxl-tux"}]},
+ {"id":"_help_x1lQNKQBqLcA","title":"Signing in with OpenID Connect","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/openid-connect"},{"type":"label","name":"iconClass","value":"bx bxs-key"}],"children":[
+ {"id":"_help_IgkTHSaFfq6A","title":"Setting up with various providers","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/openid-connect/setup"},{"type":"label","name":"iconClass","value":"bx bx-file"}]}
+ ]},
+ {"id":"_help_yeEaYqosGLSh","title":"Third-party cloud hosting","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/cloud-hosting"},{"type":"label","name":"iconClass","value":"bx bx-cloud"}]},
+ {"id":"_help_iGTnKjubbXkA","title":"System Requirements","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/server/system-requirements"},{"type":"label","name":"iconClass","value":"bx bx-chip"}]}
+ ]},
+ {"id":"_help_cbkrhQjrkKrh","title":"Synchronization","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/synchronization"},{"type":"label","name":"iconClass","value":"bx bx-sync"}]},
+ {"id":"_help_RDslemsQ6gCp","title":"Mobile Frontend","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/mobile-frontend"},{"type":"label","name":"iconClass","value":"bx bx-mobile-alt"}]},
+ {"id":"_help_MtPxeAWVAzMg","title":"Web Clipper","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/web-clipper"},{"type":"label","name":"iconClass","value":"bx bx-paperclip"}]},
+ {"id":"_help_n1lujUxCwipy","title":"Upgrading TriliumNext","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/upgrading"},{"type":"label","name":"iconClass","value":"bx bx-up-arrow-alt"}]},
+ {"id":"_help_ODY7qQn5m2FT","title":"Backup","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/backup"},{"type":"label","name":"iconClass","value":"bx bx-hdd"}]},
+ {"id":"_help_tAassRL4RSQL","title":"Data directory","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/data-directory"},{"type":"label","name":"iconClass","value":"bx bx-folder-open"}]},
+ {"id":"_help_ebyr7ES2SwOW","title":"Downloaded resources","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/setup/downloaded-resources"},{"type":"label","name":"iconClass","value":"bx bx-download"}]}
+ ]},
+ {"id":"_help_gh7bpGYxajRS","title":"Basic Concepts and Features","type":"book","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts"},{"type":"label","name":"iconClass","value":"bx bx-help-circle"}],"children":[
+ {"id":"_help_Vc8PjrjAGuOp","title":"UI Elements","type":"book","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui"},{"type":"label","name":"iconClass","value":"bx bx-window-alt"}],"children":[
+ {"id":"_help_x0JgW8UqGXvq","title":"Vertical and horizontal layout","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/layouts"},{"type":"label","name":"iconClass","value":"bx bxs-layout"}]},
+ {"id":"_help_x3i7MxGccDuM","title":"Global menu","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/global-menu"},{"type":"label","name":"iconClass","value":"bx bx-menu"}]},
+ {"id":"_help_oPVyFC7WL2Lp","title":"Note Tree","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-tree"},{"type":"label","name":"iconClass","value":"bx bxs-tree-alt"}],"children":[
+ {"id":"_help_YtSN43OrfzaA","title":"Note tree contextual menu","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-tree/context-menu"},{"type":"label","name":"iconClass","value":"bx bx-menu"}]},
+ {"id":"_help_yTjUdsOi4CIE","title":"Multiple selection","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-tree/multiple-selection"},{"type":"label","name":"iconClass","value":"bx bx-list-plus"}]},
+ {"id":"_help_DvdZhoQZY9Yd","title":"Keyboard shortcuts","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-tree/keyboard-shortcuts"},{"type":"label","name":"iconClass","value":"bx bxs-keyboard"}]},
+ {"id":"_help_wyaGBBQrl4i3","title":"Hiding the subtree","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-tree/hiding-subtree"},{"type":"label","name":"iconClass","value":"bx bx-hide"}]}
+ ]},
+ {"id":"_help_3seOhtN8uLIY","title":"Tabs","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/tabs"},{"type":"label","name":"iconClass","value":"bx bx-dock-top"}]},
+ {"id":"_help_xYmIYSP6wE3F","title":"Launch Bar","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/launch-bar"},{"type":"label","name":"iconClass","value":"bx bx-sidebar"}]},
+ {"id":"_help_8YBEPzcpUgxw","title":"Note menu","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-menu"},{"type":"label","name":"iconClass","value":"bx bx-dots-horizontal-rounded"}]},
+ {"id":"_help_1P8QXI5edXNd","title":"Note buttons","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-buttons"},{"type":"label","name":"iconClass","value":"bx bx-download"}]},
+ {"id":"_help_4TIF1oA4VQRO","title":"Options","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/options"},{"type":"label","name":"iconClass","value":"bx bx-cog"}]},
+ {"id":"_help_luNhaphA37EO","title":"Split View","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/split-view"},{"type":"label","name":"iconClass","value":"bx bx-dock-right"}]},
+ {"id":"_help_RnaPdbciOfeq","title":"Right Sidebar","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/right-sidebar"},{"type":"label","name":"iconClass","value":"bx bxs-dock-right"}],"children":[
+ {"id":"_help_2dcGDhp9WFKb","title":"Outline tab","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/right-sidebar/outline"},{"type":"label","name":"iconClass","value":"bx bx-list-ul"}]},
+ {"id":"_help_uNtgN0cUKEBc","title":"Attributes tab","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/right-sidebar/attributes"},{"type":"label","name":"iconClass","value":"bx bx-hash"}]},
+ {"id":"_help_LrKznOtw9cQD","title":"AI chat tab","type":"text","attributes":[{"type":"label","name":"iconClass","value":"bx bx-bot"}]},
+ {"id":"_help_KRlZFoIH0j6p","title":"Connections tab","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/right-sidebar/connections"},{"type":"label","name":"iconClass","value":"bx bx-network-chart"}]}
+ ]},
+ {"id":"_help_r5JGHN99bVKn","title":"Recent Changes","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/recent-changes"},{"type":"label","name":"iconClass","value":"bx bx-history"}]},
+ {"id":"_help_ny318J39E5Z0","title":"Zoom","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/zoom"},{"type":"label","name":"iconClass","value":"bx bx-zoom-in"}]},
+ {"id":"_help_lgKX7r3aL30x","title":"Note Tooltip","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-tooltip"},{"type":"label","name":"iconClass","value":"bx bx-message-detail"}]},
+ {"id":"_help_SL5f1Auq7sVN","title":"Note types with split view","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-types-with-split-view"},{"type":"label","name":"iconClass","value":"bx bx-card"}]},
+ {"id":"_help_t596jLvPrqkS","title":"Content width","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/content-width"},{"type":"label","name":"iconClass","value":"bx bx-detail"}]},
+ {"id":"_help_jcQVxzYybYgz","title":"Note contextual menu","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-context-menu"},{"type":"label","name":"iconClass","value":"bx bx-menu"}]},
+ {"id":"_help_AlJ73vBCjWDw","title":"Status bar","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/status-bar"},{"type":"label","name":"iconClass","value":"bx bx-dock-bottom"}]},
+ {"id":"_help_I6p2a06hdnL6","title":"Breadcrumb","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/breadcrumb"},{"type":"label","name":"iconClass","value":"bx bx-chevron-right"}]}
+ ]},
+ {"id":"_help_BFs8mudNFgCS","title":"Notes","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes"},{"type":"label","name":"iconClass","value":"bx bx-notepad"}],"children":[
+ {"id":"_help_l7pigIGu01K2","title":"Title","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/title"},{"type":"label","name":"iconClass","value":"bx bx-text"}]},
+ {"id":"_help_p9kXRFAkwN4o","title":"Note Icons & Colors","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/note-icons"},{"type":"label","name":"iconClass","value":"bx bxs-grid"}]},
+ {"id":"_help_0vhv7lsOLy82","title":"Attachments","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/attachments"},{"type":"label","name":"iconClass","value":"bx bx-paperclip"}]},
+ {"id":"_help_IakOLONlIfGI","title":"Cloning Notes","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/cloning"},{"type":"label","name":"iconClass","value":"bx bx-duplicate"}],"children":[
+ {"id":"_help_TBwsyfadTA18","title":"Branch prefix","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/cloning/branch-prefix"},{"type":"label","name":"iconClass","value":"bx bx-rename"}]}
+ ]},
+ {"id":"_help_bwg0e8ewQMak","title":"Protected Notes","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/protected-notes"},{"type":"label","name":"iconClass","value":"bx bx-lock-alt"}]},
+ {"id":"_help_MKmLg5x6xkor","title":"Archived Notes","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/archived-notes"},{"type":"label","name":"iconClass","value":"bx bx-box"}]},
+ {"id":"_help_vZWERwf8U3nx","title":"Note Revisions","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/note-revisions"},{"type":"label","name":"iconClass","value":"bx bx-history"}]},
+ {"id":"_help_aGlEvb9hyDhS","title":"Sorting Notes","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/sorting"},{"type":"label","name":"iconClass","value":"bx bx-sort-up"}]},
+ {"id":"_help_NRnIZmSMc5sj","title":"Printing & Exporting as PDF","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/printing-and-pdf-export"},{"type":"label","name":"iconClass","value":"bx bx-printer"}]},
+ {"id":"_help_CoFPLs3dRlXc","title":"Read-Only Notes","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/read-only-notes"},{"type":"label","name":"iconClass","value":"bx bx-edit-alt"}]},
+ {"id":"_help_0ESUbbAxVnoK","title":"Note List","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/note-list"},{"type":"label","name":"iconClass","value":"bx bxs-grid"}]},
+ {"id":"_help_S0Fos78ZfcY7","title":"Note Inbox","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/note-inbox"},{"type":"label","name":"iconClass","value":"bx bxs-inbox"}]},
+ {"id":"_help_5Ct4MAJTS4tQ","title":"Restoring Deleted Notes","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/restoring-deleted-notes"},{"type":"label","name":"iconClass","value":"bx bx-trash-alt"}]},
+ {"id":"_help_m3VlURMSeOrd","title":"New note type switcher","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/new-note-type-switcher"},{"type":"label","name":"iconClass","value":"bx bxs-widget"}]},
+ {"id":"_help_B5dihXRDksTk","title":"Note badges","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/note-badges"},{"type":"label","name":"iconClass","value":"bx bx-square-rounded"}]},
+ {"id":"_help_Bsm4fyzPJkSc","title":"Save status indicator","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/save-status-indicator"},{"type":"label","name":"iconClass","value":"bx bx-save"}]}
+ ]},
+ {"id":"_help_wArbEsdSae6g","title":"Navigation","type":"book","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation"},{"type":"label","name":"iconClass","value":"bx bx-navigation"}],"children":[
+ {"id":"_help_kBrnXNG3Hplm","title":"Tree Concepts","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/tree-concepts"},{"type":"label","name":"iconClass","value":"bx bx-pyramid"}]},
+ {"id":"_help_MMiBEQljMQh2","title":"Note Navigation","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/note-navigation"},{"type":"label","name":"iconClass","value":"bx bxs-navigation"}]},
+ {"id":"_help_Ms1nauBra7gq","title":"Quick search","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/quick-search"},{"type":"label","name":"iconClass","value":"bx bx-search-alt-2"}]},
+ {"id":"_help_F1r9QtzQLZqm","title":"Jump to & command palette","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/jump-to"},{"type":"label","name":"iconClass","value":"bx bx-send"}]},
+ {"id":"_help_eIg8jdvaoNNd","title":"Search","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/search"},{"type":"label","name":"iconClass","value":"bx bx-search-alt-2"}],"children":[
+ {"id":"_help_Oxyb6jOjjVNL","title":"Under the hood","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/search/under-the-hood"},{"type":"label","name":"iconClass","value":"bx bxs-cog"}]},
+ {"id":"_help_WbjlujkUhEb5","title":"How search matches your text","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/search/matching"},{"type":"label","name":"iconClass","value":"bx bx-file-find"}]}
+ ]},
+ {"id":"_help_u3YFHC9tQlpm","title":"Bookmarks","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/bookmarks"},{"type":"label","name":"iconClass","value":"bx bx-bookmarks"}]},
+ {"id":"_help_OR8WJ7Iz9K4U","title":"Note Hoisting","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/note-hoisting"},{"type":"label","name":"iconClass","value":"bx bxs-chevrons-up"}]},
+ {"id":"_help_ZjLYv08Rp3qC","title":"Quick edit","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/quick-edit"},{"type":"label","name":"iconClass","value":"bx bx-edit"}]},
+ {"id":"_help_9sRHySam5fXb","title":"Workspaces","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/workspace"},{"type":"label","name":"iconClass","value":"bx bx-door-open"}]},
+ {"id":"_help_xWtq5NUHOwql","title":"Similar Notes","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/similar-notes"},{"type":"label","name":"iconClass","value":"bx bx-bar-chart"}]},
+ {"id":"_help_McngOG2jbUWX","title":"Search in note","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/search-in-note"},{"type":"label","name":"iconClass","value":"bx bx-search-alt-2"}]}
+ ]},
+ {"id":"_help_A9Oc6YKKc65v","title":"Keyboard Shortcuts","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/keyboard-shortcuts"},{"type":"label","name":"iconClass","value":"bx bxs-keyboard"}]},
+ {"id":"_help_Wy267RK4M69c","title":"Themes","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/themes"},{"type":"label","name":"iconClass","value":"bx bx-palette"}],"children":[
+ {"id":"_help_VbjZvtUek0Ln","title":"Theme Gallery","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/themes/theme-gallery"},{"type":"label","name":"iconClass","value":"bx bx-book-reader"}]},
+ {"id":"_help_gOKqSJgXLcIj","title":"Icon Packs","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/themes/icon-packs"},{"type":"label","name":"iconClass","value":"bx bx-package"}]},
+ {"id":"_help_w4rMEhJsALlA","title":"Personalizing the font","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/themes/fonts"},{"type":"label","name":"iconClass","value":"bx bx-font"}]}
+ ]},
+ {"id":"_help_mHbBMPDPkVV5","title":"Import & Export","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export"},{"type":"label","name":"iconClass","value":"bx bx-import"}],"children":[
+ {"id":"_help_Oau6X9rCuegd","title":"Markdown","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/markdown"},{"type":"label","name":"iconClass","value":"bx bxl-markdown"}],"children":[
+ {"id":"_help_rJ9grSgoExl9","title":"Supported syntax","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/markdown/supported-syntax"},{"type":"label","name":"iconClass","value":"bx bx-code-alt"}]}
+ ]},
+ {"id":"_help_ckZ2uNWQmVeX","title":"Importing data from other applications","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/import-from-apps"},{"type":"label","name":"iconClass","value":"bx bx-import"}],"children":[
+ {"id":"_help_GnhlmrATVqcH","title":"Microsoft OneNote","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/import-from-apps/onenote"},{"type":"label","name":"iconClass","value":"tn-brand tn-brand-onenote"}],"children":[
+ {"id":"_help_LpvyEIBIAAj7","title":"Tags","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/import-from-apps/onenote/tags"},{"type":"label","name":"iconClass","value":"bx bx-star"}]}
+ ]},
+ {"id":"_help_Y5mKeJ6dsCld","title":"Notion","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/import-from-apps/notion"},{"type":"label","name":"iconClass","value":"tn-brand tn-brand-notion"}]},
+ {"id":"_help_nhQVuO4zvIxi","title":"Google Keep","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/import-from-apps/keep"},{"type":"label","name":"iconClass","value":"tn-brand tn-brand-google-keep"}]},
+ {"id":"_help_syuSEKf2rUGr","title":"Evernote","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/import-from-apps/evernote"},{"type":"label","name":"iconClass","value":"tn-brand tn-brand-evernote"}],"children":[
+ {"id":"_help_dj3j8dG4th4l","title":"Process internal links by title","type":"code","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/import-from-apps/evernote/internal-links.js"},{"type":"label","name":"iconClass","value":"bx bx-file"}],"mime":"application/javascript;env=frontend"}
+ ]},
+ {"id":"_help_83zmPBJRgfnW","title":"Anytype","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/import-from-apps/anytype"},{"type":"label","name":"iconClass","value":"tn-brand tn-brand-anytype"}]},
+ {"id":"_help_iWD7wiIuMtgV","title":"Obsidian","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/import-from-apps/obsidian"},{"type":"label","name":"iconClass","value":"tn-brand tn-brand-obsidian"}]}
+ ]}
+ ]},
+ {"id":"_help_rC3pL2aptaRE","title":"Zen mode","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/zen-mode"},{"type":"label","name":"iconClass","value":"bx bxs-yin-yang"}]},
+ {"id":"_help_YzMcWlCVeW09","title":"Active content","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/concepts/active-content"},{"type":"label","name":"iconClass","value":"bx bxs-widget"}]}
+ ]},
+ {"id":"_help_s3YCWHBfmYuM","title":"Quick Start","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/quick-start"},{"type":"label","name":"iconClass","value":"bx bx-run"}]},
+ {"id":"_help_i6dbnitykE5D","title":"FAQ","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/faq"},{"type":"label","name":"iconClass","value":"bx bx-question-mark"}]},
+ {"id":"_help_KSZ04uQ2D1St","title":"Note Types","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types"},{"type":"label","name":"iconClass","value":"bx bx-edit"}],"children":[
+ {"id":"_help_iPIMuisry3hd","title":"Text","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text"},{"type":"label","name":"iconClass","value":"bx bx-note"}],"children":[
+ {"id":"_help_oSuaNgyyKnhu","title":"Anchors","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/bookmarks"},{"type":"label","name":"iconClass","value":"bx bx-bookmark"}]},
+ {"id":"_help_oI7GoyilXXAr","title":"Automatic replacements","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/automatic-replacements"},{"type":"label","name":"iconClass","value":"bx bx-reply"}]},
+ {"id":"_help_NwBbFdNZ9h7O","title":"Block quotes & admonitions","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/blockquotes"},{"type":"label","name":"iconClass","value":"bx bx-info-circle"}]},
+ {"id":"_help_klC3ilXa9kUE","title":"Block references","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/block-references"},{"type":"label","name":"iconClass","value":"bx bx-paragraph"}]},
+ {"id":"_help_4n4oQUVbnOxa","title":"Collapsible blocks","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/collapsible-blocks"},{"type":"label","name":"iconClass","value":"bx bx-chevron-down-circle"}]},
+ {"id":"_help_veGu4faJErEM","title":"Content language & Right-to-left support","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/content-language"},{"type":"label","name":"iconClass","value":"bx bx-align-right"}]},
+ {"id":"_help_EK2ckIZ74tbT","title":"Content tabs","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/content-tabs"},{"type":"label","name":"iconClass","value":"cke cke-trilium-tabs"}]},
+ {"id":"_help_2x0ZAX9ePtzV","title":"Cut to subnote","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/cut-to-subnote"},{"type":"label","name":"iconClass","value":"bx bx-cut"}]},
+ {"id":"_help_UYuUB1ZekNQU","title":"Developer-specific formatting","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/developer-formatting"},{"type":"label","name":"iconClass","value":"bx bx-code-alt"}],"children":[
+ {"id":"_help_QxEyIjRBizuC","title":"Code blocks","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/developer-formatting/code-blocks"},{"type":"label","name":"iconClass","value":"bx bx-code"}]}
+ ]},
+ {"id":"_help_AgjCISero73a","title":"Footnotes","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/footnotes"},{"type":"label","name":"iconClass","value":"bx bx-bracket"}]},
+ {"id":"_help_5wZallV2Qo1t","title":"Format Painter","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/format-painter"},{"type":"label","name":"iconClass","value":"bx bxs-paint-roll"}]},
+ {"id":"_help_nRhnJkTT8cPs","title":"Formatting toolbar","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/formatting-toolbar"},{"type":"label","name":"iconClass","value":"bx bx-text"}]},
+ {"id":"_help_Gr6xFaF6ioJ5","title":"General formatting","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/general-formatting"},{"type":"label","name":"iconClass","value":"bx bx-bold"}]},
+ {"id":"_help_AxshuNRegLAv","title":"Highlights list","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/highlights-list"},{"type":"label","name":"iconClass","value":"bx bx-highlight"}]},
+ {"id":"_help_mT0HEkOsz6i1","title":"Images","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/images"},{"type":"label","name":"iconClass","value":"bx bx-image-alt"}],"children":[
+ {"id":"_help_0Ofbk1aSuVRu","title":"Image references","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/images/image-references"},{"type":"label","name":"iconClass","value":"bx bxs-file-image"}]}
+ ]},
+ {"id":"_help_VRoP0g1uHHc2","title":"In-editor AI assistant","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/ai-assistant"},{"type":"label","name":"iconClass","value":"bx bx-bot"}],"children":[
+ {"id":"_help_mVEYwt20exhO","title":"Custom AI quick actions","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/ai-assistant/custom-quick-actions"},{"type":"label","name":"iconClass","value":"bx bx-file"}]}
+ ]},
+ {"id":"_help_nBAXQFj20hS1","title":"Include Note","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/include-note"},{"type":"label","name":"iconClass","value":"bx bx-file"}]},
+ {"id":"_help_CohkqWQC1iBv","title":"Insert buttons","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/insert-buttons"},{"type":"label","name":"iconClass","value":"bx bx-plus"}],"children":[
+ {"id":"_help_hD8GawVuazff","title":"Icons","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/insert-buttons/icons"},{"type":"label","name":"iconClass","value":"bx bx-sticker"}]}
+ ]},
+ {"id":"_help_oiVPnW8QfnvS","title":"Keyboard shortcuts","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/keyboard-shortcuts"},{"type":"label","name":"iconClass","value":"bx bxs-keyboard"}]},
+ {"id":"_help_UmgZAfcltxkS","title":"Link Previews","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/link-previews"},{"type":"label","name":"iconClass","value":"bx bx-link-external"}]},
+ {"id":"_help_QEAPj01N5f7w","title":"Links","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/links"},{"type":"label","name":"iconClass","value":"bx bx-link-alt"}],"children":[
+ {"id":"_help_3IDVtesTQ8ds","title":"External links","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/links/external-links"},{"type":"label","name":"iconClass","value":"bx bx-link-external"}]},
+ {"id":"_help_hrZ1D00cLbal","title":"Internal (reference) links","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/links/reference-links"},{"type":"label","name":"iconClass","value":"bx bx-link"}]},
+ {"id":"_help_wfGXLmm7x27z","title":"Backlinks","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/links/backlinks"},{"type":"label","name":"iconClass","value":"bx bx-link-alt"}]}
+ ]},
+ {"id":"_help_S6Xx8QIWTV66","title":"Lists","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/lists"},{"type":"label","name":"iconClass","value":"bx bx-list-ul"}]},
+ {"id":"_help_QrtTYPmdd1qq","title":"Markdown-like formatting","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/markdown-formatting"},{"type":"label","name":"iconClass","value":"bx bxl-markdown"}]},
+ {"id":"_help_YfYAtQBcfo5V","title":"Math Equations","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/math-equations"},{"type":"label","name":"iconClass","value":"bx bx-math"}]},
+ {"id":"_help_wYDzQ1fBFgfT","title":"Multicolumn layout","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/multicolumn-layout"},{"type":"label","name":"iconClass","value":"cke cke-trilium-multicolumn"}]},
+ {"id":"_help_dEHYtoWWi8ct","title":"Other features","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/other-features"},{"type":"label","name":"iconClass","value":"bx bxs-grid"}]},
+ {"id":"_help_gLt3vA97tMcp","title":"Premium features","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/premium-features"},{"type":"label","name":"iconClass","value":"bx bx-star"}]},
+ {"id":"_help_ZlN4nump6EbW","title":"Slash Commands","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/slash-commands"},{"type":"label","name":"iconClass","value":"bx bx-menu"}]},
+ {"id":"_help_oBo3iHIZnbG2","title":"Spell Check","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/spellcheck"},{"type":"label","name":"iconClass","value":"bx bx-check-double"}]},
+ {"id":"_help_BFvAtE74rbP6","title":"Table of contents","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/table-of-contents"},{"type":"label","name":"iconClass","value":"bx bx-heading"}]},
+ {"id":"_help_NdowYOC1GFKS","title":"Tables","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/tables"},{"type":"label","name":"iconClass","value":"bx bx-table"}]},
+ {"id":"_help_pwc194wlRzcH","title":"Text Snippets","type":"text","attributes":[{"type":"label","name":"iconClass","value":"bx bx-file"}]},
+ {"id":"_help_fASfBrYnquKU","title":"To-do Lists","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/text/todo-lists"},{"type":"label","name":"iconClass","value":"bx bx-checkbox-checked"}]}
+ ]},
+ {"id":"_help_6f9hih2hXXZk","title":"Code","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/code"},{"type":"label","name":"iconClass","value":"bx bx-code"}]},
+ {"id":"_help_m523cpzocqaD","title":"Saved Search","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/saved-search"},{"type":"label","name":"iconClass","value":"bx bx-file-find"}]},
+ {"id":"_help_iRwzGnHPzonm","title":"Relation Map","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/relation-map"},{"type":"label","name":"iconClass","value":"bx bx-shape-polygon"}]},
+ {"id":"_help_bdUJEHsAPYQR","title":"Note Map","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/note-map"},{"type":"label","name":"iconClass","value":"bx bxs-network-chart"}]},
+ {"id":"_help_HcABDtFCkbFN","title":"Render Note","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/render-note"},{"type":"label","name":"iconClass","value":"bx bx-extension"}]},
+ {"id":"_help_s1aBHPd79XYj","title":"Mermaid Diagrams","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/mermaid-diagrams"},{"type":"label","name":"iconClass","value":"bx bx-selection"}],"children":[
+ {"id":"_help_RH6yLjjWJHof","title":"ELK layout","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/mermaid-diagrams/elk"},{"type":"label","name":"iconClass","value":"bx bxs-network-chart"}]},
+ {"id":"_help_WWgeUaBb7UfC","title":"Syntax reference","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://mermaid.js.org/intro/syntax-reference.html"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/mermaid-diagrams/syntax-reference"},{"type":"label","name":"iconClass","value":"bx bx-file"}]}
+ ]},
+ {"id":"_help_grjYqerjn243","title":"Canvas","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/canvas"},{"type":"label","name":"iconClass","value":"bx bx-pen"}]},
+ {"id":"_help_1vHRoWCEjj0L","title":"Web View","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/webview"},{"type":"label","name":"iconClass","value":"bx bx-globe-alt"}]},
+ {"id":"_help_gBbsAeiuUxI5","title":"Mind Map","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/mindmap"},{"type":"label","name":"iconClass","value":"bx bx-sitemap"}]},
+ {"id":"_help_W8vYD3Q1zjCR","title":"File","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/file"},{"type":"label","name":"iconClass","value":"bx bx-file-blank"}],"children":[
+ {"id":"_help_XJGJrpu7F9sh","title":"PDFs","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/file/pdf"},{"type":"label","name":"iconClass","value":"bx bxs-file-pdf"}]},
+ {"id":"_help_AjqEeiDUOzj4","title":"Audio & Video","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/file/audio-video"},{"type":"label","name":"iconClass","value":"bx bx-video"}]},
+ {"id":"_help_KG48zgNY31NW","title":"Office documents","type":"text","attributes":[{"type":"label","name":"iconClass","value":"bx bxs-file-doc"}]}
+ ]},
+ {"id":"_help_GWHEkY4I4OE3","title":"Spreadsheets","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/spreadsheets"},{"type":"label","name":"iconClass","value":"bx bx-table"}]},
+ {"id":"_help_6RM1Q7ppFVoj","title":"Markdown","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/markdown"},{"type":"label","name":"iconClass","value":"bx bxl-markdown"}]},
+ {"id":"_help_jludwdW7N4hg","title":"Converting between note types","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/note-types/note-type-conversion"},{"type":"label","name":"iconClass","value":"bx bx-repost"}]}
+ ]},
+ {"id":"_help_GTwFsgaA0lCt","title":"Collections","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/collections"},{"type":"label","name":"iconClass","value":"bx bx-book"}],"children":[
+ {"id":"_help_xWbu3jpNWapp","title":"Calendar","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/collections/calendar"},{"type":"label","name":"iconClass","value":"bx bx-calendar"}]},
+ {"id":"_help_2FvYrpmOXm29","title":"Table","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/collections/table"},{"type":"label","name":"iconClass","value":"bx bx-table"}]},
+ {"id":"_help_CtBQqbwXDx1w","title":"Kanban Board","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/collections/kanban-board"},{"type":"label","name":"iconClass","value":"bx bx-columns"}]},
+ {"id":"_help_81SGnPGMk7Xc","title":"Geo Map","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/collections/geomap"},{"type":"label","name":"iconClass","value":"bx bx-map-alt"}],"children":[
+ {"id":"_help_C2H9HK4BzwG7","title":"Drawing shapes","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/collections/geomap/shapes"},{"type":"label","name":"iconClass","value":"bx bx-shape-square"}]},
+ {"id":"_help_ZRDXGc0nAIh4","title":"Image maps","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/collections/geomap/image-maps"},{"type":"label","name":"iconClass","value":"bx bx-image-alt"}]}
+ ]},
+ {"id":"_help_zP3PMqaG71Ct","title":"Presentation","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/collections/presentation"},{"type":"label","name":"iconClass","value":"bx bx-slideshow"}]},
+ {"id":"_help_8QqnMzx393bx","title":"Grid View","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/collections/grid"},{"type":"label","name":"iconClass","value":"bx bxs-grid"}]},
+ {"id":"_help_mULW0Q3VojwY","title":"List View","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/collections/list"},{"type":"label","name":"iconClass","value":"bx bx-list-ul"}]},
+ {"id":"_help_CssoWBu8I7jF","title":"Collection Properties","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/collections/collection-properties"},{"type":"label","name":"iconClass","value":"bx bx-cog"}]},
+ {"id":"_help_IF7Q6I9x7zuw","title":"Dashboard","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/collections/dashboard"},{"type":"label","name":"iconClass","value":"bx bxs-dashboard"}]}
+ ]},
+ {"id":"_help_BgmBlOIl72jZ","title":"Troubleshooting","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/troubleshooting"},{"type":"label","name":"iconClass","value":"bx bx-bug"}],"children":[
+ {"id":"_help_wy8So3yZZlH9","title":"Reporting issues","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/troubleshooting/reporting-issues"},{"type":"label","name":"iconClass","value":"bx bx-bug-alt"}]},
+ {"id":"_help_x59R8J8KV5Bp","title":"Anonymized Database","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/troubleshooting/anonymized-database"},{"type":"label","name":"iconClass","value":"bx bx-low-vision"}]},
+ {"id":"_help_qzNzp9LYQyPT","title":"Error logs","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/troubleshooting/error-logs"},{"type":"label","name":"iconClass","value":"bx bx-comment-error"}],"children":[
+ {"id":"_help_bnyigUA2UK7s","title":"Backend (server) logs","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/troubleshooting/error-logs/backend-logs"},{"type":"label","name":"iconClass","value":"bx bx-server"}]},
+ {"id":"_help_9yEHzMyFirZR","title":"Frontend logs","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/troubleshooting/error-logs/frontend-logs"},{"type":"label","name":"iconClass","value":"bx bx-window-alt"}]}
+ ]},
+ {"id":"_help_vdlYGAcpXAgc","title":"Synchronization fails with 504 Gateway Timeout","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/troubleshooting/sync-timeout"},{"type":"label","name":"iconClass","value":"bx bx-error"}]},
+ {"id":"_help_s8alTXmpFR61","title":"Refreshing the application","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/troubleshooting/refreshing-app"},{"type":"label","name":"iconClass","value":"bx bx-refresh"}]}
+ ]},
+ {"id":"_help_pKK96zzmvBGf","title":"Theme development","type":"book","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/theme-development"},{"type":"label","name":"iconClass","value":"bx bx-palette"}],"children":[
+ {"id":"_help_7NfNr5pZpVKV","title":"Creating a custom theme","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/theme-development/creating-custom-theme"},{"type":"label","name":"iconClass","value":"bx bxs-color"}]},
+ {"id":"_help_WFGzWeUK6arS","title":"Customize the Next theme","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/theme-development/customize-next-theme"},{"type":"label","name":"iconClass","value":"bx bx-news"}]},
+ {"id":"_help_WN5z4M8ASACJ","title":"Reference","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/theme-development/reference"},{"type":"label","name":"iconClass","value":"bx bx-book-open"}]},
+ {"id":"_help_AlhDUqhENtH7","title":"Custom app-wide CSS","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/theme-development/custom-appcss"},{"type":"label","name":"iconClass","value":"bx bxs-file-css"}]},
+ {"id":"_help_g1mlRoU8CsqC","title":"Creating an icon pack","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/theme-development/creating-icon-pack"},{"type":"label","name":"iconClass","value":"bx bx-package"}]}
+ ]},
+ {"id":"_help_tC7s2alapj8V","title":"Advanced Usage","type":"book","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage"},{"type":"label","name":"iconClass","value":"bx bx-rocket"}],"children":[
+ {"id":"_help_zEY4DaJG4YT5","title":"Attributes","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/attributes"},{"type":"label","name":"iconClass","value":"bx bx-list-check"}],"children":[
+ {"id":"_help_HI6GBBIduIgv","title":"Labels","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/attributes/labels"},{"type":"label","name":"iconClass","value":"bx bx-hash"}]},
+ {"id":"_help_Cq5X6iKQop6R","title":"Relations","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/attributes/relations"},{"type":"label","name":"iconClass","value":"bx bx-transfer"}]},
+ {"id":"_help_bwZpz2ajCEwO","title":"Attribute Inheritance","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/attributes/attribute-inheritance"},{"type":"label","name":"iconClass","value":"bx bx-list-plus"}]},
+ {"id":"_help_OFXdgB2nNk1F","title":"Promoted Attributes","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/attributes/promoted-attributes"},{"type":"label","name":"iconClass","value":"bx bx-table"}]}
+ ]},
+ {"id":"_help_KC1HB96bqqHX","title":"Templates","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/template"},{"type":"label","name":"iconClass","value":"bx bx-detail"}]},
+ {"id":"_help_B2ORr7OVEZtc","title":"Snippets","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/snippets"},{"type":"label","name":"iconClass","value":"bx bx-news"}],"children":[
+ {"id":"_help_VQjhl61rlWh9","title":"Markdown Snippets","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/snippets/markdown-snippets"},{"type":"label","name":"iconClass","value":"bx bxl-markdown"}]},
+ {"id":"_help_IEgsWp5hHH35","title":"Code Snippets","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/snippets/code-snippets"},{"type":"label","name":"iconClass","value":"bx bx-code-alt"}]},
+ {"id":"_help_pwc194wlRzcH","title":"Text Snippets","type":"text","attributes":[{"type":"label","name":"iconClass","value":"bx bx-file"}]}
+ ]},
+ {"id":"_help_BCkXAVs63Ttv","title":"Note Map (Link map, Tree map)","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/note-map"},{"type":"label","name":"iconClass","value":"bx bxs-network-chart"}]},
+ {"id":"_help_R9pX4DGra2Vt","title":"Sharing","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/sharing"},{"type":"label","name":"iconClass","value":"bx bx-share-alt"}],"children":[
+ {"id":"_help_Qjt68inQ2bRj","title":"Serving directly the content of a note","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/sharing/serving-raw"},{"type":"label","name":"iconClass","value":"bx bx-code"}]},
+ {"id":"_help_ycBFjKrrwE9p","title":"Exporting static HTML for web publishing","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/sharing/static-html"},{"type":"label","name":"iconClass","value":"bx bxs-file-html"}]},
+ {"id":"_help_sLIJ6f1dkJYW","title":"Reverse proxy configuration","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/sharing/reverse-proxy"},{"type":"label","name":"iconClass","value":"bx bx-world"}]},
+ {"id":"_help_Ad7Ku5gOHrDU","title":"Custom share template","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/sharing/custom-share-template"},{"type":"label","name":"iconClass","value":"bx bxl-nodejs"}]}
+ ]},
+ {"id":"_help_5668rwcirq1t","title":"Advanced Showcases","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/advanced-showcases"},{"type":"label","name":"iconClass","value":"bx bxs-component"}],"children":[
+ {"id":"_help_l0tKav7yLHGF","title":"Day Notes","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/advanced-showcases/day-notes"},{"type":"label","name":"iconClass","value":"bx bx-calendar"}]},
+ {"id":"_help_R7abl2fc6Mxi","title":"Weight Tracker","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/advanced-showcases/weight-tracker"},{"type":"label","name":"iconClass","value":"bx bx-line-chart"}]},
+ {"id":"_help_xYjQUYhpbUEW","title":"Task Manager","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/advanced-showcases/task-manager"},{"type":"label","name":"iconClass","value":"bx bx-calendar-check"}]}
+ ]},
+ {"id":"_help_i16PM6A7GXdU","title":"Customizing to-do task states","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/customizing-to-do-task-states"},{"type":"label","name":"iconClass","value":"bx bx-list-check"}]},
+ {"id":"_help_J5Ex1ZrMbyJ6","title":"Custom Request Handler","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/custom-request-handler"},{"type":"label","name":"iconClass","value":"bx bx-globe"}]},
+ {"id":"_help_d3fAXQ2diepH","title":"Custom Resource Providers","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/custom-resource-providers"},{"type":"label","name":"iconClass","value":"bx bxs-file-plus"}]},
+ {"id":"_help_pgxEVkzLl1OP","title":"ETAPI (REST API)","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/etapi"},{"type":"label","name":"iconClass","value":"bx bx-extension"}],"children":[
+ {"id":"_help_9qPsTWBorUhQ","title":"API Reference","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/rest-api/etapi/"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/etapi/api-reference"},{"type":"label","name":"iconClass","value":"bx bx-file"}]}
+ ]},
+ {"id":"_help_47ZrP6FNuoG8","title":"Default Note Title","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/default-note-title"},{"type":"label","name":"iconClass","value":"bx bx-edit-alt"}]},
+ {"id":"_help_wX4HbRucYSDD","title":"Database","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/database"},{"type":"label","name":"iconClass","value":"bx bx-data"}],"children":[
+ {"id":"_help_oyIAJ9PvvwHX","title":"Manually altering the database","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/database/manual-editing"},{"type":"label","name":"iconClass","value":"bx bxs-edit"}],"children":[
+ {"id":"_help_YKWqdJhzi2VY","title":"SQL Console","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/database/manual-editing/sql-console"},{"type":"label","name":"iconClass","value":"bx bx-data"}]}
+ ]},
+ {"id":"_help_6tZeKvSHEUiB","title":"Demo Notes","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/database/demo-notes"},{"type":"label","name":"iconClass","value":"bx bx-package"}]}
+ ]},
+ {"id":"_help_Gzjqa934BdH4","title":"Configuration (config.ini or environment variables)","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/configuration"},{"type":"label","name":"iconClass","value":"bx bx-cog"}],"children":[
+ {"id":"_help_c5xB8m4g2IY6","title":"Trilium instance","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/configuration/trilium-instance"},{"type":"label","name":"iconClass","value":"bx bx-windows"}]},
+ {"id":"_help_LWtBjFej3wX3","title":"Cross-Origin Resource Sharing (CORS)","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/configuration/cors"},{"type":"label","name":"iconClass","value":"bx bx-lock"}]}
+ ]},
+ {"id":"_help_ivYnonVFBxbQ","title":"Bulk Actions","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/bulk-actions"},{"type":"label","name":"iconClass","value":"bx bx-list-plus"}]},
+ {"id":"_help_4FahAwuGTAwC","title":"Note source","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/note-source"},{"type":"label","name":"iconClass","value":"bx bx-code"}]},
+ {"id":"_help_1YeN2MzFUluU","title":"Technologies used","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/technologies"},{"type":"label","name":"iconClass","value":"bx bx-pyramid"}],"children":[
+ {"id":"_help_MI26XDLSAlCD","title":"CKEditor","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/technologies/ckeditor"},{"type":"label","name":"iconClass","value":"bx bx-file"}]}
+ ]},
+ {"id":"_help_m1lbrzyKDaRB","title":"Note ID","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/note-id"},{"type":"label","name":"iconClass","value":"bx bx-fingerprint"}]},
+ {"id":"_help_0vTSyvhPTAOz","title":"Internal API","type":"book","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/internal-api"},{"type":"label","name":"iconClass","value":"bx bxs-component"}],"children":[
+ {"id":"_help_z8O2VG4ZZJD7","title":"API Reference","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/rest-api/internal/"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/internal-api/api-reference"},{"type":"label","name":"iconClass","value":"bx bx-file"}]}
+ ]},
+ {"id":"_help_2mUhVmZK8RF3","title":"Hidden Notes","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/hidden-notes"},{"type":"label","name":"iconClass","value":"bx bx-hide"}]},
+ {"id":"_help_uYF7pmepw27K","title":"Metrics","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/metrics"},{"type":"label","name":"iconClass","value":"bx bxs-data"}],"children":[
+ {"id":"_help_bOP3TB56fL1V","title":"grafana-dashboard.json","type":"code","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/metrics/grafana-dashboard"},{"type":"label","name":"iconClass","value":"bx bx-file"}],"mime":"application/json"}
+ ]},
+ {"id":"_help_64ZTlUPgEPtW","title":"Safe mode","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/safe-mode"},{"type":"label","name":"iconClass","value":"bx bxs-virus-block"}]},
+ {"id":"_help_HAIOFBoYIIdO","title":"Nightly release","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/nightly-release"},{"type":"label","name":"iconClass","value":"bx bx-moon"}]},
+ {"id":"_help_ZmT9ln8XJX2o","title":"Read-only database","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/read-only-db"},{"type":"label","name":"iconClass","value":"bx bx-book-reader"}]},
+ {"id":"_help_TiQbQDgP8L5t","title":"Text Extraction (OCR)","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/ocr"},{"type":"label","name":"iconClass","value":"bx bx-file"}]}
+ ]},
+ {"id":"_help_GBBMSlVSOIGP","title":"AI","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/llm"},{"type":"label","name":"iconClass","value":"bx bx-bot"}],"children":[
+ {"id":"_help_bkPZAMT7d2sR","title":"Providers","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/llm/providers"},{"type":"label","name":"iconClass","value":"bx bx-cog"}],"children":[
+ {"id":"_help_eFhxp9laTW1S","title":"Subscription-based providers","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/llm/providers/subscription-based"},{"type":"label","name":"iconClass","value":"bx bx-coin"}]}
+ ]},
+ {"id":"_help_cRRrdZjgyhNc","title":"Privacy","type":"text","attributes":[{"type":"label","name":"iconClass","value":"bx bx-lock-alt"}]},
+ {"id":"_help_KOWBFgsZXJAD","title":"MCP","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/llm/mcp"},{"type":"label","name":"iconClass","value":"bx bx-network-chart"}]}
+ ]},
+ {"id":"_help_Y84QCbArmK3z","title":"Meeting transcription","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/transcription"},{"type":"label","name":"iconClass","value":"bx bx-microphone"}]},
+ {"id":"_help_CdNpE2pqjmI6","title":"Scripting","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts"},{"type":"label","name":"iconClass","value":"bx bxs-file-js"}],"children":[
+ {"id":"_help_yIhgI5H7A2Sm","title":"Frontend Basics","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics"},{"type":"label","name":"iconClass","value":"bx bx-window"}],"children":[
+ {"id":"_help_MgibgPcfeuGz","title":"Custom Widgets","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/custom-widget"},{"type":"label","name":"iconClass","value":"bx bxs-widget"}],"children":[
+ {"id":"_help_SynTBQiBsdYJ","title":"Widget Basics","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/custom-widget/widget-basics"},{"type":"label","name":"iconClass","value":"bx bx-file"}]},
+ {"id":"_help_GhurYZjh8e1V","title":"Note context aware widget","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/custom-widget/note-context-aware-widget"},{"type":"label","name":"iconClass","value":"bx bx-file"}]},
+ {"id":"_help_M8IppdwVHSjG","title":"Right pane widget","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/custom-widget/right-pane-widget"},{"type":"label","name":"iconClass","value":"bx bx-file"}]},
+ {"id":"_help_YNxAqkI5Kg1M","title":"Word count widget","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/custom-widget/word-count"},{"type":"label","name":"iconClass","value":"bx bx-file"}]},
+ {"id":"_help_VqGQnnPGnqAU","title":"CSS","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/custom-widget/css"},{"type":"label","name":"iconClass","value":"bx bx-file"}]},
+ {"id":"_help_gMkgcLJ6jBkg","title":"Troubleshooting","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/custom-widget/troubleshooting"},{"type":"label","name":"iconClass","value":"bx bx-file"}]}
+ ]},
+ {"id":"_help_es8OU2GuguFU","title":"Examples","type":"book","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/examples"},{"type":"label","name":"iconClass","value":"bx bx-code-alt"}],"children":[
+ {"id":"_help_TjLYAo3JMO8X","title":"\"New Task\" launcher button","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/examples/new-task-button"},{"type":"label","name":"iconClass","value":"bx bx-task"}]},
+ {"id":"_help_7kZPMD0uFwkH","title":"Downloading responses from Google Forms","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/examples/responses-from-google-forms"},{"type":"label","name":"iconClass","value":"bx bx-file"}]},
+ {"id":"_help_DL92EjAaXT26","title":"Using promoted attributes to configure scripts","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/examples/promoted-attributes-config"},{"type":"label","name":"iconClass","value":"bx bx-file"}]}
+ ]},
+ {"id":"_help_4Gn3psZKsfSm","title":"Launch Bar Widgets","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/launch-bar-widgets"},{"type":"label","name":"iconClass","value":"bx bx-dock-left"}],"children":[
+ {"id":"_help_IPArqVfDQ4We","title":"Note Title Widget","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/launch-bar-widgets/note-title"},{"type":"label","name":"iconClass","value":"bx bx-file"}]},
+ {"id":"_help_gcI7RPbaNSh3","title":"Analog Watch","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/launch-bar-widgets/analog-watch"},{"type":"label","name":"iconClass","value":"bx bx-file"}]}
+ ]},
+ {"id":"_help_KLsqhjaqh1QW","title":"Preact","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/preac"},{"type":"label","name":"iconClass","value":"bx bxl-react"}],"children":[
+ {"id":"_help_Bqde6BvPo05g","title":"Component libraries","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/preac/component-libraries"},{"type":"label","name":"iconClass","value":"bx bxs-component"}]},
+ {"id":"_help_ykYtbM9k3a7B","title":"Hooks","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/preac/hooks"},{"type":"label","name":"iconClass","value":"bx bx-question-mark"}]},
+ {"id":"_help_Sg9GrCtyftZf","title":"CSS","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/preac/css"},{"type":"label","name":"iconClass","value":"bx bxs-file-css"}]},
+ {"id":"_help_RSssb9S3xgSr","title":"Built-in components","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/preac/builtin-components"},{"type":"label","name":"iconClass","value":"bx bxs-component"}],"children":[
+ {"id":"_help_i9B4IW7b6V6z","title":"Widget showcase","type":"code","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/preac/builtin-components/widget-showcase"},{"type":"label","name":"iconClass","value":"bx bx-file"}],"mime":"text/jsx"}
+ ]}
+ ]},
+ {"id":"_help_irkwjdNtjcxR","title":"Frontend Events","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/events"},{"type":"label","name":"iconClass","value":"bx bx-rss"}]}
+ ]},
+ {"id":"_help_SPirpZypehBG","title":"Backend scripts","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/backend-basics"},{"type":"label","name":"iconClass","value":"bx bx-server"}],"children":[
+ {"id":"_help_fZ2IGYFXjkEy","title":"Server-side imports","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/backend-basics/server-imports"},{"type":"label","name":"iconClass","value":"bx bx-file"}]},
+ {"id":"_help_GPERMystNGTB","title":"Backend Events","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/backend-basics/events"},{"type":"label","name":"iconClass","value":"bx bx-rss"}]}
+ ]},
+ {"id":"_help_wqXwKJl6VpNk","title":"Common concepts","type":"book","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/common-concepts"},{"type":"label","name":"iconClass","value":"bx bxl-nodejs"}],"children":[
+ {"id":"_help_hA834UaHhSNn","title":"Script bundles","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/common-concepts/bundles"},{"type":"label","name":"iconClass","value":"bx bx-package"}]}
+ ]},
+ {"id":"_help_GLks18SNjxmC","title":"Script API","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/script-api"},{"type":"label","name":"iconClass","value":"bx bx-code-curly"}],"children":[
+ {"id":"_help_Q2z6av6JZVWm","title":"Frontend API","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/script-api/frontend"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/script-api/frontend-api"},{"type":"label","name":"iconClass","value":"bx bx-folder"}],"children":[
+ {"id":"_help_habiZ3HU8Kw8","title":"FNote","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/script-api/frontend/interfaces/FNote.html"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/script-api/frontend-api/fnote"},{"type":"label","name":"iconClass","value":"bx bx-file"}]}
+ ]},
+ {"id":"_help_MEtfsqa5VwNi","title":"Backend API","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/script-api/backend"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/script-api/backend-api"},{"type":"label","name":"iconClass","value":"bx bx-file"}]},
+ {"id":"_help_GFXVHyblVN3d","title":"Electron API","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/script-api/electron"},{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/script-api/electron-api"},{"type":"label","name":"iconClass","value":"bx bx-window-alt"}]},
+ {"id":"_help_ApVHZ8JY5ofC","title":"Day.js","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/script-api/day.js"},{"type":"label","name":"iconClass","value":"bx bx-calendar"}]}
+ ]},
+ {"id":"_help_vElnKeDNPSVl","title":"Logging","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/logging"},{"type":"label","name":"iconClass","value":"bx bx-terminal"}]},
+ {"id":"_help_cNpC0ITcfX0N","title":"Breaking changes","type":"book","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/breaking-changes"},{"type":"label","name":"iconClass","value":"bx bx-up-arrow-alt"}],"children":[
+ {"id":"_help_IjZS7iK5EXtb","title":"v0.107.0: Removal of the old layout","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/breaking-changes/old-layout-removal"},{"type":"label","name":"iconClass","value":"bx bx-layout"}]},
+ {"id":"_help_kTx7WqLdZ3Ry","title":"v0.106.0: Removal of cheerio","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/breaking-changes/cheerio-removal"},{"type":"label","name":"iconClass","value":"bx bx-file"}]},
+ {"id":"_help_YeOa2l7Pu39I","title":"v0.104.0: Disabling the Node integration in Electron","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/breaking-changes/disabling-node-integration"},{"type":"label","name":"iconClass","value":"bx bx-file"}]},
+ {"id":"_help_fqAK6opjUagR","title":"v0.103.0: Removal of axios","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/breaking-changes/axios-removal"},{"type":"label","name":"iconClass","value":"bx bx-file"}]},
+ {"id":"_help_pAJ0jWz16xFm","title":"v0.103.0: `cheerio` is now deprecated","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/breaking-changes/cheerio-deprecated"},{"type":"label","name":"iconClass","value":"bx bx-file"}]},
+ {"id":"_help_72dxvnbnkDFY","title":"v0.102.0: Upgrade to jQuery 4.0.0","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/breaking-changes/jquery4"},{"type":"label","name":"iconClass","value":"bx bx-file"}]}
+ ]},
+ {"id":"_help_fiHicjpHjIRJ","title":"Security","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/scripts/security"},{"type":"label","name":"iconClass","value":"bx bx-shield"}]}
+ ]},
+ {"id":"_help_Fm0j45KqyHpU","title":"Miscellaneous","type":"book","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/misc"},{"type":"label","name":"iconClass","value":"bx bx-info-circle"}],"children":[
+ {"id":"_help_WFbFXrgnDyyU","title":"Privacy Policy","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/misc/privacy-policy"},{"type":"label","name":"iconClass","value":"bx bx-file"}]},
+ {"id":"_help_NcsmUYZRWEW4","title":"Patterns of personal knowledge","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/misc/patterns-of-personal-knowledge"},{"type":"label","name":"iconClass","value":"bx bx-file"}]},
+ {"id":"_help_d1Ap6Pg6IjaJ","title":"License","type":"text","attributes":[{"type":"label","name":"docUrl","value":"https://docs.triliumnotes.org/user-guide/misc/license"},{"type":"label","name":"iconClass","value":"bx bx-file"}]}
+ ]}
+]
\ No newline at end of file
diff --git a/apps/server/src/in_app_help_provider.spec.ts b/apps/server/src/in_app_help_provider.spec.ts
index 23a31b3d4b..44b8baee9b 100644
--- a/apps/server/src/in_app_help_provider.spec.ts
+++ b/apps/server/src/in_app_help_provider.spec.ts
@@ -1,9 +1,10 @@
import fs from "fs";
+import path from "path";
import { afterEach, describe, expect, it, vi } from "vitest";
// in_app_help_provider is loaded during boot (setup.ts), so vi.mock can't
// intercept "fs" — spy on the real (shared) fs.readFileSync instead.
-import NodejsInAppHelpProvider from "./in_app_help_provider.js";
+import NodejsInAppHelpProvider, { getHelpAssetDir } from "./in_app_help_provider.js";
afterEach(() => vi.restoreAllMocks());
@@ -16,6 +17,23 @@ describe("NodejsInAppHelpProvider", () => {
expect(provider.getHelpHiddenSubtreeData()).toEqual(data);
});
+ // Every becca load asks for the tree, and there are several in a session.
+ it("reads each file once, however often it is asked", () => {
+ const readFileSync = vi.spyOn(fs, "readFileSync")
+ .mockReturnValue(Buffer.from(JSON.stringify([])) as never);
+
+ const provider = new NodejsInAppHelpProvider();
+ for (let i = 0; i < 3; i++) {
+ provider.getHelpHiddenSubtreeData();
+ provider.getHelpContent();
+ }
+
+ expect(readFileSync.mock.calls.map(([ file ]) => String(file).replace(/^.*[\\/]/, "")))
+ .toEqual([ "help_meta.json", "help_content.json" ]);
+ });
+
+ // A failed read is remembered too, rather than retried on every load: the files ship with the
+ // application, so one that is missing now will be missing for the life of the process.
it("returns an empty list and warns when the meta file cannot be read", () => {
const warnSpy = vi.spyOn(console, "warn").mockImplementation(() => {});
vi.spyOn(fs, "readFileSync").mockImplementation(() => {
@@ -26,4 +44,19 @@ describe("NodejsInAppHelpProvider", () => {
expect(provider.getHelpHiddenSubtreeData()).toEqual([]);
expect(warnSpy).toHaveBeenCalled();
});
+
+ it("reads a help asset by its path, and nothing outside the asset directory", async () => {
+ const provider = new NodejsInAppHelpProvider();
+ const inside = path.join(getHelpAssetDir(), "User Guide", "pic.png");
+ const readFile = vi.spyOn(fs.promises, "readFile").mockResolvedValue(Buffer.from([ 1, 2 ]));
+
+ expect(await provider.getHelpAsset("User Guide/pic.png")).toEqual(Buffer.from([ 1, 2 ]));
+ expect(path.resolve(String(readFile.mock.calls[0][0]))).toBe(path.resolve(inside));
+
+ expect(await provider.getHelpAsset("../../secret.txt")).toBeNull();
+ expect(readFile).toHaveBeenCalledTimes(1);
+
+ readFile.mockRejectedValue(new Error("ENOENT"));
+ expect(await provider.getHelpAsset("User Guide/missing.png")).toBeNull();
+ });
});
diff --git a/apps/server/src/in_app_help_provider.ts b/apps/server/src/in_app_help_provider.ts
index 1a5299100a..a1638b106e 100644
--- a/apps/server/src/in_app_help_provider.ts
+++ b/apps/server/src/in_app_help_provider.ts
@@ -1,21 +1,79 @@
-import type { HiddenSubtreeItem } from "@triliumnext/commons";
+import type { HelpBundle, HiddenSubtreeItem } from "@triliumnext/commons";
import { InAppHelpProvider } from "@triliumnext/core";
import fs from "fs";
import path from "path";
+import { assetUrlFragment } from "./services/asset_path.js";
import { RESOURCE_DIR } from "./services/resource_dir.js";
+import { isDev } from "./services/utils.js";
+/**
+ * Serves the in-app help from the two artifacts `edit-docs` builds out of `docs/User Guide`:
+ * the note tree and the rendered content of its pages.
+ */
export default class NodejsInAppHelpProvider extends InAppHelpProvider {
+ /** The guide only changes with the application, so both files are read once per process. */
+ private helpMeta: HiddenSubtreeItem[] | null = null;
+ private helpContent: HelpBundle | null = null;
+
+ /**
+ * The tree is asked for on every becca load, of which there are several in a session — a
+ * restore, an import, a consistency check — so it is worth not re-reading a fifth of a
+ * megabyte each time. Callers only read it: the injection builds notes from the items rather
+ * than writing to them.
+ */
getHelpHiddenSubtreeData(): HiddenSubtreeItem[] {
- const helpDir = path.join(RESOURCE_DIR, "doc_notes", "en", "User Guide");
- const metaFilePath = path.join(helpDir, "!!!meta.json");
+ if (!this.helpMeta) {
+ this.helpMeta = readHelpFile<HiddenSubtreeItem[]>("help_meta.json") ?? [];
+ }
+ return this.helpMeta;
+ }
+
+ getHelpContent(): HelpBundle {
+ if (!this.helpContent) {
+ this.helpContent = readHelpFile<HelpBundle>("help_content.json") ?? {};
+ }
+ return this.helpContent;
+ }
+
+ getHelpAssetBase(): string {
+ return `${assetUrlFragment}/help`;
+ }
+
+ async getHelpAsset(assetPath: string): Promise<Uint8Array | null> {
+ const root = path.resolve(getHelpAssetDir());
+ const filePath = path.resolve(root, assetPath);
+ if (!filePath.startsWith(root + path.sep)) {
+ return null;
+ }
try {
- return JSON.parse(fs.readFileSync(metaFilePath).toString("utf-8"));
- } catch (e) {
- console.warn(e);
- return [];
+ return await fs.promises.readFile(filePath);
+ } catch {
+ return null;
}
}
}
+
+/**
+ * Where the in-app help's images and attachments live: the Markdown export in a source checkout,
+ * the copy the build makes (see `copyServerAssets()`) in a packaged one.
+ */
+export function getHelpAssetDir() {
+ if (isDev) {
+ return path.join(RESOURCE_DIR, "..", "..", "..", "..", "docs", "User Guide");
+ }
+ return path.join(RESOURCE_DIR, "help");
+}
+
+function readHelpFile<T>(fileName: string): T | null {
+ const filePath = path.join(RESOURCE_DIR, "help", fileName);
+
+ try {
+ return JSON.parse(fs.readFileSync(filePath).toString("utf-8")) as T;
+ } catch (e) {
+ console.warn(e);
+ return null;
+ }
+}
diff --git a/apps/server/src/routes/assets.ts b/apps/server/src/routes/assets.ts
index 95653ba358..45e7e73699 100644
--- a/apps/server/src/routes/assets.ts
+++ b/apps/server/src/routes/assets.ts
@@ -4,6 +4,7 @@ import { existsSync } from "fs";
import path from "path";
import type serveStatic from "serve-static";
+import { getHelpAssetDir } from "../in_app_help_provider.js";
import { assetUrlFragment } from "../services/asset_path.js";
import auth from "../services/auth.js";
import port from "../services/port.js";
@@ -65,8 +66,10 @@ async function register(app: express.Application) {
cacheDir: path.join(clientDir, "../..", ".cache", `vite-${port}`)
});
app.use(`/${assetUrlFragment}/`, (req, res, next) => {
- if (req.url.startsWith("/images/") || req.url.startsWith("/doc_notes/")) {
- // Images and doc notes are served as static assets from the server.
+ if (req.url.startsWith("/images/") || req.url.startsWith("/help/")) {
+ // Images and the in-app help's assets are served as static assets from the server.
+ // Anything not listed here is handed to Vite, which answers unknown paths with
+ // index.html — a 200 that looks fine until you read the body.
next();
return;
}
@@ -112,7 +115,10 @@ async function register(app: express.Application) {
}
app.use(`/pdfjs/`, persistentCacheStatic(getPdfjsAssetDir()));
app.use(`/${assetUrlFragment}/images`, persistentCacheStatic(path.join(resourceDir, "assets", "images")));
- app.use(`/${assetUrlFragment}/doc_notes`, persistentCacheStatic(path.join(resourceDir, "assets", "doc_notes")));
+ // Images and attachments of the in-app help. They are not committed under the server's assets
+ // — the User Guide owns them — so in a source checkout they are served straight out of docs/,
+ // while a packaged build copies them in (see scripts/build.ts).
+ app.use(`/${assetUrlFragment}/help`, persistentCacheStatic(getHelpAssetDir()));
// `vX` is a version-independent alias so custom themes and scripts can reference built-in assets
// without naming a version they would have to bump on every upgrade. It serves the same files as
// the versioned routes above, but without `maxAge`: the URL no longer changes between releases,
diff --git a/apps/server/src/services/hidden_subtree.spec.ts b/apps/server/src/services/hidden_subtree.spec.ts
index 736a60dd06..9b72518340 100644
--- a/apps/server/src/services/hidden_subtree.spec.ts
+++ b/apps/server/src/services/hidden_subtree.spec.ts
@@ -1,5 +1,5 @@
import { deferred, LOCALES } from "@triliumnext/commons";
-import { becca, becca_loader, binary_utils, cls, hidden_subtree as hiddenSubtreeService, i18n, note_service as notes, TaskContext } from "@triliumnext/core";
+import { becca, becca_loader, binary_utils, cls, getSql, hidden_subtree as hiddenSubtreeService, i18n, note_service as notes, TaskContext } from "@triliumnext/core";
import protectedSessionService from "@triliumnext/core/src/services/protected_session.js";
import { beforeAll, describe, expect, it } from "vitest";
@@ -32,38 +32,36 @@ describe("Hidden Subtree", () => {
expect(childBranches![0].parentNoteId).toStrictEqual("_lbVisibleLaunchers");
});
- it("should enforce the correct placement of help", () => {
- // First, verify the help note exists in its original correct location
- const originalBranch = becca.getBranchFromChildAndParent("_help_Vc8PjrjAGuOp", "_help_gh7bpGYxajRS");
- expect(originalBranch).toBeDefined();
- expect(originalBranch?.parentNoteId).toBe("_help_gh7bpGYxajRS");
-
- // Move the help note to an incorrect location (_help root instead of its proper parent)
- cls.init(() => {
- branches.moveBranchToNote(originalBranch!, "_help");
- });
-
- // Verify the note was moved to the wrong location
- const movedBranches = becca.notes["_help_Vc8PjrjAGuOp"]?.getParentBranches()
- .filter((b) => !b.isDeleted);
- expect(movedBranches).toBeDefined();
- expect(movedBranches![0].parentNoteId).toBe("_help");
+ it("provides the help subtree as virtual notes, with no persisted rows left behind", () => {
+ // The help subtree is injected into becca from the bundled meta as virtual notes;
+ // the fixture DB carried persisted _help rows which migration 242 must have
+ // removed, entity_changes included.
+ const helpRoot = becca.getNoteOrThrow("_help");
+ expect(helpRoot.isVirtual).toBe(true);
+ expect(helpRoot.getParentNotes().map((n) => n.noteId)).toEqual(["_hidden"]);
+ expect(helpRoot.getChildNotes().length).toBeGreaterThan(0);
+
+ const page = becca.getNoteOrThrow("_help_Vc8PjrjAGuOp");
+ expect(page.isVirtual).toBe(true);
+
+ const sql = getSql();
+ expect(sql.getValue(/*sql*/`SELECT COUNT(*) FROM notes WHERE noteId LIKE '\\_help%' ESCAPE '\\'`)).toBe(0);
+ expect(sql.getValue(/*sql*/`SELECT COUNT(*) FROM branches WHERE noteId LIKE '\\_help%' ESCAPE '\\' OR parentNoteId LIKE '\\_help%' ESCAPE '\\'`)).toBe(0);
+ expect(sql.getValue(/*sql*/`SELECT COUNT(*) FROM attributes WHERE noteId LIKE '\\_help%' ESCAPE '\\'`)).toBe(0);
+ expect(sql.getValue(/*sql*/`SELECT COUNT(*) FROM entity_changes WHERE entityId LIKE '\\_help%' ESCAPE '\\'`)).toBe(0);
+ });
- // Run the hidden subtree integrity check
- cls.init(() => {
- hiddenSubtreeService.checkHiddenSubtree(true);
- });
+ it("rejects moving a help note", () => {
+ const originalBranch = becca.getBranchFromChildAndParent("_help_Vc8PjrjAGuOp", "_help_gh7bpGYxajRS");
+ expect(originalBranch?.isVirtual).toBe(true);
- // Verify that the integrity check moved the help note back to its correct location
- const correctedBranches = becca.notes["_help_Vc8PjrjAGuOp"]?.getParentBranches()
- .filter((b) => !b.isDeleted);
- expect(correctedBranches).toBeDefined();
- expect(correctedBranches![0].parentNoteId).toBe("_help_gh7bpGYxajRS");
+ // validateParentChild rejects the move before anything is touched
+ const result = originalBranch && cls.init(() => branches.moveBranchToNote(originalBranch, "_help"));
+ expect(Array.isArray(result) ? result[1] : result).toMatchObject({ success: false });
- // Ensure the note is no longer under the incorrect parent
- const helpRootChildren = becca.notes["_help"]?.getChildNotes();
- const incorrectChild = helpRootChildren?.find(note => note.noteId === "_help_Vc8PjrjAGuOp");
- expect(incorrectChild).toBeUndefined();
+ // structure is unchanged
+ const parents = becca.getNoteOrThrow("_help_Vc8PjrjAGuOp").getParentNotes().map((n) => n.noteId);
+ expect(parents).toEqual(["_help_gh7bpGYxajRS"]);
});
it("enforces renames of launcher notes", () => {
@@ -96,19 +94,15 @@ describe("Hidden Subtree", () => {
expect(updatedBoardTemplate?.title).not.toBe("My renamed board");
});
- it("enforces webviewSrc of templates", () => {
- const apiRefNote = becca.getNote("_help_9qPsTWBorUhQ");
- expect(apiRefNote).toBeDefined();
+ it("rejects attribute changes on virtual help notes", () => {
+ const apiRefNote = becca.getNoteOrThrow("_help_9qPsTWBorUhQ");
+ expect(apiRefNote.isVirtual).toBe(true);
- cls.init(() => {
- apiRefNote!.setAttribute("label", "webViewSrc", "foo");
- apiRefNote!.save();
- hiddenSubtreeService.checkHiddenSubtree(true);
- });
+ expect(() => cls.init(() => apiRefNote.setAttribute("label", "webViewSrc", "foo"))).toThrow(/virtual/);
- const updatedApiRefNote = becca.getNote("_help_9qPsTWBorUhQ");
- expect(updatedApiRefNote).toBeDefined();
- expect(updatedApiRefNote?.getLabelValue("webViewSrc")).not.toBe("foo");
+ // nothing was persisted; reload to shed the in-memory leftover of the failed save
+ cls.init(() => becca_loader.reload("test"));
+ expect(becca.getNoteOrThrow("_help_9qPsTWBorUhQ").getLabelValue("webViewSrc")).not.toBe("foo");
});
it("maintains launchers hidden, if they were shown by default but moved by the user", () => {
diff --git a/apps/server/src/services/llm/index.spec.ts b/apps/server/src/services/llm/index.spec.ts
index 2a1a388ad5..42654c3cce 100644
--- a/apps/server/src/services/llm/index.spec.ts
+++ b/apps/server/src/services/llm/index.spec.ts
@@ -2,32 +2,24 @@ import { describe, expect, it, vi } from "vitest";
const registrations = vi.hoisted(() => ({
hostProviders: [] as { type: string; factory: () => unknown }[],
- docNoteReader: undefined as ((note: unknown) => string | null) | undefined,
- skillReader: undefined as ((file: string) => string | null) | undefined,
- toolRegistryLoaders: [] as (() => Promise<unknown>)[]
+ skillReader: undefined as ((file: string) => string | null) | undefined
}));
vi.mock("@triliumnext/core/src/services/llm/host_providers.js", () => ({
registerHostProvider: (type: string, factory: () => unknown) => { registrations.hostProviders.push({ type, factory }); }
}));
+// Partial: dropping the tool-registry mock brings the real tool graph into this suite, and the
+// skills tool reads the catalog at import time.
vi.mock("@triliumnext/core/src/services/llm/skills.js", async (importOriginal) => ({
...await importOriginal<typeof import("@triliumnext/core/src/services/llm/skills.js")>(),
registerSkillReader: (reader: (file: string) => string | null) => { registrations.skillReader = reader; }
}));
-vi.mock("@triliumnext/core/src/services/llm/tools/helpers.js", async (importOriginal) => ({
- ...await importOriginal<typeof import("@triliumnext/core/src/services/llm/tools/helpers.js")>(),
- registerDocNoteHtmlReader: (reader: (note: unknown) => string | null) => { registrations.docNoteReader = reader; }
-}));
-vi.mock("@triliumnext/core/src/services/llm/tools/registration.js", () => ({
- registerToolRegistryLoader: (loader: () => Promise<unknown>) => { registrations.toolRegistryLoaders.push(loader); }
-}));
import { registerServerLlmExtensions } from "./index.js";
import { AntigravityAgentProvider } from "./providers/antigravity_agent.js";
import { ClaudeAgentProvider } from "./providers/claude_agent.js";
import { CodexAgentProvider } from "./providers/codex_agent.js";
import { CopilotAgentProvider } from "./providers/copilot_agent.js";
-import { helpTools } from "./tools/help_tools.js";
describe("registerServerLlmExtensions", () => {
it("hands core every piece of the stack that needs Node", async () => {
@@ -43,14 +35,8 @@ describe("registerServerLlmExtensions", () => {
expect(await registrations.hostProviders[1].factory()).toBeInstanceOf(CopilotAgentProvider);
expect(await registrations.hostProviders[2].factory()).toBeInstanceOf(AntigravityAgentProvider);
expect(await registrations.hostProviders[3].factory()).toBeInstanceOf(CodexAgentProvider);
- // The User Guide reader, which core's note-content helper calls for doc notes.
- expect(registrations.docNoteReader).toBeTypeOf("function");
// The skill sheets: core owns the catalog and the tool, the server only
// knows how to get a sheet off disk.
expect(registrations.skillReader?.("search_syntax.md")).toContain("#");
- // The one registry still backed by files this build alone carries,
- // registered as a loader so the tool stack stays out of the startup path.
- expect(registrations.toolRegistryLoaders).toHaveLength(1);
- expect(await registrations.toolRegistryLoaders[0]()).toBe(helpTools);
});
});
diff --git a/apps/server/src/services/llm/index.ts b/apps/server/src/services/llm/index.ts
index 98d067a18b..30d47f220b 100644
--- a/apps/server/src/services/llm/index.ts
+++ b/apps/server/src/services/llm/index.ts
@@ -4,9 +4,9 @@
* The stack itself lives in `@triliumnext/core`, so the browser-hosted
* (standalone) build can run it too. What could not follow it there is anything
* that needs Node: the providers that spawn the Claude Code and GitHub Copilot
- * CLIs, Google's Antigravity ACP server and the Codex ACP adapter, and the User Guide tools, which read pages off disk. Core exposes a seam
- * for each; this is where the server fills them in — including the skill sheets,
- * whose catalog is core's while the reading is per-runtime.
+ * CLIs, Google's Antigravity ACP server and the Codex ACP adapter, and the skill
+ * sheets, whose catalog is core's while the reading is per-runtime. Core exposes
+ * a seam for each; this is where the server fills them in.
*
* Each seam is keyed rather than bespoke, so the next host-provided provider is
* one more line here and one more entry in core's HOST_PROVIDED_TYPES.
@@ -14,11 +14,8 @@
import { registerHostProvider } from "@triliumnext/core/src/services/llm/host_providers.js";
import { registerSkillReader } from "@triliumnext/core/src/services/llm/skills.js";
-import { registerDocNoteHtmlReader } from "@triliumnext/core/src/services/llm/tools/helpers.js";
-import { registerToolRegistryLoader } from "@triliumnext/core/src/services/llm/tools/registration.js";
import { loadSkillSheet } from "../../core_assets.js";
-import { getDocNoteHtml } from "./tools/doc_notes.js";
/**
* Contribute those pieces to core. Called once from startup, beside the other
@@ -26,9 +23,9 @@ import { getDocNoteHtml } from "./tools/doc_notes.js";
* routes reach the stack directly, so what a chat can use must not depend on
* whether some module that happens to import this one was loaded first.
*
- * The providers and the help tools are registered as loaders, not values: their
- * modules carry the agent SDKs and the tool stack, and importing them here
- * would put all of that in the startup path of every install. The registration
+ * The providers are registered as loaders, not values: their modules carry the
+ * agent SDKs, and importing them here would put all of that in the startup path
+ * of every install. The registration
* seams are light on purpose — core resolves each loader on first use.
*/
export function registerServerLlmExtensions() {
@@ -36,7 +33,5 @@ export function registerServerLlmExtensions() {
registerHostProvider("copilot-agent", async () => new (await import("./providers/copilot_agent.js")).CopilotAgentProvider());
registerHostProvider("antigravity-agent", async () => new (await import("./providers/antigravity_agent.js")).AntigravityAgentProvider());
registerHostProvider("codex-agent", async () => new (await import("./providers/codex_agent.js")).CodexAgentProvider());
- registerDocNoteHtmlReader(getDocNoteHtml);
registerSkillReader(loadSkillSheet);
- registerToolRegistryLoader(async () => (await import("./tools/help_tools.js")).helpTools);
}
diff --git a/apps/server/src/services/llm/tools/doc_notes.spec.ts b/apps/server/src/services/llm/tools/doc_notes.spec.ts
deleted file mode 100644
index 7a47520b45..0000000000
--- a/apps/server/src/services/llm/tools/doc_notes.spec.ts
+++ /dev/null
@@ -1,53 +0,0 @@
-import type { BNote } from "@triliumnext/core";
-import { beforeEach, describe, expect, it, vi } from "vitest";
-
-/** Fake on-disk help pages: path suffix → HTML content. */
-const docFiles = vi.hoisted(() => new Map<string, string>());
-
-// Doc notes read their HTML from disk — serve them from the docFiles fixture
-// map and pass every other path through to the real fs.
-vi.mock("fs", async (importOriginal) => {
- const actual = await importOriginal<typeof import("fs")>();
- const readFileSync = ((filePath: unknown, ...rest: unknown[]) => {
- const pathStr = String(filePath);
- for (const [suffix, content] of docFiles) {
- if (pathStr.endsWith(suffix)) return content;
- }
- if (pathStr.includes("doc_notes")) {
- throw new Error(`ENOENT: ${pathStr}`);
- }
- return (actual.readFileSync as (...args: unknown[]) => unknown)(filePath, ...rest);
- }) as typeof actual.readFileSync;
- const mocked = { ...actual, readFileSync };
- return { ...mocked, default: mocked };
-});
-
-import { getDocNoteHtml } from "./doc_notes.js";
-
-/** Minimal BNote stub exposing only the label lookup the reader performs. */
-function docNoteStub(docName: string | null) {
- return {
- noteId: "n1",
- type: "doc",
- getLabelValue: (name: string) => (name === "docName" ? docName : null)
- } as unknown as BNote;
-}
-
-describe("getDocNoteHtml", () => {
- beforeEach(() => docFiles.clear());
-
- it("reads the page HTML from disk under doc_notes/en", () => {
- docFiles.set("Cloning Notes.html", "<h2>Cloning</h2>");
- expect(getDocNoteHtml(docNoteStub("User Guide/User Guide/Cloning Notes"))).toBe("<h2>Cloning</h2>");
- });
-
- it("returns null without a docName label, on a missing file, and on path traversal attempts", () => {
- expect(getDocNoteHtml(docNoteStub(null))).toBeNull();
- expect(getDocNoteHtml(docNoteStub("User Guide/Nonexistent Page"))).toBeNull();
- // Traversal attempts must be rejected before touching the filesystem —
- // register a catch-all fixture so any read would be visible.
- docFiles.set(".html", "<p>leaked</p>");
- expect(getDocNoteHtml(docNoteStub("../../../../etc/passwd"))).toBeNull();
- expect(getDocNoteHtml(docNoteStub("/etc/passwd"))).toBeNull();
- });
-});
diff --git a/apps/server/src/services/llm/tools/doc_notes.ts b/apps/server/src/services/llm/tools/doc_notes.ts
deleted file mode 100644
index 6c1924ed95..0000000000
--- a/apps/server/src/services/llm/tools/doc_notes.ts
+++ /dev/null
@@ -1,39 +0,0 @@
-/**
- * Filesystem-backed resolution of in-app help pages, for the help tools.
- *
- * Kept out of `@triliumnext/core`'s LLM code because it is the one tool helper
- * that reads from `RESOURCE_DIR`: the User Guide ships as static HTML on disk,
- * which the browser-hosted (standalone) build has no way to read synchronously.
- */
-
-import type { BNote } from "@triliumnext/core";
-import { readFileSync } from "fs";
-import path from "path";
-
-import resourceDir from "../../resource_dir.js";
-
-/**
- * Resolve the on-disk HTML of a `doc` note (in-app help / User Guide pages,
- * identified by their `#docName` label), or null if it cannot be resolved.
- * The User Guide ships in English only, so the `en` tree is always used
- * (mirroring the client's doc_renderer behaviour).
- */
-export function getDocNoteHtml(note: BNote): string | null {
- const docName = note.getLabelValue("docName");
- if (!docName) {
- return null;
- }
-
- const docNotesDir = path.resolve(resourceDir.RESOURCE_DIR, "doc_notes");
- const filePath = path.resolve(docNotesDir, "en", `${docName}.html`);
- if (!filePath.startsWith(docNotesDir + path.sep)) {
- // Path traversal guard — the docName label is note data, not trusted input.
- return null;
- }
-
- try {
- return readFileSync(filePath, "utf-8");
- } catch {
- return null;
- }
-}
diff --git a/apps/server/src/services/llm/tools/help_tools.spec.ts b/apps/server/src/services/llm/tools/help_tools.spec.ts
deleted file mode 100644
index 83f91d89cc..0000000000
--- a/apps/server/src/services/llm/tools/help_tools.spec.ts
+++ /dev/null
@@ -1,178 +0,0 @@
-import { becca, becca_easy_mocking } from "@triliumnext/core";
-import { registerDocNoteHtmlReader } from "@triliumnext/core/src/services/llm/tools/helpers.js";
-import type { ToolDefinition } from "@triliumnext/core/src/services/llm/tools/tool_registry.js";
-import { beforeEach, describe, expect, it, vi } from "vitest";
-
-import { getDocNoteHtml } from "./doc_notes.js";
-import { helpTools, resetHelpIndex } from "./help_tools.js";
-
-// Doc-note HTML reaches core through a host-registered reader — the server's is
-// filesystem-backed. Registering it here mirrors what services/llm/index.ts
-// does in production.
-registerDocNoteHtmlReader(getDocNoteHtml);
-
-const { buildNote } = becca_easy_mocking;
-
-/** Fake on-disk help pages: path suffix → HTML content. */
-const docFiles = vi.hoisted(() => new Map<string, string>());
-
-// Help pages are doc notes whose HTML lives on disk — serve them from the
-// docFiles fixture map and pass every other path through to the real fs.
-vi.mock("fs", async (importOriginal) => {
- const actual = await importOriginal<typeof import("fs")>();
- const readFileSync = ((filePath: unknown, ...rest: unknown[]) => {
- const pathStr = String(filePath);
- for (const [suffix, content] of docFiles) {
- if (pathStr.endsWith(suffix)) return content;
- }
- if (pathStr.includes("doc_notes")) {
- throw new Error(`ENOENT: ${pathStr}`);
- }
- return (actual.readFileSync as (...args: unknown[]) => unknown)(filePath, ...rest);
- }) as typeof actual.readFileSync;
- const mocked = { ...actual, readFileSync };
- return { ...mocked, default: mocked };
-});
-
-function getTool(name: string): ToolDefinition {
- for (const [n, def] of helpTools) {
- if (n === name) return def;
- }
- throw new Error(`Tool ${name} not registered`);
-}
-
-/** A miniature `_help` subtree: root → section → page. */
-function buildHelpTree() {
- buildNote({
- id: "_help",
- title: "User Guide",
- children: [
- {
- id: "_help_basics",
- title: "Basic Concepts",
- children: [
- {
- id: "_help_notes",
- title: "Notes",
- children: [
- { id: "_help_cloning", title: "Cloning Notes", type: "doc", "#docName": "User Guide/User Guide/Cloning Notes" }
- ]
- }
- ]
- },
- { id: "_help_install", title: "Installation & Setup", type: "doc", "#docName": "User Guide/User Guide/Installation" }
- ]
- });
- docFiles.set("Cloning Notes.html", "<p>A note can be placed in multiple locations. Prefix &amp; installation hints.</p>");
- docFiles.set("Installation.html", "<p>Download the desktop app.</p>");
-}
-
-interface SearchHelpResult {
- totalResults: number;
- results: { noteId: string; title: string; path: string; contentPreview: string | null }[];
-}
-
-describe("help_tools", () => {
- beforeEach(() => {
- becca.reset();
- resetHelpIndex();
- docFiles.clear();
- vi.clearAllMocks();
- });
-
- it("reads only the User Guide, which ships with Trilium, never the user's data", () => {
- const readsUserData = (name: string) => {
- const definition = getTool(name);
- return definition.mutates ? true : definition.readsUserData;
- };
- expect([ "search_help", "get_help_toc" ].map(readsUserData)).toEqual([ false, false ]);
- });
-
- describe("search_help", () => {
- it("matches page bodies (which live on disk, invisible to regular search) and returns breadcrumb paths", () => {
- buildHelpTree();
-
- const result = getTool("search_help").execute({ query: "multiple locations" }) as SearchHelpResult;
-
- expect(result.totalResults).toBe(1);
- expect(result.results[0]).toMatchObject({
- noteId: "_help_cloning",
- title: "Cloning Notes",
- path: "Basic Concepts > Notes"
- });
- expect(result.results[0].contentPreview).toContain("multiple locations");
- });
-
- it("requires every query word (AND semantics)", () => {
- buildHelpTree();
-
- const result = getTool("search_help").execute({ query: "cloning fnordhotzenplotz" }) as SearchHelpResult;
-
- expect(result.totalResults).toBe(0);
- expect(result.results).toEqual([]);
- });
-
- it("ranks title matches above body matches and respects the limit", () => {
- buildHelpTree();
- // "installation" occurs in the Installation page title AND in the Cloning page body.
-
- const all = getTool("search_help").execute({ query: "installation" }) as SearchHelpResult;
- expect(all.totalResults).toBe(2);
- expect(all.results.map(r => r.noteId)).toEqual(["_help_install", "_help_cloning"]);
-
- const limited = getTool("search_help").execute({ query: "installation", limit: 1 }) as SearchHelpResult;
- expect(limited.totalResults).toBe(2);
- expect(limited.results).toHaveLength(1);
- });
-
- it("strips punctuation and deduplicates query words", () => {
- buildHelpTree();
-
- // "locations?" would never match as-is; repeated words must not double-count.
- const punctuated = getTool("search_help").execute({ query: "multiple locations?" }) as SearchHelpResult;
- expect(punctuated.results.map(r => r.noteId)).toEqual(["_help_cloning"]);
-
- const deduped = getTool("search_help").execute({ query: "installation installation" }) as SearchHelpResult;
- // Title match still outranks body match — the duplicate word doesn't skew scoring.
- expect(deduped.results.map(r => r.noteId)).toEqual(["_help_install", "_help_cloning"]);
- });
-
- it("rejects an empty query", () => {
- buildHelpTree();
- expect(getTool("search_help").execute({ query: " " }))
- .toEqual({ error: "Empty search query." });
- expect(getTool("search_help").execute({ query: "?!" }))
- .toEqual({ error: "Empty search query." });
- });
-
- it("returns an error when the help subtree is absent or empty", () => {
- expect(getTool("search_help").execute({ query: "anything" }))
- .toEqual({ error: "The built-in User Guide is not available in this installation." });
-
- buildNote({ id: "_help", title: "User Guide" }); // present but not yet populated
- expect(getTool("search_help").execute({ query: "anything" }))
- .toEqual({ error: "The built-in User Guide is not available in this installation." });
- });
- });
-
- describe("get_help_toc", () => {
- it("returns an indented outline of every help page with its noteId", () => {
- buildHelpTree();
-
- const result = getTool("get_help_toc").execute({}) as { pageCount: number; toc: string };
-
- expect(result.pageCount).toBe(4);
- expect(result.toc.split("\n")).toEqual([
- "Basic Concepts (_help_basics)",
- " Notes (_help_notes)",
- " Cloning Notes (_help_cloning)",
- "Installation & Setup (_help_install)"
- ]);
- });
-
- it("returns an error when the help subtree is absent", () => {
- expect(getTool("get_help_toc").execute({}))
- .toEqual({ error: "The built-in User Guide is not available in this installation." });
- });
- });
-});
diff --git a/apps/standalone/src/assets/help_meta.json b/apps/standalone/src/assets/help_meta.json
deleted file mode 100644
index 901b59a187..0000000000
--- a/apps/standalone/src/assets/help_meta.json
+++ /dev/null
@@ -1 +0,0 @@
-[{"id":"_help_BOCnjTMBCoxW","title":"Feature Highlights","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/feature-highlights"},{"name":"iconClass","value":"bx bx-star","type":"label"}],"enforceAttributes":true},{"id":"_help_Otzi9La2YAUX","title":"Installation & Setup","type":"book","attributes":[{"name":"iconClass","value":"bx bx-cog","type":"label"}],"children":[{"id":"_help_poXkQfguuA0U","title":"Desktop Installation","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/desktop"},{"name":"iconClass","value":"bx bx-desktop","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_nRqcgfTb97uV","title":"Using the desktop application as a server","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/desktop/desktop-as-server"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true},{"id":"_help_Rp0q8bSP6Ayl","title":"System Requirements","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/desktop/system-requirements"},{"name":"iconClass","value":"bx bx-chip","type":"label"}],"enforceAttributes":true},{"id":"_help_Un4wj2Mak2Ky","title":"Nix flake","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/desktop/nix-flake"},{"name":"iconClass","value":"bx bxl-tux","type":"label"}],"enforceAttributes":true},{"id":"_help_swSFivWk6KkA","title":"Network Access","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/desktop/network-access"},{"name":"iconClass","value":"bx bx-network-chart","type":"label"}],"enforceAttributes":true},{"id":"_help_7iwde4lsKc6O","title":"Tray icon & automatic startup","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/desktop/tray-icon-and-startup"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true},{"id":"_help_hvRfsDr591WP","title":"Troubleshooting","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/desktop/troubleshooting"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true}]},{"id":"_help_WOcw2SLH6tbX","title":"Server Installation","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/server"},{"name":"iconClass","value":"bx bx-server","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_Dgg7bR3b6K9j","title":"1. Installing the server","type":"book","attributes":[{"name":"iconClass","value":"bx bx-folder","type":"label"}],"children":[{"id":"_help_3tW6mORuTHnB","title":"Packaged version for Linux","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/server/installation/packaged-server"},{"name":"iconClass","value":"bx bxl-tux","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_ZNAjFcxqHr9V","title":"Simple auto-update for server","type":"doc","attributes":[{"name":"iconClass","value":"bx bx-file","type":"label"}]}]},{"id":"_help_rWX5eY045zbE","title":"Using Docker","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/server/installation/docker"},{"name":"iconClass","value":"bx bxl-docker","type":"label"}],"enforceAttributes":true},{"id":"_help_moVgBcoxE3EK","title":"On NixOS","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/server/installation/nixos"},{"name":"iconClass","value":"bx bxl-tux","type":"label"}],"enforceAttributes":true},{"id":"_help_J1Bb6lVlwU5T","title":"Manually","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/server/installation/manual"},{"name":"iconClass","value":"bx bx-code-alt","type":"label"}],"enforceAttributes":true},{"id":"_help_DCmT6e7clMoP","title":"Using Kubernetes","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/server/installation/kubernetes"},{"name":"iconClass","value":"bx bxl-kubernetes","type":"label"}],"enforceAttributes":true},{"id":"_help_klCWNks3ReaQ","title":"Multiple server instances","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/server/installation/multiple-instances"},{"name":"iconClass","value":"bx bxs-user-account","type":"label"}],"enforceAttributes":true}]},{"id":"_help_vcjrb3VVYPZI","title":"2. Reverse proxy","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/server/reverse-proxy"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_ud6MShXL4WpO","title":"Nginx","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/server/reverse-proxy/nginx"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true},{"id":"_help_fDLvzOx29Pfg","title":"Apache using Docker","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/server/reverse-proxy/apache"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true},{"id":"_help_LLzSMXACKhUs","title":"Trusted proxy","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/server/reverse-proxy/trusted-proxy"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true},{"id":"_help_5ERVJb9s4FRD","title":"Traefik","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/server/reverse-proxy/traefik"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true}]},{"id":"_help_l2VkvOwUNfZj","title":"HTTPS (TLS)","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/server/https"},{"name":"iconClass","value":"bx bx-lock-alt","type":"label"}],"enforceAttributes":true},{"id":"_help_0hzsNCP31IAB","title":"Authentication","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/server/auth"},{"name":"iconClass","value":"bx bx-user","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_lwAX5SvbrK2g","title":"Resetting your password","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/server/auth/password-reset"},{"name":"iconClass","value":"bx bx-key","type":"label"}],"enforceAttributes":true}]},{"id":"_help_7DAiwaf8Z7Rz","title":"Multi-factor authentication with TOTP","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/server/mfa"},{"name":"iconClass","value":"bx bx-stopwatch","type":"label"}],"enforceAttributes":true},{"id":"_help_x1lQNKQBqLcA","title":"Signing in with OpenID Connect","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/server/openid-connect"},{"name":"iconClass","value":"bx bxs-key","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_IgkTHSaFfq6A","title":"Setting up with various providers","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/server/openid-connect/setup"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true}]},{"id":"_help_yeEaYqosGLSh","title":"Third-party cloud hosting","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/server/cloud-hosting"},{"name":"iconClass","value":"bx bx-cloud","type":"label"}],"enforceAttributes":true},{"id":"_help_iGTnKjubbXkA","title":"System Requirements","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/server/system-requirements"},{"name":"iconClass","value":"bx bx-chip","type":"label"}],"enforceAttributes":true}]},{"id":"_help_cbkrhQjrkKrh","title":"Synchronization","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/synchronization"},{"name":"iconClass","value":"bx bx-sync","type":"label"}],"enforceAttributes":true},{"id":"_help_RDslemsQ6gCp","title":"Mobile Frontend","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/mobile-frontend"},{"name":"iconClass","value":"bx bx-mobile-alt","type":"label"}],"enforceAttributes":true},{"id":"_help_MtPxeAWVAzMg","title":"Web Clipper","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/web-clipper"},{"name":"iconClass","value":"bx bx-paperclip","type":"label"}],"enforceAttributes":true},{"id":"_help_n1lujUxCwipy","title":"Upgrading TriliumNext","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/upgrading"},{"name":"iconClass","value":"bx bx-up-arrow-alt","type":"label"}],"enforceAttributes":true},{"id":"_help_ODY7qQn5m2FT","title":"Backup","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/backup"},{"name":"iconClass","value":"bx bx-hdd","type":"label"}],"enforceAttributes":true},{"id":"_help_tAassRL4RSQL","title":"Data directory","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/data-directory"},{"name":"iconClass","value":"bx bx-folder-open","type":"label"}],"enforceAttributes":true},{"id":"_help_ebyr7ES2SwOW","title":"Downloaded resources","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/setup/downloaded-resources"},{"name":"iconClass","value":"bx bx-download","type":"label"}],"enforceAttributes":true}]},{"id":"_help_gh7bpGYxajRS","title":"Basic Concepts and Features","type":"book","attributes":[{"name":"iconClass","value":"bx bx-help-circle","type":"label"}],"children":[{"id":"_help_Vc8PjrjAGuOp","title":"UI Elements","type":"book","attributes":[{"name":"iconClass","value":"bx bx-window-alt","type":"label"}],"children":[{"id":"_help_x0JgW8UqGXvq","title":"Vertical and horizontal layout","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/layouts"},{"name":"iconClass","value":"bx bxs-layout","type":"label"}],"enforceAttributes":true},{"id":"_help_x3i7MxGccDuM","title":"Global menu","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/global-menu"},{"name":"iconClass","value":"bx bx-menu","type":"label"}],"enforceAttributes":true},{"id":"_help_oPVyFC7WL2Lp","title":"Note Tree","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-tree"},{"name":"iconClass","value":"bx bxs-tree-alt","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_YtSN43OrfzaA","title":"Note tree contextual menu","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-tree/context-menu"},{"name":"iconClass","value":"bx bx-menu","type":"label"}],"enforceAttributes":true},{"id":"_help_yTjUdsOi4CIE","title":"Multiple selection","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-tree/multiple-selection"},{"name":"iconClass","value":"bx bx-list-plus","type":"label"}],"enforceAttributes":true},{"id":"_help_DvdZhoQZY9Yd","title":"Keyboard shortcuts","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-tree/keyboard-shortcuts"},{"name":"iconClass","value":"bx bxs-keyboard","type":"label"}],"enforceAttributes":true},{"id":"_help_wyaGBBQrl4i3","title":"Hiding the subtree","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-tree/hiding-subtree"},{"name":"iconClass","value":"bx bx-hide","type":"label"}],"enforceAttributes":true}]},{"id":"_help_3seOhtN8uLIY","title":"Tabs","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/tabs"},{"name":"iconClass","value":"bx bx-dock-top","type":"label"}],"enforceAttributes":true},{"id":"_help_xYmIYSP6wE3F","title":"Launch Bar","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/launch-bar"},{"name":"iconClass","value":"bx bx-sidebar","type":"label"}],"enforceAttributes":true},{"id":"_help_8YBEPzcpUgxw","title":"Note menu","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-menu"},{"name":"iconClass","value":"bx bx-dots-horizontal-rounded","type":"label"}],"enforceAttributes":true},{"id":"_help_1P8QXI5edXNd","title":"Note buttons","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-buttons"},{"name":"iconClass","value":"bx bx-download","type":"label"}],"enforceAttributes":true},{"id":"_help_4TIF1oA4VQRO","title":"Options","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/options"},{"name":"iconClass","value":"bx bx-cog","type":"label"}],"enforceAttributes":true},{"id":"_help_luNhaphA37EO","title":"Split View","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/split-view"},{"name":"iconClass","value":"bx bx-dock-right","type":"label"}],"enforceAttributes":true},{"id":"_help_RnaPdbciOfeq","title":"Right Sidebar","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/right-sidebar"},{"name":"iconClass","value":"bx bxs-dock-right","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_2dcGDhp9WFKb","title":"Outline tab","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/right-sidebar/outline"},{"name":"iconClass","value":"bx bx-list-ul","type":"label"}],"enforceAttributes":true},{"id":"_help_uNtgN0cUKEBc","title":"Attributes tab","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/right-sidebar/attributes"},{"name":"iconClass","value":"bx bx-hash","type":"label"}],"enforceAttributes":true},{"id":"_help_KRlZFoIH0j6p","title":"Connections tab","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/right-sidebar/connections"},{"name":"iconClass","value":"bx bx-network-chart","type":"label"}],"enforceAttributes":true}]},{"id":"_help_r5JGHN99bVKn","title":"Recent Changes","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/recent-changes"},{"name":"iconClass","value":"bx bx-history","type":"label"}],"enforceAttributes":true},{"id":"_help_ny318J39E5Z0","title":"Zoom","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/zoom"},{"name":"iconClass","value":"bx bx-zoom-in","type":"label"}],"enforceAttributes":true},{"id":"_help_lgKX7r3aL30x","title":"Note Tooltip","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-tooltip"},{"name":"iconClass","value":"bx bx-message-detail","type":"label"}],"enforceAttributes":true},{"id":"_help_SL5f1Auq7sVN","title":"Note types with split view","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-types-with-split-view"},{"name":"iconClass","value":"bx bx-card","type":"label"}],"enforceAttributes":true},{"id":"_help_t596jLvPrqkS","title":"Content width","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/content-width"},{"name":"iconClass","value":"bx bx-detail","type":"label"}],"enforceAttributes":true},{"id":"_help_jcQVxzYybYgz","title":"Note contextual menu","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/note-context-menu"},{"name":"iconClass","value":"bx bx-menu","type":"label"}],"enforceAttributes":true},{"id":"_help_AlJ73vBCjWDw","title":"Status bar","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/status-bar"},{"name":"iconClass","value":"bx bx-dock-bottom","type":"label"}],"enforceAttributes":true},{"id":"_help_I6p2a06hdnL6","title":"Breadcrumb","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/ui/breadcrumb"},{"name":"iconClass","value":"bx bx-chevron-right","type":"label"}],"enforceAttributes":true}]},{"id":"_help_BFs8mudNFgCS","title":"Notes","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/notes"},{"name":"iconClass","value":"bx bx-notepad","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_l7pigIGu01K2","title":"Title","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/title"},{"name":"iconClass","value":"bx bx-text","type":"label"}],"enforceAttributes":true},{"id":"_help_p9kXRFAkwN4o","title":"Note Icons & Colors","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/note-icons"},{"name":"iconClass","value":"bx bxs-grid","type":"label"}],"enforceAttributes":true},{"id":"_help_0vhv7lsOLy82","title":"Attachments","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/attachments"},{"name":"iconClass","value":"bx bx-paperclip","type":"label"}],"enforceAttributes":true},{"id":"_help_IakOLONlIfGI","title":"Cloning Notes","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/cloning"},{"name":"iconClass","value":"bx bx-duplicate","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_TBwsyfadTA18","title":"Branch prefix","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/cloning/branch-prefix"},{"name":"iconClass","value":"bx bx-rename","type":"label"}],"enforceAttributes":true}]},{"id":"_help_bwg0e8ewQMak","title":"Protected Notes","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/protected-notes"},{"name":"iconClass","value":"bx bx-lock-alt","type":"label"}],"enforceAttributes":true},{"id":"_help_MKmLg5x6xkor","title":"Archived Notes","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/archived-notes"},{"name":"iconClass","value":"bx bx-box","type":"label"}],"enforceAttributes":true},{"id":"_help_vZWERwf8U3nx","title":"Note Revisions","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/note-revisions"},{"name":"iconClass","value":"bx bx-history","type":"label"}],"enforceAttributes":true},{"id":"_help_aGlEvb9hyDhS","title":"Sorting Notes","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/sorting"},{"name":"iconClass","value":"bx bx-sort-up","type":"label"}],"enforceAttributes":true},{"id":"_help_NRnIZmSMc5sj","title":"Printing & Exporting as PDF","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/printing-and-pdf-export"},{"name":"iconClass","value":"bx bx-printer","type":"label"}],"enforceAttributes":true},{"id":"_help_CoFPLs3dRlXc","title":"Read-Only Notes","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/read-only-notes"},{"name":"iconClass","value":"bx bx-edit-alt","type":"label"}],"enforceAttributes":true},{"id":"_help_0ESUbbAxVnoK","title":"Note List","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/note-list"},{"name":"iconClass","value":"bx bxs-grid","type":"label"}],"enforceAttributes":true},{"id":"_help_S0Fos78ZfcY7","title":"Note Inbox","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/note-inbox"},{"name":"iconClass","value":"bx bxs-inbox","type":"label"}],"enforceAttributes":true},{"id":"_help_5Ct4MAJTS4tQ","title":"Restoring Deleted Notes","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/restoring-deleted-notes"},{"name":"iconClass","value":"bx bx-trash-alt","type":"label"}],"enforceAttributes":true},{"id":"_help_m3VlURMSeOrd","title":"New note type switcher","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/new-note-type-switcher"},{"name":"iconClass","value":"bx bxs-widget","type":"label"}],"enforceAttributes":true},{"id":"_help_B5dihXRDksTk","title":"Note badges","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/note-badges"},{"name":"iconClass","value":"bx bx-square-rounded","type":"label"}],"enforceAttributes":true},{"id":"_help_Bsm4fyzPJkSc","title":"Save status indicator","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/notes/save-status-indicator"},{"name":"iconClass","value":"bx bx-save","type":"label"}],"enforceAttributes":true}]},{"id":"_help_wArbEsdSae6g","title":"Navigation","type":"book","attributes":[{"name":"iconClass","value":"bx bx-navigation","type":"label"}],"children":[{"id":"_help_kBrnXNG3Hplm","title":"Tree Concepts","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/tree-concepts"},{"name":"iconClass","value":"bx bx-pyramid","type":"label"}],"enforceAttributes":true},{"id":"_help_MMiBEQljMQh2","title":"Note Navigation","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/note-navigation"},{"name":"iconClass","value":"bx bxs-navigation","type":"label"}],"enforceAttributes":true},{"id":"_help_Ms1nauBra7gq","title":"Quick search","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/quick-search"},{"name":"iconClass","value":"bx bx-search-alt-2","type":"label"}],"enforceAttributes":true},{"id":"_help_F1r9QtzQLZqm","title":"Jump to & command palette","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/jump-to"},{"name":"iconClass","value":"bx bx-send","type":"label"}],"enforceAttributes":true},{"id":"_help_eIg8jdvaoNNd","title":"Search","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/search"},{"name":"iconClass","value":"bx bx-search-alt-2","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_Oxyb6jOjjVNL","title":"Under the hood","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/search/under-the-hood"},{"name":"iconClass","value":"bx bxs-cog","type":"label"}],"enforceAttributes":true},{"id":"_help_WbjlujkUhEb5","title":"How search matches your text","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/search/matching"},{"name":"iconClass","value":"bx bx-file-find","type":"label"}],"enforceAttributes":true}]},{"id":"_help_u3YFHC9tQlpm","title":"Bookmarks","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/bookmarks"},{"name":"iconClass","value":"bx bx-bookmarks","type":"label"}],"enforceAttributes":true},{"id":"_help_OR8WJ7Iz9K4U","title":"Note Hoisting","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/note-hoisting"},{"name":"iconClass","value":"bx bxs-chevrons-up","type":"label"}],"enforceAttributes":true},{"id":"_help_ZjLYv08Rp3qC","title":"Quick edit","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/quick-edit"},{"name":"iconClass","value":"bx bx-edit","type":"label"}],"enforceAttributes":true},{"id":"_help_9sRHySam5fXb","title":"Workspaces","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/workspace"},{"name":"iconClass","value":"bx bx-door-open","type":"label"}],"enforceAttributes":true},{"id":"_help_xWtq5NUHOwql","title":"Similar Notes","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/similar-notes"},{"name":"iconClass","value":"bx bx-bar-chart","type":"label"}],"enforceAttributes":true},{"id":"_help_McngOG2jbUWX","title":"Search in note","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/navigation/search-in-note"},{"name":"iconClass","value":"bx bx-search-alt-2","type":"label"}],"enforceAttributes":true}]},{"id":"_help_A9Oc6YKKc65v","title":"Keyboard Shortcuts","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/keyboard-shortcuts"},{"name":"iconClass","value":"bx bxs-keyboard","type":"label"}],"enforceAttributes":true},{"id":"_help_Wy267RK4M69c","title":"Themes","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/themes"},{"name":"iconClass","value":"bx bx-palette","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_VbjZvtUek0Ln","title":"Theme Gallery","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/themes/theme-gallery"},{"name":"iconClass","value":"bx bx-book-reader","type":"label"}],"enforceAttributes":true},{"id":"_help_gOKqSJgXLcIj","title":"Icon Packs","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/themes/icon-packs"},{"name":"iconClass","value":"bx bx-package","type":"label"}],"enforceAttributes":true},{"id":"_help_w4rMEhJsALlA","title":"Personalizing the font","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/themes/fonts"},{"name":"iconClass","value":"bx bx-font","type":"label"}],"enforceAttributes":true}]},{"id":"_help_mHbBMPDPkVV5","title":"Import & Export","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export"},{"name":"iconClass","value":"bx bx-import","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_Oau6X9rCuegd","title":"Markdown","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/markdown"},{"name":"iconClass","value":"bx bxl-markdown","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_rJ9grSgoExl9","title":"Supported syntax","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/markdown/supported-syntax"},{"name":"iconClass","value":"bx bx-code-alt","type":"label"}],"enforceAttributes":true}]},{"id":"_help_ckZ2uNWQmVeX","title":"Importing data from other applications","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/import-from-apps"},{"name":"iconClass","value":"bx bx-import","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_GnhlmrATVqcH","title":"Microsoft OneNote","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/import-from-apps/onenote"},{"name":"iconClass","value":"tn-brand tn-brand-onenote","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_LpvyEIBIAAj7","title":"Tags","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/import-from-apps/onenote/tags"},{"name":"iconClass","value":"bx bx-star","type":"label"}],"enforceAttributes":true}]},{"id":"_help_Y5mKeJ6dsCld","title":"Notion","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/import-from-apps/notion"},{"name":"iconClass","value":"tn-brand tn-brand-notion","type":"label"}],"enforceAttributes":true},{"id":"_help_nhQVuO4zvIxi","title":"Google Keep","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/import-from-apps/keep"},{"name":"iconClass","value":"tn-brand tn-brand-google-keep","type":"label"}],"enforceAttributes":true},{"id":"_help_syuSEKf2rUGr","title":"Evernote","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/import-from-apps/evernote"},{"name":"iconClass","value":"tn-brand tn-brand-evernote","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_dj3j8dG4th4l","title":"Process internal links by title","type":"doc","attributes":[{"name":"iconClass","value":"bx bx-file","type":"label"}]}]},{"id":"_help_83zmPBJRgfnW","title":"Anytype","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/import-from-apps/anytype"},{"name":"iconClass","value":"tn-brand tn-brand-anytype","type":"label"}],"enforceAttributes":true},{"id":"_help_iWD7wiIuMtgV","title":"Obsidian","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/import-export/import-from-apps/obsidian"},{"name":"iconClass","value":"tn-brand tn-brand-obsidian","type":"label"}],"enforceAttributes":true}]}]},{"id":"_help_rC3pL2aptaRE","title":"Zen mode","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/zen-mode"},{"name":"iconClass","value":"bx bxs-yin-yang","type":"label"}],"enforceAttributes":true},{"id":"_help_YzMcWlCVeW09","title":"Active content","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/concepts/active-content"},{"name":"iconClass","value":"bx bxs-widget","type":"label"}],"enforceAttributes":true}]},{"id":"_help_s3YCWHBfmYuM","title":"Quick Start","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/quick-start"},{"name":"iconClass","value":"bx bx-run","type":"label"}],"enforceAttributes":true},{"id":"_help_i6dbnitykE5D","title":"FAQ","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/faq"},{"name":"iconClass","value":"bx bx-question-mark","type":"label"}],"enforceAttributes":true},{"id":"_help_KSZ04uQ2D1St","title":"Note Types","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types"},{"name":"iconClass","value":"bx bx-edit","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_iPIMuisry3hd","title":"Text","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text"},{"name":"iconClass","value":"bx bx-note","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_oSuaNgyyKnhu","title":"Anchors","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/bookmarks"},{"name":"iconClass","value":"bx bx-bookmark","type":"label"}],"enforceAttributes":true},{"id":"_help_oI7GoyilXXAr","title":"Automatic replacements","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/automatic-replacements"},{"name":"iconClass","value":"bx bx-reply","type":"label"}],"enforceAttributes":true},{"id":"_help_NwBbFdNZ9h7O","title":"Block quotes & admonitions","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/blockquotes"},{"name":"iconClass","value":"bx bx-info-circle","type":"label"}],"enforceAttributes":true},{"id":"_help_klC3ilXa9kUE","title":"Block references","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/block-references"},{"name":"iconClass","value":"bx bx-paragraph","type":"label"}],"enforceAttributes":true},{"id":"_help_4n4oQUVbnOxa","title":"Collapsible blocks","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/collapsible-blocks"},{"name":"iconClass","value":"bx bx-chevron-down-circle","type":"label"}],"enforceAttributes":true},{"id":"_help_veGu4faJErEM","title":"Content language & Right-to-left support","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/content-language"},{"name":"iconClass","value":"bx bx-align-right","type":"label"}],"enforceAttributes":true},{"id":"_help_EK2ckIZ74tbT","title":"Content tabs","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/content-tabs"},{"name":"iconClass","value":"cke cke-trilium-tabs","type":"label"}],"enforceAttributes":true},{"id":"_help_2x0ZAX9ePtzV","title":"Cut to subnote","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/cut-to-subnote"},{"name":"iconClass","value":"bx bx-cut","type":"label"}],"enforceAttributes":true},{"id":"_help_UYuUB1ZekNQU","title":"Developer-specific formatting","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/developer-formatting"},{"name":"iconClass","value":"bx bx-code-alt","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_QxEyIjRBizuC","title":"Code blocks","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/developer-formatting/code-blocks"},{"name":"iconClass","value":"bx bx-code","type":"label"}],"enforceAttributes":true}]},{"id":"_help_AgjCISero73a","title":"Footnotes","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/footnotes"},{"name":"iconClass","value":"bx bx-bracket","type":"label"}],"enforceAttributes":true},{"id":"_help_5wZallV2Qo1t","title":"Format Painter","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/format-painter"},{"name":"iconClass","value":"bx bxs-paint-roll","type":"label"}],"enforceAttributes":true},{"id":"_help_nRhnJkTT8cPs","title":"Formatting toolbar","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/formatting-toolbar"},{"name":"iconClass","value":"bx bx-text","type":"label"}],"enforceAttributes":true},{"id":"_help_Gr6xFaF6ioJ5","title":"General formatting","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/general-formatting"},{"name":"iconClass","value":"bx bx-bold","type":"label"}],"enforceAttributes":true},{"id":"_help_AxshuNRegLAv","title":"Highlights list","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/highlights-list"},{"name":"iconClass","value":"bx bx-highlight","type":"label"}],"enforceAttributes":true},{"id":"_help_mT0HEkOsz6i1","title":"Images","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/images"},{"name":"iconClass","value":"bx bx-image-alt","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_0Ofbk1aSuVRu","title":"Image references","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/images/image-references"},{"name":"iconClass","value":"bx bxs-file-image","type":"label"}],"enforceAttributes":true}]},{"id":"_help_VRoP0g1uHHc2","title":"In-editor AI assistant","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/ai-assistant"},{"name":"iconClass","value":"bx bx-bot","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_mVEYwt20exhO","title":"Custom AI quick actions","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/ai-assistant/custom-quick-actions"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true}]},{"id":"_help_nBAXQFj20hS1","title":"Include Note","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/include-note"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true},{"id":"_help_CohkqWQC1iBv","title":"Insert buttons","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/insert-buttons"},{"name":"iconClass","value":"bx bx-plus","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_hD8GawVuazff","title":"Icons","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/insert-buttons/icons"},{"name":"iconClass","value":"bx bx-sticker","type":"label"}],"enforceAttributes":true}]},{"id":"_help_oiVPnW8QfnvS","title":"Keyboard shortcuts","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/keyboard-shortcuts"},{"name":"iconClass","value":"bx bxs-keyboard","type":"label"}],"enforceAttributes":true},{"id":"_help_UmgZAfcltxkS","title":"Link Previews","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/link-previews"},{"name":"iconClass","value":"bx bx-link-external","type":"label"}],"enforceAttributes":true},{"id":"_help_QEAPj01N5f7w","title":"Links","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/links"},{"name":"iconClass","value":"bx bx-link-alt","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_3IDVtesTQ8ds","title":"External links","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/links/external-links"},{"name":"iconClass","value":"bx bx-link-external","type":"label"}],"enforceAttributes":true},{"id":"_help_hrZ1D00cLbal","title":"Internal (reference) links","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/links/reference-links"},{"name":"iconClass","value":"bx bx-link","type":"label"}],"enforceAttributes":true},{"id":"_help_wfGXLmm7x27z","title":"Backlinks","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/links/backlinks"},{"name":"iconClass","value":"bx bx-link-alt","type":"label"}],"enforceAttributes":true}]},{"id":"_help_S6Xx8QIWTV66","title":"Lists","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/lists"},{"name":"iconClass","value":"bx bx-list-ul","type":"label"}],"enforceAttributes":true},{"id":"_help_QrtTYPmdd1qq","title":"Markdown-like formatting","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/markdown-formatting"},{"name":"iconClass","value":"bx bxl-markdown","type":"label"}],"enforceAttributes":true},{"id":"_help_YfYAtQBcfo5V","title":"Math Equations","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/math-equations"},{"name":"iconClass","value":"bx bx-math","type":"label"}],"enforceAttributes":true},{"id":"_help_wYDzQ1fBFgfT","title":"Multicolumn layout","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/multicolumn-layout"},{"name":"iconClass","value":"cke cke-trilium-multicolumn","type":"label"}],"enforceAttributes":true},{"id":"_help_dEHYtoWWi8ct","title":"Other features","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/other-features"},{"name":"iconClass","value":"bx bxs-grid","type":"label"}],"enforceAttributes":true},{"id":"_help_gLt3vA97tMcp","title":"Premium features","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/premium-features"},{"name":"iconClass","value":"bx bx-star","type":"label"}],"enforceAttributes":true},{"id":"_help_ZlN4nump6EbW","title":"Slash Commands","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/slash-commands"},{"name":"iconClass","value":"bx bx-menu","type":"label"}],"enforceAttributes":true},{"id":"_help_oBo3iHIZnbG2","title":"Spell Check","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/spellcheck"},{"name":"iconClass","value":"bx bx-check-double","type":"label"}],"enforceAttributes":true},{"id":"_help_BFvAtE74rbP6","title":"Table of contents","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/table-of-contents"},{"name":"iconClass","value":"bx bx-heading","type":"label"}],"enforceAttributes":true},{"id":"_help_NdowYOC1GFKS","title":"Tables","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/tables"},{"name":"iconClass","value":"bx bx-table","type":"label"}],"enforceAttributes":true},{"id":"_help_fASfBrYnquKU","title":"To-do Lists","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/text/todo-lists"},{"name":"iconClass","value":"bx bx-checkbox-checked","type":"label"}],"enforceAttributes":true}]},{"id":"_help_6f9hih2hXXZk","title":"Code","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/code"},{"name":"iconClass","value":"bx bx-code","type":"label"}],"enforceAttributes":true},{"id":"_help_m523cpzocqaD","title":"Saved Search","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/saved-search"},{"name":"iconClass","value":"bx bx-file-find","type":"label"}],"enforceAttributes":true},{"id":"_help_iRwzGnHPzonm","title":"Relation Map","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/relation-map"},{"name":"iconClass","value":"bx bx-shape-polygon","type":"label"}],"enforceAttributes":true},{"id":"_help_bdUJEHsAPYQR","title":"Note Map","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/note-map"},{"name":"iconClass","value":"bx bxs-network-chart","type":"label"}],"enforceAttributes":true},{"id":"_help_HcABDtFCkbFN","title":"Render Note","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/render-note"},{"name":"iconClass","value":"bx bx-extension","type":"label"}],"enforceAttributes":true},{"id":"_help_s1aBHPd79XYj","title":"Mermaid Diagrams","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/mermaid-diagrams"},{"name":"iconClass","value":"bx bx-selection","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_RH6yLjjWJHof","title":"ELK layout","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/mermaid-diagrams/elk"},{"name":"iconClass","value":"bx bxs-network-chart","type":"label"}],"enforceAttributes":true},{"id":"_help_WWgeUaBb7UfC","title":"Syntax reference","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://mermaid.js.org/intro/syntax-reference.html"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true}]},{"id":"_help_grjYqerjn243","title":"Canvas","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/canvas"},{"name":"iconClass","value":"bx bx-pen","type":"label"}],"enforceAttributes":true},{"id":"_help_1vHRoWCEjj0L","title":"Web View","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/webview"},{"name":"iconClass","value":"bx bx-globe-alt","type":"label"}],"enforceAttributes":true},{"id":"_help_gBbsAeiuUxI5","title":"Mind Map","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/mindmap"},{"name":"iconClass","value":"bx bx-sitemap","type":"label"}],"enforceAttributes":true},{"id":"_help_W8vYD3Q1zjCR","title":"File","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/file"},{"name":"iconClass","value":"bx bx-file-blank","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_XJGJrpu7F9sh","title":"PDFs","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/file/pdf"},{"name":"iconClass","value":"bx bxs-file-pdf","type":"label"}],"enforceAttributes":true},{"id":"_help_AjqEeiDUOzj4","title":"Audio & Video","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/file/audio-video"},{"name":"iconClass","value":"bx bx-video","type":"label"}],"enforceAttributes":true}]},{"id":"_help_GWHEkY4I4OE3","title":"Spreadsheets","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/spreadsheets"},{"name":"iconClass","value":"bx bx-table","type":"label"}],"enforceAttributes":true},{"id":"_help_6RM1Q7ppFVoj","title":"Markdown","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/markdown"},{"name":"iconClass","value":"bx bxl-markdown","type":"label"}],"enforceAttributes":true},{"id":"_help_jludwdW7N4hg","title":"Converting between note types","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/note-types/note-type-conversion"},{"name":"iconClass","value":"bx bx-repost","type":"label"}],"enforceAttributes":true}]},{"id":"_help_GTwFsgaA0lCt","title":"Collections","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/collections"},{"name":"iconClass","value":"bx bx-book","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_xWbu3jpNWapp","title":"Calendar","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/collections/calendar"},{"name":"iconClass","value":"bx bx-calendar","type":"label"}],"enforceAttributes":true},{"id":"_help_2FvYrpmOXm29","title":"Table","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/collections/table"},{"name":"iconClass","value":"bx bx-table","type":"label"}],"enforceAttributes":true},{"id":"_help_CtBQqbwXDx1w","title":"Kanban Board","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/collections/kanban-board"},{"name":"iconClass","value":"bx bx-columns","type":"label"}],"enforceAttributes":true},{"id":"_help_81SGnPGMk7Xc","title":"Geo Map","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/collections/geomap"},{"name":"iconClass","value":"bx bx-map-alt","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_C2H9HK4BzwG7","title":"Drawing shapes","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/collections/geomap/shapes"},{"name":"iconClass","value":"bx bx-shape-square","type":"label"}],"enforceAttributes":true},{"id":"_help_ZRDXGc0nAIh4","title":"Image maps","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/collections/geomap/image-maps"},{"name":"iconClass","value":"bx bx-image-alt","type":"label"}],"enforceAttributes":true}]},{"id":"_help_zP3PMqaG71Ct","title":"Presentation","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/collections/presentation"},{"name":"iconClass","value":"bx bx-slideshow","type":"label"}],"enforceAttributes":true},{"id":"_help_8QqnMzx393bx","title":"Grid View","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/collections/grid"},{"name":"iconClass","value":"bx bxs-grid","type":"label"}],"enforceAttributes":true},{"id":"_help_mULW0Q3VojwY","title":"List View","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/collections/list"},{"name":"iconClass","value":"bx bx-list-ul","type":"label"}],"enforceAttributes":true},{"id":"_help_CssoWBu8I7jF","title":"Collection Properties","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/collections/collection-properties"},{"name":"iconClass","value":"bx bx-cog","type":"label"}],"enforceAttributes":true},{"id":"_help_IF7Q6I9x7zuw","title":"Dashboard","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/collections/dashboard"},{"name":"iconClass","value":"bx bxs-dashboard","type":"label"}],"enforceAttributes":true}]},{"id":"_help_BgmBlOIl72jZ","title":"Troubleshooting","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/troubleshooting"},{"name":"iconClass","value":"bx bx-bug","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_wy8So3yZZlH9","title":"Reporting issues","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/troubleshooting/reporting-issues"},{"name":"iconClass","value":"bx bx-bug-alt","type":"label"}],"enforceAttributes":true},{"id":"_help_x59R8J8KV5Bp","title":"Anonymized Database","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/troubleshooting/anonymized-database"},{"name":"iconClass","value":"bx bx-low-vision","type":"label"}],"enforceAttributes":true},{"id":"_help_qzNzp9LYQyPT","title":"Error logs","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/troubleshooting/error-logs"},{"name":"iconClass","value":"bx bx-comment-error","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_bnyigUA2UK7s","title":"Backend (server) logs","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/troubleshooting/error-logs/backend-logs"},{"name":"iconClass","value":"bx bx-server","type":"label"}],"enforceAttributes":true},{"id":"_help_9yEHzMyFirZR","title":"Frontend logs","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/troubleshooting/error-logs/frontend-logs"},{"name":"iconClass","value":"bx bx-window-alt","type":"label"}],"enforceAttributes":true}]},{"id":"_help_vdlYGAcpXAgc","title":"Synchronization fails with 504 Gateway Timeout","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/troubleshooting/sync-timeout"},{"name":"iconClass","value":"bx bx-error","type":"label"}],"enforceAttributes":true},{"id":"_help_s8alTXmpFR61","title":"Refreshing the application","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/troubleshooting/refreshing-app"},{"name":"iconClass","value":"bx bx-refresh","type":"label"}],"enforceAttributes":true}]},{"id":"_help_pKK96zzmvBGf","title":"Theme development","type":"book","attributes":[{"name":"iconClass","value":"bx bx-palette","type":"label"}],"children":[{"id":"_help_7NfNr5pZpVKV","title":"Creating a custom theme","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/theme-development/creating-custom-theme"},{"name":"iconClass","value":"bx bxs-color","type":"label"}],"enforceAttributes":true},{"id":"_help_WFGzWeUK6arS","title":"Customize the Next theme","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/theme-development/customize-next-theme"},{"name":"iconClass","value":"bx bx-news","type":"label"}],"enforceAttributes":true},{"id":"_help_WN5z4M8ASACJ","title":"Reference","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/theme-development/reference"},{"name":"iconClass","value":"bx bx-book-open","type":"label"}],"enforceAttributes":true},{"id":"_help_AlhDUqhENtH7","title":"Custom app-wide CSS","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/theme-development/custom-appcss"},{"name":"iconClass","value":"bx bxs-file-css","type":"label"}],"enforceAttributes":true},{"id":"_help_g1mlRoU8CsqC","title":"Creating an icon pack","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/theme-development/creating-icon-pack"},{"name":"iconClass","value":"bx bx-package","type":"label"}],"enforceAttributes":true}]},{"id":"_help_tC7s2alapj8V","title":"Advanced Usage","type":"book","attributes":[{"name":"iconClass","value":"bx bx-rocket","type":"label"}],"children":[{"id":"_help_zEY4DaJG4YT5","title":"Attributes","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/attributes"},{"name":"iconClass","value":"bx bx-list-check","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_HI6GBBIduIgv","title":"Labels","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/attributes/labels"},{"name":"iconClass","value":"bx bx-hash","type":"label"}],"enforceAttributes":true},{"id":"_help_Cq5X6iKQop6R","title":"Relations","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/attributes/relations"},{"name":"iconClass","value":"bx bx-transfer","type":"label"}],"enforceAttributes":true},{"id":"_help_bwZpz2ajCEwO","title":"Attribute Inheritance","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/attributes/attribute-inheritance"},{"name":"iconClass","value":"bx bx-list-plus","type":"label"}],"enforceAttributes":true},{"id":"_help_OFXdgB2nNk1F","title":"Promoted Attributes","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/attributes/promoted-attributes"},{"name":"iconClass","value":"bx bx-table","type":"label"}],"enforceAttributes":true}]},{"id":"_help_KC1HB96bqqHX","title":"Templates","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/template"},{"name":"iconClass","value":"bx bx-detail","type":"label"}],"enforceAttributes":true},{"id":"_help_B2ORr7OVEZtc","title":"Snippets","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/snippets"},{"name":"iconClass","value":"bx bx-news","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_VQjhl61rlWh9","title":"Markdown Snippets","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/snippets/markdown-snippets"},{"name":"iconClass","value":"bx bxl-markdown","type":"label"}],"enforceAttributes":true},{"id":"_help_IEgsWp5hHH35","title":"Code Snippets","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/snippets/code-snippets"},{"name":"iconClass","value":"bx bx-code-alt","type":"label"}],"enforceAttributes":true}]},{"id":"_help_BCkXAVs63Ttv","title":"Note Map (Link map, Tree map)","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/note-map"},{"name":"iconClass","value":"bx bxs-network-chart","type":"label"}],"enforceAttributes":true},{"id":"_help_R9pX4DGra2Vt","title":"Sharing","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/sharing"},{"name":"iconClass","value":"bx bx-share-alt","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_Qjt68inQ2bRj","title":"Serving directly the content of a note","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/sharing/serving-raw"},{"name":"iconClass","value":"bx bx-code","type":"label"}],"enforceAttributes":true},{"id":"_help_ycBFjKrrwE9p","title":"Exporting static HTML for web publishing","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/sharing/static-html"},{"name":"iconClass","value":"bx bxs-file-html","type":"label"}],"enforceAttributes":true},{"id":"_help_sLIJ6f1dkJYW","title":"Reverse proxy configuration","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/sharing/reverse-proxy"},{"name":"iconClass","value":"bx bx-world","type":"label"}],"enforceAttributes":true},{"id":"_help_Ad7Ku5gOHrDU","title":"Custom share template","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/sharing/custom-share-template"},{"name":"iconClass","value":"bx bxl-nodejs","type":"label"}],"enforceAttributes":true}]},{"id":"_help_5668rwcirq1t","title":"Advanced Showcases","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/advanced-showcases"},{"name":"iconClass","value":"bx bxs-component","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_l0tKav7yLHGF","title":"Day Notes","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/advanced-showcases/day-notes"},{"name":"iconClass","value":"bx bx-calendar","type":"label"}],"enforceAttributes":true},{"id":"_help_R7abl2fc6Mxi","title":"Weight Tracker","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/advanced-showcases/weight-tracker"},{"name":"iconClass","value":"bx bx-line-chart","type":"label"}],"enforceAttributes":true},{"id":"_help_xYjQUYhpbUEW","title":"Task Manager","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/advanced-showcases/task-manager"},{"name":"iconClass","value":"bx bx-calendar-check","type":"label"}],"enforceAttributes":true}]},{"id":"_help_i16PM6A7GXdU","title":"Customizing to-do task states","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/customizing-to-do-task-states"},{"name":"iconClass","value":"bx bx-list-check","type":"label"}],"enforceAttributes":true},{"id":"_help_J5Ex1ZrMbyJ6","title":"Custom Request Handler","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/custom-request-handler"},{"name":"iconClass","value":"bx bx-globe","type":"label"}],"enforceAttributes":true},{"id":"_help_d3fAXQ2diepH","title":"Custom Resource Providers","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/custom-resource-providers"},{"name":"iconClass","value":"bx bxs-file-plus","type":"label"}],"enforceAttributes":true},{"id":"_help_pgxEVkzLl1OP","title":"ETAPI (REST API)","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/etapi"},{"name":"iconClass","value":"bx bx-extension","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_9qPsTWBorUhQ","title":"API Reference","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/rest-api/etapi/"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true}]},{"id":"_help_47ZrP6FNuoG8","title":"Default Note Title","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/default-note-title"},{"name":"iconClass","value":"bx bx-edit-alt","type":"label"}],"enforceAttributes":true},{"id":"_help_wX4HbRucYSDD","title":"Database","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/database"},{"name":"iconClass","value":"bx bx-data","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_oyIAJ9PvvwHX","title":"Manually altering the database","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/database/manual-editing"},{"name":"iconClass","value":"bx bxs-edit","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_YKWqdJhzi2VY","title":"SQL Console","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/database/manual-editing/sql-console"},{"name":"iconClass","value":"bx bx-data","type":"label"}],"enforceAttributes":true}]},{"id":"_help_6tZeKvSHEUiB","title":"Demo Notes","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/database/demo-notes"},{"name":"iconClass","value":"bx bx-package","type":"label"}],"enforceAttributes":true}]},{"id":"_help_Gzjqa934BdH4","title":"Configuration (config.ini or environment variables)","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/configuration"},{"name":"iconClass","value":"bx bx-cog","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_c5xB8m4g2IY6","title":"Trilium instance","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/configuration/trilium-instance"},{"name":"iconClass","value":"bx bx-windows","type":"label"}],"enforceAttributes":true},{"id":"_help_LWtBjFej3wX3","title":"Cross-Origin Resource Sharing (CORS)","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/configuration/cors"},{"name":"iconClass","value":"bx bx-lock","type":"label"}],"enforceAttributes":true}]},{"id":"_help_ivYnonVFBxbQ","title":"Bulk Actions","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/bulk-actions"},{"name":"iconClass","value":"bx bx-list-plus","type":"label"}],"enforceAttributes":true},{"id":"_help_4FahAwuGTAwC","title":"Note source","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/note-source"},{"name":"iconClass","value":"bx bx-code","type":"label"}],"enforceAttributes":true},{"id":"_help_1YeN2MzFUluU","title":"Technologies used","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/technologies"},{"name":"iconClass","value":"bx bx-pyramid","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_MI26XDLSAlCD","title":"CKEditor","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/technologies/ckeditor"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true}]},{"id":"_help_m1lbrzyKDaRB","title":"Note ID","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/note-id"},{"name":"iconClass","value":"bx bx-fingerprint","type":"label"}],"enforceAttributes":true},{"id":"_help_0vTSyvhPTAOz","title":"Internal API","type":"book","attributes":[{"name":"iconClass","value":"bx bxs-component","type":"label"}],"children":[{"id":"_help_z8O2VG4ZZJD7","title":"API Reference","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/rest-api/internal/"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true}]},{"id":"_help_2mUhVmZK8RF3","title":"Hidden Notes","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/hidden-notes"},{"name":"iconClass","value":"bx bx-hide","type":"label"}],"enforceAttributes":true},{"id":"_help_uYF7pmepw27K","title":"Metrics","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/metrics"},{"name":"iconClass","value":"bx bxs-data","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_bOP3TB56fL1V","title":"grafana-dashboard.json","type":"doc","attributes":[{"name":"iconClass","value":"bx bx-file","type":"label"}]}]},{"id":"_help_64ZTlUPgEPtW","title":"Safe mode","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/safe-mode"},{"name":"iconClass","value":"bx bxs-virus-block","type":"label"}],"enforceAttributes":true},{"id":"_help_HAIOFBoYIIdO","title":"Nightly release","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/nightly-release"},{"name":"iconClass","value":"bx bx-moon","type":"label"}],"enforceAttributes":true},{"id":"_help_ZmT9ln8XJX2o","title":"Read-only database","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/read-only-db"},{"name":"iconClass","value":"bx bx-book-reader","type":"label"}],"enforceAttributes":true},{"id":"_help_TiQbQDgP8L5t","title":"Text Extraction (OCR)","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/advanced-usage/ocr"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true}]},{"id":"_help_GBBMSlVSOIGP","title":"AI","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/llm"},{"name":"iconClass","value":"bx bx-bot","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_bkPZAMT7d2sR","title":"Providers","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/llm/providers"},{"name":"iconClass","value":"bx bx-cog","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_eFhxp9laTW1S","title":"Subscription-based providers","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/llm/providers/subscription-based"},{"name":"iconClass","value":"bx bx-coin","type":"label"}],"enforceAttributes":true}]},{"id":"_help_KOWBFgsZXJAD","title":"MCP","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/llm/mcp"},{"name":"iconClass","value":"bx bx-network-chart","type":"label"}],"enforceAttributes":true}]},{"id":"_help_Y84QCbArmK3z","title":"Meeting transcription","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/transcription"},{"name":"iconClass","value":"bx bx-microphone","type":"label"}],"enforceAttributes":true},{"id":"_help_CdNpE2pqjmI6","title":"Scripting","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts"},{"name":"iconClass","value":"bx bxs-file-js","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_yIhgI5H7A2Sm","title":"Frontend Basics","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics"},{"name":"iconClass","value":"bx bx-window","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_MgibgPcfeuGz","title":"Custom Widgets","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/custom-widget"},{"name":"iconClass","value":"bx bxs-widget","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_SynTBQiBsdYJ","title":"Widget Basics","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/custom-widget/widget-basics"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true},{"id":"_help_GhurYZjh8e1V","title":"Note context aware widget","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/custom-widget/note-context-aware-widget"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true},{"id":"_help_M8IppdwVHSjG","title":"Right pane widget","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/custom-widget/right-pane-widget"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true},{"id":"_help_YNxAqkI5Kg1M","title":"Word count widget","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/custom-widget/word-count"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true},{"id":"_help_VqGQnnPGnqAU","title":"CSS","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/custom-widget/css"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true},{"id":"_help_gMkgcLJ6jBkg","title":"Troubleshooting","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/custom-widget/troubleshooting"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true}]},{"id":"_help_es8OU2GuguFU","title":"Examples","type":"book","attributes":[{"name":"iconClass","value":"bx bx-code-alt","type":"label"}],"children":[{"id":"_help_TjLYAo3JMO8X","title":"\"New Task\" launcher button","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/examples/new-task-button"},{"name":"iconClass","value":"bx bx-task","type":"label"}],"enforceAttributes":true},{"id":"_help_7kZPMD0uFwkH","title":"Downloading responses from Google Forms","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/examples/responses-from-google-forms"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true},{"id":"_help_DL92EjAaXT26","title":"Using promoted attributes to configure scripts","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/examples/promoted-attributes-config"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true}]},{"id":"_help_4Gn3psZKsfSm","title":"Launch Bar Widgets","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/launch-bar-widgets"},{"name":"iconClass","value":"bx bx-dock-left","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_IPArqVfDQ4We","title":"Note Title Widget","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/launch-bar-widgets/note-title"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true},{"id":"_help_gcI7RPbaNSh3","title":"Analog Watch","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/launch-bar-widgets/analog-watch"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true}]},{"id":"_help_KLsqhjaqh1QW","title":"Preact","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/preac"},{"name":"iconClass","value":"bx bxl-react","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_Bqde6BvPo05g","title":"Component libraries","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/preac/component-libraries"},{"name":"iconClass","value":"bx bxs-component","type":"label"}],"enforceAttributes":true},{"id":"_help_ykYtbM9k3a7B","title":"Hooks","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/preac/hooks"},{"name":"iconClass","value":"bx bx-question-mark","type":"label"}],"enforceAttributes":true},{"id":"_help_Sg9GrCtyftZf","title":"CSS","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/preac/css"},{"name":"iconClass","value":"bx bxs-file-css","type":"label"}],"enforceAttributes":true},{"id":"_help_RSssb9S3xgSr","title":"Built-in components","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/preac/builtin-components"},{"name":"iconClass","value":"bx bxs-component","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_i9B4IW7b6V6z","title":"Widget showcase","type":"doc","attributes":[{"name":"iconClass","value":"bx bx-file","type":"label"}]}]}]},{"id":"_help_irkwjdNtjcxR","title":"Frontend Events","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/frontend-basics/events"},{"name":"iconClass","value":"bx bx-rss","type":"label"}],"enforceAttributes":true}]},{"id":"_help_SPirpZypehBG","title":"Backend scripts","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/backend-basics"},{"name":"iconClass","value":"bx bx-server","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_fZ2IGYFXjkEy","title":"Server-side imports","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/backend-basics/server-imports"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true},{"id":"_help_GPERMystNGTB","title":"Backend Events","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/backend-basics/events"},{"name":"iconClass","value":"bx bx-rss","type":"label"}],"enforceAttributes":true}]},{"id":"_help_wqXwKJl6VpNk","title":"Common concepts","type":"book","attributes":[{"name":"iconClass","value":"bx bxl-nodejs","type":"label"}],"children":[{"id":"_help_hA834UaHhSNn","title":"Script bundles","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/common-concepts/bundles"},{"name":"iconClass","value":"bx bx-package","type":"label"}],"enforceAttributes":true}]},{"id":"_help_GLks18SNjxmC","title":"Script API","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/script-api"},{"name":"iconClass","value":"bx bx-code-curly","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_Q2z6av6JZVWm","title":"Frontend API","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/script-api/frontend"},{"name":"iconClass","value":"bx bx-folder","type":"label"}],"enforceAttributes":true,"children":[{"id":"_help_habiZ3HU8Kw8","title":"FNote","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/script-api/frontend/interfaces/FNote.html"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true}]},{"id":"_help_MEtfsqa5VwNi","title":"Backend API","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/script-api/backend"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true},{"id":"_help_GFXVHyblVN3d","title":"Electron API","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/script-api/electron"},{"name":"iconClass","value":"bx bx-window-alt","type":"label"}],"enforceAttributes":true},{"id":"_help_ApVHZ8JY5ofC","title":"Day.js","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/script-api/day.js"},{"name":"iconClass","value":"bx bx-calendar","type":"label"}],"enforceAttributes":true}]},{"id":"_help_vElnKeDNPSVl","title":"Logging","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/logging"},{"name":"iconClass","value":"bx bx-terminal","type":"label"}],"enforceAttributes":true},{"id":"_help_cNpC0ITcfX0N","title":"Breaking changes","type":"book","attributes":[{"name":"iconClass","value":"bx bx-up-arrow-alt","type":"label"}],"children":[{"id":"_help_IjZS7iK5EXtb","title":"v0.107.0: Removal of the old layout","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/breaking-changes/old-layout-removal"},{"name":"iconClass","value":"bx bx-layout","type":"label"}],"enforceAttributes":true},{"id":"_help_kTx7WqLdZ3Ry","title":"v0.106.0: Removal of cheerio","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/breaking-changes/cheerio-removal"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true},{"id":"_help_YeOa2l7Pu39I","title":"v0.104.0: Disabling the Node integration in Electron","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/breaking-changes/disabling-node-integration"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true},{"id":"_help_fqAK6opjUagR","title":"v0.103.0: Removal of axios","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/breaking-changes/axios-removal"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true},{"id":"_help_pAJ0jWz16xFm","title":"v0.103.0: `cheerio` is now deprecated","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/breaking-changes/cheerio-deprecated"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true},{"id":"_help_72dxvnbnkDFY","title":"v0.102.0: Upgrade to jQuery 4.0.0","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/breaking-changes/jquery4"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true}]},{"id":"_help_fiHicjpHjIRJ","title":"Security","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/scripts/security"},{"name":"iconClass","value":"bx bx-shield","type":"label"}],"enforceAttributes":true}]},{"id":"_help_Fm0j45KqyHpU","title":"Miscellaneous","type":"book","attributes":[{"name":"iconClass","value":"bx bx-info-circle","type":"label"}],"children":[{"id":"_help_WFbFXrgnDyyU","title":"Privacy Policy","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/misc/privacy-policy"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true},{"id":"_help_NcsmUYZRWEW4","title":"Patterns of personal knowledge","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/misc/patterns-of-personal-knowledge"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true},{"id":"_help_d1Ap6Pg6IjaJ","title":"License","type":"webView","attributes":[{"type":"label","name":"webViewSrc","value":"https://docs.triliumnotes.org/user-guide/misc/license"},{"name":"iconClass","value":"bx bx-file","type":"label"}],"enforceAttributes":true}]}]
\ No newline at end of file
diff --git a/apps/standalone/src/lightweight/in_app_help_provider.spec.ts b/apps/standalone/src/lightweight/in_app_help_provider.spec.ts
index bbae4093bf..69ea47a828 100644
--- a/apps/standalone/src/lightweight/in_app_help_provider.spec.ts
+++ b/apps/standalone/src/lightweight/in_app_help_provider.spec.ts
@@ -1,4 +1,4 @@
-import { describe, expect, it } from "vitest";
+import { describe, expect, it, vi } from "vitest";
import StandaloneInAppHelpProvider from "./in_app_help_provider.js";
@@ -10,22 +10,51 @@ describe("StandaloneInAppHelpProvider", () => {
expect(data.length).toBeGreaterThan(0);
});
- it("all entries use webView or book type (no doc type with docName)", () => {
+ it("serves the fetched page content, keyed by note ID", async () => {
const provider = new StandaloneInAppHelpProvider();
- const data = provider.getHelpHiddenSubtreeData();
+ expect(provider.getHelpContent()).toEqual({});
+
+ const fetchSpy = vi.spyOn(globalThis, "fetch").mockResolvedValue(
+ new Response(JSON.stringify({ _help_page: "<p>Body</p>" }), { status: 200 })
+ );
+ await provider.load();
+
+ expect(fetchSpy).toHaveBeenCalledWith("/server-assets/help/help_content.json");
+ expect(provider.getHelpContent()).toEqual({ _help_page: "<p>Body</p>" });
+ fetchSpy.mockRestore();
+ });
+
+ it("keeps the tree usable when the content cannot be fetched", async () => {
+ const provider = new StandaloneInAppHelpProvider();
+ const warn = vi.spyOn(console, "warn").mockImplementation(() => {});
+ const fetchSpy = vi.spyOn(globalThis, "fetch").mockResolvedValue(new Response("", { status: 404 }));
+
+ // Pages lose their bodies; the titles and the navigation do not depend on this.
+ await expect(provider.load()).resolves.toBeUndefined();
+ expect(provider.getHelpContent()).toEqual({});
+ expect(provider.getHelpHiddenSubtreeData().length).toBeGreaterThan(0);
+ expect(warn).toHaveBeenCalled();
+
+ fetchSpy.mockRestore();
+ warn.mockRestore();
+ });
+
+ it("fetches a help asset from the copy the build makes, encoding each path segment", async () => {
+ const provider = new StandaloneInAppHelpProvider();
+ const fetchSpy = vi.spyOn(globalThis, "fetch")
+ .mockResolvedValueOnce(new Response(new Uint8Array([ 1, 2 ]), { status: 200 }))
+ .mockResolvedValueOnce(new Response("", { status: 404 }))
+ .mockRejectedValueOnce(new Error("offline"));
+
+ expect(await provider.getHelpAsset("User Guide/My pic.png")).toEqual(new Uint8Array([ 1, 2 ]));
+ expect(fetchSpy).toHaveBeenCalledWith("/server-assets/help/User%20Guide/My%20pic.png");
+ expect(await provider.getHelpAsset("User Guide/missing.png")).toBeNull();
+ expect(await provider.getHelpAsset("User Guide/any.png")).toBeNull();
+
+ fetchSpy.mockRestore();
+ });
- function assertNoDocWithContent(items: typeof data) {
- for (const item of items) {
- if (item.type === "doc") {
- const hasDocName = item.attributes?.some(a => a.name === "docName");
- expect(hasDocName, `${item.title} should not have docName`).toBe(false);
- }
- if (item.children) {
- assertNoDocWithContent(item.children);
- }
- }
- }
-
- assertNoDocWithContent(data);
+ it("points assets at the copy the build makes", () => {
+ expect(new StandaloneInAppHelpProvider().getHelpAssetBase()).toBe("server-assets/help");
});
});
diff --git a/apps/standalone/src/lightweight/in_app_help_provider.ts b/apps/standalone/src/lightweight/in_app_help_provider.ts
index 69e62d605f..17d26d2653 100644
--- a/apps/standalone/src/lightweight/in_app_help_provider.ts
+++ b/apps/standalone/src/lightweight/in_app_help_provider.ts
@@ -1,15 +1,61 @@
-import type { HiddenSubtreeItem } from "@triliumnext/commons";
+import type { HelpBundle, HiddenSubtreeItem } from "@triliumnext/commons";
import { InAppHelpProvider } from "@triliumnext/core";
-import helpMeta from "../assets/help_meta.json";
+import helpMeta from "../../../server/src/assets/help/help_meta.json";
+
+/** Where the build copies the guide's content and assets (see vite.config.mts). */
+const HELP_ASSETS = "server-assets/help";
/**
- * Standalone in-app help provider: serves the pre-built help meta (webView-based)
- * generated at build time by edit-docs.
+ * Standalone in-app help provider, reading the same two artifacts the server does: the note tree
+ * `edit-docs` builds from the User Guide, and the rendered content of its pages.
+ *
+ * The tree is inlined by the bundler, because the subtree is built synchronously on every becca
+ * load. The content is not — it is an order of magnitude larger and only needed once a page is
+ * opened or searched — so it is fetched by {@link load} during worker startup. That is also the
+ * last moment it can be: by the time anything asks for a page, `getContent` is synchronous.
*/
export default class StandaloneInAppHelpProvider extends InAppHelpProvider {
+ private content: HelpBundle = {};
+
getHelpHiddenSubtreeData(): HiddenSubtreeItem[] {
return helpMeta as HiddenSubtreeItem[];
}
+
+ getHelpContent(): HelpBundle {
+ return this.content;
+ }
+
+ getHelpAssetBase(): string {
+ return HELP_ASSETS;
+ }
+
+ async getHelpAsset(assetPath: string): Promise<Uint8Array | null> {
+ const url = `/${HELP_ASSETS}/${assetPath.split("/").map(encodeURIComponent).join("/")}`;
+ try {
+ const response = await fetch(url);
+ return response.ok ? new Uint8Array(await response.arrayBuffer()) : null;
+ } catch {
+ return null;
+ }
+ }
+
+ /**
+ * Loads the page content. Failing costs the pages their bodies while the tree, the titles and
+ * the navigation keep working, so it is logged rather than allowed to fail startup.
+ */
+ async load(): Promise<void> {
+ try {
+ const response = await fetch(`/${HELP_ASSETS}/help_content.json`);
+
+ if (!response.ok) {
+ throw new Error(`HTTP ${response.status}`);
+ }
+
+ this.content = await response.json() as HelpBundle;
+ } catch (e) {
+ console.warn("[Worker] In-app help content could not be loaded:", e);
+ }
+ }
}
diff --git a/apps/standalone/src/local-server-worker.ts b/apps/standalone/src/local-server-worker.ts
index d5daacce65..723e13cae6 100644
--- a/apps/standalone/src/local-server-worker.ts
+++ b/apps/standalone/src/local-server-worker.ts
@@ -95,6 +95,8 @@ let StandaloneLogService: typeof import('./lightweight/log_provider').default;
let StandaloneBackupService: typeof import('./lightweight/backup_provider').default;
let removeBackupLeftovers: typeof import('./lightweight/backup_provider').removeBackupLeftovers;
let StandaloneInAppHelpProvider: typeof import('./lightweight/in_app_help_provider').default;
+let inAppHelpProvider: InstanceType<typeof import('./lightweight/in_app_help_provider').default>;
+let inAppHelpLoaded: Promise<void>;
let translationProvider: typeof import('./lightweight/translation_provider').default;
let createConfiguredRouter: typeof import('./lightweight/browser_routes').createConfiguredRouter;
let waitForSahPoolRelease: typeof import('./lightweight/sql_provider').waitForSahPoolRelease;
@@ -214,6 +216,11 @@ async function loadModules(): Promise<void> {
// Loaded separately to avoid breaking Promise.all tuple inference
BridgedRequestProvider = (await import('./lightweight/bridged_request_provider.js')).default;
StandaloneInAppHelpProvider = (await import('./lightweight/in_app_help_provider.js')).default;
+ // Started here rather than at the point of use: the guide's content is a plain fetch, so it
+ // can run alongside opening the database instead of adding to startup, and it has to be in
+ // memory before anything reads a page — `getContent` is synchronous by then.
+ inAppHelpProvider = new StandaloneInAppHelpProvider();
+ inAppHelpLoaded = inAppHelpProvider.load();
// Create instances
sqlProvider = new BrowserSqlProvider();
@@ -335,7 +342,7 @@ async function initialize(): Promise<void> {
if (!response.ok) return null;
return new Uint8Array(await response.arrayBuffer());
},
- inAppHelp: new StandaloneInAppHelpProvider(),
+ inAppHelp: inAppHelpProvider,
image: (await import("./services/image_provider.js")).standaloneImageProvider,
// What `assertScriptingEnabled()` answers from. Read from a locked OPFS file rather
// than the database, because the SQL console is enabled separately and an `UPDATE
@@ -363,6 +370,11 @@ async function initialize(): Promise<void> {
});
coreModule.ws.init();
+ // Nothing can read a help page before the routes are up, and by then this has long
+ // since resolved; awaited so a slow network delays the first page rather than
+ // silently serving it empty.
+ await inAppHelpLoaded;
+
// This build's half of the LLM stack, mirroring what the server
// contributes in registerServerLlmExtensions. Imported here rather than
// at the top of the file so the skill sheets it inlines travel in a
diff --git a/apps/standalone/src/test_setup.ts b/apps/standalone/src/test_setup.ts
index c33f930c4d..777ebbe569 100644
--- a/apps/standalone/src/test_setup.ts
+++ b/apps/standalone/src/test_setup.ts
@@ -10,6 +10,7 @@ import { beforeAll } from "vitest";
import StandaloneBackupService from "./lightweight/backup_provider.js";
import BrowserExecutionContext from "./lightweight/cls_provider.js";
import BrowserCryptoProvider from "./lightweight/crypto_provider.js";
+import StandaloneInAppHelpProvider from "./lightweight/in_app_help_provider.js";
import StandalonePlatformProvider from "./lightweight/platform_provider.js";
import { registerShareProvider } from "./lightweight/share_provider.js";
import BrowserSqlProvider from "./lightweight/sql_provider.js";
@@ -125,6 +126,9 @@ beforeAll(async () => {
});
},
platform: new StandalonePlatformProvider(""),
+ // Mirrors production (local-server-worker): registers the _help virtual note
+ // provider so the virtual help subtree exists in this environment's becca too.
+ inAppHelp: new StandaloneInAppHelpProvider(),
backup: new StandaloneBackupService(options),
image: standaloneImageProvider,
schema: schemaSql,
diff --git a/apps/standalone/vite.config.mts b/apps/standalone/vite.config.mts
index edb071f290..a5efb27374 100644
--- a/apps/standalone/vite.config.mts
+++ b/apps/standalone/vite.config.mts
@@ -120,6 +120,77 @@ const sqliteWasmPlugin = viteStaticCopy({
]
});
+/** Source of the in-app help's images and attachments, and the URL the app requests them under. */
+const HELP_ASSETS_SOURCE = join(__dirname, "../../docs/User Guide");
+const HELP_ASSETS_DEST = join(__dirname, "dist/server-assets/help");
+const HELP_ASSETS_URL = "/server-assets/help/";
+
+const HELP_ASSET_MIME_TYPES: Record<string, string> = {
+ png: "image/png",
+ gif: "image/gif",
+ webp: "image/webp",
+ jpg: "image/jpeg",
+ jpeg: "image/jpeg",
+ svg: "image/svg+xml",
+ json: "application/json"
+};
+
+/** The guide's own files, as opposed to the content bundle that arrives with the server's assets. */
+function isHelpAsset(sourcePath: string) {
+ return !sourcePath.endsWith(".md") && !sourcePath.endsWith("!!!meta.json");
+}
+
+/**
+ * Serves the guide's images and attachments beside the content bundle that comes with the
+ * server's assets. They belong to the User Guide rather than to the server, so no other copy step
+ * brings them in, and the markdown they were built from is not needed at runtime.
+ *
+ * Both halves are needed: a build copies them into the output, and the dev server reads them
+ * straight from the guide — without that, requests fall through to the SPA fallback and every
+ * image on a help page comes back as index.html with a 200.
+ */
+function copyHelpAssetsPlugin(): Plugin {
+ return {
+ name: "trilium-copy-help-assets",
+ configureServer(server) {
+ server.middlewares.use((req, res, next) => {
+ if (!req.url?.startsWith(HELP_ASSETS_URL)) {
+ return next();
+ }
+
+ const relativePath = decodeURIComponent(req.url.slice(HELP_ASSETS_URL.length).split("?")[0]);
+ const filePath = join(HELP_ASSETS_SOURCE, relativePath);
+
+ // Same prefix-collision guard as the PDF.js middleware above.
+ if (!resolve(filePath).startsWith(resolve(HELP_ASSETS_SOURCE) + sep) || !isHelpAsset(filePath)) {
+ return next();
+ }
+
+ // Anything not found here — the content bundle and the tree — is copied in from
+ // the server's assets, so it belongs to the next middleware.
+ if (!fs.existsSync(filePath) || !fs.statSync(filePath).isFile()) {
+ return next();
+ }
+
+ const extension = filePath.split(".").pop()?.toLowerCase() ?? "";
+ res.setHeader("Content-Type", HELP_ASSET_MIME_TYPES[extension] ?? "application/octet-stream");
+ fs.createReadStream(filePath).pipe(res);
+ });
+ },
+ closeBundle() {
+ if (isDev) {
+ return;
+ }
+
+ fs.cpSync(HELP_ASSETS_SOURCE, HELP_ASSETS_DEST, {
+ recursive: true,
+ dereference: true,
+ filter: isHelpAsset
+ });
+ }
+ };
+}
+
let plugins: any = [
stripUniverHyphenation(),
stripUniverEmojiData(),
@@ -142,15 +213,14 @@ let plugins: any = [
targets: [
{
src: [
- "../../server/src/assets/**/*",
- // Exclude the User Guide (~20 MB) since it's not needed in standalone mode.
- "!../../server/src/assets/doc_notes/en/User Guide/**"
+ "../../server/src/assets/**/*"
],
dest: "server-assets",
rename: { stripBase: 3 }
}
]
}),
+ copyHelpAssetsPlugin(),
// What the share theme's own pages load besides its bundle: the icon-pack fonts the client ships
// and the logo, each at the path content_renderer.ts writes into the page. The server answers
// these from express.static routes it registers in routes/assets.ts; here they are copied into
diff --git a/docs/Developer Guide/Developer Guide/Documentation.md b/docs/Developer Guide/Developer Guide/Documentation.md
index dac8a44b97..76dcda30ca 100644
--- a/docs/Developer Guide/Developer Guide/Documentation.md
+++ b/docs/Developer Guide/Developer Guide/Documentation.md
@@ -14,7 +14,8 @@ All documentation is stored in the [Trilium](https://github.com/TriliumNext/Tril
* `docs/Release Notes` is also stored in Markdown format and can be freely edited.
* The _Script API_ is auto-generated and is **not** committed to the repository. It is built into the gitignored `site/` directory and published to [docs.triliumnotes.org](https://docs.triliumnotes.org/); see [Updating the Script API](#updating-the-script-api) below.
* `docs/User Guide` contains Markdown documentation as well, together with a `!!!meta.json` file that describes the note tree (note IDs, share aliases, icons, attachments).
- * From it, `apps/server/src/assets/doc_notes/en/User Guide` (the HTML rendered by the in-app help) and `apps/standalone/src/assets/help_meta.json` are generated. These generated files must never be edited by hand.
+ * From it, `apps/server/src/assets/help/help_meta.json` (the note tree of the in-app help) and `apps/server/src/assets/help/help_content.json` (the HTML of each page) are generated. These generated files must never be edited by hand.
+ * The in-app help is not stored in the database: at startup, Trilium builds the `_help` subtree from these two files as read-only virtual notes, which are never persisted or synchronized.
* The Markdown can be edited by hand, as long as the generated files are refreshed afterwards by running `pnpm edit-docs:sync-docs` (see below).
The mappings between note trees and directories are listed in `edit-docs-config.yaml` at the root of the repository.
@@ -33,7 +34,7 @@ To edit the documentation using Trilium, set up a working development environmen
How it works:
* At startup, the documentation from `docs/` is imported from Markdown into a in-memory session (the initialization of the database is already handled by the application).
-* Each modification will trigger after 10s an export from the in-memory Trilium session back to Markdown, including the meta file, as well as the HTML and meta files used by the in-app help.
+* Each modification will trigger after 10s an export from the in-memory Trilium session back to Markdown, including the meta file, as well as the two files used by the in-app help.
### Manual editing
diff --git a/docs/Release Notes/!!!meta.json b/docs/Release Notes/!!!meta.json
index 19da07f525..0ee7af6126 100644
--- a/docs/Release Notes/!!!meta.json
+++ b/docs/Release Notes/!!!meta.json
@@ -1272,7 +1272,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "v0.90.5-beta_image.png"
+ "dataFileName": "v0.90.5-beta_image.jpg"
}
]
},
@@ -1397,7 +1397,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "v0.48_note-map.png"
+ "dataFileName": "v0.48_note-map.jpg"
},
{
"attachmentId": "c74WFpjTo0p4",
@@ -1405,7 +1405,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "v0.48_screenshot.png"
+ "dataFileName": "v0.48_screenshot.jpg"
},
{
"attachmentId": "szlnTmTJL4HL",
@@ -1413,7 +1413,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "v0.48_split.png"
+ "dataFileName": "v0.48_split.jpg"
},
{
"attachmentId": "VQxrtpQTYmI6",
@@ -1421,7 +1421,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "v0.48_bookmarks.png"
+ "dataFileName": "v0.48_bookmarks.jpg"
},
{
"attachmentId": "ZRyEqxAv1MTd",
diff --git a/docs/Release Notes/Release Notes/v0.48.md b/docs/Release Notes/Release Notes/v0.48.md
index f1b5e5c3ba..8ac3255460 100644
--- a/docs/Release Notes/Release Notes/v0.48.md
+++ b/docs/Release Notes/Release Notes/v0.48.md
@@ -3,7 +3,7 @@
## Major frontend redesign
-<img src="v0.48_screenshot.png" alt="" width="1047" height="772">
+<img src="v0.48_screenshot.jpg" alt="" width="1047" height="772">
* right panel is no more, most of these widgets have been moved to the new ribbon-style widget under note title
* right panel is still possible to activate for scripts
@@ -11,13 +11,13 @@
## Vertical split window
-<figure class="image"><img style="aspect-ratio:1047/779;" src="v0.48_split.png" alt="" width="1047" height="779"></figure>
+<figure class="image"><img style="aspect-ratio:1047/779;" src="v0.48_split.jpg" alt="" width="1047" height="779"></figure>
## Link map re-implemented
Now supports also hierarchical view of the notes:
-<figure class="image"><img style="aspect-ratio:1082/786;" src="v0.48_note-map.png" alt="" width="1082" height="786"></figure>
+<figure class="image"><img style="aspect-ratio:1082/786;" src="v0.48_note-map.jpg" alt="" width="1082" height="786"></figure>
## Mermaid diagrams
@@ -27,7 +27,7 @@ Thanks to [@abitofevrything](https://github.com/abitofevrything) for this contri
## Basic bookmark support
-<figure class="image"><img style="aspect-ratio:1200/815;" src="v0.48_bookmarks.png" alt="" width="1200" height="815"></figure>
+<figure class="image"><img style="aspect-ratio:1200/815;" src="v0.48_bookmarks.jpg" alt="" width="1200" height="815"></figure>
## Other changes
diff --git a/docs/Release Notes/Release Notes/v0.48_bookmarks.png b/docs/Release Notes/Release Notes/v0.48_bookmarks.jpg
similarity index 100%
rename from docs/Release Notes/Release Notes/v0.48_bookmarks.png
rename to docs/Release Notes/Release Notes/v0.48_bookmarks.jpg
diff --git a/docs/Release Notes/Release Notes/v0.48_note-map.png b/docs/Release Notes/Release Notes/v0.48_note-map.jpg
similarity index 100%
rename from docs/Release Notes/Release Notes/v0.48_note-map.png
rename to docs/Release Notes/Release Notes/v0.48_note-map.jpg
diff --git a/docs/Release Notes/Release Notes/v0.48_screenshot.png b/docs/Release Notes/Release Notes/v0.48_screenshot.jpg
similarity index 100%
rename from docs/Release Notes/Release Notes/v0.48_screenshot.png
rename to docs/Release Notes/Release Notes/v0.48_screenshot.jpg
diff --git a/docs/Release Notes/Release Notes/v0.48_split.png b/docs/Release Notes/Release Notes/v0.48_split.jpg
similarity index 100%
rename from docs/Release Notes/Release Notes/v0.48_split.png
rename to docs/Release Notes/Release Notes/v0.48_split.jpg
diff --git a/docs/Release Notes/Release Notes/v0.90.5-beta.md b/docs/Release Notes/Release Notes/v0.90.5-beta.md
index 44787678e1..b8b33d7d04 100644
--- a/docs/Release Notes/Release Notes/v0.90.5-beta.md
+++ b/docs/Release Notes/Release Notes/v0.90.5-beta.md
@@ -17,7 +17,7 @@ Mind maps are usually a fast method to write down ideas and do brainstorming wit
Note that the integration is still in its infancy, so there might be bugs and a lack of feature until it is stabilized. The library itself supports quite a few features that are not implemented yet in Trilium: math expressions using KaTeX, images, links. Those might be implemented along the way, provided they are needed by users.
-<figure class="image"><img src="v0.90.5-beta_image.png"></figure>
+<figure class="image"><img src="v0.90.5-beta_image.jpg"></figure>
> **Note**: For the note type to fully work (such as shared notes), it is ideal to update the server instance as well, if you are using one.
diff --git a/docs/Release Notes/Release Notes/v0.90.5-beta_image.png b/docs/Release Notes/Release Notes/v0.90.5-beta_image.jpg
similarity index 100%
rename from docs/Release Notes/Release Notes/v0.90.5-beta_image.png
rename to docs/Release Notes/Release Notes/v0.90.5-beta_image.jpg
diff --git a/docs/User Guide/!!!meta.json b/docs/User Guide/!!!meta.json
index a18e3d3084..ea9d749320 100644
--- a/docs/User Guide/!!!meta.json
+++ b/docs/User Guide/!!!meta.json
@@ -1147,7 +1147,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "Synchronization_image.png"
+ "dataFileName": "Synchronization_image.jpg"
},
{
"attachmentId": "x0t06ATHph6b",
@@ -1352,7 +1352,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "Data directory_image.png"
+ "dataFileName": "Data directory_image.jpg"
}
]
},
@@ -1499,7 +1499,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "Vertical and horizontal layout_image.png"
+ "dataFileName": "Vertical and horizontal layout_image.jpg"
},
{
"attachmentId": "JwO3rUNb9tyU",
@@ -1507,7 +1507,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "1_Vertical and horizontal layout_image.png"
+ "dataFileName": "1_Vertical and horizontal layout_image.jpg"
}
]
},
@@ -1551,7 +1551,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "Global menu_image.png"
+ "dataFileName": "Global menu_image.jpg"
}
]
},
@@ -1603,7 +1603,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "Note Tree_image.png"
+ "dataFileName": "Note Tree_image.jpg"
},
{
"attachmentId": "m0KuVBZvGyzW",
@@ -1718,7 +1718,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "1_Multiple selection_image.png"
+ "dataFileName": "Multiple selection_image.jpg"
},
{
"attachmentId": "xZnYDX7rv0rW",
@@ -1726,7 +1726,7 @@
"role": "image",
"mime": "image/png",
"position": 10,
- "dataFileName": "2_Multiple selection_image.png"
+ "dataFileName": "1_Multiple selection_image.png"
}
]
},
@@ -1913,7 +1913,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "Launch Bar_image.png"
+ "dataFileName": "Launch Bar_image.jpg"
}
]
},
@@ -3473,7 +3473,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "Note Navigation_image.png"
+ "dataFileName": "Note Navigation_image.jpg"
}
]
},
@@ -3855,7 +3855,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "Workspaces_image.png"
+ "dataFileName": "Workspaces_image.jpg"
},
{
"attachmentId": "vZSH2mOKzWBx",
@@ -3863,7 +3863,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "1_Workspaces_image.png"
+ "dataFileName": "1_Workspaces_image.jpg"
}
]
},
@@ -4046,7 +4046,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "Themes_image.png"
+ "dataFileName": "Themes_image.jpg"
}
],
"dirFileName": "Themes",
@@ -5154,7 +5154,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "Content language & Right-to-left support_image.png"
+ "dataFileName": "Content language & Right-to-left support_image.jpg"
}
]
},
@@ -5277,7 +5277,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "Developer-specific formatting_image.png"
+ "dataFileName": "Developer-specific formatting_image.jpg"
},
{
"attachmentId": "V9BY5v8WX15Q",
@@ -5285,7 +5285,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "1_Developer-specific formatting_image.png"
+ "dataFileName": "1_Developer-specific formatting_image.jpg"
},
{
"attachmentId": "VYcvGUzbobxQ",
@@ -5293,7 +5293,7 @@
"role": "image",
"mime": "image/png",
"position": 10,
- "dataFileName": "2_Developer-specific formatting_image.png"
+ "dataFileName": "Developer-specific formatting_image.png"
}
],
"dirFileName": "Developer-specific formatting",
@@ -5339,7 +5339,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "Code blocks_image.png"
+ "dataFileName": "Code blocks_image.jpg"
},
{
"attachmentId": "kE8PPw7iyuu9",
@@ -5347,7 +5347,7 @@
"role": "image",
"mime": "image/png",
"position": 10,
- "dataFileName": "1_Code blocks_image.png"
+ "dataFileName": "Code blocks_image.png"
}
]
}
@@ -5489,7 +5489,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "1_Formatting toolbar_image.png"
+ "dataFileName": "Formatting toolbar_image.jpg"
},
{
"attachmentId": "jYEbPqDcUCNQ",
@@ -5497,7 +5497,7 @@
"role": "image",
"mime": "image/png",
"position": 10,
- "dataFileName": "2_Formatting toolbar_image.png"
+ "dataFileName": "1_Formatting toolbar_image.png"
},
{
"attachmentId": "WV5kfOEFZdMa",
@@ -5505,7 +5505,7 @@
"role": "image",
"mime": "image/png",
"position": 10,
- "dataFileName": "3_Formatting toolbar_image.png"
+ "dataFileName": "2_Formatting toolbar_image.png"
}
]
},
@@ -5652,7 +5652,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "Images_image.png"
+ "dataFileName": "Images_image.jpg"
},
{
"attachmentId": "Bi9LiB0eMbcH",
@@ -5660,7 +5660,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "1_Images_image.png"
+ "dataFileName": "1_Images_image.jpg"
},
{
"attachmentId": "dRgFtpOcHwke",
@@ -5668,7 +5668,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "2_Images_image.png"
+ "dataFileName": "2_Images_image.jpg"
},
{
"attachmentId": "NZJRGKS6yDeg",
@@ -5676,7 +5676,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "3_Images_image.png"
+ "dataFileName": "3_Images_image.jpg"
},
{
"attachmentId": "qJXx7vPPD4JW",
@@ -5684,7 +5684,7 @@
"role": "image",
"mime": "image/png",
"position": 10,
- "dataFileName": "4_Images_image.png"
+ "dataFileName": "Images_image.png"
}
],
"dirFileName": "Images",
@@ -6244,7 +6244,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "Lists_image.png"
+ "dataFileName": "Lists_image.jpg"
},
{
"attachmentId": "JopMc0iA0dqA",
@@ -6252,7 +6252,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "1_Lists_image.png"
+ "dataFileName": "1_Lists_image.jpg"
},
{
"attachmentId": "kZMYrJubac6T",
@@ -6260,7 +6260,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "2_Lists_image.png"
+ "dataFileName": "2_Lists_image.jpg"
},
{
"attachmentId": "VgoG6BtlLYn7",
@@ -6268,7 +6268,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "3_Lists_image.png"
+ "dataFileName": "3_Lists_image.jpg"
},
{
"attachmentId": "y0zFP6x0IRRf",
@@ -6276,7 +6276,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "4_Lists_image.png"
+ "dataFileName": "4_Lists_image.jpg"
},
{
"attachmentId": "z8eVlXe2WKqr",
@@ -6284,7 +6284,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "5_Lists_image.png"
+ "dataFileName": "5_Lists_image.jpg"
}
]
},
@@ -6785,7 +6785,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "Code_image.png"
+ "dataFileName": "Code_image.jpg"
}
]
},
@@ -8315,7 +8315,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "Anonymized Database_image.png"
+ "dataFileName": "Anonymized Database_image.jpg"
}
]
},
@@ -8438,7 +8438,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "Frontend logs_image.png"
+ "dataFileName": "Frontend logs_image.jpg"
},
{
"attachmentId": "Y05WqmS4uMMt",
@@ -8594,7 +8594,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "Creating a custom theme_3_Creating a custom theme_im.png"
+ "dataFileName": "Creating a custom theme_3_Creating a custom theme_im.jpg"
},
{
"attachmentId": "hJc5fBNfSLoY",
@@ -8602,7 +8602,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "Creating a custom theme_Creating a custom theme_im.png"
+ "dataFileName": "Creating a custom theme_Creating a custom theme_im.jpg"
},
{
"attachmentId": "j3OaGihW6eg3",
@@ -8610,7 +8610,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "Creating a custom theme_1_Creating a custom theme_im.png"
+ "dataFileName": "Creating a custom theme_1_Creating a custom theme_im.jpg"
},
{
"attachmentId": "LCQ6zvUbvXQr",
@@ -8618,7 +8618,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "Creating a custom theme_4_Creating a custom theme_im.png"
+ "dataFileName": "Creating a custom theme_4_Creating a custom theme_im.jpg"
},
{
"attachmentId": "mY5EGlN7TO6I",
@@ -8626,7 +8626,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "Creating a custom theme_5_Creating a custom theme_im.png"
+ "dataFileName": "Creating a custom theme_5_Creating a custom theme_im.jpg"
},
{
"attachmentId": "TMHEj1M3XFGO",
@@ -8634,7 +8634,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "Creating a custom theme_2_Creating a custom theme_im.png"
+ "dataFileName": "Creating a custom theme_2_Creating a custom theme_im.jpg"
}
]
},
@@ -9363,7 +9363,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "Serving directly the content of a note_image.png"
+ "dataFileName": "Serving directly the content of a note_image.jpg"
},
{
"attachmentId": "ixkXFTSSkdpL",
@@ -9371,7 +9371,7 @@
"role": "image",
"mime": "image/png",
"position": 10,
- "dataFileName": "1_Serving directly the content of a note_image.png"
+ "dataFileName": "Serving directly the content of a note_image.png"
}
]
},
@@ -9565,7 +9565,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "1_Day Notes_image.png"
+ "dataFileName": "Day Notes_image.jpg"
}
]
},
@@ -9609,7 +9609,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "Weight Tracker_image.png"
+ "dataFileName": "Weight Tracker_image.jpg"
}
]
},
@@ -9941,7 +9941,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "Manually altering the database_image.png"
+ "dataFileName": "Manually altering the database_image.jpg"
}
],
"dirFileName": "Manually altering the database",
@@ -9987,7 +9987,7 @@
"role": "image",
"mime": "image/jpg",
"position": 10,
- "dataFileName": "SQL Console_image.png"
+ "dataFileName": "SQL Console_image.jpg"
},
{
"attachmentId": "wdBs3e0MApgs",
@@ -9995,7 +9995,7 @@
"role": "image",
"mime": "image/png",
"position": 10,
- "dataFileName": "1_SQL Console_image.png"
+ "dataFileName": "SQL Console_image.png"
}
]
}
diff --git a/docs/User Guide/User Guide/Advanced Usage/Advanced Showcases/1_Day Notes_image.png b/docs/User Guide/User Guide/Advanced Usage/Advanced Showcases/1_Day Notes_image.png
deleted file mode 100644
index 9e03a2375d..0000000000
Binary files a/docs/User Guide/User Guide/Advanced Usage/Advanced Showcases/1_Day Notes_image.png and /dev/null differ
diff --git a/docs/User Guide/User Guide/Advanced Usage/Advanced Showcases/Day Notes.md b/docs/User Guide/User Guide/Advanced Usage/Advanced Showcases/Day Notes.md
index 2bc1931bdd..7910a3591d 100644
--- a/docs/User Guide/User Guide/Advanced Usage/Advanced Showcases/Day Notes.md
+++ b/docs/User Guide/User Guide/Advanced Usage/Advanced Showcases/Day Notes.md
@@ -5,7 +5,7 @@ For this, Trilium provides a concept of "day note". Trilium semi-automatically g
Select an existing day note, and the menubar contains a calendar widget. Select any day to create a note for that day. 
-![](1_Day%20Notes_image.png)
+![](Day%20Notes_image.jpg)
This pattern works well also because of [Cloning Notes](../../Basic%20Concepts%20and%20Features/Notes/Cloning%20Notes.md) functionality - note can appear in multiple places in the note tree, so besides appearing under day note, it can also be categorized into other notes.
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Advanced Showcases/1_Day Notes_image.png b/docs/User Guide/User Guide/Advanced Usage/Advanced Showcases/Day Notes_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Advanced Showcases/1_Day Notes_image.png
rename to docs/User Guide/User Guide/Advanced Usage/Advanced Showcases/Day Notes_image.jpg
diff --git a/docs/User Guide/User Guide/Advanced Usage/Advanced Showcases/Weight Tracker.md b/docs/User Guide/User Guide/Advanced Usage/Advanced Showcases/Weight Tracker.md
index 5b9198ec28..eec1b2fa78 100644
--- a/docs/User Guide/User Guide/Advanced Usage/Advanced Showcases/Weight Tracker.md
+++ b/docs/User Guide/User Guide/Advanced Usage/Advanced Showcases/Weight Tracker.md
@@ -1,5 +1,5 @@
# Weight Tracker
-![](Weight%20Tracker_image.png)
+![](Weight%20Tracker_image.jpg)
The `Weight Tracker` is a [Script API](../../Scripting/Script%20API.md) showcase present in the [demo notes](../Database.md).
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Advanced Showcases/Weight Tracker_image.png b/docs/User Guide/User Guide/Advanced Usage/Advanced Showcases/Weight Tracker_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Advanced Showcases/Weight Tracker_image.png
rename to docs/User Guide/User Guide/Advanced Usage/Advanced Showcases/Weight Tracker_image.jpg
diff --git a/docs/User Guide/User Guide/Advanced Usage/Advanced Showcases/Weight Tracker_image.png b/docs/User Guide/User Guide/Advanced Usage/Advanced Showcases/Weight Tracker_image.png
deleted file mode 100644
index 0167e759ba..0000000000
Binary files a/docs/User Guide/User Guide/Advanced Usage/Advanced Showcases/Weight Tracker_image.png and /dev/null differ
diff --git a/docs/User Guide/User Guide/Advanced Usage/Attributes/Labels.md b/docs/User Guide/User Guide/Advanced Usage/Attributes/Labels.md
index 1f6e9187f2..135be11290 100644
--- a/docs/User Guide/User Guide/Advanced Usage/Attributes/Labels.md
+++ b/docs/User Guide/User Guide/Advanced Usage/Attributes/Labels.md
@@ -71,6 +71,7 @@ This is a list of labels that Trilium natively supports.
| `share*` | See the attribute reference in <a class="reference-link" href="../Sharing.md">Sharing</a>. |
| `displayRelations`, `hideRelations` | Comma delimited names of relations which should be displayed/hidden in a <a class="reference-link" href="../../Note%20Types/Relation%20Map.md">Relation Map</a> (both the note type and the <a class="reference-link" href="../Note%20Map%20(Link%20map%2C%20Tree%20map).md">Note Map (Link map, Tree map)</a> general functionality). |
| `titleTemplate` | Default title of notes created as children of this note. This value is evaluated as a JavaScript string and thus can be enriched with dynamic content via the injected `now` and `parentNote` variables.       <br> <br>See <a class="reference-link" href="../Default%20Note%20Title.md">Default Note Title</a> for more info. |
+| `template:titleTemplate` | Set on a template note: default title of notes created from the template, taking precedence over the parent's `titleTemplate`. Evaluated the same way as `titleTemplate`. See <a class="reference-link" href="../Default%20Note%20Title.md">Default Note Title</a>. |
| `template` | This note will appear in the selection of available template when creating new note. See <a class="reference-link" href="../Templates.md">Templates</a> for more information. |
| `color` | defines color of the note in note tree, links etc. Use any valid CSS color value like 'red' or #a13d5f        <br>Note: this color may be automatically adjusted when displayed to ensure sufficient contrast with the background. |
| `keyboardShortcut` | Defines a keyboard shortcut which will immediately jump to this note. Example: 'ctrl+alt+e'. Requires frontend reload for the change to take effect. |
diff --git a/docs/User Guide/User Guide/Advanced Usage/Database/Manually altering the database.md b/docs/User Guide/User Guide/Advanced Usage/Database/Manually altering the database.md
index 70841499cd..336145eb1b 100644
--- a/docs/User Guide/User Guide/Advanced Usage/Database/Manually altering the database.md
+++ b/docs/User Guide/User Guide/Advanced Usage/Database/Manually altering the database.md
@@ -28,7 +28,7 @@ To do so:
5. Press "Write Changes" in the main toolbar.
6. Close the application or close the database.
-![](Manually%20altering%20the%20database_image.png)
+![](Manually%20altering%20the%20database_image.jpg)
### Using the SQLite CLI
diff --git a/docs/User Guide/User Guide/Advanced Usage/Database/Manually altering the database/1_SQL Console_image.png b/docs/User Guide/User Guide/Advanced Usage/Database/Manually altering the database/1_SQL Console_image.png
deleted file mode 100644
index a395a969b4..0000000000
Binary files a/docs/User Guide/User Guide/Advanced Usage/Database/Manually altering the database/1_SQL Console_image.png and /dev/null differ
diff --git a/docs/User Guide/User Guide/Advanced Usage/Database/Manually altering the database/SQL Console.md b/docs/User Guide/User Guide/Advanced Usage/Database/Manually altering the database/SQL Console.md
index 68bbcb4faf..138448021e 100644
--- a/docs/User Guide/User Guide/Advanced Usage/Database/Manually altering the database/SQL Console.md
+++ b/docs/User Guide/User Guide/Advanced Usage/Database/Manually altering the database/SQL Console.md
@@ -6,7 +6,7 @@ The SQL Console is Trilium's built-in database editor.
It can be accessed by going to the <a class="reference-link" href="../../../Basic%20Concepts%20and%20Features/UI%20Elements/Global%20menu.md">Global menu</a> → Advanced → Open SQL Console.
-![](SQL%20Console_image.png)
+![](SQL%20Console_image.jpg)
### Interaction
@@ -16,7 +16,7 @@ It can be accessed by going to the <a class="reference-link" href="../../../Bas
* For queries that return a result, the data will displayed in a table.
* For statements (e.g. `INSERT`, `UPDATE`), the number of affected rows is displayed.
-<figure class="image"><img style="aspect-ratio:1124/571;" src="1_SQL Console_image.png" width="1124" height="571"></figure>
+<figure class="image"><img style="aspect-ratio:1124/571;" src="SQL Console_image.png" width="1124" height="571"></figure>
### Interacting with the table
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Database/Manually altering the database/SQL Console_image.png b/docs/User Guide/User Guide/Advanced Usage/Database/Manually altering the database/SQL Console_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Database/Manually altering the database/SQL Console_image.png
rename to docs/User Guide/User Guide/Advanced Usage/Database/Manually altering the database/SQL Console_image.jpg
diff --git a/docs/User Guide/User Guide/Advanced Usage/Database/Manually altering the database/SQL Console_image.png b/docs/User Guide/User Guide/Advanced Usage/Database/Manually altering the database/SQL Console_image.png
index 32a91fc2f3..a395a969b4 100644
Binary files a/docs/User Guide/User Guide/Advanced Usage/Database/Manually altering the database/SQL Console_image.png and b/docs/User Guide/User Guide/Advanced Usage/Database/Manually altering the database/SQL Console_image.png differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Database/Manually altering the database_image.png b/docs/User Guide/User Guide/Advanced Usage/Database/Manually altering the database_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Database/Manually altering the database_image.png
rename to docs/User Guide/User Guide/Advanced Usage/Database/Manually altering the database_image.jpg
diff --git a/docs/User Guide/User Guide/Advanced Usage/Database/Manually altering the database_image.png b/docs/User Guide/User Guide/Advanced Usage/Database/Manually altering the database_image.png
deleted file mode 100644
index 469899ebc0..0000000000
Binary files a/docs/User Guide/User Guide/Advanced Usage/Database/Manually altering the database_image.png and /dev/null differ
diff --git a/docs/User Guide/User Guide/Advanced Usage/Default Note Title.md b/docs/User Guide/User Guide/Advanced Usage/Default Note Title.md
index 3ee4676721..678c594de9 100644
--- a/docs/User Guide/User Guide/Advanced Usage/Default Note Title.md
+++ b/docs/User Guide/User Guide/Advanced Usage/Default Note Title.md
@@ -13,6 +13,15 @@ Now, to the parent note "2022 Books" you can assign label `#titleTemplate="[Auth
And all children of "2022 Books" will be created with initial title "\[Author name\]: \[Book title\], \[Publication year\]". There's no artificial intelligence here, the idea is to just prompt you to manually fill in the pieces of information into the note title by yourself.
+## Titles set by a template
+
+A template can name the notes created from it, wherever they are created. To do so, add a `#template:titleTemplate` label to the template note, for example `#template:titleTemplate="Meeting ${now.format('YYYY-MM-DD')}"` on a _Meeting_ template.
+
+* It applies both when the template is picked explicitly and when it comes from a parent's `~child:template`. See <a class="reference-link" href="Templates.md">Templates</a>.
+* It takes precedence over the parent's `#titleTemplate`. A title typed in by the user always wins.
+* It can be inherited from the template's ancestors in the tree (for example, a folder holding several templates), in which case a label owned by the template itself takes precedence. A note created from a template and later marked as a template does not keep that template's title.
+* Its value is evaluated the same way as `#titleTemplate`, with `parentNote` being the parent of the new note.
+
## Dynamic value
The value of `#titleTemplate` is evaluated at the point of note's creation as a JavaScript string, which means it can be enriched with the help of JS string interpolation with dynamic data.
diff --git a/docs/User Guide/User Guide/Advanced Usage/Hidden Notes.md b/docs/User Guide/User Guide/Advanced Usage/Hidden Notes.md
index 20710e4b1e..79f7d4cde1 100644
--- a/docs/User Guide/User Guide/Advanced Usage/Hidden Notes.md
+++ b/docs/User Guide/User Guide/Advanced Usage/Hidden Notes.md
@@ -73,7 +73,7 @@ Here is a brief summary of all the notes within the hidden tree:
</tr>
<tr>
<td><a class="reference-link" href="#root/_hidden/_help">User Guide</a></td>
- <td>This is where the note structure for the User Guide is actually stored. Only the metadata is stored, as the help itself is present as actual files in the application directory.</td>
+ <td>This is where the User Guide appears in the note tree. Its notes are not stored in the database: Trilium builds them from files that ship with the application each time it starts, so they cannot be edited, moved or cloned, and they are not synchronized.</td>
</tr>
</tbody>
</table>
\ No newline at end of file
diff --git a/docs/User Guide/User Guide/Advanced Usage/Sharing/1_Serving directly the content of a note_image.png b/docs/User Guide/User Guide/Advanced Usage/Sharing/1_Serving directly the content of a note_image.png
deleted file mode 100644
index 23592294b1..0000000000
Binary files a/docs/User Guide/User Guide/Advanced Usage/Sharing/1_Serving directly the content of a note_image.png and /dev/null differ
diff --git a/docs/User Guide/User Guide/Advanced Usage/Sharing/Serving directly the content of a note.md b/docs/User Guide/User Guide/Advanced Usage/Sharing/Serving directly the content of a note.md
index 40bb27c335..71c4375ded 100644
--- a/docs/User Guide/User Guide/Advanced Usage/Sharing/Serving directly the content of a note.md
+++ b/docs/User Guide/User Guide/Advanced Usage/Sharing/Serving directly the content of a note.md
@@ -3,7 +3,7 @@ When accessing a shared note, Trilium will render it as a web page. Sometimes it
| A note displayed as a web page (HTML) | A note displayed as a raw format |
| --- | --- |
-| <figure class="image"><img style="aspect-ratio:738/275;" src="1_Serving directly the content of a note_image.png" width="738" height="275"></figure> | ![](Serving%20directly%20the%20content%20of%20a%20note_image.png) |
+| <figure class="image"><img style="aspect-ratio:738/275;" src="Serving directly the content of a note_image.png" width="738" height="275"></figure> | ![](Serving%20directly%20the%20content%20of%20a%20note_image.jpg) |
## By adding an attribute to the note
@@ -13,4 +13,4 @@ Simply add the `#shareRaw` attribute and the note will always be rendered _raw_
Append `?raw` to the URL to display a note in its raw format regardless of whether the `#shareRaw` attribute is added on the note.
-![](Serving%20directly%20the%20content%20of%20a%20note_image.png)
\ No newline at end of file
+![](Serving%20directly%20the%20content%20of%20a%20note_image.jpg)
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Sharing/Serving directly the content of a note_image.png b/docs/User Guide/User Guide/Advanced Usage/Sharing/Serving directly the content of a note_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Advanced Usage/Sharing/Serving directly the content of a note_image.png
rename to docs/User Guide/User Guide/Advanced Usage/Sharing/Serving directly the content of a note_image.jpg
diff --git a/docs/User Guide/User Guide/Advanced Usage/Sharing/Serving directly the content of a note_image.png b/docs/User Guide/User Guide/Advanced Usage/Sharing/Serving directly the content of a note_image.png
index bab0f97f53..23592294b1 100644
Binary files a/docs/User Guide/User Guide/Advanced Usage/Sharing/Serving directly the content of a note_image.png and b/docs/User Guide/User Guide/Advanced Usage/Sharing/Serving directly the content of a note_image.png differ
diff --git a/docs/User Guide/User Guide/Advanced Usage/Templates.md b/docs/User Guide/User Guide/Advanced Usage/Templates.md
index 5bb2313671..127d4a1983 100644
--- a/docs/User Guide/User Guide/Advanced Usage/Templates.md
+++ b/docs/User Guide/User Guide/Advanced Usage/Templates.md
@@ -59,10 +59,14 @@ By default, newly created notes are <a class="reference-link" href="../Note%20T
Selecting a specific template from the creation menu always takes precedence over `child:template`.
+## Default title for new notes
+
+A template can also give its instances a default title, using the `#template:titleTemplate` label. See <a class="reference-link" href="Default%20Note%20Title.md">Default Note Title</a> for details.
+
## Additional Notes
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 <a class="reference-link" href="Database/Demo%20Notes.md">Demo Notes</a>, including examples like the <a class="reference-link" href="../Note%20Types/Relation%20Map.md">Relation Map</a>, <a class="reference-link" href="Advanced%20Showcases/Task%20Manager.md">Task Manager</a>, and <a class="reference-link" href="Advanced%20Showcases/Day%20Notes.md">Day Notes</a>.
-Additionally, see <a class="reference-link" href="Default%20Note%20Title.md">Default Note Title</a> for creating title templates. Note templates and title templates can be combined by creating a `#titleTemplate` for a template note.
\ No newline at end of file
+Additionally, see <a class="reference-link" href="Default%20Note%20Title.md">Default Note Title</a> for creating title templates. A `#titleTemplate` on a template note is passed on to its instances like any other label, so it names the children of each instance rather than the instances themselves; to name the instances, use `#template:titleTemplate`.
\ No newline at end of file
diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/Import & Export.md b/docs/User Guide/User Guide/Basic Concepts and Features/Import & Export.md
index cefccb255a..6459bc0ddf 100644
--- a/docs/User Guide/User Guide/Basic Concepts and Features/Import & Export.md
+++ b/docs/User Guide/User Guide/Basic Concepts and Features/Import & Export.md
@@ -65,4 +65,11 @@ You can easily move the notes onto the root using the tree's <a class="referenc
</table>
> [!TIP]
-> Instead of exporting full ZIPs (including the root note), consider using [backups](../Installation%20%26%20Setup/Backup.md) instead. Backups always contain the entire structure, as well as additional information a ZIP export does not have: maintains note IDs, contains the options/tokens and handle <a class="reference-link" href="Notes/Protected%20Notes.md">Protected Notes</a> better.
\ No newline at end of file
+> Instead of exporting full ZIPs (including the root note), consider using [backups](../Installation%20%26%20Setup/Backup.md) instead. Backups always contain the entire structure, as well as additional information a ZIP export does not have: maintains note IDs, contains the options/tokens and handle <a class="reference-link" href="Notes/Protected%20Notes.md">Protected Notes</a> better.
+
+## Exporting the User Guide
+
+The in-app User Guide can be exported like any other note: right click one of its pages or chapters in the <a class="reference-link" href="UI%20Elements/Note%20Tree.md">Note Tree</a> and select _Export_, or use <a class="reference-link" href="UI%20Elements/Note%20menu.md">Note menu</a> → _Export note_.
+
+* Exporting a chapter with _This note & all descendants_ writes the pictures and files of each page as its attachments. Importing that archive creates an ordinary copy that you can edit, with its pictures and the links between its pages working.
+* Exporting a single page with _Only this note_ embeds its pictures in the exported file.
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/1_Workspaces_image.png b/docs/User Guide/User Guide/Basic Concepts and Features/Navigation/1_Workspaces_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/1_Workspaces_image.png
rename to docs/User Guide/User Guide/Basic Concepts and Features/Navigation/1_Workspaces_image.jpg
diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/Navigation/1_Workspaces_image.png b/docs/User Guide/User Guide/Basic Concepts and Features/Navigation/1_Workspaces_image.png
deleted file mode 100644
index ae10ee7cb1..0000000000
Binary files a/docs/User Guide/User Guide/Basic Concepts and Features/Navigation/1_Workspaces_image.png and /dev/null differ
diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/Navigation/Note Navigation.md b/docs/User Guide/User Guide/Basic Concepts and Features/Navigation/Note Navigation.md
index 10edf13097..c24d4321e6 100644
--- a/docs/User Guide/User Guide/Basic Concepts and Features/Navigation/Note Navigation.md
+++ b/docs/User Guide/User Guide/Basic Concepts and Features/Navigation/Note Navigation.md
@@ -7,7 +7,7 @@ You can use alt-left and alt-right to move back and forward in history of viewed
This works identically to browser backwards / forwards, it's actually using built-in browser support for this.
-![](Note%20Navigation_image.png)
+![](Note%20Navigation_image.jpg)
## Jump to note
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Note Navigation_image.png b/docs/User Guide/User Guide/Basic Concepts and Features/Navigation/Note Navigation_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Note Navigation_image.png
rename to docs/User Guide/User Guide/Basic Concepts and Features/Navigation/Note Navigation_image.jpg
diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/Navigation/Note Navigation_image.png b/docs/User Guide/User Guide/Basic Concepts and Features/Navigation/Note Navigation_image.png
deleted file mode 100644
index 2ea2690121..0000000000
Binary files a/docs/User Guide/User Guide/Basic Concepts and Features/Navigation/Note Navigation_image.png and /dev/null differ
diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/Navigation/Workspaces.md b/docs/User Guide/User Guide/Basic Concepts and Features/Navigation/Workspaces.md
index d26281d523..c32335f389 100644
--- a/docs/User Guide/User Guide/Basic Concepts and Features/Navigation/Workspaces.md
+++ b/docs/User Guide/User Guide/Basic Concepts and Features/Navigation/Workspaces.md
@@ -6,9 +6,9 @@ So far workspace consists of these features:
* [note hoisting](Note%20Hoisting.md) - you can "zoom" into a workspace subtree to focus only on the relevant notes
* easy entering of workspace: 
- ![](1_Workspaces_image.png)
+ ![](1_Workspaces_image.jpg)
* visual identification of workspace in tabs:
- ![](Workspaces_image.png)
+ ![](Workspaces_image.jpg)
### Configuration
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Workspaces_image.png b/docs/User Guide/User Guide/Basic Concepts and Features/Navigation/Workspaces_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Navigation/Workspaces_image.png
rename to docs/User Guide/User Guide/Basic Concepts and Features/Navigation/Workspaces_image.jpg
diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/Navigation/Workspaces_image.png b/docs/User Guide/User Guide/Basic Concepts and Features/Navigation/Workspaces_image.png
deleted file mode 100644
index 2401cf0836..0000000000
Binary files a/docs/User Guide/User Guide/Basic Concepts and Features/Navigation/Workspaces_image.png and /dev/null differ
diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/Notes/Note badges.md b/docs/User Guide/User Guide/Basic Concepts and Features/Notes/Note badges.md
index fc7fb41db6..0fb6a6d7ba 100644
--- a/docs/User Guide/User Guide/Basic Concepts and Features/Notes/Note badges.md
+++ b/docs/User Guide/User Guide/Basic Concepts and Features/Notes/Note badges.md
@@ -5,7 +5,7 @@ Note badges appear near the fixed note title and indicate important information
The following badges are available:
-* <span class="tn-icon bx bx-lock-alt"></span> **Read-only badge**, which will be shown if the note is not editable due to either automatic read-only or manual read-only. Clicking on the badge will temporarily edit the note.
+* <span class="tn-icon bx bx-lock-alt"></span> **Read-only badge**, which will be shown if the note is not editable due to either automatic read-only or manual read-only. Clicking on the badge will temporarily edit the note. On the pages of the built-in user guide, which cannot be edited, the badge does nothing when clicked.
* <span class="tn-icon bx bx-share-alt"></span> **Share badge**, which will indicate that the current note is shared. The badge will also indicate if the share is on the local network (for the desktop application without <a class="reference-link" href="../../Installation%20%26%20Setup/Synchronization.md">Synchronization</a> set up) or publicly accessible (for the server).
* <span class="tn-icon bx bx-globe"></span> **Web clip badge**, which will indicate if the note was clipped using the <a class="reference-link" href="../../Installation%20%26%20Setup/Web%20Clipper.md">Web Clipper</a>. The badge acts as a link, so it can be clicked on to navigate to the page or right clicked for more options. When the clipper also saved the page's description, its author, or the dates it was published and last updated, clicking the badge shows these details instead, with a link to the page at the top.
* <span class="tn-icon bx bx-play"></span> **Execute badge**, for [scripts](../../Scripting.md) or [saved SQL queries](../../Advanced%20Usage/Database/Manually%20altering%20the%20database/SQL%20Console.md) which have an execute button or a description.
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 69f7c7c814..263bedd28c 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
@@ -33,4 +33,6 @@ Apart from using the <a class="reference-link" href="../UI%20Elements/Note%20me
When accessing a read-only note, it's possible to temporarily edit it pressing the _Read-only_ badge.
-When pressed, the note will become editable but will become read-only again after navigating to a different note.
\ No newline at end of file
+When pressed, the note will become editable but will become read-only again after navigating to a different note.
+
+The pages of the built-in user guide are an exception: they are part of Trilium itself and cannot be edited, not even temporarily. Their _Read-only_ badge cannot be pressed, the note menu does not offer to edit them, and their attributes are shown in the right sidebar without a way to change them.
\ No newline at end of file
diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/Themes.md b/docs/User Guide/User Guide/Basic Concepts and Features/Themes.md
index 9620b3b34c..369d66a1cc 100644
--- a/docs/User Guide/User Guide/Basic Concepts and Features/Themes.md
+++ b/docs/User Guide/User Guide/Basic Concepts and Features/Themes.md
@@ -114,7 +114,7 @@ When Trilium's frontend starts, all notes labeled with `appCss` are automaticall
After making changes, press Ctrl + R to reload the frontend and apply your new styles.
-![](Themes_image.png)
+![](Themes_image.jpg)
### Styling Specific Notes in the Tree
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Themes_image.png b/docs/User Guide/User Guide/Basic Concepts and Features/Themes_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Themes_image.png
rename to docs/User Guide/User Guide/Basic Concepts and Features/Themes_image.jpg
diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/Themes_image.png b/docs/User Guide/User Guide/Basic Concepts and Features/Themes_image.png
deleted file mode 100644
index 49df907308..0000000000
Binary files a/docs/User Guide/User Guide/Basic Concepts and Features/Themes_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/1_Vertical and horizontal layout_image.png b/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/1_Vertical and horizontal layout_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/1_Vertical and horizontal layout_image.png
rename to docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/1_Vertical and horizontal layout_image.jpg
diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/1_Vertical and horizontal layout_image.png b/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/1_Vertical and horizontal layout_image.png
deleted file mode 100644
index 2f200ca850..0000000000
Binary files a/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/1_Vertical and horizontal layout_image.png and /dev/null differ
diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Global menu.md b/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Global menu.md
index ead4bba18e..899ce7477f 100644
--- a/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Global menu.md
+++ b/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Global menu.md
@@ -1,7 +1,7 @@
# Global menu
The global menu configures the current window (zoom, keeping the window on top) and offers access to some more advanced options.
-![](Global%20menu_image.png)
+![](Global%20menu_image.jpg)
## Accessing the global menu
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Global menu_image.png b/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Global menu_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Global menu_image.png
rename to docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Global menu_image.jpg
diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Global menu_image.png b/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Global menu_image.png
deleted file mode 100644
index 957a04b164..0000000000
Binary files a/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Global menu_image.png and /dev/null differ
diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Launch Bar.md b/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Launch Bar.md
index d9af1ac6a7..710ad88178 100644
--- a/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Launch Bar.md
+++ b/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Launch Bar.md
@@ -22,7 +22,7 @@ There are two ways to configure the launch bar:
This will open a new tab with the <a class="reference-link" href="Note%20Tree.md">Note Tree</a> listing the launchers.
-![](Launch%20Bar_image.png)
+![](Launch%20Bar_image.jpg)
Expanding _Available Launchers_ section will show the list of launchers that are not displayed on the launch bar. The _Visible Launchers_ will show the ones that are currently displayed.
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Launch Bar_image.png b/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Launch Bar_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Launch Bar_image.png
rename to docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Launch Bar_image.jpg
diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Launch Bar_image.png b/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Launch Bar_image.png
deleted file mode 100644
index 6e8c374800..0000000000
Binary files a/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Launch Bar_image.png and /dev/null differ
diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree.md b/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree.md
index 7ef2d64c8a..3de153cde1 100644
--- a/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree.md
+++ b/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree.md
@@ -1,7 +1,7 @@
# Note Tree
This page explains how to manipulate the note tree in TriliumNext, focusing on moving notes.
-![](Note%20Tree_image.png)
+![](Note%20Tree_image.jpg)
## Drag and Drop
diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/1_Multiple selection_image.png b/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/1_Multiple selection_image.png
index ad3c045078..9ec0a2fdf3 100644
Binary files a/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/1_Multiple selection_image.png and b/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/1_Multiple selection_image.png differ
diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/2_Multiple selection_image.png b/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/2_Multiple selection_image.png
deleted file mode 100644
index 9ec0a2fdf3..0000000000
Binary files a/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/2_Multiple selection_image.png and /dev/null differ
diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Multiple selection.md b/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Multiple selection.md
index fd0b852440..10550d3f37 100644
--- a/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Multiple selection.md
+++ b/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Multiple selection.md
@@ -13,7 +13,7 @@ The selected notes will be indicated via a different background color and an ico
### Selecting notes in a sequence
-<figure class="image image-style-align-right image_resized" style="width:29.24%;"><img style="aspect-ratio:233/205;" src="1_Multiple selection_image.png" width="233" height="205"></figure>
+<figure class="image image-style-align-right image_resized" style="width:29.24%;"><img style="aspect-ratio:233/205;" src="Multiple selection_image.jpg" width="233" height="205"></figure>
When notes are in a sequence (e.g. one underneath the other), the entire selection can be made just by selecting the first and the last item instead of individually clicking all the notes.
@@ -28,4 +28,4 @@ There is a distinction between _selected notes_ and the _active note_:
* Visually, it's identified in the tree by having a different background color and a subtle shadow.
* The active note can also be selected case in which the icon and background will also change:
- <img class="image_resized" style="aspect-ratio:317/223;width:35.1%;" src="2_Multiple selection_image.png" width="317" height="223">
\ No newline at end of file
+ <img class="image_resized" style="aspect-ratio:317/223;width:35.1%;" src="1_Multiple selection_image.png" width="317" height="223">
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/1_Multiple selection_image.png b/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Multiple selection_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/1_Multiple selection_image.png
rename to docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Multiple selection_image.jpg
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree_image.png b/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree_image.png
rename to docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree_image.jpg
diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree_image.png b/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree_image.png
deleted file mode 100644
index 74a2060c72..0000000000
Binary files a/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree_image.png and /dev/null differ
diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note menu.md b/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note menu.md
index 6654f8da1b..28568f1f3e 100644
--- a/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note menu.md
+++ b/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note menu.md
@@ -98,7 +98,7 @@ Notes deleted without erasing can be brought back, see <a class="reference-link
## Limitations
* The note menu is not available on launchers.
-* On the notes of <a class="reference-link" href="Options.md">Options</a> and of the in-app help, most entries are grayed out, since these notes cannot be imported into, exported, deleted or have revisions.
+* On the notes of <a class="reference-link" href="Options.md">Options</a> and of the in-app help, most entries are grayed out, since these notes cannot be imported into, deleted or have revisions. Of the two, only the in-app help can be exported, see <a class="reference-link" href="../Import%20%26%20Export.md">Import &amp; Export</a>.
* The [Note properties](#note-properties) section is only listed when the note itself is displayed, not its <a class="reference-link" href="../Notes/Attachments.md">Attachments</a> or its <a class="reference-link" href="../../Advanced%20Usage/Note%20source.md">Note source</a>.
* In <a class="reference-link" href="../Navigation/Quick%20edit.md">Quick edit</a>, _Search in note_, _Note map_, _Full width_ and _Convert into attachment_ are not listed.
diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Vertical and horizontal layout.md b/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Vertical and horizontal layout.md
index 6dca758201..5d3b1d9866 100644
--- a/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Vertical and horizontal layout.md
+++ b/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Vertical and horizontal layout.md
@@ -11,7 +11,7 @@ The vertical layout is Trilium's original layout:
* The <a class="reference-link" href="Note%20Tree.md">Note Tree</a> can be collapsed by pressing the <span class="tn-icon bx bx-chevrons-left"></span> button at the bottom of the <a class="reference-link" href="Launch%20Bar.md">Launch Bar</a>.
* The <a class="reference-link" href="Global%20menu.md">Global menu</a> can be accessed via the <span class="tn-icon cke cke-trilium"></span> icon at the top of the <a class="reference-link" href="Launch%20Bar.md">Launch Bar</a>.
-![](1_Vertical%20and%20horizontal%20layout_image.png)
+![](1_Vertical%20and%20horizontal%20layout_image.jpg)
### Horizontal layout
@@ -23,7 +23,7 @@ The horizontal layout is a more traditional layout, since it bears similarity wi
* The <a class="reference-link" href="Note%20Tree.md">Note Tree</a> can be collapsed by pressing the small <span class="tn-icon bx bx-sidebar"></span> button to the left of the first tab.
* The <a class="reference-link" href="Global%20menu.md">Global menu</a> can be accessed via the <span class="tn-icon bx bx-menu"></span> button at the end of the <a class="reference-link" href="Launch%20Bar.md">Launch Bar</a>.
-![](Vertical%20and%20horizontal%20layout_image.png)
+![](Vertical%20and%20horizontal%20layout_image.jpg)
## Changing the layout
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Vertical and horizontal layout_image.png b/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Vertical and horizontal layout_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Vertical and horizontal layout_image.png
rename to docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Vertical and horizontal layout_image.jpg
diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Vertical and horizontal layout_image.png b/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Vertical and horizontal layout_image.png
deleted file mode 100644
index 17a6d28854..0000000000
Binary files a/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Vertical and horizontal layout_image.png and /dev/null differ
diff --git a/docs/User Guide/User Guide/Installation & Setup/Data directory.md b/docs/User Guide/User Guide/Installation & Setup/Data directory.md
index 246acc7c7e..ae01e16cb4 100644
--- a/docs/User Guide/User Guide/Installation & Setup/Data directory.md
+++ b/docs/User Guide/User Guide/Installation & Setup/Data directory.md
@@ -10,7 +10,7 @@ Data directory contains:
Easy way how to find out which data directory Trilium uses is to look at the "About Trilium Notes" dialog (from "Menu" in upper left corner):
-![](Data%20directory_image.png)
+![](Data%20directory_image.jpg)
Here's how the location is decided:
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Data directory_image.png b/docs/User Guide/User Guide/Installation & Setup/Data directory_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Data directory_image.png
rename to docs/User Guide/User Guide/Installation & Setup/Data directory_image.jpg
diff --git a/docs/User Guide/User Guide/Installation & Setup/Data directory_image.png b/docs/User Guide/User Guide/Installation & Setup/Data directory_image.png
deleted file mode 100644
index 823c6ceac6..0000000000
Binary files a/docs/User Guide/User Guide/Installation & Setup/Data directory_image.png and /dev/null differ
diff --git a/docs/User Guide/User Guide/Installation & Setup/Synchronization.md b/docs/User Guide/User Guide/Installation & Setup/Synchronization.md
index 088d088f5d..ea085e602a 100644
--- a/docs/User Guide/User Guide/Installation & Setup/Synchronization.md
+++ b/docs/User Guide/User Guide/Installation & Setup/Synchronization.md
@@ -1,7 +1,7 @@
# Synchronization
Trilium is an offline-first note-taking application that stores all data locally on the desktop client. However, it also offers the option to set up synchronization with a server instance, allowing multiple desktop clients to sync with a central server. This creates a star-shaped topology:
-![](Synchronization_image.png)
+![](Synchronization_image.jpg)
In this setup, a central server (referred to as the _sync server_) and multiple _client_ (or _desktop_) instances synchronize with the sync server. Once configured, synchronization is automatic and ongoing, requiring no manual intervention.
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Synchronization_image.png b/docs/User Guide/User Guide/Installation & Setup/Synchronization_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Installation & Setup/Synchronization_image.png
rename to docs/User Guide/User Guide/Installation & Setup/Synchronization_image.jpg
diff --git a/docs/User Guide/User Guide/Installation & Setup/Synchronization_image.png b/docs/User Guide/User Guide/Installation & Setup/Synchronization_image.png
deleted file mode 100644
index 344262a9a6..0000000000
Binary files a/docs/User Guide/User Guide/Installation & Setup/Synchronization_image.png and /dev/null differ
diff --git a/docs/User Guide/User Guide/Note Types/Code.md b/docs/User Guide/User Guide/Note Types/Code.md
index 82c9e6cde4..951ca1221f 100644
--- a/docs/User Guide/User Guide/Note Types/Code.md
+++ b/docs/User Guide/User Guide/Note Types/Code.md
@@ -10,7 +10,7 @@ This can be useful for a few things:
For shorter snippets of code that can be embedded in [Text](Text.md) notes, see [Code blocks](Text/Developer-specific%20formatting/Code%20blocks.md).
-![](Code_image.png)
+![](Code_image.jpg)
## Creating a code note
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Code_image.png b/docs/User Guide/User Guide/Note Types/Code_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Code_image.png
rename to docs/User Guide/User Guide/Note Types/Code_image.jpg
diff --git a/docs/User Guide/User Guide/Note Types/Code_image.png b/docs/User Guide/User Guide/Note Types/Code_image.png
deleted file mode 100644
index f3ebaf6734..0000000000
Binary files a/docs/User Guide/User Guide/Note Types/Code_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/1_Developer-specific formatting_image.png b/docs/User Guide/User Guide/Note Types/Text/1_Developer-specific formatting_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/1_Developer-specific formatting_image.png
rename to docs/User Guide/User Guide/Note Types/Text/1_Developer-specific formatting_image.jpg
diff --git a/docs/User Guide/User Guide/Note Types/Text/1_Developer-specific formatting_image.png b/docs/User Guide/User Guide/Note Types/Text/1_Developer-specific formatting_image.png
deleted file mode 100644
index ef28ed50d4..0000000000
Binary files a/docs/User Guide/User Guide/Note Types/Text/1_Developer-specific formatting_image.png and /dev/null differ
diff --git a/docs/User Guide/User Guide/Note Types/Text/1_Formatting toolbar_image.png b/docs/User Guide/User Guide/Note Types/Text/1_Formatting toolbar_image.png
index bc6bd96c47..785ce7fc54 100644
Binary files a/docs/User Guide/User Guide/Note Types/Text/1_Formatting toolbar_image.png and b/docs/User Guide/User Guide/Note Types/Text/1_Formatting toolbar_image.png differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/1_Images_image.png b/docs/User Guide/User Guide/Note Types/Text/1_Images_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/1_Images_image.png
rename to docs/User Guide/User Guide/Note Types/Text/1_Images_image.jpg
diff --git a/docs/User Guide/User Guide/Note Types/Text/1_Images_image.png b/docs/User Guide/User Guide/Note Types/Text/1_Images_image.png
deleted file mode 100644
index 08a40b0d05..0000000000
Binary files a/docs/User Guide/User Guide/Note Types/Text/1_Images_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/1_Lists_image.png b/docs/User Guide/User Guide/Note Types/Text/1_Lists_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/1_Lists_image.png
rename to docs/User Guide/User Guide/Note Types/Text/1_Lists_image.jpg
diff --git a/docs/User Guide/User Guide/Note Types/Text/1_Lists_image.png b/docs/User Guide/User Guide/Note Types/Text/1_Lists_image.png
deleted file mode 100644
index ed6f4c37ca..0000000000
Binary files a/docs/User Guide/User Guide/Note Types/Text/1_Lists_image.png and /dev/null differ
diff --git a/docs/User Guide/User Guide/Note Types/Text/2_Developer-specific formatting_image.png b/docs/User Guide/User Guide/Note Types/Text/2_Developer-specific formatting_image.png
deleted file mode 100644
index c0cf731a5f..0000000000
Binary files a/docs/User Guide/User Guide/Note Types/Text/2_Developer-specific formatting_image.png and /dev/null differ
diff --git a/docs/User Guide/User Guide/Note Types/Text/2_Formatting toolbar_image.png b/docs/User Guide/User Guide/Note Types/Text/2_Formatting toolbar_image.png
index 785ce7fc54..44b3746526 100644
Binary files a/docs/User Guide/User Guide/Note Types/Text/2_Formatting toolbar_image.png and b/docs/User Guide/User Guide/Note Types/Text/2_Formatting toolbar_image.png differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/2_Images_image.png b/docs/User Guide/User Guide/Note Types/Text/2_Images_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/2_Images_image.png
rename to docs/User Guide/User Guide/Note Types/Text/2_Images_image.jpg
diff --git a/docs/User Guide/User Guide/Note Types/Text/2_Images_image.png b/docs/User Guide/User Guide/Note Types/Text/2_Images_image.png
deleted file mode 100644
index 297d49ee5b..0000000000
Binary files a/docs/User Guide/User Guide/Note Types/Text/2_Images_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/2_Lists_image.png b/docs/User Guide/User Guide/Note Types/Text/2_Lists_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/2_Lists_image.png
rename to docs/User Guide/User Guide/Note Types/Text/2_Lists_image.jpg
diff --git a/docs/User Guide/User Guide/Note Types/Text/2_Lists_image.png b/docs/User Guide/User Guide/Note Types/Text/2_Lists_image.png
deleted file mode 100644
index 0ab30524bc..0000000000
Binary files a/docs/User Guide/User Guide/Note Types/Text/2_Lists_image.png and /dev/null differ
diff --git a/docs/User Guide/User Guide/Note Types/Text/3_Formatting toolbar_image.png b/docs/User Guide/User Guide/Note Types/Text/3_Formatting toolbar_image.png
deleted file mode 100644
index 44b3746526..0000000000
Binary files a/docs/User Guide/User Guide/Note Types/Text/3_Formatting toolbar_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/3_Images_image.png b/docs/User Guide/User Guide/Note Types/Text/3_Images_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/3_Images_image.png
rename to docs/User Guide/User Guide/Note Types/Text/3_Images_image.jpg
diff --git a/docs/User Guide/User Guide/Note Types/Text/3_Images_image.png b/docs/User Guide/User Guide/Note Types/Text/3_Images_image.png
deleted file mode 100644
index 731df83bb9..0000000000
Binary files a/docs/User Guide/User Guide/Note Types/Text/3_Images_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/3_Lists_image.png b/docs/User Guide/User Guide/Note Types/Text/3_Lists_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/3_Lists_image.png
rename to docs/User Guide/User Guide/Note Types/Text/3_Lists_image.jpg
diff --git a/docs/User Guide/User Guide/Note Types/Text/3_Lists_image.png b/docs/User Guide/User Guide/Note Types/Text/3_Lists_image.png
deleted file mode 100644
index 30a9511b08..0000000000
Binary files a/docs/User Guide/User Guide/Note Types/Text/3_Lists_image.png and /dev/null differ
diff --git a/docs/User Guide/User Guide/Note Types/Text/4_Images_image.png b/docs/User Guide/User Guide/Note Types/Text/4_Images_image.png
deleted file mode 100644
index 8fa28fbf98..0000000000
Binary files a/docs/User Guide/User Guide/Note Types/Text/4_Images_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/4_Lists_image.png b/docs/User Guide/User Guide/Note Types/Text/4_Lists_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/4_Lists_image.png
rename to docs/User Guide/User Guide/Note Types/Text/4_Lists_image.jpg
diff --git a/docs/User Guide/User Guide/Note Types/Text/4_Lists_image.png b/docs/User Guide/User Guide/Note Types/Text/4_Lists_image.png
deleted file mode 100644
index 8369a03c61..0000000000
Binary files a/docs/User Guide/User Guide/Note Types/Text/4_Lists_image.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/5_Lists_image.png b/docs/User Guide/User Guide/Note Types/Text/5_Lists_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/5_Lists_image.png
rename to docs/User Guide/User Guide/Note Types/Text/5_Lists_image.jpg
diff --git a/docs/User Guide/User Guide/Note Types/Text/5_Lists_image.png b/docs/User Guide/User Guide/Note Types/Text/5_Lists_image.png
deleted file mode 100644
index fba0cc85c9..0000000000
Binary files a/docs/User Guide/User Guide/Note Types/Text/5_Lists_image.png and /dev/null differ
diff --git a/docs/User Guide/User Guide/Note Types/Text/Content language & Right-to-left support.md b/docs/User Guide/User Guide/Note Types/Text/Content language & Right-to-left support.md
index 4c181413e2..792e53bfa9 100644
--- a/docs/User Guide/User Guide/Note Types/Text/Content language & Right-to-left support.md
+++ b/docs/User Guide/User Guide/Note Types/Text/Content language & Right-to-left support.md
@@ -1,5 +1,5 @@
# Content language & Right-to-left support
-![](Content%20language%20&%20Right-to-left%20support_image.png)
+![](Content%20language%20&%20Right-to-left%20support_image.jpg)
The content language determines:
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Content language & Right-to-left support_image.png b/docs/User Guide/User Guide/Note Types/Text/Content language & Right-to-left support_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Content language & Right-to-left support_image.png
rename to docs/User Guide/User Guide/Note Types/Text/Content language & Right-to-left support_image.jpg
diff --git a/docs/User Guide/User Guide/Note Types/Text/Content language & Right-to-left support_image.png b/docs/User Guide/User Guide/Note Types/Text/Content language & Right-to-left support_image.png
deleted file mode 100644
index dee799386c..0000000000
Binary files a/docs/User Guide/User Guide/Note Types/Text/Content language & Right-to-left support_image.png and /dev/null differ
diff --git a/docs/User Guide/User Guide/Note Types/Text/Developer-specific formatting.md b/docs/User Guide/User Guide/Note Types/Text/Developer-specific formatting.md
index 7f8671416b..e3865be307 100644
--- a/docs/User Guide/User Guide/Note Types/Text/Developer-specific formatting.md
+++ b/docs/User Guide/User Guide/Note Types/Text/Developer-specific formatting.md
@@ -3,7 +3,7 @@
Inline code formats text using a monospace font to indicate technical content in a sentence such as code, paths, etc.
-![](2_Developer-specific%20formatting_image.png)
+![](Developer-specific%20formatting_image.png)
Example of inline code being used to illustrate file system paths as well as shell commands (`git` in this case).
@@ -17,7 +17,7 @@ To insert an inline code:
Code blocks display a snippet of code as a dedicated block:
-![](1_Developer-specific%20formatting_image.png)
+![](1_Developer-specific%20formatting_image.jpg)
A code block with JavaScript syntax highlight enabled.
@@ -29,7 +29,7 @@ See the dedicated documentation for more information: [Code blocks](Developer-s
This allows marking a portion of text as a shortcut key.
-![](Developer-specific%20formatting_image.png)
+![](Developer-specific%20formatting_image.jpg)
To apply this style, press the <span class="tn-icon cke cke-trilium-kbd"></span> button in <span class="tn-icon bx bx-text"></span> group from the [Formatting toolbar](Formatting%20toolbar.md). On the floating toolbar, the buttons appear when selecting a text.
diff --git a/docs/User Guide/User Guide/Note Types/Text/Developer-specific formatting/1_Code blocks_image.png b/docs/User Guide/User Guide/Note Types/Text/Developer-specific formatting/1_Code blocks_image.png
deleted file mode 100644
index 6cd7f4b4e3..0000000000
Binary files a/docs/User Guide/User Guide/Note Types/Text/Developer-specific formatting/1_Code blocks_image.png and /dev/null differ
diff --git a/docs/User Guide/User Guide/Note Types/Text/Developer-specific formatting/Code blocks.md b/docs/User Guide/User Guide/Note Types/Text/Developer-specific formatting/Code blocks.md
index baf8d45d9d..03b55774b6 100644
--- a/docs/User Guide/User Guide/Note Types/Text/Developer-specific formatting/Code blocks.md
+++ b/docs/User Guide/User Guide/Note Types/Text/Developer-specific formatting/Code blocks.md
@@ -1,5 +1,5 @@
# Code blocks
-![](Code%20blocks_image.png)
+![](Code%20blocks_image.jpg)
The code blocks feature allows entering pieces of code in text notes.
@@ -60,7 +60,7 @@ Should you encounter any issues after the migration, try running Trilium in safe
## Changing the language of a code block
Simply click anywhere inside the code block and press again the code block button in the <a class="reference-link" href="../Formatting%20toolbar.md">Formatting toolbar</a>:
-![](1_Code%20blocks_image.png)
+![](Code%20blocks_image.png)
## Adjusting the list of languages
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Developer-specific formatting/Code blocks_image.png b/docs/User Guide/User Guide/Note Types/Text/Developer-specific formatting/Code blocks_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Developer-specific formatting/Code blocks_image.png
rename to docs/User Guide/User Guide/Note Types/Text/Developer-specific formatting/Code blocks_image.jpg
diff --git a/docs/User Guide/User Guide/Note Types/Text/Developer-specific formatting/Code blocks_image.png b/docs/User Guide/User Guide/Note Types/Text/Developer-specific formatting/Code blocks_image.png
index ef28ed50d4..6cd7f4b4e3 100644
Binary files a/docs/User Guide/User Guide/Note Types/Text/Developer-specific formatting/Code blocks_image.png and b/docs/User Guide/User Guide/Note Types/Text/Developer-specific formatting/Code blocks_image.png differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Developer-specific formatting_image.png b/docs/User Guide/User Guide/Note Types/Text/Developer-specific formatting_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Developer-specific formatting_image.png
rename to docs/User Guide/User Guide/Note Types/Text/Developer-specific formatting_image.jpg
diff --git a/docs/User Guide/User Guide/Note Types/Text/Developer-specific formatting_image.png b/docs/User Guide/User Guide/Note Types/Text/Developer-specific formatting_image.png
index 6ae0fd87ae..c0cf731a5f 100644
Binary files a/docs/User Guide/User Guide/Note Types/Text/Developer-specific formatting_image.png and b/docs/User Guide/User Guide/Note Types/Text/Developer-specific formatting_image.png differ
diff --git a/docs/User Guide/User Guide/Note Types/Text/Formatting toolbar.md b/docs/User Guide/User Guide/Note Types/Text/Formatting toolbar.md
index cd2e4a7b8e..0f05cb15e3 100644
--- a/docs/User Guide/User Guide/Note Types/Text/Formatting toolbar.md
+++ b/docs/User Guide/User Guide/Note Types/Text/Formatting toolbar.md
@@ -10,19 +10,19 @@ The floating bar is a more minimalist option, in which the formatting is hidden
### Block-level popup
The first popup is the block-level popup. This will appear to the left of the current paragraph you are currently editing, as a sequence of dots:
-![](1_Formatting%20toolbar_image.png)
+![](Formatting%20toolbar_image.jpg)
Clicking this popup will reveal the formatting options that are specific to the entire paragraph, such as setting a heading, lists, tables, etc.
The dots are also a drag handle: drag them to move the paragraph, all the selected paragraphs, or a selected element such as an image, a table or an included note to another place in the note. Right-clicking them copies a reference to the paragraph or to the selected paragraphs, see <a class="reference-link" href="Block%20references.md">Block references</a>.
-<figure class="image"><img style="aspect-ratio:1404/156;" src="3_Formatting toolbar_image.png" width="1404" height="156"></figure>
+<figure class="image"><img style="aspect-ratio:1404/156;" src="2_Formatting toolbar_image.png" width="1404" height="156"></figure>
### Inline popup
The inline popup appears automatically when selecting a text:
-<figure class="image"><img style="aspect-ratio:1008/154;" src="2_Formatting toolbar_image.png" width="1008" height="154"></figure>
+<figure class="image"><img style="aspect-ratio:1008/154;" src="1_Formatting toolbar_image.png" width="1008" height="154"></figure>
All the options here apply only to the selected portion of text, such as changing the font size, or making the text bold.
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/1_Formatting toolbar_image.png b/docs/User Guide/User Guide/Note Types/Text/Formatting toolbar_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/1_Formatting toolbar_image.png
rename to docs/User Guide/User Guide/Note Types/Text/Formatting toolbar_image.jpg
diff --git a/docs/User Guide/User Guide/Note Types/Text/Images.md b/docs/User Guide/User Guide/Note Types/Text/Images.md
index db3088444b..81cadf3782 100644
--- a/docs/User Guide/User Guide/Note Types/Text/Images.md
+++ b/docs/User Guide/User Guide/Note Types/Text/Images.md
@@ -28,7 +28,7 @@ The automatic download of images is enabled by default and can be toggled from 
## Configuring the images
Clicking on an image will reveal a popup with multiple options:
-![](4_Images_image.png)
+![](Images_image.png)
### Alignment
@@ -36,10 +36,10 @@ The first set of options configure the alignment are, in order:
| Icon | Option | Preview | Description |
| --- | --- | --- | --- |
-| <span class="tn-icon cke cke-object-inline"></span> | Inline | ![](Images_image.png) | As the name suggests, the name can be put inside a paragraph and moved around similarly as if it was a block of text. Use drag & drop or cut-paste to move it around. |
-| <span class="tn-icon cke cke-object-center"></span> | Centered image | ![](1_Images_image.png) | The image will be displayed as a block and centered, not allowing text in either the left or right of it. |
-| <span class="tn-icon cke cke-object-inline-right"></span> | Wrap text | ![](3_Images_image.png) | The image will be displayed to the left or the right of the text. |
-| <span class="tn-icon cke cke-object-left"></span> | Block align | ![](2_Images_image.png) | Similarly to _Centered image_, the image will be displayed as a block and aligned either to the left or to the right, but not allowing text to flow on either of its sides. |
+| <span class="tn-icon cke cke-object-inline"></span> | Inline | ![](Images_image.jpg) | As the name suggests, the name can be put inside a paragraph and moved around similarly as if it was a block of text. Use drag & drop or cut-paste to move it around. |
+| <span class="tn-icon cke cke-object-center"></span> | Centered image | ![](1_Images_image.jpg) | The image will be displayed as a block and centered, not allowing text in either the left or right of it. |
+| <span class="tn-icon cke cke-object-inline-right"></span> | Wrap text | ![](3_Images_image.jpg) | The image will be displayed to the left or the right of the text. |
+| <span class="tn-icon cke cke-object-left"></span> | Block align | ![](2_Images_image.jpg) | Similarly to _Centered image_, the image will be displayed as a block and aligned either to the left or to the right, but not allowing text to flow on either of its sides. |
### Drawing over an image
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Images_image.png b/docs/User Guide/User Guide/Note Types/Text/Images_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Images_image.png
rename to docs/User Guide/User Guide/Note Types/Text/Images_image.jpg
diff --git a/docs/User Guide/User Guide/Note Types/Text/Images_image.png b/docs/User Guide/User Guide/Note Types/Text/Images_image.png
index a4e23ef9a8..8fa28fbf98 100644
Binary files a/docs/User Guide/User Guide/Note Types/Text/Images_image.png and b/docs/User Guide/User Guide/Note Types/Text/Images_image.png differ
diff --git a/docs/User Guide/User Guide/Note Types/Text/Lists.md b/docs/User Guide/User Guide/Note Types/Text/Lists.md
index 01cd68adac..b56bdfc084 100644
--- a/docs/User Guide/User Guide/Note Types/Text/Lists.md
+++ b/docs/User Guide/User Guide/Note Types/Text/Lists.md
@@ -27,32 +27,32 @@ It possible to add content-level blocks such as headings, code blocks, tables wi
<tbody>
<tr>
<td>1</td>
- <td><img src="2_Lists_image.png"></td>
+ <td><img src="2_Lists_image.jpg"></td>
<td>First, create a list.</td>
</tr>
<tr>
<td>2</td>
- <td><img src="4_Lists_image.png"></td>
+ <td><img src="4_Lists_image.jpg"></td>
<td>Press Enter to create a new list item.</td>
</tr>
<tr>
<td>3</td>
- <td><img src="1_Lists_image.png"></td>
+ <td><img src="1_Lists_image.jpg"></td>
<td>Press Backspace to get rid of the bullet point. Notice the cursor position.</td>
</tr>
<tr>
<td>4</td>
- <td><img class="image_resized" style="aspect-ratio:676/112;width:98.29%;" src="5_Lists_image.png" width="676" height="112"></td>
+ <td><img class="image_resized" style="aspect-ratio:676/112;width:98.29%;" src="5_Lists_image.jpg" width="676" height="112"></td>
<td>At this point, insert any desired block-level item such as a code block.</td>
</tr>
<tr>
<td>5</td>
- <td><img class="image_resized" style="aspect-ratio:675/129;width:94.22%;" src="3_Lists_image.png" width="675" height="129"></td>
+ <td><img class="image_resized" style="aspect-ratio:675/129;width:94.22%;" src="3_Lists_image.jpg" width="675" height="129"></td>
<td>To continue with a new bullet point, press Enter until the cursor moves to a new blank position.</td>
</tr>
<tr>
<td>6</td>
- <td><img class="image_resized" style="aspect-ratio:675/129;width:100%;" src="Lists_image.png" width="675" height="129"></td>
+ <td><img class="image_resized" style="aspect-ratio:675/129;width:100%;" src="Lists_image.jpg" width="675" height="129"></td>
<td>Press Enter once more to create the new bullet.</td>
</tr>
</tbody>
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Lists_image.png b/docs/User Guide/User Guide/Note Types/Text/Lists_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Lists_image.png
rename to docs/User Guide/User Guide/Note Types/Text/Lists_image.jpg
diff --git a/docs/User Guide/User Guide/Note Types/Text/Lists_image.png b/docs/User Guide/User Guide/Note Types/Text/Lists_image.png
deleted file mode 100644
index 32992762ae..0000000000
Binary files a/docs/User Guide/User Guide/Note Types/Text/Lists_image.png and /dev/null differ
diff --git a/docs/User Guide/User Guide/Theme development/Creating a custom theme.md b/docs/User Guide/User Guide/Theme development/Creating a custom theme.md
index b3005c7046..2674afb51d 100644
--- a/docs/User Guide/User Guide/Theme development/Creating a custom theme.md
+++ b/docs/User Guide/User Guide/Theme development/Creating a custom theme.md
@@ -5,22 +5,22 @@ Organization is an important aspect of managing a knowledge base. When developin
As such, the first step is to create a new note to gather all the themes.
-![](Creating%20a%20custom%20theme_5_Creating%20a%20custom%20theme_im.png)
+![](Creating%20a%20custom%20theme_5_Creating%20a%20custom%20theme_im.jpg)
## Step 2. Create the theme
<table>
<tbody>
<tr>
- <td><img src="Creating a custom theme_3_Creating a custom theme_im.png"></td>
+ <td><img src="Creating a custom theme_3_Creating a custom theme_im.jpg"></td>
<td>Themes are code notes with a special attribute. Start by creating a new code note.</td>
</tr>
<tr>
- <td><img src="Creating a custom theme_1_Creating a custom theme_im.png"></td>
+ <td><img src="Creating a custom theme_1_Creating a custom theme_im.jpg"></td>
<td>Then change the note type to a CSS code.</td>
</tr>
<tr>
- <td><img src="Creating a custom theme_Creating a custom theme_im.png"></td>
+ <td><img src="Creating a custom theme_Creating a custom theme_im.jpg"></td>
<td>In the attributes of the note (the&nbsp;<span class="tn-icon bx bx-list-check"></span> button in the&nbsp;<a class="reference-link" href="../Basic%20Concepts%20and%20Features/UI%20Elements/Status%20bar.md">Status bar</a>), define the <code>#appTheme</code> attribute to point to any desired name. This is the name that will show up in the appearance section in settings.</td>
</tr>
</tbody>
@@ -42,11 +42,11 @@ To alter the different variables of the theme:
Refresh the application (Ctrl+Shift+R is a good way to do so) and go to settings. You should see the newly created theme:
-![](Creating%20a%20custom%20theme_2_Creating%20a%20custom%20theme_im.png)
+![](Creating%20a%20custom%20theme_2_Creating%20a%20custom%20theme_im.jpg)
Afterwards the application will refresh itself with the new theme:
-![](Creating%20a%20custom%20theme_4_Creating%20a%20custom%20theme_im.png)
+![](Creating%20a%20custom%20theme_4_Creating%20a%20custom%20theme_im.jpg)
Do note that the theme will be based off of the legacy theme. To override that and base the theme on the Modern theme, see <a class="reference-link" href="Customize%20the%20Next%20theme.md">Customize the Next theme</a>.
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Creating a custom theme_1_Creating a custom theme_im.png b/docs/User Guide/User Guide/Theme development/Creating a custom theme_1_Creating a custom theme_im.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Creating a custom theme_1_Creating a custom theme_im.png
rename to docs/User Guide/User Guide/Theme development/Creating a custom theme_1_Creating a custom theme_im.jpg
diff --git a/docs/User Guide/User Guide/Theme development/Creating a custom theme_1_Creating a custom theme_im.png b/docs/User Guide/User Guide/Theme development/Creating a custom theme_1_Creating a custom theme_im.png
deleted file mode 100644
index 81a9d35c8c..0000000000
Binary files a/docs/User Guide/User Guide/Theme development/Creating a custom theme_1_Creating a custom theme_im.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Creating a custom theme_2_Creating a custom theme_im.png b/docs/User Guide/User Guide/Theme development/Creating a custom theme_2_Creating a custom theme_im.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Creating a custom theme_2_Creating a custom theme_im.png
rename to docs/User Guide/User Guide/Theme development/Creating a custom theme_2_Creating a custom theme_im.jpg
diff --git a/docs/User Guide/User Guide/Theme development/Creating a custom theme_2_Creating a custom theme_im.png b/docs/User Guide/User Guide/Theme development/Creating a custom theme_2_Creating a custom theme_im.png
deleted file mode 100644
index d352621496..0000000000
Binary files a/docs/User Guide/User Guide/Theme development/Creating a custom theme_2_Creating a custom theme_im.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Creating a custom theme_3_Creating a custom theme_im.png b/docs/User Guide/User Guide/Theme development/Creating a custom theme_3_Creating a custom theme_im.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Creating a custom theme_3_Creating a custom theme_im.png
rename to docs/User Guide/User Guide/Theme development/Creating a custom theme_3_Creating a custom theme_im.jpg
diff --git a/docs/User Guide/User Guide/Theme development/Creating a custom theme_3_Creating a custom theme_im.png b/docs/User Guide/User Guide/Theme development/Creating a custom theme_3_Creating a custom theme_im.png
deleted file mode 100644
index 743d51c8fa..0000000000
Binary files a/docs/User Guide/User Guide/Theme development/Creating a custom theme_3_Creating a custom theme_im.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Creating a custom theme_4_Creating a custom theme_im.png b/docs/User Guide/User Guide/Theme development/Creating a custom theme_4_Creating a custom theme_im.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Creating a custom theme_4_Creating a custom theme_im.png
rename to docs/User Guide/User Guide/Theme development/Creating a custom theme_4_Creating a custom theme_im.jpg
diff --git a/docs/User Guide/User Guide/Theme development/Creating a custom theme_4_Creating a custom theme_im.png b/docs/User Guide/User Guide/Theme development/Creating a custom theme_4_Creating a custom theme_im.png
deleted file mode 100644
index 4f9583c7be..0000000000
Binary files a/docs/User Guide/User Guide/Theme development/Creating a custom theme_4_Creating a custom theme_im.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Creating a custom theme_5_Creating a custom theme_im.png b/docs/User Guide/User Guide/Theme development/Creating a custom theme_5_Creating a custom theme_im.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Creating a custom theme_5_Creating a custom theme_im.png
rename to docs/User Guide/User Guide/Theme development/Creating a custom theme_5_Creating a custom theme_im.jpg
diff --git a/docs/User Guide/User Guide/Theme development/Creating a custom theme_5_Creating a custom theme_im.png b/docs/User Guide/User Guide/Theme development/Creating a custom theme_5_Creating a custom theme_im.png
deleted file mode 100644
index f2e63f1ec3..0000000000
Binary files a/docs/User Guide/User Guide/Theme development/Creating a custom theme_5_Creating a custom theme_im.png and /dev/null differ
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Creating a custom theme_Creating a custom theme_im.png b/docs/User Guide/User Guide/Theme development/Creating a custom theme_Creating a custom theme_im.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Creating a custom theme_Creating a custom theme_im.png
rename to docs/User Guide/User Guide/Theme development/Creating a custom theme_Creating a custom theme_im.jpg
diff --git a/docs/User Guide/User Guide/Theme development/Creating a custom theme_Creating a custom theme_im.png b/docs/User Guide/User Guide/Theme development/Creating a custom theme_Creating a custom theme_im.png
deleted file mode 100644
index 94afbf4249..0000000000
Binary files a/docs/User Guide/User Guide/Theme development/Creating a custom theme_Creating a custom theme_im.png and /dev/null differ
diff --git a/docs/User Guide/User Guide/Troubleshooting/Anonymized Database.md b/docs/User Guide/User Guide/Troubleshooting/Anonymized Database.md
index 051a28a83d..94f6abb468 100644
--- a/docs/User Guide/User Guide/Troubleshooting/Anonymized Database.md
+++ b/docs/User Guide/User Guide/Troubleshooting/Anonymized Database.md
@@ -1,5 +1,5 @@
# Anonymized Database
-![](Anonymized%20Database_image.png)
+![](Anonymized%20Database_image.jpg)
In certain scenarios, understanding the structure of a database is crucial for troubleshooting issues. However, sharing your actual [database](../Advanced%20Usage/Database.md) file with personal notes is not advisable. To address this, Trilium offers a feature to anonymize the database. This feature can be accessed via Menu -> Options -> Advanced tab.
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Anonymized Database_image.png b/docs/User Guide/User Guide/Troubleshooting/Anonymized Database_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Anonymized Database_image.png
rename to docs/User Guide/User Guide/Troubleshooting/Anonymized Database_image.jpg
diff --git a/docs/User Guide/User Guide/Troubleshooting/Anonymized Database_image.png b/docs/User Guide/User Guide/Troubleshooting/Anonymized Database_image.png
deleted file mode 100644
index fb640c0c9a..0000000000
Binary files a/docs/User Guide/User Guide/Troubleshooting/Anonymized Database_image.png and /dev/null differ
diff --git a/docs/User Guide/User Guide/Troubleshooting/Error logs/Frontend logs.md b/docs/User Guide/User Guide/Troubleshooting/Error logs/Frontend logs.md
index 60b724a711..acba08dd49 100644
--- a/docs/User Guide/User Guide/Troubleshooting/Error logs/Frontend logs.md
+++ b/docs/User Guide/User Guide/Troubleshooting/Error logs/Frontend logs.md
@@ -10,6 +10,6 @@ If that doesn't work, then:
Once you have Dev Tools open, click on "Console" tab:
-![](Frontend%20logs_image.png)
+![](Frontend%20logs_image.jpg)
Copy-paste (or screenshot) the logs. It's better to provide not just errors, but the whole log, which might provide context while analyzing the bug.
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Error logs/Frontend logs_image.png b/docs/User Guide/User Guide/Troubleshooting/Error logs/Frontend logs_image.jpg
similarity index 100%
rename from apps/server/src/assets/doc_notes/en/User Guide/User Guide/Troubleshooting/Error logs/Frontend logs_image.png
rename to docs/User Guide/User Guide/Troubleshooting/Error logs/Frontend logs_image.jpg
diff --git a/docs/User Guide/User Guide/Troubleshooting/Error logs/Frontend logs_image.png b/docs/User Guide/User Guide/Troubleshooting/Error logs/Frontend logs_image.png
deleted file mode 100644
index 62a034e3fd..0000000000
Binary files a/docs/User Guide/User Guide/Troubleshooting/Error logs/Frontend logs_image.png and /dev/null differ
diff --git a/edit-docs-config.yaml b/edit-docs-config.yaml
index 728523c5ca..57d09c0d56 100644
--- a/edit-docs-config.yaml
+++ b/edit-docs-config.yaml
@@ -4,17 +4,11 @@ noteMappings:
- rootNoteId: "pOsGYCXsbNQG"
path: "docs/User Guide"
format: "markdown"
-
- - rootNoteId: "pOsGYCXsbNQG"
- path: "apps/server/src/assets/doc_notes/en/User Guide"
- format: "html"
- ignoredFiles:
- - "index.html"
- - "navigation.html"
- - "style.css"
- - "User Guide.html"
- exportOnly: true
-
+ # The markdown export is the single source of the in-app help: this derives the note tree
+ # the application injects, and the build renders the page content from the same files.
+ helpMeta: "apps/server/src/assets/help/help_meta.json"
+ helpContent: "apps/server/src/assets/help/help_content.json"
+
- rootNoteId: "jdjRLhLV3TtI"
path: "docs/Developer Guide"
format: "markdown"
diff --git a/packages/commons/src/index.ts b/packages/commons/src/index.ts
index 89c15ba612..83613ed983 100644
--- a/packages/commons/src/index.ts
+++ b/packages/commons/src/index.ts
@@ -3,6 +3,7 @@ export * from "./lib/katex_macros.js";
export * from "./lib/options_interface.js";
export * from "./lib/keyboard_actions_interface.js";
export * from "./lib/hidden_subtree.js";
+export * from "./lib/help_meta.js";
export * from "./lib/rows.js";
export * from "./lib/safe_template.js";
export * from "./lib/test-utils.js";
diff --git a/packages/commons/src/lib/builtin_attributes.ts b/packages/commons/src/lib/builtin_attributes.ts
index c84440d75f..0a8a0bd691 100644
--- a/packages/commons/src/lib/builtin_attributes.ts
+++ b/packages/commons/src/lib/builtin_attributes.ts
@@ -192,6 +192,8 @@ const BUILTIN_ATTRIBUTES = [
{ type: "label", name: "displayRelations", valueType: "text" },
{ type: "label", name: "hideRelations", valueType: "text" },
{ type: "label", name: "titleTemplate", valueType: "text", isDangerous: true },
+ // Set on a template: the default title of a note created from it, as `#titleTemplate` is for children.
+ { type: "label", name: "template:titleTemplate", valueType: "text", isDangerous: true },
{ type: "label", name: "template", valueType: "boolean" },
{ type: "label", name: "snippet", valueType: "boolean" },
{ type: "label", name: "snippetDescription", valueType: "text", hasUserValue: true },
diff --git a/packages/commons/src/lib/help_meta.ts b/packages/commons/src/lib/help_meta.ts
new file mode 100644
index 0000000000..d9fa6e7894
--- /dev/null
+++ b/packages/commons/src/lib/help_meta.ts
@@ -0,0 +1,33 @@
+import type { HiddenSubtreeAttribute } from "./hidden_subtree.js";
+
+/**
+ * One note of the in-app help (User Guide) tree, as prepared by `edit-docs` from the User
+ * Guide's markdown export and consumed by both the server and the standalone build.
+ *
+ * The shape is deliberately that of a virtual subtree item: the help notes are injected into becca
+ * by a virtual note provider and never persisted. Which markdown file backs each note is a build
+ * concern that stays in `edit-docs`, so it is not part of this — the tree carries only what an
+ * application needs to show the pages.
+ */
+export interface HelpMetaItem {
+ /** Note ID, always prefixed with `_help_`. */
+ id: string;
+ title: string;
+ /**
+ * `text` and `code` notes carry content of their own, found in the bundle under this note's
+ * ID; `book` is a folder with none; `webView` embeds a remote page given by its `webViewSrc`
+ * label.
+ */
+ type: "text" | "code" | "book" | "webView";
+ /** Only meaningful for `code` notes; text pages are `text/html` once rendered. */
+ mime?: string;
+ /** Labels the note carries in the application, e.g. `iconClass`, `docUrl`, `webViewSrc`. */
+ attributes?: HiddenSubtreeAttribute[];
+ children?: HelpMetaItem[];
+}
+
+/**
+ * The rendered content of every help note that has one, keyed by note ID — the counterpart of
+ * the help tree. Notes without an entry (folders, web views) have no content of their own.
+ */
+export type HelpBundle = Record<string, string>;
diff --git a/packages/commons/src/lib/image_mimes.spec.ts b/packages/commons/src/lib/image_mimes.spec.ts
index 7ad30a31c5..b319cb52a7 100644
--- a/packages/commons/src/lib/image_mimes.spec.ts
+++ b/packages/commons/src/lib/image_mimes.spec.ts
@@ -38,9 +38,17 @@ describe("imageExtensionForMime", () => {
expect(imageExtensionForMime("image/svg+xml")).toBe("svg");
});
+ it("settles on one name for a JPEG, whichever of its two media types it arrived as", () => {
+ // The format is spelled two ways on each side, and a picture converted to it is named by
+ // its media type alone — the title it was uploaded under describes the format it used to
+ // be. Answering ".jpeg" for one spelling and ".jpg" for the other would make that renaming
+ // depend on which spelling happened to be stored.
+ expect(imageExtensionForMime("image/jpeg")).toBe("jpg");
+ expect(imageExtensionForMime("image/jpg")).toBe("jpg");
+ });
+
it("takes the subtype where the subtype is the name", () => {
expect(imageExtensionForMime("image/png")).toBe("png");
- expect(imageExtensionForMime("image/jpeg")).toBe("jpeg");
expect(imageExtensionForMime("image/webp")).toBe("webp");
expect(imageExtensionForMime("image/avif")).toBe("avif");
expect(imageExtensionForMime("image/bmp")).toBe("bmp");
@@ -66,6 +74,11 @@ describe("imageMimeForExtension", () => {
// Two media types share ".ico"; the one a reader will recognise wins.
expect(imageMimeForExtension("ico")).toBe("image/x-icon");
expect(imageMimeForExtension("svg")).toBe("image/svg+xml");
+ // Both spellings of a JPEG resolve to the registered one. `image/jpg` is a thing clients
+ // send, not a thing to store — reaching it from a ".jpg" file is how it used to end up in
+ // the database, and from there in an export's file names.
+ expect(imageMimeForExtension("jpg")).toBe("image/jpeg");
+ expect(imageMimeForExtension("jpeg")).toBe("image/jpeg");
});
it("builds the media type from the extension otherwise", () => {
diff --git a/packages/commons/src/lib/image_mimes.ts b/packages/commons/src/lib/image_mimes.ts
index 27df1a0dd3..ee8a3bac58 100644
--- a/packages/commons/src/lib/image_mimes.ts
+++ b/packages/commons/src/lib/image_mimes.ts
@@ -76,8 +76,16 @@ export const IMAGE_UPLOAD_SUBTYPES: readonly string[] = IMAGE_MIMES.map((mime) =
* `image/png` is `.png`. These are the ones where deriving it that way produces something nobody
* has ever seen — an icon written `.xicon`, an SVG written `.svgxml` — because the subtype carries
* a prefix or a suffix that is not part of the name anyone uses for the format.
+ *
+ * JPEG is here for a second reason: the format has two spellings on each side, and picking one of
+ * each is what lets the two directions agree. `.jpg` is the name overwhelmingly written, and
+ * `image/jpeg` is the only registered media type of the two — `image/jpg` is a thing clients send,
+ * not a thing to store. Without this entry the reverse lookup builds `image/jpg` out of a `.jpg`
+ * file and puts an unregistered media type in the database, which every reader downstream then
+ * needs its own special case for.
*/
const IMAGE_EXTENSION_OVERRIDES: Record<string, string> = {
+ "image/jpeg": "jpg",
"image/svg+xml": "svg",
"image/x-icon": "ico",
"image/vnd.microsoft.icon": "ico"
diff --git a/packages/trilium-core/src/becca/becca_loader.ts b/packages/trilium-core/src/becca/becca_loader.ts
index 610c936579..7f6ee2e2fd 100644
--- a/packages/trilium-core/src/becca/becca_loader.ts
+++ b/packages/trilium-core/src/becca/becca_loader.ts
@@ -14,6 +14,8 @@ import BNote from "./entities/bnote.js";
import BOption from "./entities/boption.js";
import { getSql } from "../services/sql";
import { getContext } from "../services/context.js";
+import dateUtils from "../services/utils/date.js";
+import { getVirtualNoteProviders, type VirtualNoteProvider, type VirtualSubtreeItem } from "../services/virtual_notes.js";
export const beccaLoaded = new Promise<void>(async (res, rej) => {
// We have to import async since options init requires keyboard actions which require translations.
@@ -69,6 +71,8 @@ function load() {
});
+ injectVirtualSubtrees();
+
for (const noteId in becca.notes) {
becca.notes[noteId].sortParents();
}
@@ -91,6 +95,174 @@ const ATTRIBUTE_COLUMNS = [
"attributeId", "noteId", "type", "name", "value", "isInheritable", "position", "utcDateModified"
];
+/**
+ * Builds the becca entities of every registered virtual note provider (see
+ * `services/virtual_notes.ts`). Runs on every load, after the persisted entities: virtual
+ * entities live only in becca, so a full reload (e.g. `becca_loader.reload()`) both refreshes
+ * them and is the way to pick up provider-side changes.
+ */
+function injectVirtualSubtrees() {
+ const log = getLog();
+ let injectedAny = false;
+
+ for (const provider of getVirtualNoteProviders()) {
+ if (!(provider.parentNoteId in becca.notes)) {
+ // E.g. the first load during initial database creation, which happens before the
+ // hidden subtree exists; the post-dbReady load will inject.
+ log.info(`Virtual note provider '${provider.namespace}': anchor note '${provider.parentNoteId}' not present, skipping injection.`);
+ continue;
+ }
+
+ try {
+ const subtree = provider.getSubtree();
+ validateVirtualSubtree(provider, subtree);
+
+ // Sort the injected roots after the anchor's persisted children so their
+ // notePositions don't collide.
+ const basePosition = becca.notes[provider.parentNoteId]
+ .getChildBranches()
+ .reduce((max, childBranch) => Math.max(max, childBranch?.notePosition ?? 0), 0);
+
+ // Set before injecting: should injection throw mid-subtree, the already-injected
+ // notes still need the target-relation backfill below.
+ injectedAny = true;
+
+ for (const [index, item] of subtree.entries()) {
+ injectVirtualItem(provider, provider.parentNoteId, item, basePosition + (index + 1) * 10);
+ }
+ } catch (e) {
+ // A broken provider must never take down the becca load.
+ log.error(`Virtual note provider '${provider.namespace}' failed, skipping: ${e instanceof Error ? (e.stack ?? e.message) : String(e)}`);
+ }
+ }
+
+ if (injectedAny) {
+ backfillVirtualTargetRelations();
+ }
+}
+
+function validateVirtualSubtree(provider: VirtualNoteProvider, items: VirtualSubtreeItem[]) {
+ // Repeated IDs are deliberately allowed: an ID appearing in several places is a clone
+ // (multiple placements of one note), which e.g. the User Guide meta makes use of.
+ for (const item of items) {
+ if (!item.id.startsWith(provider.namespace)) {
+ throw new Error(`Item '${item.id}' is outside the provider's namespace '${provider.namespace}'.`);
+ }
+
+ validateVirtualSubtree(provider, item.children ?? []);
+ }
+}
+
+function injectVirtualItem(provider: VirtualNoteProvider, parentNoteId: string, item: VirtualSubtreeItem, defaultPosition: number) {
+ let note = becca.notes[item.id];
+
+ if (note && !note.isVirtual && note.type !== undefined) {
+ // A persisted note still occupies this ID (e.g. rows predating the migration that
+ // removed the persisted variant of this subtree). Persisted data wins to avoid
+ // corrupting it; the conflict is surfaced instead of silently overridden.
+ getLog().error(`Virtual note provider '${provider.namespace}': a persisted note '${item.id}' already exists, skipping injection of this item and its children.`);
+ return;
+ }
+
+ // An already-virtual note means this is a repeated placement (a clone within the virtual
+ // subtree): the first occurrence defined the note and its attributes, this one only
+ // contributes an additional branch.
+ const isCloneOccurrence = !!note?.isVirtual;
+
+ if (!isCloneOccurrence) {
+ const noteRow: Partial<NoteRow> = {
+ noteId: item.id,
+ title: item.title,
+ type: item.type,
+ mime: item.mime ?? (item.type === "text" ? "text/html" : ""),
+ isProtected: false,
+ dateCreated: dateUtils.localNowDateTime(),
+ dateModified: dateUtils.localNowDateTime(),
+ utcDateCreated: dateUtils.utcNowDateTime(),
+ utcDateModified: dateUtils.utcNowDateTime()
+ };
+
+ if (note) {
+ // Skeleton created by a forward reference (e.g. a persisted branch or relation
+ // loaded before this virtual note existed) — fill it in place so those links
+ // survive.
+ note.updateFromRow(noteRow);
+ } else {
+ note = new BNote(noteRow);
+ }
+
+ note.isVirtual = true;
+ }
+
+ const branchId = `${parentNoteId}_${item.id}`;
+
+ if (!becca.branches[branchId]) {
+ const branch = new BBranch({
+ branchId,
+ noteId: item.id,
+ parentNoteId,
+ prefix: null,
+ notePosition: item.notePosition ?? defaultPosition,
+ isExpanded: !!item.isExpanded
+ });
+ branch.isVirtual = true;
+ }
+
+ const attributeDefs = isCloneOccurrence ? [] : [...(item.attributes ?? [])];
+
+ if (!isCloneOccurrence && item.icon) {
+ attributeDefs.push({ type: "label", name: "iconClass", value: `bx ${item.icon}` });
+ }
+
+ for (const [index, def] of attributeDefs.entries()) {
+ // Deterministic ID, unique thanks to the note-ID prefix; the counter suffix
+ // disambiguates multiple same-named attributes on one note, probing until free so
+ // pathological names (e.g. "x" colliding with an explicit "x_1") cannot overwrite.
+ const baseAttributeId = `v_${item.id}_${def.type.charAt(0)}${def.name}`;
+ let attributeId = baseAttributeId;
+ for (let suffix = 1; becca.attributes[attributeId]; suffix++) {
+ attributeId = `${baseAttributeId}_${suffix}`;
+ }
+
+ const attribute = new BAttribute({
+ attributeId,
+ noteId: item.id,
+ type: def.type,
+ name: def.name,
+ value: def.value ?? "",
+ isInheritable: !!def.isInheritable,
+ position: (index + 1) * 10
+ });
+ attribute.isVirtual = true;
+ }
+
+ for (const [index, child] of (item.children ?? []).entries()) {
+ injectVirtualItem(provider, item.id, child, (index + 1) * 10);
+ }
+}
+
+/**
+ * Relations pointing into a virtual namespace load before the virtual notes exist, so their
+ * target-relation backlinks could not be established in `BAttribute.init()` — including
+ * relations between virtual notes when the target comes later in the subtree. One pass after
+ * injection fixes both.
+ */
+function backfillVirtualTargetRelations() {
+ for (const attributeId in becca.attributes) {
+ const attribute = becca.attributes[attributeId];
+
+ if (attribute.type !== "relation" || !attribute.value) {
+ continue;
+ }
+
+ const targetNote = becca.notes[attribute.value];
+
+ if (targetNote?.isVirtual && !targetNote.targetRelations.includes(attribute)) {
+ targetNote.targetRelations.push(attribute);
+ }
+ }
+}
+
function reload(reason: string) {
load();
diff --git a/packages/trilium-core/src/becca/entities/abstract_becca_entity.ts b/packages/trilium-core/src/becca/entities/abstract_becca_entity.ts
index da336a81dd..c472d27955 100644
--- a/packages/trilium-core/src/becca/entities/abstract_becca_entity.ts
+++ b/packages/trilium-core/src/becca/entities/abstract_becca_entity.ts
@@ -1,3 +1,4 @@
+import { ValidationError } from "../../errors.js";
import eventService from "../../services/events";
import blobService from "../../services/blob.js";
@@ -33,6 +34,23 @@ abstract class AbstractBeccaEntity<T extends AbstractBeccaEntity<T>> {
isSynced?: boolean;
blobId?: string;
+ /**
+ * Virtual entities exist only in becca — they are injected by a virtual note provider
+ * (see `services/virtual_notes.ts`), never persisted to the database and never synced.
+ * {@link save} and {@link markAsDeleted} throw; content goes through the note's provider.
+ */
+ isVirtual?: boolean;
+
+ /** @throws ValidationError when this entity is virtual, since virtual entities never touch the database. */
+ protected ensureNotVirtual(action: string) {
+ if (!this.isVirtual) {
+ return;
+ }
+
+ const constructorData = this.constructor as unknown as ConstructorData<T>;
+ throw new ValidationError(`Cannot ${action} ${constructorData.entityName} '${(this as any)[constructorData.primaryKeyName]}': it is a virtual entity (provided by a virtual note provider) and is read-only.`);
+ }
+
protected beforeSaving(opts?: {}) {
const constructorData = this.constructor as unknown as ConstructorData<T>;
if (!(this as any)[constructorData.primaryKeyName]) {
@@ -103,6 +121,8 @@ abstract class AbstractBeccaEntity<T extends AbstractBeccaEntity<T>> {
* Saves entity - executes SQL, but doesn't commit the transaction on its own
*/
save(opts?: {}): this {
+ this.ensureNotVirtual("save");
+
const constructorData = this.constructor as unknown as ConstructorData<T>;
const entityName = constructorData.entityName;
const primaryKeyName = constructorData.primaryKeyName;
@@ -141,6 +161,8 @@ abstract class AbstractBeccaEntity<T extends AbstractBeccaEntity<T>> {
}
protected _setContent(content: string | Uint8Array, opts: ContentOpts = {}) {
+ this.ensureNotVirtual("set content of");
+
// client code asks to save entity even if blobId didn't change (something else was changed)
opts.forceSave = !!opts.forceSave;
opts.forceFrontendReload = !!opts.forceFrontendReload;
@@ -293,6 +315,8 @@ abstract class AbstractBeccaEntity<T extends AbstractBeccaEntity<T>> {
* This is a low-level method, for notes and branches use `note.deleteNote()` and 'branch.deleteBranch()` instead.
*/
markAsDeleted(deleteId: string | null = null) {
+ this.ensureNotVirtual("delete");
+
const constructorData = this.constructor as unknown as ConstructorData<T>;
const entityId = (this as any)[constructorData.primaryKeyName];
const entityName = constructorData.entityName;
@@ -320,6 +344,8 @@ abstract class AbstractBeccaEntity<T extends AbstractBeccaEntity<T>> {
}
markAsDeletedSimple() {
+ this.ensureNotVirtual("delete");
+
const constructorData = this.constructor as unknown as ConstructorData<T>;
const entityId = (this as any)[constructorData.primaryKeyName];
const entityName = constructorData.entityName;
diff --git a/packages/trilium-core/src/becca/entities/battachment.ts b/packages/trilium-core/src/becca/entities/battachment.ts
index f29f556b66..9ad9f2bea3 100644
--- a/packages/trilium-core/src/becca/entities/battachment.ts
+++ b/packages/trilium-core/src/becca/entities/battachment.ts
@@ -2,6 +2,7 @@
import { type AttachmentRow, isImageAttachmentRole } from "@triliumnext/commons";
+import { ValidationError } from "../../errors.js";
import dateUtils from "../../services/utils/date";
import { getLog } from "../../services/log.js";
import noteService from "../../services/notes.js";
@@ -237,6 +238,10 @@ class BAttachment extends AbstractBeccaEntity<BAttachment> {
}
override beforeSaving() {
+ if (this.becca.notes[this.ownerId]?.isVirtual) {
+ throw new ValidationError(`Cannot save an attachment of note '${this.ownerId}': virtual notes have no attachments.`);
+ }
+
super.beforeSaving();
if (this.position === undefined || this.position === null) {
diff --git a/packages/trilium-core/src/becca/entities/battribute.ts b/packages/trilium-core/src/becca/entities/battribute.ts
index 8b287bbcab..c76f501038 100644
--- a/packages/trilium-core/src/becca/entities/battribute.ts
+++ b/packages/trilium-core/src/becca/entities/battribute.ts
@@ -184,6 +184,13 @@ class BAttribute extends AbstractBeccaEntity<BAttribute> {
}
override beforeSaving(opts: SavingOpts = {}) {
+ // Virtual notes (e.g. the in-app help) are not user-customizable, so no persisted
+ // attribute may be attached to them. (Relations *pointing to* virtual notes from
+ // regular notes are fine — this guards the owning note only.)
+ if (this.becca.notes[this.noteId]?.isVirtual) {
+ throw new Error(`Cannot save attribute '${this.name}' for note '${this.noteId}': attributes of virtual notes cannot be modified.`);
+ }
+
if (!opts.skipValidation) {
this.validate();
}
diff --git a/packages/trilium-core/src/becca/entities/bbranch.ts b/packages/trilium-core/src/becca/entities/bbranch.ts
index 1468e04599..16a1c19e74 100644
--- a/packages/trilium-core/src/becca/entities/bbranch.ts
+++ b/packages/trilium-core/src/becca/entities/bbranch.ts
@@ -210,6 +210,16 @@ class BBranch extends AbstractBeccaEntity<BBranch> {
throw new Error(`noteId and parentNoteId are mandatory properties for Branch`);
}
+ // Virtual notes (e.g. the in-app help) cannot be cloned or moved: a persisted branch
+ // referencing a virtual note would dangle on other sync instances and after upgrades.
+ if (this.becca.notes[this.noteId]?.isVirtual) {
+ throw new Error(`Cannot save branch for note '${this.noteId}': virtual notes cannot be cloned or moved.`);
+ }
+
+ if (this.becca.notes[this.parentNoteId]?.isVirtual) {
+ throw new Error(`Cannot place note '${this.noteId}' under '${this.parentNoteId}': virtual notes cannot receive children.`);
+ }
+
this.branchId = `${this.parentNoteId}_${this.noteId}`;
if (this.notePosition === undefined || this.notePosition === null) {
diff --git a/packages/trilium-core/src/becca/entities/bnote.ts b/packages/trilium-core/src/becca/entities/bnote.ts
index 4114aa1962..c9f4cfe27e 100644
--- a/packages/trilium-core/src/becca/entities/bnote.ts
+++ b/packages/trilium-core/src/becca/entities/bnote.ts
@@ -21,6 +21,7 @@ import BRevision from "./brevision.js";
import { getLog } from "../../services/log.js";
import { getSql } from "../../services/sql/index.js";
import { formatDownloadTitle, isStringNote, normalize, randomString, replaceAll } from "../../services/utils/index.js";
+import { getVirtualNoteContent, isVirtualNoteContentWritable, setVirtualNoteContent } from "../../services/virtual_notes.js";
const LABEL = "label";
const RELATION = "relation";
@@ -219,6 +220,11 @@ class BNote extends AbstractBeccaEntity<BNote> {
* - but to the user note content and title changes are one and the same - single dateModified (so all changes must go through Note and content is not a separate entity)
*/
getContent() {
+ if (this.isVirtual) {
+ // Virtual notes have no blob row; content (if any) comes from their provider.
+ return getVirtualNoteContent(this.noteId);
+ }
+
return this._getContent();
}
@@ -245,11 +251,21 @@ class BNote extends AbstractBeccaEntity<BNote> {
}
setContent(content: Uint8Array | string, opts: ContentOpts = {}) {
+ if (this.isVirtual) {
+ setVirtualNoteContent(this.noteId, content);
+ return;
+ }
+
this._setContent(content, opts);
eventService.emit(eventService.NOTE_CONTENT_CHANGE, { entity: this });
}
+ /** Whether the content can be saved: always for a persisted note, per provider for a virtual one. */
+ isContentWritable() {
+ return !this.isVirtual || isVirtualNoteContentWritable(this.noteId);
+ }
+
setJsonContent(content: {}) {
this.setContent(JSON.stringify(content, null, "\t"));
}
diff --git a/packages/trilium-core/src/becca/entities/brevision.ts b/packages/trilium-core/src/becca/entities/brevision.ts
index f7f94bf51d..d4b45e9a75 100644
--- a/packages/trilium-core/src/becca/entities/brevision.ts
+++ b/packages/trilium-core/src/becca/entities/brevision.ts
@@ -1,5 +1,6 @@
"use strict";
+import { ValidationError } from "../../errors.js";
import protectedSessionService from "../../services/protected_session.js";
import dateUtils from "../../services/utils/date";
import becca from "../becca.js";
@@ -184,6 +185,10 @@ class BRevision extends AbstractBeccaEntity<BRevision> {
}
override beforeSaving() {
+ if (this.becca.notes[this.noteId]?.isVirtual) {
+ throw new ValidationError(`Cannot save a revision of note '${this.noteId}': virtual notes have no revisions.`);
+ }
+
super.beforeSaving();
this.utcDateModified = dateUtils.utcNowDateTime();
diff --git a/packages/trilium-core/src/becca/virtual_notes_injection.spec.ts b/packages/trilium-core/src/becca/virtual_notes_injection.spec.ts
new file mode 100644
index 0000000000..bd20cf65e5
--- /dev/null
+++ b/packages/trilium-core/src/becca/virtual_notes_injection.spec.ts
@@ -0,0 +1,280 @@
+import { afterAll, beforeAll, describe, expect, it } from "vitest";
+
+import { ValidationError } from "../errors.js";
+import { getContext } from "../services/context.js";
+import noteService from "../services/notes.js";
+import optionService from "../services/options.js";
+import { getSql } from "../services/sql/index.js";
+import { registerVirtualNoteProvider, unregisterVirtualNoteProvider, type VirtualSubtreeItem } from "../services/virtual_notes.js";
+import becca from "./becca.js";
+import { load } from "./becca_loader.js";
+import BAttribute from "./entities/battribute.js";
+import BBranch from "./entities/bbranch.js";
+
+const SUBTREE: VirtualSubtreeItem[] = [
+ {
+ id: "_vtest",
+ title: "Virtual root",
+ type: "book",
+ icon: "bx-cube",
+ isExpanded: true,
+ children: [
+ {
+ id: "_vtestPage",
+ title: "Virtual page",
+ type: "text",
+ attributes: [{ type: "label", name: "docName", value: "vtest_page" }]
+ },
+ {
+ id: "_vtestLinked",
+ title: "Linked page",
+ type: "text",
+ // relation to a sibling that is injected *after* this note — exercises the
+ // backfill of forward references within a virtual subtree
+ attributes: [{ type: "relation", name: "seeAlso", value: "_vtestLast" }]
+ },
+ {
+ id: "_vtestLast",
+ title: "Last page",
+ type: "text",
+ // repeated placement of _vtestPage — a clone within the virtual subtree,
+ // as the real User Guide meta contains (same ID, several locations)
+ children: [{ id: "_vtestPage", title: "Clone placement", type: "text" }]
+ }
+ ]
+ }
+];
+
+function reloadBecca() {
+ getContext().init(() => load());
+}
+
+function countRows(table: string, column: string): number {
+ return getSql().getValue<number>(`SELECT COUNT(*) FROM ${table} WHERE ${column} LIKE '\\_vtest%' ESCAPE '\\'`);
+}
+
+describe("virtual note injection", () => {
+ beforeAll(() => {
+ registerVirtualNoteProvider({
+ namespace: "_vtest",
+ parentNoteId: "_hidden",
+ getSubtree: () => SUBTREE,
+ getContent: (noteId) => (noteId === "_vtestPage" ? "<p>virtual content</p>" : null)
+ });
+ reloadBecca();
+ });
+
+ afterAll(() => {
+ unregisterVirtualNoteProvider("_vtest");
+ reloadBecca();
+ });
+
+ it("builds the subtree in becca with virtual notes, branches and attributes", () => {
+ const root = becca.getNoteOrThrow("_vtest");
+ expect(root.isVirtual).toBe(true);
+ expect(root.title).toBe("Virtual root");
+ expect(root.type).toBe("book");
+ expect(root.mime).toBe("");
+ // A text page without a mime of its own gets the one every text note carries, which
+ // the full-text search needs to read its markup as HTML.
+ expect(becca.getNoteOrThrow("_vtestPage").mime).toBe("text/html");
+ expect(root.getParentNotes().map((note) => note.noteId)).toEqual(["_hidden"]);
+ expect(root.getChildNotes().map((note) => note.noteId)).toEqual(["_vtestPage", "_vtestLinked", "_vtestLast"]);
+
+ // deterministic branch IDs, registered in all becca maps
+ const rootBranch = becca.getBranch("_hidden__vtest");
+ expect(rootBranch?.isVirtual).toBe(true);
+ expect(rootBranch?.isExpanded).toBe(true);
+ expect(becca.getBranchFromChildAndParent("_vtestPage", "_vtest")?.isVirtual).toBe(true);
+
+ // the root sorts after the anchor's persisted children
+ const siblingPositions = becca.getNoteOrThrow("_hidden")
+ .getChildBranches()
+ .filter((branch) => branch && branch.noteId !== "_vtest")
+ .map((branch) => branch?.notePosition ?? 0);
+ expect(rootBranch?.notePosition).toBeGreaterThan(Math.max(...siblingPositions));
+
+ // attributes: explicit ones and the icon-derived label
+ const page = becca.getNoteOrThrow("_vtestPage");
+ expect(page.getLabelValue("docName")).toBe("vtest_page");
+ expect(becca.getNoteOrThrow("_vtest").getLabelValue("iconClass")).toBe("bx bx-cube");
+ expect(page.getOwnedAttributes().every((attribute) => attribute.isVirtual)).toBe(true);
+ });
+
+ it("treats repeated item IDs as clones: one note, several branches, attributes once", () => {
+ const page = becca.getNoteOrThrow("_vtestPage");
+
+ // the first occurrence defines the note; the second only places it again
+ expect(page.title).toBe("Virtual page");
+ expect(page.getParentNotes().map((note) => note.noteId).sort()).toEqual(["_vtest", "_vtestLast"]);
+ expect(becca.getBranchFromChildAndParent("_vtestPage", "_vtestLast")?.isVirtual).toBe(true);
+
+ // attributes come from the first occurrence only, without duplication
+ expect(page.getOwnedAttributes().filter((attribute) => attribute.name === "docName")).toHaveLength(1);
+ });
+
+ it("persists nothing to the database", () => {
+ expect(countRows("notes", "noteId")).toBe(0);
+ expect(countRows("branches", "noteId")).toBe(0);
+ expect(countRows("attributes", "noteId")).toBe(0);
+ expect(getSql().getValue<number>(`SELECT COUNT(*) FROM entity_changes WHERE entityId LIKE '\\_vtest%' ESCAPE '\\'`)).toBe(0);
+ });
+
+ it("virtual entities are read-only", () => {
+ const note = becca.getNoteOrThrow("_vtestPage");
+ expect(note.isContentWritable()).toBe(false);
+ expect(() => getContext().init(() => note.save())).toThrow(ValidationError);
+ expect(() => getContext().init(() => note.setContent("<p>nope</p>"))).toThrow(ValidationError);
+ expect(() => getContext().init(() => note.markAsDeleted())).toThrow(ValidationError);
+ expect(() => getContext().init(() => note.saveRevision())).toThrow(ValidationError);
+ expect(() => getContext().init(() => note.saveAttachment({
+ role: "file", mime: "text/plain", title: "notes.txt", content: "nope"
+ }))).toThrow(ValidationError);
+ expect(countRows("revisions", "noteId")).toBe(0);
+ expect(countRows("attachments", "ownerId")).toBe(0);
+
+ const branch = becca.getBranch("_hidden__vtest");
+ expect(branch).toBeTruthy();
+ expect(() => getContext().init(() => branch?.markAsDeleted())).toThrow(/read-only/);
+
+ const attribute = note.getOwnedAttributes()[0];
+ expect(() => getContext().init(() => attribute.save())).toThrow(/read-only/);
+ });
+
+ it("hands content to a provider that can save it, keeping it out of the database", () => {
+ const saved = new Map<string, string | Uint8Array>();
+ registerVirtualNoteProvider({
+ namespace: "_vtw",
+ parentNoteId: "_hidden",
+ getSubtree: () => [{ id: "_vtwFile", title: "File", type: "text" }],
+ getContent: (noteId) => saved.get(noteId),
+ setContent: (noteId, content) => { saved.set(noteId, content); }
+ });
+
+ try {
+ reloadBecca();
+ const note = becca.getNoteOrThrow("_vtwFile");
+ expect(note.isContentWritable()).toBe(true);
+
+ getContext().init(() => note.setContent("<p>saved</p>"));
+ expect(note.getContent()).toBe("<p>saved</p>");
+
+ // The editor's save route, with a link that would otherwise become an `internalLink`
+ // attribute and a revision that would otherwise be due.
+ const linked = `<p><a class="reference-link" href="#root/_hidden">Hidden</a></p>`;
+ getContext().init(() => {
+ optionService.setOption("revisionSnapshotTimeInterval", "0");
+ try {
+ noteService.updateNoteData("_vtwFile", linked);
+ } finally {
+ optionService.setOption("revisionSnapshotTimeInterval", "600");
+ }
+ });
+ expect(note.getContent()).toBe(linked);
+ expect(note.getRelations("internalLink")).toEqual([]);
+ expect(getSql().getValue("SELECT COUNT(*) FROM revisions WHERE noteId = '_vtwFile'")).toBe(0);
+ expect(getSql().getValue("SELECT COUNT(*) FROM entity_changes WHERE entityId LIKE '\\_vtw%' ESCAPE '\\'")).toBe(0);
+ expect(getSql().getValue("SELECT COUNT(*) FROM notes WHERE noteId LIKE '\\_vtw%' ESCAPE '\\'")).toBe(0);
+ } finally {
+ unregisterVirtualNoteProvider("_vtw");
+ reloadBecca();
+ }
+ });
+
+ it("rejects persisting branches or attributes that reference virtual notes", () => {
+ const realNote = getContext().init(() =>
+ noteService.createNewNote({
+ parentNoteId: "root",
+ title: "real note for virtual tests",
+ content: "",
+ type: "text"
+ }).note
+ );
+
+ // cloning a virtual note out into the persisted tree
+ expect(() => getContext().init(() =>
+ new BBranch({ noteId: "_vtestPage", parentNoteId: realNote.noteId, isExpanded: false }).save()
+ )).toThrow(/cloned or moved/);
+
+ // placing a persisted note under a virtual parent
+ expect(() => getContext().init(() =>
+ new BBranch({ noteId: realNote.noteId, parentNoteId: "_vtest", isExpanded: false }).save()
+ )).toThrow(/receive children/);
+
+ // annotating a virtual note
+ expect(() => getContext().init(() =>
+ new BAttribute({ noteId: "_vtest", type: "label", name: "myLabel", value: "x" }).save()
+ )).toThrow(/virtual/);
+ });
+
+ it("serves content from the provider, defaulting to empty", () => {
+ expect(becca.getNoteOrThrow("_vtestPage").getContent()).toBe("<p>virtual content</p>");
+ expect(becca.getNoteOrThrow("_vtest").getContent()).toBe("");
+ });
+
+ it("resolves relations targeting virtual notes across reloads (backfill)", () => {
+ const realNote = getContext().init(() =>
+ noteService.createNewNote({
+ parentNoteId: "root",
+ title: "note linking into virtual subtree",
+ content: "",
+ type: "text"
+ }).note
+ );
+ getContext().init(() =>
+ new BAttribute({ noteId: realNote.noteId, type: "relation", name: "linksTo", value: "_vtestLinked" }).save()
+ );
+
+ // On reload the persisted relation loads before the virtual notes exist; the
+ // injection backfill must re-establish the target-relation backlink.
+ reloadBecca();
+
+ const target = becca.getNoteOrThrow("_vtestLinked");
+ expect(target.isVirtual).toBe(true);
+ expect(target.targetRelations.some((rel) => rel.name === "linksTo" && rel.noteId === realNote.noteId)).toBe(true);
+
+ // ...including forward references between virtual notes themselves
+ const last = becca.getNoteOrThrow("_vtestLast");
+ expect(last.targetRelations.some((rel) => rel.name === "seeAlso" && rel.noteId === "_vtestLinked")).toBe(true);
+ });
+
+ it("skips providers whose anchor note does not exist, without creating skeletons", () => {
+ registerVirtualNoteProvider({
+ namespace: "_vghost",
+ parentNoteId: "_doesNotExist",
+ getSubtree: () => [{ id: "_vghost", title: "Ghost", type: "text" }]
+ });
+
+ try {
+ reloadBecca();
+ expect(becca.getNote("_vghost")).toBeNull();
+ expect(becca.getNote("_doesNotExist")).toBeNull();
+ } finally {
+ unregisterVirtualNoteProvider("_vghost");
+ }
+ });
+
+ it("skips a provider whose subtree strays outside its namespace, leaving others intact", () => {
+ registerVirtualNoteProvider({
+ namespace: "_vbad",
+ parentNoteId: "_hidden",
+ getSubtree: () => [{
+ id: "_vbad",
+ title: "Bad",
+ type: "text",
+ children: [{ id: "_outsider", title: "Outside the namespace", type: "text" }]
+ }]
+ });
+
+ try {
+ reloadBecca();
+ // validation runs before injection, so nothing of the bad provider materializes
+ expect(becca.getNote("_vbad")).toBeNull();
+ expect(becca.getNote("_outsider")).toBeNull();
+ // and the healthy provider is unaffected
+ expect(becca.getNote("_vtest")?.isVirtual).toBe(true);
+ } finally {
+ unregisterVirtualNoteProvider("_vbad");
+ }
+ });
+});
diff --git a/packages/trilium-core/src/index.ts b/packages/trilium-core/src/index.ts
index 4393da225f..ac4de67041 100644
--- a/packages/trilium-core/src/index.ts
+++ b/packages/trilium-core/src/index.ts
@@ -141,6 +141,16 @@ export { default as sync_mutex } from "./services/sync_mutex";
export { default as setup } from "./services/setup";
export { getPlatform, type PlatformProvider } from "./services/platform";
export { InAppHelpProvider } from "./services/in_app_help";
+export {
+ getVirtualNoteContent,
+ getVirtualNoteProvider,
+ getVirtualNoteProviders,
+ registerVirtualNoteProvider,
+ unregisterVirtualNoteProvider,
+ type VirtualNoteProvider,
+ type VirtualSubtreeAttribute,
+ type VirtualSubtreeItem
+} from "./services/virtual_notes";
export { type ImageProvider, type ImageFormat, type ImageCompressionOutcome, type ImageCompressionRequest, type ImageShrink, type ProcessedImage, getImageProvider } from "./services/image_provider";
export { default as imageCompressionService } from "./services/image_compression";
export { default as imageInventoryService, type ImageInventoryOptions } from "./services/image_inventory";
@@ -228,6 +238,11 @@ export async function initializeCore({ dbConfig, executionContext, crypto, zip,
initZipProvider(zip);
initZipExportProviderFactory(zipExportProviderFactory);
initContext(executionContext);
+ if (inAppHelp) {
+ // Must precede initSql: it registers the _help virtual note provider, and initSql can
+ // resolve dbReady, which triggers the becca load that injects virtual subtrees.
+ initInAppHelp(inAppHelp);
+ }
await initSql(new SqlService(dbConfig, getLog()));
initSchema(schema);
initImageProvider(image);
@@ -241,7 +256,4 @@ export async function initializeCore({ dbConfig, executionContext, crypto, zip,
if (request) {
initRequest(request);
}
- if (inAppHelp) {
- initInAppHelp(inAppHelp);
- }
};
diff --git a/packages/trilium-core/src/migrations/migrations.ts b/packages/trilium-core/src/migrations/migrations.ts
index 304e162ec9..645d7b6729 100644
--- a/packages/trilium-core/src/migrations/migrations.ts
+++ b/packages/trilium-core/src/migrations/migrations.ts
@@ -9,6 +9,38 @@ export function getMaxMigrationVersion() {
// Migrations should be kept in descending order, so the latest migration is first.
export const MIGRATIONS: (SqlMigration | JsMigration)[] = [
+ // The in-app help (`_help` subtree) became virtual — injected into becca from the bundled
+ // help meta on every load, never persisted or synced (see services/virtual_notes.ts).
+ // Remove the previously persisted rows, including their entity_changes so the deletions
+ // don't churn through sync: every instance in a cluster runs this same migration (the
+ // accompanying sync-version bump guarantees no un-migrated peers), so all copies converge.
+ // User clones of help notes and user attributes on them are dropped by design — the help
+ // structure is application-owned. Orphaned blobs are vacuumed by the regular erase job.
+ // The rows for indirectly-keyed entities must be removed from entity_changes before their
+ // base rows disappear from under the subselects.
+ {
+ version: 242,
+ sql: /*sql*/`
+ DELETE FROM entity_changes WHERE entityName = 'branches' AND entityId IN
+ (SELECT branchId FROM branches WHERE noteId LIKE '\\_help%' ESCAPE '\\' OR parentNoteId LIKE '\\_help%' ESCAPE '\\');
+ DELETE FROM entity_changes WHERE entityName = 'attributes' AND entityId IN
+ (SELECT attributeId FROM attributes WHERE noteId LIKE '\\_help%' ESCAPE '\\');
+ DELETE FROM entity_changes WHERE entityName = 'revisions' AND entityId IN
+ (SELECT revisionId FROM revisions WHERE noteId LIKE '\\_help%' ESCAPE '\\');
+ DELETE FROM entity_changes WHERE entityName = 'attachments' AND entityId IN
+ (SELECT attachmentId FROM attachments WHERE ownerId LIKE '\\_help%' ESCAPE '\\');
+ -- Blanket sweep by ID prefix: catches notes and note_reordering rows directly, plus
+ -- tombstones of help branches/attributes deleted (and later erased) by past releases —
+ -- their base rows are gone, so the subselects above cannot find them, but branch IDs
+ -- ('parentNoteId_noteId') and attribute IDs ('noteId_...') carry the _help prefix.
+ DELETE FROM entity_changes WHERE entityId LIKE '\\_help%' ESCAPE '\\';
+ DELETE FROM branches WHERE noteId LIKE '\\_help%' ESCAPE '\\' OR parentNoteId LIKE '\\_help%' ESCAPE '\\';
+ DELETE FROM attributes WHERE noteId LIKE '\\_help%' ESCAPE '\\';
+ DELETE FROM revisions WHERE noteId LIKE '\\_help%' ESCAPE '\\';
+ DELETE FROM attachments WHERE ownerId LIKE '\\_help%' ESCAPE '\\';
+ DELETE FROM notes WHERE noteId LIKE '\\_help%' ESCAPE '\\';
+ `
+ },
// Delete the globe icon the web clipper wrote onto clippings, so they take the icon of their clipType
{
version: 241,
diff --git a/packages/trilium-core/src/routes/api/branches.spec.ts b/packages/trilium-core/src/routes/api/branches.spec.ts
index da3fd64b75..0a4bf6cd41 100644
--- a/packages/trilium-core/src/routes/api/branches.spec.ts
+++ b/packages/trilium-core/src/routes/api/branches.spec.ts
@@ -1,6 +1,10 @@
import { beforeAll, describe, expect, it } from "vitest";
+import becca from "../../becca/becca";
+import { load } from "../../becca/becca_loader";
+import { getContext } from "../../services/context";
import { getSql } from "../../services/sql/index";
+import { registerVirtualNoteProvider, unregisterVirtualNoteProvider } from "../../services/virtual_notes";
import { createTextNote } from "../../test/api_fixtures";
import { CoreApiTester } from "../../test/api_tester";
@@ -30,6 +34,7 @@ function setExpanded(branchIds: string[], isExpanded: number) {
"UPDATE branches SET isExpanded = ? WHERE branchId = ?",
[ isExpanded, branchId ]
);
+ becca.getBranchOrThrow(branchId).isExpanded = !!isExpanded;
}
}
@@ -287,6 +292,73 @@ describe("Branches API (core)", () => {
expect(getBranchRow(branchId)?.isExpanded).toBe(0);
}
});
+
+ it("reaches the virtual subtree below a note, and a subtree that is virtual itself", async () => {
+ const anchor = await createTextNote(api, { title: "Virtual anchor" });
+ const persistedChild = await createTextNote(api, { parentNoteId: anchor.noteId, title: "Persisted child" });
+ registerVirtualNoteProvider({
+ namespace: "_vexp",
+ parentNoteId: anchor.noteId,
+ getSubtree: () => [{
+ id: "_vexp",
+ title: "Virtual root",
+ type: "book",
+ children: [{
+ id: "_vexpBook",
+ title: "Virtual book",
+ type: "book",
+ children: [{ id: "_vexpPage", title: "Virtual page", type: "text" }]
+ }]
+ }]
+ });
+
+ try {
+ getContext().init(() => load());
+ const virtualBranchIds = [ `${anchor.noteId}__vexp`, "_vexp__vexpBook", "_vexpBook__vexpPage" ];
+ const isExpanded = (branchId: string) => becca.getBranch(branchId)?.isExpanded;
+
+ const expand = await api.put<{ branchIds: string[] }>(`/api/branches/${anchor.branchId}/expanded-subtree/1`);
+ expect(new Set(expand.body.branchIds)).toEqual(new Set([ anchor.branchId, persistedChild.branchId, ...virtualBranchIds ]));
+ expect(getBranchRow(persistedChild.branchId)?.isExpanded).toBe(1);
+ expect(virtualBranchIds.map(isExpanded)).toEqual([ true, true, true ]);
+
+ const collapse = await api.put<{ branchIds: string[] }>(`/api/branches/_vexp__vexpBook/expanded-subtree/0`);
+ expect(new Set(collapse.body.branchIds)).toEqual(new Set([ "_vexp__vexpBook", "_vexpBook__vexpPage" ]));
+ expect(virtualBranchIds.map(isExpanded)).toEqual([ true, false, false ]);
+ expect(getBranchRow(persistedChild.branchId)?.isExpanded).toBe(1);
+ } finally {
+ unregisterVirtualNoteProvider("_vexp");
+ getContext().init(() => load());
+ }
+ });
+
+ it("expands a note with more children than a call can take as arguments", async () => {
+ const anchor = await createTextNote(api, { title: "Crowded anchor" });
+ const childCount = 200_000;
+ registerVirtualNoteProvider({
+ namespace: "_vbig",
+ parentNoteId: anchor.noteId,
+ getSubtree: () => [{
+ id: "_vbig",
+ title: "Crowded note",
+ type: "book",
+ children: Array.from({ length: childCount }, (_, index) => ({
+ id: `_vbig${index}`, title: `Child ${index}`, type: "text" as const
+ }))
+ }]
+ });
+
+ try {
+ getContext().init(() => load());
+
+ const res = await api.put<{ branchIds: string[] }>(`/api/branches/${anchor.noteId}__vbig/expanded-subtree/1`);
+ expect(res.status).toBe(200);
+ expect(res.body.branchIds).toHaveLength(childCount + 1);
+ } finally {
+ unregisterVirtualNoteProvider("_vbig");
+ getContext().init(() => load());
+ }
+ }, 60_000);
});
describe("prefixes", () => {
diff --git a/packages/trilium-core/src/routes/api/branches.ts b/packages/trilium-core/src/routes/api/branches.ts
index fdb0c123db..ae757b9b2b 100644
--- a/packages/trilium-core/src/routes/api/branches.ts
+++ b/packages/trilium-core/src/routes/api/branches.ts
@@ -4,6 +4,7 @@ import eventService from "../../services/events.js";
import type { Request } from "../../http_interface";
import becca from "../../becca/becca.js";
+import type BBranch from "../../becca/entities/bbranch.js";
import entityChangesService from "../../services/entity_changes.js";
import { getLog } from "../../services/log.js";
import TaskContext from "../../services/task_context.js";
@@ -175,44 +176,41 @@ function setExpanded(req: Request<{ branchId: string, expanded: string }>) {
function setExpandedForSubtree(req: Request<{ branchId: string, expanded: string }>) {
const { branchId } = req.params;
- const expanded = req.params.expanded === "1" ? 1 : 0;
- const sql = getSql();
-
- // The state filter sits outside the recursion so that the walk reaches every descendant;
- // `none_root` is excluded because the root is always expanded.
- const branchIds = sql.getColumn<string>(/*sql*/`
- WITH RECURSIVE
- tree(branchId, noteId) AS (
- SELECT branchId, noteId FROM branches WHERE branchId = ?
- UNION
- SELECT branches.branchId, branches.noteId
- FROM branches
- JOIN tree ON branches.parentNoteId = tree.noteId
- WHERE branches.isDeleted = 0
- )
- SELECT tree.branchId
- FROM tree
- JOIN branches USING (branchId)
- WHERE branches.isExpanded != ?
- AND tree.branchId != 'none_root'`,
- [ branchId, expanded ]
- );
+ const isExpanded = req.params.expanded === "1";
+
+ // Walks becca rather than the `branches` table, so that the virtual branches a provider
+ // injects are reached too; `none_root` is skipped because the root is always expanded.
+ const changedBranches: BBranch[] = [];
+ const visitedNoteIds = new Set<string>();
+ const startBranch = becca.branches[branchId];
+ const pending = startBranch ? [ startBranch ] : [];
+
+ for (let branch = pending.pop(); branch; branch = pending.pop()) {
+ if (branch.branchId !== "none_root" && branch.isExpanded !== isExpanded) {
+ changedBranches.push(branch);
+ }
- sql.executeMany(
- /*sql*/`UPDATE branches SET isExpanded = ${expanded} WHERE branchId IN (???)`,
- branchIds
- );
+ if (!visitedNoteIds.has(branch.noteId)) {
+ visitedNoteIds.add(branch.noteId);
+ for (const childBranch of branch.childNote.getChildBranches()) {
+ if (childBranch) {
+ pending.push(childBranch);
+ }
+ }
+ }
+ }
- for (const branchId of branchIds) {
- const branch = becca.branches[branchId];
+ getSql().executeMany(
+ /*sql*/`UPDATE branches SET isExpanded = ${isExpanded ? 1 : 0} WHERE branchId IN (???)`,
+ changedBranches.filter((branch) => !branch.isVirtual).map((branch) => branch.branchId)
+ );
- if (branch) {
- branch.isExpanded = !!expanded;
- }
+ for (const branch of changedBranches) {
+ branch.isExpanded = isExpanded;
}
return {
- branchIds
+ branchIds: changedBranches.map((branch) => branch.branchId)
};
}
diff --git a/packages/trilium-core/src/routes/api/export.ts b/packages/trilium-core/src/routes/api/export.ts
index e380ab9f63..8224872849 100644
--- a/packages/trilium-core/src/routes/api/export.ts
+++ b/packages/trilium-core/src/routes/api/export.ts
@@ -30,7 +30,7 @@ async function exportBranch(req: Request<{ branchId: string; type: string; forma
if (format !== "html" && format !== "markdown") {
throw new ValidationError("Invalid export type.");
}
- singleExportService.exportSingleNote(taskContext, branch, format, res);
+ await singleExportService.exportSingleNote(taskContext, branch, format, res);
} else if (format === "opml") {
opmlExportService.exportToOpml(taskContext, branch, res);
} else {
diff --git a/packages/trilium-core/src/routes/api/link_embed.spec.ts b/packages/trilium-core/src/routes/api/link_embed.spec.ts
index be44ab7298..c1b6d46c8a 100644
--- a/packages/trilium-core/src/routes/api/link_embed.spec.ts
+++ b/packages/trilium-core/src/routes/api/link_embed.spec.ts
@@ -249,8 +249,8 @@ describe("link-embed getMetadata", () => {
expect(result.siteName).toBe("Example");
// Stored, not hotlinked; opaque, so re-encoded as JPEG. Named after the page it is a
// picture of, which is what a second paste of the same URL reuses it by.
- expect(stored("coverImage")?.fileName).toMatch(/^example\.com-page-[0-9a-f]{8}\.jpeg$/);
- expect(result.image).toMatch(/^api\/attachments\/att\d+\/image\/example\.com-page-[0-9a-f]{8}\.jpeg$/);
+ expect(stored("coverImage")?.fileName).toMatch(/^example\.com-page-[0-9a-f]{8}\.jpg$/);
+ expect(result.image).toMatch(/^api\/attachments\/att\d+\/image\/example\.com-page-[0-9a-f]{8}\.jpg$/);
});
it("resolves a relative og:image against the page URL before downloading it", async () => {
@@ -306,7 +306,7 @@ describe("link-embed getMetadata", () => {
serveImage({ payload: await makePng(1024, 512, 0x00ff00ff), contentType: "image/png" });
const image = await imageOf();
- expect(image?.fileName).toMatch(/\.jpeg$/);
+ expect(image?.fileName).toMatch(/\.jpg$/);
const decoded = await Jimp.read(image?.buffer ?? Buffer.alloc(0));
expect(decoded.bitmap.width).toBe(256);
@@ -831,7 +831,7 @@ describe("link-embed getMetadata", () => {
// used either, and the thumbnail comes from the conventional hqdefault URL.
expect(result.title).toBeUndefined();
expect(result.description).toBeUndefined();
- expect(stored("coverImage")?.fileName).toMatch(/\.jpeg$/);
+ expect(stored("coverImage")?.fileName).toMatch(/\.jpg$/);
});
it("ignores meta tags whose content is empty, falling back to the document title", async () => {
diff --git a/packages/trilium-core/src/routes/api/notes.spec.ts b/packages/trilium-core/src/routes/api/notes.spec.ts
index 0bfa3ac838..1422d23cc3 100644
--- a/packages/trilium-core/src/routes/api/notes.spec.ts
+++ b/packages/trilium-core/src/routes/api/notes.spec.ts
@@ -1,9 +1,12 @@
-import { beforeAll, describe, expect, it, vi } from "vitest";
+import { afterAll, beforeAll, describe, expect, it, vi } from "vitest";
import becca from "../../becca/becca";
+import { load } from "../../becca/becca_loader";
+import { getContext } from "../../services/context";
import eraseService from "../../services/erase";
import noteService from "../../services/notes";
import { getSql } from "../../services/sql/index";
+import { registerVirtualNoteProvider, unregisterVirtualNoteProvider } from "../../services/virtual_notes";
import ws from "../../services/ws";
import { createTextNote } from "../../test/api_fixtures";
import { CoreApiTester } from "../../test/api_tester";
@@ -745,4 +748,27 @@ describe("Notes API (core)", () => {
expect(res.body.noteIdsToBeDeleted).toEqual([]);
});
});
+
+ describe("read-only virtual notes", () => {
+ beforeAll(() => {
+ registerVirtualNoteProvider({
+ namespace: "_vapi",
+ parentNoteId: "_hidden",
+ getSubtree: () => [{ id: "_vapiPage", title: "Page", type: "text" }],
+ getContent: () => "<p>shipped</p>"
+ });
+ getContext().init(() => load());
+ });
+
+ afterAll(() => {
+ unregisterVirtualNoteProvider("_vapi");
+ getContext().init(() => load());
+ });
+
+ it("refuses content and revision writes as a client error", async () => {
+ expect((await api.put("/api/notes/_vapiPage/data", { body: { content: "<p>edited</p>" } })).status).toBe(400);
+ expect((await api.post("/api/notes/_vapiPage/revision")).status).toBe(400);
+ expect(becca.getNoteOrThrow("_vapiPage").getContent()).toBe("<p>shipped</p>");
+ });
+ });
});
diff --git a/packages/trilium-core/src/routes/api/tree.spec.ts b/packages/trilium-core/src/routes/api/tree.spec.ts
index 9c33b754fa..65e95892d9 100644
--- a/packages/trilium-core/src/routes/api/tree.spec.ts
+++ b/packages/trilium-core/src/routes/api/tree.spec.ts
@@ -1,6 +1,9 @@
import { afterEach, beforeAll, describe, expect, it, vi } from "vitest";
import becca from "../../becca/becca";
+import { load } from "../../becca/becca_loader";
+import { getContext } from "../../services/context";
+import { registerVirtualNoteProvider, unregisterVirtualNoteProvider } from "../../services/virtual_notes";
import { createTextNote } from "../../test/api_fixtures";
import { CoreApiTester } from "../../test/api_tester";
@@ -53,6 +56,30 @@ describe("Tree API (core)", () => {
expect(res.body.notes.some((n) => n.noteId === "root")).toBe(true);
});
+ it("marks a note whose content cannot be saved, and only that note", async () => {
+ registerVirtualNoteProvider({
+ namespace: "_vtree",
+ parentNoteId: "_hidden",
+ getSubtree: () => [{ id: "_vtreePage", title: "Page", type: "text" }],
+ getContent: () => "<p>shipped</p>"
+ });
+ getContext().init(() => load());
+
+ try {
+ const res = await api.post<{ notes: { noteId: string; isContentWritable?: boolean }[] }>("/api/tree/load", {
+ body: { noteIds: [ "root", "_vtreePage" ] }
+ });
+ const byId = new Map(res.body.notes.map((note) => [ note.noteId, note ]));
+ expect(byId.get("_vtreePage")?.isContentWritable).toBe(false);
+ const root = byId.get("root");
+ expect(root).toBeTruthy();
+ expect(Object.hasOwn(root ?? {}, "isContentWritable")).toBe(false);
+ } finally {
+ unregisterVirtualNoteProvider("_vtree");
+ getContext().init(() => load());
+ }
+ });
+
describe("edge cases", () => {
afterEach(() => {
vi.restoreAllMocks();
diff --git a/packages/trilium-core/src/routes/api/tree.ts b/packages/trilium-core/src/routes/api/tree.ts
index b3fbecc1fe..1dc7f9bbe3 100644
--- a/packages/trilium-core/src/routes/api/tree.ts
+++ b/packages/trilium-core/src/routes/api/tree.ts
@@ -53,7 +53,7 @@ function getNotesAndBranchesAndAttributes(_noteIds: string[] | Set<string>) {
collectEntityIds(note);
}
- const notes: NoteRow[] = [];
+ const notes: (NoteRow & { isContentWritable?: false })[] = [];
for (const noteId of collectedNoteIds) {
const note = becca.notes[noteId];
@@ -64,7 +64,8 @@ function getNotesAndBranchesAndAttributes(_noteIds: string[] | Set<string>) {
isProtected: note.isProtected,
type: note.type,
mime: note.mime,
- blobId: note.blobId
+ blobId: note.blobId,
+ ...(note.isContentWritable() ? {} : { isContentWritable: false })
});
}
diff --git a/packages/trilium-core/src/services/app_info.spec.ts b/packages/trilium-core/src/services/app_info.spec.ts
index 6f51c72703..a247a26824 100644
--- a/packages/trilium-core/src/services/app_info.spec.ts
+++ b/packages/trilium-core/src/services/app_info.spec.ts
@@ -19,7 +19,7 @@ describe("app_info", () => {
it("exposes the fixed sync and clipper protocol versions", () => {
// These are protocol constants; bumping them is a deliberate,
// breaking change, so they are locked here as a regression guard.
- expect(appInfo.syncVersion).toBe(40);
+ expect(appInfo.syncVersion).toBe(41); // 41: in-app help notes became virtual (v242 migration)
expect(appInfo.clipperProtocolVersion).toBe("1.1");
});
diff --git a/packages/trilium-core/src/services/app_info.ts b/packages/trilium-core/src/services/app_info.ts
index 15bb29f9d6..0bb0a8ff80 100644
--- a/packages/trilium-core/src/services/app_info.ts
+++ b/packages/trilium-core/src/services/app_info.ts
@@ -3,7 +3,9 @@ import packageJson from "../../package.json" with { type: "json" };
import { AppInfo } from "@triliumnext/commons";
import { getMaxMigrationVersion } from "../migrations/migrations.js";
-const SYNC_VERSION = 40;
+// 41: in-app help notes became virtual (never persisted/synced); un-migrated peers would
+// still push _help entity changes, so they must upgrade before syncing.
+const SYNC_VERSION = 41;
const CLIPPER_PROTOCOL_VERSION = "1.1";
const appInfo: AppInfo = {
diff --git a/packages/trilium-core/src/services/blob.ts b/packages/trilium-core/src/services/blob.ts
index 518cc22d82..1c15720369 100644
--- a/packages/trilium-core/src/services/blob.ts
+++ b/packages/trilium-core/src/services/blob.ts
@@ -5,7 +5,9 @@ import { getLog } from "./log.js";
import protectedSessionService from "./protected_session.js";
import { getSql } from "./sql/index.js";
import { decodeUtf8 } from "./utils/binary.js";
-import { hash, isStringNote } from "./utils/index.js";
+import dateUtils from "./utils/date.js";
+import { hash, hashedBlobId, isStringNote } from "./utils/index.js";
+import { getVirtualNoteContent } from "./virtual_notes.js";
function getBlobPojo(entityName: string, entityId: string, opts?: { preview: boolean }) {
// TODO: Unused opts.
@@ -14,6 +16,10 @@ function getBlobPojo(entityName: string, entityId: string, opts?: { preview: boo
throw new NotFoundError(`Entity ${entityName} '${entityId}' was not found.`);
}
+ if (entity.isVirtual) {
+ return virtualBlobPojo(entityId);
+ }
+
const blob = becca.getBlob(entity);
if (!blob) {
throw new NotFoundError(`Blob ${entity.blobId} for ${entityName} '${entityId}' was not found.`);
@@ -40,6 +46,30 @@ function getBlobPojo(entityName: string, entityId: string, opts?: { preview: boo
return { ...pojo, isStubbed };
}
+/**
+ * Produces a blob POJO for a virtual note. Virtual notes have no `blobs` row — their content comes
+ * from the provider that injected them (see `services/virtual_notes.ts`) — so the POJO is derived
+ * on the fly. The blobId is hashed from the content exactly as the persisted path does, so the
+ * client caches and change-detects it the same way, and an empty page still yields
+ * {@link EMPTY_BLOB_ID} rather than looking like a withheld sync stub.
+ */
+function virtualBlobPojo(noteId: string) {
+ const content = getVirtualNoteContent(noteId);
+ const isString = typeof content === "string";
+
+ return {
+ blobId: hashedBlobId(content),
+ // Binary content follows the persisted path, which hands the caller null and lets it fetch
+ // the bytes through the dedicated route instead.
+ content: isString ? content : null,
+ contentLength: content.length,
+ textRepresentation: null,
+ dateModified: dateUtils.localNowDateTime(),
+ utcDateModified: dateUtils.utcNowDateTime(),
+ isStubbed: false
+ };
+}
+
/**
* Produces a blob POJO for a soft-deleted (not-yet-erased) note. The normal {@link getBlobPojo}
* path resolves the note through Becca, which never contains deleted notes — so this reads the
diff --git a/packages/trilium-core/src/services/consistency_checks.spec.ts b/packages/trilium-core/src/services/consistency_checks.spec.ts
index 85c4bc10a8..d4e14cd262 100644
--- a/packages/trilium-core/src/services/consistency_checks.spec.ts
+++ b/packages/trilium-core/src/services/consistency_checks.spec.ts
@@ -1,10 +1,14 @@
-import { describe, expect, it } from "vitest";
+import { afterAll, beforeAll, describe, expect, it } from "vitest";
import { getContext } from "./context.js";
import { getSql } from "./sql/index.js";
import consistency_checks from "./consistency_checks.js";
import syncOptions from "./sync_options.js";
import optionsService from "./options.js";
+import noteService from "./notes.js";
+import { registerVirtualNoteProvider, unregisterVirtualNoteProvider } from "./virtual_notes.js";
+import becca from "../becca/becca.js";
import becca_loader from "../becca/becca_loader.js";
+import BAttribute from "../becca/entities/battribute.js";
let testCounter = 0;
@@ -152,6 +156,74 @@ describe("Consistency checks during partial sync", () => {
});
});
+describe("Consistency checks and virtual notes", () => {
+ beforeAll(() => {
+ registerVirtualNoteProvider({
+ namespace: "_vcc",
+ parentNoteId: "_hidden",
+ getSubtree: () => [{ id: "_vccPage", title: "Virtual page", type: "text" }]
+ });
+ getContext().init(() => becca_loader.load());
+ });
+
+ afterAll(() => {
+ unregisterVirtualNoteProvider("_vcc");
+ getContext().init(() => becca_loader.load());
+ });
+
+ function createNote(title: string) {
+ return noteService.createNewNote({ parentNoteId: "root", title, content: "", type: "text" }).note.noteId;
+ }
+
+ /** Persisted relation to `targetNoteId`, as `scanForLinks` creates for a reference link. */
+ function linkTo(sourceNoteId: string, targetNoteId: string) {
+ return new BAttribute({
+ noteId: sourceNoteId,
+ type: "relation",
+ name: "internalLink",
+ value: targetNoteId
+ }).save().attributeId;
+ }
+
+ function isRelationAlive(attributeId: string) {
+ return !!getSql().getValue("SELECT attributeId FROM attributes WHERE attributeId = ? AND isDeleted = 0", [attributeId]);
+ }
+
+ it("keeps relations targeting virtual notes, while still deleting genuinely broken ones", async () => {
+ await getContext().init(async () => {
+ setOption("syncServerHost", "");
+ setOption("syncIncomplete", "false");
+
+ // A virtual note exists in becca but deliberately never in the `notes` table, so a
+ // relation pointing at one looks broken to every SQL-level existence check.
+ expect(becca.getNote("_vccPage")?.isVirtual).toBe(true);
+ expect(getSql().getValue("SELECT noteId FROM notes WHERE noteId = '_vccPage'")).toBeFalsy();
+
+ const sourceNoteId = createNote("note linking into the virtual subtree");
+ const virtualLinkId = linkTo(sourceNoteId, "_vccPage");
+
+ // A relation to a note that is simply gone — `BAttribute.validate()` refuses to create
+ // one, so it has to be planted the way sync does: straight into the table.
+ const brokenLinkId = "brokenLink___";
+ getSql().execute(
+ `INSERT INTO attributes (attributeId, noteId, type, name, value, position, utcDateModified, isDeleted, isInheritable)
+ VALUES (?, ?, 'relation', 'internalLink', 'MISSING_TARGET', 10, '2026-01-01 00:00:00Z', 0, 0)`,
+ [brokenLinkId, sourceNoteId]
+ );
+ becca_loader.reload("plant broken relation");
+
+ await consistency_checks.runOnDemandChecks(true);
+
+ expect(isRelationAlive(virtualLinkId)).toBe(true);
+ expect(isRelationAlive(brokenLinkId)).toBe(false);
+
+ // ...and the surviving relation keeps its becca backlink, so backlinks and link maps still resolve
+ expect(becca.getAttribute(virtualLinkId)).toBeTruthy();
+ expect(becca.getNoteOrThrow("_vccPage").targetRelations.some((rel) => rel.attributeId === virtualLinkId)).toBe(true);
+ });
+ });
+});
+
describe("Notes without a usable branch", () => {
it("should recover notes with no branch and notes whose branches are all deleted", async () => {
diff --git a/packages/trilium-core/src/services/consistency_checks.ts b/packages/trilium-core/src/services/consistency_checks.ts
index 765d487e44..13886cf8c3 100644
--- a/packages/trilium-core/src/services/consistency_checks.ts
+++ b/packages/trilium-core/src/services/consistency_checks.ts
@@ -13,6 +13,7 @@ import optionsService from "./options.js";
import { getSql } from "./sql/index.js";
import sqlInit from "./sql_init.js";
import syncMutexService from "./sync_mutex.js";
+import { getVirtualNoteProvider } from "./virtual_notes.js";
import ws from "./ws.js";
import { default as eraseService } from "./erase.js";
import becca_loader from "../becca/becca_loader.js";
@@ -34,9 +35,13 @@ class ConsistencyChecks {
this.reloadNeeded = false;
}
- findAndFixIssues(query: string, fixerCb: (res: any) => void) {
+ /**
+ * @param isExempt - rows it accepts are not issues at all: they are dropped before the fixer
+ * runs, so they neither get "fixed" nor counted as unrecovered errors.
+ */
+ findAndFixIssues(query: string, fixerCb: (res: any) => void, isExempt?: (res: any) => boolean) {
const sql = getSql();
- const results = sql.getRows(query);
+ const results = sql.getRows(query).filter((res) => !isExempt?.(res));
for (const res of results) {
try {
@@ -250,7 +255,15 @@ class ConsistencyChecks {
} else {
logError(`Relation '${attributeId}' references missing note '${noteId}'`);
}
- }
+ },
+ // Virtual notes (the in-app help, …) live only in becca and are deliberately never
+ // written to the `notes` table, so a relation pointing at one — the `~internalLink` a
+ // reference link to a help page produces, say — looks broken to a check done in SQL.
+ // Such relations are legitimate, so their whole namespace is exempt. The test is the
+ // registered namespace rather than becca's contents: a provider may not have injected
+ // its subtree at check time, and deleting the user's relations over that would be
+ // irreversible and would propagate through sync.
+ ({ noteId }) => !!getVirtualNoteProvider(noteId)
);
this.findAndFixIssues(
diff --git a/packages/trilium-core/src/services/export/single.spec.ts b/packages/trilium-core/src/services/export/single.spec.ts
index 0c3f0ae829..b32fe8dd7b 100644
--- a/packages/trilium-core/src/services/export/single.spec.ts
+++ b/packages/trilium-core/src/services/export/single.spec.ts
@@ -8,6 +8,7 @@ import type BNote from "../../becca/entities/bnote.js";
import type { ExportFormat } from "../../meta.js";
import TaskContext from "../task_context.js";
import { buildNote } from "../../test/becca_easy_mocking.js";
+import { registerVirtualNoteProvider, unregisterVirtualNoteProvider } from "../virtual_notes.js";
import singleExportService, { mapByNoteType } from "./single.js";
describe("Note type mappings", () => {
@@ -254,24 +255,56 @@ describe("exportSingleNote", () => {
return { result: singleExportService.exportSingleNote(taskContext, branch, format as ExportFormat, res), res };
}
- it("writes the mapped payload and download headers for a supported note", () => {
+ it("writes the mapped payload and download headers for a supported note", async () => {
const note = buildNote({ type: "code", mime: "text/x-markdown", title: "script" });
vi.spyOn(note, "getContent").mockReturnValue("# hi");
- const { res } = exportNote(note, "html");
+ const { result, res } = exportNote(note, "html");
+ await result;
expect(res.setHeader).toHaveBeenCalledWith("Content-Disposition", expect.stringContaining("script.md"));
expect(res.setHeader).toHaveBeenCalledWith("Content-Type", "text/x-markdown; charset=UTF-8");
expect(res.send).toHaveBeenCalledWith("# hi");
});
- it("throws a ValidationError for note types and formats it cannot export", () => {
+ it("inlines the pictures and files of a virtual note, which exist only behind its provider", async () => {
+ registerVirtualNoteProvider({
+ namespace: "_vsingle",
+ parentNoteId: "_hidden",
+ getSubtree: () => [],
+ getAssets: () => [
+ { id: "a1", url: "assets/v1/vsingle/pic.png", title: "pic.png", mime: "image/png", getContent: async () => new Uint8Array([ 1, 2, 3 ]) },
+ { id: "a2", url: "assets/v1/vsingle/data.dat", title: "data.dat", mime: "application/octet-stream", getContent: async () => new Uint8Array([ 4, 5 ]) },
+ { id: "a3", url: "assets/v1/vsingle/gone.png", title: "gone.png", mime: "image/png", getContent: async () => null }
+ ]
+ });
+
+ try {
+ const note = buildNote({
+ id: "_vsinglePage", type: "text", title: "Page",
+ content: `<img src="assets/v1/vsingle/pic.png"><a href="assets/v1/vsingle/data.dat">data</a><img src="assets/v1/vsingle/gone.png">`
+ });
+ note.isVirtual = true;
+
+ const { result, res } = exportNote(note, "html");
+ await result;
+
+ const payload = String(vi.mocked(res.send).mock.calls[0][0]);
+ expect(payload).toContain(`src="data:image/png;base64,AQID"`);
+ expect(payload).toContain(`href="data:application/octet-stream;base64,BAU=" download="data.dat"`);
+ expect(payload).toContain(`src="assets/v1/vsingle/gone.png"`);
+ } finally {
+ unregisterVirtualNoteProvider("_vsingle");
+ }
+ });
+
+ it("throws a ValidationError for note types and formats it cannot export", async () => {
// A returned [status, body] tuple used to be dropped on the floor by the route, leaving the
// request unanswered; throwing an HttpError is what actually reaches the client.
for (const type of ["image", "file"] as const) {
const note = buildNote({ type, title: "Binary" });
- expect(() => exportNote(note, "html")).toThrow(
+ await expect(exportNote(note, "html").result).rejects.toThrow(
expect.objectContaining({
name: "ValidationError",
statusCode: 400,
@@ -280,7 +313,7 @@ describe("exportSingleNote", () => {
);
}
- expect(() => exportNote(buildNote({ type: "text", title: "Texty" }), "pdf")).toThrow(
+ await expect(exportNote(buildNote({ type: "text", title: "Texty" }), "pdf").result).rejects.toThrow(
expect.objectContaining({ name: "ValidationError", statusCode: 400, message: "Unrecognized format 'pdf'" })
);
});
diff --git a/packages/trilium-core/src/services/export/single.ts b/packages/trilium-core/src/services/export/single.ts
index 9804007a08..d6586738ca 100644
--- a/packages/trilium-core/src/services/export/single.ts
+++ b/packages/trilium-core/src/services/export/single.ts
@@ -14,8 +14,9 @@ import mdService from "./markdown.js";
import { stripListItemIds } from "./strip_list_item_ids.js";
import { ExportFormat } from "../../meta.js";
import { encodeBase64 } from "../utils/binary.js";
+import { getVirtualNoteAssets, type VirtualNoteAsset } from "../virtual_notes.js";
-function exportSingleNote(taskContext: TaskContext<"export">, branch: BBranch, format: ExportFormat, res: Response) {
+async function exportSingleNote(taskContext: TaskContext<"export">, branch: BBranch, format: ExportFormat, res: Response) {
const note = branch.getNote();
// These are thrown rather than returned: the export route writes straight to `res` and has no
@@ -30,7 +31,12 @@ function exportSingleNote(taskContext: TaskContext<"export">, branch: BBranch, f
throw new ValidationError(`Unrecognized format '${format}'`);
}
- const { payload, extension, mime } = mapByNoteType(note, note.getContent(), format);
+ let content = note.getContent();
+ if (note.isVirtual && typeof content === "string") {
+ content = await inlineVirtualAssets(content, getVirtualNoteAssets(note.noteId));
+ }
+
+ const { payload, extension, mime } = mapByNoteType(note, content, format);
const fileName = `${note.title}.${extension}`;
res.setHeader("Content-Disposition", getContentDisposition(fileName));
@@ -174,6 +180,26 @@ function inlineAttachments(content: string) {
return content;
}
+/**
+ * Replaces the URLs a virtual note's content points at with `data:` URIs, since those files exist
+ * only behind the note's provider. An asset that cannot be read keeps its URL.
+ */
+async function inlineVirtualAssets(content: string, assets: VirtualNoteAsset[]) {
+ for (const asset of assets) {
+ const bytes = await asset.getContent();
+ if (!bytes) {
+ continue;
+ }
+
+ const dataUri = `data:${asset.mime};base64,${encodeBase64(bytes)}`;
+ content = content
+ .replaceAll(`src="${asset.url}"`, `src="${dataUri}"`)
+ .replaceAll(`href="${asset.url}"`, `href="${dataUri}" download="${escapeHtml(asset.title)}"`);
+ }
+
+ return content;
+}
+
export default {
exportSingleNote
};
diff --git a/packages/trilium-core/src/services/export/zip.spec.ts b/packages/trilium-core/src/services/export/zip.spec.ts
index d1cca4ad83..affcc3cfd8 100644
--- a/packages/trilium-core/src/services/export/zip.spec.ts
+++ b/packages/trilium-core/src/services/export/zip.spec.ts
@@ -7,6 +7,7 @@ import { afterAll, beforeAll, describe, expect, it } from "vitest";
import { isLocalPreviewImageSrc } from "@triliumnext/commons";
import becca from "../../becca/becca.js";
+import becca_loader from "../../becca/becca_loader.js";
import type BBranch from "../../becca/entities/bbranch.js";
import type BNote from "../../becca/entities/bnote.js";
import type { ExportFormat, NoteMetaFile } from "../../meta.js";
@@ -14,6 +15,7 @@ import { getContext } from "../context.js";
import noteService from "../notes.js";
import sql_init from "../sql_init.js";
import { decodeUtf8 } from "../utils/binary.js";
+import { registerVirtualNoteProvider, unregisterVirtualNoteProvider } from "../virtual_notes.js";
import type { ZipArchive, ZipArchiveEntryOptions, ZipProvider } from "../zip_provider.js";
import { getZipProvider, initZipProvider } from "../zip_provider.js";
import zip, { shouldStoreUncompressed } from "./zip.js";
@@ -380,6 +382,45 @@ describe.skipIf(isBrowserRuntime)("zip export (real DB)", () => {
expect(entries[attFileName]).toBeDefined();
});
+ it("names a converted image after its mime, not after the title it was uploaded under", async () => {
+ // Uploading a PNG with compression on stores JPEG bytes under the name the upload
+ // arrived with: the mime follows the conversion, the title deliberately does not.
+ // The export is the last point at which the file name can still describe the bytes.
+ //
+ // This is the shape of the 51 mislabelled files in docs/User Guide — JPEGs written
+ // to a .png name, each one recorded as image/jpg in the meta beside it.
+ const { note } = createNote("root", { title: "ConvertedImageHost", content: "<p>host</p>" });
+ const jpegBytes = Buffer.from([0xff, 0xd8, 0xff, 0xe0, 0x00, 0x10, 0x4a, 0x46]);
+ getContext().init(() =>
+ note.saveAttachment({ role: "image", mime: "image/jpg", title: "image.png", content: jpegBytes })
+ );
+ const branch = note.getParentBranches()[0];
+
+ const { entries } = await exportSubtree(branch, "markdown");
+ const rootMeta = parseMeta(entries).files[0];
+
+ // Named exactly, not merely ending in the right thing: the extension replaces the one
+ // the title carried rather than being appended to it, and "image.png.jpg" would pass
+ // any check that only looked at how the name ends.
+ const attFileName = (rootMeta.attachments ?? [])[0]?.dataFileName ?? "";
+ expect(attFileName).toBe("ConvertedImageHost_image.jpg");
+ // The renamed file is the one actually written, and its bytes are the JPEG's.
+ expect(entries[attFileName]).toBeDefined();
+ expect(Buffer.compare(entries[attFileName], jpegBytes)).toBe(0);
+ });
+
+ it("keeps a dotted title whole when the extension is added rather than substituted", async () => {
+ // `extname` reads "v0.48" as ending in ".48", and a release note is called exactly that.
+ // Only a picture's extension is replaced; anywhere else the name is left alone and the
+ // new extension is appended, so this must not export as "v0.md".
+ const { note } = createNote("root", { title: "v0.48", content: "<p>changelog</p>" });
+ const branch = note.getParentBranches()[0];
+
+ const { entries } = await exportSubtree(branch, "markdown");
+
+ expect(parseMeta(entries).files[0].dataFileName).toBe("v0.48.md");
+ });
+
it("round-trips binary attachment content byte-for-byte", async () => {
const { note } = createNote("root", { title: "BinaryAttachHost", content: "<p>host</p>" });
// Bytes that are not valid UTF-8 (0x00, 0xFF, lone 0x80 continuation byte)
@@ -514,6 +555,80 @@ describe.skipIf(isBrowserRuntime)("zip export (real DB)", () => {
}
});
+ it("exports a virtual subtree as a copy that imports with its pictures, files and links", async () => {
+ const picture = new Uint8Array([ 0x89, 0x50, 0x4e, 0x47, 1, 2, 3 ]);
+ const file = new Uint8Array([ 7, 8, 9 ]);
+ registerVirtualNoteProvider({
+ namespace: "_vzip",
+ parentNoteId: "_hidden",
+ getSubtree: () => [{
+ id: "_vzipGuide", title: "Guide", type: "book",
+ attributes: [{ type: "label", name: "readOnly", value: "", isInheritable: true }],
+ children: [
+ { id: "_vzipPage", title: "Page", type: "text" },
+ { id: "_vzipOther", title: "Other", type: "text" }
+ ]
+ }],
+ getContent: (noteId) => (noteId === "_vzipPage"
+ ? `<p><img src="assets/v1/vzip/My%20picture.png"></p>`
+ + `<p><a href="assets/v1/vzip/data.dat">data</a></p>`
+ + `<p><a class="reference-link" href="#root/_vzipOther">Other</a></p>`
+ : "<p>other</p>"),
+ getAssets: (noteId) => (noteId === "_vzipPage"
+ ? [
+ { id: "_vzipPage_a1", url: "assets/v1/vzip/My%20picture.png", title: "My picture.png", mime: "image/png", getContent: async () => picture },
+ { id: "_vzipPage_a2", url: "assets/v1/vzip/data.dat", title: "data.dat", mime: "application/octet-stream", getContent: async () => file }
+ ]
+ : [])
+ });
+
+ try {
+ getContext().init(() => becca_loader.load());
+ const taskContext = (await import("../task_context.js")).default;
+ const importZip = (await import("../import/zip.js")).default;
+
+ for (const format of [ "html", "markdown" ] as const) {
+ const { buffer, entries } = await exportSubtree(becca.getBranchOrThrow("_hidden__vzipGuide"), format);
+ const guideMeta = parseMeta(entries).files[0];
+ const pageMeta = guideMeta.children?.find((child) => child.noteId === "_vzipPage");
+ const attachmentFile = (title: string) => pageMeta?.attachments?.find((a) => a.title === title)?.dataFileName;
+ expect(new Uint8Array(entries[`Guide/${attachmentFile("My picture.png")}`]), format).toEqual(picture);
+ expect(new Uint8Array(entries[`Guide/${attachmentFile("data.dat")}`]), format).toEqual(file);
+
+ const pageFile = entries[`Guide/${pageMeta?.dataFileName}`].toString("utf-8");
+ expect(pageFile, format).not.toContain("assets/v1/vzip");
+ // Markdown percent-encodes the file name; HTML writes it as it is.
+ const pictureFile = String(attachmentFile("My picture.png"));
+ expect([ pictureFile, encodeURIComponent(pictureFile) ].some((name) => pageFile.includes(name)), format).toBe(true);
+
+ const guide = await getContext().init(async () => await importZip.importZip(
+ new taskContext("no-progress-reporting", "importNotes", {}),
+ buffer,
+ becca.getNoteOrThrow("root")
+ ));
+
+ const [ page, other ] = [ "Page", "Other" ].map((title) => guide.getChildNotes().find((n) => n.title === title));
+ expect(guide.isVirtual || page?.isVirtual, format).toBeFalsy();
+ const pictureCopy = page?.getAttachments().find((a) => a.title === "My picture.png");
+ const fileCopy = page?.getAttachments().find((a) => a.title === "data.dat");
+ expect(new Uint8Array(pictureCopy?.getContent() as Uint8Array), format).toEqual(picture);
+ expect(new Uint8Array(fileCopy?.getContent() as Uint8Array), format).toEqual(file);
+
+ const content = page?.getContent().toString();
+ expect(content, format).toContain(`src="api/attachments/${pictureCopy?.attachmentId}/image/`);
+ expect(content, format).toContain(`attachmentId=${fileCopy?.attachmentId}`);
+ expect(content, format).toContain(`href="#root/${other?.noteId}"`);
+
+ // The copy is the user's own: it saves like any other note.
+ getContext().init(() => page?.setContent("<p>edited</p>"));
+ expect(page?.getContent(), format).toBe("<p>edited</p>");
+ }
+ } finally {
+ unregisterVirtualNoteProvider("_vzip");
+ getContext().init(() => becca_loader.load());
+ }
+ });
+
it("pipes the archive to the response before appending any content", async () => {
// Memory efficiency: the archive must start streaming to the response
// before note/attachment content is appended, so blobs drain to the
diff --git a/packages/trilium-core/src/services/export/zip.ts b/packages/trilium-core/src/services/export/zip.ts
index c7f3d902f6..bc93d8899c 100644
--- a/packages/trilium-core/src/services/export/zip.ts
+++ b/packages/trilium-core/src/services/export/zip.ts
@@ -1,4 +1,4 @@
-import { getImageAttachmentTitle, NoteType } from "@triliumnext/commons";
+import { getImageAttachmentTitle, imageMimeForExtension, isAcceptedImageMime, NoteType } from "@triliumnext/commons";
import mimeTypes from "mime-types";
import sanitize from "sanitize-filename";
@@ -22,6 +22,7 @@ import { extname } from "../utils/path";
import { truncateUtf8Bytes } from "../utils/binary";
import { rewriteMarkdownContentLinks, isMarkdownCodeNote } from "./rewrite_links.js";
import { stripListItemIds } from "./strip_list_item_ids.js";
+import { getVirtualNoteAssets, referenceAssetsAsAttachments, type VirtualNoteAsset } from "../virtual_notes.js";
// Most filesystems cap a single path component at 255 bytes; keep exported file names within that.
const MAX_FILENAME_BYTES = 255;
@@ -42,6 +43,8 @@ async function exportToZip(taskContext: TaskContext<"export">, branch: BBranch,
const noteIdToMeta: Record<string, NoteMeta> = {};
/** The file holding the content of an image or file note in a share export, beside its page. */
const noteIdToRawFileName: Record<string, string> = {};
+ /** The files a virtual note's content links to, exported as attachments of that note. */
+ const noteIdToVirtualAssets: Record<string, VirtualNoteAsset[]> = {};
async function buildProvider() {
const providerData: ZipExportProviderData = {
@@ -97,7 +100,8 @@ async function exportToZip(taskContext: TaskContext<"export">, branch: BBranch,
// name so the whole entry (extension included) stays within the 255-byte
// filesystem limit without ever chopping the extension off long / multi-byte
// titles and attachment names. This replaces the old arbitrary 30-char cap.
- const base = truncateUtf8Bytes(sanitize(fileName), MAX_FILENAME_BYTES - extension.length);
+ const named = dropReplacedPictureExtension(fileName, existingExtension, newExtension);
+ const base = truncateUtf8Bytes(sanitize(named), MAX_FILENAME_BYTES - extension.length);
return getUniqueFilename(existingFileNames, `${base}${extension}`);
}
@@ -216,6 +220,21 @@ async function exportToZip(taskContext: TaskContext<"export">, branch: BBranch,
return attMeta;
});
+ if (note.isVirtual) {
+ const assets = getVirtualNoteAssets(note.noteId);
+ noteIdToVirtualAssets[note.noteId] = assets;
+ for (const [index, asset] of assets.entries()) {
+ meta.attachments.push({
+ attachmentId: asset.id,
+ title: asset.title,
+ role: asset.mime.startsWith("image/") ? "image" : "file",
+ mime: asset.mime,
+ position: (index + 1) * 10,
+ dataFileName: getDataFileName(null, asset.mime, `${baseFileName}_${asset.title}`, existingFileNames)
+ });
+ }
+ }
+
if (childBranches.length > 0) {
meta.dirFileName = getUniqueFilename(existingFileNames, baseFileName);
meta.children = [];
@@ -365,6 +384,10 @@ async function exportToZip(taskContext: TaskContext<"export">, branch: BBranch,
content = stripListItemIds(content);
}
+ if (note?.isVirtual && typeof content === "string") {
+ content = referenceAssetsAsAttachments(note.noteId, content, noteIdToVirtualAssets[note.noteId] ?? []);
+ }
+
content = provider.prepareContent(title, content, noteMeta, note, branch);
// Rewrite markdown-style links for code notes with markdown MIME.
@@ -436,11 +459,17 @@ async function exportToZip(taskContext: TaskContext<"export">, branch: BBranch,
continue;
}
- const attachment = note.getAttachmentById(attachmentMeta.attachmentId);
+ const asset = noteIdToVirtualAssets[note.noteId]?.find((a) => a.id === attachmentMeta.attachmentId);
// getContent() already returns a string or a Uint8Array; the binary
// case can be appended as-is (the zip provider handles the Buffer
// conversion), so avoid an extra full copy of the blob here.
- const content = attachment.getContent();
+ const content = asset
+ ? await asset.getContent()
+ : note.getAttachmentById(attachmentMeta.attachmentId).getContent();
+ if (content === null) {
+ log.info(`Could not read asset '${attachmentMeta.title}' of virtual note '${note.noteId}', leaving it out of the export.`);
+ continue;
+ }
archive.append(content, {
name: filePathPrefix + attachmentMeta.dataFileName,
@@ -653,6 +682,33 @@ export function shouldStoreUncompressed(mime: string | undefined | null): boolea
return ALREADY_COMPRESSED.has(m) || isZipBasedContainer(m);
}
+/**
+ * The name with the extension the new one is about to replace taken off it, where that is what is
+ * happening — otherwise the name unchanged.
+ *
+ * A picture is the one thing whose extension gets *substituted* rather than added to: an image
+ * converted to JPEG on upload keeps a `.png` title, and the export renames it. Appending there
+ * produces `image.png.jpg`.
+ *
+ * Everywhere else the extension is only ever added to a name that had none of its own, and taking
+ * a trailing dot-suffix off would do real damage: `extname` reads "v0.48" as ending in ".48", so a
+ * release note by that name would export as "v0.md". Restricting this to a picture replacing a
+ * picture is what keeps a suffix that merely looks like an extension out of reach — the check is
+ * against the media types those extensions name, not against the text.
+ */
+function dropReplacedPictureExtension(fileName: string, existingExtension: string, newExtension: string | null): string {
+ if (!existingExtension || !newExtension || !namesPicture(existingExtension) || !namesPicture(newExtension)) {
+ return fileName;
+ }
+
+ return fileName.slice(0, -existingExtension.length);
+}
+
+/** Whether an extension is one a picture is written with, dotted or not. */
+function namesPicture(extension: string): boolean {
+ return !!extension && isAcceptedImageMime(imageMimeForExtension(extension));
+}
+
// Office / e-book / package formats that are ZIP containers under the hood.
function isZipBasedContainer(mime: string): boolean {
return (
diff --git a/packages/trilium-core/src/services/export/zip/abstract_provider.spec.ts b/packages/trilium-core/src/services/export/zip/abstract_provider.spec.ts
index d93fe9be17..076a66380e 100644
--- a/packages/trilium-core/src/services/export/zip/abstract_provider.spec.ts
+++ b/packages/trilium-core/src/services/export/zip/abstract_provider.spec.ts
@@ -89,15 +89,50 @@ describe("ZipExportProvider", () => {
expect(provider.mapExtension("file", "application/json", "", "html")).toBe("json");
});
- it("preserves an existing extension (returns null) ahead of jpg/mermaid/fallback handling", () => {
- // existingExtension is checked before the jpg/mermaid special cases,
- // so a set extension short-circuits even for those mimes.
+ it("preserves an existing extension (returns null) ahead of mermaid/fallback handling", () => {
+ // existingExtension is checked before the mermaid special case, so a set extension
+ // short-circuits even for that mime.
expect(provider.mapExtension("image", "image/png", ".png", "html")).toBeNull();
expect(provider.mapExtension("image", "image/jpg", ".jpeg", "html")).toBeNull();
expect(provider.mapExtension("code", "text/mermaid", ".mmd", "html")).toBeNull();
});
- it("normalises image/jpg and text/mermaid special cases when no extension exists", () => {
+ it("names an image from its mime where the existing extension contradicts it", () => {
+ // An image converted on upload keeps the title it arrived under — attachments are
+ // deliberately never renamed, since a canvas addresses its images by title — while
+ // its mime follows the bytes. The file name is the only thing left that can still
+ // describe them, so where the two disagree the mime is the one that saw the bytes.
+ //
+ // Trusting the title instead is what put 51 JPEGs under a .png name in
+ // docs/User Guide, every one of them recorded as image/jpg in !!!meta.json.
+ expect(provider.mapExtension("image", "image/jpeg", ".png", "markdown")).toBe("jpg");
+ expect(provider.mapExtension("image", "image/jpg", ".png", "markdown")).toBe("jpg");
+ expect(provider.mapExtension("image", "image/png", ".jpg", "html")).toBe("png");
+ expect(provider.mapExtension("image", "image/webp", ".png", "html")).toBe("webp");
+ expect(provider.mapExtension("image", "image/gif", ".PNG", "html")).toBe("gif");
+ });
+
+ it("keeps an extension that already names the mime's format, whatever its spelling", () => {
+ // Only a genuine disagreement is worth renaming over: correcting ".jpeg" to ".jpg"
+ // churns file names across an export for no gain, and the case of an extension
+ // carries no meaning at all.
+ expect(provider.mapExtension("image", "image/jpeg", ".jpg", "html")).toBeNull();
+ expect(provider.mapExtension("image", "image/jpg", ".jpeg", "html")).toBeNull();
+ expect(provider.mapExtension("image", "image/png", ".PNG", "html")).toBeNull();
+ expect(provider.mapExtension("image", "image/svg+xml", ".svg", "html")).toBeNull();
+ expect(provider.mapExtension("image", "image/x-icon", ".ico", "html")).toBeNull();
+ });
+
+ it("leaves a non-image extension alone, having nothing better to offer than the title", () => {
+ // The correction is scoped to pictures, where the mime is authoritative about the
+ // encoding. Elsewhere the title is usually the more informative of the two: a
+ // mermaid source is better named .mmd than the .txt its mime maps to.
+ expect(provider.mapExtension("code", "text/mermaid", ".mmd", "html")).toBeNull();
+ expect(provider.mapExtension("file", "application/pdf", ".bak", "html")).toBeNull();
+ expect(provider.mapExtension("file", "application/totally-unknown", ".bin", "html")).toBeNull();
+ });
+
+ it("reads a media type however it was written when no extension exists", () => {
expect(provider.mapExtension("image", "image/jpg", "", "html")).toBe("jpg");
expect(provider.mapExtension("image", " IMAGE/JPG ", "", "html")).toBe("jpg");
expect(provider.mapExtension("code", "text/mermaid", "", "html")).toBe("txt");
diff --git a/packages/trilium-core/src/services/export/zip/abstract_provider.ts b/packages/trilium-core/src/services/export/zip/abstract_provider.ts
index ce20d1886a..3aa7fd06af 100644
--- a/packages/trilium-core/src/services/export/zip/abstract_provider.ts
+++ b/packages/trilium-core/src/services/export/zip/abstract_provider.ts
@@ -1,4 +1,4 @@
-import { NoteType } from "@triliumnext/commons";
+import { imageExtensionForMime, imageMimeForExtension, isAcceptedImageMime, NoteType } from "@triliumnext/commons";
import mimeTypes from "mime-types";
import type BBranch from "../../../becca/entities/bbranch.js";
@@ -74,13 +74,33 @@ export abstract class ZipExportProvider {
return "js";
} else if (type === "canvas" || mime === "application/json") {
return "json";
- } else if (existingExtension.length > 0) {
- // if the page already has an extension, then we'll just keep it
+ }
+
+ const pictureExtension = pictureExtensionFor(mime);
+
+ if (pictureExtension) {
+ // A picture is named after its media type rather than after its title, that being the
+ // only way round which survives the upload having converted it. An image compressed
+ // from PNG to JPEG keeps the title it arrived under — an attachment is never renamed,
+ // a canvas addressing its images by title being the reason — while its mime follows
+ // the new bytes. Take the title's word for it and a JPEG is written to a `.png` name,
+ // which every reader downstream then believes.
+ //
+ // Only a real disagreement is worth renaming over: `.jpg` and `.jpeg` are one format
+ // under either spelling of the media type, and the case of an extension means nothing.
+ const titleExtension = existingExtension && pictureExtensionFor(imageMimeForExtension(existingExtension));
+
+ return titleExtension === pictureExtension ? null : pictureExtension;
+ }
+
+ if (existingExtension.length > 0) {
+ // Outside pictures the title tends to be the better informed of the two, so it keeps
+ // the last word: a mermaid source is named `.mmd` far more usefully than the `.txt`
+ // its media type maps to.
return null;
}
- if (mime?.toLowerCase()?.trim() === "image/jpg") {
- return "jpg";
- } else if (mime?.toLowerCase()?.trim() === "text/mermaid") {
+
+ if (mime?.toLowerCase()?.trim() === "text/mermaid") {
return "txt";
}
return mapCodeMimeToExtension(mime) || mimeTypes.extension(mime) || "dat";
@@ -89,3 +109,15 @@ export abstract class ZipExportProvider {
}
}
+
+/**
+ * The extension a picture of this media type is written with, or null where it is not a picture.
+ *
+ * Trims and lowercases first, so the reading survives a media type stored untidily, and answers
+ * for one spelling of a format exactly as it does for the other.
+ */
+function pictureExtensionFor(mime: string): string | null {
+ const normalized = mime?.trim().toLowerCase() ?? "";
+
+ return isAcceptedImageMime(normalized) ? imageExtensionForMime(normalized) : null;
+}
diff --git a/packages/trilium-core/src/services/hidden_subtree.spec.ts b/packages/trilium-core/src/services/hidden_subtree.spec.ts
index 5414e738a5..9ebac3b671 100644
--- a/packages/trilium-core/src/services/hidden_subtree.spec.ts
+++ b/packages/trilium-core/src/services/hidden_subtree.spec.ts
@@ -52,8 +52,10 @@ describe("hidden_subtree (real DB)", () => {
expect(hidden.getParentBranches().some((b) => b.parentNoteId === "root")).toBe(true);
// A representative set of the declared children must exist and sit
- // directly under _hidden.
- for (const childId of ["_search", "_options", "_help", "_taskStates", "_lbRoot"]) {
+ // directly under _hidden. (_help is deliberately absent: it is a virtual
+ // subtree owned by the in-app help provider, not by checkHiddenSubtree —
+ // see in_app_help.spec.ts.)
+ for (const childId of ["_search", "_options", "_taskStates", "_lbRoot"]) {
const child = becca.notes[childId];
expect(child, `${childId} should exist`).toBeDefined();
expect(
diff --git a/packages/trilium-core/src/services/hidden_subtree.ts b/packages/trilium-core/src/services/hidden_subtree.ts
index b48fb2fa12..e97831b2bb 100644
--- a/packages/trilium-core/src/services/hidden_subtree.ts
+++ b/packages/trilium-core/src/services/hidden_subtree.ts
@@ -7,7 +7,6 @@ import BBranch from "../becca/entities/bbranch.js";
import BNote from "../becca/entities/bnote.js";
import buildLaunchBarConfig from "./hidden_subtree_launcherbar.js";
import buildHiddenSubtreeTemplates from "./hidden_subtree_templates.js";
-import { cleanUpHelp, getHelpHiddenSubtreeData } from "./in_app_help.js";
import migrationService from "./migration.js";
import noteService from "./notes.js";
import { getLog } from "./log.js";
@@ -32,7 +31,7 @@ export const LBTPL_CUSTOM_WIDGET = "_lbTplCustomWidget";
let hiddenSubtreeDefinition: HiddenSubtreeItem;
-function buildHiddenSubtreeDefinition(helpSubtree: HiddenSubtreeItem[]): HiddenSubtreeItem {
+function buildHiddenSubtreeDefinition(): HiddenSubtreeItem {
const launchbarConfig = buildLaunchBarConfig();
return {
@@ -350,14 +349,6 @@ function buildHiddenSubtreeDefinition(helpSubtree: HiddenSubtreeItem[]): HiddenS
{ id: "_optionsAdvanced", title: t("hidden-subtree.advanced-title"), type: "contentWidget" }
]
},
- {
- id: "_help",
- title: t("hidden-subtree.user-guide"),
- type: "book",
- icon: "bx-help-circle",
- children: helpSubtree,
- isExpanded: true
- },
buildHiddenSubtreeTemplates()
]
};
@@ -374,9 +365,8 @@ function checkHiddenSubtree(force = false, extraOpts: CheckHiddenExtraOpts = {})
return;
}
- const helpSubtree = getHelpHiddenSubtreeData();
if (!hiddenSubtreeDefinition || force) {
- hiddenSubtreeDefinition = buildHiddenSubtreeDefinition(helpSubtree);
+ hiddenSubtreeDefinition = buildHiddenSubtreeDefinition();
}
getSql().transactional(() => {
@@ -389,13 +379,6 @@ function checkHiddenSubtree(force = false, extraOpts: CheckHiddenExtraOpts = {})
if (!taskStatesExisted) {
seedDefaultTaskStates();
}
-
- try {
- cleanUpHelp(helpSubtree);
- } catch (e) {
- // Non-critical operation should something go wrong.
- console.error(e);
- }
});
}
@@ -495,7 +478,7 @@ function checkHiddenSubtreeRecursively(
}
}
- if (item.enforceBranches || item.id.startsWith("_help")) {
+ if (item.enforceBranches) {
// Clean up any branches that shouldn't exist according to the meta definition
// For hidden subtree notes, we want to ensure they only exist in their designated locations
@@ -555,7 +538,7 @@ function checkHiddenSubtreeRecursively(
}
}
- const shouldRestoreNames = extraOpts.restoreNames || note.noteId.startsWith("_help") || item.id.startsWith("_lb") || item.id.startsWith("_template");
+ const shouldRestoreNames = extraOpts.restoreNames || item.id.startsWith("_lb") || item.id.startsWith("_template");
if (shouldRestoreNames && note.title !== item.title) {
note.title = item.title;
note.save();
@@ -628,7 +611,7 @@ function checkHiddenSubtreeRecursively(
value: attr.value,
isInheritable: attr.isInheritable
}).save();
- } else if (attr.name === "docName" || (existingAttribute.noteId.startsWith("_help") && attr.name === "iconClass")) {
+ } else if (attr.name === "docName") {
if (existingAttribute.value !== attr.value) {
log.info(`Updating attribute ${attrId} from "${existingAttribute.value}" to "${attr.value}"`);
existingAttribute.value = attr.value ?? "";
diff --git a/packages/trilium-core/src/services/i18n.ts b/packages/trilium-core/src/services/i18n.ts
index 61c4035b2f..0b107b58c5 100644
--- a/packages/trilium-core/src/services/i18n.ts
+++ b/packages/trilium-core/src/services/i18n.ts
@@ -3,6 +3,7 @@ import sql_init from "./sql_init";
import options from "./options";
import i18next from "i18next";
import hidden_subtree from "./hidden_subtree";
+import { getContext } from "./context";
export type TranslationProvider = (i18nextInstance: typeof i18next, locale: LOCALE_IDS) => Promise<void>;
@@ -40,6 +41,14 @@ function getCurrentLanguage(): LOCALE_IDS {
export async function changeLanguage(locale: string) {
await i18next.changeLanguage(locale);
hidden_subtree.checkHiddenSubtree(true, { restoreNames: true });
+
+ // Virtual subtrees (e.g. the in-app help) build their titles with t() at injection time,
+ // so a becca reload is needed to re-render them in the new language. Deliberately load()
+ // and not reload(): the latter would push a reload-frontend message mid-request, aborting
+ // the very options call that triggered the language change — and the client performs its
+ // own frontend reload after a locale switch anyway.
+ const { load } = await import("../becca/becca_loader.js");
+ getContext().init(() => load());
}
/**
diff --git a/packages/trilium-core/src/services/image.spec.ts b/packages/trilium-core/src/services/image.spec.ts
index 494ef7102b..ce8103c6e0 100644
--- a/packages/trilium-core/src/services/image.spec.ts
+++ b/packages/trilium-core/src/services/image.spec.ts
@@ -1,5 +1,7 @@
import { afterEach, describe, expect, it, vi } from "vitest";
+import { imageMimeForExtension } from "@triliumnext/commons";
+
import becca from "../becca/becca.js";
import type BNote from "../becca/entities/bnote.js";
import { getContext } from "./context.js";
@@ -27,10 +29,13 @@ const fakeBuffer = new Uint8Array([0xde, 0xad, 0xbe, 0xef]);
* Replaces the provider's processImage with one that resolves to the given
* processed image, so the async persistence branch runs deterministically.
*/
-function stubProcessImage(format: { ext: string }, buffer: Uint8Array = fakeBuffer) {
+function stubProcessImage(format: { ext: string; mime?: string }, buffer: Uint8Array = fakeBuffer) {
const processed: ProcessedImage = {
+ // A real provider reports both halves and they agree — `{ ext: "jpg", mime: "image/jpeg" }`
+ // is what the codec hands back. Deriving the default the same way keeps a stub from
+ // describing an image no provider would ever produce.
buffer,
- format: { ext: format.ext, mime: `image/${format.ext}` }
+ format: { ext: format.ext, mime: format.mime ?? imageMimeForExtension(format.ext) }
};
return vi.spyOn(getImageProvider(), "processImage").mockResolvedValue(processed);
}
@@ -113,7 +118,7 @@ describe("image service (real DB)", () => {
expect(bytesOf(note.getContent())).toEqual(Array.from(fakeBuffer));
});
- it("maps the svg extension to the svg+xml mime and appends the extension when missing", async () => {
+ it("stores the svg+xml mime whole and appends the extension when the name has none", async () => {
stubProcessImage({ ext: "svg" });
counter++;
const baseName = `nodotsvg${counter}`;
@@ -276,10 +281,30 @@ describe("image service (real DB)", () => {
await flushAsync();
const attachment = becca.getAttachment(att.attachmentId!)!;
- expect(attachment.mime).toBe("image/jpg");
+ expect(attachment.mime).toBe("image/jpeg");
expect(attachment.title).toBe("nodotattach.jpg");
expect(bytesOf(attachment.getContent())).toEqual(Array.from(fakeBuffer));
});
+
+ it("records the media type the provider reported rather than rebuilding one from its extension", async () => {
+ // The codec names JPEG `{ ext: "jpg", mime: "image/jpeg" }`, so the correct media
+ // type is already in hand. Deriving it from the extension instead yields the
+ // unregistered "image/jpg", which every consumer downstream then needs a special
+ // case for — mapExtension carries one, and IMAGE_MIMES has to list it.
+ const host = createTargetNote();
+ stubProcessImage({ ext: "jpg", mime: "image/jpeg" });
+
+ const att = getContext().init(() =>
+ imageService.saveImageToAttachment(host.noteId, fakeBuffer, "screenshot.png", false)
+ );
+ await flushAsync();
+
+ const attachment = becca.getAttachment(att.attachmentId ?? "");
+ expect(attachment?.mime).toBe("image/jpeg");
+ // The title is left alone on purpose (a canvas addresses its images by it), which is
+ // precisely why the mime has to be right — it is all the export has left to go on.
+ expect(attachment?.title).toBe("screenshot.png");
+ });
});
describe("updateImage", () => {
@@ -327,7 +352,7 @@ describe("image service (real DB)", () => {
expect(note.getOwnedLabelValue("originalFileName")).toBe("renamed.png");
// Mime/content now reflect updateImage's distinct provider output, which
// differs from the PNG/[1,2,3] state saveImage produced.
- expect(note.mime).toBe("image/jpg");
+ expect(note.mime).toBe("image/jpeg");
expect(bytesOf(note.getContent())).toEqual(Array.from(updatedBuffer));
});
});
diff --git a/packages/trilium-core/src/services/image.ts b/packages/trilium-core/src/services/image.ts
index 9de2f816b8..86744da2ea 100644
--- a/packages/trilium-core/src/services/image.ts
+++ b/packages/trilium-core/src/services/image.ts
@@ -3,7 +3,7 @@
* Uses ImageProvider for platform-specific processing (compression, format detection).
*/
-import { type ImageAttachmentRole, imageMimeForExtension, isDeduplicatedAttachmentRole } from "@triliumnext/commons";
+import { type ImageAttachmentRole, isDeduplicatedAttachmentRole } from "@triliumnext/commons";
import sanitizeFilename from "sanitize-filename";
import becca from "../becca/becca.js";
@@ -109,7 +109,7 @@ function updateImage(noteId: string, uploadBuffer: Uint8Array, originalName: str
trackWrite(getImageProvider().processImage(uploadBuffer, originalName, true).then(({ buffer, format }) => {
getContext().init(() => {
getSql().transactional(() => {
- note.mime = imageMimeForExtension(format.ext);
+ note.mime = format.mime;
note.save();
note.setContent(buffer);
});
@@ -151,7 +151,7 @@ function saveImage(
trackWrite(getImageProvider().processImage(uploadBuffer, originalName, shrinkImageSwitch).then(({ buffer, format }) => {
getContext().init(() => {
getSql().transactional(() => {
- note.mime = imageMimeForExtension(format.ext);
+ note.mime = format.mime;
if (!originalName.includes(".")) {
originalName += `.${format.ext}`;
@@ -251,7 +251,7 @@ function saveImageToAttachment(
return;
}
- savedAttachment.mime = imageMimeForExtension(format.ext);
+ savedAttachment.mime = format.mime;
if (!originalName.includes(".")) {
originalName += `.${format.ext}`;
diff --git a/packages/trilium-core/src/services/image_compression.ts b/packages/trilium-core/src/services/image_compression.ts
index 08b74735c0..9eb0e70e8f 100644
--- a/packages/trilium-core/src/services/image_compression.ts
+++ b/packages/trilium-core/src/services/image_compression.ts
@@ -246,8 +246,12 @@ export const HEADER_BYTES = 64 * 1024;
* One image the run can act on, hiding whether it lives in a note's content or in an attachment.
*
* Neither kind is renamed when its format changes: an attachment's title is a reference elsewhere
- * (a canvas addresses its images by the Excalidraw file id stored as the title), and download and
- * export filenames already derive their extension from the mime when the title disagrees.
+ * (a canvas addresses its images by the Excalidraw file id stored as the title), so the mime is
+ * left to carry the format on its own.
+ *
+ * That makes the mime load-bearing rather than merely informative, since it is then the only
+ * record of what the bytes are: download and export filenames both derive their extension from it
+ * where the title disagrees, which is the whole reason they may be left disagreeing.
*/
export interface CompressionTarget {
entityType: "note" | "attachment";
diff --git a/packages/trilium-core/src/services/in_app_help.spec.ts b/packages/trilium-core/src/services/in_app_help.spec.ts
index 0cc6f51f92..29bb8356cb 100644
--- a/packages/trilium-core/src/services/in_app_help.spec.ts
+++ b/packages/trilium-core/src/services/in_app_help.spec.ts
@@ -1,117 +1,161 @@
-import { beforeAll, describe, expect, it } from "vitest";
+import { describe, expect, it } from "vitest";
-import type { HiddenSubtreeItem } from "@triliumnext/commons";
+import { EMPTY_BLOB_ID, type HelpBundle, type HiddenSubtreeItem } from "@triliumnext/commons";
import becca from "../becca/becca.js";
+import { load } from "../becca/becca_loader.js";
+import { ValidationError } from "../errors.js";
+import blobService from "./blob.js";
import { getContext } from "./context.js";
-import {
- cleanUpHelp,
- getHelpHiddenSubtreeData,
- InAppHelpProvider,
- initInAppHelp
-} from "./in_app_help.js";
-
-/** Minimal concrete provider so the abstract `cleanUpHelp` logic can be exercised. */
-class TestHelpProvider extends InAppHelpProvider {
+import { getHelpHiddenSubtreeData, HELP_ASSET_TOKEN, InAppHelpProvider, initInAppHelp } from "./in_app_help.js";
+import { getVirtualNoteAssets, getVirtualNoteProvider } from "./virtual_notes.js";
- constructor(private data: HiddenSubtreeItem[]) {
+/** Minimal concrete provider standing in for the platform-specific implementations. */
+class TestHelpProvider extends InAppHelpProvider {
+ constructor(private data: HiddenSubtreeItem[], private content: HelpBundle = {}, private assetBase = "assets/help") {
super();
}
+
getHelpHiddenSubtreeData(): HiddenSubtreeItem[] {
return this.data;
}
+ getHelpContent(): HelpBundle {
+ return this.content;
+ }
+
+ getHelpAssetBase(): string {
+ return this.assetBase;
+ }
+
+ readAssets: string[] = [];
+
+ async getHelpAsset(assetPath: string): Promise<Uint8Array | null> {
+ this.readAssets.push(assetPath);
+ return new Uint8Array([ assetPath.length ]);
+ }
}
-const noteService = (await import("./notes.js")).default;
-
-/** Creates a note with a forced id under the given parent within the help subtree. */
-function createHelpNote(noteId: string, parentNoteId: string) {
- return getContext().init(
- () =>
- noteService.createNewNote({
- noteId,
- parentNoteId,
- title: noteId,
- content: "help content",
- type: "text",
- // The help subtree (`_help*`) is a forbidden parent by default.
- ignoreForbiddenParents: true
- }).note
- );
+function reloadBecca() {
+ getContext().init(() => load());
}
-describe("in_app_help - module accessors", () => {
+describe("in_app_help", () => {
it("delegates getHelpHiddenSubtreeData to the registered provider", () => {
// The server suite registers a real provider during initializeCore;
// override it with a deterministic stub for this isolated fork.
- const data: HiddenSubtreeItem[] = [
- { id: "_helpFoo", title: "Foo", type: "text" }
- ];
+ const data: HiddenSubtreeItem[] = [{ id: "_helpFoo", title: "Foo", type: "text" }];
initInAppHelp(new TestHelpProvider(data));
expect(getHelpHiddenSubtreeData()).toBe(data);
});
-});
-
-describe("in_app_help - cleanUpHelp", () => {
- beforeAll(() => {
- // `_help` already exists in the fixture (empty). Build a subtree under it:
- // _help
- // ├── _helpKeep
- // │ └── _helpKeepChild
- // └── _helpStale
- createHelpNote("_helpKeep", "_help");
- createHelpNote("_helpKeepChild", "_helpKeep");
- createHelpNote("_helpStale", "_help");
- });
- it("deletes notes absent from the definition and preserves the rest", () => {
- // Definition keeps _helpKeep (and its child) but omits _helpStale.
- const definition: HiddenSubtreeItem[] = [
+ it("injects the help subtree as virtual notes under _hidden", () => {
+ const data: HiddenSubtreeItem[] = [
{
- id: "_help",
- title: "Help",
- type: "text",
- children: [
- {
- id: "_helpKeep",
- title: "Keep",
- type: "text",
- children: [
- {
- id: "_helpKeepChild",
- title: "Keep child",
- type: "text"
- }
- ]
- }
- ]
+ id: "_helpStub",
+ title: "Stub page",
+ type: "doc",
+ icon: "bx-file",
+ attributes: [{ type: "label", name: "docName", value: "stub" }]
}
];
+ initInAppHelp(new TestHelpProvider(data));
+ reloadBecca();
- getContext().init(() => cleanUpHelp(definition));
+ const helpRoot = becca.getNoteOrThrow("_help");
+ expect(helpRoot.isVirtual).toBe(true);
+ expect(helpRoot.type).toBe("book");
+ expect(helpRoot.getParentNotes().map((note) => note.noteId)).toEqual(["_hidden"]);
- // The stale note is gone; the kept notes (incl. nested child and root) survive.
- expect(becca.getNote("_helpStale")?.isDeleted ?? true).toBe(true);
- expect(becca.getNote("_helpKeep")?.isDeleted).toBe(false);
- expect(becca.getNote("_helpKeepChild")?.isDeleted).toBe(false);
- expect(becca.getNote("_help")?.isDeleted).toBe(false);
+ const stub = becca.getNoteOrThrow("_helpStub");
+ expect(stub.isVirtual).toBe(true);
+ expect(stub.getParentNotes().map((note) => note.noteId)).toEqual(["_help"]);
+ expect(stub.getLabelValue("docName")).toBe("stub");
+ expect(stub.getLabelValue("iconClass")).toBe("bx bx-file");
});
- it("is a no-op when the _help subtree does not exist", () => {
- // Remove the whole _help subtree, so becca.getNote("_help") is null and
- // the recursive flattener hits its empty-note short-circuit.
- getContext().init(() => becca.getNote("_help")?.deleteNote());
- expect(becca.getNote("_help")).toBeNull();
+ it("serves page content from the provider, through becca and the blob route", () => {
+ const data: HiddenSubtreeItem[] = [
+ { id: "_helpPage", title: "Page", type: "text" },
+ { id: "_helpBlank", title: "Blank", type: "text" }
+ ];
+ initInAppHelp(new TestHelpProvider(data, { _helpPage: "<p>Rendered</p>" }));
+ reloadBecca();
+
+ expect(becca.getNoteOrThrow("_helpPage").getContent()).toBe("<p>Rendered</p>");
+ // A page the provider has no entry for reads as empty rather than failing.
+ expect(becca.getNoteOrThrow("_helpBlank").getContent()).toBe("");
- expect(() => getContext().init(() => cleanUpHelp([]))).not.toThrow();
+ // Virtual notes have no blobs row, so the route derives the POJO from the provider. The
+ // blobId is content-derived, as for persisted notes, so the client change-detects it the
+ // same way — and empty content yields the shared empty-blob id rather than looking like a
+ // blob the sync server withheld.
+ const page = blobService.getBlobPojo("notes", "_helpPage");
+ expect(page.content).toBe("<p>Rendered</p>");
+ expect(page.contentLength).toBe("<p>Rendered</p>".length);
+ expect(page.isStubbed).toBe(false);
+
+ const blank = blobService.getBlobPojo("notes", "_helpBlank");
+ expect(blank.blobId).toBe(EMPTY_BLOB_ID);
+ expect(blank.isStubbed).toBe(false);
+ expect(page.blobId).not.toBe(blank.blobId);
});
-});
-describe("in_app_help - no provider registered", () => {
- // Runs last: it clears the provider for the rest of this isolated fork.
- it("falls back to defaults when no provider is registered", () => {
+ it("substitutes the platform's asset location into the pages", () => {
+ const page = `<img src="${HELP_ASSET_TOKEN}/User%20Guide/pic.png">`;
+ initInAppHelp(new TestHelpProvider(
+ [{ id: "_helpPage", title: "Page", type: "text" }],
+ { _helpPage: page },
+ "assets/v1.2.3/help"
+ ));
+ reloadBecca();
+
+ // One bundle ships to every platform; where its images live is decided on read.
+ expect(becca.getNoteOrThrow("_helpPage").getContent())
+ .toBe(`<img src="assets/v1.2.3/help/User%20Guide/pic.png">`);
+ });
+
+ it("declares each picture and file a page references, at the URL its content carries", async () => {
+ const page = `<img src="${HELP_ASSET_TOKEN}/User%20Guide/My%20pic.png">`
+ + `<a href="${HELP_ASSET_TOKEN}/User%20Guide/api.dat">API</a>`
+ + `<img src="${HELP_ASSET_TOKEN}/User%20Guide/My%20pic.png">`
+ + `<a href="https://example.com/x.png">elsewhere</a>`;
+ const provider = new TestHelpProvider(
+ [{ id: "_helpPage", title: "Page", type: "text" }],
+ { _helpPage: page },
+ "assets/v1.2.3/help"
+ );
+ initInAppHelp(provider);
+ reloadBecca();
+
+ const assets = getVirtualNoteAssets("_helpPage");
+ expect(assets.map(({ id, url, title, mime }) => ({ id, url, title, mime }))).toEqual([
+ { id: "_helpPage_a1", url: "assets/v1.2.3/help/User%20Guide/My%20pic.png", title: "My pic.png", mime: "image/png" },
+ { id: "_helpPage_a2", url: "assets/v1.2.3/help/User%20Guide/api.dat", title: "api.dat", mime: "application/octet-stream" }
+ ]);
+ const content = String(becca.getNoteOrThrow("_helpPage").getContent());
+ expect(assets.every((asset) => content.includes(`"${asset.url}"`))).toBe(true);
+
+ await assets[0].getContent();
+ expect(provider.readAssets).toEqual([ "User Guide/My pic.png" ]);
+ });
+
+ it("makes every help page read-only, with no label the user could remove", () => {
+ initInAppHelp(new TestHelpProvider([{ id: "_helpPage", title: "Page", type: "text" }]));
+ reloadBecca();
+
+ const page = becca.getNoteOrThrow("_helpPage");
+ expect(becca.getNoteOrThrow("_help").isContentWritable()).toBe(false);
+ expect(page.isContentWritable()).toBe(false);
+ expect(page.hasLabel("readOnly")).toBe(false);
+ expect(() => getContext().init(() => page.setContent("<p>edited</p>"))).toThrow(ValidationError);
+ });
+
+ it("unregisters the help provider when none is supplied", () => {
initInAppHelp(undefined as unknown as InAppHelpProvider);
expect(getHelpHiddenSubtreeData()).toEqual([]);
- expect(() => cleanUpHelp([])).not.toThrow();
+ expect(getVirtualNoteProvider("_help")).toBeNull();
+
+ reloadBecca();
+ expect(becca.getNote("_help")).toBeNull();
});
});
diff --git a/packages/trilium-core/src/services/in_app_help.ts b/packages/trilium-core/src/services/in_app_help.ts
index 76201f02dd..c1e5f9cc10 100644
--- a/packages/trilium-core/src/services/in_app_help.ts
+++ b/packages/trilium-core/src/services/in_app_help.ts
@@ -1,73 +1,117 @@
-import type { HiddenSubtreeItem } from "@triliumnext/commons";
+import type { HelpBundle, HiddenSubtreeItem } from "@triliumnext/commons";
+import { t } from "i18next";
+import mimeTypes from "mime-types";
-import becca from "../becca/becca.js";
-import type BNote from "../becca/entities/bnote.js";
+import {
+ registerVirtualNoteProvider,
+ unregisterVirtualNoteProvider,
+ type VirtualNoteAsset,
+ type VirtualSubtreeItem
+} from "./virtual_notes.js";
+/**
+ * Platform-specific source of the in-app help (User Guide), both its tree and the rendered content
+ * of its pages. Both are produced by `edit-docs` from the markdown under `docs/User Guide`; the
+ * server reads them from `RESOURCE_DIR/help`.
+ *
+ * The help notes themselves are **virtual notes**: they exist only in becca, injected under
+ * `_hidden` by the `_help` virtual note provider registered in {@link initInAppHelp}. They are
+ * never persisted or synced — their structure and content are owned by the application, not the
+ * user.
+ */
export abstract class InAppHelpProvider {
abstract getHelpHiddenSubtreeData(): HiddenSubtreeItem[];
/**
- * Iterates recursively through the help subtree that the user has and compares it against the definition
- * to remove any notes that are no longer present in the latest version of the help.
+ * Rendered content of the help pages, keyed by note ID. Called on every page read, so
+ * implementations that load it from disk should cache it.
*/
- cleanUpHelp(helpDefinition: HiddenSubtreeItem[]): void {
- function getFlatIds(items: HiddenSubtreeItem | HiddenSubtreeItem[]) {
- const ids: (string | string[])[] = [];
- if (Array.isArray(items)) {
- for (const item of items) {
- ids.push(getFlatIds(item));
- }
- } else {
- if (items.children) {
- for (const child of items.children) {
- ids.push(getFlatIds(child));
- }
- }
- ids.push(items.id);
- }
- return ids.flat();
- }
+ abstract getHelpContent(): HelpBundle;
- function getFlatIdsFromNote(note: BNote | null) {
- if (!note) {
- return [];
- }
+ /**
+ * Where this platform serves the guide's images and attachments from, substituted into the
+ * pages for {@link HELP_ASSET_TOKEN}. Relative URLs are resolved by the browser against the
+ * application root, which keeps them working behind a reverse proxy and under Electron's
+ * custom protocol.
+ */
+ abstract getHelpAssetBase(): string;
- const ids: (string | string[])[] = [];
+ /**
+ * Reads one of the guide's images or attachments, by its path from the export root as the
+ * pages reference it (percent-decoded). Resolves to `null` when the file cannot be read.
+ */
+ abstract getHelpAsset(assetPath: string): Promise<Uint8Array | null>;
+}
- for (const subnote of note.getChildNotes()) {
- ids.push(getFlatIdsFromNote(subnote));
- }
+/**
+ * Placeholder the content bundle carries in place of an asset location, so that one bundle can be
+ * shipped to platforms that serve those assets from different places. Kept in sync with the
+ * bundler in `apps/edit-docs`.
+ */
+export const HELP_ASSET_TOKEN = "{{helpAssets}}";
- ids.push(note.noteId);
- return ids.flat();
- }
+let provider: InAppHelpProvider | null = null;
- const definitionHelpIds = new Set(getFlatIds(helpDefinition));
- const realHelpIds = getFlatIdsFromNote(becca.getNote("_help"));
+export const HELP_SUBTREE_NAMESPACE = "_help";
- for (const realHelpId of realHelpIds) {
- if (realHelpId === "_help") {
- continue;
- }
+export function initInAppHelp(p: InAppHelpProvider) {
+ provider = p;
- if (!definitionHelpIds.has(realHelpId)) {
- becca.getNote(realHelpId)?.deleteNote();
- }
- }
+ if (!p) {
+ // defensive: callers passing nothing get no help subtree rather than an empty one
+ unregisterVirtualNoteProvider(HELP_SUBTREE_NAMESPACE);
+ return;
}
-}
-let provider: InAppHelpProvider | null = null;
-
-export function initInAppHelp(p: InAppHelpProvider) {
- provider = p;
+ registerVirtualNoteProvider({
+ namespace: HELP_SUBTREE_NAMESPACE,
+ parentNoteId: "_hidden",
+ getSubtree(): VirtualSubtreeItem[] {
+ return [
+ {
+ id: HELP_SUBTREE_NAMESPACE,
+ title: t("hidden-subtree.user-guide"),
+ type: "book",
+ icon: "bx-help-circle",
+ isExpanded: true,
+ // HiddenSubtreeItem is structurally a VirtualSubtreeItem (its enforce*
+ // fields are simply ignored here).
+ children: getHelpHiddenSubtreeData()
+ }
+ ];
+ },
+ getContent(noteId: string) {
+ const page = provider?.getHelpContent()[noteId];
+ return page?.replaceAll(HELP_ASSET_TOKEN, provider?.getHelpAssetBase() ?? "");
+ },
+ getAssets: (noteId) => getHelpPageAssets(p, noteId)
+ });
}
export function getHelpHiddenSubtreeData(): HiddenSubtreeItem[] {
return provider?.getHelpHiddenSubtreeData() ?? [];
}
-export function cleanUpHelp(items: HiddenSubtreeItem[]): void {
- provider?.cleanUpHelp(items);
+/** The images and attachments one help page references, in the order they first appear. */
+function getHelpPageAssets(p: InAppHelpProvider, noteId: string): VirtualNoteAsset[] {
+ const page = p.getHelpContent()[noteId] ?? "";
+ const prefix = `${HELP_ASSET_TOKEN}/`;
+ const encodedPaths = new Set<string>();
+ for (const [ , url ] of page.matchAll(/(?:src|href)="([^"]*)"/g)) {
+ if (url.startsWith(prefix)) {
+ encodedPaths.add(url.slice(prefix.length));
+ }
+ }
+
+ return [ ...encodedPaths ].map((encodedPath, index) => {
+ const assetPath = decodeURIComponent(encodedPath);
+ const title = assetPath.split("/").pop() ?? assetPath;
+ return {
+ id: `${noteId}_a${index + 1}`,
+ url: `${p.getHelpAssetBase()}/${encodedPath}`,
+ title,
+ mime: mimeTypes.lookup(title) || "application/octet-stream",
+ getContent: () => p.getHelpAsset(assetPath)
+ };
+ });
}
diff --git a/packages/trilium-core/src/services/llm/tools/help_tools.spec.ts b/packages/trilium-core/src/services/llm/tools/help_tools.spec.ts
new file mode 100644
index 0000000000..2212fa39d4
--- /dev/null
+++ b/packages/trilium-core/src/services/llm/tools/help_tools.spec.ts
@@ -0,0 +1,160 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+
+import becca from "../../../becca/becca.js";
+import { buildNote } from "../../../test/becca_easy_mocking.js";
+import type SearchContext from "../../search/search_context.js";
+
+// The searching itself is the application's, and it wants a database; what belongs to these tools
+// is which notes they put in scope and what they make of the results. Those are asserted here, and
+// the matching end to end against the shipped guide in `apps/server/spec/in_app_help.spec.ts`.
+vi.mock("../../search/services/search.js", () => ({
+ default: {
+ findResultsWithQuery: (query: string, context: SearchContext) => search(query, context)
+ }
+}));
+
+import { helpTools } from "./help_tools.js";
+import type { ToolDefinition } from "./tool_registry.js";
+
+let search = vi.fn((_query: string, _context: SearchContext) => [] as { noteId: string }[]);
+
+function getTool(name: string): ToolDefinition {
+ for (const [n, def] of helpTools) {
+ if (n === name) return def;
+ }
+ throw new Error(`Tool ${name} not registered`);
+}
+
+/** A miniature `_help` subtree: root → section → page. */
+function buildHelpTree() {
+ buildNote({
+ id: "_help",
+ title: "User Guide",
+ content: "",
+ children: [
+ {
+ id: "_help_basics",
+ title: "Basic Concepts",
+ content: "",
+ children: [
+ {
+ id: "_help_notes",
+ title: "Notes",
+ content: "",
+ children: [
+ {
+ id: "_help_cloning",
+ title: "Cloning Notes",
+ type: "text",
+ content: "<p>A note can be placed in multiple locations. Prefix &amp; installation hints.</p>"
+ }
+ ]
+ }
+ ]
+ },
+ { id: "_help_install", title: "Installation & Setup", type: "text", content: "<p>Download the desktop app.</p>" }
+ ]
+ });
+}
+
+interface SearchHelpResult {
+ totalResults: number;
+ results: { noteId: string; title: string; path: string; contentPreview: string | null }[];
+}
+
+describe("help_tools", () => {
+ beforeEach(() => {
+ becca.reset();
+ search = vi.fn(() => []);
+ });
+
+ it("reads only the User Guide, which ships with Trilium, never the user's data", () => {
+ const readsUserData = (name: string) => {
+ const definition = getTool(name);
+ return definition.mutates ? true : definition.readsUserData;
+ };
+ expect([ "search_help", "get_help_toc" ].map(readsUserData)).toEqual([ false, false ]);
+ });
+
+ describe("search_help", () => {
+ it("searches the guide and nothing else, passing the query through as written", () => {
+ buildHelpTree();
+
+ getTool("search_help").execute({ query: "multiple locations?" });
+
+ expect(search).toHaveBeenCalledOnce();
+ const [ query, context ] = search.mock.calls[0];
+ expect(query).toBe("multiple locations?");
+ // Naming an ancestor is also what puts the hidden subtree in scope, so the guide is
+ // reachable without the search opening up to everything else hidden.
+ expect(context.ancestorNoteId).toBe("_help");
+ expect(context.includeHiddenNotes).toBe(false);
+ });
+
+ it("describes each hit by its title, its place in the guide and a preview of its text", () => {
+ buildHelpTree();
+ search = vi.fn(() => [ { noteId: "_help_cloning" } ]);
+
+ const result = getTool("search_help").execute({ query: "multiple locations" }) as SearchHelpResult;
+
+ expect(result.totalResults).toBe(1);
+ expect(result.results[0]).toMatchObject({
+ noteId: "_help_cloning",
+ title: "Cloning Notes",
+ path: "Basic Concepts > Notes"
+ });
+ expect(result.results[0].contentPreview).toContain("multiple locations");
+ });
+
+ it("reports how many pages matched even when only some are returned", () => {
+ buildHelpTree();
+ search = vi.fn(() => [ { noteId: "_help_install" }, { noteId: "_help_cloning" } ]);
+
+ const limited = getTool("search_help").execute({ query: "installation", limit: 1 }) as SearchHelpResult;
+
+ expect(limited.totalResults).toBe(2);
+ expect(limited.results.map((r) => r.noteId)).toEqual([ "_help_install" ]);
+ });
+
+ it("drops a hit whose note has since gone from becca", () => {
+ buildHelpTree();
+ search = vi.fn(() => [ { noteId: "_help_cloning" }, { noteId: "_help_vanished" } ]);
+
+ const result = getTool("search_help").execute({ query: "anything" }) as SearchHelpResult;
+
+ expect(result.results.map((r) => r.noteId)).toEqual([ "_help_cloning" ]);
+ });
+
+ it("returns an error when the help subtree is absent or empty, without searching", () => {
+ expect(getTool("search_help").execute({ query: "anything" }))
+ .toEqual({ error: "The built-in User Guide is not available in this installation." });
+
+ buildNote({ id: "_help", title: "User Guide", content: "" }); // present but not yet populated
+ expect(getTool("search_help").execute({ query: "anything" }))
+ .toEqual({ error: "The built-in User Guide is not available in this installation." });
+
+ expect(search).not.toHaveBeenCalled();
+ });
+ });
+
+ describe("get_help_toc", () => {
+ it("returns an indented outline of every help page with its noteId", () => {
+ buildHelpTree();
+
+ const result = getTool("get_help_toc").execute({}) as { pageCount: number; toc: string };
+
+ expect(result.pageCount).toBe(4);
+ expect(result.toc.split("\n")).toEqual([
+ "Basic Concepts (_help_basics)",
+ " Notes (_help_notes)",
+ " Cloning Notes (_help_cloning)",
+ "Installation & Setup (_help_install)"
+ ]);
+ });
+
+ it("returns an error when the help subtree is absent", () => {
+ expect(getTool("get_help_toc").execute({}))
+ .toEqual({ error: "The built-in User Guide is not available in this installation." });
+ });
+ });
+});
diff --git a/apps/server/src/services/llm/tools/help_tools.ts b/packages/trilium-core/src/services/llm/tools/help_tools.ts
similarity index 50%
rename from apps/server/src/services/llm/tools/help_tools.ts
rename to packages/trilium-core/src/services/llm/tools/help_tools.ts
index 825f06d2b1..8602e62b5e 100644
--- a/apps/server/src/services/llm/tools/help_tools.ts
+++ b/packages/trilium-core/src/services/llm/tools/help_tools.ts
@@ -4,30 +4,31 @@
* "how do I…?" questions about Trilium itself, grounded in the documentation
* that ships with the running version instead of possibly stale training data.
*
- * Help pages are `doc` notes: their HTML lives on disk rather than in the
- * database, so Trilium's regular search cannot see their bodies. search_help
- * therefore matches against a lazily built in-memory index of the page texts
- * (~1 MB for the whole guide, loaded once per process).
+ * The searching itself is the application's own, scoped to the guide. What these add is that they
+ * are here to be reached for at all: a tool the assistant can see is what points it at the
+ * documentation of the version in front of it.
*/
-import { becca, type BNote } from "@triliumnext/core";
-import { getContentPreview, getDocNoteHtml } from "@triliumnext/core/src/services/llm/tools/helpers.js";
-import { defineTools } from "@triliumnext/core/src/services/llm/tools/tool_registry.js";
import { z } from "zod";
+import becca from "../../../becca/becca.js";
+import type BNote from "../../../becca/entities/bnote.js";
+import SearchContext from "../../search/search_context.js";
+import searchService from "../../search/services/search.js";
+import { getContentPreview } from "./helpers.js";
+import { defineTools } from "./tool_registry.js";
+
const HELP_ROOT_NOTE_ID = "_help";
const DEFAULT_SEARCH_LIMIT = 10;
/** The User Guide is only a few levels deep; bound traversal defensively. */
const MAX_HELP_DEPTH = 10;
-/** A word occurrence in the title outweighs one in the body. */
-const TITLE_MATCH_WEIGHT = 10;
export const helpTools = defineTools({
search_help: {
description: [
"Search Trilium's built-in User Guide — the documentation for Trilium itself.",
"Use this to answer questions about how to use Trilium: features, settings, keyboard shortcuts, sync, scripting, themes, etc.",
- "Full-text keyword search over the help pages; keep queries to a few keywords (e.g. 'keyboard shortcuts', 'protected notes').",
+ "Takes the same query as search_notes, over the help pages alone; keep it to a few keywords (e.g. 'keyboard shortcuts', 'protected notes').",
"If a query finds nothing, retry with synonyms or browse get_help_toc — the guide may name the concept differently (e.g. placing a note in two locations is 'cloning').",
"Read a found page with get_note_content."
].join(" "),
@@ -41,27 +42,19 @@ export const helpTools = defineTools({
return { error: "The built-in User Guide is not available in this installation." };
}
- // Strip punctuation (models happily send "cloning?" despite the
- // schema hint) and deduplicate so repeated words don't skew scoring.
- const words = query.toLowerCase()
- .replace(/[^\p{L}\p{N}\s]/gu, " ")
- .split(/\s+/)
- .filter(Boolean)
- .filter((word, index, all) => all.indexOf(word) === index);
- if (words.length === 0) {
- return { error: "Empty search query." };
- }
-
- const matches = getHelpIndex()
- .map((page) => ({ page, score: scorePage(page, words) }))
- .filter((m) => m.score > 0)
- .sort((a, b) => b.score - a.score);
+ // Naming an ancestor is also what lets the guide be found at all: it takes the place
+ // of the filter that keeps the hidden subtree out of ordinary results (see
+ // `getAncestorExp`), so the pages are in scope without opening up everything else.
+ const matches = searchService.findResultsWithQuery(
+ query,
+ new SearchContext({ ancestorNoteId: HELP_ROOT_NOTE_ID })
+ );
- const results = matches.slice(0, limit).map(({ page }) => {
- const note = becca.notes[page.noteId];
+ const results = matches.slice(0, limit).map(({ noteId }) => {
+ const note = becca.notes[noteId];
if (!note) return null;
return {
- noteId: page.noteId,
+ noteId,
title: note.getTitleOrProtected(),
path: getHelpPath(note),
contentPreview: getContentPreview(note)
@@ -100,87 +93,6 @@ export const helpTools = defineTools({
}
});
-/** One help page in the search index; title and text are lowercased for matching. */
-interface HelpPageIndexEntry {
- noteId: string;
- titleLower: string;
- textLower: string;
-}
-
-/**
- * Lazily built index of all help pages. The guide only changes on upgrade
- * (which restarts the server), so it is cached for the process lifetime.
- */
-let helpIndex: HelpPageIndexEntry[] | null = null;
-
-/** Drop the cached search index (for tests). */
-export function resetHelpIndex(): void {
- helpIndex = null;
-}
-
-function getHelpIndex(): HelpPageIndexEntry[] {
- if (helpIndex === null) {
- helpIndex = [];
- collectIndexEntries(becca.getNoteOrThrow(HELP_ROOT_NOTE_ID), 0, helpIndex);
- }
- return helpIndex;
-}
-
-function collectIndexEntries(note: BNote, depth: number, entries: HelpPageIndexEntry[]): void {
- if (depth >= MAX_HELP_DEPTH) {
- return;
- }
- for (const child of note.getChildNotes()) {
- entries.push({
- noteId: child.noteId,
- titleLower: child.getTitleOrProtected().toLowerCase(),
- textLower: htmlToPlainText(getDocNoteHtml(child) ?? "").toLowerCase()
- });
- collectIndexEntries(child, depth + 1, entries);
- }
-}
-
-/**
- * Score a page against the query words: every word must occur in the title or
- * body (AND semantics), title occurrences weigh more than body occurrences.
- * Returns 0 when any word is missing.
- */
-function scorePage(page: HelpPageIndexEntry, words: string[]): number {
- let score = 0;
- for (const word of words) {
- const titleHits = countOccurrences(page.titleLower, word);
- const bodyHits = countOccurrences(page.textLower, word);
- if (titleHits + bodyHits === 0) {
- return 0;
- }
- score += titleHits * TITLE_MATCH_WEIGHT + bodyHits;
- }
- return score;
-}
-
-function countOccurrences(haystack: string, needle: string): number {
- let count = 0;
- let index = haystack.indexOf(needle);
- while (index !== -1) {
- count++;
- index = haystack.indexOf(needle, index + needle.length);
- }
- return count;
-}
-
-/** Crude tag stripping — good enough for keyword matching, not for display. */
-function htmlToPlainText(html: string): string {
- return html
- .replace(/<[^>]+>/g, " ")
- .replace(/&nbsp;/g, " ")
- .replace(/&lt;/g, "<")
- .replace(/&gt;/g, ">")
- .replace(/&quot;/g, "\"")
- .replace(/&#39;/g, "'")
- .replace(/&amp;/g, "&")
- .replace(/\s+/g, " ");
-}
-
/** The help subtree exists only once the in-app help has been imported. */
function isHelpAvailable(): boolean {
const helpRoot = becca.getNote(HELP_ROOT_NOTE_ID);
diff --git a/packages/trilium-core/src/services/llm/tools/helpers.spec.ts b/packages/trilium-core/src/services/llm/tools/helpers.spec.ts
index b07576ec1c..558b2830b7 100644
--- a/packages/trilium-core/src/services/llm/tools/helpers.spec.ts
+++ b/packages/trilium-core/src/services/llm/tools/helpers.spec.ts
@@ -20,11 +20,9 @@ import {
flag,
getAttachmentContentPreview,
getContentPreview,
- getDocNoteHtml,
getNoteContentForLlm,
getNoteMeta,
getSvgImageError,
- registerDocNoteHtmlReader,
setNoteContentFromLlm
} from "./helpers.js";
@@ -133,26 +131,14 @@ describe("getNoteContentForLlm", () => {
});
describe("doc notes", () => {
- beforeEach(() => registerDocNoteHtmlReader(() => null));
-
- it("resolves a doc note's HTML through the registered reader", () => {
- registerDocNoteHtmlReader(note => (note.getLabelValue("docName") ? "<h2>Cloning</h2>" : null));
- expect(getDocNoteHtml(docNoteStub("User Guide/Cloning Notes"))).toBe("<h2>Cloning</h2>");
- expect(getDocNoteHtml(docNoteStub(null))).toBeNull();
- });
-
- it("getNoteContentForLlm converts the reader's HTML to Markdown", () => {
- registerDocNoteHtmlReader(() => "<h2>Cloning</h2><p>Place a note in two locations.</p>");
- const content = getNoteContentForLlm(docNoteStub("User Guide/Cloning Notes"));
- expect(content).toContain("## Cloning");
- expect(content).toContain("Place a note in two locations.");
- });
-
- it("degrades gracefully when no reader is registered — as in the browser build", () => {
+ // Their page is picked by the `docName` label out of the client's translation catalog, so
+ // there is nothing here for the backend to read.
+ it("report no content, whichever page they name", () => {
getBlobMock.mockReturnValue(null);
- const note = docNoteStub("User Guide/Cloning Notes");
- expect(getNoteContentForLlm(note)).toBe("[doc content not available]");
- expect(getContentPreview(note)).toBeNull();
+ for (const note of [ docNoteStub("launchbar_intro"), docNoteStub(null) ]) {
+ expect(getNoteContentForLlm(note)).toBe("[doc content not available]");
+ expect(getContentPreview(note)).toBeNull();
+ }
});
});
diff --git a/packages/trilium-core/src/services/llm/tools/helpers.ts b/packages/trilium-core/src/services/llm/tools/helpers.ts
index 8edb3551fd..9919bf0b1f 100644
--- a/packages/trilium-core/src/services/llm/tools/helpers.ts
+++ b/packages/trilium-core/src/services/llm/tools/helpers.ts
@@ -31,29 +31,6 @@ const SVG_SOURCE_RE = /^\s*(?:<\?xml[\s\S]*?\?>\s*)?(?:(?:<!--(?:(?!-->)[\s\S])*
/** Note IDs that must not be deleted, moved, or cloned by the LLM. */
export const PROTECTED_SYSTEM_NOTES = new Set(["root", "_hidden", "_share", "_lbRoot", "_globalNoteMap"]);
-/** Host-provided reader for doc-note HTML. See {@link registerDocNoteHtmlReader}. */
-let docNoteHtmlReader: ((note: BNote) => string | null) | null = null;
-
-/**
- * Register the host's reader for in-app help pages.
- *
- * `doc` notes (the User Guide) keep no content in the database — their HTML
- * ships as static files, which the server reads off disk. The browser-hosted
- * build has no synchronous way to do that, so hosts that can supply it register
- * a reader here and the rest simply report the content as unavailable.
- */
-export function registerDocNoteHtmlReader(reader: (note: BNote) => string | null) {
- docNoteHtmlReader = reader;
-}
-
-/**
- * Resolve the HTML of a `doc` note via the registered reader, or null when no
- * reader is registered or it cannot resolve the page.
- */
-export function getDocNoteHtml(note: BNote): string | null {
- return docNoteHtmlReader?.(note) ?? null;
-}
-
/**
* Return `true` if the value is truthy, otherwise `undefined`.
* Since `undefined` values are omitted from JSON serialization,
@@ -70,10 +47,9 @@ export function flag(value: boolean | undefined): true | undefined {
*/
export function getNoteContentForLlm(note: BNote) {
if (note.type === "doc") {
- // Doc notes (in-app help / User Guide pages) store no content in the
- // database — their HTML lives on disk and is fetched by the client.
- const html = getDocNoteHtml(note);
- return html ? markdownExport.toMarkdown(html) : "[doc content not available]";
+ // Doc notes hold no content of their own: the client renders an explanatory page picked
+ // by their `docName` label, out of its own translation catalog.
+ return "[doc content not available]";
}
const content = note.getContent();
diff --git a/packages/trilium-core/src/services/llm/tools/index.ts b/packages/trilium-core/src/services/llm/tools/index.ts
index 62806715c1..9194d311e6 100644
--- a/packages/trilium-core/src/services/llm/tools/index.ts
+++ b/packages/trilium-core/src/services/llm/tools/index.ts
@@ -14,6 +14,7 @@ export { ToolRegistry } from "./tool_registry.js";
import { attachmentTools } from "./attachment_tools.js";
import { attributeTools } from "./attribute_tools.js";
+import { helpTools } from "./help_tools.js";
import { hierarchyTools } from "./hierarchy_tools.js";
import { iconTools } from "./icon_tools.js";
import { noteTools } from "./note_tools.js";
@@ -33,6 +34,7 @@ import type { ToolRegistry } from "./tool_registry.js";
*/
export const allToolRegistries: ToolRegistry[] = [
noteTools,
+ helpTools,
attributeTools,
attachmentTools,
hierarchyTools,
diff --git a/packages/trilium-core/src/services/notes.spec.ts b/packages/trilium-core/src/services/notes.spec.ts
index 2b00bcbfa6..529a46c000 100644
--- a/packages/trilium-core/src/services/notes.spec.ts
+++ b/packages/trilium-core/src/services/notes.spec.ts
@@ -351,6 +351,39 @@ describe("notes service (real DB)", () => {
expect(note.mime).toBe("text/x-python");
expect(note.getContent()).toBe("print('hi')");
});
+
+ it("titles a note from its template's #template:titleTemplate before the parent's #titleTemplate", () => {
+ const templates = createNote("root", {
+ attributes: [
+ { type: "label", name: "template:titleTemplate", value: "Folder ${parentNote.title}", isInheritable: true }
+ ]
+ });
+ const meeting = createNote(templates.note.noteId, {
+ attributes: [{ type: "label", name: "template:titleTemplate", value: "Meeting ${parentNote.title}" }]
+ });
+ const book = createNote(templates.note.noteId);
+ const plain = createNote("root");
+ const parent = createNote("root", {
+ title: "Q4",
+ attributes: [
+ { type: "label", name: "titleTemplate", value: "Child of ${parentNote.title}" },
+ { type: "relation", name: "child:template", value: meeting.note.noteId }
+ ]
+ });
+ const untitled = (templateNoteId?: string, title?: string) => createNote(parent.note.noteId, {
+ title, templateNoteId
+ }).note;
+
+ expect(untitled(undefined).title).toBe("Meeting Q4");
+ expect(untitled(book.note.noteId).title).toBe("Folder Q4");
+ expect(untitled(plain.note.noteId).title).toBe("Child of Q4");
+ expect(untitled(meeting.note.noteId, "Typed").title).toBe("Typed");
+
+ // A note created from Meeting and marked #template does not take Meeting's title along.
+ const instance = untitled(meeting.note.noteId);
+ getContext().init(() => instance.setLabel("template"));
+ expect(untitled(instance.noteId).title).toBe("Child of Q4");
+ });
});
describe("createNewNote logging", () => {
diff --git a/packages/trilium-core/src/services/notes.ts b/packages/trilium-core/src/services/notes.ts
index b3ae99887a..ff13ed8f88 100644
--- a/packages/trilium-core/src/services/notes.ts
+++ b/packages/trilium-core/src/services/notes.ts
@@ -161,9 +161,48 @@ function copyAttachments(origNote: BNote, newNote: BNote) {
}
function getNewNoteTitle(parentNote: BNote) {
- let title = t("notes.new-note");
+ return evaluateTitleTemplate(
+ parentNote.getLabelValue("titleTemplate"),
+ parentNote,
+ `titleTemplate of note '${parentNote.noteId}'`
+ );
+}
- const titleTemplate = parentNote.getLabelValue("titleTemplate");
+/**
+ * Returns the default title that the first of the note's templates carrying a
+ * `#template:titleTemplate` gives it, or `null` when none does.
+ */
+function getTemplateNoteTitle(note: BNote, parentNote: BNote) {
+ for (const relation of note.getOwnedRelations("template")) {
+ const templateNote = relation.targetNote;
+ const titleTemplate = templateNote ? getTemplateTitleTemplate(templateNote) : null;
+
+ if (templateNote && titleTemplate !== null) {
+ return evaluateTitleTemplate(
+ titleTemplate,
+ parentNote,
+ `template:titleTemplate of note '${templateNote.noteId}'`
+ );
+ }
+ }
+
+ return null;
+}
+
+/**
+ * Reads the template's own `#template:titleTemplate`, or one inherited from its ancestors in the tree.
+ * A value lent through `~template` is skipped, so a note created from a template and later marked
+ * `#template` does not adopt the original template's title, as with `~template:newNoteDefaultParent`.
+ */
+function getTemplateTitleTemplate(templateNote: BNote) {
+ const sourceNoteIds = new Set([ templateNote.noteId, ...templateNote.getAncestorNoteIds() ]);
+
+ return templateNote.getLabels("template:titleTemplate")
+ .find((label) => sourceNoteIds.has(label.noteId))?.value ?? null;
+}
+
+function evaluateTitleTemplate(titleTemplate: string | null, parentNote: BNote, source: string) {
+ let title = t("notes.new-note");
if (titleTemplate !== null) {
const now = dayjs(date_utils.localNowDateTime() || new Date());
@@ -175,7 +214,7 @@ function getNewNoteTitle(parentNote: BNote) {
titleTemplate,
{ now, parentNote },
title,
- `titleTemplate of note '${parentNote.noteId}'`
+ source
);
}
@@ -226,7 +265,8 @@ function createNewNote(params: NoteParams): {
} {
const parentNote = getAndValidateParent(params);
- if (params.title === null || params.title === undefined) {
+ const isTitleDefaulted = params.title === null || params.title === undefined;
+ if (isTitleDefaulted) {
params.title = getNewNoteTitle(parentNote);
}
@@ -336,6 +376,13 @@ function createNewNote(params: NoteParams): {
copyChildAttributes(parentNote, note, params.isTypeDefaulted);
+ // Read once the templates are applied, so both a chosen template and a `child:template` count.
+ const templateTitle = isTitleDefaulted ? getTemplateNoteTitle(note, parentNote) : null;
+ if (templateTitle !== null) {
+ note.title = templateTitle;
+ note.save();
+ }
+
eventService.emit(eventService.ENTITY_CREATED, { entityName: "notes", entity: note });
eventService.emit(eventService.ENTITY_CHANGED, { entityName: "notes", entity: note });
triggerNoteTitleChanged(note);
@@ -404,6 +451,13 @@ function createNewNoteWithTarget(target: "into" | "after" | "before", targetBran
}
function protectNoteRecursively(note: BNote, protect: boolean, includingSubTree: boolean, taskContext: TaskContext<"protectNotes">) {
+ if (note.isVirtual) {
+ // Virtual notes (e.g. the in-app help) are read-only, application-owned and never
+ // persisted — (un)protecting them is meaningless. Their children are virtual too,
+ // so the whole subtree is skipped.
+ return;
+ }
+
protectNote(note, protect);
taskContext.increaseProgressCount();
@@ -1189,6 +1243,13 @@ function updateNoteData(noteId: string, content: string, attachments: Attachment
throw new Error(`Note '${noteId}' is not available for change!`);
}
+ // Revisions, attachments and link attributes are database rows, which a virtual note has none
+ // of; its provider stores the content alone.
+ if (note.isVirtual) {
+ note.setContent(content);
+ return;
+ }
+
saveRevisionIfNeeded(note);
// Saved before the links, so that `checkImageAttachments()` reads the drawings of this save.
diff --git a/packages/trilium-core/src/services/search/expressions/note_content_fulltext.ts b/packages/trilium-core/src/services/search/expressions/note_content_fulltext.ts
index a79c4bab19..0e3e6e751d 100644
--- a/packages/trilium-core/src/services/search/expressions/note_content_fulltext.ts
+++ b/packages/trilium-core/src/services/search/expressions/note_content_fulltext.ts
@@ -1,4 +1,4 @@
-import type { NoteRow } from "@triliumnext/commons";
+import type { NoteRow, NoteType } from "@triliumnext/commons";
import becca from "../../../becca/becca.js";
import { getLog } from "../../log.js";
@@ -25,6 +25,9 @@ const ALLOWED_OPERATORS = new Set(["=", "!=", "*=*", "*=", "=*", "%=", "~=", "~*
// Maximum content size for search processing (2MB)
const MAX_SEARCH_CONTENT_SIZE = 2 * 1024 * 1024;
+/** Note types whose content is text worth searching. Shared by the persisted and virtual passes. */
+const SEARCHABLE_TYPES: NoteType[] = [ "text", "code", "mermaid", "canvas", "mindMap", "spreadsheet", "llmChat" ];
+
const cachedRegexes: Record<string, RegExp> = {};
function getRegex(str: string): RegExp {
@@ -104,12 +107,14 @@ class NoteContentFulltextExp extends Expression {
for (const row of getSql().iterateRows<SearchRow>(`
SELECT noteId, type, mime, content, isProtected
FROM notes JOIN blobs USING (blobId)
- WHERE type IN ('text', 'code', 'mermaid', 'canvas', 'mindMap', 'spreadsheet', 'llmChat')
+ WHERE type IN (${SEARCHABLE_TYPES.map((type) => `'${type}'`).join(", ")})
AND isDeleted = 0
AND LENGTH(content) < ${MAX_SEARCH_CONTENT_SIZE}`)) {
this.findInText(row, inputNoteSet, resultNoteSet, searchContext);
}
+ this.findInVirtualNotes(inputNoteSet, resultNoteSet, searchContext);
+
// For exact match with flatText, also search notes WITHOUT content (they may have matching attributes)
if (this.flatText && (this.operator === "=" || this.operator === "!=")) {
for (const note of inputNoteSet.notes) {
@@ -220,6 +225,34 @@ class NoteContentFulltextExp extends Expression {
return false;
}
+ /**
+ * Virtual notes (the in-app help, and anything else a virtual note provider injects) hold
+ * their content in becca rather than in `blobs`, so the query above cannot see them. They are
+ * matched from the cache instead, under the same type and size rules.
+ *
+ * Whether they can be *returned* is decided elsewhere: they live under `_hidden`, so a search
+ * only reaches them when it opts into hidden notes or scopes itself to the subtree — which is
+ * why this pass does not change what an ordinary search finds.
+ */
+ findInVirtualNotes(inputNoteSet: NoteSet, resultNoteSet: NoteSet, searchContext: SearchContext) {
+ for (const noteId in becca.notes) {
+ const note = becca.notes[noteId];
+
+ if (!note.isVirtual || !inputNoteSet.hasNoteId(noteId) || !SEARCHABLE_TYPES.includes(note.type)) {
+ continue;
+ }
+
+ const content = note.getContent();
+
+ if (typeof content !== "string" || content.length >= MAX_SEARCH_CONTENT_SIZE) {
+ continue;
+ }
+
+ // Virtual notes are never protected — nothing about them is user data.
+ this.findInText({ noteId, type: note.type, mime: note.mime, content, isProtected: false }, inputNoteSet, resultNoteSet, searchContext);
+ }
+ }
+
findInText({ noteId, isProtected, content, type, mime }: SearchRow, inputNoteSet: NoteSet, resultNoteSet: NoteSet, searchContext: SearchContext) {
if (!inputNoteSet.hasNoteId(noteId) || !(noteId in becca.notes)) {
return;
diff --git a/packages/trilium-core/src/services/tree.ts b/packages/trilium-core/src/services/tree.ts
index 2dbac4e4a9..51fce019ea 100644
--- a/packages/trilium-core/src/services/tree.ts
+++ b/packages/trilium-core/src/services/tree.ts
@@ -26,6 +26,16 @@ function validateParentChild(parentNoteId: string, childNoteId: string, branchId
return { branch: null, success: false, message: `Cannot move anything into 'none' parent.` };
}
+ // Virtual notes (e.g. the in-app help) exist only in becca — a persisted branch
+ // referencing them would dangle after upgrades and on other sync instances.
+ if (becca.getNote(childNoteId)?.isVirtual) {
+ return { branch: null, success: false, message: `Note '${childNoteId}' is a virtual note and cannot be cloned or moved.` };
+ }
+
+ if (becca.getNote(parentNoteId)?.isVirtual) {
+ return { branch: null, success: false, message: `Note '${parentNoteId}' is a virtual note and cannot receive children.` };
+ }
+
const existingBranch = becca.getBranchFromChildAndParent(childNoteId, parentNoteId);
if (existingBranch && existingBranch.branchId !== branchId) {
diff --git a/packages/trilium-core/src/services/virtual_notes.spec.ts b/packages/trilium-core/src/services/virtual_notes.spec.ts
new file mode 100644
index 0000000000..28b70c8c61
--- /dev/null
+++ b/packages/trilium-core/src/services/virtual_notes.spec.ts
@@ -0,0 +1,78 @@
+import { afterEach, describe, expect, it } from "vitest";
+
+import {
+ getVirtualNoteContent,
+ getVirtualNoteProvider,
+ getVirtualNoteProviders,
+ registerVirtualNoteProvider,
+ unregisterVirtualNoteProvider,
+ type VirtualNoteProvider
+} from "./virtual_notes.js";
+
+function makeProvider(namespace: string, overrides: Partial<VirtualNoteProvider> = {}): VirtualNoteProvider {
+ return {
+ namespace,
+ parentNoteId: "_hidden",
+ getSubtree: () => [],
+ ...overrides
+ };
+}
+
+const TEST_NAMESPACES = ["_vnreg", "_vnother"];
+
+describe("virtual_notes registry", () => {
+ afterEach(() => {
+ for (const namespace of TEST_NAMESPACES) {
+ unregisterVirtualNoteProvider(namespace);
+ }
+ });
+
+ it("registers, looks up by note-ID prefix, and unregisters providers", () => {
+ const provider = makeProvider("_vnreg");
+ registerVirtualNoteProvider(provider);
+
+ expect(getVirtualNoteProviders()).toContain(provider);
+ expect(getVirtualNoteProvider("_vnregSomeNote")).toBe(provider);
+ expect(getVirtualNoteProvider("_unrelated")).toBeNull();
+
+ unregisterVirtualNoteProvider("_vnreg");
+ expect(getVirtualNoteProvider("_vnregSomeNote")).toBeNull();
+ });
+
+ it("rejects namespaces not starting with an underscore", () => {
+ expect(() => registerVirtualNoteProvider(makeProvider("vnreg"))).toThrow(/must start with '_'/);
+ });
+
+ it("rejects overlapping namespaces but allows re-registering the same one", () => {
+ registerVirtualNoteProvider(makeProvider("_vnreg"));
+
+ // one namespace being a prefix of another would make provider lookup ambiguous
+ expect(() => registerVirtualNoteProvider(makeProvider("_vnregSub"))).toThrow(/overlaps/);
+ expect(() => registerVirtualNoteProvider(makeProvider("_vn"))).toThrow(/overlaps/);
+
+ // disjoint namespace is fine
+ expect(() => registerVirtualNoteProvider(makeProvider("_vnother"))).not.toThrow();
+
+ // same namespace replaces the previous registration (idempotent re-initialization)
+ const replacement = makeProvider("_vnreg");
+ registerVirtualNoteProvider(replacement);
+ expect(getVirtualNoteProvider("_vnreg")).toBe(replacement);
+ expect(getVirtualNoteProviders().filter((p) => p.namespace === "_vnreg")).toHaveLength(1);
+ });
+
+ it("delegates content to the provider and falls back to an empty string", () => {
+ registerVirtualNoteProvider(makeProvider("_vnreg", {
+ getContent: (noteId) => (noteId === "_vnregPage" ? "<p>hello</p>" : null)
+ }));
+
+ expect(getVirtualNoteContent("_vnregPage")).toBe("<p>hello</p>");
+ // provider returns null → empty content
+ expect(getVirtualNoteContent("_vnregOther")).toBe("");
+ // no provider at all → empty content
+ expect(getVirtualNoteContent("_nowhere")).toBe("");
+
+ // provider without getContent → empty content
+ registerVirtualNoteProvider(makeProvider("_vnother"));
+ expect(getVirtualNoteContent("_vnotherPage")).toBe("");
+ });
+});
diff --git a/packages/trilium-core/src/services/virtual_notes.ts b/packages/trilium-core/src/services/virtual_notes.ts
new file mode 100644
index 0000000000..0dbf3f14e1
--- /dev/null
+++ b/packages/trilium-core/src/services/virtual_notes.ts
@@ -0,0 +1,187 @@
+import type { NoteType } from "@triliumnext/commons";
+
+import { ValidationError } from "../errors.js";
+
+/**
+ * Virtual notes are notes that exist only in becca (and, through it, in the client's froca) —
+ * they are never persisted to the database and never produce entity changes, so they are
+ * invisible to sync, backups and consistency checks. They are meant for content whose structure
+ * is owned by the application (or an external source) rather than by the user: the in-app help,
+ * and in the future e.g. computed hierarchies or read-only mounts of external data.
+ *
+ * A {@link VirtualNoteProvider} declares a subtree of {@link VirtualSubtreeItem}s under an
+ * existing anchor note. The subtree is (re)built by `becca_loader` on every becca load, so a
+ * provider can be refreshed by triggering `becca_loader.reload()`.
+ *
+ * Ground rules enforced by this module and the becca entities:
+ *
+ * - Virtual entities carry `isVirtual = true` and refuse `save()`, `setContent()` and
+ * `markAsDeleted()` — they are read-only and their lifecycle is owned by the provider.
+ * - Persisted (non-virtual) branches and attributes may not be attached to virtual notes, so
+ * virtual notes cannot be cloned into the user's tree, moved, or annotated. Relations
+ * *pointing to* virtual notes from regular notes are allowed — the target resolves in becca.
+ * - Provider namespaces must start with `_` (the hidden-subtree convention), keeping virtual
+ * notes out of user-facing note operations that already special-case `_`-prefixed IDs.
+ */
+export interface VirtualNoteProvider {
+ /**
+ * Unique note-ID prefix owned by this provider (e.g. `_help`). Must start with `_`.
+ * Every item ID in the provided subtree must start with this namespace, which guarantees
+ * providers cannot collide with each other or with user note IDs.
+ */
+ namespace: string;
+
+ /**
+ * ID of the (persisted) note the virtual subtree is attached under, e.g. `_hidden`.
+ * If the anchor is not present in becca at load time (e.g. during initial database
+ * creation, before the hidden subtree exists), injection is skipped for that load and
+ * happens on the next one.
+ */
+ parentNoteId: string;
+
+ /**
+ * Returns the root item(s) of the virtual subtree. Called on every becca (re)load, so the
+ * result may change between calls (e.g. after an application upgrade ships new help pages).
+ */
+ getSubtree(): VirtualSubtreeItem[];
+
+ /**
+ * Content of a virtual note. When absent, or when it returns `null` or `undefined`, the
+ * content is `""`.
+ */
+ getContent?(noteId: string): string | Uint8Array | null | undefined;
+
+ /**
+ * Files that the note's content references by URL (pictures, downloads). An export carries
+ * them as attachments of the note, so the exported copy works without the provider.
+ */
+ getAssets?(noteId: string): VirtualNoteAsset[];
+
+ /**
+ * Saves new content of a virtual note. Without it, the provider's notes are read-only. The
+ * write stays on this instance, since virtual notes never sync.
+ */
+ setContent?(noteId: string, content: string | Uint8Array): void;
+}
+
+export interface VirtualNoteAsset {
+ /** Stands in for an attachment ID in an export, so it uses only `[a-zA-Z0-9_]`. */
+ id: string;
+ /** The URL exactly as `getContent()` writes it into the note. */
+ url: string;
+ title: string;
+ mime: string;
+ /** Resolves to `null` when the file cannot be read; the export then leaves it out. */
+ getContent(): Promise<Uint8Array | null>;
+}
+
+export interface VirtualSubtreeItem {
+ /** Must start with the owning provider's namespace. */
+ id: string;
+ title: string;
+ type: NoteType;
+ /** MIME type; defaults to "". */
+ mime?: string;
+ /** Icon in `bx-icon-name` format (without the leading `bx `), exposed as an `iconClass` label. */
+ icon?: string;
+ attributes?: VirtualSubtreeAttribute[];
+ children?: VirtualSubtreeItem[];
+ isExpanded?: boolean;
+ /** Position among siblings; defaults to definition order. */
+ notePosition?: number;
+}
+
+export interface VirtualSubtreeAttribute {
+ type: "label" | "relation";
+ name: string;
+ value?: string;
+ isInheritable?: boolean;
+}
+
+const providers = new Map<string, VirtualNoteProvider>();
+
+/**
+ * Registers a provider. Re-registering the same namespace replaces the previous provider
+ * (making repeated initialization idempotent). Takes effect on the next becca load, so
+ * providers should be registered during application initialization, before the database
+ * is ready.
+ */
+export function registerVirtualNoteProvider(provider: VirtualNoteProvider) {
+ if (!provider.namespace.startsWith("_")) {
+ throw new Error(`Virtual note provider namespace must start with '_', got '${provider.namespace}'.`);
+ }
+
+ for (const existing of providers.keys()) {
+ if (existing === provider.namespace) {
+ continue; // same namespace replaces the previous registration
+ }
+
+ if (existing.startsWith(provider.namespace) || provider.namespace.startsWith(existing)) {
+ throw new Error(`Virtual note provider namespace '${provider.namespace}' overlaps with already registered namespace '${existing}'.`);
+ }
+ }
+
+ providers.set(provider.namespace, provider);
+}
+
+export function unregisterVirtualNoteProvider(namespace: string) {
+ providers.delete(namespace);
+}
+
+export function getVirtualNoteProviders(): VirtualNoteProvider[] {
+ return [...providers.values()];
+}
+
+/** Returns the provider owning the given note ID, based on its namespace prefix. */
+export function getVirtualNoteProvider(noteId: string): VirtualNoteProvider | null {
+ for (const provider of providers.values()) {
+ if (noteId.startsWith(provider.namespace)) {
+ return provider;
+ }
+ }
+
+ return null;
+}
+
+/** Content of a virtual note, delegated to its provider; `""` when the provider has none. */
+export function getVirtualNoteContent(noteId: string): string | Uint8Array {
+ return getVirtualNoteProvider(noteId)?.getContent?.(noteId) ?? "";
+}
+
+/** Whether the provider of a virtual note can save its content. */
+export function isVirtualNoteContentWritable(noteId: string) {
+ return !!getVirtualNoteProvider(noteId)?.setContent;
+}
+
+/** @throws ValidationError when the note's provider cannot save content. */
+export function setVirtualNoteContent(noteId: string, content: string | Uint8Array) {
+ const provider = getVirtualNoteProvider(noteId);
+ if (!provider?.setContent) {
+ throw new ValidationError(`Note '${noteId}' is read-only.`);
+ }
+
+ provider.setContent(noteId, content);
+}
+
+/** Assets of a virtual note, delegated to its provider; empty when the provider has none. */
+export function getVirtualNoteAssets(noteId: string): VirtualNoteAsset[] {
+ return getVirtualNoteProvider(noteId)?.getAssets?.(noteId) ?? [];
+}
+
+/**
+ * Rewrites the asset URLs in a virtual note's HTML into the references a persisted note uses for
+ * its attachments: `api/attachments/<id>/image/<title>` for a picture, an attachment link for any
+ * other file. The export rewrites those references to the exported files.
+ */
+export function referenceAssetsAsAttachments(noteId: string, content: string, assets: VirtualNoteAsset[]) {
+ for (const asset of assets) {
+ const attachmentLink = `#root/${noteId}?viewMode=attachments&attachmentId=${asset.id}`;
+ if (asset.mime.startsWith("image/")) {
+ content = content.replaceAll(`src="${asset.url}"`,
+ `src="api/attachments/${asset.id}/image/${encodeURIComponent(asset.title)}"`);
+ }
+ content = content.replaceAll(`href="${asset.url}"`, `href="${attachmentLink}"`);
+ }
+
+ return content;
+}
diff --git a/packages/trilium-e2e/src/help.spec.ts b/packages/trilium-e2e/src/help.spec.ts
index 52d1f7e27e..0b7504c8af 100644
--- a/packages/trilium-e2e/src/help.spec.ts
+++ b/packages/trilium-e2e/src/help.spec.ts
@@ -1,5 +1,5 @@
import { test, expect } from "@playwright/test";
-import App, { isStandalone } from "./support/app";
+import App from "./support/app";
test("Help popup", async ({ page, context }) => {
page.setDefaultTimeout(15_000);
@@ -11,7 +11,7 @@ test("Help popup", async ({ page, context }) => {
await expect(page.locator(".help-cards")).toBeVisible();
});
-test("In-app-help works in English", async ({ page, context }, testInfo) => {
+test("In-app-help works in English", async ({ page, context }) => {
const app = new App(page, context);
await app.goto();
@@ -20,22 +20,13 @@ test("In-app-help works in English", async ({ page, context }, testInfo) => {
await expect(app.noteTreeHoistedNote).toContainText(title);
await expect(app.currentNoteSplitTitle).toHaveValue(title);
- app.noteTree.getByText("Troubleshooting").click();
+ await app.noteTree.getByText("Troubleshooting").click();
await expect(app.currentNoteSplitTitle).toHaveValue("Troubleshooting");
- if (isStandalone(testInfo)) {
- // Standalone renders help as webView iframes pointing to docs site
- const iframe = app.currentNoteSplitContent.locator("iframe");
- await expect(iframe).toBeVisible();
- await expect(iframe).toHaveAttribute("src", /docs\.triliumnotes\.org.*troubleshooting/);
- } else {
- // Server/desktop renders help as inline doc content
- await app.currentNoteSplitContent.locator("p").first().waitFor({ state: "visible" });
- expect(await app.currentNoteSplitContent.locator("p").count()).toBeGreaterThan(10);
- }
+ await expectPageBody(app);
});
-test("In-app-help works in other languages", async ({ page, context }, testInfo) => {
+test("In-app-help works in other languages", async ({ page, context }) => {
const app = new App(page, context);
try {
await app.goto();
@@ -47,19 +38,18 @@ test("In-app-help works in other languages", async ({ page, context }, testInfo)
await expect(app.noteTreeHoistedNote).toContainText(title);
await expect(app.currentNoteSplitTitle).toHaveValue(title);
- app.noteTree.getByText("Troubleshooting").click();
+ await app.noteTree.getByText("Troubleshooting").click();
await expect(app.currentNoteSplitTitle).toHaveValue("Troubleshooting");
- if (isStandalone(testInfo)) {
- const iframe = app.currentNoteSplitContent.locator("iframe");
- await expect(iframe).toBeVisible();
- await expect(iframe).toHaveAttribute("src", /docs\.triliumnotes\.org.*troubleshooting/);
- } else {
- await app.currentNoteSplitContent.locator("p").first().waitFor({ state: "visible" });
- expect(await app.currentNoteSplitContent.locator("p").count()).toBeGreaterThan(10);
- }
+ await expectPageBody(app);
} finally {
// Ensure English is set after each locale change to avoid any leaks to other tests.
await app.setOption("locale", "en");
}
});
+
+/** Every platform now renders the guide from the shipped artifacts, so a page's body is inline HTML. */
+async function expectPageBody(app: App) {
+ await app.currentNoteSplitContent.locator("p").first().waitFor({ state: "visible" });
+ expect(await app.currentNoteSplitContent.locator("p").count()).toBeGreaterThan(10);
+}
diff --git a/renovate.json b/renovate.json
index fa8b9471cc..182bcb0f11 100644
--- a/renovate.json
+++ b/renovate.json
@@ -17,7 +17,6 @@
"ignorePaths": [
"**/node_modules/**",
"apps/edit-docs/demo/**",
- "apps/server/src/assets/doc_notes/**",
"docs/**",
"apps/server/Dockerfile.legacy",
"apps/mobile/android/**"
diff --git a/scripts/build-utils.ts b/scripts/build-utils.ts
index 77ac151621..2873280436 100644
--- a/scripts/build-utils.ts
+++ b/scripts/build-utils.ts
@@ -18,7 +18,11 @@ export default class BuildHelper {
mkdirSync(this.outDir, { recursive: true });
}
- copy(projectDirPath: string, outDirPath: string) {
+ /**
+ * @param opts.filter receives each source path and returns whether to copy it; directories are
+ * consulted too, so returning false for one skips its whole subtree.
+ */
+ copy(projectDirPath: string, outDirPath: string, opts?: { filter?: (sourcePath: string) => boolean }) {
let sourcePath: string;
if (projectDirPath.startsWith("/") || projectDirPath.startsWith("\\")) {
sourcePath = join(this.rootDir, projectDirPath.substring(1));
@@ -29,7 +33,7 @@ export default class BuildHelper {
if (outDirPath.endsWith("/")) {
mkdirSync(join(this.outDir, outDirPath), { recursive: true });
}
- cpSync(sourcePath, join(this.outDir, outDirPath), { recursive: true, dereference: true });
+ cpSync(sourcePath, join(this.outDir, outDirPath), { recursive: true, dereference: true, filter: opts?.filter });
}
deleteFromOutput(path: string) {
@@ -188,6 +192,11 @@ export default class BuildHelper {
this.copy(
"/node_modules/@agentclientprotocol/codex-acp/dist/index.js", "assets/codex-acp.mjs");
this.copy("/packages/share-theme/src/templates", "share-theme/templates/");
+ // The in-app help's images and attachments live with the User Guide; its pages travel as
+ // the content bundle in assets/help, so the Markdown and its meta stay out of the package.
+ this.copy("/docs/User Guide", "assets/help/", {
+ filter: (sourcePath) => !sourcePath.endsWith(".md") && !sourcePath.endsWith("!!!meta.json")
+ });
}
buildFrontend() {