2011/7/18 Gregory Pittman <span dir="ltr"><<a href="mailto:gregp_ky@yahoo.com">gregp_ky@yahoo.com</a>></span><br><div class="gmail_quote"><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
<div><div></div><div class="h5">On 07/18/2011 09:59 AM, Louis Desjardins wrote:<br>
<blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
2011/7/10 Craig Bradney<<a href="mailto:cbradney@zip.com.au" target="_blank">cbradney@zip.com.au</a>><br>
<br>
<blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
On 7/10/11 8:26 AM, Louis Desjardins wrote:<br>
<blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
Hi,<br>
<br>
When I install 1.4 RC5 on Mac OS X I have access to "Aide>  Manuel de<br>
Scribus" (Help>  Scribus Manual) but it is in English.<br>
<br>
However it seems that on other platform the French Manual is accessible.<br>
</blockquote>
At<br>
<blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
least on Ale's machine, it is.<br>
<br>
How can I have access to this help on a Mac?<br>
<br>
<br>
</blockquote>
<br>
<br>
Commit 15825 removed the installation of anything but English docs, on<br>
all platforms - as the others are way out of date.<br>
</blockquote>
<br>
<br>
This needs to be nuanced.<br>
<br>
I am only aware of 3 languages total, including English (original text),<br>
French and German.<br>
<br>
It would be useful to have the sections tagged so we know what has been<br>
updated and what has not.<br>
<br>
For instance, large parts if not all parts of the various pages about Fonts<br>
(Fonts in depth, Non-Latin fonts, etc.) are in the same state they were at<br>
translation time and thus the FR translation for this part is still totally<br>
relevant.<br>
<br>
I can only suggest that we put a warning as a header to the sections that<br>
have been re-written so the readers know that a particular part have been<br>
significantly updated and they should refer to the English help and/or give<br>
a hand with the translation. This will increase the awareness about the need<br>
for good translation but can also serve as a basis for an updated text. One<br>
of the most difficult part in translating such texts as technical manual is<br>
the vocabulary and the co-occurrences (combination of words that you cannot<br>
find in a dictionary). Most of this job is now done in French and in German<br>
and can be of great help to translators taking over.<br>
<br>
I do not think that putting away all the translations just like that is the<br>
way to go.<br>
<br>
Mentioning "others are way out of date" seems a clear message but in fact it<br>
is too general as a statement. We need details at this point because in any<br>
event translation will be done word by word, sentence by sentence, section<br>
by section. We need to know which parts need care.<br>
<br>
At first glance we can also tell the Online Help is quite outdated itself in<br>
some aspects. One screenshot show 1.3.0 cvs. The list of release dates and<br>
versions stops Oct. 2010 with 1.3.9.<br>
<br>
As for the availability or relevantness of the other languages, the page My<br>
Tutorial has a link to a wiki page that is in English and refers to the<br>
Tutorial by Nyam Bushan which is available and easy to find on the Scribus<br>
website while the translation I made myself is much harder to find. I don’t<br>
discuss here about relevantness, I discuss the fact that this material is<br>
available in its original form in English and has a translation done in 2004<br>
and if one is available, the other should be too. In fact, I see no reason<br>
not to keep all that work available. They can by updated and/or translated<br>
in other languages. To my knowledge, this tutorial is one of the very few<br>
who talks about the PDF creation and edition capabillities of Scribus.<br>
<br>
</blockquote>
<br></div></div>
I think these are a number of valid points. Even within the realm of English doc updates, it gets hard to recognize which parts need updates and which do not. I suppose we need some scheme to help. One of the difficulties is that the age of a part of the docs isn't necessarily an indicator of a need to update.<br>

<br>
Having said this, I am quite open to helping anyone who wishes to contribute to the documentation see what needs to be done, whether it's in the English or some other language section. It seems that Alessandro Levati will be helping to create a first-time Italian version of the online manual soon.<br>

<br>
Whenever we have solid, helpful documentation, we all benefit. I don't know why anyone would believe that something must be created in English and then translated. We might as easily have new documentation in French, Italian, or German that gets translated to English later. This is exactly what happened with the Working with Master Pages article on the wiki, which originally was submitted in German.[1]<br>

<br>
Once you get into contributing docs you realize that you don't need to ask permission to contribute. Clearly there are areas of greater need than others, but we have a larger problem with inertia than misdirected effort.<br>

<br>
It would help me if someone could spell out the substantive pros and cons of various licencing options for the docs to help me understand why there are benefits or aggravations with one licence versus another... I am trying to submit work which can be freely used by anyone, but I would prefer not to have someone take this and make money from publishing it without paying back to Scribus in some way.<br>
</blockquote><div><br>Someone else will come with Licences explanations! :)<br><br>Could we say that the online help could much follow the menu structure of the applications itself with a minimum of contextual information when absolutely necessary. This means that we could treat this as an extended "tooltip" type of info, describing more in-depth the features and what the settings are all about. This would be useful to users but would definitely make a very boring book nobody would buy (and nobody would publish).<br>
<br>For me, a publishable book is a whole different thing.<br><br>There is a need for online help because tooltips can't tell it all and some features of Scribus are not as self-explanatory as they seem, especially for newcomers in the DTP world. So, people need more and there they could have it. We would then use a licence that would allow distros to ship the app and the doc at the same time.<br>
<br>For more, including details about how to use the software and explanations about printing and design, this is another story and, in my view, is a bit out of the topic of an online help.<br><br>The advantage I see as having a straight definition of what is Online Help and what should be in there is that it will allow better tracking possibilities and it will be easier to tag anything as "current with version x" or "outdated". For instance, ket's say we tag them with the version of the app. If a feature has not been changed, we change the tag to the next version of the app without change. If it was upgraded in a development series, then it's updated too in the Online Help and gets tagged so translators know about it. Hope this is clear.<br>
<br>Such Help would be easily translatable and updatable and we could use the same Qt-linguist that is used for the GUI and it would pose not much licence problems, I guess.<br><br>How does that sound?<br><br>Louis<br><br>
<br></div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
<br>
Greg<br>
<br>
[1] <a href="http://wiki.scribus.net/canvas/Arbeiten_mit_Musterseiten" target="_blank">http://wiki.scribus.net/<u></u>canvas/Arbeiten_mit_<u></u>Musterseiten</a><div><div></div><div class="h5"><br>
<br>
___<br>
Scribus Mailing List: <a href="mailto:scribus@lists.scribus.net" target="_blank">scribus@lists.scribus.net</a><br>
Edit your options or unsubscribe:<br>
<a href="http://lists.scribus.net/mailman/listinfo/scribus" target="_blank">http://lists.scribus.net/<u></u>mailman/listinfo/scribus</a><br>
See also:<br>
<a href="http://wiki.scribus.net" target="_blank">http://wiki.scribus.net</a><br>
<a href="http://forums.scribus.net" target="_blank">http://forums.scribus.net</a><br>
</div></div></blockquote></div><br><br>