INTRO
=====

Convert Microsoft Word document content to MediaWiki markup.

This is a Word Visual Basic macro. Usage requires a running copy of Microsoft Word that supports Visual Basic macros. (Word 97 or greater).
Features

    * Replaces smart quotes/double-quotes with dumb equivalents
    * Escapes the following characters: * # { } [ ] ~ ^^ | '
    * Converts external hyperlinks
    * Converts H1-H5 headings
    * Converts bold/italic/underline/strikethrough/superscript/subscript formatting
    * Converts bulleted/numbered lists

CAVEATS
=======

    * No guarantees, no official support, just like the DokuWiki itself (or Word =} )
    * No in-document hyperlink conversion (so make Wiki links yourself after pasting)
    * May not work well with documents that have highly customized styles/templates. It works best with documents written in the default "Normal" template
    * Image/graphics/figures are not supported.

INSTALLATION
============

   1. Make sure you've got the Word2DokuWiki.bas file from the zip archive
   2. Start Word
   3. Bring up the Visual Basic Editor (Tools->Macro->Visual Basic Editor or Alt+F11).
   4. From the VBE, import the macro library (File->Import File...) and select the file you downloaded.

USAGE
=====

   1. Open a word document to convert
   2. Run the Word2DokuWiki macro by bringing up the Macros dialog (Tools->Macro->Macros… or Alt+F8), selecting Word2DokuWiki and clicking Run.
   3. The macro converts the document to DokuWiki markup and places a copy of the content on the system clipboard.
   4. Switch to a DokuWiki editor page (or new page) and paste the result in.
   
ATTRIBUTION
===========

I did not come up with this macro, though I was looking to make something similar. The actual coding was done by http://infpro.com/projekte/wordwiki/ . Thank them for the fact you're using this. I only trivially hacked the functions to work with the slight differences inherent in DokuWiki formatting. And I rarely use Word. =}

A similar macro is available for converting OpenOffice documents to DokuWiki format at :
http://homepages.paradise.net.nz/hillview/OOo/

I don't foresee any problems or need for this macro to be enhanced, but if you need to get a hold of me, the best way is by leaving a comment on my blog Across Weirdish Wild Space @ http://www.wakatara.com/blog/

Enjoy !
Daryl Manning

THANKS
======

And a special thanks to the creator and community surrounding DokuWiki.
