/usr/share/doc/HOWTO/fr-html/Xterm-Title.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<html>
<head>
<meta name="generator" content=
"HTML Tidy for HTML5 for Linux version 5.2.0">
<meta name="GENERATOR" content="LinuxDoc-Tools 0.9.72">
<title>Comment changer le titre d'un xterm</title>
</head>
<body>
<h1>Comment changer le titre d'un xterm</h1>
<h2>Ric Lister, <code>ric@giccs.georgetown.edu</code><br>
traduction Jean-Albert Ferrez,
<code>Jean-Albert.Ferrez@epfl.ch</code></h2>
Dernière modification&nbsp;: 22.11.1999, v2.0
<hr>
<em>Ce document explique comment utiliser des séquences
d'échappement pour modifier dynamiquement le titre de la fenêtre et
de l'icône d'un xterm. Des exemples sont donnés pour plusieurs
shells, et l'annexe donne les séquences pour d'autres types de
terminaux.</em>
<hr>
<h2><a name="s1">1. Où trouver ce document</a></h2>
<p>Ce document fait désormais partie des <a href=
"http://sunsite.unc.edu/LDP/HOWTO/">HOWTOs Linux</a> et peut être
trouvé à&nbsp;: <a href=
"http://sunsite.unc.edu/LDP/HOWTO/mini/Xterm-Title.html">http://sunsite.unc.edu/LDP/HOWTO/mini/Xterm-Title.html</a>.</p>
<p>La dernière version en date se trouve à&nbsp;: <a href=
"http://www.giccs.georgetown.edu/~ric/howto/Xterm-Title/">http://www.giccs.georgetown.edu/~ric/howto/Xterm-Title/</a>.</p>
<p>Ce document remplace le howto initial écrit par Winfried
Trümper.</p>
<p>Ndt&nbsp;: La version française de ce document se trouve
à&nbsp;: <a href=
"http://www.freenix.fr/linux/HOWTO/mini/Xterm-Title.html">http://www.freenix.fr/linux/HOWTO/mini/Xterm-Title.html</a></p>
<h2><a name="s2">2. Titres statiques</a></h2>
<p>Les titres des émulateurs de terminaux xterm, color-xterm ou
rxvt peuvent être donnés sur la ligne de commande avec les options
-T et -n&nbsp;:</p>
<blockquote>
<pre><code>
xterm -T "Le titre de mon XTerm" -n "Le titre de son icône"
</code></pre></blockquote>
<h2><a name="s3">3. Titres dynamiques</a></h2>
<p>Bon nombre de personnes trouvent utile de faire apparaître dans
le titre de leur terminal une information qui change dynamiquement,
telle que le nom du serveur sur lequel on est connecté, le
répertoire courant, etc.</p>
<h2><a name="ss3.1">3.1 Les séquences d'échappement xterm</a></h2>
<p>On peut changer le titre de la fenêtre et de l'icône dans un
xterm lancé en utilisant les séquences d'échappement XTerm. Les
séquences suivantes sont utiles dans ce but&nbsp;:</p>
<ul>
<li><code>ESC]0;<b>nom</b>BEL</code> -- Change le titre de la
fenêtre et de l'icône</li>
<li><code>ESC]1;<b>nom</b>BEL</code> -- Change le titre de
l'icône</li>
<li><code>ESC]2;<b>nom</b>BEL</code> -- Change le titre de la
fenêtre</li>
</ul>
<p>où ESC est le caractère escape (échappement, \033), et BEL est
le caractère bell (bip, \007).</p>
<p>Afficher l'une de ces séquences dans un xterm causera le
changement du titre de la fenêtre ou de l'icône.</p>
<p><b>Note</b>: Ces séquences fonctionnent également avec la
plupart des dérivés de xterm, tels que nxterm, color-xterm et rxvt.
D'autres émulateurs de terminaux utilisent d'autres
séquences&nbsp;; quelques exemples sont donnés en annexe. La liste
complète des séquences d'échappement est donnée dans le fichier
<a href=
"http://www.giccs.georgetown.edu/~ric/howto/Xterm-Title/ctlseq2.txt">
ctlseq2.txt</a> de la distribution de xterm, ou dans le fichier
<a href=
"http://www.giccs.georgetown.edu/~ric/howto/Xterm-Title/xterm.seq">xterm.seq</a>
de la distribution de <a href="http://www.rxvt.org/">rxvt</a>.</p>
<h2><a name="ss3.2">3.2 Afficher les séquences
d'échappement</a></h2>
<p>Pour les informations qui ne changent pas au cours de
l'éxécution du shell, telles que le serveur et le nom
d'utilisateur, il suffit d'afficher les séquences depuis le fichier
rc du shell&nbsp;:</p>
<blockquote>
<pre><code>
echo -ne "\033]0;${USER}@${HOST}\007"
</code></pre></blockquote>
devrait donner un titre du genre <code>nom@serveur</code>, pour
autant que les variables <code>$USER</code> et <code>$HOST</code>
soient correctes. Les options requises pour echo peuvent dépendre
du shell (cf ci-dessous).
<p>Pour les informations qui peuvent changer au cours de
l'exécution du shell, telles que le répertoire courant, ces
séquences doivent vraiment être données lors de chaque changement
de l'invite. De cette façon, le titre est mis à jour lors de chaque
commande et peut ainsi refléter des informations telles que le
répertoire en cours, le nom d'utilisateur, le nom du serveur, etc.
Certains shells offrent des fonctions spéciales pour y parvenir,
d'autres pas&nbsp;: il faut dans ce cas insérer la chaîne
directement dans le texte de l'invite.</p>
<h2><a name="s4">4. Exemples pour quelques shells</a></h2>
<p>Nous donnons ci-dessous des exemples pour les shells les plus
courants. Nous commençons avec <code>zsh</code> car il offre des
possibilités qui facilitent grandement notre tâche. Nous
progresserons ensuite vers des exemples de plus en plus
difficiles.</p>
<p>Dans tous les exemples ci-dessous, on teste la variable
d'environnement TERM pour être certain de n'appliquer ces séquences
que si l'on est dans un xterm (ou dérivé). Le test est fait sur
TERM=xterm*, de manière à inclure au passage les variantes telles
que TERM=xterm-color (défini par rxvt).</p>
<p>Encore une remarque au sujet des dérivés du C shell tels que
<code>tcsh</code> et <code>csh</code>. Dans ces shells, les
variables non-définies causent des erreurs fatales. Il est dès lors
nécessaire avant de tester la valeur de la variable
<code>$TERM</code>, de tester si elle existe pour ne pas
interrompre un shell non-interactif. Pour y parvenir, il faut
inclure les exemples ci-dessous dans quelque chose du
genre&nbsp;:</p>
<blockquote>
<pre><code>
  if ($?TERM) then
      ...
  endif
</code></pre></blockquote>
(À notre avis, il s'agit d'une raison parmi beaucoup d'autres de ne
pas utiliser les C shells. Voir <i><a href=
"http://language.perl.com/versus/csh.whynot">Csh Programming
Considered Harmful</a></i> pour une discussion utile).
<p>Pour utiliser les exemples suivants, placez-les dans le fichier
d'initialisation du shell aproprié, c'est-à-dire un fichier lu lors
du lancement d'un shell interactif. Le plus souvent il s'agit de
<code>.<i>shell</i>rc</code> (ex&nbsp;: <code>.zshrc</code>,
<code>.tcshrc</code>, etc.)</p>
<h2><a name="ss4.1">4.1 zsh</a></h2>
<p>On utilise quelques fonctions et codes offerts par
<code>zsh</code>&nbsp;:</p>
<blockquote>
<pre><code>
precmd ()   fonction exécutée juste avant chaque invite
chpwd ()    fonction exécutée lors de chaque changement de répertoire
\e          code du caractère escape (ESC)
\a          code du caractère bip (BEL)
%n          code remplacé par $USERNAME
%m          code remplacé par le hostname jusqu'au premier '.'
%~          code remplacé par le répertoire, avec '~' à la place de $HOME
</code></pre></blockquote>
De nombreux autres codes sont disponibles, voir 'man zshmisc'.
<p>Ainsi, le code suivant, mis dans ~/.zshrc, affiche
"nom@serveur:répertoire" dans le titre de la fenêtre (et de
l'icône).</p>
<blockquote>
<pre><code>
case $TERM in
   xterm*)
       precmd () {print -Pn "\e]0;%n@%m: %~\a"}
       ;;
esac
</code></pre></blockquote>
On arrive au même résultat en utilisant <code>chpwd()</code> au
lieu de <code>precmd()</code>. La commande interne
<code>print</code> fonctionne comme <code>echo</code>, mais donne
accès aux séquences <code>%</code>.
<h2><a name="ss4.2">4.2 tcsh</a></h2>
<p><code>tcsh</code> offre des possibilités similaires à celles de
<code>zsh</code>&nbsp;:</p>
<blockquote>
<pre><code>
precmd ()   fonction exécutée juste avant chaque invite
chpwd ()    fonction exécutée lors de chaque changement de répertoire
%n          code remplacé par $USERNAME
%m          code remplacé par le hostname jusqu'au premier '.'
%~          code remplacé par le répertoire, avec '~' à la place de $HOME
</code></pre></blockquote>
<p>Malheureusement, il n'y a pas d'équivalent à la fonction print
de <code>zsh</code> qui permette d'utiliser les codes de l'invite
dans la chaîne du titre&nbsp;; le mieux que l'on puisse faire est
d'utiliser les variables du shell (dans
<code>~/.tcshrc</code>)&nbsp;:</p>
<blockquote>
<pre><code>
switch ($TERM)
   case "xterm*":
       alias precmd 'echo -n "\033]0;${HOST}:$cwd\007"'
       breaksw
endsw
</code></pre></blockquote>
mais on obtient alors le chemin complet du répertoire, sans '~'.
Par contre, on peut mettre la chaîne dans l'invite&nbsp;:
<blockquote>
<pre><code>
switch ($TERM)
   case "xterm*":
       set prompt="%{\033]0;%n@%m:%~\007%}tcsh%# "
       breaksw
   default:
       set prompt="tcsh%# "
       breaksw
endsw
</code></pre></blockquote>
ce qui donne "<code>tcsh%</code> " comme invite, et
"<code><i>nom</i>@<i>serveur</i>: <i>répertoire</i></code>" dans le
titre (et l'icône) de xterm. Les "%{...%}" doivent être placés
autour des séquences d'échappement (et ne peuvent pas être le
dernier élément de l'invite, 'man tcsh' donne plus de détails).
<h2><a name="ss4.3">4.3 bash</a></h2>
<p><code>bash</code> offre la variable <code>PROMPT_COMMAND</code>
qui contient une commande à exécuter avant d'afficher l'invite. Ce
code (inséré dans <code>~/.bashrc</code>) affiche
<code>nom@serveur: répertoire</code> dans le titre de la fenêtre
(et de l'icône).</p>
<blockquote>
<pre><code>
PROMPT_COMMAND='echo -ne "\033]0;${USER}@${HOSTNAME}: ${PWD}\007"'
</code></pre></blockquote>
où <code>\033</code> est le caractère <code>ESC</code> et
<code>\007</code> <code>BEL</code>.
<p>Il convient de noter que les guillemets jouent un rôle
important&nbsp;: les variables entre <code>"..."</code> sont
évaluées, alors que celles entre <code>"..."</code> ne le sont pas.
Ainsi, <code>PROMPT_COMMAND</code> reçoit bien le nom des
variables, ces dernières étant évaluées lorsque
<code>PROMPT_COMMAND</code> est invoquée.</p>
<p>Cependant, <code>$PWD</code> donne le répertoire complet. Si
l'on veut utiliser le raccourci <code>~</code>, il faut placer
toute la séquence d'échappement dans l'invite pour avoir accès aux
codes suivants&nbsp;:</p>
<blockquote>
<pre><code>
\u          est remplacé par $USERNAME
\h          est remplacé par le hostname jusqu'au premier '.'
\w          est remplacé par le repertoire, avec '~' à la place de $HOME
\[...\]     signale une suite de caractère non-imprimables
</code></pre></blockquote>
<p>Ainsi le code suivant produit l'invite <code>bash$</code> , et
place <code>nom@serveur: répertoire</code> dans le titre (et
l'icône) de xterm.</p>
<blockquote>
<pre><code>
case $TERM in
   xterm*)
       PS1="\[\033]0;\u@\h: \w\007\]bash\$ "
       ;;
   *)
       PS1="bash\$ "
       ;;
esac
</code></pre></blockquote>
L'utilisation de <code>\[...\]</code> signale à <code>bash</code>
la présence de caractères non-imprimables, information dont il a
besoin lorsqu'il calcule la longueur de l'invite. Sans cette
précaution, les commandes d'édition de ligne ne savent plus très
bien où placer le curseur.
<h2><a name="ss4.4">4.4 ksh</a></h2>
<p><code>ksh</code> n'offre pas grand chose en terme de fonctions
et codes, il faut donc mettre notre chaîne dans l'invite pour
qu'elle soit mise à jour dynamiquement. L'exemple suivant produit
l'invite <code>ksh$</code> , et place <code>nom@serveur:
répertoire</code> dans le titre (et l'icône) de xterm.</p>
<blockquote>
<pre><code>
case $TERM in
   xterm*)
       HOST=`hostname`
       PS1='^[]0;${USER}@${HOST}: ${PWD}^Gksh$ '
       ;;
   *)
       PS1='ksh$ '
       ;;
esac
</code></pre></blockquote>
Cependant, <code>$PWD</code> donne le répertoire complet. On peut
ôter le préfixe <code>$HOME/</code> en utilisant la construction
<code>${...##...}</code>. De même, on peut tronquer le nom du
serveur à l'aide de <code>${...%%...}</code>.
<blockquote>
<pre><code>
HOST=`hostname`
HOST=${HOST%%.*}
PS1='^[]0;${USER}@${HOST}: ${PWD##${HOME}/}^Gksh$ '
</code></pre></blockquote>
Les caractères <code>^[</code> et <code>^G</code> désignent
<code>ESC</code> et <code>BEL</code> (ils peuvent être saisis dans
emacs à l'aide de <code>C-q ESC</code> et <code>C-q C-g</code>).
<h2><a name="ss4.5">4.5 csh</a></h2>
<p>C'est assez difficile à réaliser avec <code>csh</code>. On finit
par mettre ce qui suit dans le ~/.cshrc&nbsp;:</p>
<blockquote>
<pre><code>
switch ($TERM)
   case "xterm*":
       set host=`hostname`
       alias cd 'cd \!*; echo -n "^[]0;${user}@${host}: ${cwd}^Gcsh% "'
       breaksw
   default:
       set prompt='csh% '
       breaksw
endsw
</code></pre></blockquote>
Il a fallu faire un alias de la commande <code>cd</code> pour
mettre à jour l'invite. Les caractères <code>^[</code> et
<code>^G</code> désignent <code>ESC</code> et <code>BEL</code> (ils
peuvent être saisis dans emacs à l'aide de <code>C-q ESC</code> et
<code>C-q C-g</code>).
<p>Notes&nbsp;: sur certains systèmes <code>hostname -s</code> peut
être utilisé pour obtenir le nom de la machine au lieu du nom
qualifié. Les utilisateurs ayant des liens symboliques sur des
répertoires trouveront <code>`pwd`</code> plus précis que
<code>$cwd</code>.</p>
<h2><a name="s5">5. Afficher le nom de la commande en cours
d'exécution</a></h2>
<p>Souvent un utilisateur lance une longue commande en avant plan
telle que <code>top</code>, un éditeur, un lecteur de courrier
électronique, etc, et voudrait que le nom de cette commande figure
dans le titre de la fenêtre. C'est un problème délicat qui n'est
facile à résoudre qu'avec <code>zsh</code>.</p>
<h2><a name="ss5.1">5.1 zsh</a></h2>
<p><code>zsh</code> offre une fonction idéale pour cet
objectif&nbsp;:</p>
<blockquote>
<pre><code>
preexec()   fonction exécutée juste avant qu'une commande soit exécutée
$*,$1,...   arguments passés à preexec()
</code></pre></blockquote>
On peut donc insérer le nom de la commande de la manière
suivante&nbsp;:
<blockquote>
<pre><code>
case $TERM in
    xterm*)
      preexec () {
        print -Pn "\e]0;$*\a"
      }
    ;;
esac
</code></pre></blockquote>
Note: la fonction <code>preexec()</code> est apparue vers la
version 3.1.2 de <code>zsh</code>, vous devrez peut-être mettre à
jour votre ancienne version.
<h2><a name="ss5.2">5.2 Autres shells</a></h2>
<p>Ce n'est pas facile avec les autres shells qui n'ont pas
l'équivalent de la fonction <code>preexec()</code>. Si quelqu'un a
des exemples, merci de les communiquer par email à l'auteur.</p>
<h2><a name="s6">6. Annexe&nbsp;: séquences d'échappement pour
d'autres émulateurs de terminaux</a></h2>
<p>De nombreux émulateurs de terminaux modernes sont des dérivés de
<code>xterm</code> ou <code>rxvt</code> et acceptent les séquences
d'échappement que nous avons utilisées jusqu'ici. Certains
terminaux propriétaires fournis avec les diverses variantes d'unix
utilisent leur propres séquences.</p>
<h2><a name="ss6.1">6.1 <code>aixterm</code> d'IBM</a></h2>
<p><code>aixterm</code> reconnaît les séquences d'échappement de
<code>xterm</code>.</p>
<h2><a name="ss6.2">6.2 <code>wsh</code>, <code>xwsh</code> et
<code>winterm</code> de SGI</a></h2>
<p>Ces terminaux définissent <code>$TERM=iris-ansi</code> et
utilisent&nbsp;:</p>
<ul>
<li><code>ESCP1.y<i>texte</i>ESC\ Pour le titre de la
fenêtre</code></li>
<li><code>ESCP3.y<i>texte</i>ESC\ Pour le titre de
l'icône</code></li>
</ul>
La liste complète des séquences est donnée dans la page man
<code>xwsh(1G)</code>.
<p>Les terminaux d'Irix supportent également les séquences de
<code>xterm</code> pour définir individuellement le titre de la
fenêtre et de l'icône, mais pas celle pour définir les deux en même
temps.</p>
<h2><a name="ss6.3">6.3 <code>cmdtool</code> et
<code>shelltool</code> de Sun</a></h2>
<p><code>cmdtool</code> et <code>shelltool</code> définissent
<code>$TERM=sun-cmd</code> et utilisent&nbsp;:</p>
<ul>
<li><code>ESC]l<i>texte</i>ESC\ Pour le titre de la
fenêtre</code></li>
<li><code>ESC]L<i>texte</i>ESC\ Pour le titre de
l'icône</code></li>
</ul>
Ce sont des programmes vraiment horribles, il vaut mieux utiliser
autre chose.
<h2><a name="ss6.4">6.4 CDE dtterm</a></h2>
<p><code>dtterm</code> définit <code>$TERM=dtterm</code>. Il semble
qu'il reconnaisse à la fois les séquences <code>xterm</code>
standard ainsi que celles du <code>cmdtool</code> de Sun (testé sur
Solaris 2.5.1, Digital Unix 4.0, HP-UX 10.20).</p>
<h2><a name="ss6.5">6.5 HPterm</a></h2>
<p><code>hpterm</code> définit <code>$TERM=hpterm</code> et utilise
les séquences suivantes&nbsp;:</p>
<ul>
<li><code>ESC&amp;f0k<i>longueur</i>D<i>texte</i> Donne le texte
<i>texte</i> de longueur <i>longueur</i> comme titre de
fenêtre</code></li>
<li><code>ESC&amp;f-1k<i>longueur</i>D<i>texte</i> Donne le texte
<i>texte</i> de longueur <i>longueur</i> comme nom de
l'icône</code></li>
</ul>
<p>Un programme C simple pour calculer la longueur et afficher la
bonne séquence ressemble à&nbsp;:</p>
<blockquote>
<pre><code>
#include &lt;string.h&gt;
int main(int argc, char *argv[])
{
    printf("\033&amp;f0k%dD%s", strlen(argv[1]), argv[1]);
    printf("\033&amp;f-1k%dD%s", strlen(argv[1]), argv[1]);
    return(0);
}
</code></pre></blockquote>
<p>On peut également écrire un shell-script équivalent, utilisant
<code>${#string}</code> (<code>zsh</code>, <code>bash</code>,
<code>ksh</code>) ou <code>${%string}</code> (<code>tcsh)</code>
pour obtenir la longueur d'une chaîne. L'exemple suivant est pour
<code>zsh</code>&nbsp;:</p>
<blockquote>
<pre><code>
case $TERM in
    hpterm)
        str="\e]0;%n@%m: %~\a"
        precmd () {print -Pn "\e&amp;f0k${#str}D${str}"}
        precmd () {print -Pn "\e&amp;f-1k${#str}D${str}"}
        ;;
esac
</code></pre></blockquote>
<h2><a name="s7">7. Annexe&nbsp;: exemples dans d'autres
langages</a></h2>
<p>Il peut être utile d'écrire des bouts de codes pour changer le
titre de la fenêtre à l'aide des séquences <code>xterm</code>.
Voici quelques exemples&nbsp;:</p>
<h2><a name="ss7.1">7.1 C</a></h2>
<blockquote>
<pre><code>
#include &lt;stdio.h&gt;

int main (int argc, char *argv[]) {
  printf("%c]0;%s%c", '\033', argv[1], '\007');
  return(0);
}
</code></pre></blockquote>
<h2><a name="ss7.2">7.2 Perl</a></h2>
<blockquote>
<pre><code>
#!/usr/bin/perl
print "\033]0;@ARGV\007";
</code></pre></blockquote>
<h2><a name="s8">8. Crédits</a></h2>
<p>Merci aux personnes suivantes pour leur contribution à ce
document.</p>
<p>Paul D. Smith <code>&lt;psmith@BayNetworks.COM&gt;</code> et
Christophe Martin <code>&lt;cmartin@ipnl.in2p3.fr&gt;</code> ont
tous les deux remarqué que j'avais interverti les guillemets dans
le <code>PROMPT_COMMAND</code> pour <code>bash</code>. Les avoir
dans le bon ordre garantit que les variables sont évaluées
dynamiquement.</p>
<p>Paul D. Smith <code>&lt;psmith@BayNetworks.COM&gt;</code> a
proposé de protéger les caractères non-imprimables dans l'invite de
<code>bash</code>.</p>
<p>Christophe Martin <code>&lt;cmartin@ipnl.in2p3.fr&gt;</code> a
donné la solution pour ksh.</p>
<p>Keith Turner <code>&lt;keith@silvaco.com&gt;</code> a donné les
séquences d'échappement pour les <code>cmdtool</code> et
<code>shelltool</code> de Sun.</p>
<p>Jean-Albert Ferrez <code>&lt;ferrez@dma.epfl.ch&gt;</code> a
signalé un manque de cohérence dans l'utilisation de
"<code>PWD</code>" et "<code>$PWD</code>", ainsi que de
"<code>\</code>" et "<code>\\</code>".</p>
<p>Bob Ellison <code>&lt;papillo@hpellis.fc.hp.com&gt;</code> et
Jim Searle <code>&lt;jims@broadcom.com&gt;</code> ont testé
<code>dtterm</code> sur HP-UX.</p>
<p>Teng-Fong Seak <code>&lt;seak@drfc.cad.cea.fr&gt;</code> a
suggéré l'option <code>-s</code> de <code>hostname</code>,
l'utilisation de <code>`pwd`</code>, et de <code>echo</code> sous
<code>csh</code>.</p>
<p>Trilia <code>&lt;trilia@nmia.com&gt;</code> a suggéré les
exemples dans d'autres langages.</p>
<p>Brian Miller <code>&lt;bmiller@telstra.com.au&gt;</code> a
fourni les séquences d'échappement et les exemples pour
<code>hpterm</code>.</p>
<p>Lenny Mastrototaro <code>&lt;lenny@click3x.com&gt;</code> a
expliqué l'utilisation des séquences xterm dans les émulateurs de
terminaux Irix.</p>
<p>Paolo Supino <code>&lt;paolo@init.co.il&gt;</code> a suggéré
l'utilisation de <code>\\$</code> dans le prompt de
<code>bash</code>.</p>
</body>
</html>
doc-linux-fr-html 2013.01-3ubuntu1 / usr / share / doc / HOWTO / fr-html / Xterm-Title.html
