-
Notifications
You must be signed in to change notification settings - Fork 10
/
Copy pathREADME
249 lines (173 loc) · 8.5 KB
/
README
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
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
Template LaTeX pour SSTIC
Utilisation
===========
Pour compiler les sources, c'est aussi simple que :
$ make
Par défaut, cette commande compile tous les articles présents dans le
répertoire (un article est un répertoire dont le nom est composé de
caractères alphanumériques et qui contient un fichier master.tex).
Avec le modèle fraichement téléchargé, cela produira l'article
MonNom.pdf et l'article MyName.pdf.
Pour que la compilation fonctionne, il faut installer un certain
nombre de packages LaTeX. Sous Debian, les packages nécessaires sont
texlive, texlive-latex-extra, texlive-science, texlive-lang-french,
cm-super et gs.
Ce modèle doit être la base commune à tous les articles LaTeX pour
SSTIC.
Un exemple d'article est disponible dans le répertoire MonNom/ En
tant qu'auteur, vous devez copier ce répertoire et l'adapter.
$ cp -r MonNom SecuriteDesTrotinettes
Important : Vous ne devez modifier que les fichiers contenus dans le
répertoire correspondant à votre article.
Nous avons déjà sélectionné quelques packages. D'ailleurs, ces
derniers nécessitent parfois d'installer des paquetages systèmes
(lmodern pour lmodern, cm-super pour microtype). Si vous avez besoin
d'ajouter un nouveau package, veuillez contacter l'équipe (actes (AT)
lists.sstic.org) car nous devons vérifier la compatibilité des modules
entre eux.
Publication
===========
Vous devez envoyer les *sources* à actes (AT) lists.sstic.org avant
la date butoir.
L'auteur consciencieux prendre soin de corriger tous les warnings
avant de nous envoyer ses sources :). En particulier, les erreurs les
plus importantes sont signalées en rouge par la commande make.
Vous pouvez envoyer une archive complète de votre répertoire
(.tar.gz), ou encore un patch, ou un lien vers votre repository git
dérivé du dépôt d'origine, etc.
Découpage en sections
=====================
La classe llcns ne définit que 4 niveaux de sections :
* section
* subsection
* subsubsection
* paragraph
Merci de *ne pas* redéfinir la profondeur des sections, en particulier
le compteur secnumdepth.
Si vous souhaitez mettre des annexes, vous pouvez utiliser \appendix :
toutes les sections qui suivront cette commande seront identifiées par
des lettres.
Images, figures
===============
Les images doivent être placées dans un environnement figure de
façon à pouvoir y associer facilement une légende et un label.
Quelques notes:
* La légende doit être en dessous de l'image
* Le placement de l'image par LaTeX ne garantit pas que votre
image sera exactement où vous souhaitiez. Remplacez donc les
formules "l'image ci-dessous" mais plutôt par sa référence
("l'image~\ref{fig:monnom:archi}")
* il ne *FAUT* pas utiliser [H] pour forcer les figures flottantes
à une position donnée. Cela n'est pas une option standard et
elle est incompatible avec certains packages.
* Format de l'image
- Compatible pdflatex : PNG, PDF
- Les formats vectoriels (comme PDF) sont recommandés car il
arrive de devoir redimensionner les images à l'édition
finale
* Il est demandé de créér un répertoire img/ dédié à toutes les
images
* La référence doit être préfixée par votre fig:monnom pour éviter les
collisions entre articles dans la version consolidée des actes.
* Prenez soin de vos couleurs, SSTIC n'imprime qu'en dégradé de
gris, votre choix de couleurs doit donc respecter cette
contrainte.
Votre article sera publié sur papier et sur notre site Web. Vous
pouvez donc fournir les images dans les deux « formats » si cela
vous semble nécessaire.
Pour cela, le plus simple est d'inclure l'image aux deux formats
(bw-archi.png et archi.png) dans le répertoire img/ et d'utiliser la
macro \ifssticbw pour choisir la version à utiliser lors de la
compilation. Un illutstration de cette macro est donnée dans
l'article donné en exemple.
Citations
=========
* Les références de citation doivent être préfixées par votre nom
afin d'empêcher les collisions entre auteurs.
* La bibliographie doit être dans contenue dans le fichier
biblio.bib au format BibTeX
Référence des types : http://newton.ex.ac.uk/tex/pack/bibtex/btxdoc/node6.html
Référence des champs: http://newton.ex.ac.uk/tex/pack/bibtex/btxdoc/node7.html
* Faites attention aux warning indiquant les références manquantes
* Attention à la syntaxe lorsque vous citez plusieurs références:
MAUVAIS: \cite{foo, bar}
MAUVAIS: \cite{foo}\cite{bar}
CORRECT: \cite{foo,bar}
* BibTeX a la fâcheuse tendance de ne pas conserver les majuscules
dans les titres des références. Pour éviter le problème, le plus
simple est d'entourer la valeur du champ title avec deux accolades
(le fichier MonNom/biblio.bib est un exemple)
Texte verbatim
==============
lstlisting
----------
Documentation complète : http://mirrors.ctan.org/macros/latex/contrib/listings/listings.pdf
Options utiles :
* ``language'' peut prendre les valeurs suivantes:
Python Java PHP [x86masm]Assembler
C Perl HTML [Sharp]C
* ``numbers'' pour numéroter les ligne (``stepnumbers'' pour contrôler l'incrément)
* ``basicstyle'' pour modifier la police utilisée (exemple: basicstyle=\tiny)
Mise en page
============
De manière générale, LaTeX fait un bon travail de mise en page. Dans
tous les cas, ne vous souciez de la mise en page qu'à *la fin* de la
rédaction.
Si la mise en page ne vous plaît pas, évitez d'utiliser des sauts de
ligne (\\) ou de page (\newpage) car cela casse la mise en page et
nuit au rendu global. On préférera, si vraiment c'est nécessaire, les
commandes \smallskip, \medskip et \bigskip qui s'intègrent mieux à
l'algorithme de mise en page.
En cas de doute, n'hésitez pas à poser la question à
[email protected]. En effet, l'objetif est d'avoir un document
unique contenant les différents articles. Homogénéiser les styles rend
la lecture des actes plus agréables.
Concernant les figures flottantes, elles ont vocation, comme leur nom
l'indique, à *flotter*. Ne vous étonnez donc pas qu'elles
n'apparaissent pas au bon endroit. Il est possible d'indiquer à LaTeX
où on souhaiterait voir ces images. Lorsque vous en avez peu, les
indications [ht] ou [h] suffisent. En revanche, si vous avez beaucoup
de figures, LaTeX peut refuser d'en mettre plus de deux par
page. Auquel cas vous pouvez essayer [p], qui regroupe les figures sur
de pages dédiées. Le rendu obtenu est souvent préférable à ce que l'on
obtient en forçant le positionnement des figures. En aucun cas il ne
faut utiliser [H] dans vos articles.
E-Book
======
La compilation des actes sous forme d'e-book se fait en appelant la
commande make sstic-actes.{azw3,mobi,epub} (choisir l'extension
voulue.
Elle nécessite, en plus des paquetages LaTeX décrits ci-dessus, les
outils suivants (les paquetages Debian sont indiqués entre parenthèses)
- htlatex (tex4ht)
- ebook-convert (calibre)
- cssselect (python-cssselect)
La génération des e-books est un procédé incertain et fragile,
utilisant divers formats (HTML entre autres) et de nombreux outils qui
ne fonctionnent que grâce à la magie noire et à beaucoup de
scotch. Cela explique que la commande peut échouer, ou ne pas rendre
les actes de manière fidèle.
FAQ
===
Q) LaTeX m'insulte avec le message sordide suivant :
! pdfTeX error (font expansion): auto expansion is only possible with scalable fonts.
R) Afin de fonctionner les packages séléctionnés nécessitent
l'installation du paquetage Debian cm-super.
Q) LaTeX m'insulte au sujet d'utf8x.def / algorithm.sty / du support
du français. Que faire ?
R) Il faut respectivement installer texlive-latex-extra,
texlive-sciences et texlive-lang-french.
Q) Autre message sordide de LaTeX:
LaTeX Warning: Characters dropped after `\end{verbatim}'
R) Le package verbatim change la façon dont les environnements du même
nom sont interprétés. En particulier, si vous avez une ligne de la
forme '\end{verbatim}}', la seconde accolade est ignorée, ce qui mène
logiquement à une problème plus loin.
Q) Puis-je redéfinir des commandes (newcommand / renewcommand) ?
R) Si ce sont des commandes perso (TODO, myurl), vous pouvez, mais
pensez à préfixer ces commandes par votre nom ou quelque chose les
rendant uniques (pour éviter la collision avec d'autres articles). Si
ce sont des commandes standard (labelitemi, secnumdepth), la réponse
est *non*. En effet, cela nuit à l'homogénéité des actes, et surtout,
cela risque de casser les articles suivant le vôtre dans le
document. En cas de doute, contactez la liste actes@.