Éditer du texte en ligne de commande

Ne tournons pas autour du pot, nous allons parler de vim et pas de emacs, même si les idées de RMS sont dans mon cœur.

Pendant longtemps, j’ai utilisé vi comme éditeur de texte en étant persuadé je j’utilisais vim. Puis un jour, après avoir configuré mutt (maileur en ligne de commande) pour utiliser vi, j’ai eu besoin de la correction orthographique. Or, tout ce que j’ai tenté de faire pour y parvenir n’a pas fonctionné jusqu’au moment où j’ai regardé si vim était bien installé. Il ne l’était pas. J’utilisais vi dans sa nudité la plus pure sous Debian. J’ai donc installé vim et beaucoup de choses sont apparues qui m’ont donné envie d’écrire cet article.

Configuration

La configuration de vim se fait dans le fichier ~/.vimrc. Voici une configuration très simple qui permet de voir comment cela fonctionne :

ab moi Machin Truc <machin.truc@chose.org>
" Un commentaire
set mouse=a
set number
set spell
set t_Co=256
map <F2> :set spell!<CR>
set spelllang=fr,en
hi SpellBad ctermfg=Red ctermbg=NONE

La première ligne crée un alias. En tapant « moi » dans vim suivi d’un espace, le texte « moi » sera remplacé par « Machin Truc <machin.truc@chose.org> ».
Ensuite se trouve un commentaire, annoncé par des guillemets « .
mouse=a précise que la souris peut être utilisée pour placer le curseur. C’est très utile, car dans vim, on se déplace dans la ligne et non de haut en bas à travers les lignes.
number spécifie qu’on veut des numéros de lignes.
spell spécifie qu’on peut utiliser un correcteur orthographique.
t_Co=256 fait passer la console en mode 256 couleurs.
map … lie la touche F2 à une bascule qui permet de passer au ou de revenir du mode de correction orthographique.
spelllang précise évidemment la ou les langues utilisées.
hi configure la couleur du texte (rouge) d’un mot mal orthographié et de son fond (ici aucun).

Correction orthographique

Un bon article sur la correction orthographique sous vim : http://www.jdhp.org/docs/tutoriel_vim_spellfr/tutoriel_vim_spellfr.html

La correction d’un mot se fait en tapant «z=». Des propositions sont faites alors et il faut choisir l’une d’entre elle dans la liste par son numéro.

On peut corriger toutes les occurrences d’un mot avec la commande «:spellr».
On passe de faute en faute vers le bas avec «]s» et vers le haut avec «[s ».
On peut désactiver et réactiver la correction orthographique, avec «:set spell» et «:set nospell».

Éditeur de texte

Déplacements

Ici, vi et vim se confondent. Ce sont des éditeur dédié au clavier et clairement orienté vers la logique de la structure. Celle-ci fait clairement la différence entre la structure logique du texte qui fait le sens d’un paragraphe et ce que l’on voit à l’écran. Un paragraphe logique peut s’étaler sur plusieurs lignes à l’écran. À la fin de celui-ci se trouve un saut de paragraphe. Pour l’écran, il y a plusieurs saut de lignes dans ce paragraphe. Si l’éditeur de texte ne fait pas la différence entre ces sauts et un saut de paragraphe, quand vous le copierez dans un éditeur ou le texte brut est nécessaire, en HTML par exemple, le paragraphe formera plusieurs lignes et la justification sera mauvaise. De plus la numérotation ne sera pas celle des lignes logiques, c’est-à-dire celle des paragraphes, mais celle arbitraire due à la largeur de l’écran.

Cela a une grande importance pour le déplacement à l’aide des touches clavier. Pour se déplacer dans une ligne, les flèches gauche et droite ou les touches H et L respectivement permettent de se déplacer d’un caractère vers la gauche ou la droite respectivement. Entre les lignes les flèches bas et haut ou les touches J et K respectivement permettent de se déplacer d’une ligne vers le bas ou le haut respectivement.

← ou H : un caractère vers la gauche
↓ ou J : une ligne vers le bas
↑ ou K : une ligne vers le haut
→ ou L : un caractère vers la droite

Pour les déplacement dans la ligne, il faut avoir recours aux touches suivantes :

0 : curseur sur le premier caractère de la ligne
17→ ou 17L : curseur 17 caractères plus loin vers la droite
5← ou 5H : curseur 5 caractères plus loin vers la gauche
^^ : curseur sur le premier caractère de la ligne
$ : curseur sur le dernier caractère de la ligne
w : saut d’un mot vers la fin de la ligne (séparateurs de mots non alphanumériques)
b : saut d’un mot vers le début de la ligne (séparateurs de mots non alphanumériques)
W : saut d’un mot vers la fin de la ligne (séparateur de mots : espaces)
B : saut d’un mot vers le début de la ligne (séparateur de mots : espace)
( : saut vers le début de la phrase ou le début de la phrase précédente
) : saut vers le début de la phrase suivante

gg : curseur au début de la première ligne
G : curseur au début de la dernière ligne
7G : curseur au début de la 7e ligne
{ : saut vers le paragraphe précédent
} : saut vers le paragraphe suivant

H : curseur en haut de l’écran
M : curseur au milieu de l’écran
L : curseur en bas de l’écran

Modifications

21. Météo en ligne de commande

Dans le cas de la météo, les données à récupérer doivent forcément être sur internet. L’idée est donc « simplement » de les récupérer à l’aide d’un programme généraliste qui n’est pas spécifiquement dédié à la météo. Il s’agit de

CURL
cURL est une interface en ligne de commande, destinée à récupérer le contenu d’une ressource accessible par un réseau informatique.
Cette commande va nous permettre d’interroger un service externe, mais surtout elle offre une interface proche de la ligne de commande classique comme on va le voir. La première étape est donc d’installer cURL si ce n’est déjà fait :
apt-get install cURL
Puis, on peut immédiatement interroger la ressource wttr.in ainsi :
curl wttr.in
pour obtenir les prévision en un endroit non choisi.
À l’instar de la ligne de commande, on peut avoir accès au options disponibles pour ce service de la manière suivante :
curl wttr.in/:help
Le résultat est une magnifique aide, formellement très semblable à ce que peut fournir un logiciel en ligne de commande, qui va nous permettre de spécifier l’utilisation de la langue française et le lieux choisi :
curl -H "Accept-Language: fr" wttr.in/vannes
et le résultat est magnifique :

Relevons l’existence d’un autre service tout aussi simplement accessible, mais moins abouti graphiquement et qui fait appel à la commande finger, généralement dédiée à des informations sur l’utilisateur (essayez finger dans options), mais utilisée ici pour interroger un service externe :

finger vannes@graph.no

Quelques options sont décrites dans cet article si vous voulez l’utiliser, mais nous n’irons pas plus loin ici.

WordPress : catégorie d’accueil

Ce tout petit article pour décrire comment demander à WordPress d’afficher une catégorie d’articles en page d’accueil.

Évidemment, il ne faut pas faire afficher une page statique comme page d’accueil, mais des articles. Pour cela il faut aller dans Réglages -> Lecture et choisir « Les derniers articles ». Mais, dans ces conditions, ce sont les articles de toutes les catégories qui vont s’afficher.

Pour filtrer ceux-ci pour n’en afficher qu’une seule, il suffit d’ajouter au fichier functions.php du thème, tout à la fin :

function affiche_category($query) {
if ($query->is_home() && $query->is_main_query()) {
$query->set('category_name', 'accueil');}}
add_action('pre_get_posts', 'affiche_category');

Dans un premier temps, on y définit une fonction dont l’action sera de ne retourner que les articles de la catégorie accueil. Elle porte évidemment le nom affiche_category et reçoit une requête ($query), un article par exemple. En premier lieu, elle détermine si l’article est destiné à la page de blog de WordPress (is_home), c’est-à-dire la page principale des articles (celle-ci pourrait ne pas être la page d’accueil du site si une page statique avait été choisie pour celui-ci ; une autre fonction pourrait alors être utilisée is_front_page différence) et si la requête est principale (porte sur des articles ou page et non sur leur contenu). Si les deux conditions sont remplies, elle utilise la méthode set pour sélectionner les articles qui font partie de la catégorie dont le nom est accueil (catégorie définie préalablement par vous-même dans WordPress).

Enfin, cette fonction est déclarée comme une action à effectuer avant (pre_get_posts) la requête principale (is_main_query). Référence.

Voilà, notez que d’autres possibilités existent pour choisir une, ou plusieurs, catégories (RTFM).

19. Calendrier en ligne de commande

Ce que je voulais c’est la possibilité de mettre/retirer ou voir des événements sur mes calendriers. La recherche d’applications ne fut pas très longue, car une solution s’est imposée d’elle-même : calendar-cli. En effet, est mentionné sur la page de calendar-cli une alternative (gcalendar-cli) dont le g ne me satisfaisait pas (g ne signifiant pas Gnome, mais Goo…). De plus, la philosophie du projet calendar-cli :

The philosophy behind calendar-cli is slightly different, calendar-cli is supposed to be a simple cli-based caldav+ical client. No synchronization, no local storage.

étant simplement parfaite et le fait que celui-ci soit programmé en python m’a définitivement convaincu.

J’ai donc décidé de l’installer.

Le premier problème rencontré a été du à l’utilisation de python3. En effet, selon :

https://static.cinay.xyz/2016/05/calendar-cli-ligne-de-commande.html

il est nécessaire d’installer icalendar, caldav et tzlocal. Or, il existe phython3-icalendar, python3-caldav et python3-tzlocal dans les dépôts. J’ai donc installé tout cela et au premier lancement de calendar-cli me suis vu retourner une erreur liée à l’absence d’une méthode de tzlocal. En inspectant le fichier source, la première chose qui m’a frappé était l’appel à python2 en première ligne. J’ai donc installé python-icalendar, python-caldav et python-tzlocal et cette erreur à disparu.

On verra plus tard que la migration à python3 est en cours.

L’installation ne se fait pas via les dépôts puisqu’il n’y existe pas. Mais sur le second site mentionné ci-dessus, les instructions sont claires :

cd ~/scripts git clone https://github.com/tobixen/calendar-cli

Création d’un lien nommé calendarcmd

sudo ln -s /home/yannick/scripts/calendar-cli/calendar-cli.py /usr/local/bin/calendarcmd

Le fichier de configuration ~/.config/calendar.conf au format json

nano ~/.config/calendar.conf
{ "default": 
  { "caldav_url": "http://foo.bar.example.com/caldav/", 
    "caldav_user": "luser",
    "caldav_pass": "insecure"
  }
}

Les droits sur le fichier de configuration

chmod 0600 ~/.config/calendar.conf

Claires, parfaitement fonctionnelles, mais on en trouve une critique sur le site du projet (premier lien ci-dessus), puisqu’il est conseillé d’utiliser calendar_url pour spécifier l’adresse du calendrier spécifique d’un utilisateur et n’utiliser caldav_url que pour l’adresse du site fournissant les calendriers. Pour Framasoft, par exemple, cela donne :

{ "default":
{ "caldav_url": "https://framagenda.org/remote.php/dav/calendars/",
"calendar_url": "machin@truc.chose/personnel/",
"caldav_user": "nom_utilisateur",
"caldav_pass": "mdp"
},
"professionnel":
{ "caldav_url": "https://framagenda.org/remote.php/dav/calendars/",
"calendar_url": "machin@truc.chose/professionnel/",
"caldav_user": "nom_utilisateur",
"caldav_pass": "mdp"
}
}

Vient ensuite la phase de tests. La commande à lancer est, on l’aura compris : calendarcmd. Mais, quelle est la structure des ses arguments ? Deux exemples sont donnés. Le premier pour ajouter un événement :

calendarcmd calendar add '2016-05-18 11:45:00+2h' 'Test calendrier en ligne de commande'

Tout s’est bien passé. L’événement ajouté, s’est retrouvé comme par miracle sur mon calendrier.

Le second pour voir les événements depuis une date donnée :

calendarcmd calendar agenda --from-time=2016-05-17 --agenda-days=14

Une erreur s’est alors produite :

Traceback (most recent call last):
File "/usr/local/bin/calendarcmd", line 945, in <module>
main()
File "/usr/local/bin/calendarcmd", line 942, in main
ret = args.func(caldav_conn, args)
File "/usr/local/bin/calendarcmd", line 480, in calendar_agenda
events_ = find_calendar(caldav_conn, args).date_search(dtstart, dtend, expand=True)
TypeError: date_search() got an unexpected keyword argument 'expand'

Ici, un digression est nécessaire. La simplicité de cette erreur permettant de ne pas trop s’allonger ici, je me permet de la mettre en valeur pour montrer que l’accès au code source est indéniablement un plus dans ce genre de cas.

La lecture du retour d’erreur est claire : ligne 480 dans le code de la commande calendarcmd se trouve une erreur liée à un argument inattendu : expand. Évidemment, il faut savoir lire et prendre le temps de le faire. De plus, il faut se rappeler que la commande calendarcmd est un lien vers calendar-cli.py (voir ci-dessus). C’est donc dans ce fichier qu’il faut chercher.

À la ligne 480 se trouve :

events_ = find_calendar(caldav_conn, args).date_search(dtstart, dtend, expand=True)

et le problème vient du dernier argument de la méthode date_search de l’objet find_calendar. Évidemment, il est facile de simplement le supprimer, vu que « got an unexpected keyword argument ‘expand’ » dit clairement que python ne comprends pas celui-ci. Le problème est qu’il est parfois risqué de lancer une méthode en lui retirant un argument qui pourrait alors être par défaut différent de celui qui était donné. Enfin, par prudence, avant de le supprimer j’ai tenté de trouver la signature de la méthode (c’est-à-dire la spécification de l’ensemble des arguments qu’il utilise). Mais encore fallait-il savoir où chercher en d’autres termes, à quel module appartenait la méthode date_search où l’objet find_calendar.

À force de recherches, je suis tombé sur la documentation de caldav :

https://pythonhosted.org/caldav/caldav/objects.html#caldav.objects.Calendar.date_search

et y ai trouvé la méthode :date_search(start, end=None, compfilter=’VEVENT’) avec la description des paramètres :

  • start = datetime.today().
  • end = same as above.
  • compfilter = defaults to events only. Set to None to fetch all calendar components.

Le dernier paramètre n’étant pas expand et la valeur par défaut de compfilter étant pour récupérer tous les éléments du calendrier, supprimer le dernier argument devait être possible. Je l’ai donc fait et tout a très bien fonctionné.


Ainsi, les deux commandes de base :

calendarcmd calendar add '2016-05-18 11:45:00+2h' 'Test calendrier en ligne de commande'
calendarcmd calendar agenda --from-time=2016-05-17 --agenda-days=14

s’utilisent maintenant sans difficultés. Attention, la première va fournir en retour d’un ajout réussi, un uid d’événement (un nombre unique) qui est nécessaire pour éventuellement le supprimer (voir ci-dessous).

Pour la gestion de multiples calendriers, il suffit d’ajouter –config-section=professionnel :

calendarcmd calendar --config-section=professionnel agenda --from-time=2016-05-17 --agenda-days=14

pour obtenir les événements du calendrier professionnel. Pour en retirer :

calendarcmd calendar delete --event-uid=l_uid_de_l_evenement

Malheureusement, le retrait d’évènements par date n’est pas encore implémenté.

Pour trouver des événements et les supprimer, il faut leur uid. La commande suivante permet de les obtenir :

calendarcmd calendar --config-section=professionnel agenda --event-template "{dtstart} {summary} {uid}"

Elle retourne les événements du calendrier spécifié avec leur date de départ, le texte de commentaire et l’uid.

0. Ligne de commande

Mis en avant

Suite à mon article sur la nécessité d’une autre informatique, beaucoup moins dépendante des interfaces graphiques et aux antipodes de la vidéo et suite aux nombreux autres articles que j’ai rédigés sur différents aspects d’une informatique en ligne de commande, voici un petit tour d’horizon de ce qu’il est possible de faire de cette manière :

  1. Pourquoi relever ses mails en ligne de commande
  2. Comment relever ses mails en ligne de commande 1
  3. Comment relever ses mails en ligne de commande 2
  4. Terminator pour la ligne de commande
  5. Gérer ses fichiers en ligne de commande
  6. Naviguer en ligne de comande
  7. Lynx, midnight commander et mutt transparents dans terminator
  8. Installer un shell particulier : zsh
  9. Gestion du temps et des tâches en ligne de commande
  10. Redimensionner en ligne de commande
  11. Flux RSS en ligne de commande
  12. De la musique en ligne de commande
  13. GNUpg en ligne de commande
  14. Images en ligne de commande : planche de contact
  15. Carnet d’adresse en ligne de commande
  16. Mutt avancé en ligne de commande
  17. Covid eo 19
  18. Processus en avant/arrière plan
  19. Calendrier en ligne de commande
  20. Suivi de poids en ligne de commande
  21. Météo en ligne de commande
  22. Éditer du texte en ligne de commande
  23. À suivre …

Écrire n’est pas un métier, c’est une envie

15. Carnet d’adresse en ligne de commande

L’un des problèmes liés à l’utilisation de mutt est celui de la mémorisation des adresses email.

Les alias

Mutt est intéressant de ce point de vue, car il permet d’associer à chaque adresse un alias. Ainsi, en écrivant dans le fichier de configuration :

alias ptitnom machin.truc@longnomdedomaine.org

on spécifie l’utilisation possible de « ptitnom » à la place de la longue adresse email qui lui correspond. Ainsi, quand on demande d’écrire un message (m), comme destinataire il suffit d’écrire « ptitnom » pour que mutt le remplace par son adresse email.

Attention, ce n’est pas valable dans l’éditeur de texte vi. Pour obtenir le même comportement, il faut le faire spécifiquement pour vi.

Évidemment, écourter les adresse email est une bonne chose, mais elle des limites. Au bout d’un certain temps, le nombre d’alias grandissant, on ne s’y retrouve plus. Il faut donc un autre mécanisme que nous allons présenter ici.

Mais avant, une autre utilisation des alias est à signaler. En effet, on peut écrire :

alias famille truc@domaine.org, machin@domaine.org, chose@domaine.org

La séparation par des virgules de plusieurs adresses permet de spécifier en un seul mot (l’alias) l’envoi d’un mail à plusieurs personnes simultanément.

Attention cependant, toutes les adresses sont placées dans le champ TO. Ainsi, l’ensemble des destinataires sont clairement visibles par tous les autres.

Le répertoire d’adresse

Il s’agit de l’application abook. Une petite application en ligne de commande s’intégrant bien avec mutt.

Tout d’abord, il faut l’installer. Abook est dans les dépôts de toute distribution Linux classique. Il suffit donc de faire :

apt-get install abook

en mode superutilisateur.

Puis, il faut informer mutt qu’il est possible d’utiliser abook (sans renoncer aux alias :-). Ainsi, on va définir le comportement de deux touches : la touche de recherche Q et la touche A par l’ajout du code suivant dans .muttrc :

set query_command="abook --mutt-query '%s'"
macro index,pager A "|abook --add-email-quiet" 'add sender to abook'

La première ligne définit la commande de recherche. En pressant sur la touche Q (pas q qui vous fera quitter mutt), mutt va vous demander un mot à chercher. Par exemple le nom du correspondant à qui vous voulez écrire. Puis en tapant Enter, on fait passer ce mot à abook pour qu’il le recherche dans sa base de donnée. S’il le trouve, il en affiche les éléments et vous permet de demander l’envoi du message à ce correspondant.

La seconde ligne permet de définir le comportement de la touche A, qui peut être utilisée depuis l’index (la liste des messages) ou le pager (le message en mode de lecture ; pas en mode écriture sous vi). Elle lance encore abook pour y ajouter l’adresse E-mail sélectionnée dans mutt. Attention, il peut parfois sembler que l’adresse n’est pas enregistrés dans abook. Souvent c’est le signe d’un mauvais encodage et il faut alors lancer abook pour y écrire correctement les informations.

Pour gérer les adresse E-mail, il suffit de lancer abook, directement dans la console. Vous obtenez alors la liste de vos contacts avec différentes actions possibles sur ceux-ci, annoncées dans une barre en haut de l’écran. Vous pouvez ajouter un contact avec la touche a, en effacer un avec r et l’éditer en appuyant sur Enter. Vous verrez alors apparaître différents onglets qui vous donnent accès à différents renseignements sur le contact, comme son numéro de téléphone par exemple.

Et c’est tout. Abook est un gestionnaire de contact simple, mais qui fait bien sont travail.