Contributed by TWIKI.NET


The ConfluenceToTWikiAddOn helps to convert the Confluence Wiki Site into TWiki Wiki Site. It converts Confluence workspaces into the TWiki webs. It converts the Confluence Pages and News articles into the TWiki topics into the respective TWiki webs.

Features/What is converted? What is not converted?

  • Please note that - the tool depends on RPC-XMLRPC ( http://CONFLUNECE_URL/rpc/xmlrpc/) service, the tool works only when the service is up/running.
  • Converts regular wiki markups including table of content - {toc} to appropriate syntax in TWiki
  • Confluence tables are converted to TWiki tables.
  • Confluence spaces are converted to TWiki webs. If webs have spaces/special characters, those are converted into the "_" characters. If Confluence have spaces called "Main", "TWiki", "Sandbox" - those webs are converted into ConfluenceMain, ConfluenceTWiki, ConfluenceSanbox, respectively.

  • The comments on Confluence pages/news are also added into the TWiki topics.
  • The Pages/News are converted into the topics; if any name/news has special characters/spaces, they are replaced with "_" (underscore).
  • Does not carry the complete history meta-data in current version.
  • The attachments of Pages/News from the confluence are attached to the respective topics in TWiki.

The tool will be improved over time to handle more syntax conversions.

How does it Work?

  • The tool depends on the RPC-XMLRPC service installed with Confluence to fetch the data from Confluence.
  • The tool use the Perl Modules/Open Source Libraries developed to convert the XML data to TWiki topics.
  • The tool use the TWiki's to create the corresponding TWiki webs and topics, and to attach the attachments.
  • The tool is command line interface, is expected to run on the server where TWiki is already installed. If you have not installed TWiki please consult the installation documents at or contact TWIKI.NET ( which can provide you with services related to TWiki including the installation of the TWiki.

Add-On Installation and Usage Instructions

Note: You do not need to install anything on the browser to use this add-on. The following instructions are for the administrator who installs the add-on on the server where TWiki is running.

  1. Download the ZIP file from the Add-on Home (see below)
  2. Content of the zip file:
File: Description:
data/TWiki/ConfluenceToTWikiAddOn.txt Add-on topic
pub/TWiki/ConfluenceToTWikiAddOn/ Add-on topic, attachment(logo)
src/ command line tool
xml/ this directory is used to download the data from Confluence, store zip files before converting the data into TWiki
lib/ holds the libraries/code required to do processing
conf/ConfluenceConf.conf for adding information regarding confluence
conf/ConvertorConfig.conf for adding information about TWiki
lib/ This is work form Confluence community-thanks to the Confluence community
lib/WikiText and lib/ This is actually part of CPAN's WikiText module. Thanks to Ingy dot Net for creating wonderful module
readme.txt has help information
Pre-requisites.txt describes the prerequisites
  1. Unzip into any directory where root/admin user of the system has write permission.
    • Why root/admin user? - You need to have write permission in {TWIKI_ROOT} directory for creating webs/topics, have write permission into the TWiki's working area.
  2. copy data/TWiki/ConfluenceToTWikiAddOn.txt, pub/TWiki/ConfluenceToTWikiAddOn/twikinet145x66d-t.gif into respective areas of your TWiki installation, this can be used as help document for this converter.
  3. Edit the configuration files called ConfluenceConfig.conf and ConverterConfig.conf
  4. Run the command line tool, for example:
    perl -I ../lib -I /var/www/twiki/lib

Modification of ConfluenceConfig.conf File

  • Specify ServerURL - example :
  • Specify User - example:
    You can specify any user who has administration level access to Confluence Wiki.
  • Specify Password You need to write the password, make sure to destroy once you are done with the conversion.

Modification of ConverterConfig.conf File

  • Specify LogFile example
    This can be useful when you face issues, will be useful while debugging.
  • Specify Debug example
  • Specify User Example
    This is TWiki Admin user - yes we have admin user for TWiki 4.2.0 and onwords...
  • Specify Password - You need to write the password, make sure to destroy once you are done with the conversion.
  • Specify ApacheGroup example
    The topics ownership is changed to this user/group.
  • Specify TwikiPath example
    This is TWiki installation root.

Add-On Info

  • Set SHORTDESCRIPTION = Convert a Confluence wiki site into a TWiki site

Add-on Author: TWiki:Main.MainSopanShewale
Copyright: 2008, TWIKI.NET, Inc.
License: GPL (GNU General Public License)
Add-on Version: 06 Aug 2008 (V1.000)
Change History:
06 Aug 2008: Initial version
TWiki Dependency: $TWiki::Plugins::VERSION 1.2 (TWiki 4.2)
CPAN Dependencies: CPAN:Log::Log4perl, CPAN:HTTP::Lite, CPAN:RPC::XML, CPAN:Error, CPAN:XML::LibXML, CPAN:XML::LibXML::Common, CPAN:Algorithm::Diff, CPAN:XMLRPC::Lite, CPAN:Getopt::Std, CPAN:Cwd, CPAN:Archive::Extract, CPAN:Archive::Zip
Other Dependencies: Confluence 2.8.1 - with working RPC-XMLRPC services
Perl Version: 5.8.8
Add-on Home:

Related Topic: TWikiAddOns

-- SopanShewale - 05 Aug 2008

Topic attachments
I Attachment History Action Size Date Who Comment
GIFgif twikinet145x66d-t.gif r1 manage 3.5 K 2008-08-05 - 04:22 TWikiAdminUser TWIKI.NET LOGO
Edit | Attach | Watch | Print version | History: r1 | Backlinks | Raw View | WYSIWYG | More topic actions
Topic revision: r1 - 2008-08-05 - TWikiAdminUser
    • Cern Search Icon Cern Search
    • TWiki Search Icon TWiki Search
    • Google Search Icon Google Search

    TWiki All webs login

This site is powered by the TWiki collaboration platform Powered by PerlCopyright & 2008-2023 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
or Ideas, requests, problems regarding TWiki? use Discourse or Send feedback
Note: Please contribute updates to this topic on at TWiki:TWiki.ConfluenceToTWikiAddOn