Les wikis

Reader\MediaWiki\MediaWikiReader, Reader\DokuWiki\DokuWikiReader et Reader\Creole\CreoleReader lisent la syntaxe de trois wikis et en font un document UJO, dont phil/ujo produit le rendu HTML. Chacun lit la syntaxe native de son wiki (titres, emphase, liens vers des pages et vers d'autres sites, listes, tableaux, texte préformaté, texte gardé tel qu'écrit, images, filets) et les extensions que partagent tous les wikis de PHIL, écrites comme le wiki écrit les siennes : des balises dans MediaWiki et DokuWiki, <note>, des espaces réservés dans Creole, <<note>> ; des modèles et des mots magiques dans MediaWiki, {{TOC}}, __TOC__ ; des macros dans DokuWiki, ~~TOC~~. Ensemble, ils donnent à chaque wiki toutes les fonctionnalités du lecteur Markdown. Formats place chaque syntaxe à côté de celles des autres formats.

$reading = new MediaWikiReader()->read("== Rules ==\nRoll '''two''' dice.<ref>Six-sided.</ref>");

$reading->document->blocks[0];   // a `header` block, level 2, its anchor `rules`
$reading->document->blocks[2];   // the `footnote` block, `Six-sided.`

new MediaWikiReader(true) garde le HTML brut ; DefaultCompiler le demande au seul niveau all. Un deuxième argument remplace le normaliseur de phil/ujo qui vérifie le document ; un troisième, un Reader\Wiki\WikiLinks, dit où se trouvent les pages et les fichiers.

Pages et fichiers

Un lien vers une page, [[Main Page#History]], mène au chemin de la page : ses espaces deviennent des traits de soulignement, ses autres caractères non sûrs sont encodés, et sa section devient une ancre produite comme les lecteurs produisent les ancres des titres : /Main_Page#history. Un fichier, [[File:map.png]] ou {{map.png}}, mène au chemin des médias. Une adresse Web est gardée telle qu'écrite.

new MediaWikiReader(false, null, new WikiLinks(pages: '/wiki/', media: 'https://cdn.example.com/'));

Les deux chemins commencent par / par défaut, pour qu'un nom qui contient : (un espace de noms, Help:Contents) ne soit jamais lu comme un schéma. DokuWiki écrit ses noms de pages en minuscules, comme le fait DokuWiki.

Les balises d'extension

Une balise s'écrit <name>, <name flag key="value"> ou <name/> dans MediaWiki et DokuWiki, <<name …>> dans Creole, son nom en majuscules ou en minuscules, et se ferme par </name> ou <</name>>. Une valeur qui contient des espaces se met entre guillemets.

En ligne

Une balise inconnue, ou laissée ouverte, est du texte. Une balise qui contient une balise de son propre nom se ferme à la première balise fermante.

Blocs

Un conteneur s'ouvre par sa balise au début d'une ligne, et contient les blocs jusqu'à sa balise fermante (sur la même ligne ou sur une ligne suivante), ou jusqu'à la balise fermante d'un conteneur qui l'entoure, ou jusqu'à la fin. <note>a</note> est une note qui contient un paragraphe.

Chaque conteneur prend les attributs id (l'ajustement anchor du bloc qu'il produit), class (un container autour), align, width, height et wrap="left" ou wrap="right". Les conteneurs s'imbriquent aussi profondément que le permet UJO : la balise d'un conteneur plus profond est laissée de côté, ses blocs lus comme ceux du conteneur qui l'entoure. Une balise fermante qui ne ferme rien d'ouvert est laissée de côté.

MediaWiki

Un modèle se nomme en majuscules ou en minuscules, ses espaces et ses traits de soulignement laissés de côté : {{Page break}} est {{pagebreak}}. Un modèle inconnu est du texte.

DokuWiki

Creole

Texte mal formé

Tout texte est un document, et les lecteurs ne lancent jamais d'exception. Une marque d'emphase ferme l'élément de son genre encore ouvert, et ceux ouverts à l'intérieur et laissés ouverts sont du texte, pour que le HTML soit toujours bien imbriqué ; une marque jamais fermée est du texte. Un lien, une image ou un modèle se lit dans les 4 Ko et sur une seule ligne ; s'il n'y est pas fermé, c'est du texte. Un conteneur jamais fermé contient le reste du texte.

Temps linéaire

Chaque ligne est lue une seule fois, les balises des conteneurs ayant d'abord été placées sur des lignes à elles par une passe. Un délimiteur absent à partir d'une position est absent à partir de toutes les positions suivantes, ce dont se souvient le lecteur en ligne ; le contenu est lu sur huit niveaux au plus, plus profond comme du texte ; un lien, une image ou un modèle est cherché dans les 4 Ko. Les conteneurs ouverts sont comptés par nom, et une ligne de tableau garde soixante-quatre cellules, le texte des autres joint à la dernière. Des sources de 100 Ko écrites pour être lentes se lisent chacune en une fraction de seconde.