compass/COMMAND_LINE.markdown
2009-10-05 00:56:49 -07:00

1.9 KiB

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