Differences

This shows you the differences between two versions of the page.

--- internal_link2 [2009/08/03 08:50] – removed clare
+++ internal_link2 [2025/09/19 15:18] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
+====== Convert HTML to DokuWiki ======
+An idea for converting existing documents to text files with [[http://www.dokuwiki.org/tips:dokuwiki|DokuWiki]] [[http://www.dokuwiki.org/tips:syntax|syntax]] using an HTML to Text converter. I've set up a config file for the tool available at [[http://www.mbayer.de/html2text/|http://www.mbayer.de/html2text/]] which produces some usable results: [[http://www.dokuwiki.org/_media/wiki:text2html.rc|text2html.rc]].
+Thomas J. Messenger made a Perl module to convert HTML to DokuWiki's syntax available at [[http://www.citlink.net/%7Emessengertj/|http://www.citlink.net/~messengertj/]] (see [[http://bugs.splitbrain.org/index.php?do=details&amp;task_id=81|81]], too)
+Or the one at CPAN: [[http://search.cpan.org/%7Ediberri/HTML-WikiConverter-0.61/lib/HTML/WikiConverter.pm|http://search.cpan.org/~diberri/HTML-WikiConverter-0.61/lib/HTML/WikiConverter.pm]]
+A web interface used to convert pasted text or a webpage page is available at [[http://diberri.dyndns.org/html2wiki.html|http://diberri.dyndns.org/html2wiki.html]]
+A Converter Tool (HTML>DokuWiki, UTF8, Tablespacing) [[http://runtime-basic.net/Projekt:WikiTool|WikiTool]]
+===== Html2DokuWiki Converter GUI for Win32 =====
+Html2DokuWiki is a free HTML to DokuWiki converter for Win32 platforms. It is very simple to install and extremely easy to use. Just extract the executable from the archive, double-click to start, and Html2DokuWiki is ready to go.
+To start converting, just type HTML into the upper edit. The converted DokuWiki syntax will immediately appear in the lower edit. Then select (''CTRL+A'') the converted document and copy / paste it into any DokuWiki site. Larger HTML documents can also be pasted into the HTML input.
+[[http://www.yunqa.de/delphi/downloads/Html2DokuWiki.zip|Click here to download Html2DokuWiki]].
+**Supported** **HTML** **Elements**
+[[http://www.dokuwiki.org/lib/exe/fetch.php?cache=nocache&amp;media=http%3A%2F%2Fwww.yunqa.de%2Fsoftware%2FHtml2DokuWiki.png|{{ Convert%20HTML%20to%20DokuWiki_files:image002.gif?250x208|Html2DokuWiki}}]]Html2DokuWiki converts all HTML elements currently supported by DokuWiki:
+  * **<A>** → links, outputs multiple links for formatting
+  * **<B>** → ''%%**%%''
+  * **<BLOCKQUOTE>** → ''>'', including nested quotes
+  * **<BR>** → new line ''\\''
+  * **%%<CODE>%%** → ''%%''%%''
+  * **<DEL>** → ''<del>''
+  * **<DL>, <DT>, and <DD>** → Simulate output as simple unnumbered lists with ''<DT>'' as bold.
+  * **<H1>** … **<H5>** → ''%%======%%'' to ''%%==%%''
+  * **<I>** → ''%%//%%''
+  * **<IMG>** → images
+  * **<LI>** → list items, including nested lists
+  * **<OL>** → numbered lists
+  * **<P>** → new paragraph
+  * **<PRE>** → ''%%<code>%%''
+  * **<S>** → ''%%**%%''
+  * **<STRIKE>** → ''%%//%%''
+  * **<STRONG>** → ''%%**%%''
+  * **%%<SUB>%%** → ''%%<sub>%%''
+  * **%%<SUP>%%** → ''%%<sup>%%''
+  * **<TABLE>** → tables
+  * **<TBODY>** → recognized, but not output
+  * **<TD>** → table cell, with ''align'' and ''colspan'' support
+  * **<TFOOT>** → recognized, but not output
+  * **<TH>** → table header cell, with ''align'' and ''colspan'' support
+  * **<THEAD>** → recognized, but not output
+  * **<TR>** → table row, with ''align'' support
+  * **<TT>** → to ''%%''%%''
+  * **<U>** → to ''%%__%%''
+**Special Features**
+  * Internal links are converted to DokuWiki's '':'' style, external ones are left unchanged. ''mailto'''':'' is removed from e-mail links.
+  * Support for alignment in table cells and rows.
+  * Image properties are converted, including alignment, width, and height.
+  * Formatting is only applied where accepted by DokuWiki, but not to ''%%===%% … ==='' and ''%%<code>%% … </code>'', for example.
+  * Full Unicode support, with optional UTF-8 input or output encoding.
+  * Option to hide links from DokuWiki syntax.
+**Author, Contact, and Development**
+Html2DokuWiki is developed by Ralf Junker. You can contact the author via the [[http://www.freelists.org/list/yunqa|Yunqa]][[http://www.freelists.org/list/yunqa| mailing list]]. Feel free to report praise, bugs, or suggestions about Html2DokuWiki.
+The converter might also be available as a software library %%(*%%.DLL, *.DCU, or Delphi source code). Please get in touch if interested.
+**Version History**
+-08-27
+  * Add inline formatting to table cells.
+  * New UTF-8 input encoding.
+  * Fix paragraph problems with alternating inline-tags and block-tags.
+  * Do not escape ''%%//%%'' to ''<nowiki>%%</nowiki>%%//%%<nowiki>%%</nowiki>'' if part of an external URI.
+  * Escape ''<nowiki>%%</nowiki>'' to ''<nowiki>%%<nowiki>''.
+  * Empty heading elements separate paragraphs.
+-10-22
+  * New: Support for ''<DL>'', ''<DT>'', and ''<DD>''. Simulate output as simple unnumbered lists with ''<DT>'' as bold.
+  * Improve: Empty paragraph inserts line break.
+  * Improve: Recognize DokuWiki internal escapes ''<nowiki>%%</nowiki>'', ''<nowiki>'', and ''</nowiki>'' and escape them properly.
+  * Improve: Escape table markup (''%%|%%'' and ''%%^%%'') when inside a table.
+  * Improve: Escape double parenthesis ''%%((%%'', which starts a DokuWiki footnote.
+  * Improve: Suppress DokuWiki escapes and typography in ''<PRE>'' blocks.
+  * Fix: Newline output for HTML like ''<P><PRE>one</PRE>two</P><BR>three''.
+  * Fix: ''<TBODY>'' table problem where a new row did not ouput a linebreak.
+===== Workflow Microsoft Word 2 DokuWiki using html2wiki-GUI =====
+I was looking for a way to convert about 150 DOC-files (Microsoft Word2000 or 2003) in our new wiki without too much hazzle. The macros available didn´t work for me.
+**Specifications**
+  * usable for multiple files
+  * converting tables
+  * converting images
+**suggested** **workflow** (not used excessively yet)
+  - open word-document in OpenOffice
+  - save as html (the pictures will be stored in the same folder as the html)
+  - open html2dokuwiki plugin[[http://www.yunqa.de/delphi/downloads/Html2DokuWiki.zip|Click]] here to download Html2DokuWiki
+  - [[http://www.yunqa.de/delphi/downloads/Html2DokuWiki.zip|paste and copy html-code in the ]][[http://www.yunqa.de/delphi/downloads/Html2DokuWiki.zip|GUI]]
+  - [[http://www.yunqa.de/delphi/downloads/Html2DokuWiki.zip|save as txt-file (or create new page for integrity)]]
+  - [[http://www.yunqa.de/delphi/downloads/Html2DokuWiki.zip|copy txt-file in the DATA/PAGES/NAMESPACE-folder and Pictures in the DATA/MEDIA/NAMESPACE-folder]]
+[[http://www.yunqa.de/delphi/downloads/Html2DokuWiki.zip|Is there a faster way (2009/07/18 by ]][[http://www.yunqa.de/delphi/downloads/Html2DokuWiki.zip|bobeck]][[http://www.yunqa.de/delphi/downloads/Html2DokuWiki.zip|)]]