Статья начинается с черновика. Каждое сохранение создаёт новую ревизию, а читатели ничего не увидят, пока вы не опубликуете одну из них. В этой инструкции — как писать, публиковать и сопровождать статьи. Коллекции и категории описаны в разделе
: в меню коллекции или категории есть та же кнопка, и статья сразу окажется в этом разделе.
Заголовок — то, что видят читатели.
Адрес — ссылка для читателей: /articles/{адрес}/. Он не зависит от коллекции, поэтому статью можно свободно перемещать. При смене адреса существующей статьи остаётся перенаправление, и старые ссылки продолжают работать.
Краткое описание — одно-два предложения для списков и результатов поиска.
Текст — тело статьи в Markdown.
2
Пишите в Markdown
Рядом с текстом редактор показывает предпросмотр, который рендерит сервер, — ровно то, что получат читатели. Предупреждения и битые ссылки перечислены под полем. Что поддерживает рендерер:
Выноски: > [!NOTE], а также TIP, IMPORTANT, WARNING и CAUTION. Подпись выводится на языке страницы.
Ссылки на другие статьи: [текст](doc:<uuid статьи>). Они указывают на идентификатор статьи, а не на адрес, поэтому переименование их не ломает. Кнопка с книгой в панели инструментов подставит ссылку сама.
Файлы:  для изображения, [файл](asset:<uuid>) для документа. Кнопка загрузки в панели инструментов делает это за вас.
Оглавление собирается из заголовков 2–4 уровней автоматически.
HTML не рендерится — он появится как текст. Изображения с других сайтов на приватных страницах блокируются — загрузите изображение сюда.
## Как оплатить счёт
> [!TIP]
> Счёт нужно оплатить в течение 14 дней.
1. Откройте **Оплата и счета** и выберите счёт.
2. Выберите способ оплаты — см. [Способы оплаты](doc:5d1c7c0e-8f2a-4b3e-9a6d-2b1f0c9e7a11).
Коллекция и Категория определяют место статьи в структуре. Размещение действует сразу после сохранения, но читатели увидят статью только после публикации.
Метки общие для всей страницы. Введите название, чтобы создать метку на месте; у каждой метки есть своя страница /tags/{адрес}/. Переименовать или удалить метку можно на вкладке
Метки
.
Рекомендуемая — статья выделяется на главной странице и в своей коллекции.
В разделе
Расширенные настройки
— SEO-заголовок, SEO-описание и, для уже созданной статьи, Комментарий к изменению: он сохраняется вместе с ревизией и виден в истории.
4
Сохраните и опубликуйте
Сохранить черновик
создаёт новую ревизию черновика. Для читателей пока ничего не меняется. Чтобы выпустить статью, откройте вкладку
Публикация
:
Опубликовать
— текущий черновик сразу появится на сайте. После новых правок у статьи появятся неопубликованные изменения: читатели видят прежнюю ревизию, пока вы не опубликуете снова.
Запланировать
— укажите дату и время; черновик в его нынешнем виде выйдет автоматически. Если после этого отредактировать статью, новый текст не выйдет, пока вы не перепланируете публикацию.
Снять с публикации
— статья скрывается с сайта, адрес отдаёт ошибку 404, черновик сохраняется.
В архив
— статья убирается с сайта, а адрес остаётся за ней, чтобы старая ссылка никогда не привела к чужому тексту. Статью из архива можно восстановить в любой момент.
Удаления нет: чтобы вывести статью из обращения, отправьте её в архив.
5
История ревизий
На вкладке
История ревизий
перечислены все сохранения с номером, датой и комментарием, а также отмечено, какая ревизия опубликована, запланирована или является текущим черновиком. Любую ревизию можно открыть и прочитать или восстановить — старый текст копируется вперёд как новый черновик, история никогда не переписывается.
6
Связанные статьи
На вкладке
Связанные статьи
собран упорядоченный список, который показывается под статьёй на сайте. Добавьте статьи, перетащите их в нужном порядке и нажмите Сохранить список — весь список сохраняется целиком.
7
Работа с большим числом статей
На вкладке
Статьи
собраны все статьи страницы с фильтрами по состоянию и коллекции и поиском по заголовку. Отметьте несколько строк, чтобы опубликовать, снять с публикации, архивировать или переместить их разом.
Первая статья опубликована — читатели уже могут её найти 🚀