MediaWiki syntax support in GitLab wiki editor
Description
We have a development team who are migrating from MediaWiki + SVN to GitLab. There are a large number of wiki documents that we would like to put in a GitLab wiki. Our experiments show that if we commit the .wiki files into a project repository, then not only can GitLab render the wikitext properly, but also gives a usable Edit button and preview functionality. However, intra-wiki links no longer works in this mode because the file viewer does not automatically translate page slugs into proper file names. One workaround is to modify all the links like this: [[some page.wiki]]
, but obviously this is tedious and not very usable.
We have also found that git cloning the project wiki and committing .wiki files into it works to a certain extent. However, the in-browser wiki editor only supports Markdown, RDoc and AsciiDoc. There is no way to edit wiki pages in MediaWiki syntax even though GitLab already clearly supports editing and rendering it in the code repository. Also, the wiki page rendering fails to turn page slugs into proper URLs, e.g. [[page2]]
generates http://servername/page2
instead of the expected http://gitlab.company.com/user/project/wikis/page2
.
Proposal
Since GitLab wiki is designed to support multiple document formats, and support for MediaWiki syntax mostly already exists, the GitLab wiki editor should support pages in MediaWiki format. This will significantly lower the cost of adopting GitLab for teams who have a lot of MediaWiki documents and markup skills.
A conversion tool that takes an exported MediaWiki document collection and commit it into GitLab wiki would be very nice. As a minimal use case, we should be able to copy and paste wikitext into a GitLab wiki page, and it should work without heavy modification of the document (especially page slugs and links), assuming that we are willing to drag attachments and pictures into the pages manually.
Links / references
GitHub supports MediaWiki syntax. The wiki page editor provides a "Edit mode" drop-down that allows the choice of MediaWiki, and also provides functional Preview mode.