Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Collective blog written by developers from Altoros
branch: master

This branch is 7 commits ahead, 54 commits behind Altoros:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


Hi, this is collective blog of developers in Altoros company. This is show cheatsheet for those from you who would like to contribute some contents here. The blog is using jekyll static site generator and hosted at github pages, so please read corresponding resources to you need to learn more.

To be accepted your post should follow these simple rules:

  1. To have name like _posts/%Y-%m-%d-%{slug}.markdown. You can easily create new file with this oneliner:

    $ touch _posts/`date +%Y-%m-%d`-my-cool-post.markdown
  2. To have mandatory YAML header like this:

    layout: post
    title: The Cool Title
    description: Short description of the post
      name: Your Name

    The layout: property is constant, but others you must change. The link: property could be any valid URL which describes your identity better.

  3. If your post is quite long, it will be great if you will hide second part of it on the index page. To do so you should wrap it using <!-- full start --> and <!-- full end -->. For example:

    Bla bla bla...
    <!-- full start -->
    Long body.....
    <!-- full end -->

    In this case the generator will be able to cut this section and hide on index page.

For those who aren't familiar with ruby ecosystem, steps to setup local jekyll site:

  1. Install ruby

    $ sudo apt-get install -y ruby rubygems
  2. Install jekyll and rdiscount

    $ sudo gem install rdiscount jekyll
  3. Fork this repository and clone your fork locally

    $ git clone
  4. Write the post and verify it by spawning local server

    $ jekyll --server
  5. Create a pull request

Something went wrong with that request. Please try again.