# 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
# 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:

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

=> /nb/glossary/#gemtext gemtext
=> /nb/glossary/#tor Tor
=> /nb/glossary/#onion onion
=> https://git.engineer.company/ git.engineer.company
=> /nb/credits/ Kolofonen
=> /nb/contact/ be oss bygge en til deg

=> https://engineer.company/nb/cli/ Denne siden på nettet
