Is it possible to wikify Visual Studio XML comments?
-
21-08-2019 - |
Question
Is it possible to generate a set of wiki pages from XML comment file generated by Visual Studio?
I'm talking about something like Sandcastle, but for wiki format instead of compiled CHM.
Edit: I'm using MediaWiki which can import/export articles in XML. So I hope that it is possible to write a transformation converting XML comments to MediaWiki XML.
Solution
I'd recommend a bit different solution:
- Use Help Server to publish .CHM/.HxS on the web
- Use special MediaWiki templates to link reference from Wiki like here.
- Use
<see href="...">
to link Wiki pages from XML comments - See also: FiXml
This is not exactly what you wanted, but I hope this will be helpful.
OTHER TIPS
If the items mentioned above do not suffice, have you tried to simply build your own XSLT transform into the wiki markup of your choice?
You can write a simple application in .NET (or pick your platform of choice) to transform the doc XML format to wiki XML format. You'd still have to keep the wiki updated with the output files manually.