The goal of Wagtail SEO is to become the most complete, go-to package for doing SEO on Wagtail. This means it will not only provide the features, but will continually stay up to date with evolving SEO practices and data standards (and Google’s whims).
That being said we heartily welcome contributions!
Bugs, feature requests, and ideas should be opened first as a GitHub issue. Pull requests will be accepted provided they meet the project’s quality standards, and can be demonstrated to align with a published SEO or data standard.
To set up your development environment:
Create a new environment (in a
python -m venv .venv # Mac and Linux source ./.venv/bin/activate # Windows (PowerShell) ./.venv/Scripts/Activate.ps1
Enter the source code directory and install the package locally with additional development tools:
pip install -r requirements-dev.txt
Write some code.
Next, run the static analysis tools:
black . codespell . flake8 . mypy ./wagtailseo/
Next, run the units tests. A simple Wagtail project using Wagtail SEO is in the
testproject/directory. The tests will also generate a code coverage report at
htmlcov/index.html, which you can open in your browser:
To build the documentation, run the following, which will output to the
sphinx-build -M html ./docs/ ./docs/_build/ -W
To create a python package, run the following, which will output the package to
python setup.py sdist bdist_wheel