Added interlink in the docs

docs/.build/html/_sources/en/apache_install.txt

@@ -2,7 +2,7 @@
 Apache setup
 =============
 
-Apache is heavier than Nginx. But it's also much more famous:
+Apache is heavier than :doc:`Nginx <./nginx_install>`. But it's also much more famous:
 
 - more people will be able to help you on forums;
 - your hosting will most probably support Apache;
@@ -17,7 +17,8 @@ installation facile. You'll benefit from having:
 - several Apache module at your disposal (like requests throttling);
 - Apache robustness in front end: it's secure, and there is much less chance
   it will crash under heavy load;
-- your web site processes won't run with admin rights, even if --user doesn't
+- your web site processes won't run with admin rights, even if
+  :ref:`--user <user-and-group-en>` doesn't
   work on your OS.
 
 

docs/.build/html/_sources/en/easy_install.txt

@@ -3,7 +3,8 @@ Easiest installation
 ====================
 
 These solution are easy all will be able to handle a personnal website traffic.
-For more robust and secure solutions, see Apache et Nginx setups.
+For more robust and secure solutions, see :doc:`Apache <./apache_install>`
+and :doc:`Nginx <./nginx_install>` setups.
 
 10 seconds setup (if you know Python already)
 ===============================================
@@ -25,14 +26,14 @@ On ubuntu, this is a one liner::
 
     wget stuff && unzip zerobin.zip && cd zerobin && sudo python zerobin.py --host 0.0.0.0 --port 80 --compressed-static
 
-Check out for more configuration options.
+Check out for more :doc:`configuration options <./options>`.
 
 Run 0bin in background
 =======================
 
-0bin doesn't come with something built in for this. You have several solutions:
+0bin doesn't come with something built in for this. You have several solutions.
 
-For a small website:
+*For a small website:*
 
 Just make it a shell background process. E.G in GNU/Linux::
 
@@ -40,10 +41,10 @@ Just make it a shell background process. E.G in GNU/Linux::
 
 Or run it in a screen.
 
-For a big Website:
+*For a big Website:*
 
-- setup 0bin with Apache;
-- setup 0bin with supervisord (best way to do it);
+- setup 0bin with :doc:`Apache <./apache_install>`;
+- setup 0bin with :doc:`supervisor <./using_supervisor>` (best way to do it).
 
 .. Note::
 

docs/.build/html/_sources/en/nginx_install.txt

@@ -8,8 +8,8 @@ Nginx is a very popular choice to serve a Python project:
 - It's lightweight.
 - Configuration files are simple.
 
-If you have your own server, it's the best choice. If not, try the easiest
-setup, or the Apache setup.
+If you have your own server, it's the best choice. If not, try the
+ :doc:`easiest setup <./easy_install>`, or the :doc:`Apache <./apache_install>` setup.
 
 Nginx doesn't run any Python process, it only serve requests from outside to
 the Python server.

docs/.build/html/_sources/en/options.txt

@@ -34,6 +34,8 @@ In debug mode, the server also reload automatically any modified Python file;
 Default: False
 Configuration file equivalent: DEBUG
 
+.. _user-and-group-en:
+
 --user and --group
 -------------------
 
@@ -109,6 +111,8 @@ In debug mode, the server also reload automatically any modified Python file;
 Default: False
 Command line equivalent: --debug
 
+.. _static-root-en:
+
 STATIC_FILES_ROOT
 ------------------
 
@@ -135,6 +139,8 @@ Absolute path to the directory in which 0bin is going to look save pastes.
 Default: "static/content" direcotry in the "zerobin" directory
 Command line equivalent: None
 
+.. _template-dirs-en:
+
 TEMPLATE_DIRS
 --------------
 

docs/.build/html/_sources/en/theming.txt

@@ -5,12 +5,12 @@ Theming
 0bin comes with a complete theming support, but for now it's not well integrated.
 
 If you wish to create your own theme, you'll need to create templates similar
-to the ones in zerobin/view, and add the path to the director containing them
-to the settings file.
+to the ones in zerobin/view, and add the path to the directory containing them
+to the :ref:`configuration file <template-dirs-en>`.
 
-You'll also need to copy static files from zerobin/static to a new direcotry
+You'll also need to copy static files from zerobin/static to a new directory
 where you can edit them. And you need to add this directory in the
-settings file too.
+:ref:`configuration file <static-root-en>` too.
 
 Of course, if you look for something simple, you can just edit all files in place/
 

docs/.build/html/_sources/fr/apache_install.txt

@@ -2,7 +2,8 @@
 Installation avec Apache
 =========================
 
-Apache est plus lourd que Nginx mais il est aussi beaucoup plus connu:
+Apache est plus lourd que :doc:`Nginx <./nginx_install>` mais il
+est aussi beaucoup plus connu:
 
 - plus de gens pourront vous aider les fora;
 - votre hébergeur propose surement Apache;
@@ -17,7 +18,7 @@ installation facile. Vous bénéficierez:
 - de la solidité d'Apache en front end: il est sécurité, et il y a peu de chance
   qu'il crash sous une forte charge;
 - les processus de votre site ne tournent pas avec les droits admin, même si
-  --user ne fonctionne pas sur votre OS.
+  :ref:`--user <user-and-group-fr>` ne fonctionne pas sur votre OS.
 
 Apache s'installe avec votre gestionnaire de paquet habituel, nous ne couvrierons
 pas cette partie.

docs/.build/html/_sources/fr/easy_install.txt

@@ -3,8 +3,8 @@ Installation la plus simple
 ============================
 
 Ces solutions sont simples et supportent le traffic d'un site web personnel.
-Pour des solutions plus solides et sécurisées, essayez les installtion Apache
-et Nginx.
+Pour des solutions plus solides et sécurisées, essayez les installation
+:doc:`Apache <./apache_install>` et :doc:`Nginx <./nginx_install>`.
 
 Installation en 10 secondes (si vous connaissez Python)
 ========================================================
@@ -27,15 +27,15 @@ Sous ubuntu, une line suffit::
 
     wget stuff && unzip zerobin.zip && cd zerobin && sudo python zerobin.py --host 0.0.0.0 --port 80 --compressed-static
 
-Jetez un oeil aux options de configuration.
+Jetez un oeil aux :doc:`options de configuration <./options>`.
 
 Faire tourner 0bin en arrière plan
 ==================================
 
 0bin ne vient pas avec un moyen intégré pour le faire. Il y a plusieurs
-solutions:
+solutions.
 
-Pour un petit site:
+*Pour un petit site:*
 
 Lancer simplement 0bin en processus shell d'arrière plan. Exemple sous GNU/Linux::
 
@@ -43,10 +43,10 @@ Lancer simplement 0bin en processus shell d'arrière plan. Exemple sous GNU/Linu
 
 Ou dans un screen.
 
-Pour les gros sites Web:
+*Pour les gros sites Web:*
 
-- configurer 0bin et Apache;
-- configure 0bin avec supervisord (recommandé).
+- configurer 0bin et :doc:`Apache <./apache_install>`;
+- configure 0bin avec :doc:`supervisor <./using_supervisor>` (recommandé).
 
 .. Note::
 
@@ -56,7 +56,7 @@ Pour les gros sites Web:
 
         python zerobin.py --host 0.0.0.0 --port 8000
 
-    0bin sera maintenant accessible sur http://your.local.ip.address:8000.
+    0bin sera maintenant accessible sur http://votre.addresse.ip.locale:8000.
 
     Ça peut être très un moyen très cool pour partager du code dans une entreprise
     ou a un code sprint.

docs/.build/html/_sources/fr/intro.txt

@@ -65,7 +65,7 @@ Problèmes connus
 =================
 
 - 0bin utilise plusieurs fonctionalités HTML5/CSS3 qui ne sont pas
-  encore largement supporté. Dans ce cas nous gérons la dégradation le plus
+  encore largement supportées. Dans ce cas nous gérons la dégradation le plus
   gracieusement possible.
 - La fonction "copier dans le press/papier" est buggée sous Linux. C'est du
   flash donc nous ne le réparerons pas. Il vaut mieux attendre le support

docs/.build/html/_sources/fr/nginx_install.txt

@@ -9,7 +9,8 @@ Nginx est un choix très populaire pour servir un projet Python:
 - Les fichiers de configuration sont très simple.
 
 Si vous avez votre propre serveur, c'est le meilleur choix. Dans le cas contraire,
-essayez l'installation la plus simple, ou avec Apache.
+essayez  :doc:`l'installation la plus simple <./easy_install>`,
+ou avec :doc:`Apache <./apache_install>`.
 
 Nginx ne lance aucun processus Python, il sert uniquement les requêtes
 depuis l'extérieur vers le server Python.

docs/.build/html/_sources/fr/options.txt

@@ -35,6 +35,8 @@ modifié.
 Défaut: False
 Equivalent du fichier de configuration : DEBUG
 
+.. _user-and-group-fr:
+
 --user et --group
 -------------------
 
@@ -110,6 +112,8 @@ modifié.
 Défaut: False
 Equivalent en ligne de commande : --debug
 
+.. _static-root-fr:
+
 STATIC_FILES_ROOT
 ------------------
 
@@ -136,6 +140,8 @@ Chemin absolu du dossier dans lequel 0bin va sauvegarder les pastes.
 Défaut: dossier "static/content" dans le dossier "zerobin"
 Equivalent en ligne de commande : Aucun
 
+.. _template-dirs-fr:
+
 TEMPLATE_DIRS
 --------------
 

docs/.build/html/_sources/fr/theming.txt

@@ -6,11 +6,12 @@ Personnaliser l'apparence
 
 Si vous souhaitez créer votre propre theme, il vous faut créer des templates
 similaires à ceux par défault présents dans zerobin/view, et
-ajouter le chemin du dossier contenant ces templates au fichier de settings.
+ajouter le chemin du dossier contenant ces templates au
+:ref:`fichier de configuration <template-dirs-fr>`..
 
 Vous aurez également besoin de copier les fichiers statiques présent
 dans zerobin/static dans un nouveau dossier, puis les modifier. Et signifier
-que vous utilisez ce dossier dans le fichiers de settings.
+que vous utilisez ce dossier dans le :ref:`fichier de configuration <static-root-fr>`.
 
 Vous pouvez bien entendu également éditez tous les fichier directement par
 souci de simplicité.

docs/.build/html/en/apache_install.html

@@ -53,7 +53,7 @@
             
   <div class="section" id="apache-setup">
 <h1>Apache setup<a class="headerlink" href="#apache-setup" title="Permalink to this headline">¶</a></h1>
-<p>Apache is heavier than Nginx. But it&#8217;s also much more famous:</p>
+<p>Apache is heavier than <a class="reference internal" href="nginx_install.html"><em>Nginx</em></a>. But it&#8217;s also much more famous:</p>
 <ul class="simple">
 <li>more people will be able to help you on forums;</li>
 <li>your hosting will most probably support Apache;</li>
@@ -67,7 +67,8 @@ installation facile. You&#8217;ll benefit from having:</p>
 <li>several Apache module at your disposal (like requests throttling);</li>
 <li>Apache robustness in front end: it&#8217;s secure, and there is much less chance
 it will crash under heavy load;</li>
-<li>your web site processes won&#8217;t run with admin rights, even if &#8211;user doesn&#8217;t
+<li>your web site processes won&#8217;t run with admin rights, even if
+<a class="reference internal" href="options.html#user-and-group-en"><em>&#8211;user</em></a> doesn&#8217;t
 work on your OS.</li>
 </ul>
 <div class="section" id="mod-wsgi">

docs/.build/html/en/easy_install.html

@@ -54,7 +54,8 @@
   <div class="section" id="easiest-installation">
 <h1>Easiest installation<a class="headerlink" href="#easiest-installation" title="Permalink to this headline">¶</a></h1>
 <p>These solution are easy all will be able to handle a personnal website traffic.
-For more robust and secure solutions, see Apache et Nginx setups.</p>
+For more robust and secure solutions, see <a class="reference internal" href="apache_install.html"><em>Apache</em></a>
+and <a class="reference internal" href="nginx_install.html"><em>Nginx</em></a> setups.</p>
 <div class="section" id="seconds-setup-if-you-know-python-already">
 <h2>10 seconds setup (if you know Python already)<a class="headerlink" href="#seconds-setup-if-you-know-python-already" title="Permalink to this headline">¶</a></h2>
 <p>pip install zerobin
@@ -73,20 +74,20 @@ with the admin rights.</li>
 <p>On ubuntu, this is a one liner:</p>
 <div class="highlight-python"><pre>wget stuff &amp;&amp; unzip zerobin.zip &amp;&amp; cd zerobin &amp;&amp; sudo python zerobin.py --host 0.0.0.0 --port 80 --compressed-static</pre>
 </div>
-<p>Check out for more configuration options.</p>
+<p>Check out for more <a class="reference internal" href="options.html"><em>configuration options</em></a>.</p>
 </div>
 <div class="section" id="run-0bin-in-background">
 <h2>Run 0bin in background<a class="headerlink" href="#run-0bin-in-background" title="Permalink to this headline">¶</a></h2>
-<p>0bin doesn&#8217;t come with something built in for this. You have several solutions:</p>
-<p>For a small website:</p>
+<p>0bin doesn&#8217;t come with something built in for this. You have several solutions.</p>
+<p><em>For a small website:</em></p>
 <p>Just make it a shell background process. E.G in GNU/Linux:</p>
 <div class="highlight-python"><pre>nohup python zerobin.py --host 0.0.0.0 --port 80 --compressed-static &amp;</pre>
 </div>
 <p>Or run it in a screen.</p>
-<p>For a big Website:</p>
+<p><em>For a big Website:</em></p>
 <ul class="simple">
-<li>setup 0bin with Apache;</li>
-<li>setup 0bin with supervisord (best way to do it);</li>
+<li>setup 0bin with <a class="reference internal" href="apache_install.html"><em>Apache</em></a>;</li>
+<li>setup 0bin with <a class="reference internal" href="using_supervisor.html"><em>supervisor</em></a> (best way to do it).</li>
 </ul>
 <div class="admonition note">
 <p class="first admonition-title">Note</p>

docs/.build/html/en/nginx_install.html

@@ -59,8 +59,10 @@
 <li>It&#8217;s lightweight.</li>
 <li>Configuration files are simple.</li>
 </ul>
-<p>If you have your own server, it&#8217;s the best choice. If not, try the easiest
-setup, or the Apache setup.</p>
+<dl class="docutils">
+<dt>If you have your own server, it&#8217;s the best choice. If not, try the</dt>
+<dd><a class="reference internal" href="easy_install.html"><em>easiest setup</em></a>, or the <a class="reference internal" href="apache_install.html"><em>Apache</em></a> setup.</dd>
+</dl>
 <p>Nginx doesn&#8217;t run any Python process, it only serve requests from outside to
 the Python server.</p>
 <p>Therefor there are two steps:</p>

docs/.build/html/en/options.html

@@ -76,7 +76,7 @@ instead of showing the 500 error page.</p>
 Configuration file equivalent: DEBUG</p>
 </div>
 <div class="section" id="user-and-group">
-<h3>&#8211;user and &#8211;group<a class="headerlink" href="#user-and-group" title="Permalink to this headline">¶</a></h3>
+<span id="user-and-group-en"></span><h3>&#8211;user and &#8211;group<a class="headerlink" href="#user-and-group" title="Permalink to this headline">¶</a></h3>
 <p>The user and group the server will adopt after start up.</p>
 <p>Useful when you run the command with admin rights to be able to listen to the
 port 80, but you wish that the process do not have access to protected files.</p>
@@ -132,7 +132,7 @@ instead of showing the 500 error page.</p>
 Command line equivalent: &#8211;debug</p>
 </div>
 <div class="section" id="static-files-root">
-<h3>STATIC_FILES_ROOT<a class="headerlink" href="#static-files-root" title="Permalink to this headline">¶</a></h3>
+<span id="static-root-en"></span><h3>STATIC_FILES_ROOT<a class="headerlink" href="#static-files-root" title="Permalink to this headline">¶</a></h3>
 <p>Asbolute path to the directory where 0bin is going to look for static files
 (css, js and images).</p>
 <p>Default:  &#8220;static&#8221; directory in the &#8220;zerobin&#8221; directory
@@ -152,7 +152,7 @@ Command line equivalent: &#8211;compressed-static</p>
 Command line equivalent: None</p>
 </div>
 <div class="section" id="template-dirs">
-<h3>TEMPLATE_DIRS<a class="headerlink" href="#template-dirs" title="Permalink to this headline">¶</a></h3>
+<span id="template-dirs-en"></span><h3>TEMPLATE_DIRS<a class="headerlink" href="#template-dirs" title="Permalink to this headline">¶</a></h3>
 <p>List of absolute path to directories containing templates that 0bin uses to
 generate the web site pages. The first list items have priotity on the later.</p>
 <p>If you wish to use your own templates, add the directory containing them

docs/.build/html/en/theming.html

@@ -55,11 +55,11 @@
 <h1>Theming<a class="headerlink" href="#theming" title="Permalink to this headline">¶</a></h1>
 <p>0bin comes with a complete theming support, but for now it&#8217;s not well integrated.</p>
 <p>If you wish to create your own theme, you&#8217;ll need to create templates similar
-to the ones in zerobin/view, and add the path to the director containing them
-to the settings file.</p>
-<p>You&#8217;ll also need to copy static files from zerobin/static to a new direcotry
+to the ones in zerobin/view, and add the path to the directory containing them
+to the <a class="reference internal" href="options.html#template-dirs-en"><em>configuration file</em></a>.</p>
+<p>You&#8217;ll also need to copy static files from zerobin/static to a new directory
 where you can edit them. And you need to add this directory in the
-settings file too.</p>
+<em class="xref std std-ref">configuration file</em> too.</p>
 <p>Of course, if you look for something simple, you can just edit all files in place/</p>
 <p>But be careful, the javascript code is tightly coupled with HTML ID and classes,
 and they are not very well organized for now.</p>

docs/.build/html/fr/apache_install.html

@@ -53,7 +53,8 @@
             
   <div class="section" id="installation-avec-apache">
 <h1>Installation avec Apache<a class="headerlink" href="#installation-avec-apache" title="Permalink to this headline">¶</a></h1>
-<p>Apache est plus lourd que Nginx mais il est aussi beaucoup plus connu:</p>
+<p>Apache est plus lourd que <a class="reference internal" href="nginx_install.html"><em>Nginx</em></a> mais il
+est aussi beaucoup plus connu:</p>
 <ul class="simple">
 <li>plus de gens pourront vous aider les fora;</li>
 <li>votre hébergeur propose surement Apache;</li>
@@ -68,7 +69,7 @@ du nombre de requêtes);</li>
 <li>de la solidité d&#8217;Apache en front end: il est sécurité, et il y a peu de chance
 qu&#8217;il crash sous une forte charge;</li>
 <li>les processus de votre site ne tournent pas avec les droits admin, même si
-&#8211;user ne fonctionne pas sur votre OS.</li>
+<a class="reference internal" href="options.html#user-and-group-fr"><em>&#8211;user</em></a> ne fonctionne pas sur votre OS.</li>
 </ul>
 <p>Apache s&#8217;installe avec votre gestionnaire de paquet habituel, nous ne couvrierons
 pas cette partie.</p>

docs/.build/html/fr/easy_install.html

@@ -54,8 +54,8 @@
   <div class="section" id="installation-la-plus-simple">
 <h1>Installation la plus simple<a class="headerlink" href="#installation-la-plus-simple" title="Permalink to this headline">¶</a></h1>
 <p>Ces solutions sont simples et supportent le traffic d&#8217;un site web personnel.
-Pour des solutions plus solides et sécurisées, essayez les installtion Apache
-et Nginx.</p>
+Pour des solutions plus solides et sécurisées, essayez les installation
+<a class="reference internal" href="apache_install.html"><em>Apache</em></a> et <a class="reference internal" href="nginx_install.html"><em>Nginx</em></a>.</p>
 <div class="section" id="installation-en-10-secondes-si-vous-connaissez-python">
 <h2>Installation en 10 secondes (si vous connaissez Python)<a class="headerlink" href="#installation-en-10-secondes-si-vous-connaissez-python" title="Permalink to this headline">¶</a></h2>
 <p>pip install zerobin
@@ -74,21 +74,21 @@ avec les droits admin.</li>
 <p>Sous ubuntu, une line suffit:</p>
 <div class="highlight-python"><pre>wget stuff &amp;&amp; unzip zerobin.zip &amp;&amp; cd zerobin &amp;&amp; sudo python zerobin.py --host 0.0.0.0 --port 80 --compressed-static</pre>
 </div>
-<p>Jetez un oeil aux options de configuration.</p>
+<p>Jetez un oeil aux <a class="reference internal" href="options.html"><em>options de configuration</em></a>.</p>
 </div>
 <div class="section" id="faire-tourner-0bin-en-arriere-plan">
 <h2>Faire tourner 0bin en arrière plan<a class="headerlink" href="#faire-tourner-0bin-en-arriere-plan" title="Permalink to this headline">¶</a></h2>
 <p>0bin ne vient pas avec un moyen intégré pour le faire. Il y a plusieurs
-solutions:</p>
-<p>Pour un petit site:</p>
+solutions.</p>
+<p><em>Pour un petit site:</em></p>
 <p>Lancer simplement 0bin en processus shell d&#8217;arrière plan. Exemple sous GNU/Linux:</p>
 <div class="highlight-python"><pre>nohup python zerobin.py --host 0.0.0.0 --port 80 --compressed-static &amp;</pre>
 </div>
 <p>Ou dans un screen.</p>
-<p>Pour les gros sites Web:</p>
+<p><em>Pour les gros sites Web:</em></p>
 <ul class="simple">
-<li>configurer 0bin et Apache;</li>
-<li>configure 0bin avec supervisord (recommandé).</li>
+<li>configurer 0bin et <a class="reference internal" href="apache_install.html"><em>Apache</em></a>;</li>
+<li>configure 0bin avec <a class="reference internal" href="using_supervisor.html"><em>supervisor</em></a> (recommandé).</li>
 </ul>
 <div class="admonition note">
 <p class="first admonition-title">Note</p>
@@ -96,7 +96,7 @@ solutions:</p>
 <p>Assurez vous que votre parefeu ne bloque pas le port, et lancez:</p>
 <div class="highlight-python"><pre>python zerobin.py --host 0.0.0.0 --port 8000</pre>
 </div>
-<p>0bin sera maintenant accessible sur <a class="reference external" href="http://your.local.ip.address:8000">http://your.local.ip.address:8000</a>.</p>
+<p>0bin sera maintenant accessible sur <a class="reference external" href="http://votre.addresse.ip.locale:8000">http://votre.addresse.ip.locale:8000</a>.</p>
 <p class="last">Ça peut être très un moyen très cool pour partager du code dans une entreprise
 ou a un code sprint.</p>
 </div>

docs/.build/html/fr/intro.html

@@ -114,7 +114,7 @@ plutôt qu&#8217;utiliser le copier/coller;</li>
 <h2>Problèmes connus<a class="headerlink" href="#problemes-connus" title="Permalink to this headline">¶</a></h2>
 <ul class="simple">
 <li>0bin utilise plusieurs fonctionalités HTML5/CSS3 qui ne sont pas
-encore largement supporté. Dans ce cas nous gérons la dégradation le plus
+encore largement supportées. Dans ce cas nous gérons la dégradation le plus
 gracieusement possible.</li>
 <li>La fonction &#8220;copier dans le press/papier&#8221; est buggée sous Linux. C&#8217;est du
 flash donc nous ne le réparerons pas. Il vaut mieux attendre le support

docs/.build/html/fr/nginx_install.html

@@ -60,7 +60,8 @@
 <li>Les fichiers de configuration sont très simple.</li>
 </ul>
 <p>Si vous avez votre propre serveur, c&#8217;est le meilleur choix. Dans le cas contraire,
-essayez l&#8217;installation la plus simple, ou avec Apache.</p>
+essayez  <a class="reference internal" href="easy_install.html"><em>l&#8217;installation la plus simple</em></a>,
+ou avec <a class="reference internal" href="apache_install.html"><em>Apache</em></a>.</p>
 <p>Nginx ne lance aucun processus Python, il sert uniquement les requêtes
 depuis l&#8217;extérieur vers le server Python.</p>
 <p>Il y a donc deux étapes:</p>

docs/.build/html/fr/options.html

@@ -74,7 +74,7 @@ modifié.</p>
 Equivalent du fichier de configuration : DEBUG</p>
 </div>
 <div class="section" id="user-et-group">
-<h3>&#8211;user et &#8211;group<a class="headerlink" href="#user-et-group" title="Permalink to this headline">¶</a></h3>
+<span id="user-and-group-fr"></span><h3>&#8211;user et &#8211;group<a class="headerlink" href="#user-et-group" title="Permalink to this headline">¶</a></h3>
 <p>L&#8217;utilisateur et le group que le serveur essayera d&#8217;adopter après le démarrage.</p>
 <p>Utile quand on lance la commande avec les droits admin afin de pouvoir
 écouter sur le port 80, mais qu&#8217;on souhaite, pour des raisons de sécurité, que
@@ -132,7 +132,7 @@ modifié.</p>
 Equivalent en ligne de commande : &#8211;debug</p>
 </div>
 <div class="section" id="static-files-root">
-<h3>STATIC_FILES_ROOT<a class="headerlink" href="#static-files-root" title="Permalink to this headline">¶</a></h3>
+<span id="static-root-fr"></span><h3>STATIC_FILES_ROOT<a class="headerlink" href="#static-files-root" title="Permalink to this headline">¶</a></h3>
 <p>Chemin absolu du dossier dans lequel 0bin va chercher les fichiers statiques
 (css, js et images).</p>
 <p>Défaut: dossier &#8220;static&#8221; dans le dossier &#8220;zerobin&#8221;
@@ -152,7 +152,7 @@ Equivalent en ligne de commande : &#8211;compressed-static</p>
 Equivalent en ligne de commande : Aucun</p>
 </div>
 <div class="section" id="template-dirs">
-<h3>TEMPLATE_DIRS<a class="headerlink" href="#template-dirs" title="Permalink to this headline">¶</a></h3>
+<span id="template-dirs-fr"></span><h3>TEMPLATE_DIRS<a class="headerlink" href="#template-dirs" title="Permalink to this headline">¶</a></h3>
 <p>Liste des chemins absolus des dossiers qui contiennent les templates que 0bin
 utilise pour générer les pages du site. Les premiers éléments de la liste
 ont priorités sur les suivant.</p>

docs/.build/html/fr/theming.html

@@ -56,10 +56,11 @@
 <p>0bin possède un support de theming complet, mais pour le moment mal intégré.</p>
 <p>Si vous souhaitez créer votre propre theme, il vous faut créer des templates
 similaires à ceux par défault présents dans zerobin/view, et
-ajouter le chemin du dossier contenant ces templates au fichier de settings.</p>
+ajouter le chemin du dossier contenant ces templates au
+<a class="reference internal" href="options.html#template-dirs-fr"><em>fichier de configuration</em></a>..</p>
 <p>Vous aurez également besoin de copier les fichiers statiques présent
 dans zerobin/static dans un nouveau dossier, puis les modifier. Et signifier
-que vous utilisez ce dossier dans le fichiers de settings.</p>
+que vous utilisez ce dossier dans le <em class="xref std std-ref">fichier de configuration</em>.</p>
 <p>Vous pouvez bien entendu également éditez tous les fichier directement par
 souci de simplicité.</p>
 <p>Attention cependant, le code javascript est très dépendant des ID et classes

docs/en/apache_install.rst

@@ -2,7 +2,7 @@
 Apache setup
 =============
 
-Apache is heavier than Nginx. But it's also much more famous:
+Apache is heavier than :doc:`Nginx <./nginx_install>`. But it's also much more famous:
 
 - more people will be able to help you on forums;
 - your hosting will most probably support Apache;
@@ -17,7 +17,8 @@ installation facile. You'll benefit from having:
 - several Apache module at your disposal (like requests throttling);
 - Apache robustness in front end: it's secure, and there is much less chance
   it will crash under heavy load;
-- your web site processes won't run with admin rights, even if --user doesn't
+- your web site processes won't run with admin rights, even if
+  :ref:`--user <user-and-group-en>` doesn't
   work on your OS.
 
 

docs/en/easy_install.rst

@@ -3,7 +3,8 @@ Easiest installation
 ====================
 
 These solution are easy all will be able to handle a personnal website traffic.
-For more robust and secure solutions, see Apache et Nginx setups.
+For more robust and secure solutions, see :doc:`Apache <./apache_install>`
+and :doc:`Nginx <./nginx_install>` setups.
 
 10 seconds setup (if you know Python already)
 ===============================================
@@ -25,14 +26,14 @@ On ubuntu, this is a one liner::
 
     wget stuff && unzip zerobin.zip && cd zerobin && sudo python zerobin.py --host 0.0.0.0 --port 80 --compressed-static
 
-Check out for more configuration options.
+Check out for more :doc:`configuration options <./options>`.
 
 Run 0bin in background
 =======================
 
-0bin doesn't come with something built in for this. You have several solutions:
+0bin doesn't come with something built in for this. You have several solutions.
 
-For a small website:
+*For a small website:*
 
 Just make it a shell background process. E.G in GNU/Linux::
 
@@ -40,10 +41,10 @@ Just make it a shell background process. E.G in GNU/Linux::
 
 Or run it in a screen.
 
-For a big Website:
+*For a big Website:*
 
-- setup 0bin with Apache;
-- setup 0bin with supervisord (best way to do it);
+- setup 0bin with :doc:`Apache <./apache_install>`;
+- setup 0bin with :doc:`supervisor <./using_supervisor>` (best way to do it).
 
 .. Note::
 

docs/en/nginx_install.rst

@@ -8,8 +8,8 @@ Nginx is a very popular choice to serve a Python project:
 - It's lightweight.
 - Configuration files are simple.
 
-If you have your own server, it's the best choice. If not, try the easiest
-setup, or the Apache setup.
+If you have your own server, it's the best choice. If not, try the
+ :doc:`easiest setup <./easy_install>`, or the :doc:`Apache <./apache_install>` setup.
 
 Nginx doesn't run any Python process, it only serve requests from outside to
 the Python server.

docs/en/options.rst

@@ -34,6 +34,8 @@ In debug mode, the server also reload automatically any modified Python file;
 Default: False
 Configuration file equivalent: DEBUG
 
+.. _user-and-group-en:
+
 --user and --group
 -------------------
 
@@ -109,6 +111,8 @@ In debug mode, the server also reload automatically any modified Python file;
 Default: False
 Command line equivalent: --debug
 
+.. _static-root-en:
+
 STATIC_FILES_ROOT
 ------------------
 
@@ -135,6 +139,8 @@ Absolute path to the directory in which 0bin is going to look save pastes.
 Default: "static/content" direcotry in the "zerobin" directory
 Command line equivalent: None
 
+.. _template-dirs-en:
+
 TEMPLATE_DIRS
 --------------
 

docs/en/theming.rst

@@ -5,12 +5,12 @@ Theming
 0bin comes with a complete theming support, but for now it's not well integrated.
 
 If you wish to create your own theme, you'll need to create templates similar
-to the ones in zerobin/view, and add the path to the director containing them
-to the settings file.
+to the ones in zerobin/view, and add the path to the directory containing them
+to the :ref:`configuration file <template-dirs-en>`.
 
-You'll also need to copy static files from zerobin/static to a new direcotry
+You'll also need to copy static files from zerobin/static to a new directory
 where you can edit them. And you need to add this directory in the
-settings file too.
+:ref:`configuration file <static-root-en>` too.
 
 Of course, if you look for something simple, you can just edit all files in place/
 

docs/fr/apache_install.rst

@@ -2,7 +2,8 @@
 Installation avec Apache
 =========================
 
-Apache est plus lourd que Nginx mais il est aussi beaucoup plus connu:
+Apache est plus lourd que :doc:`Nginx <./nginx_install>` mais il
+est aussi beaucoup plus connu:
 
 - plus de gens pourront vous aider les fora;
 - votre hébergeur propose surement Apache;
@@ -17,7 +18,7 @@ installation facile. Vous bénéficierez:
 - de la solidité d'Apache en front end: il est sécurité, et il y a peu de chance
   qu'il crash sous une forte charge;
 - les processus de votre site ne tournent pas avec les droits admin, même si
-  --user ne fonctionne pas sur votre OS.
+  :ref:`--user <user-and-group-fr>` ne fonctionne pas sur votre OS.
 
 Apache s'installe avec votre gestionnaire de paquet habituel, nous ne couvrierons
 pas cette partie.

docs/fr/easy_install.rst

@@ -3,8 +3,8 @@ Installation la plus simple
 ============================
 
 Ces solutions sont simples et supportent le traffic d'un site web personnel.
-Pour des solutions plus solides et sécurisées, essayez les installtion Apache
-et Nginx.
+Pour des solutions plus solides et sécurisées, essayez les installation
+:doc:`Apache <./apache_install>` et :doc:`Nginx <./nginx_install>`.
 
 Installation en 10 secondes (si vous connaissez Python)
 ========================================================
@@ -27,15 +27,15 @@ Sous ubuntu, une line suffit::
 
     wget stuff && unzip zerobin.zip && cd zerobin && sudo python zerobin.py --host 0.0.0.0 --port 80 --compressed-static
 
-Jetez un oeil aux options de configuration.
+Jetez un oeil aux :doc:`options de configuration <./options>`.
 
 Faire tourner 0bin en arrière plan
 ==================================
 
 0bin ne vient pas avec un moyen intégré pour le faire. Il y a plusieurs
-solutions:
+solutions.
 
-Pour un petit site:
+*Pour un petit site:*
 
 Lancer simplement 0bin en processus shell d'arrière plan. Exemple sous GNU/Linux::
 
@@ -43,10 +43,10 @@ Lancer simplement 0bin en processus shell d'arrière plan. Exemple sous GNU/Linu
 
 Ou dans un screen.
 
-Pour les gros sites Web:
+*Pour les gros sites Web:*
 
-- configurer 0bin et Apache;
-- configure 0bin avec supervisord (recommandé).
+- configurer 0bin et :doc:`Apache <./apache_install>`;
+- configure 0bin avec :doc:`supervisor <./using_supervisor>` (recommandé).
 
 .. Note::
 
@@ -56,7 +56,7 @@ Pour les gros sites Web:
 
         python zerobin.py --host 0.0.0.0 --port 8000
 
-    0bin sera maintenant accessible sur http://your.local.ip.address:8000.
+    0bin sera maintenant accessible sur http://votre.addresse.ip.locale:8000.
 
     Ça peut être très un moyen très cool pour partager du code dans une entreprise
     ou a un code sprint.

docs/fr/intro.rst

@@ -65,7 +65,7 @@ Problèmes connus
 =================
 
 - 0bin utilise plusieurs fonctionalités HTML5/CSS3 qui ne sont pas
-  encore largement supporté. Dans ce cas nous gérons la dégradation le plus
+  encore largement supportées. Dans ce cas nous gérons la dégradation le plus
   gracieusement possible.
 - La fonction "copier dans le press/papier" est buggée sous Linux. C'est du
   flash donc nous ne le réparerons pas. Il vaut mieux attendre le support

docs/fr/nginx_install.rst

@@ -9,7 +9,8 @@ Nginx est un choix très populaire pour servir un projet Python:
 - Les fichiers de configuration sont très simple.
 
 Si vous avez votre propre serveur, c'est le meilleur choix. Dans le cas contraire,
-essayez l'installation la plus simple, ou avec Apache.
+essayez  :doc:`l'installation la plus simple <./easy_install>`,
+ou avec :doc:`Apache <./apache_install>`.
 
 Nginx ne lance aucun processus Python, il sert uniquement les requêtes
 depuis l'extérieur vers le server Python.

docs/fr/options.rst

@@ -35,6 +35,8 @@ modifié.
 Défaut: False
 Equivalent du fichier de configuration : DEBUG
 
+.. _user-and-group-fr:
+
 --user et --group
 -------------------
 
@@ -110,6 +112,8 @@ modifié.
 Défaut: False
 Equivalent en ligne de commande : --debug
 
+.. _static-root-fr:
+
 STATIC_FILES_ROOT
 ------------------
 
@@ -136,6 +140,8 @@ Chemin absolu du dossier dans lequel 0bin va sauvegarder les pastes.
 Défaut: dossier "static/content" dans le dossier "zerobin"
 Equivalent en ligne de commande : Aucun
 
+.. _template-dirs-fr:
+
 TEMPLATE_DIRS
 --------------
 

docs/fr/theming.rst

@@ -6,11 +6,12 @@ Personnaliser l'apparence
 
 Si vous souhaitez créer votre propre theme, il vous faut créer des templates
 similaires à ceux par défault présents dans zerobin/view, et
-ajouter le chemin du dossier contenant ces templates au fichier de settings.
+ajouter le chemin du dossier contenant ces templates au
+:ref:`fichier de configuration <template-dirs-fr>`..
 
 Vous aurez également besoin de copier les fichiers statiques présent
 dans zerobin/static dans un nouveau dossier, puis les modifier. Et signifier
-que vous utilisez ce dossier dans le fichiers de settings.
+que vous utilisez ce dossier dans le :ref:`fichier de configuration <static-root-fr>`.
 
 Vous pouvez bien entendu également éditez tous les fichier directement par
 souci de simplicité.