diff --git a/src/public/app/doc_notes/en/User Guide/!!!meta.json b/src/public/app/doc_notes/en/User Guide/!!!meta.json index b90fd4f50..4fb15df7f 100644 --- a/src/public/app/doc_notes/en/User Guide/!!!meta.json +++ b/src/public/app/doc_notes/en/User Guide/!!!meta.json @@ -1,6 +1,6 @@ { "formatVersion": 2, - "appVersion": "0.91.6-test-250214-024424", + "appVersion": "0.91.6-test-250217-024840", "files": [ { "isClone": false, @@ -11,7 +11,7 @@ "title": "User Guide", "notePosition": 20, "prefix": null, - "isExpanded": false, + "isExpanded": true, "type": "text", "mime": "text/html", "attributes": [ @@ -27,135 +27,6 @@ "attachments": [], "dirFileName": "User Guide", "children": [ - { - "isClone": false, - "noteId": "jrai60LsOhdk", - "notePath": [ - "OkOZllzB3fqN", - "jrai60LsOhdk" - ], - "title": "Installation", - "notePosition": 20, - "prefix": null, - "isExpanded": false, - "type": "text", - "mime": "text/html", - "attributes": [ - { - "type": "relation", - "name": "internalLink", - "value": "KPeRqBU7YSAY", - "isInheritable": false, - "position": 10 - }, - { - "type": "label", - "name": "hideChildrenOverview", - "value": "", - "isInheritable": false, - "position": 10 - } - ], - "format": "html", - "dataFileName": "Installation.html", - "attachments": [ - { - "attachmentId": "Mp9RaDeLtETz", - "title": "Fedora_logo.svg", - "role": "image", - "mime": "image/svg+xml", - "position": 10, - "dataFileName": "Installation_Fedora_logo.svg" - } - ], - "dirFileName": "Installation", - "children": [ - { - "isClone": false, - "noteId": "KPeRqBU7YSAY", - "notePath": [ - "OkOZllzB3fqN", - "jrai60LsOhdk", - "KPeRqBU7YSAY" - ], - "title": "On Fedora Linux", - "notePosition": 10, - "prefix": null, - "isExpanded": false, - "type": "text", - "mime": "text/html", - "attributes": [ - { - "type": "label", - "name": "iconClass", - "value": "bx bxl-tux", - "isInheritable": false, - "position": 10 - } - ], - "format": "html", - "dataFileName": "On Fedora Linux.html", - "attachments": [ - { - "attachmentId": "YHD8kyEhgkyZ", - "title": "Screenshot From 2025-02-05 19-30-50.png", - "role": "image", - "mime": "image/png", - "position": 10, - "dataFileName": "On Fedora Linux_Screenshot.png" - }, - { - "attachmentId": "0CpZ5v5xUMia", - "title": "Screenshot From 2025-02-05 19-35-45.png", - "role": "image", - "mime": "image/png", - "position": 10, - "dataFileName": "1_On Fedora Linux_Screenshot.png" - }, - { - "attachmentId": "9u7nBYvUbXJW", - "title": "image.png", - "role": "image", - "mime": "image/png", - "position": 10, - "dataFileName": "On Fedora Linux_image.png" - }, - { - "attachmentId": "ipGBq0moRvF3", - "title": "Screenshot From 2025-02-05 19-36-27.png", - "role": "image", - "mime": "image/png", - "position": 10, - "dataFileName": "2_On Fedora Linux_Screenshot.png" - }, - { - "attachmentId": "fa83WbDUIB4G", - "title": "image.png", - "role": "image", - "mime": "image/png", - "position": 10, - "dataFileName": "1_On Fedora Linux_image.png" - }, - { - "attachmentId": "kcCWr0YXytOU", - "title": "Screenshot From 2025-02-05 19-30-30.png", - "role": "image", - "mime": "image/png", - "position": 10, - "dataFileName": "3_On Fedora Linux_Screenshot.png" - }, - { - "attachmentId": "YF3JZy1qz7Fq", - "title": "image.png", - "role": "image", - "mime": "image/png", - "position": 10, - "dataFileName": "2_On Fedora Linux_image.png" - } - ] - } - ] - }, { "isClone": false, "noteId": "yoAe4jV2yzbd", @@ -166,7 +37,7 @@ "title": "Features", "notePosition": 40, "prefix": null, - "isExpanded": true, + "isExpanded": false, "type": "text", "mime": "text/html", "attributes": [], @@ -314,7 +185,7 @@ "title": "Note Types", "notePosition": 70, "prefix": null, - "isExpanded": true, + "isExpanded": false, "type": "text", "mime": "text/html", "attributes": [], @@ -548,7 +419,7 @@ "title": "Book", "notePosition": 30, "prefix": null, - "isExpanded": true, + "isExpanded": false, "type": "text", "mime": "text/html", "attributes": [ diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Advanced usage/Theme development/Reference.html b/src/public/app/doc_notes/en/User Guide/User Guide/Advanced usage/Theme development/Reference.html index e858513c1..59c2320c4 100644 --- a/src/public/app/doc_notes/en/User Guide/User Guide/Advanced usage/Theme development/Reference.html +++ b/src/public/app/doc_notes/en/User Guide/User Guide/Advanced usage/Theme development/Reference.html @@ -13,6 +13,37 @@

Reference

+

Detecting mobile vs. desktop

+

The mobile layout is different than the one on the desktop. Use body.mobile and body.desktop to + differentiate between them.

body.mobile #root-widget {
+	/* Do something on mobile */
+}
+
+body.desktop #root-widget {
+	/* Do something on desktop */
+}
+

Do note that there is also a “tablet mode” in the mobile layout. For that + particular case media queries are required:

@media (max-width: 991px) {
+
+    #launcher-pane {
+
+        /* Do something on mobile layout */
+
+    }
+
+}
+
+
+
+@media (min-width: 992px) {
+
+    #launcher-pane {
+
+        /* Do something on mobile tablet + desktop layout */
+
+    }
+
+}

Detecting horizontal vs. vertical layout

The user can select between vertical layout (the classical one, where the launcher bar is on the left) and a horizontal layout (where the launcher @@ -85,14 +116,14 @@ body.electron:not(.native-titlebar) {

On macOS

On macOS the semaphore window buttons are enabled by default when the native title bar is disabled. The offset of the buttons can be adjusted - using:

body {
+          using:

body {
     --native-titlebar-darwin-x-offset: 12;
     --native-titlebar-darwin-y-offset: 14 !important;
 }

Background/transparency effects on Windows (Mica)

Windows 11 offers a special background/transparency effect called Mica, which can be enabled by themes by setting the --background-material variable - at body level:

body.electron.platform-win32 {
+          at body level:

body.electron.platform-win32 {
 	--background-material: tabbed; 
 }

The value can be either tabbed (especially useful for the horizontal @@ -104,12 +135,12 @@ body.electron:not(.native-titlebar) {

Theme capabilities are small adjustments done through CSS variables that can affect the layout or the visual aspect of the application.

In the tab bar, to display the icons of notes instead of the icon of the - workspace:

:root {
+          workspace:

:root {
 	--tab-note-icons: true;
 }

When a workspace is hoisted for a given tab, it is possible to get the background color of that workspace, for example to apply a small strip - on the tab instead of the whole background color:

.note-tab .note-tab-wrapper {
+          on the tab instead of the whole background color:

.note-tab .note-tab-wrapper {
     --tab-background-color: initial !important;
 }
 
@@ -127,6 +158,21 @@ body.electron:not(.native-titlebar) {
           href="../Custom%20resource%20providers.html">Custom resource providers.
           Basically import a font into Trilium and assign it #customResourceProvider=fonts/myfont.ttf and
           then import the font in CSS via /custom/fonts/myfont.ttf.

+

Dark and light themes

+

A light theme needs to have the following CSS:

:root {
+	--theme-style: light;
+}
+

if the theme is dark, then --theme-style needs to be dark.

+

If the theme is auto (e.g. supports both light or dark based on prefers-color-scheme) + it must also declare (in addition to setting --theme-style to + either light or dark):

:root {
+
+    --theme-style-auto: true;
+
+}
+

This will affect the behavior of the Electron application by informing + the operating system of the color preference (e.g. background effects will + appear correct on Windows).

diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Installation.html b/src/public/app/doc_notes/en/User Guide/User Guide/Installation.html deleted file mode 100644 index 058f84feb..000000000 --- a/src/public/app/doc_notes/en/User Guide/User Guide/Installation.html +++ /dev/null @@ -1,38 +0,0 @@ - - - - - - - - Installation - - - -
-

Installation

- -
-

Desktop application

-
- - - - - - -
-
- -
-

Fedora -

-
-
-

Self-hosted server

-
-
- - - \ No newline at end of file diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Installation/1_On Fedora Linux_Screenshot.png b/src/public/app/doc_notes/en/User Guide/User Guide/Installation/1_On Fedora Linux_Screenshot.png deleted file mode 100644 index d519f9b75..000000000 Binary files a/src/public/app/doc_notes/en/User Guide/User Guide/Installation/1_On Fedora Linux_Screenshot.png and /dev/null differ diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Installation/1_On Fedora Linux_image.png b/src/public/app/doc_notes/en/User Guide/User Guide/Installation/1_On Fedora Linux_image.png deleted file mode 100644 index f3fcbfcb5..000000000 Binary files a/src/public/app/doc_notes/en/User Guide/User Guide/Installation/1_On Fedora Linux_image.png and /dev/null differ diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Installation/2_On Fedora Linux_Screenshot.png b/src/public/app/doc_notes/en/User Guide/User Guide/Installation/2_On Fedora Linux_Screenshot.png deleted file mode 100644 index d7370a422..000000000 Binary files a/src/public/app/doc_notes/en/User Guide/User Guide/Installation/2_On Fedora Linux_Screenshot.png and /dev/null differ diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Installation/2_On Fedora Linux_image.png b/src/public/app/doc_notes/en/User Guide/User Guide/Installation/2_On Fedora Linux_image.png deleted file mode 100644 index b69b71d3c..000000000 Binary files a/src/public/app/doc_notes/en/User Guide/User Guide/Installation/2_On Fedora Linux_image.png and /dev/null differ diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Installation/3_On Fedora Linux_Screenshot.png b/src/public/app/doc_notes/en/User Guide/User Guide/Installation/3_On Fedora Linux_Screenshot.png deleted file mode 100644 index 6c3589ca4..000000000 Binary files a/src/public/app/doc_notes/en/User Guide/User Guide/Installation/3_On Fedora Linux_Screenshot.png and /dev/null differ diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Installation/On Fedora Linux.html b/src/public/app/doc_notes/en/User Guide/User Guide/Installation/On Fedora Linux.html deleted file mode 100644 index 88ad36272..000000000 --- a/src/public/app/doc_notes/en/User Guide/User Guide/Installation/On Fedora Linux.html +++ /dev/null @@ -1,82 +0,0 @@ - - - - - - - - On Fedora Linux - - - -
-

On Fedora Linux

- -
-

First, download a release from GitHub.

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - -
1 -
- -
-
In your file explorer, look for the .rpm file of TriliumNext.
2 -
- -
-
Right click the file and select Open With Software Install.
3 -
- -
-
-

GNOME Software will appear. Press the - .

-

You will be asked to confirm the action by entering your password.

-

After confirmation the software will start installing.

-

Once it's done the “Install” button will turn into - .

-
4 -
- -
-
After installation, the application will be available in the GNOME overview - section.
-
-
-
- - - \ No newline at end of file diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Installation/On Fedora Linux_Screenshot.png b/src/public/app/doc_notes/en/User Guide/User Guide/Installation/On Fedora Linux_Screenshot.png deleted file mode 100644 index fb0ce66ef..000000000 Binary files a/src/public/app/doc_notes/en/User Guide/User Guide/Installation/On Fedora Linux_Screenshot.png and /dev/null differ diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Installation/On Fedora Linux_image.png b/src/public/app/doc_notes/en/User Guide/User Guide/Installation/On Fedora Linux_image.png deleted file mode 100644 index 5791f83ef..000000000 Binary files a/src/public/app/doc_notes/en/User Guide/User Guide/Installation/On Fedora Linux_image.png and /dev/null differ diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Installation_Fedora_logo.svg b/src/public/app/doc_notes/en/User Guide/User Guide/Installation_Fedora_logo.svg deleted file mode 100644 index 1ad9c15c8..000000000 --- a/src/public/app/doc_notes/en/User Guide/User Guide/Installation_Fedora_logo.svg +++ /dev/null @@ -1,10 +0,0 @@ - - - - - - - - - - \ No newline at end of file diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/Book/Calendar View.html b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/Book/Calendar View.html index d5364a1e9..c01fe823f 100644 --- a/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/Book/Calendar View.html +++ b/src/public/app/doc_notes/en/User Guide/User Guide/Note Types/Book/Calendar View.html @@ -74,6 +74,8 @@
+
  • Creating new notes from the calendar will respect the ~child:template relation + if set on the book note.
  • Interacting with events

      diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Scripting/Examples/Downloading responses from Goo.html b/src/public/app/doc_notes/en/User Guide/User Guide/Scripting/Examples/Downloading responses from Goo.html index 7e4955655..fdffa270d 100644 --- a/src/public/app/doc_notes/en/User Guide/User Guide/Scripting/Examples/Downloading responses from Goo.html +++ b/src/public/app/doc_notes/en/User Guide/User Guide/Scripting/Examples/Downloading responses from Goo.html @@ -12,7 +12,53 @@

      Downloading responses from Google Forms

      -
      +
      +

      This tutorials showcases a basic integration with Google Forms, where + we are able to download the responses of a form using the “Link to Sheets" + functionality.

      +

      Note that the link will be publicly accessible to everyone (however the + link is in a hard-to-guess format such as https://docs.google.com/spreadsheets/d/e/2PACX-1vTA8NU2_eZFhc8TFadCZPreBfvP7un8IHd6J0SchrLLw3ueGmntNZjwRmsH2ZRcp1pJYDAzMz1FmFaj/pub?output=csv). + Make sure you are not accidentally publishing sensitive information.

      +

      Obtaining the CSV link

      +
        +
      1. Open the Google Forms in a browser.
      2. +
      3. Select the “Responses” tab and click on “Link to Sheets”.
      4. +
      5. Select “Create a new spreadsheet” and press “Create”.
      6. +
      7. In Google Sheets, select File → Share → Publish to web.
      8. +
      9. In the “Publish to the web” screen, make sure the “Link” tab is selected + and instead of “Web page”, select “Comma-separated values (.csv)”.
      10. +
      11. Copy the given link which will be used for the upcoming script.
      12. +
      +

      Creating the script

      +

      Create a “JS Frontend” script:

      const CSV_URL = "https://docs.google.com/spreadsheets/d/e/2PACX-1vTiwooLV2whjCSVa49dJ99p_G3_qhqHHRqttMjYCJVfLXVdTgUSNJu5K0rpqmaHYF2k7Vofi3o7gW82/pub?output=csv";
      +
      +
      +async function fetchData() {
      +
      +    try {
      +
      +        const response = await fetch(CSV_URL);
      +
      +        return await response.text();
      +
      +    } catch (e) {
      +
      +        api.showError(e.message);
      +
      +    }
      +
      +}
      +
      +const data = await fetchData();
      +console.log(data);
      +// Do something with the data.
      +

      Note that the data will be received as a string and there is no library + to do the CSV parsing for us. To do a very simple parsing of CSV:

      const content = data
      +	.split("\n")
      +	.slice(1)
      +	.map((row) => row.split(","));
      +

      This will return the data as an array of arrays.

      +
      diff --git a/src/public/app/doc_notes/en/User Guide/index.html b/src/public/app/doc_notes/en/User Guide/index.html index fc49dc742..c5c17da96 100644 --- a/src/public/app/doc_notes/en/User Guide/index.html +++ b/src/public/app/doc_notes/en/User Guide/index.html @@ -6,6 +6,6 @@ - + \ No newline at end of file diff --git a/src/public/app/doc_notes/en/User Guide/navigation.html b/src/public/app/doc_notes/en/User Guide/navigation.html index 85143e944..732ee6d61 100644 --- a/src/public/app/doc_notes/en/User Guide/navigation.html +++ b/src/public/app/doc_notes/en/User Guide/navigation.html @@ -9,12 +9,6 @@