Engineer i en terminal

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.

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

i# Eller bed serveren om den og lad den vælge		ditte.engineer.company	70
curl -sL -H 'Accept: text/markdown' https://engineer.company/da/about/
```

Send det videre til det, der gengiver Markdown for dig:

```sh
curl -sL https://engineer.company/da/portfolio/index.md | glow -
curl -sL https://engineer.company/da/what-it-costs/index.md | bat -l md
```

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

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

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

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

```sh
printf '/da/contact\r\n' | nc engineer.company 70
```

En onion-tjeneste

Samme site over Tor, for en læser, hvis netværk ikke bør vide, hvad
vedkommende læser:

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

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

```sh
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      # Atom
```

Og sitet fører et kort over sig selv til alt, der læser i stedet for
at 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

Sitets kildekode ligger i private repositorier på vores git-server.
Samarbejdspartnere med tilladelse får adgang over SSH med en
godkendt SSH-nøgle:

```sh
ssh git.engineer.company
```

Kommandoen å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
(pipes, exit-koder og det hele).

hDenne side på nettet	URL:https://ditte.engineer.company/da/cli/	ditte.engineer.company	70
