Можно ли викифицировать XML-комментарии Visual Studio?
-
21-08-2019 - |
Вопрос
Можно ли сгенерировать набор вики-страниц из файла XML-комментариев, сгенерированного Visual Studio?
Я говорю о чем-то вроде Sandcastle, но для формата wiki вместо скомпилированного CHM.
Редактировать:Я использую MediaWiki, который может импортировать / экспортировать статьи в формате XML.Поэтому я надеюсь, что можно написать преобразование, преобразующее XML-комментарии в MediaWiki XML.
Решение
Я бы порекомендовал немного другое решение:
- Использование Справочный сервер опубликовать файл .CHM/.HxS в Интернете
- Использование специальные шаблоны MediaWiki чтобы связать ссылку из Wiki, например здесь.
- Использование
<see href="...">
для создания ссылок на вики-страницы из XML-комментариев - Смотрите также: FiXml
Это не совсем то, что вы хотели, но я надеюсь, что это будет полезно.
Другие советы
Если упомянутых выше пунктов недостаточно, пробовали ли вы просто создать свое собственное преобразование XSLT в выбранную вами вики-разметку?
Вы можете написать простое приложение на .NET (или выбрать платформу по своему выбору), чтобы преобразовать формат doc XML в формат wiki XML.Вам все равно придется обновлять wiki выходными файлами вручную.