octave-dev

[OctDev] How can I help with translation?

[胡小柯 <hot...@gm...>]

Hi,
guys!

I am very glad to encounter with octave, but I found that it is not
available in Chinese, I mean Chinese Simplified. So I would like to
help with translation, and read the translator guide, but it is
confusing. Maybe it is outdated, can everybody update it so that I can
follow it step by step to translate?

Thanks.

Regards,
hottea

Re: [OctDev] How can I help with translation?

[Carnë D. <car...@gm...>]

On 3 September 2012 16:19, 胡小柯 <hot...@gm...> wrote:
> Hi,
> guys!
>
> I am very glad to encounter with octave, but I found that it is not
> available in Chinese, I mean Chinese Simplified. So I would like to
> help with translation, and read the translator guide, but it is
> confusing. Maybe it is outdated, can everybody update it so that I can
> follow it step by step to translate?
>
> Thanks.
>
> Regards,
> hottea

Hi

No one has been working on this anymore. You are free to do so but
unfortunately it seems that everyone that was related to it are no
longer involved. See
http://octave.1599824.n4.nabble.com/Help-wanted-to-translate-GNU-Octave-documentation-into-Chinese-td4633495.html

I believe there's better methods to have translations, but they would
need to be implemented on octave core (I'm cc,ing the mailing list for
octave maintainers). Maybe you would like to start working on it?

Carnë

Re: [OctDev] How can I help with translation?

[Carnë D. <car...@gm...>]

Always make reply to all including the mailing list. Also avoid top
posting (I have readjusted your e-mail to put it on the bottom). This
makes it easier for others to follow the conversation.

On 3 September 2012 17:58, 胡小柯 <hot...@gm...> wrote:
> 2012/9/3 Carnë Draug <car...@gm...>:
>> On 3 September 2012 16:19, 胡小柯 <hot...@gm...> wrote:
>>> Hi,
>>> guys!
>>>
>>> I am very glad to encounter with octave, but I found that it is not
>>> available in Chinese, I mean Chinese Simplified. So I would like to
>>> help with translation, and read the translator guide, but it is
>>> confusing. Maybe it is outdated, can everybody update it so that I can
>>> follow it step by step to translate?
>>>
>>> Thanks.
>>>
>>> Regards,
>>> hottea
>>
>> Hi
>>
>> No one has been working on this anymore. You are free to do so but
>> unfortunately it seems that everyone that was related to it are no
>> longer involved. See
>> http://octave.1599824.n4.nabble.com/Help-wanted-to-translate-GNU-Octave-documentation-into-Chinese-td4633495.html
>>
>> I believe there's better methods to have translations, but they would
>> need to be implemented on octave core (I'm cc,ing the mailing list for
>> octave maintainers). Maybe you would like to start working on it?
>>
>> Carnë
>
> so there used to be someone would like to help with translation, but
> finally gave up because they didn't know how-to or there isn't a clear
> translator guide ?
>
> My problem is that I could not follow the guide to translate, can you
> tell me how to? I need brief and clear steps. I even didn't know what
> I need to translate after reading the guide. Tell me where are the
> files for translation and what tolls are available, it seems poedit is
> not available. Or, maybe I could translate the manual on this website
> http://www.gnu.org/software/octave/octave.pdf
>
> And I got some material available in Chinese Traditional on this
> website https://sites.google.com/site/octavetech/
> But it is seems it won't updated anymore and it have a long way to
> complete. And yeah, I am translating the manual, but only the Chapter
> 15 Plotting, because I am now needing it.

There used to be some people who knew how this is works. But no one
has doing anything about it for ages. The link I sent you was also
from a chinese person interested on translating a few months that got
stuck. I believe the way it worked was that a package would shadow the
core help function and would show a translated help text if available.
So only the help text of functions, not the manual would be translated
by this method. I can't help you more with this as I never tried do it
and don't know the details.

Carnë

Re: [OctDev] How can I help with translation?

[Michael D G. <mic...@gm...>]

On 09/03/2012 01:50 PM, Carnë Draug wrote:
>   Or, maybe I could translate the manual on this website
> >http://www.gnu.org/software/octave/octave.pdf
> >
It would not be good to start from the current English PDF.  This
is created by the Octave build system from a set of input files.
An important challenge will be how to keep the translation in step
with the English version.  The English language files are updated
quite often, but the people doing this typically do not know Chinese.
Some fairly automatic means to telling the translators that a English
file has been updated will be needed.

First, you need to learn how the current Manual gets built.  You
can learn this by studying the build process from the Octave
source.  This will take some work, but it would be of major
value if you could complete a translation, and I am sure that
other maintainers would help with technical issues about the
Octave system.

I have done translations of German and French technical
material lately and one thing I know (for these languages) is
that Google translate is very helpful.  I think that it knows Chinese,
too.  It cannot handle whole sections (Chapters, say) of text, but
it is good at phrases and sentences -- it lets you ask for alternate
translations, for instance.  So, it helps recall particular words that
you were searching for, for example.

So, I hope you will not get discouraged by how much you need to
learn -- it will not be all that hard.  And, it will be of great value to
the user community.

Good luck!

Michael

Re: [OctDev] How can I help with translation?

[胡小柯 <hot...@gm...>]

2012/9/4 Michael D Godfrey <mic...@gm...>:
> On 09/03/2012 01:50 PM, Carnë Draug wrote:
>
>  Or, maybe I could translate the manual on this website
>> http://www.gnu.org/software/octave/octave.pdf
>>
>
> It would not be good to start from the current English PDF.  This
> is created by the Octave build system from a set of input files.
> An important challenge will be how to keep the translation in step
> with the English version.  The English language files are updated
> quite often, but the people doing this typically do not know Chinese.
> Some fairly automatic means to telling the translators that a English
> file has been updated will be needed.
>
> First, you need to learn how the current Manual gets built.  You
> can learn this by studying the build process from the Octave
> source.  This will take some work, but it would be of major
> value if you could complete a translation, and I am sure that
> other maintainers would help with technical issues about the
> Octave system.
>
> I have done translations of German and French technical
> material lately and one thing I know (for these languages) is
> that Google translate is very helpful.  I think that it knows Chinese,
> too.  It cannot handle whole sections (Chapters, say) of text, but
> it is good at phrases and sentences -- it lets you ask for alternate
> translations, for instance.  So, it helps recall particular words that
> you were searching for, for example.
>
> So, I hope you will not get discouraged by how much you need to
> learn -- it will not be all that hard.  And, it will be of great value to
> the user community.
>
> Good luck!
>
> Michael
>
>

Thanks, Carnë and Michael, And sorry for top posting.  I think the
manual(that PDF) is also helpful, so I decide to continue translate
it. And you suggest finding out how the help manual built by process
the Octave from sources, but I'm not good at programmer. Do I need to
read all the sources or which files build the help manual?

Re: [OctDev] How can I help with translation?

[Michael D G. <mic...@gm...>]

On 09/04/2012 05:30 AM, 胡小柯 wrote:
> Thanks, Carnë and Michael, And sorry for top posting.  I think the
> manual(that PDF) is also helpful, so I decide to continue translate
> it. And you suggest finding out how the help manual built by process
> the Octave from sources, but I'm not good at programmer. Do I need to
> read all the sources or which files build the help manual?
A translation of the Manual will certainly be helpful. Are you
translating directly into Chinese text, or are you familiar with
TeX or Latex?  The Manual is composed from the same files that
produce the "help" text in Octave, and a form of TeX is used in
this process.  This is what allows using mathematical expressions,
and also supports inserting the tables and plots.

You do not really need to know much about this to do the
translation from octave.pdf, but at some point to make it all
work well  (the help text becomes Chinese, and the Manual
in Chinese is generated in the same way as the English) there
will be a need to do some more work.  We hope that someone
who both knows Chinese and knows more about the internals
of Octave may come along to help out!

By the way, please be sure that you are working from the
latest version of octave.pdf.  A way to get this is to download
the "devel" source and build the system.  The Manual will
appear in octave/doc/interpreter/octave.pdf.  If you have trouble
with this, one of us can email a copy to you.

So, please keep doing what you can.  That is all we can ask!

Michael