Makefly : utiliser et configurer ce CMS

Octobre 2015

Voici quelques notes sur le CMS Lua "makefly" (qui est moteur de blog). Ce logiciel permet de créer un site Internet statique : des pages HTML sont générées et on a pas besoin de traitement côté serveur pour les servir.

Makefly a la particularité d'utiliser le langage de programmation Lua. Cet article est basé sur la version 0.4 de Makefly.

Installation de Makefly

Pour l'installer, il est nécessaire d'avoir Lua 5.1 et Lua filesystem.

Vous pouvez installer ces dépendances sur une machine linux Ubuntu à l'aide de ces commandes :

sudo apt-get install lua5.1
sudo apt-get install lua-filesystem

Ensuite, vous pouvez cloner le répertoire github de développement : https://github.com/blankoworld/makefly

Ou alors télécharger la dernière version stable depuis le site Internet du projet : http://makefly.depotoi.re/.

La première chose à faire est de faire une bonne configuration. Pour cela il faut modifier le fichier makefly.rc en s'inspirant de makefly.rc.fr.example.

Vous pouvez aussi directement écraser le fichier de configuration par défaut à partir de l'exemple :

cp makefly.rc.example makefly.rc

Configuration

Vous pouvez maintenant modifier le fichier makefly.rc à votre convenance. Voici à quoi correspondent les paramètres de ce fichier :

BLOG_TITLE = Titre de votre blog
BLOG_SHORT_DESC = Description de votre blog 
BLOG_DESCRIPTION = Description plus longue de votre site...
BLOG_LANG = fr
BLOG_CHARSET = UTF-8
BLOG_URL = http://localhost/makefly
INSTALLDIR = /var/www/html/makefly
RSS_FEED_NAME = Flux RSS de votre site
MAX_POST = 2
AUTO_EDIT = 1
DATE_FORMAT = %d-%m-%Y à %H:%M
SHORT_DATE_FORMAT = %m/%Y
SIDEBAR = 0
SEARCH_BAR = 0
MAX_RSS = 8
ISSO = 0

Le plus important est de modifier les paramètres BLOG_TITLE, BLOG_SHORT_DESC et BLOG_DESCRIPTION. Il y a aussi le paramètre BLOG_URL dans lequel vous devez indiquer à quelle url on va trouver votre site.

Maintenant que votre fichier de configuration est terminé, vous pouvez exécuter cette commande qui va créer le site :

./makefly clean && ./makefly compile

La première commande supprime tout l'existant et la deuxième créée le site. C'est cette commande que vous pourrez utiliser à chaque fois que vous ajouterez un billet à votre blog.

Vous pouvez rencontrez cette erreur :

"lua: ./makefly:66: invalid escape sequence near '\.'"

Cela signifie que votre version de Lua n'est pas correctement paramétrée pour utiliser lua5.1.

Dans ce cas, tapez la commande suivante dans votre terminal :

lua -v

Si vous avez autre chose que la version 5.1 alors il faudra faire quelques changements. Par exemple, j'ai cela qui s'affiche :

Lua 5.2.3  Copyright (C) 1994-2013 Lua.org, PUC-Rio

Donc ce n'est pas correct puisque c'est Lua 5.1 qui doit être utilisé. Après vérification sur mon système je vois que la bonne commande est lua5.1 et non lua.

Du coup, j'ai plusieurs solutions pour résoudre ce soucis :

créer un alias : mais dans ce cas tous mes programmes Lua vont utiliser la version 5.1
modifier la version de Lua du script makefly

J'ai décidé de modifier la version Lua du script Makefly pour que cela fonctionne. Rassurez vous c'est tout simple.

Ouvrez le fichier 'makefly" dans votre éditeur de texte favori et repérez la première ligne :

#!/usr/bin/env lua

Il suffit de changer "lua" par "lua5.1". Une fois que c'est terminé, vous pouvez sauvegarder le fichier et relancer la génération de la documentation.

Installation sur votre serveur

Si vous avez réussi à aller jusque ici, vous pouvez maintenant installer directement le site sur votre serveur grâce à la commande :

./makefly refresh && ./makefly install

Attention : cette commande va supprimer tout ce qui se trouve dans le répertoire indiqué au paramètre INSTALLDIR de votre fichier .

INSTALLDIR = /var/www/html/makefly

Après l'exécution de cette commande, vous aurez votre site au bon endroit sur votre serveur et vous pourrez y accéder via votre navigateur.

Ajouter un nouveau billet

Vous pouvez ajouter un nouveau billet de blog via cette commande :

./makefly add

Conclusion

J'ai un peu utiliser Makefly pour un projet personnel et je suis assez content du résultat. Mon seul problème vient du fait qu'il est assez ennuyeux de modifier l'url d'une page ou son contenu : il faut fouiller dans l'arborescence pour retrouver les éléments et les modifier.

Ceci étant dit, pour un usage simple et la tenue d'un petit blog, c'est outil pratique, rapide et léger. Si vous avez quelques connaissances en commandes Linux ou en programmation Lua c'est encore mieux !

Pour d'autres articles, cliquez ICI.