How to make your github static page a blog
So, I was just tired to use wordpress and its very huge do-everything blog engine. I just need something easy to use, the wordpress website don't work nice to create and publish posts when I'm at elinks or lynx. And else, I'm not confortable writing long posts on a small entry-box on a webbrowser. It is not natural for me. Long texts should be written on a text editor (your favorite flavor one).
For that I wrote this very simple blog engine that works statically. What does it means? Once I write a post on my favorite text editor (I use vim when I'm on terminal, sublime othercase) I just tell to my blog engine: "Hey buddy, I have something new! Please, rebuild yourself!" and it is done on my machine, and just once, and I have just created every single page of my blog (with paginator, permalinks, etc.). Now that I have all this, I just have to push it to my static server, and I'm using the github static page for that (as can you see, you are on it right now!).
Creating your own static blog
I'll write soon a tutorial about how to use Speechhub, bu here I can just show some highlights. First of all you must have a static server (just a place where you can store static files, and is accesible for who will read your blog). For this I'm using Github. For more datails take a look here: Pages on github
Now download and install Speechhub. You can find it here: Speech Hub.
Once you have Speechhub installed and you are on your local copy of the repository, create a blog wherever you want (I have created a folder called 'blog' inside my personal page):
$ ls . .. blog/ $ cd blog $ speechhub create-blog --blog-name="The name of my blog"
At this momment you speechhub will create a structure like this one on your blog folder:
.
├── config
├── index.html
├── pages
├── posts
│ └── permalinks
└── static
└── css
Now, to create a new post let's do:
$ speechhub new-post --title "My first post"
Two files have been created inside your posts folder: 'my_first_postdate.md' and 'my_first_postdate.meta.json'. To edit the content of your blog you must edit the markdown file (.md).
Once you have filled the content of your post, let's publish it:
$ speechhub manage --publish-post [path_to_post].meta.json
Now you can push your static blog to your repository (if you are using Github page, just commit and push it).
Tip: Untill I don't publish a full tutorial about Speechhub, try edit the 'config/config.json' file
I hope you liked it
blog comments powered by Disqus