Вставить Doxygen в MediaWiki

Question

Я использую mediawiki для большей части моей документации.Однако недавно мы начали использовать doxygen для документирования API в одном из наших тяжелых проектов на C / C ++.Чтобы наша общая документация выглядела единообразно, я бы хотел добавить материал о кислороде в mediawiki.Как мне это сделать?

Я посмотрел на некоторые расширения, но все, что я нашел до сих пор, кажется недоделанным.

Answer 1

Единственное известное мне расширение - DoxyWiki . Я думаю, что это все, что доступно прямо сейчас.

Но, может быть, это то, что вы имели в виду под "полу-печеным"?

(См. Также: Вики и Википедия )

Answer 2

Я не пробовал DoxyWiki.

Вы можете закодировать вики-страницу Special, например, Special: FileSystem или настроить пространство имен, чьи «подстраницы» соответствуют HTML-файлам doxygen в файловой системе. Проблема в том, что doxygen хочет создать собственную навигацию, которая несовместима с боковой панелью типичного скина MediaWiki и т. Д.

Вы можете поместить HTML-файлы doxygen в другой каталог на вашем веб-сервере и ссылаться на них. Чтобы сделать это чище, вы можете определить для него префикс interwiki , например, "docs", а затем вы можете ссылаться на веб-страницы doxygen с помощью обычных вики-ссылок [[docs:php/Action_8php.html|see the Action.php reference docs]]. Вы можете обработать вывод кислорода, чтобы он больше походил на кожу вашей вики. Но окно поиска вашей вики не даст совпадения с кислородом.