Artica's Website

Last update: Tue Sep 8 10:38:59 WEST 2015

This is the new Artica's website built around Jekyll and GitHub pages.

Setting up your environment

Before you start editing and modifying this website, you need to install a few tools first.

You will need a GitHub account and familiarity with git and its basic operations. If not, please take 30 minutes and read this Guide and these Pages.

You should start by cloning this repository in a local folder of your choice.

git clone git@github.com:Artica/website.git ~/Documents

Congratulations! You just cloned this repository to ~/Documents/website.

You now have a local copy of our website on your computer that you can edit and browse.

Jekyll

Artica's website uses GitHub Pages, which runs with Jekyll. Jekyll is a simple, blog-aware static site generator.

Please follow these steps to install Jekyll on your Mac computer:

sudo gem update --system
sudo gem install jekyll

Note that using sudo, you will be asked for you password.

For more information on getting started with Jekyll, check this page.

Jekyll uses the Liquid templating system.

Please follow these steps to install Jekyll on your Windows computer:

• Install Python 2.7 on C:\Python27 (make sure it's on path)
• python -m pip install -U pip setuptools
• Install Ruby 2.2.3 on C:\Ruby22-x64 (don't forget to tick the box to add it to path)
• Install RubyDevKit on C:\RubyDevKit
• cd C:\RubyDevKit
• ruby dk.rb init
• make sure config.yml includes path to C:\Ruby22-x64
• ruby dk.rb install
• python -m pip install Pygments
• gem install jekyll
• gem install jekyll-paginate
• gem install redcarpet

Running the website

Running your local copy of the Artica's website couldn't be easier. Open a terminal window and type the following:

cd ~/Documents/website
jekyll serve

At this point, you should see something similar to this:

$ jekyll serve 
Configuration file: ~/Documents/website/_config.yml
            Source: ~/Documents/website
       Destination: ~/Documents/website/_site
      Generating... done.
 Auto-regeneration: enabled
  Server running... press ctrl-c to stop.

Note that the path to the configuration file, source and destination might change depending on where you cloned the repository.

Congratulations! You can open http://localhost:4000 with your favorite browser and browse just as usual. Pretty cool huh?

InK

This website uses InK, a set of tools for quick development of web interfaces. It offers a fluid and responsive grid, common UI elements, interactive components, a design-first approach with ease of use and simplicity at its core. Start integrating Ink into your projects and remove the hassle of building the basics, focusing on what matters.

InK provides modern responsive CSS patterns different devices, which means this website will work well on desktop, phones or tablets.

So, how do I, like, do stuff and all?

Writing a blog post, or changing any section of the website might seem tricky at first. But as soon as you get comfortable with git, [Jekyll] 7, [Liquid templating] 8 and [Ink] 6, you'll find that not only it's easy and simple to operate, but also clean and powerful.

And again, everything is local and static, no external dependencies, databases or dynamic languages to worry about.

So let's get busy. Here are your recipes:

• Writing a blog post