$ npm i @asciidoctor/core @asciidoctor/docbook-converterIf you are using the Asciidoctor.js CLI then you can use the --require option to load the DocBook converter:
$ asciidoctor --require @asciidoctor/docbook-converter --backend docbook doc.adoc
The above command will generate a file named doc.xml using the DocBook converter.
It's also possible to use the API to convert AsciiDoc content to DocBook.
ECMAScript modules are the official standard format to package JavaScript code.
We recommend to import this converter using the import directive:
import Asciidoctor from '@asciidoctor/core'
import docbookConverter from '@asciidoctor/docbook-converter'
const asciidoctor = Asciidoctor() // instantiate Asciidoctor
docbookConverter.register() // register the DocBook converter
const content = `= DocBook
Author Name
v1.0, 2020-04-13
:doctype: book
:doctitle: Awesome Asciidoctor
:docdate: 2020-01-01
== First section
Once upon a time...`
const docbook = asciidoctor.convert(content, { backend: 'docbook5', standalone: true })
//console.log(docbook)❗ IMPORTANT: Make sure to instantiate Asciidoctor before registering the DocBook converter.
ℹ️ NOTE: Since @asciidoctor/core is not yet published as an ECMAScript module, you will to use a Web bundler such as Webpack, Rollup or Parcel to import it using the import directive.
const asciidoctor = require('@asciidoctor/core')()
const docbookConverter = require('@asciidoctor/docbook-converter')
docbookConverter.register() // register the DocBook converterIn addition, we also provide a Universal Module Definition that exports a global object named AsciidoctorDocBook.
Once Asciidoctor.js is loaded, you will need to register the converter using register:
/* global Asciidoctor, AsciidoctorDocBook */
const asciidoctor = Asciidoctor()
AsciidoctorDocBook.register() // register the DocBook converter