After publish your blog, there is still a few things you can do to improve it. These are some of them:
Point your own domain to GitHub pages
This is a must have. Have your own domain is cool. If you don’t like the .github.io at the end of the address bar, you can point your domain to github.
- Create a file named
CNAMEin the root of your repository with the nude name of domain. With nude I mean without
* Configure the DNS in your domain control panel. Make the root domain (the @) point to
220.127.116.11, which is
github’s IP, and the www subdomain to
your-username.github.com. Screenshot from my namecheap configuration.
And wait the dns changes to propagate. For me it took less than 15 minutes but can take much longer.
Add a new page to your blog
The main part of your blog are the posts but with octopress you can create any page or section that makes sense to you. Some ideas: Host the documentation/demo of one of your opensource proyects, an about-me section, a portfolio…
The pages can be places anywhere in the /source folder, but there is 2 main aproaches.
- If you want the url to look like domain.com/about-me you must create a file /source/about-me/index.markdown.
You can use the rake task
- If you want the url to look like domain.com/about-me.html you must create a file /source/about-me.markdown.
You can use the rake task
Creating this page is more or less like build an static html side with some simple suport for layouts and partials. The first lines of each page have some comments to configure which layout you want, enable or disable the footer and more.
Add google analytics
Octopress is the essence of a blog generator. It only server static content, so it don’t provides you an admin area to record and see the trafic and see the stats. This is not a big deal since google analytics is the most powerfull tool you can desire in this area, and octopress has built-in support for it out of the box.
Create a free acount if you don’t have one, and add a New account for your blog. During this process you will get an ID number like AB-12345678-9.
Go and edit your the config file and add this id to the google analytics key.
1 2 3 4 5 6
Basic SEO considerations
First of all, I need to say that I am NOT a fan of SEO. In fact, for me is the biggest lie of the modern times, but still there is a few good practices that you should follow to help google to do its job.
Keywords & description
You should add keywords for your blog and for every post you create. This keywords will help google to know for what searches your content can be a good result, so pick the words wisely. Think about the words you would type in google to find your own article, but pick just half a docen.
By example, the previous post could have these keywords: tutorial,create,octopress,2.1,host,github pages,deploy
The description is also important for google, since it’s the phase that will show under the link when this blog post is listed as a search result.
You can these information in the comments section at the beginning of each .markdown file, like the posts.
1 2 3 4 5 6 7 8 9
The keywords and the description will be added automatically to the
But there is still a things that can be improved. At the time of writting this, the description was missing in the posts, and there is no keywords for the blog level. A few lines fixed that problem.
1 2 3 4 5 6 7 8 9 10 11 12 13
The general keywords and description for your blog should be placed in _config.yml
Categorize your posts
Don’t forget to add a category (or categories) for each post. Users will be able to find related posts and google will apreciate also this information.