Faire une copie locale

La génération de l’ensemble des fichiers .tex est assez energivore. En effet il faut dans une même action :
-  convertir les raccourcis SPIP en code LaTeX
-  créer l’ensemble des fichiers .tex depuis la base de donnée.
-  les mettre en ZIP.

Pour cette raison, nous recommandons lors du passage en .tex de faire une copie locale du site.

Pour ce faire, on se reportera à l’un des tutoriels suivant :
-  Pour Mac
-  Pour Windows

Une fois l’installation locale faite, il faut bien sûr récupérer le contenu de la base de donnée pour la copier en local. Ainsi que les éventuelles images du dossier IMG.

Générer les .tex

Pour générér les .tex, il faudra installer :
-  le plugin latexwheel, qui permet de convertir les raccourcis SPIP en code LaTeX.
-  le plugin Zippeur version 2, pour assembler un ensemble de fichiers .tex en un zip.
-  le jeu de squelettes documentation2latex qui proposent des squelettes produisants des fichiers .tex correspondants au squelette documentations.

Une fois cela fait, on se rendra sur la page adressedusiteenlocal/?page=generer-zip.

L’ordinateur va ramer un peu pour générer les zips. Donc c’est normal que la page ne s’affiche pas tout de suite. Mais après, une fois que la page s’affiche, il suffit de cliquer sur le liens pour récuperer le zip.

Fabriquer le fichier PDF à partir des fichiers .tex

-  Il faut disposer d’une installation LaTeX.

• Sous Windows : http://miktex.org/
• Sous Mac : https://www.tug.org/mactex/
• Sous Linux : https://www.tug.org/texlive/

-  En outre

• Si on utilise colorationcode ou si on cite du code, il faut installer pygments : http://pygments.org/docs/installation/. Il faut du coup faire un peu de ligne de commande.
• Si dans ce code coloré, il y a du code SPIP, il faut installer la coloration syntaxique pour SPIP dans Pygments.

La démarche varie selon que l’on utilise la coloration syntaxique ou non :
-  Si on n’utilise pas la coloration syntaxique, on peut utiliser une interface graphique pour compiler. Il faut ouvrir le fichier documentation.tex du dossier contenu dans le zip avec le logiciel TeXWorks. Dans le menu déroulant en haut de la fenêtre, choisir XeLaTeX puis cliquer sur le bouton vert.

Une première compilation (= transformation du .tex en .pdf se lance. Une fois achevée, il faut cliquer une deuxième fois sur le bouton vert. Puis une troisième fois, pour s’assurer que le sommaire soit correcte. Une fois cela fait, on trouve le .pdf à côté du fichier .tex
-  Si on utilise la coloration syntaxique, on doit utiliser la ligne de commande. Il faut alors se rendre dans le dossier du zip décompressé. Puis il faut frapper latexmk. Lorsque l’exécution est terminée (cela peut prendre plus ou moins de temps), on trouve le fichier .pdf à côté du fichier .tex.

Et si cela ne marche pas ?

-  Vérifier que tout les raccourcis SPIP sont bien appareillés.
-  M’écrire en me fournissant les fichiers .tex, pour que je puisse voir où est le problème (ou alors connaître LaTeX). C’est encore expérimental ! Me dire aussi le système sous lequel le fichier se fabrique.