Skip to content

Build your personal knowledge base with Trilium Notes

client/tree options: remake the UI

Adorian Doran031c1c657abf
diff --git a/apps/client/src/stylesheets/theme-next/shell.css b/apps/client/src/stylesheets/theme-next/shell.css
index abfe7ed593..89f75fef59 100644
--- a/apps/client/src/stylesheets/theme-next/shell.css
+++ b/apps/client/src/stylesheets/theme-next/shell.css
@@ -861,25 +861,6 @@ body[dir=rtl] :is(#left-pane, .tree-popup-sidebar) span.fancytree-node.protected
transition: color 200ms ease-out;
}
-/*
- * Tree settings popup
- */
-
-:is(#left-pane, .tree-popup-sidebar) .tree-settings-popup {
- box-shadow: 0px 10px 20px rgba(0, 0, 0, var(--dropdown-shadow-opacity));
- border: 1px solid var(--dropdown-border-color);
- padding: 25px;
- background: var(--menu-background-color);
- backdrop-filter: blur(10px) saturate(6);
- color: var(--menu-text-color);
-}
-
-:is(#left-pane, .tree-popup-sidebar) .tree-settings-popup h4 {
- margin-bottom: 0.75em;
- font-size: 1.5em;
- line-height: 1;
-}
-
/*
* TAB BAR
*/
diff --git a/apps/client/src/translations/en/translation.json b/apps/client/src/translations/en/translation.json
index c85fff7f50..b9c8ae6cf3 100644
--- a/apps/client/src/translations/en/translation.json
+++ b/apps/client/src/translations/en/translation.json
@@ -2824,7 +2824,6 @@
"automatically-collapse-notes-title": "Notes will be collapsed after period of inactivity to declutter the tree.",
"follow-active-note": "Follow active note",
"follow-active-note-title": "Scrolls the tree and expands parent nodes to show the active note. When disabled, the tree stays in place and only the background highlight is updated.",
- "save-changes": "Save & apply changes",
"auto-collapsing-notes-after-inactivity": "Auto collapsing notes after inactivity...",
"saved-search-note-refreshed": "Saved search note refreshed.",
"hoist-this-note-workspace": "Hoist this note (workspace)",
@@ -4383,7 +4382,8 @@
"exit_fullscreen": "Exit fullscreen",
"open_in_new_tab": "Open in new tab",
"more_actions": "More actions",
- "beta": "Beta"
+ "beta": "Beta",
+ "close": "Close"
},
"spreadsheet": {
"read-only": "This note is read-only.",
diff --git a/apps/client/src/widgets/note_tree.ts b/apps/client/src/widgets/note_tree.ts
index 30c0b3f101..bbf3ea0438 100644
--- a/apps/client/src/widgets/note_tree.ts
+++ b/apps/client/src/widgets/note_tree.ts
@@ -6,6 +6,7 @@ import "../stylesheets/tree.css";
import "./note_tree.css";
import { GEO_LOCATION_ATTRIBUTE, MAP_POSITION_ATTRIBUTE } from "@triliumnext/commons";
+import { h } from "preact";
import appContext, { type CommandListenerData, type EventData } from "../components/app_context.js";
import type { SetNoteOpts } from "../components/note_context.js";
@@ -30,6 +31,8 @@ import treeService from "../services/tree.js";
import utils from "../services/utils.js";
import ws from "../services/ws.js";
import NoteContextAwareWidget from "./note_context_aware_widget.js";
+import TreeSettings from "./note_tree_settings.jsx";
+import { disposeReactWidget, renderReactWidgetAtElement } from "./react/react_utils.jsx";
const TPL = /*html*/`
<div class="tree-wrapper">
@@ -91,17 +94,6 @@ const TPL = /*html*/`
inset-inline-end: 10px;
}
- .tree-settings-popup {
- display: none;
- position: absolute;
- background-color: var(--accented-background-color);
- border: 1px solid var(--main-border-color);
- padding: 20px;
- z-index: 1000;
- width: 340px;
- border-radius: 10px;
- }
-
.tree .hidden-node-is-hidden {
display: none;
}
@@ -121,37 +113,6 @@ const TPL = /*html*/`
<button class="tree-floating-button bx bxs-tree tree-settings-button"
title="${t("note_tree.tree-settings-title")}"></button>
</div>
-
-
- <div class="tree-settings-popup">
- <h4>${t("note_tree.tree-settings-title")}</h4>
- <div class="form-check">
- <label class="form-check-label tn-checkbox">
- <input class="form-check-input hide-archived-notes" type="checkbox" value="">
- ${t("note_tree.hide-archived-notes")}
- </label>
- </div>
- <div class="form-check">
- <label class="form-check-label tn-checkbox">
- <input class="form-check-input auto-collapse-note-tree" type="checkbox" value="">
- ${t("note_tree.automatically-collapse-notes")}
- <span class="bx bx-info-circle"
- title="${t("note_tree.automatically-collapse-notes-title")}"></span>
- </label>
- </div>
- <div class="form-check">
- <label class="form-check-label tn-checkbox">
- <input class="form-check-input follow-active-note" type="checkbox" value="">
- ${t("note_tree.follow-active-note")}
- <span class="bx bx-info-circle"
- title="${t("note_tree.follow-active-note-title")}"></span>
- </label>
- </div>
-
- <br/>
-
- <button class="btn btn-sm btn-primary save-tree-settings-button" type="submit">${t("note_tree.save-changes")}</button>
- </div>
</div>
`;
@@ -190,12 +151,8 @@ const BATCH_UPDATE_THRESHOLD = 10;
export default class NoteTreeWidget extends NoteContextAwareWidget {
private $tree!: JQuery<HTMLElement>;
private $treeActions!: JQuery<HTMLElement>;
- private $treeSettingsButton!: JQuery<HTMLElement>;
- private $treeSettingsPopup!: JQuery<HTMLElement>;
- private $saveTreeSettingsButton!: JQuery<HTMLElement>;
- private $hideArchivedNotesCheckbox!: JQuery<HTMLElement>;
- private $autoCollapseNoteTree!: JQuery<HTMLElement>;
- private $followActiveNoteCheckbox!: JQuery<HTMLElement>;
+ private settingsContainer = document.createElement("div");
+ private isSettingsShown = false;
private treeName: "main";
private autoCollapseTimeoutId?: Timeout;
private lastFilteredHoistedNotePath?: string | null;
@@ -262,50 +219,8 @@ export default class NoteTreeWidget extends NoteContextAwareWidget {
}
});
- this.$treeSettingsPopup = this.$widget.find(".tree-settings-popup");
- this.$hideArchivedNotesCheckbox = this.$treeSettingsPopup.find(".hide-archived-notes");
- this.$autoCollapseNoteTree = this.$treeSettingsPopup.find(".auto-collapse-note-tree");
- this.$followActiveNoteCheckbox = this.$treeSettingsPopup.find(".follow-active-note");
-
- this.$treeSettingsButton = this.$widget.find(".tree-settings-button");
- this.$treeSettingsButton.on("click", (e) => {
- if (this.$treeSettingsPopup.is(":visible")) {
- this.$treeSettingsPopup.hide();
- return;
- }
-
- this.$hideArchivedNotesCheckbox.prop("checked", this.hideArchivedNotes);
- this.$autoCollapseNoteTree.prop("checked", this.autoCollapseNoteTree);
- this.$followActiveNoteCheckbox.prop("checked", this.treeScrollFollowNavigation);
-
- const top = this.$treeActions[0].offsetTop - (this.$treeSettingsPopup.outerHeight() ?? 0);
- const left = Math.max(0, this.$treeActions[0].offsetLeft - (this.$treeSettingsPopup.outerWidth() ?? 0) + (this.$treeActions.outerWidth() ?? 0));
-
- this.$treeSettingsPopup
- .css({
- top,
- left
- })
- .show();
-
- return false;
- });
-
- this.$treeSettingsPopup.on("click", (e) => {
- e.stopPropagation();
- });
-
- $(document).on("click", () => this.$treeSettingsPopup.hide());
-
- this.$saveTreeSettingsButton = this.$treeSettingsPopup.find(".save-tree-settings-button");
- this.$saveTreeSettingsButton.on("click", async () => {
- await this.setHideArchivedNotes(this.$hideArchivedNotesCheckbox.prop("checked"));
- await this.setAutoCollapseNoteTree(this.$autoCollapseNoteTree.prop("checked"));
- await this.setTreeScrollFollowNavigation(this.$followActiveNoteCheckbox.prop("checked"));
-
- this.$treeSettingsPopup.hide();
-
- this.reloadTreeFromCache();
+ this.$widget.find(".tree-settings-button").on("click", () => {
+ this.toggleSettings(!this.isSettingsShown);
});
// note tree starts initializing already during render which is atypical
@@ -349,24 +264,34 @@ export default class NoteTreeWidget extends NoteContextAwareWidget {
await this.reloadTreeFromCache();
}
- async setHideArchivedNotes(val: string) {
- await options.save(`hideArchivedNotes_${this.treeName}`, val.toString());
- }
-
get autoCollapseNoteTree() {
return options.is("autoCollapseNoteTree");
}
- async setAutoCollapseNoteTree(val: string) {
- await options.save("autoCollapseNoteTree", val.toString());
- }
-
get treeScrollFollowNavigation() {
return options.is("treeScrollFollowNavigation");
}
- async setTreeScrollFollowNavigation(val: boolean) {
- await options.save("treeScrollFollowNavigation", val.toString());
+ private toggleSettings(isShown: boolean) {
+ if (isShown === this.isSettingsShown) {
+ return;
+ }
+
+ this.isSettingsShown = isShown;
+ if (!isShown) {
+ disposeReactWidget(this.settingsContainer);
+ return;
+ }
+
+ renderReactWidgetAtElement(this, h(TreeSettings, {
+ anchor: this.$treeActions[0],
+ onHideArchivedNotesChange: () => this.reloadTreeFromCache(),
+ onClose: () => this.toggleSettings(false)
+ }), this.settingsContainer);
+ }
+
+ cleanup() {
+ this.toggleSettings(false);
}
initFancyTree() {
@@ -1137,7 +1062,7 @@ export default class NoteTreeWidget extends NoteContextAwareWidget {
async refresh() {
this.toggleInt(this.isEnabled());
- this.$treeSettingsPopup.hide();
+ this.toggleSettings(false);
this.activityDetected();
diff --git a/apps/client/src/widgets/note_tree_settings.css b/apps/client/src/widgets/note_tree_settings.css
new file mode 100644
index 0000000000..990aef286d
--- /dev/null
+++ b/apps/client/src/widgets/note_tree_settings.css
@@ -0,0 +1,28 @@
+:where(:root) {
+ --tree-settings-shadow-color: black;
+ --tree-settings-border-color: var(--main-border-color);
+ --tree-settings-background-color: var(--accented-background-color);
+}
+
+.tree-settings {
+ box-shadow: 10px 10px 93px -25px var(--tree-settings-shadow-color);
+ border: 1px solid var(--tree-settings-border-color);
+ border-radius: 4px;
+ padding: 15px;
+ width: 400px;
+ max-width: calc(100vw - 20px);
+ background-color: var(--tree-settings-background-color);
+ overflow: auto;
+
+ .tree-settings-header {
+ display: flex;
+ align-items: center;
+ gap: 8px;
+ margin-bottom: 8px;
+ }
+
+ .tree-settings-title {
+ margin: 0;
+ margin-inline-end: auto;
+ }
+}
diff --git a/apps/client/src/widgets/note_tree_settings.spec.tsx b/apps/client/src/widgets/note_tree_settings.spec.tsx
new file mode 100644
index 0000000000..09927bef5f
--- /dev/null
+++ b/apps/client/src/widgets/note_tree_settings.spec.tsx
@@ -0,0 +1,140 @@
+import { render } from "preact";
+import { act } from "preact/test-utils";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+
+import options from "../services/options";
+import { renderInto } from "../test/render";
+import TreeSettings, { inlineEndEdge, type TreeSettingsProps } from "./note_tree_settings";
+
+vi.mock("../services/i18n", async (importOriginal) => ({
+ ...await importOriginal<typeof import("../services/i18n")>(),
+ t: (key: string) => key
+}));
+
+describe("TreeSettings", () => {
+ let anchor: HTMLElement;
+
+ beforeEach(() => {
+ anchor = document.createElement("div");
+ document.body.append(anchor);
+ options.set("hideArchivedNotes_main", "false");
+ options.set("autoCollapseNoteTree", "true");
+ options.set("treeScrollFollowNavigation", "true");
+ });
+
+ afterEach(() => {
+ anchor.remove();
+ vi.restoreAllMocks();
+ });
+
+ function open(props: Partial<TreeSettingsProps> = {}) {
+ renderInto(
+ <TreeSettings
+ anchor={anchor}
+ onHideArchivedNotesChange={vi.fn()}
+ onClose={vi.fn()}
+ {...props}
+ />
+ );
+ const popup = document.querySelector<HTMLElement>(".tree-settings.tn-tool-dialog");
+ if (!popup) throw new Error("Expected the tree settings popup.");
+ return popup;
+ }
+
+ function toggleNamed(popup: HTMLElement, name: string) {
+ const toggle = popup.querySelector<HTMLInputElement>(`input.switch-toggle[id^="${name}-"]`);
+ if (!toggle) throw new Error(`No ${name} toggle.`);
+ return toggle;
+ }
+
+ async function flip(popup: HTMLElement, name: string) {
+ await act(async () => {
+ toggleNamed(popup, name).dispatchEvent(new Event("input", { bubbles: true }));
+ });
+ }
+
+ it("shows each option as a toggle holding its value, with no save button", () => {
+ const popup = open();
+
+ expect(popup.getAttribute("role")).toBe("dialog");
+ const title = popup.querySelector(".tree-settings-title");
+ expect(title?.textContent).toBe("note_tree.tree-settings-title");
+ expect(popup.getAttribute("aria-labelledby")).toBe(title?.id);
+ expect(toggleNamed(popup, "hide-archived-notes").checked).toBe(false);
+ expect(toggleNamed(popup, "auto-collapse-note-tree").checked).toBe(true);
+ expect(toggleNamed(popup, "follow-active-note").checked).toBe(true);
+ expect(popup.querySelectorAll("button")).toHaveLength(1);
+ });
+
+ it("saves each change at once and reloads the tree only for archived notes", async () => {
+ const save = vi.spyOn(options, "save");
+ const onHideArchivedNotesChange = vi.fn();
+ const popup = open({ onHideArchivedNotesChange });
+
+ await flip(popup, "follow-active-note");
+ expect(save).toHaveBeenLastCalledWith("treeScrollFollowNavigation", "false");
+
+ await flip(popup, "auto-collapse-note-tree");
+ expect(save).toHaveBeenLastCalledWith("autoCollapseNoteTree", "false");
+ expect(onHideArchivedNotesChange).not.toHaveBeenCalled();
+
+ await flip(popup, "hide-archived-notes");
+ expect(save).toHaveBeenLastCalledWith("hideArchivedNotes_main", "true");
+ expect(onHideArchivedNotesChange).toHaveBeenCalledOnce();
+ expect(toggleNamed(popup, "hide-archived-notes").checked).toBe(true);
+ });
+
+ it("closes from its close button or a press outside, not from the settings button", () => {
+ const settingsButton = document.createElement("button");
+ settingsButton.className = "tree-settings-button";
+ anchor.append(settingsButton);
+ const onClose = vi.fn();
+ const popup = open({ onClose });
+
+ settingsButton.dispatchEvent(new PointerEvent("pointerdown", { bubbles: true }));
+ expect(onClose).not.toHaveBeenCalled();
+
+ document.body.dispatchEvent(new PointerEvent("pointerdown", { bubbles: true }));
+ expect(onClose).toHaveBeenCalledOnce();
+
+ popup.querySelector<HTMLButtonElement>(".tree-settings-header button")?.click();
+ expect(onClose).toHaveBeenCalledTimes(2);
+ });
+
+ it("stays at the toolbar's end edge while the toolbar collapses", async () => {
+ vi.spyOn(document.documentElement, "clientWidth", "get").mockReturnValue(1000);
+ vi.spyOn(document.documentElement, "clientHeight", "get").mockReturnValue(800);
+ vi.spyOn(HTMLElement.prototype, "offsetWidth", "get").mockReturnValue(400);
+ vi.spyOn(HTMLElement.prototype, "offsetHeight", "get").mockReturnValue(100);
+ const rect = vi.spyOn(anchor, "getBoundingClientRect");
+
+ // Expanded and collapsed widths, both ending at x = 300.
+ const placements: string[] = [];
+ for (const [ x, width ] of [ [ 100, 200 ], [ 260, 40 ] ]) {
+ rect.mockReturnValue(DOMRect.fromRect({ x, y: 700, width, height: 30 }));
+ const container = renderInto(
+ <TreeSettings
+ anchor={anchor}
+ onHideArchivedNotesChange={vi.fn()}
+ onClose={vi.fn()}
+ />
+ );
+ const popup = document.querySelector<HTMLElement>(".tree-settings");
+ await vi.waitFor(() => expect(popup?.style.visibility).toBe("visible"));
+ placements.push(`${popup?.style.left} ${popup?.style.top}`);
+ act(() => render(null, container));
+ }
+
+ expect(placements).toEqual([ "300px 592px", "300px 592px" ]);
+ });
+
+ it("takes the left edge as the end edge in a right-to-left layout", () => {
+ vi.spyOn(anchor, "getBoundingClientRect")
+ .mockReturnValue(DOMRect.fromRect({ x: 100, y: 700, width: 200, height: 30 }));
+
+ expect(inlineEndEdge(anchor).getBoundingClientRect().x).toBe(300);
+ anchor.style.direction = "rtl";
+ expect(inlineEndEdge(anchor).getBoundingClientRect())
+ .toMatchObject({ x: 100, width: 0, y: 700 });
+ });
+});
diff --git a/apps/client/src/widgets/note_tree_settings.tsx b/apps/client/src/widgets/note_tree_settings.tsx
new file mode 100644
index 0000000000..55118752e4
--- /dev/null
+++ b/apps/client/src/widgets/note_tree_settings.tsx
@@ -0,0 +1,99 @@
+import "./note_tree_settings.css";
+
+import type { ReferenceElement } from "@floating-ui/dom";
+import { useEffect, useMemo } from "preact/hooks";
+
+import { t } from "../services/i18n.js";
+import ActionButton from "./react/ActionButton.jsx";
+import { useTriliumOptionBool, useUniqueName } from "./react/hooks.jsx";
+import { suspendModalFocusTraps } from "./react/modal_focustrap.js";
+import Popup from "./react/Popup.jsx";
+import { OptionsRowWithToggle } from "./type_widgets/options/components/OptionsRow.jsx";
+
+export interface TreeSettingsProps {
+ /** The tree toolbar. The popup opens above its inline-end edge. */
+ anchor: HTMLElement;
+ /** Called after the archived notes option is saved, so the tree can reload. */
+ onHideArchivedNotesChange: () => void;
+ onClose: () => void;
+}
+
+/** The note tree settings popup. Each toggle saves its option as soon as it changes. */
+export default function TreeSettings(props: TreeSettingsProps) {
+ const { anchor, onHideArchivedNotesChange, onClose } = props;
+ const [ isArchivedHidden, setArchivedHidden ] = useTriliumOptionBool("hideArchivedNotes_main");
+ const [ isAutoCollapsed, setAutoCollapsed ] = useTriliumOptionBool("autoCollapseNoteTree");
+ const [ isFollowingActiveNote, setFollowingActiveNote ] =
+ useTriliumOptionBool("treeScrollFollowNavigation");
+ const titleId = useUniqueName("tree-settings-title");
+ // The toolbar's start edge moves when it collapses. Its end edge does not.
+ const reference = useMemo(() => inlineEndEdge(anchor), [ anchor ]);
+
+ // The popup is outside the tree popup editor's modal, so the modal's focus trap is paused.
+ useEffect(() => suspendModalFocusTraps(), []);
+
+ return (
+ <Popup
+ anchor={reference}
+ placement="top-end"
+ offset={8}
+ reveal
+ role="dialog"
+ aria-labelledby={titleId}
+ className="tree-settings tn-tool-dialog"
+ // The settings button closes the popup through its own click handler.
+ keepOpenSelector=".tree-settings-button"
+ onDismiss={onClose}
+ >
+ <div className="tree-settings-header">
+ <h5 id={titleId} className="tree-settings-title">
+ {t("note_tree.tree-settings-title")}
+ </h5>
+ <ActionButton
+ icon="bx bx-x"
+ text={t("common.close")}
+ tooltipClass="tooltip-top"
+ onClick={onClose}
+ />
+ </div>
+
+ <OptionsRowWithToggle
+ name="hide-archived-notes"
+ label={t("note_tree.hide-archived-notes")}
+ currentValue={isArchivedHidden}
+ onChange={async (isHidden) => {
+ await setArchivedHidden(isHidden);
+ onHideArchivedNotesChange();
+ }}
+ />
+
+ <OptionsRowWithToggle
+ name="auto-collapse-note-tree"
+ label={t("note_tree.automatically-collapse-notes")}
+ description={t("note_tree.automatically-collapse-notes-title")}
+ currentValue={isAutoCollapsed}
+ onChange={setAutoCollapsed}
+ />
+
+ <OptionsRowWithToggle
+ name="follow-active-note"
+ label={t("note_tree.follow-active-note")}
+ description={t("note_tree.follow-active-note-title")}
+ currentValue={isFollowingActiveNote}
+ onChange={setFollowingActiveNote}
+ />
+ </Popup>
+ );
+}
+
+/** A zero-width reference on the inline-end edge of `element`, for Floating UI. */
+export function inlineEndEdge(element: HTMLElement): ReferenceElement {
+ return {
+ getBoundingClientRect() {
+ const { left, right, y, height } = element.getBoundingClientRect();
+ const edge = getComputedStyle(element).direction === "rtl" ? left : right;
+ return DOMRect.fromRect({ x: edge, y, width: 0, height });
+ },
+ contextElement: element
+ };
+}
diff --git a/apps/server/src/assets/help/help_content.json b/apps/server/src/assets/help/help_content.json
index 8c62b0194f..10614b2bb5 100644
--- a/apps/server/src/assets/help/help_content.json
+++ b/apps/server/src/assets/help/help_content.json
@@ -37,7 +37,7 @@
"_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_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. Each option is a toggle that takes effect as soon as it is switched:</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><li><kbd>Alt</kbd>+<kbd>S</kbd> - sorts the child notes of the note (see&nbsp;<a class=\"reference-link\" href=\"#root/_help_aGlEvb9hyDhS\">Sorting Notes</a>).</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>",
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 3de153cde1..4a1c512d6c 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
@@ -34,7 +34,7 @@ See <a class="reference-link" href="Note%20Tree/Note%20tree%20contextual%20menu
## Tree Settings
-Click the tree icon in the tree toolbar to open the tree settings popup. It contains the following options:
+Click the tree icon in the tree toolbar to open the tree settings popup. Each option is a toggle that takes effect as soon as it is switched:
* _Hide archived notes_: When enabled, archived notes are not shown in the tree.
* _Automatically collapse notes_: When enabled, notes are collapsed after a period of inactivity to keep the tree tidy.