Modèle:Tiret

La bibliothèque libre.
Aller à la navigation Aller à la recherche
Documentation

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.

Si le mot coupé est en italique ou en gras, inscrire le tiret après la mise en forme (exemple : '''vellé'''-).

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 2e 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 1er 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ètreDescriptionTypeÉtat
Début du mot1

Début du mot

Exemple
comp
Inconnufacultatif
Fin du mot2

Fin du mot

Exemple
rendre
Chaînefacultatif
Mot en completmotcomplet

À utiliser pour éviter un problème de syntaxe HTML

Inconnufacultatif

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 1re page (en mode page) Rendu sur la 2de 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