Engineer dans un terminal

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.

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

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

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

```sh
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.

```text
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 :

```sh
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.

```text
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.

```sh
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 :

```text
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 :

```sh
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 :

```sh
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 :

```sh
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 :

```sh
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 (tubes, codes de sortie et
tout le reste).

hCette page sur le Web	URL:https://engineer.company/fr/cli/	engineer.company	70
