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

Added interlink in the docs

This commit is contained in:
sam
2012-05-18 22:47:17 +02:00
parent a3dcbe9c2b
commit 611570b1d3
47 changed files with 138 additions and 97 deletions

View File

@@ -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.

View File

@@ -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::

View File

@@ -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.

View File

@@ -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
--------------

View File

@@ -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/