Aide:Transclusion : Différence entre versions

De EncyclopAtys

m
m
 
(21 révisions intermédiaires par 2 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
{{Trad
+
<noinclude>{{Trad
|DE=
+
|DE=Hilfe:Transklusion
 
|EN=Help:Transclusion
 
|EN=Help:Transclusion
 
|ES=
 
|ES=
 
|FR=Aide:Transclusion
 
|FR=Aide:Transclusion
 
|RU=
 
|RU=
}}  
+
}} </noinclude>
  
 +
<includeonly>
 +
La '''transclusion''' signifie l'inclusion du contenu d'un document dans un autre document par référence. Il s'agit de l'utilisation de la fonction modèle de MediaWiki pour inclure le même contenu dans de multiples documents sans avoir à éditer chacun de ces documents séparément.
 +
</includeonly>
 +
==Transclusion==
 +
Dans la transclusion Wikipédia, le logiciel MediaWiki se référera au contenu d'une page, le modèle, pour l'inclure dans le contenu de toute autre page, la page cible. De la même manière que tout nom de page peut devenir un lien en plaçant son nom entre doubles crochets, tout nom de page peut devenir un modèle en le plaçant entre doubles accolades, '''<nowiki>{{Namespace:Pagename}}</nowiki>'''. Les modifications apportées au modèle sont alors automatiquement répercutées sur toutes les pages dans lesquelles cette page a été intégrée (bien qu'une '''purge''' puisse parfois être nécessaire).
  
La '''transclusion''' signifie l'inclusion du contenu d'un document dans un autre document par référence. Dans la transclusion Wikipédia, le logiciel MediaWiki se référera au contenu d'une page, le modèle, pour l'inclure dans le contenu de toute autre page, la page cible. De la même manière que tout nom de page peut devenir un lien en plaçant son nom entre doubles crochets, tout nom de page peut devenir un modèle en le plaçant entre doubles accolades, '''<nowiki>{{Namespace:Pagename}}</nowiki>'''. Les modifications apportées au modèle sont alors automatiquement répercutées sur toutes les pages dans lesquelles cette page a été intégrée (bien qu'une '''purge''' puisse parfois être nécessaire).
+
Si le nom de la page du modèle ne commence pas par un espace de noms, il est supposé se trouver dans l'espace de noms du modèle. Pour faire référence à une page dans l'espace de noms "Main" (article), il est nécessaire de la faire précéder d'un deux-points ( :).  
  
Si le nom de la page du modèle ne commence pas par un espace de noms, il est supposé se trouver dans l'espace de noms du modèle. Pour faire référence à une page dans l'espace de noms "Main" (article), il est nécessaire de la faire précéder d'un deux-points ( :).
+
Des exemples de '''syntaxe''': Si la source est dans
 +
* l'espace de noms des modèles (par exemple "Template:Welcome"), utilisez simplement le nom du modèle tout seul : '''<nowiki>{{Welcome}}</nowiki>'''
 +
*l'espace de noms principal (par exemple "Lore"), vous devez placer un symbole « deux points » devant le nom : '''<nowiki>{{:Lore}}</nowiki>'''
 +
* tout autre espace de noms (par exemple "User:Example"), vous devez utiliser le nom complet incluant l'espace de noms : '''<nowiki>{{User:Example}}</nowiki>'''
 +
*Si la source est une sous-page de la page cible, (comme « Transclusion/ja »), vous pouvez spécifier simplement le nom de la sous-page indépendamment de l'espace de noms : '''<nowiki>{{/ja}}</nowiki>'''
  
==balises associées==
+
===Balises associées aux transclusions partielles===
 
Les balises associées sont <nowiki><noinclude></nowiki>, <nowiki><onlyinclude></nowiki> et <nowiki><includeonly></nowiki>.
 
Les balises associées sont <nowiki><noinclude></nowiki>, <nowiki><onlyinclude></nowiki> et <nowiki><includeonly></nowiki>.
  
 
La transclusion montrera toute la page (avec les flags de traduction, les catégories etc). Ces 3 balises permettent de choisir ce qui sera montré ou non de la page source.
 
La transclusion montrera toute la page (avec les flags de traduction, les catégories etc). Ces 3 balises permettent de choisir ce qui sera montré ou non de la page source.
* typiquement, on met les catégories (code en bas de page) entre <nowiki><noinclude></nowiki> et <nowiki></noinclude></nowiki>
+
 
*  
+
 
 +
{| class="wikitable"
 +
|-
 +
! Code wiki !! Ce qui sera affiché ici (page source) !! Ce qui sera affiché lors de la transclusion<br /> (page de destination, où on a mis <nowiki>{{:sous-page}}</nowiki>)
 +
|-
 +
| <nowiki><noinclude>text1</noinclude></nowiki> text2  || text1 text2 || text2
 +
|-
 +
| <nowiki><onlyinclude>text1</onlyinclude></nowiki> text2  || text1 text2 || text1
 +
|-
 +
| <nowiki><includeonly>text1</includeonly></nowiki> text2 || text2 || text1 text2
 +
|}
 +
 
 +
 
 +
 
 +
* typiquement, on met les catégories (code en bas de page) et les flags de traduction entre <nowiki><noinclude></nowiki> et <nowiki></noinclude></nowiki>
 +
* '''includeonly''' est simple (voir l'exemple sur cette page): le texte entre les balises
 +
** sera uniquement utilisé lorsque la page sera transclue depuis une autre page,
 +
** et n'apparaîtra pas sur la page elle-même
 +
* '''onlyinclude''' ressemble à includeonly mais en plus complexe.
 +
** Elle l'emporte souvent sur les autres. Cela peut être utile, par exemple, pour répéter une petite partie d'une page sur une deuxième : il suffit d'entourer la petite partie par des balises "onlyinclude" et de l'inclure sur la deuxième page.
 +
**Contrairement à <nowiki><noinclude></nowiki> et <nowiki><includeonly></nowiki>, <nowiki><onlyinclude></nowiki> aura la priorité sur l'insertion de balises '''<nowiki><nowiki></nowiki>'''. En d'autres termes, <nowiki><nowiki><onlyinclude>Un texte</onlyinclude></nowiki></nowiki> ne produit que "Un texte" lorsqu'il est transclu.
 +
 
 +
===Pages spéciales===
 +
Certaines pages sur Special:Specialpages peuvent être transcluses, comme Special:AllPages, Special:PrefixIndex, Special:NewFiles, Special:NewPages, Special:RecentChanges et Special:RecentChangesLinked. Les paramètres d'URL peuvent être passés comme des paramètres de modèle, par exemple : <nowiki>{{Special:RecentChanges|namespace=10|limit=5}}</nowiki>, qui produit: {{Special:RecentChanges|namespace=10|limit=5}}.
 +
 
 +
Ne fonctionne pas entre les wiki FR/EN etc (erreur ngnix 301).
 +
 
 +
==Modèles pour le surf IG==
 +
On souhaite pouvoir récupérer dans le jeu des parties du wiki.
 +
 
 +
Pour ceci, des modèles ont été créés, sous la [[:Catégorie:IGtemplate|Catégorie:IGtemplate]] : tout ce qui est entre  <nowiki>{{IGstart}} et {{IGend}}</nowiki> seront visibles dans le jeu.
  
 
== Notes et liens ==
 
== Notes et liens ==
 
* Source: [https://en.wikipedia.org/wiki/Wikipedia:Transclusion transclusion] (page en anglais).
 
* Source: [https://en.wikipedia.org/wiki/Wikipedia:Transclusion transclusion] (page en anglais).
 
* https://www.mediawiki.org/wiki/Transclusion/fr
 
* https://www.mediawiki.org/wiki/Transclusion/fr
 +
* Sur les  paramètres d'URL  https://www.mediawiki.org/wiki/Manual:Parameters_to_index.php/fr
 +
 +
* Sur les ns (namespaces) du wiki FR: [[Guide Technique du wiki/FR ns liste]]
  
[[catégorie:Aide]]
+
[[catégorie:Aide|Transclusion]]

Version actuelle datée du 1 décembre 2021 à 00:32

de:Hilfe:Transklusion
en:Help:Transclusion
fr:Aide:Transclusion


Transclusion

Dans la transclusion Wikipédia, le logiciel MediaWiki se référera au contenu d'une page, le modèle, pour l'inclure dans le contenu de toute autre page, la page cible. De la même manière que tout nom de page peut devenir un lien en plaçant son nom entre doubles crochets, tout nom de page peut devenir un modèle en le plaçant entre doubles accolades, {{Namespace:Pagename}}. Les modifications apportées au modèle sont alors automatiquement répercutées sur toutes les pages dans lesquelles cette page a été intégrée (bien qu'une purge puisse parfois être nécessaire).

Si le nom de la page du modèle ne commence pas par un espace de noms, il est supposé se trouver dans l'espace de noms du modèle. Pour faire référence à une page dans l'espace de noms "Main" (article), il est nécessaire de la faire précéder d'un deux-points ( :).

Des exemples de syntaxe: Si la source est dans

  • l'espace de noms des modèles (par exemple "Template:Welcome"), utilisez simplement le nom du modèle tout seul : {{Welcome}}
  • l'espace de noms principal (par exemple "Lore"), vous devez placer un symbole « deux points » devant le nom : {{:Lore}}
  • tout autre espace de noms (par exemple "User:Example"), vous devez utiliser le nom complet incluant l'espace de noms : {{User:Example}}
  • Si la source est une sous-page de la page cible, (comme « Transclusion/ja »), vous pouvez spécifier simplement le nom de la sous-page indépendamment de l'espace de noms : {{/ja}}

Balises associées aux transclusions partielles

Les balises associées sont <noinclude>, <onlyinclude> et <includeonly>.

La transclusion montrera toute la page (avec les flags de traduction, les catégories etc). Ces 3 balises permettent de choisir ce qui sera montré ou non de la page source.


Code wiki Ce qui sera affiché ici (page source) Ce qui sera affiché lors de la transclusion
(page de destination, où on a mis {{:sous-page}})
<noinclude>text1</noinclude> text2 text1 text2 text2
<onlyinclude>text1</onlyinclude> text2 text1 text2 text1
<includeonly>text1</includeonly> text2 text2 text1 text2


  • typiquement, on met les catégories (code en bas de page) et les flags de traduction entre <noinclude> et </noinclude>
  • includeonly est simple (voir l'exemple sur cette page): le texte entre les balises
    • sera uniquement utilisé lorsque la page sera transclue depuis une autre page,
    • et n'apparaîtra pas sur la page elle-même
  • onlyinclude ressemble à includeonly mais en plus complexe.
    • Elle l'emporte souvent sur les autres. Cela peut être utile, par exemple, pour répéter une petite partie d'une page sur une deuxième : il suffit d'entourer la petite partie par des balises "onlyinclude" et de l'inclure sur la deuxième page.
    • Contrairement à <noinclude> et <includeonly>, <onlyinclude> aura la priorité sur l'insertion de balises <nowiki>. En d'autres termes, <nowiki><onlyinclude>Un texte</onlyinclude></nowiki> ne produit que "Un texte" lorsqu'il est transclu.

Pages spéciales

Certaines pages sur Special:Specialpages peuvent être transcluses, comme Special:AllPages, Special:PrefixIndex, Special:NewFiles, Special:NewPages, Special:RecentChanges et Special:RecentChangesLinked. Les paramètres d'URL peuvent être passés comme des paramètres de modèle, par exemple : {{Special:RecentChanges|namespace=10|limit=5}}, qui produit:

26 novembre 2024

     14:04  Modèle:ColorAtys‎ (diff | hist) . . (+26). . Zorroargh (discussion | contributions)
.

Ne fonctionne pas entre les wiki FR/EN etc (erreur ngnix 301).

Modèles pour le surf IG

On souhaite pouvoir récupérer dans le jeu des parties du wiki.

Pour ceci, des modèles ont été créés, sous la Catégorie:IGtemplate : tout ce qui est entre {{IGstart}} et {{IGend}} seront visibles dans le jeu.

Notes et liens