mirror of
https://github.com/wagtail/wagtail.git
synced 2024-11-29 17:36:49 +01:00
7523d7f57f
Concatinating with settings.STATIC_URL is no longer reccomended for creating URLs to static resources, because it doesn't take the configured storage engine into account. For example, a site using S3 to store its static files will need static URLs that link out to S3, rather than relative URLs within the same domain. I replaced it with django.contrib.staticfiles.templatetags.staticfiles.static() in python example code, and the {% static %} tag in template examples. |
||
---|---|---|
.. | ||
_static/images | ||
advanced_topics | ||
contributing | ||
editor_manual | ||
getting_started | ||
reference | ||
releases | ||
topics | ||
autobuild.sh | ||
conf.py | ||
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.