Difference between revisions of "FR/Wiki/Aide:Modeles"

From Apache OpenOffice Wiki
< FR‎ | Wiki
Jump to: navigation, search
(Etablir la structure puis ventiler cette page...)
 
(13 intermediate revisions by 3 users not shown)
Line 1: Line 1:
−
{{DISPLAYTITLE: Les modèles}}
+
{{DISPLAYTITLE: Les modèles Wiki}}
−
{{FR/NavWikiGuide}}
+
{{FR/NavWikiGuide|part}}
 
{{FR/Documentation/MasterTOC
 
{{FR/Documentation/MasterTOC
 
|ShowPrevNext=block
 
|ShowPrevNext=block
Line 6: Line 6:
 
|ShowNextPage=block
 
|ShowNextPage=block
 
|PrevPage=FR/Wiki/Aide:Categories/Renommer
 
|PrevPage=FR/Wiki/Aide:Categories/Renommer
−
|NextPage=FR/Wiki/Aide:Syntaxe_Wiki
+
|NextPage=FR/Wiki/Aide:Modeles/Mise_en_forme
 
|bookid=FrWikiGuide
 
|bookid=FrWikiGuide
 
|booktitle=[[FR/Wiki/Aide:Editeur|Guide de l'éditeur]]
 
|booktitle=[[FR/Wiki/Aide:Editeur|Guide de l'éditeur]]
Line 14: Line 14:
 
|PrevPart=FR/Wiki/Aide:Categories
 
|PrevPart=FR/Wiki/Aide:Categories
 
|ShowNextPart=block
 
|ShowNextPart=block
−
|NextPart=FR/Wiki/Aide:Syntaxe_Wiki
+
|NextPart=FR/Wiki/Aide:Syntaxe
 
|toccontent=*  
 
|toccontent=*  
−
* [[FR/Wiki/Aide:Modeles/Mise_en_forme|Mise en forme]]
+
* [[FR/Wiki/Aide:Modeles/Mise_en_forme| Mise en forme]]
−
* [[FR/Wiki/Aide:Modeles/Referencement|Assignation automatique de catégories]]
+
* [[FR/Wiki/Aide:Modeles/Referencement| Regroupement des pages]]
−
* [[FR/Wiki/Aide:Modeles/Lien|Gestion d'hyperliens]]
+
* [[FR/Wiki/Aide:Modeles/Lien| Gestion d'hyperliens]]
−
* [[FR/Wiki/Aide:Modeles/Complexe|Modèles hybrides]]
+
* [[FR/Wiki/Aide:Modeles/Autres| Autres modèles]]
 
}}
 
}}
  
−
Un modèle Wiki n'est guère comparable avec un modèle de document, tels qu'ils existent pour les modules {{OOo}}, par exemple. Il s'agit ici de réaliser une inclusion d'une page dans une autre, les modèles (pages spéciales {{"L}}Template{{"R}}) offrant des facilités pour cela.
 
  
 +
Un modèle Wiki n'est guère comparable avec un modèle de document, tels qu'ils existent pour les modules {{OOo}}, par exemple...
 +
 +
Il s'agit ici de réaliser une inclusion d'une page dans une autre, les modèles (pages spéciales {{Tl|Template}}) offrant des facilités pour cela.
 +
 +
 +
== Utiliser un modèle ==
 +
Encadrez le nom du modèle par une double paire d'accolades :
 +
<pre>
 +
{{Nom du modèle}}
 +
</pre>
 +
C'est le cas d'appel le plus simple. Cependant de nombreux modèles utilisent des paramètres additionnels. Dans ce cas vous devrez les séparer par le caractère ''pipe'' {{"L}}'''<nowiki>|</nowiki>'''{{"R}}.
 +
 +
Sans (pour l'instant) rentrer plus avant dans les détails, on peut noter que les paramètres peuvent être numérotés ou nommés, et donc appelés différemment... De toute façon l'aide est régulièrement intégrée sur la page (du modèle) elle-même.
 +
 +
== Créer un modèle ==
 +
<big>'''Inciter à l'utilisation du modèle'''</big> <br><br>
 +
'''Documenter le modèle : Quelques points notables :
 +
* Voir préalablement les explications sur les [[:Category:FR/Modeles_Wiki | balises spéciales ''noinclude'' et ''includeonly'']].
 +
* C'est un bon réflexe d'intégrer une aide dans votre nouveau modèle, jusque dans le détail... l'aide est là dès qu'on veut s'en servir ! Facilitons l'accès à nos futurs "collègues" !
 +
** Ainsi (De plus), pour l'ajouter à ce guide, on se contentera de le présenter dans la section des modèles existants ;-)
 +
* Modèles et catégories sont des pages comme les autres ! (cf la belle icône du [[:Category:Localization|projet de localisation]]). Et même si elles appartiennent à des espaces de nom différents dotés de propriétés particulières, qu'il vaut mieux connaître c'est vrai...
 +
 +
== Renommer un modèle ==
 
S'il est très facile par la relation parent-enfant de faire se "mouvoir" des catégories proprement, il n'en va pas du tout de même avec les modèles. En effet, un modèle renommé provoquera une erreur dans toutes les pages ou il a été employé, mais il n'y aura d'autre moyen de le savoir que de visiter chacune de ces pages (à moins que ne soit incluse une catégorie dans le modèle, cf plus bas les modèles EnAttente et EnCours), et corriger manuellement l'erreur... attention à la casse !
 
S'il est très facile par la relation parent-enfant de faire se "mouvoir" des catégories proprement, il n'en va pas du tout de même avec les modèles. En effet, un modèle renommé provoquera une erreur dans toutes les pages ou il a été employé, mais il n'y aura d'autre moyen de le savoir que de visiter chacune de ces pages (à moins que ne soit incluse une catégorie dans le modèle, cf plus bas les modèles EnAttente et EnCours), et corriger manuellement l'erreur... attention à la casse !
−
{{Documentation/FR/Note|
+
{{Note|
−
* Il est sans doute possible d'assigner temporairement une catégorie spéciale à un modèle qu'on voudrait renommer, par exemple [[:Category:Temp]] ou [[:Category:FR/Temp]], en vérifiant préalablement qu'elle soit "vide" (c.a.d. qu'aucune autre page n'y fasse référence), pour pouvoir afficher simplement (et modifier) toutes les pages qui utilisent ce modèle... Cette opération peut malgré tout s'avérer longue et fastidieuse, et le bénéfice gagné insignifiant... (pour l'exemple du modèle)
+
* Il est sans doute possible d'assigner temporairement une catégorie spéciale à un modèle qu'on voudrait renommer, par exemple Category:Temp ou Category:FR/Temp, en vérifiant préalablement qu'elle soit "vide" (c.a.d. qu'aucune autre page n'y fasse référence), pour pouvoir afficher simplement (et modifier) toutes les pages qui utilisent ce modèle... Cette opération peut malgré tout s'avérer longue et fastidieuse, et le bénéfice gagné insignifiant... (pour l'exemple du modèle)
 
* Plutôt que de créer une nouvelle catégorie pour un tel usage, vous pouvez en choisir une - '''vide !''' - dans les [[Special:UncategorizedCategories|catégories sans catégorie]], ou parmi nos [[:Category:FR/Archives|archives]]...
 
* Plutôt que de créer une nouvelle catégorie pour un tel usage, vous pouvez en choisir une - '''vide !''' - dans les [[Special:UncategorizedCategories|catégories sans catégorie]], ou parmi nos [[:Category:FR/Archives|archives]]...
 
}}
 
}}
−
Ci dessous la liste existante reprise et actualisée de la page [[FR/Documentation/TableauBord/Organisation]]...
+
 
 +
==Modèles existants ==
 +
* Vous trouverez dans les pages suivantes des exemples de modèles et de leur fonctionnement
 +
* La liste est reprise et actualisée de la page [[FR/Documentation/TableauBord/Organisation]]
 +
* Le mode d'emploi est généralement inclus dans le modèle lui-même (colonne de gauche).
 +
* La catégorie [[:Category:FR/Modeles_Wiki|FR/Modeles_Wiki]] répertorie les modèles exclusivement francophone.
 +
* C'est elle-même une sous-catégorie de : [[:Category:Wiki_Templates]]
  
 
'''Pages anglophones'''
 
'''Pages anglophones'''
 
* Page d'aide pour les modèles : [[Help:Templates]]
 
* Page d'aide pour les modèles : [[Help:Templates]]
−
* Catégorie listant les modèles existants : [[:Category:Wiki_Templates]]
 
−
 
−
==Modèles existants (Templates) ==
 
−
* Le mode d'emploi est généralement inclus dans le modèle lui-même (colonne de gauche).
 
−
* La catégorie [[:Category:FR/Modeles|FR/Modeles]] répertorie les modèles exclusivement francophone.
 
−
 
−
{|border=1 style="border-collapse:collapse;" cellpadding=3 cellspacing=4
 
−
|-
 
−
!Nom du modèle!!Syntaxe!!Résultat
 
−
|-
 
−
|[[Template:OOo]]||'''<nowiki>{{OOo}}</nowiki>'''<br>Même effet que le modèle ci-dessous || {{OOo}}
 
−
|-
 
−
|[[Template:Documentation/PRODUCTNAME]]||'''<nowiki>{{Documentation/PRODUCTNAME}}</nowiki>'''<br>Même effet que le modèle ci-dessus || {{Documentation/PRODUCTNAME}}
 
−
|-
 
−
|[[Template:Documentation/Abstract]]||'''<nowiki>{{Documentation/Abstract|Votre note}}</nowiki>'''||{{Documentation/Abstract|Votre note}}<small>[Note : quel est l'intérêt de ce modèle ?] [[User:Synanceia (Pierre)|Synanceia (Pierre)]] 07:56, 9 May 2009 (UTC)</small>
 
−
|--
 
−
|[[Template:Documentation/Banner]]
 
−
|'''<nowiki>{{Documentation/Banner}}</nowiki>'''
 
−
Met la bannière "doc OOo" en haut à droite de la page<br><small>[Note : je ne pense pas qu'il soit possible d'ajouter un texte, il ne s'agit pas d'une bannière] [[User:Synanceia (Pierre)|Synanceia (Pierre)]] 07:56, 9 May 2009 (UTC)</small>
 
−
|[[Image:Docbanner.png]]
 
−
|-
 
−
|[[Template:Documentation/FR/PremierJet]]||'''<nowiki>{{Documentation/FR/PremierJet}}</nowiki>'''<br>Note : vous ne pouvez pas ajouter de commentaires... || {{Documentation/FR/PremierJet}}
 
−
|-
 
−
|[[Template:Documentation/FR/AideDemandee]]||'''<nowiki>{{Documentation/FR/AideDemandee|Vérifiez le texte et l'orthographe}}</nowiki>'''<br><small>[Note : modèle modifié pour autoriser l'ajout d'un commentaire] [[User:Synanceia (Pierre)|Synanceia (Pierre)]] 07:56, 9 May 2009 (UTC)</small>||{{Documentation/FR/AideDemandee|Vérifiez le texte et l'orthographe}}
 
−
|-
 
−
|[[Template:Documentation/FR/EnCours]]||'''<nowiki>{{Documentation/FR/EnCours|Mon commentaire<br>~~~~}}</nowiki>'''<br>Indique que le document est réservé, pour rédaction, relecture, etc.<br>Ce modèle est utilisé, en particulier, lorsque l'édition de la page nécessite de travailler hors connexion ou plusieurs sessions.<br>Vous ajouterez <nowiki>~~~~</nowiki> pour faire apparaitre votre nom et la date ; vous pouvez éventuellement ajouter un commentaire. ||{{Documentation/FR/EnCours|Mon commentaire<br>[[User:Jean Dupond|Jean Dupond]] 08:14, 9 May 2009 (UTC)}}
 
−
|-
 
−
|[[Template:Documentation/FR/EnAttente]]||'''<nowiki>{{Documentation/FR/EnAttente|Section macro en attente de relecture.}}</nowiki>'''<br>Demandez une relecture... <br>Vous pouvez ajouter un commentaire dans ce cadre...|| {{Documentation/FR/EnAttente|Section macro en attente de relecture.}}
 
−
|-
 
−
|[[Template:Documentation/FR/PertinenceVerifiee]]||'''<nowiki>{{Documentation/FR/PertinenceVerifiee|~~~~ }}</nowiki>'''<br>Retour du relecteur. Ajoutez <nowiki>~~~~</nowiki>&nbsp;: votre nom et la date de la vérification seront ajoutés (un lien direct sur votre page sera également créé)... ||{{Documentation/FR/PertinenceVerifiee|Jean Dupond 08:25, 9 May 2009 (UTC)}}
 
−
|--valign=top
 
−
|[[Template:Documentation/FR/PlusValable]]
 
−
|'''<nowiki>{{Documentation/FR/PlusValable}}</nowiki>'''<br>Cet article n'est plus à jour ou ne correspond plus au comportement de la version actuelle.
 
−
|{{Documentation/FR/PlusValable}}
 
−
|-
 
−
|[[Template:Documentation/FR/Attention]]||'''<nowiki>{{Documentation/FR/Attention|Faites très attention à ce qui est écrit ici.}}</nowiki>'''<br>Série 1||{{Documentation/FR/Attention|Faites très attention à ce qui est écrit ici.}}
 
−
|-
 
−
|[[Template:Documentation/FR/Note]]||'''<nowiki>{{Documentation/FR/Note|Information notable}}</nowiki>'''<br>Série 1 || {{Documentation/FR/Note|Information notable}}
 
−
|-
 
−
|[[Template:Documentation/FR/Astuce]]||'''<nowiki>{{Documentation/FR/Astuce|Essayez cette astuce.}}</nowiki>'''<br>Série 1 ||{{Documentation/FR/Astuce|Essayez cette astuce.}}
 
−
|-
 
−
|[[Template:Attention]]||'''<nowiki>{{Attention|Faites très attention à ce qui est écrit ici.}}</nowiki>'''<br>Série 2||{{Attention|Faites très attention à ce qui est écrit ici.}}
 
−
|-
 
−
|[[Template:Information]]||'''<nowiki>{{Information|Information notable}}</nowiki>'''<br>Série 2||{{Information|Information notable}}
 
−
|-
 
−
|[[Template:Tip]]||'''<nowiki>{{Tip|Essayez cette astuce.}}</nowiki>'''<br>Série 2||{{Tip|Essayez cette astuce.}}
 
−
|-valign=top
 
−
|[[Template:Documentation/hbar]]
 
−
|Utilisé pour tracer des barres horizontales pour réaliser des graphiques simplistes
 
−
<tt><nowiki>Blabla1{{Documentation/hbar|width=100|bg=#3333FF}}</nowiki><br>
 
−
<nowiki>Blabla2{{Documentation/hbar|width=57|bg=#33FF33}}</nowiki><br>
 
−
<nowiki>Blabla3{{Documentation/hbar|width=112|bg=#FF3333}}</nowiki><br>
 
−
<nowiki>Blabla5{{Documentation/hbar|width=150}}</nowiki></tt>
 
−
|
 
−
Blabla1{{Documentation/hbar|width=100|bg=#3333FF}}
 
−
Blabla2{{Documentation/hbar|width=57|bg=#33FF33}}
 
−
Blabla3{{Documentation/hbar|width=112|bg=#FF3333}}
 
−
Blabla4{{Documentation/hbar|width=150}}
 
−
 
−
|-
 
−
|[[Template:Documentation/Hook]]||'''<nowiki>{{Documentation/Hook}}</nowiki>''' || {{Documentation/Hook|Essai}}
 
−
|-
 
−
|[[Template:Documentation/Imported]]||'''<nowiki>{{Documentation/Imported|author=Jean Dupont|contributors=Pierre Dubois, Paul Durand}}</nowiki>'''||{{Documentation/Imported|author=Jean Dupont|contributors=Pierre Dubois, Paul Durand}}
 
−
|-
 
−
|[[Template:Documentation/LastEdited]]|| || {{Documentation/LastEdited|Only works after update of mw engine to > 1.8}}
 
−
|-
 
−
|[[Template:Documentation/Linux]]||'''<nowiki>{{Documentation/Linux|Informations spécifiques aux systèmes UNIX}}</nowiki>''' || {{Documentation/Linux|Informations spécifiques aux systèmes UNIX}}
 
−
|-
 
−
|[[Template:Documentation/Windows]]||'''<nowiki>{{Documentation/Windows|Informations spécifiques aux systèmes Microsoft Windows}}</nowiki>'''<br> ||{{Documentation/Windows|Informations spécifiques aux systèmes Microsoft Windows}}
 
−
|-
 
−
|[[Template:Documentation/MasterTOC]]||'''<nowiki>{{Documentation/MasterTOC}}</nowiki>''' <br>Vous devriez préférer le modèle francisé ci-dessous...||{{Documentation/MasterTOC}}
 
−
|-
 
−
|[[Template:FR/Documentation/MasterTOC]]
 
−
| <pre>{{FR/Documentation/MasterTOC
 
−
|ShowPrevPage=none
 
−
|ShowNextPage=block
 
−
|NextPage=The Next Page
 
−
|bookid=1234'''
 
−
|booktitle=[[Mon guide]]
 
−
|ShowParttitle=block
 
−
|parttitle=[[Première partie]]
 
−
|ShowPrevPart=none
 
−
|ShowNextPart=block
 
−
|NextPart=The Second Part
 
−
|toccontent=* Chapitre
 
−
* Chapitre
 
−
* Chapitre
 
−
}}</pre>
 
−
|{{FR/Documentation/MasterTOC
 
−
|ShowPrevPage=none
 
−
|ShowNextPage=block
 
−
|NextPage=The Next Page
 
−
|bookid=1234'''
 
−
|booktitle=[[Mon guide]]
 
−
|ShowParttitle=block
 
−
|parttitle=[[Première partie]]
 
−
|ShowPrevPart=none
 
−
|ShowNextPart=block
 
−
|NextPart=The Second Part
 
−
|toccontent=* Chapitre
 
−
* Chapitre
 
−
* Chapitre
 
−
}}
 
−
|-
 
−
|[[Template:Documentation/OOo]]||'''<nowiki>{{Documentation/OOo}}Lien vers...</nowiki>''' || {{Documentation/OOo}}Lien vers le document (Merci d'indiquer la taille du fichier pour les possesseurs d'une connexion bas-débit).
 
−
|-
 
−
|[[Template:Documentation/PDF]]||'''<nowiki>{{Documentation/PDF}}Lien vers...</nowiki>''' || {{Documentation/PDF}}Lien vers le fichier (de même que précédemment, indiquez sa taille).
 
−
|-
 
−
|[[Template:Français]] || '''<nowiki>{{Français}}</nowiki>''' || {{Français}}
 
−
|}
 
−
 
−
==Modèles en construction ==
 
−
{|border=1 style="border-collapse:collapse;" cellpadding=3 cellspacing=4
 
−
|-
 
−
!Nom du modèle!!Syntaxe!!Résultat
 
−
|-
 
−
||[[Template:FR/Navbox]] || '''<nowiki>{{FR/Navbox}}</nowiki>'''<br><br>'''<nowiki>{{FR/Navbox|Autres liens|[http://meta.wikimedia.org/wiki/Aide:%C3%89diteur Manuel de l'éditeur Wiki]}}</nowiki>''' <br><br>Ce modèle occupe normalement une plus grande largeur... <br>L'occasion de noter - avec ce tableau - leur adaptabilité...<br>Il accepte deux paramètres optionnels pour adapter la dernière ligne au contexte dans lequel il est employé || {{FR/Navbox|Autres liens|[http://meta.wikimedia.org/wiki/Aide:%C3%89diteur Manuel de l'éditeur Wiki]}}
 
−
|}
 
  
 
== Liens externes ==
 
== Liens externes ==
 +
*[http://meta.wikimedia.org/wiki/Aide:Modèle Modèles (www.wikimedia.org)]
 
*[http://www.mediawiki.org/wiki/Help:Templates/fr Modèles (www.mediawiki.org)]
 
*[http://www.mediawiki.org/wiki/Help:Templates/fr Modèles (www.mediawiki.org)]
 
*[http://www.mediawiki.org/wiki/Help:Variables/fr Variables (www.mediawiki.org)]
 
*[http://www.mediawiki.org/wiki/Help:Variables/fr Variables (www.mediawiki.org)]
  
 
{{PDL1}}
 
{{PDL1}}

Latest revision as of 08:29, 18 July 2018




Un modèle Wiki n'est guère comparable avec un modèle de document, tels qu'ils existent pour les modules Apache OpenOffice, par exemple...

Il s'agit ici de réaliser une inclusion d'une page dans une autre, les modèles (pages spéciales {{Template}}) offrant des facilités pour cela.


Utiliser un modèle

Encadrez le nom du modèle par une double paire d'accolades : 

{{Nom du modèle}}

C'est le cas d'appel le plus simple. Cependant de nombreux modèles utilisent des paramètres additionnels. Dans ce cas vous devrez les séparer par le caractère pipe « | ».

Sans (pour l'instant) rentrer plus avant dans les détails, on peut noter que les paramètres peuvent être numérotés ou nommés, et donc appelés différemment... De toute façon l'aide est régulièrement intégrée sur la page (du modèle) elle-même.

Créer un modèle

Inciter à l'utilisation du modèle

Documenter le modèle : Quelques points notables :

  • Voir préalablement les explications sur les balises spéciales noinclude et includeonly.
  • C'est un bon réflexe d'intégrer une aide dans votre nouveau modèle, jusque dans le détail... l'aide est là dès qu'on veut s'en servir ! Facilitons l'accès à nos futurs "collègues" !
    • Ainsi (De plus), pour l'ajouter à ce guide, on se contentera de le présenter dans la section des modèles existants ;-)
  • Modèles et catégories sont des pages comme les autres ! (cf la belle icône du projet de localisation). Et même si elles appartiennent à des espaces de nom différents dotés de propriétés particulières, qu'il vaut mieux connaître c'est vrai...

Renommer un modèle

S'il est très facile par la relation parent-enfant de faire se "mouvoir" des catégories proprement, il n'en va pas du tout de même avec les modèles. En effet, un modèle renommé provoquera une erreur dans toutes les pages ou il a été employé, mais il n'y aura d'autre moyen de le savoir que de visiter chacune de ces pages (à moins que ne soit incluse une catégorie dans le modèle, cf plus bas les modèles EnAttente et EnCours), et corriger manuellement l'erreur... attention à la casse !

Documentation note.png
  • Il est sans doute possible d'assigner temporairement une catégorie spéciale à un modèle qu'on voudrait renommer, par exemple Category:Temp ou Category:FR/Temp, en vérifiant préalablement qu'elle soit "vide" (c.a.d. qu'aucune autre page n'y fasse référence), pour pouvoir afficher simplement (et modifier) toutes les pages qui utilisent ce modèle... Cette opération peut malgré tout s'avérer longue et fastidieuse, et le bénéfice gagné insignifiant... (pour l'exemple du modèle)
  • Plutôt que de créer une nouvelle catégorie pour un tel usage, vous pouvez en choisir une - vide ! - dans les catégories sans catégorie, ou parmi nos archives...

Modèles existants

  • Vous trouverez dans les pages suivantes des exemples de modèles et de leur fonctionnement
  • La liste est reprise et actualisée de la page FR/Documentation/TableauBord/Organisation
  • Le mode d'emploi est généralement inclus dans le modèle lui-même (colonne de gauche).
  • La catégorie FR/Modeles_Wiki répertorie les modèles exclusivement francophone.
  • C'est elle-même une sous-catégorie de : Category:Wiki_Templates

Pages anglophones

Liens externes

Content on this page is licensed under the Public Documentation License (PDL).
Retrieved from "https://wiki.openoffice.org/w/index.php?title=FR/Wiki/Aide:Modeles&oldid=243711"
Personal tools