This post was updated on .
* I may edit pages in a dedicated text editor or in a wiki software.
* I may want to browse files as I can on typora because I don't necessarily want to maintain index page. A list of files and directories is itself an index. * I want to set document root as you can with gollum wiki. AsciidocFX, atom, and other IDEs don't really allow me to set document root. I don't think they support hyperlinks on a wiki page. Chrome asciidoc extension is quite nice for a desktop wiki, but it doesn't set document root, and it is a privacy risk. Can anyone recommend a local asciidoc wiki software? |
It’s definitely not a wiki, but I’d consider an Antora site.
My experience of wikis other than wikipedia is that they start off with good intentions and quickly decay into meaningless spaghetti. I find that the Antora structure helps keep the spaghetti nature of information a bit under control :-) I’ve written an extension that lets you set up “index pages” listing the results of querying the Antora content catalog, so it’s pretty easy to have such a page maintenance-free. Unfortunately it doesn’t currently work in Antora nav files. asciidoctor-antora-indexer Thanks David Jencks
|
A static site generator such as antora is not suitable for my use case.
I can be satisfied by a local asciidoc viewer that is aware of its own document root. Something like typora for asciidoc would be cool. |
I looked at the typora website and having a preview in the editor looks really cool.
The two requirements of "local asciidoc viewer that is aware of its own document root" might be covered by IntelliJ [community or ultimate edition] + the AsciiDoc plugin. Editing has to be done in a text editor with syntax highlighting. Preview is separate. What you'll get:
(I'll probably be biased as the current maintainer of the plugin) https://intellij-asciidoc-plugin.ahus1.de/
Alexander Schwartz (alexander.schwartz@gmx.net)
https://www.ahus1.de |
While I like the plugin, I wouldn't use IntelliJ for a local asciidoc wiki. IntelliJ is a big IDE. I want a reasonably minimal software.
|
In reply to this post by egalitarian
Is there a minimalist web server that displays folder contents and renders asciidoc on the fly?
|
Does
https://github.com/gollum/gollum do what you're looking for? See also
https://github.com/gollum/gollum/wiki/Screenshots On Wed, Aug 5, 2020 at 3:56 PM egalitarian [via Asciidoctor :: Discussion] <[hidden email]> wrote: Is there a minimalist web server that displays folder contents and renders asciidoc on the fly? |
Gollum wiki is almost what I want, but I don't want to commit every change.
I just want to view my asciidoc notes as if it were a wiki. I don't like to commit changes to my notes. I like them as plain files in plain folders. |
Sure, others have requested the same thing in Gollum:
https://github.com/gollum/gollum/issues/1031
I can't think of another tool which does this. For viewing Firefox, Chrome and possibly Safari have an extension for viewing which could be used from the local filesystem but that doesn't support editing. |
My guess is what you want is too simple :-) I think you could write something in node using ‘http’ and asciidoctor.js that would display folders and rendered asciidoc in less than 100 lines of code. I don’t know how you’d do in-browser editing, is that one of your requirements?
|
This post was updated on .
I do not require in-browser editing. I use emacs and vim as my main editors. If I utilized asciidoctor executable, I could write a local asciidoc viewer with its own document root in clojure, clojurescript on node, haskell, janet, or some other language.
|
Free forum by Nabble | Edit this page |