/asciidoctor-firefox-addon

:wolf: An add-on for Mozilla Firefox that converts AsciiDoc files to HTML directly in the browser using Asciidoctor.js.

Primary LanguageJavaScriptMIT LicenseMIT

Asciidoctor Firefox Addon (deprecated)

This project uses Asciidoctor.js to render AsciiDoc as HTML inside Firefox!

Important

No longer actively maintained since Firefox now supports WebExtensions API 🎉

In the past, there were several toolsets for developing Firefox extensions, but by the end of November 2017, extensions must be built using WebExtensions APIs. Extensions written using WebExtensions APIs for Firefox are designed to be cross-browser compatible. In most cases it will run in Chrome, Edge, and Opera with few if any changes. They are also fully compatible with multiprocess Firefox.

The code base for Chrome, Chromium, Opera and Firefox is now available at https://github.com/asciidoctor/asciidoctor-chrome-extension

Usage

  1. Install the extension from the Firefox Add-ons site or from the GitHub latest release page. When you download the xpi file, if Firefox downloads it instead of directly installing it, just drag and drop it on Firefox

  2. Open local or remote .ad, .adoc, .asc, .asciidoc file in Firefox

  3. Click on the Asciidoctor Live Preview button in the toolbar (button with an A icon) to activate or deactivate the rendering.

asciidoctor preview enabled
Figure 1. An asciidoc file opened in firefox with HTML preview
asciidoctor preview disabled
Figure 2. An asciidoc file opened in firefox without HTML preview

Local build

To manually build the extension bundle (.xpi) from the source you need to install jpm.

$ npm install jpm -g

Then execute the command jpm xpi from the add-on’s directory:

$ jpm xpi

This command will produce an .xpi file. You can simply drag and drop it on Firefox to install the Add-on.

Copyright

Copyright © 2013 Guillaume Grossetie. Free use of this software is granted under the terms of the MIT License.

See the LICENSE file for details.