pyScss 技术文档

1. 安装指南

环境要求

• Python 2.6+ 或 3.3+
• PyPy 也支持

安装步骤

1. 使用 pip 安装 pyScss：

   pip install pyScss
   

2. 项目的使用说明

快速开始

安装完成后，可以通过命令行或 Python API 使用 pyScss。

命令行使用

通过命令行编译 .scss 文件：

python -mscss < style.scss

Python API 使用

在 Python 脚本中使用 pyScss 编译字符串：

from scss import Compiler

compiler = Compiler()
result = compiler.compile_string("a { color: red + green; }")
print(result)

3. 项目API使用文档

Python API

pyScss 提供了简单的 Python API，允许用户在代码中直接编译 Sass 代码。

主要类和方法

• Compiler 类：用于编译 Sass 代码。
  • compile_string(scss_string): 编译给定的 Sass 字符串并返回生成的 CSS 代码。

示例

from scss import Compiler

compiler = Compiler()
css = compiler.compile_string("a { color: red + green; }")
print(css)

4. 项目安装方式

通过 pip 安装

pyScss 可以通过 pip 进行安装：

pip install pyScss

从源码安装

如果需要从源码安装，可以按照以下步骤操作：

1. 克隆项目仓库：

   git clone https://github.com/Kronuz/pyScss.git
   

2. 进入项目目录：

   cd pyScss
   

3. 安装依赖并构建项目：

   pip install -r requirements.txt
   python setup.py install
   

5. 进一步阅读

• 项目文档可以通过 Sphinx 生成，运行以下命令生成 HTML 文档：

  make html
  

• 生成的文档可以在 docs/_build/html 目录下找到。

6. 版权信息

• 版权所有 © 2012 German M. Bravo (Kronuz)
• 项目基于 MIT 许可证发布，详细信息请参阅 LICENSE 文件。