diff --git a/docs/usage.rst b/docs/usage.rst index ad205757280d83d2fc975bb6491b7a1bd8890312..29e5b386b8673473d2c47b13a2ade466fc0369df 100644 --- a/docs/usage.rst +++ b/docs/usage.rst @@ -130,6 +130,29 @@ you would run:: pip install pip install requirements/development.txt +Serving of static and media files +--------------------------------- + +Out of the box, project templates will configure ``/static/`` as base URL for +static files, and ``/media/`` as base URL for media. + +Root directories for locating static and media files are set-up to point to +parent directory of project (so, one level up from ``manage.py``), in +directories ``assets/static/`` and ``assets/media/``. + +As an example, in case you create project in ``~/tmp/``, you would have +structure similar to: + +- ``~/tmp/myproject/`` +- ``~/tmp/myproject/manage.py`` +- Many other files and directories under ``~/tmp/myproject/`` +- ``~/tmp/assets/static/`` +- ``~/tmp/assets/media/`` + +This way you can keep the assets (static and media files) outside of the project +code tree. + + Working with the project ------------------------