Asciidoctor :: Discussion

Is there any software for local asciidoc wiki?

_‹ Previous Topic Next Topic _›

Classic

List

Threaded

11 messages Options

egalitarian

Is there any software for local asciidoc wiki?

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?

David Jencks

Re: Is there any software for local asciidoc wiki?

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

On Jul 27, 2020, at 9:46 PM, egalitarian [via Asciidoctor :: Discussion] <[hidden email]> wrote:

* I may edit pages in a dedicated text editor or in a wiki software.
* I may want to browse files as I can on zim desktop wiki because I don't necessarily want to maintain index page. A list of files and directories is itself an index.
* I want to start in a top-level directory as you can with gollum wiki.

AsciidocFX, atom, and other IDEs don't really set top-level directory.
I don't think they support hyperlinks on a wiki page.

Chrome asciidocfx extension is quite nice for a desktop wiki, but it doesn't set top-level directory, and it is a privacy risk.

Can anyone recommend a local asciidoc wiki software?

If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/Is-there-any-software-for-local-asciidoc-wiki-tp8112.html

To start a new topic under Asciidoctor :: Discussion, [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

egalitarian

Re: Is there any software for local asciidoc wiki?

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.

Alexander Schwartz

Re: Is there any software for local asciidoc wiki?

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:

Integration of Git
The "document root" would be the folder that you open (usually also the Git root)
AsciiDoc viewer - either source code only, side-by-side preview, or only preview.

(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

egalitarian

Re: Is there any software for local asciidoc wiki?

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.

egalitarian

Re: Is there any software for local asciidoc wiki?

In reply to this post by egalitarian

Is there a minimalist web server that displays folder contents and renders asciidoc on the fly?

danyill

Re: Is there any software for local asciidoc wiki?

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?

If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/Is-there-any-software-for-local-asciidoc-wiki-tp8112p8143.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

Private or confidential message? Public Key available here:

egalitarian

Re: Is there any software for local asciidoc wiki?

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.

danyill

Re: Is there any software for local asciidoc wiki?

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.

David Jencks

Re: Is there any software for local asciidoc wiki?

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?

On Aug 5, 2020, at 2:46 PM, danyill [via Asciidoctor :: Discussion] <[hidden email]> wrote:

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.

If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/Is-there-any-software-for-local-asciidoc-wiki-tp8112p8147.html

To start a new topic under Asciidoctor :: Discussion, [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

egalitarian

Re: Is there any software for local asciidoc wiki?

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.