= textlint-plugin-asciidoc // Settings: :idprefix: :idseparator: - ifndef::env-github[:icons: font] ifdef::env-github[] :status: :warning-caption: :warning: endif::[] // URIs: :repo-path: opendevise/textlint-plugin-asciidoc :uri-repo: https://github.com/{repo-path} :uri-asciidoc: http://asciidoctor.org/docs/what-is-asciidoc/ :uri-textlint: https://github.com/textlint/textlint :uri-ci-travis: https://travis-ci.org/{repo-path}

ifdef::status[] image:https://img.shields.io/travis/{repo-path}/master.svg[Build Status (Travis CI), link={uri-ci-travis}] endif::[]

An AsciiDoc parser designed to perform validations on {uri-asciidoc}[AsciiDoc] documents using {uri-textlint}[textlint].

.Alpha warning WARNING: This plugin is currently in alpha. Do not expect it to handle all the AsciiDoc syntax correctly. Refer to the test suite to learn what syntax the parser currently supports. The AST created by this plugin is also not yet compatible with any textlint rules. That alignment is expected to happen as the plugin evolves.

== Prerequisites

This plugin targets ES6 and is tested using Node (stable). Therefore, you must have at least Node 7 in order to run it.

== Usage

[source,js]

const AsciiDocProcessor = require('textlint-plugin-asciidoc').Processor const processor = new AsciiDocProcessor().processor('.adoc') const ast = processor.preProcess('Build me a tree.\nI will visit its branches.', '') console.log(ast)

.Output .... { type: 'DocumentNode', raw: 'Build me a tree.\nI will visit its branches.', range: [ 0, 43 ], loc: { start: Position { line: 1, column: 0 }, end: Position { line: 2, column: 26 } }, children: [ { type: 'ParagraphNode', range: [ 0, 43 ], loc: { start: Position { line: 1, column: 0 }, end: Position { line: 2, column: 26 } }, children: [...] } ] } ....

=== Copyright and License

Copyright (C) 2017-present Dan Allen and OpenDevise Inc. Free use of this software is granted under the terms of the MIT License. To see the full text of the license, refer to the link:LICENSE[LICENSE] file.