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 à
actes@lists.sstic.org. 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@.