Octopress est un framework utilisant Jekyll, le générateur de blog statique utilisé sur les pages Githubs Il vous évite d’avoir un hébergement compliqué. Le dynamisme est obtenu côté client. Vous pouvez rajouter la gestion de Twitter, de Github, de StackOverflow. Pour les commentaires ,vous passez par Disqus, un service tiers ou par une application comme Juvia. Ce post vous permettra d’aborder rapidement l’installation d’Octopress.

Prérequis

Octopress s’appuyant sur Ruby et RVM, il faut installer les deux.

On commence par installer RVM qui permet d’installer séparément des librairies pour gérer des environnements par projet.

1

bash -s stable < <(curl -s https://raw.github.com/wayneeseguin/rvm/master/binscripts/rvm-installer)

Ensuite, on rajoute RVM à notre shell avec

1
2

echo '[[ -s "$HOME/.rvm/scripts/rvm" ]] && . "$HOME/.rvm/scripts/rvm" # Charge la function RVM dans ~/.bash_profile
source ~/.bash_profile

On installe Ruby 1.9.2 et on met à jour RubyGems (qui sert à installer des librairies par un système de paquets)

1
2

rvm install 1.9.2 && rvm use 1.9.2
rvm rubygems latest

Il faut aussi Git : il est nécesssaire pour récupérer les sources et le but est de pouvoir versionner le blog également. Allez sur cette doc d’installation pour en savoir plus.

Octopress

On arrive à ce qui nous intéresse directement : l’installation d’Octopress.

Pour cela, rien de plus simple, exécuter les instructions ci-dessous.

1
2
3

git clone git://github.com/imathis/octopress.git octopress
cd octopress    # Il faudra confirmer qu'il faut faire confiance au fichier .rvmrc en répondant "yes").
ruby --version  # Doit renvoyer Ruby 1.9.2

Ajouter les paquets associés

1
2
3

git clone git://github.com/imathis/octopress.git octopress
gem install bundler
bundle install

Vous avez Octopress d’installé. Vous pouvez customisé à fond votre blog. Pour notre part, nous avons utilisé quelques astuces ci-dessous.

Les plugins et autres paramétrages customisés

Support du rst (ReStructured Text)

Un plugin est disponible pour transformer le rst directement dans Jekyll/Octopress Allez sur Github pour le récupérer et voir comment l’installer.

Pour le moment, nous n’avons pas réussi à obtenir un résultat satisfaisant: les accents ne marchent pas et font planter la génération html. Le plugin utilisé en Ruby (reposant sur RbST et “wrappant” rst2html.py) semble être le responsable car l’usage de rst2html.py directement par Python est ok. Ayant besoin de basculer mes écrits sur Sphinx, j’envisage de passer par Pandoc pour pallier àce problème en attendant de le résoudre.

Multiplication des flux RSS / Atom par catégories

Nous avons utilisé l’astuce mentionné sur ce blog anglophone Il suffit de copier le snippet proposé et de remplacer la chaîne “emacs” par votre catégorie.

D’autres compléments sont à venir sur Octopress