减震器
Ascidoctor.js 扩展,减少 AsciiDoc 文档,其中包含对单一 AsciiDoc 文档的指令,通过扩展父文档可达到的包含. 此外,扩展评价预处理器条件(除非允许保存这些条件的选项),只让这些行远离真实的条件. 如果文档没有包含任何预处理器指令,扩展提供对未修改源的访问.
(目前JavaScript版本没有CLI和API).
安装
此软件包取决于 asciidoctor 软件包(qq 2. 2. 2. 0, < 3. 0.0),但并未宣布它是依赖关系.
因此,在安装这个包时必须安装这个包.
$ npm i asciidoctor @asciidoctor/reducer
如果你用Antora的扩展 asciidoctor antora提供的软件包.
使用量
延长
您可以结合 Asciidodor 提供的负载 API 使用此扩展 . 如果您想要在全球注册扩展, 则需要库如下 :
const Asciidoctor = require('asciidoctor')()
require('@asciidoctor/reducer').register()
当您使用 Ascidoctor 加载 API 时, 文档会自动被减小 .
您可以调用其中任一源 getSource() 或者说 getSourceLines() 在已装入的文档上.
const doc = Asciidoctor.loadFile('main.adoc', { safe: 'safe' })
console.log(doc.getSource())
您可以通过注册实例 register 以范围登记(以负载API呼叫为范围)来登记扩展的方法.
const Asciidoctor = require('asciidoctor')()
const registry = Asciidoctor.Extensions.create()
require('@asciidoctor/reducer').register(registry)
const doc = Asciidoctor.loadFile('main.adoc', { extension_registry: registry, safe: 'safe' })
您还可以要求 @asciidoctor/reducer/extensions 访问 Extensions 课.
版权和许可证
版权(C)2021年至今,丹·艾伦和该项目的个人贡献者. 该软件的使用根据麻省理工学院许可证的规定准予.
商标
AsciiDoc(R)和AsciiDoc Language(TM)是Eclipse基金会股份有限公司的商标.