Download the PHP package kiefer79/kss-php without Composer
On this page you can find all versions of the php package kiefer79/kss-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download kiefer79/kss-php
More information about kiefer79/kss-php
Files in kiefer79/kss-php
Package kss-php
Short Description A PHP implementation of KSS: a methodology for documenting CSS and generating styleguides
License MIT
Informations about the package kss-php
Knyle Style Sheets
This is a PHP implementation of Knyle Style Sheets (KSS). KSS attempts to provide a methodology for writing maintainable, documented CSS within a team. Specifically, KSS is a documentation specification and styleguide format. It is not a preprocessor, CSS framework, naming convention, or specificity guideline.
KSS in a nutshell
The methodology and ideas behind Knyle Style Sheets are contained in SPEC.md of the origin ruby version of KSS. At its core, KSS is a documenting syntax for CSS.
PHP Library
This repository includes a php library suitable for parsing SASS, SCSS, and CSS documented with KSS guidelines. To use the library, include it in your project as a composer dependency (see below). Then, create a parser and explore your KSS.
Generating styleguides
The documenting syntax and php library are intended to generate styleguides automatically. To do this, you'll need to leverage a small javascript library that generates class styles for pseudo-class styles (:hover
, :disabled
, etc).
- kss.coffee
- kss.js (compiled js)
For an example of how to generate a styleguide, check out the example
php pages.
Dependencies
The PHP version of KSS has dependencies managed by Composer. If you did not install kss-php using composer, you must install these dependencies manually before using the library by running the following commands:
If you do not yet have Composer, download it following the instructions on http://getcomposer.org or run the following commands to install it globally on your system:
Symfony2 Bundle
If your project uses symfony2, consider using the [KSS Bundle] (https://github.com/kss-php/KssBundle) as well. The KSS Bundle uses Twig templates to make the styleguide block easier to customize and include in your views.