Getting started: Octopress powered and Github hosted blog
There are various blogging sites like blogspot, wordpress, posterous, and many more.
Each has their own pros and cons and none of the engine gives us full power of ehhance our blogging experience.
Anyone who has atleast some technical knowledge can start with octopress powered blog. This gives us the power of freedom of doing anything.
So, Lets first understand about octopress framework and its features.
Octopress is a framework designed by Brandon Mathis for Jekyll, the blog aware static site generator. If you wanted to know more then it can be found here
1. Before starting make sure you have git installed.
If not then do install using,
2. Install ruby 1.9.3 or higher
Make git clone of octopress source code
Installing Octopress theme
Install the default Octopress theme using
In order to install custom themes,
Please browse through themes and make a selection for your blog.
Once choice is made, you need to do git clone of theme source and install it.
To genrate infrastrcture for your blog i.e. layouts, js and css
Edit _config.yml to configure blog title, header, metadata, plugins and 3rd Party Settings.
more on configurations can be found here.
We are almost done, and now ready to create our first blog post -
Now you can open a post inside editor and change as you wanted. More on writing markdown can be found here and here too
Well ! Now its time to see, how our blog looks like -
Visit browser http://localhost:4000 and you should be seeing blog running there :-)
There are ways to deploy octopress blog. You can either deploy this blog on heroku or on github using github pages.
As heroku provides free hosting (1 node) you may want to deploy at heroku.
More on this deployment can be found here
2. With Github Project Pages:
Github provides free static website hosting using github pages and deployment is also very simple.
Note: You should have a github repository called username.github.io
Visit http://username.github.io to see your blog hosted on github.
Also, do not forget to commit and push your source code on github.
Adding custom domain
First create a CNAME file and add naked domain name to it.
Then goto your domain provider website and point your domain i.e A record to github ip address 126.96.36.199.
## Adding subdomain
If you want to point subdomain to github blog then -
then go to your domain provider website and create a CNAME record for your subdomain i.e. blog pointing to yourname.github.io.
If you want more help on this then please see here and also here