Giuseppe Greco wrote:

Do you plan to localize NAnt?

I think it would be a good idea.

If yes, how are you going
to manage translations? Actually, compiled assemblies and
XML files generated by the C# compiler are kept togheter
in the same directory, letting NDoc find them and do its
job.



looks like the xmldoc attribute you mention in a later email is the way to get around this. We would invoke ndoc once for each translated language.

In order to be able to translate, let's say, the SDK
documentation into many languages, the XML files generated
by the C# compiler should be kept separately (e.g. doc/en-US)
and, of course, only English documentation should be generated
automatically from source code; other translations, which
should have their own directory (doc/it-IT, doc/es-ES, etc.),
have to be done manually.



although we should be able to knock up a script to generate stubs based on the original english doc.

So the question is: how do you tell NDoc where to find the XML
files to process?



xmldoc tag :)
A thought I've had recently is that it could be cool to hack nDoc to accept the monodoc xml format as input. There is no reason it shouldn't be possible as its functionally equivalent to the ms/ndoc format. The advantage then is that there are some nice tools for editing monodoc and we would get the ability to view the nant help in the monodoc gui. I'm not sure if the monodoc gui is functional on win32 yet but I think its being worked on.


of course - quite apart from the documentation there is the process of making internal strings load from a resource file rather than being hard-coded to english as they are now.


Ian

-
Giuseppe Greco

::agamura::

phone:  +41 (0)91 604 67 65
mobile: +41 (0)79 602 99 27
email:  [EMAIL PROTECTED]
web:    www.agamura.com
----------------------------------------


-------------------------------------------------------
SF email is sponsored by - The IT Product Guide
Read honest & candid reviews on hundreds of IT Products from real users.
Discover which products truly live up to the hype. Start reading now.
http://ads.osdn.com/?ad_id=6595&alloc_id=14396&op=click
_______________________________________________
nant-developers mailing list
nant-developers@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/nant-developers




-------------------------------------------------------
SF email is sponsored by - The IT Product Guide
Read honest & candid reviews on hundreds of IT Products from real users.
Discover which products truly live up to the hype. Start reading now.
http://ads.osdn.com/?ad_id=6595&alloc_id=14396&op=click
_______________________________________________
nant-developers mailing list
nant-developers@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/nant-developers

Reply via email to