allcaps / guide

Guide

Guide is a website to help content editors, moderators, administrators, and other users learn how to user the Wagtail content management system (CMS).

The Wagtail guide will ultimately include:

• Tutorials
• How-to articles
• Reference materials
• Walkthroughs and visual learning materials

You can learn more about the documentation system here.

Table of Contents

• Installation
• Gitpod
• Contributing
• Other Notes

Installation

We assume that you have basic knowledge of Node/Yarn/Webpack and Python/Django/Wagtail in these instructions. We recommend you develop Wagtail Guide locally on your machine using venv.

Dependencies

• Python 3.9
• Git
• Node 16.*
• Yarn

Setting up Wagtail guide in a virtual environment

Run:

python -V

Confirm that the output is showing version Python 3.9. If not, you may have multiple versions of Python installed on your system and will need to switch to the appropriate version when creating the virtual environment.

With the Python 3.9 output confirmed, run:

python -m venv env
source env/bin/activate

Now we're ready to set up the guide project:

cd ~/dev [or your preferred dev directory]
git clone https://github.com/wagtail/guide.git
cd guide
make backend
make frontend
make buildfixtures

Once the backend and frontend have been set up, you can run the development server with:

make run

If everything worked, http://127.0.0.1:8000 should show you a welcome page.

You can access the administrative area at http://127.0.0.1:8000/admin and log in using the credentials you created during the backend setup.

Gitpod

With Gitpod you can deploy a ready-to-code Wagtail Guide development environment with a single click to evaluate the code.

Steps:

1. Click the Open in Gitpod button.
2. Relax: a development environment with an active Wagtail Guide site will be created for you.
3. Login at /admin/ with username admin and password changeme

Contributing

If you're a Python or Django developer, fork the repo and join us. You'll find answers to many common new contributor questions in our contributing guidelines.

Other Notes

Google Summer of Code

This project is one of three Wagtail projects being sponsored by Google as a part of Google Summer of Code 2022. The team for this project includes:

Contributor

• Hitansh Shah

Mentors

• Phil Dexter
• Coen van der Kamp
• Meagen Voss

You can learn more about our Google Summer of Code projects in this blog or on our wiki page.