Modèle:exemple/Documentation

Documentation du modèle

Ceci est la page de documentation de Modèle:exemple. · ·

Ce modèle utilise le Module:exemples, un script écrit dans le langage de programmation Lua. Toute expérimentation devrait être conduite d’abord via une sous-page bac à sable ou dans votre espace utilisateur.

Le modèle {{exemple}} permet soit :

• de formater un exemple avec une source et éventuellement une transcription et une traduction;
• ou de signaler qu’un exemple serait le bienvenu.

Son utilisation permet au gadget Ajouter des exemples de proposer un formulaire pour ajouter facilement un autre exemple.

{{exemple|lang=fr}}

{{exemple|Texte de l’exemple
 |lang=Code
 |source=Auteur, ''titre'', année}}

{{exemple|Texte de l’exemple
 |lang=Code
 |source=Auteur, , Site/Journal/etc., année, page}}

Exemple

#* {{exemple|lang=fr}}

…donnera :

1. • Exemple d’utilisation manquant. (Ajouter)

Exemple

#* {{exemple|Texte de l’exemple
 |lang=fr
 |source={{w|Gustave Flaubert}}, ''Bouvard et Pécuchet'', tome 1, chapitre 1, Éditions Conard, Paris, 1910}}

…donnera :

1. • Texte de l’exemple — (Gustave Flaubert, Bouvard et Pécuchet, tome 1, chapitre 1, Éditions Conard, Paris, 1910)

On utilise {{w}} pour lier un nom d’auteur à sa page Wikipédia, si cette page existe.

#* {{exemple|Das Kind '''hat''' mit der Schaufel und dem Eimer im Sandkasten '''gespielt'''.
|lang=de
|sens=L’enfant jouait avec la pelle et le seau dans le bac à sable.
}}

…donnera :

1. • Das Kind hat mit der Schaufel und dem Eimer im Sandkasten gespielt.

     L’enfant jouait avec la pelle et le seau dans le bac à sable.

1. Avec Wikipédia : utiliser {{w|<nom de l’article>}} ou ]
2. Avec Wikisource : utiliser ''{{ws|<nom de l’article>}}'' ou ]

Exemple

#* {{exemple|Texte de l’exemple
 |lang=fr
 |source={{w|Gustave Flaubert}}, ''{{ws|Bouvard et Pécuchet}}'', tome I, {{ws|Bouvard et Pécuchet/Chapitre I|chapitre I}}, {{w|Éditions Conard}}, Paris, 1910}}

donnera

1. • Texte de l’exemple — (Gustave Flaubert, Bouvard et Pécuchet, tome I, chapitre I, Éditions Conard, Paris, 1910)

Pour l’affichage de liens vers des pages web, vous pouvez utiliser le paramètre lien (la présence de caractères spéciaux est toutefois bien gérée). Par exemple, à la place de :

#* {{exemple|Texte de l’exemple
 |lang=Code
 |source={{w|Nicolas Vassiliévitch Gogol}}, traduction de Ernest Charrière, , tome 1, 1859, page 267}}

Vous pouvez utiliser la syntaxe suivante :

#* {{exemple|Texte de l’exemple
 |lang=Code
 |source={{w|Nicolas Vassiliévitch Gogol}}, traduction de Ernest Charrière, ''Les Âmes mortes'', tome 1, 1859, page 267
 |lien=https://fr.wikisource.orghttps://dictious.com/fr/Les_%C3%82mes_mortes/I/8}}

Cette syntaxe peut être utilisée pour tout lien vers des pages web externes. Vous pouvez aussi utiliser l’un des modèles {{ouvrage}}, {{lien web}} ou {{périodique}}, comme ceci :

#* {{exemple|Texte de l’exemple
 |lang=Code
 |source={{ouvrage|auteur={{w|Nicolas Vassiliévitch Gogol}}|traduction=Ernest Charrière|titre=Les Âmes mortes|tome=1|date=1859|passage=267|url=https://fr.wikisource.orghttps://dictious.com/fr/Les_%C3%82mes_mortes/I/8}}}}

La syntaxe wiki fait que si un signe « égal à » (=) est présent dans un paramètre, la partie à sa gauche est considérée nommer le paramètre. Il faut donc rendre explicites les paramètres anonymes 1 à 3. Par exemple :

#* {{exemple |lang=la 
|'''vidi''' eum ingredientem.
|2=je l’ai vu entrer (= au moment où il entrait).}}

…donnera :

1. • vidi eum ingredientem.

     je l’ai vu entrer (= au moment où il entrait).

Omettre le « 2= » causera une erreur parce que le modèle cherchera à définir un paramètre nommé « je l’ai vu entrer ( ».

Autre caprice de la syntaxe wiki, si on rend un paramètre anonyme explicite, il faut aussi expliciter ceux qui le suivent en aval. Exemple :

#* {{exemple |lang=de 
|1=Er ist zu einem '''Verrat''' (= zu allem) fähig! 
|2=Il est capable de tout ! }}

…donnera :

1. • Er ist zu einem Verrat (= zu allem) fähig!

     Il est capable de tout !

Alors que :

#* {{exemple |lang=de 
|1=Er ist zu einem '''Verrat''' (= zu allem) fähig! 
|Il est capable de tout ! }}

…sera compris comme spécifiant deux fois le paramètre 1, ce qui donnera :

1. • Il est capable de tout !

     La traduction en français de l’exemple manque. (Ajouter)

Une autre façon de gérer le signe égal est de le remplacer par une de ses références de caractères : « = », « = » ou « = ». Par exemple :

#* {{exemple |lang=de 
|Er ist zu einem '''Verrat''' (= zu allem) fähig! 
|Il est capable de tout ! }}

…donnera :

1. • Er ist zu einem Verrat (= zu allem) fähig!

     Il est capable de tout !

Les paramètres anonymes 1 à 3 ne doivent pas commencer par un plus petit (<). Il faut alors lui substituer <.

• Convention:Typographie#Citations
• {{ibid}}
• {{ja-exemple}}
• {{zh-exemple}}
• {{ouvrage}}, {{lien web}}, {{périodique}}