Ascidoctor.js 的 DocBook 转换器
安装
$ npm i @asciidoctor/core @asciidoctor/docbook-converter
使用量
国 际
如果你正在使用 Ascidoctor.js CLI (英语) 然后,你可以使用这个 --require 选项以装入 DocBook 转换器 :
$ asciidoctor --require @asciidoctor/docbook-converter --backend docbook doc.adoc
上述命令将生成一个名为的文件 医生.xml 使用 DocBook 转换器.
API 密码
也可以使用API将AsciiDoc的内容转换为DocBook.
无害环境管理(进口)
ECMAScript模块是包装JavaScript代码的官方标准格式.
我们建议使用 import 指令 :
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)
关键是: 在注册 DocBook 转换器之前, 请先将 Asciidodor 立即进行 .
注: 自兹 @asciidoctor/core 尚未作为 ECMAScript 模块发布,您将使用 Webpack 、 Rollup 或 Parcel 等 Web 捆绑器使用 import 指令.
普通JS( 必需)
const asciidoctor = require('@asciidoctor/core')()
const docbookConverter = require('@asciidoctor/docbook-converter')
docbookConverter.register() // register the DocBook converter
UMD 图像
此外,我们还提供 通用模块定义 导出一个名为全局对象 AsciidoctorDocBook。 。 。 .
Ascidoctor.js 装入后,您需要使用 register数字 :
/* global Asciidoctor, AsciidoctorDocBook */
const asciidoctor = Asciidoctor()
AsciidoctorDocBook.register() // register the DocBook converter