|
<div id="test">
{{Fil d'Ariane aide}}
* ''[[Le Second Hippias]]'', traduction [[Auteur:Victor Cousin|Victor Cousin]]
{| border="0" cellpadding="3" cellspacing="15" align="center" width="100%"
* ''[[Hippias mineur (trad. Chambry)|Hippias mineur]]'', traduction [[Auteur:Émile Chambry|Émile Chambry]]
| style="background: #efefef" |
</div>
'''Prérequis :''' [[Aide:Espace « Page »|Espace « Page »]], [[Aide:Espace « Livre »|Espace « Livre »]]
La transclusion (voir [[wiktionary:fr:transclusion|définition]]) est, dans le domaine informatique, l’action d’inclure une page dans une autre de façon dynamique. La transclusion est différente de la copie : en effet, toute modification de la page incluse sera automatiquement et immédiatement répercutée sur la page hôte.
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 après relecture dans [[Aide:Espace « Page »|l’espace page]], et permet de présenter aux lecteurs un texte suivant sa structue logique : par parties, par chapitres, par poèmes, etc. et non suivant sa structure physique.
Cette transclusion s’effectue à l’aide de la balise {{vert|<nowiki><pages /></nowiki>}}
|}
== Fonctionnement de la balise <nowiki><pages /></nowiki> ==
Cette balise permet de transclure à l’endroit où elle est utilisée un intervalle de pages d’un livre dont on connait la page d’index dans [[Aide:Espace « Livre »|l’espace livre]]. Les attributs que l’on peut préciser à l’intérieur de la balise sont :
* '''index''' (''obligatoire'') : le nom de la page d’index du livre, sans {{vert|Livre:}} au début du nom
* '''from''' (''optionnel'') : la page du début de l’intervalle de pages à transclure
* '''fromsection''' (''optionnel''): pour la page {{vert|from}}, transclure uniquement la section indiquée
* '''to''' (''optionnel'') : la page de fin de l’intervalle de pages à transclure
* '''tosection''' (''optionnel''): pour la page {{vert|to}}, transclure uniquement la section indiquée
* '''header''' (''optionnel''): voir [[#Header|Header]]
Exemples :
{| class="wikitable"
! code !! effet produit
|-
|{{vert|<nowiki><pages index="Baudelaire - Les Fleurs du mal 1857.djvu" from=106 to=107 /></nowiki>}}
|Transclure les pages 106 à 107 du livre [[Index:Baudelaire - Les Fleurs du mal 1857.djvu|Baudelaire - Les Fleurs du mal 1857.djvu]]
|-
|{{vert|<nowiki><pages index="Dickens - La Petite Dorrit - Tome 2.djvu" from=16 fromsection=chap2 to=20 tosection=chap2 /></nowiki>}}
|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 {{vert|chap2}}, pour la page 20 transclure uniquement la section {{vert|chap2}}.
|}
Les numéros de page affichés sur le côté des pages transcluses sont les numéros associés à ces pages sur la page d’index du livre. Voir [[Aide:Espace_«_Livre_»#Liste_des_pages|l’aide de l’espace « Livre »]] pour introduire des décalages dans la numérotation.
Si l’attribut {{vert|from}} est présent sans l’attribut {{vert|to}}, alors ce dernier est fixé par défaut à la dernière page du livre : les pages sont transcluses jusqu’à la fin du livre.
Si ni {{vert|from}} ni {{vert|to}} ne sont présents, alors on obtient une transclusion du sommaire du livre tel qu’il apparaît sur la page d’index du Livre, précédé d’une boîte de titre reprenant les informations de cette page (voir [[#Header|Header]]).
== Header ==
L’attribut {{vert|header}} permet d’afficher une boîte de titre au-dessus des pages transcluses. Cette boîte de titre reprend les informations présentes sur la page d’index du livre d’où proviennent les pages transcluses : titre, auteur, édition, etc. Les valeurs possibles pour l’attribut {{vert|header}} sont :
* '''header=1''' : boîte de titre avec navigateur. On obtient en dessous de la boîte de titre un ''navigateur'' comportant un lien vers le texte précédent et un lien vers le texte suivant le texte courant. Ces liens sont obtenus automatiquement depuis les liens figurant dans le sommaire présent sur la page d’index du livre.
* '''header=Sommaire''' : boîte de titre sans navigateur, seules les informations présentes sur la page d’index sont reprises. Il n’y a pas de liens vers le texte précédent et suivant le texte courant. L’intervalle des pages transcluses n’est pas non plus indiqué.
Comme mentionné plus haut, lorsque ni {{vert|from}} ni {{vert|to}} ne sont spécifiés dans la balise {{vert|<nowiki><pages /></nowiki>}}, on obtient une transclusion du sommaire du livre. La boîte de titre a alors la même apparence qu’avec {{vert|<nowiki>header=Sommaire</nowiki>}}.
Exemples :
{| class="wikitable"
! code !! effet produit
|-
|{{vert|<nowiki><pages index="Dickens - La Petite Dorrit - Tome 2.djvu" from=16 to=20 header=1/></nowiki>}}
|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 textes 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.
|-
|{{vert|<nowiki><pages index="Verlaine - Œuvres complètes, Vanier, I.djvu" from=440 fromsection=s2 to=442 header=Sommaire /></nowiki>}}
|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]]
|-
|{{vert|<nowiki><pages index="Bloy - Les Dernières Colonnes de l’Église, Mercure de France, 1903.djvu"/></nowiki>}}
|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]].
|}
L’apparence de la boîte de titre dépend du type de l’ouvrage indiqué dans le champ ''Type'' (menu déroulant) du formulaire de modification de la page d’index de l’ouvrage :
* '''Journal ou revue''' (''nom technique : journal'') : auteur, nom de la page, titre, volume, année, intervalle de pages
* '''Recueil''' (''nom technique : collection'') : auteur, nom de la page, recueil, titre, éditeur scientifique, éditeur, année, intervalle de pages
* '''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 {{vert|<nowiki><pages /></nowiki>}} 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 :
{| class="wikitable"
! code !! effet produit
|-
|{{vert|<nowiki><pages header=1 auteur="[[Victor Cousin]]" index="Journal des économistes, 1846, T16.djvu" from=147 to=152 /></nowiki>}}
|Transclure les pages 147 à 152, l’auteur affiché sera [[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]]
|}
== FAQ ==
=== Comment traiter le cas des recueils ===
=== Comment inclure plusieurs pages dans un même tableau lors de la transclusion ? ===
Si un élément logique (par exemple un tableau) occupe plusieurs pages, il est possible d'utiliser des commandes noinclude et includeonly. Exemple : [[Œuvres de Fermat - I - Partie 2]], voir question XXVIII.
== Voir aussi ==
* [[Modèle:Proofreadpage header template]] pour des détails techniques sur le modèle utilisé par la boîte de titre.
| 