Skip to content

v2.0.0

Compare
Choose a tag to compare
@mojavelinux mojavelinux released this 03 Jul 06:01
· 362 commits to main since this release

This release is a major rewrite of the plugin. The integration with AsciiDoc is now much deeper. You can expect many more features of AsciiDoc to just work. Of particular note, the Jekyll front matter header is no longer required and the layout is automatically selected based on the page type, so you can use standard AsciiDoc documents. Additionally, path-related implicit attributes are defined, allowing images generated by Asciidoctor Diagram end up in the right location. You'll also find the README for the plugin to be much more informative. Enjoy!

Changes

  • Split source into multiple files; move all classes under the Jekyll::AsciiDoc module
  • Avoid redundant initialization caused by the jekyll-watch plugin
  • Set docdir, docfile, docname, outfile, outdir, and outpath attributes for each file if using Jekyll 3 (#59)
    • docdir is only set if value of base_dir option is :docdir
    • setting outdir allows proper integration with Asciidoctor Diagram
  • Automatically set imagesoutdir attribute if imagesdir attribute is relative to root
  • Pass site information (root, source, destination, baseurl and url) through as AsciiDoc attributes
  • Automatically generate stylesheet for Pygments (#30)
  • Change default layout to match collection label (#104)
    • page for pages, post for posts, collection label for all others; use default layout as fallback
  • Resolve attribute references in attribute values defined in config (#103)
  • Apply AsciiDoc header integration to documents in all collections (#93)
  • Document how to create and enable templates to customize the HTML that Asciidoctor generates (#73)
  • Allow base_dir option to track document directory by setting the value to :docdir (#80)
  • Add a comprehensive test suite (#77)
  • Allow site-wide Asciidoctor attributes to be specified as a Hash; convert to Hash if Array is used (#87)
  • Interpret page attribute values as YAML data
  • Use Jekyll.logger to write log messages (#85)
  • Add topic to all log messages
  • Restructure configuration keys so all general settings are under the asciidoc key (#82)
  • Don't enable hardbreaks attribute by default (#69)
  • Bump minimum version of Jekyll to 2.3.0 and document requirement in README (#76)
  • Allow layout to be disabled to create standalone document; support additional values for layout (#63)
  • Make front matter header optional (#57)
  • Apply site-wide Asciidoctor configuration (options/attributes) when loading document header (#67)
  • Disable liquid processor on AsciiDoc files by default; enable using liquid page variable (#65)
  • Resolve empty page attribute value as empty string (#70)
  • Soft assign linkattrs attribute
  • Allow plugin to work in safe mode (#112)
  • Major restructure and rewrite of README
  • Document how to use plugin with GitLab Pages (#47)
  • Document asciidocify filter

Distributions