asciidoctor / Asciidoctor Browser Extension
Projects that are alternatives of or similar to Asciidoctor Browser Extension
= Asciidoctor Browser Extension Guillaume Grossetie
ifndef::env-github[:icons: font] ifdef::env-github[] :outfilesuffix: .adoc :caution-caption: 🔥 :important-caption: ❗️ :note-caption: 📎 :tip-caption: 💡 :warning-caption: ⚠️ endif::[]
:uri-license: https://github.com/asciidoctor/asciidoctor-chrome-extension/blob/master/LICENSE :uri-hacking: https://github.com/asciidoctor/asciidoctor-chrome-extension/blob/master/hacking.adoc :uri-changelog: https://github.com/asciidoctor/asciidoctor-chrome-extension/blob/master/changelog.adoc :uri-chrome-webstore: https://chrome.google.com/webstore/detail/asciidoctorjs-live-previe/iaalpfgpbocpdfblpnhhgllgbdbchmia :uri-mozilla-addon: https://addons.mozilla.org/firefox/addon/asciidoctorjs-live-preview :uri-opera-addon: https://addons.opera.com/extensions/details/asciidoctorjs-live-preview :uri-edge-webstore: https://microsoftedge.microsoft.com/addons/detail/asciidoctorjs-live-previ/pefkelkanablhjdekgdahplkccnbdggd
This project uses https://github.com/asciidoctor/asciidoctor.js[Asciidoctor.js] to preview AsciiDoc as HTML inside Chrome (or Chromium), Firefox and Opera!
image:https://raw.githubusercontent.com/asciidoctor/asciidoctor-browser-extension/master/promotional/chromewebstore-badge-wborder-496x150.png[link={uri-chrome-webstore},height="58px"] image:https://addons.cdn.mozilla.net/static/img/addons-buttons/AMO-button_1.png[link={uri-mozilla-addon},height="58px"] image:https://dev.opera.com/extensions/branding-guidelines/[email protected][link={uri-opera-addon},width=206px] image:https://raw.githubusercontent.com/asciidoctor/asciidoctor-browser-extension/master/promotional/edgewebstore-badge.png[link={uri-edge-webstore},height="58px"]
Project health: image:https://travis-ci.org/asciidoctor/asciidoctor-browser-extension.svg?branch=master[Build Status, link="https://travis-ci.org/asciidoctor/asciidoctor-browser-extension"] image:https://github.com/asciidoctor/asciidoctor-browser-extension/workflows/CI/badge.svg[Build Status, link="https://github.com/asciidoctor/asciidoctor-browser-extension/actions?query=workflow%3ACI"]
== Usage
=== Chrome, Chromium, Brave or Opera
- Install the extension from the {uri-chrome-webstore}[Chrome Web Store] or the {uri-opera-addon}[Opera Add-ons website]
- Check
Allow access to file URLs
inchrome://extensions
- Open local or remote .ad, .adoc, .asc, .asciidoc files in your browser
- Enjoy!
=== Firefox
- Install the extension from the {uri-mozilla-addon}[Firefox Add-ons website]
- Open local or remote .ad, .adoc, .asc, .asciidoc files in Firefox
- Enjoy!
[WARNING]
On Firefox, pages viewed directly from GitHub may not render properly. This is result of a https://bugzilla.mozilla.org/show_bug.cgi?id=1267027[Firefox bug] carrying over the Content Security Policies (CSP). The restrictive CSP sent by GitHub are applied to the content inserted by the WebExtension.
file://
from a link.
Instead, you have to enter the file://
URL directly into the address bar of the browser.
If you do navigate to a file://
URL from a link, simply highlight the address bar and press "Enter" to force the extension to load. There's an open issue in the https://bugzilla.mozilla.org/show_bug.cgi?id=1266960[Firefox bug tracker] to fix this limitation.
In addition, the extension does not automatically trigger in Firefox when navigating to a == Installation
Loading your local copy of the extension on Chrome (or Chromium), Firefox or Opera is super easy!
=== Chrome, Chromium, Brave or Opera
- Check
Developer mode
inchrome://extensions
- Click
Load unpacked extension...
and select the extensionapp
directory - That's all
To see your changes, click the Reload (Ctrl+R)
link in chrome://extensions
.
If you want to create a Pack extension
just make a zip
file of the extension app
directory.
=== Firefox
- Click on the
Load Temporary Add-on
inabout:debugging
- Select the manifest file in the
app
directory - That's all
To see your changes, click the Reload
link in about:debugging
.
== Options
The extension can be configured via an options page.
To open the options page, in Chrome, Brave or Opera, right-click the extension icon and choose Options on the menu.
You can also go to chrome://extensions
and click the Options link.
In Firefox, go to about:addons
and click the More link or the Preferences button.
The options page let you add custom Asciidoctor attributes or change the theme of the AsciiDoc HTML output.
== Contributing
See the <<hacking#, hacking>> file.
== Changelog
See the <<changelog#, changelog>> file.
== Copyright
Copyright (C) 2013-2020 Guillaume Grossetie. Free use of this software is granted under the terms of the MIT License.
See the {uri-license}[LICENSE] file for details.