From 15f62ba1c3c9d5462db9c2840a875d03c6f00b44 Mon Sep 17 00:00:00 2001 From: Elian Doran Date: Sun, 6 Apr 2025 16:47:32 +0300 Subject: [PATCH] feat(docs): update day notes documentation --- .../Advanced Showcases/Day Notes.md | 4 +- .../Advanced Showcases/Day Notes.html | 99 +++++++++++++++---- 2 files changed, 83 insertions(+), 20 deletions(-) diff --git a/docs/User Guide/User Guide/Advanced Usage/Advanced Showcases/Day Notes.md b/docs/User Guide/User Guide/Advanced Usage/Advanced Showcases/Day Notes.md index 0120574ac..06e40a9d0 100644 --- a/docs/User Guide/User Guide/Advanced Usage/Advanced Showcases/Day Notes.md +++ b/docs/User Guide/User Guide/Advanced Usage/Advanced Showcases/Day Notes.md @@ -1,4 +1,4 @@ -# Day Notes +# Day Notes A common pattern in note-taking is that a lot of notes will be centered around a certain date - e.g. you have some tasks which needs to be done on a certain date, you have meeting minutes from a certain date, you have your thoughts etc. and it all revolves around a date on which they occurred. For this reason, it makes sense to create a certain "day workspace" which will centralize all those notes relevant for a certain date. For this, Trilium provides a concept of "day note". Trilium semi-automatically generates a single note for each day. Under this note you can save all those relevant notes. @@ -100,4 +100,4 @@ Trilium has some special support for day notes in the form of [backend Script AP Day (and year, month) notes are created with a label - e.g. `#dateNote="2025-03-09"` this can then be used by other scripts to add new notes to day note etc. -Journal also has relation `child:child:child:template=Day template` (see \[\[attribute inheritance\]\]) which effectively adds \[\[template\]\] to day notes (grand-grand-grand children of Journal). Please note that, when you enable week notes or quarter notes, it will not automatically change the relation for the child level. +Journal also has relation `child:child:child:template=Day template` (see \[\[attribute inheritance\]\]) which effectively adds \[\[template\]\] to day notes (grand-grand-grand children of Journal). Please note that, when you enable week notes or quarter notes, it will not automatically change the relation for the child level. \ No newline at end of file diff --git a/src/public/app/doc_notes/en/User Guide/User Guide/Advanced Usage/Advanced Showcases/Day Notes.html b/src/public/app/doc_notes/en/User Guide/User Guide/Advanced Usage/Advanced Showcases/Day Notes.html index f9b3cbf2e..2b4b909ee 100644 --- a/src/public/app/doc_notes/en/User Guide/User Guide/Advanced Usage/Advanced Showcases/Day Notes.html +++ b/src/public/app/doc_notes/en/User Guide/User Guide/Advanced Usage/Advanced Showcases/Day Notes.html @@ -35,12 +35,19 @@

You can see the structure of day notes appearing under "Journal" note - - there's a note for the whole year 2017, under it, you have "12 - December" - which then contains "18 - Monday". This is our "day note" which contains + - there's a note for the whole year 2025, under it, you have "03 - March" + which then contains "09 - Monday". This is our "day note" which contains some text in its content and also has some child notes (some of them are from Task manager).

You can also notice how this day note has promoted attribute "weight" where you can track your daily weight. This data is then used in Weight tracker.

+

Week Note and Quarter Note

+

Week and quarter notes are disabled by default, since it might be too + much for some people. To enable them, you need to set #enableWeekNotes and #enableQuarterNotes attributes + on the root calendar note, which is identified by #calendarRoot label. + Week note is affected by the first week of year option. Be careful when + you already have some week notes created, it will not automatically change + the existing week notes and might lead to some duplicates.

Templates

Trilium provides template functionality, and it could be used together with day notes.

@@ -48,36 +55,69 @@ (identified by #calendarRoot label):

All of these are relations. When Trilium creates a new note for year or month or date, it will take a look at the root and attach a corresponding ~template relation to the newly created role. Using this, you can e.g. create your daily template with e.g. checkboxes for daily routine etc.

-

Date pattern

+

Naming pattern

+

You can customize the title of generated journal notes by defining a #datePattern, #weekPattern, #monthPattern, #quarterPattern and #yearPattern attribute + on a root calendar note (identified by #calendarRoot label). + The naming pattern replacements follow a level-up compatibility - each + level can use replacements from itself and all levels above it. For example, #monthPattern can + use month, quarter and year replacements, while #weekPattern can + use week, month, quarter and year replacements. But it is not possible + to use week replacements in #monthPattern.

+

Date pattern

It's possible to customize the title of generated date notes by defining - a #datePattern label on a root calendar note (identified by #calendarRoot label). - Following are possible values:

+ a #datePattern attribute on a root calendar note (identified + by #calendarRoot label). Following are possible values:

-

Month pattern

+

The default is {dateNumberPadded} - {weekDay} +

+

Week pattern

+

It is also possible to customize the title of generated week notes through + the #weekPattern attribute on the root calendar note. The options + are:

+ +

The default is Week {weekNumber} +

+

Month pattern

It is also possible to customize the title of generated month notes through - the #monthPattern attribute, much like #datePattern. - The options are:

+ the #monthPattern attribute on the root calendar note. The options + are:

The default is {monthNumberPadded} - {month}

+

Quarter pattern

+

It is also possible to customize the title of generated quarter notes + through the #quarterPattern attribute on the root calendar note. + The options are:

+ +

The default is Quarter {quarterNumber} +

+

Year pattern

+

It is also possible to customize the title of generated year notes through + the #yearPattern attribute on the root calendar note. The options + are:

+ +

The default is {year} +

Implementation

Trilium has some special support for day notes in the form of backend Script API - see e.g. getDayNote() function.

-

Day (and year, month) notes are created with a label - e.g. #dateNote="2018-08-16" this +

Day (and year, month) notes are created with a label - e.g. #dateNote="2025-03-09" this can then be used by other scripts to add new notes to day note etc.

Journal also has relation child:child:child:template=Day template (see [[attribute inheritance]]) which effectively adds [[template]] to day notes - (grand-grand-grand children of Journal).

+ (grand-grand-grand children of Journal). Please note that, when you enable + week notes or quarter notes, it will not automatically change the relation + for the child level.