WordToWiki

When a migration to TWiki is planned, but many documents already exist in MS Word .doc format, the migration process can be a pain to do manually. Also casual contributers like to use their favorite text editor, which is in many cases MS Word. Several plugins have attempted to overcome this problem, the most well-known is TWiki:Plugins.MsOfficeAttachmentsAsHTMLPlugin. However, in this way the documents are not editable in the wiki fashion, i.e. 'click-edit-save'.

Usage

1. User edits Word file
2. User saves Word file for future reference
3. User clicks Alt+F8 or Tools-Macros > Word2TWiki
4. Text in Word file is converted to TWikiML, and is copied to the clipboard
5. Document is saved as filtered htm (additional document besides your previously saved word document)
6. Inline images are collected in folder ActiveDocumentPath\YourFileName_files
7. Explorer opens the images folder
8. User pastes data into TWiki and saves topic Ctrl + V or Edit -> Paste
9. User uploads all images from the folder. (Recommended: use TWiki:Plugins.BatchUploadPlugin to simply upload all the images as a zip file that gets unzipped by the plugin on the topic)

Add-On Installation Instructions

Note: Contrary to many TWiki Add Ons this is not installed on the server but is a macro to be installed in MS Word.

• Download the .BAS file (see attachments)
• Launch Microsoft Word, go to Tools | Macro | Visual Basic Editor (Alt+F11)
• right mouse button on the Normal project (within the Project Explorer window - if you don't see that window, go View | Project Explorer (Ctrl-R), do an Insert | Module
• Use context menu or File menu to select Import file... and pick the downloaded .BAS file.
• go File | Save Normal, then File | Close and Return to Microsoft Word

Please note that from version 1.400, this macro requires MS Excel in order to handle merged table cells. Since most people/corporations who own Word also own Excel, this decision was believed to be acceptable. If you do not own MS Excel but do want to use this macro, replace the ConvertTable() subfunction with the function in version 1.310 (the Add On will then fail on encountering tables with merged cells).

For updates go to

http://twiki.org/cgi-bin/view/Plugins/MsWordToTWikiMLAddOn

-- DamienMakarewicz - 09 Oct 2008