# 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
# Tvillingen, med namn
curl -sL https://engineer.company/sv/about/index.md

# Eller be servern om den och låt den välja
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).

=> /sv/glossary/#gemtext gemtext
=> /sv/glossary/#tor Tor
=> /sv/glossary/#onion onion
=> https://git.engineer.company/ git.engineer.company
=> /sv/credits/ Kolofonen
=> /sv/contact/ be oss bygga en åt dig

=> https://engineer.company/sv/cli/ Den här sidan på webben
