Nova

Extensions


Readme

YAML Tag Picker allows you to easily select tags for the YAML front matter in your blog posts. It scans your existing posts for tags and presents them in a Choice Palette, making it easy to maintain consistent tagging across your blog.

You can select multiple tags one after another; when you're done choose "Finish Selection" or press Esc.

Each tag is inserted on a new line, prefixed with a hyphen and a space:

- just
- like
- this

This extension does not suggest new tags, it just allows you to pick from your tags you've already used.

Usage

  1. Open your blog project in Nova
  2. Place your cursor at the start of the line where you want to insert tags in your front matter
  3. Run the YAML Tag Picker command from the Command Palette (I map it to keyboard Cmd+Shift+Enter)
  4. Choose the tags you want to use from the presented list (repeat)
  5. When you're done choose "Finish Selection" or press Esc
  6. The selected tags will be inserted at your cursor position

Configuration

To configure global preferences, open Extensions → Extension Library... then select YAML Tag Picker's Settings tab.

You can customise the following:

  • Posts Folder Name
    • default: _posts
  • Tag Prefix Character
    • default: -
  • Skip Tags Containing
    • default: '

Requirements

  • This extension requires access to your filesystem to read your blog posts
  • Your blog posts should be in the _posts directory (default for Jekyll static site generator)
  • Tags should be defined in the front matter of your posts using the YAML format
  • It can cope with tags specified as an array or as one per-line

Support

If you encounter any issues please open an issue on the GitHub repository.

Bonus!

There's also a command to Create YAML Tag Audit document which will open a markdown file containing all tags, including duplicates, so you can do some manual rationalising or coallescing with the help of search and replace.


Changelog

Version 1.1.2

Change: settings description

Version 1.1.1

Change: gradient icon

Version 1.1.0

Added: Create YAML Tag Audit document

Version 1.0.4

Improved: README and icon

Version 1.0.3

Improved: README

Version 1.0.2

Shorter chooser prompt

Version 1.0.1

Remove debug logging

Version 1.0

Initial release