Языки и переводы документации приложения
Одна страница — две языковые версии
У одной Markdown-страницы может быть русская версия, английская версия или обе. Переводы сохраняют общий ID страницы, поэтому это не два независимых пункта меню. В списке материалов столбец «Язык» показывает RU, EN или обе метки.
Ни русский, ни английский не обязателен. Начните с языка, на котором готова инструкция, а второй перевод добавьте позже.
Добавление перевода
Откройте Markdown-страницу, чтобы перейти в редактор переводов.
- Переключитесь на вкладку «Русский» или English.
- Если версии ещё нет, нажмите «Добавить перевод».
- Заполните заголовок и содержимое.
- Нажмите «Сохранить». Кнопка сохраняет изменения обеих вкладок.
Удаление перевода
Кнопка «Удалить перевод» удаляет только открытую языковую версию. Действие доступно, когда у страницы останется другая версия. Удаление строки из общей таблицы — другое действие: оно удаляет страницу целиком со всеми переводами.
Переключение языка в публичной документации
Русский и английский разделы имеют адреса с /ru и /en, но общий ID переводов позволяет оставить текущую страницу открытой при смене языка. Если у неё нет второго перевода, ссылка на этот язык не показывается. Прямой адрес недоступного языка перенаправляет на существующую версию.
При открытии корня документации сначала выбирается язык сайта. Если его нет, используется единственный доступный язык. Папка показывается в боковом меню только тогда, когда внутри есть Markdown-страница выбранного языка.