%
% API Documentation for cssutils
% Module cssutils.scripts.csscombine'
%
% Generated by epydoc 3.0.1
% [Fri Feb 01 19:05:22 2008]
%

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%                          Module Description                           %%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

    \index{cssutils \textit{(package)}!cssutils.scripts \textit{(package)}!cssutils.scripts.csscombine' \textit{(module)}|(}
\section{Module cssutils.scripts.csscombine'}

    \label{cssutils:scripts:csscombine'}
\begin{alltt}
combines sheets referred to by @import rules in a given CSS proxy sheet
into a single new sheet. 

- proxy currently is a path (no URI)
- in @import rules only relative paths do work for now but should be used 
  anyway
- currently no nested @imports are resolved
- messages are send to stderr
- output to stdout. 

Example::
    
    csscombine sheets{\textbackslash}csscombine-proxy.css -m -t ascii -s utf-8 
        1{\textgreater}combined.css 2{\textgreater}log.txt

results in log.txt::
    
    COMBINING sheets{\textbackslash}csscombine-proxy.css
    USING SOURCE ENCODING: utf-8
    * PROCESSING @import sheets{\textbackslash}csscombine-1.css
    * PROCESSING @import sheets{\textbackslash}csscombine-2.css
    SETTING TARGET ENCODING: ascii

and combined.css::

    @charset "ascii";a\{color:green\}body\{color:\#fff;background:\#000\}

or without option -m::

    @charset "ascii";
    /* proxy sheet which imports sheets which should be combined {\textbackslash}F6 {\textbackslash}E4 {\textbackslash}FC  */
    /* @import "csscombine-1.css"; */
    /* combined sheet 1 */
    a \{
        color: green
        \}
    /* @import url(csscombine-2.css); */
    /* combined sheet 2 */
    body \{
        color: \#fff;
        background: \#000
        \}

issues
    - URL or file hrefs? URI should be default and therefor baseURI is needed
    - no nested @imports are resolved yet
    - namespace rules are not working yet!
        - @namespace must be resolved (all should be moved to top of main sheet?
          but how are different prefixes resolved???)
    - maybe add a config file which is used?
    
\end{alltt}


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%                               Functions                               %%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

  \subsection{Functions}

    \label{cssutils:scripts:csscombine}
    \index{cssutils \textit{(package)}!cssutils.scripts \textit{(package)}!cssutils.scripts.csscombine \textit{(function)}}

    \vspace{0.5ex}

\hspace{.8\funcindent}\begin{boxedminipage}{\funcwidth}

    \raggedright \textbf{csscombine}(\textit{proxypath}, \textit{sourceencoding}={\tt \texttt{'}\texttt{css}\texttt{'}}, \textit{targetencoding}={\tt \texttt{'}\texttt{utf-8}\texttt{'}}, \textit{minify}={\tt True})

    \vspace{-1.5ex}

    \rule{\textwidth}{0.5\fboxrule}
\setlength{\parskip}{2ex}
\begin{alltt}

:Properties:
    proxypath
        url or path to a CSSStyleSheet which imports other sheets which
        are then combined into one sheet
    sourceencoding = 'css'
        encoding of the source sheets including the proxy sheet
        
    targetencoding = 'utf-8'
        encoding of the combined stylesheet
    minify = True
        defines if the combined sheet should be minified
\end{alltt}

\setlength{\parskip}{1ex}
    \end{boxedminipage}

    \label{cssutils:scripts:csscombine':main}
    \index{cssutils \textit{(package)}!cssutils.scripts \textit{(package)}!cssutils.scripts.csscombine' \textit{(module)}!cssutils.scripts.csscombine'.main \textit{(function)}}

    \vspace{0.5ex}

\hspace{.8\funcindent}\begin{boxedminipage}{\funcwidth}

    \raggedright \textbf{main}(\textit{args}={\tt None})

\setlength{\parskip}{2ex}
\setlength{\parskip}{1ex}
    \end{boxedminipage}

    \index{cssutils \textit{(package)}!cssutils.scripts \textit{(package)}!cssutils.scripts.csscombine' \textit{(module)}|)}
