Управление сайтом документации#

Официальный сайт работает на Elang. Его Content Studio позволяет доверенному администратору редактировать документацию, уроки, примеры, руководства и публикации об обновлениях без изменения исходного кода приложения.

Вход в редакционную рабочую область#

Откройте /login, войдите под подготовленной учётной записью администратора и при необходимости смените временный пароль. Затем откройте /admin. Обычные пользователи не могут войти в рабочую область; публичная регистрация на официальном сайте отключена.

Учётная запись администратора подготавливается через доверенный терминал, а не через публичную форму. Адрес учётной записи должен быть подтверждён, а роль — соответствовать администратору.

Черновик, предпросмотр и публикация#

Выберите существующую страницу или создайте страницу в поддерживаемом разделе. Напишите заголовок на выбранном языке страницы, понятное описание для поиска и текст Markdown, начинающийся с одного основного заголовка. Добавьте предварительные требования, полные команды, ожидаемые результаты, объяснения ошибок и следующий шаг.

«Сохранить черновик» оставляет текст закрытым. Предпросмотр отображает очищенный Markdown без публикации. Публикация обновляет публичную страницу, навигацию, результаты поиска, представление Markdown и карту сайта на основе одного и того же опубликованного содержимого.

Необработанный HTML удаляется при преобразовании Markdown. Пользовательские скрипты не становятся исполняемым содержимым предпросмотра.

Редакции и одновременные изменения#

Каждое сохранение фиксирует редакцию и автора действия. Редактор проверяет номер редакции, прежде чем принять изменение. Если другая сессия обновила страницу, ответ о конфликте предлагает перезагрузить её, чтобы не перезаписать эту работу незаметно.

Восстановление исторической редакции создаёт новый черновик. Проверьте его и явно опубликуйте. Изменения черновика не меняют дату изменения публичной статьи.

Границы хранилища#

Редакционное содержимое и редакции хранятся в закрытой базе данных. Исходный код и конфигурация PHP-приложения остаются вне корневого веб-каталога. Редактор не может выполнять команды оболочки, редактировать .env или записывать данные по произвольным путям файловой системы.

Храните резервные копии базы данных и проверяйте процедуры восстановления. История редакций полезна для восстановления текстов, но не заменяет эксплуатационную резервную копию.