Read in:
Русский

Кто может прочитать заметку

Страница отвечает на два вопроса: кто может прочитать заметку и что видят остальные. После неё вы по 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.

Смотрите также