Hoppa till innehållet
EngineerRådgivning
Meny
Design
Svenska

Engineer / Rådgivning

Engineer i en terminal

Läs engineer.company från kommandoraden: Markdown över HTTP, en Gemini-kapsel, ett Gopher-hål och en onion-tjänst — samma webbplats på fyra sätt.

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.

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

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.

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:

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.

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:

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:

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:

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:

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:

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:

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.

Kontakt

Håller ni fortfarande på att reda ut vad ni behöver?

Berätta vad som inte fungerar eller vad ni försöker bygga. Vi säger vad det skulle kräva, ungefär vad det skulle kosta och om vi är rätt personer för uppgiften.

Från 1 400 DKK i timmen, exklusive moms — och mindre per timme vid en längre bokning.

welcome@engineer.company +45 50 10 61 84 Köpenhamn, Danmark