Add week note and quarter note support

bin/tpl/anonymize-database.sql

@@ -14,7 +14,8 @@ UPDATE attributes SET name  = 'name', value = 'value' WHERE type = 'label'
        'widget', 'noteInfoWidgetDisabled', 'linkMapWidgetDisabled', 'revisionsWidgetDisabled',
        'whatLinksHereWidgetDisabled', 'similarNotesWidgetDisabled', 'workspace', 'workspaceIconClass',
        'workspaceTabBackgroundColor', 'workspaceCalendarRoot', 'workspaceTemplate', 'searchHome', 'workspaceInbox',
-       'workspaceSearchHome', 'sqlConsoleHome', 'datePattern', 'pageSize', 'viewType', 'mapRootNoteId',
+       'workspaceSearchHome', 'sqlConsoleHome', 'datePattern', 'weekPattern', 'enableWeekNote', 'monthPattern',
+       'quarterPattern', 'yearPattern', 'enableQuarterNote', 'pageSize', 'viewType', 'mapRootNoteId',
        'bookmarkFolder', 'sorted', 'sortDirection', 'sortFoldersFirst', 'sortNatural', 'sortLocale', 'top',
        'fullContentWidth', 'shareHiddenFromTree', 'shareExternalLink', 'shareOmitDefaultCss', 'shareRoot', 'shareDescription',
        'shareRaw', 'shareDisallowRobotIndexing', 'shareIndex', 'displayRelations', 'hideRelations', 'titleTemplate',
@@ -31,7 +32,8 @@ UPDATE attributes SET name = 'name' WHERE type = 'relation'
        'widget', 'noteInfoWidgetDisabled', 'linkMapWidgetDisabled', 'revisionsWidgetDisabled',
        'whatLinksHereWidgetDisabled', 'similarNotesWidgetDisabled', 'workspace', 'workspaceIconClass',
        'workspaceTabBackgroundColor', 'workspaceCalendarRoot', 'workspaceTemplate', 'searchHome', 'workspaceInbox',
-       'workspaceSearchHome', 'sqlConsoleHome', 'datePattern', 'pageSize', 'viewType', 'mapRootNoteId',
+       'workspaceSearchHome', 'sqlConsoleHome', 'datePattern', 'weekPattern', 'enableWeekNote', 'monthPattern',
+       'quarterPattern', 'yearPattern', 'enableQuarterNote', 'pageSize', 'viewType', 'mapRootNoteId',
        'bookmarkFolder', 'sorted', 'sortDirection', 'sortFoldersFirst', 'sortNatural', 'sortLocale', 'top',
        'fullContentWidth', 'shareHiddenFromTree', 'shareExternalLink', 'shareOmitDefaultCss', 'shareRoot', 'shareDescription',
        'shareRaw', 'shareDisallowRobotIndexing', 'shareIndex', 'displayRelations', 'hideRelations', 'titleTemplate',

docs/User Guide/!!!meta.json

@@ -1,6 +1,6 @@
 {
     "formatVersion": 2,
-    "appVersion": "0.92.6",
+    "appVersion": "0.92.7",
     "files": [
         {
             "isClone": false,
@@ -3511,58 +3511,51 @@
                                             "position": 20
                                         },
                                         {
-                                            "type": "label",
-                                            "name": "shareAlias",
-                                            "value": "search",
-                                            "isInheritable": false,
-                                            "position": 20
-                                        },
-                                        {
-                                            "type": "label",
-                                            "name": "iconClass",
-                                            "value": "bx bx-search-alt-2",
+                                            "type": "relation",
+                                            "name": "internalLink",
+                                            "value": "OR8WJ7Iz9K4U",
                                             "isInheritable": false,
                                             "position": 30
                                         },
                                         {
                                             "type": "relation",
                                             "name": "internalLink",
-                                            "value": "xYmIYSP6wE3F",
+                                            "value": "wX4HbRucYSDD",
                                             "isInheritable": false,
                                             "position": 40
                                         },
                                         {
                                             "type": "relation",
                                             "name": "internalLink",
-                                            "value": "YtSN43OrfzaA",
+                                            "value": "ivYnonVFBxbQ",
                                             "isInheritable": false,
                                             "position": 50
                                         },
                                         {
                                             "type": "relation",
                                             "name": "internalLink",
-                                            "value": "OR8WJ7Iz9K4U",
+                                            "value": "xYmIYSP6wE3F",
                                             "isInheritable": false,
                                             "position": 60
                                         },
                                         {
                                             "type": "relation",
                                             "name": "internalLink",
-                                            "value": "9sRHySam5fXb",
+                                            "value": "YtSN43OrfzaA",
                                             "isInheritable": false,
                                             "position": 70
                                         },
                                         {
                                             "type": "relation",
                                             "name": "internalLink",
-                                            "value": "m523cpzocqaD",
+                                            "value": "9sRHySam5fXb",
                                             "isInheritable": false,
                                             "position": 80
                                         },
                                         {
                                             "type": "relation",
                                             "name": "internalLink",
-                                            "value": "wX4HbRucYSDD",
+                                            "value": "m523cpzocqaD",
                                             "isInheritable": false,
                                             "position": 90
                                         },
@@ -3590,16 +3583,23 @@
                                         {
                                             "type": "relation",
                                             "name": "internalLink",
-                                            "value": "ivYnonVFBxbQ",
+                                            "value": "oPVyFC7WL2Lp",
                                             "isInheritable": false,
                                             "position": 130
                                         },
                                         {
-                                            "type": "relation",
-                                            "name": "internalLink",
-                                            "value": "oPVyFC7WL2Lp",
+                                            "type": "label",
+                                            "name": "shareAlias",
+                                            "value": "search",
                                             "isInheritable": false,
-                                            "position": 140
+                                            "position": 20
+                                        },
+                                        {
+                                            "type": "label",
+                                            "name": "iconClass",
+                                            "value": "bx bx-search-alt-2",
+                                            "isInheritable": false,
+                                            "position": 30
                                         }
                                     ],
                                     "format": "markdown",
@@ -3852,16 +3852,16 @@
                                     "mime": "text/html",
                                     "attributes": [
                                         {
-                                            "type": "label",
-                                            "name": "iconClass",
-                                            "value": "bx bx-search-alt-2",
+                                            "type": "relation",
+                                            "name": "internalLink",
+                                            "value": "MI26XDLSAlCD",
                                             "isInheritable": false,
                                             "position": 10
                                         },
                                         {
                                             "type": "relation",
                                             "name": "internalLink",
-                                            "value": "8YBEPzcpUgxw",
+                                            "value": "iPIMuisry3hd",
                                             "isInheritable": false,
                                             "position": 20
                                         },
@@ -3875,16 +3875,16 @@
                                         {
                                             "type": "relation",
                                             "name": "internalLink",
-                                            "value": "iPIMuisry3hd",
+                                            "value": "8YBEPzcpUgxw",
                                             "isInheritable": false,
                                             "position": 40
                                         },
                                         {
-                                            "type": "relation",
-                                            "name": "internalLink",
-                                            "value": "MI26XDLSAlCD",
+                                            "type": "label",
+                                            "name": "iconClass",
+                                            "value": "bx bx-search-alt-2",
                                             "isInheritable": false,
-                                            "position": 50
+                                            "position": 10
                                         }
                                     ],
                                     "format": "markdown",

docs/User Guide/User Guide/Advanced Usage/Advanced Showcases/Day Notes.md

@@ -13,48 +13,91 @@ This pattern works well also because of [Cloning Notes](../../Basic%20Concepts%2
 
 ![](Day%20Notes_image.png)
 
-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 some text in its content and also has some child notes (some of them are from [Task manager](Task%20Manager.md)).
+You can see the structure of day notes appearing under "Journal" note - 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](Task%20Manager.md)).
 
 You can also notice how this day note has [promoted attribute](../Attributes/Promoted%20Attributes.md) "weight" where you can track your daily weight. This data is then used in [Weight tracker](Weight%20Tracker.md).
 
+## 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](../Templates.md) functionality, and it could be used together with day notes.
 
 You can define one of the following relations on the root of the journal (identified by `#calendarRoot` label):
 
 *   yearTemplate
+*   quarterTemplate (if `#enableQuarterNotes` is set)
 *   monthTemplate
+*   weekTemplate (if `#enableWeekNotes` is set)
 *   dateTemplate
 
 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`.
 
-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:
+### Date pattern
 
-*   `{dayInMonthPadded} - {weekDay}` day notes are named e.g. "24 - Monday"
-*   `{dayInMonthPadded}: {weekDay3}` day notes are named e.g. "24: Mon"
-*   `{dayInMonthPadded}: {weekDay2}` day notes are named e.g. "24: Mo"
-*   `{isoDate} - {weekDay}` day notes are named e.g. "2020-12-24 - Monday"
+It's possible to customize the title of generated date notes by defining a `#datePattern` attribute on a root calendar note (identified by `#calendarRoot` label). Following are possible values:
+
+*   `{isoDate}` results in an ISO 8061 formatted date (e.g. "2025-03-09" for March 9, 2025)
+*   `{dateNumber}` results in a number like `9` for the 9th day of the month, `11` for the 11th day of the month
+*   `{dateNumberPadded}` results in a number like `09` for the 9th day of the month, `11` for the 11th day of the month
 *   `{ordinal}` is replaced with the ordinal date (e.g. 1st, 2nd, 3rd) etc.
+*   `{weekDay}` results in the full day name (e.g. `Monday`)
+*   `{weekDay3}` is replaced with the first 3 letters of the day, e.g. Mon, Tue, etc.
+*   `{weekDay2}` is replaced with the first 2 letters of the day, e.g. Mo, Tu, etc.
+
+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:
+
+*   `{weekNumber}` results in a number like `9` for the 9th week of the year, `11` for the 11th week of the year
+*   `{weekNumberPadded}` results in a number like `09` for the 9th week of the year, `11` for the 11th week of the year
+*   `{shortWeek}` results in a short week string like `W9` for the 9th week of the year, `W11` for the 11th week of the year
+*   `{shortWeek3}` results in a short week string like `W09` for the 9th week of the year, `W11` for the 11th week of the year
+
+The default is `Week {weekNumber}`
 
-## Month pattern
+### Month pattern
 
-It is also possible to customize the title of generated month notes through the `#monthPattern` attribute, much like `#datePattern`. The options are:
+It is also possible to customize the title of generated month notes through the `#monthPattern` attribute on the root calendar note. The options are:
 
 *   `{isoMonth}` results in an ISO 8061 formatted month (e.g. "2025-03" for March 2025)
+*   `{monthNumber}` results in a number like `9` for September, and `11` for November
 *   `{monthNumberPadded}` results in a number like `09` for September, and `11` for November
 *   `{month}` results in the full month name (e.g. `September` or `October`)
 *   `{shortMonth3}` is replaced with the first 3 letters of the month, e.g. Jan, Feb, etc.
 *   `{shortMonth4}` is replaced with the first 4 letters of the month, e.g. Sept, Octo, etc.
 
 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:
+
+*   `{quarterNumber}` results in a number like `1` for the 1st quarter of the year
+*   `{shortQuarter}` results in a short quarter string like `Q1` for the 1st quarter of the year
+
+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:
+
+*   `{year}` results in the full year (e.g. `2025`)
+
+The default is `{year}`
+
 ## Implementation
 
 Trilium has some special support for day notes in the form of [backend Script API](https://triliumnext.github.io/Notes/backend_api/BackendScriptApi.html) - see e.g. getDayNote() function.
 
-Day (and year, month) notes are created with a label - e.g. `#dateNote="2018-08-16"` this can then be used by other scripts to add new notes to day note etc.
+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).
+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.

docs/frontend_api/FrontendScriptApi.html

@@ -4680,7 +4680,7 @@ <h5>Returns:</h5>
 
 
 
-    <h4 class="name" id="getWeekNote"><span class="type-signature"></span>getWeekNote<span class="signature">(date)</span><span class="type-signature"> &rarr; {Promise.&lt;<a href="FNote.html">FNote</a>>}</span></h4>
+    <h4 class="name" id="getWeekFirstDayNote"><span class="type-signature"></span>getWeekFirstDayNote<span class="signature">(date)</span><span class="type-signature"> &rarr; {Promise.&lt;<a href="FNote.html">FNote</a>>}</span></h4>
 
 
 

docs/frontend_api/services_frontend_script_api.js.html

@@ -563,7 +563,7 @@ <h1 class="page-title">Source: services/frontend_script_api.js</h1>
      * @param {string} date - e.g. "2019-04-29"
      * @returns {Promise&lt;FNote>}
      */
-    this.getWeekNote = dateNotesService.getWeekNote;
+    this.getWeekFirstDayNote = dateNotesService.getWeekFirstDayNote;
 
     /**
      * Returns month-note. If it doesn't exist, it is automatically created.

src/etapi/etapi.openapi.yaml

@@ -694,7 +694,7 @@ paths:
     /calendar/weeks/{date}:
         get:
             description: returns a week note for a given date. Gets created if doesn't exist.
-            operationId: getWeekNote
+            operationId: getWeekFirstDayNote
             parameters:
                 - name: date
                   in: path