9 nov 2020

Documentation de Qlam

Documentation

Table des matières

Styles typographiques

Les styles de caractères disponibles sont

Italique
Saisie : ^Aitalique^A
Résultat : italique
Gras
Saisie ^Bgras^B
Résultat : gras
Souligné
Saisie ^Usouligné^U
Résultat : souligné
Code
Saisie : ^Cfind /usr/share/ -name "c.vim"^C
Saisie : find /usr/share/ -name "c.vim"
Encadré
Saisie : ^KCtrl^K
Résultat : Ctrl

Remarque : Les caractères ^A, ^B, ^C, ^U, et ^K s'obtiennent sous linux par, respectivement Ctrl-V Ctrl-A, Ctrl-V Ctrl-B, Ctrl-V Ctrl-C, Ctrl-V Ctrl-U, Ctrl-V Ctrl-K.

Ces styles peuvent être imbriqués. Le code :

Normal ^Aitalique ^Bgras et italique^A gras^B normal

donnera :

Normal italique gras et italique gras normal

Remarque : On peut modifier ces styles par des feuilles css.

Table des matières

Titres

En html il existe six niveaux de titres nommés <h1>, ..., <h6>. La balise Qlam pour les invoquer est du type #1, ..., #6. En plus Qlam crée une ancre de même nom. Exemple le titre de ce pargraphe a été codé ainsi :

#3 Titres

Ce code est un raccourci pour :

<a id="Titres"></a>
<h3>Titres</h3>

Comme pour tous les éléments de la page, on ajuste les styles de présentation à son goût dans la ou les feuilles css.

Remarque : Pour que l'uri soit valide Qlam remplace les espaces par "%20", et supprime les foutus accents. L'utilisateur n'a pas à s'en préoccuper.

Table des matières

Listes

Trois types de listes sont pourvues :

  1. les listes à puces,
  2. les listes numérotées
  3. les listes en défition.

Une liste est initiée par une ligne qui débute par -, + ou ?.

Listes à puces

Code :

- Ligne 1
- Ligne 2
- Ligne 3

Résultat :

Listes numérotées

Code :

+ Ligne 1
+ Ligne 2
+ Ligne 3

Résultat :

  1. Ligne 1
  2. Ligne 2
  3. Ligne 3

Listes imbriquées

On peut imbriquer des liste en plaçant des tabulation au début de la ligne : Une tabulation par profondeur d'imbrication.

Code:

- Ligne 1
	+ Ligne 11
	+ Ligne 12
	+ Ligne 13
- Ligne 2
- Ligne 3

Résultat :

Listes en définition

Code :

? Mot 1
	Définition de : Mot 1
? Mot 2
	Définition de : Mot 2

Résultat :

Mot 1
Définition de : Mot 1
Mot 2
Définition de : Mot 2

Table des matières

Tables

Code

#table
Décimal|Français|English
1      |un      |one
2      |deux    |two

L'alignement des caractères délimiteurs n'a aucune importance. Il peut ajouter au confort pour le rédacteur.

DécimalFrançaisEnglish
1 un one
2 deux two

La balise #table accepte des arguments comme

Table des matières

Code

Un style en ligne particulier est :

Code
S'obtient avec ^C<code>^C
Résultat : <code>

Ce style utilise une police à chasse fixe (monospace).

Une variante de style sous forme de bloc de code (balise html <pre>) est la suivante. Elle commence par la ligne #code et se temine par une ligne vide.

Exemple ::

#code
#!/usr/bin/env python3
from math import sqrt # racine carrée
def diviseurs(a):
	L = []
	for n in range(1, int(sqrt(a)) + 1):
		if a % n == 0:
			if n == a//n: 
				L.append(n)
			else: 
				L.extend([n, a//n])
	L.sort()
	return L

va donner :

#!/usr/bin/env python3
from math import sqrt # racine carrée
def diviseurs(a):
	L = []
	for n in range(1, int(sqrt(a)) + 1):
		if a % n == 0:
			if n == a//n: 
				L.append(n)
			else: 
				L.extend([n, a//n])
	L.sort()
	return L

Remarque : On peut fournir à la balise #code un argument qui permet mettre en gras les mots clés d'un langage, et les commentaires et les chaines de caractères en italiques. Exemple :

#code c
// ctrl-A, ctrl-B, ctrl-C
for(int i=0; i<4; i++)
	printf("i: %s; ^%c", i, i + 'A');

Affichage html

// ctrl-A, ctrl-B, ctrl-C
for(int i=0; i<4; i++)
	printf("i: %s; ^%c", i, i + 'A');

Voir les fichiers c.kwds, cpp.kwds, js.kwds, bash.kwds et html.kwds. On peut en rajouter.

Table des matières

Liens

Ancre

On ajoute une ancre avec le code #: ancre affichage.

Exemple

#: ancre ici

Résutat:

ici

Les liens de ce document vers le haut de la page sont codés ainsi :

[Table des matières->#top]

Liens

Liens internes au document
Syntaxe : &lsqb;Table des matières->#top]
Résultat : Table des matières
Liens internes au site
Syntaxe : &lsqb;Retourner à l'acceuil->index.html]
Résultat : Retourner à l'acceuil
Lien externe
Syntaxe : &lsqb;Voir le site grognon->http://arad.free.fr]
Résultat : Voir le site grognon

Note de bas de page

Les notes de bas de page sont des liens particuliers dont la syntaxe a été simplifiée. Dans le texte on réalise un renvoi en bas de page avec le code <a class="nte" href="#1">(1)</a>. Essayez (1)

La note de bas de page proprement dite se fait avec une balise #note suivie du numéro de la note. Une ligne vide clos le texte de la note. Exemple :

#note 1
Ceci est une balise note de bas de page.
 

En fait la balise #note x ajoute le code suivant :

<a id="x">(x)</a>
<div class="note">
....
</div>

Le contenu de la note de bas de page doit se terminier par une ligne vide.

Table des matières

CSS

On peut charger dans l'entête du document autant de feuilles css qu'on le souhaite. En cas de conflit la dernière recouvre les précédentes. La balise pour charger une feuille css est :

#style perso

Elle est un raccourci de la balise html :

<link rel="stylesheet" href="qlm/perso.css">

Les styles définis dans les pages css peuvent être utilisées soit pour surcharger les styles par défaut, soit pour définir des styles particuliers pour les balises bloc : #code, #div, #table.

On peut aussi écrire à tout moment du code html et faire appel au css.

Exemple :

<div class="truc">
... <span class="emph"> .. </span>
</div>

Table des matières

Javascript

On peut invoquer du javascript soit directement en place soit à partir d'un fichier externe.

Javascript en ligne

Exemple :

#js 
var now = new Date();
var h = now.getHours();
var m = now.getMinutes();
var s = now.getSeconds();
document.write('Il est ' + h + ':' + m + ':' + s); 

Ce petit javascript va afficher l'heure :

Inclure un script à partir d'un fichier

Une autre façon d'insérer un script à partir d'un fichier externe. Ici un fichier date.js a été préparé dans le dossier script. C'est le même script que ci-dessus. L'argument de la balise #js est le nom du fichier, sans indication de du dossier script.

#js date.js

Le résultat est ici :

Cette balise correspond à

<script src="script/date.js">

Cette balise peut être utilisée dans l'entête, généralement pour inclure une librairie javascript comme par exemple LaTeXMathML.js

Table des matières

Entête

L'entête est placée au début du fichier. Cette entête constitue le &lt;head&gt; du fichier html. Elle peut comprendre

Table des matières

Divers

Inclure du html

Il existe deux balises d'inclusion de code html :

Inclure tout un fichier
#inchtml fichier

Va inclure dans le document à l'endroit où est placée la balise, le contenu d'un fichier. Peut-être utile pour inclure des bouts de code utiles à certaines pages du site.


(1)

Ceci est une balise note de bas de page.

Revenir à Note de bas de pages





Réalisé avec Qlam - LGPL