ikiwiki (3.20130711) unstable; urgency=low
[ikiwiki.git] / doc / forum / how_do_I_translate_a_TWiki_site.mdwn
1 [[!meta date="2006-12-19 09:56:21 +0000"]]
2
3 # Excellent - how do I translate a TWiki site?
4
5 I just discovered ikiwiki quite by chance, I was looking for a console/terminal
6 menu system and found pdmenu.  So pdmenu brought me to here and I've found ikiwiki!
7 It looks as if it's just what I've been wanting for a long time.  I wanted something
8 to create mostly text web pages which, as far as possible, have source which is human 
9 readable or at least in a standard format.  ikiwiki does this twice over by using 
10 markdown for the source and producing static HTML from it.
11
12 I'm currently using TWiki and have a fair number of pages in that format, does
13 anyone have any bright ideas for translating?  I can knock up awk scripts fairly
14 easily, perl is possible (but I'm not strong in perl).
15
16 > Let us know if you come up with something to transition from the other
17 > format. Another option would be writing a ikiwiki plugin to support the
18 > TWiki format. --[[Joey]]
19
20 > Jamey Sharp and I have a set of scripts in progress to convert other wikis to ikiwiki, including history, so that we can migrate a few of our wikis.  We already have support for migrating MoinMoin wikis to ikiwiki, including conversion of the entire history to Git.  We used this to convert the [XCB wiki](http://xcb.freedesktop.org/wiki/) to ikiwiki; until we finalize the conversion and put the new wiki in place of the old one, you can browse the converted result at <http://xcb.freedesktop.org/ikiwiki>.  We already plan to add support for TWiki (including history, since you can just run parsecvs on the TWiki RCS files to get Git), so that we can convert the [Portland State Aerospace Society wiki](http://psas.pdx.edu) (currently in Moin, but with much of its history in TWiki, and with many of its pages still in TWiki format using Jamey's TWiki format for MoinMoin).
21 >
22 > Our scripts convert by way of HTML, using portions of the source wiki's code to render as HTML (with some additional code to do things like translate MoinMoin's `\[[TableOfContents]]` to ikiwiki's `\[[!toc ]]`), and then using a modified [[!cpan HTML::WikiConverter]] to turn this into markdown and ikiwiki.  This produces quite satisfactory results, apart from things that don't have any markdown equivalent and thus remain HTML, such as tables and definition lists.  Conversion of the history occurs by first using another script we wrote to translate MoinMoin history to Git, then using our git-map script to map a transformation over the Git history.
23 >
24 > We will post the scripts as soon as we have them complete enough to convert our wikis.
25 >
26 > -- [[JoshTriplett]]
27
28 >> Thanks for an excellent Xmas present, I will appreciate the additional 
29 >> users this will help switch to ikiwiki! --[[Joey]]
30
31
32 >> Sounds great indeed. Learning from [here](http://www.bddebian.com/~wiki/AboutTheTWikiToIkiwikiConversion/) that HTML::WikiConverter needed for your conversion was not up-to-date on Debian I have now done an unofficial package, including your proposed Markdown patches, apt-get'able at <pre>deb http://debian.jones.dk/ sid wikitools</pre>
33 >> -- [[JonasSmedegaard]]
34
35
36 >>I see the "We will post the scripts ...." was committed about a year ago.  A current site search for "Moin" does not turn them up.  Any chance of an appearance in the near (end of year) future?
37 >>
38 >> -- [[MichaelRasmussen]]
39
40 >>> It appears the scripts were never posted?  I recently imported my Mediawiki site into Iki.  If it helps, my notes are here: <http://iki.u32.net/Mediawiki_Conversion> --[[sabr]]
41
42 >>>>> The scripts have been posted now, see [[joshtriplett]]'s user page, 
43 >>>>> and I've pulled together all ways I can find to [[convert]] other
44 >>>>> systems into ikiwiki. --[[Joey]]