[Mono-docs-list] Translator from monodoc XML format to Microsoft XML format

[Joshua Tauberer]

Rodolfo,

A starting point:

For the static HTML docs generating stuff I'm working on, I added a new 
"index.xml" file into the mix.  These files (one per assembly) contain 
assembly- and namespace- specific documentation that isn't present in 
the regular XML files for each of the types.

You might want to use these files to determine which types to combine 
into the MS-style XML file, using something like:
	<xsl:for-each 
select="document('index.xml')/Overview/Types/Namespace/Type/@Name">
You can generate an index.xml file using monodoc/tools/stub.exe with the 
--stubassembly option (which I just now committed).  This will let you 
combine all of the files entirely with XSLT.

Otherwise you could also scan the directory, but that requires 
programming outside of XSLT.


-- 
- Joshua Tauberer

http://taubz.for.net

** Nothing Unreal Exists **



Rodolfo Campero wrote:
> I don't know how long will take to do that; I will try first to do a 
> stand alone application, and then I will check NDoc documentation in 
> order to evaluate if I can do the documenter.
> 
> If I decide to jump into that second task, I will ask Kevin if I need 
> some help or explanation.
> 
> 
>> From: "Gert Driesen" <gert.driesen@pandora.be>
>> To: "Rodolfo Campero" 
>> <rodolfocampero@hotmail.com>,<mono-docs-list@lists.ximian.com>
>> CC: <kdowns@users.sourceforge.net>
>> Subject: Re: [Mono-docs-list] Translator from monodoc XML format to 
>> Microsoft XML format
>> Date: Thu, 29 Apr 2004 15:57:16 +0200
>>
>> Hi,
>>
>> Kevin Downs (NDoc team) has already started working on an NDoc documenter
>> that will convert MS XML format to Monodoc.  It would be great if the
>> conversion from Monodoc (ECMA) to MS XML format could be implemented 
>> as an
>> NDoc documenter too.
>>
>> Gert
>> ----- Original Message -----
>> From: "Rodolfo Campero" <rodolfocampero@hotmail.com>
>> To: <mono-docs-list@lists.ximian.com>
>> Sent: Thursday, April 29, 2004 3:45 PM
>> Subject: [Mono-docs-list] Translator from monodoc XML format to Microsoft
>> XML format
>>
>>
>> > FYI
>> >
>> >
>> > >From: "Rodolfo Campero" <rodolfocampero@hotmail.com>
>> > >To: tauberer@for.net
>> > >CC: xiii29@free.fr, 
>> mono-list@lists.ximian.com,gellyfish@gellyfish.com,
>> > >mono-docs-lists@lists.ximian.com
>> > >Subject: Re: [Mono-list] Question about attributes
>> > >Date: Thu, 29 Apr 2004 13:37:28 +0000
>> > >
>> > >Hi Joshua,
>> > >I already know XSLT, so I will give it a shot this afternoon (it's 
>> 10:30
>> am
>> > >here in Argentina, I will start working on it at 19:00).
>> > >Also I will subscribe to mono-docs-list right now, so I will posts
>> > >questions there if I have to.
>> > >I would like to know who should I refer to when I get something 
>> usable,
>> in
>> > >order to make it part of mono or monodoc.
>> > >Best regards,
>> > >Rodolfo
>> > >
>> > >
>> > >>From: Joshua Tauberer <tauberer@for.net>
>> > >>To: Rodolfo Campero <rodolfocampero@hotmail.com>
>> > >>CC: xiii29@free.fr, mono-list@lists.ximian.com, 
>> gellyfish@gellyfish.com
>> > >>Subject: Re: [Mono-list] Question about attributes
>> > >>Date: Thu, 29 Apr 2004 09:21:26 -0400
>> > >>
>> > >>Rodolfo Campero wrote:
>> > >>>I don't know if there is some effort to create a translator from
>> > >>>monodoc XML format to Microsoft XML documentation format. That would
>> > >>>be nice, because one could use NDoc to generate files for Windows
>> > >>>users.
>> > >>>
>> > >>>Does anyone knows about such a tool?
>> > >>
>> > >>Since this has come up so many times, I'll work on it when I get the
>> > >>chance.  (As I keep repeating on the docs list, the two formats 
>> are so
>> > >>similar that it would be trivial for anyone to learn XSLT, if 
>> necessary,
>> > >>and write the conversion themselves if they wanted it.  It would also
>> make
>> > >>a nice project if someone is looking for a way to contribute to 
>> Mono.)
>> > >>
>> > >>--
>> > >>- Joshua Tauberer
>> > >>
>> > >>http://taubz.for.net
>> > >>
>> > >>** Nothing Unreal Exists **
>> > >
>> > >_________________________________________________________________
>> > >Protect your PC - get McAfee.com VirusScan Online
>> > >http://clinic.mcafee.com/clinic/ibuy/campaign.asp?cid=3963
>> > >
>> > >_______________________________________________
>> > >Mono-list maillist  -  Mono-list@lists.ximian.com
>> > >http://lists.ximian.com/mailman/listinfo/mono-list
>> >
>> > _________________________________________________________________
>> > The new MSN 8: advanced junk mail protection and 2 months FREE*
>> > http://join.msn.com/?page=features/junkmail
>> >
>> > _______________________________________________
>> > Mono-docs-list maillist  -  Mono-docs-list@lists.ximian.com
>> > http://lists.ximian.com/mailman/listinfo/mono-docs-list
>> >
>>
>> _______________________________________________
>> Mono-docs-list maillist  -  Mono-docs-list@lists.ximian.com
>> http://lists.ximian.com/mailman/listinfo/mono-docs-list
> 
> 
> _________________________________________________________________
> Help STOP SPAM with the new MSN 8 and get 2 months FREE*  
> http://join.msn.com/?page=features/junkmail
> 
> _______________________________________________
> Mono-docs-list maillist  -  Mono-docs-list@lists.ximian.com
> http://lists.ximian.com/mailman/listinfo/mono-docs-list