Engineer у терміналі
Читайте engineer.company з командного рядка: Markdown через HTTP, капсула Gemini, нора Gopher та onion-сервіс — той самий сайт, чотирма способами.
Цей сайт доступний за чотирма протоколами — з однієї теки файлів на одному сервері. Якщо ви живете в терміналі, вам ніколи не доведеться відкривати браузер, щоб його читати.
Усе, що описано нижче, вже працює на живому сайті. Для жодного з цих способів не потрібен обліковий запис, ключ чи клієнт, який треба збирати самому.
Кожна сторінка існує і як Markdown
Кожну сторінку опубліковано двічі: як HTML і поруч — як чистий Markdown. Запитуйте будь-яку версію.
# Двійник, за назвою
curl -sL https://engineer.company/uk/about/index.md
# Або попросіть сервер — хай обере сам
curl -sL -H 'Accept: text/markdown' https://engineer.company/uk/about/
Перенаправте вивід у будь-яку програму, що відображає Markdown:
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.
Капсула Gemini
Gemini — невеликий протокол, у який закладено ті самі принципи, що й у цей сайт: текстові документи поверх TLS, без скриптів, без cookie, без жодних засобів стеження за вами. Кожна сторінка цього сайту також є у форматі gemtext.
gemini://engineer.company/
Її читає будь-який клієнт Gemini — Amfora, Lagrange чи Bombadillo у терміналі, Castor або Kristall у вікні. На Mac чи машині з Debian:
brew install amfora && amfora gemini://engineer.company/
Вміст, здатний покинути браузер, для якого його писали, переживе й той фреймворк, що його зібрав.
Системи ми будуємо так само: цінність — це дані, а інтерфейс можна замінити.
Нора Gopher
Gopher — протокол меню 1991 року (простий TCP, без шифрування, без скриптів), і сайт там — це набір меню, по одному на теку.
gopher://engineer.company/
Lynx підтримує його одразу, як і Bombadillo та gopher-cli. Або запитайте селектор вручну — у цьому одному рядку весь протокол:
printf '/uk/contact\r\n' | nc engineer.company 70
Onion-сервіс
Той самий сайт через Tor, для читача, чия мережа не повинна знати, що він читає:
http://engineer2ezpeji52ipphljcflzyhetvy5r6tnqubtq45nzlxxv6rsqd.onion/
Тут навмисно звичайний http://: адреса onion — це
власний відкритий ключ сервісу, тож канал автентифіковано й зашифровано ще до
першого байта HTTP, а сертифікат лише повторно засвідчив би ім’я, яке вже
засвідчує сама адреса. Якщо Tor працює локально, curl дістанеться до нього
напряму:
ONION=engineer2ezpeji52ipphljcflzyhetvy5r6tnqubtq45nzlxxv6rsqd.onion
curl -sL --socks5-hostname 127.0.0.1:9050 "http://$ONION/uk/index.md"
Читати роботу як дані
Портфоліо публікується у трьох форматах, і кожен містить повний текст кожного запису, а не анонс:
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
А ще сайт тримає карту самого себе для програм, які читають, а не сканують:
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-сервері, а git працює через SSH:
ssh git.engineer.company
Ви потрапите до списку репозиторіїв, які ми публікуємо. Вебверсія того самого — на git.engineer.company.
Навіщо все це
Одне розгортання записує одну теку, а чотири входи читають її, тож вони не можуть розійтися між собою, і жоден не є окремо підтримуваною копією сайту. Сторінка, яка добре читається як gemtext, має справжню структуру, а не намальовану зверху, — і саме завдяки цьому її добре читає зчитувач екрана і вона правильно друкується на папері. Сторінка подяк називає демонів, які обслуговують кожен вхід.
Ми будуємо речі, які добре читаються без браузера, бо зазвичай це ознака того, що їх збудовано як слід, — замовте нам таке саме.
Одне розгортання, четверо вхідних дверей — і жодні з них не розійдуться з рештою.
Сторінка, яка читається правильно без браузера, має справжню структуру.