François Poulain 85ee829ea8 | ||
---|---|---|
requirements | ||
test-wagtail | ||
.gitignore | ||
CHANGELOG.md | ||
CONTRIBUTORS.txt | ||
LICENSE | ||
Makefile | ||
README.md | ||
config.env.example | ||
manage.py | ||
requirements.txt | ||
setup.cfg |
README.md
test-wagtail
Une courte description du projet.
Installation
Requirements
On a Debian-based host - running at least Debian Stretch, you will need the following packages:
- python3
- virtualenv
- python3-psycopg2 (optional, in case of a PostgreSQL database)
Note: if you're serving the application with uWSGI and NGINX on a sub location, ensure
that you've added route-run = fixpathinfo:
to your uWSGI configuration (from
v2.0.11).
Step by step
In waiting for a complete Makefile
, you will have to follow those steps to
install the application.
It assumes that you have downloaded the last release of test-wagtail, extracted it and that you moved to that folder.
-
Start by creating a new virtual environment under
./venv
and activate it:$ virtualenv --system-site-packages ./venv $ source ./venv/bin/activate
-
Install the required Python packages depending on your environment:
$ pip install -r requirements/production.txt ... or ... $ pip install -r requirements/development.txt
-
Configure the application by setting the proper environment variables depending on your environment. You can use the
config.env.example
which give you the main variables with example values.$ cp config.env.example config.env $ nano config.env
Note that this
./config.env
file will be loaded by default when the application starts. If you don't want that, just move this file away or set theDJANGO_READ_CONFIG_FILE
environment variable tofalse
. -
Create the database tables - it assumes that you have created the database and set the proper configuration to use it:
$ ./manage.py migrate
That's it! You should now be able to start the Django development server to check that everything is working fine with:
$ ./manage.py runserver
Structure
Overview
All the application files - e.g. Django code including settings, templates and
statics - are located into the test-wagtail/
. It should
permit in a near future to distribute the application as a Python package and
install it system-wide.
Two environments are defined - either for requirements and settings:
development
: for local application development and testing. It uses a SQLite3 database and enable debugging by default, add some useful settings and applications for development purpose - i.e. thedjango-debug-toolbar
.production
: for production. It checks that configuration is set and correct, try to optimize performances and enforce some settings - i.e. HTTPS related ones.
Local changes
You can override and extend statics and templates locally. This can be useful
if you have to change the logo for a specific instance for example. For that,
just put your files under the local/static/
and local/templates/
folders.
Regarding the statics, do not forget to collect them after that. Note also that
the local/
folder is ignored by git.
Variable content
All the variable content - e.g. user-uploaded media, collected statics - are
stored inside the var/
folder. It is also ignored by git as it's specific
to each application installation.
So, you will have to configure your Web server to serve the var/media/
and
var/static/
folders, which should point to /media/
and /static/
,
respectively.
License
test-wagtail is developed by Cliss XXI and licensed under the AGPLv3+.