What is convtags
----------------

convtags is a bidirectional converter:
  DokuWiki => AsciiDoc => Dokuwiki
  
Written with portability in mind, it should work on any UNIX® like operating
system.

Target use cases
----------------

_ Convert a wiki powered by DokuWiki to a static website
_ Ease the translation of a wiki powered by DokuWiki

Warning: the conversion from AsciiDoc to DokuWiki is only provided to convert
back a document previously converted from DokuWiki to AsciiDoc. It can handle
only a small subset of the AsciiDoc constructs, i.e. those that have a
matching equivalent in DokuWiki.

Installation
------------

Manual installation:

_ Download the program convtags and the md5 hash file convtags.md5
_ Check the integity of convtags using convtags.md5. This command:
    md5sum -c convtags
  should return:
    OK
_ Ensure that convtags be executable and owned by root:
    chown root:root convtags; chmod 755 convtags
_ Move convtags in a suitable location, preferably /usr/bin:
    mv convtags /usr/bin

Dependencies
------------

convtags has no hard dependency beyond a shell and some usual utilities
found in all UNIX-like systems, mainly sed.

AsciiDoc is an obvious soft dependency.

Usage
-----

After installation, type:
  convtags
to get information on usage, settings, configuration and support.