Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 14 additions & 14 deletions docs/templating-commands/meeting-notes.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,62 +8,62 @@ Like Quick Notes, you have templates that you apply often, and you would like to
However, unlike a meeting note which is attached to a specific NotePlan event, `np.Templating` meeting notes will allow you to create detached meeting notes

## Meeting Notes Templates
By default, Meeting Notes templates are located in "🗓 Meeting Notes" folder, however you can place them where you wish within the "@Templates" folder.
By default, Meeting Notes templates are located in the "🗓 Meeting Notes" folder. However, you can place them where you wish within the "@Templates" folder.

![Template Chooser](/img/templates-meeting-notes.png)

:::caution
Due to utilization of advanced templating features, Meeting Note templates must be using the frontmatter style, legacy templates are **not** supported.
Due to utilization of advanced templating features, Meeting Note templates must use the frontmatter style; legacy templates are **not** supported.
:::

*****

### Using Meeting Notes
When you create a Meeting Note template, it becomes available via the `np:mtn` command. When invoking the `np:mtn`, you will see the **Meeting Note Template Picker**, where you can select the desired Meeting Note template for which you want to create a new note.
When you create a Meeting Note template, it becomes available via the `np:mtn` command. When invoking the `np:mtn`, you will see the **Meeting Note Template Picker**, where you can select the desired template to create a new Meeting Note.

![Template Chooser](/img/meeting-note-chooser.png)

**Step 1:** Invoke NotePlan Command Bar (`Command-J`)
**Step 1:** Invoke the NotePlan Command Bar (`Command-J`)

**Step 2:** Type `np:mtn` (or any of the `mtn` [aliases](/docs/templating-commands/overview/#npmtn))

**Step 3:** Select desired template
**Step 3:** Select the desired template

After selecting the desired Meeting Note, a new note will be created in the defined folder location as defined in the Meeting Note template header.
After selecting the desired Meeting Note, a new note will be created in the folder defined in the Meeting Note template header.

:::important
If you only have a single Meeting Note in the "🗓 Meeting Notes" folder, it will be selected automatically and the Template Chooser dialog will not be displayed.
:::

### Meeting Note Template Required Attributes
Each Meeting Note must contain each of the following items:
Each Meeting Note must contain all of the following items:

- `title` - contains the template title (this is what will appear in `np:qtn` template chooser)
- `type` - specifies that this is a Meeting Note template (should be set to `meeting-note`)
- `folder` - path to folder where new note will be created
- if `folder` has a value of `<select>` new note will be created in the selected folder
- if `folder` has a value of `<current>` new note will be created in the folder of the currently displayed note
- if `folder` has a value of `<current>` but you are not displaying a NotePlan, new note will be created in selected folder
- if `folder` has a value of `<select>` a new note will be created in the selected folder
- if `folder` has a value of `<current>` a new note will be created in the folder of the currently displayed note
- if `folder` has a value of `<current>` but you are not displaying a note, then a new note will be created in the selected folder

In addition, you can use an optional field for `newNoteTitle` which will be used when creating new note. If not supplied, you will be prompted to enter `newNoteTitle`

- `newNoteTitle` - will be name of new note. You can use any `np.Templating` module method, such as `<%- date.now() %>`, or a prompt command such as `<%- prompt('meetingSummary','What would you like to discuss') %>`


:::danger ATTRIBUTE NAMING REQUIREMENTS
All template attributes values must start with an alpha character (a..z, A..Z) and may not include illegal characters such as `#` otherwise must be surrounded with double quotes. To be safe with any frontmatter attribute, it is always a good idea to wrap in quotes as to not lead to issues down the road.
All template attributes values must start with an alpha character (a..z, A..Z) and may not include illegal characters such as `#` unless the attribute value is surrounded with double quotes. To be safe with any frontmatter attribute, it is always a good idea to wrap it in quotes to prevent issues down the road.
:::

**Bad:**

The following attribute value will cause any FrontMatter module method to return an empty attribute block
The following attribute value will cause any FrontMatter module method to return an empty attribute block:
```
title: - invalid character
```

**Good:**

The following attribute value be properly parsed as it is surrounded in quotes
The following attribute value be properly parsed since it is surrounded in quotes:

```
title: "- invalid character"
Expand All @@ -73,7 +73,7 @@ title: "- invalid character"

**Example:**

The following example outlines the 3 mandatory field in a Meeting Note template
The following example outlines the three mandatory fields in a Meeting Note template:

```markdown
---
Expand Down