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 à
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.


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@.