[phpMyAdmin Developers] Wiki
bennetch at gmail.com
Wed Jun 15 03:16:52 CEST 2016
Sebastian, I'm glad to hear from you.
On 6/13/16 11:54 AM, Sebastian Mendel wrote:
> I am not sure what type of git integration you are looking for, but I
> like Atlassian Confluence:
I have not used it yet. Do you mind sharing briefly what you like about
it? Does it allow for offline editing like we can do using the github wiki?
> Isaac Bennetch <bennetch at gmail.com <mailto:bennetch at gmail.com>> schrieb
> am Mo., 13. Juni 2016, 15:08:
> On 6/13/16 8:02 AM, Michal Čihař wrote:
> > Hi
> > this topic was discussed quite a lot on the mailing list, but
> still I'd
> > like to hear feedback which solution do you prefer.
> > Dne 8.6.2016 v 13:33 Michal Čihař napsal(a):
> >> Possible solutions:
> >> * bring Mediawiki on wiki.phpmyadmin.net
> <http://wiki.phpmyadmin.net> back to usable state
> >> - we will have to handle security fixes and so on
> >> - need some way to prevent vandalism
> > Alec Teal offered help with this. The best approach here is
> probably to
> > start with updating latest Mediawiki and avoid using Debian packages
> > completely.
> 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.
> >> * use wiki on GitHub
> >> - it's for free with the repository
> >> - the wiki is quite limited (no categories, no search, ...)
> >> - having wiki content as Git repository is great
> > The wiki features are rather limited here, on the other side we really
> > did not use much of them anyway...
> 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.
> >> * use other solution for wiki.phpmyadmin.net
> >> - we could use cleaned up wiki content which is currently used
> on GitHub
> >> - I'd really prefer something with Git integration
> >> - preferably use GitHub authentication, so that we do not have to
> >> maintain another list of users
> >> - one of possible tools to do that is ikiwiki
> > Anybody has experience with ikiwiki or other wiki engines?
> 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
> > git clone git://ikiwiki.branchable.com/
> 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. However, it seems the path to
> OpenID is a bumpy one.
> I'm more excited about Gitit. 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 has similar goals
> to ours and settled on Gitit.
> Finally, there is Realms and Gollum. 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
> 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 at phpmyadmin.net <mailto:Developers at phpmyadmin.net>
> Developers mailing list
> Developers at phpmyadmin.net
More information about the Developers