Engineer / Données
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 mdLes 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 70Un 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.mdLire 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 # AtomLe 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.txtLe 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.companyLa 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.