Engineer у терміналі

Цей сайт доступний за чотирма протоколами — з однієї теки файлів на
одному сервері. Якщо ви живете в терміналі, вам ніколи не доведеться
відкривати браузер, щоб його читати.

Публічні формати сайту нижче не потребують облікового запису, ключа
чи клієнта, який треба збирати самому. Репозиторії вихідного коду
приватні; умови доступу описано в розділі про SSH.

Кожна сторінка існує і як Markdown

Кожна сторінка має HTML-версію та чистий Markdown поруч. Запитуйте
будь-яку версію.

```sh
i# Двійник, за назвою		advisory.engineer.company	70
curl -sL https://engineer.company/uk/about/index.md

i# Або попросіть сервер — хай обере сам		advisory.engineer.company	70
curl -sL -H 'Accept: text/markdown' https://engineer.company/uk/about/
```

Перенаправте вивід у будь-яку програму, що відображає Markdown:

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

Усі мови працюють однаково — `/about/index.md`,
`/da/about/index.md`.

Біля QR-коду кожної сторінки також є посилання на JSON, gemtext і
меню Gopher. JSON-файл за адресою `/uk/about/index.json` містить
метадані цієї сторінки та її вміст у Markdown; `/uk/feed.json` —
окрема стрічка портфоліо. Запитуйте `index.json` безпосередньо:
заголовок `Accept: application/json` не обирає його за HTML-адресою
сторінки.

Переглянути PDF відкриває PDF сторінки в новій вкладці;

Завантажити PDF пропонує той самий файл для збереження. Ці статичні
файли генеруються перед публікацією за друкованим макетом сторінки.
Посилання використовують вбудовані засоби браузера й не додають
JavaScript у браузері.

Капсула Gemini

Gemini — невеликий протокол, у який закладено ті самі принципи, що й
у цей сайт: текстові документи поверх TLS, без скриптів, без cookie,
без жодних засобів стеження за вами. Кожна сторінка цього сайту
також є у форматі gemtext.

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

Її читає будь-який клієнт Gemini — Amfora, Lagrange чи Bombadillo у
терміналі, Castor або Kristall у вікні. На Mac із Homebrew:

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

Нора Gopher

Gopher — протокол меню 1991 року (простий TCP, без шифрування, без
скриптів), і сайт там — це набір меню, по одному на теку.

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

Lynx підтримує його одразу, як і Bombadillo та gopher-cli. Або
запитайте селектор вручну — у цьому одному рядку весь протокол:

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

Onion-сервіс

Той самий сайт через Tor, для читача, чия мережа не повинна знати,
що він читає:

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

Тут навмисно звичайний `http://`: адреса onion містить закодований
відкритий ключ ідентифікації сервісу. Tor перевіряє справжність
сервісу й шифрує з'єднання ще до обміну HTTP. Якщо Tor працює
локально, `curl` дістанеться до нього напряму:

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

Читати роботу як дані

Портфоліо публікується у трьох форматах, і кожен містить повний
текст кожного запису, а не анонс:

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

А ще сайт тримає карту самого себе для програм, які читають, а не
сканують:

```sh
curl -s https://engineer.company/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://advisory.engineer.company/uk/cli/	advisory.engineer.company	70
