[scribus-dev] Scribus documentation translations temporarily removed from builds

Louis Desjardins louis.desjardins at gmail.com
Tue Nov 30 20:12:17 CET 2010


2010/11/30 Craig Bradney <cbradney at scribus.info>

>
>
>
>
>
> On 30/11/2010, at 3:07 PM, Louis Desjardins <louis.desjardins at gmail.com>
> wrote:
>
> 2010/11/30 "Christoph Schäfer" < <christoph-schaefer at gmx.de>
> christoph-schaefer at gmx.de>
>
>> Am Montag, 29. November 2010, 10:14:53 schrieb Louis Desjardins:
>> > 2010/11/29 Gregory Pittman < <gpittman at iglou.com>gpittman at iglou.com>
>> >
>> > > On 11/28/2010 10:23 PM, Louis Desjardins wrote:
>> > >> 2010/11/28 Gregory Pittman < <gpittman at iglou.com>gpittman at iglou.com
>> > >> <mailto: <gpittman at iglou.com>gpittman at iglou.com
>> > >>
>> > >>    I think that when we get some translators on board for the docs,
>> > >>    the
>> > >>    screenshots aren't so hard to do. If we knew we had them, I
>> > >>    could be
>> > >>    making dialog screenshots in various languages as I go...
>> > >>
>> > >> Good evening Greg,
>> > >>
>> > >> The issue here is to have material readily available to whoever wants
>> > >> to
>> > >> translate any part of the documentation without even having to ask
>> for
>> > >> it.
>> > >
>> > > I disagree. The issue is getting translators on board actually working
>> > > on
>> > > the translations. The raw material they need is present in the
>> 1.3.9svn
>> > > version of Scribus. Witness our Italian friend Alevati feverishly
>> > > working on Italian translations for the wiki pages, and it doesn't
>> seem
>> > > he is inhibited by the use of English-language screenshots.
>> >
>> > I guess this mostly depends on the skills of the translator. I am still
>> on
>> > the opinion that if we’d have an automated way of outputting those
>> > screenshots, it would be helpful. Mind you, we don’t need to run the
>> script
>> > all the time. But from time to time, when for instance a stable version
>> is
>> > released, then we can produce the screenshots for all.
>> >
>> > > One of the big problems we had with the printed manual was getting
>> > > output
>> > > from those who told us they would contribute. I can step in and begin
>> > > making screenshots showing the content pertinent to the text, in
>> > > whatever language. It may be that some translators won't mind or would
>> > > prefer to make their own.
>> > >
>> > > There is not quite so much work as it would seem, since there is still
>> > > quite a bit of content that Christoph and I agree is quite out of
>> date,
>> > > and wrong to varying degrees, with screenshots that make little sense
>> > > in the context of current Scribus versions.
>> >
>> > I am not talking about wrong or outdated content but I am looking ahead
>> to
>> > see how we could improve the translation of the doc. To me, it is *not*
>> a
>> > success so far. We have outdated French translation, and I don’t know
>> the
>> > status for German. Do we have other translations for the doc? Now I am
>> happy
>> > to read we’re going to have an Italian version. We have 49 languages in
>> the
>> > GUI list. When we call up the online help, we are sent to:
>> >
>> > <http://docs.scribus.net/>http://docs.scribus.net/
>> >
>> > where we have currently 3 languages. This is short, don’t you think ?
>> >
>> > The screenshots of this doc seem outdated for most of what I see after a
>> > quick overview — however much of this information is still valuable as
>> the
>> > program has evolved but we are still in DTP... and the basic principles
>> are
>> > covered. Anyway, this needs to be updated too.
>> >
>> > If the doc was available for translation as a wikipedia article for
>> > instance, and we could merge automatically — when the developers think
>> it is
>> > time to do it — the screenshots, then I think we could see more action
>> on
>> > the translation front.
>> >
>> > Do you know how many screenshots we have in the Manual ?
>> >
>> > Of course, don't get me wrong, I don’t think it is only a matter of
>> > screenshots... of course.
>> >
>> > I am looking for a solution. To me, one book in English and online help
>> in 2
>> > more languages is a signal that something needs to be improved. I don’t
>> say
>> > my solution is the best but I think it’s worth digging a bit in that
>> > direction. Only showing the work is already started can convince someone
>> to
>> > step in and give a hand.
>>
>> I think we need to put this into perspective. We're talking about the
>> Online Help here. This means that not all screenshots need to be redone for
>> a translation, as only some of them are language/UI-specific.
>
>
> Most if not all dialog show at least a few words. If we get a mix of
> languages in the dialog screenshots, it will look like unfinished work and
> to a lot of users it wil not be appealing. From the user perspective I don’t
> think this should even be in discussion.
>
>
>> Plus, since it's highly unlikely that a translator can work like a
>> machine, the files will be translated one by one, and a translator can
>> create a localised screenshot whenever it's necessary. In other words: there
>> are no robo-translators, thus, no need for robo-screenshots.
>
>
> The machine metaphor is certainly funny but it doesn’t help diminish the
> work. Doing screenshots does take time. All I am saying is let’s give a hand
> to translators, show them that we have cared enough to get the work started,
> we have a template, they can concentrate on the translation itself, they
> have the screenshots in their target language and thus the right terminology
> in front of them right at the start of the work. The work can also be more
> easily distributed if all the work is done online.
>
>
>> And, as Greg already mentioned, we need human beings willing to do the
>> work before we can start the creation of language-specific screenshots.
>
>
> The way around. I think we have all the evidences that this doesn’t work.
> The numbers are clear. We have 3 languages out of 49. The doc has been in
> that language state for years as the GUI has evolved a lot faster. I was
> even surprised at the end of the count to be at 49! Wow! If so many people
> care about the GUI translation, I guess that we should understand the
> message.
>
>
>> We simply do not know for how many languages there will be volunteers.
>
>
> So far, 49 languages.
>
>
>> It may be possible to automate the creation of screenshots, but I doubt
>> this is worth the efforts, as someone will have to write the code.
>
>
> Again, not only a matter of screenshots. Putting all this in a wikipedia
> like access and already providing the frame will definitely help translators
> get started, even if they have very little time to spend. Again, distributed
> work is the key.
>
>
>> On the other hand, what would be really useful is a set of sample files
>> that can be used across translations, to make sure that screenshots show the
>> same content in all language versions. This set of files can be created when
>> the update to the English version has been more or less completed.
>>
>
> Maybe you can explain what you have in mind here. I don’t get the idea.
>
> Cheers!
>
> Louis
>
>>
>> Christoph
>> --
>> Neu: GMX De-Mail - Einfach wie E-Mail, sicher wie ein Brief!
>> Jetzt De-Mail-Adresse reservieren: <http://portal.gmx.net/de/go/demail>
>> http://portal.gmx.net/de/go/demail
>>
>> _______________________________________________
>> scribus-dev mailing list
>>  <scribus-dev at lists.scribus.net>scribus-dev at lists.scribus.net
>>  <http://lists.scribus.net/mailman/listinfo/scribus-dev>
>> http://lists.scribus.net/mailman/listinfo/scribus-dev
>>
> _______________________________________________
> scribus-dev mailing list
> scribus-dev at lists.scribus.net
> http://lists.scribus.net/mailman/listinfo/scribus-dev
>
>
> A few thousand strings in the GUI is significantly less work than tens of
> HTML help files. Is is very unlikely we will find people so ready to
> translate documentation.
>

Maybe we will not find them. They will find us.

Unquestionably, there is a need for documentation.

And there are some countries where it’s possible to get some help for this
kind of effort. Once we have Spanish, Portuguese, French, Italian,
Russian... we cover quite a few potential users with those languages. More
and more are then expected to join.

The question could be "can we make that easier so more translators can step
in"?

More people could also be involved into the writing/updating process?

Only thoughts.

Louis


>
> Craig
>
> _______________________________________________
> scribus-dev mailing list
> scribus-dev at lists.scribus.net
> http://lists.scribus.net/mailman/listinfo/scribus-dev
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.scribus.net/pipermail/scribus-dev/attachments/20101130/2418b332/attachment-0001.htm>


More information about the scribus-dev mailing list