SPIP-Contrib

SPIP-Contrib

عربي | Deutsch | English | Español | français | italiano | Nederlands

288 Plugins, 197 contribs sur SPIP-Zone, 183 visiteurs en ce moment

Accueil > Contribs dédiées > Livre avec SPIP > Archives ZipTeX > Référence de ZipTeX

Référence de ZipTeX

22 janvier 2012 – par Maïeul

Ceci est une archive périmée mais qui reste intéressante, parfois autant pour l’article que les commentaires associés.

Ceci est une ARCHIVE, peut-être périmée. Vérifiez bien les compatibilités !

Depuis Mars 2012, cet article n’a plus lieu d’être. On se reportera au nouveau tutoriel sur la création de modèle personnalisé de livre.

Cet articles est la documentation technique du plugin ZipTeX, qui permet de mettre dans un même zip plusieurs fichiers .tex. Il sert dans les projets de fabrication d’un livre à partir d’une base de donnée SPIP.

On se reportera au tutoriel pour une première approche.

On consultera aussi la documentation sur la balise #ARRAY, qui est beaucoup utilisée dans ziptex.

À chaque fois que nous parlerons de chemin, sauf si nous précisons « à l’intérieur de ziptex, la notion de chemin s’entend au sens SPIP.

Rappelons aussi que ce plugin nécessite le plugin zippeur

Le filtre |ziptex_zipper

C’est le filtre de base. Il zippe le dossier local/ziptex et retourne l’url du Zip.

Mais avant de zipper, le filtre peut ajouter du contenu dans le dossier local/ziptex.

Pour ce faire, il reçoit un tableau, généré via #ARRAY, dont la structure est la suivante :

  • 0. Un tableau contenant les .tex direct, c’est à dire sans code SPIP dedans, avec à chaque fois :
    • 0. Chemin du fichier .tex dans l’arborescence SPIP
    • 1. Chemin du fichier .tex dans le future ZIP
  • 1. Un tableau contenant les squelettes qui généreront du latex avec à chaque fois :
    • 0. Chemin du squelette, sans le .html
    • 1. Chemin du .tex correspondant, avec le .tex
    • 2. Option du squelette

Il retourne le chemin du zip.
Exemple : générer un zip contenant :

  1. #SET{tableau,
  2. #ARRAY{
  3. 0,#ARRAY{
  4. 0,#ARRAY{0,latexmk,1,latexmk}
  5. },
  6. 1,#ARRAY{
  7. 0,#ARRAY{
  8. 0,principal.tex,
  9. 1,principal.tex,
  10. 2,#ARRAY{id_rubrique,#ID_RUBRIQUE}
  11. }
  12. }
  13. }
  14. }
  15.  
  16. [(#GET{tableau}|ziptex_zipper)]

Télécharger

Le filtre |ziptex_creer_tex

Produit à partir du squelette un fichier .tex dans le dossier ziptex.

S’applique sur le nom du squelette (sans le .html), le premier argurment est le chemin du fichier à produire dans ziptex, le second est un tableau des arguments à passer au squelette.

Exemple :

  1. [(#REM)Créer un fichier articlexxx.tex depuis le squelette article.tex, en fournissant l'id_article]
  2. <BOUCLE_articles(ARTICLES)
  3. [(#VAL{article.tex}|ziptex_creer_tex{inclure/article#ID_ARTICLE.tex,#ARRAY{id_article,#ID_ARTICLE}})]
  4. </BOUCLE_articles>

Télécharger

Le filtre |ziptex_dir

Il s’applique sur un tableau généré via #ARRAY. Il crée dans le dossier ziptex des sous répertoires.

Exemple :

  1. [(#REM) Créer des dossiers inclure et img]
  2.  
  3. [(#SET{rep,#ARRAY{0,inclure,1,img}})]
  4.  
  5. [(#GET{rep}|ziptex_dir)]

Télécharger

Le filtre |ziptex_copier_tex

Copie un fichier .tex dans le dossier ziptex.

Exemple :

  1. [(#REM)Copier le fichier principal.tex dans ziptex]
  2.  
  3. [(#VAL{principal.tex}|ziptex_copier_tex{principal.tex})]

Télécharger

Le filtre ziptex_copier_img

Il est à utiliser dans les modèles d’insertion des images.

Ce filtre reçoit le chemin d’une image, mais le chemin absolue, pas au sens SPIP.

Si l’image est un .gif, il le convertit en .png.

Il copie ensuite l’image dans le dossier ziptex/IMG et retourne ensuite le nom du fichier dans le dossier IMG, précédé de #IMG.

Exemple : dans un modeles d’insertion d’image, on réduit d’abord l’image à 200 px de large, puis on copie dans ziptex/img.

  1. <BOUCLE_img(DOCUMENTS){id_document=#ENV{id}}>
  2.  
  3. \includegraphics{[(#URL_DOCUMENT|image_reduire{200}|extraire_attribut{src}|ziptex_copier_img)]}
  4.  
  5. </BOUCLE_img>

Télécharger

Le filtre ziptex_polyglossia

Il permet de convertir un code de langue fournit par SPIP via la balise #LANG en code de langue du package XeLaTeX polyglossia.

  1. [(#LANG|ziptex_polyglossia)]

Pour le moment, sont intégrés :
-  l’espagnol
-  l’anglais
-  le français

Pour ajouter une nouvelle langue :
-  soit faire la modification directement sur la zone
-  soit me demander de le faire

Dernière modification de cette page le 1er avril 2012

Retour en haut de la page

Répondre à cet article

Qui êtes-vous ?
  • [Se connecter]

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 Les choses à faire avant de poser une question (Prolégomènes aux rapports de bugs. )
Ajouter un document

Retour en haut de la page

Ça discute par ici

  • Mise à jour automatique des plugins

    5 octobre 2009 – 156 commentaires

    Une nouvelle lame du Couteau Suisse permet de visualiser les plugins nécessitant une mise à jour, tout comme SPIP lui-même ! Présentation Rendons à César ce qui est à César, voici un extrait de la présentation du Couteau Suisse pour sa lame « Mise (...)

  • Plugin Modèles media

    25 avril 2011 – 170 commentaires

    Les modèles , et produisent chacun un résultat différent et ce résultat, pour les images, dépend du fait qu’elle soit dans le portfolio ou non. Ce plugin propose une nouvelle série de modèles ayant un comportement unifié et indépendant du mode des (...)

  • Refonte de l’identité graphique

    10 juillet – 68 commentaires

    Lors de la SPIP Party 2017 à Toulouse, un nouveau contributeur est venu nous présenter son travail sur une refonte du logo. Au delà de la refonte du logo, c’est une toute nouvelle identité graphique pour SPIP que Jordan nous propose. Voici une (...)

  • Mailsubscribers

    16 janvier 2013 – 306 commentaires

    Ce plugin permet de gérer les inscriptions (ou abonnements) à la diffusion de contenu par email. Mailsubscribers permet de gérer les inscriptions par Opt-in simple ou double et la désinscription par URL. Ce plugin gère également plusieurs listes (...)

  • Saisies

    27 mars 2010 – 490 commentaires

    Introduction Créer un formulaire est une tâche toujours un peu répétitive : les champs ont souvent les mêmes propriétés, le même accompagnement (message d’erreur, explication, ...) et la même structure HTML. Ce plugin est un outil pour les développeurs (...)

Ça spipe par là