HowTo Add a post

Before adding a post, you need to create a github account. Basically any one needs to contribute the project must fork the project to their repo and make changes to their repo and finally rising a pull request to the base repo. This is a step by step guide how to add a post in http://thamizha.github.io

Step 1 – Forking the main repository

First you need to login to the github. Then navigate to http://github.com/thamizha/thamizha.github.io. You will be arrived in to the following page. Then click on the “Fork” button. This will fork the project to your account.(Forking is nothing but you are copying the files to your account. )

Step 2 – Opening the forked repository

After forking the repository, all the files have been copied to your repository. Now you will be having write access to the forked repository, where you can add the posts. Now, click on the “_posts” folder in the forked repository.

Step 3 – Creating a new post

The files inside the _posts folder will be listed like this. Click on the “+” icon next to the breadcrumb. Now get ready for adding a new post.

Step 4 – Adding content

Now you will arrive at the online editor. Better use a modern browser like Mozilla Firefox or Google Chrome to make this edit. :) There are some standards need to be followed. First one, the name the file should be in the format YYYY-MM-DD-title.md.

For eg., 2013-03-10-thamizha-cd-released.md

Note the “.md” extension. Then the layout information needs to be added. The syntax for this is,

---
layout: post
title: Title of the page
tags:
- tamil
- how to page	
---

If you have any doubts in this, better you can copy and paste it from an existing file. Then you can add the content as need. You can use github flavored makdown for the page.

Step 5 – Commiting the file

After finishing editing the page, you need to commit the file into the repository. Please give a brief description about the post you have added here and then click the “Commit New File”

Step 6 – Making a Pull request

After adding all the posts you need to give a pull request to add the files in your repository to the main repository. Click on the “Pull Request” button to make a pull request.

Once the pull request has been given, the changes are reviewed by our team, and then if it is accepted it will be merged into the main repository. Once it has been merged, it will be made available in http://thamizha.github.io as per the release schedule.