config pour la version pdf

python/formation/Makefile

@@ -3,7 +3,7 @@
 
 # You can set these variables from the command line.
 SPHINXOPTS    =
-SPHINXBUILD   = sphinx-build2
+SPHINXBUILD   = sphinx-build
 PAPER         =
 BUILDDIR      = _build
 

python/formation/conf.py

@@ -40,8 +40,8 @@ source_suffix = '.txt'
 master_doc = 'index'
 
 # General information about the project.
-project = u'python'
+project = u'Formation Python'
-copyright = u'2012, cadoles (www.cadoles.com)'
+copyright = u'2015, cadoles (www.cadoles.com)'
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
@@ -50,7 +50,7 @@ copyright = u'2012, cadoles (www.cadoles.com)'
 # The short X.Y version.
 version = '1'
 # The full version, including alpha/beta/rc tags.
-release = '0'
+release = '1'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
@@ -183,8 +183,8 @@ latex_elements = {
 # Grouping the document tree into LaTeX files. List of tuples
 # (source start file, target name, title, author, documentclass [howto/manual]).
 latex_documents = [
-  ('index', 'python.tex', u'python Documentation',
+  ('index', 'python.tex', u'Formation Python',
-   u'gwen', 'manual'),
+   u'Gwen', 'manual'),
 ]
 
 # The name of an image file (relative to this directory) to place at the top of

python/formation/getting-started.txt

@@ -49,6 +49,16 @@ avec python :
 - lorsqu'on lance python sans spécifier de nom de fichier, c'est l'interpréteur
   python qui est lancé (le "prompt")
 
+
+En python, le dicton le plus répandu est "there must be an obvious way
+to do it", (il y a certainement une manière évidente de le faire en
+python), ``import this`` permet de se remémorer les
+dictons de python. Ce dicton est très différent de l'approche du perl
+par exemple, qui présuppose : "there is more than one way to do it",
+c'est-à-dire que en gros en perl, on peut le faire n'importe comment,
+mais pas en python, enfin en python c'est pas conseillé de le faire à sa
+sauce, il y a en général une bonne pratique à découvrir et à mettre en place.
+
 Taper "python" dans votre console
 
 ::

python/formation/settings.txt

@@ -3,39 +3,6 @@
 Mettre en place son environnement de travail
 =============================================
 
-un framework de développement intégré : :term:`IDLE`
-
-.. glossary::
-
-    IDLE
-        IDLE_ est un IDE (environnement de développement intégré) mis à disposition
-        dans la :term:`librairie standard` de python
-
-.. _IDLE: http://docs.python.org/2/library/idle.html
-
-.. glossary::
-
-    librairie standard
-
-        Une des règles de base de python est qu'il existe certainement une manière
-        conseillé de faire une tâche en python. Le premier réflexe est d'aller
-        voir dans la `librairie standard`_
-
-.. _`librairie standard`: http://docs.python.org/2.7/library/index.html
-
-Premier réflexe : la doc en ligne ou bien installée sur votre disque dur.
-
-la page d'accueil de la doc officielle python :
-
-.. image:: images/DocPython.png
-
-et surtout, une fois la librairie standard abordée, la page d'index des
-modules :
-
-.. image:: images/ModuleIndex.png
-
-
-
 Les éditeurs pour python
 -----------------------------
 
@@ -62,6 +29,17 @@ https://docs.python.org/2/library/idle.html
 Pour information, IDLE est un éditeur intégré (dans la lib standard de python)
 mais je te le déconseille (trop spartiate).
 
+un framework de développement intégré : :term:`IDLE`
+
+.. glossary::
+
+    IDLE
+        IDLE_ est un IDE (environnement de développement intégré) mis à disposition
+        dans la :term:`librairie standard` de python
+
+.. _IDLE: http://docs.python.org/2/library/idle.html
+
+
 nano
 --------
 
@@ -209,3 +187,28 @@ exemple de `.pystartup`
     # enhanced completion
     #import rlcompleter2
     #rlcompleter2.setup()
+
+
+Consulter la librairie standard
+-------------------------------------
+
+.. glossary::
+
+    librairie standard
+
+        Une des règles de base de python est qu'il existe certainement une manière
+        conseillé de faire une tâche en python. Le premier réflexe est d'aller
+        voir dans la `librairie standard`_
+
+.. _`librairie standard`: http://docs.python.org/2.7/library/index.html
+
+Premier réflexe : la doc en ligne ou bien installée sur votre disque dur.
+
+la page d'accueil de la doc officielle python :
+
+.. image:: images/DocPython.png
+
+et surtout, une fois la librairie standard abordée, la page d'index des
+modules :
+
+.. image:: images/ModuleIndex.png