OK, so I bit the bullet and looked to see how hard it was to covert our
wiki pages to github wiki. After having a lot of early success just hand
converting, I managed to create a tool to help me convert the meeting
minutes and now have everything on our wiki converted and loaded into
our github wiki. Here are my notes and caveats:
1. I only converted the first page to markdown. Since I was converting
by hand, and most of the pages are historical anyway, I converted from
moinmoin wiki to mediawiki.
2. I did not edit the content. If there were errors, or even wrong
material, I left it. I only editted the formatting, attempting to get
the new pages to display as close to our original page as possible. This
means things like our landing page still had helps on editting with
moinmoin wiki that no longer apply.
3. I retained comments that were in the wiki page, converting them to
comments in either markdown or mediawiki.
4. All the internal links should work. I did fix a couple of internal
links to meeting minutes (the link was off on the date even though the
description was right). All internal links should work and go somewhere
useful.
5. mediawiki automatically adds Table of Contents to pages with more
than X headings... that includes most of our pages. I've suppressed that
with __NOTOC__ in our new pages.
6. All external links should point to where they did when the were in
original wiki page. Not all of them (in fact few of them) go anywhere
useful. Many are old links to the old oasis document system. I project
for someone who knows where everything went might be to update those
links. Other links are 'external' links to the old wiki. We should
probably convert them to internal links as the old wiki will likely go away.
7. About tables.... I've been able to convert our tables, but there are
a couple of issues which could make things annoying:
7.1 The sidebar reduces the size of our table on the screen. You
can slide back and forth, but you can't see the whole table at once.
7.2 github is filtering out the style tag... particularly the
style="background-color:xxxx;" attribute. There might be a way to get
that to stop happening, but I haven't figured it out yet. The new pages
have the style attribute in them so once we figure out how to set those,
color should start working.
8. If you want to do some bulk updates (like finding all the document
links and converting them), you can do that by pulling the wiki from git:
git clone
git@github.com:oasis-tcs/pkcs11.wiki.git