端末で読むEngineer

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

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

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

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

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

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

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

```sh
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でも提供しています。

```text
gemini://engineer.company/
```

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

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

Gopherホール

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

```text
gopher://engineer.company/
```

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

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

Onionサービス

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

```text
http://engineer2ezpeji52ipphljcflzyhetvy5r6tnqubtq45nzlxxv6rsqd.onion/
```

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

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

実績をデータとして読む

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

```sh
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
```

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

```sh
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経由で閲
覧できます。

```sh
ssh git.engineer.company
```

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

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

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

ブラウザーなしでも読みやすいものをつくるのは、通常、それが適切につく
られた証拠だからです。構築をご相談ください
(パイプも終了コードも含めて)。

hこのページのウェブ版	URL:https://brand.engineer.company/ja/cli/	brand.engineer.company	70
