本文へ移動
Engineerソフトウェア
メニュー
デザイン
日本語

Engineer / ソフトウェア

端末で読むEngineer

コマンドラインからengineer.companyを読む方法をご案内します。HTTPのMarkdown、Gemini、Gopher、Onionサービスの四つの入り口があります。

このサイトは、一台のサーバーの一つのフォルダーにあるファイルを、四つのプロトコルで提供しています。端末を中心に使う方は、ブラウザーを開かずにお読みいただけます。

以下の公開サイトの形式は、アカウントや鍵、自分でビルドしたクライアントなしで読めます。ソースリポジトリは非公開です。アクセスの条件はSSHの節で説明しています。

すべてのページにMarkdown版もあります

各ページはHTML版で提供し、その隣に整ったMarkdown版も用意しています。どちらでも取得できます。

# ファイル名を指定してMarkdown版を取得
curl -sL https://engineer.company/ja/about/index.md

# AcceptヘッダーでMarkdown形式を指定
curl -sL -H 'Accept: text/markdown' https://engineer.company/ja/about/

お使いのMarkdown表示ツールに、パイプで渡してください。

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

他の言語も同じ仕組みです。/da/about/index.md、/uk/about/index.mdから取得できます。

各ページのQRコードの横には、JSON、gemtext、Gopherメニューへのリンクもあります。/ja/about/index.jsonのJSONには、そのページのメタデータとMarkdownの本文が含まれます。/ja/feed.jsonは、それとは別のポートフォリオ用フィードです。index.jsonを直接指定してください。HTMLのURLへのリクエストにAccept: application/jsonヘッダーを付けても、このJSONは選択されません。

PDFを表示を選ぶと、ページのPDFが新しいタブで開きます。PDFをダウンロードでは、同じファイルをダウンロードできます。これらは、公開前にページの印刷レイアウトから生成する静的ファイルです。リンクはブラウザー標準の操作機能を使い、ブラウザーで実行するJavaScriptは追加しません。

Geminiカプセル

Geminiは、このサイトと同じ考え方を備えた小さなプロトコルです。TLS上でテキスト文書を提供し、スクリプトもCookieも、利用者を追跡するものもありません。このサイトの全ページは、gemtextでも提供しています。

gemini://engineer.company/

どのGeminiクライアントでも読めます。端末ではAmfora、Lagrange、Bombadillo、ウインドウではCastorやKristallを使えます。Homebrewを使うMacでは、次のように開けます。

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

Gopherホール

Gopherは1991年のメニュープロトコルです。暗号化やスクリプトのない単純なTCPを使います。このサイトは、ディレクトリごとに一つのメニューとして提供されます。

gopher://engineer.company/

Lynxはそのまま対応しており、Bombadilloとgopher-cliも利用できます。手動でセレクターを要求することもできます。これがプロトコルの全体を一行で表したものです。

printf '/ja/contact\r\n' | nc engineer.company 70

Onionサービス

利用するネットワークに何を読んでいるか知られたくない方のために、同じサイトをTorでも提供しています。

http://engineer2ezpeji52ipphljcflzyhetvy5r6tnqubtq45nzlxxv6rsqd.onion/

意図的に単なるhttp://を使っています。Onionアドレスには、サービスの識別用公開鍵が符号化されています。HTTPをやり取りする前に、Torがサービスを認証し、接続を暗号化します。ローカルでTorが動いていれば、curlで直接取得できます。

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

実績をデータとして読む

実績は三つのフィード形式で配信しています。いずれも抜粋ではなく、各項目の全文を含みます。

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

また、クロールではなく読み取りを行うもののために、サイト自身の案内も用意しています。

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

SSHでソースを読む

このサイトのソースは、自社のGitサーバーの非公開リポジトリで管理しています。アクセスを許可された方は、承認済みのSSH鍵を使ってSSH経由で閲覧できます。

ssh git.engineer.company

このコマンドでサーバーの画面を開きます。閲覧できるリポジトリは、SSH鍵に与えられた権限によって異なります。git.engineer.companyの公開ページは、サービスを説明するもので、リポジトリの内容を公開するものではありません。

こうした入り口を用意する理由

一度のデプロイで一つのフォルダーを書き出し、四つの入り口がそれを読みます。内容が互いにずれることも、別々に保守するサイトのコピーになることもありません。gemtextで読みやすいページには、見た目だけではない本物の構造があります。同じ性質が、スクリーンリーダーでの読みやすさと、紙への正しい印刷にもつながります。それぞれを提供するデーモンは、クレジットに記載しています。

ブラウザーなしでも読みやすいものをつくるのは、通常、それが適切につくられた証拠だからです。構築をご相談ください。

お問い合わせ

必要なことを整理している段階ですか?

うまくいっていないことや、つくりたいものをお聞かせください。何が必要か、おおよそいくらかかるか、私たちが適任かどうかをお伝えします。

時間単価は1,400 DKKから(VAT別)で、ご依頼期間が長いほど下がります。

welcome@engineer.company +45 50 10 61 84 デンマーク、コペンハーゲン