Engineer / Støtte
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.
De offentlige sideformatene nedenfor krever ingen konto, nøkkel eller klient du må bygge selv. Kildekoden ligger i private repoer; SSH-avsnittet forklarer vilkårene for tilgang.
Hver side er også Markdown
Hver side har en HTML-versjon og ren Markdown ved siden av. Be om den 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 mdAlle språkene virker på samme måte — /about/index.md, /da/about/index.md og
/uk/about/index.md.
Ved QR-koden på hver side finner du også lenker til JSON,
gemtext og en
Gopher-meny. JSON-filen på /nb/about/index.json inneholder sidens metadata og
Markdown-innhold; /nb/feed.json er den separate porteføljefeeden. Hent
index.json direkte: Accept: application/json velger den ikke fra sidens
HTML-adresse.
Vis PDF åpner sidens PDF i en ny fane; Last ned PDF tilbyr den samme filen for nedlasting. Disse statiske filene genereres før publisering med sidens utskriftsoppsett. Lenkene bruker nettleserens innebygde funksjoner og legger ikke til JavaScript i nettleseren.
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 med Homebrew:
brew install amfora && amfora gemini://engineer.company/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 70En 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 koder inn tjenestens offentlige identitetsnøkkel. Tor autentiserer tjenesten og krypterer tilkoblingen før HTTP utveksles. 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 # AtomOg 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.txtKildekoden, over SSH
Nettstedets kildekode ligger i private repoer på git-serveren vår. Samarbeidspartnere med tillatelse får tilgang over SSH med en godkjent SSH-nøkkel:
ssh git.engineer.companyKommandoen åpner serverens grensesnitt. Hvilke repoer du kan se, avhenger av tilgangen som er gitt til SSH-nøkkelen din. Den offentlige siden på git.engineer.company beskriver tjenesten; den publiserer ikke innholdet i repoene.
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 kopi 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.