[Pacemaker] howto migrate between linux-ha wiki

[Lars Ellenberg]

On Thu, Jan 28, 2010 at 02:01:25PM +0100, Florian Haas wrote:
> On 2010-01-28 13:51, Dejan Muhamedagic wrote:
> > Yes :) Is there a way to copy/convert old wiki documents to the
> > new wiki? Some documents are almost as good as new. Some need
> > minor changes. And we need lots of hands, so it'd be good to have
> > a kind of HOWTO for this. Finally, is there a way to make
> > redirect for those pages which moved to the new wiki?
> 
> Given the fact that whatever is to be moved over from the old wiki
> _definitely_ needs a human to at least proofread, I think any automated
> process would be a bad idea.
> 
> Conversely, copying and pasting and then reviewing, it's helpful that
> the Mediawiki syntax is actually not too different from the MoinMoin
> syntax (with the added benefit that anyone who's ever fixed up a
> Wikipedia article will, at least to some degree, be familiar with
> Mediawiki syntax). So an approach that I have used for a number of pages
> is to open the edit interface in the old MoinMoin wiki,

no need for the edit page, add ?action=raw.
like http://moin.linux-ha.org/SBD_Fencing?action=raw

> copy the text,
> paste it into an edit window in the new Mediawiki, and then edit for
> content and syntax in one go. That process is actually remarkably quick. :)

Right.

To adjust formatting, just use the preview function.
The following hints may help.

headlines, bold, italic is all the same.

Tables become "interesting".
Fortunately we don't have many tables in the old pages.


  indented text		now has one (or more) colons in the first column
                        ::

lists need to start in the first column as well:

 * Item 1		* Item 1
  * Item 1.1            ** Item 1.2
 * Item 2               * Item 2


 1. Item 1		# Item 1
  a. Item 1.a           ## Item 1.2
 1. Item 2              # Item 2

 term:: definition	; term : definition

{{{ code blocks }}} and `monospace`
	need to be either just indented
	or changed to <tt>code block</tt> or <pre>code block</pre>
	as necessary.

see also http://www.mediawiki.org/wiki/Help:Formatting

Most links (bracketed links) are fine.

MoinMoin CamelCase links
	need to be changed (and updated, to not point nowhere).
	if you don't want to migrate the page they are pointing to,
	maybe just convert them to normal text.

__underline__ becomes <u>underline</u>

^superscript^		<sup></sup>
,,subscript,,		<sub></sub>

Attachments need special attention anyways, in case you really want to
move them over. If it is not simple images, but binaries, pdfs or
similar, maybe we rather put them outside the wiki into an other
static area on the server.


-- 
: Lars Ellenberg
: LINBIT | Your Way to High Availability
: DRBD/HA support and consulting http://www.linbit.com

DRBD® and LINBIT® are registered trademarks of LINBIT, Austria.