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> : dclare une nouvelle partie (chaque partie est visible dans la NSTableView au dessus du texte de l'aide). Au moins un lment part est obligatoire pour un fichier d'aide. Dans le cas contraire le fichier ne sera pas considr comme valide.</li>
<li><code><section></code> : dclare une section (vous pouvez imbriquer une section dans une autre pour crer une sous-section, etc.). La numrotation 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 spcifier le nom de la partie ou de la section.
Exemple :
<pre><section name="Structure Tags"></pre>
<br><br>
Il y a galement une srie de tags, similaires au HTML, pour crer 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="Rferencer">
Il y a deux possibilites pour rfrencer quelque chose :
<ul>
<li>lier une url, en utilisant <code><b><url></b></code>...<code><b></url></b></code></li>
<li>lier une rfrence interne, en utilisant <code><b><ref id="RefID"></b>your text<b></ref></b></code></li>
</ul>
<section name="Rferences internes">
Vous pouvez rfrencer des parties ou des sections, en utilisant leur attribut <i>name</i> comme ID; ou vous
pouvez dfinir 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 lgendes">
Vous pouvez ajouter des lgendes une image qui seront automatiquement dessines et positionnes. 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 "lgendes" pour mettre jour les figures. L'autre avantage est que c'est simple
faire, et normalement plus rapide que de dessinner les lgendes la main sous gimp :)
<br>
Vous pouvez inclure une figure avec lgendes 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" dterminent les lgendes dessines.
Les attributes "x" et "y" sont les positions, en pixels, de la cible pointe par la lgende. Pour dterminer
ces attibutes, vous pouvez charger l'image dans un programme comme gimp, les coordones de la souris
devraient s'afficher quelque part :)
</section>
</section>
|
