<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	xmlns:georss="http://www.georss.org/georss" xmlns:geo="http://www.w3.org/2003/01/geo/wgs84_pos#" xmlns:media="http://search.yahoo.com/mrss/"
	>

<channel>
	<title>Le blog de Patrick Vergain</title>
	<atom:link href="http://pvergain.wordpress.com/feed/" rel="self" type="application/rss+xml" />
	<link>http://pvergain.wordpress.com</link>
	<description>&#34;...mais ce serait peut-être l&#039;une des plus grandes opportunités manquées de notre époque si le logiciel libre ne libérait rien d&#039;autre que du code...&#34;</description>
	<lastBuildDate>Wed, 18 Nov 2009 21:42:15 +0000</lastBuildDate>
	<generator>http://wordpress.com/</generator>
	<language>fr</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
	<cloud domain='pvergain.wordpress.com' port='80' path='/?rsscloud=notify' registerProcedure='' protocol='http-post' />
<image>
		<url>http://www.gravatar.com/blavatar/cb14d07960d874e0d3b37821f15f5e22?s=96&#038;d=http://s.wordpress.com/i/buttonw-com.png</url>
		<title>Le blog de Patrick Vergain</title>
		<link>http://pvergain.wordpress.com</link>
	</image>
			<item>
		<title>Python documentation: news sphinx/numpydoc  + flexirest + sphinx sourceforge theme/{gsdview,bestgui}</title>
		<link>http://pvergain.wordpress.com/2009/11/16/python-documentation-news-sphinxnumpydoc-flexirest-sphinx-sourceforge-themegsdviewbestgui/</link>
		<comments>http://pvergain.wordpress.com/2009/11/16/python-documentation-news-sphinxnumpydoc-flexirest-sphinx-sourceforge-themegsdviewbestgui/#comments</comments>
		<pubDate>Sun, 15 Nov 2009 22:20:31 +0000</pubDate>
		<dc:creator>patrick</dc:creator>
				<category><![CDATA[2009]]></category>
		<category><![CDATA[Documentation]]></category>
		<category><![CDATA[Génie logiciel]]></category>
		<category><![CDATA[python]]></category>
		<category><![CDATA[reStructuredText]]></category>
		<category><![CDATA[sourceforge]]></category>
		<category><![CDATA[sphinx theme]]></category>

		<guid isPermaLink="false">http://pvergain.wordpress.com/?p=627</guid>
		<description><![CDATA[- http://pypi.python.org/pypi/numpydoc/0.3.1 (Sphinx extension to support docstrings in Numpy format)
 - http://pypi.python.org/pypi/flexirest/ (&#8216; The medium-featured, flexible reStructuredText utility. Flexirest is a project that was born out of the authors long-running interest for reStructuredText, and the idea of writing everyday documents like letters, invoices and other simple documents in this way. Flexirest tries to strike a [...]<img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=pvergain.wordpress.com&blog=696018&post=627&subd=pvergain&ref=&feed=1" />]]></description>
			<content:encoded><![CDATA[<div class='snap_preview'><br /><p>- <a title="Numpy" href="http://pypi.python.org/pypi/numpydoc/0.3.1" target="_blank">http://pypi.python.org/pypi/numpydoc/0.3.1 </a>(Sphinx extension to support docstrings in Numpy format)</p>
<p><!-- -*- mode: rst -*- --> <!-- -*- Coding: utf-8 -*- -->-<a title="flexirest" href="http://pypi.python.org/pypi/flexirest/" target="_blank"> http://pypi.python.org/pypi/flexirest/ </a>(&#8216; <em>The medium-featured, flexible reStructuredText utility<cite>. Flexirest</cite> is a project that was born out of the authors long-running interest for <a href="http://docutils.sourceforge.net/rst.html">reStructuredText</a>, and the idea of writing everyday documents like letters, invoices and other simple documents in this way.<cite> Flexirest</cite> tries to strike a middle ground between <a href="http://docutils.sourceforge.net/">docutils</a> own command line tool chain (<cite>rst2html</cite> et al), that I find a little to minimalistic and <a href="http://sphinx.pocoo.org/">Sphinx</a>, that I find very nice but a little heavy to use for a quickie document like a random letter or some such. In short, the goal of <cite>flexirest</cite> is to enable you to use the <cite>reST</cite> format for everyday documents instead of a word processor or similar with minimal fuzz. Hence you get to stay in the comfy environment of your text editor and tool chain. And you can check in your docs </em><em>in text format into your version control system of choice. And, if used correctly, you get to reuse a couple of stylings that you only need to create once. There are some modestly advanced tricks you can do too, primarily writing your own <cite>docutils</cite> <a href="http://docutils.sourceforge.net/docs/howto/rst-roles.html">roles</a>, but I wouldn&#8217;t consider those the major points of flexirest. For more information on how to operate <cite>flexirest</cite>, see the <a href="http://pypi.python.org/pypi/flexirest/quick-manual.html">quick manual</a></em>.&#8217;)</p>
<ul>
<li><a title="flexirest" href="http://bitbucket.org/esmljaos/flexirest/overview/" target="_blank">http://bitbucket.org/esmljaos/flexirest/overview/ </a>(The medium-featured, flexible reStructuredText utility)</li>
</ul>
<p>- <a title="sphinx" href="http://groups.google.fr/group/sphinx-dev/browse_thread/thread/8e97570a6321dd8d?hl=fr" target="_blank">http://groups.google.fr/group/sphinx-dev/browse_thread/thread/8e97570a6321dd8d?hl=fr</a> (&#8216;<em>sphinx theme that could be useful to authors of <strong>sourceforge hosted projects</strong>. The look is more or less the same of the default theme but there are some facilities that could be useful.<br />
A more detailed description of the theme can be found at:</em></p>
<ul>
<li><em><a title="theme sourceforge" href="http://sourceforge.net/apps/trac/gsdview/browser/trunk/doc/themes/sourceforge" target="_blank">http://sourceforge.net/apps/trac/gsdview/browser/trunk/doc/themes/sourceforge </a><br />
</em></li>
<li><a title="theme sourceforge" href="http://sourceforge.net/apps/trac/gsdview/browser/trunk/doc/themes/sourceforge/README.txt" target="_blank"><em>http://sourceforge.net/apps/trac/gsdview/browser/trunk/doc/themes/sourceforge/README.txt</em>&#8216;</a>)</li>
</ul>
<p><em>And, finally, two projects of using it: </em></p>
<ul>
<li><a href="http://gsdview.sourceforge.net/" target="_blank">http://gsdview.sourceforge.net/</a> (&#8216;<em>GSDView (Geo-Spatial Data Viewer) is a lightweight viewer for geo-spatial data and products. It is written in <a href="http://www.python.org/">python</a> and <a href="http://trolltech.com/products/qt">Qt4</a> and it is mainly intended to be a graphical front-end for the <a href="http://www.gdal.org/">GDAL</a> library and tools. GSDView is modular and has a simple plug-in architecture</em>.&#8217;)</li>
<li><a href="http://bestgui.sourceforge.net/" target="_blank">http://bestgui.sourceforge.net/</a> (&#8216;<em>BESTGUI is a Graphical User Interface (GUI) for <a href="http://earth.esa.int/services/best">BEST</a> written in <a href="http://www.python.org/">Python</a> and <a href="http://www.gtk.org/">GTK+</a>. The Basic Envisat SAR Toolbox (<a href="http://earth.esa.int/services/best">BEST</a>) is a collection of executable software tools that has been designed to facilitate the use of <a href="http://earth.esa.int/">ESA</a> (the European Space Agency) SAR data. It operates according to user-generated parameters files. For more detail you should refer to the <a href="http://earth.esa.int/services/best">BEST</a> Home Page</em>.&#8217;)</li>
</ul>
<p style="padding-left:30px;">
Posted in 2009, Documentation, Génie logiciel, python, reStructuredText Tagged: sourceforge, sphinx theme <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gocomments/pvergain.wordpress.com/627/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/comments/pvergain.wordpress.com/627/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godelicious/pvergain.wordpress.com/627/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/delicious/pvergain.wordpress.com/627/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gostumble/pvergain.wordpress.com/627/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/stumble/pvergain.wordpress.com/627/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godigg/pvergain.wordpress.com/627/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/digg/pvergain.wordpress.com/627/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/goreddit/pvergain.wordpress.com/627/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/reddit/pvergain.wordpress.com/627/" /></a> <img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=pvergain.wordpress.com&blog=696018&post=627&subd=pvergain&ref=&feed=1" /></div>]]></content:encoded>
			<wfw:commentRss>http://pvergain.wordpress.com/2009/11/16/python-documentation-news-sphinxnumpydoc-flexirest-sphinx-sourceforge-themegsdviewbestgui/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
	
		<media:content url="http://1.gravatar.com/avatar/9a2b1985a6f239af4bcfaa1f6199b5d4?s=96&#38;d=identicon&#38;r=G" medium="image">
			<media:title type="html">pvergain</media:title>
		</media:content>
	</item>
		<item>
		<title>Python : documentation technique de projets logiciels  : un article de Jacob Kaplan-Moss (partie 1) / Django / sphinx</title>
		<link>http://pvergain.wordpress.com/2009/11/12/python-documentation-technique-de-projets-logiciels-un-article-de-jacob-kaplan-moss-partie-1-django-sphinx/</link>
		<comments>http://pvergain.wordpress.com/2009/11/12/python-documentation-technique-de-projets-logiciels-un-article-de-jacob-kaplan-moss-partie-1-django-sphinx/#comments</comments>
		<pubDate>Thu, 12 Nov 2009 21:45:49 +0000</pubDate>
		<dc:creator>patrick</dc:creator>
				<category><![CDATA[Django]]></category>
		<category><![CDATA[Documentation]]></category>
		<category><![CDATA[Python Web Frameworks]]></category>
		<category><![CDATA[Sphinx]]></category>
		<category><![CDATA[python]]></category>
		<category><![CDATA[Knowledge is power!]]></category>

		<guid isPermaLink="false">http://pvergain.wordpress.com/?p=622</guid>
		<description><![CDATA[Source: http://jacobian.org/writing/great-documentation/what-to-write/ 
Voici quelques extraits intéressants:
I love Django&#8217;s documentation. It clocks in at about 700 pages printed, and most of it is clear, concise, and helpful. I think Django&#8217;s among the best documented open source projects, and nothing makes me prouder.
&#8230;

Today I&#8217;ll discuss the different forms technical documentation can take, and where to focus your [...]<img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=pvergain.wordpress.com&blog=696018&post=622&subd=pvergain&ref=&feed=1" />]]></description>
			<content:encoded><![CDATA[<div class='snap_preview'><br /><p>Source: <a title="doc" href="http://jacobian.org/writing/great-documentation/what-to-write/" target="_blank">http://jacobian.org/writing/great-documentation/what-to-write/ </a></p>
<p>Voici quelques extraits intéressants:</p>
<p style="padding-left:30px;"><em>I love <a href="http://docs.djangoproject.com/" target="_blank">Django&#8217;s documentation</a>. It clocks in at about 700 pages printed, and most of it is clear, concise, and helpful. I think Django&#8217;s among the best documented open source projects, and nothing makes me prouder.</em></p>
<p style="padding-left:30px;"><em>&#8230;<br />
</em></p>
<p style="padding-left:30px;"><strong><em>Today I&#8217;ll discuss the different forms technical documentation can take, and where to focus your efforts.</em></strong></p>
<p>&nbsp;</p>
<p><strong>Tutorials</strong></p>
<p style="padding-left:30px;"><em>Good tutorials are a must as they’re usually the first thing someone sees when trying out a new piece of tech. First impressions are incredibly important: that rush of success as you work through a good tutorial will likely color your future opinions about the project&#8230;.</em><strong>Be quick.</strong> At some conference or another I heard someone — I think it was <a href="http://headrush.typepad.com/">Kathy Sierra</a> — say that, as a rule of thumb, a new user should be able to experience success within thirty minutes&#8230;</p>
<p style="padding-left:30px;">
<p><strong>Topical guides</strong></p>
<p style="padding-left:30px;"><em>This is the meat of your documentation. Once somebody’s learned (from a tutorial) the high-level concepts, they’re going to need to dive into the details of some area or another. Any documentation worth its salt is going to have a whole bunch of these — Django’s got about 35 different topical guides, covering each conceptual area (e.g. <a href="http://docs.djangoproject.com/en/dev/topics/db/models/">models</a>, <a href="http://docs.djangoproject.com/en/dev/topics/http/sessions/">sessions</a>, <a href="http://docs.djangoproject.com/en/dev/topics/testing/">testing</a>, etc.)&#8230;The main goal for topical coverage should be <strong>comprehensiveness</strong>. The reader ought to come away from a close read feeling very comfortable with the topic in question. They should feel that they know the vast majority of the possible options, and more importantly they should understand how all the concepts fit together.</em></p>
<p style="padding-left:30px;"><em>Unfortunately<strong> there aren’t a lot of projects that do these very well</strong>. Most have reasonable tutorials, many have okay-to-good reference material, but most seem to leave the topical guides to books.</em></p>
<p>&nbsp;</p>
<p><strong>Reference</strong></p>
<p style="padding-left:30px;"><em>Finally, you need complete reference for all the public APIs your project provides. These should be designed for those who already know <em>how</em> to use some API, but need to look up the exact arguments some function takes, or how a particular setting influences behavior, etc&#8230;It’s important to point out that reference material is <em>not in any way</em> a substitute for good tutorials and guides!..</em><span style="color:#ff0000;"><strong>Think of guides and reference as partners: guides give you the “why,” and reference gives you the “how.”</strong></span></p>
<p style="padding-left:30px;">
<p style="padding-left:30px;">It’s really tempting to use an auto-documentation tool like <a href="http://java.sun.com/j2se/javadoc/">Javadoc</a> or <a href="http://rdoc.sourceforge.net/">RDoc</a> for reference material.</p>
<p style="padding-left:30px;"><strong>Don’t.</strong></p>
<p style="padding-left:30px;"><strong>Auto-generated documentation is almost worthless</strong>. At best it’s a <em>slightly</em> improved version of simply browsing through the source, but most of the time it’s <em>easier</em> just to read the source than to navigate the bullshit that these autodoc tools produce. <strong>About the only thing auto-generated documentation is good for is filling printed pages when contracts dictate delivery of a certain number of pages of documentation</strong>.<span style="color:#ff0000;"><strong> I feel a particularly deep form of rage every time I click on a “documentation” link and see auto-generated documentation.</strong></span></p>
<p style="padding-left:30px;"><span style="color:#ff0000;"><strong>There’s no substitute for documentation written, organized, and edited <em>by hand</em>.</strong></span></p>
<p style="padding-left:30px;">I’ll even go further and say that auto-generated documentation is <em>worse than useless</em>: <strong>it lets maintainers fool themselves into thinking they have documentation, thus putting off actually writing good reference by hand</strong>. If you don’t have documentation just admit to it. Maybe a volunteer will offer to write some! But don’t lie and give me that auto-documentation crap.</p>
<p style="padding-left:30px;">
<p><strong>A voir</strong></p>
<p><strong>- <a title="Django" href="http://www.djangoproject.com/" target="_blank"> </a></strong><a title="Django" href="http://www.djangoproject.com/" target="_blank">http://www.djangoproject.com/ </a>(&#8216;Django is a high-level Python Web framework that encourages rapid development and clean, pragmatic design.&#8217;)</p>
<p>- <a title="Django fr" href="http://www.django-fr.org/" target="_blank">http://www.django-fr.org/ </a>(&#8216;<em>Django est un framework écrit en <a href="http://www.python.org/">Python</a>. Puissant, il est utilisé par des organisations comme la <a href="http://opensource.arc.nasa.gov/">Nasa</a>,         <a href="http://projects.washingtonpost.com/congress/">le Washington Times</a> et a servi de base à         <a href="http://code.google.com/intl/fr/appengine/">Google App Engine</a>. Mais Django est aussi adapté si vous n&#8217;êtes pas une multinationale ou une agence gouvernementale</em>&#8216;)</p>
<p>&nbsp;</p>
Posted in Django, Documentation, python, Python Web Frameworks, Sphinx Tagged: Knowledge is power! <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gocomments/pvergain.wordpress.com/622/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/comments/pvergain.wordpress.com/622/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godelicious/pvergain.wordpress.com/622/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/delicious/pvergain.wordpress.com/622/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gostumble/pvergain.wordpress.com/622/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/stumble/pvergain.wordpress.com/622/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godigg/pvergain.wordpress.com/622/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/digg/pvergain.wordpress.com/622/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/goreddit/pvergain.wordpress.com/622/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/reddit/pvergain.wordpress.com/622/" /></a> <img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=pvergain.wordpress.com&blog=696018&post=622&subd=pvergain&ref=&feed=1" /></div>]]></content:encoded>
			<wfw:commentRss>http://pvergain.wordpress.com/2009/11/12/python-documentation-technique-de-projets-logiciels-un-article-de-jacob-kaplan-moss-partie-1-django-sphinx/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
	
		<media:content url="http://1.gravatar.com/avatar/9a2b1985a6f239af4bcfaa1f6199b5d4?s=96&#38;d=identicon&#38;r=G" medium="image">
			<media:title type="html">pvergain</media:title>
		</media:content>
	</item>
		<item>
		<title>Python : Distribute 0.6.8 (http://python-distribute.org/) , pip 0.6 , virtualenv 1.4.1 : make the transition today :)</title>
		<link>http://pvergain.wordpress.com/2009/11/10/python-distribute-0-6-8-httppython-distribute-org-pip-0-6-virtualenv-1-4-1-make-the-transition-today/</link>
		<comments>http://pvergain.wordpress.com/2009/11/10/python-distribute-0-6-8-httppython-distribute-org-pip-0-6-virtualenv-1-4-1-make-the-transition-today/#comments</comments>
		<pubDate>Tue, 10 Nov 2009 21:58:35 +0000</pubDate>
		<dc:creator>patrick</dc:creator>
				<category><![CDATA[2009]]></category>
		<category><![CDATA[distribute]]></category>
		<category><![CDATA[package_management]]></category>
		<category><![CDATA[python]]></category>
		<category><![CDATA[Distribute]]></category>
		<category><![CDATA[Tarek Ziadé]]></category>

		<guid isPermaLink="false">http://pvergain.wordpress.com/?p=607</guid>
		<description><![CDATA[Source: http://s3.pixane.com/pip_distribute.png 


curl  -0 http://python-distribute.org/distribute_setup.py &#62; distribute_setup.py
sudo python distribute_setup.py
sudo easy_install -U pip

http://pypi.python.org/pypi/pip/0.6 (‘pip is a replacement for easy_install. It uses mostly the same techniques for finding packages, so packages that were made easy_installable should be pip-installable as well…The main website for pip is pip.openplans.org.  You can also install the in-development version of pip [...]<img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=pvergain.wordpress.com&blog=696018&post=607&subd=pvergain&ref=&feed=1" />]]></description>
			<content:encoded><![CDATA[<div class='snap_preview'><br /><p>Source: <a title="pip distribute" href="http://s3.pixane.com/pip_distribute.png" target="_blank">http://s3.pixane.com/pip_distribute.png </a></p>
<div id="attachment_608"><a href="http://pypi.python.org/pypi/distribute"><img title="pip_distribute" src="http://pvergain.files.wordpress.com/2009/11/pip_distribute.png?w=700&amp;h=525&#038;h=525" alt="distribute, pip virtualenv" width="700" height="525" /></a></div>
<pre class="brush: python;">
curl  -0 http://python-distribute.org/distribute_setup.py &gt; distribute_setup.py
sudo python distribute_setup.py
sudo easy_install -U pip
</pre>
<p><a title="pip " href="http://pypi.python.org/pypi/pip/0.6" target="_blank">http://pypi.python.org/pypi/pip/0.6 </a>(‘pip is a replacement for <a href="http://peak.telecommunity.com/DevCenter/EasyInstall">easy_install</a>. It uses mostly the same techniques for finding packages, so packages that were made easy_installable should be pip-installable as well…The main website for pip is <a href="http://pip.openplans.org/">pip.openplans.org</a>.  You can also install the <a href="http://bitbucket.org/ianb/pip/get/tip.gz#egg=pip-dev">in-development version</a> of pip with <tt>easy_install pip==dev</tt>. ‘)</p>
<p>- <a title="virtualenv" href="http://pypi.python.org/pypi/virtualenv/1.4.2" target="_blank">http://pypi.python.org/pypi/virtualenv/1.4.2 </a>(‘<tt>virtualenv</tt> is a successor to <a href="http://cheeseshop.python.org/pypi/workingenv.py">workingenv</a>, and an extension of <a href="http://peak.telecommunity.com/DevCenter/EasyInstall#creating-a-virtual-python">virtual-python</a>.’)</p>
<p><strong>More informations</strong></p>
<p><strong><br />
</strong></p>
<pre style="padding-left:30px;">source: <a title="distribute 0.6.7" href="http://mail.python.org/pipermail/distutils-sig/2009-November/014229.html" target="_blank">http://mail.python.org/pipermail/distutils-sig/2009-November/014229.html </a>

On behalf of the Distribute team, I am pleased to announce the 0.6.7
release of Distribute.

As usual, availabe at PyPI: <a href="http://pypi.python.org/pypi/distribute">http://pypi.python.org/pypi/distribute</a>

Most noticeable changes in 0.6.7 are:

- now the develop command supports the --user option, so it can use
the per-user site packages (PEP 370)
- the generated scripts now wrap their call to the script entry point
in the standard "if name == 'main'"
- better errors handling in PackageIndex when files and pages are
visited by easy_install
- a virtualenv-compatible version, so the next virtualenv release will
be able to provide a --distribute option.

You can visit <a href="http://pypi.python.org/pypi/distribute#id2">http://pypi.python.org/pypi/distribute#id2</a> for a full
CHANGES list.

We are now starting the 0.6.8 work in parallel of 0.7.x development,
with more bugfixes coming up.
</pre>
<p>- <a title="distribute" href="http://python-distribute.org/" target="_blank">http://python-distribute.org/ </a></p>
<p style="padding-left:30px;"><em>This is just a placeholder for bootstrap files for Distribute, and nightly builds for Distutils</em></p>
<p style="padding-left:30px;"><em> Useful links: </em></p>
<blockquote>
<ul style="padding-left:30px;">
<li><em>Distribute documentation: <a href="http://packages.python.org/distribute">http://packages.python.org/distribute</a></em></li>
<li><em>Bootstrap file to install Distribute: <a href="http://python-distribute.org/distribute_setup.py">http://python-distribute.org/distribute_setup.py</a></em></li>
<li><em>Bootstrap file for zc.buildout: <a href="http://python-distribute.org/bootstrap.py">http://python-distribute.org/bootstrap.py</a></em></li>
</ul>
</blockquote>
<p>- <a title="history" href="http://faassen.n--tree.net/blog/view/weblog/2009/11/09/0" target="_blank">http://faassen.n&#8211;tree.net/blog/view/weblog/2009/11/09/0 </a>(&#8216;A history of Python packaging&#8217;)</p>
<p>- <a title="guido van rossum" href="http://s3.pixane.com/python_comrades.png" target="_blank">http://s3.pixane.com/python_comrades.png </a></p>
<p><a href="http://s3.pixane.com/python_comrades.png"><img class="alignnone size-full wp-image-618" title="python_comrades" src="http://pvergain.files.wordpress.com/2009/11/python_comrades.png?w=800&#038;h=600" alt="guido van rossum" width="800" height="600" /></a></p>
Posted in 2009, distribute, package_management, python Tagged: Distribute, Tarek Ziadé <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gocomments/pvergain.wordpress.com/607/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/comments/pvergain.wordpress.com/607/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godelicious/pvergain.wordpress.com/607/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/delicious/pvergain.wordpress.com/607/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gostumble/pvergain.wordpress.com/607/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/stumble/pvergain.wordpress.com/607/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godigg/pvergain.wordpress.com/607/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/digg/pvergain.wordpress.com/607/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/goreddit/pvergain.wordpress.com/607/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/reddit/pvergain.wordpress.com/607/" /></a> <img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=pvergain.wordpress.com&blog=696018&post=607&subd=pvergain&ref=&feed=1" /></div>]]></content:encoded>
			<wfw:commentRss>http://pvergain.wordpress.com/2009/11/10/python-distribute-0-6-8-httppython-distribute-org-pip-0-6-virtualenv-1-4-1-make-the-transition-today/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
	
		<media:content url="http://1.gravatar.com/avatar/9a2b1985a6f239af4bcfaa1f6199b5d4?s=96&#38;d=identicon&#38;r=G" medium="image">
			<media:title type="html">pvergain</media:title>
		</media:content>

		<media:content url="http://pvergain.files.wordpress.com/2009/11/pip_distribute.png?w=700&#38;h=525" medium="image">
			<media:title type="html">pip_distribute</media:title>
		</media:content>

		<media:content url="http://pvergain.files.wordpress.com/2009/11/python_comrades.png" medium="image">
			<media:title type="html">python_comrades</media:title>
		</media:content>
	</item>
		<item>
		<title>Des nouvelles de python : Guido Van Rossum et la documentation avec sphinx/rest , numpy, scipy, ipython</title>
		<link>http://pvergain.wordpress.com/2009/11/09/des-nouvelles-de-python-guido-van-rossum-et-la-documentation-avec-sphinxrest-numpy-scipy-ipython/</link>
		<comments>http://pvergain.wordpress.com/2009/11/09/des-nouvelles-de-python-guido-van-rossum-et-la-documentation-avec-sphinxrest-numpy-scipy-ipython/#comments</comments>
		<pubDate>Mon, 09 Nov 2009 21:52:42 +0000</pubDate>
		<dc:creator>patrick</dc:creator>
				<category><![CDATA[2009]]></category>
		<category><![CDATA[Doc_sphinx]]></category>
		<category><![CDATA[Documentation]]></category>
		<category><![CDATA[Génie logiciel]]></category>
		<category><![CDATA[Sphinx]]></category>
		<category><![CDATA[python]]></category>
		<category><![CDATA[reStructuredText]]></category>
		<category><![CDATA[Guido Van Rossum]]></category>
		<category><![CDATA[ipython]]></category>
		<category><![CDATA[sequence diagram]]></category>
		<category><![CDATA[UML]]></category>

		<guid isPermaLink="false">http://pvergain.wordpress.com/?p=593</guid>
		<description><![CDATA[Documentation rest/sphinx

- http://neopythonic.blogspot.com/2009/11/python-in-scientific-world.html (&#8216;...After the meeting, Fernando showed me a little about how NumPy is maintained. They have elaborate docstrings that are marked up with a (very light) variant of Sphynx, and they let the user community edit the docstrings through a structured wiki-like setup. Such changes are then presented to the developers for review, [...]<img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=pvergain.wordpress.com&blog=696018&post=593&subd=pvergain&ref=&feed=1" />]]></description>
			<content:encoded><![CDATA[<div class='snap_preview'><br /><h1>Documentation rest/sphinx</h1>
<p><a title="Guido Van Rossum" href="http://neopythonic.blogspot.com/2009/11/python-in-scientific-world.html" target="_blank"></a></p>
<div id="attachment_599" class="wp-caption alignnone" style="width: 130px"><a><img class="size-full wp-image-599" title="guido_van_rossum" src="http://pvergain.files.wordpress.com/2009/11/guido_van_rossum.png?w=120&#038;h=235" alt="guido_van_rossum" width="120" height="235" /></a><p class="wp-caption-text">Guido Van Rossum</p></div>
<p>- <a title="python doc" href="http://neopythonic.blogspot.com/2009/11/python-in-scientific-world.html" target="_blank">http://neopythonic.blogspot.com/2009/11/python-in-scientific-world.html</a> (&#8216;.<em>..After the meeting, Fernando showed me a little about how <a title="Numpy" href="http://numpy.scipy.org/" target="_blank">NumPy</a> is maintained. They have elaborate docstrings that are marked up with a (very light) variant of <a title="sphinx" href="http://sphinx.pocoo.org/" target="_blank">Sphynx</a>, and they let the user community edit the docstrings through a structured wiki-like setup. Such changes are then presented to the developers for review, and can be incorporated into the code base with minimal effort.</em></p>
<div><em>An important aspect of this approach is that the users who edit the docstrings are often scientists who understand the computation being carried out in its scientific context, and who share their knowledge about the code and its background and limitations with other scientists who might be using the same code. This process, together with the facilities in IPython for quickly calling up the docstring for any object, really improves the value of the docstrings for the community. Maybe we could use something like this for the Python standard library; it might be a way that would allow non-programmers to help contribute to the Python project (one of the ideas also mentioned in the diversity discussions</em>).&#8217;)</div>
<div>- <a title="Fernando Perez" href="http://fdoperez.blogspot.com/2009/11/guido-van-rossum-at-uc-berkeleys.html" target="_blank">http://fdoperez.blogspot.com/2009/11/guido-van-rossum-at-uc-berkeleys.html</a> (&#8216;&#8230;I wanted both to thank him for creating and shepherding such a high-quality language for us scientists, and to establish <strong>a good line of communication with him (and indirectly the core python development group)</strong> so that he can understand better what are some of the use patterns, concerns and questions we may have regarding the language.I have the impression that in this we were successful, especially as we had time after the open presentations for a more detailed discussion of how we use and develop our tools.  Most of us in scientific computing end up spending an enormous amount of time with open interpreter sessions, typically <a href="http://ipython.scipy.org/">IPython</a> ones (I started the project in the first place because I wanted a <em>very good</em> interactive environment, beyond Python&#8217;s default one), and in this work mode the key source of understanding for code are good docstrings.  This is an area where I&#8217;ve always been unhappy about the standard library, whose docstrings are typically not very good (and often they are non-existent).  <strong>We showed Guido the fabulous Numpy/Scipy</strong> <a href="http://docs.scipy.org/numpy/Front%20Page/">docstring editor</a> by Pauli Virtanen and Emmanuelle Gouillart, as well as the fact that Numpy has an actual <a href="http://projects.scipy.org/numpy/wiki/CodingStyleGuidelines#docstring-standard">docstring standard</a> that is easy to read yet fairly complete.  I hope that this may lead in the future to an increase in the quality of the Python docstrings, and perhaps even to the adoption of a more detailed docstring standard as part of <a href="http://www.python.org/dev/peps/pep-0008">PEP 8</a>, which I think would be very beneficial to the community at large&#8230;&#8217;)<span style="text-decoration:underline;"><strong>A voir:</strong></span></p>
<p>- <a title="docstring editor" href="http://docs.scipy.org/numpy/Front%20Page/" target="_blank">http://docs.scipy.org/numpy/Front%20Page/ </a></p>
<p>&nbsp;</p>
<p><strong>Extensions sphinx</strong></p>
<ul>
<li><a title="sedit" href="http://pypi.python.org/pypi/sphinxcontrib-sdedit/0.3" target="_blank">http://pypi.python.org/pypi/sphinxcontrib-sdedit/0.3 </a>(&#8216;Sphinx extension for drawing sequence diagrams This package contains the <a href="http://sphinx.pocoo.org/">Sphinx</a> extension for <a href="http://sdedit.sourceforge.net/">sdedit</a>.&#8217;)</li>
</ul>
<p>&nbsp;</p>
</div>
Posted in 2009, Documentation, Doc_sphinx, Génie logiciel, python, reStructuredText, Sphinx Tagged: Guido Van Rossum, ipython, sequence diagram, UML <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gocomments/pvergain.wordpress.com/593/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/comments/pvergain.wordpress.com/593/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godelicious/pvergain.wordpress.com/593/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/delicious/pvergain.wordpress.com/593/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gostumble/pvergain.wordpress.com/593/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/stumble/pvergain.wordpress.com/593/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godigg/pvergain.wordpress.com/593/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/digg/pvergain.wordpress.com/593/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/goreddit/pvergain.wordpress.com/593/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/reddit/pvergain.wordpress.com/593/" /></a> <img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=pvergain.wordpress.com&blog=696018&post=593&subd=pvergain&ref=&feed=1" /></div>]]></content:encoded>
			<wfw:commentRss>http://pvergain.wordpress.com/2009/11/09/des-nouvelles-de-python-guido-van-rossum-et-la-documentation-avec-sphinxrest-numpy-scipy-ipython/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
	
		<media:content url="http://1.gravatar.com/avatar/9a2b1985a6f239af4bcfaa1f6199b5d4?s=96&#38;d=identicon&#38;r=G" medium="image">
			<media:title type="html">pvergain</media:title>
		</media:content>

		<media:content url="http://pvergain.files.wordpress.com/2009/11/guido_van_rossum.png" medium="image">
			<media:title type="html">guido_van_rossum</media:title>
		</media:content>
	</item>
		<item>
		<title>fOSSa Conference &#8211; Free and Open Source Software Academic Conference,  november 17-18, 2009 Grenoble</title>
		<link>http://pvergain.wordpress.com/2009/10/29/fossa-conference-free-and-open-source-software-academic-conference-november-17-18-2009-grenoble/</link>
		<comments>http://pvergain.wordpress.com/2009/10/29/fossa-conference-free-and-open-source-software-academic-conference-november-17-18-2009-grenoble/#comments</comments>
		<pubDate>Thu, 29 Oct 2009 21:37:38 +0000</pubDate>
		<dc:creator>patrick</dc:creator>
				<category><![CDATA[2009]]></category>
		<category><![CDATA[conference]]></category>
		<category><![CDATA[licence libre]]></category>
		<category><![CDATA[logiciel libre]]></category>
		<category><![CDATA[open source]]></category>
		<category><![CDATA[fOSSa]]></category>
		<category><![CDATA[Grenoble]]></category>

		<guid isPermaLink="false">http://pvergain.wordpress.com/?p=569</guid>
		<description><![CDATA[Source: http://www.ow2.org/view/Events/fOSSaConferenceGrenobleFrance 
&#160;
Date: November 17-18, 2009
Venue: World Trade Center, Grenoble, France
Practical information, detailed program and registration: http://fossa.inrialpes.fr/2009/
Conference overview
The &#8220;fOSSa&#8221; conference (Free/Open Source Software Academics) is co-organised by INRIA and OW2 Europe Local Chapter. It will review Open Source fundamentals and will present innovating Open Source project as well as communities experiences. fOSSa is the first [...]<img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=pvergain.wordpress.com&blog=696018&post=569&subd=pvergain&ref=&feed=1" />]]></description>
			<content:encoded><![CDATA[<div class='snap_preview'><br /><p>Source: <a title="fOSSa" href="http://www.ow2.org/view/Events/fOSSaConferenceGrenobleFrance" target="_blank">http://www.ow2.org/view/Events/fOSSaConferenceGrenobleFrance </a></p>
<div id="attachment_570" class="wp-caption aligncenter" style="width: 310px"><img class="size-medium wp-image-570" title="fossa-big" src="http://pvergain.files.wordpress.com/2009/10/fossa-big1.png?w=300&#038;h=163" alt="fossa-big" width="300" height="163" /><p class="wp-caption-text">fOSSa</p></div>
<p>&nbsp;</p>
<p><strong><span style="text-decoration:underline;">Date</span>:</strong> November 17-18, 2009<br />
Venue: World Trade Center, Grenoble, France<br />
Practical information, detailed program and registration: <a title="fOSSa" href="http://fossa.inrialpes.fr/2009/" target="_blank">http://fossa.inrialpes.fr/2009/</a></p>
<p><span style="text-decoration:underline;"><strong>Conference overview</strong></span><br />
The &#8220;fOSSa&#8221; conference (Free/Open Source Software Academics) is co-organised by INRIA and OW2 Europe Local Chapter. It will review Open Source fundamentals and will present innovating Open Source project as well as communities experiences. fOSSa is the first international Open Source Conference event located in Grenoble! The fOSSa audience mainly focuses on academia and research centres but does not close the door to industrials as in many cases academia needs industrials and vice versa: we believe that Open Source model can improve such kind of collaboration in a much more natural way.</p>
<p><span style="text-decoration:underline;"><strong>DAY 1 is focusing on the Open Source model basics:</strong></span></p>
<p>1. OSS and Benefits for Academic projects<br />
2. OSS and Innovation for Academic projects<br />
3. OSS and Business Models for Academic projects<br />
4. OSS and the Law for Academic projects<br />
5. OSS and Communities for Academic projects<br />
6. OSS and European Commission fo Academic projects<br />
7. OSS and Market Needs for Academic projects</p>
<p><span style="text-decoration:underline;"><strong>DAY 2, practical session including with real life examples of the OSS fundamentals, will address: </strong></span></p>
<p>1. OSS and Collaboration for Academic projects<br />
2. OSS and Promotion for Academic projects<br />
3. OSS and Governance for Academic projects<br />
4. OSS and Quality for Academic projects<br />
5. OSS and the Law for Academic projects</p>
<p><span style="text-decoration:underline;"><strong>Day 2, 10-10-10 presentation</strong></span></p>
<p>In parallel, OW2 academic projects will be presented in a 10-10-10 formula style1. PLUMES/FEATHER community will present scientific Open Source academic projects, and sessions will be booked for Open Source Start-up&#8217;s presentation.</p>
<p>(1) 10 minutes presentation -10 minutes demo -10 minutes questions/answers.</p>
<p><span style="text-decoration:underline;"><strong>Participants</strong></span><br />
Apache, Eclipse, Engineering, HP Fossology, INRIA, Mandriva, OW2, Sun Microsystem, University Paris VII, University of Milano&#8230;</p>
<p>&nbsp;</p>
<p>&nbsp;</p>
<p>&nbsp;</p>
<p>&nbsp;</p>
Posted in 2009, conference, licence libre, logiciel libre, open source Tagged: fOSSa, Grenoble <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gocomments/pvergain.wordpress.com/569/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/comments/pvergain.wordpress.com/569/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godelicious/pvergain.wordpress.com/569/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/delicious/pvergain.wordpress.com/569/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gostumble/pvergain.wordpress.com/569/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/stumble/pvergain.wordpress.com/569/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godigg/pvergain.wordpress.com/569/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/digg/pvergain.wordpress.com/569/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/goreddit/pvergain.wordpress.com/569/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/reddit/pvergain.wordpress.com/569/" /></a> <img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=pvergain.wordpress.com&blog=696018&post=569&subd=pvergain&ref=&feed=1" /></div>]]></content:encoded>
			<wfw:commentRss>http://pvergain.wordpress.com/2009/10/29/fossa-conference-free-and-open-source-software-academic-conference-november-17-18-2009-grenoble/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
	
		<media:content url="http://1.gravatar.com/avatar/9a2b1985a6f239af4bcfaa1f6199b5d4?s=96&#38;d=identicon&#38;r=G" medium="image">
			<media:title type="html">pvergain</media:title>
		</media:content>

		<media:content url="http://pvergain.files.wordpress.com/2009/10/fossa-big1.png?w=300" medium="image">
			<media:title type="html">fossa-big</media:title>
		</media:content>
	</item>
		<item>
		<title>fOSSa conférence sur le libre/open-source d&#8217;envergure Internationale les 17-18 novembre 2009 à Grenoble</title>
		<link>http://pvergain.wordpress.com/2009/10/29/fossa-conference-sur-le-libreopen-source-denvergure-internationale-les-17-18-novembre-2009-a-grenoble/</link>
		<comments>http://pvergain.wordpress.com/2009/10/29/fossa-conference-sur-le-libreopen-source-denvergure-internationale-les-17-18-novembre-2009-a-grenoble/#comments</comments>
		<pubDate>Thu, 29 Oct 2009 21:18:42 +0000</pubDate>
		<dc:creator>patrick</dc:creator>
				<category><![CDATA[2009]]></category>
		<category><![CDATA[licence libre]]></category>
		<category><![CDATA[logiciel libre]]></category>
		<category><![CDATA[open source]]></category>
		<category><![CDATA[17-18 novembre 2009]]></category>
		<category><![CDATA[conférence]]></category>
		<category><![CDATA[fOSSa]]></category>
		<category><![CDATA[Grenoble]]></category>

		<guid isPermaLink="false">http://pvergain.wordpress.com/?p=565</guid>
		<description><![CDATA[Source
INRIA Rhone-Alpes / D2T / OW2 Europe Local Chapter
fOSSa Steering Committee / QualiPSo / NESSI OSS WG

fOSSa (Free Open Source Software for Academia) est organisée conjointement par le chapitre local Europe d&#8217;OW2 et l&#8217;INRIA.
L&#8217;histoire du logiciel libre débute dans les années 70 grâce aux universitaires et chercheurs académiques: pour cette communauté, distribuer un code informatique sous une [...]<img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=pvergain.wordpress.com&blog=696018&post=565&subd=pvergain&ref=&feed=1" />]]></description>
			<content:encoded><![CDATA[<div class='snap_preview'><br /><p><strong>Source</strong></p>
<p>INRIA Rhone-Alpes / D2T / OW2 Europe Local Chapter<br />
fOSSa Steering Committee / QualiPSo / NESSI OSS WG</p>
<p style="text-align:center;"><img class="alignnone size-medium wp-image-566" title="fossa-big" src="http://pvergain.files.wordpress.com/2009/10/fossa-big.png?w=300&#038;h=163" alt="fOSSa" width="300" height="163" /></p>
<p>fOSSa (Free Open Source Software for Academia) est organisée conjointement par le chapitre local Europe d&#8217;OW2 et l&#8217;INRIA.</p>
<p>L&#8217;histoire du logiciel libre débute dans les années 70 grâce aux universitaires et chercheurs académiques: pour cette communauté, distribuer un code informatique sous une licence permissive était une règle naturelle. Depuis, le monde du logiciel libre connaît un succès extraordinaire à travers, en outre, le monde industriel. Cependant, les objectifs initiaux défini par le monde académique semble, aujourd&#8217;hui, être oubliés.</p>
<p>Le programme couvre les aspects fondamentaux du logiciel libre/open-source (modèles économiques, licences, collaboration, communautés, promotion, exploitation) et <strong>propose des retours d&#8217;expérience ainsi que des présentations de projets innovants</strong>.  Elle s&#8217;adresse au monde académique/universitaire, mais aussi aux industriels dans la mesure où les relations recherche/industrie sont de plus en plus souvent au coeur de développements collaboratifs libres/open-source: <strong>fOSSa propose de repositionner le Libre au centre des collaborations recherche-industrie.</strong></p>
<p>Les intervenants sont, en autre, Clément Escoffier (Apache), Ralph Mueller (Directeur Fondation Eclipse Europe), HP Fossology (Bob Gobeille et Bruno Cornec), INRIA (Luc Grateau et Jean Bernard Stefani), Arnaud Laprévote (Directeur R&amp;D Mandriva), Cédric Thomas (OW2 Consortium CEO), Roberto Di Cosmo (CIRILL &amp; Mancoozi), Plumes (Jean Luc Archimbaud et Teresa Gomez DIaz) &#8230;</p>
<p><strong><strong>Date :</strong> 17-18 Novembre 2009</strong><br />
<strong>Lieu :</strong> World Trade Center &#8211; Grenoble &#8211; France<br />
<strong>Programme &amp; Inscription (gratuite): </strong> <a href="http://www.ow2.org/fossaconference" target="_blank">http://www.ow2.org/fossaconference</a></p>
Posted in 2009, licence libre, logiciel libre, open source Tagged: 17-18 novembre 2009, conférence, fOSSa, Grenoble <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gocomments/pvergain.wordpress.com/565/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/comments/pvergain.wordpress.com/565/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godelicious/pvergain.wordpress.com/565/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/delicious/pvergain.wordpress.com/565/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gostumble/pvergain.wordpress.com/565/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/stumble/pvergain.wordpress.com/565/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godigg/pvergain.wordpress.com/565/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/digg/pvergain.wordpress.com/565/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/goreddit/pvergain.wordpress.com/565/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/reddit/pvergain.wordpress.com/565/" /></a> <img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=pvergain.wordpress.com&blog=696018&post=565&subd=pvergain&ref=&feed=1" /></div>]]></content:encoded>
			<wfw:commentRss>http://pvergain.wordpress.com/2009/10/29/fossa-conference-sur-le-libreopen-source-denvergure-internationale-les-17-18-novembre-2009-a-grenoble/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
	
		<media:content url="http://1.gravatar.com/avatar/9a2b1985a6f239af4bcfaa1f6199b5d4?s=96&#38;d=identicon&#38;r=G" medium="image">
			<media:title type="html">pvergain</media:title>
		</media:content>

		<media:content url="http://pvergain.files.wordpress.com/2009/10/fossa-big.png?w=300" medium="image">
			<media:title type="html">fossa-big</media:title>
		</media:content>
	</item>
		<item>
		<title>Documentation de python 2.6 grâce à sphinx</title>
		<link>http://pvergain.wordpress.com/2009/10/27/documentation-de-python-2-6-grace-a-sphinx/</link>
		<comments>http://pvergain.wordpress.com/2009/10/27/documentation-de-python-2-6-grace-a-sphinx/#comments</comments>
		<pubDate>Mon, 26 Oct 2009 22:11:11 +0000</pubDate>
		<dc:creator>patrick</dc:creator>
				<category><![CDATA[Documentation]]></category>
		<category><![CDATA[Sphinx]]></category>
		<category><![CDATA[python]]></category>
		<category><![CDATA[Georg Brandl]]></category>
		<category><![CDATA[REST]]></category>
		<category><![CDATA[reStructuredText]]></category>

		<guid isPermaLink="false">http://pvergain.wordpress.com/?p=562</guid>
		<description><![CDATA[L&#8217;utilisation de sphinx pour la documentation python faisait partie des nouveautés de la version 2.6.1 sortie le 1er octobre 2008.
- http://docs.python.org/whatsnew/2.6.html 

New Documentation Format: reStructuredText Using Sphinx¶
The Python documentation was written using LaTeX since the project started around 1989.  In the 1980s and early 1990s, most documentation was printed out for later study, not [...]<img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=pvergain.wordpress.com&blog=696018&post=562&subd=pvergain&ref=&feed=1" />]]></description>
			<content:encoded><![CDATA[<div class='snap_preview'><br /><p>L&#8217;utilisation de sphinx pour la <a title="doc python" href="http://docs.python.org/index.html" target="_blank">documentation python</a> faisait partie des nouveautés de la version 2.6.1 sortie le 1er octobre 2008.</p>
<p>- <a title="Sphinx python" href="http://docs.python.org/whatsnew/2.6.html" target="_blank">http://docs.python.org/whatsnew/2.6.html </a></p>
<div id="new-documentation-format-restructuredtext-using-sphinx">
<h3 style="padding-left:30px;"><em>New Documentation Format: reStructuredText Using Sphinx<a title="Permalink to this headline" href="http://docs.python.org/whatsnew/2.6.html#new-documentation-format-restructuredtext-using-sphinx">¶</a></em></h3>
<p style="padding-left:30px;"><em>The Python documentation was written using LaTeX since the project started around 1989.  In the 1980s and early 1990s, most documentation was printed out for later study, not viewed online. LaTeX was widely used because it provided attractive printed output while remaining straightforward to write once the basic rules of the markup were learned.</em></p>
<p style="padding-left:30px;"><em>Today LaTeX is still used for writing publications destined for printing, but the landscape for programming tools has shifted.  We no longer print out reams of documentation; instead, we browse through it online and HTML has become the most important format to support. Unfortunately, converting LaTeX to HTML is fairly complicated and Fred L. Drake Jr., the long-time Python documentation editor, spent a lot of time maintaining the conversion process.  Occasionally people would suggest converting the documentation into SGML and later XML, but performing a good conversion is a major task and no one ever committed the time required to finish the job.</em></p>
<p style="padding-left:30px;"><strong><em>During the 2.6 development cycle, Georg Brandl put a lot of effort into building a new toolchain for processing the documentation.  The resulting package is called Sphinx, and is available from <a href="http://sphinx.pocoo.org/">http://sphinx.pocoo.org/</a>.</em></strong></p>
<p style="padding-left:30px;"><em><span style="color:#ff0000;"><strong>Sphinx concentrates on HTML output, producing attractively styled and modern HTML</strong></span>; printed output is still supported through conversion to LaTeX.  <strong>The input format is reStructuredText, a markup syntax supporting custom extensions and directives that is commonly used in the Python community.</strong></em></p>
<p style="padding-left:30px;"><em>Sphinx is a standalone package that can be used for writing, and almost two dozen other projects (<a href="http://sphinx.pocoo.org/examples.html">listed on the Sphinx web site</a>) have adopted Sphinx as their documentation tool.</em></p>
<div style="padding-left:30px;">
<p><span style="text-decoration:underline;"><strong><em>See also:</em></strong></span></p>
<dl>
<dt><em><a href="http://docs.python.org/documenting/index.html#documenting-index">Documenting Python (</a></em><a href="http://docs.python.org/documenting/index.html#documenting-index">http://docs.python.org/documenting/index.html#documenting-index)</a></dt>
<dd><em>Describes how to write for Python’s documentation.</em></dd>
<dt><em><a href="http://sphinx.pocoo.org/">Sphinx</a></em></dt>
<dd><em>Documentation and code for the Sphinx toolchain.</em></dd>
<dt><em><a href="http://docutils.sf.net/">Docutils</a></em></dt>
<dd><em>The underlying reStructuredText parser and toolset.</em></dd>
</dl>
</div>
</div>
<div></div>
<div><strong>Voir aussi <img src='http://s.wordpress.com/wp-includes/images/smilies/icon_smile.gif' alt=':)' class='wp-smiley' /> </strong></div>
<div></div>
<div>- <a title="georg brandl" href="http://pyfound.blogspot.com/2008/08/georg-brandl-and-brett-cannon-to.html" target="_blank">http://pyfound.blogspot.com/2008/08/georg-brandl-and-brett-cannon-to.html</a> (&#8216;At the July (2008) Board meeting of the PSF Board of Directors, <a href="http://www.python.org/community/awards/psf-awards/">PSF Community Awards</a> were awarded to Georg Brandl and Brett Cannon.Georg has been an enthusiastic contributor to the core for several years, <span style="color:#ff0000;"><strong>and a while ago stunned the Python development world by building </strong></span><a href="http://sphinx.pocoo.org/"><span style="color:#ff0000;"><strong>the Sphinx</strong></span> documentation system</a> as an alternative to the LaTeX-based system we had been using previously, and converting <a href="http://docs.python.org/dev/">the Python documentation</a> to use it. Brett has also been an active core developer for many years, but was nominated for his infrastructure work in migrating <a href="http://bugs.python.org/">the Python bug-tracking system</a> off of SourceForge to our own Roundup instance, and for his efforts keeping <a href="http://www.python.org/dev/intro/">the Python developer introduction</a> updated. Georg and Brett richly deserve recognition for their contributions. <strong>Congratulations to Brett and Georg, and thanks for all your hard work!</strong>&#8216;)</div>
<p> </p>
Posted in Documentation, python, Sphinx Tagged: Georg Brandl, REST, reStructuredText <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gocomments/pvergain.wordpress.com/562/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/comments/pvergain.wordpress.com/562/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godelicious/pvergain.wordpress.com/562/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/delicious/pvergain.wordpress.com/562/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gostumble/pvergain.wordpress.com/562/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/stumble/pvergain.wordpress.com/562/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godigg/pvergain.wordpress.com/562/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/digg/pvergain.wordpress.com/562/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/goreddit/pvergain.wordpress.com/562/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/reddit/pvergain.wordpress.com/562/" /></a> <img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=pvergain.wordpress.com&blog=696018&post=562&subd=pvergain&ref=&feed=1" /></div>]]></content:encoded>
			<wfw:commentRss>http://pvergain.wordpress.com/2009/10/27/documentation-de-python-2-6-grace-a-sphinx/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
	
		<media:content url="http://1.gravatar.com/avatar/9a2b1985a6f239af4bcfaa1f6199b5d4?s=96&#38;d=identicon&#38;r=G" medium="image">
			<media:title type="html">pvergain</media:title>
		</media:content>
	</item>
		<item>
		<title>Comment débuter pour documenter un projet python, C, admin, etc&#8230; avec le logiciel python sphinx de Georg Brandl</title>
		<link>http://pvergain.wordpress.com/2009/10/25/comment-debuter-pour-documenter-un-projet-python-c-admin-etc-avec-le-logiciel-python-sphinx-de-georg-brandl/</link>
		<comments>http://pvergain.wordpress.com/2009/10/25/comment-debuter-pour-documenter-un-projet-python-c-admin-etc-avec-le-logiciel-python-sphinx-de-georg-brandl/#comments</comments>
		<pubDate>Sat, 24 Oct 2009 22:16:32 +0000</pubDate>
		<dc:creator>patrick</dc:creator>
				<category><![CDATA[2009]]></category>
		<category><![CDATA[Années]]></category>
		<category><![CDATA[Documentation]]></category>
		<category><![CDATA[Génie logiciel]]></category>
		<category><![CDATA[Sphinx]]></category>
		<category><![CDATA[python]]></category>
		<category><![CDATA[Birkenfeld]]></category>
		<category><![CDATA[Georg Brandl]]></category>
		<category><![CDATA[http://pythonic.pocoo.org/tags/sphinx]]></category>
		<category><![CDATA[http://twitter.com/birkenfeld]]></category>
		<category><![CDATA[projet c]]></category>
		<category><![CDATA[projet python]]></category>
		<category><![CDATA[REST]]></category>
		<category><![CDATA[reStructuredText]]></category>

		<guid isPermaLink="false">http://pvergain.wordpress.com/?p=555</guid>
		<description><![CDATA[Voici quelques liens pour bien débuter une documentation d&#8217;un projet avec sphinx. J&#8217;ai commencé à écrire une page http://pvergain.wordpress.com/sphinx-doc/ pour rassembler la documentation qui pour moi était la plus intéressante. J&#8217;ai inséré ci-dessous la liste des principaux liens.
Je mets à jour une liste des projets utilisant sphinx. Les 3 derniers en date (22 octobre 2009) [...]<img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=pvergain.wordpress.com&blog=696018&post=555&subd=pvergain&ref=&feed=1" />]]></description>
			<content:encoded><![CDATA[<div class='snap_preview'><br /><div id="attachment_556" class="wp-caption alignnone" style="width: 310px"><img class="size-medium wp-image-556" title="sphinx" src="http://pvergain.files.wordpress.com/2009/10/sphinx.png?w=300&#038;h=52" alt="sphinx" width="300" height="52" /><p class="wp-caption-text">sphinx</p></div>
<p>Voici quelques liens pour bien débuter une documentation d&#8217;un projet avec <a title="sphinx" href="http://sphinx.pocoo.org/" target="_blank">sphinx</a>. J&#8217;ai commencé à écrire une page <a title="sphinx" href="http://pvergain.wordpress.com/sphinx-doc/" target="_blank">http://pvergain.wordpress.com/sphinx-doc/</a> pour rassembler la documentation qui pour moi était la plus intéressante. J&#8217;ai inséré ci-dessous la liste des principaux liens.</p>
<p>Je mets à jour une liste des projets utilisant sphinx. Les 3 derniers en date (22 octobre 2009) sont <a title="ase sphinx documentation" href="https://wiki.fysik.dtu.dk/ase/" target="_blank">https://wiki.fysik.dtu.dk/ase/</a>,  <a title="gpaw" href="https://wiki.fysik.dtu.dk/gpaw/index.html" target="_blank">https://wiki.fysik.dtu.dk/gpaw/index.html</a> et <a title="openalea" href="http://openalea.gforge.inria.fr/doc/openalea/doc/build/html/index.html" target="_blank">http://openalea.gforge.inria.fr/doc/openalea/doc/build/html/index.html</a>.</p>
<p><strong>Merci à Georg Brandl alias Birkenfeld (</strong><a title="Birkenfeld" href="http://twitter.com/birkenfeld" target="_blank">http://twitter.com/birkenfeld</a>, <a title="Birkenfeld" href="http://pythonic.pocoo.org/" target="_blank">http://pythonic.pocoo.org/</a> , <a title="Birkenfeld" href="http://pythonic.pocoo.org/tags/sphinx" target="_blank">http://pythonic.pocoo.org/tags/sphinx</a> ) et aussi Uli Fouquet, Andre Roberge, Armin Ronacher,  Tim Golden and Mark Summerfield <strong> pour ce magnifique logiciel</strong>.</p>
<p><img class="alignnone size-full wp-image-518" title="gb_bigger" src="http://pvergain.files.wordpress.com/2009/10/gb_bigger.jpg?w=73&#038;h=73" alt="gb_bigger" width="73" height="73" /></p>
<ul>
<li><a title="sphinx" href="http://sphinx.pocoo.org/" target="_blank">http://sphinx.pocoo.org/</a> (’Sphinx is a tool that makes it easy to create intelligent and beautiful documentation, written by Georg Brandl and licensed under the BSD license.It was originally created to translate <a href="http://docs.python.org/dev/">the     new Python documentation</a>, and it has excellent support for the documentation of Python projects, but other documents can be written with it too. Of course, this site is also created from reStructuredText sources using Sphinx!’)</li>
<li><a title="sphinx" href="http://matplotlib.sourceforge.net/sampledoc/" target="_blank">http://matplotlib.sourceforge.net/sampledoc/ </a>(’<em>This is a tutorial introduction to quickly get you up and running with your own sphinx documentation system. We’ll cover installing sphinx, customizing the look and feel, using custom extensions for embedding plots, inheritance diagrams, syntax highlighted ipython sessions and more. If you follow along the tutorial, you’ll start with nothing and end up with this site – it’s the bootstrapping documentation tutorial that writes itself!</em>‘)</li>
<li><a title="sphinx getting started" href="http://matplotlib.sourceforge.net/sampledoc/getting_started.html" target="_blank">http://matplotlib.sourceforge.net/sampledoc/getting_started.html </a>(’Installing your doc directory’)</li>
<li><a title="sphinx" href="http://matplotlib.sourceforge.net/sampledoc/cheatsheet.html#this-file" target="_blank">http://matplotlib.sourceforge.net/sampledoc/cheatsheet.html#this-file </a></li>
<li>Very nice sphinx doc:
<ul>
<li><a title="ase sphinx documentation" href="https://wiki.fysik.dtu.dk/ase/" target="_blank">https://wiki.fysik.dtu.dk/ase/</a> (’<em>The Atomic Simulation Environment (ASE) is the common part of the simulation tools developed at <a href="http://www.camd.dtu.dk/">CAMd</a>.  ASE provides <a href="http://www.python.org/">Python</a> modules for manipulating atoms, analyzing simulations, visualization etc</em>.’)
<ul>
<li><a title="ase doc sphinx" href="https://wiki.fysik.dtu.dk/ase/development/writing_documentation_ase.html" target="_blank">https://wiki.fysik.dtu.dk/ase/development/writing_documentation_ase.html </a></li>
</ul>
</li>
<li><a title="mathplotlib" href="http://matplotlib.sourceforge.net/" target="_blank">http://matplotlib.sourceforge.net/ </a></li>
<li><a title="buildout" href="http://www.buildout.org/index.html" target="_blank">http://www.buildout.org/index.html</a> (’<em>Buildout is a Python-based build system for creating, assembling and deploying applications from multiple parts, some of which may be non-Python-based. It lets you create a buildout configuration and reproduce the same software later.</em> ‘)</li>
<li><a title="gpaw" href="https://wiki.fysik.dtu.dk/gpaw/index.html" target="_blank">https://wiki.fysik.dtu.dk/gpaw/index.html </a>(’<em>GPAW is a density-functional theory (DFT) <a href="http://www.python.org/">Python</a> code based on the projector-augmented wave (<a href="https://wiki.fysik.dtu.dk/gpaw/documentation/literature.html#literature"><em>PAW</em></a>) method.  It uses real-space uniform grids and multigrid methods or atom-centered basis-functions.  Read more about <a href="https://wiki.fysik.dtu.dk/gpaw/features_and_algorithms.html#features-and-algorithms"><em>its features and the algorithms used</em></a></em>.’)
<ul>
<li><a title="doc" href="https://wiki.fysik.dtu.dk/gpaw/devel/writing_documentation.html" target="_blank">https://wiki.fysik.dtu.dk/gpaw/devel/writing_documentation.html </a></li>
</ul>
</li>
<li><a title="sagemath" href="http://sagemath.org/doc/developer/index.html" target="_blank">http://sagemath.org/doc/developer/index.html </a>(’<em>Sage is a free mathematics software system. It is implemented using Python, Cython, and C++, uses GAP, GSL, Matplotlib, Maxima, MWRANK, NetworkX, NTL, Numpy, PARI, Singular and many specialized systems and libraries. It is free and open source, and is available under the terms of the GNU Public License. Some parts are available under compatible licenses</em>.’)</li>
<li><a title="openalea" href="http://openalea.gforge.inria.fr/doc/openalea/doc/build/html/index.html" target="_blank">http://openalea.gforge.inria.fr/doc/openalea/doc/build/html/index.html </a>(’<strong>OpenAlea</strong> is an open source project primarily aimed at the plant research community, with a particular focus on Plant Architecture Modeling at different scales. It is a distributed collaborative effort to develop Python libraries and tools which address the needs of current and future work in Plant Architecture modeling’)
<ul>
<li><a title="sphinx tools" href="http://openalea.gforge.inria.fr/doc/openalea/misc/doc/html/misc/openalea_misc_sphinx_tools_ref.html#module-sphinx_tools" target="_blank">http://openalea.gforge.inria.fr/doc/openalea/misc/doc/html/misc/openalea_misc_sphinx_tools_ref.html#module-sphinx_tools</a></li>
<li><a title="gforge inria" href="https://gforge.inria.fr/frs/?group_id=79" target="_blank">https://gforge.inria.fr/frs/?group_id=79 </a></li>
</ul>
<ul>
<li>
<pre>svn checkout svn://scm.gforge.inria.fr/svn/openalea/trunk openalea</pre>
</li>
</ul>
</li>
</ul>
</li>
</ul>
<p><span style="text-decoration:underline;"><strong>Projets utilisant sphinx</strong></span></p>
<ul>
<li><a title="sphinx" href="http://sphinx.pocoo.org/examples.html" target="_blank">http://sphinx.pocoo.org/examples.html<br />
</a></p>
<ul>
<li>APSW: <a href="http://apsw.googlecode.com/svn/publish/index.html">http://apsw.googlecode.com/svn/publish/index.html</a></li>
<li>boostmpi: <a href="http://documen.tician.de/boostmpi/">http://documen.tician.de/boostmpi/</a></li>
<li>Calibre: <a href="http://calibre.kovidgoyal.net/user_manual/">http://calibre.kovidgoyal.net/user_manual/</a></li>
<li>Chaco: <a href="http://code.enthought.com/projects/chaco/docs/html/">http://code.enthought.com/projects/chaco/docs/html/</a></li>
<li>CodePy: <a href="http://documen.tician.de/codepy/">http://documen.tician.de/codepy/</a></li>
<li>Cython: <a href="http://docs.cython.org/">http://docs.cython.org/</a></li>
<li>C\C++ Python language binding project: <a href="http://language-binding.net/index.html">http://language-binding.net/index.html</a></li>
<li>Director: <a href="http://packages.python.org/director/">http://packages.python.org/director/</a></li>
<li>Djagios: <a href="http://djagios.org/">http://djagios.org/</a></li>
<li>Django: <a href="http://docs.djangoproject.com/">http://docs.djangoproject.com/</a></li>
<li>F2py: <a href="http://www.f2py.org/html/">http://www.f2py.org/html/</a></li>
<li>GeoDjango: <a href="http://geodjango.org/docs/">http://geodjango.org/docs/</a></li>
<li>GeoServer: <a href="http://docs.geoserver.org/">http://docs.geoserver.org/</a></li>
<li>Glashammer: <a href="http://glashammer.org/">http://glashammer.org/</a></li>
<li>Grok: <a href="http://grok.zope.org/doc/current/">http://grok.zope.org/doc/current/</a></li>
<li>Hedge: <a href="http://documen.tician.de/hedge/">http://documen.tician.de/hedge/</a></li>
<li>IFM: <a href="http://fluffybunny.memebot.com/ifm-docs/index.html">http://fluffybunny.memebot.com/ifm-docs/index.html</a></li>
<li>Jinja: <a href="http://jinja.pocoo.org/2/documentation/">http://jinja.pocoo.org/2/documentation/</a></li>
<li>LEPL: <a href="http://www.acooke.org/lepl/">http://www.acooke.org/lepl/</a></li>
<li>MapServer: <a href="http://mapserver.org/">http://mapserver.org/</a></li>
<li>Matplotlib: <a href="http://matplotlib.sourceforge.net/">http://matplotlib.sourceforge.net/</a></li>
<li>Mayavi: <a href="http://code.enthought.com/projects/mayavi/docs/development/html/mayavi">http://code.enthought.com/projects/mayavi/docs/development/html/mayavi</a></li>
<li>MeshPy: <a href="http://documen.tician.de/meshpy/">http://documen.tician.de/meshpy/</a></li>
<li>MirrorBrain: <a href="http://mirrorbrain.org/docs/">http://mirrorbrain.org/docs/</a></li>
<li>Mixin.com: <a href="http://dev.mixin.com/">http://dev.mixin.com/</a></li>
<li>mpmath: <a href="http://mpmath.googlecode.com/svn/trunk/doc/build/index.html">http://mpmath.googlecode.com/svn/trunk/doc/build/index.html</a></li>
<li>MyHDL: <a href="http://www.myhdl.org/doc/0.6/">http://www.myhdl.org/doc/0.6/</a></li>
<li>NetworkX: <a href="http://networkx.lanl.gov/">http://networkx.lanl.gov/</a></li>
<li>NumPy: <a href="http://docs.scipy.org/doc/numpy/reference/">http://docs.scipy.org/doc/numpy/reference/</a></li>
<li>ObjectListView: <a href="http://objectlistview.sourceforge.net/python">http://objectlistview.sourceforge.net/python</a></li>
<li>OpenEXR: <a href="http://excamera.com/articles/26/doc/index.html">http://excamera.com/articles/26/doc/index.html</a></li>
<li>OpenLayers: <a href="http://docs.openlayers.org/">http://docs.openlayers.org/</a></li>
<li>openWNS: <a href="http://docs.openwns.org/">http://docs.openwns.org/</a></li>
<li>Paste: <a href="http://pythonpaste.org/script/">http://pythonpaste.org/script/</a></li>
<li>Paver: <a href="http://www.blueskyonmars.com/projects/paver/">http://www.blueskyonmars.com/projects/paver/</a></li>
<li>Py on Windows: <a href="http://timgolden.me.uk/python-on-windows/">http://timgolden.me.uk/python-on-windows/</a></li>
<li>PyCuda: <a href="http://documen.tician.de/pycuda/">http://documen.tician.de/pycuda/</a></li>
<li>PyEphem: <a href="http://rhodesmill.org/pyephem/">http://rhodesmill.org/pyephem/</a></li>
<li>Pyevolve: <a href="http://pyevolve.sourceforge.net/">http://pyevolve.sourceforge.net/</a></li>
<li>PyLit: <a href="http://pylit.berlios.de/">http://pylit.berlios.de/</a> (<a href="http://pylit.berlios.de/literate-programming.html"> Literate Programming</a> with <a href="http://docutils.sourceforge.net/rst.html">reStructuredText)</a></li>
</ul>
<ul>
<li>Pylo: <a href="http://documen.tician.de/pylo/">http://documen.tician.de/pylo/</a></li>
<li>Pylons: <a href="http://docs.pylonshq.com/">http://docs.pylonshq.com/</a></li>
<li>PyMOTW: <a href="http://www.doughellmann.com/PyMOTW/">http://www.doughellmann.com/PyMOTW/</a></li>
<li>PyPubSub: <a href="http://pubsub.sourceforge.net/">http://pubsub.sourceforge.net/</a></li>
<li>pyrticle: <a href="http://documen.tician.de/pyrticle/">http://documen.tician.de/pyrticle/</a></li>
<li>Pysparse: <a href="http://pysparse.sourceforge.net/">http://pysparse.sourceforge.net/</a></li>
<li>Python: <a href="http://docs.python.org/">http://docs.python.org/</a></li>
<li>python-apt: <a href="http://people.debian.org/%7Ejak/python-apt-doc/">http://people.debian.org/~jak/python-apt-doc/</a></li>
<li>PyUblas: <a href="http://documen.tician.de/pyublas/">http://documen.tician.de/pyublas/</a></li>
<li>Quex: <a href="http://quex.sourceforge.net/">http://quex.sourceforge.net/</a></li>
<li>Reteisi: <a href="http://docs.argolinux.org/reteisi/">http://docs.argolinux.org/reteisi/</a></li>
<li>Roundup: <a href="http://www.roundup-tracker.org/">http://www.roundup-tracker.org/</a></li>
<li>Sage: <a href="http://sagemath.org/doc/">http://sagemath.org/doc/</a></li>
<li>Satchmo: <a href="http://www.satchmoproject.com/docs/svn/">http://www.satchmoproject.com/docs/svn/</a></li>
<li>Scapy: <a href="http://www.secdev.org/projects/scapy/doc/">http://www.secdev.org/projects/scapy/doc/</a></li>
<li>Selenium: <a href="http://seleniumhq.org/docs/">http://seleniumhq.org/docs/</a></li>
<li>Self: <a href="http://selflanguage.org/">http://selflanguage.org/</a></li>
<li>SimPy: <a href="http://simpy.sourceforge.net/">http://simpy.sourceforge.net/</a> (<em><span style="font-family:verdana,arial,helvetica;">SimPy (= <strong>Sim</strong>ulation in <strong>Py</strong>thon) is an object-oriented, process-based discrete-event simulation language based on standard Python . It provides the modeler with components of a simulation model including processes, for active components like customers, messages, and vehicles, and resources, for passive components that form limited capacity congestion points like servers, checkout counters, and tunnels…</span></em>)</li>
<li>Sphinx: <a href="http://sphinx.pocoo.org/">http://sphinx.pocoo.org/</a></li>
<li>Sprox: <a href="http://sprox.org/">http://sprox.org/</a></li>
<li>SQLAlchemy: <a href="http://www.sqlalchemy.org/docs/">http://www.sqlalchemy.org/docs/</a></li>
<li>Sqlkit: <a href="http://sqlkit.argolinux.org/">http://sqlkit.argolinux.org/</a></li>
<li>SymPy: <a href="http://docs.sympy.org/">http://docs.sympy.org/</a></li>
<li>tinyTiM: <a href="http://tinytim.sourceforge.net/docs/2.0/">http://tinytim.sourceforge.net/docs/2.0/</a></li>
<li>The Wine Cellar Book: <a href="http://www.thewinecellarbook.com/doc/en/">http://www.thewinecellarbook.com/doc/en/</a></li>
<li>TurboGears: <a href="http://turbogears.org/2.0/docs/">http://turbogears.org/2.0/docs/</a></li>
<li>VOR: <a href="http://www.vor-cycling.be/">http://www.vor-cycling.be/</a></li>
<li>WebFaction: <a href="http://docs.webfaction.com/">http://docs.webfaction.com/</a></li>
<li>WFront: <a href="http://discorporate.us/projects/WFront/">http://discorporate.us/projects/WFront/</a></li>
<li>WTForms: <a href="http://wtforms.simplecodes.com/docs/">http://wtforms.simplecodes.com/docs/</a></li>
<li>Zope 3: e.g. <a href="http://docs.carduner.net/z3c-tutorial/">http://docs.carduner.net/z3c-tutorial/</a></li>
<li>zc.async: <a href="http://packages.python.org/zc.async/1.5.0/">http://packages.python.org/zc.async/1.5.0/</a></li>
</ul>
</li>
</ul>
<p><span style="text-decoration:underline;"><strong>Builtin sphinx extensions<br />
</strong></span></p>
<ul>
<li><a title="builtin sphinx extensions" href="http://sphinx.pocoo.org/extensions.html#builtin-sphinx-extensions" target="_blank">http://sphinx.pocoo.org/extensions.html#builtin-sphinx-extensions</a></li>
<li><a title="sphinx extensions" href="http://matplotlib.sourceforge.net/sampledoc/extensions.html" target="_blank">http://matplotlib.sourceforge.net/sampledoc/extensions.html </a></li>
</ul>
<p>These extensions are built in and can be activated by respective entries in the <a href="http://sphinx.pocoo.org/config.html#confval-extensions"><tt>extensions</tt></a> configuration value:</p>
<ul>
<li><a href="http://sphinx.pocoo.org/ext/autodoc.html"><tt>sphinx.ext.autodoc</tt> – Include documentation from docstrings</a>
<ul>
<li><a href="http://sphinx.pocoo.org/ext/autodoc.html#docstring-preprocessing">Docstring preprocessing</a></li>
<li><a href="http://sphinx.pocoo.org/ext/autodoc.html#skipping-members">Skipping members</a></li>
</ul>
</li>
<li><a href="http://sphinx.pocoo.org/ext/autosummary.html"><tt>sphinx.ext.autosummary</tt> – Generate autodoc summaries</a>
<ul>
<li><a href="http://sphinx.pocoo.org/ext/autosummary.html#sphinx-autogen-generate-autodoc-stub-pages"><strong>sphinx-autogen</strong> – generate autodoc stub pages</a></li>
<li><a href="http://sphinx.pocoo.org/ext/autosummary.html#generating-stub-pages-automatically">Generating stub pages automatically</a></li>
<li><a href="http://sphinx.pocoo.org/ext/autosummary.html#customizing-templates">Customizing templates</a></li>
</ul>
</li>
<li><a href="http://sphinx.pocoo.org/ext/doctest.html"><tt>sphinx.ext.doctest</tt> – Test snippets in the documentation </a>
<ul>
<li>This extension allows you to test snippets in the documentation in a natural way. It works by collecting specially-marked up code blocks and running them as doctest tests.</li>
<li><a title="sphinx auto test" href="http://jessenoller.com/2009/02/26/sphinx-and-auto-buildingtests/" target="_blank">http://jessenoller.com/2009/02/26/sphinx-and-auto-buildingtests/ </a>(’<em>…Ok, so I’m think I’m in sphinx-love. I’ve needed to really begin a largish documentation project for a code base I own and drive (omgmanagerspeak) and since I’d rather not completely rely on API docs, and I have exposure to sphinx courtesy of python-core work, I chose you sphinx-a-chu!<a href="http://sphinx.pocoo.org/" target="_blank"> Sphinx</a> really is awesome. I started just chugging through the docs, and ended up pulling from tip (<a href="http://bitbucket.org/birkenfeld/sphinx/" target="_blank">via mercurial</a>) and using the latest version for the theme support Georg added recently. Rather than rehash the basics, I’ll simple explain my setup, and why I love it – starting with the output from sphinx-quickstart which kicks out a makefile for you, I immediately turned on the ‘<a href="http://sphinx.pocoo.org/ext/autodoc.html" target="_blank">sphinx.ext.autodoc</a>‘ and ‘<a href="http://sphinx.pocoo.org/ext/doctest.html" target="_blank">sphinx.ext.doctest</a>‘ extensions – the former allows you to tell sphinx (in your rst file) to delegate the documentation for this class/method/etc to the API docs, and the latter allows you to pass the examples/snippets you <strong>will</strong> have through doctest. These two things make writing/testing the docs <strong>awesome</strong> – but it gets more awesome..</em>.’)</li>
<li><a title="sphinx" href="http://aroberge.blogspot.com/2008/03/inspiration-and-persistence.html" target="_blank">http://aroberge.blogspot.com/2008/03/inspiration-and-persistence.html </a>(’… <em>inspired by an earlier post on Georg Brand’s remarkable <a href="http://sphinx.pocoo.org/">Sphinx</a>, <a title="crunchy" href="http://code.google.com/p/crunchy/" target="_blank">Crunchy</a> now includes a prototype for an automated documentation testing framework along the lines of <a href="http://sphinx.pocoo.org/ext/doctest.html">sphinx.ext.doctest</a> which was released yesterday. My intention is to update Crunchy’s implementation so that it can be totally compatible with Sphinx’s. And while I believe that this is a neat (and fun!) thing to include in Crunchy, it only very indirectly contribute to my overall goal and ends up delaying the 1.0 release for Crunchy.</em>..’)</li>
<li><a title="doc turbogears2" href="http://svn.turbogears.org/docs/2.0/docs/conf.py" target="_blank">http://svn.turbogears.org/docs/2.0/docs/conf.py </a></li>
</ul>
</li>
<li><a href="http://sphinx.pocoo.org/ext/intersphinx.html"><tt>sphinx.ext.intersphinx</tt> – Link to other projects’ documentation</a></li>
<li><a href="http://sphinx.pocoo.org/ext/math.html">Math support in Sphinx</a>
<ul>
<li><a href="http://sphinx.pocoo.org/ext/math.html#module-sphinx.ext.pngmath"><tt>sphinx.ext.pngmath</tt> – Render math as PNG images</a></li>
<li><a href="http://sphinx.pocoo.org/ext/math.html#module-sphinx.ext.jsmath"><tt>sphinx.ext.jsmath</tt> – Render math via JavaScript</a></li>
</ul>
</li>
<li><a href="http://sphinx.pocoo.org/ext/graphviz.html"><tt>sphinx.ext.graphviz</tt> – Add Graphviz graphs</a></li>
<li><a href="http://sphinx.pocoo.org/ext/inheritance.html"><tt>sphinx.ext.inheritance_diagram</tt> – Include inheritance diagrams</a></li>
<li><a href="http://sphinx.pocoo.org/ext/refcounting.html"><tt>sphinx.ext.refcounting</tt> – Keep track of reference counting behavior</a></li>
<li><a href="http://sphinx.pocoo.org/ext/ifconfig.html"><tt>sphinx.ext.ifconfig</tt> – Include content based on configuration</a></li>
<li><a href="http://sphinx.pocoo.org/ext/coverage.html"><tt>sphinx.ext.coverage</tt> – Collect doc coverage stats</a></li>
<li><a href="http://sphinx.pocoo.org/ext/todo.html"><tt>sphinx.ext.todo</tt> – Support for todo items</a></li>
</ul>
<h2>Third-party extensions</h2>
<p>There are several extensions that are not (yet) maintained in the Sphinx distribution.  The <a href="http://www.bitbucket.org/birkenfeld/sphinx/wiki/Home">Wiki at BitBucket</a> maintains a list of those.</p>
<p>If you write an extension that you think others will find useful, please write to the project mailing list (<a href="mailto:sphinx-dev%40googlegroups.com">sphinx-dev@googlegroups.com</a>) and we’ll find the proper way of including or hosting it for the public.</p>
<ul>
<li>ascii (aafigure for sphinx, <a title="aafigure" href="http://packages.python.org/sphinxcontrib-aafig/" target="_blank">http://packages.python.org/sphinxcontrib-aafig/</a> )</li>
</ul>
<ul>
<li><a title="doc numpy" href="http://projects.scipy.org/numpy/browser/trunk/doc/sphinxext/numpydoc.py" target="_blank">http://projects.scipy.org/numpy/browser/trunk/doc/sphinxext/numpydoc.py </a>
<ul>
<li><a title="doc nipy" href="http://nipy.sourceforge.net/nipy/documentation.html" target="_blank">http://nipy.sourceforge.net/nipy/documentation.html </a>(très belle documentation produite avec l’extension ci-dessus)</li>
<li><a title="doc standard" href="http://projects.scipy.org/numpy/wiki/CodingStyleGuidelines" target="_blank">http://projects.scipy.org/numpy/wiki/CodingStyleGuidelines </a></li>
<li><a title="example" href="http://svn.scipy.org/svn/numpy/trunk/doc/example.py" target="_blank">http://svn.scipy.org/svn/numpy/trunk/doc/example.py</a></li>
<li><a title="nipy" href="http://nipy.sourceforge.net/devel/" target="_blank">http://nipy.sourceforge.net/devel/ </a>
<ul>
<li><a title="doc sphinx" href="http://nipy.sourceforge.net/devel/guidelines/howto_document.html" target="_blank">http://nipy.sourceforge.net/devel/guidelines/howto_document.html </a>(’<a href="http://neuroimaging.scipy.org/">Nipy</a> uses the <a href="http://sphinx.pocoo.org/">Sphinx</a> documentation generating tool.  Sphinx translates <a href="http://docutils.sourceforge.net/rst.html">reST</a> formatted documents into html and pdf documents. All our documents and docstrings are in reST format, this allows us to have both human-readable docstrings when viewed in <a href="http://ipython.scipy.org/">ipython</a>, and web and print quality documentation.’)</li>
<li><a title="nipy" href="http://nipy.sourceforge.net/devel/guidelines/sphinx_helpers.html" target="_blank">http://nipy.sourceforge.net/devel/guidelines/sphinx_helpers.html </a></li>
</ul>
</li>
</ul>
<ul>
<li> UML
<ul>
<li> <a title="UML" href="http://www.shibu.jp/sdeditext/" target="_blank">http://www.shibu.jp/sdeditext/ </a></li>
<li> <a title="UML" href="http://bitbucket.org/shibu/sdeditext_for_sphinx/" target="_blank">http://bitbucket.org/shibu/sdeditext_for_sphinx/ </a></li>
</ul>
<p><img title="uml" src="http://pvergain.files.wordpress.com/2009/10/uml.png?w=300&amp;h=92&#038;h=92" alt="uml" width="300" height="92" /></li>
</ul>
</li>
</ul>
<ul>
<li></li>
</ul>
<p><strong>Utiliser sphinx avec:</strong></p>
<ul>
<li>doxygen
<ul>
<li><a title="doxygen" href="http://github.com/michaeljones/breathe" target="_blank">http://github.com/michaeljones/breathe </a>(’<em><span id="repository_description">Restructured text and Sphinx bridge to Doxygen</span>‘</em>)</li>
</ul>
</li>
</ul>
<p><span style="text-decoration:underline;"><strong>Autres  projets utilisant sphinx (non listés sur sphinx.pocoo.org)<br />
</strong></span></p>
<ul>
<li><a title="scipy" href="http://docs.scipy.org/doc/" target="_blank">http://docs.scipy.org/doc/</a> (’Welcome! This is     the documentation for Numpy and Scipy     .’)</li>
<li><a title="nipy" href="http://nipy.sourceforge.net/devel/" target="_blank">http://nipy.sourceforge.net/devel/</a> (’The purpose of NIPY is to make it easier to do better brain imaging   research.’)</li>
<li><a title="ipython" href="http://ipython.scipy.org/doc/manual/html/index.html" target="_blank">http://ipython.scipy.org/doc/manual/html/index.html </a></li>
<li><a title="sphinx" href="http://doc.freevo.org/api/kaa/base/core/index.html" target="_blank">http://doc.freevo.org/api/kaa/base/core/index.html </a></li>
<li><a title="Durus" href="http://11craft.github.com/duruses/" target="_blank">http://11craft.github.com/duruses/ </a></li>
<li><a title="buildout" href="http://www.buildout.org/index.html" target="_blank">http://www.buildout.org/index.html </a></li>
<li><a title="Durus" href="http://11craft.github.com/duruses/index.html" target="_blank">http://11craft.github.com/duruses/index.html </a>
<ul>
<li><a title="Durus" href="http://11craft.github.com/duruses/api.html#module-duruses.client" target="_blank">http://11craft.github.com/duruses/api.html#module-duruses.client </a></li>
<li><a title="Durus" href="http://11craft.github.com/duruses/sources/api.txt" target="_blank">http://11craft.github.com/duruses/sources/api.txt </a></li>
</ul>
</li>
<li><a title="mock" href="http://www.voidspace.org.uk/python/mock/" target="_blank">http://www.voidspace.org.uk/python/mock/ </a></li>
<li><a title="pph" href="http://infinitemonkeycorps.net/docs/pph/" target="_blank">http://infinitemonkeycorps.net/docs/pph/ </a>(’You have a pile of Python code. You think, “this could be useful to someone else.” You want to release it as an open-source project. You’ve come to the right place.’)</li>
<li><a title="Sphinx" href="http://doc.bazaar-vcs.org/en/" target="_blank">http://doc.bazaar-vcs.org/en/ </a>(’<strong>Documentation for Bazaar</strong> 2.0- The Adaptive Version Control System’)</li>
<li><a title="pypng" href="http://packages.python.org/pypng/" target="_blank">http://packages.python.org/pypng/ </a></li>
<li><a title="pySide" href="http://www.pyside.org/docs/pyside/index.html" target="_blank">http://www.pyside.org/docs/pyside/index.html</a> (’PySide aims to provide Python developers access to the Qt libraries in the most natural way’)</li>
<li><a title="ase" href="https://wiki.fysik.dtu.dk/ase/" target="_blank">https://wiki.fysik.dtu.dk/ase/ </a>(’<em>The Atomic Simulation Environment (ASE) is the common part of the simulation tools developed at <a href="http://www.camd.dtu.dk/">CAMd</a>.  ASE provides <a href="http://www.python.org/">Python</a> modules for manipulating atoms, analyzing simulations, visualization etc</em>.’)
<ul>
<li><a title="ase doc sphinx" href="https://wiki.fysik.dtu.dk/ase/development/writing_documentation_ase.html" target="_blank">https://wiki.fysik.dtu.dk/ase/development/writing_documentation_ase.html </a></li>
</ul>
</li>
</ul>
<ul>
<li><span style="text-decoration:underline;"><strong>Projets sphinx concernant des projets non “python”</strong></span></li>
</ul>
<ul>
<li>
<ul>
<li> <a title="sphinx " href="http://www.nongnu.org/gsl-shell/index.html" target="_blank">http://www.nongnu.org/gsl-shell/index.html </a></li>
<li><a title="sphinx" href="http://nicolas.steinmetz.fr/tutoriels/index.html" target="_blank">http://nicolas.steinmetz.fr/tutoriels/index.html</a></li>
<li><a title="sphinx" href="http://catherinedevlin.pythoneers.com/" target="_blank">http://catherinedevlin.pythoneers.com/</a></li>
</ul>
</li>
</ul>
<p><span style="text-decoration:underline;"><strong>A lire</strong></span></p>
<ul>
<li><a title="Georg Brandl" href="http://pythonic.pocoo.org/" target="_blank">http://pythonic.pocoo.org/ </a>(’Le blog de Georg Brandl’)</li>
<li><a title="Bookrest" href="http://www.pythonprogramminglanguage.info/2009/10/02/bookrest-the-stylesheet-editor-in-action/" target="_blank">http://www.pythonprogramminglanguage.info/2009/10/02/bookrest-the-stylesheet-editor-in-action/ </a></li>
<li><a title="sphinx" href="http://pylonsbook.com/en/1.0/documentation.html#introducing-sphinx" target="_blank">http://pylonsbook.com/en/1.0/documentation.html#introducing-sphinx </a></li>
</ul>
<ul>
<li><a title="Georg Brandl" href="http://pyfound.blogspot.com/2008/08/georg-brandl-and-brett-cannon-to.html" target="_blank">http://pyfound.blogspot.com/2008/08/georg-brandl-and-brett-cannon-to.html </a>(”At the July Board meeting of the PSF Board of Directors, <a href="http://www.python.org/community/awards/psf-awards/">PSF Community Awards</a> were awarded to Georg Brandl and Brett Cannon.Georg has been an enthusiastic contributor to the core for several years, and a while ago stunned the Python development world by building <a href="http://sphinx.pocoo.org/">the Sphinx documentation system</a> as an alternative to the LaTeX-based system we had been using previously, and converting <a href="http://docs.python.org/dev/">the Python documentation</a> to use it.’)</li>
<li><a title="Georg Brandl" href="http://pythonic.pocoo.org/2009/9/12/new-in-sphinx-1-0-domains" target="_blank">http://pythonic.pocoo.org/2009/9/12/new-in-sphinx-1-0-domains</a> (’)</li>
<li><a title="sphinx" href="http://bitbucket.org/birkenfeld/sphinx-domains" target="_blank">http://bitbucket.org/birkenfeld/sphinx-domains </a>(’…<em>Anyway, when domain support is fully implemented, and assuming someone writes a JavaScript domain extension, you will be able to document a JavaScript project (or a mixed project) with Sphinx just as comfortably as you document a Python project right now</em>…’)</li>
<li><a title="sphinx" href="http://www.voidspace.org.uk/python/weblog/arch_d7_2008_11_22.shtml" target="_blank">http://www.voidspace.org.uk/python/weblog/arch_d7_2008_11_22.shtml </a>(’…<em>This is timely as one of the most valuable things that I learned at PyWorks (in the hallway track) was how to use Sphinx. <a href="http://www.percious.com/blog/">Chris Perkins</a> (who has some patches that will be integrated into the next release) showed me how to get started. My conclusion – Sphinx is frickin awesome!.</em>.’)</li>
<li><a title="sphinx" href="http://tarekziade.wordpress.com/2008/03/23/sphinx-as-a-doc-builder-for-python-projects/" target="_blank">http://tarekziade.wordpress.com/2008/03/23/sphinx-as-a-doc-builder-for-python-projects/ </a>(’…<em>Sphinx annoucement is really exciting, and it shouldn’t be too much pain to bundle it in a buildout recipe to manage a project documentation. Since it is based on templates and configuration files, a default structure can be generated to startup a project documentation together with a code base..</em>.’)</li>
</ul>
<p><strong>Autres liens<br />
</strong></p>
<ul>
<li><a title="doc picture" href="http://code.google.com/p/docpicture/" target="_blank">http://code.google.com/p/docpicture/ </a>(’<em><a id="project_summary_link" style="text-decoration:none;color:#000000;" href="http://code.google.com/p/docpicture/">Alternative to Python help() enabling viewing of embedded pictures</a></em>‘)</li>
<li><a title="doc python" href="http://www.packtpub.com/article/documenting-your-python-project-1" target="_blank">http://www.packtpub.com/article/documenting-your-python-project-1 </a>(’<em>…Documentation is work that is often neglected by developers and sometimes by managers. This is often due to a lack of time towards the end of development cycles, and the fact that people think they are bad at writing. Some of them are bad, but the majority of them are able to produce fine documentation..</em>.’)</li>
</ul>
<p><strong>A voir</strong></p>
<p>- <a title="ReStructuredText" href="http://en.wikipedia.org/wiki/ReStructuredText" target="_blank">http://en.wikipedia.org/wiki/ReStructuredText </a>(&#8216;<em><strong>reStructuredText</strong> is a <a title="Lightweight markup language" href="http://en.wikipedia.org/wiki/Lightweight_markup_language">lightweight markup language</a> intended to be highly readable in <a title="Source code" href="http://en.wikipedia.org/wiki/Source_code">source</a> format. Its formal name indicates that it is a &#8220;revised, reworked, and reinterpreted <a title="StructuredText (page does not exist)" href="http://en.wikipedia.org/w/index.php?title=StructuredText&amp;action=edit&amp;redlink=1">StructuredText</a>.&#8221;<sup><a href="http://en.wikipedia.org/wiki/ReStructuredText#cite_note-0">[1]</a></sup> reStructuredText is sometimes abbreviated as RST; while sometimes abbreviated as ReST or reST, this can create confusion with <a title="Representational State Transfer" href="http://en.wikipedia.org/wiki/Representational_State_Transfer">REST</a>, an unrelated technology</em>.&#8217;)</p>
Posted in 2009, Années, Documentation, Génie logiciel, python, Sphinx Tagged: Birkenfeld, Documentation, Georg Brandl, http://pythonic.pocoo.org/tags/sphinx, http://twitter.com/birkenfeld, projet c, projet python, python, REST, reStructuredText <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gocomments/pvergain.wordpress.com/555/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/comments/pvergain.wordpress.com/555/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godelicious/pvergain.wordpress.com/555/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/delicious/pvergain.wordpress.com/555/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gostumble/pvergain.wordpress.com/555/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/stumble/pvergain.wordpress.com/555/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godigg/pvergain.wordpress.com/555/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/digg/pvergain.wordpress.com/555/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/goreddit/pvergain.wordpress.com/555/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/reddit/pvergain.wordpress.com/555/" /></a> <img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=pvergain.wordpress.com&blog=696018&post=555&subd=pvergain&ref=&feed=1" /></div>]]></content:encoded>
			<wfw:commentRss>http://pvergain.wordpress.com/2009/10/25/comment-debuter-pour-documenter-un-projet-python-c-admin-etc-avec-le-logiciel-python-sphinx-de-georg-brandl/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
	
		<media:content url="http://1.gravatar.com/avatar/9a2b1985a6f239af4bcfaa1f6199b5d4?s=96&#38;d=identicon&#38;r=G" medium="image">
			<media:title type="html">pvergain</media:title>
		</media:content>

		<media:content url="http://pvergain.files.wordpress.com/2009/10/sphinx.png?w=300" medium="image">
			<media:title type="html">sphinx</media:title>
		</media:content>

		<media:content url="http://pvergain.files.wordpress.com/2009/10/gb_bigger.jpg" medium="image">
			<media:title type="html">gb_bigger</media:title>
		</media:content>

		<media:content url="http://pvergain.files.wordpress.com/2009/10/uml.png?w=300&#38;h=92" medium="image">
			<media:title type="html">uml</media:title>
		</media:content>
	</item>
		<item>
		<title>Python choisi pour l&#8217;enseignement de l&#8217;algorithmique en classe de seconde pour la rentrée 2009/2010 en France</title>
		<link>http://pvergain.wordpress.com/2009/09/20/python-choisi-pour-lenseignement-de-lalgorithmique-en-classe-de-seconde-pour-la-rentree-20092010-en-france/</link>
		<comments>http://pvergain.wordpress.com/2009/09/20/python-choisi-pour-lenseignement-de-lalgorithmique-en-classe-de-seconde-pour-la-rentree-20092010-en-france/#comments</comments>
		<pubDate>Sun, 20 Sep 2009 21:16:36 +0000</pubDate>
		<dc:creator>patrick</dc:creator>
				<category><![CDATA[2009]]></category>
		<category><![CDATA[algorithmique]]></category>
		<category><![CDATA[apprentissage de python]]></category>
		<category><![CDATA[classe de seconde]]></category>
		<category><![CDATA[documentation python]]></category>
		<category><![CDATA[how to think like a computer scientist]]></category>
		<category><![CDATA[magma]]></category>
		<category><![CDATA[maple]]></category>
		<category><![CDATA[mathematica]]></category>
		<category><![CDATA[matlab]]></category>
		<category><![CDATA[MIT]]></category>
		<category><![CDATA[pyromaths]]></category>
		<category><![CDATA[python-xy]]></category>
		<category><![CDATA[sage]]></category>
		<category><![CDATA[scratch]]></category>
		<category><![CDATA[spyder]]></category>
		<category><![CDATA[tutoriel python]]></category>

		<guid isPermaLink="false">http://pvergain.wordpress.com/?p=498</guid>
		<description><![CDATA[
C&#8217;est en lisant le magazine hors série N°37 &#8216;Tangente (http://www.tangente-education.com, &#8220;Les algorithmes au coeur du raisonnement structuré&#8220;)  que j&#8217;ai appris que le langage python faisait partie des 2 principaux langages de programmation recommandés pour l&#8217;apprentissage de l&#8217;algorithmique en classe de seconde ! C&#8217;est une bonne nouvelle pour les élèves et pour python également  . [...]<img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=pvergain.wordpress.com&blog=696018&post=498&subd=pvergain&ref=&feed=1" />]]></description>
			<content:encoded><![CDATA[<div class='snap_preview'><br /><p><img class="alignleft size-thumbnail wp-image-502" title="serpent2" src="http://pvergain.files.wordpress.com/2009/09/serpent2.gif?w=78&#038;h=91" alt="serpent2" width="78" height="91" /></p>
<p>C&#8217;est en lisant le magazine hors série N°37 &#8216;Tangente (<a title="Tangente" href="http://www.tangente-education.com" target="_blank">http://www.tangente-education.com</a>, &#8220;<strong>Les algorithmes au coeur du raisonnement structuré</strong>&#8220;)  que j&#8217;ai appris que le langage python faisait partie des 2 principaux langages de programmation recommandés pour l&#8217;apprentissage de l&#8217;algorithmique en classe de seconde ! C&#8217;est une bonne nouvelle pour les élèves et pour python également <img src='http://s.wordpress.com/wp-includes/images/smilies/icon_smile.gif' alt=':)' class='wp-smiley' /> . C&#8217;est aussi dans ce même magazine que j&#8217;ai appris que l&#8217;algorithmique était désormais inscrite dans les programmes de lycées !</p>
<p>Le magazine va proposer un manuel interactif en cours de préparation (<a title="python tangente" href="http://www.tangente-education.com/ManuelTangente2/mansec/manuelseconde/home/index/" target="_blank">http://www.tangente-education.com/ManuelTangente2/mansec/manuelseconde/home/index/</a>)</p>
<p><span style="text-decoration:underline;"><strong>Autre source pour cette nouvelle:</strong></span></p>
<ul>
<li>
<ul>
<li><a title="annonce sur scratch" href="http://scratch.mit.edu/forums/viewtopic.php?id=22097" target="_blank">http://scratch.mit.edu/forums/viewtopic.php?id=22097 </a>(&#8216;<em>ET OUI l&#8217;an prochain il y aura un peu d&#8217;algorithmique à enseigner en classe de Seconde : Voilà le lien :<a href="http://eduscol.education.fr/D0015/LLPHPR01.htm">Eduscol Mathématiques</a></em>&#8230;<em>Scratch (</em>le deuxième langage recommandé)<em>&#8230;est cité en exemple dans ces documents.</em>&#8216;)<br />
<em><a href="http://eduscol.education.fr/D0015/LLPHAG00.htm#ressources_scde">La page d&#8217;accès aux ressources</a></em><br />
<em>Le lien pour le document ressource pour l&#8217;enseignement de l&#8217;algorithmique </em><br />
<em><a href="http://eduscol.education.fr/D0015/Doc_ress_algo_v25.pdf">Ressources pour la Classe de Seconde &#8211; Algorithmique</a></em><br />
<em>Le lien pour le document ressource pour l&#8217;enseignement des probabilités et statistiques </em><br />
<em><a href="http://eduscol.education.fr/D0015/Doc_ressource_proba-stats.pdf">Ressources pour la Classe de Seconde &#8211; Probabilités Statistiques</a></em><br />
<em>Le lien pour le document ressource pour l&#8217;enseignement de la logique </em><br />
<em><a href="http://eduscol.education.fr/D0015/Doc_ressource_raisonnement.pdf">Ressources pour la Classe de Seconde &#8211; Notations et raisonnement mathématiques</a></em><br />
<em>Le lien pour le document ressource pour l&#8217;enseignement des fonctions </em><br />
<em><a href="http://eduscol.education.fr/D0015/Doc_ressource_fonctions.pdf">Ressources pour la Classe de Seconde &#8211; Fonctions</a></em></li>
</ul>
</li>
</ul>
<p><span style="text-decoration:underline;"><strong>Voici quelques liens sur les mathématiques avec python:</strong></span></p>
<ul>
<li><a title="Edu-sig" href="http://mail.python.org/mailman/listinfo/edu-sig" target="_blank">http://mail.python.org/mailman/listinfo/edu-sig </a>(&#8216;This list is for discussion of Python in education, however (at the request of a majority of readers) explicitly excluding educational politics&#8217;)</li>
<li><a title="python in education" href="http://wiki.python.org/moin/PythonInEducation" target="_blank">http://wiki.python.org/moin/PythonInEducation</a>
<ul>
<li><a title="schools" href="http://wiki.python.org/moin/SchoolsUsingPython" target="_blank">http://wiki.python.org/moin/SchoolsUsingPython</a> (&#8216;This is a listing of schools that are using Python in their curriculum.&#8217;)</li>
</ul>
</li>
<li><a title="pyromaths" href="http://www.pyromaths.org/" target="_blank">http://www.pyromaths.org/ </a>(&#8216;<strong>Pyromaths</strong> est un programme qui permet de générer des fiches d’<strong>exercices de mathématiques de collège</strong> ainsi que leur corrigé. Il crée des fichiers au format pdf qui peuvent ensuite être imprimés ou lus sur écran.&#8217;)
<ul>
<li><a href="http://www.pyromaths.org/xmedia/pyromaths/dlcount.php3?str=pyromaths-09.09-sources.tar.bz2">Les sources de Pyromaths</a></li>
</ul>
</li>
<li><a href="http://www.inforef.be/swi/python.htm" target="_blank">http://www.inforef.be/swi/python.htm</a></li>
<li><a title="scipy" href="http://www.scipy.org/" target="_blank">http://www.scipy.org/ </a>(&#8216;<em>SciPy (pronounced &#8220;Sigh Pie&#8221;) is open-source software for mathematics, science, and engineering. It is also the name of a very popular <a href="http://conference.scipy.org/">conference</a> on scientific programming with Python. The SciPy library depends on <a href="http://numpy.scipy.org/">NumPy</a>, which provides convenient and fast N-dimensional array manipulation. The SciPy library is built to work with NumPy arrays, and provides many user-friendly and efficient numerical routines such as routines for numerical integration and optimization. Together, they run on all popular operating systems, are quick to install, and are free of charge. NumPy and SciPy are easy to use, but powerful enough to be depended upon by some of the world&#8217;s leading scientists and engineers. If you need to manipulate numbers on a computer and display or publish the results, give SciPy a try!</em>&#8216;)</li>
<li><a title="nipy" href="http://neuroimaging.scipy.org/site/index.html" target="_blank"><img class="alignnone size-full wp-image-526" title="reggie2" src="http://pvergain.files.wordpress.com/2009/09/reggie2.png?w=76&#038;h=90" alt="reggie2" width="76" height="90" />http://neuroimaging.scipy.org/site/index.html </a>(&#8216;<em>The neuroimaging in python (NIPY) project is an environment for the analysis of structural and functional neuroimaging data. It currently has a full system for general linear modeling of functional magnetic resonance imaging (fMRI</em>).&#8217;)</li>
<li><a title="spyderlib" href="http://code.google.com/p/spyderlib/" target="_blank">http://code.google.com/p/spyderlib/</a> (Spyder (previously known as Pydee) is a Python development environment providing MATLAB-like features in a simple and light-weighted software, available for Microsoft Windows XP/Vista, GNU/Linux and MacOS X.)</li>
<li><a title="python-xy" href="http://www.pythonxy.com/foreword_fr.php" target="_blank">http://www.pythonxy.com/foreword_fr.php </a>(&#8216;Python(x,y) est un logiciel libre scientifique de calcul numérique basé sur le langage Python, les interfaces graphiques Qt (et le cadre de développement associé), l&#8217;environnement de développement Eclipse et l&#8217;environnement de développement scientifique interactif Spyder.&#8217;)</li>
<li><a title="sage" href="http://www.sagemath.org/" target="_blank">http://www.sagemath.org/ </a>
<ul>
<li><a title="sage" href="http://www.sagemath.org/fr/tutorial/index.html" target="_blank">http://www.sagemath.org/fr/tutorial/index.html </a>(&#8216;Sage est un logiciel mathématique libre destiné à la recherche et à l’enseignement en algèbre, géométrie, arithmétique, théorie des nombres, cryptographie, calcul scientifique et dans d’autres domaines apparentés. Le modèle de développement de Sage comme ses caractéristiques techniques se distinguent par un souci extrême d’ouverture, de partage, de coopération et de collaboration : notre but est de construire la voiture, non de réinventer la roue. L’objectif général de Sage est de créer une alternative libre viable à Maple, Mathematica, Magma et MATLAB&#8230;.le public visé par Sage comprend les étudiants  (du lycée au doctorat), les enseignants et les chercheurs en mathématiques. Le but est de fournir un logiciel qui permette d’explorer toutes sortes de constructions mathématiques et de faire des expériences avec, en algèbre, en géométrie, en arithmétique et théorie des nombres, en analyse, en calcul numérique, etc. Sage facilite l’expérimentation interactive avec des objets mathématiques&#8217;)</li>
</ul>
</li>
</ul>
<p><span style="text-decoration:underline;"><strong>Autres liens sur l&#8217;apprentissage de python</strong></span></p>
<ul>
<li><a title="cp4e" href="http://www.python.org/doc/essays/cp4e.html" target="_blank">http://www.python.org/doc/essays/cp4e.html </a>(&#8216;<em>We intend to start with Python, a language designed for rapid development. <strong><span style="color:#ff0000;">We believe that Python makes a great first language to learn</span></strong>: Unlike languages designed specifically for beginners, Python is also the choice of many programming professionals. It has an active, growing user community which has already expressed much interest in this proposal, and we expect that this will be a fertile first deployment ground for the teaching materials and tools we propose to create. During the course of the research we will evaluate Python and propose improvements or alternatives</em>&#8230;<strong><span style="color:#ff0000;">Python is a good language for teaching absolute beginners</span></strong>&#8230; by <a title="Guido Van Rossum" href="http://www.python.org/~guido/" target="_blank"></a><a title="Guido Van Rossum" href="http://en.wikipedia.org/wiki/Guido_van_Rossum" target="_blank">Guido Van Rossum</a>, http://www.python.org/~guido/ &#8216;)</li>
<li><a title="Beginners guide" href="http://wiki.python.org/moin/BeginnersGuide" target="_blank">http://wiki.python.org/moin/BeginnersGuide </a>(&#8216;<em>New to programming? Python is free, and easy to learn if you know where to start! This guide will help you to get started quickly.</em>&#8216;)</li>
<li><a title="Afpy" href="http://www.afpy.org/" target="_blank">http://www.afpy.org/</a> (&#8216;<em>L&#8217;Association Francophone Python est une association pour la promotion du langage Python&#8217;</em>)</li>
<li><a title="Wiki python" href="http://wikipython.flibuste.net/" target="_blank">http://wikipython.flibuste.net/ </a>(&#8216;<strong>Bienvenue sur ce Wiki-Python : site autogéré sur le langage Python</strong>&#8216;)</li>
<li><a title="Richard Gruet" href="http://rgruet.free.fr/" target="_blank">http://rgruet.free.fr/ </a>(&#8216;<em>Just try Python! I suggest that you download the official distribution, or the ActivePython distribution, and then start here.</em>&#8216;)</li>
<li><a title="python courant" href="http://docs.python.org/" target="_blank">http://docs.python.org/ </a>(Python 2.6)</li>
<li><a title="Python tutorial" href="http://docs.python.org/tutorial/" target="_blank">http://docs.python.org/tutorial/ </a>(&#8216;<em>Python is an easy to learn, powerful programming language. It has efficient high-level data structures and a simple but effective approach to object-oriented programming. Python’s elegant syntax and dynamic typing, together with its interpreted nature, make it an ideal language for scripting and rapid application development in many areas on most platforms</em>.&#8217;)</li>
<li><a title="Python 2.7" href="http://docs.python.org/dev/" target="_blank">http://docs.python.org/dev/ </a>(Python 2.7)</li>
<li><a title="Python 3.1" href="http://docs.python.org/3.1/" target="_blank">http://docs.python.org/3.1/</a> (Python 3.1)</li>
<li><a title="py3k" href="http://docs.python.org/dev/py3k/" target="_blank">http://docs.python.org/dev/py3k/</a> (Python 3.2)</li>
<li><a title="python 3.x" href="http://diveintopython3.org/" target="_blank">http://diveintopython3.org/</a> (&#8216;<cite>Dive Into Python 3</cite> covers Python 3 and its differences from Python 2. Compared to <cite><a href="http://diveintopython.org/">Dive Into Python</a></cite>, it’s about 20% revised and 80% new material. The book is now complete, but <a href="http://diveintopython3.org/about.html">feedback is always welcome</a>.&#8217;)</li>
<li><a title="Python en Français" href="http://wiki.python.org/moin/Languages/French?highlight=%28CategoryLanguage%29" target="_blank">http://wiki.python.org/moin/Languages/French?highlight=%28CategoryLanguage%29 </a></li>
<li><a title="Dépots de programmes python" href="http://pypi.python.org/pypi" target="_blank">http://pypi.python.org/pypi </a>(&#8216;The Python Package Index is a repository of software for the Python programming language&#8217;)</li>
<li><a title="Python" href="http://ocw.mit.edu/OcwWeb/Electrical-Engineering-and-Computer-Science/6-00Fall-2008/CourseHome/index.htm" target="_blank">http://ocw.mit.edu/OcwWeb/Electrical-Engineering-and-Computer-Science/6-00Fall-2008/CourseHome/index.htm</a>(&#8216;<em>Introduction to Computer Science and Programming. This subject is aimed at students with little or no programming experience. It aims to provide students with an understanding of the role computation can play in solving problems. It also aims to help students, regardless of their major, to feel justifiably confident of their ability to write small programs that allow them to accomplish useful goals. The class will use the Python™ programming language</em>.&#8217;)</li>
</ul>
<ul>
<li> <a title="pybiblio" href="http://www.openbookproject.net/pybiblio/" target="_blank">http://www.openbookproject.net/pybiblio/ </a>(&#8216;<span style="text-decoration:underline;"> Welcome</span> <span style="text-decoration:underline;">to</span> <span style="text-decoration:underline;">the</span> <span style="text-decoration:underline;">Python</span> <span style="text-decoration:underline;">Bibliotheca</span>! This site aims to be both a library of educational materials using Python to teach computer programming, and a virtual meeting place for teachers and students engaged in learning and teaching using Python.&#8217;)</li>
<p style="text-align:center;"><img class="size-medium wp-image-525 aligncenter" title="pslytherin" src="http://pvergain.files.wordpress.com/2009/09/pslytherin.png?w=243&#038;h=300" alt="pslytherin" width="243" height="300" /></p>
</ul>
<ul>
<li><a title="Cours python" href="http://www.openbookproject.net/pybiblio/gasp/course/" target="_blank">http://www.openbookproject.net/pybiblio/gasp/course/ </a>(&#8216;There are a lot of worksheets in our beginners’ Python course. The most important are the five numbered sheets; you should work your way through those. But they’ll be pretty hard going unless you also make use of the lettered sheets, which give you useful information about particular topics.&#8217;)</li>
<li><a title="python" href="http://www.openbookproject.net/pybiblio/gasp/course/1-intro.html" target="_self">http://www.openbookproject.net/pybiblio/gasp/course/1-intro.html </a>(&#8216;Introducing Python, first steps&#8217;)</li>
<li><a title="Python" href="http://www.openbookproject.net/thinkcs/python/english2e/" target="_blank">http://www.openbookproject.net/thinkcs/python/english2e/ </a>(&#8216;<span style="color:#ff0000;"><strong>How to Think Like a Computer Scientist</strong></span>. Learning with Python 2nd Edition by Jeffrey Elkner, Allen B. Downey, and Chris Meyers. This book is <a href="http://en.wikipedia.org/wiki/Markup_language">marked up</a> in <a href="http://en.wikipedia.org/wiki/ReStructuredText">ReStructuredText</a> using a document generation system called <a href="http://en.wikipedia.org/wiki/Sphinx_%28documentation_generator%29">Sphinx</a>.The source code is located on the <a href="http://en.wikipedia.org/wiki/Launchpad_%28website%29">Launchpad website</a> at <a href="http://bazaar.launchpad.net/%7Ethinkcspy/thinkcspy/english2e/files">http://bazaar.launchpad.net/~thinkcspy/thinkcspy/english2e/files</a>.&#8217;)</li>
</ul>
<p><a title="Cours python" href="http://www.openbookproject.net/pybiblio/gasp/course/" target="_blank"></a></p>
<p style="text-align:center;"><a title="Cours python" href="http://www.openbookproject.net/pybiblio/gasp/course/" target="_blank"><img title="gasp_lessons" src="http://pvergain.files.wordpress.com/2009/09/gasp_lessons.png?w=192&#038;h=192" alt="gasp_lessons" width="192" height="192" /></a></p>
Posted in 2009 Tagged: algorithmique, apprentissage de python, classe de seconde, documentation python, how to think like a computer scientist, magma, maple, mathematica, matlab, MIT, pyromaths, python-xy, sage, scratch, spyder, tutoriel python <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gocomments/pvergain.wordpress.com/498/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/comments/pvergain.wordpress.com/498/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godelicious/pvergain.wordpress.com/498/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/delicious/pvergain.wordpress.com/498/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gostumble/pvergain.wordpress.com/498/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/stumble/pvergain.wordpress.com/498/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godigg/pvergain.wordpress.com/498/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/digg/pvergain.wordpress.com/498/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/goreddit/pvergain.wordpress.com/498/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/reddit/pvergain.wordpress.com/498/" /></a> <img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=pvergain.wordpress.com&blog=696018&post=498&subd=pvergain&ref=&feed=1" /></div>]]></content:encoded>
			<wfw:commentRss>http://pvergain.wordpress.com/2009/09/20/python-choisi-pour-lenseignement-de-lalgorithmique-en-classe-de-seconde-pour-la-rentree-20092010-en-france/feed/</wfw:commentRss>
		<slash:comments>4</slash:comments>
	
		<media:content url="http://1.gravatar.com/avatar/9a2b1985a6f239af4bcfaa1f6199b5d4?s=96&#38;d=identicon&#38;r=G" medium="image">
			<media:title type="html">pvergain</media:title>
		</media:content>

		<media:content url="http://pvergain.files.wordpress.com/2009/09/serpent2.gif?w=131" medium="image">
			<media:title type="html">serpent2</media:title>
		</media:content>

		<media:content url="http://pvergain.files.wordpress.com/2009/09/reggie2.png" medium="image">
			<media:title type="html">reggie2</media:title>
		</media:content>

		<media:content url="http://pvergain.files.wordpress.com/2009/09/pslytherin.png?w=243" medium="image">
			<media:title type="html">pslytherin</media:title>
		</media:content>

		<media:content url="http://pvergain.files.wordpress.com/2009/09/gasp_lessons.png" medium="image">
			<media:title type="html">gasp_lessons</media:title>
		</media:content>
	</item>
		<item>
		<title>Les projets python de la semaine 37: Tornado (web) , sqlkit (database), HeeChee (mercurial-subversion), sinthgunt (video, ffmpeg)</title>
		<link>http://pvergain.wordpress.com/2009/09/12/les-projets-python-de-la-semaine-37-tornado-web-sqlkit-database-heechee-mercurial-subversion-sinthgunt-video-ffmpeg/</link>
		<comments>http://pvergain.wordpress.com/2009/09/12/les-projets-python-de-la-semaine-37-tornado-web-sqlkit-database-heechee-mercurial-subversion-sinthgunt-video-ffmpeg/#comments</comments>
		<pubDate>Sat, 12 Sep 2009 21:06:49 +0000</pubDate>
		<dc:creator>patrick</dc:creator>
				<category><![CDATA[2009]]></category>
		<category><![CDATA[bases de données]]></category>
		<category><![CDATA[camelot]]></category>
		<category><![CDATA[epoll]]></category>
		<category><![CDATA[ffmpeg]]></category>
		<category><![CDATA[mercurial]]></category>
		<category><![CDATA[PycURL]]></category>
		<category><![CDATA[sql]]></category>
		<category><![CDATA[subversion]]></category>
		<category><![CDATA[svn:externals]]></category>
		<category><![CDATA[vidéo]]></category>

		<guid isPermaLink="false">http://pvergain.wordpress.com/?p=495</guid>
		<description><![CDATA[
http://www.tornadoweb.org/ (&#8216;Tornado is an open source version of the scalable, non-blocking web server and tools that power FriendFeed. The FriendFeed application is written using a web framework that looks a bit like web.py or Google&#8217;s webapp, but with additional tools and optimizations to take advantage of the underlying non-blocking infrastructure. The framework is distinct from [...]<img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=pvergain.wordpress.com&blog=696018&post=495&subd=pvergain&ref=&feed=1" />]]></description>
			<content:encoded><![CDATA[<div class='snap_preview'><br /><ul>
<li><a title="Tornado" href="http://www.tornadoweb.org/" target="_blank">http://www.tornadoweb.org/ </a>(&#8216;<em><a href="http://www.tornadoweb.org/">Tornado</a> is an open source version of the scalable, non-blocking web server and tools that power <a href="http://friendfeed.com/">FriendFeed</a>. The FriendFeed application is written using a web framework that looks a bit like <a href="http://webpy.org/">web.py</a> or <a href="http://code.google.com/appengine/docs/python/tools/webapp/">Google&#8217;s webapp</a>, but with additional tools and optimizations to take advantage of the underlying <strong>non-blocking infrastructure</strong>. The framework is distinct from most mainstream web server frameworks (and certainly most Python frameworks) because it is non-blocking and reasonably fast. Because it is non-blocking and uses <a href="http://www.kernel.org/doc/man-pages/online/pages/man4/epoll.4.html">epoll</a>, it can handle thousands of simultaneous standing connections, which means it is ideal for real-time web services. We built the web server specifically to handle FriendFeed&#8217;s real-time features — every active user of FriendFeed maintains an open connection to the FriendFeed servers. (For more information on scaling servers to support thousands of clients, see The <a href="http://www.kegel.com/c10k.html">C10K problem</a>&#8230;Tornado has been tested on Python 2.5 and 2.6. To use all of the features of Tornado, you need to have <a href="http://pycurl.sourceforge.net/">PycURL</a><a href="http://pypi.python.org/pypi/simplejson/">simplejson</a> installed</em> and a JSON library like )&#8217;)
<ul>
<li><a title="Tornad on twisted" href="http://github.com/dustin/tornado/tree/master">http://github.com/dustin/tornado/tree/master</a> (<span id="repository_description"> a port of the tornado web framework to <a title="Twisted" href="http://twistedmatrix.com/trac/" target="_blank">twisted</a>.</span>)</li>
<li><a title="glyph" href="http://glyph.twistedmatrix.com/2009/09/what-i-wish-tornado-were.html" target="_blank">http://glyph.twistedmatrix.com/2009/09/what-i-wish-tornado-were.html </a>(&#8216;<em>In the course of developing Tornado, there are several things that FriendFeed could have done to move the Twisted community forward, at no cost to themselves.  I don&#8217;t want to rag on FriendFeed, or Bret Taylor, or Facebook here; they&#8217;re not the first to re-write something without communicating.  In fact I recently had almost this exact same discussion with <a href="https://garage.maemo.org/pipermail/brisa-develop/2009-August/thread.html">another project</a> that did the same thing.  Since Tornado is such a high-profile example, though, I want to draw attention to the problem so that there&#8217;s some hope that maybe the next project won&#8217;t forget to communicate first</em>.&#8217;)</li>
<li><a title="Tornado twisted" href="http://glyph.twistedmatrix.com/2009/09/tornado-twisted.html" target="_blank">http://glyph.twistedmatrix.com/2009/09/tornado-twisted.html </a>(&#8216;<em>Many kudos to Dustin Sallings, <a href="http://dustin.github.com/2009/09/12/tornado.html">who has <em>already</em> created a branch of Tornado which uses Twisted for both networking and HTTP parsing</a>, in probably less time than it took me to write my previous post about how somebody should do that.  Awesome!<br />
(The method it uses is currently a little weird, where you create a &#8220;Site&#8221; object, but it looks like it would be pretty simple to use a Resource instead if you were so inclined</em>.)&#8217;)</li>
</ul>
</li>
</ul>
<ul>
<li><a title="Heechee" href="//www.aeracode.org/2009/9/10/announcing-heechee/" target="_blank">http://www.aeracode.org/2009/9/10/announcing-heechee/ </a>(<em>&#8230;One of the particular issues I have is with<span style="color:#ff0000;"> svn:externals</span>. A lot of apps &#8211; including some we have at work &#8211; <strong>rely on svn:externals to pull in external dependencies into a libs folder along with the project itself</strong>. <span style="color:#ff0000;"><strong>Externals is one of the few features of subversion that I thought was pretty much perfect, and it was sad to see my move to Mercurial break it</strong></span>&#8230; <span id="profile_name">One of the questions led him onto <a href="http://hg-git.github.com/">hg-git</a> &#8211; the awesome git backend plugin for Mercurial, that the GitHub guys wrote &#8211; and how they first investigated the idea of an svn gateway to expose their repositories transparently to subversion users. From what I gathered, subversion&#8217;s wire format proved too tricky to deal with, and so they turned elsewhere&#8230;</span><span id="profile_name">After some digging, reading an obscure academic paper and liberal application of Wireshark, I grew confident enough that I could at least implement something. A day later, and <span style="text-decoration:underline;"><span style="color:#ff0000;"><strong>I&#8217;d like to present the very first version of what I&#8217;m calling Heechee</strong></span></span> (if you get the pun, ten nerd points).</span><span id="profile_name"> <span style="color:#ff0000;"><strong>Heechee is a transparent mercurial-as-subversion gateway</strong></span>. It serves a Mercurial repository as a Subversion <a title="webdav" href="http://en.wikipedia.org/wiki/WebDAV" target="_blank">WebDAV</a>-based repository. It&#8217;s still in the early stages, but at the moment it will serve its own mercurial repository to subversion in such a way that you can check out the repository, and update to various revisions within it.</span><span id="profile_name">You can <a href="http://bitbucket.org/andrewgodwin/heechee/">check it out at BitBucket</a>. It&#8217;s pretty alpha code, and make sure you have the dependencies mentioned in the README, but it works, which greatly surprises me. I plan to much improve the code to support more &#8216;advanced&#8217; features, like being able to do more than checkout and update, as well as exposing tags and branches correctly. There&#8217;s even the chance I&#8217;ll stick Git support in, when I&#8217;ve had a play with <a href="http://samba.org/%7Ejelmer/dulwich/">Dulwich</a>.</span></em>)</li>
</ul>
<ul>
<li><a title="sqlkit" href="http://sqlkit.argolinux.org/" target="_blank">http://sqlkit.argolinux.org/</a> (&#8216;<em>Sqlkit is a mini framework based on <a href="http://www.pygtk.org/">pygtk</a> that provides some very powerfull classes     to edit databases. It&#8217;s meant as a base for database desktop applications. Sqlkit is based on: </em></li>
</ul>
<blockquote>
<ul>
<li><em><a href="http://www.python.org/">Python</a></em></li>
<li><em><a href="http://www.pygtk.org/">Pygtk</a></em></li>
<li><em><a href="http://www.sqlalchemy.org/">sqlalchemy</a> (&gt;=0.5)</em></li>
<li><em><a href="http://labix.org/python-dateutil">python_dateutils </a></em></li>
<p><em><a href="http://labix.org/python-dateutil"> </a></em></p>
<li><em><a href="http://babel.edgewall.org/">babel</a> for localization</em></li>
<li><em>the correct driver for your database of choice</em>&#8216;).</li>
</ul>
<p>Un autre projet similaire est camelot basé sur pyQt (<a title="Camelot" href="http://pypi.python.org/pypi/Camelot" target="_blank">http://pypi.python.org/pypi/Camelot</a>/).</p></blockquote>
<ul>
<li><a title="sinthgunt" href="http://code.google.com/p/sinthgunt/" target="_blank"><span style="text-decoration:none;color:#000000;">http://code.google.com/p/sinthgunt/</span></a><a style="text-decoration:none;color:#000000;" title="sinthgunt" href="http://code.google.com/p/sinthgunt/" target="_blank"> </a> (&#8216;<em>Sinthgunt is an open source graphical user interface for <a rel="nofollow" href="http://www.ffmpeg.org/">ffmpeg</a>, a computer program that can convert digital audio and video into numerous formats. Using pre-configured conversion settings, it makes the task of converting between different media formates very easy.</em>&#8216;)</li>
</ul>
Posted in 2009, bases de données Tagged: camelot, epoll, ffmpeg, mercurial, PycURL, sql, subversion, svn:externals, vidéo <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gocomments/pvergain.wordpress.com/495/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/comments/pvergain.wordpress.com/495/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godelicious/pvergain.wordpress.com/495/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/delicious/pvergain.wordpress.com/495/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/gostumble/pvergain.wordpress.com/495/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/stumble/pvergain.wordpress.com/495/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/godigg/pvergain.wordpress.com/495/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/digg/pvergain.wordpress.com/495/" /></a> <a rel="nofollow" href="http://feeds.wordpress.com/1.0/goreddit/pvergain.wordpress.com/495/"><img alt="" border="0" src="http://feeds.wordpress.com/1.0/reddit/pvergain.wordpress.com/495/" /></a> <img alt="" border="0" src="http://stats.wordpress.com/b.gif?host=pvergain.wordpress.com&blog=696018&post=495&subd=pvergain&ref=&feed=1" /></div>]]></content:encoded>
			<wfw:commentRss>http://pvergain.wordpress.com/2009/09/12/les-projets-python-de-la-semaine-37-tornado-web-sqlkit-database-heechee-mercurial-subversion-sinthgunt-video-ffmpeg/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
	
		<media:content url="http://1.gravatar.com/avatar/9a2b1985a6f239af4bcfaa1f6199b5d4?s=96&#38;d=identicon&#38;r=G" medium="image">
			<media:title type="html">pvergain</media:title>
		</media:content>
	</item>
	</channel>
</rss>