Is there any software for local asciidoc wiki?

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
11 messages Options
Reply | Threaded
Open this post in threaded view
|

Is there any software for local asciidoc wiki?

egalitarian
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?
Reply | Threaded
Open this post in threaded view
|

Re: Is there any software for local asciidoc wiki?

David Jencks
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

Reply | Threaded
Open this post in threaded view
|

Re: Is there any software for local asciidoc wiki?

egalitarian
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.
Reply | Threaded
Open this post in threaded view
|

Re: Is there any software for local asciidoc wiki?

Alexander Schwartz
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
Reply | Threaded
Open this post in threaded view
|

Re: Is there any software for local asciidoc wiki?

egalitarian
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.
Reply | Threaded
Open this post in threaded view
|

Re: Is there any software for local asciidoc wiki?

egalitarian
In reply to this post by egalitarian
Is there a minimalist web server that displays folder contents and renders asciidoc on the fly?
Reply | Threaded
Open this post in threaded view
|

Re: Is there any software for local asciidoc wiki?

danyill

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

Reply | Threaded
Open this post in threaded view
|

Re: Is there any software for local asciidoc wiki?

egalitarian
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.
Reply | Threaded
Open this post in threaded view
|

Re: Is there any software for local asciidoc wiki?

danyill
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.
Reply | Threaded
Open this post in threaded view
|

Re: Is there any software for local asciidoc wiki?

David Jencks
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

Reply | Threaded
Open this post in threaded view
|

Re: Is there any software for local asciidoc wiki?

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