Gentoo Forums
Gentoo Forums
Gentoo Forums
Quick Search: in
Looking for asciidoc viewer or wysiwyg editor
View unanswered posts
View posts from last 24 hours

 
Reply to topic    Gentoo Forums Forum Index Gentoo Chat
View previous topic :: View next topic  
Author Message
Zucca
Moderator
Moderator


Joined: 14 Jun 2007
Posts: 3698
Location: Rasi, Finland

PostPosted: Thu Oct 31, 2024 11:15 am    Post subject: Looking for asciidoc viewer or wysiwyg editor Reply with quote

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

My gentoo installs:
init=/sbin/openrc-init
-systemd -logind -elogind seatd

Quote:
I am NaN! I am a man!
Back to top
View user's profile Send private message
Banana
Moderator
Moderator


Joined: 21 May 2004
Posts: 1730
Location: Germany

PostPosted: Thu Oct 31, 2024 11:40 am    Post subject: Reply with quote

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


Last edited by Banana on Thu Oct 31, 2024 1:48 pm; edited 1 time in total
Back to top
View user's profile Send private message
sMueggli
Guru
Guru


Joined: 03 Sep 2022
Posts: 495

PostPosted: Thu Oct 31, 2024 12:31 pm    Post subject: Reply with quote

I use AsciidocFX.
Back to top
View user's profile Send private message
Zucca
Moderator
Moderator


Joined: 14 Jun 2007
Posts: 3698
Location: Rasi, Finland

PostPosted: Fri Nov 01, 2024 8:39 am    Post subject: Reply with quote

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

My gentoo installs:
init=/sbin/openrc-init
-systemd -logind -elogind seatd

Quote:
I am NaN! I am a man!
Back to top
View user's profile Send private message
szatox
Advocate
Advocate


Joined: 27 Aug 2013
Posts: 3431

PostPosted: Fri Nov 01, 2024 9:43 am    Post subject: Reply with quote

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
Back to top
View user's profile Send private message
logrusx
Advocate
Advocate


Joined: 22 Feb 2018
Posts: 2420

PostPosted: Fri Nov 01, 2024 9:49 am    Post subject: Reply with quote

+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
Back to top
View user's profile Send private message
logrusx
Advocate
Advocate


Joined: 22 Feb 2018
Posts: 2420

PostPosted: Fri Nov 01, 2024 2:23 pm    Post subject: Reply with quote

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
Back to top
View user's profile Send private message
flexibeast
Guru
Guru


Joined: 04 Apr 2022
Posts: 449
Location: Naarm/Melbourne, Australia

PostPosted: Fri Nov 01, 2024 11:43 pm    Post subject: Reply with quote

logrusx wrote:
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.
_________________
https://wiki.gentoo.org/wiki/User:Flexibeast
Back to top
View user's profile Send private message
Zucca
Moderator
Moderator


Joined: 14 Jun 2007
Posts: 3698
Location: Rasi, Finland

PostPosted: Sun Nov 03, 2024 2:18 pm    Post subject: Reply with quote

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

My gentoo installs:
init=/sbin/openrc-init
-systemd -logind -elogind seatd

Quote:
I am NaN! I am a man!
Back to top
View user's profile Send private message
miket
Guru
Guru


Joined: 28 Apr 2007
Posts: 497
Location: Gainesville, FL, USA

PostPosted: Wed Nov 13, 2024 6:31 am    Post subject: Reply with quote

Zucca wrote:
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.
Back to top
View user's profile Send private message
Display posts from previous:   
Reply to topic    Gentoo Forums Forum Index Gentoo Chat All times are GMT
Page 1 of 1

 
Jump to:  
You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot vote in polls in this forum