Index: third_party/pyscss/README.rst |
diff --git a/third_party/pyscss/README.rst b/third_party/pyscss/README.rst |
deleted file mode 100644 |
index 96bf086a1d5d7aab15538ae5bcf2b68166e20539..0000000000000000000000000000000000000000 |
--- a/third_party/pyscss/README.rst |
+++ /dev/null |
@@ -1,308 +0,0 @@ |
-Python-scss |
-=========== |
- |
-Python-scss is SCSS_ compiler for python. Documentation available at pypi_ or github_. |
-This is part of zeta-library_. |
- |
-.. contents:: |
- |
- |
-Features |
-======== |
-Python-scss has most of the funcitonality in Sass SCSS_ 3.2 and more. It supports: |
- |
-* **Nested rules** |
-* **Keyword arguments** |
-* **Mixins**: ``@mixin``, ``@include`` |
-* **Functions**: ``@function``, ``@return`` |
-* **Inheritance**: ``@extend`` |
-* **Conditions**: ``@if``, ``@else``, ``@if else`` |
-* **Loops**: ``@for`` |
-* **Variables**: ``$``, ``@variables``, ``@vars`` |
-* **Images**: ``image-url``, ``image-width``, ``image-height``, .. |
-* **Embedded inline images**: ``inline-image`` |
-* **Colors handling**: ``adjust-color()``, ``scale-color()``, ``opacify()``/``transparentize()``, ``lighten()``/``darken()``, ``mix()``, ... |
-* **Math functions**: ``sin()``, ``cos()``, ``tan()``, ``round()``, ``ceil()``, ``floor()``, ``pi()``, ... |
-* **Options**: ``@option compress:true, sort:false;``, ``@option comments:false;`` |
-* **Compass_ helpers**: ``enumerate``, ``type-of``, ... |
-* **Sorting declarations**: in `Zen sorting order`_ |
- |
-.. note:: |
- For ``@import`` support you can use zeta-library_, python compass alternative. |
- |
- Zeta-library supported ``@import url(path or http)``, but all static files css, scss. |
- |
- Also zeta support js import ``require( '../jquery.js' );``. Zeta allow you control all your static files. |
- |
- |
-Requirements |
-============= |
-- python >= 2.5 |
-- pyparsing >= 1.5.5 |
- |
- |
-Installation |
-============ |
-**python-scss** should be installed using pip or setuptools: :: |
- |
- pip install scss |
- |
- easy_install scss |
- |
- |
-Usage |
-===== |
- |
-#. **From python source code**: :: |
- |
- from scss import parser |
- |
- file_path = path_to_file |
- src = open( file_path ).read() |
- |
- # from file |
- print parser.load( 'file_path' ) |
- |
- # from string |
- print parser.parse( 'src' ) |
- |
- # Create parser object |
- p = parser.Stylesheet( options=dict( compress=True ) ) |
- print p.loads( src ) |
- p.load( file_path ) |
- print p |
- |
-#. **From command line**: :: |
- |
- $ scss --help |
- Usage: scss [OPTION]... [INFILE] [OUTFILE] |
- |
- Compile INFILE or standard input, to OUTFILE or standard output. |
- |
- Options: |
- --version show program's version number and exit |
- -h, --help show this help message and exit |
- -c, --cache Create and use cache file. Only for files. |
- -i, --interactive Run in interactive shell mode. |
- -m, --compress Compress css output. |
- -w WATCH, --watch=WATCH |
- Watch files or directories for changes. The location |
- of the generated CSS can be set using a colon: |
- scss -w input.scss:output.css |
- -S, --no-sorted Do not sort declaration. |
- -C, --no-comments Clear css comments. |
- -W, --no-warnings Disable warnings. |
- |
-#. **In interactive mode**: :: |
- |
- scss -i |
- |
- >>> 25px + 1.5em |
- |
- |
-Changes |
-======= |
- |
-Make sure you`ve read the following document if you are upgrading from previous versions of scss: |
- |
-http://packages.python.org/scss/changes.html |
- |
- |
-Examples |
-======== |
- |
-#. **Nested Rules** |
- Example:: |
- |
- .selector { |
- a { |
- display: block; |
- } |
- strong { |
- color: blue; |
- } |
- } |
- |
- ...produces:: |
- |
- .selector a { |
- display: block} |
- |
- .selector strong { |
- color: blue} |
- |
- |
-#. **Variables** |
- Example:: |
- |
- $main-color: #ce4dd6; |
- $style: solid; |
- $side: bottom; |
- #navbar { |
- border-#{$side}: { |
- color: $main-color; |
- style: $style; |
- } |
- } |
- |
- ...produces:: |
- |
- #navbar { |
- border-bottom-color: #ce4dd6; |
- border-bottom-style: solid} |
- |
-#. **Mixins** |
- Example:: |
- |
- @mixin rounded($side, $radius: 10px) { |
- border-#{$side}-radius: $radius; |
- -moz-border-radius-#{$side}: $radius; |
- -webkit-border-#{$side}-radius: $radius; |
- } |
- #navbar li { @include rounded(top); } |
- #footer { @include rounded(top, 5px); } |
- #sidebar { @include rounded(left, 8px); } |
- |
- ...produces:: |
- |
- #navbar li { |
- -moz-border-radius-top: 10px; |
- -webkit-border-top-radius: 10px; |
- border-top-radius: 10px} |
- |
- #footer { |
- -moz-border-radius-top: 5px; |
- -webkit-border-top-radius: 5px; |
- border-top-radius: 5px} |
- |
- #sidebar { |
- -moz-border-radius-left: 8px; |
- -webkit-border-left-radius: 8px; |
- border-left-radius: 8px} |
- |
-#. **Extend** (using `@extend`) |
- Example:: |
- |
- .error { |
- border: 1px #f00; |
- background-color: #fdd; |
- } |
- .error.intrusion { |
- background-image: url("/image/hacked.png"); |
- } |
- .seriousError { |
- @extend .error; |
- border-width: 3px; |
- } |
- |
- ...produces:: |
- |
- .error, .seriousError { |
- background-color: #fdd; |
- border: 1px #f00} |
- |
- .error .intrusion, .seriousError .intrusion { |
- background-image: url('/image/hacked.png')} |
- |
- .seriousError { |
- border-width: 3px} |
- |
-#. **Interactive mode** |
- Example:: |
- |
- $ python scss.py --interactive |
- >>> 25px + 1.5em |
- 44.5px |
- >>> lighten(rgba(130,130,130,.4),10%) |
- rgba(155,155,155,0.40) |
- >>> .rule { test: red; } |
- .rule { |
- test: red } |
- >>> _ |
- |
- |
-Options |
-======= |
- |
-Python-scss has the following options: |
- |
-- **compress**: Compress ouput css, default is False |
- |
-- **cache**: Precache compile result, default is False |
- |
-- **comments**: Leave css comments, default is True |
- |
-- **sort**: Sort declaration, default is True |
- Declaration sorted in `Zen sorting order`_ |
- |
-- **warn**: Enable or disable warnings: unwnown mixin, declaration name, extend ruleset, default is True |
- |
-Option can be defined... |
- |
-#. from command line: :: |
- |
- scss -m -S file.scss |
- |
-#. from python: :: |
- |
- parser = Stylesheet( options=dict( compress=True ) ) |
- |
-#. from scss source: :: |
- |
- @option compress: true, sort: false; |
- |
- |
-.. note:: |
- python-scss is still at early stages of development |
- |
- |
-Bug tracker |
-=========== |
- |
-If you have any suggestions, bug reports or |
-annoyances please report them to the issue tracker |
-at https://github.com/klen/python-scss/issues |
- |
- |
-Contributing |
-============ |
- |
-Development of python-scss happens at github: https://github.com/klen/python-scss |
- |
-* klen_ (Kirill Klenov) |
- |
- |
-License |
-======= |
- |
-Licensed under a `GNU lesser general public license`_. |
- |
- |
-Copyright |
-========= |
- |
-Copyright (c) 2011 Kirill Klenov (horneds@gmail.com) |
- |
-Compass_: |
- (c) 2009 Christopher M. Eppstein |
- http://compass-style.org/ |
- |
-SCSS_: |
- (c) 2006-2009 Hampton Catlin and Nathan Weizenbaum |
- http://sass-lang.com/ |
- |
- |
-Note |
-==== |
- |
-**Your feedback are welcome!** |
- |
-.. _zeta-library: http://github.com/klen/zeta-library |
-.. _GNU lesser general public license: http://www.gnu.org/copyleft/lesser.html |
-.. _SCSS: http://sass-lang.com |
-.. _compass: http://compass-style.org/ |
-.. _python scss git: http://packages.python.org/scss/ |
-.. _pypi: http://packages.python.org/scss/ |
-.. _github: https://github.com/klen/python-scss |
-.. _Zen sorting order: http://code.google.com/p/zen-coding/wiki/ZenCSSPropertiesEn#Sorting_Methods |
-.. _klen: https://klen.github.com |