When comparing DokuWiki vs Asciidoctor, the Slant community recommends DokuWiki for most people. In the question“What are the best markup languages?” DokuWiki is ranked 7th while Asciidoctor is ranked 8th. The most important reason people chose DokuWiki is:
Licensed under GPL2.
Ranked in these QuestionsQuestion Ranking
Pro Free and open source
Licensed under GPL2.
Pro Easy to set up and mantain
To install you need a webserver running PHP 5.2 or later where you unpack the downloaded archive and navigate to install.php in your browser, fill out the necessary information required for the one-page installer and you are done.
Pro Plain-text file storage
Dokuwiki does not require a database, it stores everything in plain-text.
Pro Version control
Dokuwik offers unlimited page revisions.
Pro Good selection of plugins
DokuWiki offers over a thousand plugins to extend its functionality.
Pro Access control
DokuWiki has built-in ACL support.
Pro Runs on any PHP server
It requires a webserver running PHP 5.2 or later of any kind.
Pro Search functionality
DokuWiki allows searching through pages.
Pro A dedicated page for recent changes
A dedicated page to quickly note what has changed recently can be set up.
Pro Good selection of themes
DokuWiki offers over a hundred templates to change the visual appearance of the site.
Pro Standardized format
The formatting of Asciidoc is standardized so there is only one 'flavor' unlike in Markdown. The definitive user guide is here: http://asciidoctor.org/docs/asciidoc-writers-guide/
Pro Supported by GitHub
GitHub supports AsciiDoc syntax in repositories, wikis and gists (powered by Asciidoctor).
Simple, easy-to-read style similar to Markdown. Designed to be easy for a human to enter with a simple text editor, and easy to read in its raw form.
Pro Technical Documentation
The DocBook format which Asciidoctor can convert to was originally developed with the creation of computer books in mind and thus has a rich array of formatting options which are powerful enough to manage the formatting of lengthy technical books.
Con Lots of plugins to manage
DokuWiki is highly modular. Even thing like WYSIWYG editors and categories have to be added separately as plugins. This can quickly lead to managing lots of plugins.
Con Relies on Ruby Gem
Requires installation of the asciidoctor Ruby gem.
Con Not as popular/widely used as Markdown
The Asciidoc format is not as popular/widely used as Markdown. Notwithstanding the foregoing, Asciidoc is used for some of the following projects:
- O'Reilly and Maker Press
- NFJS, the magazine
- other examples: http://asciidoctor.org/docs/what-is-asciidoc/#who-s-using-asciidoc
Con Limited output options
Asciidoctor can only convert directly to HTML or DocBook. However, you can always use another converter such as pandoc to convert from one of the output formats to another format.