Engineer i en terminal

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.

```sh
i# Tvillingen, ved navn		advisory.engineer.company	70
curl -sL https://engineer.company/nb/about/index.md

i# Eller be serveren om den og la den velge		advisory.engineer.company	70
curl -sL -H 'Accept: text/markdown' https://engineer.company/nb/about/
```

Send den gjennom en pipe til det som viser Markdown for deg:

```sh
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.

```text
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:

```sh
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.

```text
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:

```sh
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:

```text
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:

```sh
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:

```sh
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:

```sh
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:

```sh
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 (pipes,
exit-koder og alt).

hDenne siden på nettet	URL:https://advisory.engineer.company/nb/cli/	advisory.engineer.company	70
