hablo/doc/Generating-your-blog.md
2019-04-20 09:54:21 +02:00

2.1 KiB

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.

mkdir 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 but the tags directory itself must exist). Tags live in a subdirectory of articles.

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.

hablo

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.

Now you might wonder how to view your blog in your browser so you can start tuning it. Read about deployment or customization.