[C#] XML output Visual Studio 2008 opmaken

[Matis]

Beste GoTters,

ik heb (voor school, maar dat doet er niet echt toe) een project gemaakt in C#.

Project telt een aantal klassen en daarin natuurlijk methodes e.d..

Nu moet er natuurlijk gedocumenteerd worden om de volgende groep een overzichtelijk stukje software af te leven.

We hebben daarom al met /// summary gewerkt en dat gaat allemaal prima. Ook hebben we VS2k8 ook de xml laten uitspugen met daarin netjes alle public methodes met summary.

Alleen nu is mijn vraag, hoe kan ik makkelijk die xml output opmaken, zodat je netjes een html-paginaatje krijgt, of met een xsl de xml opmaken? De standaardopmaak van die xml is immers bagger!

Nu heb ik natuurlijk al wat vooronderzoek gedaan en heb ik een aantal programma's / plugins gevonden die xsl(t) kunnen maken, zoals XMLSpy en IronXSLT.

Ik ben dus eigenlijk opzoek naar Javadoc van Eclipse, maar dan voor VS2k8.

Ik heb ook Ndoc gevonden en Sandcastle, maar NDoc werkt niet (meer) voor .NET 3.5 en Sandcastle krijg ik niet aan de praat.

Dus heeft er iemand ervaring en/of tips om mij uit de brand te helpen?

Alvast bedankt,

TOAOMatis

[Gorion3]

Ik herken je probleem. Heb vroeger (lees .Net 1.0) ook die output opgemaakt, was ook een opdracht voor school , maar ik heb toen NDoc gebruikt en dat was nog in VS 2k3 als ik me niet vergis. Ik kan je niet helpen, sorry. Wel kan ik even wat navraag doen op het werk. Mocht daar iets uitkomen dan hoor je het van me!

[Soultaker]

Ik heb op zich goede ervaringen met Doxygen al heb ik het nooit in een C# project gebruikt (wordt wel ondersteund) en ik heb ook niet echt geprobeerd de uitvoer te customizen, hoewel ook daar wel support voor is:
• Doxygen: customizing the output

[Matis]

Soultaker schreef op zaterdag 24 januari 2009 @ 21:45:
Ik heb op zich goede ervaringen met Doxygen al heb ik het nooit in een C# project gebruikt (wordt wel ondersteund) en ik heb ook niet echt geprobeerd de uitvoer te customizen, hoewel ook daar wel support voor is:
• Doxygen: customizing the output

Kijkaan, dit lijkt er al meer op ik ga eens kijken of ik er mee overweg kan. thnx alvast voor je reactie

[whoami]

Ik gebruik Sandcastle.
Kijk eens naar de tool Sandcastle Help File Builder, deze zal je wel wat meer op weg helpen.

[ Voor 14% gewijzigd door whoami op 25-01-2009 11:28 ]

[KeesV]

Op mijn werk gebruiken we Sandcastle in combinatie met Docproject. Dan kan je in Visual Studio een Docproject project aanmaken waar vervolgens een ASP.Net applicatie, een CHM file of een HxS file uit komt. Werkt erg mooi! Mijn ervaring is: installeren, Docproject aanmaken (met behulp van een wizard) en gaan met die banaan. Voor output als CHM moet je nog even de Microsoft HTML Help Workshop installeren.

[Matis]

Super bedankt allemaal voor de reacties

Ik ben nu gegaan voor DoxyGen, dit omdat school het er goed uit vond zien en het verder netjes doet wat ik wil.

Ik wil jullie bedankten voor de replies. Dit mag wat mij betreft op slot!

[RobIII]

whoami schreef op zondag 25 januari 2009 @ 11:28:
Ik gebruik Sandcastle.
Kijk eens naar de tool Sandcastle Help File Builder, deze zal je wel wat meer op weg helpen.

Die vind ik ook fijn en makkelijk werken en de output is erg netjes IMHO

toaomatis schreef op zondag 25 januari 2009 @ 22:47:

Ik wil jullie bedankten voor de replies. Dit mag wat mij betreft op slot!

Een slotje is niet nodig op een topic als je je oplossing hebt. Zie daarvoor ook onze faq betreffende topiceinde.

[ Voor 35% gewijzigd door RobIII op 25-01-2009 22:49 ]

[Victor]

De makers van XMLSpy hebben een gratis XSLT engine: AltovaXML

Te gebruiken als command line tool om een XML door een XSLT te halen.