Writing content /install

- Restructured the content to focus on the 2 ways to get Sass installed: GUI & the command line
- Added icons (they need to be converted to SVG or webfonts so they look pretty)
- Added a version YML file so we can add the current Sass version, name and release notes in a single location to use throughout the site.
This commit is contained in:
Bermon Painter 2013-10-11 16:17:32 -04:00
parent 454ab06f6b
commit 6c54fd7c30
6 changed files with 126 additions and 53 deletions

3
data/version.yml Normal file
View File

@ -0,0 +1,3 @@
number: 3.2.12
name: Media Mark
notes: ~

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.1 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.9 KiB

View File

@ -0,0 +1,24 @@
$os-icons: "/assets/images/icons/os-icons.png";
%os-icons {
background: url($os-icons) 0 0 no-repeat;
@include background-size(auto 15px);
display: inline-block;
height: 15px;
width: 15px;
}
.mac-icon {
@extend %os-icons;
background-position: -35px 0;
}
.windows-icon {
@extend %os-icons;
}
.linux-icon {
@extend %os-icons;
background-position: -65px 0;
}
.paid-icon {
@extend %os-icons;
background-position: -100px 0;
}

View File

@ -40,6 +40,7 @@
@import "components/features";
@import "components/get-started";
@import "components/slides";
@import "components/icons";

View File

@ -6,7 +6,82 @@ layout: layout_1_column
.features
%h2 There are a couple of ways to start using Sass:
%ol
%li.frameworks
%li.gui-application
%h3 Applications
%p There are a a good many applications that will get you up and running with Sass in a few minutes for Mac, Windows, and Linux. You can download most of the applications for free but a few of them are paid apps <small>(and totally worth it)</small>.
/ The applications are listed in alphabetical order. As new applications are released they should be added to the list.
%ul
%li
= link_to "CodeKit", "http://incident57.com/codekit/"
%span.paid-icon
%span.mac-icon
%li
= link_to "Compass", "http://compass.handlino.com/"
%span.paid-icon
%span.mac-icon
%span.windows-icon
%span.linux-icon
%li
= link_to "Koala", "http://koala-app.com/"
%span.mac-icon
%span.windows-icon
%span.linux-icon
%li
= link_to "LiveReload", "http://livereload.com/"
%span.mac-icon
%span.windows-icon
%li
= link_to "Prepros", "http://alphapixels.com/prepros/"
%span.mac-icon
%span.windows-icon
%li
= link_to "Scout", "http://mhs.github.io/scout-app/"
%span.mac-icon
%span.windows-icon
%li.command-line-unix
%h3 Command Line
#install-ruby-linux
%strong 1. Linux
%p If you're using a distribution of Linux, you'll need to install Ruby first. You can use --something--, or --something--, or --something else--.
#install-ruby-windows
%strong 1. Windows
%p Before you start using Sass you will need to install Ruby. The fastest way to get Ruby on your Windows computer is to use <a href="http://www.rubyinstaller.org">Ruby Installer</a>. It's a single-click installer that will get everything set up for you super fast.
%p Along with Ruby the installer will also install a Ruby command line application that you will let you use the Ruby libraries. Open --application name--.
#install-ruby-mac
%strong 1. Mac
%p If you prefer the command line over an application then getting Sass set up is a fairly quick process. Sass has a Ruby dependency but if you're using a Mac, congratulations, Ruby comes pre-installed.
%p Here's the quickest way we've found to start using Sass by using the command line:
%ol
%li
%p <strong>2. Open your command line application.</strong> On the Mac the Terminal.app comes installed by default. It's located in your "Utilities" folder.
%li
%p <strong>3. Install Sass.</strong> Ruby uses Gems to manage it's various packages of code like Sass. In your open terminal window type:
%pre
:preserve
gem install sass
%p This will install Sass and any dependencies for you. It's pretty magical.
%li
%p <strong>4. Double-check.</strong> You should now have Sass installed, but it never hurts to double-check. In your terminal application you can type:
%pre
:preserve
sass -v
%p It should return <code>Sass #{data.version.number} (#{data.version.name})</code>. Congratulations! You've successfully installed Sass.
%li
%p <strong>5. Go and play.</strong> If you're brand new to Sass we've set up some resources to help you learn pretty darn quick.
= link_to "Learn Sass", "/learn-sass", :class => "button primary"
.frameworks
%h3 Frameworks
%p
If you or your team is using a dynamic web language or framework, then
@ -31,33 +106,3 @@ layout: layout_1_column
%p
This is a very partial list. Just search the web for the name of your
framework + Sass and it's likely to come up.
%li.command-line
%h3 Command Line
/ Description for Unix users
%p
Using Sass on the command line is as simple as using a few commands.
To install Sass just type the following into the command line:
/ We'll try and point the user to either
%pre
:preserve
gem install sass
%p
To learn how to compile your Sass files, please see our Command Line
Reference
%p= link_to "Command Line Guide", '/get-started/command-line#unix'
%p
For Windows users, go check out the
= succeed "." do
= link_to "Sass for Windows Guide", "/get-started/command-line#windows"
%li.gui-application
%h3 GUI Application
%p There are many free and paid GUIs that natively support Sass in them. This is the ideal start for the very non-technical user.
%ul
%li= link_to "Scout (Mac, Free)", "http://mhs.github.io/scout-app/"
%li= link_to "Compass.app ($10)", "http://compass.handlino.com/"
%li= link_to "LiveReload ($9.95)", "http://livereload.com/"
%li= link_to "CodeKit ($25)", "http://incident57.com/codekit/"