Re: [Mixxx-devel] Mixxx manual info

[Sébastien BLAISOT]

Le 17/11/2017 à 13:31, Josep Maria Antolin a écrit :
As for translating the manual ( as an author of one of the only two 
mostly complete translations ), what happens when the english versions 
of the sentences change, is that the translated sentence dissapears 
and has to be rewritten completely.
Given that the sentences on a manual tend to be long, small changes in 
the english version could cause quite some work on the translations. 
(I don't know if transifex has improved this recently or not, or if it 
simply depends on how the original sentences get updated)


On transifex, you have suggestions in the right-hand pane.
often, when only a small part of a phrase changes, the suggestions 
contains the old phrase and translation and also similar phrases 
elsewhere in the resource.
You have a button below each suggestion to automatically copy the old 
translation and you only have to adapt to reflect the small change.


sb

--
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
___
Get Mixxx, the #1 Free MP3 DJ Mixing software Today
http://mixxx.org


Mixxx-devel mailing list
Mixxx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/mixxx-devel

Re: [Mixxx-devel] Mixxx manual info

[Sean M. Pappalardo - D.J. Pegasus]

On 11/17/2017 04:31 AM, Josep Maria Antolin wrote:
> As for the format, remember that we have two versions, the PDF one,
> included with Mixxx, and the HTML version, which can be accessed online
> from mixxx.org .

Both are generated from the same ReST source.

Sincerely,
Sean M. Pappalardo
"D.J. Pegasus"
Mixxx Developer - Controller Specialist



smime.p7s
Description: S/MIME Cryptographic Signature
--
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot___
Get Mixxx, the #1 Free MP3 DJ Mixing software Today
http://mixxx.org


Mixxx-devel mailing list
Mixxx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/mixxx-devel

Re: [Mixxx-devel] Mixxx manual info

[Josep Maria Antolin]

As for translating the manual ( as an author of one of the only two mostly
complete translations ), what happens when the english versions of the
sentences change, is that the translated sentence dissapears and has to be
rewritten completely.
Given that the sentences on a manual tend to be long, small changes in the
english version could cause quite some work on the translations. (I don't
know if transifex has improved this recently or not, or if it simply
depends on how the original sentences get updated)

On the other hand, new sentences do not imply any problem, and the
translator just has to keep an eye to the amount of sentences that miss
translation.
​
As for the format, remember that we have two versions, the PDF one,
included with Mixxx, and the HTML version, which can be accessed online
from mixxx.org.
--
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot___
Get Mixxx, the #1 Free MP3 DJ Mixing software Today
http://mixxx.org


Mixxx-devel mailing list
Mixxx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/mixxx-devel

Re: [Mixxx-devel] Mixxx manual info

[Daniel Schürmann]

Ok, in that case 2018-01-31 is a good date for manual string freeze.


Am 16.11.2017 11:13 nachm. schrieb "Sean M. Pappalardo - D.J. Pegasus" <
spappala...@mixxx.org>:



On 11/16/2017 01:26 PM, Daniel Schürmann wrote:
> I am afraid 2018-01-31 is to short for a polished English Doku and then
> wait for translations. So we need to find a mode to do things in parallel.

That's not really possible. Translators depend on the English manual
being complete and stable, so we have to do that first.

On 11/16/2017 11:38 AM, ronso wrote:
> I'd like to help improving the manual, though I'm not very patient nor
> super-skilled in DTP.
> I'll have a look at how all the formatting is done, also I'll ask a
> fellow graphic designer for feedback.

Note that the manual is created with Restructured Text so formatting can
be changed easily (using CSS) later. What matters right now is the
actual content: text, screen shots and diagrams.

Here are instructions to build and edit the manual:
https://github.com/mixxxdj/manual/blob/manual/README.md

Sincerely,
Sean M. Pappalardo
"D.J. Pegasus"
Mixxx Developer - Controller Specialist



--
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
___
Get Mixxx, the #1 Free MP3 DJ Mixing software Today
http://mixxx.org


Mixxx-devel mailing list
Mixxx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/mixxx-devel
--
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot___
Get Mixxx, the #1 Free MP3 DJ Mixing software Today
http://mixxx.org


Mixxx-devel mailing list
Mixxx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/mixxx-devel

Re: [Mixxx-devel] Mixxx manual info

[Sean M. Pappalardo - D.J. Pegasus]

On 11/16/2017 01:26 PM, Daniel Schürmann wrote:
> I am afraid 2018-01-31 is to short for a polished English Doku and then
> wait for translations. So we need to find a mode to do things in parallel.

That's not really possible. Translators depend on the English manual
being complete and stable, so we have to do that first.

On 11/16/2017 11:38 AM, ronso wrote:
> I'd like to help improving the manual, though I'm not very patient nor
> super-skilled in DTP.
> I'll have a look at how all the formatting is done, also I'll ask a
> fellow graphic designer for feedback.

Note that the manual is created with Restructured Text so formatting can
be changed easily (using CSS) later. What matters right now is the
actual content: text, screen shots and diagrams.

Here are instructions to build and edit the manual:
https://github.com/mixxxdj/manual/blob/manual/README.md

Sincerely,
Sean M. Pappalardo
"D.J. Pegasus"
Mixxx Developer - Controller Specialist



smime.p7s
Description: S/MIME Cryptographic Signature
--
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot___
Get Mixxx, the #1 Free MP3 DJ Mixing software Today
http://mixxx.org


Mixxx-devel mailing list
Mixxx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/mixxx-devel