mirror of
https://github.com/zadam/trilium.git
synced 2025-03-01 14:22:32 +01:00
added sharing docs
parent
e61af24ffc
commit
8126900155
66
Sharing.md
Normal file
66
Sharing.md
Normal file
@ -0,0 +1,66 @@
|
|||||||
|
Since v0.49 Trilium offers a feature to share selected notes as publicly accessible read only documents.
|
||||||
|
|
||||||
|
Basic prerequisite for this feature is to have a [[server installation]] - this is where the notes will be hosted from.
|
||||||
|
|
||||||
|
## Share note
|
||||||
|
|
||||||
|
Click on the "shared" switch, URL appears on which you can click.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
And this is the opened link:
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
The URL refers to the localhost (127.0.0.1) because there's no configured sync server.
|
||||||
|
|
||||||
|
## Share a note subtree
|
||||||
|
|
||||||
|
Sharing a note actually shares a whole subtree of notes, the note shown above just didn't have any children.
|
||||||
|
|
||||||
|
If I share the whole "Formatting" subtree then the page looks like this:
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
You can see a basic navigation on the right. With this you can create small websites.
|
||||||
|
|
||||||
|
## Advanced options
|
||||||
|
|
||||||
|
### Styling the shared notes
|
||||||
|
|
||||||
|
The default shared page is pretty rudimentary. In case you want to style it more nicely you can:
|
||||||
|
|
||||||
|
* add a `~shareCss` relation to a CSS code note which will be linked in the shared page
|
||||||
|
* in case you want this to apply to the whole subtree, don't forget to make the label inheritable
|
||||||
|
* the linked CSS code note needs to be also in the shared subtree. If you want to hide it from left tree navigation, add `#shareHiddenFromTree` label to the CSS code note.
|
||||||
|
* if you make extensive styling changes then it's recommended to use `#shareOmitDefaultCss` on the shared subtree so that you don't need to override default stylesheet (this will also avoid problems in the future when the default CSS changes).
|
||||||
|
|
||||||
|
### Creating human-readable URL aliases
|
||||||
|
|
||||||
|
Shared notes are accessible using URLs like `http://domain/share/knvU8aJy4dJ7`, where the last part is note's ID.
|
||||||
|
|
||||||
|
You can add `#shareAlias` to individual notes to make the URLs nicer, e.g. `#shareAlias=highlighting` will make the URL look like `http://domain/share/formatting`.
|
||||||
|
|
||||||
|
Note that you are responsible for keeping the aliases unique.
|
||||||
|
|
||||||
|
### Seeing all shared notes
|
||||||
|
|
||||||
|
All shared notes are grouped under automatically managed "Share Notes" note. Besides seeing what's shared, you can also effectively share/unshare notes by cloning/moving them from/to this note.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
## Limitations
|
||||||
|
|
||||||
|
Shared notes functionality is compared to standard functionality very limited.
|
||||||
|
|
||||||
|
The not exhaustive list of **what is missing** is:
|
||||||
|
|
||||||
|
* math support
|
||||||
|
* mermaid support
|
||||||
|
* relation map support
|
||||||
|
* scripting
|
||||||
|
* book notes show only children note list
|
||||||
|
* code notes have no highlighting
|
||||||
|
* note tree is static
|
||||||
|
|
||||||
|
Some of these limitations might be removed/mitigated in the future.
|
@ -45,6 +45,7 @@
|
|||||||
* [[Relation map]]
|
* [[Relation map]]
|
||||||
* [[Link map]]
|
* [[Link map]]
|
||||||
* [[Book note]]
|
* [[Book note]]
|
||||||
|
* [[Sharing]]
|
||||||
* [[Code notes]]
|
* [[Code notes]]
|
||||||
* [[Scripts]]
|
* [[Scripts]]
|
||||||
* [[Script API]]
|
* [[Script API]]
|
||||||
@ -56,4 +57,4 @@
|
|||||||
* [[Weight Tracker]]
|
* [[Weight Tracker]]
|
||||||
* [[Task Manager]]
|
* [[Task Manager]]
|
||||||
* [[FAQ]]
|
* [[FAQ]]
|
||||||
* [[Troubleshooting]]
|
* [[Troubleshooting]]
|
||||||
|
BIN
images/share-multiple-notes-web.png
Normal file
BIN
images/share-multiple-notes-web.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 116 KiB |
BIN
images/share-single-note-web.png
Normal file
BIN
images/share-single-note-web.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 89 KiB |
BIN
images/share-single-note.png
Normal file
BIN
images/share-single-note.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 136 KiB |
BIN
images/shared-list.png
Normal file
BIN
images/shared-list.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 13 KiB |
Loading…
x
Reference in New Issue
Block a user