compass/docs/COMMAND_LINE.markdown
2009-10-25 22:17:27 -07:00

69 lines
1.9 KiB
Markdown

Compass Command Line Documentation
==================================
Extensions Commands
-------------------
# install a global extension. probably requires sudo.
compass extension install extension_name
# install an extension into a project
compass extension unpack extension_name [path/to/project]
# uninstall a local or global extension. global extensions will require sudo.
compass extension uninstall extension_name [path/to/project]
# list the extensions in the project
compass extensions list
# list the extensions available for install
compass extensions available
Project Commands
----------------
# Create a new compass project
compass create path/to/project [--using blueprint] [--sass-dir=sass ...] [--project-type=rails]
# Initialize an existing project to work with compass
compass init rails path/to/project [--using blueprint]
# Install a pattern from an extension into a project
compass install blueprint/buttons [path/to/project]
# Compile the project's sass files into css
compass compile [path/to/project]
# Watch the project for changes and compile whenever it does
compass watch [path/to/project]
# Emit a configuration file at the location specified.
compass config [path/to/config] [--sass-dir=sass --css-dir=css ...]
# Validate the generated CSS.
compass validate [path/to/project]
misc commands
-------------
# Generate a background image that can be used to verify grid alignment
compass grid-img W+GxH [path/to/grid.png]
# Emit the version of compass
compass version
# Get help on compass
compass help
# Get help on an extension
compass help extension_name
# Get help about an extension pattern
compass help extension_name/pattern_name
# Get help about a particular sub command
compass help command_name