Voir la source de Modèle:Lien/Documentation

{{Sous-page de documentation}}

{{Confusion|Modèle:Liens}}
<includeonly>{{Protection}}</includeonly>
{{Modèle utilisant les modules Lua|Module:Lien interwiki}}

Au cours de la rédaction du texte d'un article donné, ce modèle a pour but de placer un [[Wikipédia:Liens internes|lien interne]] vers un autre article même si cet autre article n'existe pas dans la Wikipédia en français (donc lien apparaissant par défaut en rouge), tout en fournissant un [[Aide:Lien interlangue#Liens interlangues dans le texte|lien interlangue dans le texte]] vers un article équivalent dans une version de Wikipédia d'une autre langue. Il s'agit donc d'une aide pour le lecteur d'un article donné, en lui fournissant des détails lorsqu'un « lien bleu » n'est pas disponible dans la Wikipédia en français.

Toutefois, dès que l’article est créé en français avec le nom (français) prévu dans l'usage du modèle « Lien », le lien vers l’article dans l’autre langue disparaît. Concrètement <small>(les liens sont simulés)</small> :
* tant que l’article en français n’a pas été créé, le lien se présente de la manière suivante :
*: <span style="color:#BA0000">Article en français</span> <span style="color:#36B;font-family:monospace;font-weight:bold;font-size:small">({{{langue|en}}})</span> ;
* dès que l’article en français a été créé, le lien se présente de la manière suivante, sans le complément « <span style="color:#36B;font-family:monospace;font-weight:bold;font-size:small">({{{langue|en}}})</span> » :
*: <span style="color:#002BB8">Article en français</span>.

== Intérêt ==

En premier lieu, le modèle permet aux lecteurs d’avoir des informations — dans une autre langue que le français — sur le sujet malgré l’absence d’article en français. Il souligne l'absence d'article en français et est en conséquence susceptible d'inciter à sa création.

Le modèle « Lien » offre, à la personne qui envisage de créer l'article en français, un lien vers un article équivalent dans une autre langue pour le [[Projet:Traduction|traduire]] ou s’en inspirer (notamment de ses sources et de sa bibliographie). Donc il vaut mieux que l'article visé dans l'autre langue dispose de sources de qualité. L'emploi du modèle ne constitue pas une obligation de se baser sur l’article dans l’autre langue pour créer le nouvel article en français.
Voici la ''[[Wikipédia:Articles_à_créer/pages_demandées_les_plus_liées_au_modèle_Lien|liste des articles les plus demandés via le modèle Lien]]''.

=== Limites ===
#Si la page avec le titre envisagé en français est créée, le modèle établit un lien interne bleu vers cette page. Mais rien ne garantit que la page correspond effectivement à l'équivalent de la page dans l'autre langue. Il peut s'agir d'un homonyme ou d'une page d'homonymie. Donc lors du remplacement d'un modèle Lien par une syntaxe classique de lien interne, il convient de vérifier que le sujet en français est le bon. Dans le cas contraire, il faut adapter les paramètres du modèle.
#Le modèle ne suit pas les [[Aide:Lien interlangue|liens interlangues]], donc il ne détectera pas l'article en français, si celui-ci est créé avec un autre titre que celui prévu dans le paramètre <code>fr=</code> du modèle. <br>''Exemple : {{Lien|trad=Aachener Domschatzkammer|langue=de|fr=Domschatzkammer d'Aix-la-Chapelle|texte=Domschatzkammer}} (l'article en français existe avec le titre [[Trésor de la cathédrale d'Aix-la-Chapelle]] et non [[Domschatzkammer d'Aix-la-Chapelle]]).''

== Syntaxe ==

<pre>
{{Lien|langue=code|trad=Title|fr=Titre|texte=Texte}}
</pre>

Les paramètres sont à compléter de cette manière :

 <nowiki>{{</nowiki>Lien
 <nowiki>|</nowiki>langue= <em style="color:#555">Code langue de la Wikipédia en langue étrangère</em> (voir [[Liste des codes ISO 639-1]])
 <nowiki>|</nowiki>trad= <em style="color:#555">Titre de l’article dans la Wikipédia en langue étrangère</em>
 <nowiki>|</nowiki>fr= <em style="color:#555">Titre de l’article inexistant à créer en français</em>
 <nowiki>|</nowiki>texte= <em style="color:#555">Texte en français (souvent abrégé ou accordé différemment) à afficher sur le lien</em>
 <nowiki>}}</nowiki>

=== Valeur du paramètre langue ===
La liste des codes langue est disponible sur [[Modèle:Langue#Codes de langue|la documentation du modèle Langue]] ou à partir de la [[:meta:List_of_Wikipedias#All_Wikipedias_ordered_by_number_of_articles|liste des Wikipedias dans Méta-Wiki]]. Si vous souhaitez utiliser le modèle avec une langue peu courante, vérifiez l'existence de la catégorie associée (sous-catégorie de la {{Catégorie|Article contenant un appel à traduction}}). Si elle n'existe pas {{incise|ce que vous constaterez par le lien rouge dans les catégories cachées en bas d'article}}, créez la !

Particularité : la valeur « d » est admise si plusieurs articles de bonne qualité existent dans d'autres langues ; il faut alors écrire : « |langue=d |trad=Qxxx ».

=== Valeurs des paramètres <code>|trad=</code> et <code>|fr=</code> ===
Les titres indiqués dans les paramètres <code>|trad=</code> et <code>|fr=</code> ou le premier paramètre non nommé ne devraient contenir aucun espace excédentaire (hormis les espaces en tête et en fin, qui sont ignorés pour les paramètres nommés explicitement), ni aucun des caractères interdits dans les noms de page (dont <code>#<>{|}</code>) ; ces titres ne peuvent donc contenir aucun formatage destiné à l'affichage (qui pourra être précisé, si nécessaire, en renseignant explicitement le paramètre <code>|texte=</code>).

Les titres d'articles peuvent mentionner (en préfixe) le nom d'un [[Aide:Espace de noms|espace de noms]] suivi de <code>:</code> ; à utiliser avec précaution. Attention, les noms d'espaces de noms ne sont pas nécessairement les mêmes entre la Wikipédia francophone et les autres Wikipédia en langue étrangère (en effet ces derniers ne connaissent pas les noms français des espaces de noms de la Wikipédia francophone) : en cas de différence, renseigner séparément et complètement les paramètres <code>|trad=</code> et <code>|fr=</code>.

Les titres indiqués sont à rédiger, de préférence, sans l'encodage utilisé pour des raisons techniques dans les URL (donc sans le soulignement <code>_</code> qui remplace l'espace dans les URL et sans la représentation [[hexadécimal]]e [[UTF-8]] [[encodage-pourcent|de la forme]] <code>%HH...%HH</code> utilisée pour les caractères non latins de base). Astuce : copiez le titre depuis la page cible affichée surtout si celle-ci contient des caractères n'existant pas sur un clavier français (par exemple cyrilliques si langue=ru). <br>
Recommandation : il est conseillé de vérifier les liens générés en les visitant pour les valider (et éviter également de générer des liens qui sont en fait redirigés vers une autre page). 

Les titres peuvent également mentionner après <code>#</code> le nom d'une ancre dans la page cible. Néanmoins, utiliser une ancre dans le paramètre <code>|fr=</code> est déconseillé. En effet, sauf dans des domaines précis ayant un plan préétabli, il est difficile d'anticiper le nom des sections qui seront présentes dans l'article en français au moment de sa création.

=== Syntaxe simplifiée ===
Le paramètre <code>|fr=</code> peut ne pas être nommé (à condition que le titre en valeur ne contienne pas le caractère <code>=</code> ni aucune espace en tête ou à la fin car il n'y a actuellement aucun filtre pour en faire un titre de page valide), le titre de l'article en français est alors implicitement passé dans le premier paramètre non nommé.

Les paramètres sont facultatifs sous certaines conditions :

* si <code>|langue=</code> est omis, il est remplacé par la valeur « en » (pour viser un article de la Wikipedia en langue anglaise) ;
* si <code>|trad=</code> est omis, il est remplacé par la valeur de <code>fr=</code>, ou du premier paramètre non nommé ;
* si <code>|fr=</code> est omis, il est remplacé par la valeur du premier paramètre non nommé, ou de <code>trad=</code> ;
* si <code>|texte=</code> est omis, l'affichage suit la logique de <code>|fr=</code>, donc ce sera la valeur de <code>|fr=</code>, ou du premier paramètre non nommé, ou de <code>trad=</code>.

Il est néanmoins fortement conseillé de spécifier au moins le paramètre <code>|trad=</code>, élément dont la valeur est la plus tangible au moment de l'insertion du modèle.

== Exemples de rendu ==

{|class="wikitable" width="100%"
|-
!scope="col"| Conditions
!scope="col"| Code
!scope="col"| Rendu

|-
| Le titre de l'article à créer en français est identique au titre de l'article existant sur la Wikipédia en langue anglaise.
|
 <nowiki>{{</nowiki>Lien
 <nowiki>|</nowiki>trad= National Association of Rocketry
 <nowiki>}}</nowiki>
| {{Lien |trad= National Association of Rocketry }}

|-
| Le titre de l'article à créer en français est identique au titre de l'article existant sur la Wikipédia en langue anglaise,<br /> mais un texte différent (souvent abrégé) du titre français doit apparaître.
|
 <nowiki>{{</nowiki>Lien
 <nowiki>|</nowiki>trad= National Association of Rocketry
 <nowiki>|</nowiki>texte= NAR
 <nowiki>}}</nowiki>
| {{Lien |trad= National Association of Rocketry |texte= NAR }}

|-
| Le titre de l'article à créer en français est différent du titre de l'article existant sur la Wikipédia en langue anglaise.
|
 <nowiki>{{</nowiki>Lien
 <nowiki>|</nowiki>trad= Falling Down (Lil Peep and XXXTentacion song)
 <nowiki>|</nowiki>fr= Falling Down (chanson)
 <nowiki>}}</nowiki>
| {{Lien |trad=Falling Down (Lil Peep and XXXTentacion song) |fr= Falling Down (chanson)}}

|-
| Le titre de l'article à créer en français est différent du titre de l'article existant sur la Wikipédia en langue anglaise,<br /> mais un texte différent (souvent abrégé) du titre français doit apparaître.
|
 <nowiki>{{</nowiki>Lien
 <nowiki>|</nowiki>trad= Falling Down (Lil Peep and XXXTentacion song)
 <nowiki>|</nowiki>fr= Falling Down (chanson)
 <nowiki>|</nowiki>texte= Falling Down
 <nowiki>}}</nowiki>
| {{ Lien |trad= Falling Down (Lil Peep and XXXTentacion song) |fr= Falling Down (chanson) |texte= Falling Down }}

|-
| Le titre de l'article à créer en français est identique au titre de l'article existant sur la Wikipédia dans une autre langue.
|
 <nowiki>{{</nowiki>Lien
 <nowiki>|</nowiki>langue= de
 <nowiki>|</nowiki>trad=Rhein-Zeitung
 <nowiki>}}</nowiki>
| {{Lien |langue= de |trad=Rhein-Zeitung}}

|-
| Le titre de l'article à créer en français est identique au titre de l'article existant sur la Wikipédia dans une autre langue,<br /> mais un texte différent (souvent abrégé) du titre français doit apparaître.
|
 <nowiki>{{</nowiki>Lien
 <nowiki>|</nowiki>langue= de
 <nowiki>|</nowiki>trad= Rhein-Zeitung
 <nowiki>|</nowiki>texte= RZ
 <nowiki>}}</nowiki>
| {{Lien |langue= de |trad= Rhein-Zeitung|texte= RZ}}

|-
| Le titre de l'article à créer en français est différent du titre de l'article existant sur la Wikipédia dans une autre langue.
|
 <nowiki>{{</nowiki>Lien
 <nowiki>|</nowiki>langue= it
 <nowiki>|</nowiki>trad= Falling Down (Lil Peep e XXXTentacion)
 <nowiki>|</nowiki>fr= Falling Down (chanson)
 <nowiki>}}</nowiki>
| {{Lien |langue=it |trad= Falling Down (Lil Peep e XXXTentacion) |fr= Falling Down (chanson)}}

|-
| Le titre de l'article à créer en français est différent du titre de l'article existant sur la Wikipédia dans une autre langue,<br /> mais un texte différent (souvent abrégé) du titre français doit apparaître.
|
 <nowiki>{{</nowiki>Lien
 <nowiki>|</nowiki>langue= it
 <nowiki>|</nowiki>trad= Falling Down (Lil Peep e XXXTentacion)
 <nowiki>|</nowiki>fr= Falling Down (chanson)
 <nowiki>|</nowiki>texte= Falling Down
 <nowiki>}}</nowiki>
| {{Lien |langue= it |trad= Falling Down (Lil Peep e XXXTentacion) |fr= Falling Down (chanson) |texte= Falling Down}}

|-
| Seul le lien vers la Wikipédia dans une autre langue est souhaité, pas le lien rouge vers Wikipédia en français.
|
 <nowiki>{{</nowiki>Lien
 <nowiki>|</nowiki>langue= it
 <nowiki>|</nowiki>trad= Falling Down (Lil Peep e XXXTentacion)
 <nowiki>|</nowiki>texte= Falling Down
 <nowiki>|</nowiki>lienfr= non
 <nowiki>}}</nowiki>
| {{Lien |langue= it |trad= Falling Down (Lil Peep e XXXTentacion) |texte= Falling Down |lienfr= non}}

|-
| Le lien vers la Wikipédia dans une autre langue est souhaité, et pas le lien vers l'article en français (qui existe).
|
 <nowiki>{{</nowiki>Lien
 <nowiki>|</nowiki>langue= de
 <nowiki>|</nowiki>trad= Paris
 <nowiki>|</nowiki>texte= article sur Paris
 <nowiki>|</nowiki>lienfr= non
 <nowiki>}}</nowiki>
| {{Lien |langue= de |trad= Paris |texte= article sur Paris |lienfr= non}}

|-
| Exemple de fonctionnement avec un élément Wikidata
|
 <nowiki>{{</nowiki>Lien
 <nowiki>|</nowiki>langue= d
 <nowiki>|</nowiki>trad= Q109501963
 <nowiki>|</nowiki>fr= Charles Orengo
 <nowiki>}}</nowiki>
| {{Lien |langue= d |trad= Q109501963 |fr= Charles Orengo}}

|}

== TemplateData ==
<templatedata>
{
	"description": "Insère un lien vers un article inexistant et vers son équivalent dans une autre langue. À utiliser pour faire un lien vers un article à créer dans la Wikipédia en français (apparaissant par défaut en rouge) en fournissant un lien supplémentaire vers un article équivalent dans une version de Wikipédia dans une autre langue.",
	"params": {
		"fr": {
			"aliases": [
				"1"
			],
			"label": "Article en français",
			"description": "Titre de l’article inexistant à créer sur la Wikipédia en français. Si omis, utilise le même titre que l’article existant en langue étrangère.",
			"example": "Comité des utilisations pacifiques de l'espace extra-atmosphérique",
			"type": "line",
			"suggested": true
		},
		"langue": {
			"label": "Langue",
			"description": "Code langue de la Wikipédia en langue étrangère où il existe un article correspondant au sujet. Si omis, désigne la Wikipédia en anglais.",
			"type": "line",
			"default": "en",
			"aliases": [
				"lang"
			],
			"suggested": true,
			"example": "de"
		},
		"trad": {
			"label": "Article en langue étrangère",
			"description": "Titre de l’article existant sur la Wikipédia en langue étrangère. Paramètre fortement recommandé. Si omis, utilise le même titre que l’article inexistant à créer sur la Wikipédia en français.",
			"example": "Ausschuss für die friedliche Nutzung des Weltraums",
			"type": "line",
			"suggested": true
		},
		"texte": {
			"label": "Texte",
			"description": "Texte en français (souvent abrégé ou accordé différemment) à afficher sur le lien. Si omis, affiche le titre de l’article à créer en français, sinon affiche le titre de l'article existant sur la Wikipédia en langue étrangère.",
			"type": "line",
			"example": "COPUOS"
		},
		"nocat": {
			"label": "Nocat",
			"description": "Permet de ne pas catégoriser la page.",
			"type": "string",
			"suggestedvalues": [
				"oui"
			]
		},
		"lienfr": {
			"label": "présence du lien vers Wikipédia en français",
			"description": "la valeur \"non\" désactive la création d'un lien (rouge ou bleu) vers Wikipédia en français.",
			"suggestedvalues": [
				"non"
			],
			"default": "le lien est affiché"
		}
	},
	"format": "inline",
	"paramOrder": [
		"langue",
		"trad",
		"fr",
		"texte",
		"nocat",
		"lienfr"
	]
}
</templatedata>

== Maintenance ==

La maintenance des appels de ce modèle est de deux sortes : la réparation des appels incorrects et celle des appels désuets. Plusieurs bots se chargent d'une partie de cette maintenance ; le reste doit être corrigé par des utilisateurs humains.

Note : si vous avez l'impression qu'un bot remplace une utilisation du modèle Lien à tort, merci de remonter l'information à son dresseur.

=== Repérer les appels incorrects ===

Dans le modèle {{m|Lien}}, un paramètre non nommé est équivalent au paramètre « fr ». Lorsque les deux sont remplis, le paramètre « fr » a la priorité et masque le paramètre non nommé. Cependant, ce fonctionnement est mal compris et certains contributeurs utilisent par erreur un paramètre non nommé en plus de « fr » pour donner la traduction dans l'autre langue ou le code de langue. La liste suivante, en cours d'élaboration liste les usages du modèle Lien dans ce cas et propose des pistes de correction :
* [[Projet:Liens rouges/Paramètre non nommé dans Lien]].


L'article visé peut avoir été créé sur Wikipédia en français mais [[Wikipédia:Conventions sur les titres|sous un autre nom que]] celui attendu dans le paramètre <code>|fr=</code>. L'analyse de ces cas n'est pas effectuée par le modèle Lien, car il ne consulte pas Wikidata. L'analyse est effectuée par un bot. Ensuite, les corrections doivent être faites par des utilisateurs humains. Les pages appelées à création par le modèle Lien vers un article déjà traduit sont rangées dans la page d'analyse suivante (à corriger par des utilisateurs humains en suivant les conseils dans sa description) :
* [[Projet:Liens rouges/Modèle lien vers un article déjà traduit]].


L'article visé peut aussi ne pas exister dans la langue désignée par <code>|langue=</code>, par exemple à cause de sa suppression dans la Wikipedia cible ou à cause d'une faute de frappe dans <code>|trad=</code>. Là aussi, l'analyse est effectuée par un bot et les corrections doivent être faites par des utilisateurs humains :
* [[Projet:Liens rouges/Modèle Lien vers un article inexistant en langue étrangère]].


Les appels au modèle {{m|Lien}} présentant un paramètre contenant un signe égal. Un paramètre contenant le signe égal peut être le signe d'une erreur de syntaxe qui peut conduire à un lien erroné ou empêcher la conversion (par bot) du modèle Lien en lien interne classique si l'article en français a été créé. D'autres détections comme la présence de crochets, accolades, « http » ou une valeur manquante/douteuse pour « trad » sont effectuées :
* [[Projet:Liens rouges/Modèle Lien avec un paramètre problématique]].


Les pages où le paramètre <code>|langue=</code> est incorrect sont rangées dans les catégories suivantes (à corriger par des utilisateurs humains en suivant les conseils dans leurs descriptions) : 
* {{Catégorie|Article contenant un appel à traduction avec un code langue inconnu}} ;
* {{Catégorie|Article contenant un appel à traduction avec un code langue remplacé}}.

=== Repérer les appels désuets ===

Tant que l’article en français n’a pas été créé, le lien vers l’équivalent dans une autre langue est affiché. Le modèle catégorise alors la page où il est utilisé dans les sous-catégories de la {{Catégorie|Article contenant un appel à traduction}}.

Lorsque l’article en français a été créé, le lien vers l’équivalent dans une autre langue n’est plus affiché, et l’utilisation de ce modèle n’est plus nécessaire ; il peut alors être remplacé par la [[Aide:Insérer_un_lien_(Éditeur_visuel)|syntaxe wiki habituelle]]. La page est rangée dans la catégorie suivante, qui est vidée conjointement par des bots et des utilisateurs humains (en suivant les conseils dans sa description) :
* {{Catégorie|Page utilisant Lien pour un article existant}}.

== Voir aussi ==
* {{m|Lien'}} : équivalent au modèle {{m|Lien}}, mais sans fonction coûteuse testant l'existence de l'article en français. <small>En conséquence, le lien interwiki est toujours affiché.</small> À utiliser à la place du modèle Lien sur les pages portant beaucoup de tels modèles. 
* {{m|AutoLien}} : affiche l’hyperlien si la page cible existe, modèle à ne pas utiliser directement dans les articles.
* {{m|Lien/Conversion automatique}} : modèle de formatage du modèle Lien, à utiliser avec précaution car il ne vérifie ni les erreurs de syntaxe, ni les correspondances interwiki entre les pages existantes, ni la nature des pages (homonymie).
* {{m|Lien web}} : modèle pour un lien web ordinaire.
* {{m|Sortname}} : modèle pour un lien triable dans un tableau par un second terme pouvant être lié dans en.wp.
* [[Liste des codes ISO 639-1]] : liste des codes langues.
<includeonly>

{{DEFAULTSORT:Lien, Modele}}
[[Catégorie:Modèle lien interne]]
[[Catégorie:Modèle qui catégorise]]
[[Catégorie:Modèle du projet Traduction]]
[[Catégorie:Wikipédia:Liens entre wikis]]
</includeonly>