Система имён [N], [C], [A]
Система имён нужна, чтобы одна файловая структура могла описывать навигацию, категории и страницы без отдельного ручного описания каждого элемента.
Что означает каждый префикс
| Префикс | Тип | Что создаёт |
|---|---|---|
[N] | section | Верхнюю секцию навигации |
[C] | category | Категорию внутри секции |
[A] | page | Страницу внутри категории или секции |
Полный формат имени
Где:
[ПРЕФИКС]— один из[N],[C],[A].Название— человекочитаемый заголовок.{slug}— URL-safe slug.
Как это реализовано в коде
Реализация находится в src/lib/content/naming.ts. Главные функции:
parseNamedContentPath возвращает объект с типом, названием и slug.
Создание секции
Результат:
Создание категории
Результат:
Создание страницы
Результат:
Как подключается текущая навигация
Навигация описывается в src/lib/config/navigation.ts. Система имён служит утилитарным слоем: она умеет парсить и создавать имена файлов, а структура sidebar задаётся вручную через contentSections.
Система кастомных страниц
Кастомные страницы нужны, когда страница должна быть не обычным .svx файлом, а полноценным Svelte-компонентом, например landing page, interactive demo, playground или страница со сложной логикой.
Где находится registry
Формат кастомной страницы
Пример подключения
Как loader находит кастомные страницы
src/lib/content/sections.ts сначала ищет .svx, потом проверяет registry кастомных страниц, потом обычные .svelte content-файлы.
Когда использовать .svx, .svelte и custom page
| Формат | Когда использовать |
|---|---|
.svx | Обычная документация, markdown, markdown blocks |
.svelte | Страница с компонентной логикой, но лежит как content-file |
customPages | Страница генерируется/регистрируется из кода и может не иметь file-backed markdown |
Markdown chart blocks
Графики пишутся как markdown block :::chart. Тип выбирается через [type], остальные параметры — строками [имя]значение.
Поддерживаемые типы
| Type | Название |
|---|---|
area | Площадная диаграмма |
line | Линейный график |
bar | Столбчатая диаграмма |
composed | Комбинированный (столбцы + линии) |
pie | Круговая диаграмма |
donut | Кольцевая диаграмма (ring — старое имя) |
radar | Радарная диаграмма |
radial | Радиальная диаграмма |
sankey | Диаграмма Санки |
Общие параметры chart block
| Параметр | Пример | Значение |
|---|---|---|
[title] | [title]Рост подписчиков | Заголовок графика |
[description] | [description]За полгода | Подзаголовок |
[type] | [type]area | Тип графика |
[variant] | [variant]hatched | Вариант заливки для типа |
[colors] | [colors]#047857 #10b981, #a>#b | Цвета серий: одна тема, светлая|тёмная, градиент |
[legend] | [legend]bottom | Положение легенды или false |
[height] | [height]400 | Высота в px |
Данные задаются markdown-таблицей. Первый столбец считается label/x-axis, остальные — числовые series; для sankey — колонки «источник | цель | значение». Все параметры описаны на странице Основы и markdown.
