Page 2 of 3
Re: MX-15 Users Manual -- Final
Posted: Thu Jan 07, 2016 5:23 pm
by KernSpy
Great Job by Everyone Involved !!
Code: Select all
|| Thank You! || Thank You! || Thank You! || Thank You! || Thank You! || Thank You! || Thank You! || Thank You! || Thank You! ||
I'm off to grap the PDF. I think I'm going to print it. (Probably tomorrow. Double Sided).
Re: MX-15 Users Manual -- Final
Posted: Thu Jan 07, 2016 5:32 pm
by anticapitalista
Dutch was one of the last languages on my mind for translation :)
It is a *huge* task and I think best tackled by translators of each language working as part of a team - to reduce the burden.
That's why I asked if there is an 'easy' way for people to contribute to translating the manual already in place? i.e. not having to worry about formatting.
When I said 'set a goal', I mean a very long term goal. MX-15 jessie will be supported for I guess at least 5 years.
Re: MX-15 Users Manual -- Final
Posted: Fri Jan 08, 2016 8:06 am
by Jerry3904
anticapitalista wrote:Well done to all involved.
Is there an 'easy' way for people to contribute translated versions? I know we have a Russian translation of MX-14 manual. Wouldn't it be great if we could get the manual translated into other languages we support. I know it is a very time-consuming task, but I think we should set a goal to get the manual translated into as many languages as we can.
Been thinking about this question. Here is one possibility that I see:
1) Start with a reasonable goal:
I suggest Sections 1 and 3, with the introduction and all the configuration. Then Section 2 followed by the others can be added when ready.
2) Set up a Wiki-type page on "Manual Translation" with universal access (or just registered teams?) and dedicated child pages for each language
3) Set up a Manual Translation forum for communication
4) When someone (or preferably a small group) decides to work on this, we use the Google Translate button for the target language, then paste that code into the Wiki page.
5) We post a running list of translations in progress at the top of the Manual Translation forum
6) Any (now pretty infrequent) changes in the official Section 3 will be announced in the MT forum so teams can update
7) We transfer completed sections to the location for the Manual, and list them on the page linked with the upper tab.
Would something like that work? My sense is that we could get such work done at a reasonable pace.
Re: MX-15 Users Manual -- Final
Posted: Fri Jan 08, 2016 10:55 am
by bicyclist56
I just started to work. I find it easier than others - I can use past translation MX-14 in Russian. I just need to be careful, and do not miss the differences :)
Re: MX-15 Users Manual -- Final
Posted: Fri Jan 08, 2016 11:06 am
by Jerry3904
Got a message from Peregrine that the exact method I propose would be difficult to implement. But we can reexamine that later.
I do think the Sections are not of equal importance to the beginner, and would continue to urge that we start with Sections 1 & 3: it's always better to break a big task down into smaller ones.
Re: MX-15 Users Manual -- Final
Posted: Fri Jan 08, 2016 11:24 am
by anticapitalista
Jerry3904 wrote:
I do think the Sections are not of equal importance to the beginner, and would continue to urge that we start with Sections 1 & 3: it's always better to break a big task down into smaller ones.
I agree. Is there a template for translators to download? Or should they just use the html file in mx-docs?
Re: MX-15 Users Manual -- Final
Posted: Fri Jan 08, 2016 11:51 am
by Jerry3904
I think this procedure should not be that hard:
--click on the Manual tab and open the MX-15 Manual (not the onboard one, where Google Translate code does not work)
--use the GT pull-down menu to convert the text to the target language
--highlight Section 1 and copy
--open LO and paste (will put in text and images)
--save as MX15_Manual_1 or something similar (see result for French below)
--repeat with Section 3, saving it of course as MX15_Manual_3. It's long, so you might want to download it in subsections and paste them one behind the other.
We can work out later whether/how to reformat it once we have our first concrete example.
Re: MX-15 Users Manual -- Final
Posted: Fri Jan 08, 2016 1:16 pm
by Jerry3904
When more than one person is working on the same translation, the simplest method might be to store the document in the cloud, agree to work on separate subsections, and use Track Changes.
Re: MX-15 Users Manual -- Final
Posted: Fri Jan 08, 2016 1:22 pm
by antiX-Dave
Yes looks good.
I appologize for not taking a look sooner.
I wish to suggest that if possible in future versions to include a "TOP" link in the html manual?
Code: Select all
<div class="toc"> becomes <div class="toc" id="toc">
after each paragraph / section insert
<a href="#toc">Go to Table of Contents</a>
Re: MX-15 Users Manual -- Final
Posted: Fri Jan 08, 2016 1:27 pm
by Jerry3904
Will do. I just use Ctrl-Home, but a link would be easier.