This is the source code to Wagtail's website
You firstly need to install git, Vagrant and Virtualbox. Once they are installed, run the following commands to get up and running:
git clone https://github.com/wagtail/wagtail.io.git
cd wagtail.io
vagrant up
This will download the base image and provision a local VM that will run the site locally.
You will need to apply migrations, create a super user, and create a cache table once the vagrant environment is setup.
vagrant ssh
./manage.py migrate
./manage.py createsuperuser
./manage.py createcachetable
Common Vagrant commands:
vagrant up
starts the VMvagrant halt
stops the VMvagrant ssh
opens a shell in the VMvagrant destroy
deletes the VM
Shortcut commands:
Within the VM shell, you can run ./manage.py
to run any Django management command. But we have added a couple of shortcuts to save on typing:
dj <command> [args]
- Runs a management command (eg,dj shell
)djrun
- Starts the webserver on port 8000
The site is hosted on heroku, and is deployed by pushing to the heroku remote.
Creating and pushing to the heroku branch is handled automatically by fabric command.
To staging
fab deploy_staging
To production
fab deploy_production
Wagtail documentation is hosted at readthedocs. A Cloudflare worker is in place to rewrite canonical URLs on old versions of the documentation - see conf/wagtaildocs-cloudflare-worker.js
.