Aller au contenu

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.

  • Réseau, câble réseau, gestion du câblage
    Photo : Bru-nO / Pixabay
  • Amiga, ordinateur, rétro
    Photo : AndrzejRembowski / Pixabay

Allez au-delà du navigateur

Rendez les informations utiles accessibles aux personnes et aux outils en dehors d'un navigateur graphique.

Découvrir nos prestations Contactez-nous

Examinez les interfaces textuelles

Examinez les interfaces textuelles présentées ici comme exemples d'une source unique accessible à plusieurs clients.

Études de cas Contactez-nous

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 contenu qui peut quitter le navigateur pour lequel il a été écrit survivra au framework qui l'a construit.

Nous construisons les systèmes de la même façon : les données sont l'actif, l'interface est remplaçable.

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.

La mascotte Engineer : un sympathique robot bleu et blanc portant une cape à motifs de circuits, portant des lunettes noires et pointant vers l'extérieur des deux mains

Un seul déploiement, quatre portes d'entrée — sans qu'aucune puisse diverger des autres.

Une page qui se lit correctement sans navigateur est une page dont la structure est réelle.

Demandez-nous de vous en créer une Nos prestations

Identifiez les clients et leurs besoins

Commencez par les informations dont vos utilisateurs ont besoin et les clients par lesquels ils doivent y accéder.

Consulter les tarifs Contactez-nous

Commandez une interface textuelle utilisable

Parlons de sorties textuelles stables et d'interfaces que vos propres systèmes peuvent exploiter.

Découvrir nos prestations
welcome@engineer.company +45 50 10 61 84 Copenhague, Danemark
Code QR pour Engineer dans un terminal
Emportez cette page avec voushttps://brand.engineer.company/fr/cli/