[Biopython-dev] Experimenting with migrating wiki to GitHub pages

[Peter Cock]

Hi all,

A short update on the MediaWiki to Markdown / GitHub pages work.

I have just updated the migration at:

https://github.com/biopython/biopython.github.io
http://biopython.github.io/wiki/Biopython

This required minor changes to the settings and conversion due to
GitHub's updates, e.g.

https://github.com/biopython/biopython.github.io/commit/88c2e291d2fbb94a004a47aeb0548659148d20d4
https://github.com/peterjc/mediawiki_to_git_md/commit/e7a94e1f7f42490ed31e15de1d48f41fb7ea5732

I also filled in a few more mappings from the old MediaWiki usernames
to GitHub email addresses - hopefully these are all correct?

https://github.com/biopython/biopython.github.io/graphs/contributors

Likewise if anyone claims one of the following (number of edits, old username),
please email me:

1 - Amitjoshi
1 - Daniel P.
1 - Dj winter
3 - Einar
1 - Emeryl
1 - Hugog
1 - James Estevez
1 - Jbbrown
1 - Jflatow
1 - Jtriley
1 - Kian.ho
1 - Kmcallenberg
1 - Konrad
2 - Krishna
1 - Marc Juul
3 - MatatTHC
2 - Matsen
1 - Mys 721tx
2 - Mzapala
2 - NeilenMarais
3 - Newacct
2 - Nfdelane
1 - Nuin
1 - Robschia
1 - Zach Stednick

In other news, BioJava are hoping to switch over to their GitHub Pages
website shortly...

Peter


On Thu, Apr 7, 2016 at 11:55 AM, Peter Cock <p.j.a.cock at googlemail.com> wrote:
> Dear Biopythoneers,
>
> In reference to my earlier email, the website migration has become more
> urgent as the main biopython.org website is down until the AWS server
> can be rebuilt:
>
> http://lists.open-bio.org/pipermail/biopython/2016-April/015909.html
> http://lists.open-bio.org/pipermail/biopython-dev/2016-April/021308.html
>
> BioPerl has already got a potential replacement home page up and
> running using GitHub Pages, but this did not preserve the contribution
> history:
>
> http://bioperl.github.io
> https://github.com/bioperl/bioperl.github.io
>
> You may recall last year I started work on a migration from MediaWiki
> to markdown using GitHub Pages?
>
> https://github.com/peterjc/mediawiki_to_git_md [migration tool]
>
> Andreas and the BioJava team started with my migration tool, and have
> already raced ahead with adding styling on top to make something
> quite impressive:
>
> http://biojava.github.io/wiki/Main_Page [pretty]
> https://github.com/biojava/biojava.github.io
>
> In comparison right now the Biopython migration is currently very
> plain:
>
> http://biopython.github.io/wiki/Biopython
> https://github.com/biopython/biopython.github.io
>
> I was hoping to fix some of the remaining issues in the conversion, in
> particular the categories, but perhaps it is good enough already for the
> Biopython wiki? (Some of these limitations would have been/are more
> of a problem for the BioPerl wiki with many templates, and the main
> OBF wiki with many wiki pages using subfolder slashes in their names):
>
> https://github.com/peterjc/mediawiki_to_git_md/issues
>
> Right now there are various things to do, including switching to the
> kramdown markup engine and other tweaks for Jekyll 3.0 (which
> Andreas has already done for BioJava):
>
> https://github.com/blog/2100-github-pages-now-faster-and-simpler-with-jekyll-3-0
>
> After than I think it would be sensible to start adopting much of the
> styling work pioneered by Andreas for the BioJava team?
>
> Do we have any GitHub pages experts in the community?
>
> In general, please have a look at the trial migration wiki pages
> and if you see any glitches, please report them via:
>
> https://github.com/biopython/biopython.github.io/issues
> and/or https://github.com/peterjc/mediawiki_to_git_md/issues
>
> Thank you,
>
> Peter
>
> On Wed, Mar 4, 2015 at 4:46 PM, Peter Cock <p.j.a.cock at googlemail.com> wrote:
>>
>> I've got the basic wiki content converted in markdown and showing nicely
>> (while preserving the wiki revisions and most of the contributors). Adding
>> a theme for a pretty layout is a finishing touch. First, all the links and files
>> need doing - definitely possible.
>>
>> A key question is will it be as easy for people to edit as the wiki is/was?
>>
>> Peter
>>
>> On Wed, Mar 4, 2015 at 4:22 PM, João Rodrigues
>> <j.p.g.l.m.rodrigues at gmail.com> wrote:
>>> Hi Peter, all,
>>>
>>> I've used Jekyll + Github to create our lab webpage. Turns out to be an
>>> amazingly simple solution and very collaborative as well. Nice thought of
>>> moving the wiki to such a system.
>>>
>>> A quick question: why not make a page from "scratch" ? Using a template and
>>> converting the HTML to markdown seems pretty simple, it's just a matter of
>>> agreeing on a layout.
>>>
>>> Maybe I'm missing the point and you're doing this already..
>>>
>>> Cheers,
>>>
>>> João