mirror of
https://github.com/wagtail/wagtail.git
synced 2024-12-01 11:41:20 +01:00
aab0393c3f
- Always clarify that the instructions assume a virtual environment - Add to the tutorial instructions for using venv - Clarify that Python 3 is required - Clarify that the tutorial is an alternative to "Getting started" that assumes less background knowledge - Remove pip installation instructions because Django only supports versions of Python that include it - Make headings in the tutorial instead of an ordered list This makes the page easier to scan visually and allows linking to specific headings. - Add the warning about Pillow dependencies to the tutorial - In "Getting started" move Pillow's dependencies to the general dependencies list - Make language more welcoming (saying "we just do x" alienates people who have less familiarity with x") - Other small text changes |
||
|---|---|---|
| .. | ||
| _static | ||
| advanced_topics | ||
| contributing | ||
| editor_manual | ||
| getting_started | ||
| reference | ||
| releases | ||
| topics | ||
| autobuild.sh | ||
| conf.py | ||
| favicon.ico | ||
| index.rst | ||
| logo.png | ||
| Makefile | ||
| README.md | ||
| requirements.txt | ||
| spelling_wordlist.txt | ||
| support.rst | ||
Wagtail docs
These are Sphinx docs, automatically built at http://docs.wagtail.io when the master branch is committed to Github. To build them locally, install Wagtail's development requirements (in the root Wagtail directory):
pip install -e .[testing,docs]
To build the documentation for browsing, from this directory run:
make html
then open _build/html/index.html in a browser.
To rebuild automatically while editing the documentation, from this directory run:
sphinx-autobuild . _build
The online editor at http://rst.ninjs.org/ is a helpful tool for checking reStructuredText syntax.