From c0d116313a8fab3b1a4f186a9625250bf85d9fc2 Mon Sep 17 00:00:00 2001 From: Thomas Schwinge Date: Tue, 6 Nov 2007 22:15:19 +0100 Subject: Rename two files. --- AboutTheTWikiToIkiwikiConversion.mdwn | 105 ----------------------------- about_the_twiki_to_ikiwiki_conversion.mdwn | 105 +++++++++++++++++++++++++++++ index.mdwn | 2 +- wiki_colophon.mdwn | 32 +++++++++ wikicolophon.mdwn | 32 --------- 5 files changed, 138 insertions(+), 138 deletions(-) delete mode 100644 AboutTheTWikiToIkiwikiConversion.mdwn create mode 100644 about_the_twiki_to_ikiwiki_conversion.mdwn create mode 100644 wiki_colophon.mdwn delete mode 100644 wikicolophon.mdwn diff --git a/AboutTheTWikiToIkiwikiConversion.mdwn b/AboutTheTWikiToIkiwikiConversion.mdwn deleted file mode 100644 index bf8fb1fa..00000000 --- a/AboutTheTWikiToIkiwikiConversion.mdwn +++ /dev/null @@ -1,105 +0,0 @@ -[[meta copyright="Copyright © 2007 Free Software Foundation, Inc."]] -[[meta license="Permission is granted to copy, distribute and/or modify this -document under the terms of the GNU Free Documentation License, Version 1.2 or -any later version published by the Free Software Foundation; with no Invariant -Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license -is included in the section entitled -[[GNU_Free_Documentation_License|/fdl.txt]]."]] - -# Some Quick Notes About the *TWiki to ikiwiki* Conversion - -/!\ Incomplete. - -I saw a *moin2iki* program bundle being announced from -. - - JoshTriplett: On http://ikiwiki.info/users/joshtriplett.html - you write about a TWiki to ikiwiki conversion script. Is that already - available somewhere? - tschwinge: Yes, you can get it in its current state at - git://svcs.cs.pdx.edu/git/moin2iki.git - tschwinge: That repo has scripts for converting from Moin - and TWiki to ikiwiki. - tschwinge: Work in progress. - tschwinge: For a purely TWiki setup, it should work fine. - tschwinge: You need a number of depenencies, though, and we - haven't documented them well yet. - JoshTriplett: Thanks, I'll have a look and report back (in some - days, I hope). - tschwinge: In particular, you need HTML::WikiConverter with - our 12 ikiwiki-related patches. - tschwinge: - http://rt.cpan.org/Public/Bug/Display.html?id=24446 - -As I had difficulties with extracting the patches from the cpan site, they were -also made available by the authors at -. - -The Debian package *libhtml-wikiconverter-perl* is too old at least until -[[debbug 419918]] is closed. - -For converting from rcs files (as used by TWiki) to a git repository you'll -need to get `git clone git://people.freedesktop.org/~keithp/parsecvs` and build -it. Or don't do that and install the Debian *git-cvs* package instead; see -below. - -Here is the command line I used (line breaks added for readability) to create -an *Authors* file from the TWiki files, suitable for *parsecvs* or -*git-cvsimport* to use: - - $ sort < data/Main/TWikiUsers.txt | uniq | ↩ - while read s n r; do ↩ - ( [ "$s" != \* ] || expr "$r" : .\*\< > /dev/null) && continue; ↩ - echo "$n"="$(recode Latin1..UTF-8 < data/Main/"$n".txt | ↩ - awk -v name="$n" 'BEGIN { FS = ": "; email = "web-hurd@gnu.org" } ↩ - { sub("\r$", "") } $1 ~ /\* Name$/ { name = $2 } ↩ - $1 ~ /\* Email$/ { email = $2 } ↩ - END { print name " <" email ">" }')"; ↩ - done | tee Authors - -The old TWiki installation had managed to corrupt one of its own rcs files, -which both *parsecvs* and *git-cvsimport* stumbled on. As that file was not -essential for me, I simply deleted it. - -The final output (after the TWiki markup to Markdown markup conversion) was -expected to pour out *.mdwn* files. However the original TWiki files are named -*.txt*. As the *git-map* step as yet (would this be possible at all?) has no -way to rename the files while converting, I simply adapted the input files' -names to what was expected: I ran a the following command to rename the -*.txt,v* files to *.mdwn,v* files before running *git-cvsimport*: - - $ find ./ | grep \\.txt,v | while read f; do ↩ - mv -vi "$f" "$(expr "$f" : \\\(.\*\\\)\\.txt,v)".mdwn,v; done - -Instead of using *parsecvs* (which finally even choked on the valid rcs input -files) I eventually ended up successfully converting the old TWiki with -*git-cvsimport*: - - $ git-cvsimport -v -d "`pwd`"/../hurd-wiki/ -z 0 -a -A ../Authors data - [...] - Committed patch 4698 (origin +0000 2007-04-13 17:40:08) - Commit ID c33d05d0274d0d602fba835805abb9ba413c65c6 - Generating pack... - Done counting 18576 objects. - Deltifying 18576 objects... - 100% (18576/18576) done - Writing 18576 objects... - 100% (18576/18576) done - Total 18576 (delta 12567), reused 16106 (delta 10886) - Pack pack-d38e3d55705f5d355f669aaa7d993420b50798d0 created. - Removing unused objects 100%... - Done. - DONE; creating master branch - -The only thing I had to do to make the conglomerate of rcs files a *valid* cvs -repository (read: to satisfy *git-cvsimport*'s needs) was a `mkdir -../hurd-wiki/CVSROOT`. - -Then let's convert the whole git tree from TWiki syntax to Markdown: - - $ TWIKI="`pwd`"/../hurd-wiki tw_2001-12-01_2iki "`pwd`"/.git - [...] - -After that I repeated -- in a separate directory!, they can be merged later -- -the same last steps again, replacing *data* with *pub*, which contains the data -files that had been attached to the wiki pages (like images, for example). diff --git a/about_the_twiki_to_ikiwiki_conversion.mdwn b/about_the_twiki_to_ikiwiki_conversion.mdwn new file mode 100644 index 00000000..bf8fb1fa --- /dev/null +++ b/about_the_twiki_to_ikiwiki_conversion.mdwn @@ -0,0 +1,105 @@ +[[meta copyright="Copyright © 2007 Free Software Foundation, Inc."]] +[[meta license="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled +[[GNU_Free_Documentation_License|/fdl.txt]]."]] + +# Some Quick Notes About the *TWiki to ikiwiki* Conversion + +/!\ Incomplete. + +I saw a *moin2iki* program bundle being announced from +. + + JoshTriplett: On http://ikiwiki.info/users/joshtriplett.html + you write about a TWiki to ikiwiki conversion script. Is that already + available somewhere? + tschwinge: Yes, you can get it in its current state at + git://svcs.cs.pdx.edu/git/moin2iki.git + tschwinge: That repo has scripts for converting from Moin + and TWiki to ikiwiki. + tschwinge: Work in progress. + tschwinge: For a purely TWiki setup, it should work fine. + tschwinge: You need a number of depenencies, though, and we + haven't documented them well yet. + JoshTriplett: Thanks, I'll have a look and report back (in some + days, I hope). + tschwinge: In particular, you need HTML::WikiConverter with + our 12 ikiwiki-related patches. + tschwinge: + http://rt.cpan.org/Public/Bug/Display.html?id=24446 + +As I had difficulties with extracting the patches from the cpan site, they were +also made available by the authors at +. + +The Debian package *libhtml-wikiconverter-perl* is too old at least until +[[debbug 419918]] is closed. + +For converting from rcs files (as used by TWiki) to a git repository you'll +need to get `git clone git://people.freedesktop.org/~keithp/parsecvs` and build +it. Or don't do that and install the Debian *git-cvs* package instead; see +below. + +Here is the command line I used (line breaks added for readability) to create +an *Authors* file from the TWiki files, suitable for *parsecvs* or +*git-cvsimport* to use: + + $ sort < data/Main/TWikiUsers.txt | uniq | ↩ + while read s n r; do ↩ + ( [ "$s" != \* ] || expr "$r" : .\*\< > /dev/null) && continue; ↩ + echo "$n"="$(recode Latin1..UTF-8 < data/Main/"$n".txt | ↩ + awk -v name="$n" 'BEGIN { FS = ": "; email = "web-hurd@gnu.org" } ↩ + { sub("\r$", "") } $1 ~ /\* Name$/ { name = $2 } ↩ + $1 ~ /\* Email$/ { email = $2 } ↩ + END { print name " <" email ">" }')"; ↩ + done | tee Authors + +The old TWiki installation had managed to corrupt one of its own rcs files, +which both *parsecvs* and *git-cvsimport* stumbled on. As that file was not +essential for me, I simply deleted it. + +The final output (after the TWiki markup to Markdown markup conversion) was +expected to pour out *.mdwn* files. However the original TWiki files are named +*.txt*. As the *git-map* step as yet (would this be possible at all?) has no +way to rename the files while converting, I simply adapted the input files' +names to what was expected: I ran a the following command to rename the +*.txt,v* files to *.mdwn,v* files before running *git-cvsimport*: + + $ find ./ | grep \\.txt,v | while read f; do ↩ + mv -vi "$f" "$(expr "$f" : \\\(.\*\\\)\\.txt,v)".mdwn,v; done + +Instead of using *parsecvs* (which finally even choked on the valid rcs input +files) I eventually ended up successfully converting the old TWiki with +*git-cvsimport*: + + $ git-cvsimport -v -d "`pwd`"/../hurd-wiki/ -z 0 -a -A ../Authors data + [...] + Committed patch 4698 (origin +0000 2007-04-13 17:40:08) + Commit ID c33d05d0274d0d602fba835805abb9ba413c65c6 + Generating pack... + Done counting 18576 objects. + Deltifying 18576 objects... + 100% (18576/18576) done + Writing 18576 objects... + 100% (18576/18576) done + Total 18576 (delta 12567), reused 16106 (delta 10886) + Pack pack-d38e3d55705f5d355f669aaa7d993420b50798d0 created. + Removing unused objects 100%... + Done. + DONE; creating master branch + +The only thing I had to do to make the conglomerate of rcs files a *valid* cvs +repository (read: to satisfy *git-cvsimport*'s needs) was a `mkdir +../hurd-wiki/CVSROOT`. + +Then let's convert the whole git tree from TWiki syntax to Markdown: + + $ TWIKI="`pwd`"/../hurd-wiki tw_2001-12-01_2iki "`pwd`"/.git + [...] + +After that I repeated -- in a separate directory!, they can be merged later -- +the same last steps again, replacing *data* with *pub*, which contains the data +files that had been attached to the wiki pages (like images, for example). diff --git a/index.mdwn b/index.mdwn index d3229d44..435cc95e 100644 --- a/index.mdwn +++ b/index.mdwn @@ -124,7 +124,7 @@ The menu on the upper right corner provides a rough structuring about the available content. Just follow those topics and explore the wiki. Further information about this site and how it was created can be found in the -[[wiki_colophon|wikicolophon]]. +[[wiki_colophon]]. ---- diff --git a/wiki_colophon.mdwn b/wiki_colophon.mdwn new file mode 100644 index 00000000..a479599a --- /dev/null +++ b/wiki_colophon.mdwn @@ -0,0 +1,32 @@ +Just like a book, this topic is designed to help describe the tools used to +create this website and what methods were used to give it it's look and feel. + + +# Rev. I + +We used a particular implementation (or clone) of Wiki software called +[TWiki](http://twiki.org). + +A generic [WikiWikiWeb](http://www.c2.com/cgi/wiki?WelcomeVisitors), or simply +Wiki, is _"a collaborative forum where people can share ideas and record any +consensus reached on difficult issues, along with rebuttal. It changes as +people come and go, as experience develops, and as opinions change." The TWiki +software is an enhanced descendent of the original WikiWikiWeb_. + +We used the [GNU Skin](http://twiki.org/cgi-bin/view/Plugins/GnuSkin) created +by our own Joachim Nilsson. + +This site began in May, 2002 as one TWiki web: *Hurd*. This WebHome page was +used as the front page of the whole site. We grew this site and added more +TWiki webs by December, 2002. Due to the success of the site we had to act +with respect to more completely addressing copyright issues. More people +started adding content. + + +--- + +# Rev. II + +On 2007-08-12 [[Thomas_Schwinge|tschwinge]] finished the conversion of the +TWiki content to [ikiwiki](http://ikiwiki.info). Read +[[about_the_twiki_to_ikiwiki_conversion]]. diff --git a/wikicolophon.mdwn b/wikicolophon.mdwn deleted file mode 100644 index 518bab8e..00000000 --- a/wikicolophon.mdwn +++ /dev/null @@ -1,32 +0,0 @@ -Just like a book, this topic is designed to help describe the tools used to -create this website and what methods were used to give it it's look and feel. - - -# Rev. I - -We used a particular implementation (or clone) of Wiki software called -[TWiki](http://twiki.org). - -A generic [WikiWikiWeb](http://www.c2.com/cgi/wiki?WelcomeVisitors), or simply -Wiki, is _"a collaborative forum where people can share ideas and record any -consensus reached on difficult issues, along with rebuttal. It changes as -people come and go, as experience develops, and as opinions change." The TWiki -software is an enhanced descendent of the original WikiWikiWeb_. - -We used the [GNU Skin](http://twiki.org/cgi-bin/view/Plugins/GnuSkin) created -by our own Joachim Nilsson. - -This site began in May, 2002 as one TWiki web: *Hurd*. This WebHome page was -used as the front page of the whole site. We grew this site and added more -TWiki webs by December, 2002. Due to the success of the site we had to act -with respect to more completely addressing copyright issues. More people -started adding content. - - ---- - -# Rev. II - -On 2007-08-12 [[Thomas_Schwinge|tschwinge]] finished the conversion of the -TWiki content to [ikiwiki](http://ikiwiki.info). On -[[AboutTheTWikiToIkiwikiConversion]] you can read a bit about that. -- cgit v1.2.3