Разделы, главы и статьи
Обновлено
Разделы
Откройте «База знаний → Все разделы». Нажмите название раздела, чтобы увидеть вступление, главы и статьи. «Настройки раздела» открывают параметры проекта.
| Настройка | Что делает | Значения / по умолчанию |
|---|---|---|
| Заголовок | Название раздела | Обязательный текст |
| Адрес страницы | Часть адреса раздела | Подставляется из названия при создании; должен быть уникальным среди разделов |
| Теги | Объединяют разделы в группы для фильтра главной | Несколько тегов; изначально нет |
| Описание | Краткая характеристика раздела | Текст; изначально пусто |
| Вид проекта | Классификация раздела | «Тема дизайна», «Приложение», «Плагин»; по умолчанию «Плагин» |
| Статус | Доступность раздела посетителям | «Черновик» / «Опубликовано»; новый раздел — черновик |
| Иконка | Символ раздела в списке бэкенда | Текст; пусто — стандартная иконка |
| Цвет | Цвет символа раздела в списке бэкенда | Текстовое значение цвета; изначально пусто |
| Вступление (Markdown) | Содержание стартовой страницы раздела | Markdown; изначально пусто |
Поля «SEO и социальные сети» описаны в статье о SEO.
При создании раздела автоматически появляется страница _index. Она служит вступлением по адресу раздела и не попадает в обычное меню статей, поиск и блок недавних обновлений. Её можно открыть отдельно из списка проекта. Не меняйте этот адрес, если страница должна оставаться вступлением.
Главы и порядок
Нажмите «Новая глава», укажите «Заголовок» и нажмите «Создать». У главы нет отдельной публичной страницы: она группирует статьи в меню.
Главы можно редактировать, удалять и перемещать выше или ниже. Удаление главы оставляет её статьи в группе «Без главы».
Статьи можно перетаскивать внутри главы и между главами. Есть кнопки «Поднять», «Опустить» и список «Перенести в главу». При активном поиске или фильтре по главе перетаскивание отключено: очистите фильтры, чтобы вернуть его.
Порядок разделов меняется через «Действия → Поднять / Опустить». Порядок плиток главной задаётся отдельно в настройках хаба.
Редактор статьи
При создании статьи сначала укажите заголовок, адрес, главу и статус и нажмите «Создать». После создания доступны содержание, краткое описание и SEO.
| Настройка | Что делает | Значения / по умолчанию |
|---|---|---|
| Заголовок | Название статьи | Обязательный текст |
| Краткое описание | Описание для списков; может использоваться как запасное SEO-описание | Текст; изначально пусто |
| Содержание (Markdown) | Основной текст статьи | Markdown; изначально пусто |
| Статус | Публикует статью или оставляет черновиком | «Черновик» / «Опубликовано»; новая статья — черновик |
| Адрес страницы | Часть адреса статьи | Уникален внутри выбранного раздела |
| Раздел | Принадлежность статьи | Выбор раздела; при смене поле главы сбрасывается |
| Глава | Группа в меню | Глава текущего раздела или «Без главы» |
Для адресов используйте буквы, цифры, дефис и подчёркивание без пробелов и слешей. Адрес search занят поиском и недоступен для раздела.
Режим «Исходник» показывает Markdown, «Предпросмотр» — результат, «Рядом» — обе области. Сохраняйте кнопкой «Сохранить» или Ctrl/Cmd + S. Предпросмотр не сохраняет текст автоматически.
Markdown поддерживает заголовки, списки, ссылки, изображения, таблицы и ограждённые блоки кода. Заголовки второго и третьего уровней образуют оглавление. HTML внутри Markdown выводится как текст. Изображение добавляется обычной Markdown-ссылкой на доступный URL:
## Установка
1. Откройте настройки.
2. Сохраните изменения.
Вставки :::tip, :::warning, :::info, :::danger и :::details с закрывающей строкой ::: создают выделенные блоки. Например:
:::tip Подсказка
Проверьте результат после сохранения.
:::Если статья хранится в прежнем HTML-формате, она доступна в предпросмотре. «Перейти на Markdown» предлагает заменить содержание новым Markdown-текстом; автоматического преобразования HTML в заполненный Markdown нет.
Черновики и публикация
У статьи и раздела независимые статусы. Опубликованная статья внутри чернового раздела недоступна обычному посетителю. Изменение статуса раздела меняет статус вступления _index, но сохраняет статусы остальных статей.
«Открыть на сайте» позволяет посмотреть сохранённую статью. Для черновика добавляется ?preview=1; просмотр работает только с доступом к бэкенду «Базы знаний».
Статус — свойство всей статьи. Если изменить уже опубликованную статью и сохранить её с прежним статусом, посетители увидят изменения. Для подготовки непубличного текста переведите статью в «Черновик»; отдельной параллельной черновой версии нет.
Удаление статьи требует подтверждения. Чтобы удалить раздел, сначала удалите его статьи, вступление _index и главы.