1
0
silverbullet/website/Page Templates.md
Zef Hemel f30b1d3418
Templates 2.0 (#636)
Templates 2.0 and a whole bunch of other refactoring
2024-01-20 19:16:07 +01:00

2.1 KiB

Page templates enable you to define templates for creating new pages. They can be invoked in a few ways:

  • Explicitly using the {[Page: From Template]} command
  • Explicitly using a custom command configured in the template
  • Implicitly when configured to be used automatically for a specific page prefix.

A page template is a Templates using the hooks.newPage attribute (in Frontmatter).

The following configuration options are supported:

  • suggestedName: the proposed name for the new page, can use template placeholders such as {{today}}.
  • confirmName: Confirm the suggested page name before creating it (defaults to true).
  • openIfExists: If a page with the suggestedName already exists, open it instead of overwriting it. This is useful to implement page templates like Library/Journal/New Page/Daily Note.
  • forPrefix: automatically apply (or offer, when multiple page templates match) this page template for page names that start with this prefix.
  • command: expose the snippet as a Commands.
  • key: Bind the snippet to a keyboard shortcut (note: this requires to also specify the command configuration).
  • mac: Bind the snippet to a Mac-specific keyboard shortcut.

An example:

---
tags: template
hooks.newPage:
  suggestedName: "📕 "
  forPrefix: "📕 "
---
# {{@page.name}}
As recorded on {{today}}.

## Introduction
## Notes
## Conclusions

When using the {[Page: From Template]} command and selecting this template, this will prompt you to pick a page name (defaulting to “📕 “), and then create the following page (on 2023-08-08) when you pick “📕 Harry Potter” as a page name:

# 📕 Harry Potter
As recorded on 2022-08-08.

## Introduction
## Notes
## Conclusions

In addition, this page template will be used automatically when you create any new page starting with “📕 “ by navigating to a new page matching this prefix, such as “📕 Foundation”.

As with any Templates, the frontmatter can be used to define Frontmatter for the new page.