Engineer im Terminal
engineer.company auf der Kommandozeile: Markdown über HTTP, Gemini-Kapsel, Gopher-Menü und Onion-Dienst — dieselbe Website auf vier Wegen.
Diese Website antwortet über vier Protokolle aus einem einzigen Dateiordner auf einem Server. Wenn Sie im Terminal zu Hause sind, brauchen Sie zum Lesen nie einen Browser zu öffnen.
Die unten beschriebenen öffentlichen Websiteformate benötigen weder Konto noch Schlüssel noch einen selbst zu kompilierenden Client. Die Quellcode-Repositories sind privat; der SSH-Abschnitt erläutert die Zugangsbedingungen.
Jede Seite gibt es auch als Markdown
Jede Seite gibt es als HTML und daneben als sauberes Markdown. Fordern Sie das gewünschte Format an.
# The twin, by name
curl -sL https://engineer.company/about/index.md
# Or ask the server for it and let it choose
curl -sL -H 'Accept: text/markdown' https://engineer.company/about/Leiten Sie es an Ihr bevorzugtes Markdown-Anzeigeprogramm weiter:
curl -sL https://engineer.company/portfolio/index.md | glow -
curl -sL https://engineer.company/what-it-costs/index.md | bat -l mdAndere Sprachen funktionieren genauso — /da/about/index.md, /uk/about/index.md.
Neben dem QR-Code jeder Seite führen die Formatlinks auch zu JSON, Gemtext und einem Gopher-Menü. Das JSON unter /de/about/index.json enthält die Metadaten und den Markdown-Inhalt dieser Seite; /de/feed.json ist der separate Portfolio-Feed. Fordern Sie index.json direkt an: Mit Accept: application/json erhalten Sie es nicht über die HTML-URL.
PDF ansehen öffnet die PDF-Datei der Seite in einem neuen Tab; PDF herunterladen bietet dieselbe Datei zum Download an. Diese statischen Dateien werden vor der Veröffentlichung mit dem Drucklayout der Seite erzeugt. Die Links verwenden die eingebauten Bedienelemente des Browsers und fügen kein JavaScript für den Browser hinzu.
Eine Gemini-Kapsel
Gemini ist ein kleines Protokoll, dessen Grundgedanken zu dieser Website passen: Textdokumente über TLS, keine Skripte, keine Cookies, nichts zum Verfolgen Ihrer Aktivitäten. Jede Seite dieser Website existiert auch als Gemtext.
gemini://engineer.company/Jeder Gemini-Client kann sie lesen — Amfora, Lagrange oder Bombadillo im Terminal, Castor oder Kristall in einem Fenster. Auf einem Mac mit Homebrew:
brew install amfora && amfora gemini://engineer.company/Ein Gopher-Menü
Gopher ist ein Menüprotokoll von 1991 — einfaches TCP, keine Verschlüsselung, keine Skripte. Die Website besteht dort aus Menüs, eines je Verzeichnis.
gopher://engineer.company/Lynx unterstützt es ohne zusätzliche Einrichtung, ebenso Bombadillo und gopher-cli. Oder fordern Sie einen Selektor von Hand an — das gesamte Protokoll in einer Zeile:
printf '/contact\r\n' | nc engineer.company 70Ein Onion-Dienst
Dieselbe Website über Tor, wenn Ihr Netzwerk nicht wissen soll, was Sie lesen:
http://engineer2ezpeji52ipphljcflzyhetvy5r6tnqubtq45nzlxxv6rsqd.onion/Das einfache http:// ist Absicht: Eine Onion-Adresse kodiert den öffentlichen Identitätsschlüssel des Dienstes. Tor authentifiziert den Dienst und verschlüsselt die Verbindung, bevor HTTP ausgetauscht wird. Wenn Tor lokal läuft, erreicht curl sie direkt:
curl -sL --socks5-hostname 127.0.0.1:9050 \
http://engineer2ezpeji52ipphljcflzyhetvy5r6tnqubtq45nzlxxv6rsqd.onion/index.mdDie Arbeiten als Daten lesen
Das Portfolio wird in drei Feedformaten verbreitet, jeweils mit dem vollständigen Text jedes Eintrags statt eines Anreißers:
curl -s https://engineer.company/feed.json | jq -r '.items[] | .title'
curl -s https://engineer.company/index.xml # RSS
curl -s https://engineer.company/atom.xml # AtomAußerdem hält die Website eine Karte für alles bereit, was liest statt crawlt:
curl -s https://engineer.company/llms.txt
curl -s https://engineer.company/humans.txt
curl -s https://engineer.company/.well-known/security.txtDer Quellcode über SSH
Der Quellcode dieser Website liegt in privaten Repositories auf unserem Git-Server. Berechtigte Mitwirkende greifen über SSH mit einem zugelassenen SSH-Schlüssel darauf zu:
ssh git.engineer.companyDer Befehl öffnet die Serveroberfläche. Welche Repositories Sie einsehen können, hängt von den Ihrem SSH-Schlüssel gewährten Zugriffsrechten ab. Die öffentliche Seite unter git.engineer.company beschreibt den Dienst; sie veröffentlicht keine Repositoryinhalte.
Warum es das alles gibt
Eine Bereitstellung schreibt einen Ordner, und vier Zugangswege lesen daraus. Keiner kann deshalb von den anderen abweichen; keiner ist eine gesondert gepflegte Kopie der Website. Eine als Gemtext gut lesbare Seite besitzt eine echte, nicht nur optisch aufgemalte Struktur. Dieselbe Eigenschaft macht sie für Screenreader gut lesbar und auf Papier korrekt druckbar. Die Quellenseite nennt die zugehörigen Daemons.
Wir entwickeln Dinge, die auch ohne Browser gut lesbar sind, weil das meist für einen ordentlichen Aufbau spricht — lassen Sie uns etwas für Sie entwickeln.