Ludovic ROLAND

Blog technique sur mes expériences de développeur.

Octopress : ajouter des articles connexes à votre blog

10 mars 2014

Ma série d’articles sur Octopress continue ! Pour rappel, jusqu’aujourd’hui, nous avons vu comment créer son blog Octopress et y écrire du contenu. Dernièrement, nous avons également vu comment migrer le contenu de votre ancien blog Wordpress vers nouveau blog Octopress.

Dans ce nouvel article, qui sera très court, je vous propose de voir comment ajouter des articles connexes sur notre blog.

Comment faire ?

Bien évidemment, nous pourrions coder nous-même une extension en Ruby pour sélectionner une liste d’articles à afficher à la fin d’un article, mais ce n’est pas ce que nous allons faire et ce pour les raisons suivantes :

  • je n’aime pas réinventer la roue ;
  • je suis incapable d’écrire une ligne de code en Ruby !

Nous allons donc utiliser un petit plugin déjà tout prêt et nous contenter de l’intégrer à notre blog.

Le plugin

Pour faire très simple, le plugin se base sur les catégories des articles pour sélectionner les articles connexes à afficher. Simple mais efficace !

Téléchargement

Pour débuter, rendez-vous sur la page GitHub du plugin et enregistrez sur votre ordinateur le fichier connexe_tag.rb :

Installation

Pour “installer” le plugin, il convient tout simplement de déplacer le fichier connexe_tag.rb fraîchement téléchargé dans le dossier pluginbs d’Octopress.

Utilisation

Le plugin s’utilise très simplement puisqu’un simple tag suffit :


{% connexe %}

Le rendu graphique est visible à la fin de cet article.

Configuration

Finalement, sachez qu’il est possible de personnaliser 2 éléments du plug-in :

  • le titre de la section des articles connexes ;
  • le nombre d’articles maximum à afficher.

Pour configurer le plug-in, rendez-vous dans le fichier _config.yml de votre dossier Octopress puis ajouter :

  • connexe_title pour personnaliser le titre de la section ;
  • connexe_maximum pour personnaliser le nombre d’articles.

Par exemple :

connexe_title: "A lire aussi..."
connexe_maximum: 5

Commentaires