Engineer i en terminal

Den här webbplatsen svarar på fyra protokoll, ur en enda mapp med
filer på en enda server. Om du bor i en terminal behöver du aldrig
öppna en webbläsare för att läsa den.

De offentliga sidformaten nedan kräver inget konto, ingen nyckel och
ingen klient som du själv måste bygga. Källkoden finns i privata
repon; SSH-avsnittet förklarar villkoren för åtkomst.

Varje sida finns också som Markdown

Varje sida har en HTML-version och ren Markdown bredvid. Be om den
du vill.

```sh
i# Tvillingen, med namn		data.engineer.company	70
curl -sL https://engineer.company/sv/about/index.md

i# Eller be servern om den och låt den välja		data.engineer.company	70
curl -sL -H 'Accept: text/markdown' https://engineer.company/sv/about/
```

Skicka det vidare till det program som renderar Markdown åt dig:

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

De andra språken fungerar likadant — `/about/index.md`,
`/da/about/index.md`, `/uk/about/index.md`.

Vid varje sidas QR-kod finns också länkar till JSON, gemtext och en
Gopher-meny. JSON-filen på `/sv/about/index.json` innehåller sidans
metadata och Markdown-innehåll; `/sv/feed.json` är det separata
portföljflödet. Hämta `index.json` direkt: `Accept:
application/json` väljer den inte från sidans HTML-adress.

Visa PDF öppnar sidans PDF i en ny flik; Hämta PDF erbjuder samma
fil för nedladdning. Dessa statiska filer genereras före publicering
med sidans utskriftslayout. Länkarna använder webbläsarens inbyggda
funktioner och lägger inte till JavaScript i webbläsaren.

En Gemini-kapsel

Gemini är ett litet protokoll med den här webbplatsens hållning
inbyggd: textdokument över TLS, inga skript, inga kakor, inget att
spåra dig med. Varje sida på den här webbplatsen finns också som
gemtext.

```text
gemini://engineer.company/
```

Vilken Gemini-klient som helst läser den — Amfora, Lagrange eller

Bombadillo i en terminal, Castor eller Kristall i ett fönster. På en
Mac med Homebrew:

```sh
brew install amfora && amfora gemini://engineer.company/
```

Ett Gopher-hål

Gopher är ett menyprotokoll från 1991 — ren TCP, ingen kryptering,
inga skript — och webbplatsen är en uppsättning menyer där, en per
katalog.

```text
gopher://engineer.company/
```

Lynx talar det direkt, och det gör även Bombadillo och gopher-cli.
Eller be om en selektor för hand, vilket är hela protokollet på en
rad:

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

En onion-tjänst

Samma webbplats över Tor, för en läsare vars nätverk inte ska veta
vad som läses:

```text
http://engineer2ezpeji52ipphljcflzyhetvy5r6tnqubtq45nzlxxv6rsqd.onion/
```

Det är vanlig `http://` med avsikt: en onion-adress kodar in
tjänstens publika identitetsnyckel. Tor autentiserar tjänsten och
krypterar anslutningen innan HTTP utväxlas. Med Tor igång lokalt når
`curl` den direkt:

```sh
ONION=engineer2ezpeji52ipphljcflzyhetvy5r6tnqubtq45nzlxxv6rsqd.onion
curl -sL --socks5-hostname 127.0.0.1:9050 "http://$ONION/sv/index.md"
```

Läsa arbetet som data

Portföljen publiceras i tre format, och vart och ett innehåller hela
texten för varje post i stället för en försmak:

```sh
curl -s https://engineer.company/sv/feed.json | jq -r '.items[] | .title'
curl -s https://engineer.company/sv/index.xml     # RSS
curl -s https://engineer.company/sv/atom.xml      # Atom
```

Och webbplatsen har en karta över sig själv för allt som läser
snarare än genomsöker:

```sh
curl -s https://engineer.company/llms.txt
curl -s https://engineer.company/humans.txt
curl -s https://engineer.company/.well-known/security.txt
```

Källkoden, över SSH

Webbplatsens källkod finns i privata repon på vår git-server.
Samarbetspartner med tillstånd får åtkomst via SSH med en godkänd
SSH-nyckel:

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

Kommandot öppnar serverns gränssnitt. Vilka repon du kan läsa beror
på den åtkomst som din SSH-nyckel har fått. Den offentliga sidan på
git.engineer.company beskriver tjänsten; den publicerar inte
innehållet i några repon.

Varför något av det här finns

En driftsättning skriver en mapp, och fyra ytterdörrar läser den —
så ingen av dem kan glida isär från de andra, och ingen av dem är en
version av webbplatsen som underhålls separat. En sida som läses bra
som gemtext är en sida vars struktur är verklig snarare än pålagd,
och det är samma egenskap som gör att den läses bra i en skärmläsare
och skrivs ut korrekt på papper. Kolofonen namnger daemonerna bakom
var och en.

Vi bygger saker som läses bra utan webbläsare, eftersom det oftast
är ett tecken på att de byggdes ordentligt — be oss bygga en åt dig
(pipes, exit-koder och allt).

hDen här sidan på webben	URL:https://data.engineer.company/sv/cli/	data.engineer.company	70
