mirrors/wagtail
mirrors/wagtail
0
0
Fork 0
mirror of https://github.com/wagtail/wagtail.git synced 2024-11-28 17:13:31 +01:00
Code Issues Releases Wiki Activity
c6666c6de5
wagtail/docs/contributing/styleguide.rst

21 lines
824 B
ReStructuredText
Raw Normal View History

Move wagtailsettings into contrib module The `wagtailsettings` module is useful enough that it should be included in the Wagtail contrib section, to make it available to all Wagtail developers. All the code has been given a once-over to make sure it is nice and polished before being copied in. As such, this is not a direct copy of the `wagtailsettings` module. It should be backwards compatible though, excepting the new location. It has been moved to `wagtail.contrib.settings`, following the naming scheme set out in #1504. Documentation has been concatenated in to a single page, and added to the contrib reference section.
2015-09-30 07:28:33 +02:00
.. _styleguide:
made difference clearer between coding style and styleguide
2015-05-14 15:21:36 +02:00
UI Styleguide
=============
moved styleguide to own page. renamed trying wagtail to demo site
2015-05-14 15:02:06 +02:00
Developers working on the Wagtail UI or creating new UI components may wish to test their work against our Styleguide, which is provided as the contrib module "wagtailstyleguide".
To install the styleguide module on your site, add it to the list of ``INSTALLED_APPS`` in your settings:
.. code-block:: python
INSTALLED_APPS = (
Changed indentation on all code samples to 4 spaces. Most of the samples were already 4-space indented, but a few were using 2-space, which is both inconsistent and, when it happened with Python code samples, incompatible with PEP8.
2016-04-28 02:23:39 +02:00
...
'wagtail.contrib.wagtailstyleguide',
...
moved styleguide to own page. renamed trying wagtail to demo site
2015-05-14 15:02:06 +02:00
)
At present the styleguide is static: new UI components must be added to it manually, and there are no hooks into it for other modules to use. We hope to support hooks in the future.
Move wagtailsettings into contrib module The `wagtailsettings` module is useful enough that it should be included in the Wagtail contrib section, to make it available to all Wagtail developers. All the code has been given a once-over to make sure it is nice and polished before being copied in. As such, this is not a direct copy of the `wagtailsettings` module. It should be backwards compatible though, excepting the new location. It has been moved to `wagtail.contrib.settings`, following the naming scheme set out in #1504. Documentation has been concatenated in to a single page, and added to the contrib reference section.
2015-09-30 07:28:33 +02:00
The styleguide doesn't currently provide examples of all the core interface components; notably the Page, Document, Image and Snippet chooser interfaces are not currently represented.
Copy Permalink