v0.1.4

Improved Color Scheme

The package's native "AsciiDoc Dark" color scheme has been revamped and polished: improved color palette, better coverage of syntax elements.

IMPORTANT — The package no no longer enforces the scheme by default, since some users reported problems due to what seems a bug in Sublime Text cache. So you'll have to enable the color scheme for the AsciiDoc syntax manually to keep using it.

Syntax Support for Preprocessor Directives

Now the syntax handles preprocessor directives (include:: and the conditionals ifdef::, ifndef::, ifeval:::: and endif::).

Although there's still some work to be done to cover the full range of supported parameters, the syntax already does a decent job at scoping these directives and their core elements.

Credits

Again, thanks to @polyglot-jones for contributing to this new release — although I'm afraid that due to some history rewrite operations on the development branch, some of his commits ended up being attributed to me (sorry for that, I thought that the original author would be preserved in the commits metadata).

v0.1.3

Syntax Branching

This release enables the syntax branching feature of Sublime Text 4, which greatly improves handling syntax highlighting of malformed quotes in AsciiDoc sources by gracefully recovering and this preventing documents break-up.

• Marked/Highlight spans
• Bold and Italic
• Inline code (monospace)

Syntax Improvements

Thanks to @polyglot-jones for contributing syntax-highlighting support for new AsciiDoc elements and improving existing ones:

• Attribute references (e.g. {my-attribute})
• Typographic/curly quotes
• Cross reference links (e.g. <<my-link, My Link text>>)
• Ordered list items
• Definition list items
• Index terms (e.g. ((flow-index)) and (((index term,concealed))))
• Bibliographic anchors (e.g. [[[book-one]]])
• XML/SGML entities (named and numeric)
• Callout definitions (e.g. <1> Description)
• Characters escapes
• Double escaping of unconstrained delimiters
• Admonition inline labels (e.g. TIP: Did you...)

Dedicated Color Scheme

The package now ships with AsciiDoc Dark, a dedicated (dark) color scheme, tailored to cover AsciiDoc syntax scopes and designed with documentation editing in mind.

This color scheme (enabled by default) brings to life all the supported AsciiDoc elements — most of which are given ad hoc scope names which are unlikely covered by other generic schemes. Color combinations where carefully chose in order to allow keeping track of the various elements without being overwhelmed by too many color contrasts on the "page".

Build System

@polyglot-jones contributed AsciiDoc build presets targeting HTML, EPUB, and DOCX.

• HTML Build — Assumes that Asciidoctor is installed on the system path.
• EPUB Build — Assumes that Asciidoctor EPUB3 is also installed on the system path.
• DOCX Build — Assumes that pandoc is also installed on the system path.

v0.1.2

Syntax Fixes

This release improves syntax highlighting AsciiDoc sources by fixing two bugs that were causing documents break-up.

Fix Broken Example Blocks

Fixed a bug in example blocks where curly quotes would result in prematurely popping-out of the example context, causing the closing block delimiter to be treated as a new opening example block, jeopardizing syntax highlighting of the rest of the document.

This was the most annoying bug in the package, leading to documents highlighting and scoping frequently breaking up.

Attributes List Lines

The attribute_list_line context, which had been temporarily disabled while disentangling the original syntax, has now been reintroduced.

Besides adding syntax highlighting for this element, its reintroduction also fixes a known problem where block attributes-lists contents were triggering false positive matches for inline quote elements, e.g. capturing as a superscript delimiter the caret in the cols table attribute <.^h of the following example:

[cols="<.^h,<.<a"]
|=============================

These false positives would jeopardize syntax highlighting the rest of the document, or large portions of it. There was already a temporary workaround to this problem, but it only handled table specific attributes-list, whereas the attribute_list_line context should handle all edge-cases.

v0.1.1

User Guide

ST4-Asciidoctor has now an online User Guide which can be accessed via the Sublime Text menu:

• Preferences > Package Settings > Asciidoctor > User Guide

Snippets

Improved snippets and enforced consistent standards:

• "Quote Block" renamed to "Quoted Block".
• "Sidebar block": added sbar trigger.
• Enforce consistent 78-characters length to all snippets that emit long block delimiters:
  • Comment Block
  • Example Block
  • Listing Block
  • Passthrough Block
  • Quoted Block
  • Sidebar Block
  • Table
• Add missing selection preservation (via ${n:$SELECTION}) to all block elements that could benefit from it:
  • Example Block
  • Listing Block
  • Passthrough Block
  • Quoted Block
  • Sidebar Block

v0.1.0

• The repository was renamed from ST3-Asciidoctor to ST4-Asciidoctor.
• The package will now supports Sublime Text 4 only, in order to leverage its new syntax features (like branching and rewind) to handle complex AsciiDoc constructs and edge cases.
• The package can now be installed from GitHub using the Package Control tool of Sublime Text (see installation instructions).