Skip to content
mdDocs
mdDocs
Компонент, превращающий новый сайт в систему документации
  1. Компоненты
  2. mdDocs

mdDocs

Компонент, позволяющий реализовать аналог старого docs.modx.pro из любого чистого сайта на MODX Revolution.

Установка

Необходимо настроить подключение к репозиторию MODSTORE.PRO, после чего через "Установщик приложений" установить mdDocs. Автоматически установятся:

  • pdoTools
  • Markdown
  • Theme.Bootstrap

Настройка

После установки необходимо какому-либо ресурсу установить шаблон "mdDocs", после чего ID этого ресурса сохранить в системной настройке mddocs_docs_page_id. Если установка произведена на чистый сайт, а других назначений для сайта не предполагается, такой страницей будет главная страница сайта с ID = 1.

Системные настройки

НастройкаЗначение по умолчаниюОписание
mddocs_custom_cssПользовательский файл стилей для настройки внешнего вида
mddocs_docs_page_id1ID страницы для отображения документации
mddocs_docs_path{corePath}gitdocs/Путь к документации по умолчанию относительно корня сайта
mddocs_git_token<Генерируется при установке>Токен для принятия запроса webhook'ом на выполнение git pull
mddocs_lang_defaultenЯзык по умолчанию
mddocs_lang_switch{"ru":"РУС","en":"EN"}JSON-массив соответствий названий каталогов отображаемым обозначениям языков
mddocs_logoПуть к изображению с логотипом
mddocs_remote_imagesДаИзображения хранятся на удаленном сервере или локально в каталоге документации. Если локально, установите значение "Нет" и убедитесь, что файлы из каталога документации доступны для пользователей

Транслитерация адресов

По умолчанию все адреса генерируются на основании названий файлов. Соответственно, русскоязычные названия файлов и каталогов отображаются на русском.

Если в системе установлен компонент translit, то через него автоматически пропускаются все составляющие части адреса.

Подтягивание из git'a

Для автоматического обновления документации используется webhook: SITE_URL>/assets/components/mddocs/gitpull.php?token=<TOKEN>

В настройках git'a необходимо указать полный адрес webhook'a, включая токен для доступа. Ниже скрин на примере Github'a:

mdDocs