Skip to content
This repository has been archived by the owner on Nov 21, 2017. It is now read-only.

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

License

Notifications You must be signed in to change notification settings

asciidoctor/asciidoctor-firefox-addon

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

89 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

About

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

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published