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.
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.
Ruby programming language installed - you can find it at https://www.ruby-lang.org/;
the SASS Gem - you can find it at http://sass-lang.com/.
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:
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:
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;
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!