zetalibrary 0.4.21

Zeta library is css, js framework.

Zeta library

Zeta library is a framework allows to create, collect and pack css, scss, js files much easier. Documentation during development.

Contents

• Zeta library

• Features

• Requirements

• Installation

• Usage

• Frameworks

• Zeta blocks

• Changes

• Examples

• Options

• Bug tracker

• Contributing

• License

• Copyright

• Note

Features

• CSS import support:

  @import url(path or http);

• JS require support:

  require("path or http");

• SCSS compile and imports support See SCSS for more information about language:

  @import url(path or http);

• Compass blueprint scss, css framework Ex.

  @import url( zeta://blueprint.css );
  /* Or */
  @import url( zeta://blueprint/typography.scss );

• Partial compass framework support Ex.

  @import url( zeta://compass/reset.scss );

• Boilerrplate framework support Ex.

  @import url( zeta://boilerplate.css );

• Zeta css, js framework Ex:

  @import url( zeta://zeta.css );
  
  require( "zeta://zeta.js" );

Requirements

• python >= 2.5

• python-scss >= 6.2

Installation

Zeta library should be installed using pip or setuptools:

pip install zetalibrary

easy_install zetalibrary

Usage

$zeta

$ zeta --help

usage: zeta [-h] [-p PREFIX] [-f FORMAT] [-n] [-w] [-s] [-z] source

Parse file or dir, import css, js code and save with prefix.

positional arguments:
source                filename or dirname

optional arguments:
-h, --help            show this help message and exit
-p PREFIX, --prefix PREFIX
                        Save result with prefix. Default is '_'.
-f FORMAT, --format FORMAT
                        Force use this format.
-n, --no-comments     Clear comments.
-w, --watch           Watch directory of file and recompile source if it
                        edited.
-s, --show-frameworks
                        Show available frameworks.
-z, --show-blocks     Show available zeta blocks.

Frameworks

$zeta -s .

zeta.css
Zeta is a static framework.

zeta.js
Part of zeta framework. Include jQuery.

boilerplate.css 0.9.5
HTML5 Boilerplate is the professional badass's base HTML/CSS/JS template for a fast, robust and future-proof site. See http://html5boilerplate.com/

compass.css
Compass is a stylesheet authoring framework. See: http://compass-style.org/

blueprint.css 1.0
Blueprint is a CSS framework. See: http://www.blueprintcss.org/

jquery.js 1.6.2
jQuery is a fast and concise JavaScript Library. See http://jquery.com

Zeta blocks

$ zeta -z .

z-base
z-print
z-grid
z-typography
z-placeholder
z-reset

Changes

Make sure you`ve read the following document if you are upgrading from previous versions of makesite:

http://packages.python.org/zetalibrary/changes.html

Examples

1. Parse all static files in directory ‘’/tmp/static’’ with default prefix:

   $> ls -la /tmp/static
   drwxr-xr-x 4 www-data www-data 4096 2011-02-16 15:09 main
   -rw-r--r-- 1 www-data www-data  335 2011-02-16 15:09 main.css
   -rw-r--r-- 1 www-data www-data  343 2011-02-16 15:09 main.js
   -rw-r--r-- 1 www-data www-data    0 2011-02-16 15:09 print.css
   
   $> zeta /tmp/static
   ...
   $> ls -la /tmp/static
   drwxr-xr-x 4 www-data www-data 4096 2011-02-16 15:09 main
   -rw-r--r-- 1 www-data www-data  335 2011-02-16 15:09 main.css
   -rw-r--r-- 1 www-data www-data  335 2011-02-16 15:09 _main.css
   -rw-r--r-- 1 www-data www-data  343 2011-02-16 15:09 main.js
   -rw-r--r-- 1 www-data www-data  343 2011-02-16 15:09 _main.js
   -rw-r--r-- 1 www-data www-data    0 2011-02-16 15:09 print.css
   -rw-r--r-- 1 www-data www-data    0 2011-02-16 15:09 _print.css

2. Parse /static/main.js

   $> zeta /static/main.js

Options

Under construction.

Bug tracker

If you have any suggestions, bug reports or annoyances please report them to the issue tracker at https://github.com/klen/zeta-library/issues

Contributing

Development of python-scss happens at github: https://github.com/klen/zeta-library

License

Licensed under a GNU lesser general public license.

Copyright

Copyright (c) 2011 Kirill Klenov ([e-mail])

Compass:

(c) 2009 Christopher M. Eppstein http://compass-style.org/

SCSS:

(c) 2006-2009 Hampton Catlin and Nathan Weizenbaum http://sass-lang.com/

jQuery:

(c) 2009-2010 jQuery Project http://jquery.org/

Note

Your feedback are welcome!