mirror of
https://github.com/Tygs/0bin.git
synced 2023-08-10 21:13:00 +03:00
229 lines
5.5 KiB
ReStructuredText
229 lines
5.5 KiB
ReStructuredText
============
|
|
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
|
|
|
|
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
|
|
|
|
Equivalent du fichier de configuration : DEBUG
|
|
|
|
.. _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
|
|
|
|
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
|
|
|
|
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
|
|
|
|
Equivalent du fichier de configuration : COMPRESSED_STATIC_FILES
|
|
|
|
--version et --help
|
|
--------------------
|
|
|
|
Affiche l'aide ou la version de 0bin
|
|
|
|
Défaut: Aucun
|
|
|
|
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
|
|
|
|
Equivalent en ligne de commande : --debug
|
|
|
|
.. _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"
|
|
|
|
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
|
|
|
|
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"
|
|
|
|
Equivalent en ligne de commande : Aucun
|
|
|
|
.. _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"
|
|
|
|
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
|
|
|
|
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
|
|
|
|
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)
|
|
|
|
Equivalent en ligne de commande : Aucun |