This repository has been archived by the owner. It is now read-only.
🐺 An add-on for Mozilla Firefox that converts AsciiDoc files to HTML directly in the browser using Asciidoctor.js.
JavaScript CSS
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
data
img
lib
.gitignore
LICENSE
README.adoc
contributing-code.adoc
icon.png
icon64.png
package.json

README.adoc

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 © 2013 Guillaume Grossetie. Free use of this software is granted under the terms of the MIT License.

See the LICENSE file for details.