← Все новости

Виджет для MediaWiki: схемы из «Помощника SA» на страницах корпоративной вики

Вслед за Confluence диаграммы и спецификации из «Помощника SA» можно показывать в MediaWiki. Вышло расширение для MediaWiki — для вики на MediaWiki 1.39 и новее.

Как это выглядит

На страницу вставляется тег со ссылкой «Поделиться» на документ или версию:

<helper-sa url="https://helper-sa.ru/shared/plantuml/…" width="600" />

На странице появляется то же, что в Confluence:

  • заголовок — название документа со ссылкой на источник, номер версии, автор и дата изменения;
  • картинка — миниатюра нужной ширины, щелчок открывает её в полном размере: у PlantUML, BPMN, DBML и карты типов GraphQL;
  • «Исходный код» — раскрывающийся блок с подсветкой и номерами строк.

Версия закрепляется при сохранении

Когда страницу сохраняют, к ссылке на документ сам дописывается номер его текущей версии — как подпись ~~~~ превращается в имя и дату. Документ продолжают править, а вики показывает согласованную версию. Чтобы обновить виджет, достаточно удалить атрибут version и сохранить страницу ещё раз.

Как подключить

Администратор вики распаковывает расширение в папку extensions/HelperSa и добавляет в LocalSettings.php строку wfLoadExtension( 'HelperSa' );. Сервер вики обращается только к разрешённым сайтам helper-sa — по умолчанию к https://helper-sa.ru. Подробная инструкция — в репозитории расширения.