Engineer i en terminal

Dette site svarer på fire protokoller, ud af én mappe med filer på én server. Bor du i en terminal, behøver du aldrig åbne en browser for at læse det.

Alt herunder virker i dag mod det levende site. Intet kræver en konto, en nøgle eller en klient, du selv skal bygge.

Hver side findes også som Markdown

Hver side udgives to gange: som HTML og som ren Markdown ved siden af. Bed om hvilken som helst af dem.

# Tvillingen, ved navn
curl -sL https://engineer.company/da/about/index.md

# Eller bed serveren om den og lad den vælge
curl -sL -H 'Accept: text/markdown' https://engineer.company/da/about/

Send det videre til det, der gengiver Markdown for dig:

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

Alle sprog virker ens — /about/index.md, /uk/about/index.md.

En Gemini-kapsel

Gemini er en lille protokol med samme sans for tingene som dette site: tekstdokumenter over TLS, ingen scripting, ingen cookies, intet at spore dig med. Hver side på dette site findes også som gemtext.

gemini://engineer.company/

Enhver Gemini-klient læser det — Amfora, Lagrange eller Bombadillo i en terminal, Castor eller Kristall i et vindue. På en Mac eller en Debian-maskine:

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

Et Gopher-hul

Gopher er en menuprotokol fra 1991 — ren TCP, ingen kryptering, ingen scripting — og sitet er et sæt menuer dér, én pr. mappe.

gopher://engineer.company/

Lynx taler det uden videre, og det samme gør Bombadillo og gopher-cli. Eller bed om en selector i hånden, hvilket er hele protokollen på én linje:

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

En onion-tjeneste

Samme site over Tor, for en læser hvis netværk ikke bør vide, hvad der læses:

http://engineer2ezpeji52ipphljcflzyhetvy5r6tnqubtq45nzlxxv6rsqd.onion/

Det er med vilje almindelig http://: en onion-adresse er tjenestens egen offentlige nøgle, så forbindelsen er godkendt og krypteret, før der overhovedet tales HTTP, og et certifikat ville kun bevise et navn, adressen allerede har bevist. Med Tor kørende lokalt når curl den direkte:

ONION=engineer2ezpeji52ipphljcflzyhetvy5r6tnqubtq45nzlxxv6rsqd.onion
curl -sL --socks5-hostname 127.0.0.1:9050 "http://$ONION/da/index.md"

At læse arbejdet som data

Porteføljen udgives i tre formater, som hver bærer den fulde tekst af hvert punkt frem for en smagsprøve:

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

Og sitet fører et kort over sig selv til alt, der læser frem for at kravle:

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

Kildekoden, over SSH

Sitets egen kildekode ligger på vores git-server, og git taler SSH:

ssh git.engineer.company

Det lander dig i en liste over de arkiver, vi offentliggør. Webudgaven af det samme findes på git.engineer.company.

Hvorfor noget af det findes

Én udrulning skriver én mappe, og fire hoveddøre læser den — så ingen af dem kan komme ud af trit med de andre, og ingen af dem er en version af sitet, der vedligeholdes for sig. En side, der læses godt som gemtext, er en side, hvis struktur er virkelig frem for malet på, og det er den samme egenskab, der får den til at læses godt i en skærmlæser og printe rigtigt på papir. Tak-siden nævner de dæmoner, der står bag hver enkelt.

Vi bygger ting, der læses godt uden en browser, fordi det som regel er et tegn på, at de er bygget ordentligt — bed os bygge en til jer.