Difference between revisions of "Html2Wiki"

From Freephile Wiki
Jump to navigation Jump to search
m (fix link)
(Remove feature)
 
(5 intermediate revisions by one other user not shown)
Line 1: Line 1:
 
__NOTOC__ __NOEDITSECTION__
 
__NOTOC__ __NOEDITSECTION__
{{Feature
+
<!-- {{Feature
 
|explains= Special:Html2Wiki
 
|explains= Special:Html2Wiki
|description=This extension to MediaWiki is used to import HTML content (including images) into the wiki.
+
|description=Convert  web pages, Google Docs, or entire websites (including images) to your wiki
 
|notes=Authored by [[User:Freephile|Greg Rundlett]]
 
|notes=Authored by [[User:Freephile|Greg Rundlett]]
 
|tests=Interesting test case: http://howtoreallypronouncegif.com/
 
|tests=Interesting test case: http://howtoreallypronouncegif.com/
 
|examples=
 
|examples=
}}
+
}} -->
 
This extension officially lives at [[mw:Extension:Html2Wiki]]
 
This extension officially lives at [[mw:Extension:Html2Wiki]]
  
We don't want to maintain another copy of the documentation here, but we may well host development ideas.
+
See the documentation there, since it is maintained with the software.
 +
 
 +
This site may host development ideas or interesting examples/demos.
 +
 
 +
== Other conversion tools ==
 +
Html2Wiki relies on <code>pandoc</code> to do format conversion.  Here are some other approaches to doing conversions.
 +
=== LibreOffice ===
 +
LibreOffice Writer can connect to a Wiki, and allow you to edit and save articles in the wiki.
 +
* Make sure your LibreOffice can export MediaWiki directly from any format that LibreOffice can read
 +
sudo apt-get install libreoffice-wiki-publisher
 +
With this library installed, you can now export documents straight out of LibreOffice.
 +
 
 +
=== Two-step conversion ===
 +
This isn't really better than using LibreOffice directly, but it is an option to at least compare the output (assuming direct export is giving a bad result)
 +
* Convert a doc to mediawiki by converting to HTML first, and then using <code>pandoc</code> to convert HTML to MediaWiki markup
 +
libreoffice --headless --convert-to html /tmp/awk.cheat.sheet.doc && \
 +
pandoc awk.cheat.sheet.html -o awk.cheat.sheet.mw -f html -t mediawiki
 +
 
 +
=== Online conversion ===
 +
https://devotter.com/converter is a webform interface to pandoc
 +
 
 +
Note: [[MediaWiki/Toolbox]] explains how we add a custom link to the "toolbox" element of this site.
 +
 
 +
# {{@todo}} [https://phabricator.wikimedia.org/project/board/1094/ Html2Wiki workboard]
 +
# {{@todo}} upgrade extension to work with new loading mechanism
 +
# {{@todo}} Create a service to import Google Docs to wiki
 +
# {{@todo}} Expand Html2Wiki to include anything that pandoc supports

Latest revision as of 17:06, 13 May 2020

This extension officially lives at mw:Extension:Html2Wiki

See the documentation there, since it is maintained with the software.

This site may host development ideas or interesting examples/demos.

Other conversion tools

Html2Wiki relies on pandoc to do format conversion. Here are some other approaches to doing conversions.

LibreOffice

LibreOffice Writer can connect to a Wiki, and allow you to edit and save articles in the wiki.

  • Make sure your LibreOffice can export MediaWiki directly from any format that LibreOffice can read
sudo apt-get install libreoffice-wiki-publisher

With this library installed, you can now export documents straight out of LibreOffice.

Two-step conversion

This isn't really better than using LibreOffice directly, but it is an option to at least compare the output (assuming direct export is giving a bad result)

  • Convert a doc to mediawiki by converting to HTML first, and then using pandoc to convert HTML to MediaWiki markup
libreoffice --headless --convert-to html /tmp/awk.cheat.sheet.doc && \
pandoc awk.cheat.sheet.html -o awk.cheat.sheet.mw -f html -t mediawiki

Online conversion

https://devotter.com/converter is a webform interface to pandoc

Note: MediaWiki/Toolbox explains how we add a custom link to the "toolbox" element of this site.

  1. Gedit.svg todo Html2Wiki workboard
  2. Gedit.svg todo upgrade extension to work with new loading mechanism
  3. Gedit.svg todo Create a service to import Google Docs to wiki
  4. Gedit.svg todo Expand Html2Wiki to include anything that pandoc supports