Engineer / Rådgivning
Engineer i en terminal
Læs engineer.company fra kommandolinjen: Markdown over HTTP, en Gemini-kapsel, et Gopher-hul og en onion-tjeneste — samme site, fire veje.
Dette site svarer på fire protokoller, fra én mappe med filer på én server. Arbejder du helst i en terminal, behøver du aldrig åbne en browser for at læse det.
De offentlige sideformater herunder kræver ingen konto, nøgle eller klient, du selv skal bygge. Kildekoden ligger i private repositorier; afsnittet om SSH forklarer adgangsgrænsen.
Hver side findes også som Markdown
Hver side har en HTML-version og ren Markdown ved siden af. Bed om den, du foretrækker.
# 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 mdAlle sprog virker ens — /about/index.md, /uk/about/index.md.
Ved hver sides QR-kode finder du også links til JSON,
gemtext og en
Gopher-menu. JSON-filen på /da/about/index.json indeholder sidens metadata og
Markdown-indhold; /da/feed.json er det separate porteføljefeed. Hent
index.json direkte: Accept: application/json vælger den ikke fra sidens
HTML-adresse.
Vis PDF åbner sidens PDF i en ny fane; Hent PDF tilbyder den samme fil til download. De statiske filer genereres inden udgivelsen med sidens udskriftslayout. Linkene bruger browserens indbyggede funktioner og tilføjer intet JavaScript i browseren.
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 med Homebrew:
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 manuelt, hvilket er hele protokollen på én linje:
printf '/da/contact\r\n' | nc engineer.company 70En onion-tjeneste
Samme site over Tor, for en læser, hvis netværk ikke bør vide, hvad vedkommende læser:
http://engineer2ezpeji52ipphljcflzyhetvy5r6tnqubtq45nzlxxv6rsqd.onion/Det er med vilje almindelig http://: en onion-adresse indkoder tjenestens offentlige identitetsnøgle. Tor autentificerer tjenesten og krypterer forbindelsen, før der udveksles HTTP. Kører Tor 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 har den fulde tekst af hvert punkt og ikke bare 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 # AtomOg sitet fører et kort over sig selv til alt, der læser i stedet for at 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
Sitets kildekode ligger i private repositorier på vores git-server. Samarbejdspartnere med tilladelse får adgang over SSH med en godkendt SSH-nøgle:
ssh git.engineer.companyKommandoen åbner serverens brugerflade. Hvilke repositorier du kan se, afhænger af de rettigheder, din SSH-nøgle har fået. Den offentlige side på git.engineer.company beskriver tjenesten; den offentliggør ikke repositoriernes indhold.
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 ægte og ikke malet på, og det er den samme egenskab, der får den til at læses godt i en skærmlæser og blive printet korrekt på papir. Kolofonen 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 dig.