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

Фото: Bru-nO / Pixabay 
Фото: AndrzejRembowski / Pixabay
Вийдіть за межі браузера
Зробіть корисну інформацію доступною людям та інструментам поза графічним браузером.
Перевірте текстові інтерфейси
Розгляньте текстові інтерфейси тут як приклади одного джерела для різних клієнтів.
Кожна сторінка існує і як 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.
Біля 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.
gemini://engineer.company/Її читає будь-який клієнт Gemini — Amfora, Lagrange чи Bombadillo у терміналі, Castor або Kristall у вікні. На Mac із Homebrew:
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 70Onion-сервіс
Той самий сайт через Tor, для читача, чия мережа не повинна знати, що він читає:
http://engineer2ezpeji52ipphljcflzyhetvy5r6tnqubtq45nzlxxv6rsqd.onion/Тут навмисно звичайний http://: адреса onion містить
закодований відкритий ключ ідентифікації сервісу. Tor перевіряє справжність
сервісу й шифрує з’єднання ще до обміну 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-сервері. Учасники, яким надано доступ, користуються SSH із дозволеним SSH-ключем:
ssh git.engineer.companyКоманда відкриває інтерфейс сервера. Репозиторії, які ви можете переглядати, залежать від прав, наданих вашому SSH-ключу. Публічна сторінка git.engineer.company описує сервіс, але не публікує вміст репозиторіїв.
Навіщо все це
Одне розгортання записує одну теку, а чотири входи читають її, тож вони не можуть розійтися між собою, і жоден не є окремо підтримуваною копією сайту. Сторінка, яка добре читається як gemtext, має справжню структуру, а не намальовану зверху, — і саме завдяки цьому її добре читає зчитувач екрана і вона правильно друкується на папері. Сторінка подяк називає демонів, які обслуговують кожен вхід.
Ми будуємо речі, які добре читаються без браузера, бо зазвичай це ознака того, що їх збудовано як слід, — замовте нам таке саме.

Одне розгортання, четверо вхідних дверей — і жодні з них не розійдуться з рештою.
Сторінка, яка читається правильно без браузера, має справжню структуру.

