@asciidoctor/core v3.0.4
= Asciidoctor.js: AsciiDoc in JavaScript powered by Asciidoctor Dan Allen https://github.com/mojavelinux[@mojavelinux]; Guillaume Grossetie https://github.com/mogztter[@mogztter]; Anthonny Quérouil https://github.com/anthonny[@anthonny] :idprefix: :idseparator: - :uri-nodejs: https://nodejs.org :uri-opal: https://opalrb.com :uri-repo: https://github.com/asciidoctor/asciidoctor.js :uri-freesoftware: https://www.gnu.org/philosophy/free-sw.html ifndef::uri-rel-file-base:uri-rel-file-base: link: :uri-contribute: {uri-rel-file-base}CONTRIBUTING.adoc :uri-contribute-code: {uri-rel-file-base}CONTRIBUTING-CODE.adoc :uri-user-manual: https://asciidoctor-docs.netlify.com/asciidoctor.js/ :license: {uri-repo}/blob/master/LICENSE :experimental: :endash:
ifdef::env-github[] image:https://img.shields.io/travis/asciidoctor/asciidoctor.js/master.svg[Travis build status, link=https://travis-ci.org/asciidoctor/asciidoctor.js] image:https://ci.appveyor.com/api/projects/status/i69sqvvyr95sf6i7/branch/master?svg=true[Appveyor build status, link=https://ci.appveyor.com/project/asciidoctor/asciidoctor-js] image:https://img.shields.io/npm/v/asciidoctor.svg[npm version, link=https://www.npmjs.org/package/asciidoctor] image:https://data.jsdelivr.com/v1/package/npm/asciidoctor/badge?style=rounded[jsDelivr stats, link=https://www.jsdelivr.com/package/npm/asciidoctor] image:https://img.shields.io/badge/jsdoc-master-blue.svg[JSDoc, link=http://asciidoctor.github.io/asciidoctor.js/master] image:https://inch-ci.org/github/asciidoctor/asciidoctor.js.svg?branch=master[InchCI, link=https://inch-ci.org/github/asciidoctor/asciidoctor.js] endif::[]
Asciidoctor.js brings AsciiDoc to the JavaScript world!
This project uses {uri-opal}Opal to transpile http://asciidoctor.org[Asciidoctor], a modern implementation of AsciiDoc, from Ruby to JavaScript to produce asciidoctor.js. The asciidoctor.js script can be run on any JavaScript platform, including Node.js, GraalVM and, of course, a web browser.
== Quickstart
$ npm i asciidoctor --save
Here is a simple example that converts AsciiDoc to HTML5:
.sample.js
source,javascript
const asciidoctor = require('asciidoctor')() // <1> const content = 'http://asciidoctor.org[Asciidoctor] ' + 'running on https://opalrb.com[Opal] ' + 'brings AsciiDoc to Node.js!' const html = asciidoctor.convert(content) // <2>
console.log(html) // <3>
<1> Instantiate the Asciidoctor.js library <2> Convert AsciiDoc content to HTML5 using Asciidoctor.js <3> Print the HTML5 output to the console
Save the file as sample.js and run it using the node
command:
$ node sample.js
You should see the following output in your terminal:
source.output,html
It's also possible to use the following script
tag directly into your HTML page:
<script src="node_modules/@asciidoctor/core/dist/browser/asciidoctor.js"></script>
== Learning
If you want to learn more about Asciidoctor.js, please read the {uri-user-manual}User Manual.
== Contributing
In the spirit of {uri-freesoftware}free software, everyone is encouraged to help improve this project. If you discover errors or omissions in the source code, documentation, or website content, please don't hesitate to submit an issue or open a pull request with a fix. New contributors are always welcome!
The {uri-contribute}Contributing guide provides information on how to contribute.
If you want to write code, the {uri-contribute-code}Contributing Code guide will help you to get started quickly.
== Copyright
Copyright (C) 2019 Dan Allen, Guillaume Grossetie, Anthonny Quérouil and the Asciidoctor Project. Free use of this software is granted under the terms of the MIT License.
See the {license}LICENSE file for details.
1 month ago
2 months ago
3 months ago
10 months ago
10 months ago
10 months ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
2 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago