为django简单编译compass项目。
django-compass2的Python项目详细描述
django-compass2是一个可重用的django应用程序,它提供了 将基于Compass或Sass的样式表编译为css。它的主要部分 好处是django设置集成,所以不需要太多compass.rb 配置文件(尤其是在多个部署中 塞特拉)。除此之外,它只是compass命令行的代理 申请。
安装和设置
您需要安装Compass;这是一个ruby库,所以使用gem 实用程序(在大多数系统上都是现成安装的):
$ [sudo] gem install compass --pre
然后,只需使用pip或easy_install安装django-compass2。 将自动处理依赖关系):
$ pip install django-compass2 # OR $ easy_install django-compass2
将'djcompass'添加到INSTALLED_APPS设置中。
在settings.py文件中,添加必要的设置。看看 下面的配置参考以获取更多信息,但这里有一个 示例:
COMPASS_INPUT = PROJECT_ROOT + 'media/sass' COMPASS_OUTPUT = PROJECT_ROOT + 'media/css' COMPASS_STYLE = 'compact' COMPASS_REQUIRES = ( 'ninesixty', # 960.gs Grid System )
现在可以使用管理命令编译sass:
$ python manage.py compass
用法
命令行界面非常简单。 要查看可用的选项和命令,请尝试:
$ python manage.py compass --help
基本上语法很简单:
$ python manage.py compass <primary_command>
只需将sass编译成css:
$ python manage.py compass exists media/css unchanged media/sass/style.sass
以上命令或多或少相当于调用:
compass --sass-dir media/sass --css-dir media/css --output-style compact
持续监控您的sass:
$ python manage.py compass watch >>> Compass is watching for changes. Press Ctrl-C to Stop. >>> Change detected to: .../media/sass/style.sass overwrite media/css/style.css ...
它类似于:
compass --sass-dir media/sass --css-dir media/css --output-style compact --watch
配置参考
django设置
这些应该放在settings.py文件中。
所需设置
- COMPASS_INPUT:保存sass/scss样式表的目录。
- COMPASS_OUTPUT:指南针应该输出css的目录。
请注意,这两个都不应该有尾随斜杠。它们可能是绝对的,或者 相对路径;如果是相对路径,它们将根据当前工作解析 目录。
可选设置
- COMPASS_EXECUTABLE:指南针二进制的路径。默认为“指南针”
- COMPASS_STYLE:一个'nested','expanded','compact'或 'compressed',指定生成的css输出的样式。违约 是'compact'。
- COMPASS_REQUIRES:运行前到require的一系列ruby库 指南针指令。
- COMPASS_IMAGE_DIR:存储图像的目录(用于 指南针的资源url帮助程序)。
- COMPASS_SCRIPT_DIR:包含javascript文件的目录(使用 用于Compass的资产URL帮助程序)。
- COMPASS_RELATIVE_URLS:布尔值,指定指南针的资产是否为 url助手应该生成相对url。
命令行选项
这些选项可能在运行时传递以影响指南针的运行方式。
- -t,--trace:打印指南针错误的完整堆栈跟踪。