Cet article ne s'applique qu'au champ texte d'une œuvre (works.text).

1. Insertion d'un modèle de ligne titre de chapitre

La procédure la plus simple pour insérer une ligne titre de chapitre ou de sous-chapitre dans le texte d'un article est la suivante :

• pour ajouter une ligne titre à un article, sélectionnez l'œuvre associée en mode gestion, puis passez en modification ;
• placez le curseur là où vous voulez ajouter votre ligne titre de chapitre ;
• dans l'éditeur de texte TinyMCE, ouvrez le menu Insertion, puis choisissez la commande Modèles... ;
• dans la liste déroulante Thèmes, sélectionnez la ligne de titre du niveau souhaité,
  la modèle s'insère alors dans le texte ;
• remplacez enfin le mot Titre par le titre de votre chapitre ou sous-chapitre.

Après rafraichissement ou enregistrement du formulaire, une ancre et le numéro de chaque chapitre est placé entre les signes « = » et « : » de chaque titre.

2. Lien vers un chapitre

Nous avons vu au chapitre précédent, qu'une ancre, c'est-à-dire un point de référence dans une page HTML, est placée automatiquement en début de chaque ligne titre de chapitre ou de sous-chapitre. Cette ancre peut être référencé par un lien sur la même page, sur une autre page du site, voire depuis un autre site.

Pour cela, il suffit de terminer l'adresse cible du lien par un dièse « # » suivi du mot chapter suivi de la numérotation du titre en utilisant le caractère souligné « _ » comme séparatif.

Exemples :

	lien interne à la page :	#chapter_2_1
	lien dans une autre page du site :	/fr/p/1/85/2363#chapter_1_3_2
	lien depuis un autre site :	htp://a-io.eu/fr/p/1/85/2363#chapter_3

3. Sommaire automatique d'un article

Dans le code d'un générateur de pages, le composant _p3008_article_summary affiche automatiquement le sommaire d'un article.

Voir en début de la marge droite de cette page comme exemple.

4. Adaptations possibles du modèle

4.1. Format général

Pour qu'un titre soit soumis à la numérotation automatique, il faut qu'il soit placer dans une séquence de la forme :

{#format=valeur:Titre#}

avec :

• format = format du numéro généré ;
• valeur = ce champ peut être laissé vide, il sera remplacé par le numéro calculé ;
• Titre = titre du chapitre ou sous-chapitre qui sera repris dans le sommaire.

4.2. Format du numéro de chapitre

Le champ format est constitué ainsi :

• chaque dièse représente un niveau de numérotation (y compris le premier de la séquence) ;
• tout autre caractère sera restitué à l'identique (sauf le signe égal « = » qui est interdit).

Exemples :

{#.#. =:Titre#}
{#) =:Titre#}
{# - # - #°=:Titre#}

Le nombre de dièses en début de la séquence indique le niveau de la numérotation. Il n'est pas corrélé au type de la balise h1, h2, h3... ou autre (p, div...) dans laquelle elle est placée.

La formule de numérotation automatique peut être précédée ou suivie sur la même ligne de caractères qui apparaitront dans le texte, mais pas dans le sommaire de l'article.
Exemple :

• Article {# - =:Droits et devoirs#} -
• titre généré dans le texte : Article 4 - Droits et devoirs -
• titre généré dans le sommaire : 4 - Droits et devoirs

4.3. Titre du chapitre ou sous-chapitre

Le titre du chapitre ou sous-chapitre ne doit être plié.

Tout ou partie du texte peut être formaté, le formatage sera alors repris dans le sommaire automatique généré.
Ex. : Menu Édition ; 3^me jour ; Texte nouveau

4.4. Limitations actuelles

La version actuelle (0.8.15) du logiciel présente plusieurs limitations dans l'utilisation de la numérotation automatique des chapitres, limitations qui seront ou non levées dans les versions ultérieures :

• Une page ne doit comporter qu'un seul article numéroté.
• La numérotation porte au maximum sur 3 niveaux de titre.
• La numérotation est en chiffres arabes (1, 2...), elle ne peut pas être en chiffres romains (I, II... ou i, ii...), ni en lettres (A, B... ou a, b... ou α, β...).
• La numérotation commence à 1 (ou 0 pour le ou les niveaux précédents non définis).