Aide:Inclusion

De Wikimedica
Aller à : navigation, rechercher

L’inclusion (parfois aussi dénommée transclusion) désigne, de manière générale, la reproduction du contenu d’un document dans un autre document à l’aide d’une référence vers le premier document.[note 1] Dans Wikimedica, l’inclusion est un mécanisme qui consiste à reproduire tout ou partie du contenu d’une page dans une autre. Cette technique est très utilise, car elle permet d'éviter la duplication d'information. Si le contenu d'une page est amélioré, toutes les pages qui en font l'inclusion le seront aussi automatiquement. C'est d'ailleurs le principe derrière les modèles.

1 Comment l'inclusion fonctionne

Transclusion-simple.png
Une page B est crée et elle contient « foo », une donnée très utile.

Une page A fait l'inclusion de la page B, « foo » est reproduit sur la page B.

Transclusion-multiple-foo.png
Le contenu de la page B, « foo » peut être reproduit sur autant de pages que nécessaire.
Transclusion-multiple-twit.png
Le contenu de la page B,« foo » n'est plus d'actualité et doit être changé à « twit ».

Toutes les pages qui avaient inclut B sont automatiquement mis à jour.

Voyez-vous la pertinence de l'inclusion sur Wikimedica? Les exemples sont innombrables:
  • Un dosage pour un médicament qui change.
  • Les critères diagnostiques pour une maladie qui sont mis à jour.
  • etc.

2 Inclure du contenu avec l'Éditeur Visuel

La manière la plus simple d'inclure du contenu avec l'Éditeur Visuel est de se servir des modèles d'inclusions. Si vous ne savez pas comment vous servir des modèles, référez-vous à leur page d'aide.

Les inclusions ne sont pas à l'abris de bris si le contenu de la page d'origine change trop. L'utilisation des modèles d'inclusions permet d'identifier les pages contenant des inclusions brisées en les plaçant dans Catégorie:Pages avec des inclusions brisées.

2.1 Réparer une inclusion brisée

Vous trouverez les pages avec une inclusion brisée dans Catégorie:Pages avec des inclusions brisées. Sur la page, l'inclusion défectueuse sera marquée d'un « L'inclusion de puis la page Nom_de_la_page_source est brisée. ».

Les modèles d'inclusion requièrent tous le paramètre page qui indique le nom de la page source. Pour Modèle:Inclure une section d'une page, le paramètre section sera également spécifié et pour les modèles Modèle:Inclure une zone d'une page et Modèle:Inclure une page sauf une zone le paramètre zone sera spécifié. Pour plus de détails, consultez la documentation du modèle utilisé.

Réparer une inclusion consiste donc en trouver lequel des paramètres n'est plus valide. En règle général, ce sera les paramètres section ou zone qui seront en cause, car un utilisateur aura changé le nom d'une zone ou d'une section de la page source. Le nom des pages peut changer, mais l'inclusion fonctionne au travers des redirections, ce qui les protège des bris.

3 Inclure du contenu en wikicode

Comme avec l'Éditeur Visuel, l'utilisation des modèles d'inclusion est préconisée aussi en wikicode.

3.1 Définir une zone

Il est possible de définir une zone sur une page au moyen de balises spéciales:

<section begin=nom_de_la_zone />

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque lacinia id lacus sed varius. Quisque ultricies posuere lorem in ullamcorper. Morbi interdum ex et justo placerat sodales. Fusce dictum aliquam orci, quis elementum metus accumsan egestas. Nunc vehicula, turpis quis eleifend iaculis, tellus est rhoncus mauris, ut fringilla nisi eros vel est. In at convallis sapien. Sed justo nulla, aliquet ut dapibus id, eleifend vel diam. Morbi porta mauris odio, a laoreet sapien tincidunt a. Nam ultrices pellentesque massa, ut imperdiet lacus maximus in. Praesent gravida maximus felis, non ornare felis semper ac. Vestibulum sit amet ligula faucibus, lobortis est non, aliquet leo. Interdum et malesuada fames ac ante ipsum primis in faucibus. Vestibulum imperdiet nisi sed elit vehicula aliquet. Sed varius lacus sed urna tempor, nec auctor neque vehicula. Praesent pellentesque id nunc at posuere.

<section end=nom_de_la_zone />

3.2 Inclusion manuelle

L’inclusion d’une page X dans une page Y s’opère en plaçant le code {{X}} dans la page Y. Mais, en l’absence d’espace de noms (c'est-à-dire si X est un article), c’est le modèle Modèle:X (et non X) qui est inclus. Pour inclure un article A dans un article B, il faut utiliser le code {{:A}} dans la page B.

  • Si la page incluse est un article dans l'espace de noms principal (comme « Chat »), il faut mettre deux points en face du nom : {{:Chat}}.
  • Si la page incluse est dans l'espace de noms des modèles (comme « Modèle:Boîte »), il suffit d'écrire le nom seul : {{Boîte}}.
  • Si la page incluse est dans n'importe quel autre espace de noms (comme « User:Dcoetzee »), il faut écrire le nom entier, avec l'espace de noms : {{User:Dcoetzee}}

4 Éviter que du contenu d'une page soit inclus

Pour éviter que du contenu d'une page soit inclus, placez le entre les balises suivantes selon vos besoins, malheureusement, ces balises ne sont disponibles qu'en wikicode:

  • <noinlclude>...</noinclude>: ce contenu ne sera pas inclus;
  • <onlyinclude>...</onlyinclude>: seul ce contenu sera inclus;
  • <inlcludeonly>...</includeonly>: ce contenu n'apparaîtra que lorsque la page est incluse; il n'apparaîtra sur sa page d'origine.

5 Notes

  1. Ce procédé est né avec les premiers langages informatiques comme le langage C (directive #include).