<div dir="ltr">... I had created an awesome-python-android page, but I seem to have `push -f`'ed over it and the reflog is too hard.</div><div class="gmail_extra"><br><div class="gmail_quote">On Tue, Jan 6, 2015 at 1:25 PM, Wes Turner <span dir="ltr"><<a href="mailto:wes.turner@gmail.com" target="_blank">wes.turner@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">Fair disclosure: I'm not a big fan of Moin syntax (can Pandoc convert this?). I don't like having to login to share with the Python community. It would be great to gain maximum synergy from the community on this.<div><br></div><div>Some interesting perspectives on wikis, and where wikis are going:</div><div><br></div><div>[1] <a href="https://github.com/blog/1939-how-github-uses-github-to-document-github" target="_blank">https://github.com/blog/1939-how-github-uses-github-to-document-github</a></div><div>[2] <a href="https://github.com/westurner/wiki/blob/master/Makefile" target="_blank">https://github.com/westurner/wiki/blob/master/Makefile</a></div><div><br></div><div>[2] is a Sphinx Makefile for a GitHub ReStructuredText wiki. It seems to work okay for my purposes. What could prevent this from scaling to handle the Python wiki? </div><div><br></div><div>From <a href="https://github.com/westurner/wiki/issues/5" target="_blank">https://github.com/westurner/wiki/issues/5</a> , in Markdown (which works on both BitBucket and GitHub):</div><div><br></div><div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"># Advantages<br></blockquote><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"> </blockquote><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">* Beautiful Sphinx output: <a href="https://github.com/westurner/wiki/blob/master/conf.py" target="_blank">https://github.com/westurner/wiki/blob/master/conf.py</a><br>  * Search<br>  * Context-focused pages<br>  * Navbar<br>  * **Responsive** CSS Freedom; for my cell phone<br>* Pull Requests<br># Challenges / Disadvantages<br>* New wiki pages created through the GitHub wiki interface add the `.rest` suffix, rather than `.rst`<br>  * Sort of an advantage (`.rest` files are docutils-only)<br>  * This precludes inclusion of the wiki pages into a standard Sphinx docset as a submodule or subtree.<br>* Sphinx ReStructuredText is a superset of GitHub ReStructuredText (docutils), so Sphinx markup is, in the best case not supported, and in the worst case breaks the wiki render<br>  * Notably: `:ref:`, `.. index:`, and `.. toctree::` are only supported by Sphinx<br>  * To test this: `make rst2html_all`<br>* Double Tables of Contents (#4)<br>* Double pulls and pushes (`make pull push`): <a href="https://github.com/westurner/wiki/blob/master/Makefile" target="_blank">https://github.com/westurner/wiki/blob/master/Makefile</a><br>* Sphinx requires a manual build step in order to publish in-progress changes</blockquote></div><div><br></div><div><br></div><div><br></div></div><div class="HOEnZb"><div class="h5"><div class="gmail_extra"><br><div class="gmail_quote">On Tue, Jan 6, 2015 at 2:31 AM, M.-A. Lemburg <span dir="ltr"><<a href="mailto:mal@egenix.com" target="_blank">mal@egenix.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span>On 06.01.2015 07:26, Ben Finney wrote:<br>
> "M.-A. Lemburg" <<a href="mailto:mal@egenix.com" target="_blank">mal@egenix.com</a>> writes:<br>
><br>
>> [editing the Python wiki] requiring asking for editing rights<br>
>> on the pydotorg-www mailing list. Which is a little annoying and<br>
>> some work for the admins, but has resulted in the amount of<br>
>> spam to go down to zero. We usually grant the editing requests<br>
>> within a day.<br>
><br>
> I quite understand the motivation for this.<br>
><br>
> It does need to be recognised that this will dramatically reduce the<br>
> number of pople who will pass that hurdle to edit the wiki, and thus the<br>
> wiki loses a lot of edits (both helpful and unhelpful) it might<br>
> otherwise have.<br>
<br>
</span>We might lose some occasional quick typo fixes, but it seems that<br>
those genuinely interested in helping with the wiki don't have<br>
a problem asking on the list.<br>
<br>
To reduce the problem I had created a list of user names<br>
who had made good edits in the months before the change.<br>
<br>
The only nit I still have with the setup is that it's not<br>
necessarily apparent for new users how to get editing rights.<br>
There's a section on the front page, but you don't see this<br>
when looking at a random page.<br>
<span><br>
> Thanks to those doing the work to maintain Python community<br>
> infrastructure.<br>
<br>
--<br>
</span>Marc-Andre Lemburg<br>
eGenix.com<br>
<br>
Professional Python Services directly from the Source  (#1, Jan 06 2015)<br>
<span>>>> Python Projects, Coaching and Consulting ...  <a href="http://www.egenix.com/" target="_blank">http://www.egenix.com/</a><br>
>>> mxODBC Plone/Zope Database Adapter ...       <a href="http://zope.egenix.com/" target="_blank">http://zope.egenix.com/</a><br>
>>> mxODBC, mxDateTime, mxTextTools ...        <a href="http://python.egenix.com/" target="_blank">http://python.egenix.com/</a><br>
________________________________________________________________________<br>
<br>
::::: Try our mxODBC.Connect Python Database Interface for free ! ::::::<br>
<br>
   eGenix.com Software, Skills and Services GmbH  Pastor-Loeh-Str.48<br>
    D-40764 Langenfeld, Germany. CEO Dipl.-Math. Marc-Andre Lemburg<br>
           Registered at Amtsgericht Duesseldorf: HRB 46611<br>
               <a href="http://www.egenix.com/company/contact/" target="_blank">http://www.egenix.com/company/contact/</a><br>
</span><div><div>_______________________________________________<br>
Python-ideas mailing list<br>
<a href="mailto:Python-ideas@python.org" target="_blank">Python-ideas@python.org</a><br>
<a href="https://mail.python.org/mailman/listinfo/python-ideas" target="_blank">https://mail.python.org/mailman/listinfo/python-ideas</a><br>
Code of Conduct: <a href="http://python.org/psf/codeofconduct/" target="_blank">http://python.org/psf/codeofconduct/</a><br>
</div></div></blockquote></div><br></div>
</div></div></blockquote></div><br></div>