{"canonical_url":"https://engineer.company/uk/glossary/gemtext/","content_markdown":"# gemtext\n\n## Що це таке\n\nGemtext — це формат документів протоколу Gemini: звичайний текст у UTF-8, де перші символи\nкожного рядка визначають, чим цей рядок є, тож клієнт може показати всю сторінку за один прохід\nзгори донизу. Специфікація називає його гіпертекстовим форматом Gemini (the Gemini hypertext\nformat), сервери позначають його типом носія `text/gemini`, а файли зазвичай мають розширення\n`.gmi`.\n\nРядків буває шість видів. Рядок, що починається з `=\u003e`, — це посилання: адреса, абсолютна чи\nвідносна, і за нею необов'язковий підпис. Рядок із трьох зворотних лапок (backticks) вмикає або\nвимикає режим попередньо форматованого тексту, і все між двома такими рядками показується точно\nтак, як написано, моноширинним шрифтом. Один, два чи три символи решітки дають заголовок, зірочка\nз пробілом дає пункт списку, а знак «більше» дає цитату. Усі інші рядки є звичайним текстом, і\nклієнт переносить його за шириною того екрана, на який він потрапить.\n\n```text\n# Польові нотатки\n\nТекстовий рядок — це абзац, хоч який довгий. Клієнт його переносить.\n\n=\u003e /archive/ Старіші нотатки\n=\u003e gemini://example.org/ Капсула деінде\n\n* Пункт списку\n\u003e Цитований рядок\n```\n\nСпецифікація ділить ці шість на три основні типи, які мусить обробляти кожен клієнт (текст,\nпосилання і перемикач попередньо форматованого тексту), і три, які мінімальний клієнт може\nпоказувати як звичайний текст. На цьому формат і закінчується. У ньому немає жирного шрифту й\nкурсиву, таблиць, зображень усередині тексту, вкладеності та способу зробити клікабельним слово\nпосеред речення. Парсер тримає в пам'яті один-єдиний біт стану: чи перебуває він усередині\nпопередньо форматованого блоку.\n\nGemtext найчастіше порівнюють із Markdown, на який він на перший погляд схожий. Різниця в тому,\nдля чого кожен із них існує. Файл Markdown — це вихідний текст, написаний для того, щоб його\nперетворили на щось інше; файл gemtext — уже готовий документ, і показує його тільки клієнт\nчитача. Свою єдину структурну звичку, посилання в окремому рядку, формат успадкував від старших\nменю Gopher.\n\n## Чому це важливо\n\nОбрати gemtext означає обрати, хто керує сторінкою. Автор визначає структуру: які рядки є\nзаголовками, які посиланнями і де стоїть код. Клієнт читача визначає решту, від шрифту й довжини\nрядка до кольорів, відступів і того, чи стануть заголовки змістом. Специфікація прямо каже, що\nформат не призначений давати авторові точний контроль над виглядом. Для одних видавців це\nполегшення, для інших кінець розмови, і краще знати, котрий випадок ваш, ще до конвертації першої\nсторінки.\n\nПолегшення полягає в тому, що зникає. Сторінка gemtext не має ні таблиці стилів, ні скрипту, ні\nвебшрифту, ні банера про cookies, ні пікселя стеження, і доглядати в ній треба лише слова.\nСторінки маленькі, і їх швидко писати вручну. Посилання ніколи нічого не завантажують самі:\nспецифікація забороняє клієнтові відкривати мережеве з'єднання тільки для того, щоб показати\nпосилання, тож сторінка не може потай від читача підтягнути зображення чи шрифт від третьої\nсторони.\n\nЦіна так само відчутна. Gemtext доходить лише до людей, які користуються клієнтом Gemini, а це\nневелика аудиторія поруч із вебом. Форм у форматі немає; єдиний спосіб, у який капсула просить\nщось увести, — це код статусу в протоколі, а не щось у самому документі. До того ж текст має\nпрацювати без посилань усередині речень. Речення, написане для HTML, «деталі дивіться на сторінці\nз цінами», зберігає слова, але втрачає вказівник, тож добрий gemtext вимагає речень, які мають\nсенс і тоді, коли посилання стоїть рядком нижче.\n\nТому для більшості організацій реалістичне питання звучить так: gemtext разом із вебсайтом, а не\nзамість нього, з того самого джерела і в тому самому збиранні. За такої постановки gemtext коштує\nнебагато, а заразом стає перевіркою тексту. Якщо сторінка й далі ясно читається як стовпчик\nтекстових рядків і рядків-посилань, то її структура весь час була в самих словах.\n\n## Як це виглядає на практиці\n\nЦей сайт публікується як gemtext поруч зі своїм HTML. Сторінка\n[Engineer у терміналі](/uk/cli/) наводить адресу капсули, `gemini://engineer.company/`, каже, що\nкожна сторінка сайту існує і в цьому форматі, і називає клієнти, які його читають: Amfora,\nLagrange і Bombadillo в терміналі, Castor і Kristall у вікні. Вона ж пояснює причину. Одне\nрозгортання записує одну теку, з якої читають усі входи, тож копія gemtext не може розійтися з\nHTML, а сторінка, що добре читається як gemtext, має справжню структуру, а не намальовану зверху.\n\nЯк це збудовано, описано в [розповіді про віддзеркалення сайту в Gemini і Gopher](/uk/portfolio/mirrored-the-site-to-gemini-and-gopher/). Gemtext є форматом виводу того самого збирання, а не окремим набором інструментів. Генераторові сайту додали власні медіатипи й формати виводу, і кожна сторінка, розділ та термін таксономії отримали документ Gemini поруч зі своїм HTML і двійником у Markdown: на зафіксованому етапі реалізації їх було 777, і їх віддавав невеликий демон на тому самому хості. Нові формати позначено як неальтернативні подання. Окреме порівняння збірок зафіксувало нуль змінених байтів HTML під час додавання цих форматів; пізніших редакторських чи візуальних змін воно не вимірювало.\n\nШаблони, що стоять за цією копією, показують, що означає конвертація в gemtext. Кожне посилання\nвиймають із речення: слова лишаються там, де вони потрібні реченню, а адреса переїжджає під текст\nокремим рядком `=\u003e`. Позначки жирного шрифту зникають, пункти з дефісом стають зірочками, а блок\nкоду між огорожами проходить без змін, бо огорожа Markdown і перемикач попередньо форматованого\nтексту в gemtext складаються з тих самих трьох зворотних лапок.\n\n## Де виникають проблеми\n\n### Обірвані рядки, які так і не зливаються\n\nТекст доходить до клієнта нерівним стовпчиком коротких рядків, обірваних посеред речення. Джерело\nбуло перенесене на 80 символах, як це часто буває з файлами Markdown, а специфікація забороняє\nклієнтові об'єднувати короткі текстові рядки, що йдуть підряд, у довші. Пишіть кожен абзац одним\nдовгим рядком або доручіть конвертерові з'єднувати м'які розриви рядків, перш ніж він запише\nфайл.\n\n### Посилання, що виводять за межі капсули\n\nПерше ж посилання, за яким переходить читач, відкриває вебоглядач. Конвертер записав кожне\nпосилання як абсолютну адресу `https://`, а клієнт Gemini передає такі адреси іншій програмі.\nЗаписуйте навігацію як шляхи від кореня, наприклад `/about/`, які ведуть усередину капсули, і\nзалиште на кожній сторінці одне свідоме посилання на її вебверсію.\n\n### Код, що злипається в один рядок\n\nПриклад коду з'являється одним довгим рядком, приліпленим до відкривної огорожі. Конвертер\nобробив блок як звичайний текст і злив його рядки з усім іншим. Розбивайте документ за огорожами\nраніше за будь-який інший крок, пропускайте кожен попередньо форматований блок так, як його\nнаписано, і дозволяйте рядкові-перемикачу нести щонайбільше короткий альтернативний текст,\nнаприклад назву мови.\n\n### Markdown, що перетворюється на буквальні символи\n\nПункти з дефісом, подвійні зірочки, підкреслені заголовки, вкладені списки й посилання у\nквадратних дужках з'являються в клієнті точно так, як їх набрано. Gemtext розпізнає лише зірочку\nз пробілом як пункт списку і решітки як заголовок, а розмітки всередині рядка в ньому немає\nвзагалі. Перетворюйте ці конструкції на виході або пишіть капсулу одразу в gemtext.\n\n### Речення, що вказують у порожнечу\n\nАбзац каже «натисніть тут» або «як за посиланням вище», і читач лишається без напрямку.\nПосилання вийняли з речення, а слова, що лишилися, ніколи не казали, куди воно веде. Пишіть\nпідписи посилань, які називають місце призначення, щоб і речення, і рядок `=\u003e` мали сенс самі по\nсобі.\n\n## Що почитати далі\n\n- [A quick introduction to gemtext markup](https://geminiprotocol.net/docs/gemtext.gmi)\n  — власний короткий огляд проєкту з усіма типами рядків і примітками для тих, хто знає Markdown.\n- [Gemini hypertext format specification](https://geminiprotocol.net/docs/gemtext-specification.gmi)\n  — нормативний текст: типи рядків, стан парсера, правила перенесення, параметр `lang` і\n  формальна граматика.\n- [Gemini network protocol specification](https://geminiprotocol.net/docs/protocol-specification.gmi)\n  — як капсула віддає gemtext: запити, коди статусу й правила TLS, яких дотримується клієнт.\n- [Project Gemini FAQ](https://geminiprotocol.net/docs/faq.gmi) — міркування, що стоять за\n  дизайном, зокрема чому посилання стоять в окремих рядках.\n\n\u003chttps://engineer.company/uk/glossary/gemtext/\u003e\n","date_modified":"2026-11-08T02:22:23Z","description":"Як пишуть gemtext, формат документів Gemini, рядок за рядком, чому вигляд сторінки визначає читач і де звички з Markdown ламають капсулу.","formats":{"gemtext":"https://engineer.company/uk/glossary/gemtext/index.gmi","gopher":"https://engineer.company/uk/glossary/gemtext/gophermap","html":"https://engineer.company/uk/glossary/gemtext/","json":"https://engineer.company/uk/glossary/gemtext/index.json","markdown":"https://engineer.company/uk/glossary/gemtext/index.md","pdf":"https://engineer.company/uk/glossary/gemtext/index.pdf"},"kind":"page","language":"uk","title":"Що таке gemtext?","url":"https://engineer.company/uk/glossary/gemtext/","version":1}