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

Contenu supprimé Contenu ajouté
+ onlysection
Aucun résumé des modifications
Ligne 13 :
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 wikisourceWikisource, 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 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 {{vert|<nowiki><pages /></nowiki>}}
 
== Fonctionnement de la balise <nowiki><pages /></nowiki> ==
La balise <nowiki><pages /></nowiki> permet de transclure à l’endroit où elle est utilisée, dans la page-feuille, une série de pages-sources, entières ou partielles, issues d’un livre dont on connaît la page d’index dans [[Aide:Espace « Livre »|l’espace livre]]. (Attentionattention : le numéro de page d’index du fichier, djvu ou pdf, est souvent différent du numéro de page du livre-papier.) 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
Ligne 44 :
|-
|{{vert|<nowiki><pages index="" from=1 to=10 step=2 /></nowiki>}}
|Affiche les pages 1, 3, 5, 7 et 9.
|-
|{{vert|<nowiki><pages index="" from=1 to=10 exclude="2-5,9" /></nowiki>}}
|Affiche les pages 1, 6, 7, 8 et 10.
|-
|{{vert|<nowiki><pages index="" include="2-5,9" /></nowiki>}}
|Affiche les pages 2, 3, 4, 5 et 9.
|}