Fabriquer les .tex puis le .PDF

Maintenant que votre livre est rédigé en version web grâce au squelette documentation, il s’agit de produire le PDF, pour ensuite l’imprimer.

Ceci se passe en deux étapes :
-  générer un ensemble de fichiers .tex
-  passer ces fichiers dans le « compilateur » LaTeX pour produire le PDF.

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.

-  En outre

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.

Dernière modification de cette page le 20 février 2019

Discussion

Une discussion

  • 4

    Bonjour,

    Testé avec succès, avec un spip 3.2.3, l’ensemble de plugins :
    documentation, latexwheel, zippeur, documentation2latex, et suivant_precedent

    De petites modifications dans le fichier paquet.xml des plugins suivants ont été nécessaires :

    • documentation :
      1. <necessite nom="zcore" compatibilite="[2.0.6;]" />
    • latexwheel et documentation2latex :
      1. compatibilite="[3.0.0;3.2.*]"
    • remplacer ’Gill Sans" par ’FreeSans’ (p.ex) à la ligne 4 de inclure/preambule.tex fourni par le .zip créé afin que le compliateur xelatex ne butte pas sur une police introuvable sur mon ubuntu
      1. \setsansfont[Scale=MatchLowercase,Mapping=tex-text]{FreeSans}

    Donc, cela semble bien tourner sous spip3.2 :-)
    Je suis ravi
    Merci les développeurs !

    • Merci pour ces tests et ces retours.
      Concernant les compatibilités
      https://zone.spip.net/trac/spip-zone/changeset/113894/spip-zone
      https://zone.spip.net/trac/spip-zone/changeset/113896/spip-zone

      les indiques pour les plugins latex

      concernant le plugin documentation, comme j’en suis pas l’auteur, je préfère en parler avec Marcimat avant de commiter

      concernant la police... je ne sais pas trop quoi faire. Parce que « FreeSans » n’est pas livré avec les deux os dominants (bien que propriétaire). Donc je suis très hésitant.

    • Salut,

      concernant le squelette « documentation » tu es sur qu’il ne nécessite pas zpip ?

    • bonjour,

      1. Test zcore concernant le plugin documentation,version 3.0.11
      — renommage de squelettes-dist en squelettes-distant,
      — Vidé cache spip le site donne l’image jointe. (*)
      — Excepté les squelettes : inclure/documents et formulaires/administration, tout fonctionne.
      Donc avec squelettes-dist réactivé, zcore semble fonctionnel avec plugin documentation, voir image jointe (*)
      zpip en version 1 n’est plus maintenu et est devenu zpip-dist

      2 plugin documentation 3.0.11 :
      bug dans squelette documentation/v.3.0.11/inclure/forum.html lignes 63 et 69
      De : [ (#EXPOSE)][(#ID_OBJET|me#OBJET,#ID_AUTEUR)me]
      En : [ (#EXPOSE)][(#ID_OBJET|me#OBJET,#ID_AUTEUR)]
      idem ligne 69

      3 La police FreeSans, a été mise à titre d’exemple, je suppose que toute autre police Sans fonctionnera.

      4 je n’utilise pas le plugin_latex que tu mentionnes en lien

      (*) le site est en test et en mode maintenance, donc pas d’accès public.

    • Bonjour,
      En renommant squelettes-dist cela fonctionne (avec 2 squelettes introuvables dans ce cas) donc avec le squelette-dist restauré, c’est pour moi bon.

    Répondre à ce message

Ajouter un commentaire

Qui êtes-vous ?

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom