[Docs] Better intro page.

This commit is contained in:
Chris Eppstein 2010-05-09 23:17:49 -07:00
parent ae231c7f6d
commit c361229ef0
2 changed files with 59 additions and 13 deletions

View File

@ -6,7 +6,7 @@ body_id: home
%article
%h1#logo Compass
%p
:markdown
Compass is a stylesheet authoring tool that uses the Sass stylesheet
language to make your stylesheets smaller and your web site easier to
maintain. Compass provides ports of the best of breed css frameworks
@ -14,16 +14,49 @@ body_id: home
names. Its a new way of thinking about stylesheets that must be seen
in action!
%h2 Screencast Tutorial
## Installing
%p
This screencast will walk you through getting set up,
learning Sass, and then how to use Compass to style a webpage.
Compass is a tool that runs on the command line.
<object width="660" height="371"><param name="allowfullscreen" value="true" /><param name="allowscriptaccess" value="always" /><param name="movie" value="http://vimeo.com/moogaloop.swf?clip_id=4335944&amp;server=vimeo.com&amp;show_title=1&amp;show_byline=0&amp;show_portrait=0&amp;color=00ADEF&amp;fullscreen=1" /><embed src="http://vimeo.com/moogaloop.swf?clip_id=4335944&amp;server=vimeo.com&amp;show_title=1&amp;show_byline=0&amp;show_portrait=0&amp;color=00ADEF&amp;fullscreen=1" type="application/x-shockwave-flash" allowfullscreen="true" allowscriptaccess="always" width="660" height="371" /></object>
On any system with ruby installed, open your terminal and type:
%h2 Bugs Reports, Discussions, Support
gem install compass
This will install Compass and Sass too. Verify that compass is installed:
compass version
## Creating a stand-alone project
compass create myproject
mate myproject
compass watch myproject
If you don't have TextMate, substitute the `mate myproject` part with the text
editor of your choice. Edit the `*.scss` files in the `src` directory.
These files are yours and you can change them as you see fit, delete them,
make new ones, etc. Compass will automatically compile them into css in the
`stylesheets` directory whenever they change.
## Rails Support
compass init rails /path/to/myrailsproject
## Installing a framework
When creating a new project:
compass create myproject --using blueprint/basic
When installing into an existing project:
compass install myproject --using blueprint/semantic
With Rails:
compass init rails /path/to/myrailsproject --using blueprint/semantic
## Bugs Reports, Discussions, Support
:markdown
Send a note to the [mailing list](http://groups.google.com/group/compass-users)
and/or [File a bug](http://github.com/chriseppstein/compass/issues).

View File

@ -0,0 +1,13 @@
---
title: Compass Documentation
crumb: Docs
body_id: home
---
%h1 Screencast Tutorial
%p
This screencast will walk you through getting set up,
learning Sass, and then how to use Compass to style a webpage.
<object width="660" height="371"><param name="allowfullscreen" value="true" /><param name="allowscriptaccess" value="always" /><param name="movie" value="http://vimeo.com/moogaloop.swf?clip_id=4335944&amp;server=vimeo.com&amp;show_title=1&amp;show_byline=0&amp;show_portrait=0&amp;color=00ADEF&amp;fullscreen=1" /><embed src="http://vimeo.com/moogaloop.swf?clip_id=4335944&amp;server=vimeo.com&amp;show_title=1&amp;show_byline=0&amp;show_portrait=0&amp;color=00ADEF&amp;fullscreen=1" type="application/x-shockwave-flash" allowfullscreen="true" allowscriptaccess="always" width="660" height="371" /></object>