..
  Copyright (C)  2023  Jeremie Salvi.
  Permission is granted to copy, distribute and/or modify this document
  under the terms of the GNU Free Documentation License, Version 1.3
  or any later version published by the Free Software Foundation;
  with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
  A copy of the license is included in the section entitled "GNU
  Free Documentation License".

Installation de rxvt unicode
============================

Rxvt-unicore ou urxvt est un terminal léger, configurable et facile d'accès. C'est
une bonne alternative a xterm, il est plus puissant tout en restant aussi simple,
et évite d'installer des terminaux trop lourds comme ceux fournis avec les plus
grosses interfaces graphiques.

Prérequis
---------

Aucun, sous arch, il suffit d'ouvrir un shell et de l'installer.

.. code-block:: bash

  pacman -S rxvt-unicode

Configuration
-------------

La configuration se fait depuis .Xresources, soit depuis ``/etc/X11/xinit/`` pour la configuration globale,
ou depuis ``~/.Xresources`` pour la surdéfinition des paramètres par l'utilisateur.
voici les paramètres généraux que j'utilise, plus d'infos dans le manpage (ou via un moteur de recherche |:smile:|)

.. code-block:: bash

  !-------------------------
  ! Global Term Parameters
  !-------------------------

  *.foreground:#abb2bf
  *.foreground-dark:#5c6370
  *.background:#282c34
  *.background-light:#333842
  *.background-dark:#21252b
  *.cursorColor:#98c379
  *.scrollBar:false
  *.saveLines:65535
  *.termName:rxvt-unicode
  *.font:xft:DejaVu Sans Mono:style=Regular:size=12:antialias=true
  *.boldFont:xft:DejaVu Sans Mono:style=Bold:size=12:antialias=true
  !*.font:xft:Material Icons:style=Regular:size=14:antialias=true
  !*.boldFont:xft:Iosevka Nerd Font Mono:style=Bold:size=14:antialias=true
  !*.letterSpace:-4
  *.intensityStyles:true
  *.iconFile:/usr/share/icons/ePapirus/96x96/apps/urxvt.svg
  *.cutchars:"()<>=[]{}|\"\`'*"
  *.iso14755:false
  *.utf8:true
  *.geometry:87x27

  !-------------------------
  ! One Dark theme colors
  !-------------------------

  !Black & grey
  !*color0:#21252b
  !*color8:#282c34
  !Red & lightred
  *color1:#e06c75
  *color9:#e06c75
  !Green & lightgreen
  *color2:#98c379
  *color10:#98c379
  !Yellow & lightyellow
  *color3:#ffd766
  *color11:#ffd766
  !Blue & lightblue
  *color4:#61afef
  *color12:#61afef
  !Magenta & lightmagenta
  *color5:#c678dd
  *color13:#c678dd
  !Cyan & lightcyan
  *color6:#56b6c2
  *color14:#56b6c2
  !Lightgrey & white
  !*color7:#333842
  !*color15:#d7dae0

  !-------------------------
  ! Rxvt Only
  !-------------------------
  URxvt.perl-ext:-confirm-paste

  ! Pseudo Transparency
  !URxvt.transparent: true
  !URxvt.shading: 50
  !URxvt.blurRadius: 20

  ! True Transparency (works only with a composite manager like xcompmgr !)
  !URxvt.depth: 32
  !URxvt.background:[50]#282c34
  !URxvt.background:rgba:2800/2c00/3400/F000

Utilisation des extensions perl
-------------------------------

Le point fort d'urxvt c'est de pouvoir charger des extensions en perl et le rendre hautement configurable.
sous arch, il y en a installées par defaut dans ``/usr/lib/urxvt/perl``. Si vous ne trouvez pas la votre,
il faudra la télécharger dans ce dossier.

Pour les configuer, toujours dans ``.Xresources`` il faut ajouter les lignes suivantes :

.. code-block:: bash

  URxvt.perl-lib:/usr/lib/urxvt/perl
  URxvt.perl-ext-common:tabbed,resize-font,matcher

  !Configure font size extension :
  URxvt.keysym.C-Up:    resize-font:bigger
  URxvt.keysym.C-Down:  resize-font:smaller
  URxvt.keysym.C-equal: resize-font:reset
  URxvt.keysym.C-slash: resize-font:show

  !Configure Url Launcher
  URxvt.url-launcher: firefox
  URxvt.matcher.button: C-1 
  URxvt.keysym.C-u: perl:matcher:select

  !Configure tabbed extension according terminal.sexy
  !*.color0: #101010
  !*.color1: #008800
  *.tabbed.tabbar-bg: 0
  *.tabbed.tab-fg:    0
  *.tabbed.tab-bg:    1
  *.tabbed.tabbar-fg: 1

Choisir son jeu de couleur
--------------------------

Voici un lien sympa qui nous aide à choisir nos couleurs pour avoir des contrastes qui rendent l'interface
accessible : `terminal sexy <https://terminal.sexy/#DwoY0svhGRIlIxoyNipKUD9tcVqXk4C0ua7P5OHtda7C2rzJarecg8mwZ6SPuq3T0YSqcLOb>`_.

Notes
-----
Le copier coller se fait avec ``Ctrl+Alt+C`` et ``Ctrl+Alt+V``.