Are you happy with your logging solution? Would you help us out by taking a 30-second survey? Click here


Statistics on techblog

Number of watchers on Github 14
Number of open issues 0
Main language JavaScript
Average time to merge a PR about 17 hours
Open pull requests 1+
Closed pull requests 3+
Last commit about 2 years ago
Repo Created over 6 years ago
Repo Last Updated over 2 years ago
Size 74.6 MB
Organization / Authorbadoo
Contributors14
Page Updated
Do you use techblog? Leave a review!
View on github
Fresh, new opensource launches 🚀🚀🚀
Trendy new open source projects in your inbox! View examples

Subscribe to our mailing list

Evaluating techblog for your project? Score Explanation
Commits Score (?)
Issues & PR Score (?)

Badoo Tech Blog

This is the source code for the Badoo Tech Blog, it is built using Jekyll.


Getting Set Up

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

Contributing a Post

Environment

The tech blog is built using Jekyll. So you need to install the ruby gem if you don't have it in your computer:

gem install jekyll

Furthermore, we use Less preprocessor, so you will also need to install it. The easiest way:

npm install -g less

Then 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.

Your first post

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.


Running Locally

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.


Post Titles and Dates - Very Important!

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.

techblog open issues Ask a question     (View All Issues)
  • almost 6 years fixed-headers-in-mobile-webapps
techblog open pull requests (View All Pulls)
  • Fixed sidebar position
techblog list of languages used
Other projects in JavaScript