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

229 lines
5.5 KiB
ReStructuredText
Raw Normal View History

============
Options
============
Le comportement de 0bin peut être ajusté à l'aide d'options passées depuis un
fichier de configuration ou directement à la ligne de commande. Certains
paramètres sont uniquement disponibles dans le fichier de configuration.
Si une option n'est pas passée, 0bin utilise la valeur par
défaut présente dans le fichier zerobin/default_settings.py.
Ligne de commande
==================
--host et --port
-------------------
L'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.
Défaut: 127.0.0.1 et 8000
2012-05-19 00:58:14 +04:00
Equivalent du fichier de configuration : HOST et PORT
--debug
----------
Afffiche un listing d'informations utiles pour déboguer quand quelque chose
se passe mal à la place d'une page d'erreur 500.
En mode debug, le serveur recharge aussi automatiquement tout fichier Python
modifié.
Défaut: False
2012-05-19 00:58:14 +04:00
Equivalent du fichier de configuration : DEBUG
2012-05-19 00:47:17 +04:00
.. _user-and-group-fr:
--user et --group
-------------------
L'utilisateur et le group que le serveur essayera d'adopter après le démarrage.
Utile quand on lance la commande avec les droits admin afin de pouvoir
écouter sur le port 80, mais qu'on souhaite, pour des raisons de sécurité, que
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
2012-05-19 00:58:14 +04:00
Equivalent du fichier de configuration : USER et GROUP
--settings-file
-----------------
Chemin vers le fichier de configuration, si vous souhaitez en utiliser un.
Défaut: Aucun
2012-05-19 00:58:14 +04:00
Equivalent du fichier de configuration : Aucun
--compressed-static
--------------------
Sert les versions minifiées fichiers statiques (css et js). A utiliser en
production pour un site plus rapide.
Défaut: False
2012-05-19 00:58:14 +04:00
Equivalent du fichier de configuration : COMPRESSED_STATIC_FILES
--version et --help
--------------------
Affiche l'aide ou la version de 0bin
Défaut: Aucun
2012-05-19 00:58:14 +04:00
Equivalent du fichier de configuration : Aucun
Exemples
----------
Production::
sudo zerobin --host 0.0.0.0 --port 80 --user foo --compressed-static
Développement::
zerobin --debug --serve-static
Fichier de configuration
========================
Le fichier configuration doit être un fichier Python ordinnaire, généralement
appelé settings.py. On l'utilise ainsi::
zerobin --settings-file '/chemin/vers/settings.py'
Toutes les autres options passées à la commandes auront priorité sur les options
du fichier de configuration. Le fichier zerobin/default_settings.py peut servir
d'exemple pour créer son propre fichier de configuration, il est largement commenté.
DEBUG
-----
Afffiche un listing d'informations utiles pour déboguer quand quelque chose
se passe mal à la place d'une page d'erreur 500.
En mode debug, le serveur recharge aussi automatiquement tout fichier Python
modifié.
Défaut: False
2012-05-19 00:58:14 +04:00
Equivalent en ligne de commande : --debug
2012-05-19 00:47:17 +04:00
.. _static-root-fr:
STATIC_FILES_ROOT
------------------
Chemin absolu du dossier dans lequel 0bin va chercher les fichiers statiques
(css, js et images).
Défaut: dossier "static" dans le dossier "zerobin"
2012-05-19 00:58:14 +04:00
Equivalent en ligne de commande : Aucun
COMPRESSED_STATIC_FILES
-------------------------
Sert les versions minifiées fichiers statiques (css et js). A utiliser en
production pour un site plus rapide.
Défaut: False
2012-05-19 00:58:14 +04:00
Equivalent en ligne de commande : --compressed-static
PASTE_FILES_ROOT
-----------------
Chemin absolu du dossier dans lequel 0bin va sauvegarder les pastes.
Défaut: dossier "static/content" dans le dossier "zerobin"
2012-05-19 00:58:14 +04:00
Equivalent en ligne de commande : Aucun
2012-05-19 00:47:17 +04:00
.. _template-dirs-fr:
TEMPLATE_DIRS
--------------
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.
Si vous voulez utiliser vos propres templates, ajoutez le dossier qui les
contient au début de la liste::
from zerobin.defauls_settings import TEMPLATE_DIRS
TEMPLATE_DIRS = (
'/chemin/version/votre/dossier/de/templates',
) + TEMPLATE_DIRS
Défaut: dossier "view" dans le dossier "zerobin"
2012-05-19 00:58:14 +04:00
Equivalent en ligne de commande : Aucun
HOST et PORT
-------------------
L'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.
Défaut: 127.0.0.1 et 8000
2012-05-19 00:58:14 +04:00
Equivalent du fichier de configuration : --host et --port
USER et GROUP
-------------------
L'utilisateur et le group que le serveur essayera d'adopter après le démarrage.
Utile quand on lance la commande avec les droits admin afin de pouvoir
écouter sur le port 80, mais qu'on souhaite, pour des raisons de sécurité, que
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
2012-05-19 00:58:14 +04:00
Equivalent en ligne de commande : --user et --group
MENU
------
Une liste de paires 'Nom' + 'Liens' à utiliser pour construire le menu qui
est en haut de chaque page.
Le lien peut être un lien relatif, absolu, ou une adresse email.
Toute addresse email sera automatiquement protégée contre le spam.
Défaut::
MENU = (
('Home', '/'),
('Download 0bin', 'https://github.com/sametmax/0bin'),
('Contact', 'mailto:your@email.com') # email
)
Equivalent en ligne de commande : Aucun
MAX_SIZE
---------
Valeur approximative de limite de taille d'un paste.
Défaut = 500000 octets (500 ko)
2012-05-19 00:58:14 +04:00
Equivalent en ligne de commande : Aucun