Re: [phpMyAdmin Developers] Wiki

On 6/13/16 8:02 AM, Michal Čihař wrote: I am not against staying with Mediawiki, however the obvious shortcoming is lack of git integration. This is not a deal-killer for me, but it is a negative. We can work around the lack of features, since there aren't many we use, but the limitations with how data is displayed (for instance, only about 70% of the page is used for actual wiki data) make this difficult. I'm not fond of Github wiki and only consider it because it's easy and has great git integration. GitHub I've been looking in to ikiwiki, actually. It has git integration, which I think is the feature we're most looking for. The underlying language is Markdown, which we're rather familiar with. However, the rendered pages are a bit ugly. You can quickly clone the repository with to view the demo wiki. Look in the ./doc/ folder for the actual wiki content. The rendered pages are visible at https://ikiwiki.info/ They appear to allow authentication using accounts from OpenID, Yahoo, WordPress, and more; in fact there's a page with discussion about their plans/roadmap for authentication[1]. However, it seems the path to OpenID is a bumpy one[2]. I'm more excited about Gitit[3][4]. Gitit has a git backend (or darcs or mercurial), pages are able to be written in about ten different flavors including Markdown and reStructuredText (anything understood by Pandoc), and it looks like Mediawiki (which isn't a big goal for me, but it's a common and easy-to-use structure). The default/suggested authentication seems to be GitHub OAuth. Downsides about it: their own wiki is a mess (broken links to the Install guide and README, not a whole lot of information in general), development seems slow (there are plenty of Issues and Pull Requests without a comment, last commit was 12 days ago), and it's written in Haskell (with which I'm not very familiar) -- but this is my favorite right now. This random guy[5] has similar goals to ours and settled on Gitit. Finally, there is Realms[6][7] and Gollum[8]. Realms is built on Gollum, uses GitHub OAuth, and it looks really modern. However, the documentation seems really weak and it looks like they haven't published an actual release yet (though running their git 'master' branch seems to work okay). Realms is very interesting to me, but with my cursory examination it doesn't feel like production-ready software. I could be wrong. Gollum is apparently what GitHub is using for their wiki engine. I don't have a good sense of what Gollum is like, because as near as I can tell they don't have a demo and I haven't gotten around to installing it on my test machine. There's a fork to add OAuth support[9]. For looks, I think Realms acts best; it's modern and slick and easy to use. However, Gitit seems much more established and reliable. 1 - https://ikiwiki.info/todo/emailauth/ 2 - https://ikiwiki.info/plugins/openid/troubleshooting/ 3 - http://gitit.net/ 4 - https://github.com/jgm/gitit 5 - http://nathantypanski.com/blog/2014-07-09-personal-wiki.html 6 - http://realms.io/ 7 - https://github.com/scragg0x/realms-wiki 8 - https://github.com/gollum/gollum 9 - https://github.com/aleiphoenix/gollum-with-auth _______________________________________________ Developers mailing list Developers(a)phpmyadmin.net https://lists.phpmyadmin.net/mailman/listinfo/developers