View previous topic :: View next topic |
Author |
Message |
Zucca Moderator
Joined: 14 Jun 2007 Posts: 3776 Location: Rasi, Finland
|
Posted: Thu Oct 31, 2024 11:15 am Post subject: Looking for asciidoc viewer or wysiwyg editor |
|
|
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 |
|
|
Banana Moderator
Joined: 21 May 2004 Posts: 1800 Location: Germany
|
|
Back to top |
|
|
sMueggli Guru
Joined: 03 Sep 2022 Posts: 514
|
Posted: Thu Oct 31, 2024 12:31 pm Post subject: |
|
|
I use AsciidocFX. |
|
Back to top |
|
|
Zucca Moderator
Joined: 14 Jun 2007 Posts: 3776 Location: Rasi, Finland
|
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 :..
My gentoo installs: | init=/sbin/openrc-init
-systemd -logind -elogind seatd |
Quote: | I am NaN! I am a man! |
|
|
Back to top |
|
|
szatox Advocate
Joined: 27 Aug 2013 Posts: 3477
|
Posted: Fri Nov 01, 2024 9:43 am Post subject: |
|
|
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 |
|
|
logrusx Advocate
Joined: 22 Feb 2018 Posts: 2527
|
Posted: Fri Nov 01, 2024 9:49 am Post subject: |
|
|
+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 |
|
|
logrusx Advocate
Joined: 22 Feb 2018 Posts: 2527
|
Posted: Fri Nov 01, 2024 2:23 pm Post subject: |
|
|
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 |
|
|
flexibeast Guru
Joined: 04 Apr 2022 Posts: 473 Location: Naarm/Melbourne, Australia
|
Posted: Fri Nov 01, 2024 11:43 pm Post subject: |
|
|
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 |
|
|
Zucca Moderator
Joined: 14 Jun 2007 Posts: 3776 Location: Rasi, Finland
|
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 :..
My gentoo installs: | init=/sbin/openrc-init
-systemd -logind -elogind seatd |
Quote: | I am NaN! I am a man! |
|
|
Back to top |
|
|
miket Guru
Joined: 28 Apr 2007 Posts: 497 Location: Gainesville, FL, USA
|
Posted: Wed Nov 13, 2024 6:31 am Post subject: |
|
|
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 |
|
|
logrusx Advocate
Joined: 22 Feb 2018 Posts: 2527
|
|
Back to top |
|
|
|