kopia lustrzana https://github.com/wagtail/wagtail
ddebafa119
Depending on libsass for all Wagtail installations was causing issues
with various operating systems, dramatically increasing installation
times, and preventing front end development adopting modern practices.
libsass has been removed as a dependency. Sass files are compiled before
release as a dependency of the `sdist` setup command. Sass compilation
is done through `gulp`. People wishing to hack on the frontend assets
should now install wagtail locally, install the node dependencies, and
run `gulp`:
$ pip install -e path/to/wagtail
$ cd path/to/wagtail
$ npm install
$ npm start
All the templates and JS files have been updated to reference the new
compiled CSS files instead of the Sass files.
Precompiled CSS for jquery-ui and similar have been moved out of the
`scss/` directory to the `css/` directory.
|
||
|---|---|---|
| .. | ||
| _static | ||
| contrib | ||
| contributing | ||
| editor_manual | ||
| getting_started | ||
| howto | ||
| images | ||
| pages | ||
| reference | ||
| releases | ||
| search | ||
| Makefile | ||
| README.md | ||
| autobuild.sh | ||
| conf.py | ||
| form_builder.rst | ||
| index.rst | ||
| requirements.txt | ||
| snippets.rst | ||
| spelling_wordlist.txt | ||
| support.rst | ||
README.md
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 Sphinx and the RTD theme:
pip install Sphinx
pip install sphinx-rtd-theme
Then make html from this directory, and open _build/html/index.html in your browser.
We've provided a watchdog script (based on @jacobian's snippet) to auto-build your local docs when you save them. Install watchdog:
pip install watchdog
Then run ./autobuild.sh before you start editing.
The online editor at http://rst.ninjs.org/ is a helpful tool for checking reStructuredText syntax.