Wikisource

« Aide:Transclusion » : différence entre les versions

Navigation interactive dans l’historique
← Modification précédenteModification suivante →
Contenu supprimé Contenu ajouté
VisuelWikicode
Aucun résumé des modifications
tentative d'utilisation du modèle {{tag}}
Balise : Révoqué
Ligne 6 :
| ariane2 =
| voiravant = [[Aide:Espace « Page »]] et [[Aide:Espace « Livre »]]
| descriptif = Cette page d’aide expose le principe général de la transclusion et sa mise en œuvre pratique au moyen de la balise <code><nowiki><{{tag|pages/></nowiki></code>|single}}.
| voiraussi = [[Aide:Transcription]]
| techno =
Ligne 16 :
}}
 
{{En bref|La transclusion permet d’inclure une page dans une autre.<br/>Pour transclure, il faut utiliser la balise <code><nowiki><{{tag|pages/></nowiki></code>|single}} dans l'espace principal.<br/>On appelle « page(s)-source(s) » la (ou les) page(s) à inclure et nomme « page-feuille » la page qui reçoit la (ou les) « page(s)-source(s) ».}}
 
{{Menu de navigation aide|état groupe3 = affiché}}
Ligne 24 :
Sur Wikisource, la transclusion est utilisée principalement pour inclure des pages de [[Aide:Espace « Page »|l’espace page]] dans l’espace principal. La transclusion est donc le plus souvent effectuée [[Aide:Qualité des pages|après relecture]] dans [[Aide:Espace « Page »|l’espace page]]. Il permet de présenter aux lecteurs un texte suivant sa structure logique : par parties, par chapitres, par poèmes… et non suivant le découpage physique des pages-papier.
 
Cette transclusion s’effectue à l’aide de la balise <code><nowiki><{{tag|pages /></nowiki></code>|single}}.
 
== Fonctionnement de la balise <nowiki><{{tag|pages /></nowiki>|single}} ==
La balise <code><nowiki><{{tag|pages /></nowiki></code>|single}} permet de transclure une ou des pages-sources à l’endroit où elle est utilisée dans la page-feuille. La page-feuille transclue entièrement ou partiellement des pages-sources, issues d’un livre (qui est dans [[Aide:Espace « Livre »|l’espace livre]] — appelé espace ''Index'' en anglais).
{{début encart coloré}}[[File:OOjs UI icon alert-progressive.svg|20px]] Le numéro de page d’index du fichier, djvu ou pdf, est souvent différent du numéro de page du livre-papier.{{fin encart}}
Les attributs que l’on peut préciser à l’intérieur de la balise sont les suivantes :
Ligne 123 :
!scope="col" width="50%"| Description du rendu
|-
|<code><nowiki><{{tag|pages index|content={{=}}"Baudelaire - Les Fleurs du mal 1857.djvu" from{{=}}"106" to{{=}}"107" /></nowiki></code>|single}}
|Transclure les pages 106 à 107 du livre [[Index:Baudelaire - Les Fleurs du mal 1857.djvu|Baudelaire - Les Fleurs du mal 1857.djvu]].
|-
|<code><nowiki><{{tag|pages index|content={{=}}"Dickens - La Petite Dorrit - Tome 2.djvu" from{{=}}"16" fromsection{{=}}"chap2" to{{=}}"20" tosection{{=}}"chap2" /></nowiki></code>|single}}
|Transclure les pages 16 à 20 du livre [[Index:Dickens - La Petite Dorrit - Tome 2.djvu|Dickens - La Petite Dorrit - Tome 2.djvu]]. Pour la page 16, transclure uniquement la section « chap2 », pour la page 20 transclure uniquement la section « chap2 ».
|-
|<code><nowiki><{{tag|pages index|content={{=}}"" from{{=}}"1" to{{=}}"10" step{{=}}2 /></nowiki></code>|single}}
|Affiche les pages 1, 3, 5, 7 et 9.
|-
|<code><nowiki><{{tag|pages index|content={{=}}"" from{{=}}"1" to{{=}}"10" exclude{{=}}"2-5,9" /></nowiki></code>|single}}
|Affiche les pages 1, 6, 7, 8 et 10.
|-
|<code><nowiki><{{tag|pages index|content={{=}}"" include{{=}}"2-5,9" /></nowiki></code>|single}}
|Affiche les pages 2, 3, 4, 5 et 9.
|}
Ligne 160 :
!scope="col" width="50%"| Description du rendu
|-
|<code><nowiki><{{tag|pages index|content={{=}}"Dickens - La Petite Dorrit - Tome 2.djvu" from{{=}}"16" to{{=}}"20" header{{=}}1/></nowiki></code>|single}}
|Transclure les pages 16 à 20 du livre [[Index:Dickens - La Petite Dorrit - Tome 2.djvu|Dickens - La Petite Dorrit - Tome 2.djvu]], boîte de titre avec navigateur. [[La Petite Dorrit/Tome 2/Chapitre 2|Résultat]]. Noter que les liens vers le texte suivant et le texte précédent sont ceux qui apparaissent autour du texte dans le sommaire sur la [[Livre:Dickens - La Petite Dorrit - Tome 2.djvu|page d’index]] du Livre.
|-
|<code><nowiki><{{tag|pages index|content={{=}}"Verlaine - Œuvres complètes, Vanier, I.djvu" from{{=}}"440" fromsection{{=}}"s2" to{{=}}"442" header{{=}}Sommaire /></nowiki></code>|single}}
|Transclure les pages 440 à 442 du livre [[Index:Verlaine - Œuvres complètes, Vanier, I.djvu|Verlaine - Œuvres complètes, Vanier, I.djvu]]. Boîte de titre sans navigateur. [[Jadis et naguère (1902)|Résultat]].
|-
|<code><nowiki><{{tag|pages index|content={{=}}"Bloy - Les Dernières Colonnes de l’Église, Mercure de France, 1903.djvu"/></nowiki></code>|single}}
|Transclure le sommaire du livre [[Index:Bloy - Les Dernières Colonnes de l’Église, Mercure de France, 1903.djvu|Bloy - Les Dernières Colonnes de l’Église, Mercure de France, 1903.djvu]]. [[Les Dernières Colonnes de l’Église|Résultat]].
|}
Ligne 175 :
* '''Autre''' : auteur, titre, traducteur, éditeur, année, volume, intervalle de pages.
 
Il est possible de définir les informations utilisées ci-dessus à l’intérieur de la balise <code><nowiki><{{tag|pages /></nowiki></code>|single}} pour outrepasser la valeur définie dans la page d’index du livre. Cela peut être utile dans le cas d’un recueil d’ouvrages de différents auteurs : chaque texte du recueil doit redéfinir son propre auteur.
 
Exemple :
Ligne 183 :
!scope="col" width="50%"| Description du rendu
|-
|<code><nowiki><{{tag|pages index|content=header{{=}}1 auteur{{=}}"[[Auteur:Victor Cousin|Victor Cousin]]" index{{=}}"Journal des économistes, 1846, T16.djvu" from{{=}}"147" to{{=}}"152" /></nowiki></code>
|Transclure les pages 147 à 152, l’auteur affiché sera [[Auteur:Victor Cousin|Victor Cousin]] qui est différent de l’auteur indiqué dans la [[Index:Journal des économistes, 1846, T16.djvu|page d’index]] (non renseigné). [[Adam Smith et ses ouvrages|Résultat]].
|}
Récupérée de « https://fr.wikisource.org/wiki/Aide:Transclusion »