SPIP-Contrib

SPIP-Contrib

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

286 Plugins, 197 contribs sur SPIP-Zone, 236 visiteurs en ce moment

Accueil > Contribs dédiées > Livre avec SPIP > Utiliser le squelette « Documentation » pour rédiger un livre

Utiliser le squelette « Documentation » pour rédiger un livre

17 janvier 2012 – par Maïeul

4 votes

La manière la plus simple pour se lancer dans le projet « un livre avec SPIP » est d’utiliser le squelette documentation pour SPIP 3.

Ce squelette est celui utilisé par le site de Marcimat Programmer avec SPIP, mais porté sur SPIP 3.

Dans cet article, j’explique comment installer et l’utiliser de manière à optimiser l’export en .tex.

Installation

Le squelette est distribué sous forme de plugin. Il s’installe comme n’importe quel plugin.

Toutefois il nécessite au minimum SPIP 3.

En outre il a besoin des plugins :
-  ZPIP 1.7.x
-  Critères precedent et suivant
-  Saisie
-  Champ extra 3

Utilisation

Arborescence

Puisque le but est d’utiliser le squelette pour ensuite fabriquer un .tex pour l’impression, il est bon de savoir comment est organisé la hiérachie des titres dans un fichier LaTeX.
Par défaut, tout les titres sont numérotés automatiquement. Voici les différents niveaux de titre, du plus important au plus faible.

Nom de titreCode LaTeXSpécificité lors de la conversion en PDF
Partie \part Le titre est sur une page de droite dédiée.
Chapitre \chapter Un chapitre commence en haut de page, sur une page de droite.
Section \section Une section provoque un changement de paragraphe.
Sous-section \subsection Une sous-section provoque un changement de paragraphe

Il existe également les niveaux \subsubsection, \paragraph et \subparagraph, mais ces nivaux ne sont pas utilisés lors de la génération des fichiers .tex par SPIP.

À ces niveaux de titre LaTeX correspondent des nivaux dans la hiérachie des rubriques.

-  Le premier niveau (secteur) correspond à un livre entier. Un secteur correspondant à une langue.
-  Le second niveau correspond à un partie au sens LaTeX (\part). Exemple de rubrique de niveau \part : http://programmer.spip.org/-Ecriture-des-squelettes-.
-  Le troisième niveau correspond à un chapitre au sens LaTeX (\chapter) http://programmer.spip.org/-Les-boucles-.
-  Un article correspond à une section au sens LaTeX (\section) http://programmer.spip.org/Syntaxe-des-boucles.
-  Les raccourcis {{{…}}} provoquent des sous-sections. (\subsection).

Contenu des articles
En plus du classique champs titre et texte, chaque article peut avoir un exemple, un exercice et une réponse à l’exercice. Le champ PS est également utilisé.

Lors de l’export en .tex, les trois champs supplémentaires (exemple, exercice, réponse) seront encadrés d’un code signalant qu’il faudra les mettre dans un cadre gris dans le PDF final.

Les champs exemple, exercice, réponse et PS seront précédés d’intertitres.

Ordre des rubriques / articles

Il est possible de ne pas écrire les rubriques / articles dans leur ordre logiques. Pour déterminer l’ordre des rubriques / articles, il suffit de faire précéder les titres d’un nombre, suivi d’un point, suivi d’un espace :

1. Rubrique qui apparaîtra en premier

Raccourcis typographique

On peut utiliser l’ensemble des raccourcis typographique de SPIP. Si on cite du code, il faut utiliser le plugin coloration code.

Un code entre <cadre> aura ses lignes numérotées, pas un code entre <code>.

Par ailleurs, le module LaTeX de gestion du code sources colorés n’est pas capable de couper automatiquement les lignes trop longues : il faut donc les limiter directement au sein des balises <cadre> ou <code> (60 caractères approximativement, si vous gardez les réglage de format de papier et de marge standard).

Production du PDF

La production du PDF est détaillé dans un autre article.

Dernière modification de cette page le 22 décembre 2013

Retour en haut de la page

Répondre à cet article

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

  • Cycle2

    7 août 2014 – 104 commentaires

    La seconde version de la librairie Javascript « jQuery Cycle », qui permet de produire des diaporamas, se nomme « Cycle2 » : http://jquery.malsup.com/cycle2/. Voici cette nouvelle librairie mise en plugin pour SPIP. Si vous utilisez déjà « jQuery (...)

  • CleverMail

    20 janvier 2010 – 635 commentaires

    CleverMail est un plugin permettant d’envoyer des lettres d’informations à des abonnés depuis SPIP. Issu au départ d’un développement libre complètement indépendant de SPIP, il a connu une première version pour SPIP 1.9 avant d’être complètement réécris (...)

  • SPMC : Squelette par mot clé V2.0

    21 septembre 2009 – 48 commentaires

    Ce plugin prend la suite de squelette par mot clef V1.92 qui ne fonctionnait plus sous SPIP 2.0.x. Avec l’accord de Mortimer qui n’a plus le temps de le maintenir, je prend donc la suite. Présentation du plugin « Squelette par mot clé V2.0 » Le (...)

  • Sarka-SPIP 3

    15 septembre 2009 – 211 commentaires

    Si la lignée 3 de Sarka-SPIP a été l’occasion de refaire presque entièrement le code du squelette elle continue à évoluer et à s’améliorer au fil des versions. Nous ne saurions trop conseiller aux nouveaux utilisateurs - et aussi aux anciens - (...)

  • Paiement avec Formidable

    16 février 2015 – 53 commentaires

    Ce plugin « Paiement avec Formidable » permet d’ajouter une étape de paiement à la fin de la saisie d’un formulaire créé par le plugin Formidable. Il le complète et nécessite par ailleurs le plugin bank qui gère l’interface technique avec les prestataires (...)