EtherpadInclusion

Summary: This recipe describes a way how to include data stored in collaborative documents in Etherpad-Lite via IncludeXML into PmWiki.
Version: 2011-12-28
Prerequisites: Etherpad-Lite, PmWiki > 2.2.17 with XMLInclude, GuiEdit
Status: experimental
Maintainer:Vittorio Muth
Categories: Editing, Publishing

Questions answered by this recipe

How do I include (not: import) content created in Etherpad-Lite dynamically into PmWiki?

Description

This recipe explains how to connect Etherpad-Lite and PmWiki. Etherpad-Lite is used as an additional external editor to the standard editor of PmWiki.

Installation

  1. Download and install etherpad-lite from http://etherpad.org or https://github.com/Pita/etherpad-lite
  2. In your local instance of etherpad-lite backup the file etherpad-lite/node/utils/ExportHtml.js
  3. Download a modified version of http://pragm.ath.cx/twwiki/etherpad/ExportHtml.js which produces restricted, "well formed" and so readable HTML for IncludeXML).
  4. Move the downloaded file to etherpad-lite/node/utils/
  5. Download http://pragm.ath.cx/twwiki/xml/etherpad2wiki.xsl, for recipe IncludeXML
  6. Upload etherpad2wiki.xsl into your wiki (e.g. group "Main")
  7. In config.php add a button for recipe GuiEdit which creates the MarkUp for simple inclusion of an Etherpad-Lite document
     $GUIButtons ['ethxmlincl']      = array($ArrayCount++, 
    "(:includexml xml='", "' xsl='http://MyWiki/Main.etherpad2wiki.xsl':)", 
    '$[[http://MyEtherpad:9001/r/ro.XYZ]', | '$GUIButtonDirUrlFmt/ethxml.gif"$[Include Etherpad Document]]"'); 
  8. Download this icon Include Etherpad-Lite document to PmWiki/pub/MyGuiEdit/ethxml.gif
  9. In the wiki pages Site.EditForm or Site.PageActions create a link to etherpad-lite:
    %newwin%[[http://MyEtherpad:9001/p/{*$FullName}| Etherpad:{*$FullName}]]

Usage in PmWiki

  1. Create a new wiki page (e.g. "MyWikiGroup.MyNewPage").
  2. In PmWiki's standard editor click on the (new) link "Etherpad:MyWikiGroup.MyNewPage".
  3. Etherpad starts in a new window and opens a wikipad named "MyWikiGroup.MyNewPage"
  4. In etherpad, create your content.
  5. In etherpad's upper right menu icon "eye" get the URL for the read only version of "MyWikiGroup.MyNewPage". Its name is for example http://MyEtherpad:9001/r/ro.XdrZciLp
  6. In PmWiki's standard editor, click on the new icon Include Etherpad-Lite document. This creates prepared MarkUp:
    (:includexml xml='http://MyEtherpad:9001/r/ro.XYZ' xsl='http://MyWiki/pmwiki/Main/uploads/etherpad2wiki.xsl':)
  7. Exchange "XYZ" with "XdrZciLp" - the read only version of "MyWikiGroup.MyNewPage".

Notes

  • For Linux Ubuntu:OK
  • For Windows: ?

See Also

Contributors

Comments

See discussion at EtherpadInclusion-Talk

User notes? : If you use, used or reviewed this recipe, you can add your name. These statistics appear in the Cookbook listings and will help newcomers browsing through the wiki.