diff --git a/docs/User Guide/!!!meta.json b/docs/User Guide/!!!meta.json
index 0feb993c1..7765c4fef 100644
--- a/docs/User Guide/!!!meta.json
+++ b/docs/User Guide/!!!meta.json
@@ -2099,6 +2099,13 @@
"value": "bx bx-paperclip",
"isInheritable": false,
"position": 40
+ },
+ {
+ "type": "relation",
+ "name": "internalLink",
+ "value": "W8vYD3Q1zjCR",
+ "isInheritable": false,
+ "position": 50
}
],
"format": "markdown",
@@ -2494,6 +2501,26 @@
"dataFileName": "Read-Only Notes_image.png"
}
]
+ },
+ {
+ "isClone": false,
+ "noteId": "0ESUbbAxVnoK",
+ "notePath": [
+ "pOsGYCXsbNQG",
+ "gh7bpGYxajRS",
+ "BFs8mudNFgCS",
+ "0ESUbbAxVnoK"
+ ],
+ "title": "Note List",
+ "notePosition": 140,
+ "prefix": null,
+ "isExpanded": false,
+ "type": "text",
+ "mime": "text/html",
+ "attributes": [],
+ "format": "markdown",
+ "dataFileName": "Note List.md",
+ "attachments": []
}
]
},
@@ -5722,6 +5749,176 @@
"dataFileName": "18_Geo Map_image.png"
}
]
+ },
+ {
+ "isClone": false,
+ "noteId": "W8vYD3Q1zjCR",
+ "notePath": [
+ "pOsGYCXsbNQG",
+ "KSZ04uQ2D1St",
+ "W8vYD3Q1zjCR"
+ ],
+ "title": "File",
+ "notePosition": 210,
+ "prefix": null,
+ "isExpanded": false,
+ "type": "text",
+ "mime": "text/html",
+ "attributes": [
+ {
+ "type": "relation",
+ "name": "internalLink",
+ "value": "8YBEPzcpUgxw",
+ "isInheritable": false,
+ "position": 10
+ },
+ {
+ "type": "relation",
+ "name": "internalLink",
+ "value": "BlN9DFI679QC",
+ "isInheritable": false,
+ "position": 20
+ },
+ {
+ "type": "relation",
+ "name": "internalLink",
+ "value": "iPIMuisry3hd",
+ "isInheritable": false,
+ "position": 30
+ },
+ {
+ "type": "relation",
+ "name": "internalLink",
+ "value": "0vhv7lsOLy82",
+ "isInheritable": false,
+ "position": 50
+ },
+ {
+ "type": "relation",
+ "name": "internalLink",
+ "value": "mHbBMPDPkVV5",
+ "isInheritable": false,
+ "position": 60
+ },
+ {
+ "type": "relation",
+ "name": "internalLink",
+ "value": "6f9hih2hXXZk",
+ "isInheritable": false,
+ "position": 70
+ },
+ {
+ "type": "relation",
+ "name": "internalLink",
+ "value": "wX4HbRucYSDD",
+ "isInheritable": false,
+ "position": 80
+ },
+ {
+ "type": "relation",
+ "name": "internalLink",
+ "value": "ODY7qQn5m2FT",
+ "isInheritable": false,
+ "position": 90
+ },
+ {
+ "type": "relation",
+ "name": "internalLink",
+ "value": "0Ofbk1aSuVRu",
+ "isInheritable": false,
+ "position": 100
+ },
+ {
+ "type": "relation",
+ "name": "internalLink",
+ "value": "oPVyFC7WL2Lp",
+ "isInheritable": false,
+ "position": 110
+ },
+ {
+ "type": "relation",
+ "name": "internalLink",
+ "value": "0ESUbbAxVnoK",
+ "isInheritable": false,
+ "position": 120
+ }
+ ],
+ "format": "markdown",
+ "dataFileName": "File.md",
+ "attachments": [
+ {
+ "attachmentId": "82as0jgkDvVH",
+ "title": "image.png",
+ "role": "image",
+ "mime": "image/png",
+ "position": 10,
+ "dataFileName": "File_image.png"
+ },
+ {
+ "attachmentId": "FoEnowwOhzLT",
+ "title": "image.png",
+ "role": "image",
+ "mime": "image/png",
+ "position": 10,
+ "dataFileName": "1_File_image.png"
+ },
+ {
+ "attachmentId": "fZ7VMfQJWuLQ",
+ "title": "image.png",
+ "role": "image",
+ "mime": "image/png",
+ "position": 10,
+ "dataFileName": "2_File_image.png"
+ },
+ {
+ "attachmentId": "hddkgf7kr9g4",
+ "title": "image.png",
+ "role": "image",
+ "mime": "image/png",
+ "position": 10,
+ "dataFileName": "3_File_image.png"
+ },
+ {
+ "attachmentId": "hIg9g5pgsjS3",
+ "title": "image.png",
+ "role": "image",
+ "mime": "image/png",
+ "position": 10,
+ "dataFileName": "4_File_image.png"
+ },
+ {
+ "attachmentId": "IC0j8LFCOKka",
+ "title": "image.png",
+ "role": "image",
+ "mime": "image/png",
+ "position": 10,
+ "dataFileName": "5_File_image.png"
+ },
+ {
+ "attachmentId": "QuS3PW5vuXmf",
+ "title": "image.png",
+ "role": "image",
+ "mime": "image/png",
+ "position": 10,
+ "dataFileName": "6_File_image.png"
+ },
+ {
+ "attachmentId": "uEFfm1fmx9G7",
+ "title": "image.png",
+ "role": "image",
+ "mime": "image/png",
+ "position": 10,
+ "dataFileName": "7_File_image.png"
+ },
+ {
+ "attachmentId": "wNHX24feZRAl",
+ "title": "image.png",
+ "role": "image",
+ "mime": "image/png",
+ "position": 10,
+ "dataFileName": "8_File_image.png"
+ }
+ ]
}
]
},
diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/Notes/Attachments.md b/docs/User Guide/User Guide/Basic Concepts and Features/Notes/Attachments.md
index 91076bef0..384a82ff0 100644
--- a/docs/User Guide/User Guide/Basic Concepts and Features/Notes/Attachments.md
+++ b/docs/User Guide/User Guide/Basic Concepts and Features/Notes/Attachments.md
@@ -5,4 +5,8 @@ This can be especially useful to include dependencies for your [scripts](../../N
Each note exclusively owns its attachments, meaning attachments cannot be shared or linked from one note to another. If an attachment link is copied to a different note, the attachment itself is duplicated, and the copies are managed independently thereafter.
-Attachments, especially image files, are the recommended method for embedding visuals in notes. It is important to link image attachments within the text of the owning note; otherwise, they will be automatically deleted after a configurable timeout period if not referenced.
\ No newline at end of file
+Attachments, especially image files, are the recommended method for embedding visuals in notes. It is important to link image attachments within the text of the owning note; otherwise, they will be automatically deleted after a configurable timeout period if not referenced.
+
+## Attachment previews
+
+Attachments share the same content preview for images, videos, PDFs, etc. as the [File](../../Note%20Types/File.md) note type.
\ No newline at end of file
diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/Notes/Note List.md b/docs/User Guide/User Guide/Basic Concepts and Features/Notes/Note List.md
new file mode 100644
index 000000000..e69de29bb
diff --git a/docs/User Guide/User Guide/Note Types/1_File_image.png b/docs/User Guide/User Guide/Note Types/1_File_image.png
new file mode 100644
index 000000000..d0062c3ff
Binary files /dev/null and b/docs/User Guide/User Guide/Note Types/1_File_image.png differ
diff --git a/docs/User Guide/User Guide/Note Types/2_File_image.png b/docs/User Guide/User Guide/Note Types/2_File_image.png
new file mode 100644
index 000000000..1fbcb46d6
Binary files /dev/null and b/docs/User Guide/User Guide/Note Types/2_File_image.png differ
diff --git a/docs/User Guide/User Guide/Note Types/3_File_image.png b/docs/User Guide/User Guide/Note Types/3_File_image.png
new file mode 100644
index 000000000..7cb39064a
Binary files /dev/null and b/docs/User Guide/User Guide/Note Types/3_File_image.png differ
diff --git a/docs/User Guide/User Guide/Note Types/4_File_image.png b/docs/User Guide/User Guide/Note Types/4_File_image.png
new file mode 100644
index 000000000..6b15c903f
Binary files /dev/null and b/docs/User Guide/User Guide/Note Types/4_File_image.png differ
diff --git a/docs/User Guide/User Guide/Note Types/5_File_image.png b/docs/User Guide/User Guide/Note Types/5_File_image.png
new file mode 100644
index 000000000..c1a255edc
Binary files /dev/null and b/docs/User Guide/User Guide/Note Types/5_File_image.png differ
diff --git a/docs/User Guide/User Guide/Note Types/6_File_image.png b/docs/User Guide/User Guide/Note Types/6_File_image.png
new file mode 100644
index 000000000..6a9e1cca5
Binary files /dev/null and b/docs/User Guide/User Guide/Note Types/6_File_image.png differ
diff --git a/docs/User Guide/User Guide/Note Types/7_File_image.png b/docs/User Guide/User Guide/Note Types/7_File_image.png
new file mode 100644
index 000000000..07d4d47ad
Binary files /dev/null and b/docs/User Guide/User Guide/Note Types/7_File_image.png differ
diff --git a/docs/User Guide/User Guide/Note Types/8_File_image.png b/docs/User Guide/User Guide/Note Types/8_File_image.png
new file mode 100644
index 000000000..ba44b1074
Binary files /dev/null and b/docs/User Guide/User Guide/Note Types/8_File_image.png differ
diff --git a/docs/User Guide/User Guide/Note Types/File.md b/docs/User Guide/User Guide/Note Types/File.md
new file mode 100644
index 000000000..44f5bcef3
--- /dev/null
+++ b/docs/User Guide/User Guide/Note Types/File.md
@@ -0,0 +1,89 @@
+# File
+The _File_ note type can be used to attach various external files such as images, videos or PDF documents.
+
+## Uploading a file
+
+Since these files come from an external source, it is not possible to create a _File_ note type directly:
+
+* Drag a file into the [Note Tree](../Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tree.md).
+* Right click a note and select _Import into note_ and point it to one of the supported files.
+
+## Supported file types
+
+### PDFs
+
+
+
+PDFs can be browsed directly from Trilium.
+
+Interaction:
+
+* Press the menu icon at the top-left to see a preview (thumbnail) of all the pages, as well as a table of contents (if the PDF has this information).
+* See or edit the page number at the top.
+* Adjust the zoom using the buttons at the top or manually editing the value.
+* Rotate the document if it's in the wrong orientation.
+* In the contextual menu:
+ * View two pages at once (great for books).
+ * Toggle annotations (if present in the document).
+ * View document properties.
+
+### Images
+
+
+
+Interaction:
+
+* _Copy reference to clipboard_, for embedding the image within [Text](Text.md) notes. See [Image references](Text/Images/Image%20references.md) for more information.
+
+### Videos
+
+
+
+Video files can be added in as well. The file is streamed directly, so when accessing the note from a server it doesn't have to download the entire video to start playing it.
+
+> [!CAUTION]
+> Although Trilium offers support for videos, it is generally not meant to be used with very large files. Uploading large videos will cause the [Database](../Advanced%20Usage/Database.md) to balloon as well as the any [Backup](../Installation%20%26%20Setup/Backup.md) of it. In addition to that, there might be slowdowns when first uploading the files. Otherwise, a large database should not impact the general performance of Trilium significantly.
+
+### Audio
+
+
+
+Adding a supported audio file will reveal a basic audio player that can be used to play it.
+
+Interactions:
+
+* The audio can be played/paused using the dedicated button.
+* Dragging the mouse across, or clicking the progress bar will seek through the song.
+* The volume can be set.
+* The playback speed can be adjusted via the contextual menu next to the volume.
+
+### Text files
+
+
+
+Files that are identified as containing text will show a preview of their content. One common use case for this type of file is to embed text files whose content is not necessarily of interest to the user, such as third-party libraries or generated content, that can then be downloaded if needed.
+
+Note that generally text files will be [imported](../Basic%20Concepts%20and%20Features/Import%20%26%20Export) as either [Text](Text.md) or [Code](Code.md) notes. To bypass this behavior and create a _File_ note type, use the _Import into note_ feature and uncheck _Import HTML, Markdown and TXT as text notes_, as well as _Import recognized code files as code notes_.
+
+Since one of the use cases for having files instead of notes is to display large files, the content preview is limited to a relatively small amount of characters. To view the full file, consider opening it in an external application.
+
+### Unknown file types
+
+
+
+If the file could not be identified as any of the supported file types from above, it will be treated as an unknown file. In this case, all the default interactions will be available such as downloading or opening the file externally, but there will be no preview of the content.
+
+## Interaction
+
+* Regardless of the file type, a series of buttons will be displayed in the _Image_ or _File_ tab in the [Ribbon](../Basic%20Concepts%20and%20Features/UI%20Elements/Ribbon.md).
+ * _Download_, which will download the file for local use.
+ * _Open_, will will open the file with the system-default application.
+ * Upload new revision to replace the file with a new one.
+* It is **not** possible to change the note type of a _File_ note.
+* Convert into an [attachment](../Basic%20Concepts%20and%20Features/Notes/Attachments.md) from the [note menu](../Basic%20Concepts%20and%20Features/UI%20Elements/Note%20buttons.md).
+
+## Note list
+
+Files are also displayed in the [Note List](../Basic%20Concepts%20and%20Features/Notes/Note%20List.md) based on their type:
+
+
\ No newline at end of file
diff --git a/docs/User Guide/User Guide/Note Types/File_image.png b/docs/User Guide/User Guide/Note Types/File_image.png
new file mode 100644
index 000000000..6dc60e3ac
Binary files /dev/null and b/docs/User Guide/User Guide/Note Types/File_image.png differ
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 f19e4823a..5dd76b5c7 100644
--- a/src/public/app/doc_notes/en/User Guide/!!!meta.json
+++ b/src/public/app/doc_notes/en/User Guide/!!!meta.json
@@ -2099,6 +2099,13 @@
"value": "bx bx-paperclip",
"isInheritable": false,
"position": 40
+ },
+ {
+ "type": "relation",
+ "name": "internalLink",
+ "value": "W8vYD3Q1zjCR",
+ "isInheritable": false,
+ "position": 50
}
],
"format": "html",
@@ -2494,6 +2501,26 @@
"dataFileName": "Read-Only Notes_image.png"
}
]
+ },
+ {
+ "isClone": false,
+ "noteId": "0ESUbbAxVnoK",
+ "notePath": [
+ "pOsGYCXsbNQG",
+ "gh7bpGYxajRS",
+ "BFs8mudNFgCS",
+ "0ESUbbAxVnoK"
+ ],
+ "title": "Note List",
+ "notePosition": 140,
+ "prefix": null,
+ "isExpanded": false,
+ "type": "text",
+ "mime": "text/html",
+ "attributes": [],
+ "format": "html",
+ "dataFileName": "Note List.html",
+ "attachments": []
}
]
},
@@ -5722,6 +5749,176 @@
"dataFileName": "18_Geo Map_image.png"
}
]
+ },
+ {
+ "isClone": false,
+ "noteId": "W8vYD3Q1zjCR",
+ "notePath": [
+ "pOsGYCXsbNQG",
+ "KSZ04uQ2D1St",
+ "W8vYD3Q1zjCR"
+ ],
+ "title": "File",
+ "notePosition": 210,
+ "prefix": null,
+ "isExpanded": false,
+ "type": "text",
+ "mime": "text/html",
+ "attributes": [
+ {
+ "type": "relation",
+ "name": "internalLink",
+ "value": "8YBEPzcpUgxw",
+ "isInheritable": false,
+ "position": 10
+ },
+ {
+ "type": "relation",
+ "name": "internalLink",
+ "value": "BlN9DFI679QC",
+ "isInheritable": false,
+ "position": 20
+ },
+ {
+ "type": "relation",
+ "name": "internalLink",
+ "value": "iPIMuisry3hd",
+ "isInheritable": false,
+ "position": 30
+ },
+ {
+ "type": "relation",
+ "name": "internalLink",
+ "value": "0vhv7lsOLy82",
+ "isInheritable": false,
+ "position": 50
+ },
+ {
+ "type": "relation",
+ "name": "internalLink",
+ "value": "mHbBMPDPkVV5",
+ "isInheritable": false,
+ "position": 60
+ },
+ {
+ "type": "relation",
+ "name": "internalLink",
+ "value": "6f9hih2hXXZk",
+ "isInheritable": false,
+ "position": 70
+ },
+ {
+ "type": "relation",
+ "name": "internalLink",
+ "value": "wX4HbRucYSDD",
+ "isInheritable": false,
+ "position": 80
+ },
+ {
+ "type": "relation",
+ "name": "internalLink",
+ "value": "ODY7qQn5m2FT",
+ "isInheritable": false,
+ "position": 90
+ },
+ {
+ "type": "relation",
+ "name": "internalLink",
+ "value": "0Ofbk1aSuVRu",
+ "isInheritable": false,
+ "position": 100
+ },
+ {
+ "type": "relation",
+ "name": "internalLink",
+ "value": "oPVyFC7WL2Lp",
+ "isInheritable": false,
+ "position": 110
+ },
+ {
+ "type": "relation",
+ "name": "internalLink",
+ "value": "0ESUbbAxVnoK",
+ "isInheritable": false,
+ "position": 120
+ }
+ ],
+ "format": "html",
+ "dataFileName": "File.html",
+ "attachments": [
+ {
+ "attachmentId": "82as0jgkDvVH",
+ "title": "image.png",
+ "role": "image",
+ "mime": "image/png",
+ "position": 10,
+ "dataFileName": "File_image.png"
+ },
+ {
+ "attachmentId": "FoEnowwOhzLT",
+ "title": "image.png",
+ "role": "image",
+ "mime": "image/png",
+ "position": 10,
+ "dataFileName": "1_File_image.png"
+ },
+ {
+ "attachmentId": "fZ7VMfQJWuLQ",
+ "title": "image.png",
+ "role": "image",
+ "mime": "image/png",
+ "position": 10,
+ "dataFileName": "2_File_image.png"
+ },
+ {
+ "attachmentId": "hddkgf7kr9g4",
+ "title": "image.png",
+ "role": "image",
+ "mime": "image/png",
+ "position": 10,
+ "dataFileName": "3_File_image.png"
+ },
+ {
+ "attachmentId": "hIg9g5pgsjS3",
+ "title": "image.png",
+ "role": "image",
+ "mime": "image/png",
+ "position": 10,
+ "dataFileName": "4_File_image.png"
+ },
+ {
+ "attachmentId": "IC0j8LFCOKka",
+ "title": "image.png",
+ "role": "image",
+ "mime": "image/png",
+ "position": 10,
+ "dataFileName": "5_File_image.png"
+ },
+ {
+ "attachmentId": "QuS3PW5vuXmf",
+ "title": "image.png",
+ "role": "image",
+ "mime": "image/png",
+ "position": 10,
+ "dataFileName": "6_File_image.png"
+ },
+ {
+ "attachmentId": "uEFfm1fmx9G7",
+ "title": "image.png",
+ "role": "image",
+ "mime": "image/png",
+ "position": 10,
+ "dataFileName": "7_File_image.png"
+ },
+ {
+ "attachmentId": "wNHX24feZRAl",
+ "title": "image.png",
+ "role": "image",
+ "mime": "image/png",
+ "position": 10,
+ "dataFileName": "8_File_image.png"
+ }
+ ]
}
]
},
diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Attachments.html b/src/public/app/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Attachments.html
index 2f66bad57..65531ddbb 100644
--- a/src/public/app/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Attachments.html
+++ b/src/public/app/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Attachments.html
@@ -28,6 +28,10 @@
visuals in notes. It is important to link image attachments within the
text of the owning note; otherwise, they will be automatically deleted
after a configurable timeout period if not referenced.
+ Attachment previews
+ Attachments share the same content preview for images, videos, PDFs, etc.
+ as the File note
+ type.
diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note List.html b/src/public/app/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note List.html
new file mode 100644
index 000000000..39dcb1d79
--- /dev/null
+++ b/src/public/app/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Notes/Note List.html
@@ -0,0 +1,19 @@
+
+
+