Release Notes(version 0.11)

  • My wife, Ilana Lin, drew a comic for this week's release. Follow her on instagram and she might draw more comics for Dendron 😇

Summary

This week's release comes with improved references as well as better tooling around pods and snippets.

Dendron's pretty refs help you identify when content is embedded from elsewhere and provide links back to the source.

Dendron allows you to reference content from other notes and embed them in your current note. This is also known as transclusion.

Note references are different from regular links in that they actually include the content of the destination in the current note.

Note references are extremely powerful and help you re-use your notes in a variety of places.

Currently, Dendron supports 4 types of references to help you control the amount of content that gets embedded:

  • full note references
  • header references
  • block references
  • range references

References have the following syntax:

![[name.of.note]]

Here's an example with a block anchor:

![[name.of.note#^important-paragraph]]

Another example with a header range:

![[name.of.note#starting-header:#ending-header]]

NOTE: When referencing headers with spaces in them, the note ref needs to use - instead of spaces within the name. This is a limitation of adopting GitHub-style slugger references. This is also useful for when multiple subheaders on a page may have the same name, which would expect something else #foo vs. #foo-1 vs. #foo-2. This can be automatically taken care of by highlighting a header, and using cmd+shift+r / ctrl+shift+r to add a properly-formatted note ref to the clipboard.

For more information:

The Dendron CLI lets you access a subset of Dendron's functionality inside the terminal, including the ability to import/export your notes.

We also released the Dendron Snippet Maker, a standalone extension that comes bundled with Dendron which helps you create snippets from the current selected text.

These release notes are summary of the more notable changes, for the full list, please look at our CHANGELOG

CLI

Release Dendron CLI

Dendron now has a its own CLI that you can run standalone from the Dendron plugin.

Summary

The Dendron CLI exposes Dendron's functionality via the command line.

Enhancements

  • Run export pod using cli
  • Run import pod using cli
  • Run backfill using cli

Fixes

  • Import using cli not initialized in certain cases

Notes

New note from selection cmd

Create new note from a selection

Pods

Add configure pod command

  • shortcuts: none

Update your pod configuration

Enhancements

  • Use consistent interface for import/export
  • Additional additional options on export

Fixes

  • Deal with . when importing directories

Publishing

Published sites use pretty refs

  • status: optional
  • default: True

Whether to use pretty note refs or plain refs.

Support noindex option

  • default: false

To tell google to not index a page, you can add the following tag to the frontmatter. You can also have this as a default for a given hierarchy by setting noIndexByDefault: true in the site config.

...
noindex: true

Enhancements

  • Add config to specify pretty refs

Fixes

  • Update bad links
  • Fix ref display on published site

Refs

Support wildcard refs

Start anchor wildcard-header-reference not found

Enhancements

  • Create ref with anchor if selected
  • Render refs in container

Fixes

  • Bad ref resolution

Workbench

Dendron Snippet Maker

This is a standalone extension used by Dendron to help you more easily create snippets.

Commands

Create Global Snippet

Goto Global Snippet

Enhancements

  • Friendlier default settings

Community Announcements

Planters

A bunch of our fellow Dendronites have published notes using Dendron. You can check it at the showcase.

We've also created a new role -> @Planter (Private) :man_farmer::woman_farmer: , to recognize folks who have published using Dendron.

If you have a site you would like to showcase, please ping Kevin (kevin@dendron.so) or edit the showcase page directly and adding your site :)

Thank You

Last and most of all, a big thanks to the following gardeners that brought up issues, contributions, and fixes to this release.