1
0
mirror of https://github.com/Tygs/0bin.git synced 2023-08-10 21:13:00 +03:00

Fixed some links and typos

This commit is contained in:
sam
2012-05-18 22:58:14 +02:00
parent 611570b1d3
commit 84fe98137d
38 changed files with 228 additions and 100 deletions

View File

@ -2,6 +2,9 @@
Apache setup
=============
.. Note::
You need to have followed the :doc:`easy install <./easy_install>` first.
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;

View File

@ -9,6 +9,8 @@ and :doc:`Nginx <./nginx_install>` setups.
10 seconds setup (if you know Python already)
===============================================
Just type::
pip install zerobin
zerobin --host 0.0.0.0 --port 80 --compressed-static # as admin
@ -19,8 +21,9 @@ zerobin --host 0.0.0.0 --port 80 --compressed-static # as admin
- Download the last zip of the sources code.
- Extract all of it where you wish the site to be stored.
- Go to the extracted files.
- Run `python zerobin.py --host 0.0.0.0 --port 80 --compressed-static`
with the admin rights.
- Run with the admin rights::
python zerobin.py --host 0.0.0.0 --port 80 --compressed-static
On ubuntu, this is a one liner::

View File

@ -2,6 +2,9 @@
Nginx setup
============
.. Note::
You need to have followed the :doc:`easy install <./easy_install>` first.
Nginx is a very popular choice to serve a Python project:
- It's fast.

View File

@ -20,6 +20,7 @@ The host and port on which to listen for incomming request. Usually 127.0.0.1
and 8000 to listen locally or 0.0.0.0 and 80 to listen from the outside.
Default: 127.0.0.1 and 8000
Setting file : HOST and PORT
@ -32,6 +33,7 @@ instead of showing the 500 error page.
In debug mode, the server also reload automatically any modified Python file;
Default: False
Configuration file equivalent: DEBUG
.. _user-and-group-en:
@ -47,6 +49,7 @@ port 80, but you wish that the process do not have access to protected files.
--group is set to --user if not passed.
Default: None
Configuration file equivalent: USER and GROUP
--settings-file
@ -55,6 +58,7 @@ Configuration file equivalent: USER and GROUP
Path to the configuration file, if you use any.
Default: None
Configuration file equivalent: None
@ -65,6 +69,7 @@ Serve minified static files (css and js). Use it in production to get a faster
web site.
Default: False
Configuration file equivalent: COMPRESSED_STATIC_FILES
--version and --help
@ -73,6 +78,7 @@ Configuration file equivalent: COMPRESSED_STATIC_FILES
Display the help or the version of 0bin.
Default: None
Configuration file equivalent: None
Examples
@ -86,6 +92,7 @@ Developpement::
zerobin --debug --serve-static
Configuration file
====================
@ -109,6 +116,7 @@ In debug mode, the server also reload automatically any modified Python file;
Default: False
Command line equivalent: --debug
.. _static-root-en:
@ -120,6 +128,7 @@ Asbolute path to the directory where 0bin is going to look for static files
(css, js and images).
Default: "static" directory in the "zerobin" directory
Command line equivalent: None
COMPRESSED_STATIC_FILES
@ -129,6 +138,7 @@ Serve minified static files (css and js). Use it in production to get a faster
web site.
Default: False
Command line equivalent: --compressed-static
PASTE_FILES_ROOT
@ -137,6 +147,7 @@ PASTE_FILES_ROOT
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:
@ -157,6 +168,7 @@ at the begining of the list::
) + TEMPLATE_DIRS
Default: "view" directory in the "zerobin" directory
Command line equivalent: None
HOST and PORT
@ -167,6 +179,7 @@ The host and port on which to listen for incomming request. Usually 127.0.0.1
and 8000 to listen locally or 0.0.0.0 and 80 to listen from the outside.
Default: 127.0.0.1 and 8000
Configuration file equivalent: --host and --port
USER and GROUP
@ -180,6 +193,7 @@ port 80, but you wish that the process do not have access to protected files.
GROUP is set to USER if not passed.
Default: None
Configuration file equivalent: --user and --group
MENU
@ -199,6 +213,7 @@ Default::
('Contact', 'mailto:your@email.com') # email
)
Command line equivalent: None
MAX_SIZE
@ -209,4 +224,5 @@ Approximative value for a paste size limite.
Valeur approximative de limite de taille d'un paste.
Default = 500000 octets (500 ko)
Command line equivalent: None

View File

@ -2,6 +2,9 @@
Installation avec Apache
=========================
.. Note::
Vous devez avoir suivi :doc:`l'installation facile <./easy_install>` avant.
Apache est plus lourd que :doc:`Nginx <./nginx_install>` mais il
est aussi beaucoup plus connu:

View File

@ -9,6 +9,8 @@ Pour des solutions plus solides et sécurisées, essayez les installation
Installation en 10 secondes (si vous connaissez Python)
========================================================
Entrez::
pip install zerobin
zerobin --host 0.0.0.0 --port 80 --compressed-static # en tant qu'admin
@ -20,8 +22,9 @@ Installation en 30 secondes (pour tous)
- Télécharger le dernier zip du code source.
- Décompressez tous les fichiers là où vous souhaitez mettre le site.
- Allez dans les dossiers extraits.
- Lancez `python zerobin.py --host 0.0.0.0 --port 80 --compressed-static`
avec les droits admin.
- Lancez avec les droits admin::
python zerobin.py --host 0.0.0.0 --port 80 --compressed-static
Sous ubuntu, une line suffit::

View File

@ -2,6 +2,9 @@
Installation avec Nginx
========================
.. Note::
Vous devez avoir suivi :doc:`l'installation facile <./easy_install>` avant.
Nginx est un choix très populaire pour servir un projet Python:
- Il est rapide.

View File

@ -20,6 +20,7 @@ L'hôte et le port sur lesquels écouter les requêtes entrantes. En général
écouter les requêtes extérieures.
Défaut: 127.0.0.1 et 8000
Equivalent du fichier de configuration : HOST et PORT
@ -33,6 +34,7 @@ En mode debug, le serveur recharge aussi automatiquement tout fichier Python
modifié.
Défaut: False
Equivalent du fichier de configuration : DEBUG
.. _user-and-group-fr:
@ -49,6 +51,7 @@ le processus n'est pas accès aux fichiers protégés du système.
--group prend de --user si il n'est pas précisé.
Défaut: Aucun
Equivalent du fichier de configuration : USER et GROUP
--settings-file
@ -57,6 +60,7 @@ Equivalent du fichier de configuration : USER et GROUP
Chemin vers le fichier de configuration, si vous souhaitez en utiliser un.
Défaut: Aucun
Equivalent du fichier de configuration : Aucun
@ -67,6 +71,7 @@ Sert les versions minifiées fichiers statiques (css et js). A utiliser en
production pour un site plus rapide.
Défaut: False
Equivalent du fichier de configuration : COMPRESSED_STATIC_FILES
--version et --help
@ -75,6 +80,7 @@ Equivalent du fichier de configuration : COMPRESSED_STATIC_FILES
Affiche l'aide ou la version de 0bin
Défaut: Aucun
Equivalent du fichier de configuration : Aucun
Exemples
@ -110,6 +116,7 @@ En mode debug, le serveur recharge aussi automatiquement tout fichier Python
modifié.
Défaut: False
Equivalent en ligne de commande : --debug
.. _static-root-fr:
@ -121,6 +128,7 @@ Chemin absolu du dossier dans lequel 0bin va chercher les fichiers statiques
(css, js et images).
Défaut: dossier "static" dans le dossier "zerobin"
Equivalent en ligne de commande : Aucun
COMPRESSED_STATIC_FILES
@ -130,6 +138,7 @@ Sert les versions minifiées fichiers statiques (css et js). A utiliser en
production pour un site plus rapide.
Défaut: False
Equivalent en ligne de commande : --compressed-static
PASTE_FILES_ROOT
@ -138,6 +147,7 @@ PASTE_FILES_ROOT
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:
@ -159,6 +169,7 @@ contient au début de la liste::
) + TEMPLATE_DIRS
Défaut: dossier "view" dans le dossier "zerobin"
Equivalent en ligne de commande : Aucun
@ -170,6 +181,7 @@ L'hôte et le port sur lesquels écouter les requêtes entrantes. En général
écouter les requêtes extérieures.
Défaut: 127.0.0.1 et 8000
Equivalent du fichier de configuration : --host et --port
USER et GROUP
@ -184,7 +196,8 @@ le processus n'est pas accès au fichiers système.
GROUP prend de USER si il n'est pas précisé.
Défaut: Aucun
Equivalent du fichier de configuration : --user et --group
Equivalent en ligne de commande : --user et --group
MENU
------
@ -212,4 +225,5 @@ MAX_SIZE
Valeur approximative de limite de taille d'un paste.
Défaut = 500000 octets (500 ko)
Equivalent en ligne de commande : Aucun

View File

@ -7,10 +7,10 @@ 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
:ref:`fichier de configuration <template-dirs-fr>`..
: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
dans zerobin/static dans un nouveau dossier, puis les modifier. Et signifiez
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

View File

@ -53,6 +53,10 @@
<div class="section" id="apache-setup">
<h1>Apache setup<a class="headerlink" href="#apache-setup" title="Permalink to this headline"></a></h1>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">You need to have followed the <a class="reference internal" href="easy_install.html"><em>easy install</em></a> first.</p>
</div>
<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>

View File

@ -58,18 +58,26 @@ For more robust and secure solutions, see <a class="reference internal" href="ap
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
zerobin &#8211;host 0.0.0.0 &#8211;port 80 &#8211;compressed-static # as admin</p>
<p>Just type:</p>
<div class="highlight-python"><pre>pip install zerobin
zerobin --host 0.0.0.0 --port 80 --compressed-static # as admin</pre>
</div>
</div>
<div class="section" id="seconds-setup-for-anybody">
<h2>30 seconds setup (for anybody)<a class="headerlink" href="#seconds-setup-for-anybody" title="Permalink to this headline"></a></h2>
<ul class="simple">
<li>Make sure you have Python 2.6 or 2.7 (<cite>python &#8211;version</cite>)</li>
<li>Download the last zip of the sources code.</li>
<li>Extract all of it where you wish the site to be stored.</li>
<li>Go to the extracted files.</li>
<li>Run <cite>python zerobin.py &#8211;host 0.0.0.0 &#8211;port 80 &#8211;compressed-static</cite>
with the admin rights.</li>
<ul>
<li><p class="first">Make sure you have Python 2.6 or 2.7 (<cite>python &#8211;version</cite>)</p>
</li>
<li><p class="first">Download the last zip of the sources code.</p>
</li>
<li><p class="first">Extract all of it where you wish the site to be stored.</p>
</li>
<li><p class="first">Go to the extracted files.</p>
</li>
<li><p class="first">Run with the admin rights:</p>
<div class="highlight-python"><pre>python zerobin.py --host 0.0.0.0 --port 80 --compressed-static</pre>
</div>
</li>
</ul>
<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>

View File

@ -53,6 +53,10 @@
<div class="section" id="nginx-setup">
<h1>Nginx setup<a class="headerlink" href="#nginx-setup" title="Permalink to this headline"></a></h1>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">You need to have followed the <a class="reference internal" href="easy_install.html"><em>easy install</em></a> first.</p>
</div>
<p>Nginx is a very popular choice to serve a Python project:</p>
<ul class="simple">
<li>It&#8217;s fast.</li>

View File

@ -64,16 +64,16 @@ zerobin/default_settings.py.</p>
<h3>&#8211;host and &#8211;port<a class="headerlink" href="#host-and-port" title="Permalink to this headline"></a></h3>
<p>The host and port on which to listen for incomming request. Usually 127.0.0.1
and 8000 to listen locally or 0.0.0.0 and 80 to listen from the outside.</p>
<p>Default: 127.0.0.1 and 8000
Setting file : HOST and PORT</p>
<p>Default: 127.0.0.1 and 8000</p>
<p>Setting file : HOST and PORT</p>
</div>
<div class="section" id="debug">
<h3>&#8211;debug<a class="headerlink" href="#debug" title="Permalink to this headline"></a></h3>
<p>Display a listing of useful debugging information when something goes wrong
instead of showing the 500 error page.</p>
<p>In debug mode, the server also reload automatically any modified Python file;</p>
<p>Default: False
Configuration file equivalent: DEBUG</p>
<p>Default: False</p>
<p>Configuration file equivalent: DEBUG</p>
</div>
<div class="section" id="user-and-group">
<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>
@ -81,27 +81,27 @@ Configuration file equivalent: DEBUG</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>
<p>&#8211;group is set to &#8211;user if not passed.</p>
<p>Default: None
Configuration file equivalent: USER and GROUP</p>
<p>Default: None</p>
<p>Configuration file equivalent: USER and GROUP</p>
</div>
<div class="section" id="settings-file">
<h3>&#8211;settings-file<a class="headerlink" href="#settings-file" title="Permalink to this headline"></a></h3>
<p>Path to the configuration file, if you use any.</p>
<p>Default: None
Configuration file equivalent: None</p>
<p>Default: None</p>
<p>Configuration file equivalent: None</p>
</div>
<div class="section" id="compressed-static">
<h3>&#8211;compressed-static<a class="headerlink" href="#compressed-static" title="Permalink to this headline"></a></h3>
<p>Serve minified static files (css and js). Use it in production to get a faster
web site.</p>
<p>Default: False
Configuration file equivalent: COMPRESSED_STATIC_FILES</p>
<p>Default: False</p>
<p>Configuration file equivalent: COMPRESSED_STATIC_FILES</p>
</div>
<div class="section" id="version-and-help">
<h3>&#8211;version and &#8211;help<a class="headerlink" href="#version-and-help" title="Permalink to this headline"></a></h3>
<p>Display the help or the version of 0bin.</p>
<p>Default: None
Configuration file equivalent: None</p>
<p>Default: None</p>
<p>Configuration file equivalent: None</p>
</div>
<div class="section" id="examples">
<h3>Examples<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h3>
@ -128,28 +128,28 @@ example to create your own file. It&#8217;s heavily commented.</p>
<p>Display a listing of useful debugging information when something goes wrong
instead of showing the 500 error page.</p>
<p>In debug mode, the server also reload automatically any modified Python file;</p>
<p>Default: False
Command line equivalent: &#8211;debug</p>
<p>Default: False</p>
<p>Command line equivalent: &#8211;debug</p>
</div>
<div class="section" id="static-files-root">
<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
Command line equivalent: None</p>
<p>Default: &#8220;static&#8221; directory in the &#8220;zerobin&#8221; directory</p>
<p>Command line equivalent: None</p>
</div>
<div class="section" id="compressed-static-files">
<h3>COMPRESSED_STATIC_FILES<a class="headerlink" href="#compressed-static-files" title="Permalink to this headline"></a></h3>
<p>Serve minified static files (css and js). Use it in production to get a faster
web site.</p>
<p>Default: False
Command line equivalent: &#8211;compressed-static</p>
<p>Default: False</p>
<p>Command line equivalent: &#8211;compressed-static</p>
</div>
<div class="section" id="paste-files-root">
<h3>PASTE_FILES_ROOT<a class="headerlink" href="#paste-files-root" title="Permalink to this headline"></a></h3>
<p>Absolute path to the directory in which 0bin is going to look save pastes.</p>
<p>Default: &#8220;static/content&#8221; direcotry in the &#8220;zerobin&#8221; directory
Command line equivalent: None</p>
<p>Default: &#8220;static/content&#8221; direcotry in the &#8220;zerobin&#8221; directory</p>
<p>Command line equivalent: None</p>
</div>
<div class="section" id="template-dirs">
<span id="template-dirs-en"></span><h3>TEMPLATE_DIRS<a class="headerlink" href="#template-dirs" title="Permalink to this headline"></a></h3>
@ -164,15 +164,15 @@ at the begining of the list:</p>
<span class="p">)</span> <span class="o">+</span> <span class="n">TEMPLATE_DIRS</span>
</pre></div>
</div>
<p>Default: &#8220;view&#8221; directory in the &#8220;zerobin&#8221; directory
Command line equivalent: None</p>
<p>Default: &#8220;view&#8221; directory in the &#8220;zerobin&#8221; directory</p>
<p>Command line equivalent: None</p>
</div>
<div class="section" id="id2">
<h3>HOST and PORT<a class="headerlink" href="#id2" title="Permalink to this headline"></a></h3>
<p>The host and port on which to listen for incomming request. Usually 127.0.0.1
and 8000 to listen locally or 0.0.0.0 and 80 to listen from the outside.</p>
<p>Default: 127.0.0.1 and 8000
Configuration file equivalent: &#8211;host and &#8211;port</p>
<p>Default: 127.0.0.1 and 8000</p>
<p>Configuration file equivalent: &#8211;host and &#8211;port</p>
</div>
<div class="section" id="id3">
<h3>USER and GROUP<a class="headerlink" href="#id3" title="Permalink to this headline"></a></h3>
@ -180,8 +180,8 @@ Configuration file equivalent: &#8211;host and &#8211;port</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>
<p>GROUP is set to USER if not passed.</p>
<p>Default: None
Configuration file equivalent: &#8211;user and &#8211;group</p>
<p>Default: None</p>
<p>Configuration file equivalent: &#8211;user and &#8211;group</p>
</div>
<div class="section" id="menu">
<h3>MENU<a class="headerlink" href="#menu" title="Permalink to this headline"></a></h3>
@ -202,8 +202,8 @@ Configuration file equivalent: &#8211;user and &#8211;group</p>
<h3>MAX_SIZE<a class="headerlink" href="#max-size" title="Permalink to this headline"></a></h3>
<p>Approximative value for a paste size limite.</p>
<p>Valeur approximative de limite de taille d&#8217;un paste.</p>
<p>Default = 500000 octets (500 ko)
Command line equivalent: None</p>
<p>Default = 500000 octets (500 ko)</p>
<p>Command line equivalent: None</p>
</div>
</div>
</div>

View File

@ -53,6 +53,10 @@
<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>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">Vous devez avoir suivi <a class="reference internal" href="easy_install.html"><em>l&#8217;installation facile</em></a> avant.</p>
</div>
<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">

View File

@ -58,18 +58,26 @@ 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
zerobin &#8211;host 0.0.0.0 &#8211;port 80 &#8211;compressed-static # en tant qu&#8217;admin</p>
<p>Entrez:</p>
<div class="highlight-python"><pre>pip install zerobin
zerobin --host 0.0.0.0 --port 80 --compressed-static # en tant qu'admin</pre>
</div>
</div>
<div class="section" id="installation-en-30-secondes-pour-tous">
<h2>Installation en 30 secondes (pour tous)<a class="headerlink" href="#installation-en-30-secondes-pour-tous" title="Permalink to this headline"></a></h2>
<ul class="simple">
<li>Assurez-vous d&#8217;avoir Python 2.6 ou 2.7 (<cite>python &#8211;version</cite>)</li>
<li>Télécharger le dernier zip du code source.</li>
<li>Décompressez tous les fichiers là où vous souhaitez mettre le site.</li>
<li>Allez dans les dossiers extraits.</li>
<li>Lancez <cite>python zerobin.py &#8211;host 0.0.0.0 &#8211;port 80 &#8211;compressed-static</cite>
avec les droits admin.</li>
<ul>
<li><p class="first">Assurez-vous d&#8217;avoir Python 2.6 ou 2.7 (<cite>python &#8211;version</cite>)</p>
</li>
<li><p class="first">Télécharger le dernier zip du code source.</p>
</li>
<li><p class="first">Décompressez tous les fichiers là où vous souhaitez mettre le site.</p>
</li>
<li><p class="first">Allez dans les dossiers extraits.</p>
</li>
<li><p class="first">Lancez avec les droits admin:</p>
<div class="highlight-python"><pre>python zerobin.py --host 0.0.0.0 --port 80 --compressed-static</pre>
</div>
</li>
</ul>
<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>

View File

@ -53,6 +53,10 @@
<div class="section" id="installation-avec-nginx">
<h1>Installation avec Nginx<a class="headerlink" href="#installation-avec-nginx" title="Permalink to this headline"></a></h1>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">Vous devez avoir suivi <a class="reference internal" href="easy_install.html"><em>l&#8217;installation facile</em></a> avant.</p>
</div>
<p>Nginx est un choix très populaire pour servir un projet Python:</p>
<ul class="simple">
<li>Il est rapide.</li>

View File

@ -61,8 +61,8 @@ défaut présente dans le fichier zerobin/default_settings.py.</p>
<p>L&#8217;hôte et le port sur lesquels écouter les requêtes entrantes. En général
127.0.0.1 et 8000 pour écouter localement, ou 0.0.0.0 et 80 pour
écouter les requêtes extérieures.</p>
<p>Défaut: 127.0.0.1 et 8000
Equivalent du fichier de configuration : HOST et PORT</p>
<p>Défaut: 127.0.0.1 et 8000</p>
<p>Equivalent du fichier de configuration : HOST et PORT</p>
</div>
<div class="section" id="debug">
<h3>&#8211;debug<a class="headerlink" href="#debug" title="Permalink to this headline"></a></h3>
@ -70,8 +70,8 @@ Equivalent du fichier de configuration : HOST et PORT</p>
se passe mal à la place d&#8217;une page d&#8217;erreur 500.</p>
<p>En mode debug, le serveur recharge aussi automatiquement tout fichier Python
modifié.</p>
<p>Défaut: False
Equivalent du fichier de configuration : DEBUG</p>
<p>Défaut: False</p>
<p>Equivalent du fichier de configuration : DEBUG</p>
</div>
<div class="section" id="user-et-group">
<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>
@ -80,27 +80,27 @@ Equivalent du fichier de configuration : DEBUG</p>
écouter sur le port 80, mais qu&#8217;on souhaite, pour des raisons de sécurité, que
le processus n&#8217;est pas accès aux fichiers protégés du système.</p>
<p>&#8211;group prend de &#8211;user si il n&#8217;est pas précisé.</p>
<p>Défaut: Aucun
Equivalent du fichier de configuration : USER et GROUP</p>
<p>Défaut: Aucun</p>
<p>Equivalent du fichier de configuration : USER et GROUP</p>
</div>
<div class="section" id="settings-file">
<h3>&#8211;settings-file<a class="headerlink" href="#settings-file" title="Permalink to this headline"></a></h3>
<p>Chemin vers le fichier de configuration, si vous souhaitez en utiliser un.</p>
<p>Défaut: Aucun
Equivalent du fichier de configuration : Aucun</p>
<p>Défaut: Aucun</p>
<p>Equivalent du fichier de configuration : Aucun</p>
</div>
<div class="section" id="compressed-static">
<h3>&#8211;compressed-static<a class="headerlink" href="#compressed-static" title="Permalink to this headline"></a></h3>
<p>Sert les versions minifiées fichiers statiques (css et js). A utiliser en
production pour un site plus rapide.</p>
<p>Défaut: False
Equivalent du fichier de configuration : COMPRESSED_STATIC_FILES</p>
<p>Défaut: False</p>
<p>Equivalent du fichier de configuration : COMPRESSED_STATIC_FILES</p>
</div>
<div class="section" id="version-et-help">
<h3>&#8211;version et &#8211;help<a class="headerlink" href="#version-et-help" title="Permalink to this headline"></a></h3>
<p>Affiche l&#8217;aide ou la version de 0bin</p>
<p>Défaut: Aucun
Equivalent du fichier de configuration : Aucun</p>
<p>Défaut: Aucun</p>
<p>Equivalent du fichier de configuration : Aucun</p>
</div>
<div class="section" id="exemples">
<h3>Exemples<a class="headerlink" href="#exemples" title="Permalink to this headline"></a></h3>
@ -128,28 +128,28 @@ d&#8217;exemple pour créer son propre fichier de configuration, il est largemen
se passe mal à la place d&#8217;une page d&#8217;erreur 500.</p>
<p>En mode debug, le serveur recharge aussi automatiquement tout fichier Python
modifié.</p>
<p>Défaut: False
Equivalent en ligne de commande : &#8211;debug</p>
<p>Défaut: False</p>
<p>Equivalent en ligne de commande : &#8211;debug</p>
</div>
<div class="section" id="static-files-root">
<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;
Equivalent en ligne de commande : Aucun</p>
<p>Défaut: dossier &#8220;static&#8221; dans le dossier &#8220;zerobin&#8221;</p>
<p>Equivalent en ligne de commande : Aucun</p>
</div>
<div class="section" id="compressed-static-files">
<h3>COMPRESSED_STATIC_FILES<a class="headerlink" href="#compressed-static-files" title="Permalink to this headline"></a></h3>
<p>Sert les versions minifiées fichiers statiques (css et js). A utiliser en
production pour un site plus rapide.</p>
<p>Défaut: False
Equivalent en ligne de commande : &#8211;compressed-static</p>
<p>Défaut: False</p>
<p>Equivalent en ligne de commande : &#8211;compressed-static</p>
</div>
<div class="section" id="paste-files-root">
<h3>PASTE_FILES_ROOT<a class="headerlink" href="#paste-files-root" title="Permalink to this headline"></a></h3>
<p>Chemin absolu du dossier dans lequel 0bin va sauvegarder les pastes.</p>
<p>Défaut: dossier &#8220;static/content&#8221; dans le dossier &#8220;zerobin&#8221;
Equivalent en ligne de commande : Aucun</p>
<p>Défaut: dossier &#8220;static/content&#8221; dans le dossier &#8220;zerobin&#8221;</p>
<p>Equivalent en ligne de commande : Aucun</p>
</div>
<div class="section" id="template-dirs">
<span id="template-dirs-fr"></span><h3>TEMPLATE_DIRS<a class="headerlink" href="#template-dirs" title="Permalink to this headline"></a></h3>
@ -165,16 +165,16 @@ contient au début de la liste:</p>
<span class="p">)</span> <span class="o">+</span> <span class="n">TEMPLATE_DIRS</span>
</pre></div>
</div>
<p>Défaut: dossier &#8220;view&#8221; dans le dossier &#8220;zerobin&#8221;
Equivalent en ligne de commande : Aucun</p>
<p>Défaut: dossier &#8220;view&#8221; dans le dossier &#8220;zerobin&#8221;</p>
<p>Equivalent en ligne de commande : Aucun</p>
</div>
<div class="section" id="id2">
<h3>HOST et PORT<a class="headerlink" href="#id2" title="Permalink to this headline"></a></h3>
<p>L&#8217;hôte et le port sur lesquels écouter les requêtes entrantes. En général
127.0.0.1 et 8000 pour écouter localement, ou 0.0.0.0 et 80 pour
écouter les requêtes extérieures.</p>
<p>Défaut: 127.0.0.1 et 8000
Equivalent du fichier de configuration : &#8211;host et &#8211;port</p>
<p>Défaut: 127.0.0.1 et 8000</p>
<p>Equivalent du fichier de configuration : &#8211;host et &#8211;port</p>
</div>
<div class="section" id="id3">
<h3>USER et GROUP<a class="headerlink" href="#id3" title="Permalink to this headline"></a></h3>
@ -183,8 +183,8 @@ Equivalent du fichier de configuration : &#8211;host et &#8211;port</p>
écouter sur le port 80, mais qu&#8217;on souhaite, pour des raisons de sécurité, que
le processus n&#8217;est pas accès au fichiers système.</p>
<p>GROUP prend de USER si il n&#8217;est pas précisé.</p>
<p>Défaut: Aucun
Equivalent du fichier de configuration : &#8211;user et &#8211;group</p>
<p>Défaut: Aucun</p>
<p>Equivalent en ligne de commande : &#8211;user et &#8211;group</p>
</div>
<div class="section" id="menu">
<h3>MENU<a class="headerlink" href="#menu" title="Permalink to this headline"></a></h3>
@ -205,8 +205,8 @@ est en haut de chaque page.</p>
<div class="section" id="max-size">
<h3>MAX_SIZE<a class="headerlink" href="#max-size" title="Permalink to this headline"></a></h3>
<p>Valeur approximative de limite de taille d&#8217;un paste.</p>
<p>Défaut = 500000 octets (500 ko)
Equivalent en ligne de commande : Aucun</p>
<p>Défaut = 500000 octets (500 ko)</p>
<p>Equivalent en ligne de commande : Aucun</p>
</div>
</div>
</div>

View File

@ -57,10 +57,10 @@
<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
<a class="reference internal" href="options.html#template-dirs-fr"><em>fichier de configuration</em></a>..</p>
<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 <em class="xref std std-ref">fichier de configuration</em>.</p>
dans zerobin/static dans un nouveau dossier, puis les modifier. Et signifiez
que vous utilisez ce dossier dans le <a class="reference internal" href="options.html#static-root-fr"><em>fichier de configuration</em></a>.</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

File diff suppressed because one or more lines are too long

View File

@ -2,6 +2,9 @@
Apache setup
=============
.. Note::
You need to have followed the :doc:`easy install <./easy_install>` first.
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;

View File

@ -9,6 +9,8 @@ and :doc:`Nginx <./nginx_install>` setups.
10 seconds setup (if you know Python already)
===============================================
Just type::
pip install zerobin
zerobin --host 0.0.0.0 --port 80 --compressed-static # as admin
@ -19,8 +21,9 @@ zerobin --host 0.0.0.0 --port 80 --compressed-static # as admin
- Download the last zip of the sources code.
- Extract all of it where you wish the site to be stored.
- Go to the extracted files.
- Run `python zerobin.py --host 0.0.0.0 --port 80 --compressed-static`
with the admin rights.
- Run with the admin rights::
python zerobin.py --host 0.0.0.0 --port 80 --compressed-static
On ubuntu, this is a one liner::

View File

@ -2,6 +2,9 @@
Nginx setup
============
.. Note::
You need to have followed the :doc:`easy install <./easy_install>` first.
Nginx is a very popular choice to serve a Python project:
- It's fast.

View File

@ -20,6 +20,7 @@ The host and port on which to listen for incomming request. Usually 127.0.0.1
and 8000 to listen locally or 0.0.0.0 and 80 to listen from the outside.
Default: 127.0.0.1 and 8000
Setting file : HOST and PORT
@ -32,6 +33,7 @@ instead of showing the 500 error page.
In debug mode, the server also reload automatically any modified Python file;
Default: False
Configuration file equivalent: DEBUG
.. _user-and-group-en:
@ -47,6 +49,7 @@ port 80, but you wish that the process do not have access to protected files.
--group is set to --user if not passed.
Default: None
Configuration file equivalent: USER and GROUP
--settings-file
@ -55,6 +58,7 @@ Configuration file equivalent: USER and GROUP
Path to the configuration file, if you use any.
Default: None
Configuration file equivalent: None
@ -65,6 +69,7 @@ Serve minified static files (css and js). Use it in production to get a faster
web site.
Default: False
Configuration file equivalent: COMPRESSED_STATIC_FILES
--version and --help
@ -73,6 +78,7 @@ Configuration file equivalent: COMPRESSED_STATIC_FILES
Display the help or the version of 0bin.
Default: None
Configuration file equivalent: None
Examples
@ -86,6 +92,7 @@ Developpement::
zerobin --debug --serve-static
Configuration file
====================
@ -109,6 +116,7 @@ In debug mode, the server also reload automatically any modified Python file;
Default: False
Command line equivalent: --debug
.. _static-root-en:
@ -120,6 +128,7 @@ Asbolute path to the directory where 0bin is going to look for static files
(css, js and images).
Default: "static" directory in the "zerobin" directory
Command line equivalent: None
COMPRESSED_STATIC_FILES
@ -129,6 +138,7 @@ Serve minified static files (css and js). Use it in production to get a faster
web site.
Default: False
Command line equivalent: --compressed-static
PASTE_FILES_ROOT
@ -137,6 +147,7 @@ PASTE_FILES_ROOT
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:
@ -157,6 +168,7 @@ at the begining of the list::
) + TEMPLATE_DIRS
Default: "view" directory in the "zerobin" directory
Command line equivalent: None
HOST and PORT
@ -167,6 +179,7 @@ The host and port on which to listen for incomming request. Usually 127.0.0.1
and 8000 to listen locally or 0.0.0.0 and 80 to listen from the outside.
Default: 127.0.0.1 and 8000
Configuration file equivalent: --host and --port
USER and GROUP
@ -180,6 +193,7 @@ port 80, but you wish that the process do not have access to protected files.
GROUP is set to USER if not passed.
Default: None
Configuration file equivalent: --user and --group
MENU
@ -199,6 +213,7 @@ Default::
('Contact', 'mailto:your@email.com') # email
)
Command line equivalent: None
MAX_SIZE
@ -209,4 +224,5 @@ Approximative value for a paste size limite.
Valeur approximative de limite de taille d'un paste.
Default = 500000 octets (500 ko)
Command line equivalent: None

View File

@ -2,6 +2,9 @@
Installation avec Apache
=========================
.. Note::
Vous devez avoir suivi :doc:`l'installation facile <./easy_install>` avant.
Apache est plus lourd que :doc:`Nginx <./nginx_install>` mais il
est aussi beaucoup plus connu:

View File

@ -9,6 +9,8 @@ Pour des solutions plus solides et sécurisées, essayez les installation
Installation en 10 secondes (si vous connaissez Python)
========================================================
Entrez::
pip install zerobin
zerobin --host 0.0.0.0 --port 80 --compressed-static # en tant qu'admin
@ -20,8 +22,9 @@ Installation en 30 secondes (pour tous)
- Télécharger le dernier zip du code source.
- Décompressez tous les fichiers là où vous souhaitez mettre le site.
- Allez dans les dossiers extraits.
- Lancez `python zerobin.py --host 0.0.0.0 --port 80 --compressed-static`
avec les droits admin.
- Lancez avec les droits admin::
python zerobin.py --host 0.0.0.0 --port 80 --compressed-static
Sous ubuntu, une line suffit::

View File

@ -2,6 +2,9 @@
Installation avec Nginx
========================
.. Note::
Vous devez avoir suivi :doc:`l'installation facile <./easy_install>` avant.
Nginx est un choix très populaire pour servir un projet Python:
- Il est rapide.

View File

@ -20,6 +20,7 @@ L'hôte et le port sur lesquels écouter les requêtes entrantes. En général
écouter les requêtes extérieures.
Défaut: 127.0.0.1 et 8000
Equivalent du fichier de configuration : HOST et PORT
@ -33,6 +34,7 @@ En mode debug, le serveur recharge aussi automatiquement tout fichier Python
modifié.
Défaut: False
Equivalent du fichier de configuration : DEBUG
.. _user-and-group-fr:
@ -49,6 +51,7 @@ le processus n'est pas accès aux fichiers protégés du système.
--group prend de --user si il n'est pas précisé.
Défaut: Aucun
Equivalent du fichier de configuration : USER et GROUP
--settings-file
@ -57,6 +60,7 @@ Equivalent du fichier de configuration : USER et GROUP
Chemin vers le fichier de configuration, si vous souhaitez en utiliser un.
Défaut: Aucun
Equivalent du fichier de configuration : Aucun
@ -67,6 +71,7 @@ Sert les versions minifiées fichiers statiques (css et js). A utiliser en
production pour un site plus rapide.
Défaut: False
Equivalent du fichier de configuration : COMPRESSED_STATIC_FILES
--version et --help
@ -75,6 +80,7 @@ Equivalent du fichier de configuration : COMPRESSED_STATIC_FILES
Affiche l'aide ou la version de 0bin
Défaut: Aucun
Equivalent du fichier de configuration : Aucun
Exemples
@ -110,6 +116,7 @@ En mode debug, le serveur recharge aussi automatiquement tout fichier Python
modifié.
Défaut: False
Equivalent en ligne de commande : --debug
.. _static-root-fr:
@ -121,6 +128,7 @@ Chemin absolu du dossier dans lequel 0bin va chercher les fichiers statiques
(css, js et images).
Défaut: dossier "static" dans le dossier "zerobin"
Equivalent en ligne de commande : Aucun
COMPRESSED_STATIC_FILES
@ -130,6 +138,7 @@ Sert les versions minifiées fichiers statiques (css et js). A utiliser en
production pour un site plus rapide.
Défaut: False
Equivalent en ligne de commande : --compressed-static
PASTE_FILES_ROOT
@ -138,6 +147,7 @@ PASTE_FILES_ROOT
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:
@ -159,6 +169,7 @@ contient au début de la liste::
) + TEMPLATE_DIRS
Défaut: dossier "view" dans le dossier "zerobin"
Equivalent en ligne de commande : Aucun
@ -170,6 +181,7 @@ L'hôte et le port sur lesquels écouter les requêtes entrantes. En général
écouter les requêtes extérieures.
Défaut: 127.0.0.1 et 8000
Equivalent du fichier de configuration : --host et --port
USER et GROUP
@ -184,7 +196,8 @@ le processus n'est pas accès au fichiers système.
GROUP prend de USER si il n'est pas précisé.
Défaut: Aucun
Equivalent du fichier de configuration : --user et --group
Equivalent en ligne de commande : --user et --group
MENU
------
@ -212,4 +225,5 @@ MAX_SIZE
Valeur approximative de limite de taille d'un paste.
Défaut = 500000 octets (500 ko)
Equivalent en ligne de commande : Aucun

View File

@ -7,10 +7,10 @@ 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
:ref:`fichier de configuration <template-dirs-fr>`..
: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
dans zerobin/static dans un nouveau dossier, puis les modifier. Et signifiez
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