Index
TITLE:Pages:TITLE
Les pages sont des fichiers texte intégrant des sections de type markdown mais avec leur syntaxe spécifique. Les fichiers .page sont interprétés de manière à générer html, css et javascript. Il y a deux styles de marqueurs, d'abord les marqueurs de style empruntés à MediaWiki par exemple, ensuite des marqueurs de section sous la forme STUFF: en entrée puis :STUFF en sortie, avec les paramètres ou le contenu au milieu.
Important: les fichiers de description de pages ne contiennent PAS de code HTML, encore moins de JavaScript ou de CSS, le but est d'avoir des documents faciles à migrer d'un écosystème à un autre, ce qui impose des fonctionnalités volontairement limitées aux seules balises définies ici.
CHAPTER:Marqueurs de style:CHAPTER
CODE:
Caractères gras<:b>
Caractères soulignés<:u>
Caractères italiques<:i>
:CODE
Par exemple :
Caractères gras<:b>, caractères soulignés<:u>, caractères italiques<:i>, tous combinés<:b><:u><:i>
CHAPTER:Marqueurs de liens:CHAPTER
CODE:
: lien simple vers une page web, le titre affiché est le lien lui-même
[Titre](lien) : lien html classique, avec spécification séparée du titre
[Titre]((lien)) : comme [Titre](lien) mais le lien s'ouvre dans une nouvelle page
:CODE
CHAPTER:Marqueurs de titre:CHAPTER
CODE:
TITLE:Titre de page:TITLE
CHAPTER:Titre de chapitre:CHAPTER
SECTION:Titre de section:SECTION
:CODE
CHAPTER:Marqueurs de zone:CHAPTER
CODE\:
Zone de code
\:CODE
La même syntaxe fonctionne avec CODE, CMD, CONF et OUTPUT, pour respectivement les zones de lignes de code, de lignes de commande, de lignes de configuration et de lignes de sortie.
CHAPTER:Articles:CHAPTER
Les articles sont des dossiers articulés autour d'un fichier index.page, d'un index.settings et de leurs dépendances, images ou autres, par exemple :
CONF:
\mes-articles
\article-1
\index.page
\index.settings
\illustration-1.png
\illustration-2.png
\article-2
\index.page
\index.settings
\illustration-1.png
\illustration-2.png
\illustration-3.png
:CONF
Pour présenter la liste des articles, on aura typiquement un couple index.page/settings à la racine du dossier parent du dossier mes-articles :
CONF:
\index.page
\index.settings
\mes-articles
\article-1
\article-2
:CONF
Ce fichier index.page contiendra alors une section de ce genre :
CODE:
ARTICLES:
mes-articles/*
:ARTICLES
:CODE
On aurait pu avoir plusieurs lignes listant de manière explicite les chemins des dossiers des articles, mais il est naturellement plus pratique d'utiliser un wildcard comme ici.
CHAPTER:Images:CHAPTER
Les sections images sont simplement des listes d'images, repérées par leur chemin relatif pouvant inclure un wildcard :
CODE:
IMAGES:
mes-images/*
une-autre-image.jpg
:IMAGES
:CODE