Русский
Кто может прочитать заметку
Страница отвечает на два вопроса: кто может прочитать заметку и что видят остальные. После неё вы по frontmatter заметки скажете, что получит гость, авторизованный читатель, подписчик и агент: на странице, в поиске, в лентах и через MCP. Прочитайте её до того, как класть платные или внутренние заметки рядом с публичными. Как завести подграф и выдать доступ, описано в Подграфах; здесь описан результат.
Правило
Заметка закрыта, пока её что-то не открыло. Решают два ключа frontmatter:
free: true # everyone, guests included
subgraph: paid # readers who hold access to "paid"
| Заметка | Гость | Вошёл, доступов нет | Доступ к другому подграфу | Доступ к этому подграфу | Админ |
|---|---|---|---|---|---|
free: true |
читает | читает | читает | читает | читает |
нет free, нет subgraph |
пейвол | пейвол | читает | — | читает |
subgraph: paid |
пейвол | пейвол | пейвол | читает | читает |
subgraph: members, у members включён Require sign-in |
форма входа | читает | читает | читает | читает |
Из таблицы следуют четыре вещи.
free: trueсильнее всего остального. Бесплатная заметка в платном подграфе публична. Подграф её по-прежнему группирует, но больше не закрывает.- Заметка без подграфа не приватна. Её читает любой, у кого есть доступ хотя бы к одному подграфу. На сайте с несколькими аудиториями помечайте каждую заметку. В Подграфах есть патч, который делает это для всего хранилища.
- Несколько подграфов значат «любой из них».
subgraphs: [beta, paid]открывает заметку читателю с доступом к одному из двух. - Доступ проверяется при каждом запросе. Истёкший или отозванный доступ перестаёт работать со следующего запроса читателя.
«Доступ к подграфу» — это активная запись доступа: куплена через оффер, получена через уровень Patreon или Boosty либо Telegram-группу, выдана вручную в админке. Подробнее: Монетизация и Доступ через Telegram-группу.
Файлы .html (лейауты) как заметку не получает никто, кроме админа.
Что видит читатель без доступа
Страница открывается, но вместо текста на ней стена.
| На стене | Показано |
|---|---|
| Заголовок | да |
description из frontmatter |
да |
| Форма входа или офферы, которые открывают заметку | да |
| Текст заметки, включая первый абзац | нет |
| Описание, собранное из текста | нет |
Гость получает статус 401, авторизованный читатель без доступа — 403. Обе стены отдаются с noindex и не кешируются.
В шапке страницы остаётся og:image со ссылкой на картинку-превью заметки. Сам файл картинки проверяется как любой ассет (см. ниже). Поэтому превью ссылки на закрытую заметку покажет заголовок без картинки, если та же картинка не стоит ещё и в бесплатной заметке.
Заголовок и description закрытой заметки публичны. Не пишите в них то, что должны прочитать только подписчики.
Где закрытая заметка всё равно видна
| Место | Что получает читатель без доступа |
|---|---|
| Страница самой заметки | стена: заголовок и description |
| Карточки журнала | заголовок, дата и ссылка; description, если он задан; текста заметки нет |
| Поиск по сайту | заголовок и ссылка, вместо фрагмента текста — постоянная заглушка |
| Вики-ссылка в заметке, которую он читает | ссылка с заголовком закрытой заметки |
| Вставка в заметку, которую он читает | весь текст (см. ниже) |
| Похожие заметки | ничего |
| RSS и карта сайта | ничего: в обоих только бесплатные заметки |
| [[ru/user/note-queries | Запросы к заметкам]] |
MCP search |
ничего |
MCP note_html, expand |
Note not found — тот же ответ, что и для несуществующей заметки |
Запустите сервер с флагом --search-hide-unreadable, и закрытые заметки пропадут из поиска по сайту вместе с заголовками.
Вставленная заметка видна целиком
![[Другая заметка]] копирует готовый текст другой заметки в ту, куда её вставили. Так же работает content: [[Другая заметка]] в дефолтном шаблоне. Кто увидит результат, решает доступ принимающей заметки. free и subgraph вставленной заметки при этом не проверяются.
---
free: true
---
Intro everyone reads.
![[Paid lesson]]
Здесь любой посетитель читает Paid lesson целиком, хотя на её собственной странице стоит пейвол. Копия уходит вместе с принимающей заметкой: на страницу, во фрагмент поиска, в RSS и в ответы MCP.
Так код работает сейчас. Вставляйте закрытую заметку только в заметку с таким же или более узким доступом. Подробнее о вставках: Встраивание заметок.
Заметки с _ в начале имени
Файл или папка с именем на _ — системная заметка. Её нет в карточках журнала, поиске по сайту, похожих заметках, RSS и MCP search, а её собственный адрес отвечает 404. Вставить её по-прежнему можно, и агент откроет её по пути через MCP, если правило выше это разрешает.
Подчёркивание убирает заметку из списков. Это не настройка доступа: кто может её прочитать, по-прежнему решают free и subgraph.
Скрытые заметки
hide в updateNotes снимает заметку с сайта и не меняет её содержимое. Скрытую заметку не получает ни один читатель: нет ни страницы, ни результата в поиске, ни записи в ленте.
Ассеты
Картинки и вложения следуют за своими заметками.
- Ассет, который использует хотя бы одна бесплатная заметка, лейаут либо шапка или подвал сайта, отдаётся всем.
- Любой другой ассет получает авторизованный читатель, который может прочитать хотя бы одну заметку с этим ассетом.
- Запрос с действующим заголовком
X-API-Keyполучает любой ассет.
Черновики и релизы
Релизы решают, какую версию заметки получают читатели. Настройка называется Show Draft Versions и по умолчанию включена.
| Show Draft Versions | Страницы, поиск по сайту, карта сайта | Инструменты MCP, запросы к заметкам, похожие заметки |
|---|---|---|
| включена | последняя синхронизированная версия | последняя синхронизированная версия |
| выключена | версия из живого релиза | последняя синхронизированная версия |
При выключенной настройке второй столбец — известный пробел: эти читатели не ждут релиза. Заметка, которую вы синхронизировали, но ещё не выпустили, им уже видна, и доступ к ней берётся из её самого свежего frontmatter. Если добавить в черновик free: true, анонимный агент прочитает этот черновик через MCP раньше, чем релиз станет живым.
Админ всегда ищет по последним версиям. На странице он выбирает версию параметром: ?version=latest или ?version=live.
Ключи и токены
| С чем пришёл запрос | Что читает |
|---|---|
| Ни с чем (анонимный MCP-клиент) | бесплатные заметки |
Cookie сессии или персональный токен (t2g_…) |
то же, что этот пользователь |
API-ключ в X-API-Key |
все заметки и все ассеты |
| Ограниченный токен вебхука | заметки, подходящие под read_patterns доставки, и больше ничего |
API-ключ — это доступ владельца. Агенту читателя дайте персональный токен; как его создать, написано в GraphQL API. Ограниченные токены описаны в Вебхуках при изменении заметок и Fleet.
Свои лейауты
Лейаут, который пишете вы, может прочитать любую заметку хранилища и вывести любую её часть. Правило доступа относится к заметке, которую открыл посетитель, а не к тому, что лейаут подтянул рядом с ней. В лейауте-ленте добавьте к списку заметок .Public(), и в нём останутся только бесплатные:
{{ range i, n := nvs.ByGlob("blog/**").Public().All() }}
<a href="{{ n.Permalink() }}">{{ n.Title() }}</a>
{{ end }}
noteQuery(...) в лейауте устроен иначе: он выполняется с доступом посетителя.
Когда вашу базу ищет другая база
Федеративный сосед — ещё один вид читателя. Его ключ ограничен списком подграфов, и таблица выше действует на него как на читателя с доступом ровно к этим подграфам. Кто кого может искать и что при этом видно, настраивается отдельно: приём показан в Разделении контекста, настройка — в MCP Federation.
Смотрите также
- Подграфы: как пометить заметки, выдать и отозвать доступ
- Монетизация: офферы, Patreon, Boosty, криптовалюта
- Встраивание заметок
- Три зоны: приватное, публичное, платное