forked from pictyeye/author-template
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
217 lines (152 loc) · 7.31 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
Template LaTeX pour SSTIC
Utilisation
===========
Pour compiler les sources, c'est aussi simple que :
$ make
Le résultat est dans sstic-actes.pdf
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.
Important : Vous ne devez pas pas toucher aux fichiers préfixés par _
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 (.tar.gz), ou un patch, ou
un lien vers votre repository, 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 (en utilisant \appendix), il faut
penser à mettre l'ensemble des annexes (depuis \appendix jusqu'à la
fin de la dernière annexe) entre accolades. Ainsi, les sections de
l'article suivant ne seront pas considéré à tort comme des annexes.
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}")
* 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 auteurs
* 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". Nommez
explicitement vos images avec le préfixe bw- (exemple: bw-archi.pdf)
À défaut d'avoir une version papier, nous la convertirons à
l'aide la commande suivante:
$ convert archi.pdf -colorspace Gray bw-archi.pdf
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
* Faîtes 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}
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.
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 LaTeX 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 emet le message d'erreur suivant :
! LaTeX Error: File `ean13.tex' not found.
R) Il vous faut installer le package Debian texlive-fonts-extra.
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, 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@.