• Prerequisites This guide of getting started is for the SASS framework (the CSS framework is working out-of-the-box), since we need SASS to set it up

    There are not a lot of prerequisites required to start out working with the framework, in fact, you only need the Ruby programming language and the SASS gem installed. The ways of installing them are described below.

    I want to clear out from the start that in this book we will deal with only one working environment composed out of installing the Ruby programming language (which is necessary in order to install SASS) and the SASS gem. There are other working environments such as scaffolding your project with Node.js generators such as Yeoman, which are great tools indeed, but we will not cover this topic since it's a matter of preference. We just need the bare minimum, which is the Ruby programming language and the SASS gem.
  • Installing Needed Software

    The only thing you need to install is SASS, things like code editors and so on are your very own choice, since you already must be accustomed with a particular way of working.

    SASS Prerequisites:

    Install SASS on Linux

    Firstly, you must install Ruby and the easiest way to install it on Linux is from the terminal.

    Assuming you have a Debian Linux distribution such as Ubuntu, the command for installing Ruby is:

                sudo apt-get install ruby-full -g

    This command will install the latest stable Ruby version and will make it available globally (through to the '-g' parameter) on your system environment, so you can use it anywhere.

    Once you did this, you can check out if Ruby was installed correctly by entering the following command into the terminal:

                ruby -v

    If it gives you the output of "ruby" following the version of it, it means that it was installed successfully. The output will be something like this:

                ruby 1.9.3p484 (2013-11-22 revision 43786) [x86_64-linux]

    Now that we have Ruby installed, we must install the SASS gem, by typing the following at the terminal:

                sudo gem install sass

    Similar to Ruby, you can check SASS version by entering the command:

                sass -v

    At this moment of writing the book, the latest version of SASS is 3.4.10, so the output of the command will be:

                Sass 3.4.10 (Selective Steve)

    Now you're good to go and can start using SASS on your Linux machine!

    Install SASS on Mac

    The latest versions of Mac OS (Yosemite and Mavericks) come bundled with Ruby 2.0, so there is no need to install it. Older versions like Mountain Lion, Lion and Snow Leopard ship with Ruby 1.8.7, but we will want to use Ruby past the 1.9.3 version, since we don't want to have unwanted errors while developing.

    If you use Homebrew as a package manager, you can install Ruby using the following Homebrew command:

                brew install ruby

    Once you have Ruby installed, you can install SASS the same way as on Linux, using the following command at the terminal:

                sudo gem install sass

    If you want things plain easy, you can install Ruby and SASS using MacRuby for Mac OS.

    You can start now using SASS on your Mac machine!

    Install SASS on Windows

    You can install Ruby on Windows by downloading and running RubyInstaller and it will do everything for you.

  • Setting All Up

    Now that you have Ruby and SASS installed, you can pick up your editor of choice (I prefer using SublimeText), create a working directory and start getting your hands dirty with what's coming up.

    You will end up in no time writing a large amount of code, since that's the best way (at least, in my opinion) in learning something.

    Now that you have Ruby and SASS installed, it's time to jump into the Tutorials section, to learn how you can start a project with Blackhole.

  • Migrate to the Latest Version

    In order to update your current version of Blackhole to the latest version, you can take one of the following steps:

    • if you didn't change anything in the core and base files, you can overwrite the old files with the new ones with no worries, because there are only structural changes involved;
    • if you did made changes to the core and base files, you can use a diff tool and keep your changes and add the new ones;
    It is highly recommended to update at least the boilerplate.(s)css file from base directory, which brings a lot of fixes and improvements.

    Also, if you don't want to use the new theme available in the themes directory, you can delete that directory and also remove the @import directive from boot.scss, which is

                /* New Theme */
    @import "themes/new-theme.css";
    // @import "themes/minified/new-theme.min.css"; - minified version

    And you're good to go!