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?
_________________
..: Zucca :..

Banana · Posted: Thu Oct 31, 2024 11:40 am Post subject:

have you already looked there?
https://docs.asciidoctor.org/asciidoctor/latest/tooling/
_________________
Forum Guidelines

PFL - Portage file list - find which package a file or command belongs to.
My delta-labs.org snippets do expire

sMueggli · Guru Joined: 03 Sep 2022 Posts: 501

I use AsciidocFX.

Zucca · Posted: Fri Nov 01, 2024 8:39 am Post subject:

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.
_________________
..: Zucca :..

szatox · Advocate Joined: 27 Aug 2013 Posts: 3468

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.
_________________
Make Computing Fun Again

logrusx · Advocate Joined: 22 Feb 2018 Posts: 2475

+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 · Advocate Joined: 22 Feb 2018 Posts: 2475

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 · Posted: Fri Nov 01, 2024 11:43 pm Post subject:

Zucca · Posted: Sun Nov 03, 2024 2:18 pm Post subject:

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.
_________________
..: Zucca :..

miket · Posted: Wed Nov 13, 2024 6:31 am Post subject:

logrusx · Advocate Joined: 22 Feb 2018 Posts: 2475

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

Best Regards,
Georgi