Engineer i en terminal
Les engineer.company fra kommandolinjen: Markdown over HTTP, en Gemini-kapsel, et Gopher-hull og en onion-tjeneste — samme nettsted, fire veier.
Dette nettstedet svarer på fire protokoller, fra én mappe med filer på én server. Holder du helst til i en terminal, trenger du aldri å åpne en nettleser for å lese det.
Alt nedenfor virker i dag, mot nettstedet i drift. Ingenting krever en konto, en nøkkel eller en klient du må bygge selv.
Hver side er også Markdown
Hver side publiseres to ganger: som HTML og som ren Markdown ved siden av. Be om hvilken du vil.
# Tvillingen, ved navn
curl -sL https://engineer.company/nb/about/index.md
# Eller be serveren om den og la den velge
curl -sL -H 'Accept: text/markdown' https://engineer.company/nb/about/
Send den gjennom en pipe til det som viser Markdown for deg:
curl -sL https://engineer.company/nb/portfolio/index.md | glow -
curl -sL https://engineer.company/nb/what-it-costs/index.md | bat -l md
Alle språkene virker på samme måte — /about/index.md, /da/about/index.md og
/uk/about/index.md.
En Gemini-kapsel
Gemini er en liten protokoll med dette nettstedets holdninger bygd inn: tekstdokumenter over TLS, ingen skripting, ingen informasjonskapsler, ingenting å spore deg med. Hver side på dette nettstedet finnes også som gemtext.
gemini://engineer.company/
Enhver Gemini-klient kan lese det — Amfora, Lagrange eller Bombadillo i en terminal, Castor eller Kristall i et vindu. På en Mac eller en Debian-maskin:
brew install amfora && amfora gemini://engineer.company/
Innhold som kan forlate nettleseren det ble skrevet for, overlever rammeverket som bygde det.
Vi bygger systemer på samme måte: dataene er verdien, grensesnittet kan byttes ut.
Et Gopher-hull
Gopher er en menyprotokoll fra 1991 — ren TCP, ingen kryptering, ingen skripting — og der er nettstedet et sett med menyer, én per mappe.
gopher://engineer.company/
Lynx snakker det rett ut av boksen, og det gjør også Bombadillo og gopher-cli. Eller be om en selektor for hånd, som er hele protokollen på én linje:
printf '/nb/contact\r\n' | nc engineer.company 70
En onion-tjeneste
Det samme nettstedet over Tor, for en leser hvis nettverk ikke skal vite hva som leses:
http://engineer2ezpeji52ipphljcflzyhetvy5r6tnqubtq45nzlxxv6rsqd.onion/
Det er vanlig http:// med vilje: en onion-adresse er
tjenestens egen offentlige nøkkel, så kretsen er autentisert og kryptert før det
i det hele tatt snakkes HTTP, og et sertifikat ville bare bevise på nytt et navn
som adressen allerede har bevist. Kjører Tor lokalt, når curl den direkte:
ONION=engineer2ezpeji52ipphljcflzyhetvy5r6tnqubtq45nzlxxv6rsqd.onion
curl -sL --socks5-hostname 127.0.0.1:9050 "http://$ONION/nb/index.md"
Å lese arbeidet som data
Porteføljen publiseres i tre formater, og hvert av dem inneholder hele teksten i hvert punkt, ikke bare en smakebit:
curl -s https://engineer.company/nb/feed.json | jq -r '.items[] | .title'
curl -s https://engineer.company/nb/index.xml # RSS
curl -s https://engineer.company/nb/atom.xml # Atom
Og nettstedet har et kart over seg selv for alt som leser i stedet for å crawle:
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
Nettstedets egen kildekode ligger på git-serveren vår, og git snakker SSH:
ssh git.engineer.company
Da havner du i en liste over repoene vi publiserer, som du kan bla gjennom. Nettutgaven av det samme finnes på git.engineer.company.
Hvorfor alt dette finnes
Én produksjonssetting skriver én mappe, og fire inngangsdører leser den — så ingen av dem kan gli fra de andre, og ingen av dem er en portering av nettstedet som vedlikeholdes separat. En side som leses godt som gemtext, er en side der strukturen er ekte og ikke malt på, og det er den samme egenskapen som gjør at den leses godt i en skjermleser og skrives riktig ut på papir. Kolofonen navngir daemonene bak hver av dem.
Vi bygger ting som leses godt uten nettleser, fordi det som regel er et tegn på at de er bygd ordentlig — be oss bygge en til deg.
Én utrulling, fire inngangsdører — og ingen av dem kan komme i utakt med de andre.
En side som leses riktig uten nettleser, er en side der strukturen er ekte.