Reviews for Asciidoctor.js Live Preview
Asciidoctor.js Live Preview by Guillaume Grossetie
Review by David Calloway
Rated 5 out of 5
by David Calloway, 2 years ago27 reviews
- Rated 5 out of 5by Firefox user 15260469, 2 months ago
- Rated 5 out of 5by Firefox user 18259133, a year ago
- Rated 5 out of 5by Liam Baumann, a year agoAbsolutely great! Works out of the box (including Stem). Even has some themes you can choose from.
- Rated 1 out of 5by ЯромиR, a year agoUseless crap!..
Does not function in Firefox, nor has any controls available :-E
So, it does nothing what is false claiming in the description! - Rated 5 out of 5by Moz, a year ago
- Rated 5 out of 5by Wombat, 2 years agoThis plugin works exactly as expected and fully supports AsciiDoc, rendering AsciiDoc files to HTML. It is extremely easy to install, useful and easy to use. It is recommended highly to technical people who record their activities in text files or for those writing technical docs. If you work with or are interested in "Docs as Code" and "Diagrams as Code" this plugin is essential, maintained, and it gets daily use.
This is the first extension I install on a new browser and sometimes its the only one.
Key features of the plugin:
- Themes: Many different themes to chose from (including dark).
- Anywhere: Your files may be on your machine, remote, or raw from GitHub.
- Automatic refresh: When the browser and your text editor are side by side, view the asciidoc with the plugin. When you save the file the view refreshes automatically. You may also rename your .md file to .adoc, then edit and save to see your changes as you go.
- Custom Attributes: Just configuring this time saver with "toc=left" allows you to see a table of contents for AsciiDoc files that don't have one; and it allows you to write extremely minimalist documents without needing to write ":toc: left" in your file.
- Diagrams as Code: By configuring it to use Kroki.io, you can write diagrams as text, and have them generated by Kroki.io on the fly and rendered in the preview. Wow.
- Quick enable/disable: Clicking the red AsciiDoc extension icon toggles the preview allowing you to see the raw AsciiDoc behind it.
This review was written and reviewed as an AsciiDoc file before posting. - Rated 5 out of 5by Firefox user 17893815, 2 years ago
- Rated 5 out of 5by nikos, 2 years ago
- Rated 5 out of 5by arrufat, 2 years ago
- Rated 4 out of 5by Michel M., 2 years agoWorks fluently and fulfills its jobs! Not 5 stars, as there seems to be transient display states. My page first displays in text, then there is a first rendering, only eventually the page is displayed in the selected GitHub style .
- Rated 5 out of 5by Firefox user 16876646, 4 years ago
- Rated 5 out of 5by Billy Capple, 4 years agoThis does a nice job of previewing an asciidoc file. Perfect for simple uses cases, and possibly more complex ones (I don't know).
- Rated 5 out of 5by Firefox user 13605519, 4 years ago
- Rated 5 out of 5by Firefox user 14163673, 5 years agoAll you are going to need to preview your ADOC files. Works smoothly, just perfect!
- Rated 5 out of 5by ViperSniper0501, 5 years ago
- Rated 5 out of 5by Firefox user 14922600, 5 years agoWIth version 2.3.1, works great on Firefox now as well as chrome. Good job. Direct view of Asciidoc with diagrams is a huge win.
- Rated 5 out of 5by Firefox user 15113732, 5 years ago
- Rated 5 out of 5by Firefox user 15080318, 6 years agoThat's great if the next release supporting the floating navigation area including all headings with certain level. BRs.
- Rated 5 out of 5by Firefox user 14501485, 6 years ago
- Rated 5 out of 5by Firefox user 14562301, 6 years agoHello, I'm very happy to use the plugin.
But as Firefox-User 14060320 wrote - I've also some problems when using it in Firefox.
Though I'm not sure if these are the same problems.
I didn't have problems in Opera or Chrome.
Same situation on Windows 7 and Windows 10.
So what's wrong ...
* step 1: _in the browser_, I open a file-url to some dox/-directory containing my ADOC-files.
* step 2: in the rendered directory-listing, ...
** 2-A) click an xyz.adoc link
=> it opens in the same tab, but does not render as ADOC => :-(
** 2-B) right-click an xyz.adoc link => "open in new window"
=> it opens a new window, but does not render as ADOC => :-(
** 2-C) right-click + open in new tab (or Ctrl-Click)
=> Wow! I see pretty ADOC!
** 2-D) If I type in the whole (file-) URL directly => also OK.
So I hope that helps, and you are still glad to fix it.
Thanks,
ToniDeveloper response
posted 6 years agoHello Toni and thanks for your review :)
It's a known issue and there’s an open bug in the Firefox bug tracker to fix this limitation: https://bugzilla.mozilla.org/show_bug.cgi?id=1266960
Hopefully it will soon be fixed.
I've documented this limitation in the project README on GitHub: https://github.com/asciidoctor/asciidoctor-browser-extension#firefox
Cheers,
Guillaume - Rated 5 out of 5by 77minds, 6 years ago
- Rated 5 out of 5by Le Roux Jacques, 6 years ago
- Rated 2 out of 5by Firefox user 14060320, 7 years agoEver since Firefox changed their extension API I'm having trouble getting this extension to work.
Developer response
posted 7 years agoHello, could you please elaborate ? What is not working ? Do you have an error in the console ? Are you able to reproduce this issue on a particular website ?
I would be glad to fix it but I need some information :)
Thanks,
Guillaume
Edit: I think it might be related to this bug: https://bugzilla.mozilla.org/show_bug.cgi?id=1267027
On Firefox, pages viewed directly from GitHub may not render properly. This is result of a Firefox bug carrying over the restrictive content security policies (CSP) that GitHub sends to content inserted by the WebExtension. Please note that this issue can also occured on other websites with restictive CSP. - Rated 3 out of 5by Firefox user 13801777, 7 years agoHow can one set the rendering control? I'm trying to render graphs with graphviz, but not seeing any options to include the command... apart from that, great idea for a plugin! I use it as a live previewer, while I write in vim.
Developer response
posted 7 years agoThanks for your review.
Unfortunately Graphviz rendering is not yet available in a browser environment.
A PlantUML extension is under development and might be integrated soon.
Edit: since the last version PlantUML diagrams are rendered ;)