Asciidoctor :: Discussion

Is there any software for local asciidoc wiki?

_‹ Previous Topic Next Topic _›

Classic

List

Threaded

11 messages Options

egalitarian

Jul 28, 2020; 4:46am

Is there any software for local asciidoc wiki?

This post was updated on Jul 28, 2020; 5:26am.

CONTENTS DELETED

The author has deleted this message.

David Jencks

Jul 28, 2020; 6:49am

Re: Is there any software for local asciidoc wiki?

68 posts

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

... [show rest of quote]

egalitarian

Jul 28, 2020; 12:19pm

Re: Is there any software for local asciidoc wiki?

CONTENTS DELETED

The author has deleted this message.

Alexander Schwartz

Jul 29, 2020; 5:34pm

Re: Is there any software for local asciidoc wiki?

48 posts

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

Jul 30, 2020; 10:26am

Re: Is there any software for local asciidoc wiki?

CONTENTS DELETED

The author has deleted this message.

egalitarian

Aug 05, 2020; 3:56am

Re: Is there any software for local asciidoc wiki?

In reply to this post by egalitarian

CONTENTS DELETED

The author has deleted this message.

danyill

Aug 05, 2020; 5:32am

Re: Is there any software for local asciidoc wiki?

7 posts

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

Aug 05, 2020; 10:45am

Re: Is there any software for local asciidoc wiki?

CONTENTS DELETED

The author has deleted this message.

danyill

Aug 05, 2020; 9:46pm

Re: Is there any software for local asciidoc wiki?

7 posts

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

Aug 06, 2020; 2:04am

Re: Is there any software for local asciidoc wiki?

68 posts

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

Aug 06, 2020; 6:18am

Re: Is there any software for local asciidoc wiki?

This post was updated on Aug 06, 2020; 7:25am.

CONTENTS DELETED

The author has deleted this message.