mirror of
https://github.com/zadam/trilium.git
synced 2025-11-03 11:56:01 +01:00
Compare commits
7 Commits
copilot/ad
...
copilot/im
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
ff4cd7eae5 | ||
|
|
a62c9a1a2f | ||
|
|
cf406383c3 | ||
|
|
b1729ad7ec | ||
|
|
daec11b981 | ||
|
|
25ac9e2aa1 | ||
|
|
3b02eb8851 |
2
docs/User Guide/User Guide/AI.md
vendored
2
docs/User Guide/User Guide/AI.md
vendored
@@ -21,7 +21,7 @@ You will then need to set up the AI “provider” that you wish to use to creat
|
||||
|
||||
In the following example, we're going to use our self-hosted Ollama instance to create the embeddings for our Notes. You can see additional documentation about installing your own Ollama locally in <a class="reference-link" href="AI/Providers/Ollama/Installing%20Ollama.md">Installing Ollama</a>.
|
||||
|
||||
To see what embedding models Ollama has available, you can check out [this search](https://ollama.com/search?c=embedding)on their website, and then `pull` whichever one you want to try out. As of 4/15/25, my personal favorite is `mxbai-embed-large`.
|
||||
To see what embedding models Ollama has available, you can check out [this search](https://ollama.com/search?c=embedding) on their website, and then `pull` whichever one you want to try out. A popular choice is `mxbai-embed-large`.
|
||||
|
||||
First, we'll need to select the Ollama provider from the tabs of providers, then we will enter in the Base URL for our Ollama. Since our Ollama is running on our local machine, our Base URL is `http://localhost:11434`. We will then hit the “refresh” button to have it fetch our models:
|
||||
|
||||
|
||||
@@ -3,14 +3,14 @@
|
||||
|
||||
In Trilium, attributes are key-value pairs assigned to notes, providing additional metadata or functionality. There are two primary types of attributes:
|
||||
|
||||
1. <a class="reference-link" href="Attributes/Labels.md">Labels</a> can be used for a variety of purposes, such as storing metadata or configuring the behaviour of notes. Labels are also searchable, enhancing note retrieval.
|
||||
1. <a class="reference-link" href="Attributes/Labels.md">Labels</a> can be used for a variety of purposes, such as storing metadata or configuring the behavior of notes. Labels are also searchable, enhancing note retrieval.
|
||||
|
||||
For more information, including predefined labels, see <a class="reference-link" href="Attributes/Labels.md">Labels</a>.
|
||||
2. <a class="reference-link" href="Attributes/Relations.md">Relations</a> define connections between notes, similar to links. These can be used for metadata and scripting purposes.
|
||||
|
||||
For more information, including a list of predefined relations, see <a class="reference-link" href="Attributes/Relations.md">Relations</a>.
|
||||
|
||||
These attributes play a crucial role in organizing, categorising, and enhancing the functionality of notes.
|
||||
These attributes play a crucial role in organizing, categorizing, and enhancing the functionality of notes.
|
||||
|
||||
## Viewing the list of attributes
|
||||
|
||||
|
||||
@@ -14,7 +14,7 @@ const {secret, title, content} = req.body;
|
||||
if (req.method == 'POST' && secret === 'secret-password') {
|
||||
// notes must be saved somewhere in the tree hierarchy specified by a parent note.
|
||||
// This is defined by a relation from this code note to the "target" parent note
|
||||
// alternetively you can just use constant noteId for simplicity (get that from "Note Info" dialog of the desired parent note)
|
||||
// alternatively you can just use constant noteId for simplicity (get that from "Note Info" dialog of the desired parent note)
|
||||
const targetParentNoteId = api.currentNote.getRelationValue('targetNote');
|
||||
|
||||
const {note} = api.createTextNote(targetParentNoteId, title, content);
|
||||
@@ -37,7 +37,7 @@ This script note has also following two attributes:
|
||||
Let's test this by using an HTTP client to send a request:
|
||||
|
||||
```
|
||||
POST http://my.trilium.org/custom/create-note
|
||||
POST http://your-trilium-server/custom/create-note
|
||||
Content-Type: application/json
|
||||
|
||||
{
|
||||
@@ -70,7 +70,7 @@ For more information, see [Custom Resource Providers](Custom%20Resource%20Provi
|
||||
REST request paths often contain parameters in the URL, e.g.:
|
||||
|
||||
```
|
||||
http://my.trilium.org/custom/notes/123
|
||||
http://your-trilium-server/custom/notes/123
|
||||
```
|
||||
|
||||
The last part is dynamic so the matching of the URL must also be dynamic - for this reason the matching is done with regular expressions. Following `customRequestHandler` value would match it:
|
||||
@@ -85,4 +85,4 @@ Additionally, this also defines a matching group with the use of parenthesis whi
|
||||
const noteId = api.pathParams[0];
|
||||
```
|
||||
|
||||
Often you also need query params (as in e.g. `http://my.trilium.org/custom/notes?noteId=123`), you can get those with standard express `req.query.noteId`.
|
||||
Often you also need query params (as in e.g. `http://your-trilium-server/custom/notes?noteId=123`), you can get those with standard express `req.query.noteId`.
|
||||
@@ -13,7 +13,7 @@ Note search enables you to find notes by searching for text in the title, conten
|
||||
To search for notes, click on the magnifying glass icon on the toolbar or press the keyboard [shortcut](../Keyboard%20Shortcuts.md).
|
||||
|
||||
1. Set the text to search for in the _Search string_ field.
|
||||
1. Apart from searching for words ad-literam, there is also the possibility to search for attributes or properties of notes.
|
||||
1. Apart from searching for words literally, there is also the possibility to search for attributes or properties of notes.
|
||||
2. See the examples below for more information.
|
||||
2. To limit the search to a note and its sub-children, set a note in _Ancestor_.
|
||||
1. This value is also pre-filled if the search is triggered from a [hoisted note](Note%20Hoisting.md) or a [workspace](Workspaces.md).
|
||||
|
||||
@@ -25,7 +25,7 @@ When you delete a note in Trilium, it is actually only marked for deletion (soft
|
||||
|
||||
Within (by default) 7 days, it is possible to undelete these soft-deleted notes - open the <a class="reference-link" href="UI%20Elements/Recent%20Changes.md">Recent Changes</a> dialog, and you will see a list of all modified notes including the deleted ones. Notes available for undeletion have a link to do so. This is kind of "trash can" functionality known from e.g. Windows.
|
||||
|
||||
Clicking an undelete will recover the note, it's content and attributes - note should be just as before being deleted. This action will also undelete note's children which have been deleted in the same action.
|
||||
Clicking an undelete will recover the note, its content and attributes - note should be just as before being deleted. This action will also undelete note's children which have been deleted in the same action.
|
||||
|
||||
To be able to undelete a note, it is necessary that deleted note's parent must be undeleted (otherwise there's no place where we can undelete it to). This might become a problem when you delete more notes in succession - the solution is then undelete in the reverse order of your deletion.
|
||||
|
||||
|
||||
@@ -20,7 +20,7 @@ If you are using the _Fixed_ formatting toolbar, all the formatting buttons for
|
||||
* As a more advanced use, it's possible to change the note type in order to modify the [source code](../../Advanced%20Usage/Note%20source.md) of a note.
|
||||
* _**Protect the note**_ toggles whether the current note is encrypted and accessible only by entering the protected session. See [Protected Notes](../Notes/Protected%20Notes.md) for more information.
|
||||
* _**Editable**_ changes whether the current note:
|
||||
* Enters [read-only mode](../Notes/Read-Only%20Notes.md) automatically if the note is too big (default behaviour).
|
||||
* Enters [read-only mode](../Notes/Read-Only%20Notes.md) automatically if the note is too big (default behavior).
|
||||
* Is always in read-only mode (however it can still be edited temporarily).
|
||||
* Is always editable, regardless of its size.
|
||||
* _**Bookmark**_ toggles the display of the current note into the [Launch Bar](Launch%20Bar.md) for easy access. See [Bookmarks](../Navigation/Bookmarks.md) for more information.
|
||||
|
||||
4
docs/User Guide/User Guide/Collections.md
vendored
4
docs/User Guide/User Guide/Collections.md
vendored
@@ -1,5 +1,5 @@
|
||||
# Collections
|
||||
Collections are a unique type of notes that don't have a content, but instead display its child notes in various presentation methods.
|
||||
Collections are a unique type of note that don't have content, but instead display their child notes in various presentation methods.
|
||||
|
||||
## Main collections
|
||||
|
||||
@@ -28,7 +28,7 @@ To change the configuration of a collection or even switch to a different collec
|
||||
|
||||
## Archived notes
|
||||
|
||||
By default, [archived notes](Basic%20Concepts%20and%20Features/Notes/Archived%20Notes.md) will not be shown in collections. This behaviour can be changed by going to _Collection Properties_ in the <a class="reference-link" href="Basic%20Concepts%20and%20Features/UI%20Elements/Ribbon.md">Ribbon</a> and checking _Show archived notes_.
|
||||
By default, [archived notes](Basic%20Concepts%20and%20Features/Notes/Archived%20Notes.md) will not be shown in collections. This behavior can be changed by going to _Collection Properties_ in the <a class="reference-link" href="Basic%20Concepts%20and%20Features/UI%20Elements/Ribbon.md">Ribbon</a> and checking _Show archived notes_.
|
||||
|
||||
Archived notes will be generally indicated by being greyed out as opposed to the normal ones.
|
||||
|
||||
|
||||
@@ -16,4 +16,4 @@ Trilium offers various startup scripts to customize your experience:
|
||||
|
||||
## Synchronization
|
||||
|
||||
For Trilium desktp users who wish to synchronize their data with a server instance, refer to the <a class="reference-link" href="Synchronization.md">Synchronization</a> guide for detailed instructions.
|
||||
For Trilium desktop users who wish to synchronize their data with a server instance, refer to the <a class="reference-link" href="Synchronization.md">Synchronization</a> guide for detailed instructions.
|
||||
@@ -32,7 +32,7 @@ export TRILIUM_DATA_DIR=/home/myuser/data/my-trilium-data
|
||||
|
||||
### Disabling / Modifying the Upload Limit
|
||||
|
||||
If you're running into the 250MB limit imposed on the server by default, and you'd like to increase the upload limit, you can set the `TRILIUM_NO_UPLOAD_LIMIT` environment variable to `true` disable it completely:
|
||||
If you're running into the 250MB limit imposed on the server by default, and you'd like to increase the upload limit, you can set the `TRILIUM_NO_UPLOAD_LIMIT` environment variable to `true` to disable it completely:
|
||||
|
||||
```
|
||||
export TRILIUM_NO_UPLOAD_LIMIT=true
|
||||
|
||||
2
docs/User Guide/User Guide/Note Types.md
vendored
2
docs/User Guide/User Guide/Note Types.md
vendored
@@ -1,5 +1,5 @@
|
||||
# Note Types
|
||||
One core features of Trilium is that it supports multiple types of notes, depending on the need.
|
||||
One of the core features of Trilium is that it supports multiple types of notes, depending on the need.
|
||||
|
||||
## Creating a new note with a different type via the note tree
|
||||
|
||||
|
||||
4
docs/User Guide/User Guide/Scripting.md
vendored
4
docs/User Guide/User Guide/Scripting.md
vendored
@@ -1,14 +1,14 @@
|
||||
# Scripting
|
||||
Trilium supports creating <a class="reference-link" href="Note%20Types/Code.md">Code</a> notes, i.e. notes which allow you to store some programming code and highlight it. Special case is JavaScript code notes which can also be executed inside Trilium which can in conjunction with <a class="reference-link" href="Scripting/Script%20API.md">Script API</a> provide extra functionality.
|
||||
|
||||
## Scripting
|
||||
## Architecture Overview
|
||||
|
||||
To go further I must explain basic architecture of Trilium - in its essence it is a classic web application - it has these two main components:
|
||||
|
||||
* frontend running in the browser (using HTML, CSS, JavaScript) - this is mainly used to interact with the user, display notes etc.
|
||||
* backend running JavaScript code in node.js runtime - this is responsible for e.g. storing notes, encrypting them etc.
|
||||
|
||||
So we have frontend and backend, each with their own set of responsibilities, but their common feature is that they both run JavaScript code. Add to this the fact, that we're able to create JavaScript \[\[code notes\]\] and we're onto something.
|
||||
So we have frontend and backend, each with their own set of responsibilities, but their common feature is that they both run JavaScript code. Add to this the fact, that we're able to create JavaScript <a class="reference-link" href="Note%20Types/Code.md">code notes</a> and we're onto something.
|
||||
|
||||
## Use cases
|
||||
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
# Troubleshooting
|
||||
As Trilium is currently in beta, encountering bugs is to be expected.
|
||||
While Trilium is actively maintained and stable, encountering bugs is possible.
|
||||
|
||||
## General Quick Fix
|
||||
|
||||
@@ -21,7 +21,7 @@ TRILIUM_START_NOTE_ID=root ./trilium
|
||||
|
||||
## Broken Script Prevents Application Startup
|
||||
|
||||
If a custom script causes Triliumto crash, and it is set as a startup script or in an active [custom widget](Scripting/Custom%20Widgets.md), start Triliumin "safe mode" to prevent any custom scripts from executing:
|
||||
If a custom script causes Trilium to crash, and it is set as a startup script or in an active [custom widget](Scripting/Custom%20Widgets.md), start Trilium in "safe mode" to prevent any custom scripts from executing:
|
||||
|
||||
```
|
||||
TRILIUM_SAFE_MODE=true ./trilium
|
||||
|
||||
22
docs/index.md
vendored
22
docs/index.md
vendored
@@ -21,27 +21,27 @@ Trilium Notes is a powerful, feature-rich note-taking application designed for b
|
||||
|
||||
<div class="grid cards" markdown>
|
||||
|
||||
- :material-rocket-launch-outline: **[Quick Start Guide](User%20Guide/quick-start.md)**
|
||||
- :material-rocket-launch-outline: **[Quick Start Guide](User%20Guide/User%20Guide/Quick%20Start.md)**
|
||||
|
||||
Get up and running with Trilium in minutes
|
||||
|
||||
- :material-download: **[Installation](User%20Guide/installation.md)**
|
||||
- :material-download: **[Desktop Installation](User%20Guide/User%20Guide/Installation%20%26%20Setup/Desktop%20Installation.md)**
|
||||
|
||||
Download and install Trilium on your platform
|
||||
Download and install Trilium on your desktop
|
||||
|
||||
- :material-docker: **[Docker Setup](User%20Guide/docker.md)**
|
||||
- :material-server: **[Server Installation](User%20Guide/User%20Guide/Installation%20%26%20Setup/Server%20Installation.md)**
|
||||
|
||||
Deploy Trilium using Docker containers
|
||||
Deploy Trilium as a server
|
||||
|
||||
- :material-book-open-variant: **[User Guide](User%20Guide/index.md)**
|
||||
- :material-book-open-variant: **[User Guide](User%20Guide/User%20Guide.md)**
|
||||
|
||||
Comprehensive guide to all features
|
||||
|
||||
- :material-code-braces: **[Script API](Script%20API/index.md)**
|
||||
- :material-code-braces: **[Script API](Script%20API/index.html)**
|
||||
|
||||
Automate and extend Trilium with scripting
|
||||
|
||||
- :material-wrench: **[Developer Guide](Developer%20Guide/index.md)**
|
||||
- :material-wrench: **[Developer Guide](Developer%20Guide/Developer%20Guide/Environment%20Setup.md)**
|
||||
|
||||
Contributing and development documentation
|
||||
|
||||
@@ -80,14 +80,14 @@ Trilium Notes is a powerful, feature-rich note-taking application designed for b
|
||||
|
||||
## Getting Help
|
||||
|
||||
- **[FAQ](support/faq.md)** - Frequently asked questions
|
||||
- **[Troubleshooting](support/troubleshooting.md)** - Common issues and solutions
|
||||
- **[FAQ](User%20Guide/User%20Guide/FAQ.md)** - Frequently asked questions
|
||||
- **[Troubleshooting](User%20Guide/User%20Guide/Troubleshooting.md)** - Common issues and solutions
|
||||
- **[Community Forum](https://github.com/triliumnext/trilium/discussions)** - Ask questions and share tips
|
||||
- **[Issue Tracker](https://github.com/triliumnext/trilium/issues)** - Report bugs and request features
|
||||
|
||||
## Contributing
|
||||
|
||||
Trilium is open-source and welcomes contributions! Check out our [Contributing Guide](Developer%20Guide/contributing.md) to get started.
|
||||
Trilium is open-source and welcomes contributions! Check out our [GitHub repository](https://github.com/triliumnext/trilium) to get started.
|
||||
|
||||
## License
|
||||
|
||||
|
||||
Reference in New Issue
Block a user