Aide:Transclusion
La bibliothèque libre.
La transclusion est l’opération qui permet d’afficher une page de texte de l’espace "Page" dans l’espace principal. |
|
[modifier] Syntaxe
Une transclusion se pratique de la même façon que l’inclusion d’un modèle : il s’agit d’inclure un morceau de texte (le texte délimité physiquement aux dimensions de la page du livre dont on copie le fac-similé) dans la page qui recevra le texte délimité logiquement : poème, ou bien chapitre, ou bien acte d’une pièce de théâtre, ou même œuvre entière, page logique qui sera publiée dans l’espace principal de Wikisource.
On peut afficher non seulement le texte des pages mais aussi les numéros de ces pages, voici comment faire. Il y a deux méthodes possibles.
- Première méthode : on fait une transclusion à l’aide du modèle {{Page}} : celui-ci permet d’inclure une seule page à la fois. On peut bien sûr le récrire pour chaque page si on veut transclure plusieurs pages.
Exemple :
- {{Page|Baudelaire - Les Fleurs du mal 1857.djvu/106|num=101}}
- {{Page|Baudelaire - Les Fleurs du mal 1857.djvu/107|num=102}}
affichera les pages 106 et 107 du fichier djvu, pages qui, décalées, correspondront aux numéros de pages 101 et 102 sur les fac-similés. D’où la commande num=101 pour indiquer au logiciel qu’il doit afficher le numéro de page 101.
Voir le résultat ici.
- Deuxième méthode : la commande <pages /> permet d’inclure non plus seulement une seule page, mais toute une série de pages. Elle permet aussi d’afficher les numéros des pages tels qu’ils sont définis en page d’index par la commande <pagelist /> (voir plus bas).
Exemple :
- <pages index="Baudelaire - Les Fleurs du mal 1857.djvu" from=106 to=107 />
aboutira au même résultat que les deux modèles Page employés ci-dessus. Les numéros de pages affichés seront 106 et 107 si on ne fait rien ; pour obtenir que 106 s’affiche en 101 et 107 en 102, il faudra avoir agi préalablement sur la page d’index de l’espace Livre et y avoir modifié la commande < pagelist /> comme suit :
Pour rejoindre la page d’index dans l’espace Livre :
- [[Livre:Baudelaire - Les Fleurs du mal 1857.djvu]]
Dans la fenêtre d’édition de cette page d’index, modifier la commande pagelist comme suit :
- <pagelist 106=101 />
En utilisant l’une ou l’autre de ces deux méthodes, les numéros de page s’affichent à gauche du texte[1].
[modifier] FAQ
- Comment n'inclure qu'une partie d'une page lors de la transclusion ?
- Si un découpage logique (par exemple une fin de chapitre) a lieu au milieu d'une page, il est possible de ne faire apparaître que la partie désirée de la page lors de la transclusion. Pour cela, il faut utiliser une transclusion partielle.
- La syntaxe pour inclure une section avec la commande <pages /> est la suivante :
- <pages index="Titre-de-l’index.djvu" from=numéro-de-la-première-page fromsection=nom-de-la-section to=numéro-de-la-dernière-page tosection=nom-de-la-section />
- Comment placer automatiquement un navigateur en haut de page dans l’espace principal ?
- Pour que l’en-tête soit rempli automatiquement, il faut placer la commande header dans la commande Pages. Le logiciel prendra ses informations sur la page d’index de l’espace Livre: titre, auteur, numéros et éventuellement titres des chapitres s’ils figurent dans le sommaire de la page d’index. Syntaxe à employer :
- <pages index="Titre-de-l’index.djvu" from=numéro-de-la-première-page to=numéro-de-la-dernière-page header=1 />
-
- Exemple :
-
- <pages index="Dickens - La Petite Dorrit - Tome 2.djvu" from=39 fromsection=chap5 to=54 tosection=chap5 header=1 />
-
- Voir le résultat ici
- 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.
[modifier] Notes
- ↑ S’ils ne sont pas visibles, cliquer sur « liens vers les pages » dans les « options d’affichage » sous la « boîte à outils » à gauche de l’écran.
