Grognon <Qlam/>

More is less

Qlam

Introduction

Qlam est une application qui sert à maintenir un blog. Elle utilise un langage de balisage léger pour l'édition du contenu. Elle offre aussi la possibilité d'organiser les pages du site et la navigation entre ces pages. Qlam n'utilise pas de base de données, ni de langage sur le serveur. Il produit donc des pages HTML purement statiques.

Accessoirement Qlam peut servir à rédiger son courrier.

Ce logiciel s'adresse à des personnes qui ont quelques notions de html et de css.

Vue rapide

Un simple éditeur de texte (1) suffit pour rédiger les pages en balisage léger. Pour avoir une bonne idée de ce langage jetez un œil sur la documentation et parallèlement éditez son source doc.qlm. (clic droit, enregistrez la cible, puis ouvrez-le fichier avec un éditeur)

De façon elliptique Qlam peut :

Il existe aussi un résumé qui tient sur une seule page A4.

Haut de page

Installation

Installation pour tous les utilisateurs

Copier le fichier exécutable qlam dans /usr/share/bin`

Installation pour un seul utilisateur
  1. Créer, s'il n'existe pas déjà le répertoire ~/.local/bin
  2. Copier l'exécutable qlam dans ~/.local/bin
  3. Ajouter ou compléter dans ~/.bashrc à la ligne PATH $HOME/.local/bin.

On devrait avoir quelque chose qui ressemble à ça (2):

export PATH="$HOME/.local/bin:/usr/local/bin:/usr/bin:/bin"

Arborescence conseillée pour un site en local

site
├── css  feuilles de style   *.css
├── doc  documents           *.pdf, *.tex, etc.
├── img  images              *.gif, *.jpg, etc.
├── js   scripts javascripts *.js
└── qlm  fichiers sources    *.qlm

Haut de page

Utilisation

Premiers pas

Comme avec les autres outils de création de site, l'initialisation est la partie la plus fastidieuse. Pour faciliter cette étape commencez par créer un dossier qui contiendra le site local, puis en vous mettant dans ce dossier, tapez :

wget arad.free.fr/qlam/site/doc/lsite
chmod +x lsite
./lsite

Remplacez le logo du site favicon.png par le votre.

Si les styles vous conviennent, passez à menu.

Pour modifier les styles, vous avez deux possibilités

Les styles par défaut vous conviennent à peu près
Gardez la feuille style.css
Créez une nouvelle feuille, (par exemple css/perso.css)
Ecrasez dans cette feuille les styles que vous voulez modifier.
Ajoutez au fichier qlm/entete.qlm après la ligne #style style.css une ligne #style perso.css.
Les styles ne vous conviennent pas
Créez votre propre feuille en remplacement de css/style.css.

Haut de page

Menu

Si vous utilisez votre site comme un blog, supprimez la balise #menu de vos fichiers qlm et passez cette étape.

Le fichier qlm/menu.qlm contient le menu du site sous forme de liens Qlam. Par exemple, dans [Acceuil->index.html] c'est [Acceuil] qui apparaîtra dans le menu et c'est le fichier index.html qui sera chargé. Vous garderez peut-être cette rubrique, mais vous modifierez les deux autres, et peut-être en rajouterez-vous.

Pour chaque rubrique sauf l'accueil, il faudra créer une page rubrique.qlm qui contiendra les liens vers les articles de la rubrique et une introduction. Exemple, jetez un œil sur le fichier exemple de Rubrique1.qlm

Rédaction d'un nouvel article

  1. Placez-vous à la racine du site local et ouvrez votre éditeur de textes.
  2. Insérez le fichier entete.qlm.
  3. Ajustez les arguments.
  4. Editez votre article
  5. Quittez l'éditeur et lancez la commande qlam article
Remarque

Dans vim on peut sans quitter vim lancer la commande :

:!qlam %<

ou mapper une touche pour cette commande

Haut de page


Notes
(1)

Il existe un fichier de coloration syntaxique pour vim qlam.vim et une ébauche pour gedit/mousepad qlam.lang.

(2)

Il est utile d'avoir dans son home un dossier bin et de l'inclure dans son path. Cette facilité permet d'appeler les exécutables de n'importe où.


Réalisé avec Qlam - LGPL