/usr/share/GNUstep/HelpViewer.app/HelpViewer.help/Creation.xlp is in helpviewer.app 0.3-8build3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 | <section name="Bases" src="Bases.xlp"/>
<section name="Tags Disponibles">
Chaque tag doit être fermé avec le tag fermant correspondant.
Par exemple, pour mettre un texte en gras, on doit l'entourer avec le tag <code><b></code> :
<listing><code><b></code><b>votre texte en gras</b><code></b></code></listing>
<section name="Tags de structure">
Voici les deux tags de structure principaux :
<ul>
<li><code><part></code> : déclare une nouvelle partie (chaque partie est visible dans la NSTableView au dessus du texte de l'aide). Au moins un élément part est obligatoire pour un fichier d'aide. Dans le cas contraire le fichier ne sera pas considéré comme valide.</li>
<li><code><section></code> : déclare une section (vous pouvez imbriquer une section dans une autre pour créer une sous-section, etc.). La numérotation des sections, sous-sections, etc. est faite automatiquement.
</li>
</ul>
<br><br>
Ces deux tags ont un attribut, <code><b>name</b></code>, permettant de spécifier le nom de la partie ou de la section.
Exemple :
<pre><section name="Structure Tags"></pre>
<br><br>
Il y a également une série de tags, similaires au HTML, pour créer des listes
(avec les tags <code><ul></code> et <code><li></code>).
</section>
<section name="Positionnement">
Vous pouvez changer l'alignement du texte avec trois tags :
<ul>
<li><code><b><left></b></code> : pour aligner à gauche</li>
<li><code><b><center></b></code> : pour centrer le texte</li>
<li><code><b><right></b></code> : pour aligner à droite</li>
</ul>
</section>
<section name="Formatage du Texte">
Vous pouvez utiliser les tags suivants :
<ul>
<li><code><b><b></b></code> : pour mettre le texte en gras</li>
<li><code><b><i></b></code> : pour mettre le texte en italique</li>
<li><code><b><sc></b></code> : pour mettre le texte en petites majuscules</li>
<li><code><b><code></b></code> : pour utiliser une fonte à taille fixe</li>
<li><code><b><em></b></code> : mettre l'accent sur cette partie du texte</li>
</ul>
</section>
<section name="Réferencer">
Il y a deux possibilitées pour référencer quelque chose :
<ul>
<li>lier une url, en utilisant <code><b><url></b></code>...<code><b></url></b></code></li>
<li>lier à une référence interne, en utilisant <code><b><ref id="RefID"></b>your text<b></ref></b></code></li>
</ul>
<section name="Réferences internes">
Vous pouvez référencer des parties ou des sections, en utilisant leur attribut <i>name</i> comme ID; ou vous
pouvez définir des points d'ancrages, en utilisante le tag <i>label</i> :
<listing><code><b><label id="RefID"></b></listing>
</section>
</section>
<section name="Figure avec légendes">
Vous pouvez ajouter des légendes à une image qui seront automatiquement dessinées et positionnées. Vous
pouvez voir un exemple <ref id="Introduction">ici</ref>. L'avantage étant que quand vous traduirez vos fichiers xlp,
il suffira de traduire les tags "légendes" pour mettre à jour les figures. L'autre avantage est que c'est simple
à faire, et normalement plus rapide que de dessinner les légendes à la main sous gimp :)
<br>
Vous pouvez inclure une figure avec légendes avec les tags suivants :
<listing>
<code><legendfig src="helpviewer-200.tiff"><br>
<legend x="113" y="31">Click to view the index</legend><br>
... (etc.)<br>
</legendfig><br></code>
</listing>
<br>
L'attribut "src" indique le fichier image utilisé, et les tags "legend" déterminent les légendes dessinées.
Les attributes "x" et "y" sont les positions, en pixels, de la cible pointée par la légende. Pour déterminer
ces attibutes, vous pouvez charger l'image dans un programme comme gimp, les coordonées de la souris
devraient s'afficher quelque part :)
</section>
</section>
|