1
0
silverbullet/website/🔌 Core.md
2022-11-02 09:06:30 +01:00

3.3 KiB
Raw Blame History

type uri repo author
plug builtin:core https://github.com/silverbulletmd/silverbullet Silver Bullet Authors

This documentation is still a WIP.

Templating

The core plug implements a few templating mechanisms.

Page Templates

The {[Template: Instantiate Page]} command enables you to create a new page based on a page template.

Page templates, by default, are looked for in the template/page/ prefix. So creating e.g. a template/page/Meeting Notes page will create a “Meeting Notes” template. You can override this prefix by setting the pageTemplatePrefix in SETTINGS.

Page templates have one “magic” type of page metadata that is used during instantiation:

  • $name is used as the default value for a new page based on this template

In addition, any standard template placeholders are available (see below)

For instance:

---
$name: "📕 "
---

# {{page}}
As recorded on {{today}}.

## Introduction
## Notes
## Conclusions

Will prompt you to pick a page name (defaulting to “📕 “), and then create the following page (on 2022-08-08) when you pick “📕 Harry Potter” as a page name:

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

## Introduction
## Notes
## Conclusions

Snippets

Snippets are similar to page templates, except you insert them into an existing page with the /snippet slash command. The default prefix is snippet/ which is configurable via the snippetPrefix setting in SETTINGS.

Snippet templates do not support the $name page meta, because it doesnt apply.

However, snippets do support the special |^| placeholder for placing the cursor caret after injecting the snippet. If you leave it out, the cursor will simply be placed at the end, but if you like to insert the cursor elsewhere, that position can be set with the |^| placeholder.

For instance to replicate the /query slash command as a snippet:

<!-- #query |^| -->

<!-- /query -->

Which would insert the cursor right after #query.

Daily Note

The {[Open Daily Note]} command navigates (or creates) a daily note prefixed with a 📅 emoji by default, but this is configurable via the dailyNotePrefix setting in SETTINGS. If you have a page template (see above) named templates/page/Daily Note it will use this as a template, otherwise, the page will just be empty.

Weekly Note

The {[Open Weekly Note]} command navigates (or creates) a weekly note prefixed with a 🗓️ emoji by default, but this is configurable via the weeklyNotePrefix setting in SETTINGS. If you have a page template (see above) named templates/page/Weekly Note it will use this as a template, otherwise, the page will just be empty.

Quick Note

The {[Quick Note]} command will navigate to an empty page named with the current date and time prefixed with a 📥 emoji, but this is configurable via the quickNotePrefix in SETTINGS. The use case is to take a quick note outside of your current context.

Template placeholders

Currently supported (hardcoded in the code):

  • {{today}}: Todays date in the usual YYYY-MM-DD format
  • {{tomorrow}}: Tomorrows date in the usual YYY-MM-DD format
  • {{yesterday}}: Yesterdays date in the usual YYY-MM-DD format
  • {{lastWeek}}: Current date - 7 days
  • {{page}}: The name of the current page