Skip to content

v0.14.0

Compare
Choose a tag to compare
@mDuo13 mDuo13 released this 27 May 23:22
· 10 commits to master since this release
8afa3b4

This release improves the built-in templates, improves the documentation in the examples, and introduces the concept of "Virtual Pages". Virtual pages are placeholders for links to external sites, which you can insert into the automatically-generated navigation with a stanza similar to a page built by Dactyl.

To add a Virtual Page, add a page to your config with an html value containing //. For example,

-   name: Dactyl Homepage
    blurb: Go to the online home of Dactyl.
    html: https://dactyl.link/
    parent: virtual-pages.html
    targets:
        - everything

Dactyl's built-in templates automatically add the page to generated navigation. Use the parent field to specify where in the hierarchy the virtual page should appear. The page also shows up as an item in the page lists for the preprocessor and templates so custom templates and pages can list it also.

Breaking Changes

Most projects using Dactyl won't experience breaking changes from this release, but the following changes may potentially require action in certain circumstances:

  • The buttonize filter now uses Bootstrap's btn btn-primary classes instead of adding a button class.
  • The built-in tree-nav.html template and its associated CSS have been significantly updated to fix bugs with deeper levels of navigation and to simplify the generated HTML.
  • The children.html template no longer omits blurbs beyond the top level by default.

Other Changes

  • The default PDF templates (simple.html and pdf-cover.html) better handle frontmatter and hierarchy fields.
  • The SCSS for the tree nav has been split into a separate file to make it easier to include in external projects.
  • Updated many of the examples including their URLs.
  • Fixed integration test for the style checker.