root/trunk/README @ 9

CSSDOC PHP Library

Author: Tom Klingenberg / CSSDOC Project http://cssdoc.net/

This Code is experimental

* CSS Tokennizer
* CSS Parser 
* CSSDOC Parser

Everything should be UTF-8 encoded by default.

CSS-Resources
http://www.w3.org/Style/CSS/
http://www.w3.org/TR/CSS21/syndata.html#tokenization
http://www.w3.org/TR/CSS21/grammar.html

PEAR-Resources
http://pear.php.net/package/PHP_LexerGenerator
http://pear.php.net/package/PHP_Parser_DocblockParser

Parser-Resources
* http://www.phpdeveloper.org/tag/parser
* http://blog.oncode.info/2007/10/25/eine-eigene-programmiersprache-erschaffen-lexer-und-parser-in-php/

Theory
* A Lex Style
  * Writing an Interpreter with Lex, Yacc, and Memphis
    http://memphis.compilertools.net/interpreter.html
  * The Lex & Yacc Page
    http://dinosaur.compilertools.net/
    
* B Manual Coded Parser
  * Interpreter Pattern
    http://www.cs.mcgill.ca/~hv/classes/CS400/01.hchen/doc/interpreter/interpreter.html

Project Settings
* File Encoding: UTF-8 (no BOM)
* Line Endings: Unix
* Use PEAR and ZEND Coding Standards
* DDD

CSSDOC Css Model (Experimental)
The Css Syntax Implementaiton in CSSDOC reflects it's own tokens on a somehow higher level compared to the W3C Core/Macro/Token Lex-Based Syntax.
 
      stylesheet
          |
   +---+--+-----+---------+
   |   |  |     |         |
 (CDO CDC S) statement comment    Note: CDO, CDC and S are not a CSSDOC Parser Token
                |
          +-----+------+------+
          |            |      |
       ruleset       at-rule comment
          |             |
      +---+----+      block (recursion)
     /|\       |
  selectors comment
      |
      +---------+
     /|\        |
 declarations comment
 
 
       comment
          |
    +-----+-----+
    |          /|\
  text        tags
 

W3C Core/Macro/Token Syntax:

W3C Core Syntax: 
 stylesheet  : [ CDO | CDC | S | statement ]*;
 statement   : ruleset | at-rule;
 at-rule     : ATKEYWORD S* any* [ block | ';' S* ];
 ruleset     : selector? '{' S* declaration? [ ';' S* declaration? ]* '}' S*;
 block       : '{' S* [ any | block | ATKEYWORD S* | ';' S* ]* '}' S*;
 selector    : any+;
 declaration : DELIM? property S* ':' S* value;
 property    : IDENT;
 value       : [ any | block | ATKEYWORD S* ]+;
 any         : [ IDENT | NUMBER | PERCENTAGE | DIMENSION | STRING
               | DELIM | URI | HASH | UNICODE-RANGE | INCLUDES
               | DASHMATCH | FUNCTION S* any* ')' 
               | '(' S* any* ')' | '[' S* any* ']' ] S*;
              
W3C Macros:
 ident  [-]?{nmstart}{nmchar}*
 name   {nmchar}+
 nmstart        [_a-z]|{nonascii}|{escape}
 nonascii       [^\0-\177]
 unicode        \\[0-9a-f]{1,6}(\r\n|[ \n\r\t\f])?
 escape         {unicode}|\\[^\n\r\f0-9a-f]
 nmchar         [_a-z0-9-]|{nonascii}|{escape}
 num    [0-9]+|[0-9]*\.[0-9]+
 string         {string1}|{string2}
 string1        \"([^\n\r\f\\"]|\\{nl}|{escape})*\"
 string2        \'([^\n\r\f\\']|\\{nl}|{escape})*\'
 invalid        {invalid1}|{invalid2}
 invalid1       \"([^\n\r\f\\"]|\\{nl}|{escape})*
 invalid2       \'([^\n\r\f\\']|\\{nl}|{escape})*
 nl     \n|\r\n|\r|\f
 w      [ \t\r\n\f]*
 
W3C Tokens:
 IDENT  {ident}
 ATKEYWORD      @{ident}
 STRING         {string}
 INVALID        {invalid}
 HASH   #{name}
 NUMBER         {num}
 PERCENTAGE     {num}%
 DIMENSION      {num}{ident}
 URI    url\({w}{string}{w}\)
                |url\({w}([!#$%&*-~]|{nonascii}|{escape})*{w}\)
 UNICODE-RANGE  U\+[0-9a-f?]{1,6}(-[0-9a-f]{1,6})?
 CDO    <!--
 CDC    -->
 ;      ;
 {      \{
 }      \}
 (      \(
 )      \)
 [      \[
 ]      \]
 S      [ \t\r\n\f]+
 COMMENT        \/\*[^*]*\*+([^/*][^*]*\*+)*\/
 FUNCTION       {ident}\(
 INCLUDES       ~=
 DASHMATCH      |=
 DELIM  any other character not matched by the above rules, and neither a single nor a double quote