docs/sass.html.erb in zurb-foundation-4.0.3 vs docs/sass.html.erb in zurb-foundation-4.0.4
- old
+ new
@@ -1,7 +1,7 @@
<% @side_nav = "using" %>
-
+<% @page_title = "Sass" %>
<div class="row">
<div class="large-9 push-3 columns">
<h2>Using the Sass Version of Foundation</h2>
<h4 class="subheader">Start using Foundation the way you want, with more control than ever before. We've made it really easy to install using Compass so you'll need a little bit of knowledge before you get going. Visit the <a href="http://compass-style.org">Compass</a> and <a href="http://sass-lang.com">Sass</a> sites to learn the basics if you don't already know them.</h4>
@@ -26,20 +26,10 @@
<p class="btm-marg keystroke">[sudo] gem install zurb-foundation --pre</p>
</div>
</div>
<br>
-
- <div class="row">
- <div class="large-12 columns">
- <h5>Compiling Your Scss</h5>
- <p>To compile your Scss into CSS you run a simple command that will watch for saves and compile each time you save an Scss file. The command is:</p>
- <p class="btm-marg keystroke">compass watch</p>
- </div>
- </div>
-
- <br>
<hr>
<a name="create-compass"></a>
<h2>Creating your first project</h2>
<h5 class="subheader">Compass makes it really easy to start a new project. Since you've installed the Foundation gem by now, you now have Compass, Sass and a few other necessary dependencies available at your fingertips.</h5>
@@ -47,10 +37,23 @@
<ol style="margin-left: 20px;">
<li><span class="keystroke">cd path/to/where-you-want-your-project</span></li>
<li>run <span class="keystroke">compass create <project-name> -r zurb-foundation --using foundation</span></li>
</ol>
+ <br>
+
+ <div class="row">
+ <div class="large-12 columns">
+ <h5>Compiling Your Scss</h5>
+ <p>To compile your Scss into CSS you run a simple command that will watch for saves and compile each time you save an Scss file. From the directory of your <kbd>config.rb</kbd> file, the command is:</p>
+ <p class="btm-marg keystroke">compass watch</p>
+ <p>If you are in a different directory you can use the same command, but navigate to where your <kbd>config.rb</kbd> file is. The command looks like:</p>
+ <p class="btm-marg keystroke">compass watch path/to/project</p>
+ </div>
+ </div>
+
+
<hr>
<a name="compass-existing"></a>
<h3>Working with Existing projects</h3>
<h5 class="subheader">There are a couple situations to cover here. You might be adding Foundation to an existing project that wasn't build with Foundation or you might be upgrading Foundation for an already created Foundation Compass project.</h5>
@@ -84,18 +87,45 @@
<h3>Creating a project from Git</h3>
<h5 class="subheader">Sometimes you want to checkout what we've got even before we decide to deploy a release candidate. For these situations, you can install using Bundler.</h5>
<p>There are a few different ways to do this, but here's what we recommend:</p>
<ol style="margin-left: 20px;">
- <li>Setup a Foundation project folder: <kbd>mkdir ~/awesomeapp</kbd></li>
- <li>Create a Gemfile with this content: <br>
- <kbd style="margin-left: 15px;">source :rubygems</kbd> <br>
- <kbd style="margin-left: 15px;">gem "zurb-foundation", :git => "git@github.com:zurb/foundation.git"</kbd> <br>
- <kbd style="margin-left: 15px;">gem "compass"</kbd>
+ <li>Setup a folder for your project (i.e. <kbd>mkdir ~/awesomeapp</kbd>)
+ <li>Create a file called <code>Gemfile</code> in the folder you just created with this content: <br>
+<%= code_example '
+source "https://rubygems.org"
+gem "zurb-foundation", :git => "git@github.com:zurb/foundation.git"
+gem "compass"
+', :ruby %>
</li>
- <li>Then run: <kbd>touch ~/awesomeapp/Gemfile</kbd></li>
- <li>Change into your application directory: <kbd>cd ~/awesomeapp</kbd></li>
- <li>Create a project using Bundler: <kbd>bundle exec compass create . -r zurb-foundation --using foundation</kbd></li>
+ <li>Change into your application directory (<kbd>cd ~/awesomeapp</kbd>) then create a new compass project using the following command:</li>
+<%= code_example '
+bundle exec compass create . -r zurb-foundation --using foundation
+', :bash %>
+ <li>When you're working on your project, run: <kbd>bundle exec compass watch</kbd></li>
+ </ol>
+
+ <hr>
+
+ <a name="multiple-versions"></a>
+ <h3>Running multiple versions</h3>
+ <h5 class="subheader">If you're planning on running multiple, potentially incompatible versions of Foundation you can isolate them using Bundler as well.</h5>
+
+ <p>There are a few different ways to do this, but here's what we recommend:</p>
+ <ol style="margin-left: 20px;">
+ <li>Setup a folder for your project (i.e. <kbd>mkdir ~/awesomeapp</kbd>)
+ <li>Create a file called <code>Gemfile</code> in the folder you just created with this content: <br>
+<%= code_example '
+source "https://rubygems.org"
+# Replace 4.0.3 with the version of Foundation you want to use
+gem "zurb-foundation", "4.0.3"
+gem "compass"
+', :ruby %>
+ </li>
+ <li>Change into your application directory (<kbd>cd ~/awesomeapp</kbd>) then create a new compass project using the following command:</li>
+<%= code_example '
+bundle exec compass create . -r zurb-foundation --using foundation
+', :bash %>
<li>When you're working on your project, run: <kbd>bundle exec compass watch</kbd></li>
</ol>
<hr>