diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Printing & Exporting as PDF.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Printing & Exporting as PDF.html
index 744d1d5e5..bf5010fe0 100644
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Printing & Exporting as PDF.html
+++ b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Printing & Exporting as PDF.html
@@ -4,7 +4,6 @@
Screenshot of the note contextual menu indicating the “Export as PDF”
option.
-
Printing
This feature allows printing of notes. It works on both the desktop client,
but also on the web.
@@ -53,18 +52,27 @@ class="admonition note">
the default application might seem incorrect (such as opening in GIMP).
This is because it uses Gnome's “Recommended applications” list.
To solve this, you can change the recommended application for PDFs via
- this command line. First, list the available applications via gio mime application/pdf and
+ this command line. First, list the available applications via gio mime application/pdf and
then set the desired one. For example to use GNOME's Evince:
gio mime application/pdf
Customizing exporting as PDF
When exporting to PDF, there are no customizable settings such as page
orientation, size. However, there are a few Attributes to adjust some of the settings:
- To print in landscape mode instead of portrait (useful for big diagrams
- or slides), add #printLandscape.
- By default, the resulting PDF will be in Letter format. It is possible
- to adjust it to another page size via the #printPageSize attribute,
- with one of the following values: A0, A1, A2, A3, A4, A5, A6, Legal, Letter, Tabloid, Ledger.
+ To print in landscape mode instead of portrait (useful for big diagrams
+ or slides), add #printLandscape.
+ By default, the resulting PDF will be in Letter format. It is possible
+ to adjust it to another page size via the #printPageSize attribute,
+ with one of the following values: A0,
+ A1, A2, A3,
+ A4, A5, A6,
+ Legal, Letter, Tabloid,
+ Ledger.
These options have no effect when used with the printing feature, since
@@ -74,21 +82,29 @@ class="admonition note">
Since v0.100.0, it is possible to print more than one note at the time
by using Collections :
- First create a collection.
- Configure it to use List View .
- Print the collection note normally.
+ First create a collection.
+ Configure it to use List View .
+ Print the collection note normally.
The resulting collection will contain all the children of the collection,
while maintaining the hierarchy.
+
+ Not all note types are supported when printing or exporting to PDF. When
+ an unsupported note is encountered, it is skipped. At the end, if any of
+ the notes were skipped, a message will be displayed with the possibility
+ of viewing the full list of skipped notes. The same limitations as the
+ ones described in Constraints & limitations apply.
+
Keyboard shortcut
It's possible to trigger both printing and export as PDF from the keyboard
by going to Keyboard shortcuts in Options and assigning a key combination
for:
- Print Active Note
+ Print Active Note
- Export Active Note as PDF
+ Export Active Note as PDF
Constraints & limitations
@@ -96,41 +112,45 @@ class="admonition note">
supported when printing, in which case the Print and Export as PDF options
will be disabled.
- For Code notes:
+ For Code notes:
- Line numbers are not printed.
- Syntax highlighting is enabled, however a default theme (Visual Studio)
+ Line numbers are not printed.
+ Syntax highlighting is enabled, however a default theme (Visual Studio)
is enforced.
- For Collections ,
+ For Collections ,
the following are supported:
- List View , allowing
+ List View , allowing
to print multiple notes at once while preserving hierarchy (similar to
a book).
- Presentation ,
- where each slide/sub-note is displayed.
- Table , where the
+ Presentation ,
+ where each slide/sub-note is displayed.
+
+ Most note types are supported, especially the ones that have an image
+ representation such as Canvas and
+ Mind Map .
+
+
+ Table , where the
table is rendered in a print-friendly way.
- Tables that are too complex (especially if they have multiple columns)
+ Tables that are too complex (especially if they have multiple columns)
might not fit properly, however tables with a large number of rows are
supported thanks to pagination.
- Consider printing in landscape mode, or using #printLandscape if
+ Consider printing in landscape mode, or using #printLandscape if
exporting to PDF.
- The rest of the collections are not supported, but we plan to add support
+ The rest of the collections are not supported, but we plan to add support
for all the collection types at some point.
- Using Custom app-wide CSS for
- printing is not longer supported, due to a more stable but isolated mechanism.
-
- We plan to introduce a new mechanism specifically for a print CSS.
-
-
+ Using Custom app-wide CSS for
+ printing is no longer supported, instead a custom printCss relation
+ needs to be used (see below).
Customizing the print CSS
As an advanced use case, it's possible to customize the CSS used for printing
@@ -139,10 +159,10 @@ class="admonition note">
printing.
To do so:
- Create a CSS code note .
- On the note being printed, apply the ~printCss relation to
- point to the newly created CSS code note.
- To apply the CSS to multiple notes, consider using inheritable attributes or
+ Create a CSS code note .
+ On the note being printed, apply the ~printCss relation
+ to point to the newly created CSS code note.
+ To apply the CSS to multiple notes, consider using inheritable attributes or
Templates .
@@ -153,19 +173,23 @@ class="admonition note">
}
To remark:
- Multiple CSS notes can be add by using multiple ~printCss relations.
- If the note pointing to the printCss doesn't have the right
- note type or mime type, it will be ignored.
- If migrating from a previous version where Custom app-wide CSS , there's no need for @media print { since
- the style-sheet is used only for printing.
+ Multiple CSS notes can be add by using multiple ~printCss relations.
+ If the note pointing to the printCss doesn't
+ have the right note type or mime type, it will be ignored.
+ If migrating from a previous version where Custom app-wide CSS , there's no need for
+ @media print { since the style-sheet is used only for printing.
Under the hood
Both printing and exporting as PDF use the same mechanism: a note is rendered
individually in a separate webpage that is then sent to the browser or
the Electron application either for printing or exporting as PDF.
The webpage that renders a single note can actually be accessed in a web
- browser. For example http://localhost:8080/#root/WWRGzqHUfRln/RRZsE9Al8AIZ?ntxId=0o4fzk becomes http://localhost:8080/?print#root/WWRGzqHUfRln/RRZsE9Al8AIZ.
+ browser. For example http://localhost:8080/#root/WWRGzqHUfRln/RRZsE9Al8AIZ?ntxId=0o4fzk becomes
+ http://localhost:8080/?print#root/WWRGzqHUfRln/RRZsE9Al8AIZ.
Accessing the print note in a web browser allows for easy debugging to
understand why a particular note doesn't render well. The mechanism for
rendering is similar to the one used in [!NOTE]
+> Not all note types are supported when printing or exporting to PDF. When an unsupported note is encountered, it is skipped. At the end, if any of the notes were skipped, a message will be displayed with the possibility of viewing the full list of skipped notes. The same limitations as the ones described in _Constraints & limitations_ apply.
+
## Keyboard shortcut
It's possible to trigger both printing and export as PDF from the keyboard by going to _Keyboard shortcuts_ in Options and assigning a key combination for:
@@ -76,12 +79,12 @@ Not all Note Types
* For Collections , the following are supported:
* List View , allowing to print multiple notes at once while preserving hierarchy (similar to a book).
* Presentation , where each slide/sub-note is displayed.
+ * Most note types are supported, especially the ones that have an image representation such as Canvas and Mind Map .
* Table , where the table is rendered in a print-friendly way.
* Tables that are too complex (especially if they have multiple columns) might not fit properly, however tables with a large number of rows are supported thanks to pagination.
* Consider printing in landscape mode, or using `#printLandscape` if exporting to PDF.
* The rest of the collections are not supported, but we plan to add support for all the collection types at some point.
-* Using Custom app-wide CSS for printing is not longer supported, due to a more stable but isolated mechanism.
- * We plan to introduce a new mechanism specifically for a print CSS.
+* Using Custom app-wide CSS for printing is no longer supported, instead a custom `printCss` relation needs to be used (see below).
## Customizing the print CSS