Как редактировать базу знаний
Как открыть Studio
Редакторская часть доступна по адресу /_studio на домене документации.
STUDIO_GOOGLE_MODERATORS.Основной процесс
- Откройте
https://docs.lite-invest.com/_studio. - Войдите через Google OAuth.
- Создайте или откройте Markdown-файл в нужном разделе
content: напримерcontent/getting-started/new-page.mdилиcontent/payments/new-page.md. - Проверьте URL: публичный адрес формируется из пути файла, например
content/payments/top-up-basics.mdоткрывается как/payments/top-up-basics. - Заполните frontmatter:
title,description,tags,updatedAt,cover,featured,priority,navigationиseo. - Если нужно изменить порядок разделов или статей, обновите соответствующий
.navigation.yml. - При необходимости загрузите изображения или документы в
/public. - Используйте Markdown/MDC компоненты для заметок, шагов, изображений и видео. Небольшие изображения Studio оставит в исходном размере; крупные автоматически уместятся в колонку статьи.
- Опубликуйте изменения. Studio создаст commit в GitHub branch
main.
content/: всё, что лежит в этом каталоге, считается публичной базой знаний. Материалы, которые не должны попадать в навигацию, поиск и sitemap, храните вне content/, например в drafts/.Компоненты в статьях
Для заметок используйте note, warning и tip, для инструкций steps, для изображений image-figure, для видео video-embed.
Размер изображений
Обычная картинка, добавленная через Studio, по умолчанию не увеличивается больше своего исходного размера — так небольшие скриншоты остаются чёткими. Большая картинка при этом не выйдет за пределы колонки статьи. При нажатии изображение увеличивается в два раза, но не больше 95% ширины или высоты окна.
Если скриншот нужно намеренно растянуть на всю ширину колонки, в Markdown добавьте к нему класс full-width:
{.full-width}
Для компонента image-figure используйте параметр full:
::image-figure{src="/media/screenshot.png" alt="Описание скриншота" full}
::
Не добавляйте в статьи пароли, токены, значения .env и внутренние ссылки, не предназначенные для публичного доступа.