[phpMyAdmin Developers] Wiki
Sebastian Mendel
info at sebastianmendel.de
Thu Jun 16 21:19:48 CEST 2016
> I have not used it yet. Do you mind sharing briefly what you like about
it?
It works ;-)
The hosted version does not require any of your short time for maintaining
the system.
It is easy to use - IMHO.
It is feature-rich.
> Does it allow for offline editing like we can do using the github wiki?
It supports editing with local editors - i do not know if this requires an
active connection.
But is provides an API.
As auth provider it accepts only itself (My Atlassian) or google business
:-(
Isaac Bennetch <bennetch at gmail.com> schrieb am Mi., 15. Juni 2016 um
03:16 Uhr:
> 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:
> > https://de.atlassian.com/software/views/open-source-license-request
>
> 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
> > <http://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/
> > <http://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[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 at phpmyadmin.net <mailto:Developers at phpmyadmin.net>
> > https://lists.phpmyadmin.net/mailman/listinfo/developers
> >
> >
> >
> > _______________________________________________
> > Developers mailing list
> > Developers at phpmyadmin.net
> > https://lists.phpmyadmin.net/mailman/listinfo/developers
> >
>
> _______________________________________________
> Developers mailing list
> Developers at phpmyadmin.net
> https://lists.phpmyadmin.net/mailman/listinfo/developers
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.phpmyadmin.net/pipermail/developers/attachments/20160616/ba88dc32/attachment.html>
More information about the Developers
mailing list