Build your personal knowledge base with Trilium Notes
TypeScript electronelectron-appknowledge-baseknowledge-graphknowledge-managementknowledge-management-graphlocal-firstnote-managmentnote-takernote-takingnotebooknotesnotes-apppersonal-knowledge-basepersonal-wikiscriptableself-hostedself-hostingwiki
feat(presentation): move through the slide sidebar with the keyboard
Elian Doran2247ee72cd7e
diff --git a/apps/client/src/widgets/collections/presentation/sidebar.spec.tsx b/apps/client/src/widgets/collections/presentation/sidebar.spec.tsxindex c05d9c0794..aba88c1c7c 100644--- a/apps/client/src/widgets/collections/presentation/sidebar.spec.tsx+++ b/apps/client/src/widgets/collections/presentation/sidebar.spec.tsx@@ -108,6 +108,56 @@ describe("SlideSidebar", () => {button.dispatchEvent(mouseDown);expect(mouseDown.defaultPrevented).toBe(true);});++ it("takes one tab stop, on the active slide or else the first", () => {+ const sidebar = renderSidebar({ activeNoteId: "second" });+ const getTabStops = () => [ ...sidebar.querySelectorAll<HTMLButtonElement>(".slide-thumbnail-button") ]+ .filter(button => button.tabIndex === 0)+ .map(button => button.querySelector("[data-note-id]")?.getAttribute("data-note-id"));+ expect(getTabStops()).toEqual([ "second" ]);++ renderSidebar({ activeNoteId: undefined, container: sidebar.parentElement ?? undefined });+ expect(getTabStops()).toEqual([ "intro" ]);+ });++ it("moves through the slides in order with the arrow keys, Home and End, keeping them from Reveal.js", () => {+ const onSelectSlide = vi.fn();+ const sidebar = renderSidebar({ onSelectSlide });+ const documentKeys: string[] = [];+ const onDocumentKey = (e: KeyboardEvent) => documentKeys.push(e.key);+ document.addEventListener("keydown", onDocumentKey);+ const press = (noteId: string, key: string) => {+ const event = new KeyboardEvent("keydown", { key, bubbles: true, cancelable: true });+ getButton(sidebar, noteId).dispatchEvent(event);+ return event;+ };++ expect(press("intro", "ArrowDown").defaultPrevented).toBe(true);+ press("second", "ArrowDown");+ press("first", "ArrowUp");+ press("first", "End");+ press("web", "Home");+ press("board", "ArrowDown");+ press("intro", "ArrowUp");+ expect(onSelectSlide.mock.calls).toEqual([ [ "first" ], [ "web" ], [ "intro" ], [ "board" ], [ "intro" ] ]);++ // Other keys still reach Reveal.js.+ expect(press("intro", "ArrowRight").defaultPrevented).toBe(false);+ expect(documentKeys).toEqual([ "ArrowRight" ]);+ document.removeEventListener("keydown", onDocumentKey);+ });++ it("moves the focus with the active slide, but only while the focus is in the sidebar", () => {+ const sidebar = renderSidebar({ activeNoteId: "intro" });+ const container = sidebar.parentElement ?? undefined;++ renderSidebar({ activeNoteId: "first", container });+ expect(document.activeElement).not.toBe(getButton(sidebar, "first"));++ getButton(sidebar, "first").focus();+ renderSidebar({ activeNoteId: "web", container });+ expect(document.activeElement).toBe(getButton(sidebar, "web"));+ });});function getButton(sidebar: HTMLElement, noteId: string) {diff --git a/apps/client/src/widgets/collections/presentation/sidebar.tsx b/apps/client/src/widgets/collections/presentation/sidebar.tsxindex d3c2869416..a7a715fbe6 100644--- a/apps/client/src/widgets/collections/presentation/sidebar.tsx+++ b/apps/client/src/widgets/collections/presentation/sidebar.tsx@@ -35,11 +35,36 @@ export default function SlideSidebar({const sheets = useMemo(() => buildStyleSheets([ ...stylesheets, thumbnailStylesheet ]), [ stylesheets ]);const fitObserver = useFitObserver();const listRef = useRef<HTMLOListElement>(null);+ // In the order of the thumbnails, vertical slides included.+ const noteIds = presentation.slides.flatMap(slide => [+ slide.noteId, ...slide.verticalSlides?.map(verticalSlide => verticalSlide.noteId) ?? []+ ]);+ const tabStopNoteId = activeNoteId && noteIds.includes(activeNoteId) ? activeNoteId : noteIds[0];useEffect(() => {- listRef.current?.querySelector(".slide-thumbnail.active")?.scrollIntoView({ block: "nearest" });+ const list = listRef.current;+ if (!list) return;+ list.querySelector(".slide-thumbnail.active")?.scrollIntoView({ block: "nearest" });+ // The focus follows the slide only once it is in the sidebar, so that it stays in the slides otherwise.+ if (list.contains(document.activeElement)) {+ list.querySelector<HTMLElement>(".slide-thumbnail-button[aria-current]")?.focus();+ }}, [ activeNoteId ]);+ function onKeyDown(e: KeyboardEvent) {+ const button = e.target instanceof Element ? e.target.closest(".slide-thumbnail-button") : null;+ const buttons = [ ...listRef.current?.querySelectorAll(".slide-thumbnail-button") ?? [] ];+ const index = button ? buttons.indexOf(button) : -1;+ if (index < 0) return;++ const nextIndex = getNextIndex(e.key, index, noteIds.length);+ if (nextIndex === undefined) return;+ // Reveal.js listens to the whole document, and would move by the same key too.+ e.preventDefault();+ e.stopPropagation();+ if (nextIndex !== index) onSelectSlide(noteIds[nextIndex]);+ }+function renderThumbnail(slide: PresentationSlideBaseModel) {const closingContent = closingContents[slide.noteId];const isActive = slide.noteId === activeNoteId;@@ -47,6 +72,7 @@ export default function SlideSidebar({<buttontype="button"className="slide-thumbnail-button"+ tabIndex={slide.noteId === tabStopNoteId ? 0 : -1}aria-label={froca.getNoteFromCache(slide.noteId)?.title}aria-current={isActive ? "true" : undefined}// Keeps the focus where it was, so that Space still moves through the slides.@@ -64,7 +90,7 @@ export default function SlideSidebar({}return (- <ol ref={listRef} className="presentation-sidebar">+ <ol ref={listRef} className="presentation-sidebar" onKeyDown={onKeyDown}>{presentation.slides.map(slide => (<li key={slide.noteId}>{renderThumbnail(slide)}@@ -147,6 +173,20 @@ function ThumbnailContent({ slide, sheets, fitObserver }: ThumbnailContentProps));}+/**+ * Returns the index of the thumbnail that `key` moves to from the one at `index`, or `undefined` for+ * a key the sidebar leaves alone. At either end, the arrow keys stay where they are.+ */+function getNextIndex(key: string, index: number, count: number) {+ switch (key) {+ case "ArrowUp": return Math.max(index - 1, 0);+ case "ArrowDown": return Math.min(index + 1, count - 1);+ case "Home": return 0;+ case "End": return count - 1;+ default: return undefined;+ }+}+/** Creates the observer that zooms out thumbnails whose content is larger than the slide. */function useFitObserver() {const [ fitObserver, setFitObserver ] = useState<ResizeObserver>();diff --git a/apps/server/src/assets/help/help_content.json b/apps/server/src/assets/help/help_content.jsonindex 19846a5651..73b8d14c53 100644--- a/apps/server/src/assets/help/help_content.json+++ b/apps/server/src/assets/help/help_content.json@@ -180,7 +180,7 @@"_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. The desktop application on Linux does not offer it either, because it has no way to find the location of the device there.</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 <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> 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 <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 <a class=\"reference-link\" href=\"#root/_help_47ZrP6FNuoG8\">Default Note Title</a> 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 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 <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 <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 <a class=\"reference-link\" href=\"#root/_help_lgKX7r3aL30x\">Note Tooltip</a> 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 <a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a> 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 <a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a> 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. 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 <a class=\"reference-link\" href=\"#root/_help_C2H9HK4BzwG7\">Drawing shapes</a> 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 <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 & 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 <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>.</li></ul><p>To set a map as read-only, go to <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <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 <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 & 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 <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 & 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 <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> or from the settings menu of the <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 <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. </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 <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> or from the settings menu of the <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 & 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 <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 <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 <width>,<height></code>) as the corners.</p><aside class=\"admonition tip\"><p>To draw freely over an image instead of placing notes on it, consider a <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 <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> 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><li>A <a class=\"reference-link\" href=\"#root/_help_CtBQqbwXDx1w\">Kanban Board</a> or <a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a> collection is shown as one slide, working as it does in the note itself, so its children are not laid out as vertical slides. Other collections keep their children as vertical slides.</li><li>Slides have a fixed 16:9 shape (1280×720). The preview in the note is a scaled-down copy of what is shown in full-screen, so content that fits in the preview fits when presenting. When the window or the screen has a different shape, the slide is centered with bars around it.</li><li>A slide whose content is larger than the slide is zoomed out until it fits, text included. To keep the text large, split the content over several slides.</li></ul><h2>Interaction and navigation</h2><p>A sidebar to the left of the slides shows a thumbnail of every slide in the presentation's theme, with vertical slides indented under the slide they belong to. The slide being shown is outlined, and the sidebar scrolls to keep it in view. Click a thumbnail to go to its slide. Web view, <a class=\"reference-link\" href=\"#root/_help_CtBQqbwXDx1w\">Kanban Board</a> and <a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a> slides are shown as an icon. The sidebar is hidden when the note is too narrow to fit it.</p><p>In the floating toolbar (top-right):</p><ul><li><span class=\"tn-icon bx bx-plus\"></span> <em>New slide</em> button to add an empty text slide after the slide being shown, at the same level: after a slide and its vertical slides, or among the vertical slides. The presentation goes to the new slide and starts editing it in place. A <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a> presentation doesn't show it, and neither does one made from a search.</li><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> (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 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>Editing a slide in place</h2><p>Double-click a slide made from a text note to edit it directly on the slide, in the presentation's theme. A dashed outline marks the slide being edited, and the formatting toolbar appears next to the selected text. Changes are saved as you type, as in any text note, and a slide that grows past the edge of the slide is zoomed out to fit.</p><p>To finish editing, press <kbd>Esc</kbd>, press the <span class=\"tn-icon bx bx-check\"></span> <em>Finish editing</em> button in the floating toolbar or go to another slide. Starting the presentation in full-screen also finishes editing, and slides can't be edited in full-screen.</p><p>A <a class=\"reference-link\" href=\"#root/_help_CtBQqbwXDx1w\">Kanban Board</a> or <a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a> slide is read-only until it is edited, so that a card or a cell can't be changed by accident while presenting, and clicking a card or a row opens nothing. Double-click it to edit it on the slide as in its note, then press the <span class=\"tn-icon bx bx-check\"></span> <em>Finish editing</em> button or go to another slide to finish.</p><p>Slides of other note types, such as diagrams or canvases, are edited from their note, using the <span class=\"tn-icon bx bx-edit\"></span> <em>Edit this slide</em> button. A <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a> presentation can't be edited in place, and neither can a slide whose own note is read-only.</p><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 & 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 <a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a> 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 <a class=\"reference-link\" href=\"#root/_help_AlhDUqhENtH7\">Custom app-wide CSS</a> 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 <a class=\"reference-link\" href=\"#root/_help_0ESUbbAxVnoK\">Note List</a> so it should be able to display <a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a>, <a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a> and <a class=\"reference-link\" href=\"#root/_help_gBbsAeiuUxI5\">Mind Map</a> in full-screen (without the interactivity).<ul><li><p>A <a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a> takes on the light or dark style of the theme, or of the slide's own background color.</p></li><li><p>For <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><li>A <a class=\"reference-link\" href=\"#root/_help_1vHRoWCEjj0L\">Web View</a> slide shows its page across the whole slide, and the page can be scrolled and its links clicked. The keyboard stays with the presentation, so <kbd>Space</kbd> and the arrow keys still change slides after clicking the page; to type into the page, open the web view note itself. Only <code>http://</code> and <code>https://</code> addresses are shown. It works the same way as the web view note itself, so outside the desktop application some websites refuse to be shown.</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_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 <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> 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><li>A <a class=\"reference-link\" href=\"#root/_help_CtBQqbwXDx1w\">Kanban Board</a> or <a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a> collection is shown as one slide, working as it does in the note itself, so its children are not laid out as vertical slides. Other collections keep their children as vertical slides.</li><li>Slides have a fixed 16:9 shape (1280×720). The preview in the note is a scaled-down copy of what is shown in full-screen, so content that fits in the preview fits when presenting. When the window or the screen has a different shape, the slide is centered with bars around it.</li><li>A slide whose content is larger than the slide is zoomed out until it fits, text included. To keep the text large, split the content over several slides.</li></ul><h2>Interaction and navigation</h2><p>A sidebar to the left of the slides shows a thumbnail of every slide in the presentation's theme, with vertical slides indented under the slide they belong to. The slide being shown is outlined, and the sidebar scrolls to keep it in view. Click a thumbnail to go to its slide. From the keyboard, press <kbd>Tab</kbd> to reach the sidebar, then <kbd>↑</kbd> and <kbd>↓</kbd> to go to the previous or next slide in order, vertical slides included, or <kbd>Home</kbd> and <kbd>End</kbd> to go to the first or last slide. Web view, <a class=\"reference-link\" href=\"#root/_help_CtBQqbwXDx1w\">Kanban Board</a> and <a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a> slides are shown as an icon. The sidebar is hidden when the note is too narrow to fit it.</p><p>In the floating toolbar (top-right):</p><ul><li><span class=\"tn-icon bx bx-plus\"></span> <em>New slide</em> button to add an empty text slide after the slide being shown, at the same level: after a slide and its vertical slides, or among the vertical slides. The presentation goes to the new slide and starts editing it in place. A <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a> presentation doesn't show it, and neither does one made from a search.</li><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> (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 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>Editing a slide in place</h2><p>Double-click a slide made from a text note to edit it directly on the slide, in the presentation's theme. A dashed outline marks the slide being edited, and the formatting toolbar appears next to the selected text. Changes are saved as you type, as in any text note, and a slide that grows past the edge of the slide is zoomed out to fit.</p><p>To finish editing, press <kbd>Esc</kbd>, press the <span class=\"tn-icon bx bx-check\"></span> <em>Finish editing</em> button in the floating toolbar or go to another slide. Starting the presentation in full-screen also finishes editing, and slides can't be edited in full-screen.</p><p>A <a class=\"reference-link\" href=\"#root/_help_CtBQqbwXDx1w\">Kanban Board</a> or <a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a> slide is read-only until it is edited, so that a card or a cell can't be changed by accident while presenting, and clicking a card or a row opens nothing. Double-click it to edit it on the slide as in its note, then press the <span class=\"tn-icon bx bx-check\"></span> <em>Finish editing</em> button or go to another slide to finish.</p><p>Slides of other note types, such as diagrams or canvases, are edited from their note, using the <span class=\"tn-icon bx bx-edit\"></span> <em>Edit this slide</em> button. A <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a> presentation can't be edited in place, and neither can a slide whose own note is read-only.</p><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 & 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 <a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a> 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 <a class=\"reference-link\" href=\"#root/_help_AlhDUqhENtH7\">Custom app-wide CSS</a> 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 <a class=\"reference-link\" href=\"#root/_help_0ESUbbAxVnoK\">Note List</a> so it should be able to display <a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a>, <a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a> and <a class=\"reference-link\" href=\"#root/_help_gBbsAeiuUxI5\">Mind Map</a> in full-screen (without the interactivity).<ul><li><p>A <a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a> takes on the light or dark style of the theme, or of the slide's own background color.</p></li><li><p>For <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><li>A <a class=\"reference-link\" href=\"#root/_help_1vHRoWCEjj0L\">Web View</a> slide shows its page across the whole slide, and the page can be scrolled and its links clicked. The keyboard stays with the presentation, so <kbd>Space</kbd> and the arrow keys still change slides after clicking the page; to type into the page, open the web view note itself. Only <code>http://</code> and <code>https://</code> addresses are shown. It works the same way as the web view note itself, so outside the desktop application some websites refuse to be shown.</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 <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> notes, the text can be slightly scrollable via the mouse wheel to reveal more context.</li><li>For <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> notes, syntax highlighting is applied, with line numbers as in the editor.</li><li>For <a class=\"reference-link\" href=\"#root/_help_W8vYD3Q1zjCR\">File</a> 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 <a class=\"reference-link\" href=\"#root/_help_0ESUbbAxVnoK\">Note List</a> 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 <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> 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 <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 <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> 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 <a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a> toolbar, the buttons at the right end expand (<span class=\"tn-icon bx bx-move-vertical\"></span>) and 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 <a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a> toolbar and look for the buttons at its right end.</p><p>By default, the <span class=\"tn-icon bx bx-move-vertical\"></span> button expands only the direct children (first level) of the collection. Starting with v0.100.0, it's possible to expand multiple levels of notes using the <span class=\"tn-icon bx bx-chevron-down\"></span> button next to it.</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 <a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a> 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 the expand and collapse buttons in the list view, or the month selector and view switcher for the calendar.</li></ul>",diff --git a/docs/User Guide/User Guide/Collections/Presentation.md b/docs/User Guide/User Guide/Collections/Presentation.mdindex cf8ceeb017..d3be84270d 100644--- a/docs/User Guide/User Guide/Collections/Presentation.md+++ b/docs/User Guide/User Guide/Collections/Presentation.md@@ -19,7 +19,7 @@ Right click on an existing note in the <a class="reference-link" href="../Basic## Interaction and navigation-A sidebar to the left of the slides shows a thumbnail of every slide in the presentation's theme, with vertical slides indented under the slide they belong to. The slide being shown is outlined, and the sidebar scrolls to keep it in view. Click a thumbnail to go to its slide. Web view, <a class="reference-link" href="Kanban%20Board.md">Kanban Board</a> and <a class="reference-link" href="Table.md">Table</a> slides are shown as an icon. The sidebar is hidden when the note is too narrow to fit it.+A sidebar to the left of the slides shows a thumbnail of every slide in the presentation's theme, with vertical slides indented under the slide they belong to. The slide being shown is outlined, and the sidebar scrolls to keep it in view. Click a thumbnail to go to its slide. From the keyboard, press <kbd>Tab</kbd> to reach the sidebar, then <kbd>↑</kbd> and <kbd>↓</kbd> to go to the previous or next slide in order, vertical slides included, or <kbd>Home</kbd> and <kbd>End</kbd> to go to the first or last slide. Web view, <a class="reference-link" href="Kanban%20Board.md">Kanban Board</a> and <a class="reference-link" href="Table.md">Table</a> slides are shown as an icon. The sidebar is hidden when the note is too narrow to fit it.In the floating toolbar (top-right):