Looking for asciidoc viewer or wysiwyg editor

[Zucca]

As the title says - I'm looking for some sort of (offline) asciidoc viewer, preferably editor.
I can remember I used some editor in the past with two panes - first one was the raw ascii text, the second was a "gui rendition" of the text.

First I assumed that Libreoffice surely supports asciidoc, but no. I guess there is some plugin in the depth of the internet for that.

Anyway.

Do you write documentation using asciidoc? Which tools do you use? Which tools you would consider using if you were editing asciidoc?

[Banana]

have you already looked there?
https://docs.asciidoctor.org/asciidocto ... t/tooling/

[sMueggli]

I use AsciidocFX.

[Zucca]

Yeah.
I've looked at those.

I don't particulary like java, because of past problems with different versions... Although I'll try that if I don't find anything that uses fltk, gtk or qt.

I remember using ghostwriter back in the day. Although it seems to only support markdown, which isn't that human readable as asciidoc when viewed as ascii.

EDIT: I should have expected this. ghostwriter pulls in qtwebengine. ':)

I'll try the Firefox browser extension next.

[szatox]

Not quite there with that WYSIWYG (or more often: WYSIWTF) requirement, but vim as provided by Gentoo comes with syntax highlighting for various programming languages, and it does cover *.adoc files too.
It is not perfect, but since those files are supposed to be human-readable even without a reader, it might be good enough, depending on your particular use case.

[logrusx]

+1 for vim/nvim and also +1 for Firefox extensions as viewers. Good luck with WYSIWYG editor.

I guess emacs may also have similar capabilities as vim, if you prefer it.

So far I've only used converters as pandoc and ascii-doctor to produce something out of adoc.

Best Regards,
Georgi

[logrusx]

I just got a brilliant idea I'm sure you'll like because it's written in Java and is heavy as hell :D

Joke aside, this is the best I've seen so far. IntelliJ Ideal + AsciiDoc plugin. It gives you a split window, horizontally or vertically, it synchronizes your cursor, it follows links. No WYSIWYG but it's the next best thing.

I'm using IntelliJ ultimate which has 30 day trial period but I think community edition will work too. If it doesn't and you need information about ultimate edition, message me.

p.s. I still use nvim to edit. Not that IntelliJ doesn't have IdeaVim plugin, but I prefer the real deal. I only preview thins in IntelliJ because the tutorial I'm working on contains code as well which is way better in IntelliJ.

Best Regards,
Georgi

[flexibeast]

I guess emacs may also have similar capabilities as vim, if you prefer it.

There's certainly adoc-mode for editing AsciiDoc, although it doesn't (seem to) provide the required general preview functionality.

[Zucca]

The Firefox extension works well enough, so I can use it to verify that the written document doesn't contain any syntax errors. Eventually, I think, I can live without any preview... since, like it's name suggests, it should be human readable in raw and rendered form.

[miket]

The Firefox extension works well enough, so I can use it to verify that the written document doesn't contain any syntax errors. Eventually, I think, I can live without any preview... since, like it's name suggests, it should be human readable in raw and rendered form.

Funny, just in the last few days I was in the same situation (and not paying attention to the Gentoo forums). It was time to generate some more documentation and I wondered if there were some nice authoring tools for Asciidoc. For some time I had used the clunky solution of a PHP script running under Apache that would run asciidoc to convert my Asciidoc text into a web page. I'd edit the text in Vim and every once in a while save it and refresh my web page.

So I tried AsciidocFX and marveled at how sluggish it is (I'm spoiled by Vim's instantaneous startup) and wondered what Atom was like before Microsoft killed it. I gave some passing thought to building either Pulsar (an Atom fork) or Zed (a rusty reimplementation of Atom) and then figuring out how to add the Asciidoc support, but decided against it.

I'm back to my original method: edit in Vim and proofread the generated web page.

[logrusx]

Just stumbled on this: https://github.com/shuntaka9576/preview-asciidoc.vim

Best Regards,
Georgi