Zum Inhalt springen

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.

  • Netzwerk, Netzwerkkabel, Kabelmanagement
    Foto: Bru-nO / Pixabay
  • Amiga, Computer, Retro
    Foto: AndrzejRembowski / Pixabay

Über den Browser hinausreichen

Machen Sie nützliche Informationen für Menschen und Werkzeuge außerhalb eines grafischen Browsers zugänglich.

Unsere Leistungen entdecken Kontakt aufnehmen

Die Textschnittstellen prüfen

Prüfen Sie die Textschnittstellen hier als Beispiele dafür, wie eine Quelle mehrere Clients erreicht.

Fallstudien Kontakt aufnehmen

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 md

Andere 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/

Inhalte, die den Browser verlassen können, für den sie geschrieben wurden, überdauern das Framework, mit dem sie erstellt wurden.

Wir entwickeln Systeme genauso: Die Daten sind der Wert, die Oberfläche ist austauschbar.

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 70

Ein 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.md

Die 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      # Atom

Auß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.txt

Der 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.company

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

Das Engineer-Maskottchen: ein freundlicher blau-weißer Roboter mit einem Umhang mit Leiterbahnmuster, der eine dunkle Brille trägt und mit beiden Händen nach außen zeigt

Eine Bereitstellung, vier Zugänge — und keiner kann von den anderen abweichen.

Eine Seite, die ohne Browser richtig lesbar ist, hat eine tragfähige Struktur.

Beauftragen Sie eine solche Website Was wir anbieten

Die Clients und ihre Bedürfnisse bestimmen

Beginnen Sie mit den Informationen, die Ihre Nutzer benötigen, und den Clients, über die sie darauf zugreifen müssen.

Preise ansehen Kontakt aufnehmen

Eine nutzbare Textschnittstelle beauftragen

Fragen Sie nach stabilen Textausgaben und Schnittstellen, die Ihre eigenen Systeme verarbeiten können.

Unsere Leistungen entdecken
welcome@engineer.company +45 50 10 61 84 Kopenhagen, Dänemark
QR-Code für Engineer im Terminal
Nehmen Sie diese Seite mithttps://advisory.engineer.company/de/cli/