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.
Aucune discussion
Ajouter un commentaire
Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :
Merci d’avance pour les personnes qui vous aideront !
Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.
Suivre les commentaires : |