0.83

Dendron 0.83 has sprouted 🌱

Breaking changes: This release of Dendron updates the publishing configuration within dendron.yml. Updated workspaces will not work with older version of dendron-cli, so make sure to update.

• More information: 0.83 Changelog.

Pod V2 preview continues to grow: you can now export the contents of a hierarchy, filtered by a target vault. This means the multi-vault workspaces can be more targeted in their exports without including notes from undesired vaults.

• More information: Pod v2 exportScope

File Links now support block anchors ( ^block-anchor)! This means that you can create comments in your code, and link directly to the comment blocks. This is configurable to use the older method of linking to line numbers.

Block anchors are more reliable because they will always refer to the marked line, but Dendron has to modify the file to insert a block anchor which looks like ^this. You are free to move the anchor anywhere in the file or to put comment markers like // or # or anything else before them.

• More information: File Links

Highlights

• enhance(pods): add vault filter for pods-v2 hierarchy export
• enhance(notes): change dendron id format to be alphanumeric lowercase
• enhance(workspace): Block Anchor support for non-note files
• deprecate(publishing): Legacy publishing has now been removed from dendron-cli. Dendron users that haven't yet migrated from dendron buildSite commands must migrate to using the dendron publish commands.

Everything Else

• enhance(workspace): calculate backlinks and anchors in engine for improved editor responsiveness
• fix(workspace): Fixed instances where Journal note title values weren't properly formatted as yyyy-MM-dd and the traitID of journalNote wasn't being applied
• fix(workspace): Dendron will try to parse non-dendron files in onFirstOpen
• fix(workspace): error message to be readable in error toast
• fix(publish): horizontal line's height in publishing
• fix(publish): properly set siteIndex when it's not explicitly set by config

Community

General

• We added bookmark bot to the Dendron Discord, meaning that users can now react to a message with :bookmark: 🔖 and Bookmarker will save it for them in a direct message.

Publishing Documentation Updates

A significant review and refresh of publishing settings can be seen in the Publishing configuration reference documentation. Make sure to take a look at all of the configuration options currently available when publishing websites with Dendron!

Starboard and TIL Highlights

These are highlights from the Dendron Discord #starboard and #today-i-learned channels.

• ⭐ seadude shared how to create clickable areas of images that he found useful in reveal.js presentations: "Today I learned you can create a clickable area (or more than one) of an image and have it link anywhere."

  • Useful for RevealJS presentations, etc.

  • Done by using the usemap parameter of <img> and <map> HTML tags

  • Example:

    <img src="https://example.com/image.jpg" usemap="#map" height="550"/>
    
    <map name="map">
        <area shape="circle" coords="330,350,50" alt="egg" href=".\assets\pdfs\timeline2.pdf" target="_blank">
        <area shape="circle" coords="430,250,50" alt="mallet" href=".\assets\pdfs\timeline3.pdf" target="_blank">
    </map>
    

• 💡 seadude shared information about VS Code Snippets:

  • Related: Dendron Snippet Maker

  • Example 1: You can set a default value for a variable by using a colon (:). The DUE: property in the below snippet defaults to the current current month, date, hour but can be modified.

    "TODO": {
    "prefix": "stodo",
    "body": [
        "- [ ] ${1:Enter Task}",
        "- **CAPTURED:**        ${CURRENT_YEAR}-${CURRENT_MONTH}-${CURRENT_DATE}T${CURRENT_HOUR}:${CURRENT_MINUTE}:${CURRENT_SECOND}-08:00",
        "- **DUE:**             ${CURRENT_YEAR}-${2:${CURRENT_MONTH}}-${3:${CURRENT_DATE}}T${4:${CURRENT_HOUR}}:${5:${CURRENT_MINUTE}}:00-08:00",
        "- **PRIORITY:**        ${6|HIGH,MEDIUM,LOW|}",
        "- **STATUS:**          ${7|TODO,WAITING,IN PROGRESS,DONE|}",
        "- **NOTES:**           ",
        "    - $0",
        ],
        "description": "Capture new TODO"
    }
    

  • Example 2: You can set dropdown values for a variable using a pipe (|).

    "Context Switch": {
      "prefix": "scontext",
      "body": [
        "- **TYPE:**          ${1|COMMS,SUPPORT,RESEARCH,MEETING,DEVELOPMENT,TESTING,VALIDATION,CI/CD,PROJECT MGMT,CONSULTING,DOCUMENTATION,ADMINISTRATION,TRAINING,BREAK|}",
        "- **PROJECT:**       ${2|PROJ1,PROJ2|}",
        "- **TOOLS:**         ${3|N/A,PYTHON,AZURE,POWER APPS,POWER AUTOMATE,POWER BI,SHAREPOINT,DENDRON|}",
        "- **START:**         ${CURRENT_YEAR}-${CURRENT_MONTH}-${CURRENT_DATE}T${CURRENT_HOUR}:{$CURRENT_MINUTE}:${CURRENT_SECOND}-08:00",
        "- **END:**           ",
        "- **DURATION:**      ",
        "- **NOTES:**         ",
        "    - $0",
        "---"
        ],
        "description": "Capture new context switch"
    }
    

• 💡 scriptautomate shared a link to the Sourcegraph VS Code extension: "TIL about the Sourcegraph extension for VS Code. I feel like it has interesting potential. Like, imagine searching public Dendron vaults directly from your VS Code?"

Dendron Reading Series

This week's entry in the Dendron Reading Series.

Event Reminders

• Greenhouse Talks: Visit the Greenhouse Talks for notes from previous sessions.
  • Subject: Getting Things Done (GTD) and Other Task-Management Workflows (with Dendron!)
  • Description: Interested speakers from the community will take 5 - 10 minutes each to present their workflows for managing actionable information, followed by an open discussion. The event will be recorded and later published online.
  • Next: Fri, Feb 25, 4:00 PM PST / 00:00 UTC
  • Greenhouse Talk Recordings - YouTube Playlist
• Office Hours: Visit the Office Hours page for notes from previous sessions.
  • Next: Wed, Mar 02, 9:00 AM - 9:30 AM PST
  • Office Hour Recordings - YouTube Playlist
• New User Tuesdays: Visit the New User Tuesdays page for notes from previous sessions.
  • Next: Tue, Mar 08, 8:30 AM - 9:00 AM PST

Thank You's

A big thanks to the following gardeners that brought up issues, contributions, and fixes to this release :man_farmer: :woman_farmer: Visit Discord Roles for more information.

• Im

  • Issue: Feedback on Graph View

• Callum Mcdonald @chmac#2931

  • Issue: Greenhouse Event link to A Day in Dendron is broken

• Vincent Dansereau

  • #role.taxonomist
  • Issue: css edit link points to documentation that doesn't exists anymore

• James Henry @henry-js#6283

  • #role.taxonomist
  • Troubleshooting #lookup-shortcut-is-not-working for Vim extension conflicts

• Tycholiz @Tychronos#6624

  • Issue: Select vault not working as intended: not all vaults showing up

• Ryan Hill @rlh1994#9754

  • Issue: Page not publishing with publishByDefault: false and front matter published: true

Surveyors

A huge thanks to the following Dendronites that provided feedback in the 2022 Dendron User Survey. If you would like to help us improve Dendron, please checkout the survey (and earn a shiny Surveyor Discord badge in the process)!

• @Idan#8549
• @aleksey#5276
• @d1onysus#1514
• @foureyedsoul#0796
• @cro#4610

Changelog

Cannot find minimum compatible client version. This error should never occur! Please report a bug if you have encountered this.

dendron dev run_migration --migrationVersion 0.83.0

• 0.83