Skip to content
This repository has been archived by the owner on Feb 7, 2024. It is now read-only.

blablacar/blablatech

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BlaBlaTech

BlaBlaCar's Tech Blog — all BlaBlaCar Techies are invited to participate :)

We use Jekyll for the blog, an easy-to-use way of transform plain text into blogs posts. Posts are written in markdown, it could not be easier!

Installation

  • You need a local webserver in order to run and test the blog
  • Clone gh-pages on your machine and configure your localhost accordingly
  • Install Jekyll and the required plugins
    $ gem install jekyll
    $ gem install jekyll-redirect-from
    $ gem install jekyll-paginate
    $ gem install rdiscount
  • Then, launch it locally with build / serve:
    $ jekyll build
    $ jekyll serve
  • Warning: commits to gh-pages are immediately live

Tips & Tricks

  • Add new authors in the _config.yml, it's as easy as this
  • Posts are written in Markdown, can it be any easier?
  • Posts (.md files) are to be saved in _posts, with the following format: 2011-12-31-new-years-eve-is-awesome.md
  • Posts should be tagged, for instance "Culture", "Tech", "Conference", ...
  • Images that belong to a post go into images, prefixed with the posts's date (e.g. 2011-12-31-happy.png)
  • Drafts should end up in the folder _draft, without a prefixed date (e.g. new-years-eve-is-awesome.md)
  • If you create a new tag you also need to create the according html file in blog/tag to have a working archive
  • Use the _drafts folder to prepare your post before publishing
 jekyll serve --drafts