Différences

Ci-dessous, les différences entre deux révisions de la page.

--- composition:texte:mots:mettre_en_forme_des_url_et_des_adresses_electroniques [2020/12/12 18:51] – Fusion avec la page anglais (sans traduction). yannick.tanguy
+++ 3_composition:texte:mots:mettre_en_forme_des_url_et_des_adresses_electroniques [2021/04/18 11:01] (Version actuelle) – Changement de titre. Mots-clefs OpenGraph. jejust
@@ Ligne 1: / Ligne 1: @@
-====== Comment gérer des adresses web (ou URL) ?  ======
+====== Comment écrire des adresses web (ou URL)?  ======
-FIXME URLs tend to be very long, and contain characters that would naturally prevent them being hyphenated even if they weren't typically set in ''\ttfamily'', verbatim.  Therefore, without special treatment, they often produce wildly overfull ''\hbox''es, and their typeset representation is awful.
+Les URL ont tendance à être très longues et contiennent des caractères qui les empêchent d'être découpées facilement. Par conséquent, sans traitement spécial, elles produisent souvent des boîtes horizontales (''\hbox'') très longues et leur composition finale est alors laide. Ce qui suit présente des solutions pour arriver à mieux les gérer.
-===== Sans extension =====
+===== Avec l'extension “path” =====
-La macro ''discretionary'' permet de dire comment couper une chaîne de caractères : ''\discretionary{Avant la coupure}{après}{s'il n'y en a pas}''
+L'extension [[ctanpkg>path|path]] définit une commande ''\path''. Cette commande définit chaque caractère de césure potentielle comme un ''\discretionary'' et offre à l'utilisateur la possibilité de spécifier sa propre liste de caractères de césures potentielles. Cette commande est cependant [[2_programmation:syntaxe:c_est_quoi_la_protection|fragile]]. Les [[1_generalites:glossaire:qu_est_ce_que_eplain|commandes d'Eplain]] définissent une commande similaire ''\path''. L'extension [[ctanpkg>path|path]], bien qu'elle fonctionne dans des situations simples, ne collabore pas bien <latex>\LaTeX</latex> : malgré sa longue et honorable histoire, elle n'est plus vraiment recommandée.
-<note>
+===== Avec l'extension “url” =====
-''-'' est défini comme ''discretionary\{-\''\{\}\{\}}
-</note>
+L'extension [[ctanpkg>url|url]] permet de gérer les coupures des URL un peu longues. Elle est également capable de gérer les adresses e-mail, les liens hypertextes, les noms de répertoires, etc. Elle définit une commande ''\url'' (et bien d'autres, y compris sa propre commande ''\path'') qui donne à chaque caractère de césure potentielle un comportement assimilable à celui du mode mathématique et qui définit l'URL elle-même en mode mathématique (dans la police choisie par l'utilisateur).
-===== Avec l'extension path =====
-FIXME The [[ctanpkg>path|path]] package, which defines a ''\path'' command. The command defines each potential break character as a ''\discretionary'', and offers the user the opportunity of specifying a personal list of potential break characters.  Its chief disadvantage is fragility in LaTeX moving arguments.  The [[FAQ-eplain|Eplain macros]] --- define a similar ''\path'' command. [[ctanpkg>Path|Path]], though it works in simple situations, makes no attempt to work with LaTeX (it is irremediably fragile).  Despite its long and honourable history, it is no longer recommended for LaTeX use.
+Voici un exemple d'utilisation, illustrant aussi un paramétrage possible avec cette extension :
-===== Avec l'extension url =====
-Il existe le package [[ctanpkg>url|url]] disponible sur https://www.ctan.org/{macros/latex/contrib/misc/} qui permet de gérer les coupures des URL un peu longues. Il est également capable de gérer les adresses e-mail, les liens hypertextes, les noms de répertoires, etc. En outre, cet outil est paramétrable.
-Utilisation du package ''url''\label{use-url}
+<WRAP column 56ex>
 <code latex>
 \documentclass{article}
-\usepackage{url}
+  \usepackage{url}
-\urlstyle{sf}
+  \urlstyle{sf}
 \begin{document}
+\url{http://hostname/~username}
+Lorsque l'on veut citer une URL dans du texte
+\url{http://www.domaine.com/un/truc/long.html},
+cela se passe relativement bien.
+\end{document}
+</code>
+</WRAP>
+<WRAP column 30ex>
+<latexdoc>
+\documentclass{article}
+  \usepackage{url}
+  \urlstyle{sf}
+  \pagestyle{empty}
+\begin{document}
 \url{http://hostname/~username}
+\medskip
 Lorsque l'on veut citer une URL dans du texte
 \url{http://www.domaine.com/un/truc/long.html},
 cela se passe relativement bien.
 \end{document}
+</latexdoc>
+</WRAP>
+<WRAP clear />
+==== Des commandes plus robustes ====
+Les commandes ''\path'' de l'extension [[ctanpkg>path|path]] et ''\url'' de l'extension [[ctanpkg>url|url]] ne sont pas [[2_programmation:syntaxe:c_est_quoi_la_protection|robustes]]. Toutefois si vous avez besoin d'une URL devant aller dans un argument mouvant, vous aurez besoin de la commande ''\urldef'' de l'extension [[ctanpkg>url|url]]. Ceci donne par exemple pour rendre robuste la commande ''\faqfr'' :
+<code latex>
+\urldef\faqfr\url{https://faq.gutenberg.eu.org/}
 </code>
-FIXME The [[ctanpkg>url|url]] package, which defines an ''\url'' command (among others, including its own ''\path'' command).  The command gives each potential break character a maths-mode "personality", and then sets the URL itself (in the user's choice of font) in maths mode.  It can produce (LaTeX-style) "robust" commands (see [[FAQ-protect|use of ''\protect'']]) for use within moving arguments.
+==== La gestion des espaces ====
-FIXME The package ordinarily ignores spaces in the URL, but unfortunately URLs that contain spaces do exist; to typeset them, call the package with the ''obeyspaces'' option.  Two other useful options allow line breaks in the URL in places where they are ordinarily suppressed to avoid confusion: ''spaces'' to allow breaks at spaces (note, this requires ''obeyspaces'' as well, and ''hyphens'' to allow breaks after hyphens.  (Note that the package //never// does "ordinary" hyphenation of names inside an URL.)
+L'extension [[ctanpkg>url|url]] ignore généralement les espaces dans les URL mais, malheureusement, certaines d'entre elles contiennent des espaces. Pour les traiter, appelez l'extension avec l'option ''obeyspaces''. Deux autres options autorisent les sauts de ligne dans l'URL aux endroits où ils sont normalement supprimés pour éviter toute confusion :
+  * ''spaces'' pour autoriser les sauts au niveau des espaces (notez que cela nécessite également ''obeyspaces'') ;
-FIXME It is possible to use the [[ctanpkg>url|url]] package in Plain TeX, with the assistance of the [[ctanpkg>miniltx|miniltx]] package (which was originally developed for using the LaTeX graphics package in Plain TeX).  A small patch is also necessary: the required sequence is therefore:
+  * ''hyphens'' pour autoriser les sauts après les tirets (car, l'extension ne fait //jamais// de césure « ordinaire » dans les URL).
+Il est possible d'utiliser l'extension [[ctanpkg>url|url]] en Plain <latex>\TeX</latex>, avec l'aide de l'extension [[ctanpkg>miniltx|miniltx]] (qui a été initialement développé pour utiliser l'extension [[ctanpkg>graphics|graphics]] de <latex>\LaTeX</latex> dans Plain <latex>\TeX</latex>). Une petit morceau de code est alors nécessaire :
 <code latex>
@@ Ligne 48: / Ligne 69: @@
 </code>
-===== Avec l'extension hyperref =====
+===== Avec l'extension “hyperref” =====
-FIXME The [[ctanpkg>hyperref|hyperref]] package, which uses the typesetting code of [[ctanpkg>url|url]], in a context where the typeset text forms the anchor of a link.
+L'extension [[ctanpkg>hyperref|hyperref]] utilise le code de [[ctanpkg>url|url]] pour composer des liens
+et permet en plus de les rendre cliquables dans le document PDF.
-FIXME The author of this answer prefers the (rather newer) [[ctanpkg>url|url]] package (directly or indirectly); both [[ctanpkg>path|path]] and [[ctanpkg>url|url]] work well with Plain TeX (though of course, the fancy LaTeX facilities of [[ctanpkg>url|url]] don't have much place there). ([[ctanpkg>hyperref|hyperref]] isn't available in a version for use with Plain TeX.)
+===== Avec la commande “\discretionary” =====
-FIXME Note that neither ''\path'' (from package [[ctanpkg>path|path]]) nor ''\url'' (from package [[ctanpkg>url|url]]) is robust (in the LaTeX sense).  If you need a URL to go in a moving argument, you need the command ''\urldef'' from the [[ctanpkg>url|url]] package.  So one might write:
+La primitive ''\discretionary'' permet de dire comment couper une chaîne de caractères dans un texte : ''\discretionary{Avant la coupure}{après}{s'il n'y en a pas}''
-<code latex>
+<note>
-\urldef\faqhome\url{http://www.tex.ac.uk/faq}
+''\-'' est défini comme ''\discretionary{-}{}{}''.
-</code>
+</note>
-after which, ''\faqhome'' is robust.
 -----
@@ Ligne 65: / Ligne 86: @@
 //Source:// [[faquk>FAQ-setURL|Typesetting URLs]]
-{{htmlmetatags>metatag-keywords=(LaTeX)
+{{htmlmetatags>metatag-keywords=(LaTeX,adresse internet,adresse email,police tt,police machine à écrire,HTTP,HTTPS,lien web)
-metatag-og:title=(Comment gérer des adresses web (ou URL))
+metatag-og:title=(Comment écrire des adresses web (ou URL))
 metatag-og:site_name=(FAQ LaTeX francophone)
 }}