Metadata-Version: 2.1
Name: py-css-styleguide
Version: 0.7.0
Summary: CSS Manifest driven styleguide for your project
Home-page: https://github.com/sveetch/py-css-styleguide
Author: David Thenon
Author-email: sveetch@gmail.com
License: MIT
Keywords: CSS,Sass,Scss,Styleguide
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Internet
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Description-Content-Type: text/x-rst
Provides-Extra: dev
License-File: LICENCE.txt


.. _tinycss2: https://github.com/Kozea/tinycss2

PyCssStyleguide
===============

A Python library to build a styleguide from a CSS manifest file.

It is way of building a styleguide without to write declarations inside CSS comments in your stylesheets.

You build a manifest in a dedicated CSS file and it will be parsed and serialized so you can use it in your code or templates to build a styleguide.

Why a dedicated CSS file for a manifest ? Because it can be automatically writed from your Sass sources. Obviously it would only work if your design is driven by variables like with *Foundation for Site* or *Bootstrap*.

Manifest syntax rules are writed so the CSS file is still a valid CSS, mostly using CSS3 variables.

This library provides:

* An API to load a CSS manifest and return it has structured datas;
* A Sass source with some mixin helpers to help you to write CSS manifest from your Sass sources;

This library doesn't provide template or application to build the styleguide page, it's up to you to integrate it in your project.

Links
*****

* Read the documentation on `Read the docs <https://pycssstyleguide.readthedocs.io/>`_;
* Download its `PyPi package <http://pypi.python.org/pypi/py-css-styleguide>`_;
* Clone it on its `Github repository <https://github.com/sveetch/py-css-styleguide>`_;

Dependancies
************

* `tinycss2`_;


