Engineer i en terminal
Läs engineer.company från kommandoraden: Markdown över HTTP, en Gemini-kapsel, ett Gopher-hål och en onion-tjänst — samma webbplats på fyra sätt.
Den här webbplatsen svarar på fyra protokoll, ur en enda mapp med filer på en enda server. Om du bor i en terminal behöver du aldrig öppna en webbläsare för att läsa den.
Allt nedan fungerar i dag, mot den publicerade webbplatsen. Inget kräver ett konto, en nyckel eller en klient som du själv måste bygga.
Varje sida finns också som Markdown
Varje sida publiceras två gånger: som HTML och som ren Markdown bredvid. Be om vilken du vill.
# Tvillingen, med namn
curl -sL https://engineer.company/sv/about/index.md
# Eller be servern om den och låt den välja
curl -sL -H 'Accept: text/markdown' https://engineer.company/sv/about/
Skicka det vidare till det program som renderar Markdown åt dig:
curl -sL https://engineer.company/sv/portfolio/index.md | glow -
curl -sL https://engineer.company/sv/what-it-costs/index.md | bat -l md
De andra språken fungerar likadant — /about/index.md, /da/about/index.md,
/uk/about/index.md.
En Gemini-kapsel
Gemini är ett litet protokoll med den här webbplatsens hållning inbyggd: textdokument över TLS, inga skript, inga kakor, inget att spåra dig med. Varje sida på den här webbplatsen finns också som gemtext.
gemini://engineer.company/
Vilken Gemini-klient som helst läser den — Amfora, Lagrange eller Bombadillo i en terminal, Castor eller Kristall i ett fönster. På en Mac eller en Debian-maskin:
brew install amfora && amfora gemini://engineer.company/
Innehåll som kan lämna webbläsaren det skrevs för överlever ramverket som byggde det.
Vi bygger system på samma sätt: data är värdet, gränssnittet går att byta ut.
Ett Gopher-hål
Gopher är ett menyprotokoll från 1991 — ren TCP, ingen kryptering, inga skript — och webbplatsen är en uppsättning menyer där, en per katalog.
gopher://engineer.company/
Lynx talar det direkt, och det gör även Bombadillo och gopher-cli. Eller be om en selektor för hand, vilket är hela protokollet på en rad:
printf '/sv/contact\r\n' | nc engineer.company 70
En onion-tjänst
Samma webbplats över Tor, för en läsare vars nätverk inte ska veta vad som läses:
http://engineer2ezpeji52ipphljcflzyhetvy5r6tnqubtq45nzlxxv6rsqd.onion/
Det är vanlig http:// med avsikt: en onion-adress är
tjänstens egen publika nyckel, så kretsen är autentiserad och krypterad innan
något HTTP alls talas, och ett certifikat skulle bara bevisa på nytt ett namn
som adressen redan har bevisat. Med Tor igång lokalt når curl den direkt:
ONION=engineer2ezpeji52ipphljcflzyhetvy5r6tnqubtq45nzlxxv6rsqd.onion
curl -sL --socks5-hostname 127.0.0.1:9050 "http://$ONION/sv/index.md"
Läsa arbetet som data
Portföljen publiceras i tre format, och vart och ett innehåller hela texten för varje post i stället för en försmak:
curl -s https://engineer.company/sv/feed.json | jq -r '.items[] | .title'
curl -s https://engineer.company/sv/index.xml # RSS
curl -s https://engineer.company/sv/atom.xml # Atom
Och webbplatsen håller en karta över sig själv för allt som läser snarare än genomsöker:
curl -s https://engineer.company/llms.txt
curl -s https://engineer.company/humans.txt
curl -s https://engineer.company/.well-known/security.txt
Källkoden, över SSH
Webbplatsens egen källkod finns på vår git-server, och git talar SSH:
ssh git.engineer.company
Då hamnar du i en bläddringsbar lista över de repon vi publicerar. Webbvyn av samma sak finns på git.engineer.company.
Varför något av det här finns
En driftsättning skriver en mapp, och fyra ytterdörrar läser den — så ingen av dem kan glida isär från de andra, och ingen av dem är en version av webbplatsen som underhålls separat. En sida som läses bra som gemtext är en sida vars struktur är verklig snarare än pålagd, och det är samma egenskap som gör att den läses bra i en skärmläsare och skrivs ut korrekt på papper. Kolofonen namnger daemonerna bakom var och en.
Vi bygger saker som läses bra utan webbläsare, eftersom det oftast är ett tecken på att de byggdes ordentligt — be oss bygga en åt dig.
En driftsättning, fyra ytterdörrar — och ingen av dem kan glida från de andra.
En sida som läses rätt utan webbläsare är en sida vars struktur är äkta.