This is the source code for the Badoo Tech Blog, it is built using Jekyll.
First fork the badoo/techblog repository on GitHub.
Then clone your fork of the project locally by running the following command, with <yourusername>
replaced with your GitHub username:
git clone git@github.com:<yourusername>/techblog.git techblog
Then move into the techblog directory and add the original repository as a remote:
cd techblog
git remote add upstream git@github.com:badoo/techblog.git
First make sure there is a nice picture of you in the images/authors/ directory. If your name is "Joe Bloggs" then there should be a file called "joe-bloggs.jpeg". It MUST be a 200x200px .jpeg file.
Assuming you want to write a new post with a title of "I am awesome", first make sure you are in branch master and have pulled from upstream, then create a new branch.
git checkout master
git pull upstream master
git checkout -b i-am-awesome
Create a file in the _posts directory in the format: 2013-06-13-i-am-awesome.markdown
At the top of the file you need to include a YAML front-matter block like this:
---
layout: post
title: I Am Awesome
author: Joe Bloggs
date: 2013-06-27
categories: javascript css
---
This post has two categories, javascript and css. Categories must be lowercase and a single word. A post MUST have at least one category. Also please note that these are categories, not hash tags.
So the rules for making new categories are as follows:
- If the category is of a major technology or language (e.g. php, css, java)
- If not then the category should have at least two articles written for it else it should go under miscellaneous
The body of a post is written in standard Markdown with the exception of code blocks, which should be included like this:
{% highlight java %}
public static String getName () {
return "Bob";
}
{% endhighlight %}
You must specify the language, any of the following are valid:
- javascript
- java
- html
- css
- obj-c
- sh (Bash scripts or terminal commands)
When you are done and have committed all your work, push your branch to your forked repository.
git push origin i-am-awesome
Submit a pull request back to the origin repository and someone (or lots of people) will review it and maybe make some comments. When everybody is happy your pull request will be merged and will be live on the site when the next release is done.
To run a local version of the blog you need to install Jekyll, which is a Ruby gem. If you are running Windows see this blog post for instructions on how to set it up.
If you are on Mac OSX then run the following command. It will take a few minutes to install.
gem install jekyll
Then from the root of the techblog directory run:
jekyll serve --watch
Now go to http://localhost:4000 in your browser. The --watch
flag means that Jekyll will rebuild the project when you make a change to any file.
Once a post has has gone live DO NOT CHANGE THE TITLE OR DATE. If you do the link will change and then the internets will have broken links and everyone will be sad.