wiki.soucy.cc

ImageMagick

2026-07-06T10:08:32Z

ImageMagick

Dither

convert my-image.png -dither FloydSteinberg -colors 8 my-image-dthr.png

makefile

2026-03-10T11:58:22Z

Makefile

Voici par exemple, le Makefile que j'utilise ici:

# Makefile of wiki.soucy.cc
# <https://man.openbsd.org/make>
.POSIX:
SHELL := /bin/sh
all: build deploy
add:
satelito exec add
css:
./assets/css/css.sh
assets: css
build: assets
satelito make --export
deploy:
./bin/deploy
serve:
python3 -m http.server 8080 -d ./public_html/
watch:
find ./assets/css/ | entr -c -d ./assets/css/css.sh

Je m'en sers pour exécuter des tâches répétitives liés à un projet de site web statique. Mais les Makefile sont habituellement pour gérer des dépendances et compiler.

Sources / Ressources

wimm

2026-03-07T13:49:27Z

wimm – web image manager

wimm est une application Tcl que j'ai écrite pour me faciliter la vie avec les images destinées au Web. Pour l'instant elle fait trois choses correspondant à ces trois commandes:

optimize: dans une arborescence, trouver toutes les images aux formats png, jpeg, gif, svg, et les compresser avec des librairies comme pngquant, jpegtran, gifsicle, svgo, etc.
resize: redimensionner des images selon des valeurs donnés en arguments dans une liste Tcl.
sprite: convertir des fichers SVG en symboles, puis les exporter en un sprite SVG.

Les nom des images doivent être transmis par stdin:

echo monimage.png | wimm optimize
find images/ | wimm optimize

Pour chaque image, le traitement sera affiché dans le terminal:

find . | wimm optimize
pngquant OK
¤ -------------------------------------------------- ¤
¤ my-panda.png (pngquant) :
¤ -> [Before] 85.4677734375 | [After] 44.248046875 = -50%
¤ -------------------------------------------------- ¤
...

Une version de l'image compressée est créé avec le suffixe -wimm (ex.: my-panda-wimm.png). L'originale demeure intacte.

En option, un suffixe personnalisé peut-être appliqué:

find assets/images/ | wimm optimize --suffix "-optim"

Pour la commande resize, il suffit de mettre les valeurs de la redimension entre guillemets double et séparé par un espace:

find test/last-litre-of-petrol.jpeg | wimm resize "520 760"
¤ ----------------------------------------------------------------------------- ¤
¤ -> /home/hs0ucy/.hs0ucy/Code/wimm/test/last-litre-of-petrol-520w-wimm.jpeg
¤ ----------------------------------------------------------------------------- ¤
¤ ----------------------------------------------------------------------------- ¤
¤ -> /home/hs0ucy/.hs0ucy/Code/wimm/test/last-litre-of-petrol-760w-wimm.jpeg
¤ ----------------------------------------------------------------------------- ¤
Usage: <img srcset="last-litre-of-petrol-520w-wimm.jpeg 520w, last-litre-of-petrol-760w-wimm.jpeg 760w" ... />

wimm sprite va trouver tous les SVG, les convertir en element <symbol/>, et les combinés dans un seul fichier.

Le résultat s'affichera dans le terminal et une copie sera créé (/tmp/svg-sprite-wimm.svg).

find test/ | wimm sprite
<svg height="0" width="0" id="spriteSVG" aria-hidden="true" style="position:absolute" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
<symbol id="symbol-arrows-horizontal" width="24" height="24" fill="none">
<path xmlns="http://www.w3.org/2000/svg" fill-rule="evenodd" clip-rule="evenodd" d="M15 9V7H17V9H15ZM17 15V13H13V11H17V9H19V11L21 11V13L19 13V15H17ZM17 15V17H15V15H17ZM11 11V13H7V15H5V13L3 13V11L5 11V9L7 9V11H11ZM7 15H9V17H7V15ZM9 7V9H7V7H9Z" fill="black"/>
</symbol>
<symbol id="symbol-arrows-vertical" width="24" height="24" fill="none">
<path xmlns="http://www.w3.org/2000/svg" fill-rule="evenodd" clip-rule="evenodd" d="M11 11H13V7H15V9H17V7H15V5H13V3H11V5H9V7H7V9H9V7H11V11ZM11 13H13V17H15V19H13V21H11V19H9V17H11V13ZM9 17V15H7V17H9ZM15 17V15H17V17H15Z" fill="black"/>
</symbol>
</svg>

offlineimap

2026-03-05T09:32:30Z

OfflineIMAP

OfflineIMAP permet de synchroniser des boîtes courriel (distantes) avec une structure de répertoire de type Maildir (local).

La configuration doit se trouver dans le fichier ~/.offlineimaprc, et peut contenir plusieurs boîtes courriel. Chaque bloc de configuration commence par un terme à l'intérieur de crochets. Les paramètres généraux à toutes les comptes sont sous [general].

Ensuite, sont ajoutés les informations spécifique à chaque boîte qu'on veut synchroniser. D'abord, on déclare le compte, puis ensuite les informations locales et distantes.

[general]
ui = ttyui
accounts = hscc,lemorse,plutocrash
autorefresh = 5
pythonfile = ~/.offlineimap.py
#################
# HUGO@SOUCY.CC #
#################
[Account hscc]
localrepository = hscc-local
remoterepository = hscc-remote
[Repository hscc-local]
type = Maildir
localfolders = ~/.Mail/hscc
[Repository hscc-remote]
type = IMAP
remotehost = imap.mailserv.tld
remoteuser = hscc
realdelete = yes
sslcacertfile = /etc/ssl/cert.pem
maxconnections = 3
folderfilter = lambda folder: folder in [ 'INBOX.Sent', 'INBOX', 'INBOX.Drafts' ]
remotepasseval = get_pass_hscc()

La fonction get_pass_hscc() du paramètre remotepasseval permet de déchiffrer le mot de passe qui est protégé par une clé gpg. Cette fonction se trouve dans le fichier python qui est déclarer dans le bloc [general].

~/.offlineimap.py:

#! /usr/bin/env python
from subprocess import check_output
def get_pass_hscc():
return check_output("gpg -dq ~/.passwd_hscc.gpg", shell=True).rstrip(b"\n")

Pour lancer la synchro on exécuter simplement la commande offlineimap. Si on veut l'automatiser à une certaine fréquence, on crée une tâche de type cron avec crontab -e.

Par exemple, au cinq minutes:

*/5 * * * * /usr/local/bin/offlineimap

entr

2026-03-04T11:22:00Z

entr

entr permet d'exécuter des commandes lorsque des changements au système de fichiers sont détectés.

Personnellement, je l'utilise beaucoup pour concaténer et compresser à la volée les fichiers CSS ou JavaScript:

find . -type f -name "*.css" | entr -c -d ./css.sh

Ou tout reconstruire si un changement est détecté dans les fichiers d'un projet:

ag -l | entr make

gnupg

2026-03-03T10:54:47Z

gnupg

gpg est la partie OpenPGP de GNU Privacy Guard (GnuPG). Il s'agit d'un outil permettant de fournir des services de chiffrement et de signature numériques à l'aide de la norme OpenPGP.

Voir s'il y a déjà des clés existantes:

gpg --list-keys

Créer une nouvelle clé:

gpg --full-generate-key

Afficher votre clé public:

gpg --armor --export <key-id>

Si une adresse courriel est associé à votre clé, vous pouvez la sélectionner via cette valeur. Par exemple, au lieu de l'afficher dans le terminal (stdout), j'écris ma clé public dans une fichier:

gpg --armor --export hugo@soucy.cc > hs0ucy.pubkey

Héberger sa clé public sur un serveur comme keys.openpgp.org:

gpg --keyserver hkps://keys.openpgp.org --send-keys <key-id>

Ensuite vous recevrez une courriel de confirmation afin d'associer votre courriel à la clé que vous venez d'exporter.

Déchiffrer un fichier:

gpg --no-tty -q -r <key-id> -d ~/.passwd.gpg > mdp.txt

Chiffrer un fichier:

gpg -q -r <key-id> -e ~/test.txt

newsboat

2026-03-02T10:53:46Z

newsboat

Lecteur de fils RSS/Atom pour le termial.

Par défaut les adresses doivent êtres dans le fichier ~/.newsboat/urls:

http://feeds.bbci.co.uk/news/rss.xml                            "~BBC News"
http://www.aljazeera.com/xml/rss/all.xml                        "~Al Jazeera"
http://www.courrierinternational.com/feed/all/rss.xml           "~Courrier international"
http://www.independent.co.uk/rss                                "~The Independent"
http://www.lactualite.com/feed/                                 "~L'actualité"
http://www.spiegel.de/international/index.rss                   "~Der Spiegel"

On peut charger des fichiers alternatifs avec l'option --url-file. Ici, un exemple d'alias dans ~/.kshrc pour avoir différent types de fils:

# aliases
alias blogroll='newsboat -r --url-file="$HOME/.newsboat/blogroll"'
alias newsroll='newsboat -r --url-file="$HOME/.newsboat/newsroll"'
alias techroll='newsboat -r --url-file="$HOME/.newsboat/techroll"'

Exporter ses urls vers un fichier OMPL:

newsboat -u ~/.newsboat/newsroll --export-to-opml > newsroll.opml

msmtp

2026-03-02T10:38:54Z

msmtp

Un client pour le protocole SMTP.

Exemple de configuration ~/.msmtprc:

# Set default values for all following accounts.
defaults
auth           on
tls            on
tls_trust_file /etc/ssl/cert.pem
logfile        ~/.msmtp.log
# hscc
account        hscc
host           smtp.mailserv.tld
port           587
from           hugo@soucy.cc
user           hscc
passwordeval   gpg --no-tty -q -d ~/.passwd_hscc.gpg
# Set a default account
account default : hscc

Faire un test en ligne de commande:

echo "Bonjour le John!" | msmtp -a hscc john@doe.com

Si tout c'est bien passé, john@doe.com a reçu le message «Bonjour le John!» de la par de l'adresse associée au compte hscc.

Utilisation pour envoi de courriel via emacs:

;; Send function:
(setq send-mail-function 'message-send-mail-with-sendmail
sendmail-program "/usr/local/bin/msmtp"
mail-specify-envelope-from t
message-sendmail-envelope-from 'header
mail-envelope-from 'header
message-send-mail-function 'message-send-mail-with-sendmail
)

lowdown

2026-03-02T10:30:39Z

lowdown

Un convertisseur de markdown vers différent formats.

Convertir du markdown en gemtext:

lowdown content/about.md -tgemini

Convertir du markdown en HTML:

lowdown content/about.md -thtml

Voici un exemple plus complet où lowdown est combiné à d'autres applications POSIX shell (sort, head, grep, cat) pour créer un générateur de site minimaliste à partir de fichiers markdown:

#!/bin/sh
# md2w3.sh
#
# Conventions:
# - Les noms des fichiers markdown doivent êtres préfixés avec une date au format YYYY-MM-DD-nom-de-la-page.md
# - Dans ces fichiers le titre de premier niveau doit être sur la première ligne
# Créer feed.md et effacer son contenu à chaque exécution
touch feed.md & echo "" > feed.md
find . -type f -name "*.md" ! -name "index.md" ! -name "feed.md" | sort -r | while read -r mdfile; do
# Chemin du fichier sans l'extension .md
bname="$(basename "$mdfile" .md)"
# Extraire la date du nom du fichier
date="$(echo "$bname" | grep -Eo '[0-9]{4}-[0-9]{2}-[0-9]{2}')"
# Extraire le titre du fichier
title="$(cat < "$mdfile" | head -n 1 | grep -Eo '[^#{1}\s].+')"
# URL du fichier HTML
url="$bname.html"
# Entrée du site au format markdown
entry="* $date [$title]($url)"
# Créer la page HTML correspondante
lowdown -s "$mdfile" -o "$url" -thtml -M title="$title - monsiteweb.com"
echo "$entry" >> feed.md
done
# Créer l'index en y incluant feed.md
cat <<EOF | lowdown -s - -o "index.html" -thtml -M title="Mon site web - monsiteweb.com"
# Un site web
$(cat feed.md)
EOF

Le flag -s signifie standalone et permet de générer une page HTML complète (html>head+body);
le tiret seul -, indique que le markdown sera passé par stdin;
le paramètre -M permet l'ajout de métadonnées, tel que la balise title;
de la même façon, vous pourriez ajouter une feuille de styles: lowdown -s - -o "index.html" -thtml -M title="Mon site web - monsiteweb.com" -M css="styles.css".

Sinon, une autre manière de personnaliser le HTML généré, est de modifier les templates par défaut de lowdown. Il sagit de copier l'original et d'indiquer l'alternative avec le paramètre --template.

Les originaux se trouvent, selon de votre système d'exploitation, à quelque part comme ici: /usr/local/share/lowdown.

Vous copiez le template à modifier dans l'arborescence de votre projet:

cp /usr/local/share/lowdown/html/default.html ~/Applications/md2web/index.tpl.html

Après avoir procédé aux changements, vous l'utilisez comme ceci:

lowdown -s - -o "index.html" -thtml --template index.tpl.html

Pour plus de détails, visiter le site officiel de lowdown: https://kristaps.bsd.lv/lowdown/.

Sinon, j'ai aussi créé un dépôt git sur codeberg avec un script plus complet et parfaitement utilisable pour créer rapidement un blogue statique.

feh

2026-03-02T10:17:52Z

feh

Visionneuse d'images via le terminal.

Exemple pour le fichier ~/.xsession:

# random wallpapers on load
exec $(feh --randomize --bg-fill /home/hs0ucy/Images/oldcomp_*) &

Mon laptop

2026-03-01T13:27:25Z

Mon laptop

Voici les paquets que j'installe habituellement sur mon laptop OpenBSD:

aspell
cmus
emacs
entr
feh
ffmpeg
firefox-esr
gajim
gifsicle
gimp
git
gnupg
inkscape
iridium
ispell
keepassxc
lowdown
lua
luarocks
msmtp
mu
newsboat
offlineimap
php
pngquant
rsync
scour
scrot
shellcheck
spectrwm
speech-dispatcher
tcl
tcllib
tor-browser
the_silver_searcher
tuba
unzip
vlc
w3m
wapiti
whatweb
yt-dlp

Vdirsyncer

2025-03-06T12:54:08Z

Vdirsyncer pour synchroniser CalDAV et CardDAV sur votre ordinateur

Si comme moi, vous avez un serveur comme Baïkal pour gérer vos contacts et vos agendas, vous vous demandez peut-être comment les synchroniser sur votre ordinateur sans utiliser une application comme Thunderbird ou Évolution…

Eh bien, récemment, j'ai découvert Vdirsyncer. Une application en ligne de commande, qui sert justement à ça. C'est l'équivalent CardDAV / CalDAV de ce qu'est OfflineIMAP ou Isync pour les boîtes courriels.

Vdirsyncer se connecte à une source distante pour importer, puis synchroniser les données en local. Les événement de votre calendrier sont par exemple, importés au format standard iCalendar (.ics). Tandis que les contacts sont des fichiers vCard (.vcf). D'autres formats sont aussi disponibles.

Si vous avez un téléphone Android, vous connaissez peut-être DAVx5, qui fait à peu près la même chose.

Des paquets d'installation sont disponibles pour les principales distributions GNU/Linux, ainsi que pour Mac OS, NetBSD, etc. Sinon, installer directement avec les gestionnaires de paquets pour python pipx ou pip.

Pour moi, c'est sous OpenBSD avec pkg_add:

doas pkg_add -v vdirsyncer

Exemple de configuration

D'abord dans votre $HOME, il faut créer le répertoire et fichier de configuration de vdirsyncer:

mkdir .vdirsyncer/ && touch .vdirsyncer/config

Puis les répertoires qui acueilleront les fichiers iCalendar et vCard:

mkdir -p .calendars/nomducalendrier/
mkdir -p .contacts/nomducarnet/

Bloc CalDAV

[general]
status_path = "~/.vdirsyncer/status/"
# -------
# CALDDAV
# -------
[pair my_calendar]
a = "my_calendar_local"
b = "my_calendar_remote"
collections = ["from a", "from b"]
[storage my_calendar_local]
type = "filesystem"
path = "~/.calendars/"
fileext = ".ics"
[storage my_calendar_remote]
type = "caldav"
auth = "digest"
url = "https://monserveur.com/baikal/dav.php/calendars/mon_id/nom_du_calendrier/"
username = "mon_id"
password.fetch = ["command", "~/get-mdp-dav"]

Dans la section [general], il faut ajouter la propriétée status_path. Le dossier status contient des fichiers qui serviront aux métadonnées de synchronisation. Vous n'avez pas besoin de le créer, l'application s'en charge.

La section [pair ...] elle, décrit certaines relations ou comportement qui serviront à la découvrabilité et la synchronisation.

Ensuite les deux autres sections sont pour les paramètres des stockages local et distant.

Pour Baikal je devais renseigner la propriété optionnelle auth, dans votre cas cela ne sera peut-être pas nécessaire. À vérifier.

Et finalement, plutôt que mettre le mot de passe en claire dans le fichier de configuration, j'utilise password.fetch, pour exécuter un script shell qui va récupérer mon mot de passe stocker quelque part sur ma machine:

password.fetch = ["command", "~/get-mdp-dav"]

Une fois que votre configuration vous semble au point, il vous reste à la tester en lançant la commande discover, comme ceci:

vdirsyncer discover

Et si par bonheur vous n'avez aucune erreur, alors il est temps de synchroniser vos données:

vdirsyncer sync

Bloc CardDAV

Bon, pour les carnets d'adresses c'est sensiblement la même chose. Il vous suffit de mettre les bons identifiants et les bons chemins:

# -------
# CARDDAV
# -------
[pair my_contacts]
a = "my_contacts_local"
b = "my_contacts_remote"
collections = ["from a", "from b"]
metadata = ["hs"]
[storage my_contacts_local]
type = "filesystem"
path = "~/.contacts/"
fileext = ".vcf"
[storage my_contacts_remote]
type = "carddav"
auth = "digest"
url = "https://monserveur.com/baikal/dav.php/addressbooks/mon_id/moncarnet/"
username = "mon_id"
password.fetch = ["command", "~/get-mdp-dav"]

Comme tout à l'heure, vous devenez lancer un vdirsyncer discover et un vdirsyncer sync, lorsque votre configuration est au point.

Synchroniser à l'heure

À l'aide d'une cron job (crontab -e), vous pouvez lancer la synchronisation à la fréquence que vous le souhaitez. Pour moi, c'est à l'heure pile:

0 * * * * /usr/local/bin/vdirsyncer sync

Notez que le chemin vers la commande peut différer selon le système d'exploitation.

Ma configuration complète

[general]
status_path = "~/.vdirsyncer/status/"
# -------
# CALDDAV
# -------
[pair my_calendar]
a = "my_calendar_local"
b = "my_calendar_remote"
collections = ["from a", "from b"]
[storage my_calendar_local]
type = "filesystem"
path = "~/.calendars/"
fileext = ".ics"
[storage my_calendar_remote]
type = "caldav"
auth = "digest"
url = "https://monserveur.com/baikal/dav.php/calendars/mon_id/nom_du_calendrier/"
username = "mon_id"
password.fetch = ["command", "~/get-mdp-dav"]
# -------
# CARDDAV
# -------
[pair my_contacts]
a = "my_contacts_local"
b = "my_contacts_remote"
collections = ["from a", "from b"]
metadata = ["hs"]
[storage my_contacts_local]
type = "filesystem"
path = "~/.contacts/"
fileext = ".vcf"
[storage my_contacts_remote]
type = "carddav"
auth = "digest"
url = "https://monserveur.com/baikal/dav.php/addressbooks/mon_id/moncarnet/"
username = "mon_id"
password.fetch = ["command", "~/get-mdp-dav"]

L'utilisation

Une fois que tout se synchronise bien entre votre serveur et votre ordinateur personnel, il ne vous reste plus qu'à vous amusez. Remarquez, votre utilisation de vdirsyncer peut tout simplement se limiter au fait d'avoir des copies locales de sauvegardes de votre calendrier et de cotre carnet d'adresses. Sinon, toute application pouvant tirer profit des formats iCalendar ou vCard, peut en principe interagir avec votre nouvelle installation.

Mais histoire de rester dans le domaine de la ligne commande, je peux vous en proposer deux qui sont souvent associés au nom de vdirsyncer…

Khal

Khal peut lire et écrire des événements/calendriers dans les dossiers synchronisés par vdirsyncer. Il a aussi un mode interactif qui permet de parcourir et d'éditer à la fois.

Pour avoir la liste des commandes et options consulter le site web ou l'aide (khal --help).

Et la configuration de base est plutôt simple, et doit être placée dans $HOME/.config/khal/config:

[calendars]
[[hs_calendar_local]]
path = ~/.calendars/*
type = discover
[[hs_contacts_local]]
path = ~/.contacts/*
type = discover
[locale]
timeformat = %H:%M
dateformat = %Y-%m-%d
longdateformat = %Y-%m-%d
datetimeformat = %Y-%m-%d %H:%M
longdatetimeformat = %Y-%m-%d %H:%M
[default]
default_calendar = default

Khard

Bon vous l'aurez deviné, Khard est un gestionnaire de carnet d'adresses. À l'instar de Khard, il permet de lister et d'éditer. Sa configuration est dans la même veine que ce que nous avons vu jusqu'à maintenant:

[addressbooks]
[[default]]
path = ~/.contacts/default/
[general]
debug = no
default_action = list
editor = emacsclient, -r, -a, emacs,
merge_editor = vimdiff
[contact table]
display = first_name
group_by_addressbook = no
reverse = no
show_nicknames = no
show_uids = yes
show_kinds = no
sort = last_name
localize_dates = yes
preferred_phone_number_type = pref, cell, home
preferred_email_address_type = pref, work, home

Conclusion

Je ne suis pas encore un utilisateur de longue date, mais je suis enthousiaste par la découverte de vdirsyncer. Tout simplement parce que je cherchais ce genre d'outil depuis un certain temps. L'utilisation de formats simples et standardisés est un gros plus lorsqu'on veut interagir avec ses données sous plusieurs plateformes et applications.

Sinon je suis un utilisateur d'Emacs, entre autres pour lire et rédiger mes courriels (mu4e) et tenir des todo lists (org-mode). Et j'ai découvert deux extensions pour cet environnement, qui interfacent Khal et Khard… Ce qui fera peut-être l'objet d'une suite à ce billet.

Liste de CMS et de SSG

2025-02-14T11:13:11Z

Liste de CMS et de SSG

*Ceux que j'ai déjà essayés.

CMS sans BD (flat file)

HTMLy https://www.htmly.com/
Pico https://picocms.org/
Bludit* https://www.bludit.com/
Grav* https://getgrav.org/
Kirby* https://getkirby.com/
Lichen https://codeberg.org/stringbone/lichen
Portabloc https://portabloc.xyz/2023/10/whats-portabloc-cms
HamsterCMS http://old.net.eu.org/
Distributi https://vvvvvvaria.org/%7Edecentral1se/distribusi/
Blot https://blot.im/
PluXML* https://pluxml.org/

SSG

A List of Static Site Generators https://jamstack.org/generators/
Make a static site with find(1), grep(1), and lowdown or Markdown.pl https://romanzolotarev.com/ssg.html
shellCMS https://bkhome.org/shellcms/
Satelito* https://codeberg.org/hs0ucy/Satelito

Mémento Unix

2024-02-17T17:55:29Z

Mémento Unix

Voici un petit aide-mémoire pour les nouveaux arrivants sur Unix, ainsi que pour les autres, comme moi, qui parfois oublient.

Sur cette page

Raccourcis clavier
Commandes pour fichier et répertoire
Information système
Gestion des processus
Gestion des permissions
SSH
Compression
Réseau

Raccourcis clavier

Ctrl+c: Arrêter la commande en cours.
Ctrl+z: Suspendre la commande en cours; pour la reprendre utiliser fg au premier plan ou bg à l'arrière-plan.
Ctrl+d: Se déconnecter de la session en cours, similaire à exit (quitter).
Ctrl+r: Rechercher dans les commandes tapées précédemment.; La recherche est faite à l'intérieur de l'historique de votre shell, qui se trouve dans un fichier comme .bash_history ou .ksh_history.

Commandes pour fichier et répertoire

ls: Lister les fichiers et les répertoire.
ls -al: Liste en vue détaillée incluant les fichiers cachés.
cd undossier/: Naviguer dans l'arborescence des répertoires.
cd: Aller à notre répertoire utilisateur.
pwd: Montrer le chemin du répertoire courant.
mkdir musique: Créer le répertoire musique.
mkdir -p {musique,peinture,literature}: Créer une série de répertoires d'une seule commande.
rm todo.txt: Supprimer todo.txt.
rm -r musique: Supprimer le répertoire musique.
rm -f important.txt: Forcer la suppression du fichier important.txt.
rm -rf jeux/: Forcer la suppression du répertoire jeux/.
cp fichierA fichierB: Faire une copie du ficherA qui s'appelle fichierB.
cp -r dossierA/ dossierB/: Copier le dossierA/ dans dossierB/; si ce dernier n'existe pas il est alors créé.
mv abc.txt xyz.txt: Renommer ou déplacer abc.txt vers xyz.txt, si xyz.txt existe comme répertoire, abc.txt sera déplacé dans xyz.txt.
ln -s abc.txt lien-abc.txt: Crée un lien symbolique nommé lien-abc.txt vers le fichier abc.txt.
touch index.html: Créer ou mettre à jour index.html.
cat > new.txt: Écrire le contenu de stdin (entrée standard) dans new.txt en écrasant ce qui s'y trouve déjà.
cat a.txt b.txt c.txt > abc.txt: Concaténer a.txt b.txt c.txt dans abc.txt.
cat >> list.txt: Écrire le contenu de stdin (entrée standard) en l'ajoutant à la fin de list.txt.
cat list.txt >> todos.txt: Ajouter list.txt à la fin de todos.txt.
more index.html: Afficher le contenu du fichier index.html.
head data.csv: Afficher les 10 premières lignes de data.csv.
tail /var/log/authlog: Afficher les 10 dernières lignes de /var/log/authlog.
tail -f /var/log/authlog: Afficher en temps réel les 10 dernières lignes de /var/log/authlog.
find .: Trouver tous les fichiers récursivement à partir d'où on se trouve.
find /abc/xyz/ -maxdepth 1: Trouver tous les fichiers du répertoire /abc/xyz/ qui sont du premier niveau.
find /var/www/public_html/ -type d -empty -delete: Trouver et supprimer tous les dossiers vides dans /var/www/public_html/.
find content/ -name \*.html -type f: Trouver tous les fichiers se terminant par .html dans content/.
find content/ -mindepth 2 -name index.md -exec dirname {} \;: Trouver tous les fichiers index.md à partir du deuxième niveau de répertoire, et sur chacun d'eux, exécuter la commande dirname.
tr ',' '\t' < unix-data-science.csv > unix-data-science.tsv: Remplacer les virgules par des tabulations.
wc -l unix-data-science.tsv: Compter le nombre de ligne dans le fichier unix-data-science.tsv.

Information système

date: Affiche la date et l'heure.
date +"%Y-%m-%d %T": Afficher une version formatée de la date et de l'heure.
cal: Montre le calendrier du mois courant.
cal july: Montre le calendrier de juillet de l'année courante.
cal 1976: Montre tout le calendrier de 1976.
uptime: Affiche la durée de fonctionnement du système.
who: Affiche les utilisateurs connectés.
w: Affiche les utilisateurs connectés et ce qu'ils font.
whoami: L'utilisateur sous lequel on est connecté.
finger joe: Affiche de l'info à propos de l'utilisateur joe.
uname -a: Voir les informantion sur le système.
man nomduprogramme: Affiche le manuel d'utilisation d'un programme.; S'il n'y a pas d'entrée essayer nomduprogramme -h ou nomduprogramme --help.
df -h: Voir les niveaux d'utilisation des partitions/disques.
du -h: Afficher les statistiques d'utilisation du disque.
whereis app: Localiser une application.
which app: Localiser un (ou plusieurs) fichier(s) programme(s) dans le chemin d'accès.

Gestion des processus

ps: Afficher les processus courants en activité.
top: Afficher tous les processus en cours.
kill pid: Tuer un processus selon son pid (process ID).
pkill nomduprocessus: Tuer un processus selon son nom.
bg: Lister les tâches arrêtées ou en arrière-plan.
fg: Ramène la tâche la plus récente à l'avant-plan.
fg %n: Ramène la tâche %n à l'avant-plan.
Ctrl+z: Arrête la commande en cours et la reprendre avec fg.

Gestion des permissions

chmod octal file

Changer les permissions sur les fichiers en octal et les appliquées différemment selon l'utilisateur, le groupe ou pour tous:

4 - read (r) (lire)
2 - write (w) (écrire)
1 - execute (x) (exécuter)

Examples:

chmod 777: Lire, écrire, exécuter pour tous (4+2+1=7).
chmod 755: Lire, écrire, exécuter pour le propriétaire du fichier (4+2+1=7); lire et exécuter pour le groupe et les autres (4+1=5).

Pour davantage d'options, voir man chmod.

SSH

ssh joe@jdoe.tld: Connexion à jdoe.tld avec l'utilisateur joe.
ssh -p 222 joe@jdoe.tld: Se connecter à l'hôte par le port 222.

Fichier de configuration SSH

Quand les connexions SSH sont récurrentes, on peut enregistrer leurs paramètres dans le fichier ~/.ssh/config.

En voici un exemple:


Host johndoe_com
HostName 192.168.0.100
User johnd
Port 4242
PasswordAuthentication no
IdentityFile ~/.ssh/id_rsa
TCPKeepAlive no
ServerAliveInterval 60
ServerAliveCountMax 10
ControlPersist 4h
ControlMaster auto
VerifyHostKeyDNS yes
AddKeysToAgent yes

Et puis pour se connecter on lance SSH avec l'host de la configuration: ssh johndoe_com.

Avec rsync


#!/usr/bin/env sh
# Deploy http://johndoe.cc/
rsync -arvuz -O public_html/ johndoe_com:/var/www/htdocs/johndoe.cc

Compression

tar cf fichiers.tar fichierA.txt fichierB.txt: Créer un tar nommé fichiers.tar, contenant fichierA.txt fichierB.txt.
tar xf file.tar: Extraire les fichiers de fichiers.tar.
tar czf fichiers.tar.gz fichierA.txt fichierB.txt: Créer un tar avec un compression Gzip.
tar xzf fichiers.tar.gz: Extraire un tar utilisant Gzip.

Réseau

ping hostname: ping l'hôte et retourne les informantions relatives à ce dernier.
whois lemor.se: Retourne les infos whois à propos d'un nom de domaine.
dig lemor.se: Retourne les infos DNS à propos d'un nom de domaine.

xdg-utils

...: ...

xterm

2024-02-17T13:38:17Z

xterm

~/.Xresources

[...]
! Dracula Xresources palette
*.foreground: #F8F8F2
*.background: #282A36
*.color0:     #000000
*.color8:     #4D4D4D
*.color1:     #FF5555
*.color9:     #FF6E67
*.color2:     #50FA7B
*.color10:    #5AF78E
*.color3:     #F1FA8C
*.color11:    #F4F99D
*.color4:     #BD93F9
*.color12:    #CAA9FA
*.color5:     #FF79C6
*.color13:    #FF92D0
*.color6:     #8BE9FD
*.color14:    #9AEDFE
*.color7:     #BFBFBF
*.color15:    #E6E6E6
[...]
!!! Xterm
XTerm*eightBitInput: false
XTerm*loginShell: true
XTerm*scrollBar: false
XTerm*saveLines: 2000
XTerm*faceName: xft:Terminus:pixelsize=14
XTerm*internalBorder: 10
XTerm*locale: true
XTerm*pointerMode: 2
XTerm*allowTitleOps: true
XTerm*termName: xterm-256color
XTerm*selectToClipboard: true
xterm*VT100.Translations: #override \
Ctrl Shift <Key>V:    insert-selection(CLIPBOARD) \n\
Ctrl Shift <Key>C:    copy-selection(CLIPBOARD)

Accessibilité web

2023-03-24T14:10:23Z

Accessibilité web

Intro

L'accessibilité signifie que le contenu web tend à être universellement perceptible, utilisable, compréhensible, et ce, peu importe nos limitations physiologiques, cognitives ou même technologiques.

Suivre le fil

Adrian Roselli [RSS]
Bruce Lawson [RSS]
Digital A11Y [RSS]
Laboratoire de promotion de l'accessibilité [RSS]
Laura Kalbag [RSS]
Léonie Watson [RSS]
Sara Soueidan [RSS]
Steve Faulkner [RSS]
TetraLogical [RSS]
The A11Y project [RSS]
WebAIM [RSS]

Suivre le guide

Suivre le rythme

Suivre la voix

Outils

Mémento expressions régulières

2023-03-19T13:54:58Z

Mémento expressions régulières

Sous Unix, grep, sed, et awk utilisent les expressions régulières. Tout comme d'ailleurs, la très grande majorité des langages de programmation ou des éditeurs texte.

Sur cette page

Le point: .
Crochets: [xyz]
Crochets avec exclusion: [^xyz]
Crochets avec plage: [a-z]
Astérisque: *
Symbole d'addition: +
Point d'interrogation: ?
Accolades: {}
Parenthèses: ()
Parenthèses sans capture: (?: )
Parenthèses avec pipe: (abc|xyz)
Caractère d'échappement: \
Extraire une date de type AAAA-MM-JJ
Extraire un titre de type markdown ou gemtext
Extraire le domaine d'une adresse courriel

Motifs de base

Le point: `.`

Il permet de sélectionner n'importe quel caractère: lettres, chiffres, ponctuations, les espaces... tout.

/ . /g

ABCD 1234 !@#$

Crochets: `[xyz]`

Si on cherche une chaîne de caractères avec des lettres qui divergent, on utilise les crochets.

/ foi[sex] /g

fois, foie, foil, foix

Crochets avec exclusion: `[^xyz]`

Inversement, si je voulais plutôt exclure les mots commençant par foi mais ce terminant pas s, e ou x, j'utliserais l'accent circonflexe comme premier caractère suivant le crochet de gauche.

/ foi[^sex] /g

fois, foie, foil, foix

Crochets avec plage: `[a-z]`

Pour capturer une séquence de caractères dans une chaîne on utilise le trait d'union (range expression).

Cette expression tient compte de la casse.

/ [m-q] /g

abcdefghijklmnopqrstuvwxyz

C'est idem avec les chiffres...

/ [5-7] /g

01234567899876543210

Astérisque: `*`

Le caractère précédent l'astérisque peut être absent ou présent de multiple fois.

/ cré* /g

crevées créées

Symbole d'addition: `+`

Dans ce cas-ci, nous voulons indiquer que le caractère précédent le + est présent une fois ou possiblement plus.

/ cré+ /g

crevées créées

Point d'interrogation: `?`

Un caractère est rendu facultatif s'il est suivi par un point d'interrogation.

/ Cou?lombe /g

Coulombe ou Colombe

Accolades: `{}`

Préciser par n le nombre de fois qu'un caractère peut être répété.

/ Bo{3}uh /g

Booouh Booooouh!

On peut aussi définir un nombre minimal de répétition en ajoutant une virgule à la suite de n.

/ Bo{3,}uh /g

Booouh Booooouh!

Pour déterminer une fourchette, il suffit d'ajouter, suivant la virgule, une valeur qui correspond à la limite recherchée.

/ Bo{1,3}uh /g

Bouh Boouh Booouh Booooouh!

Parenthèses: `()`

Les parenthèses sont utilisées pour grouper des expressions.

/ (blabla) /g

Bla, bla, blabla, blabla...

Un groupe peut être référencé par une barre oblique inversé suivie d'un chiffre: \n.

/ (bla) \1, (blabla), \2 /g

Ici deux groupes se retrouvent référencés...

bla bla, blabla, blabla

Parenthèses sans capture: `(?: )`

Ignorer un groupe parmis d'autres.

/ (?:bla) (blabla) \1 /g

bla bla blabla blabla

Parenthèses avec pipe: `(abc|xyz)`

Choisir par alternance parmi plusieurs expressions.

/ (châ|ra|gâ)teau|camion /g

Au château il glace le gâteau à l'aide d'un rateau... Et au loin, un camion.

Caractère d'échappement: `\`

Pour inclure des caractères qui sont d'abord réservés à la conception aux expressions régulières il faut les précéder du caractère d'échappement.

/ (\*|\.) /g

Sélectionner un astérisque* et trois points...

Quelques exemples pouvant être utiles

Extraire une date de type AAAA-MM-JJ

Ici nous avons trois fichiers classés du plus récent au moins récent et nous voulons extraire les dates qui se trouvent au début des noms...

/ ([0-9]{4})(-)([0-9]{2})(-)([0-9]{2}) /g

2024-03-12-nam-euismod-tellus-id-erat.md
2024-02-21-sed-id-ligula-quis-est-convallis-tempor.md
2024-01-05-Mauris-ac-felis-vel-velit-tristique-imperdiet.md

Extraire un titre de type markdown ou gemtext

Récupérer les titres sans les caractères # et l'espace précédant le premier mot.

/ [^#{1,6}\s].+ /g

# Nullam eu ante vel est convallis dignissim
## Aliquam erat volutpat
### Cras placerat accumsan nulla

Extraire le domaine d'une adresse courriel

/ (?<=@)(.*)$ /g

Vous pouvez me joindre à l'adresse suivante: hs0ucy@soucy.cc.

awk

2023-03-17T09:41:48Z

Survoler awk

awk est un langage de programmation pour manipuler du texte. Il est souvent employer pour extraire et formater des données. Il est presque toujours présent par défaut sur les systèmes d'exploitation de type Unix.

Les bases

Nos commandes peuvent être directement dans le terminal ou sinon dans un fichier avec l'extension .awk:

awk 'mes_instructions_awk' données-a.csv données-b.csv
awk -f instructions.awk données-c.csv données-d.csv

Règle et action

Un programme awk consiste en un ensemble de pair de règles et d'actions. Il peut y avoir autant de ces pairs que nous en avons besoin.

Chaque pair sera éxécutée indépendamment des autres, et si une ligne correspond à plus d'une règle, elle aura plus d'une action correspondante.

une règle { une action }
une autre règle { une autre action }
3e règle { 3e action }
... Etc.

Le point virgule est utilisé pour séparer des commandes qui seraient sur une même ligne:

une règle { une action }; une autre règle { une autre action }

Il existe des règles spécifiques comme BEGIN et END pour des actions à faire au début et à la fin du traitement.

BEGIN { ... }
END { ... }

Avec données

Pour les besoins de notre exploration, je suis aller piger dans les données ouvertes de la Société de transport de Lévis (STL). Nous allons utiliser les donneées sur les trajets que j'ai reproduis dans ce fichier: awk-data-sample.txt.

awk possède des variables prédéfinies et NR est une de celles-là. Elle nous retourne le nombre de lignes lues jusqu'à présent. e Nous pouvons nous en servir pour regarder les dix premières lignes de notre fichier de données:

awk 'NR <= 10' awk-data-sample.txt

Quand les commandes ne spécifient pas d'action, print est choisie implicitement; ce qui nous retourne ceci:

route_id,service_id,trip_id,trip_headsign,trip_short_name,direction_id,block_id,shape_id,wheelchair_accessible
11A,2,344166,Terminus de la Traverse / Hôtel-Dieu de Lévis / UQAR / Lauzon,,1,44,48170_1170677_1170774,1
11A,2,344167,Terminus de la Traverse / Hôtel-Dieu de Lévis / UQAR / Lauzon,,1,44,48170_1170677_1170774,1
11A,2,344168,Terminus de la Traverse / Hôtel-Dieu de Lévis / UQAR / Lauzon,,1,44,48170_1170677_1170774,1
11A,2,344169,Terminus de la Traverse / Hôtel-Dieu de Lévis / UQAR / Lauzon,,1,44,48170_1170677_1170774,1
11A,2,344170,Terminus de la Traverse / Hôtel-Dieu de Lévis / UQAR / Lauzon,,1,44,48170_1170677_1170774,1
11A,2,344171,Terminus de la Traverse / Hôtel-Dieu de Lévis / UQAR / Lauzon,,1,44,48170_1170677_1170774,1
11A,2,344172,Terminus de la Traverse / Hôtel-Dieu de Lévis / UQAR / Lauzon,,1,44,48170_1170677_1170774,1
11A,2,344173,Terminus de la Traverse / Hôtel-Dieu de Lévis / UQAR / Lauzon,,1,44,48170_1170677_1170774,1
11A,2,344174,Terminus de la Traverse / Hôtel-Dieu de Lévis / UQAR / Lauzon,,1,44,48170_1170677_1170774,1

Ici nous voyons les en-têtes sur la première ligne, puis ensuite les entrées elles-mêmes, sur les ligne suivantes. Et nous constatons que les données sont séparées par des virgules.

Pour avoir accès aux données seulement il nous faut ignorer la première ligne qui contient les en-têtes:

awk 'NR > 1' awk-data-sample.txt

Le séparateur

Par défaut, awk considère l'espace comme séparateur. Nous pouvons en paramètrer un autre avec l'étiquette -F:

awk -F ',' 'NR <= 10 { print $1 }' awk-data-sample.txt

La commande ci-dessus, permet d'utiliser la virgule comme séparateur et nous affiche le premier champ des dix premières lignes…

route_id
11A
11A
11A
11A
11A
11A
11A
11A
11A

Sources / Ressources

CSS et Unix

2022-03-24T15:10:22Z

CSS et Unix

Regrouper plusieurs feuilles de styles ensemble sous Unix

À des fins de performance, cela peut-être une bonne idée de regrouper nos feuilles de styles pour réduire le nombre de requêtes HTTP.

Si avec HTTP 1.1, c'était bien vue de ne servir qu'un seul fichier CSS. Avec HTTP 2, il est conseillé de découper ses feuilles en plusieurs ballots hiérarchisés, plutôt qu'en un seul gros bloc de code.

À ce sujet, voir le banc d'essai de Harry Roberts: CSS and Network Performance.

Règle `@import`

La règle CSS @import, n'est pas conseillé en production pour justement une question de performance.

Alors quelle autre option nous reste-t-il si on veut découper nos styles sans passer par un préprocesseur?

Utilitaire `cat`

Pour concaténer des fichiers ensemble sous Unix il faut utiliser l'utilitaire cat.

cat - concatenate and print files

Avec peu de fichiers CSS, on peut simplement faire:

cat a.css b.css c.css d.css e.css f.css > styles.css

En voulant être plus concis cela serait:

cat *.css > styles.css

Mais en CSS l'ordre des déclarations est important. Nous ne voudrions pas neutraliser ou déclasser certains styles.

Dans les utilitaires du shell il y a un flux entrant (standard input ou stdin) et un flux sortant (standard output ou stdout). La lecture se fait par le stdin et l'écriture par le stdout. Il y a aussi un flux sortant pour les erreurs (standard error ou stderr).

Il est toutefois possible détourner ces flux. Comme par exemple avec < ou > en appliquant des redirections vers un fichier, comme dans mon exemple ci-haut, avec l'utilitaire cat, où l'on redirige la sortie vers le fichier styles.css. Sans cette redirection le résultat s'afficherait dans le terminal avec stdout.

La redirection d'entrée utilise le symbole <. Cela permet d'indiquer qu'un fichier sera passé en stdin.

Concaténer une liste de CSS avec `while`, `read` et `<`

Maintenant nous allons utilser une boucle de type while, combiné avec l'utilitaire read, pour concaténer un groupe de fichiers CSS.

Notre liste se trouve dans un fichier nommé global-styles.txt. Nous y avons inscrit une feuille de style par ligne:

global/tokens/typography.css
global/tokens/colors.css
global/tokens/grid.css
global/base.css
global/a11y.css

Ensuite, notre script sera dans un autre fichier que nous appellerons css.sh:

#!/bin/sh
while read -r line; do
[ -n "$line" ] && cat "./$line"
done < global-styles.txt

Attention, il est important de s'assurer que ce fichier soit exécutable (chmod u+x css.sh), avant de lancer la commande:

./css.sh

Si tout s'est bien passé, on constate que le contenu de toutes les feuilles que nous avons listées s'affichent dans le terminal.

Dans ce script, la valeur de chaque ligne est assignée à la variable line. Puis [ -n "$line" ], teste si la chaîne de caractère retournée par $line n'est pas null avant de d'exécuter cat. Et finalement, notre liste est dirigée dans la boucle avec <.

L'étape suivante serait de rediriger stdout vers un fichier CSS avec >:

#!/bin/sh
while read -r line; do
[ -n "$line" ] && cat "./$line"
done < global-styles.txt > global.css

On pourrait aussi ne pas vouloir de fichier .txt et lister directement dans le script les fichier à concaténer:

#!/bin/sh
while read -r line; do
[ -n "$line" ] && cat "./$line"
done <<EOF
global/tokens/typography.css
global/tokens/colors.css
global/tokens/grid.css
global/base.css
global/a11y.css
EOF

Ici EOF est une commande qui permet de faire une entrée multiligne. Donc toutes les lignes qui se trouve entre <<EOF et EOF est passé à stdin.

Minifier une feuille de style avec `tr` pour réduire son poid

L'utilitaire tr sert à traduire ou éliminer des caractères. Il va permettre de retirer les sauts de ligne et les retours dans notre CSS, pour ramener toutes les règles sur une seule ligne. Le poid du fichier sera donc un peu moindre:

cat global.css | tr -d '\n\r' > "$global.min.css"

Le caractère |, que l'on appelle pipe, sert à lier deux processus en prenant le flux de sortie du premier, pour en faire le flux d'entrée du second.

Nous pourrions aussi retirer les tabs avec tr -d '\t', et les espaces multiples avec tr -s ' ' ' '. Cependant je ne conseillerais pas de supprimer les espaces simples avec tr, et ce, parce que des fonctions CSS comme calc(), nécessitent des espaces entre certains opérateurs.

Pour ma part, j'ai développé en lua, mon propre petit utilitaire pour contourner ce genre particularités. Ceci dit, dépendamment de la taille total de votre fichier CSS, les gains sont assez négligeables.

Voyons maintenant à quoi ressemble notre minification avec ces deux commandes tr supplémentaires…

cat global.css | tr -d '\n\r' | tr -d '\t' | tr -s ' ' ' ' > "$global.min.css"

Retirer les commemtaires avec `sed`

Malgré que, ce ne soit pas la façon la plus optimale de minifier, cela permet de faire des gains de plusieurs kilo-octets.

Mais les blocs de commentaires demeurent, et sed pourrait sans doute les retirer pour nous:

cat global.css | tr -d '\n\r' | tr -d '\t' | tr -s ' ' ' ' | sed -r ':a; s%(.*)/\*.*\*/%\1%; ta; /\/\*/ !b; N; ba'

Conclusion

Rendu ici, nous pouvons rassembler la concaténation et minification:

#!/bin/sh
while read -r line; do
[ -n "$line" ] && cat "./$line"
done <<EOF | tr -d '\n\r' | tr -d '\t' | tr -s ' ' ' ' | sed -r ':a; s%(.*)/\*.*\*/%\1%; ta; /\/\*/ !b; N; ba' > "global.min.css"
global/tokens/typography.css
global/tokens/colors.css
global/tokens/grid.css
global/base.css
global/a11y.css
EOF

Pas si mal hein? Sans rien installer d'externe sur notre poste de travail, nous sommes en mesure de concaténer et réduire la taille des fichiers CSS, avec à peine, quelques lignes de POSIX shell.

Et, contrairement à de la configuration de modules NodeJS, ce que nous apprenons ici, peut nous servir dans d'autres contextes qui, n'ont rien à voir avec le développement web.

Le fichier css.sh que j'utilise ici.

Post-scriptum

entr, est un utilitaire qui permet d'exécuter des commandes quand des fichiers sont modifiés.

Ce qui en fait l'outil parfait pour mettre à jour automatiquement les changements portés à nos feuilles de styles:

find . | entr -d ./css.sh

Le climat et le Web: Réduire de 80% le poids des pages

2021-11-29T21:03:34Z

Le climat et le Web: Réduire de 80% le poids des pages

L'accord de Paris (COP21) a eu lieu en 2015. Cette année-là, le poids moyen d'une page web tournait autour de 2,3 Mo. Aujourd'hui ça ressemble davantage à 6,0 Mo.

Même si ces mesures ne sont pas complètement représentatives, elles illustrent tout de même une tendance que nous observons empiriquement tous les jours: énormément de sites web souffrent de surpoids.

Pour contenir le réchauffement à 1.5°C par rapport aux températures de l'époque pré-industrielle, le GIEC nous dit, qu'idéalement, il faut réduire nos émissions d'environ de 80%.

Alors comment l'industrie du web peut faire sa part? Tout simplement en se donnant une mesure étalon à ne pas dépasser. Un budget par page en kilo-octet (Ko).

Pour des raisons évidentes, nous ne pouvons pas nous servir d'une mesure pré-industrielle. Je suggère donc de prendre celle de 2015 que j'invoquais au début, et d'en retirer le 80% proposé par le GIEC (2300 Ko – 80%) … Cela nous donne un poids type de 460 Ko par page.

Évidemment, en bas de cela, ça serait encore mieux, ou aller jusqu'à 512 Ko, aurait tout de même tout un impact et ferait une vraie différence.

Nous pourrions ne pas nous donner de limite et héberger nos sites chez des hébergeurs dont l'électricité est produite avec des énergies renouvelables. Mais, cette croissance infinie demande toujours plus de ressources au niveau du matériel et nous conduit à l'obsolescence programmée.

Et selon les statistiques, le principal impact négatif d'un objet sur l'environnement, vient des processus d'extraction et de production.

Conclusion

Je ne me fais pas d'illusion sur le niveau d'engagement de l'industrie du numérique pour contrer les bouleversements écologiques. C'est un milieu où l'on glorifie la complexité et le solutionnisme technologique avant l'éthique.

Toutefois, je crois qu'un certain leadership de la part des concepteurs et des clients pourraient faire tourner le vent dans la bonne direction.

Sources:

Minification CSS avec Lua

2021-11-26T09:21:21Z

Minification CSS avec Lua

La semaine passée, je me suis lancé dans la confection d'un petit script lua pour minifier le CSS, que j'ai simplement nommé cssmin.

Il n'y pas de dépendance. Tout ce que vous avez besoin c'est de lua (>= 5.1).

cssmin consiste donc à:

supprimer les saut de lignes;
retirer les espaces autour des caratères suivants: :, ;, ,, *, >, {, }, ~;
et finalement effacer les commentaires.

Je n'ai cependant pas retiré les espaces autour des caractères + et -, puisque que dans la fonction calc(), il doit y avoir ces espaces entre les valeurs et les opérateurs d'addition et de soustraction, sinon les calculs ne fonctionnent pas.

Éventuellement, je préciserai ma condition pour viser tout ce qui se trouve en-dehors de cette fonction.

Vous pouvez consulter le code ici: https://codeberg.org/hs0ucy/cssmin.

Comment l'utiliser?

D'abord récupérer cssmin avec git:

git clone https://codeberg.org/hs0ucy/cssmin.git

Il faut ensuite passer un fichier CSS en argument. Le résultat s'affichera dans le terminal (stdout):

./cssmin ../monprojetweb/css/styles.css

Pour rediriger le contenu dans un fichier:

./cssmin ../monprojetweb/css/styles.css > ../monprojetweb/css/styles.min.css

Si vous êtes sous GNU/Linux ou BSD, vous pouvez déposer cssmin dans $HOME/.local/bin/, afin de rendre la commande globale dans votre environnment.

Automatiser la minification

Pour automatiser l'exécution de cssmin, il suffit d'utiliser entr:

echo styles.css | entr -s 'cssmin styles.css > styles.min.css'

Donc si styles.css est modifié, la commande qui suit entr -s sera exécutée.

Et pour le JavaScript?

Il y a JSMin par Douglas Crockford, le père du format JSON. C'est une application autonome écrite en C.

C'est d'ailleurs JSMin qui m'a donné l'envie d'écrire cssmin.

Mémento Emacs

2021-05-06T19:12:02Z

Mémento Emacs

Sur cette page

Obtenir de l'aide dans Emacs
Annuler ou répéter
Déplacement
Buffers
Effacer
Sélectionner
Couper/Copier/Coller
Chercher/Remplacer
Changements de casse
Permutations
Shell
Complétion
HTML (Mode SGML)
Gestion fichier/dossier (dired)
Rectangles
Macros

Raccourcis clavier

Dans le monde de Emacs la touche commande est représenté par C-, ce qui sur votre clavier, correspond par défaut à Ctrl. Sinon M- représente la touche méta, qui est habituellement associer à Alt.

Donc C-k est semblable à Ctrl+k. Mais si il y a des combinaisons qui ne vous plaisent pas vous pouvez les modifier, car [presque] tout est personnalisable (voir Emacs 101 – la configuration).

Obtenir de l'aide dans Emacs

Tutorial Emacs: F1, t.
Documentation: F1, r.
Description d'une commande: F1, k ou C-h, k.
Description d'une fonction: F1, f ou C-h, f.
Apropos, chercher de l'info par regEx: F1, a ou C-h, a.

Annuler ou répéter

Annule commande en cours: C-g.
Annuler la dernière commande (undo): C-x, u ou C-/.
Répéter une commande: C-x, z (Ensuite seulement z pour répéter à nouveau.).

Pour ma part, j'ai installé le paquet undo-tree. Puis j'ai assigné C-z à la commande (undo-tree-undo &optional ARG), et C-S-z à la commande (undo-tree-redo &optional ARG).

Déplacement

Déplacement à travers les mots & les paragraphes: C-[flèches].
Ligne suivante: C-n.
Ligne précédente: C-p.
Début d'une ligne: C-a.
Début d'une ligne indentée: M-m.
Fin d'une ligne: C-e.
Mot suivant: M-f.
Mot précédent: M-b.
Phrase précédente: M-a.
Phrase suivante: M-e.
Écran précédent: M-v.
Écran suivant: C-v.
Début du buffer: M-<.
Fin du buffer: M->.

Buffers

Quitter emacs: C-x, C-c.
Ouvrir ou créer un fichier: C-x, C-f.
Sauvegarder le buffer courant: C-x, C-s.
Sauvegarder tous les buffers ouverts: C-x, s.
Enregistrer-sous: C-x, C-w.
Voir la liste des buffers: C-x, C-b.
Aller à la ligne X: M-g, g.
Fermer un buffer: C-x, k.
Insérer le contenu d'un autre fichier dans un buffer: C-x, i.

Effacer

Efface le mot suivant: M-d.
Efface le mot précédant: M-Backspace.

Sélectionner

Indiquer le début (point) d'une sélection (mark): C-Spacebar.
Sélectionner tout le paragraphe: M-h.
Sélectionner tout le buffer: C-x, h.
Sélectionner une fonction: C-M-h.
Modifier une sélection: C-x, C-x.

On peut faire des actions spécifiques à une région qui est marquée. Ex.: Des undo, des trouver/remplacer, des recherches, etc.

Couper/Copier/Coller

Couper: C-w.
Copier: M-w.
Coller: C-y.
Couper une ligne: C-k.
Couper une phrase (vers l'avant): M-k.
Couper une phrase (vers l'arrière): C-x, <DEL>.

Chercher/Remplacer

Recherche vers la fin du fichier: C-s (répéter la commande pour l'occurrence suivante).
Recherche vers le début du fichier: C-r (répéter la commande pour l'occurrence précédente).
Remplacer: M-%.
y pour remplacer la correspondance en cours;.
n pour aller à la prohcaine correspondance sans remplacer;.
q pour sortir du processus de remplacement courant;.
. pour remplacer la correspondance en cours puis quitter le processus;.
! pour tout remplacer sans aucune autre question.
Chercher dans les fichiers: M-x rgrep.

Changements de casse

Premier caractère en majuscule: M-c.
Mot en majuscule: M-u.
Mot en minuscule: M-l.

Permutations

Intervertir deux lettres: C-t.
Intervertir deux mots: M-t.
Intervertir deux lignes: C-x, C-t.
Déplacer un caractère vers l'avant (transpose): C-t.
Remplacer un caractère par un saut de ligne: M-x replace-string RET remplacermoi RET C-q C-j.
C-q est pour quoted-insert, C-j est pour une saut de ligne.

Shell

Lancer un commande du shell: M-!.
Démarrer un terminal shell: M-x shell.
Démarrer un eshell: M-x eshell.
Lancer plus d'un eshell: C-u M-x shell.
Sortir d'un shell: exit Enter.

Complétion

Autocomplétion d'un mot se trouvant déjà dans le buffer: M-/.

HTML (Mode SGML)

Effacer une balise en laissant intacte le contenu: C-c, Backspace.
Créer une balise: C-c, C-o.
Compléter une balise: C-c, C-e.
Aller à la fin d'un balise: C-c, C-f.
Aller au début d'un balise: C-c, C-b.

Gestion fichier/dossier (dired)

Ouvrir un dossier C-x, d.
Monter d'un niveau ^.
Copier C.
Renommer R.
Effacer D.
Créer un nouveau dossier , .
Rafraichir un dossier g.
Archiver/Désarchiver avec Gzip Z.

Pour en savoir plus sur Dired.

Rectangles

Remplacer/ajouter du texte sur plusieurs lignes: C-x, r, t.
Insérer des espaces sur plusieurs lignes: C-x, r, o.

Pour en savoir plus sur les Rectangles.

Macros

Démarrer l'enregistrement d'un macro: C-x, (.
Stopper l'enregistrement d'un macro: C-x, ).
Exécuter le dernier macro enregistré: C-x, e.
Assigner un nom de commande à un macro: C-x, C-k, n.
Assigner un raccourci clavier à un macro: C-x, C-k, b.

En savoir plus sur les Macros.

Le Web, l'inclusion et la performance

2021-03-21T13:59:17Z

Le Web l'inclusion et la performance

Dans son billet Permacomputing, Viznut fait un parallèlle entre l'informatique et la permaculture, et comment les principes de cette dernière, pourraient être appliqués au numérique.

Au début du texte, il souligne que les ordinateurs arrivent à être plus lents malgré le fait qu'ils sont toujours plus rapides.

Il fait bien sûr allusion aux applications qui monopolisent continuellement plus de ressources pour [supposément] répondre aux besoins des utilisateurs. Le gain de puissance apporté par le matériel (hardware), en vient à être gobé par le grand l'appétit du logiciel.

Dans le domaine du développement web c'est encore plus vrai! Les sites web ont pris du [sur]poids. Nous sommes une des rares industrie qui fait fi trop souvent de l'efficacité énergétique. Peut-être parce que son coût est externalisé vers les gens qui utilisent nos produits.

Pour moi, il y a un lien à faire avec l'accessibilité web. Parce que plutôt que de tendre vers un conception universelle des sites et des applications qui, inclurait le plus large spectre de contextes technologiques et humains, nous choisissons l'exclusion et le gaspillage.

Stagit pour exposer ses dépôts git sur le Web

2020-12-19T13:33:39Z

Stagit pour exposer ses dépôts git sur le Web

Stagit est une application, écrite en C, qui crée des pages HTML statiques pour vos répertoires git auto-hébergés. C'est une alternative sobre à gitweb ou à cgit.

Ce printemps, j'ai aussi écrit un autre tutoriel pour ceux qui veulent justement auto-héberger leurs dépôts git.

Mes exemples sont sous OpenBSD, mais cela peut s'appliquer facilement à n'importe quel environment unix.

Prérequis

Être en mesure de vous connnecter à distance sur votre serveur par SSH.
Un dépôt git doit exister sur votre serveur.

Se connecter au serveur par SSH et installer stagit

ssh utilisateur@addr.ip.tld
pkg_add -v stagit

Si vous n'avez pas de paquet pour stagit sur la distribution unix de votre serveur web, vous pouvez récupérer le code sur le site officiel https://codemadness.org/git/stagit/.

Après l'installation, deux applications se retrouvent normalement dans votre répertoire /usr/local/bin. En tapant ls -la /usr/local/bin/stagit*, vous pouvez vérifier si c'est bien le cas:

-rwxr-xr-x  1 root  bin  44604 May  9  2020 /usr/local/bin/stagit
-rwxr-xr-x  1 root  bin  20460 May  9  2020 /usr/local/bin/stagit-index

Si stagit ne se trouve pas à cet endroit, vous pouvez le chercher avec la commande whereis stagit. Au cas où cette commande ne retourne rien, cela veut probablement dire que l'installation ne s'est pas bien passée.

Comment stagit fonctionne?

Stagit fabrique un site web à l'endroit où vous vous trouvez, à partir du dépôt git que vous lui indiquez:

stagit /home/git/monprojet.git

Ce qui va produire quelque chose qui va ressembler à ça:

-rw-r--r--   1 git     www   34963 Dec 19 09:50 atom.xml
drwxr-xr-x   2 git     www    3584 Dec 19 09:50 commit
drwxr-xr-x   8 git     www     512 Dec 18 16:19 file
-rw-r--r--   1 git     www  141243 Dec 19 09:50 files.html
-rw-r--r--   1 git     www   16256 Dec 19 09:50 log.html
lrwxr-xr-x   1 git     www      11 Dec 19 09:50 logo.png -> ../logo.png
-rw-r--r--   1 git     www    1197 Dec 19 09:50 refs.html
lrwxr-xr-x   1 git     www      12 Dec 19 09:50 style.css -> ../style.css

Pour plus de détails, consultez la man page, en tapant man stagit.

À quoi sert `stagit-index`

Comme c'est indiqué dans son nom, stagit-index va créer un page d'index avec tous les dépôts que vous allez lui soumettre:

stagit-index /home/git/depot-0.git /home/git/depot-1.git /home/git/depot-2.git

Le code HTML de cet index s'affichera directement dans la console (stdout). Pour l'écrire dans un fichier index.html, vous devez le préciser dans votre commande:

stagit-index /home/git/abc.git /home/git/xyz.git > index.html

Automatiser le tout avec git et un script de `post-receive`

Évidemment, nous ne voulons pas devoir lancer ces commandes à chaque commit que nous poussons vers notre serveur distant. Nous allons donc écrire un script qui automatisera tout ça.

Crochet à la rescousse

Dans votre dépôt git distant, aller dans le répertoire hooks. Là nous pouvons créer des scripts qui s'exécuterons à différents moments d'une action. Le nôtre devra se lancer à la suite d'une réception d'un git push. Pour plus de détails sur les githooks, référez vous à la documentation officiel: https://git-scm.com/docs/githooks.

Copiez un des scripts présent et renommez-le post-receive puis ouvrez-le avec nano ou un autre éditeur texte de votre choix:

cp post-receive-email.sample post-receive && nano post-receive

Effacez tout ce qui se trouve dans le fichier et copiez ce qui se trouve ci-dessous:

#!/bin/sh -e
# Les chemins doivent être absolues.
# L'emplacement du dépôt git.
gitdir="/home/git/votre-depot-git.git"
# L'emplacement du site.
dstdir="/var/www/votre-site-web.com/git"
# Créer les pages HTML.
mkdir -p "$dstdir/hscc"
(cd "$dstdir/hscc" && stagit "$gitdir")
# L'emplacement de tous les dépôts.
gitall="/home/git"
# Créer l'index
stagit-index "${gitall}/"*/ > "${dstdir}/index.html"
# Créer des liens symboliques pour les styles et le logo.
(cd "$dstdir/hscc" && ln -sf ../style.css style.css && ln -sf ../logo.png logo.png)
echo "post-receive is done"

Sauvegardez et sortez. Pour tester votre script:

./post-receive

Ensuite, allez à l'emplacement supposé du site, pour voir si les fichiers ont bien été créé. Si tout fonctionne comme prévu, à partir de maintenant, lorque vous poursserez vos changements vers votre dépôt git, votre site stagit sera mis à jour automatiquement.

Si vous avez les questions n'hésitez pas à commniquer avec moi! Merci

Surpoids de l'auto et celui du Web

2020-08-10T12:04:00Z

Surpoids de l'auto et celui du Web

Il y a certainement un parallèle à faire entre l'industrie du Web et l'industrie automobile.

En près de vingt ans, la masse moyenne d’un véhicule de promenade (automobile et camion léger) a augmenté de 18 %, selon un calcul de notre Bureau d’enquête fait à partir des nouvelles données de la Société de l’assurance automobile du Québec (SAAQ).

Même si les #autos sont de plus en plus éco-énergétiques, le fait qu'ils s'alourdissent, vient annuler cette économie!

Il en va de même pour les sites Web que nous concevons, nous avons de plus en plus de solutions pour augmenter leur #performance, mais nous les produisons toujours plus lourds! Notamment à cause de la démultiplication des images (souvent inutiles) toujours plus grandes et toujours plus nombreuses.

Nous ne faisons certainement pas parti de la solution, et honte à nous pour cela! 🙈

Source: De plus en plus lourds et de moins en moins économiques.

Auto-héberger ses dépôts git

2020-04-05T14:07:37Z

Auto-héberger ses dépôts git

J'ai un serveur dans mon sous-sol, où j'héberge le site web que vous consulter en ce moment. Et dans cette foulée d'indépendance numérique, j'ai donc décidé d'héberger également mes dépôts git.

En ce moment, pour mes projets, j'utilise soit Github, Gitlab ou Notabug. L'idée est donc de continuer à envoyer mes dépôts git vers ces services tout en utilisant mon propre serveur pour héberger code source de mes projets.

Sans faire des miroirs, je peux pousser mes commits vers plusieurs dépôts distant en même temps en ajoutant un deuxième répertoire distant: git remote set-url --add --push origin git@soucy.cc:soucy.cc.git. Voir la note au sujet de l'option pushurl.

Mes exemples sont sous OpenBSD, mais cela peut s'appliquer facilement à n'importe quel environment unix.

Se connecter au serveur par SSH et installer git

ssh utilisateur@addr.ip.tld
pkg_add -v git

Créer un utilisateur qui acceuillera les dépôts git dans son `$HOME`

mkdir /home/git
user add git

Autoriser votre utilisateur a se connecter par SSH au répertoire `/home/git`

Par exemple si vous vous connectez avec root sur votre serveur maison ou sur votre VPS:

mkdir -m 700 /home/git/.ssh
cp /root/.ssh/authorized_keys /home/git/.ssh/
chown -R git:git /home/git

Créer le dépôt distant et faire son premier commit

Maintenant depuis votre répertoire local (sur votre ordinateur) où se trouve votre code, créez le dépôt distant de type bare par SSH:

ssh git@addr.ip.tld git init --bare soucy.cc.git
git remote add origin git@addr.ip.tld:soucy.cc.git
git remote set-url --add --push origin git@addr.ip.tld:soucy.cc.git
git add .
git commit -m "Mon premier commit vers mon dépôt auto-hébrgé"
git push origin master

Voilà qui est fait. Vous pourriez aussi exposer votre code dans des pages HTML avec stagit ou cgit.

Un raccourcisseur d'URL maison avec RewriteMap

2018-02-28T11:03:46Z

Proposer des URLs courts sur son site statique

Pour un raccourcisseur d'URL maison vous avez besoin d'à peu près 3 choses:

Une liste de vos liens qui pourra être traversée par une boucle. Notez que l'ordre de cette liste doit être immuable; ceux ajoutés a posteriori le seront à la suite des autres.
Une fonction qui convertie les nombres naturels (positif et sans décimal) en chaîne de caractère.
Un accès au fichier de configuration de votre serveur HTTP; car malheuresement la solution que je propose ne peut pas être accomplie à travers un fichier de type .htaccess. Accès peut vouloir dire par vous ou par l'administrateur de votre serveur, si celui-ci est ouvert à vous aider.

Traverser la liste de vos liens

Il faut que l'emsemble des URLs que vous voulez raccourcir soient disponibles sous la forme d'un array. Comme je l'écrivais plus haut, dans ce array, l'ordre doit être immuable, puisque que ce sera le nombre qui, correspond à la position de chaque entrée qui servira à créer la chaîne de caractère courte.

Pour ma part, je stock mes URLs dans un fichier JSON qui, contient un objet dont les clés sont les URLs longs et les valeurs sont les chaînes raccourcies.

Ce JSON est créé lorsque je lance le générateur de site statique pour la première fois. Ensuite, je vérifie son existence et une nouvelle entrée est faite si la clée n'est pas déjà présente dans le JSON en question.

Moi j'ai choisi JSON, mais évidemment, cela pourrait être fait avec un autre format de donnée, comme par exemple SQLite. Sinon, voilà à quoi ressemble ma fonction en lua :

function link.makeshorts()
local links = {}
local links_db = Ferron.site.path .. Ferron.site.siteconfig.paths.data .. "/shortlinks.json"
-- If `links_db` dosen't exists create it
if path.isfile(links_db) == false then
local counter = 0
fileutils.pushfilecontent(links_db, "")
for k, v in tableutils.sortdescendingpairs(Ferron.site.pagestable) do
if v.rellink ~= "" then
counter = counter + 1
links[v.rellink] = fileutils.shorturlencode(counter)
end
end
else
links = json.decode(fileutils.pullfilecontent(links_db))
for k, v in tableutils.sortdescendingpairs(Ferron.site.pagestable) do
if v.rellink ~= "" and links[v.rellink] == nil then
links[v.rellink] = fileutils.shorturlencode(tableutils.length(links) + 1)
end
end
end
return fileutils.pushfilecontent(links_db, json.encode(links, {indent = true}))
end

Convertir les nombres en chaîne de caractère

Dans le bloc de code qui précède, c'est la fonction fileutils.shorturlencode() qui transforme l'identifiant numérique de la position de chaque entrée, en courte chaîne de caractère. C'est ce que l'on appelle une application bijective. J'ai créé une version en lua pour mon générateur de site statique, en me basant sur la version JavaScript que l'on retrouve sur GitHub dans le répertoire ShortURL. D'ailleurs, j'ai ajouté ma contribution à la douzaine de langage déjà présent.

Appliquer les redirection avec `RewriteMap`

Une fois que les adresses de vos pages sont associées à des URLs courts, il faut les exporter dans un fichier text qui sera utilisé par la directive RewitreMap.

Voici à quoi cela doit ressembler :

## shortlinksmap.txt -- rewriting map
L /note/2017/06/sesame-street-lgbt-pride.html
Q /note/2017/05/twitter-partage-vos-donnees-personnelles.html
23 /note/2017/03/animista-css-animations-on-demand.html
2L /note/2016/08/quoi-ce-n-est-pas-des-femmes-grenouilles.html
M /note/2017/06/petite-contribution-bash-au-task-runner-manuel.html
n /note/2017/12/openbsd-mise-a-jour-reussie.html
4 /note/2018/01/premier-pullrequest-lua-accepte.html
C /note/2017/09/lesbricodeurs-replyto-status-909427743573577728.html
2Q /note/2016/08/snowden-pardon-petition-on-facebook.html
P /note/2017/06/le-velo-cest-dangereux.html
2H /note/2016/09/internet-3-0-peut-on-reprendre-le-controle-des-geants.html

Puis dans votre fichier de configuration de votre site ajouter les directives suivantes. Selon votre version d'Apache il peut y avoir quelques variantes; SVP référez-vous à la documentation pour plus de détails.

## /etc/apache2/sites-available/h.soucy.cc.conf
RewriteEngine On
RewriteMap shortlinksmap "txt:/var/www/h.soucy.cc/shortlinksmap.txt"
RewriteCond ${shortlinksmap:$1|Unknown} !Unknown
RewriteRule "^/(.*)$" "${shortlinksmap:$1}" [R,L]

Je suppose qu'il existe le même genre de mécanisme pour Nginx ou Lighttpd.

À propos des enjeux autour des URLs courts

Les URLs courts sont souvent visibles sur les réseaux sociaux, tel que Twitter, pour faciliter le partage de lien dans un contexte où le message de l'auteur est limité en caractère; historiquement 140 et maintenant 280 pour les tweets. Le service le plus connu est sans doute bit.ly. Sinon on voit également beaucoup celui de l'omniprésent Google, dont le nom de domaine est goo.gl.

L'utilisation d'un service de raccourcissement fragilise la périnnité des URLs dans nos contenus; puisque si le service en question cesse ses activités du jour au lendemain, tous les liens qu'il redirigait se retrouvent dès lors inutilisables. De plus, que se passerait-il si un service était pirater ou racheter par quelqu'un avec de mauvaises intentions qui, pourrait réaiguiller tous les URLs vers des destinations peu reluisantes ?!

Dans une optique de durabilité et de robustesse il vaut toujours mieux gérer soi-même ses données. Si vous utilisez un CMS comme Drupal ou Wordpress vous avez sans doute accès à des extensions qui vous permettent de mettre en place votre propre raccourcisseur. Et c'est probablement le cas également de générateurs de site statique bien établis comme Jekyll ou Octopress.

Aide-mémoire OpenBSD

2017-11-23T21:03:10Z

Aide-mémoire OpenBSD

Notes personnelles à propos de l'utilisation d'OpenBSD comme systhème d'exploitation sur mon ordinateur personnel.

Maintenance du systhème

Mises à jour

`pkg_add` : ajouter ou mettre à jour des paquets (ports)

pkg_add -v nomdupaquet
pkg_add -uiv nomdupaquet

openports.pl est un des endroits pour trouver des paquets OpenBSD.

Nettoyage de OpenBSD

pkg_check : Donner de l'information sur l'état des paquets installés.
pkg_delete -a : Supprimer les dépendances rendues inutiles.

`syspatch` : mettre à jour le systhème

syspatch

Réseau sans fils

Ajout d'une connexion WiFi

Dans le fichier /etc/hostname.iwn0 ajouter une ligne par connexion. Par exemple :

dhcp nwid "MonReseauWiFi" wpakey monsupermotdepass.

Mais comment se connecter à un hotspot ou un point d'accès sans mot de passe ? Simplement en ajoutant l'option -wpa, comme dans l'exemple ci-dessous :

dhcp nwid "ZAP - Centre Ferland" -wpa

Si il existe plus d'une connexion, toutes les commenter sauf celle qui correspond à la connexion WiFi désirée. Ensuite redémarrer l'interface avec netstart :

sh /etc/netstart iwn0.

Pour trouver les points d'accès disponibles :

ifconfig iwn0 scan.

wpa_supplicant pourrait être une alternative pour gérer la connexion entre des points d'accès multiple.

Disques et partitions

Voir l'utilisation des disques:

df -h.

Réseau

Obtenir un tableau des ports qui sont écoutés par le serveur:

netstat -tnl -f inet.

Pour savoir quel service écoute quel port:

cat /etc/services.

Polices de caractère

Emojis

Installer le paquet openmoji:

pkg_add -v openmoji

Puis créer un lien symbolique dans /etc/fonts/conf.d/:

ln -s /usr/local/share/openmoji/90-openmoji-aliases.conf /etc/fonts/conf.d/

Emacs 101 - la configuration

2015-06-30T12:22:16Z

Emacs 101 – la configuration

Un apsect essentiel et extrèmement puissant d'Emacs, est sa capacité à être personnalisé et à être étendu en fonctionnalité. La configuration et l'ajout de nouvelles fonctions se fait avec un langage de programmation qui s'appelle le Emacs lisp ou elisp. Les fichiers écris en elisp se termine par l'extension .el.

Au démarrage, Emacs vérifie si il existe des fichiers elisp qui lui indiquerait des particularités d'initialisation dont il doit tenir compte. Pour se faire il va chercher si un des fichiers suivants existent à la racine du répertoire utilisateur : ~/.emacs, ~/.emacs.el, ou ~/.emacs.d/init.el. C'est dans ce fichier que l'on doit indiquer au programme nos préférences d'utilisation.

Vous pouvez choisir la forme de fichier de configuration qui vous plaira, mais la dernière forme est considérée comme faisant partie des bonnes pratiques, car elle permet de regrouper en un seul répertoire tous les fichiers nécessaires à la personnalisation d'Emacs. D'ailleurs le répertoire .emacs.d est généré par défaut, donc il ne vous reste plus qu'à y ajouter votre fichier init.el.

Création du fichier `init.el`

Tout d'abord, rappelons que C- correspond à la touche Ctrl et que M- correspond à la touche Alt. Donc C-k est semblable à Ctrl + k.

Nous allons maintenant créer le fichier init.el qui nous permettra de personnaliser Emacs à votre convenance :

Ouvrir Emacs.
Exécuter la commande C-x C-f (ouvrir ou créer un fichier).
Le pointeur est déplacer vers le minibuffer, où il est indiqué “Find file: ~/”.
Écrivez alors .emacs.d/init.el puis tapez sur Entrée. Si vous vous êtes trompé ou que vous ne comprenez pas ce qui se passe, faîtes C-g pour sortir du minibuffer et recommencez.
Si tout c'est bien passé, vous avez basculé vers un nouveau fichier vierge et le pointeur n'est plus dans le minibuffer.
Faîtes C-x C-s pour enregistrer init.el sur le disque.

Dès lors nous sommes en mesure de commencer notre personnalisation de Emacs.

Nos premières modifications

En démarrant Emacs vous avez peut-être remarqué que le programme s'ouvrait avec une page de bienvenue et que la marge ne contenait pas de numéros de ligne. Nous allons donc changer ces deux paramètres pour commencer; car vous l'avourez, c'est bien pratique des numéros de ligne lorqu'on écrit du code et la page de bienvenue n'est pas très jolie ;)

Ajouter les numéros de ligne

Pour ajouter des numéros dans la marge, ajoutez les deux lignes de code suivantes à votre fichier init.el.

;; Add line numbers
(global-linum-mode 1)

La première ligne est simplement un commentaire pour indiquer quel est le rôle de la ligne suivante. D'ailleurs je vous conseille de toujours commenter ce que vous faîtes dans votre fichier de configuration personnel; il sera alors plus facile de vous y retrouver au fil du temps.

La deuxième ligne, vous l'aurez deviné, est une instruction qui indique à Emacs d'afficher les numéros de ligne dans la marge.

Pour voir les changements immédiatement, tapez M-x load-file, puis faîtes Entrée. Cette commande réexécutera votre fichier init.el. Sinon vous devez redémarrer le programme pour que la nouvelle instruction soit effective.

Surligner la ligne courante

;; Highlight Current Line
(global-hl-line-mode +1)

Retirer la barre de défilement (scroll)

;; Disable scroll bars
(scroll-bar-mode -1)

Changer la page d'accueil

Pour remplacer l'écran de démarrage par un autre buffer, il faut d'abord désactiver la valeur par défaut et ensuite indiquer avec quoi nous voulons le remplacer :

;; Remove splash screen on startup
(setq inhibit-splash-screen t)
;; Have dired open instead
(dired "~/")

Vous les aurez reconnus, la première et la troisième ligne sont des commentaires qui annonces ce que nous allons modifier et/ou ajouter.

La deuxième ligne elle, change la valeur par défaut de la variable inhibit-splash-screen à t (vrai en elisp) qui par défaut est à nil (nul en elisp). Le nom de cette variable se traduirait par «empêcher l'écran de démarrage».

Avec la quatrième ligne nous indiquons à Emacs d'ouvrir le répertoire utilisateur (~/) dans le gestionnaire de fichier (dired). Vous pouvez ainsi ouvrir le dossier de votre choix ou vous pourriez ouvrir directement un fichier avec la fonction find-file au lieu de la fonction dired :

;; Remove splash screen on startup
(setq inhibit-splash-screen t)
;; Have a file instead
(find-file "~/.bashrc")

Installer des extensions avec le gestionnaire de paquet

Depuis la version 24 un gestionnaire de paquets est inclu par défaut. Le but de ce gestionnaire est de faciliter l'intallation, l'utilisation et la mise à jour d'extensions, de thèmes, de mode pour Emacs.

Pour afficher le gestionnaire de paquets vous devez taper la commande M-x package-list, puis faire Entrée. Le buffer *Packages* s'ouvrira; celui-ci est un tableau contenant l'archive par défaut qui porte le nom de ELPA. Pour avoir la description complète d'un paquet déplacez le curseur vis-à-vis celui-ci, puis appuyez sur Entrée. Pour marquer un paquet à installer faîtes i; pour compléter l'installation ou tout autre action appuyez sur la touche x.

Ajouter des archives

ELPA, c'est bien, mais il ne contient pas tout ce qui pourrait nous intéresser. Donc pour étendre l'offre des paquets il faut ajouter des archives à notre gestionnaire! Et MELPA et Marmalade sont deux des archives les plus fréquenter et fréquentables du moment.

Ce qui nous ramène donc à notre fichier init.el … À la fin de celui-ci coller le bloc de code suivant :

(when (>= emacs-major-version 24)
(require 'package)
(package-initialize)
(add-to-list 'package-archives '("melpa-stable" . "http://melpa-stable.milkbox.net/packages/") t)
(add-to-list 'package-archives '("marmalade" . "https://marmalade-repo.org/packages/"))
)

D'abord avec when nous vérifions que la version de Emacs est bien supérieur ou égal à la version 24. Ensuite nous importons le gestionnaire de paquets avec require, puis nous initialisons celui-ci. Dès lors nous pouvons ajouter des archives supplémentaires avec add-to-list.

Encore une fois, pour voir les changements immédiatement nous devons tapez M-x load-file, puis faire Entrée. Pour vérifier que les nouvelles archives sont bien chargées dans le gestionnaire de paquets il suffit de l'ouvrir (M-x package-list) et de regarder sous la colonne Archive si il y a les termes melpa-stable et marmalade qui apparaissent çà et là. Sinon il faut redémarrer Emacs et revérifier à nouveau.

Vous remarquerez que la liste des paquets s'est grandement apprécié de plusieurs dizaines d'items supplémentaires.

Mofication du thème : décore ta vie !

La dernière configuration que nous ferons aujourd'hui en est une de la plus haute importance : la mofification du thème graphique de Emacs ! D'autant plus que, maintenant grâce aux archives MELPA et Marmalade, nous avons accès à moulte nouveaux thèmes.

Vous pouvez parcourir Packages à la recherche de thèmes; pour se faire vous pouvez utiliser I-search (C-s) avec le mot clé theme.

Une fois votre theme télécharger vous pouvez l'utiliser avec la commande M-x load-theme. Le mini-buffer vous demandera alors le nom du thème à charger. Si vous ne vous en souvenez plus appuyez sur la touche Tab pour obtenir la liste des options disponibles.

Pour charger votre nouveau thème au démarage de Emacs il suffit de lancer la fonction load-theme dans votre fichier de configuration init.el. Disons que le thème installer par le gestionnaire de paquet est cyberpunk, vous indiquerez donc ceci :

;; Theme
(load-theme 'cyberpunk t)

Si ne voulez pas y aller à l'aveugle en installant et chargeant un par un les thèmes qui se trouvent dans Packages, vous pouvez aller sur le site web Emacs Themes pour magasiner votre thème. C'est normalement indiquer si votre choix est disponible dans MELPA ou un autre archive.

Conclusion

Dans le prochain billet je parlerai du comment configurer GNU Emacs pour faire du dévloppement web.

Autre billet de cette série :

Emacs 101 – l'introduction.

Emacs 101 - l'introduction

2015-06-28T19:12:02Z

Emacs 101 – l'introduction

Apprendre Emacs peut être perçu comme quelque chose de difficile. Pour ma part, je ne considère pas cela comme difficile, non. Mais cela demande certainement du temps.

Premièrement, il faut du temps pour découvrir cet envrionnement et apprendre les concepts qui le compose. Il faut aussi du temps pour connaître par coeur les commandes de base. Notre tête et nos doigts doivent s'y habituer pour sortir du joug de la souris. Car c'est bien cela l'avantage de maîtriser son éditeur texte : gagner en productivité.

Et passer moins de temps à faire des aller-retours entre la souris et le clavier apporte définitivement un gain en productivité.

Comme par exemple, si je veux sélectionner un paragraphe, le couper et le coller à fin du document. Je peux utiliser le clavier et la souris … ou seulement la souris. Toutefois avec Emacs je ferais la série de commandes suivantes (C- correspond à la touche Ctrl et M- correspond à la touche Alt) :

M-a, pour placer mon curseur au début au paragraphe;
M-k, pour couper une paragraphe vers l'avant (l'inverse serait C-x <DEL>);
M->, pour me rendre à la fin du document;
C-y, pour finalement coller le paragraphe.

Dans les premiers temps ce type de séquence vous paraîtra beaucoup moins efficace que vos anciennes habitudes, mais si vous persévérez dans l'apprentissage d'Emacs, après quelques semaines vous exécuterez ce genre de tâche avec rapidité et fluidité.

Selon-moi le meilleur moyen d'apprendre les commandes de base, est de suivre le tutoriel officiel qui est directement intégrer dans Emacs. Pour y accéder, tapez M-x, puis entrez la commande help-with-tutorial-spec-language; un choix de langue vous sera offert.

Ce tutoriel interactif vous apprendra les bases pour atteindre le bonheur et le confort dans votre nouvel éditeur texte préféré :

Démarrer et fermer Emacs.
Les commandes de bases pour vous déplacer dans le texte et l'éditer.
Ouvrir et sauvegarder des fichiers.
Les concepts qui composent Emacs : windows, frames, files, buffers, etc.
Invoquer des fonctions avec la commande M-x.
Etc.

Buffers, windows et frames

Avant d'enter dans les commandes de déplacement et d'édition, je crois qu'il faut d'abord que je vous explique ce qu'est un buffer, une window et un frame. Ces concepts sont parfois un peu déroutant pour le nouveau venu dans Emacs …

Buffers

Premièrement, on peut avoir plusieurs buffers ouverts en même temps. Habituellement un buffer représente le contenu d'un fichier, mais il peut être aussi de l'information en provenance de l'application, comme par exemple le buffer Messages, toujours présent à l'ouverture d'Emacs.

Les buffers sont visibles travers les fenêtres (windows). Pour passer à un autre buffer et l'afficher dans la fenêtre courante vous devez faire la commande C-x b. Cela a pour conséquence de déplacer le curseur vers le minibuffer et d'afficher un message qui ressemble à “Switch to buffer (default scratch)”.

À partir de là, vous pouvez taper le nom du buffer vers lequel vous voulez basculer. Pour afficher la liste de ceux qui sont ouverts appuyez sur la touche Tab.

Pour quitter le minibuffer, annuler la commande en cours et retourner le curseur dans le buffer faîtes C-g.

Il est aussi possible de lister directement tous les buffers qui sont actifs en tapant C-x C-b.

Windows et frames

Dans Emacs une fenêtre (window) n'est pas une fenêtre comme on l'entend dans un contexte de système d'exploitation; dans ce cas on parlerait plutôt d'un cadre (frame). La fenêtre est une vue sur un buffer, et il est possible d'avoir plusieurs fenêtres dans un seul cadre, ce qui permet d'afficher de multiple buffers en même temps.

Bien sûr il y des commandes pour créer ou supprimer des fenêtres, se déplacer dans chacune d'elle, modifier leur taille, etc.

Nouvelle fenêtre horizontale : C-x 2.
Nouvelle fenêtre verticale : C-x 3.
Fermer toutes les fenêtres sauf la fenêtre courante : C-x 1.
Fermer la fenêtre courante : C-x 0.
Naviguer d'une fenêtre à l'autre : C-x o.

Si vous voulez un nouveau cadre et non une nouvelle fenêtre, la commande est C-x 5 2.

Minibuffer

Le minibuffer quant à lui est l'espace, sous la barre de status, où vous interagissez avec Emacs : entrer une commande, donner un valeur à un argument, recevoir de l'info, etc. Dans le minibuffer vous avez accès aux mêmes fonctionnalités que dans n'importe quel buffer.

Rappel : Pour quitter le minibuffer, annuler la commande en cours et retourner le curseur dans le buffer faîtes C-g.

Les commandes de base

Voici une liste des commandes que vous devez maîtriser pour être efficace dans Emacs. Il est aussi intéressant de savoir que, plusieurs commandes Emacs de base fonctionneront dans n'importe quel terminal Linux ou BSD. Donc en les apprenant, vous devenez également un meilleur utilisateur UNIX.

D'abord, rappelons que C- correspond à la touche Ctrl et que M- correspond à la touche Alt. Donc C-k est semblable à Ctrl + k.

Ouvrir, créer, sauvegarder et fermer des buffers

Ouvir ou créer un fichier : C-x C-f.
Sauvegarder le buffer courant : C-x C-s.
Sauvegarder tous les buffers ouverts : C-x s.
Enregistrer-sous : C-x C-w.
Fermer un buffer : C-x k.

Se déplacer dans un buffer

Caratère suivant : C-f.
Caratère précédent : C-b.
Ligne suivante : C-n.
Ligne précédente : C-p.
Début d'une ligne : C-a.
Début d'une ligne indentée : M-m.
Fin d'une ligne : C-e.
Mot suivant : M-f.
Mot précédent : M-b.
Phrase précédente : M-a.
Phrase suivante : M-e.
Page précédente : M-v.
Page suivante : C-v.
Début du buffer : M-<.
Fin du buffer : M->.
Aller à une ligne en particulier : M-g g.

Chercher / Remplacer

Recherche vers la fin du fichier : C-s (répéter la commande pour l'occurrence suivante).
Recherche vers le début du fichier : C-r (répéter la commande pour l'occurrence précédente).
Remplacer : M-%,
y pour remplacer la correspondance en cours;
n pour aller à la prohcaine correspondance sans remplacer;
q pour sortir du processus de remplacement courant;
. pour remplacer la correspondance en cours puis quitter le processus;
! pour tout remplacer sans aucune autre question.
Chercher dans plusieurs fichiers : M-x rgrep.

Effacer

Effacer le mot suivant : M-d.
Effacer le mot précédant : M-Backspace.

Sélectionner

Indiquer le début (point) d'une sélection (mark) : C-Spacebar.
Sélectionner tout le paragraphe : M-h.
Sélectionner tout le buffer : C-x h.
Sélectionner une fonction : C-M-h.
Modifier une sélection : C-x C-x.

Notez que l'on peut faire des actions spécifiques à une région qui est marquée. Ex.: Des undo, des trouver/remplacer, des recherches, etc.

Couper / Copier / Coller

Dans le jargon Emacs les termes couper et coller sont remplacé par “kill” et “yank”.

Couper : C-w.
Copier : M-w.
Coller : C-y.
Couper une ligne : C-k.
Couper une phrase (vers l'avant) : M-k.
Couper une phrase (vers l'arrière) : C-x <DEL>.
Couper une région : C-w.

Emacs garde en mémoire tout ce qui a été couper et copier et lorsque vous collez vous avez accès à cet historique. Pour cela il suffit de coller une première fois avec C-y, puis ensuite faire M-y pour coller l'item de l'historique suivant. Cette “mémoire” se nomme kill ring. Cette fonctionnalité est une particularité très puissante et très utile de Emacs.

Undo

Il y a trois combinaisons possibles pour invoquer la fonction undo …

Undo : C-x u ou C-/ ou C-_.

À la base Emacs n'offre pas de fonction “redo” je crois. Mais il y a une extension qui s'appelle undo-tree qui étend les fonctionnalités de base à ce niveau.

Changements de casse

Premier caractère en majuscule : M-c.
Mot en majuscule : M-u.
Mot en minuscule : M-l.

Permutations

Intervertir deux lettres : C-t.
Intervertir deux mots : M-t.
Intervertir deux lignes : C-x C-t.

Auto-Complétion

Auto-complétion d'un mot se trouvant déjà dans un buffer : M-/.

Aide

Tutorial Emacs : F1 t.
Documentation : F1 r.
Description d'une commande : F1 k ou C-h k.
Description d'une fonction : F1 f ou C-h f.

Conclusion à cette introduction

Vous vous doûtez bien qu'il s'agit ici que d'un survol très sommaire des commandes et des fonctionnalités d'Emacs. D'autres billets viendront complétés celui-ci, en choisissant d'explorer des aspects plus précis.

Ceci dit, j'espère que vous allez essayer et aimer Emacs. Au départ, je vous suggère d'expérimenter et appliquer les notions que vous avez apprisent dans des fichiers de configuration ou sur des projets personnels, avant d'en faire votre éditeur de tous les jours … Si vous percévérez vous ne pourrez plus vous en passer.

Lire la suite de ce billet :

Emacs 101 – la configuration.

Emacs, l'obsession du moment

2013-06-17T08:38:24Z

J’ai utilisé Netbeans pendant au moins 6 ans. Cet IDE faisait à peu près tout ce dont j’avais besoin et le faisait généralement très bien. Mais il était aussi muni de fonctionnalités (la plupart tournant autour du langage Java) qui était complètement inutiles à un intégrateur Web. J’utilise à peu près toujours les mêmes technologies: HTML, CSS, JavaScript, Git, SSH/SCP. Donc c’était du genre bazooka pour tuer une mouche.

Deuxièmement je n’ai pas un ordinateur ultra puissant pour faire tourner ce genre de logiciel au quart de tour. Les IDEs ça pèse rarement une plume; quoique qu’avec les années Netbeans a fait énormément de progrès coté performance.

Et troisièmement, je voulais surtout apprendre un éditeur que l’on peut utiliser à travers un Terminal. À ce carrefour, le choix se fait très souvent entre deux supposés ennemis: Vim et Emacs. Je ne veux pas ici entrer dans cette rivalité, mais j’ai choisi Emacs car, dans Vim le principe des modes me rebutait un peu.

Rendu là c’est surtout une question de goût et de point de vue. L’antagonisme de type Microsoft vs Apple, ou Beatles vs Stones est très souvent puéril. Il vaut mieux apprécier et respecter les qualités de chacun. Dans le cas de Vi[m], je crois que c’est très important d’en connaître au moins les bases, puisqu’on le retrouve par défaut dans tout les environnements de type UNIX; ce qui n’est pas le cas d’Emacs. Alors quand vous devez éditer un fichier de configuration sur un serveur étranger, connaître Vim (ou Nano) peut vous sauvez la vie. ;)

Chose sûr, que ça soit Emacs ou Vim, il faut généralement pas mal de temps pour maîtriser ces deux logiciels. Pour ma part, cela fait un peu moins de six mois que j’utilise Emacs tous les jours et tous les jours je découvre de nouvelles choses à son sujet. Je dirais que je maîtrise relativement bien la plupart des raccourcis de bases, mais je ne peux pas me qualifier encore d’utilisateur avancé.

En amour avec

À mon avis il est très facile de tomber en amour avec Emacs. Tout simplement parce que ce logiciel peut faire des choses tellement cool avec n’importe quel document de type textuel. Si bien qu’on ne veut plus le quitter, on veut tout faire dans Emacs: Programmer, rédiger des textes, gérer ses courriels, lire ses fils RSS, faire sa liste d’épicerie, organiser et parcourir ses fichiers, gérer son emploi du temps et plus encore… Et le pire, c’est que tout ça c’est possible!

Une des plus grandes forces d’Emacs c’est justement son haut degré de personnalisation et d’extensibilité. Le langage Emacs Lisp est ce qui permet à l’utilisateur de mettre Emacs à sa main. Mais rassurez vous, vous n’avez pas besoin de savoir programmer en ELisp pour y arriver, car le Web est rempli d’exemples et de snippets qui vous permettront d’apprécier toute la puissance d’Emacs!

Voici d’ailleurs quelques ressources qui vous permettrons de progresser rapidement dans votre usage d’Emacs: EmacsWiki, ~~Hack Emacs~~, ErgoEmacs, Emacs Redux, emacs-fu et bien sûr la documentation officiel.

De mon coté je maintiens ~~sur GitHub~~ un aide-mémoire où j’inscris les raccourcis clavier qui me sont utiles.

Si vous venez à être tenté par l’aventure Emacs, la première fois que vous le lancerez, vous le trouverez peut-être un peu dégarni (il n’y a même pas de marge pour numéroter les lignes). Certaines personnes pourraient voir ça comme un défaut. Pour ma part je trouve que c’est une bonne chose, car le débutant plonge tête première dans le logiciel et en comprend mieux les rouages. Mais qu’à cela ne tienne, la dynamique communauté d’Emacs a développé des kits de départ pour permettre une introduction plus en douceur. Les plus connus sont Emacs Starter Kit et Emacs Prelude.

En terminant, je vous conseille de jeter un œil sur la série de screencast Emacs Rocks animée par Magnar Sveen, où ce dernier présente avec des exemples concrets la toute puissance d’Emacs! D’ailleurs voici le premier épisode…

http://www.youtube.com/embed/O0UgY-DmFbU

Contenus classés par mots clés

0000-00-00T14:32:00Z

Contenus classés par mots clés

wiki.soucy.cc

ImageMagick

ImageMagick

Dither

makefile

Makefile

Sources / Ressources

wimm

wimm – web image manager

offlineimap

OfflineIMAP

entr

entr

gnupg

gnupg

newsboat

newsboat

msmtp

msmtp

lowdown

lowdown

feh

feh

Mon laptop

Mon laptop

Vdirsyncer

Vdirsyncer pour synchroniser CalDAV et CardDAV sur votre ordinateur

Exemple de configuration

Bloc CalDAV

Bloc CardDAV

Synchroniser à l'heure

Ma configuration complète

L'utilisation

Khal

Khard

Conclusion

Liste de CMS et de SSG

Liste de CMS et de SSG

CMS sans BD (flat file)

SSG

Mémento Unix

Mémento Unix

Raccourcis clavier

Commandes pour fichier et répertoire

Information système

Gestion des processus

Gestion des permissions

SSH

Fichier de configuration SSH

Avec rsync

Compression

Réseau

xdg-utils

xterm

xterm

~/.Xresources

Accessibilité web

Accessibilité web

Intro

Suivre le fil

Suivre le guide

Suivre le rythme

Suivre la voix

Outils

Mémento expressions régulières

Mémento expressions régulières

Motifs de base

Le point: .

Crochets: [xyz]

Crochets avec exclusion: [^xyz]

Crochets avec plage: [a-z]

Astérisque: *

Symbole d'addition: +

Point d'interrogation: ?

Accolades: {}

Parenthèses: ()

Parenthèses sans capture: (?: )

Parenthèses avec pipe: (abc|xyz)

Caractère d'échappement: \

Quelques exemples pouvant être utiles

Le point: `.`

Crochets: `[xyz]`

Crochets avec exclusion: `[^xyz]`

Crochets avec plage: `[a-z]`

Astérisque: `*`

Symbole d'addition: `+`

Point d'interrogation: `?`

Accolades: `{}`

Parenthèses: `()`

Parenthèses sans capture: `(?: )`

Parenthèses avec pipe: `(abc|xyz)`

Caractère d'échappement: `\`

Règle `@import`

Utilitaire `cat`

Concaténer une liste de CSS avec `while`, `read` et `<`

Minifier une feuille de style avec `tr` pour réduire son poid

Retirer les commemtaires avec `sed`

À quoi sert `stagit-index`

Automatiser le tout avec git et un script de `post-receive`

Créer un utilisateur qui acceuillera les dépôts git dans son `$HOME`

Autoriser votre utilisateur a se connecter par SSH au répertoire `/home/git`

Appliquer les redirection avec `RewriteMap`