mirror of
https://github.com/Tygs/0bin.git
synced 2023-08-10 21:13:00 +03:00
228 lines
4.8 KiB
ReStructuredText
228 lines
4.8 KiB
ReStructuredText
============
|
|
Options
|
|
============
|
|
|
|
0bin's behavior can be adjusted with options passed using a configuration
|
|
file or directly using the command line. Some parameters are only available
|
|
in the configuration file.
|
|
|
|
If an option is not passed, 0bin will use the default value from the file
|
|
zerobin/default_settings.py.
|
|
|
|
|
|
Command line
|
|
==================
|
|
|
|
--host and --port
|
|
-------------------
|
|
|
|
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
|
|
|
|
|
|
--debug
|
|
----------
|
|
|
|
Display a listing of useful debugging information when something goes wrong
|
|
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:
|
|
|
|
--user and --group
|
|
-------------------
|
|
|
|
The user and group the server will adopt after start up.
|
|
|
|
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.
|
|
|
|
--group is set to --user if not passed.
|
|
|
|
Default: None
|
|
|
|
Configuration file equivalent: USER and GROUP
|
|
|
|
--settings-file
|
|
-----------------
|
|
|
|
Path to the configuration file, if you use any.
|
|
|
|
Default: None
|
|
|
|
Configuration file equivalent: None
|
|
|
|
|
|
--compressed-static
|
|
--------------------
|
|
|
|
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
|
|
--------------------
|
|
|
|
Display the help or the version of 0bin.
|
|
|
|
Default: None
|
|
|
|
Configuration file equivalent: None
|
|
|
|
Examples
|
|
----------
|
|
|
|
Production::
|
|
|
|
sudo zerobin --host 0.0.0.0 --port 80 --user foo --compressed-static
|
|
|
|
Developpement::
|
|
|
|
zerobin --debug --serve-static
|
|
|
|
|
|
Configuration file
|
|
====================
|
|
|
|
The configuration file should be an ordinary Python file, usually named
|
|
settings.py. It's used this way::
|
|
|
|
zerobin --settings-file '/path/to/settings.py'
|
|
|
|
Any options passed to the command line will have priority on the ones in
|
|
the configuration file. The zerobin/default_settings.py can be used as an
|
|
example to create your own file. It's heavily commented.
|
|
|
|
|
|
DEBUG
|
|
-----
|
|
|
|
Display a listing of useful debugging information when something goes wrong
|
|
instead of showing the 500 error page.
|
|
|
|
In debug mode, the server also reload automatically any modified Python file;
|
|
|
|
|
|
Default: False
|
|
|
|
Command line equivalent: --debug
|
|
|
|
.. _static-root-en:
|
|
|
|
STATIC_FILES_ROOT
|
|
------------------
|
|
|
|
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
|
|
-------------------------
|
|
|
|
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
|
|
-----------------
|
|
|
|
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
|
|
--------------
|
|
|
|
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.
|
|
|
|
If you wish to use your own templates, add the directory containing them
|
|
at the begining of the list::
|
|
|
|
from zerobin.defauls_settings import TEMPLATE_DIRS
|
|
|
|
TEMPLATE_DIRS = (
|
|
'/directy/path/to/your/templates',
|
|
) + TEMPLATE_DIRS
|
|
|
|
Default: "view" directory in the "zerobin" directory
|
|
|
|
Command line equivalent: None
|
|
|
|
HOST and PORT
|
|
-------------------
|
|
|
|
|
|
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
|
|
-------------------
|
|
|
|
The user and group the server will adopt after start up.
|
|
|
|
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.
|
|
|
|
GROUP is set to USER if not passed.
|
|
|
|
Default: None
|
|
|
|
Configuration file equivalent: --user and --group
|
|
|
|
MENU
|
|
------
|
|
|
|
A list of 'name' + 'link' pairs used to buld the menu at the top of each page.
|
|
|
|
You can use a relative or absolute link, and even an email address.
|
|
|
|
Any email address will be automatically protected against spam.
|
|
|
|
Default::
|
|
|
|
MENU = (
|
|
('Home', '/'),
|
|
('Download 0bin', 'https://github.com/sametmax/0bin'),
|
|
('Contact', 'mailto:your@email.com') # email
|
|
)
|
|
|
|
|
|
Command line equivalent: None
|
|
|
|
MAX_SIZE
|
|
---------
|
|
|
|
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 |