sass-site/source/install.html.haml

151 lines
4.7 KiB
Plaintext
Raw Normal View History

2013-10-09 12:30:53 +02:00
---
2015-04-02 01:51:37 +02:00
title: Install Sass
2018-12-28 01:31:28 +01:00
no_container: true
2013-10-09 12:30:53 +02:00
---
2018-12-28 01:31:28 +01:00
.sl-l-grid.sl-l-grid--full.sl-l-large-grid--fit.sl-l-large-grid--gutters-large
.sl-l-grid__column
2018-10-24 00:06:39 +02:00
:markdown
## Applications
![Mouse](illustrations/mouse.svg)
There are a good many applications that will get you up and running
2015-04-02 01:51:37 +02:00
with Sass in a few minutes for Mac, Windows, and Linux. You can download
2013-10-12 23:39:55 +02:00
most of the applications for free but a few of them are paid apps
<small>(and totally worth it)</small>.
2013-10-09 12:30:53 +02:00
2018-12-29 02:59:53 +01:00
%ul
2013-10-11 22:06:20 +02:00
%li
= link_to "CodeKit", "https://codekitapp.com/"
2018-12-29 02:59:53 +01:00
(Paid)
Mac
2018-10-24 00:06:39 +02:00
%li
2018-10-24 00:06:39 +02:00
= link_to 'Hammer', 'http://hammerformac.com/'
2018-12-29 02:59:53 +01:00
(Paid)
Mac
2018-10-24 00:06:39 +02:00
2013-10-11 22:06:20 +02:00
%li
2018-10-24 00:06:39 +02:00
= link_to 'LiveReload', 'http://livereload.com/'
2018-12-29 02:59:53 +01:00
(Paid, Open Source)
Mac
Windows
2018-10-24 00:06:39 +02:00
2013-10-11 22:06:20 +02:00
%li
2018-10-24 00:06:39 +02:00
= link_to 'Prepros', 'https://prepros.io/'
2018-12-29 02:59:53 +01:00
(Paid)
Mac
Windows
Linux
2018-10-24 00:06:39 +02:00
2013-10-11 22:06:20 +02:00
%li
2018-10-24 00:06:39 +02:00
= link_to 'Scout-App', 'http://scout-app.io/'
2018-12-29 02:59:53 +01:00
(Free, Open Source)
Windows
Linux
Mac
2013-10-09 12:30:53 +02:00
:markdown
## Libraries
The Sass team maintains two Node.js packages for Sass, both of which
support [the standard JavaScript API]. The [`sass` package] is pure
JavaScript, which is a little slower but can be installed on all platforms
Node.js supports. The [`sass-embedded` package] wraps a JS API around the
Dart VM, so it's faster but only supports Windows, Mac OS, and Linux.
[the standard JavaScript API]: /documentation/js-api
[`sass` package]: https://www.npmjs.com/package/sass
[`sass-embedded` package]: https://www.npmjs.com/package/sass-embedded
There are also community-maintained wrappers for the following languages:
%ul
%li
#{link_to 'Java', 'https://mvnrepository.com/artifact/de.larsgrefer.sass'},
including
#{link_to 'Gradle', 'https://docs.freefair.io/gradle-plugins/current/reference/#_embedded_sass'}
and
#{link_to 'Maven', 'https://github.com/HebiRobotics/sass-cli-maven-plugin'}
plugins.
%li
#{link_to 'Ruby', 'https://github.com/ntkme/sass-embedded-host-ruby#readme'}
%li
#{link_to 'Swift', 'https://github.com/johnfairh/swift-sass#readme'}
2018-12-28 01:31:28 +01:00
.sl-l-grid__column
:markdown
2018-10-24 00:06:39 +02:00
## Command Line
![Keyboard](illustrations/keyboard.svg)
When you install Sass on the command line, you'll be able to run the
`sass` executable to compile `.sass` and `.scss` files to `.css` files.
For example:
sass source/stylesheets/index.scss build/stylesheets/index.css
First install Sass using one of the options below, then run
`sass --version` to be sure it installed correctly. If it did, this will
include `#{impl_version(:dart)}`. You can also run `sass --help` for more
information about the command-line interface.
Once it's all set up, <strong>go and play</strong>. If you're brand new to
Sass we've set up some resources to help you learn pretty darn quick.
2018-12-28 01:31:28 +01:00
%p= link_to 'Learn More About Sass', '/guide', :class => 'sl-c-button sl-c-button--primary'
%dl
%dt Install Anywhere (Standalone)
2018-10-24 00:06:39 +02:00
%dd
You can install Sass on Windows, Mac, or Linux by downloading the
package for your operating system
2018-10-24 00:06:39 +02:00
#{link_to 'from GitHub', release_url(:dart)} and
<a href='https://katiek2.github.io/path-doc/'>adding it to your
<code>PATH</code></a>. That's all—there are no external dependencies and
nothing else you need to install.
%dt Install Anywhere (npm)
2018-10-24 00:06:39 +02:00
2013-10-12 23:39:55 +02:00
%dd
%p
If you use Node.js, you can also install Sass using
2018-10-24 00:06:39 +02:00
<a href='https://www.npmjs.com/'>npm</a> by running
%pre
:preserve
npm install -g sass
2018-04-02 02:45:05 +02:00
<strong>However, please note</strong> that this will install the pure
JavaScript implementation of Sass, which runs somewhat slower than the
other options listed here. But it has the same interface, so it'll be
easy to swap in another implementation later if you need a bit more
speed!
%dt Install on Windows (Chocolatey)
%dd
%p
If you use <a href='https://chocolatey.org/'>the Chocolatey package
manager</a> for Windows, you can install Dart Sass by running
%pre
:preserve
choco install sass
%dt Install on Mac OS X or Linux (Homebrew)
2018-10-24 00:06:39 +02:00
2013-10-12 23:39:55 +02:00
%dd
%p
2018-10-24 00:06:39 +02:00
If you use <a href='https://brew.sh/'>the Homebrew package
manager</a> for Mac OS X or Linux, you can install Dart Sass by
running
%pre
:preserve
brew install sass/sass/sass