Migrate x.org/wiki to GitLab

• Clone wiki to GitLab
• Convert mdwn to md
• Add Hugo front matter
• Create theme
• Setup pipeline
• Review pages for freshness

Currently working on this at https://gitlab.freedesktop.org/zachr/xorg-wiki/tree/hugo

assigned to @zachr

marked the checklist item Create theme as completed

marked the checklist item Create theme as incomplete

I don't think reviewing all the content should block the migration.

Moving to GitLab Pages would be really nice because it frees us from ikiwiki's Perl-based tyranny, and needing yet more manual account mangling and creation. Doing that lets people fork the wiki, make any improvements they want to either content or style, and submit MRs back for review, rather than people just randomly committing stuff. Or having to ask someone with access to commit it for them.

The annoying part (from an admin perspective) is that we have 10GB of tarballs in /archive/ which we can't just drop on the floor. But we also don't want them on GitLab Pages, because it means that every CI pipeline to generate the files involves zipping up and transferring all those tarballs, and the repo also becomes huge.

I'm thinking that the tarballs should still live on annarchy in the same place, and we use either nginx (the frontend to gitlab.fd.o and Pages sites on GCP) or Apache (on annarchy) to be the primary host and then reverse-proxy the other half.

That's totally doable, and I should have the time to do this properly in the next week or two.

Absent any objections (@ajax @keithp @alanc?), I plan to actually do this fairly shortly.

I'd originally tried to get the new nginx ingress setup running first, but that was a mistake as it's been taking a really long time to get running, so I'll just do it on top of the old setup.

I have no objections to the project in principle, just questions about the implementation.

/archive/ isn't the only non-wiki subdirectory of www.x.org we need to preserve - is anything special needed for /docs/, /videos/, etc.?

Is there somewhere we can see the prototype wiki before this goes live? I only see the markdown sources in the repo linked above.

@alanc: You can see the current version on that project's pages.

@zachr well, looks like that new wiki engine is really not working :/

I tried the first two (internal) links on the homepage, and both give me broken pages:

• https://zachr.pages.freedesktop.org/xorg-wiki/XorgFoundation/ vs https://www.x.org/wiki/XorgFoundation/
• https://zachr.pages.freedesktop.org/xorg-wiki/BoardOfDirectors/ vs https://www.x.org/wiki/BoardOfDirectors/

I assume this is a known issue though?

@eric yes that issue was filed as zachr/xorg-wiki#4 (closed) a little over a month ago. I was, perhaps pessimistically, saving some bugs until after I confirmed that this migration was viable. In other words, I didn't see any point in making the wiki perfect if the new hugo based wiki was not going to be used.

Okay, looks reasonable once things like zachr/xorg-wiki#4 (closed) are fixed.

I'm currently working on fixing up the remaining broken pages. @eric, both of the pages you mentioned (and hundreds of other index pages) should now be working. Sadly, XorgFoundation/ is a victim of newly discovered issue zachr/xorg-wiki#6. Thankfully that issue is rare, but the only fix I have is manual.

Hopefully, the migration is nearing a state of "good enough". I am treating the issues under this milestone as launch blockers. Please file issues if you find any undiscovered ones.

mentioned in merge request xkeyboard-config/xkeyboard-config!806 (merged)