Hopp til innhold
EngineerMerkevare
Meny
Design
Norsk bokmål

Engineer / Merkevare

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 md

Alle 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 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 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      # 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 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.company

Kommandoen å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.

Kontakt

Avklarer dere fortsatt hva dere trenger?

Fortell oss hva som går galt, eller hva dere prøver å bygge. Vi sier hva det vil kreve, omtrent hva det vil koste, og om vi er de rette til oppgaven.

Fra 1 400 DKK timen, eksklusive mva. — og mindre per time ved et lengre oppdrag.

welcome@engineer.company +45 50 10 61 84 København, Danmark