💾 Archived View for dmntv.ru › notes › help.gmi captured on 2024-12-17 at 10:06:07. Gemini links have been rewritten to link to archived content

-=-=-=-=-=-=-

           __   __             __   ___
|     /\  / _` |__)  /\  |\ | / _` |__
|___ /~~\ \__> |  \ /~~\ | \| \__> |___

Помощь

Что такое Gemini

Gemini — это простой протокол для обслуживания контента через Интернет. Он определяет формат, вдохновленный Markdown, позволяющий базовую разметку текстовых документов. По сравнению с HTTP и HTML, Gemini намного проще и легче в работе.

Project Gemini FAQ

Protocol and 'text/gemini' specification

Что такое Lagrange

Lagrange — это кроссплатформенный клиент для просмотра Geminispace. Он предлагает современные удобства, знакомые по веб-браузерам, такие как плавная прокрутка, встроенный просмотр изображений, несколько вкладок, визуальные темы, шрифты Unicode, закладки, история и контуры страниц.

Как и Gemini, Lagrange был разработан с учетом минимализма. Он зависит от небольшого количества необходимых библиотек. Он написан на языке C и использует SDL для аппаратного ускорения графики. OpenSSL используется для безопасной связи.

About Lagrange

SDL: Simple DirectMedia Layer

OpenSSL: Cryptography and SSL/TLS Toolkit

Особенности

Красивая типографика с полной поддержкой Unicode
Автоматически сгенерированный стиль страницы и символ для каждого домена Gemini
Светлые и темные цветовые темы
Плавная прокрутка
Масштабирование содержимого страницы (50%...200%)
Коэффициент масштабирования для пользовательского интерфейса (для произвольного DPI монитора)
TUI на основе Curses как альтернатива графическому интерфейсу
Боковые панели для управления закладками, идентификаторами и подписными лентами, а также просмотра истории просмотра и структуры страницы
Несколько вкладок
Разделенный вид для просмотра двух страниц одновременно
Постоянное состояние приложения — вкладки и история восстанавливаются при следующем запуске
Настраиваемые сочетания клавиш
Настраиваемая цветовая палитра пользовательского интерфейса
Открытие ссылок с помощью сочетаний клавиш
Выделение и копирование текста с помощью мыши
Поиск текста на странице
Открытие ссылок на изображения и аудио на одной странице
Мгновенная навигация назад/вперед (в macOS поддерживаются смахивания на трекпаде)
Подписаться на Ленты Gemini и Atom
Управление идентификацией — создание и использование клиентских сертификатов TLS
Умные подсказки при вводе URL — поиск закладок, истории, лент, идентификаций
Интеграция с поисковой системой
Настраиваемые текстовые фрагменты, которые можно вставлять в поля ввода и использовать в качестве пользовательских поисковых запросов
Использование страниц Gemini в качестве источника закладок
Воспроизведение аудио: MP3, Ogg Vorbis, WAV
Чтение книг Gempub и просмотр содержимого архивов ZIP
Встроенная поддержка загрузки и редактирования содержимого с использованием протокола Titan
Встроенная поддержка Gopher, Finger, Spartan, Nex, Misfin и Guppy
Использование прокси-серверов для содержимого Gemini, HTTP и Gopher

Почему бы просто не использовать веб-браузер

Современные веб-браузеры — сложные звери. Фактически, они настолько сложны, что внутри одного из них можно создать полнофункциональную виртуальную машину и запустить другую операционную систему!

Windows 95 on DOSBox (using Emscripten)

Если кто-то хочет просто читать текст и просматривать изображения, это абсурдное излишество. Наличие универсальной платформы, которая работает везде и на всем, — это, несомненно, ценная идея, но она имеет высокую цену. Программный стек возвышается все выше, а оборудование должно быть все более мощным и сложным, чтобы хорошо его запускать. Однако все в Интернете не должно зависеть от этого бегемота.

Один из способов просмотра контента Gemini — через расширения веб-браузера или прокси-серверы, которые переводят контент для Интернета. Это может быть достаточным и простым решением для вас. Однако собственные клиенты, такие как Lagrange, также выигрывают от простоты протокола и контента. Опыт можно оптимизировать, и программное обеспечение хорошо работает даже на простом оборудовании, таком как Raspberry Pi.

1 Пользовательский интерфейс

Пользовательский интерфейс Lagrange смоделирован по образцу веб-браузеров:

В верхней части находится панель навигации с кнопками «Назад» и «Вперед».
Есть панель вкладок для переключения вкладок. Панель вкладок скрыта, если открыта только одна вкладка.
Есть боковые панели для управления закладками, подписными лентами и идентификаторами TLS, а также для просмотра истории и структуры страницы. Боковые панели по умолчанию скрыты.
Есть панель поиска, которая появляется внизу при поиске текста на странице.

Совет: попробуйте нажать ⌘+5 сейчас, чтобы увидеть структуру страницы.

Пользовательский интерфейс был разработан для использования как с помощью мыши, так и с помощью клавиатуры. При использовании мыши наиболее часто используемые функции доступны через контекстные меню, например, щелчком правой кнопкой мыши по текущей открытой странице. С другой стороны, сочетания клавиш могут обеспечить очень быстрый и плавный пользовательский интерфейс. Например, чтобы открыть закладку "CAPCOM", можно использовать следующие сочетания клавиш:

⌘+L для активации поля ввода URL
Введите "cap", чтобы отобразить закладку "CAPCOM" как первый результат поиска
Tab (или ↓) для перемещения фокуса к результатам поиска
Enter для выбора "CAPCOM"

1.1 Навигация

1.1.1 Ввод URL и быстрый поиск

Поле ввода URL находится в традиционном месте на панели навигации. К нему можно быстро получить доступ, нажав ⌘+L. Затем вы можете ввести или вставить URL и нажать Enter, чтобы загрузить страницу.

По мере ввода текста в поле ввода URL Lagrange начинает искать совпадения в закладках, подписных лентах, истории, идентификаторах и содержимом кэшированных страниц. Это обеспечивает простой способ вернуться на страницу, на которой вы недавно были. Нажмите Tab или ↓, чтобы переключить фокус ввода на результаты.

Поиск на кэшированных страницах ограничен (небольшим) набором страниц, которые Lagrange хранит в памяти для обратной навигации. Условия поиска нечувствительны к регистру, и если введено много слов, все они должны отображаться в указанном порядке в любом совпадающем содержимом.

Обратите внимание, что стек навигации сохраняется в файле при закрытии Lagrange и восстанавливается при следующем запуске. Это означает, что при следующем запуске Lagrange вы по-прежнему сможете искать содержимое прошлых страниц. Однако стеки навигации привязаны к вкладкам, поэтому закрытие вкладки также удалит ее историю.

Вы также можете выполнять поисковые запросы в Интернете через поле ввода URL. Когда URL поиска настроен на вкладке «Общие» в настройках, текст, введенный в поле URL, передается в URL поиска в качестве параметра запроса. Поисковый запрос будет выполнен только при нажатии Enter, когда виден индикатор [Поисковый запрос]. Один из способов настройки URL поиска — щелкнуть правой кнопкой мыши ссылку «Поиск» поисковой системы — например, когда вы находитесь на главной странице системы — и выбрать «Использовать как URL поиска» в контекстном меню.

См. раздел 2.5 о дальнейшей настройке поведения поиска.

1.1.2 Ссылки

Тип и назначение ссылки указываются значком и цветом ссылки: ➤ ссылается на тот же домен, а 🌐 — на другой домен. Цвета:

Синий для Gemini
Зеленый для Gopher
Оранжевый для HTTP(S)
Красный для других/неизвестных/недействительных (невозможно открыть)

Цвета ссылок могут меняться в зависимости от цветовой темы страницы. (См. раздел 2.3.1 «Цветовые темы».)

Опцию «Показывать URL при наведении» можно включить в настройках, чтобы при наведении курсора мыши на ссылку отображалась дополнительная информация: целевой домен, схема URL для ссылок, отличных от Gemini, дата последнего посещения URL и идентификатор, который будет использоваться при открытии ссылки.

Если ссылка обычно использует значок по умолчанию ➤, но в начале метки ссылки есть эмодзи, то вместо этого в качестве значка ссылки используется этот эмодзи. В таких случаях вы всегда можете предположить, что ссылка — это ссылка Gemini, целевым адресом которой является тот же домен, на котором вы находитесь в данный момент.

Вкладка «Сеть» в настройках имеет несколько настроек, которые влияют на представление ссылок и URL в целом:

«Декодирование URL» вызывает декодирование процентного кодирования для пользовательского интерфейса, чтобы можно было видеть международные символы в URL.
«Максимальный размер URL» устанавливает ограничение на длину URL. Хотя серверы Gemini должны обеспечивать ограничение в 1024 байта для URL, этот параметр влияет на все URL независимо от схемы. Строки ссылок с URL длиннее этого будут представлены как обычный текст.

1.1.3 Кэширование страниц

При переходе на новую страницу старая страница кэшируется в памяти. Если вы вернетесь назад, кэшированная копия старой страницы будет восстановлена. Представьте себе это как перемотку времени назад — вы возвращаетесь в прошлое, как будто ничего не произошло. То же самое относится к прямой навигации; кэшированные страницы загружаются, если они доступны. Это позволяет выполнять прямую и обратную навигацию мгновенно, без каких-либо сетевых запросов.

Кэш страницы сохраняется в файле при завершени�� работы Lagrange, чтобы его можно было восстановить при следующем запуске.

Максимальный размер кэша можно настроить на вкладке «Содержимое» в настройках. Обратите внимание, что весь кэш хранится в памяти во время выполнения. Когда кэш заполняется, удаляется самое старое и самое большое содержимое страницы — оба фактора способствуют удалению. Вы можете установить максимальный размер на 0, чтобы полностью отключить кэширование, но это также отключит функцию быстрого поиска содержимого страницы.

1.1.4 Открытие ссылок в новой вкладке

Удерживание ⌘при щелчке левой кнопкой мыши по ссылке приводит к ее открытию в новой вкладке. Альтернативно, щелчок средней кнопкой мыши по ссылке имеет тот же эффект.

⇧+⌘+щелчок открывает ссылку в новой фоновой вкладке.

Щелчок правой кнопкой мыши по ссылке показывает контекстное меню для этой ссылки. Оттуда вы также можете открыть ссылку в новой фоновой вкладке, что сохранит текущую вкладку открытой.

1.1.5 Открытие ссылок сбоку

Удерживание ⇧ при щелчке левой кнопкой мыши по ссылке открывает ее в режиме разделенного просмотра с другой стороны разделения. В режиме разделенного просмотра ваши настройки закрепления вкладок будут определять вкладку, на которой будут открываться нажатые ссылки. Подробнее о режимах разделенного просмотра см. в разделе 1.9.

1.1.6 Открытие ссылок с помощью клавиатуры

Lagrange имеет два режима навигации по ссылкам с помощью клавиатуры. Первый использует клавишу-модификатор (по умолчанию ⌥): пока нажат модификатор, для каждой видимой ссылки в окне отображаются буквенно-цифровые сочетания клавиш. Затем вы можете нажать соответствующую клавишу, все еще удерживая модификатор, чтобы открыть ссылку. Второй режим основан только на буквах и фокусируется на клавишах строк страниц. Вы нажимаете и отпускаете клавишу активации (по умолчанию "F"), чтобы отобразить буквы сочетания клавиш ссылки. В этом режиме сочетания клавиш не расположены в алфавитном порядке, а примерно отсортированы по близости к клавишам F и J. Возможно, вам будет проще это использовать, так как это простая последовательность нажатий клавиш без использования модификаторов, что позволяет держать пальцы на домашнем ряду или около него.

Вы можете попробовать это сейчас по ссылке ниже. Либо удерживайте ⌥, либо нажмите и отпустите F.

Project Gemini

1.2 Вкладки

Нажмите ⌘+T, чтобы открыть новую вкладку, и ⌘+W, чтобы закрыть текущую вкладку. Щелчок правой кнопкой мыши по кнопкам на панели вкладок открывает контекстное меню для дополнительных функций, связанных с вкладками.

Набор открытых вкладок и их полное содержимое сохраняются при выходе из приложения и восстанавливаются при его повторном запуске.

1.2.1 Выделение открытых ссылок

Когда вы открываете вкладку, и URL этой вкладки находится в ссылке на другой странице, эта ссылка будет выделена. Таким образом, вы можете легко увидеть, какие ссылки в настоящее время открыты на других вкладках. Эти выделения помогут вам в навигации по иерархиям и индексации страниц.

1.2.2 Автоматическая перезагрузка

Вкладку можно настроить на автоматическую перезагрузку через заданные интервалы. Настройка запоминается до тех пор, пока вкладка не будет закрыта. Это полезно, если вы держите периодически обновляемую страницу открытой в течение длительного времени.

Функцию можно найти в контекстном меню страницы: щелкните правой кнопкой мыши и выберите «Инструменты > Установить автоматическую перезагрузку...».

1.3 Боковые панели

Боковые панели можно переключать с помощью меню или нажатием ⇧+⌘+L или ⇧+⌘+P (для левой/правой боковой панели соответственно). Обе боковые панели имеют пять вкладок:

Закладки: список созданных вами закладок, организованных в папки. Закладки отображаются первыми в результатах поиска для быстрого и легкого доступа.
Ленты: записи, найденные на подписанных страницах.
История: хронологический список посещенных URL-адресов. Это не полная история всех URL-адресов, к которым вы обращались с течением времени — отображаются только уникальные URL-адреса на момент последнего доступа.
Идентификаторы: сертификаты клиента TLS.
Структура: список заголовков в текущей открытой вкладке. Полезно при чтении длинных документов.

⌘+1 через ⌘+5 переключают между вкладками левой боковой панели или скрывают боковую панель, если нажата клавиша текущей вкладки. Вы также можете нажать Escape, чтобы убрать боковые панели.

1.4 Закладки

Нажмите ⌘+D, чтобы добавить в закладки открытый в данный момент URL-адрес.

Недавно добавленные закладки отображаются в нижней части боковой панели закладок. Вы можете перетаскивать элементы в списке, чтобы изменить их порядок.

Помимо заголовка, закладки могут иметь теги. Некоторые теги имеют особое значение, но вы можете ввести все, что захотите, в поле тегов. В результатах быстрого поиска тегам присваивается дополнительный вес, поэтому они отображаются выше в результатах.

По умолчанию закладкам назначаются случайные значки. Вы можете ввести пользовательский значок для закладки в диалоговом окне редактирования закладок, чтобы упростить распознавание определенного сайта с первого взгляда. Значок должен быть одним символом Unicode. Он будет отображаться в списке закладок, заголовках вкладок, списке записей ленты, результатах быстрого поиска и баннерах в верхней части страницы.

1.4.1 Папки

Нажмите ⇧N, чтобы создать новую папку закладок. Недавно добавленные папки отображаются в нижней части списка закладок.

Вы можете перетаскивать закладки в папки и из них. Папки также могут быть вложены друг в друга. Щелчок по заголовку папки переключит ее состояние сворачивания, скрыв или показав ее содержимое. Состояние сворачивания запоминается между сеансами.

Вы можете открыть все закладки внутри папки в новых вкладках с помощью контекстного меню боковой панели (щелчок правой кнопкой мыши по папке). Новая вкладка мгновенно создается для каждой закладки, включая закладки во вложенных подпапках. Однако страницы с закладками будут загружаться последовательно, чтобы избежать чрезмерного сетевого трафика.

1.4.2 Общий доступ и пакетный импорт

Специальная страница «about:bookmarks» используется для перечисления закладок различными способами.

Он имеет три различных режима, которые можно открыть через меню:

список закладок в алфавитном порядке
список закладок, сгруппированных по тегу
список закладок в виде ленты с датами создания

Сгенерированную страницу можно сохранить в разделе «Загрузки» или скопировать ее целиком или частично в буфер обмена. Например, затем можно использовать эти списки для обмена общедоступными закладками на вашей капсуле.

Чтобы импортировать все ссылки на странице в качестве закладок, используйте контекстное меню страницы для выбора «Инструменты > Импортировать ссылки как закладки...». Вы также можете щелкнуть правой кнопкой мыши по отдельным ссылкам и выбрать «Добавить ссылку в закладки...».

Импорт ссылок на страницу не приведет к (повторному) созданию каких-либо папок. Чтобы полностью экспортировать и импортировать ваши закладки, теги, пользовательские значки и папки, см. раздел 1.12.

1.4.3 Удаленные закладки

Эта версия Lagrange не поддерживает автоматическую синхронизацию закладок. По умолчанию все закладки хранятся локально. Однако функция удаленных закладок позволяет получать доступ к набору закладок из любой точки мира. Таким образом, вы можете настроить собственные централизованные страницы закладок или использовать любую общедоступную страницу Gemini в качестве источника закладок.

Локальную закладку можно превратить в источник удаленных закладок с помощью контекстного меню «Закладки». Щелкните правой кнопкой мыши по закладке и выберите «Использовать как удаленный источник». Значок ⤓ используется для обозначения удаленных элементов в списке закладок. Удаленные источники проверяются при запуске Lagrange и вручную с помощью пункта меню «Обновить удаленные источники».

Все ссылки, найденные в удаленных источниках, становятся удаленными закладками и включаются в список закладок. Если URL-адрес уже добавлен в закладки локально, удаленные закладки с соответствующим URL-адресом не отображаются.

Обратите внимание, что удаленные закладки доступны только для чтения: их нельзя редактировать или помечать тегами. Это означает, что вы не можете подписаться на удаленную закладку, не сделав предварительно ее локальный дубликат. Если вы хотите сделать локальные копии всех ссылок в удаленном источнике, откройте страницу удаленного источника и используйте на ней пункт контекстного меню «Импортировать ссылки как закладки...». После обновления удаленных источников удаленные копии закладок больше не будут отображаться.

1.4.4 Поведенческие теги

Закладки могут использовать ряд специальных тегов, которые управляют их поведением. На практике они хранятся в записях «теги» bookmarks.ini, но скрыты в поле «Теги» в пользовательском интерфейсе приложения.

Тег «.homepage» делает закладку одной из страниц, которые будут открываться при нажатии кнопки 🏠. Если несколько закладок по��ечены как домашние страницы, выбирается случайная.
Тег «.subscribed» означает, что Lagrange будет периодически извлекать страницу с закладкой и искать ссылки на каналы Gemini. Все найденные ссылки, соответствующие требуемому стилю («заголовок записи YYYY-MM-DD»), будут отображаться на вкладке боковой панели «Ленты».
«.headings» можно использовать вместе с «.subscribed» для подписки на новые заголовки вместо ссылок на каналы Gemini.
«.ignoreweb» изменяет подписку на каналы, чтобы игнорировать все URL-адреса HTTP(S). Это полезно, если лента содержит как Gemini, так и веб-ссылки, но вас интересуют только Gemini.
Тег ".remotesource" отмечает закладку как источник удаленных закладок. Все ссылки на исходных страницах отображаются как удаленные закладки в списке закладок.
Тег ".remote" используется для удаленных закладок. Эти закладки нельзя редактировать или помечать тегами, но можно создать локальный дубликат, чтобы превратить его в обычную закладку.
Тег ".usericon" предотвращает выбор случайного значка для закладки. Этот тег автоматически применяется при вводе символа значка в редакторе закладок.
Тег ".linksplit" заставляет все ссылки на странице с закладкой открываться в сторону, автоматически включая режим разделенного просмотра.

1.5 Подписка на каналы

Вы, возможно, знакомы с RSS- и Atom-каналами на основе XML из Интернета. Их эквивалентом в Gemini являются каналы Gemini. Канал Gemini — это просто обычная страница «текст/gemini», которая содержит одну или несколько ссылок, метки которых отформатированы определенным образом. Это значительно упрощает написание страниц, на которые клиенты могут подписываться.

See "Subscribing to Gemini pages" for more information.

Lagrange поддерживает подписки на каналы Gemini и Atom. Каналы Atom автоматически преобразуются в формат каналов Gemini, поэтому их можно просматривать и подписываться на них как на обычную страницу «text/gemini». RSS-каналы не поддерживаются.

Подписки управляются через закладки. Когда вы подписываетесь на страницу канала, создается закладка и к ней применяется специальный тег «.subscribed». В списке закладок это обозначено значком ★. Других различий между обычными закладками и подписками на каналы нет — вы можете пометить любую закладку как подписку, и Lagrange будет просматривать ее на наличие ссылок в стиле канала. Заголовок закладки используется в качестве заголовка канала. По умолчанию это верхний заголовок страницы индекса канала, но вы можете изменить его в соответствии со своими потребностями.

Каналы обновляются периодически во время работы Lagrange, а также сразу после запуска, если с момента предыдущего обновления прошло некоторое время. Вы также можете вручную обновить все каналы через меню или нажав ⇧+⌘+R.

Вкладка боковой панели «Ленты» отображает последние записи каналов. Оттуда вы можете открывать записи и отмечать их как прочитанные/непрочитанные.

Чтобы увидеть список всех записей из всех каналов, откройте страницу «Записи каналов». На этой странице также отображается, сколько времени прошло с момента предыдущего обновления канала.

about:feeds

1.6 Идентификаторы (клиентские сертификаты)

Gemini использует клиентские сертификаты TLS для идентификации пользователя/сеанса. В отличие от Интернета, где отслеживание идентификатора пользователя является скрытым и автоматическим, клиентские сертификаты должны быть введены в действие вручную, и вы можете определить, как долго каждый сертификат остается действительным. Термин «Идентификатор» используется в Lagrange для обозначения клиентских сертификатов.

На боковой вкладке «Идентификаторы» отображаются все идентификаторы, известные Lagrange. Нажмите ⌘+4, чтобы отобразить ее. Сюда входят идентификаторы, созданные в Lagrange, и любые идентификаторы, основанные на импортированных сертификатах X.509.

1.6.1 Создание нового идентификатора

Нажмите кнопку 👤 на панели навигации и выберите «Новый идентификатор...» или «Новый идентификатор для домена...». Сочетание клавиш для этого — ⇧+⌘+N.

Рассматривайте любую информацию, которую вы вводите в сертификат, как общедоступную — только общее имя должно быть непустым. Сгенерированный сертификат будет использовать Common Name в качестве издателя и субъекта сертификата, что дает понять, что сертификат является самоподписанным. Другое обязательное поле — это дата истечения срока действия в поле «Действителен до». Ввода года достаточно, и это означает, что сертификат действителен до конца этого года.

Параметр «Временный» предотвращает постоянное сохранение идентификатора — он будет удален, как только вы выйдете из Lagrange. В противном случае сертификат и его закрытый ключ записываются в файлы .crt и .pem.

1.6.2 Использование идентификатора

Вам нужно будет выбрать идентификатор, если вы столкнетесь с этим сообщением об ошибке:

🔑 Требуется сертификат

Нажатие на идентификатор на боковой панели показывает меню, в котором вы можете управлять использованием идентификатора для текущего открытого URL. При последующих загрузках страницы сертификат будет отправлен на сервер при извлечении URL или любого URL под ним. Вы можете нажать кнопку 👤 на панели навигации, чтобы увидеть, какой идентификатор используется для текущей страницы.

Поскольку боковая панель не поддерживает навигацию с помощью клавиатуры, обратите внимание, что доступ к идентификаторам также можно получить через результаты поиска. Идентификаторы, соответствующие поисковым запросам, отображаются как последняя категория в списке результатов поиска. Оттуда можно переключить идентификатор для текущей страницы или прекратить его использование на всех страницах.

Идентификаторы также можно использовать, закрепив один в закладке. Всякий раз, когда затем открывается закладка, связанный идентификатор принимается в действие. Идентификация также навсегда «прикрепляется» к открытой вкладке. Это означает, что вкладка продолжает использовать идентификацию для всех последующих запросов, но может переключаться только на URL-адреса внутри той же капсулы. Если ссылка ведет в другое место, эта ссылка открывается в новой вкладке без закрепленной идентификационной информации. Таким образом, можно свободно перемещаться внутри капсулы, сохраняя идентификацию используемой, не отправляя ее случайно в какую-либо другую капсулу, например, если вы забыли, что используете идентификацию, и вручную вводите URL-адрес какой-либо другой капсулы. Чтобы завершить использование идентификационной информации, ее необходимо вручную открепить от вкладки (с помощью кнопки «Идентификация» на панели навигации) или закрыть вкладку. Сохранение закрепленной идентификационной информации, специфичной для вкладки, также полезно, поскольку тогда один и тот же URL-адрес можно одновременно открыть с несколькими разными идентификационными данными в отдельных вкладках.

1.6.3 Импорт существующих сертификатов

Чтобы импортировать существующий сертификат X.509 в качестве удостоверения, нажмите ⇧+⌘+I или щелкните 👤 и выберите «Импорт...» (macOS: меню «Удостоверение» → «Импорт...»).

Когда откроется диалоговое окно «Импорт удостоверения», оно проверит текущую открытую страницу на наличие сертификатов и закрытых ключей в формате PEM. Если они будут найдены, они будут автоматически загружены. Вы также можете нажать ⌘+V, чтобы вставить сертификаты в формате PEM и/или закрытые ключи, или перетащить файлы .crt/.key в формате PEM в окно Lagrange, пока диалоговое окно открыто.

Кроме того, вы можете вручную скопировать файлы сертификатов, чтобы Lagrange мог их найти. При запуске Lagrange просматривает свой каталог «idents», чтобы узнать, были ли скопированы туда какие-либо новые сертификаты. (См. «Файлы времени выполнения» ниже для определения местоположения; это зависит от платформы) Формат файла должен быть PEM. Сертификат (.crt) и его закрытый ключ (.key) должны быть найдены в «idents», и у них должны быть совпадающие имена файлов. Например:

mycert.crt
mycert.key

Lagrange добавит примечание к импортированным удостоверениям, чтобы отметить их как «Импортированные».

Обратите внимание, что вы можете найти сертификаты любых экспортированных удостоверений внутри ZIP-архива пользовательских данных. Подробности см. в разделах 1.12 и 6.

1.7 Загрузки

Нажмите ⌘+S, чтобы сохранить содержимое текущей страницы в папке «Загрузки». Это работает на всех страницах независимо от того, может ли Lagrange отображать содержимое или нет.

Когда изображение или аудиоконтент отображаются в строке, вы можете щелкнуть по нему правой кнопкой мыши и выбрать «Сохранить в загрузках» в контекстном меню.

Кнопка 🔃 справа от поля ввода URL — это кнопка «Перезагрузить/Остановить» — она перезагружает текущую страницу или останавливает текущую загрузку. Во время больших загрузок рядом с кнопкой «Остановить» появляется дополнительный индикатор хода выполнения.

Место сохранения загруженных файлов можно изменить в настройках. Расположение по умолчанию — «Загрузки» в вашем домашнем каталоге.

1.8 Загрузки (с Titan)

Titan — это родственный протокол Gemini, который позволяет отправлять произвольные объемы данных от клиента к серверу. Сам протокол Gemini позволяет отправлять только до 1024 байт данн��х в запросе. Кроме того, URL-адрес запроса также учитывается в этом ограничении, и отправленные данные должны быть закодированы в процентах, чтобы их можно было проанализировать как допустимый URL-адрес. Следовательно, клиенты Gemini могут отправлять только очень ограниченные объемы данных на сервер. Titan решает эту проблему, расширяя запрос так, чтобы за URL-адресом запроса следовало поле полезной нагрузки. Что касается TLS, Titan эквивалентен Gemini, поэтому с обоими можно использовать одни и те же сертификаты сервера и клиента.

Titan Protocol (by Alex Schroeder)

Titan и Gemini связаны, но Titan — это отдельный протокол, и обычные серверы Gemini не должны его поддерживать. Многим службам не нужно позволять клиентам загружать большие объемы данных, но это полезно в некоторых конкретных случаях. Например, сервер, на котором размещен gemlog, может разрешить загрузку Titan для отправки новых сообщений или редактирования существующих сообщений путем загрузки измененной версии.

Что касается Lagrange, Titan — это всего лишь одна из поддерживаемых схем URL. Всякий раз, когда вы пытаетесь открыть URL-адрес «titan://», независимо от того, введен ли он вручную в поле URL-адреса или путем нажатия на ссылку, открытия закладки, записи ленты или через перенаправление, откроется диалоговое окно, в котором вы можете ввести данные для загрузки:

Вы можете ввести текст в поле ввода на вкладке «Текст». Он будет отправлен на сервер с использованием типа носителя «text/plain».
Вы можете перетащить файл в диалоговое окно. Подробности файла для загрузки отображаются на вкладке «Файл». Тип носителя можно указать вручную, если Lagrange не может правильно его определить.

Токен загрузки — это функция Titan, с помощью которой серверы могут требовать определенный текст/парольную фразу токена для загрузки. Как это интерпретировать, решает сервер. Его можно использовать как простой пароль или даже команду для дальнейшего указания серверу, что делать с загруженными данными. Пожалуйста, ознакомьтесь с инструкциями сервера о том, что здесь вводить. Токен также можно оставить пустым.

Подсветка синтаксиса Gemtext поддерживается в текстовом поле диалогового окна загрузки. Эту функцию можно включить в разделе «Настройки > Внешний вид». По умолчанию Lagrange поставляется с одним моноширинным шрифтом, поэтому, если вы не установите дополнительные моноширинные начертания/стили, подсветка синтаксиса будет использовать только разные цвета для типов строк Gemtext. Вы можете установить этот пакет шрифтов, чтобы включить жирные и курсивные шрифты для выделения:

Iosevka Term Extended (7,6 МБ)

Текст, введенный в основное текстовое поле диалога загрузки, защищен от случайного закрытия диалога или приложения, или сбоя. Предыдущий текст восстанавливается при повторном открытии диалога. Содержимое текстового поля очищается только после успешного завершения отправленного запроса Titan.

1.9 Режим разделенного просмотра

По умолчанию в окне приложения одновременно отображается только одна вкладка. Однако иногда бывает полезно видеть две страницы одновременно. Например, многие капсулы имеют меню верхнего уровня или списки статей, а сохранение меню/индекса видимым сбоку делает навигацию менее громоздкой.

Режим разделенного просмотра делит пользовательский интерфейс на две эквивалентные части. В каждом разделении можно открыть несколько вкладок. Закрытие всех вкладок с одной стороны удалит разделение и вернет в обычный неразделенный режим.

Разделение вида в основном контролируется с помощью меню разделения вида. Сочетание клавиш по умолчанию для его отображения — ⌘+J. Для удобства рекомендуется использовать сочетания клавиш, перечисленные в меню, для изменения режимов разделения. Например, последовательность ⌘+J 2 можно использовать для быстрой активации горизонтального разделения на 50%, а ⌘+J 1 объединит все открытые вкладки обратно в обычный неразделенный вид.

Другой способ активировать режим разделенного просмотра — нажать на ссылку, удерживая ⇧.

У каждого разделения есть свои боковые панели, что означает, что в режиме разделенного просмотра вы можете одновременно открыть четыре боковые панели.

1.9.1 Переключение фокуса

В любой момент времени один из разделов имеет фокус клавиатуры. Это обозначено цветной линией в верхней части раздела, а некоторые элементы пользовательского интерфейса будут затемнены на невыделенной стороне.

Чтобы переключить фокус клавиатуры между разделами, вы можете использовать сочетания клавиш Next/Previous Tab или Ctrl+Tab. Next/Previous Tab особенно удобен, поскольку он циклически переключает все открытые вкладки, переходя на другую сторону разделения, когда это необходимо.

Вы также можете нажать Tab, чтобы циклически переключать фокус ввода между всеми полями ввода URL.

1.9.2 Закрепление

Хотя иногда полезно просто иметь два независимых браузера, открытых рядом, по умолчанию разделение представления предназначено для помощи в навигации по иерархиям и спискам. В типичном случае использования у вас будет меню или страница индекса слева, а страница контента открыта справа. Ссылки, нажатые слева, автоматически откроются справа.

Это называется «закреплением», и поведение можно настроить в настройках. Параметр «Закрепление разделенного представления» на вкладке «Общие» настроек управляет тем, где открываются ссылки в разделенном представлении. Доступны три режима:

«Нет» заставляет ссылки открываться во вкладке, где нажимается ссылка. В этом режиме можно перемещаться по обеим сторонам разделения независимо.
«Левая вкладка» заставляет ссылки, нажатые на левой вкладке, открываться на правой стороне. Таким образом, страница, открытая на левой вкладке, «закреплена» и не изменяется, пока вы не введете новый URL или не перейдете к родительской или корневой странице.
«Правая вкладка» — то же самое, но работает наоборот. Страница, открытая на правой вкладке, закрепляется, а нажатые ссылки открываются слева.

Режим закрепления по умолчанию — «Левая вкладка».

Индикатор ◧ отображается в поле ввода URL, когда текущая вкладка закреплена.

1.10 Просмотр локальных файлов и каталогов

URL-адреса "file://" можно использовать для доступа к локальным файлам и каталогам. Типы файлов, известные Lagrange, такие как .gmi, .txt., .png, .jpg и .zip, можно просматривать внутри приложения. В этом выпуске типы локальных файлов определяются исключительно на основе расширения файла.

При просмотре каталога его содержимое отображается в виде списка ссылок. Похожая страница отображается при просмотре каталога внутри архива ZIP.

Обратите внимание, что архивы ZIP не распаковываются при просмотре структуры каталогов. Каждый запрос, который обращается к сжатому файлу в архиве, приведет к распаковке только этого конкретного файла. Это может привести к замедлению времени отклика при работе с большими сжатыми файлами.

1.11 Gempub

Gempub — это формат электронных книг/архивов, который по сути представляет собой набор файлов Gemtext, хранящихся в ZIP-архиве.

Gempub specification

Lagrange можно использовать в качестве ридера Gempub. Если файл .gpub сохранен локально, вы можете открыть его в приложении, чтобы увидеть обложку книги. На обложке вы найдете ссылку, которая открывает содержимое книги. При щелчке автоматически включается режим разделенного просмотра, и отображаются как индексная страница книги, так и первая глава (если только закрепление разделенного просмотра не отключено).

1.12 Подсказка ввода

Диалоговое окно подсказки ввода отображается, когда сервер запрашивает ввод у пользователя. Обычно вы вводите всего одно или два слова, например, поисковые запросы для поисковой системы. Однако подсказки ввода имеют несколько расширенных функций, которые могут помочь в более сложных случаях использования.

При вводе более длинного фрагмента текста может помочь масштабирование текста. Размер шрифта можно изменить с помощью клавиш, привязанных к «Увеличение» и «Уменьшение». Ширину диалогового окна можно изменить, перетащив левый или правый край с помощью мыши. Размер шрифта и ширина диалогового окна сохраняются постоянно.

Поведение клавиши Return можно переключать между отправкой ввода на сервер и вставкой переноса строки. Это можно настроить в разделе «Настройки > Пользовательский интерфейс».

В диалоговом окне есть контекстное меню для дополнительных функций. Нажмите кнопку с многоточием (⋯), чтобы открыть его.

«Вставить предыдущую строку» вставляет содержимое исходной строки Gemtext, которая непосредственно предшествует ссылке, вызвавшей открытие приглашения на ввод. Иногда это используется для действий «Изменить» в приложениях Gemini.
«Предположить, что этот URL требует ввода» изменяет то, что происходит при открытии URL-адреса приглашения. Обычно для отправки ввода требуется два запроса: первый вызывает открытие приглашения, а второй отправляет ввод пользователя на сервер. Чтобы сделать это более эффективным, вы можете предположить, что URL требует ввода, и Lagrange автоматически предложит вам перед отправкой чего-либо на сервер. (Возможно, некоторые приложения ожидают, что два запроса поступят последовательно, однако обычно проблем с прямой отправкой строк запроса не возникает.)
Восстановление прошлых записей: остальные пункты в меню предназначены для ввода, который был отправлен ранее. Выбор одного из них приведет к его вставке в поле ввода.

1.13 Экспорт/импорт данных пользователя

Функция экспорта/импорта позволяет вручную экспортировать и импортировать идентификаторы, закладки, фрагменты текста, историю просмотров и информацию о сайтах через архив ZIP.

«Данные пользователя > Экспорт» можно найти в меню Файл или меню гамбургера. На практике это создает сжатый архив, который затем можно сохранить в папке Загрузки или открыть во внешнем приложении. Оттуда вы можете вручную перенести архив на другое устройство или просто поместить в безопасное место для резервного копирования.

Открытие экспортированного архива работает аналогично пакетам шрифтов (см. раздел 2.4): при просмотре ZIP в приложении в нижней части окна есть кнопка для импорта содержащихся данных. Предоставляются подробные элементы управления для выбора того, какие данные импортируются и как, поэтому вам не нужно перезаписывать все существующие данные.

Обратите внимание, что история просмотров также содержит статус чтения записей фида, поскольку они отслеживаются на основе того, были ли посещены URL-адреса записей. Это означает, что передача пользовательских данных также включает в себя актуальный статус каждой подписки.

Автоматической службы синхронизации для обмена пользовательскими данными между несколькими устройствами не существует.

2 Настройка

В разделе «Настройки» можно найти ряд настроек для настройки пользовательского интерфейса и содержимого страницы.

2.1 Поведение при просмотре

На вкладке «Общие» «Закрепление разделенного представления» управляет тем, какие ссылки на вкладки будут открываться при просмотре в режиме разделенного представления. Режим по умолчанию — «Левая вкладка», что означает, что страница на левой вкладке закрепляется (остается неизменной) при нажатии на ссылку. Для получения дополнительной информации см. раздел 1.9.

На вкладке «Содержимое» параметр «Открывать изображения в URL-адресах данных» определяет, будут ли автоматически отображаться данные изображений, встроенные в ссылки с использованием URL-адресов данных, после завершения загрузки страницы. Это применимо только к нескольким распространенным типам медиафайлов изображений: JPEG, PNG, GIF и WebP. Обратите внимание, что максимальный размер URL-адреса имеет ограничение, поэтому эти встроенные изображения должны соответствовать настроенному ограничению, чтобы быть распознанными как допустимые ссылки. Изображения из URL-адресов данных отображаются как встроенное содержимое ссылок, как и в любой другой схеме URL-адресов.

Параметр «Открыть index.gmi в архивах ZIP» управляет тем, будут ли страницы index.gmi автоматически открываться при просмотре содержимого архива ZIP. Цель состоит в том, чтобы имитировать поведение сервера Gemini, где при открытии каталога по умолчанию будет отображаться его индексная страница. Включение этого параметра делает навигацию по архивной копии капсулы более оптимизированной.

Одной из важных характеристик Gemini является то, что вы сохраняете контроль над тем, что загружается и когда. Браузер не будет внезапно извлекать тонну изображений, автоматически воспроизводить видео или устанавливать скрытые соединения с любыми серверами отслеживания — каждый сетевой запрос является целенаправленным и запускается вручную. С учетом этого параметр «Загружать следующее изображение при нажатии клавиши прокрутки» на вкладке «UI» предназначен для помощи при просмотре только с помощью клавиатуры и для облегчения сосредоточенного чтения. При включении, если на странице видна ссылка на изображение и вы нажимаете пробел или ↓ (или любые другие клавиши, привязанные к действиям прокрутки), она будет загружена и отображена в строке _вместо_ прокрутки представления вниз. Это позволяет вам читать и видеть все содержимое страницы, нажимая всего одну клавишу на клавиатуре.

2.2 Внешний вид пользовательского интерфейса

Существует четыре различных цветовых схемы для пользовательского интерфейса: две для темного режима и две для светлого режима. Их можно выбрать на вкладке «Внешний вид» диалогового окна «Настройки»:

Темный режим: «Черный» и «Темный» имеют полностью черный или темно-серый пользовательский интерфейс.
Светлый режим: «Белый» и «Светлый» имеют полностью белый или светло-серый пользовательский интерфейс.

В macOS Lagrange автоматически переключается между темным и светлым режимами, если включен параметр «Использовать системную тему». На других платформах вам нужно будет переключаться вручную.

В Windows предоставляется возможность использовать настраиваемую рамку окна. Это обеспечивает более последовательный визуальный стиль для приложения. Однако настраиваемая рамка переопределяет поведение окна по умолчанию, поэтому, если вы опытный пользователь Windows, ожидайте, что оно не будет поддерживать все специальные взаимодействия. Например, при нажатии клавиши Windows+Влево/Вправо окно изменяет размер, чтобы занять половину экрана. Обычно Windows затем предлагает выбрать другое окно, чтобы заполнить остальную часть экрана, но этого не происходит с пользовательской рамкой окна.

2.3 Стиль и макет страницы

Вкладки «Стиль страницы» и «Макет страницы» диалогового окна «Настройки» позволяют настраивать внешний вид и расположение содержимого страницы.

2.3.1 Цветовые темы

Цветовые темы содержимого страницы выбираются на вкладке «Стиль страницы» в настройках. «Темная тема» активна в темном режиме пользовательского интерфейса, а «Светлая тема» активна в светлом режиме пользовательского интерфейса.

Цветной темный: все элементы страницы цветные; фон темный, а текст светлый. Этот режим обеспечивает наилучшее визуальное различие между различными доменами, поскольку доступно больше цветовых комбинаций.

Цветной светлый: один яркий цвет фона с черным текстом. Это самая цветная светлая тема. Обратите внимание, что цветной фон может ухудшить читаемость.

Черный: серый основной текст и яркие заголовки на черном фоне.

Серый: немного более яркая версия черного, т. е. серый основной текст и цветные заголовки на сером фоне.

Белый: цветные заголовки на белом фоне.

Сепия: светлый фон сепии с черным текстом. Не меняется в зависимости от домена; используйте его для удобства чтения, если вы предпочитаете чтение в сепии.

Океанический: в основном тема в сине-зеленых тонах с несколькими оранжевыми/красными акцентами. Яркость и насыщенность варьируются случайным образом в зависимости от домена.

Высокая контрастность: белый фон с черным текстом. Не меняется в зависимости от домена; используйте это для удобства чтения, если вы предпочитаете максимальный контраст между текстом и фоном.

Параметр «Насыщенность» можно использовать для смягчения цветов темы для более нейтрального вида.

2.3.2 Цвета, специфичные для сайта

Вы можете вручную настроить цветовую тему сайта. Откройте «Информация о странице» и нажмите «Настройки», чтобы открыть диалоговое окно настроек, специфичных для сайта. Сочетание клавиш по умолчанию для этого — ⇧+⌘+запятая.

«Семя палитры темы» — это входные данные, предоставленные генератору тем, который определяет цветовую палитру сайта. Генератор тем разработан для алгоритмического выбора палитры, цвета которой сочетаются друг с другом. Невозможно выбрать цвета темы по отдельности.

Вы можете ввести любой текст в качестве семени палитры. По умолчанию семенем является имя хоста сайта или имя пользователя, найденное в пути URL (например, «gemini://example.com/~User/» → семя «Пользователь»). Примеры использования:

Введите слово или фразу или просто случайные символы, чтобы найти понравившуюся вам тему.

Чтобы скопировать тему другого сайта, введите имя хоста этого сайта в качестве исходного.

2.3.3 Оформление текста

Шрифты для заголовков документа, основного текста и предварительно отформатированных блоков можно выбирать отдельно. Также есть отдельный шрифт для моноширинного основного текста, который используется, когда включена специфичная для Gemini/Gopher опция «Моноширинный текст». Подробнее об использовании шрифтов см. в разделе 2.4.

Опция «Жирные ссылки» определяет, используют ли ссылки жирный шрифт. Включение «Посещенные» означает, что жирный шрифт используется также для посещенных ссылок, а не только для непосещенных. «На темном» и «На светлом» включают жирные ссылки на темном/светлом фоне. Для удобства чтения рекомендуется использовать жирные шрифты на светлом фоне, поскольку различия в цвете текста и цвете значка ссылки менее заметны.

2.3.4 Параметры макета

Параметры макета абзаца:

Ширина строки: этот параметр определяет максимальную ширину текстовых строк. «Заполнение» отключает максимальный предел и подгоняет текстовые строки под всю ширину окна. (Более короткие строки, как правило, легче читать.)
Межстрочный интервал: регулируйте интервал между текстовыми строкам��. Значение 1,1 добавит на 10% больше места, а 2,0 будет означать, что между всеми текстовыми строками будет пустая строка полной высоты. Для достижения наилучших результатов поддерживайте это значение достаточно близким к 1,0. (Значения меньше 1,0 могут привести к визуальным артефактам, поскольку строки будут перекрываться.)
Ширина табуляции: количество пробелов для использования в табуляциях.
Выравнивание: абзацы выровнены, если они длиной не менее трех строк. Пробелы в каждой строке увеличиваются, чтобы уравнять ширину строк.
Большой 1-й абзац: при включении начальный абзац на странице отображается немного более крупным шрифтом. (Первый абзац автоматически определяется Lagrange, поэтому не гарантируется, что он всегда будет выбран правильно.)

Другие параметры макета:

Индикатор кавычек: цитируемый текст отображается курсивом. Кроме того, вы можете выбрать между значком кавычек и традиционной вертикальной линией вдоль левого края цитаты.
Значок капсулы слева: когда окно достаточно широкое, отображать значок капсулы на левой стороне страницы в фиксированном положении вместе с текущим заголовком уровня 1.
Свернуть предварительно отформатированные: после загрузки страницы немедленно скрыть все предварительно отформатированные блоки, отображая только альтернативные тексты.

2.4 Шрифты

Эта версия Lagrange поддерживает шрифты TrueType. Чтобы использовать новый шрифт, просто просмотрите файл .ttf в приложении, и для выполнения установки будет доступно действие нижнего колонтитула страницы. Например, попробуйте перетащить файл .ttf в окно. Кроме того, вы можете вручную скопировать шрифт в подкаталог «fonts» каталога конфигурации пользователя (см. раздел 3.5).

Вкладка «Стиль страницы» диалогового окна «Настройки» содержит параметры, которые влияют на внешний вид текста в содержимом страницы. Шрифт пользовательского интерфейса можно изменить на вкладке «Внешний вид» вместе с другими настройками рендеринга текста.

Если быть точным, на вкладке «Стиль страницы» вы можете выбрать, какие _шрифты_ использовать для определенных элементов страницы; выбор определенного шрифта (включая его размер, насыщенность, стиль и т. д.) для определенных элементов невозможен. Lagrange управляет размером и стилем текста, выбирая шрифты в соответствии с вашей темой и предпочтениями в отношении шрифтов. Термин «шрифт» часто используется в значении «гарнитура» в этом документе и в пользовательском интерфейсе приложения.

Доступно три встроенных шрифта:

«Roboto» — шрифт пользовательского интерфейса по умолчанию, который также используется для содержимого страницы.
«Source Sans» — предыдущий шрифт по умолчанию. Он более индивидуален, чем Roboto, но редко соответствует системным шрифтам.
«Iosevka» — моноширинный шрифт.

Также существует вариант «Iosevka (compact)», который фактически использует исходный межстрочный интервал шрифта. Он используется по умолчанию для предварительно отформатированных блоков, чтобы избежать пробелов между строками ASCII-арта, но не для основного текста для лучшей разборчивости.

Подробнее об управлении шрифтами, совместимости и настройке см. в разделах 2.4.4 и 5.

2.4.1 Моноширинный текст

Опция "Моноширинный текст" приводит к тому, что все страницы отображаются моноширинным шрифтом. Например, большая часть содержимого Gopher написана с предположением о моноширинном шрифте, поэтому включение этого параметра для страниц Gopher может обеспечить лучший опыт чтения. Выбранный "Моноширинный шрифт" применяется ко всему документу.

Обработка пробелов в содержимом страницы также изменяется при включении этой опции: пробелы больше не нормализуются, поэтому если в источнике где-то используется несколько пробелов, они отображаются как есть.

2.4.2 ANSI-экранирования

ANSI escape code (Wikipedia):

Escape-последовательности ANSI являются стандартом для внутриполосной сигнализации для управления местоположением курсора, цветом, стилем шрифта и другими параметрами на видеотекстовых терминалах и эмуляторах терминалов.

Иногда эти коды используются для таких вещей, как цветная графика ASCII. Однако Lagrange не является эмулятором терминала, поэтому только минимальный набор кодов имеет какой-либо эффект; остальные игнорируются.

Настройка «Escapes ANSI» управляет тем, какие escape-коды ANSI включены:

«FG Color» позволяет изменять цвет переднего плана текста.
«BG Color» позволяет изменять цвет фона текста.
«Font Style» позволяет изменять стиль шрифта: жирный, светлый, курсив, обычный или моноширинный. (Они соответствуют кодам 1, 2, 3, 10 и 11.)

Предупреждающий баннер отображается, если на странице обнаружены какие-либо коды. Это помогает вам быть в курсе потенциальных визуальных артефактов, таких как цвет текста, который принудительно становится черным независимо от цвета фона страницы. Нажмите на предупреждение, чтобы отклонить его для каждого сайта.

Если вы обслуживаете контент через Gemini, имейте в виду, что экранирование ANSI может не поддерживаться клиентами и может нарушить поведение клиента неожиданным образом. Например, рассмотрите возможность использования программы чтения с экрана или веб-прокси, которые не отфильтровывают коды. Используйте экранирование ANSI только в том случае, если пользователь каким-либо образом указал, что это его предпочтение.

2.4.3 Другие параметры шрифта

На вкладке «Содержимое» параметр «Предупреждения о глифах шрифтов» управляет тем, будет ли отображаться предупреждение, если на странице отсутствует один или несколько символов. Обычно это происходит из-за того, что страница написана на языке, который не поддерживается ни одним из установленных шрифтов. Нажатие на баннер предупреждения о глифах открывает страницу управления шрифтами.

На вкладке «Внешний вид» параметр «Сглаживание шрифтов» включает или отключает сглаживание глифов. В этой версии рекомендуется всегда включать сглаживание. Это связано с тем, что текстовый рендерер не поддерживает хинтование любого вида, что означает, что без сглаживания формы глифов будут сильно искажены. Вы все равно можете попробовать отключить этот параметр, если сглаживание вызывает у вас напряжение глаз или вы используете специальный шрифт, который не предназначен для сглаживания.

2.4.4 Управление шрифтами

Откройте "about:fonts", чтобы увидеть все установленные шрифты, а также включить, отключить или удалить отдельные пакеты шрифтов. В верхней части страницы есть ссылка на библиотеку шрифтов skyjake.fi, которая содержит тщательно подобранную коллекцию пакетов шрифтов, которые можно свободно распространять. Оттуда вы можете легко установить больше шрифтов, специально настроенных для Lagrange.

Остальная часть страницы разделена на два раздела: включенные и отключенные пакеты шрифтов. Отдельные пакеты можно отключить, чтобы они оставались установленными, но не использовались. (Совет: используйте боковую панель Outline, чтобы увидеть список всех пакетов, если их много.)

Нажмите на ссылки "Просмотреть файл", чтобы увидеть, что содержит каждый пакет шрифтов. Формат пакета шрифтов описан в разделе 5: это просто архив ZIP с некоторыми метаданными и набором файлов шрифтов. Когда вы устанавливаете шрифт TrueType (т. е. копируете его в каталог шрифтов пользователя), он рассматривается как пакет шрифтов, содержащий один файл, хотя для него не создается ZIP-архив. Используйте ссылку «Просмотреть шаблон fontpack.ini», чтобы увидеть сгенерированные метаданные, которые можно использовать в качестве основы для создания фактического пакета шрифтов.

Существует несколько мест, где Lagrange ищет пакеты шрифтов при запуске:

Каталог, содержащий двоичный файл приложения (BIN_DIR)
(BIN_DIR)/fonts
(BIN_DIR)/../share/lagrange
(BIN_DIR)/../../share/lagrange
macOS: Lagrange.app/Contents/Resources
Каталог конфигурации пользователя (CFG_DIR; см. раздел 3.5)
(CFG_DIR)/fonts

Отдельные шрифты TrueType автоматически загружаются только из последнего, (CFG_DIR)/fonts.

Если в каталоге конфигурации пользователя присутствует файл "fonts.ini", он будет загружен как метаданные fontpack (см. раздел 5). Таким образом, вы можете вручную настроить шрифты, не создавая ZIP-архив. Например:

[couriercode]
name = "Courier Code"
regular = "/home/jaakko/Fonts/Courier Code/CourierCode-Roman.ttf"
glyphscale = 0.85
monospace = true

О совместимости: шрифты сложны, и хотя формат TrueType не самый продвинутый, в нем все еще есть функции, которые не поддерживаются в Lagrange. Техническая причина в том, что глифы растрируются с помощью stb_truetype, довольно простой библиотеки шрифтов TrueType. (Она хорошая и маленькая, хотя.) Вы можете обнаружить, что некоторые шрифты просто не загружаются правильно или выглядят неправильно в приложении.

Подсказки не поддерживаются.
Растровые глифы не поддерживаются.
Многоцветные глифы не поддерживаются.

Можно использовать коллекции TrueType (.ttc) с ограничением, что каждый объявленный шрифт использует один индекс из коллекции. Индекс должен быть добавлен к имени файла:

regular = "NotoSansCJK-Regular.ttc:2"

2.5 Текстовые фрагменты и пользовательские запросы

Gemlogs часто пишутся полностью вручную, поэтому вы можете обнаружить, что печатаете или копируете-вставляете одни и те же заголовки, колонтитулы или другие небольшие фрагменты в каждый пост. Вам также может потребоваться многократно вводить определенные фрагменты текста в игру или другую интерактивную капсулу. В настольных операционных системах существует несколько существующих утилит, которые облегчают эти варианты использования. Хотя вы можете использовать их с Lagrange, приложение также имеет встроенный менеджер текстовых фрагментов, который работает на любой платформе.

В разделе «Настройки > Фрагменты» вы можете определить набор текстовых фрагментов, которые можно вставить в любое поле ввода с помощью контекстного меню поля. Фрагменты также можно создавать, щелкнув правой кнопкой мыши ссылку или выделенный текст на странице.

Текстовые фрагменты, имя которых начинается с восклицательного знака («bang»), имеют особое значение: они используются для дополнительных URL-адресов поисковых запросов. Например, если фрагмент «!w» определен как «gemini://gemi.dev/cgi-bin/wp.cgi/search», вы можете ввести следующее в поле URL-адреса панели навигации, чтобы выполнить поиск в Gemipedia:

!w Gemini Protocol

Дополнительные слова после фрагмента bang "!w" добавляются в качестве строки запроса к URL-адресу, расширенному из фрагмента. Таким образом, вы можете настроить любое количество поисков или других сочетаний клавиш, которые принимают ввод. Имена фрагментов bang могут быть длиннее одного символа, но не могут содержать пробелов.

Сочетание клавиш ⇧1 ("Введите запрос фрагмента") фокусирует поле URL и вставляет начальный символ '!', чтобы вы могли сэкономить несколько нажатий клавиш при использовании фрагментов запросов.

2.6 Прокси-серверы

Gemini позволяет передавать запросы через прокси-сервер. На вкладке "Сеть" вы можете настроить прокси-серверы для запросов Gemini, Gopher и HTTP/HTTPS.

Когда настроен прокси-сервер HTTP, ссылки HTTP/HTTPS больше не будут открываться в веб-браузере системы по умолчанию, а будут загружаться через прокси-сервер, ожидая, что он будет обслуживать версию содержимого ссылки "text/gemini".

2.7 Обработка URL

Вкладка «Сеть» в настройках содержит несколько параметров, связанных с обработкой URL.

Включение параметра «Декодировать URL» приводит к тому, что все URL с процентным кодированием отображаются в декодированном виде в пользовательском интерфейсе. Включение этого параметра полезно при обнаружении URL, содержащих символы за пределами основного латинского алфавита (A-Z). Это не влияет на то, что отправляется на сервер при загрузке страниц: запросы Gemini всегда должны отправляться в кодированном виде.

Параметр «Максимальный размер URL» определяет, что считается допустимой ссылкой в Gemtext. Строки ссылок с URL-адресами длиннее этого значения не считаются ссылками и отображаются как обычные текстовые строки. Это влияет только на ссылки, которые не используют схему «gemini». Максимальный размер URL-адреса Gemini составляет 1024 байта.

Наличие ограничения длины необходимо из-за особого случая URL-адресов данных:

RFC 2397: Схема URL-адресов «data»

С помощью URL-адресов данных можно встраивать произвольные данные в файл Gemtext с помощью строк ссылок. Это позволяет обойти преднамеренные ограничения Gemini и переопределить возможность клиентов выбирать, какие связанные ресурсы следует загружать и когда. Без ограничения сервер может, например, отправить произвольно большое вложение изображения как часть страницы, независимо от предпочтений или возможностей пользователя или клиента просматривать изображения. Также обратите внимание, что, как и любая схема, не относящаяся к Gemini, «data» не должна поддерживаться клиентами Gemini.

2.8 Сочетания клавиш

Вкладка «Клавиши» позволяет вам изменять, какие клавиши привязаны к командам пользовательского интерфейса. Щелкните мышью по элементу, а затем нажмите новую комбинацию клавиш, которую вы хотите связать с ним. Щелкните правой кнопкой мыши по привязке, чтобы стереть ее или сбросить до значения по умолчанию.

Стирание привязки может быть полезно для отключения определенных функций. Например, если вы не используете клавиатурную навигацию по ссылкам с помощью клавиши-модификатора, эту привязку можно стереть, и использование клавиши-модификатора для других целей больше не будет отвлекать вас, показывая сочетания клавиш для ссылок.

Чтобы сбросить все привязки до значений по умолчанию, выйдите из Lagrange и удалите файл «bindings.txt» в каталоге среды выполнения Lagrange. Это местоположение зависит от платформы; более подробную информацию см. ниже (в разделе «Файлы среды выполнения»).

2.9 Gopher

Lagrange преобразует меню Gopher в Gemtext для представления. Есть несколько настроек, которые управляют преобразованием.

На вкладке «Содержимое» параметр «Автоопределение стиля меню Gopher» управляет тем, должны ли меню Gopher использовать автоматически определенный стиль Gemtext. По умолчанию интерфейс Gopher в приложении имитирует интерфейс Gemini, где предварительно отформатированные ASCII-изображения находятся в отдельных блоках, а текст абзаца имеет собственный (переменной ширины) шрифт. Однако автоопределение не всегда делает это правильно. Меню с тщательно созданным ASCII иногда могут быть неправильно истолкованы. Отключение автоопределения стиля делает все текстовые строки одинаковыми по внешнему виду.

Включение моноширинного основного текста для Gopher (на вкладке «Стиль страницы») будет точно отображать исходный текст Gopher с нетронутыми исходными пробелами, а также использовать выбранный моноширинный шрифт для всего текста.

3 Интеграция ОС

3.1 Параметры командной строки

Вот некоторые из часто используемых параметров командной строки. Проверьте страницу руководства "lagrange.1" или вывод --help для более полного списка.

URL-адреса/пути

URL-адреса и пути к файлам в командной строке открываются после запуска Lagrange. Если указано более одного URL-адреса, будет открыто несколько вкладок. Например:

$ lagrange gemini://geminiprotocol.net/

--dump

Вместо открытия графического интерфейса извлекает каждый из URL/путей, указанных в командной строке, и выводит их на stdout. Метаданные об ответе будут выведены на stderr.

-E, --echo

Утилита отладки: внутренние события выводятся на stdout.

--help

Выводит список всех доступных опций.

--sw

Отключить аппаратное ускорение графики. Обратите внимание, что программный рендеринг в любом случае используется в качестве резерва, поэтому обычно эта опция не нужна.

-V, --version

Выводит версию приложения.

3.2 Открытие ссылок Gemini

В macOS и Windows Lagrange регистрирует себя как обработчик схемы URL "gemini", поэтому вы можете щелкнуть ссылки Gemini в любом приложении, чтобы открыть Lagrange с этим URL.

Аналогично (в macOS) расширения файлов .gmi/.gemini регистрируются как форматы файлов, которые Lagrange может просматривать, поэтому Finder будет знать, как открывать их автоматически с помощью Lagrange.

3.3 Перетаскивание

Вы можете перетаскивать файлы .gmi в окно Lagrange, чтобы открыть их на текущей вкладке. Перетаскивание нескольких файлов открывает их на отдельных вкладках. Это рекомендуемый способ просмотра локальных файлов, поскольку в меню нет пункта "Открыть файл". Вы также можете ввести URL-адреса "file://" в поле URL.

3.4 Управление запущенным экземпляром

Одновременно разрешено запускать только один экземпляр приложения. Это связано с тем, что каждый экземпляр использует одни и те же файлы среды выполнения (раздел 3.5) без какой-либо синхронизации. Второй экземпляр приложения перезапишет все изменения, внесенные первым, что приведет к потере закладок и другого состояния.

Если уже есть запущенный экземпляр, вы все равно можете использовать командную строку для взаимодействия с ним: вы можете открывать и закрывать вкладки, изменять текущий открытый URL или перечислять все открытые URL. См. --help для списка доступных параметров.

3.5 Файлы времени выполнения

Расположение файлов пользовательских данных можно изменить с помощью параметра --user. По умолчанию Lagrange хранит пользовательские постоянные файлы в одном из следующих мест (в зависимости от операционной системы):

   Windows : C:\Users\Name\AppData\Roaming\fi.skyjake.Lagrange
     macOS : ~/Library/Application Support/fi.skyjake.Lagrange/
Other Unix : ~/.config/lagrange/

bindings.txt

Каждая строка определяет одну комбинацию клавиш:

{binding-id} {keycode} {flags}

Идентификаторы привязки определены в src/ui/keys.c.
Код клавиши — одна из констант SDLK из SDL (шестнадцатеричная).
Флаги определяют клавиши-модификаторы:

s : Shift
a : Alt
c : Ctrl
g : Gui (Windows/Command/Meta key)
k : Caps Lock

bookmarks.ini

В этом файле хранятся все закладки и папки закладок. Формат является подмножеством TOML: поддерживаются только строки и целые числа.

[51]
url = "gemini://geminiprotocol.net/"
title = "Project Gemini"
tags = ""
icon = 0x264a
created = 1609936844  # 2021-01-06
parent = 99
order = 288

Имя таблицы (51) — уникальный идентификатор закладки.
«url», «title» и «tags» используются как есть. Для кавычек необходимо использовать экранирование обратной косой черты в стиле C (например: \"), а также опционально можно использовать для символов Unicode.
"icon" — это код UTF-32 в виде шестнадцатеричного числа.
"created" — это временная метка UNIX, указывающая, когда была создана закладка. После временной метки также указывается дата, которую может прочитать человек, но это просто комментарий — эта часть будет проигнорирована при анализе файла.
"parent" — это идентификатор родительской папки. Папки хранятся как похожие записи закладок, но их значение URL всегда представляет собой пустую строку.
"order" — для сортировки списка закладок. Список сортируется по возрастанию. Это значение автоматически обновляется при изменении порядка закладок на боковой панели.

feeds.txt

Кэшированное состояние подписок на каналы. Файл можно удалить, когда приложение не запущено, чтобы принудительно сбросить содержимое каналов. Сами подписки отслеживаются с помощью тегов закладок, поэтому удаление файл не влияет на то, какие страницы подписаны.

Файл состоит из трех разделов. Первый — это просто временная метка UNIX, указывающая, когда каналы обновлялись в последний раз. Второй раздел начинается после комментария:

# Feeds

В этом разделе каждая строка идентифицирует подписку, чтобы на нее можно было ссылаться в записях ленты:

{feed-id} {feed-url}

Идентификатор фида — шестнадцатеричное число, всегда длиной восемь символов.

Третий раздел содержит все обнаруженные записи фида. Он начинается после комментария:

# Entries

Каждая запись в ленте состоит из пяти последовательных строк:

{feed-id}

{posted-time}

{discovery-time}

{url}

{title}

Идентификатор фида — один из идентификаторов из раздела «Фиды» (без нулей для заполнения).
Время публикации — это временная метка UNIX, которая указывает, когда была опубликована запись. Она определяется по дате «ГГГГ-ММ-ДД», найденной в строке ссылки. Если это подписка на «новые заголовки», время публикации и время обнаружения совпадают.
Время обнаружения — это временная метка UNIX, которая отмечает, когда запись была добавлена в кэш.

fonts.ini

Этот файл загружается как метаданные fontpack (см. раздел 5). Его необходимо создать вручную.

idents.lgr и idents/

idents.lgr — это двоичный файл, содержащий метаданные о клиентских сертификатах, известных приложению, например, на каких URL-адресах должен быть активен определенный сертификат.

Подкаталог «idents» — это место, где хранятся фактические клиентские сертификаты. Каждый сертификат состоит из файлов .crt и .key в формате PEM. Сертификаты, созданные внутри приложения, используют отпечаток сертификата в качестве имени файла.

modmap.txt

Таблица перевода для модификаторов клавиатуры. Например, можно поменять местами клавиши Alt и Ctrl, изменив их сопоставления. См. комментарий в файле, который объясняет формат и использование.

mimehooks.txt

См. раздел 4.

palette.txt

Палитра для цветовых тем пользовательского интерфейса. Этот файл конфигурации не существует по умолчанию и должен быть создан вручную.

Фактические цвета, используемые в пользовательском интерфейсе, получены из базовой палитры. Поэтому не следует менять цвета слишком радикально, а вместо этого следовать ожидаемому шаблону: диапазон из 5 интенсивностей (черный-белый), за которым следуют две пары акцентных цветов (тусклые, яркие). Последние пять цветов зарезервированы для определенных конкретных целей, например, зеленый используется для значка блокировки панели навигации для обозначения доверенного сертификата сервера. Палитры, определенные здесь, не влияют на цветовые темы страницы, а только на пользовательский интерфейс. Обратите внимание, что значки ссылок считаются частью пользовательского интерфейса, поэтому вы можете обнаружить, что изменение палитры снизит видимость значков с некоторыми цветовыми темами страницы.

Файл определяет две палитры: одну для темного режима и одну для светлого режима. Текущая палитра выбирается с помощью строк:

# Dark

# Light

В других строках указаны цвета:

{label}: {rgb-hex}

{label}: {red} {green} {blue}

{rgb-hex} должен использовать форму "#RRGGBB"
{red}, {green}, {blue} — десятичные числа в диапазоне 0...255

Конфигурация ниже определяет встроенную палитру по умолчанию:

# Dark

black:      #000000
gray25:     #282828
gray50:     #505050
gray75:     #A0A0A0
white:      #FFFFFF
brown:      106     80      0
orange:     255     192     0
teal:       0       96      128
cyan:       0       192     255
yellow:     255     255     32
red:        255     64      64
magenta:    255     0       255
blue:       132     132     255
green:      0       200     0

# Light

black:      0       0       0
gray25:     75      75      75
gray50:     150     150     150
gray75:     235     235     235
white:      255     255     255
brown:      210     120      10
orange:     235     215     200
teal:       10      110     130
cyan:       170     215     220
yellow:     255     255     32
red:        255     64      64
magenta:    255     0       255
blue:       132     132     255
green:      0       150     0

prefs.cfg

Постоянные переменные конфигурации. Файл перезаписывается при закрытии приложения. Каждая строка интерпретируется как внутреннее событие пользовательского интерфейса, подобное тем, которые выводятся с помощью параметра командной строки --echo.

state.lgr

Двоичный файл, содержащий текущее состояние приложения: открытые вкладки и их позиции прокрутки, а также историю навигации с кэшированным содержимым страницы (до настроенного лимита кэша). Вы можете удалить этот файл, когда приложение не запущено, чтобы закрыть все вкладки и очистить кэш содержимого страницы.

sitespec.ini

Настройки, специфичные для сайта.

trusted.2.txt

Сертификаты доверенных серверов. Каждая строка указывает отпечаток сертификата одного сервера:

{domain};{port} {valid-until} {fingerprint}

Доменные имена хранятся в формате punycode, если они содержат символы, не входящие в ASCII.
Дата истечения срока действия «действителен до» — это временная метка UNIX.
Отпечаток пальца — это контрольная сумма SHA256 открытого ключа сертификата сервера в формате DER.

uploadbackup.txt

Резервная копия текста, введенного в диалоговом окне «Загрузить с помощью Titan».

uploadtoken.txt

Резервная копия токена сервера.

visit.2.txt

Объединенная история навигации по всем вкладкам. Каждая строка указывает один URL:

{last-visited} {flags} {url}

Время последнего посещения сохраняется как временная метка UNIX.
Флаги всегда имеют длину четыре байта:

0000 : No flags set
0001 : Transient
0002 : Kept

Флаг Transient используется для указания перенаправлений и для маркировки записей фида как прочитанных без фактического посещения URL. URL-адреса с флагом Transient не отображаются на боковой вкладке History.

Флаг Kept используется для предотвращения удаления URL-адреса из-за его старения. Обычно URL-адреса в истории навигации устаревают через несколько месяцев и удаляются из файла.

3.6 Переменные среды

LAGRANGE_OVERRIDE_DPI

Переопределить определение DPI дисплея с помощью значения, предоставленного пользователем. Одно и то же значение применяется ко всем дисплеям. Это полезно, если значение DPI вашего дисплея определяется неправильно. Пример:

LAGRANGE_OVERRIDE_DPI=96

4 MIME-хуки

MIME-хуки позволяют передавать ответы Gemini через внешние программы для произвольной обработки. Это позволяет использовать скриптовые языки и исполняемые двоичные файлы для выполнения преобразований форматов, преобразования контента и анализа данных.

Хуки настраиваются с помощью файла "mimehooks.txt" в каталоге конфигурации Lagrange. Каждый хук имеет регулярное выражение, которое сопоставляется с типом и параметрами ответа MIME, и каждому соответствующему хуку предлагается тело ответа через stdin. Вызванные внешние программы могут свободно переписывать весь ответ, включая тип MIME. Если один из хуков возвращает допустимый ответ, он используется в качестве окончательного ответа запроса Gemini.

Примеры вариантов использования:

Анализ XML-канала Atom и генерация индексной страницы канала Gemini
Отображение MIDI-файла с помощью Timidity в виде PCM WAV
Генерация графа PNG на основе значений в CSV
Преобразование HTML или Markdown в 'text/gemini'
Переводы на другие языки

4.1 Интерфейс

Когда вызывается хук, ему задается тип MIME и параметры через аргументы командной строки. Тело ответа предоставляется через stdin. URL запроса доступен в переменной среды REQUEST_URL.

Тип MIME и параметры разделяются точками с запятой, поэтому "text/gemini; lang=ja" будет вызываться как:

hookprogram text/gemini lang=ja

Вывод программы (через stdout) должен представлять собой допустимый ответ Gemini «20», включающий новый тип MIME:

20 text/gemini; lang=en\r\n
{...body...}

Любой вывод, который не соответствует этому формату, считается означающим, что хук отказался обрабатывать содержимое. Вместо этого ответ будет предложен следующему хуку.

4.2 Синтаксис mimehooks.txt

Как и другие строки конфигурации Lagrange, mimehooks.txt имеет простой строчно-ориентированный синтаксис. Lagrange необходимо перезапустить, чтобы изменения в файле конфигурации вступили в силу.

Каждый хук указывается в виде трех строк:

Человекочитаемая метка (для отчета пользователю)
Регулярное выражение типа MIME/параметра
Команда для выполнения, а также дополнительные аргументы, каждый из которых разделен точкой с запятой

Например:

Convert Atom to Gemini feed
application/xml
/usr/bin/python3;/home/jaakko/atomconv.py

Программа-хук выполняется напрямую, без участия оболочки. Это означает, что скрипты должны вызываться через исполняемый файл интерпретатора.

4.3 Пример: преобразование из Atom в Gemini

Следующий простой скрипт Python демонстрирует, как можно использовать хук MIME для анализа XML-документа Atom с помощью Python 3 и вывода страницы индекса ленты Gemini на основе проанализированных записей. Это всего лишь простой пример; более надежный скрипт мог бы включать больше контента из ленты Atom и также обрабатывать ошибки.

import sys
import xml.etree.ElementTree as ET

def atomtag(n):
    return '{http://www.w3.org/2005/Atom}' + n

root = ET.fromstring(sys.stdin.read())
if root.tag != atomtag('feed'):
    sys.exit(0)
feed_title = ''
feed_author = ''
feed_entries = []
for child in root:
    if child.tag == atomtag('title'):
        feed_title = child.text
    elif child.tag == atomtag('entry'):
        feed_entries.append(child)
print("20 text/gemini\r")
print(f'# {feed_title}')
for entry in feed_entries:
    entry_date = ''
    entry_title = ''
    entry_link = ''
    for child in entry:
        if child.tag == atomtag('updated'):
            entry_date = child.text[:10]
        elif child.tag == atomtag('title'):
            entry_title = child.text
        elif child.tag == atomtag('link'):
            entry_link = child.attrib['href']
    print(f'=> {entry_link} {entry_date} {entry_title}')

5 Fontpacks

Fontpack — это формат файла, определенный Lagrange, который используется для объединения набора файлов шрифтов с метаданными конфигурации. (Незарегистрированный) тип носителя для файлов .fontpack — «application/lagrange-fontpack+zip».

Fontpack — это ZIP-архив, который должен иметь файл «fontpack.ini» на корневом уровне.

version = 1

[firasans]
name        = "Fira Sans"
glyphscale  = 0.85
regular     = "FiraSans-Regular.ttf"
italic      = "FiraSans-Italic.ttf"
light       = "FiraSans-Light.ttf"
semibold    = "FiraSans-SemiBold.ttf"
bold        = "FiraSans-Bold.ttf"

Пакеты шрифтов могут использовать метод сжатия Deflate, но это может замедлить запуск приложения, поскольку каждый шрифт должен быть распакован перед загрузкой. Поэтому рекомендуется использовать параметр -0 (--compression-method store) при создании архива. Параметр -j (--junk-paths) также может оказаться полезным, если текущий рабочий каталог не является тем, в котором находится fontpack.ini.

Каждый пакет шрифтов имеет идентификатор, который получается из имени файла: идентификатор "firasans.fontpack" будет "firasans". В идентификаторе не допускаются пробелы.

Пакеты шрифтов версионируются, т. е. в их метаданных указан номер версии. Это позволяет определить, является ли пакет шрифтов обновленной версией существующего. Однако идентификатор пакета шрифтов (имя файла) должен оставаться прежним независимо от номера версии.

Файл "fontpack.ini" использует синтаксис TOML и может указывать любое количество гарнитур. В приведенном выше примере строка `[firasans]` начинает определение гарнитуры с именем "firasans". Если одна и та же гарнитура найдена в нескольких пакетах шрифтов, используется только первая загруженная; остальные игнорируются. Идентификаторы гарнитур могут совпадать или отличаться от идентификаторов пакетов шрифтов; они существуют в разных пространствах имен. Идентификатор гарнитуры — это то, что фактически используется в "prefs.cfg" для сохранения ваших настроек шрифта.

5.1 Свойства Fontpack

`version` определяет номер версии fontpack. Это одно целое число, и если оно опущено, по умолчанию оно равно нулю. Оно не имеет особого значения, за исключением того, что большие значения считаются более новыми версиями.

5.2 Свойства гарнитуры

5.2.1 Общие

`name` (строка) — это понятное человеку имя гарнитуры. Оно используется в диалоговом окне «Настройки» и в других местах пользовательского интерфейса.

5.2.2 Приоритет и исключение

Один и тот же глиф(ы) символа может быть найден в нескольких шрифтах, поэтому для выбора наиболее подходящего шрифта применяется приоритет. Выбор шрифта также может зависеть от контекста, например, предварительно отформатированные блоки должны отображаться с использованием моноширинных шрифтов. Эти свойства управляют тем, когда и будет ли использоваться гарнитура.

`priority` (целое число) определяет порядок сортировки гарнитур. Шрифты с наивысшим приоритетом проверяются в первую очередь.
`override` (bool): всегда ли эта гарнитура проверяется первой перед любой другой в любом контексте. Только одна гарнитура может использовать этот флаг.
`monospace` (bool): является ли это моноширинной гарнитурой и, следовательно, подходит для предварительно отформатированных блоков и моноширинного основного текста.
`auxiliary` (bool): если true, эта гарнитура не включена в Preferences как выбор шрифта, но все равно проверяется на наличие глифов, если другие шрифты их не предоставляют. Подходит для различных символов или дополнительных языков, например.
`allowspace` (bool): если true, используются метрики вспомогательного шрифта для символов пробела. Иногда символьные шрифты имеют очень широкие пробелы, поэтому, например, пробел рядом с эмодзи будет слишком широким. Это не имеет никакого эффекта для невспомогательных шрифтов.

5.2.3 Метрики

Эти свойства можно использовать для изменения высоты и интервала шрифта.

`height` (float) — множитель для изменения высоты шрифта. Он может быть не более 2,0, чтобы удвоить высоту. Это просто масштабирует шрифт меньше или больше, не изменяя интервал.
`glyphscale` (float) масштабирует глифы меньше, не изменяя высоту шрифта. Значение должно быть 1,0 или меньше. По сути, это позволяет увеличить интервал между последовательными строками текста. Его можно объединить с `height`, чтобы сохранить глифы того же размера, но просто увеличить межстрочный интервал. Например, `glyphscale` 0,833 будет противодействовать масштабированию, вызванному `height` 1,2, увеличивая межстрочный интервал в 1,2 раза.
`voffset` (float) — множитель, применяемый к вертикальному смещению, которое обычно центрирует масштабированные глифы на строке. Это позволяет точно настроить, где заканчивается базовая линия масштабированных глифов. Установка этого значения в 1,0 означает, что глифы будут вертикально центрированы после масштабирования с помощью `glyphscale`; 0,0 отключит центрирование. Разумные значения, скорее всего, находятся в диапазоне 0,5…1,5, в зависимости от масштабирования.

Изменение только свойства `glyphscale` является рекомендуемым способом изменения межстрочного интервала. Это упрощает смешивание и сопоставление шрифтов в одной строке без необходимости иметь дело с изменениями высоты текста. Сравните скорректированное масштабирование, чтобы увидеть, выглядит ли оно подходящим рядом с обычным основным текстом.

Каждое из этих свойств можно задать отдельно для текста пользовательского интерфейса и содержимого страницы с помощью префиксов `ui.` и `doc.`. Например, чтобы масштабировать шрифт только при использовании в пользовательском интерфейсе, задайте `ui.height` вместо `height`.

5.2.4 Файлы шрифтов

Одна гарнитура шрифта может использовать до пяти файлов шрифтов.

`regular` (строка): путь к файлу шрифта для обычного стиля. Относительный путь означает, что файл загружается из архива fontpack. Абсолютные пути можно использовать для ссылки на файлы в локальной системе.
`italic` (строка): путь к файлу шрифта для курсивного стиля.
`light` (строка): путь к файлу шрифта для легкого начертания.
`semibold` (строка): путь к файлу шрифта для полужирного начертания.
`bold` (строка): путь к файлу шрифта для жирного начертания.

Требуется только обычный стиль. Неопределенные стили возвращаются к ближайшему доступному стилю. Один и тот же путь к файлу можно использовать в нескольких стилях; в память будет загружена только одна копия файла.

Если путь ссылается на коллекцию TrueType (.ttc), к имени файла необходимо добавить индекс используемого шрифта:

regular = "NotoSansCJK-Regular.ttc:2"

6 Архивы пользовательских данных

Архивы пользовательских данных Lagrange представляют собой сжатые ZIP-архивы, содержащие историю просмотров, идентификаторы, закладки, текстовые фрагменты, настройки, специфичные для сайта, и/или отпечатки доверенных сертификатов сервера.

Архив экспорта в значительной степени отражает содержимое каталога времени выполнения (раздел 3.5). Однако файл метаданных "lagrange-export.ini" также должен присутствовать:

# Lagrange user data exported on 2022-04-01 13:34
version = "1.12.0"
timestamp = 1648809264

`version` (строка): Версия приложения, сгенерировавшего архив.
`timestamp` (целое число): Время генерации в виде временной метки UNIX.

7 Misfin

Misfin — это протокол обмена сообщениями, который находится в разработке с мая 2023 года. Как и Gemini, он использует TLS и простые текстовые запросы с форматом содержимого «text/gemini».

Lagrange поддерживает Misfin с версии 1.18. Вы можете импортировать сертификаты удостоверения Misfin и отправлять сообщения с их помощью. Вам по-прежнему понадобится почтовый ящик Misfin, в котором вы можете получать сообщения — серверы должны проверять личность неизвестных отправителей, проверяя, соответствует ли сертификат отправителя сертификату, предоставленному их сервером.

Сертификат удостоверения Misfin — это клиентский сертификат TLS, где:

Поле UID указывает имя почтового ящика
Альтернативное имя(я) субъекта указывает доменное имя(я)
Общее имя — это понятное человеку имя

Вам нужно будет импортировать один или несколько из них перед отправкой любых сообщений.

При отправке сообщения диалоговое окно «Загрузить» открывается в режиме Misfin с полями «Кому» и «От». Как обычно, текстовый редактор в диалоговом окне имеет базовую подсветку синтаксиса Gemtext, но в остальном редактор не имеет ничего специфичного для Misfin. Предусмотрен переключатель, если вы хотите отправить копию сообщения себе. Lagrange не сохраняет копии отправленных сообщений, поскольку не поддерживает локальный почтовый ящик Misfin.

При нажатии на ссылку с URI "misfin://" диалоговое окно открывается автоматически с предварительно заполненным адресом получателя.

Misfin specification(s) and resources

Original Misfin specification

s/Misfin on BBS

Лицензии с открытым исходным кодом

about:license