You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-dev@db.apache.org by "Halley Pacheco de Oliveira (JIRA)" <de...@db.apache.org> on 2005/12/22 12:06:30 UTC
[jira] Created: (DERBY-780) Getting Started manual translated into Brazilian Portuguese
Getting Started manual translated into Brazilian Portuguese
-----------------------------------------------------------
Key: DERBY-780
URL: http://issues.apache.org/jira/browse/DERBY-780
Project: Derby
Type: Improvement
Components: Documentation
Versions: 10.1.1.0
Environment: DITA-sourced documentation
Reporter: Halley Pacheco de Oliveira
DITA files from %DOC_ROOT%/trunk/src/getstart translated into Brazilian Portuguese to be attached following "Andrew McIntyre" <mc...@gmail.com> instructions Re: How do I contribute translation? 11501 and 11503 on derby-dev Digest 13 Dec 2005 23:33:11 -0000 Issue 597
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
http://www.atlassian.com/software/jira
Re: [jira] Commented: (DERBY-780) Getting Started manual translated
into Brazilian Portuguese
Posted by scott hutinger <S-...@wiu.edu>.
Very cool indeed! :-)
I think this is correct for Brazilian Portuguese; pt_BR
But I am not 100% certain.
One question is the directory layout. Should it be something like
src/en
src/pt_BR
etc?
Should the output be something like
getstarted_en.pdf
getstarted_pt_BR.pdf
I did the following, although I am thinking this might not be a very
good method. I copied the getstart directory of pt_BR into
src/getstart_pt_BR, then added the following lines to build.xml
Index: build.xml
===================================================================
--- build.xml (revision 358619)
+++ build.xml (working copy)
@@ -101,7 +101,14 @@
</target>
<target name="pdf"
depends="init,pdf.getstart,pdf.tools,pdf.devguide,pdf.adminguide,pdf.ref,pdf.tuning"/>
-
+
+ <target name="pdf.getstart_pt_BR" depends="init">
+ <antcall target="pdf.dita">
+ <param name="manual.name" value="getstart_pt_BR"/>
+ <param name="manual.ditamap" value="getstartderby.ditamap"/>
+ </antcall>
+ </target>
+
<target name="pdf.getstart" depends="init">
<antcall target="pdf.dita">
<param name="manual.name" value="getstart"/>
The output was:
out/getstart:
getstartderby.fo getstart-single.html
out/getstart_pt_BR:
getstartderby.fo getstartderby.pdf
I think it best if we tag the language to the end of the file (before
the .html .pdf etc). For example getstartderby_pt_BR.pdf and possibly
put the file in getstart so all languages will be within the getstart.
So the above isn't quite correct from my point of view. I think file
name collisions are highly likely without tagging the language to the
file itself?
I'm a bit uncertain about your question about how to keep everything
synced. I guess svn diffs would be the easiest to keep track of(?)
Also, I think their must be a better method to build different languages
than adding them manually to the build.xml file. I would have to look
into ant a bit to figure that out, unless someone knows a good answer.
scott
Jeff Levitt (JIRA) wrote:
> [ http://issues.apache.org/jira/browse/DERBY-780?page=comments#action_12361132 ]
>
> Jeff Levitt commented on DERBY-780:
> -----------------------------------
>
> While I cant comment on the content (since I can't read Brazilian Portoguese), I can say that I checked the build of these dita files by substituting them for the getting started english files and running the derby docs build using ant, and everything looks great. Thanks Halley for such a great contribution to Derby!
>
> Since this is the first documentation translating contributed to Derby, I think a discussion is warranted on how we want these placed in the build. Should users have a choice to download translated docs or does everything go at once? Do we have a mirrored nightly build process for the website that produces nightly translated documentation alongside the English, and if so, how much work would that entail to set up? Finally, if changes are made to the english docs, how do we make sure changes are made in the corresponding translated book, or at least track those changes so a translater can make the changes when they want to?
>
>
>> Getting Started manual translated into Brazilian Portuguese
>> -----------------------------------------------------------
>>
>> Key: DERBY-780
>> URL: http://issues.apache.org/jira/browse/DERBY-780
>> Project: Derby
>> Type: Improvement
>> Components: Documentation
>> Versions: 10.1.1.0
>> Environment: DITA-sourced documentation
>> Reporter: Halley Pacheco de Oliveira
>> Attachments: getstart.tgz
>>
>> DITA files from %DOC_ROOT%/trunk/src/getstart translated into Brazilian Portuguese to be attached following "Andrew McIntyre" <mc...@gmail.com> instructions Re: How do I contribute translation? 11501 and 11503 on derby-dev Digest 13 Dec 2005 23:33:11 -0000 Issue 597
>>
>
>
[jira] Commented: (DERBY-780) Getting Started manual translated into Brazilian Portuguese
Posted by "Jeff Levitt (JIRA)" <de...@db.apache.org>.
[ http://issues.apache.org/jira/browse/DERBY-780?page=comments#action_12361132 ]
Jeff Levitt commented on DERBY-780:
-----------------------------------
While I cant comment on the content (since I can't read Brazilian Portoguese), I can say that I checked the build of these dita files by substituting them for the getting started english files and running the derby docs build using ant, and everything looks great. Thanks Halley for such a great contribution to Derby!
Since this is the first documentation translating contributed to Derby, I think a discussion is warranted on how we want these placed in the build. Should users have a choice to download translated docs or does everything go at once? Do we have a mirrored nightly build process for the website that produces nightly translated documentation alongside the English, and if so, how much work would that entail to set up? Finally, if changes are made to the english docs, how do we make sure changes are made in the corresponding translated book, or at least track those changes so a translater can make the changes when they want to?
> Getting Started manual translated into Brazilian Portuguese
> -----------------------------------------------------------
>
> Key: DERBY-780
> URL: http://issues.apache.org/jira/browse/DERBY-780
> Project: Derby
> Type: Improvement
> Components: Documentation
> Versions: 10.1.1.0
> Environment: DITA-sourced documentation
> Reporter: Halley Pacheco de Oliveira
> Attachments: getstart.tgz
>
> DITA files from %DOC_ROOT%/trunk/src/getstart translated into Brazilian Portuguese to be attached following "Andrew McIntyre" <mc...@gmail.com> instructions Re: How do I contribute translation? 11501 and 11503 on derby-dev Digest 13 Dec 2005 23:33:11 -0000 Issue 597
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
http://www.atlassian.com/software/jira
[jira] Commented: (DERBY-780) Getting Started manual translated into Brazilian Portuguese
Posted by "Halley Pacheco de Oliveira (JIRA)" <de...@db.apache.org>.
[ http://issues.apache.org/jira/browse/DERBY-780?page=comments#action_12361227 ]
Halley Pacheco de Oliveira commented on DERBY-780:
--------------------------------------------------
Answering two Jeff Levit's questions:
Should users have a choice to download translated docs or does everything go at once?
My intention now is to translate the reference manual with more than 300 files, so it will take a long time. I think it would be good to have a choice of committing the translated files once a day, and not having to wait until everything is translated.
Do we have a mirrored nightly build process for the website that produces nightly translated documentation alongside the English, and if so, how much work would that entail to set up?
A nightly build process would allow having a partially translated manual, and the readers detecting errors while it is translated.
> Getting Started manual translated into Brazilian Portuguese
> -----------------------------------------------------------
>
> Key: DERBY-780
> URL: http://issues.apache.org/jira/browse/DERBY-780
> Project: Derby
> Type: Improvement
> Components: Documentation
> Versions: 10.1.1.0
> Environment: DITA-sourced documentation
> Reporter: Halley Pacheco de Oliveira
> Attachments: getstart.tgz
>
> DITA files from %DOC_ROOT%/trunk/src/getstart translated into Brazilian Portuguese to be attached following "Andrew McIntyre" <mc...@gmail.com> instructions Re: How do I contribute translation? 11501 and 11503 on derby-dev Digest 13 Dec 2005 23:33:11 -0000 Issue 597
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
http://www.atlassian.com/software/jira
[jira] Commented: (DERBY-780) Getting Started manual translated
into Brazilian Portuguese
Posted by "Jean T. Anderson (JIRA)" <de...@db.apache.org>.
[ http://issues.apache.org/jira/browse/DERBY-780?page=comments#action_12368725 ]
Jean T. Anderson commented on DERBY-780:
----------------------------------------
Commit access at Apache gets enabled for a repository -- i.e., at the svn.apache.org/repos/asf/db/derby level. Submitting patches with many changes isn't any problem at all and large patches get submitted regularly on the Derby project, so don't worry about the size of a patch. http://db.apache.org/derby/manuals/dita.html#Submitting+documentation+patches explains how to create patches for the Derby DITA files using 'svn diff'.
> Getting Started manual translated into Brazilian Portuguese
> -----------------------------------------------------------
>
> Key: DERBY-780
> URL: http://issues.apache.org/jira/browse/DERBY-780
> Project: Derby
> Type: Improvement
> Components: Documentation
> Versions: 10.1.1.0
> Environment: DITA-sourced documentation
> Reporter: Halley Pacheco de Oliveira
> Assignee: Halley Pacheco de Oliveira
> Fix For: 10.2.0.0
> Attachments: getstart.tgz
>
> DITA files from %DOC_ROOT%/trunk/src/getstart translated into Brazilian Portuguese to be attached following "Andrew McIntyre" <mc...@gmail.com> instructions Re: How do I contribute translation? 11501 and 11503 on derby-dev Digest 13 Dec 2005 23:33:11 -0000 Issue 597
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
http://www.atlassian.com/software/jira
[jira] Commented: (DERBY-780) Getting Started manual translated
into Brazilian Portuguese
Posted by "Jean T. Anderson (JIRA)" <de...@db.apache.org>.
[ http://issues.apache.org/jira/browse/DERBY-780?page=comments#action_12367424 ]
Jean T. Anderson commented on DERBY-780:
----------------------------------------
Halley Pacheco de Oliveira's icla is now recorded at the ASF, resolving the issue raised at http://mail-archives.apache.org/mod_mbox/db-derby-dev/200512.mbox/%3c43AAC118.2010401@debrunners.com%3e.
> Getting Started manual translated into Brazilian Portuguese
> -----------------------------------------------------------
>
> Key: DERBY-780
> URL: http://issues.apache.org/jira/browse/DERBY-780
> Project: Derby
> Type: Improvement
> Components: Documentation
> Versions: 10.1.1.0
> Environment: DITA-sourced documentation
> Reporter: Halley Pacheco de Oliveira
> Attachments: getstart.tgz
>
> DITA files from %DOC_ROOT%/trunk/src/getstart translated into Brazilian Portuguese to be attached following "Andrew McIntyre" <mc...@gmail.com> instructions Re: How do I contribute translation? 11501 and 11503 on derby-dev Digest 13 Dec 2005 23:33:11 -0000 Issue 597
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
http://www.atlassian.com/software/jira
[jira] Assigned: (DERBY-780) Getting Started manual translated into
Brazilian Portuguese
Posted by "Andrew McIntyre (JIRA)" <de...@db.apache.org>.
[ http://issues.apache.org/jira/browse/DERBY-780?page=all ]
Andrew McIntyre reassigned DERBY-780:
-------------------------------------
Assign To: Halley Pacheco de Oliveira
> Getting Started manual translated into Brazilian Portuguese
> -----------------------------------------------------------
>
> Key: DERBY-780
> URL: http://issues.apache.org/jira/browse/DERBY-780
> Project: Derby
> Type: Improvement
> Components: Documentation
> Versions: 10.1.1.0
> Environment: DITA-sourced documentation
> Reporter: Halley Pacheco de Oliveira
> Assignee: Halley Pacheco de Oliveira
> Fix For: 10.2.0.0
> Attachments: getstart.tgz
>
> DITA files from %DOC_ROOT%/trunk/src/getstart translated into Brazilian Portuguese to be attached following "Andrew McIntyre" <mc...@gmail.com> instructions Re: How do I contribute translation? 11501 and 11503 on derby-dev Digest 13 Dec 2005 23:33:11 -0000 Issue 597
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
http://www.atlassian.com/software/jira
[jira] Resolved: (DERBY-780) Getting Started manual translated into
Brazilian Portuguese
Posted by "Andrew McIntyre (JIRA)" <de...@db.apache.org>.
[ http://issues.apache.org/jira/browse/DERBY-780?page=all ]
Andrew McIntyre resolved DERBY-780:
-----------------------------------
Fix Version: 10.2.0.0
Resolution: Fixed
Committed revision 379979. Thanks Halley for contributing these translations to Derby!
> Getting Started manual translated into Brazilian Portuguese
> -----------------------------------------------------------
>
> Key: DERBY-780
> URL: http://issues.apache.org/jira/browse/DERBY-780
> Project: Derby
> Type: Improvement
> Components: Documentation
> Versions: 10.1.1.0
> Environment: DITA-sourced documentation
> Reporter: Halley Pacheco de Oliveira
> Fix For: 10.2.0.0
> Attachments: getstart.tgz
>
> DITA files from %DOC_ROOT%/trunk/src/getstart translated into Brazilian Portuguese to be attached following "Andrew McIntyre" <mc...@gmail.com> instructions Re: How do I contribute translation? 11501 and 11503 on derby-dev Digest 13 Dec 2005 23:33:11 -0000 Issue 597
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
http://www.atlassian.com/software/jira
[jira] Commented: (DERBY-780) Getting Started manual translated
into Brazilian Portuguese
Posted by "Jean T. Anderson (JIRA)" <de...@db.apache.org>.
[ http://issues.apache.org/jira/browse/DERBY-780?page=comments#action_12369113 ]
Jean T. Anderson commented on DERBY-780:
----------------------------------------
Committed Halley Pacheco de Oliveria's patch (getstart1.diff) to the trunk, revision 383727. Modified file:
$ svn commit
Sending trunk/src/pt_BR/getstart/rgsdocs17307.dita
> Getting Started manual translated into Brazilian Portuguese
> -----------------------------------------------------------
>
> Key: DERBY-780
> URL: http://issues.apache.org/jira/browse/DERBY-780
> Project: Derby
> Type: Improvement
> Components: Documentation
> Versions: 10.1.1.0
> Environment: DITA-sourced documentation
> Reporter: Halley Pacheco de Oliveira
> Assignee: Halley Pacheco de Oliveira
> Fix For: 10.2.0.0
> Attachments: getstart.tgz, getstart1.diff
>
> DITA files from %DOC_ROOT%/trunk/src/getstart translated into Brazilian Portuguese to be attached following "Andrew McIntyre" <mc...@gmail.com> instructions Re: How do I contribute translation? 11501 and 11503 on derby-dev Digest 13 Dec 2005 23:33:11 -0000 Issue 597
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
http://www.atlassian.com/software/jira
[jira] Commented: (DERBY-780) Getting Started manual translated
into Brazilian Portuguese
Posted by "Fernanda Pizzorno (JIRA)" <de...@db.apache.org>.
[ http://issues.apache.org/jira/browse/DERBY-780?page=comments#action_12368462 ]
Fernanda Pizzorno commented on DERBY-780:
-----------------------------------------
"Manual de Referência do Derby
Documenta a implementação da linguagem SQL no Derby. Além disso, fornece informações de referência para as implementações de JDBC e JTA do Derby, palavras-chave, tabelas do sistema e SQLExceptions. "
"Derby Reference Manual
Documents Derby's implementation of the SQL language. Also provides reference information for Derby's JDBC and JTA implementations, keywords, system tables, properties, and SQLExceptions. "
"properties" is missing in the last sentence of the brazilian portuguese version. Should this be filed as an own JIRA issue?
> Getting Started manual translated into Brazilian Portuguese
> -----------------------------------------------------------
>
> Key: DERBY-780
> URL: http://issues.apache.org/jira/browse/DERBY-780
> Project: Derby
> Type: Improvement
> Components: Documentation
> Versions: 10.1.1.0
> Environment: DITA-sourced documentation
> Reporter: Halley Pacheco de Oliveira
> Assignee: Halley Pacheco de Oliveira
> Fix For: 10.2.0.0
> Attachments: getstart.tgz
>
> DITA files from %DOC_ROOT%/trunk/src/getstart translated into Brazilian Portuguese to be attached following "Andrew McIntyre" <mc...@gmail.com> instructions Re: How do I contribute translation? 11501 and 11503 on derby-dev Digest 13 Dec 2005 23:33:11 -0000 Issue 597
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
http://www.atlassian.com/software/jira
[jira] Updated: (DERBY-780) Getting Started manual translated into
Brazilian Portuguese
Posted by "Halley Pacheco de Oliveira (JIRA)" <de...@db.apache.org>.
[ http://issues.apache.org/jira/browse/DERBY-780?page=all ]
Halley Pacheco de Oliveira updated DERBY-780:
---------------------------------------------
Attachment: getstart1.diff
Patch to correct the error found by Fernanda Pizzorno in Getting Started manual translated into Brazilian Portuguese (svn diff).
> Getting Started manual translated into Brazilian Portuguese
> -----------------------------------------------------------
>
> Key: DERBY-780
> URL: http://issues.apache.org/jira/browse/DERBY-780
> Project: Derby
> Type: Improvement
> Components: Documentation
> Versions: 10.1.1.0
> Environment: DITA-sourced documentation
> Reporter: Halley Pacheco de Oliveira
> Assignee: Halley Pacheco de Oliveira
> Fix For: 10.2.0.0
> Attachments: getstart.tgz, getstart1.diff
>
> DITA files from %DOC_ROOT%/trunk/src/getstart translated into Brazilian Portuguese to be attached following "Andrew McIntyre" <mc...@gmail.com> instructions Re: How do I contribute translation? 11501 and 11503 on derby-dev Digest 13 Dec 2005 23:33:11 -0000 Issue 597
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
http://www.atlassian.com/software/jira
[jira] Commented: (DERBY-780) Getting Started manual translated
into Brazilian Portuguese
Posted by "Halley Pacheco de Oliveira (JIRA)" <de...@db.apache.org>.
[ http://issues.apache.org/jira/browse/DERBY-780?page=comments#action_12368471 ]
Halley Pacheco de Oliveira commented on DERBY-780:
--------------------------------------------------
Almost certainly, what Fernanda found was not the only translation error in this manual. I'm sure there must be more translation errors. Once the Reference Manual that I'm finishing the translation (216 pages translated out of 237 pages in the pdf version) is bigger than Getting Started, probably the number of translation errors will be bigger too. So I think it would be good if I could correct the errors reported by others and found by myself, and send changes from my working copy to the repository directly using svn commit. In this case, I would be a commiter to pt_BR translations only. The errors could be reported to me directly, as a Jira issue, or in any other way.
> Getting Started manual translated into Brazilian Portuguese
> -----------------------------------------------------------
>
> Key: DERBY-780
> URL: http://issues.apache.org/jira/browse/DERBY-780
> Project: Derby
> Type: Improvement
> Components: Documentation
> Versions: 10.1.1.0
> Environment: DITA-sourced documentation
> Reporter: Halley Pacheco de Oliveira
> Assignee: Halley Pacheco de Oliveira
> Fix For: 10.2.0.0
> Attachments: getstart.tgz
>
> DITA files from %DOC_ROOT%/trunk/src/getstart translated into Brazilian Portuguese to be attached following "Andrew McIntyre" <mc...@gmail.com> instructions Re: How do I contribute translation? 11501 and 11503 on derby-dev Digest 13 Dec 2005 23:33:11 -0000 Issue 597
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
http://www.atlassian.com/software/jira
[jira] Updated: (DERBY-780) Getting Started manual translated into Brazilian Portuguese
Posted by "Halley Pacheco de Oliveira (JIRA)" <de...@db.apache.org>.
[ http://issues.apache.org/jira/browse/DERBY-780?page=all ]
Halley Pacheco de Oliveira updated DERBY-780:
---------------------------------------------
Attachment: getstart.tgz
Getting Started manual translated into Brazilian Portuguese DITA files tar zipped.
> Getting Started manual translated into Brazilian Portuguese
> -----------------------------------------------------------
>
> Key: DERBY-780
> URL: http://issues.apache.org/jira/browse/DERBY-780
> Project: Derby
> Type: Improvement
> Components: Documentation
> Versions: 10.1.1.0
> Environment: DITA-sourced documentation
> Reporter: Halley Pacheco de Oliveira
> Attachments: getstart.tgz
>
> DITA files from %DOC_ROOT%/trunk/src/getstart translated into Brazilian Portuguese to be attached following "Andrew McIntyre" <mc...@gmail.com> instructions Re: How do I contribute translation? 11501 and 11503 on derby-dev Digest 13 Dec 2005 23:33:11 -0000 Issue 597
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
http://www.atlassian.com/software/jira
[jira] Closed: (DERBY-780) Getting Started manual translated into
Brazilian Portuguese
Posted by "Halley Pacheco de Oliveira (JIRA)" <de...@db.apache.org>.
[ http://issues.apache.org/jira/browse/DERBY-780?page=all ]
Halley Pacheco de Oliveira closed DERBY-780:
--------------------------------------------
> Getting Started manual translated into Brazilian Portuguese
> -----------------------------------------------------------
>
> Key: DERBY-780
> URL: http://issues.apache.org/jira/browse/DERBY-780
> Project: Derby
> Type: Improvement
> Components: Documentation
> Versions: 10.1.1.0
> Environment: DITA-sourced documentation
> Reporter: Halley Pacheco de Oliveira
> Assignee: Halley Pacheco de Oliveira
> Fix For: 10.2.0.0
> Attachments: getstart.tgz, getstart1.diff
>
> DITA files from %DOC_ROOT%/trunk/src/getstart translated into Brazilian Portuguese to be attached following "Andrew McIntyre" <mc...@gmail.com> instructions Re: How do I contribute translation? 11501 and 11503 on derby-dev Digest 13 Dec 2005 23:33:11 -0000 Issue 597
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
http://www.atlassian.com/software/jira