Subversion Repositories Scribus

Rev

Rev 23232 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
22948 jghali 1
<html>
2
<head>
3
        <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
4
        <title>Créer et manipuler les styles</title>
5
</head>
6
<body>
7
<h2>Créer et manipuler les styles</h2>
8
 
9
<dl>
10
 
11
<dt><a name="-createCharStyle"><strong>createCharStyle</strong></a>(...)</dt>
12
<dd><code>createCharStyle(...)</code>
13
<p>Crée un style de caractère. Cette fonction accepte les paramètres nommés suivants:
14
<ul>
15
<li>"name" [requis] -> nom du style de caractère à créer (premier paramètre)</li>
16
<li>"font" [optionnel] -> nom de la police de caractère à utiliser (second paramètre)</li>
17
<li>fontsize [optionnel] -> taille de la police de caractère (3ème paramètre - nombre réel)</li>
18
<li>"features" [optionnel] -> détails typographiques définis sous la forme d'une liste d'éléments séparés par des virgules (sans espaces!), pris parmis les éléments suivants (4ème paramètre - chaîne de caractère):
19
<ul>
20
        <li>inherit</li>
21
        <li>bold</li>
22
        <li>italic</li>
23
        <li>underline</li>
24
        <li>underlinewords</li>
25
        <li>strike</li>
26
        <li>superscript</li>
27
        <li>subscript</li>
28
        <li>outline</li>
29
        <li>shadowed</li>
30
        <li>allcaps</li>
31
        <li>smallcaps</li>
32
</ul>
33
</li>
34
<li>"fillcolor" [optionnel], fillshade [optionnel] -> définie la couleur et la teinte de fond (5ème paramètre: chaîne, 6ème paramètre: nombre réel 1.0 = 100%)</li>
35
<li>"strokecolor" [optionnel], strokeshade [optionnel] -> définie la couleur et la teinte de filet (7ème paramètre: chaîne, 8ème paramètre: nombre réel 1.0 = 100%)</li>
36
<li>baselineoffset [optionnel] -> décalage par rapport à la ligne de base(9ème paramètre)</li>
37
<li>shadowxoffset [optionnel], shadowyoffset [optionnel] -> décalages de l'ombre portée si celle-ci est utilisée(10ème et 11ème paramètres)</li>
38
<li>outlinewidth [optionnel] -> largeur du filet si celui-ci est utilisé (12ème paramètre)</li>
39
<li>underlineoffset [optionnel], underlinewidth [optionnel] -> options de soulignement si utilisé (13ème et 14ème paramètres)</li>
40
<li>strikethruoffset [optionnel], strikethruwidth [optionnel] -> options de barré si utilisé (15ème et 16ème paramètres)</li>
41
<li>scaleh [optionnel], scalev [optionnel] -> échelle horizontale et verticale des caractères (17ème et 18ème paramètres - nombres réels, 1.0 = 100%)</li>
42
<li>tracking [optionnel] -> valeur d'approche du texte(19ème paramètre - nombre réel, e.g. -50 = -5.0%)</li>
43
<li>"language" [optionnel] -> code de language (20ème paramètre - chaîne de caractère: en = English)</li>
44
<li>"fontfeatures" [optionnel] -> chaîne de caractère contenant une liste de fonctionnalités OpenType séparées par des virgules (21ème paramètre):
45
<ul>
46
    <li>Ligatures:
47
        <ul>
48
            <li>-liga: désactive les ligatures commmunes</li>
49
            <li>-clig: désactive les ligatures contextuelles</li>
50
            <li>+dlig: active les ligatures discrétionnaires</li>
51
            <li>+hlig: active les ligatures historiques</li>
52
        </ul>
53
    </li>
54
    <li>Position des caractères:
55
        <ul>
56
            <li>+subs: active les indices</li>
57
            <li>+sups: active les exposants</li>
58
            <li>+ordn: active les ordinaux</li>
59
        </ul>
60
    </li>
61
    <li>Capitales:
62
        <ul>
63
            <li>+smcp: active les petites capitales</li>
64
            <li>+c2sc: active les capitales en petites capitales</li>
65
            <li>+pcap: active les petite caps</li>
66
            <li>+c2pc: active les capitales en les petite caps</li>
67
            <li>+unic: active l'écriture unicamérale</li>
68
            <li>+titl: active le titrage</li>
69
        </ul>
70
    </li>
71
    <li>Chiffres:
72
        <ul>
73
            <li>+lnum: active les chiffres alignés</li>
74
            <li>+tnum: active les chiffres en style ancien</li>
75
        </ul>
76
    </li>
77
    <li>Largeur des chiffres:
78
        <ul>
79
            <li>+pnum: active la largeur de chiffre proportionnelle</li>
80
            <li>+tnum: active la largeur de chiffre tabulaire</li>
81
        </ul>
82
    </li>
83
    <li>Fractions numériques:
84
        <ul>
85
            <li>+frac: active les fractions diagonales</li>
86
            <li>+afrc: active les fractions empilées</li>
87
        </ul>
88
    </li>
89
    <li>Zéro numérique:
90
        <ul>
91
            <li>+zero: active le zéro barré</li>
92
        </ul>
93
    </li>
94
    <li>Jeux de styles:
95
        <ul>
96
            <li>+ss01: active le 1er jeu de style</li>
97
            <li>...</li>
98
            <li>+ss20: active le 20ème jeu de style</li>
99
        </ul>
100
    </li>
101
</ul>
102
</li>
103
</ul>
104
</p>
22969 jghali 105
<p>Tout atttribut de style non explicitement définie verra sa valeur héritée du style de caractère par défaut.</p>
106
<p>Du fait du nombre important d'arguments de cette fonction, il est fortement conseillé d'utiliser la syntaxe par mots clés lors de son appel. Par example si vous souhaitez modifier uniquement la taille de police, n'appelez pas la fonction de la façon suivante:
107
<ul style="list-style-type:none">
108
    <li><code>newStyle = createCharStyle("Nouveau Style", "Arial Regular", 12)</code></li>
109
</ul></p>
110
<p>mais utilisez plutôt cette syntaxe à la place:
111
<ul style="list-style-type:none">
112
    <li><code>newStyle = createCharStyle("Nouveau Style", fontsize=12)</code></li>
113
</ul>
114
</p>
115
<p>Pour plus de détails à ce sujet et notamment sur la façon de définir l'approche, veuillez consulter la page wiki <a href="https://wiki.scribus.net/canvas/Text_and_Text_Manipulation">Text and Text Manipulation</a>.</p>
22948 jghali 116
</dd>
117
 
118
<dt><a name="-createCustomLineStyle"><strong>createCustomLineStyle</strong></a>(...)</dt>
119
<dd><code>createCustomLineStyle(nomStyle, style)</code>
120
<p>Crée le style de filet personnalisé 'nomStyle'.</p>
121
<p>Cette fonction accepte une liste de dictonnaires en tant que paramètre du style. Chaque dictionnaire représente un sous-filet du style et accepte les clés suivantes:
122
<ul>
123
<li>Color [optionnel] -> nom de la couleur à utiliser (chaîne)</li>
124
<li>Dash [optionnel] -> type de ligne à utiliser (entier)</li>
125
<li>LineEnd [optionnel] -> type de fin de filet à utiliser  (entier)</li>
126
<li>LineJoin [optionnel] -> type de jointure de filet à utiliser  (entier)</li>
127
<li>Shade [optionnel] -> teinte de couleur (entier)</li>
128
<li>Width [optionnel] -> largeur de filet (nombre réel entier)</li>
129
</ul>
130
</p>
131
</dd>
132
 
133
<dt><a name="-createParagraphStyle"><strong>createParagraphStyle</strong></a>(...)</dt>
134
<dd><code>createParagraphStyle(...)</code>
135
<p>Crée un style de paragraphe. Cette fonction accepte les paramètres nommés suivants:
136
<ul>
137
<li>"name" [requis] -> spécifie le nom de style de paragraphe</li>
138
<li>linespacingmode [optionnel] -> specifie le mode d'interlignage. Les valeurs possibles sont:
139
<ul>
140
        <li>interlignage fixe: 0</li>
141
        <li>interlignage automatique: 1</li>
142
        <li>aligner le texte sur la grille: 2</li>
143
</ul>
144
</li>
145
<li>linespacing [optionnel] -> spécifie la valeur d'interligne si l'interlignage fixe est utilisé</li>
146
<li>alignment [optionnel] -> spécifie l'alignement des paragraphes
147
<ul>
148
        <li>gauche: 0</li>
149
        <li>centre: 1</li>
150
        <li>droit: 2</li>
151
        <li>justifié: 3</li>
152
        <li>étendu: 4</li>
153
</ul>
154
</li>
155
<li>leftmargin [optionnel], rightmargin [optionnel] -> spécifie les marges gauches et droites</li>
156
<li>gapbefore [optionnel], gapafter [optionnel] -> spécifie l'espacement avec le paragraphe précédent et le paragraphe suivant</li>
157
<li>firstindent [optionnel] -> le décalage de la première ligne</li>
158
<li>hasdropcap [optionnel] -> spécifie si les lettrines sont activées (1 = oui, 0 = non)</li>
159
<li>dropcaplines [optionnel] -> la hauteur des lettrines en nombre de lignes si l'utilisation de lettrines est activée</li>
160
<li>dropcapoffset [optionnel] -> décalage horizontal des lettrines si l'utilisation de lettrines est activée</li>
161
<li>"charstyle" [optionnel] -> nom du style de caractère à utiliser</li>
23168 jghali 162
<li>"bullet" [optionnel] -> chaîne de caractère à utiliser pour les puces</li>
23232 jghali 163
<li>"tabs" [optional] -> a list of tab definitions
164
<ul>
165
    <li>un tab est défini par un triplet de valeur sous la forme suivante (position, type, fillchar)</li>
166
    <li>position [requis] -> nombre réel représentant la position</li>
167
    <li>type [optionnel] -> gauche: 0 [default], droit: 1, point: 2, virgule: 3, centré: 4</li>
168
    <li>fillchar [optionnel] -> le caractère utilisé pour remplir l'espace occupé par le TAB, aucun par défaut.</li>
22948 jghali 169
</ul>
23232 jghali 170
</li>
171
</ul>
22948 jghali 172
</p>
23168 jghali 173
<p>Si vous désirez omettre un certain nombre d'éléments, cette fonction n'acceptera pas de valeurs null, i.e., une série de virgule. Vous <i>devez</i> spécifier un paramètre entier pour chacun des paramètres omis. Par example, si vous désirez spécifier uniquement un nom de style de paragraphe et un nom de style de caractère, votre appel de fonction ressemblera à ceci:
174
<ul style="list-style-type:none">
175
    <li><code>scribus.createParagraphStyle("MyNewStyle",0,0,0,0,0,0,0,0,0,"MyCharStyle")</code></li>
176
</ul></p>
177
<p>Cependant, si vous désirez spécifier uniquement un nom de style et un mode d'interlignage, vous pouvez alors limiter le nombre d'argument passé dans votre appel de fonction:
178
<ul style="list-style-type:none">
179
    <li><code>scribus.createParagraphStyle("MyOtherNewStyle", 1)</code></li>
180
</ul></p>
22948 jghali 181
</dd>
182
 
183
<dt><a name="-getAllStyles"><strong>getAllStyles</strong></a>(...)</dt>
184
<dd><tt>getAllStyles() -&gt; liste</tt>
185
<p>Obsolète. Veuillez utiliser getParagraphStyles() en lieu et place.</p></dd>
186
 
187
<dt><a name="-getCharStyles"><strong>getCharStyles</strong></a>(...)</dt>
188
<dd><tt>getCharStyles() -&gt; liste</tt>
189
<p>Retourne une liste des noms de l'ensemble des styles de caractère du document courant.</p></dd>
190
 
23695 jghali 191
<dt><a name="-getLineStyles"><strong>getLineStyles</strong></a>(...)</dt>
192
<dd><tt>getLineStyles() -&gt; liste</tt>
193
<p>Retourne une liste des noms de l'ensemble des styles de filet du document courant.</p></dd>
194
 
22948 jghali 195
<dt><a name="-getParagraphStyles"><strong>getParagraphStyles</strong></a>(...)</dt>
196
<dd><tt>getParagraphStyles() -&gt; liste</tt>
197
<p>Retourne une liste des noms de l'ensemble des styles de paragraphe du document courant.</p></dd>
198
 
199
</dl>
200
</body>
201
</html>
202