[Mono-docs-list] MonoDoc translation

Giovanni Ferron info@gvnn.it
Wed, 19 May 2004 10:30:32 +0200


Thank you for help me, but if I set the flag in the monodoc/browser when
I'll upload what will happen? I'll overwrite the english?=20
Now I try to find another solution, maybe a web based one.

Bye and thanks again

Gvnn

-----Messaggio originale-----
Da: Joshua Tauberer [mailto:tauberer@for.net]=20
Inviato: marted=EC 18 maggio 2004 16.31
A: Giovanni Ferron
Cc: mono-docs-list@lists.ximian.com
Oggetto: Re: [Mono-docs-list] MonoDoc translation


Giovanni Ferron wrote:
> Hi i'm here again with a simple question,
> I would like to translate the monodoc documentation in italian, but i
> didn't find a way to do this. I only find a web page=20
> (http://www.go-mono.com/monodoc-xml.html) where says that i can use
the=20
> lang attribute in this way <doc lang=3D"ISO-code">, it's right? or
there's=20
> another way?

That page must be extremely old.  It doesn't reflect the structure of=20
the XML documents that are used now.

The Monodoc documentation is huge, to say the least.  Getting the=20
documentation in English is a huge project (and very unfinished).=20
Translating it is a huge project too.  Maybe on the order of a hundred=20
hours of work.

See: =
http://cvs.hispalinux.es/cgi-bin/cvsweb/monodoc/class/?cvsroot=3Dmono

The documentation is in CVS at /monodoc/class.

Each assembly documented has a directory there.

Within those directories is directory for each language.  Currently=20
there's only "en."

Within that, there is the real documentation.  Each namespace has a=20
directory.  In those, each type has a file.  So, you will want to build=20
a similar structure in a directory for Italian (what's the ISO code for=20
Italian?).

There's probably a flag in the assembler program (in monodoc/browser)=20
that selects English for compiling the docs.  I don't remember.

I'd suggest you copy the type files one by one from the en directory to=20
the Italian directory as you translate them so you can keep track of=20
what's been documented.  It could turn into a big mess very quickly.

Good luck...

--=20
- Joshua Tauberer

http://taubz.for.net

** Nothing Unreal Exists **