asciidoctor/asciidoctorj (org.asciidoctor:asciidoctorj)
### [`v2.4.0`](https://togithub.com/asciidoctor/asciidoctorj/releases/tag/v2.4.0)
[Compare Source](https://togithub.com/asciidoctor/asciidoctorj/compare/v2.3.0...v2.4.0)
**Improvement**
- Add method StructuralNode.setLevel() ([@Mogztter](https://togithub.com/Mogztter)) ([#931](https://togithub.com/asciidoctor/asciidoctorj/issues/931))
- Upgrade to JRuby 9.2.12.0 removing the last illegal access warnings ([#935](https://togithub.com/asciidoctor/asciidoctorj/issues/935))
- Upgrade to Asciidoctor EPUB3 1.5.0-alpha.16 ([#939](https://togithub.com/asciidoctor/asciidoctorj/issues/939))
- Upgrade to Rouge 3.21.0
**Build**
- Fix upstream build to adapt to changes in Ruby Highlightjs syntax highlighter ([#940](https://togithub.com/asciidoctor/asciidoctorj/issues/940))
#### Release Meta
Released on: 2020-07-19
Released by: [@robertpanzer](https://togithub.com/robertpanzer)
Release beer: Ran out of beers
### [`v2.3.0`](https://togithub.com/asciidoctor/asciidoctorj/releases/tag/v2.3.0)
[Compare Source](https://togithub.com/asciidoctor/asciidoctorj/compare/v2.2.0...v2.3.0)
**Improvement**
- Add asciidoctor-revealjs to distribution ([#910](https://togithub.com/asciidoctor/asciidoctorj/issues/910))
- Upgrade to Asciidoctor PDF 1.5.3
- Upgrade to Asciidoctor EPUB3 1.5.0-alpha.16
- Upgrade to Asciidoctor Diagram 2.0.2
- Upgrade to JRuby 9.2.11.1
**Bug Fixes**
- Add missing factory methods to create Lists. ([@glisicivan](https://togithub.com/glisicivan)) ([#916](https://togithub.com/asciidoctor/asciidoctorj/issues/916))
The API `Processor.createList()` is experimental and may change with any release until declared to be stable.
**Documentation**
- Update documentation to show how to create an Asciidoctor instance with GEM_PATH ([#890](https://togithub.com/asciidoctor/asciidoctorj/issues/890))
- Adds GitHub icons to admonitions sections in README ([#893](https://togithub.com/asciidoctor/asciidoctorj/issues/893))
**Build**
- Upgrade to jruby-gradle-plugin 2.0.0
- Remove CI build on TravisCI ([#918](https://togithub.com/asciidoctor/asciidoctorj/issues/918))
**Known Limitations**
- The createList() and createListItem() API is not able to create DescriptionLists.
#### Release Meta
Released on: 2020-05-02
Released by: [@robertpanzer](https://togithub.com/robertpanzer)
Release beer: No beer right now, taking care of family
### [`v2.2.0`](https://togithub.com/asciidoctor/asciidoctorj/releases/tag/v2.2.0)
[Compare Source](https://togithub.com/asciidoctor/asciidoctorj/compare/v2.1.0...v2.2.0)
### 2.2.0 (2019-12-17)
**Improvement**:
- Upgrade to JCommander 1.72 ([@Fiouz](https://togithub.com/Fiouz)) ([#782](https://togithub.com/asciidoctor/asciidoctorj/issues/782))
- Set logger name on logged log records ([@lread](https://togithub.com/lread)) ([#834](https://togithub.com/asciidoctor/asciidoctorj/issues/834))
- Upgrade to JRuby 9.2.8.0 ([@ahus1](https://togithub.com/ahus1)) ([#850](https://togithub.com/asciidoctor/asciidoctorj/issues/850))
- Upgrade to JRuby 9.2.9.0
- Upgrade to Asciidoctor PDF 1.5.0-beta.8
- Upgrade to Asciidoctor Diagram 2.0.0
- Upgrade to Rouge 3.12.0
- Use headless jdk on all platforms ([@nicerloop](https://togithub.com/nicerloop)) ([#863](https://togithub.com/asciidoctor/asciidoctorj/issues/863))
**Bug Fixes**:
- Remove exception protection from LogHandler in `JRubyAsciidoctor` to align behaviour with `AbstractConverter` ([@abelsromero](https://togithub.com/abelsromero)) ([#844](https://togithub.com/asciidoctor/asciidoctorj/issues/844))
- Make Asciidoctor API AutoClosable ([@rmannibucau](https://togithub.com/rmannibucau)) ([#849](https://togithub.com/asciidoctor/asciidoctorj/issues/849))
- Fix reading input from stdin and writing to stdout ([@nicerloop](https://togithub.com/nicerloop)) ([#865](https://togithub.com/asciidoctor/asciidoctorj/issues/865))
- Assign distinct Osgi Bundle-SymbolicNames to asciidoctorj-api.jar and asciidoctorj.jar ([@rmannibucau](https://togithub.com/rmannibucau)) ([#878](https://togithub.com/asciidoctor/asciidoctorj/issues/878))
**Build**:
- Upgrade to Gradle 5.6.3 ([@Fiouz](https://togithub.com/Fiouz)) ([#747](https://togithub.com/asciidoctor/asciidoctorj/issues/747) [#856](https://togithub.com/asciidoctor/asciidoctorj/issues/856))
- Support build from paths with whitespace ([@Fiouz](https://togithub.com/Fiouz)) ([#836](https://togithub.com/asciidoctor/asciidoctorj/issues/836))
- OSGi: switch to biz.aQute.bnd plugin ([@Fiouz](https://togithub.com/Fiouz)) ([#855](https://togithub.com/asciidoctor/asciidoctorj/issues/855))
- Fix publishing to Bintray with Gradle 5.6.3 ([@Fiouz](https://togithub.com/Fiouz)) ([#862](https://togithub.com/asciidoctor/asciidoctorj/issues/862))
**Documentation**:
- Update README about running on WildFly ([@anthonyvdotbe](https://togithub.com/anthonyvdotbe)) ([#848](https://togithub.com/asciidoctor/asciidoctorj/issues/848))
- link to tarball; add Quick Win section ([@il-pazzo](https://togithub.com/il-pazzo)) ([#854](https://togithub.com/asciidoctor/asciidoctorj/issues/854))
#### Release Meta
Released on: 2019-12-17
Released by: [@robertpanzer](https://togithub.com/robertpanzer)
Release beer: TBD
### [`v2.1.0`](https://togithub.com/asciidoctor/asciidoctorj/releases/tag/v2.1.0)
[Compare Source](https://togithub.com/asciidoctor/asciidoctorj/compare/v2.0.0...v2.1.0)
### 2.1.0 (2019-06-22)
This version brings updated versions of Asciidoctor, Asciidoctor PDF and Asciidoctor Diagram.
It also contains a new API allowing to implement Syntax Highlighters in Java.
This API is experimental and might also break in minor releases until it is defined to be stable.
#### Improvements
- Add the command line option -R to specify the source root directory ([@4lber10](https://togithub.com/4lber10) & [@ysb33r](https://togithub.com/ysb33r)) ([#822](https://togithub.com/asciidoctor/asciidoctorj/issues/822))
- Add sourcemap, catalog_assets and parse to OptionBuilder ([@jmini](https://togithub.com/jmini)) ([#825](https://togithub.com/asciidoctor/asciidoctorj/issues/825))
- Upgrade to Asciidoctor 2.0.10
- Upgrade to Asciidoctor Diagram 1.5.0-alpha.18
- Upgrade to Asciidoctor PDF 1.5.0-alpha.18
- Added an experimental API to write Syntax Highlighters in Java ([#826](https://togithub.com/asciidoctor/asciidoctorj/issues/826))
#### Documentation
- Clarify that an InlineMacroProcessor should return a PhraseNode and that Strings are deprecated. ([@jmini](https://togithub.com/jmini)) ([#823](https://togithub.com/asciidoctor/asciidoctorj/issues/823))
#### Release Meta
Released on: 2019-06-22
Released by: [@robertpanzer](https://togithub.com/robertpanzer)
Release beer: TBD
### [`v2.0.0`](https://togithub.com/asciidoctor/asciidoctorj/releases/tag/v2.0.0)
[Compare Source](https://togithub.com/asciidoctor/asciidoctorj/compare/v1.6.2...v2.0.0)
#### 2.0.0 (2019-04-24)
Enhancements:
- Extended version info printed by `asciidoctorj --version` to show versions of Asciidoctor and AsciidoctorJ separately ([@abelsromero](https://togithub.com/abelsromero)) ([#791](https://togithub.com/asciidoctor/asciidoctorj/issues/791))
- Allow custom converters to log ([#801](https://togithub.com/asciidoctor/asciidoctorj/issues/801))
- Add section numeral API ([@vmj](https://togithub.com/vmj)) ([#785](https://togithub.com/asciidoctor/asciidoctorj/issues/785))
- Move the Asciidoctor interface into the asciidoctorj-module ([@Mogztter](https://togithub.com/Mogztter)) ([#760](https://togithub.com/asciidoctor/asciidoctorj/issues/760))
- Remove deprecated render() methods from Asciidoctor interface ([@Mogztter](https://togithub.com/Mogztter)) ([#760](https://togithub.com/asciidoctor/asciidoctorj/issues/760))
Improvements:
- Upgrade to Asciidoctor 2.0.8
- Upgrade to asciidoctor-pdf 1.5.0-alpha.17 ([#809](https://togithub.com/asciidoctor/asciidoctorj/issues/809))
- Add Rouge source highlighter to asciidoctor.jar ([#806](https://togithub.com/asciidoctor/asciidoctorj/issues/806))
- Upgrade to Asciidoctor ePub3 1.5.9
- Upgrade to JRuby 9.2.7.0 ([#796](https://togithub.com/asciidoctor/asciidoctorj/issues/796)) This version of AsciidoctorJ is incompatible with any version of JRuby <= 9.2.5.0
- Upgrade to Asciidoctor Diagram 1.5.16
Bug Fixes:
- Fix logger registration when creating AsciidoctorJ instance with Asciidoctor.Factory.create([@ahus1](https://togithub.com/ahus1)) ([#790](https://togithub.com/asciidoctor/asciidoctorj/issues/790))
- Fix logger implementation ([#786](https://togithub.com/asciidoctor/asciidoctorj/issues/786))
- Fix extension initialization in OSGi environments ([#754](https://togithub.com/asciidoctor/asciidoctorj/issues/754))
- Remove reference to RubyExtensionRegistryImpl from RubyExtensionRegistry ([#759](https://togithub.com/asciidoctor/asciidoctorj/issues/759))
- Don't return null from List.blocks() and DefinitionList.blocks() ([@jensnerche](https://togithub.com/jensnerche)) ([#761](https://togithub.com/asciidoctor/asciidoctorj/issues/761))
- Move org.asciidoctor.spi.ProcessorFactory to org.asciidoctor.extension ([@jensnerche](https://togithub.com/jensnerche)) ([#762](https://togithub.com/asciidoctor/asciidoctorj/issues/762))
Documentation:
- Update documentation for running AsciidoctorJ in OSGi ([@twasyl](https://togithub.com/twasyl)) ([#765](https://togithub.com/asciidoctor/asciidoctorj/issues/765))
Build / Infrastructure::
- Fix jruby-maven-plugin and upstream build ([@mkristian](https://togithub.com/mkristian)) ([#777](https://togithub.com/asciidoctor/asciidoctorj/issues/777))
#### Release Meta
Released on: 2019-04-24
Released by: [@robertpanzer](https://togithub.com/robertpanzer)
Release beer: Firestone Walker Helldorado 2017
### [`v1.6.2`](https://togithub.com/asciidoctor/asciidoctorj/releases/tag/v1.6.2)
[Compare Source](https://togithub.com/asciidoctor/asciidoctorj/compare/v1.6.1...v1.6.2)
#### Improvements
- Upgrade to JRuby 9.2.6.0. This version of AsciidoctorJ is incompatible with any version of JRuby <= 9.2.5.0
#### Bug Fixes
- Fix extension initialization in OSGi environments([#754](https://togithub.com/asciidoctor/asciidoctorj/issues/754))
#### Release Meta
Released on: 2019-02-14
Released by: [@robertpanzer](https://togithub.com/robertpanzer)
Release beer: TBD
### [`v1.6.1`](https://togithub.com/asciidoctor/asciidoctorj/releases/tag/v1.6.1)
[Compare Source](https://togithub.com/asciidoctor/asciidoctorj/compare/v1.6.0...v1.6.1)
- This release upgrades asciidoctor-diagram and fixes a bug when registering extension instances.
#### Improvements
- Upgrade asciidoctorj-diagram to 1.5.12
#### Bug fixes
- AsciidoctorJ fails when registering a block processor instance while passing the name as a parameter ([#754](https://togithub.com/asciidoctor/asciidoctorj/issues/754))
#### Release Meta
Released on: 2019-01-25
Released by: [@robertpanzer](https://togithub.com/robertpanzer)
Release beer: TBD
### [`v1.6.0`](https://togithub.com/asciidoctor/asciidoctorj/releases/tag/v1.6.0)
[Compare Source](https://togithub.com/asciidoctor/asciidoctorj/compare/v1.5.8.1...v1.6.0)
#### AsciidoctorJ 1.6.0
AsciidoctorJ 1.6.0 is a final, transitional release in preparation for the switch to Semantic Versioning (SemVer). Despite its version number, this is a major release and, as such, not binary compatible with the 1.5.x releases.
#### Improvements
There are loads of changes that made it into this release, so it's difficult to enumerate them all. In fact, since the development of 1.6.0 ran in parallel with 1.5.x for so long, many changes from 1.6.0 may already be familiar to you as they got backported into the 1.5.x release line.
The most prominent changes in 1.6.0 are as follows:
- Rework Extension API. Please check the [Integrator Guide](https://togithub.com/asciidoctor/asciidoctorj/blob/master/docs/integrator-guide.adoc) for a documentation about how it looks now.
- Add ExtensionGroup API and fix registration of multiple extensions ([#568](https://togithub.com/asciidoctor/asciidoctorj/issues/568))
- Reworked AST API, including renaming of classes.
- Split org.asciidoctor package into api and impl modules. ([#603](https://togithub.com/asciidoctor/asciidoctorj/issues/603), [@jmini](https://togithub.com/jmini))
- Added converter API
- Add support for capturing and routing log messages from Asciidoctor ([#657](https://togithub.com/asciidoctor/asciidoctorj/issues/657))
- Add documentation for the AsciidoctorJ logger ([#674](https://togithub.com/asciidoctor/asciidoctorj/issues/674), [@abelsromero](https://togithub.com/abelsromero))
- Added annotation-based processor configuration ([#341](https://togithub.com/asciidoctor/asciidoctorj/issues/341))
- Add support for creating tables structures to Extension API ([#335](https://togithub.com/asciidoctor/asciidoctorj/issues/335))
- Add support for Lists and Definition Lists to AST ([#408](https://togithub.com/asciidoctor/asciidoctorj/issues/408))
- Loads of cleanups and improvements across the API ([#715](https://togithub.com/asciidoctor/asciidoctorj/issues/715), [#717](https://togithub.com/asciidoctor/asciidoctorj/issues/717), [@Mogztter](https://togithub.com/Mogztter))
- Added method to get and remove substitutions ([#504](https://togithub.com/asciidoctor/asciidoctorj/issues/504))
- Rename isAttr(), setAttr() and getAttr() to more Java like names, isAttribute(), setAttribute() and getAttribute(). ([#554](https://togithub.com/asciidoctor/asciidoctorj/issues/554))
- Allow for method chaining when registering extensions ([#491](https://togithub.com/asciidoctor/asciidoctorj/issues/491))
- Upgrade to Gradle 4.4.1 ([#611](https://togithub.com/asciidoctor/asciidoctorj/issues/611), [@tisoft](https://togithub.com/tisoft))
- Remove ContentPart and StructuredDocument API ([#699](https://togithub.com/asciidoctor/asciidoctorj/issues/699))
### Bug fixes
There are a lot of bugs that were fixed regarding the extension API. Some of these may have already made it into 1.5.x as long as they did not require architectural changes. To list a few:
- Support for source_location ([#351](https://togithub.com/asciidoctor/asciidoctorj/issues/351), [@ysb33r](https://togithub.com/ysb33r))
- Numerous fixes for the build process ([#474](https://togithub.com/asciidoctor/asciidoctorj/issues/474), [#482](https://togithub.com/asciidoctor/asciidoctorj/issues/482), [#469](https://togithub.com/asciidoctor/asciidoctorj/issues/469), [@ancho](https://togithub.com/ancho))
- Numerous fixes around errors in extensions, as an example ([@459](https://togithub.com/459) , [@ahus1](https://togithub.com/ahus1))
You can find more details about this release and its future at [asciidoctor.org](https://asciidoctor.org/news/asciidoctorj-1-6-0-released.html)
### Migration notes
Migrating extensions from 1.5.x to 1.6.0 requires some changes, that should in general not be too hard. As examples you might compare extensions from the test cases:
- YellBlock - [1.5.8](https://togithub.com/asciidoctor/asciidoctorj/blob/v1.5.8.1/asciidoctorj-core/src/test/java/org/asciidoctor/extension/YellBlock.java) vs [1.6.0](https://togithub.com/asciidoctor/asciidoctorj/blob/v1.6.0/asciidoctorj-core/src/test/java/org/asciidoctor/extension/YellBlock.java)
- ArrowsAndBoxesBlock - [1.5.8](https://togithub.com/asciidoctor/asciidoctorj/blob/v1.5.8.1/asciidoctorj-core/src/test/java/org/asciidoctor/extension/ArrowsAndBoxesBlock.java) vs [1.6.0](https://togithub.com/asciidoctor/asciidoctorj/blob/v1.6.0/asciidoctorj-core/src/test/java/org/asciidoctor/extension/ArrowsAndBoxesBlock.java)
- ManpageMacro - [1.5.8](https://togithub.com/asciidoctor/asciidoctorj/blob/v1.5.8.1/asciidoctorj-core/src/test/java/org/asciidoctor/extension/ManpageMacro.java) vs [1.6.0](https://togithub.com/asciidoctor/asciidoctorj/blob/v1.6.0/asciidoctorj-core/src/test/java/org/asciidoctor/extension/ManpageMacro.java)
### Thanks
This release wouldn't have been possible without the help of all our awesome contributors:
- [@abelsromero](https://togithub.com/abelsromero)
- [@ahus1](https://togithub.com/ahus1)
- [@lordofthejars](https://togithub.com/lordofthejars)
- [@mojavelinux](https://togithub.com/mojavelinux)
- [@ancho](https://togithub.com/ancho)
-
- [@Mogztter](https://togithub.com/Mogztter)
- [@htmfilho](https://togithub.com/htmfilho)
- [@innovimax](https://togithub.com/innovimax)
- [@jmini](https://togithub.com/jmini)
- [@kduske-n4](https://togithub.com/kduske-n4)
- [@tisoft](https://togithub.com/tisoft)
- [@ysb33r](https://togithub.com/ysb33r)
- [@msgilligan](https://togithub.com/msgilligan)
- [@sschuberth](https://togithub.com/sschuberth)
- [@t-h-a-l-i-s](https://togithub.com/t-h-a-l-i-s)
- [@twasyl](https://togithub.com/twasyl)
- [@lefou](https://togithub.com/lefou)
- [@mmews-n4](https://togithub.com/mmews-n4)
If I left anyone off this list, I sincerely apologize. We're certainly thankful for each and every contribution!
#### Release Meta
Released on: 2019-01-01
Released by: [@robertpanzer](https://togithub.com/robertpanzer)
Release beer: TBD
[ ] If you want to rebase/retry this PR, check this box
This PR contains the following updates:
1.5.8.1->2.4.0By merging this PR, the issue #17 will be automatically resolved and closed:
Release Notes
asciidoctor/asciidoctorj (org.asciidoctor:asciidoctorj)
### [`v2.4.0`](https://togithub.com/asciidoctor/asciidoctorj/releases/tag/v2.4.0) [Compare Source](https://togithub.com/asciidoctor/asciidoctorj/compare/v2.3.0...v2.4.0) **Improvement** - Add method StructuralNode.setLevel() ([@Mogztter](https://togithub.com/Mogztter)) ([#931](https://togithub.com/asciidoctor/asciidoctorj/issues/931)) - Upgrade to JRuby 9.2.12.0 removing the last illegal access warnings ([#935](https://togithub.com/asciidoctor/asciidoctorj/issues/935)) - Upgrade to Asciidoctor EPUB3 1.5.0-alpha.16 ([#939](https://togithub.com/asciidoctor/asciidoctorj/issues/939)) - Upgrade to Rouge 3.21.0 **Build** - Fix upstream build to adapt to changes in Ruby Highlightjs syntax highlighter ([#940](https://togithub.com/asciidoctor/asciidoctorj/issues/940)) #### Release Meta Released on: 2020-07-19 Released by: [@robertpanzer](https://togithub.com/robertpanzer) Release beer: Ran out of beers ### [`v2.3.0`](https://togithub.com/asciidoctor/asciidoctorj/releases/tag/v2.3.0) [Compare Source](https://togithub.com/asciidoctor/asciidoctorj/compare/v2.2.0...v2.3.0) **Improvement** - Add asciidoctor-revealjs to distribution ([#910](https://togithub.com/asciidoctor/asciidoctorj/issues/910)) - Upgrade to Asciidoctor PDF 1.5.3 - Upgrade to Asciidoctor EPUB3 1.5.0-alpha.16 - Upgrade to Asciidoctor Diagram 2.0.2 - Upgrade to JRuby 9.2.11.1 **Bug Fixes** - Add missing factory methods to create Lists. ([@glisicivan](https://togithub.com/glisicivan)) ([#916](https://togithub.com/asciidoctor/asciidoctorj/issues/916)) The API `Processor.createList()` is experimental and may change with any release until declared to be stable. **Documentation** - Update documentation to show how to create an Asciidoctor instance with GEM_PATH ([#890](https://togithub.com/asciidoctor/asciidoctorj/issues/890)) - Adds GitHub icons to admonitions sections in README ([#893](https://togithub.com/asciidoctor/asciidoctorj/issues/893)) **Build** - Upgrade to jruby-gradle-plugin 2.0.0 - Remove CI build on TravisCI ([#918](https://togithub.com/asciidoctor/asciidoctorj/issues/918)) **Known Limitations** - The createList() and createListItem() API is not able to create DescriptionLists. #### Release Meta Released on: 2020-05-02 Released by: [@robertpanzer](https://togithub.com/robertpanzer) Release beer: No beer right now, taking care of family ### [`v2.2.0`](https://togithub.com/asciidoctor/asciidoctorj/releases/tag/v2.2.0) [Compare Source](https://togithub.com/asciidoctor/asciidoctorj/compare/v2.1.0...v2.2.0) ### 2.2.0 (2019-12-17) **Improvement**: - Upgrade to JCommander 1.72 ([@Fiouz](https://togithub.com/Fiouz)) ([#782](https://togithub.com/asciidoctor/asciidoctorj/issues/782)) - Set logger name on logged log records ([@lread](https://togithub.com/lread)) ([#834](https://togithub.com/asciidoctor/asciidoctorj/issues/834)) - Upgrade to JRuby 9.2.8.0 ([@ahus1](https://togithub.com/ahus1)) ([#850](https://togithub.com/asciidoctor/asciidoctorj/issues/850)) - Upgrade to JRuby 9.2.9.0 - Upgrade to Asciidoctor PDF 1.5.0-beta.8 - Upgrade to Asciidoctor Diagram 2.0.0 - Upgrade to Rouge 3.12.0 - Use headless jdk on all platforms ([@nicerloop](https://togithub.com/nicerloop)) ([#863](https://togithub.com/asciidoctor/asciidoctorj/issues/863)) **Bug Fixes**: - Remove exception protection from LogHandler in `JRubyAsciidoctor` to align behaviour with `AbstractConverter` ([@abelsromero](https://togithub.com/abelsromero)) ([#844](https://togithub.com/asciidoctor/asciidoctorj/issues/844)) - Make Asciidoctor API AutoClosable ([@rmannibucau](https://togithub.com/rmannibucau)) ([#849](https://togithub.com/asciidoctor/asciidoctorj/issues/849)) - Fix reading input from stdin and writing to stdout ([@nicerloop](https://togithub.com/nicerloop)) ([#865](https://togithub.com/asciidoctor/asciidoctorj/issues/865)) - Assign distinct Osgi Bundle-SymbolicNames to asciidoctorj-api.jar and asciidoctorj.jar ([@rmannibucau](https://togithub.com/rmannibucau)) ([#878](https://togithub.com/asciidoctor/asciidoctorj/issues/878)) **Build**: - Upgrade to Gradle 5.6.3 ([@Fiouz](https://togithub.com/Fiouz)) ([#747](https://togithub.com/asciidoctor/asciidoctorj/issues/747) [#856](https://togithub.com/asciidoctor/asciidoctorj/issues/856)) - Support build from paths with whitespace ([@Fiouz](https://togithub.com/Fiouz)) ([#836](https://togithub.com/asciidoctor/asciidoctorj/issues/836)) - OSGi: switch to biz.aQute.bnd plugin ([@Fiouz](https://togithub.com/Fiouz)) ([#855](https://togithub.com/asciidoctor/asciidoctorj/issues/855)) - Fix publishing to Bintray with Gradle 5.6.3 ([@Fiouz](https://togithub.com/Fiouz)) ([#862](https://togithub.com/asciidoctor/asciidoctorj/issues/862)) **Documentation**: - Update README about running on WildFly ([@anthonyvdotbe](https://togithub.com/anthonyvdotbe)) ([#848](https://togithub.com/asciidoctor/asciidoctorj/issues/848)) - link to tarball; add Quick Win section ([@il-pazzo](https://togithub.com/il-pazzo)) ([#854](https://togithub.com/asciidoctor/asciidoctorj/issues/854)) #### Release Meta Released on: 2019-12-17 Released by: [@robertpanzer](https://togithub.com/robertpanzer) Release beer: TBD ### [`v2.1.0`](https://togithub.com/asciidoctor/asciidoctorj/releases/tag/v2.1.0) [Compare Source](https://togithub.com/asciidoctor/asciidoctorj/compare/v2.0.0...v2.1.0) ### 2.1.0 (2019-06-22) This version brings updated versions of Asciidoctor, Asciidoctor PDF and Asciidoctor Diagram. It also contains a new API allowing to implement Syntax Highlighters in Java. This API is experimental and might also break in minor releases until it is defined to be stable. #### Improvements - Add the command line option -R to specify the source root directory ([@4lber10](https://togithub.com/4lber10) & [@ysb33r](https://togithub.com/ysb33r)) ([#822](https://togithub.com/asciidoctor/asciidoctorj/issues/822)) - Add sourcemap, catalog_assets and parse to OptionBuilder ([@jmini](https://togithub.com/jmini)) ([#825](https://togithub.com/asciidoctor/asciidoctorj/issues/825)) - Upgrade to Asciidoctor 2.0.10 - Upgrade to Asciidoctor Diagram 1.5.0-alpha.18 - Upgrade to Asciidoctor PDF 1.5.0-alpha.18 - Added an experimental API to write Syntax Highlighters in Java ([#826](https://togithub.com/asciidoctor/asciidoctorj/issues/826)) #### Documentation - Clarify that an InlineMacroProcessor should return a PhraseNode and that Strings are deprecated. ([@jmini](https://togithub.com/jmini)) ([#823](https://togithub.com/asciidoctor/asciidoctorj/issues/823)) #### Release Meta Released on: 2019-06-22 Released by: [@robertpanzer](https://togithub.com/robertpanzer) Release beer: TBD ### [`v2.0.0`](https://togithub.com/asciidoctor/asciidoctorj/releases/tag/v2.0.0) [Compare Source](https://togithub.com/asciidoctor/asciidoctorj/compare/v1.6.2...v2.0.0) #### 2.0.0 (2019-04-24) Enhancements: - Extended version info printed by `asciidoctorj --version` to show versions of Asciidoctor and AsciidoctorJ separately ([@abelsromero](https://togithub.com/abelsromero)) ([#791](https://togithub.com/asciidoctor/asciidoctorj/issues/791)) - Allow custom converters to log ([#801](https://togithub.com/asciidoctor/asciidoctorj/issues/801)) - Add section numeral API ([@vmj](https://togithub.com/vmj)) ([#785](https://togithub.com/asciidoctor/asciidoctorj/issues/785)) - Move the Asciidoctor interface into the asciidoctorj-module ([@Mogztter](https://togithub.com/Mogztter)) ([#760](https://togithub.com/asciidoctor/asciidoctorj/issues/760)) - Remove deprecated render() methods from Asciidoctor interface ([@Mogztter](https://togithub.com/Mogztter)) ([#760](https://togithub.com/asciidoctor/asciidoctorj/issues/760)) Improvements: - Upgrade to Asciidoctor 2.0.8 - Upgrade to asciidoctor-pdf 1.5.0-alpha.17 ([#809](https://togithub.com/asciidoctor/asciidoctorj/issues/809)) - Add Rouge source highlighter to asciidoctor.jar ([#806](https://togithub.com/asciidoctor/asciidoctorj/issues/806)) - Upgrade to Asciidoctor ePub3 1.5.9 - Upgrade to JRuby 9.2.7.0 ([#796](https://togithub.com/asciidoctor/asciidoctorj/issues/796)) This version of AsciidoctorJ is incompatible with any version of JRuby <= 9.2.5.0 - Upgrade to Asciidoctor Diagram 1.5.16 Bug Fixes: - Fix logger registration when creating AsciidoctorJ instance with Asciidoctor.Factory.create([@ahus1](https://togithub.com/ahus1)) ([#790](https://togithub.com/asciidoctor/asciidoctorj/issues/790)) - Fix logger implementation ([#786](https://togithub.com/asciidoctor/asciidoctorj/issues/786)) - Fix extension initialization in OSGi environments ([#754](https://togithub.com/asciidoctor/asciidoctorj/issues/754)) - Remove reference to RubyExtensionRegistryImpl from RubyExtensionRegistry ([#759](https://togithub.com/asciidoctor/asciidoctorj/issues/759)) - Don't return null from List.blocks() and DefinitionList.blocks() ([@jensnerche](https://togithub.com/jensnerche)) ([#761](https://togithub.com/asciidoctor/asciidoctorj/issues/761)) - Move org.asciidoctor.spi.ProcessorFactory to org.asciidoctor.extension ([@jensnerche](https://togithub.com/jensnerche)) ([#762](https://togithub.com/asciidoctor/asciidoctorj/issues/762)) Documentation: - Update documentation for running AsciidoctorJ in OSGi ([@twasyl](https://togithub.com/twasyl)) ([#765](https://togithub.com/asciidoctor/asciidoctorj/issues/765)) Build / Infrastructure:: - Fix jruby-maven-plugin and upstream build ([@mkristian](https://togithub.com/mkristian)) ([#777](https://togithub.com/asciidoctor/asciidoctorj/issues/777)) #### Release Meta Released on: 2019-04-24 Released by: [@robertpanzer](https://togithub.com/robertpanzer) Release beer: Firestone Walker Helldorado 2017 ### [`v1.6.2`](https://togithub.com/asciidoctor/asciidoctorj/releases/tag/v1.6.2) [Compare Source](https://togithub.com/asciidoctor/asciidoctorj/compare/v1.6.1...v1.6.2) #### Improvements - Upgrade to JRuby 9.2.6.0. This version of AsciidoctorJ is incompatible with any version of JRuby <= 9.2.5.0 #### Bug Fixes - Fix extension initialization in OSGi environments([#754](https://togithub.com/asciidoctor/asciidoctorj/issues/754)) #### Release Meta Released on: 2019-02-14 Released by: [@robertpanzer](https://togithub.com/robertpanzer) Release beer: TBD ### [`v1.6.1`](https://togithub.com/asciidoctor/asciidoctorj/releases/tag/v1.6.1) [Compare Source](https://togithub.com/asciidoctor/asciidoctorj/compare/v1.6.0...v1.6.1) - This release upgrades asciidoctor-diagram and fixes a bug when registering extension instances. #### Improvements - Upgrade asciidoctorj-diagram to 1.5.12 #### Bug fixes - AsciidoctorJ fails when registering a block processor instance while passing the name as a parameter ([#754](https://togithub.com/asciidoctor/asciidoctorj/issues/754)) #### Release Meta Released on: 2019-01-25 Released by: [@robertpanzer](https://togithub.com/robertpanzer) Release beer: TBD ### [`v1.6.0`](https://togithub.com/asciidoctor/asciidoctorj/releases/tag/v1.6.0) [Compare Source](https://togithub.com/asciidoctor/asciidoctorj/compare/v1.5.8.1...v1.6.0) #### AsciidoctorJ 1.6.0 AsciidoctorJ 1.6.0 is a final, transitional release in preparation for the switch to Semantic Versioning (SemVer). Despite its version number, this is a major release and, as such, not binary compatible with the 1.5.x releases. #### Improvements There are loads of changes that made it into this release, so it's difficult to enumerate them all. In fact, since the development of 1.6.0 ran in parallel with 1.5.x for so long, many changes from 1.6.0 may already be familiar to you as they got backported into the 1.5.x release line. The most prominent changes in 1.6.0 are as follows: - Rework Extension API. Please check the [Integrator Guide](https://togithub.com/asciidoctor/asciidoctorj/blob/master/docs/integrator-guide.adoc) for a documentation about how it looks now. - Add ExtensionGroup API and fix registration of multiple extensions ([#568](https://togithub.com/asciidoctor/asciidoctorj/issues/568)) - Reworked AST API, including renaming of classes. - Split org.asciidoctor package into api and impl modules. ([#603](https://togithub.com/asciidoctor/asciidoctorj/issues/603), [@jmini](https://togithub.com/jmini)) - Added converter API - Add support for capturing and routing log messages from Asciidoctor ([#657](https://togithub.com/asciidoctor/asciidoctorj/issues/657)) - Add documentation for the AsciidoctorJ logger ([#674](https://togithub.com/asciidoctor/asciidoctorj/issues/674), [@abelsromero](https://togithub.com/abelsromero)) - Added annotation-based processor configuration ([#341](https://togithub.com/asciidoctor/asciidoctorj/issues/341)) - Add support for creating tables structures to Extension API ([#335](https://togithub.com/asciidoctor/asciidoctorj/issues/335)) - Add support for Lists and Definition Lists to AST ([#408](https://togithub.com/asciidoctor/asciidoctorj/issues/408)) - Loads of cleanups and improvements across the API ([#715](https://togithub.com/asciidoctor/asciidoctorj/issues/715), [#717](https://togithub.com/asciidoctor/asciidoctorj/issues/717), [@Mogztter](https://togithub.com/Mogztter)) - Added method to get and remove substitutions ([#504](https://togithub.com/asciidoctor/asciidoctorj/issues/504)) - Rename isAttr(), setAttr() and getAttr() to more Java like names, isAttribute(), setAttribute() and getAttribute(). ([#554](https://togithub.com/asciidoctor/asciidoctorj/issues/554)) - Allow for method chaining when registering extensions ([#491](https://togithub.com/asciidoctor/asciidoctorj/issues/491)) - Upgrade to Gradle 4.4.1 ([#611](https://togithub.com/asciidoctor/asciidoctorj/issues/611), [@tisoft](https://togithub.com/tisoft)) - Remove ContentPart and StructuredDocument API ([#699](https://togithub.com/asciidoctor/asciidoctorj/issues/699)) ### Bug fixes There are a lot of bugs that were fixed regarding the extension API. Some of these may have already made it into 1.5.x as long as they did not require architectural changes. To list a few: - Support for source_location ([#351](https://togithub.com/asciidoctor/asciidoctorj/issues/351), [@ysb33r](https://togithub.com/ysb33r)) - Numerous fixes for the build process ([#474](https://togithub.com/asciidoctor/asciidoctorj/issues/474), [#482](https://togithub.com/asciidoctor/asciidoctorj/issues/482), [#469](https://togithub.com/asciidoctor/asciidoctorj/issues/469), [@ancho](https://togithub.com/ancho)) - Numerous fixes around errors in extensions, as an example ([@459](https://togithub.com/459) , [@ahus1](https://togithub.com/ahus1)) You can find more details about this release and its future at [asciidoctor.org](https://asciidoctor.org/news/asciidoctorj-1-6-0-released.html) ### Migration notes Migrating extensions from 1.5.x to 1.6.0 requires some changes, that should in general not be too hard. As examples you might compare extensions from the test cases: - YellBlock - [1.5.8](https://togithub.com/asciidoctor/asciidoctorj/blob/v1.5.8.1/asciidoctorj-core/src/test/java/org/asciidoctor/extension/YellBlock.java) vs [1.6.0](https://togithub.com/asciidoctor/asciidoctorj/blob/v1.6.0/asciidoctorj-core/src/test/java/org/asciidoctor/extension/YellBlock.java) - ArrowsAndBoxesBlock - [1.5.8](https://togithub.com/asciidoctor/asciidoctorj/blob/v1.5.8.1/asciidoctorj-core/src/test/java/org/asciidoctor/extension/ArrowsAndBoxesBlock.java) vs [1.6.0](https://togithub.com/asciidoctor/asciidoctorj/blob/v1.6.0/asciidoctorj-core/src/test/java/org/asciidoctor/extension/ArrowsAndBoxesBlock.java) - ManpageMacro - [1.5.8](https://togithub.com/asciidoctor/asciidoctorj/blob/v1.5.8.1/asciidoctorj-core/src/test/java/org/asciidoctor/extension/ManpageMacro.java) vs [1.6.0](https://togithub.com/asciidoctor/asciidoctorj/blob/v1.6.0/asciidoctorj-core/src/test/java/org/asciidoctor/extension/ManpageMacro.java) ### Thanks This release wouldn't have been possible without the help of all our awesome contributors: - [@abelsromero](https://togithub.com/abelsromero) - [@ahus1](https://togithub.com/ahus1) - [@lordofthejars](https://togithub.com/lordofthejars) - [@mojavelinux](https://togithub.com/mojavelinux) - [@ancho](https://togithub.com/ancho) -