Extension:Word2MediaWikiPlus/old project page

'''THIS IS THE OLD PROJECT PAGE FOR THE Word2MediaWikiPlus EXTENSION.

PLEASE DON'T ADD CONTENT HERE.'''

About Word2MediaWikiPlus Converter
This Word Visual Basic macro converts Microsoft Word document content to MediaWiki markup.

Usage requires a running copy of Microsoft Word that supports Visual Basic macros (Word 2000 to 2003).

Ideas and bug reports please on the discussion page.

Example files of not so good working documents: please send to my eMail.

contact e-Mail: see quickinfo

This mail address changes regularly due to spam mailings.

Word2MediaWikiPlus: Download code (installer) here.

Version 0.6e (Nov. 23, 2006)

Demonstration
See a demonstration! that no longer works.

Features
converts:
 * Normal Text with formats and colors
 * Headings (Level 1 to 5)
 * Tables (also nested tables)
 * Hyperlinks
 * Lists (bulleted/numbered lists)
 * Page headers and footers
 * Footnotes
 * Images (extract and upload to wiki)
 * localized for German and English

Roadmap
Version 0.7
 * Image extraction without Photo Editor (html-export)

Version 0.8

FAQ - Frequently Asked Questions

 * I do not have the Microsoft Photo Editor. What can I do?
 * Not a problem any more. Use Version 0.7 or above.


 * When will be the next release?
 * (Un)fortunately I do have a life. Thus it is impossible to say. Whenever I find time to program.


 * I found a bug!
 * Please send me the file with a short description or use the discussion page.


 * I want to contribute code
 * Small extensions please into the discussion page. Big ones by mail.

Documentation / usage
see Extension:Word2MediaWikiPlus/Documentation

Office 2000 to 2002

 * MS-Word 2000 and 2002, German or English
 * MediaWiki 1.5.3 and 1.6.5, German or English
 * Microsoft Photo Editor, German or English
 * Windows XP (without admin rights)


 * The macro has numerous CONST which can to be customized to your language and MediaWiki. You will find information in the inline documentation of the macro.
 * Most settings are done with config dialogs and stored in the registry.

Office 2003
Office 2003 works in German and English
 * Use the HTML-Export functionality coming with Version 0.7 (no need for MS Photo Editor)

Office 2007
The macro does not work with office 2007. Since MS does not give away trial versions anymore, I am not able to program a workaround.

The macro will hang in an endless loop, because of a word bug, which you may try on their online demo:


 * Make a new page
 * Make about five empty paragraphs (hit enter 5 times)
 * Insert one tab in the third paragraph (not an indention!)
 * Search for the tab (Ctrl+F) with the string '^p^t^p'
 * If it finds the string, replace it with '^p^p'
 * Watch how word tries endless.

Example Screenshot

If you are a bit patient you will get an out of memory error after some time (online system, not your pc).

Or try this macro on Office 2007

Sub WordBug Selection.TypeParagraph Selection.TypeParagraph Selection.TypeParagraph Selection.TypeParagraph Selection.TypeParagraph Selection.TypeParagraph Selection.MoveUp Unit:=wdLine, Count:=4 Selection.TypeText Text:=vbTab Selection.MoveDown Unit:=wdLine, Count:=2 Selection.TypeText Text:=vbTab Selection.HomeKey Unit:=wdStory Selection.Find.ClearFormatting Selection.Find.Replacement.ClearFormatting With Selection.Find .Text = "^p^t^p" .Replacement.Text = "^p^p" .Forward = True .Wrap = wdFindContinue .Format = False .MatchCase = False .MatchWholeWord = False .MatchWildcards = False .MatchSoundsLike = False .MatchAllWordForms = False End With Selection.Find.Execute Replace:=wdReplaceAll End Sub

Known Bugs

 * The macro uses the SendKeys command. It is a known issue, that the num lock flashes and eventually turns itself off.

Requirements

 * Microsoft Windows (Word Mac does not work)
 * MS-Word 2000 to 2003 (german or english version, other languages could work with HTML-Export, please give feedback)
 * MediaWiki (1.5+ have been tested)
 * Windows XP (without admin rights)
 * MS Internet Explorer or Firefox 2.0
 * For image conversion: MS PowerPoint
 * Old image conversion routine in V0.6d: Microsoft Photo Editor

Download

 * Download macro installer and demo document (zip-file, ~500 KB)

These zip-files can be unzipped by Windows XP or almost any packer software.

Note: You might get a virus warning. Some virus scanners give a virus warning to all word documents, that contain macros. And yes, if somebody alters the macro and changes the download address, the macro can mess up your system. Download is safe if downloaded from www.beadsoft.de or www.beadsoft.net (if this text has not been altered).

Automatic process
In the download you find a word document with an installer.

Manual Process

 * 1) Start MS-Word
 * 2) Open the Installer (Word2MediaWikiPlus_Installer.doc), Demo document works as well
 * 3) Go into Macro organize
 * 4) * (see http://office.microsoft.com/en-us/assistance/HP030816741033.aspx for instructions on how to load and use Macro organize)
 * 5) Copy all modules to your normal.dot project
 * 6) * frmW2MWP_Config
 * 7) * frmW2MWP_Doc_Config
 * 8) * frmW2MWP_UploadImages
 * 9) * modW2MWP_FileDialog
 * 10) * modW2MWP_Registry
 * 11) * Word2MediaWikiPlus
 * 12) * Word2MediaWikiPlusGlobal
 * 13) create a symbol on your symbol bar for easy access: connect to macro: Normal.Word2MediaWikiPlus.Word2MediaWikiPlus
 * 14) create a symbol on your symbol bar for easy access: connect to macro: Normal.Word2MediaWikiPlus.Word2MediaWikiPlus_Config

Customizing
If you need to customize, look into the macro itself. It is well documented.

If you changed code, that may be helpful to others, so email me.

Translation
Need some help here. Would like to make it run on Italian and Swedish computers, too. Other languages highly welcome.

Credits

 * The first version of this converter seems from Swythan at TikiWiki
 * A slightly modified version is Word2Wiki from InfPro IT-Solutions.
 * By now each function has been completely reprogrammed.
 * For the numerous api descriptions I thank The KPD-Team.
 * And of course: A lot of work of me: Gunter Schmidt (eMail see above). Have a look at my website.

Version 0.7 Pre-Release Word2MediaWikiPlus
Released: November 12, 2006

This release now has export for Word 2003.

Note: There are still some bugs present and I will update fairly fast, so I do not bother with version numbers.


 * BugFix: Turn of hyphenation before converting
 * BugFix: lists in tables work now
 * BugFix: headers in tables work now
 * BugFix: fixed error with msoCanvas pictures
 * BugFix: fixed error Confic Dialog, did not find MS Photo Editor
 * Feature: Images will now be exported with html-converting (needed for Word 2003)
 * Feature: Images will now be copied to special upload directory when uploaded to wiki
 * Feature: Images will now be saved in separate folders for each document (HTML-Export only)
 * Feature: recognize "forced blanks" and replace with
 * Feature: converts form fields into text
 * Feature: comments are ignored
 * Feature: cell_justify switch implemented. Since MediaWiki will not support the justify tag, it is now removed. Search for "cell_justify".
 * Feature: numbered lists which use symbols will be converted to bullet lists
 * Changed: Replacement function now works with a range object, which is faster and more reliable
 * Changed: Replaced some SendKeys with SendMessage
 * Changed: FontFormat now uses more sizes then big and small
 * Changed: Category handling in Formular

Version 0.6 Word2MediaWikiPlus
Released: June 17, 2006

Changes:
 * Feature: Dialog for Article name and categories
 * Feature: Using registry to store user values
 * Feature: Installation routine (in separate document)
 * Feature: Converts footnotes
 * Feature: table width and alignment
 * Feature: framed and colored paragraphs
 * Feature: Icons of applications now will be saved separatly to prevent double uploading
 * Feature: User Headings based on the build in Headings will be correctly recognized
 * Feature: Word 2002 uses internal PNG copy function for better image extraction
 * Feature: Tables cells with dark background will get white font
 * Feature: Textboxes will be converted to framed tables
 * Feature: Added PreFix for Imagefiles
 * Feature: Manually numbered lists -> Word numbering will be used
 * Feature: Optional use SnagIt for converting screenshots
 * Changed: Manually created tab tables do not have a frame anymore
 * Changed: Const values for categories
 * Changed: Discontinued option to save to BMP and convert with MS Photo Editor. Now it will always paste in MS Photo Editor and then save the desired format.
 * Changed: Font size from big and small to font 1 to 7
 * Changed: Discontinued internal BMP conversion
 * BugFix: Formatting in tables, needed a workaround for a word bug
 * BugFix: Merged Cells did not work all the times

Version 0.6.b

 * Feature: Image Upload Dialog
 * Changed: User language will be detected
 * Changed: Macro remembers article name for the last document

Version 0.6.c
Released: Nov. 5, 2006
 * BugFix: Now allows converting without MS Photo Editor (without pictures)
 * BugFix: SearchPage did not work on systems that needed title =
 * BugFix: remembers last used system for upload (test / prod)
 * Changed: Image upload function now does not rely on vb components (Manfred Gerwing)
 * Changed: FontColor converter a bit faster (Hal Eden)

Version 0.6.d
Released: Nov. 11, 2006
 * BugFix: fixed error with msoCanvas pictures
 * BugFix: fixed error Confic Dialog, did not find MS Photo Editor

Version 0.6.e
Released: Nov. 23, 2006
 * Feature: French, Spanish, Dutch, (russian untested) added
 * Feature: litte advancements with the installation document (symbol bar handling)

Version 0.5 Word2MediaWikiPlus
Released: June 04, 2006

Changes:
 * BugFix: Macro crashed if Icon returned error
 * BugFix: FontSize could go into endless loop
 * BugFix: Escape characters did not work correctly, if document contained "*"
 * BugFix: some tables did not merge correctly
 * BugFix: superscript and subscript
 * BugFix: text colors in tables
 * BugFix: some bugs with combined format like colored and bold
 * BugFix: exclude hyperlinks that have targets within the document
 * Changed Upload function, customizing the keystrokes, use CheckWikiUpload to test
 * Changed Picture Export to Paste with MS Photo Editor (works a lot better)
 * Feature: Nested tables
 * Feature: CheckWikiUpload test
 * Feature: ImagePasteInEditor which works better (now we might go with Word97 again (but color problem remains)
 * Feature: "manual tables" conversion, converts tables that are made with tab stops
 * Feature: PageHeader and PageFooter (optional)
 * Feature: delete hidden text (optional)
 * Feature: Macro can be started from a special macro document (Name must include the term Word2MediaWikiPlus; must not include the term Demo)
 * no need for Default Paragraph Style anymore
 * localization for en and de, other languages can be added
 * code reorganisation and optimization
 * some minor changes and bugfixes

Version 0.4 Word2MediaWikiPlus
Changes:
 * images: added function to convert all images into .jpg or .png with Microsoft Photo Editor
 * images: added function to automaticall upload to your wiki
 * tables: tables with background colors
 * tables: tables with line breaks
 * tables: tables with merged cells
 * text: fixed bug with combined formats
 * text: added simple fontsize
 * text: added simple indention of paragraphs
 * general: wiki page display: When the macro is finished it will search for the document title in your wiki.
 * general: reorganised code
 * general: removed hourglass
 * general: styles localized
 * general: Word97 disabled with message

Version 0.3 Word2MediaWikiPlus
Released May 26, 2006.

Changes:
 * general: added some const to customize this
 * general: added hourglass and statustext
 * text: added text color
 * tables: added blank space in empty cells
 * tables: added alignment of text
 * tables: added tableformat string, const TableTemplate
 * hyperlinks: redesign: changed html and file-links, others will not be converted
 * images: added function to save all pictures of the document as .bmp and replace with Image-Tag
 * paragraph spacing: added manual line break and MediaWiki-like paragraphs
 * cleanup-function