I finally decided to establish my own blog. Sometimes there is something to write, so it is good to have a place where to put texts.
I knew about Octopress for some time, so to start actually using it, all that was needed is a good manual. Found this one: Tutorial: Create a Blog With Octopress and Host It in Github Pages
It explains what is Jekyll, what is Octopress, and provides step-by-step guide how to install and start using it.
No need to repeat here the whole manual, so I’ll just give a short excerpt (with my username and my site address).
Setting up the blog
1 2 3 4 5
It is good to save work by commiting it back into repository, so I’ll do it, step by step
Next step is to provide some basic configuration
Will show it in the diff:
1 2 3 4 5 6 7 8 9
And blog setup is done!
The first article
categories: of generated article is empty. I’ve decided to put
[octopress,github pages] there and then commited the article.
Then I’ve run
… and got nothing. Actually, it was a blank page. And no error was displayed. Did not know what to do with that yet, moved to the next step.
Deploying to Github Pages and fixing the error
First, I created repository named
denispeplin.github.io. Then run
1 2 3 4 5
After executing these commands, my sources was on the
source branch as expected, but on the
master branch was only
screen.css file, and so 404 error was displayed on http://denispeplin.github.io page.
After some research, I’ve found that it is also possible to run
Finally, this command provided what I was searching for: a good error message.
1 2 3
It became obvious, that I forgot to put space between
categories: keyword and actual categories list. So this is the fix:
Re-generate and re-deploy again
And now the blog is up and running!
All is left to do it to fill the article with an actual content. First, I’ve put commands, that I used, to the source file, then commited it, and postponed the text for the next eveining (wnich is today at time of writting).
It is good to remember some
Markdown to write nice looking article.
And for deploying and source pushing, there is a hint: use
ssh-add to input ssh keyword only once.