Aller au contenu
EngineerLogiciels
Menu
Design
Français

Engineer / Logiciels

Engineer dans un terminal

Lisez engineer.company en ligne de commande : Markdown par HTTP, Gemini, Gopher et un service onion — le même site, quatre accès.

Ce site répond sur quatre protocoles à partir d’un seul dossier de fichiers sur un seul serveur. Si vous vivez dans un terminal, vous n’avez jamais besoin d’ouvrir un navigateur pour le lire.

Les formats publics du site décrits ci-dessous ne nécessitent ni compte, ni clé, ni client à compiler. Les dépôts du code source sont privés ; la section SSH explique leurs conditions d’accès.

Chaque page existe aussi en Markdown

Chaque page dispose d’une version HTML et, à côté, d’une version Markdown épurée. Demandez l’un ou l’autre format.

# The twin, by name
curl -sL https://engineer.company/about/index.md

# Or ask the server for it and let it choose
curl -sL -H 'Accept: text/markdown' https://engineer.company/about/

Transmettez le résultat à l’outil de rendu Markdown de votre choix :

curl -sL https://engineer.company/portfolio/index.md | glow -
curl -sL https://engineer.company/what-it-costs/index.md | bat -l md

Les autres langues fonctionnent de la même manière — /da/about/index.md, /uk/about/index.md.

À côté du code QR de chaque page, les liens vers les différents formats donnent aussi accès à du JSON, du gemtext et un menu Gopher. Le JSON de /fr/about/index.json contient les métadonnées et le contenu Markdown de cette page ; /fr/feed.json est un flux distinct, consacré au portfolio. Demandez directement index.json : Accept: application/json ne permet pas de le sélectionner à partir de l’URL HTML.

Voir le PDF ouvre le PDF de la page dans un nouvel onglet ; Télécharger le PDF propose le même fichier au téléchargement. Ces fichiers statiques sont générés avant publication, en reprenant la mise en page prévue pour l’impression. Les liens utilisent les commandes natives du navigateur et n’ajoutent aucun JavaScript exécuté dans le navigateur.

Une capsule Gemini

Gemini est un petit protocole qui intègre les principes de ce site : des documents textuels sur TLS, sans scripts, sans cookies, sans rien pour vous suivre. Chaque page de ce site existe aussi en gemtext.

gemini://engineer.company/

Tout client Gemini peut le lire — Amfora, Lagrange ou Bombadillo dans un terminal, Castor ou Kristall dans une fenêtre. Sur un Mac avec Homebrew :

brew install amfora && amfora gemini://engineer.company/

Un espace Gopher

Gopher est un protocole de menus datant de 1991 — du TCP simple, sans chiffrement ni scripts — et le site y est un ensemble de menus, un par répertoire.

gopher://engineer.company/

Lynx le comprend sans configuration supplémentaire, tout comme Bombadillo et gopher-cli. Ou demandez un sélecteur manuellement : tout le protocole tient en une ligne.

printf '/contact\r\n' | nc engineer.company 70

Un service onion

Le même site par Tor, pour une personne dont le réseau ne devrait pas savoir ce qu’elle lit :

http://engineer2ezpeji52ipphljcflzyhetvy5r6tnqubtq45nzlxxv6rsqd.onion/

Le simple http:// est délibéré : une adresse onion encode la clé publique d’identité du service. Tor authentifie le service et chiffre la connexion avant tout échange HTTP. Avec Tor en cours d’exécution localement, curl y accède directement :

curl -sL --socks5-hostname 127.0.0.1:9050 \
  http://engineer2ezpeji52ipphljcflzyhetvy5r6tnqubtq45nzlxxv6rsqd.onion/index.md

Lire les réalisations comme des données

Le portfolio est diffusé dans trois formats, chacun contenant le texte intégral de chaque élément plutôt qu’un aperçu :

curl -s https://engineer.company/feed.json | jq -r '.items[] | .title'
curl -s https://engineer.company/index.xml     # RSS
curl -s https://engineer.company/atom.xml      # Atom

Le site tient aussi son propre plan pour tout ce qui lit plutôt que de parcourir les liens :

curl -s https://engineer.company/llms.txt
curl -s https://engineer.company/humans.txt
curl -s https://engineer.company/.well-known/security.txt

Le code source, par SSH

Le code source du site est conservé dans des dépôts privés de notre serveur git. Les personnes autorisées y accèdent par SSH avec une clé SSH approuvée :

ssh git.engineer.company

La commande ouvre l’interface du serveur. Les dépôts que vous pouvez consulter dépendent des droits accordés à votre clé SSH. La page publique git.engineer.company décrit le service ; elle ne publie pas le contenu des dépôts.

Pourquoi tout cela existe

Un déploiement écrit un seul dossier, et quatre portes d’entrée le lisent. Aucune ne peut donc diverger des autres, et aucune n’est une copie du site maintenue séparément. Une page qui se lit bien en gemtext possède une structure réelle plutôt qu’un simple décor ; c’est cette même propriété qui la rend agréable à lire avec un lecteur d’écran et correcte à imprimer sur papier. La page des crédits nomme les démons derrière chacun de ces accès.

Nous construisons des systèmes qui se lisent bien sans navigateur, car c’est généralement le signe qu’ils ont été correctement conçus — demandez-nous de vous en construire un.

Contact

Vous cherchez encore à préciser vos besoins ?

Dites-nous ce qui ne fonctionne pas ou ce que vous essayez de construire. Nous vous dirons ce que cela demanderait, son coût approximatif et si nous sommes les bonnes personnes pour le réaliser.

À partir de 1 400 DKK de l'heure, hors TVA — et un tarif horaire réduit pour une réservation plus longue.

welcome@engineer.company +45 50 10 61 84 Copenhague, Danemark