Как добавить материал

Способов четыре, и они не взаимозаменяемы. Сначала найдите свою строку — дальше читать только её.

Что вы хотите	Куда идти	Кто может
Поправить текст на странице	кнопка под самой страницей	автор правит сразу, остальные шлют предложение
Завести свой материал	Правка страниц → «+ Новая страница»	автор
Поделиться видео, ссылкой или пресетом	Каталог сообщества	любой с аккаунтом GitHub
Завести главу — с экзаменом и прогрессом	репозиторий, через наставника	наставник

Поправить страницу

Под каждой страницей есть «Предложить правку» — она открывает форму на GitHub, где достаточно описать, что не так. Ничего устанавливать не нужно.

Если у вас роль автора, вам доступен и прямой путь: открыть Правку страниц, найти страницу в списке слева (там есть поиск), изменить текст и нажать «Сохранить».

Если ту же страницу успел изменить кто-то ещё, сохранение не пройдёт и редактор об этом скажет — откройте её заново и внесите правку ещё раз. Так чужая работа не затирается молча.

Завести свой материал

Нужна роль автора: наставник выдаёт её у себя в разделе, по вашему логину на GitHub. После этого:

1. Откройте Правку страниц и нажмите «+ Новая страница».
2. Выберите раздел и впишите заголовок.
3. Нажмите «Создать заготовку» — адрес и номер подставятся сами.
4. Напишите текст. Кнопки над полем вставляют подсказку, раздел, «проверь себя» и код.
5. Нажмите «Создать».

Через несколько минут страница появится: сохранение отправляет её в репозиторий, а дальше платформа пересобирается сама. Ждать нужно именно сборку — в списке слева файл появляется сразу, и кнопка меняется с «Создать» на «Сохранить». Это и значит, что всё прошло.

Страница видна в трёх местах: в меню слева, на странице своего раздела карточкой и в Маршруте — блоком «Страницы».

⚠️Важно

Кнопка сохранения не нажимается, пока над полем горит список замечаний. Это не придирки: ровно те же вещи проверяет сборка, и без них страница просто не соберётся. Исправьте замечания — кнопка станет активной.

Поделиться видео, ссылкой или пресетом

Это не страница сайта, а запись в каталоге сообщества: полезное видео по теме главы, ссылка на разбор, готовый пресет тренажёра. Такое добавляется на странице Сообщество — роль автора не нужна, хватит аккаунта GitHub.

Чем глава отличается от страницы

Это единственное различие, которое стоит знать, и оно не про объём.

	Страница	Глава
Что это	памятка, объявление, разбор задания	учебный материал программы
Прогресс, галочка, сертификат	нет	да
Экзамен и самопроверки	нет	да
Обложка, 2–5 схем, 4–5 видео, вопросы дня	нет	обязательны
Где заводится	прямо на сайте	в репозитории
Сколько занимает	минуты	несколько часов

Главу нельзя довести до конца из редактора, и это не недоделка: схемы, видео и вопросы дня лежат вне папки с текстами, а редактору намеренно разрешено писать только тексты. Если материал тянет на главу — напишите его страницей и скажите наставнику. Превратить страницу в главу дешевле, чем начинать с нуля.

Как добавить целый раздел

Разделы (треки) описаны одним файлом src/data/tracks.json. Чтобы появился новый — например «Веб» или «1С» — в него добавляется запись:

{
  "dir": "web",
  "label": "Веб",
  "audience": "веб",
  "position": 5,
  "art": "grep-regex",
  "blurb": "Короткое описание раздела."
}

После этого раздел появится и в редакторе, и баннером на Маршруте, и в подвале сайта. Это единственное место, где треки перечислены.

✨Интересный факт

Номер страницы — это префикс имени файла (07-composition.mdx → 07). Чтобы перенумеровать материалы, достаточно переименовать файлы: нигде больше номер не дублируется и разойтись не может.

Если что-то пошло не так

• «Нет доступа» — роль автора не выдана. Попросите наставника.
• «GitHub не разрешил запись» — это к администратору платформы: ключу доступа не выдано право записи, страница тут ни при чём.
• «Страницу успели изменить» — откройте её заново. Ваш текст не потерян, скопируйте его перед повторным открытием.
• Страница не появилась через десять минут — скорее всего, упала сборка. Загляните во вкладку Actions репозитория: там будет видно, на чём именно.