Modèle:Tiret

Documentation

Cette documentation est incluse dans la sous-page de documentation (voir | modifier | historique). Si vous voulez améliorer ce modèle et si celui-ci est protégé, demandez à un administrateur de vous aider.

Utilisation

L’emploi de ce modèle est maintenant généralement facultatif, voir les remarques ci-dessous. Il peut toujours être utilisé en association avec le modèle {{tiret2}}, dans les éditions en mode page, pour rassembler dans la transclusion le début d'un mot coupé en fin de page avec la fin du même mot sur la page suivante.

Les modèles tiret et tiret2 doivent comporter exactement les mêmes lettres, dans les mêmes paramètres (exemple : {{tiret|Wiki|source}} et {{tiret2|Wiki|source}}, mais pas {{tiret|wiki|source}} et {{tiret2|Wiki|source}} — une seule lettre est différente, ce qui rend inopérante la transclusion). Dans une page, le premier affiche le début du mot ; dans la page suivante, le second affiche la fin du mot. Seul le texte du tiret2 sera utilisé dans la transclusion, mais le texte du tiret est nécessaire pour des raisons techniques.

Remarques

Depuis septembre 2018, l’utilisation de ce modèle n’est plus nécessaire lorsque le tiret est le dernier caractère du code wiki de la page, c’est-à-dire dans la plupart des cas, car le logiciel sait rassembler automatiquement le début et la fin du mot dans la transclusion. Le modèle demeure utile pour des situations spécifiques où le tiret n’est pas le dernier caractère :

mot partagé entre deux pages dans une note de bas de page, usage de <ref follow=…) ;
dernier mot d'une page comportant le début d'une section ## label ## (dans ce cas la page finit implicitement par </section end="label"> et le tiret ne fini pas la page ; dans le code source, le mot est alors coupé en deux, même si à l'affichage il semble entier — ce qui pose un problème en recherche plein texte) ;
mot compris dans un modèle ;
avec le gadget « Modernisation » : les deux parties du mot peuvent être substituées séparément et ne pas donner le résultat escompté (par exemple, je di- | rois donne je disrois et non je dirais).

Remarque

Si l’une ou l’autre partie (visible dans la bulle d’aide qui apparaît lors du survol par le pointeur de la souris) contient une mise en forme HTML (par exemple s’il contient des éléments <span>), le titre complet (le mot entier) peut aussi être précisé séparément, sans cette mise en forme, dans le paramètre optionnel motcomplet=mot pour éviter un problème de syntaxe HTML.

Si le paramètre motcomplet= est utilisé dans le premier modèle {{tiret|...}}, le 2^e paramètre contenant la fin du mot est totalement ignoré puisqu'il ne sert qu'à former le contenu par défaut de l'infobulle.
Si le paramètre motcomplet= est utilisé dans le deuxième modèle {{tiret2|...}}, le 1^er paramètre contenant le début du mot est totalement ignoré puisqu'il ne sert qu'à former le contenu par défaut de l'infobulle.
La mise en italique ou en gras du mot coupé doit se faire dans les paramètres du modèle {{tiret|...}} et non autour dans la première page, afin qu'elle soit totalement supprimée lors de l'assemblage du chapitre ; pour la mise en forme sur la seconde page avec {{tiret2|...}}, la mise en gras ou italique doit se faire autour du modèle et non dedans (l'assemblage du chapitre ignore totalement le contenu de {{tiret|...}} mais conserve les deux paramètres de {{tiret2|...}}).

Il est préférable (mais pas obligatoire) d'inclure dans les paramètres de la césure les ponctuations attachées immédiatement au début ou en fin de mot (et qui sont normalement inséparables de ce mot), comme le point, la virgule, le point-virgule, les points d’exclamation ou d’interrogation, ou la fermeture des guillemets (en fin de mot), ou l’ouverture des guillemets (en début de mot), afin de faciliter la lecture en mode page. Dans la mise en forme du chapitre assemblé, le choix de l’une ou l’autre option ne produit habituellement aucune différence visible (sauf rares cas particuliers, où l'inclusion de ces ponctuations donne le résultat attendu). En revanche, on n’inclura pas les espaces avant ou après ce mot et ses éventuelles ponctuations attachées.

Syntaxe

{{tiret|début_du_mot|fin_du_mot}}

{{tiret|exem|ple}}

Ce modèle ajoute automatiquement le tiret après le début du mot.

Dans la transclusion c’est le mot entier qui est mis, ce qui évite des coupures disgracieuses, mot entier qui est pris du {{tiret2}}.

{{tiret|début_du_mot|fin_du_mot|motcomplet=mot_en_entier}}

Si le mot entier résultant de la jonction n’est pas simplement l’enchaînement des deux parties, mais doit être mot_en_entier, il faut utiliser le paramètre motcomplet. C’est ce mot qui sera utilisé dans la transclusion, et dans l’infobulle en mode page.

Paramètres

Permet de transclure un mot coupé en deux. À utiliser de concert avec le Modèle:Tiret2

Paramètres du modèle[Modifier les données du modèle]
La mise en forme sur une seule ligne est préférée pour ce modèle.
Paramètre		Description	Type	État
Début du mot	`1`	Début du mot Exemple comp	Inconnu	facultatif
Fin du mot	`2`	Fin du mot Exemple rendre	Chaîne	facultatif
Mot en complet	`motcomplet`	À utiliser pour éviter un problème de syntaxe HTML	Inconnu	facultatif

Exemple

Utilisation sur ces deux pages : tiret à la fin de la page puis tiret2 au début de la page.

Cas particuliers

Description du cas	Syntaxe	Rendu sur la 1^re page (en mode page)	Rendu sur la 2^de page (en mode page)	Rendu en continu (dans le chapitre)
Mots comportant eux-mêmes des tirets	{{tiret\|croyez\|-moi,}} {{tiret2\|croyez-\|moi,}}	croyez-	moi,	croyez-moi,
Mot en italique (en penché)	{{tiret\|''Mo\|niteur''\|motcomplet=Moniteur}} ''{{tiret2\|Mo\|niteur}}''	Mo-	niteur	Moniteur
Locution non entièrement en italique	{{tiret\|l’''In\|ternationale''}} {{tiret2\|l’In\|''ternationale''\|motcomplet=l’''Internationale''}}	l’In-	ternationale	l’Internationale
Locution	{{tiret\|s’at\|tendaient}} {{tiret2\|s’at\|tendaient}}	s’at-	tendaient	s’attendaient

Voir aussi