Перейти до вмісту

Engineer у терміналі

Читайте engineer.company з командного рядка: Markdown через HTTP, капсула Gemini, нора Gopher та onion-сервіс — той самий сайт, чотирма способами.

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

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

  • Мережа, мережевий кабель, керування
    Фото: Bru-nO / Pixabay
  • Amiga, комп'ютер, ретро
    Фото: 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 70

Onion-сервіс

Той самий сайт через 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, має справжню структуру, а не намальовану зверху, — і саме завдяки цьому її добре читає зчитувач екрана і вона правильно друкується на папері. Сторінка подяк називає демонів, які обслуговують кожен вхід.

Ми будуємо речі, які добре читаються без браузера, бо зазвичай це ознака того, що їх збудовано як слід, — замовте нам таке саме.

Маскот Engineer: доброзичливий синьо-білий робот у плащі з друкованими доріжками, у темних окулярах, показує руками в різні боки

Одне розгортання, четверо вхідних дверей — і жодні з них не розійдуться з рештою.

Сторінка, яка читається правильно без браузера, має справжню структуру.

Замовте таке саме Що ми пропонуємо

Визначте клієнтські програми та їхні потреби

Почніть з інформації, потрібної користувачам, і клієнтів, через які вони її отримують.

Дивитися, скільки це коштує Зв'язатися з нами

Замовте придатний текстовий інтерфейс

Запитайте про стабільні текстові формати та інтерфейси для ваших систем.

Переглянути наші послуги
welcome@engineer.company +45 50 10 61 84 Копенгаген, Данія
QR-код сторінки «Engineer у терміналі»
Візьміть цю сторінку із собоюhttps://software.engineer.company/uk/cli/