|
= Transclusion =
'''Prérequis :''' [[Aide:Espace « Page »|Espace « Page »]]
== <nowiki><pages /></nowiki> == ▼
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 dans l’espace principal des pages de l’espace « Page ». La transclusion est donc le plus souvent effectuée après relecture dans l’espace « Page », et permet de présenter aux lecteurs un texte découpé logiquement : par chapitres, par poèmes, etc.
Cette transclusion s’effectue à l’aide de la balise {{vert|<nowiki><pages /></nowiki>}}
▲== Fonctionnement de la balise <nowiki><pages /></nowiki> ==
La balise {{vert|<nowiki><pages /></nowiki>}} permet de transclure dans l’espace Principal un intervalle de pages de l’espace page. Les attributs que l’on peut préciser à l’intérieur de la balise sont :
Exemple : {{vert|<nowiki><pages header=1 auteur="[[Victor Cousin]]" index="Journal des économistes, 1846, T16.djvu" from=147 to=152 /></nowiki>}}
== Documentation de <nowiki>{{MediaWiki:Proofreadpage header template}}</nowiki> à l’usage des personnes souhaitant modifier ce modèle ==
L’apparence de l’en-tête automatique générée par la balise {{vert|<nowiki><pages /></nowiki>}} est définie par le modèle [[MediaWiki:Proofreadpage header template]]. Ce modèle utilise les paramètres suivant définis par l’extension ProofreadPage :
{|class="wikitable"
|-
! paramètre !! description
|-
|<nowiki>{{{from}}}</nowiki> || la valeur {{vert|from}} définie par l’utilisateur, 1 par défaut
|-
|<nowiki>{{{to}}}</nowiki> || la valeur {{vert|to}} définie par l’utilisateur, par défaut la dernière page
|-
|<nowiki>{{{current}}}</nowiki> || le nom du lien pointant vers la page courante dans le sommaire de la page d’index du Livre
|-
|<nowiki>{{{prev}}}</nowiki> || le nom du lien pointant vers la page précédant la page courante dans le sommaire de la page d’index du Livre
|-
|<nowiki>{{{next}}}</nowiki> || le nom du lien pointant vers la page suivant la page courante dans le sommaire de la page d’index du Livre
|-
|<nowiki>{{{value}}}</nowiki> || la valeur de l’attribut {{vert|header}} de la balise {{vert|<nowiki><pages /></nowiki>}}, ou {{vert|toc}} si ni {{vert|from}} ni {{vert|to}} ne sont précisés
|}
Les autres paramètres sont les noms des champs apparaissant dans le formulaire de l'index du Livre. Leur valeur est celle qui apparait dans le formulaire, sauf si l'utilisateur la redéfinie dans la balise {{vert|<nowiki><pages /></nowiki>}}, auquel cas, la valeur de la balise a priorité sur celle de l'index.
Pour le paramètre {{vert|<nowiki>{{{type}}}</nowiki>}}, la valeur apparaissant dans le menu déroulant du formulaire de la page d'index est convertie en un nom à usage interne suivant le tableau de correspondance suivant :
{|class="wikitable"
|-
! valeur interne !! valeur du menu déroulant
|-
| book ||Livre
|-
| collection || Recueil
|-
| journal || Journal ou revue
|-
| phdthesis || Thèse, rapport
|-
| dictionary || Dictionnaire, encyclopédie, ouvrage de référence
|}
C'est la valeur interne qui est utilisée par le modèle. De même, si l'utilisateur souhaite redéfinir la valeur du champ type à l'intérieur de la balise balise {{vert|<nowiki><pages /></nowiki>}}, il doit utiliser la valeur interne.
| 