Table of Contents
Generating your blog
Ok, let's start your blog ! Create a directory for it and go inside it.
mkdir "Turtles paradize" cd "Turtles paradize"
Apparently it's a blog about turtles. It's empty right now, let's create a directory for your articles.
You could call it something else but that's the name
hablo expects it to be. Well let's write an article then !
cat > articles/Olive\ ridley\ sea\ turtle.md <<EOF # Olive ridley sea turtle I love Olive ridley sea turtles ! They are so cool and big and wow ! EOF
Ok, ok, not everyone uses heredocs to write their articles. Personally I don't. You're writing a blog so you probably already have a favourite text editor; use it. The only thing I care about is, at this point, that you've created the file
Olive\ ridley\ sea\ turtle.md in the
articles directory with some markdown content in it.
Ready ? Good news, we're almost done. The only thing left is to tag your first article. With hablo articles don't have to be put in a single category but they can be tagged this and that to indicate that they are somehow linked to one topic or another (they don't have to, you can perfectly leave an article untagged). Tags live in a subdirectory of
mkdir -p articles/tags/Sea\ turtles
You tag an article by putting a symbolic link to it in the tag folders of your choice.
ln -s ../../Olive\ ridley\ sea\ turtle.md articles/tags/Sea\ turtles
All that's left is to call hablo to look at your blog and do its job.
Yay !! Congratulations, you've successfully generated your first blog with hablo. Look, there are now HTML files and a JS directory in your
Turtles paradize blog directory.