# 端末で読むEngineer

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

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

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

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

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

# AcceptヘッダーでMarkdown形式を指定
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](/ja/glossary/#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](/ja/glossary/#tor)でも提供しています。

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

意図的に単なる`http://`を使っています。[Onion](/ja/glossary/#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](https://git.engineer.company/)の公開ページは、サービスを説明するもので、リポジトリの内容を公開するものではありません。

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

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

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

<https://engineer.company/ja/cli/>
