9 nov. 2020

Accueil Qlam

Introduction

Qlam est une application qui sert à éditer et 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 :

• Employer des styles typographiques (^Bgras^B, ^Aitalique^A, etc.).
• Organiser la page en sections (titres, sous-titres, div, ...).
• Faire des listes (numérotées, à puce et en définition).
• Créer des tables.
• Ajouter des liens hypertexte ou des notes de bas de page.

Il existe aussi un résumé qui tient sur une seule page A4.(cheat sheet)

Premiers pas

Le plus rapide pour essayer qlam est de télécharger l'application et le dossier contenant le site de démonstaration :

mkdir qlam
wget http://arad.free.fr/qlam/site

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
├── doc     documents           *.pdf, *.tex, etc.
├── img     images              *.gif, *.jpg, etc.
├── script  javascripts         *.js, *.py etc.
└── qlm     fichiers sources    *.qlm, *.css, *.html

Seul le dossier qlm est requis. Il contient le fichiers sources *.qlm les fichiers styles *.css et éventuellement des fichiers inclus au format html.

Utilisation

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.

Menu

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

Le fichier qlm/header.html contient la barre d'entête des pages du site. 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

Notes