texsite

texsite delivers great and ready-to-use page templates for the modern, flexible and user-focused web content management system Wagtail CMS backed by the popular Django web framework, both written in Python.

Based on the amazing StreamField introduced with Wagtail release 1.0, which texsite uses extensively, it has never been easier for editors to author awesome pages. Read more on how this concept works in the great blog article Rich text fields and faster horses written by Matt Westcott, lead technical developer of Wagtail.

Features

• Clean Blog Pages - based on the Clean Blog theme by Start Bootstrap
• Business Casual Pages - based on the Business Casual theme by Start Bootstrap
• Outstanding test coverage
• Continuously integrated codebase

Technical requirements

Below is the list of currently supported combinations of Wagtail, Django and Python:

Code and contribution

The code is open source and released under the ISC License (ISCL). It is available on Gitlab and follows the guidelines about Semantic Versioning for transparency within the release cycle and backward compatibility whenever possible.

All contributions are welcome, whether bug reports, code contributions and reviews, documentation or feature requests.

If you're a developer, fork the repo and prepare a merge request:

# Prepare your environment the first time
python3.8 venv ~/virtualenvs/texsite-py38
pip install -e .[development]

# Running the tests while development
python manage.py test --settings=tests.settings

# Individual supported versions tests and code quality checks
tox -e py38-dj22-wt27
tox -e isort
tox -e brunette
tox -e flake8
tox -e coverage

# Ensure code quality running the entire test suite,
# this requires all supported Python releases to be installed
tox

Configuration

Environment

The tool only requires one environment variable to work properly:

• TEXSITE_DATA_ROOT

This path is used to store:

• Uploaded user content such as images and documents
• Collected static files for the web application frontend
• Environment specific application configuration

For example set this environment variable in a bash to a valid directory path:

export TEXSITE_DATA_ROOT="$HOME/data/texsite"

Django settings

On startup the application loads a module localsettings where you may provide environment specific Django settings, e.g. a database service.

It searches with the sys.path and first adds the path configured in the environment variable TEXSITE_DATA_ROOT.