Subversion Repositories wimsdev

<p>
Un document est composé d'un ou plusieurs <em>blocs</em>. Un bloc
correspond à peu près à une page html, mais il est aussi possible d'insérer
un ou plusieurs blocs dans un autre.
</p><p>
Chaque bloc doit avoir un nom (un mot unique) et un titre. Le point
d'entrée du document est un bloc sous le nom <span class="tt">main</span>. C'est ce
bloc qui conduira les lecteurs au contenu entier du document.
</p>
<h3 id="creation">Création d'un bloc</h3>
Pour créer un nouveau bloc (excepté le bloc d'entrée <span class="tt">main</span>), vous
devez d'abord le citer dans un bloc existant. Quand vous lisez ce dernier
bloc, la citation deviendra un lien qui vous conduit à la création du
nouveau bloc.
<p>
Il y a trois façons pour un bloc d'en citer un autre.
</p>
<ol>
<li>Par un lien. \link{link,La syntaxe du lien}
 est très simple&nbsp;: il suffit de donner le nom du bloc cité.
<br/>
 On peut aussi utiliser des liens pour citer des blocs d'autres documents.
</li><li>
Comme une partie pliable du bloc citant. Cette partie peut être
 dépliée ou repliée à volonté par le lecteur.
 \link{fold,La syntaxe}.
</li><li>
Comme une partie intégrante de la page du bloc citant. L'insertion
 est transparente au lecteur. \link{embed, La syntaxe}.
</li></ol>
<h3 id="navigation">Champs "précédent", "suivant" et "parent" d'un bloc</h3>
Dans les champs "précédent", "suivant" et "parent" de chaque bloc, on écrit le nom
d'un bloc du document. Ces champs servent
<ul><li>à définir la structure du document ;</li>
<li>à proposer un ordre de lecture de l'ensemble des pages du document (en utilisant la flèche <span class="text_icon doch_next">Suiv</span> par exemple, le lecteur passera
au bloc suivant du bloc où il se trouve, la flèche <span class="text_icon doch_up">Sup</span> lui permettra de remonter au bloc "parent" du bloc qu'il lit) ;</li>
<li>à fixer les blocs qui apparaitront dans la version imprimable du document : la version imprimable ne se déroule pas selon l'ordre de
navigation défini par les champs "précédent" et "suivant". Les blocs apparaissent dans la version imprimable si et seulement s'il y a un lien
vers eux dans leur bloc parent et ils apparaissent dans l'ordre des liens (la version imprimable est utile par exemple
pour faire une recherche d'un mot dans un document).</li>
</ul>