Kitzijoxikil Asciidoctor.js Live Preview
Asciidoctor.js Live Preview ruma Guillaume Grossetie
Review by Liam Baumann
Rated 5 out of 5
ruma Liam Baumann, 2 సంవత్సరాలు క్రితంAbsolutely great! Works out of the box (including Stem). Even has some themes you can choose from.
26 reviews
- Rated 5 out of 5ruma Firefox okisanel 15260469, 6 నెలలు క్రితం
- Rated 5 out of 5ruma Firefox okisanel 18259133, ఒక సంవత్సరం క్రితం
- Rated 1 out of 5ruma ЯромиR, 2 సంవత్సరాలు క్రితంUseless 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 5ruma Moz, 2 సంవత్సరాలు క్రితం
- Rated 5 out of 5ruma Wombat, 2 సంవత్సరాలు క్రితంThis 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 5ruma Firefox okisanel 17893815, 2 సంవత్సరాలు క్రితం
- Rated 5 out of 5ruma nikos, 2 సంవత్సరాలు క్రితం
- Rated 5 out of 5ruma David Calloway, 2 సంవత్సరాలు క్రితం
- Rated 4 out of 5ruma Michel M., 3 సంవత్సరాలు క్రితంWorks 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 5ruma Firefox okisanel 16876646, 4 సంవత్సరాలు క్రితం
- Rated 5 out of 5ruma Billy Capple, 4 సంవత్సరాలు క్రితంThis 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 5ruma Firefox okisanel 13605519, 4 సంవత్సరాలు క్రితం
- Rated 5 out of 5ruma Firefox okisanel 14163673, 5 సంవత్సరాలు క్రితంAll you are going to need to preview your ADOC files. Works smoothly, just perfect!
- Rated 5 out of 5ruma ViperSniper0501, 5 సంవత్సరాలు క్రితం
- Rated 5 out of 5ruma Firefox okisanel 14922600, 5 సంవత్సరాలు క్రితంWIth 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 5ruma Firefox okisanel 15113732, 6 సంవత్సరాలు క్రితం
- Rated 5 out of 5ruma Firefox okisanel 15080318, 6 సంవత్సరాలు క్రితంThat's great if the next release supporting the floating navigation area including all headings with certain level. BRs.
- Rated 5 out of 5ruma Firefox okisanel 14501485, 6 సంవత్సరాలు క్రితం
- Rated 5 out of 5ruma Firefox okisanel 14562301, 6 సంవత్సరాలు క్రితంHello, 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,
ToniTzolin rutzij b'anonel
xtalüx rutzijol 6 సంవత్సరాలు క్రితంHello 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 5ruma 77minds, 6 సంవత్సరాలు క్రితం
- Rated 5 out of 5ruma Le Roux Jacques, 6 సంవత్సరాలు క్రితం
- Rated 2 out of 5ruma Firefox okisanel 14060320, 7 సంవత్సరాలు క్రితంEver since Firefox changed their extension API I'm having trouble getting this extension to work.
Tzolin rutzij b'anonel
xtalüx rutzijol 7 సంవత్సరాలు క్రితంHello, 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 5ruma Firefox okisanel 13801777, 7 సంవత్సరాలు క్రితంHow 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.
Tzolin rutzij b'anonel
xtalüx rutzijol 7 సంవత్సరాలు క్రితంThanks 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 ;) - Rated 4 out of 5ruma Paulo França Lacerda, 7 సంవత్సరాలు క్రితంIt works exactly as expected.
Very useful. Thank you!Tzolin rutzij b'anonel
xtalüx rutzijol 7 సంవత్సరాలు క్రితంThanks for your review. I'm glad you find it useful :)