Documentation

Development notes are published on triliumnext.github.io/Notes by the CI using GitHub Pages.

The GitHub Pages deployment works by taking the files from the Notes repository, in the docs directory.

How it works

There is a script that uses wget to download all the files from a share, that means:

  1. You must have a local instance of Trilium Notes server.
  2. You must have the documentation imported, up to date and shared.

Note that currently the documentation source file is not distributed (the note export), until a way is found to automate this process. Contact eliandoran should you require to obtain a copy of the documentation.

Setting up .env file

Go to bin/docs and copy .env.example to .env and edit it:

  1. Change the SHARE_PROTOCOL to either http or https depending on your setup.
  2. Change SHARE_HOST to match the domain name or the URL to the host (without the protocol or any slashes).

Generally ROOT_NOTE_ID should not be changed since the note ID must match if the files were imported correctly.

Triggering a build

Run:

./bin/docs/prepare.sh

This will attempt to download all the notes from the share URL and put them in docs, rewritten for GitHub Pages.

Commit the results and follow the normal development process to push them.