1.0.1 • Published 6 years ago

drafts-template-parser v1.0.1

Weekly downloads
1
License
ISC
Repository
github
Last release
6 years ago

Drafts 5 Template Parser

The Drafts 5 Template Parser scans a Drafts note for template tags, prompts the user for values, and binds these values to the template. The parser can be used directly as part of a Drafts action, or it can be imported as a dependency for use in other projects.

Example

A common use case for template functionality is sending boilerplate email messages. Take the following template:

Nice to meet you at [[Event]]!
Hi, [[Name]]...

It was great meeting you at [[Event]]. Let's keep in touch.
If there's anything I can do to help [[Company]], please
don't hesistate to reach out to me.

Steve

Drafts will scan the note, and prompt the user for values for "Event", "Name", and "Company". It will then bind these values to the template, and set the following tag values for use in subsequent action steps:

TextHTML (from Markdown)Description
parsed_draftparsed_draft_htmlThe entire Draft note
parsed_titleparsed_title_htmlThe first line of the note
parsed_bodyparsed_body_htmlEverything but the first line of the note
parsed_selectionparsed_selection_htmlThe text selected by the user
parsed_clipboardparsed_clipboard_htmlThe contents of the user's clipboard

So for our "Email Parsed Template" action, a subsequent step can send an email, with [[parsed_title]] as the subject, and [[parsed_body_html]] as the body.

This same pattern can be used for tweets, notes, etc.