• fix a null ref when accessing lineno under certain conditions
• bump asciidoctor dependency to 2.0.20

• enable customization of the index pages using erb templates

• enable asciidoc-mathematical (if it is accessible on the system) when rendering pdfs
  ** force the output format for equations to svg
  ** remove stem-...svg files created by asciidoctor-mathematical

Fixed a bug in the version number for the last release.

This release adds the following:

• asciidoctor-diagram is required if it exists, this makes diagrams in documents render.
• giblish now complies with these precedence rules for document attributes:

1. An attribute passed to the API or CLI whose value does not end in @rillbert
2. (giblish specific) An attribute defined in an attribute provider for a specific source node
3. An attribute defined in the document
4. An attribute passed to the API or CLI whose value or name ends in @
5. (giblish specific) The default value set by giblish, if applicable
6. The default value set by asciidoctor, if applicable

This is an augmentation of the ones found here: https://docs.asciidoctor.org/asciidoc/latest/attributes/assignment-precedence/

This is a breaking release because the internal dependencies to asciidoctor-pdf has been bumped from one major release to the next. giblish itself has not seen any major, internal, updates.

Breaking changes:

• Dependency on asciidoctor-pdf has been bumped to v2.3
• rename some pdf attributes internally in giblish to comply with the new version of asciidoctor-pdf

• Update giblish to rely on the latest 2.x versions of the asciidoctor and asciidoctor-pdf tools

This release includes a refactoring of almost the entire code base.

Breaking changes

• The '-w' flag is removed
• The text search parameters interface has changed completely. A written specification of this interface is included in the docs.
• The '-r' flag will, for html generation, copy everything under the given directory to the target location.
  • the previous restriction on folder names has been removed.
• The '-s' flag now instructs giblish to use any matching style found under the resource directory given by the '-r' flag. The exact path is no longer necessary.
• The doc attribute :icons: font is now set by default.
• The source highlighter attributes are now set as follows by default:
  • :source-highlighter: rouge :rouge-css: style :rouge-style: github
• The format of the index pages has been updated

Changes/New functionality

• Rouge is used as source highlighter and the default is to use the following attributes:
  • :rouge-css: style
  • :rouge-style: github
• A --server-css-path flag can be used to set a path to the css file used by generated html documents when served via a web server.
• A --server-search-path flag can be used to set the URI path to the location of a server-side search script that can supply the user with search results.
• A --copy-asset-folders flag can be used to copying full directories from the source to the destination tree.
• Index pages are generated for each subdirectory in the target document tree.
• The format of the git summary page has been updated and more info included.
• The text search server-side cgi script has been rewritten.
• The text search for web-server-served html docs has been updated in the following ways:
  • the asciidoc 'include' directive is supported by expanding them and include the resulting text in the search database.
  • the implementation of the server-side search tools are written completely in ruby and does no longer depend on an external 'grep' tool.
  • almost all needed infrastructure for implementing a server-side search script has been implemented within the 'giblish' gem.
• The asciidoctor toolchain dependencies are updated to the latest versions (at the time of release).

See the Changelog.

sync published gem and github tags