DCS-Mirror
/
unfoldingWord_en_glm
mirror of https://git.door43.org/unfoldingWord/en_glm
2
0
Fork 0
Files Issues Releases Wiki Activity See in Reader

Update 'docs/gl_checking.rst'

This commit is contained in:
Perry J Oakes 2018-06-05 22:10:38 +00:00
parent 2a173051f9
commit a51315163d
1 changed files with 25 additions and 25 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

50
docs/gl_checking.rst
View File

@ -152,47 +152,47 @@ The purpose of the aligning tool in translationCore (tC) is to create highlighti
So as you align the GL text with the original language text, your job is to match as accurately as possible the words of the GL text to the words of the original text that express the same meaning.
The functionality of tC will increase over time, so some of these comments will need to be updated as tC changes.
• In tC 0.9.x, Only the translationWords and the Alignment tools are available.
• No alignment data is currently exported in the Export to CSV function.
• In tC 0.9.x, Only the translationWords and the Alignment tools are available.
• No alignment data is currently exported in the Export to CSV function.
To Begin:
---------
o On the project list screen, if the Select button is disabled for the desired project, click the Home icon or the Go to Tools button to launch the project.
o Only the English ULT and the Greek BHP are opened by default in the scripture panel. Click on the + sign in the rightmost section of the scripture panel to add another language. Use the X and + controls in the scripture to close and open the sections to move the languages to different sections.
• On the project list screen, if the Select button is disabled for the desired project, click the Home icon or the Go to Tools button to launch the project.
• Only the English ULT and the Greek BHP are opened by default in the scripture panel. Click on the + sign in the rightmost section of the scripture panel to add another language. Use the X and + controls in the scripture to close and open the sections to move the languages to different sections.
General aligning instructions:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
o The GL chapters and verses are listed down the left side. When you click on a verse to open it, the words of that verse appear in a vertical list, ordered from top to bottom, just to the right of the list of chapters and verses. Each word is in a separate box.
o The words of the original language text (Greek) for that verse are also in separate boxes in a field to the right of the GL word list. There is a space under each of the source word boxes outlined with a dotted line. Click and drag each word box of the GL text into the space under the word box of the source text that the GL word corresponds to. Drop it there. When the GL word is over a word box of the original, the dotted outline will turn blue to let you know that the word will drop there. If you make a mistake or decide that the GL word belongs somewhere else, simply drag it again to where it belongs. GL words can also be dragged back to the list.
o When the same GL word occurs more than once in a verse, each instance of the word will have a small superscript number after it. This number will help you to align each repeated GL word to the correct original word in the correct order.
• The GL chapters and verses are listed down the left side. When you click on a verse to open it, the words of that verse appear in a vertical list, ordered from top to bottom, just to the right of the list of chapters and verses. Each word is in a separate box.
• The words of the original language text (Greek) for that verse are also in separate boxes in a field to the right of the GL word list. There is a space under each of the source word boxes outlined with a dotted line. Click and drag each word box of the GL text into the space under the word box of the source text that the GL word corresponds to. Drop it there. When the GL word is over a word box of the original, the dotted outline will turn blue to let you know that the word will drop there. If you make a mistake or decide that the GL word belongs somewhere else, simply drag it again to where it belongs. GL words can also be dragged back to the list.
• When the same GL word occurs more than once in a verse, each instance of the word will have a small superscript number after it. This number will help you to align each repeated GL word to the correct original word in the correct order.
Merge and un-merge instructions/constraints:
""""""""""""""""""""""""""""""""""""""""""""
o tC supports one-to-one, one-to-many, many-to-one, and many-to-many alignments. That means that one or more GL words can be aligned to one or more Greek words, as necessary to get the most accurate alignment of the meaning conveyed by the two languages.
o To align multiple GL words to a single Greek word, simple drag and drop the GL words onto the box below the desired Greek word.
o When it is desired to align GL word(s) to a combination of Greek words, first drag one of the combination Greek words into the same box as the other Greek word. Multiple Greek words can be merged together in this fashion.
o To un-merge previously merged Greek words, drag the rightmost Greek word slightly to the right. A small new alignment box will appear, and the un-merged word can be dropped into that box.
o The leftmost Greek word can also be un-merged by dragging and dropping it into the Greek word box immediately to its left.
• tC supports one-to-one, one-to-many, many-to-one, and many-to-many alignments. That means that one or more GL words can be aligned to one or more Greek words, as necessary to get the most accurate alignment of the meaning conveyed by the two languages.
• To align multiple GL words to a single Greek word, simple drag and drop the GL words onto the box below the desired Greek word.
• When it is desired to align GL word(s) to a combination of Greek words, first drag one of the combination Greek words into the same box as the other Greek word. Multiple Greek words can be merged together in this fashion.
• To un-merge previously merged Greek words, drag the rightmost Greek word slightly to the right. A small new alignment box will appear, and the un-merged word can be dropped into that box.
• The leftmost Greek word can also be un-merged by dragging and dropping it into the Greek word box immediately to its left.
Expected behavior when un-merging Greek words:
""""""""""""""""""""""""""""""""""""""""""""""
o Any GL words that were aligned with that Greek word return to the word list.
o The Greek words should remain in the proper order. If the merge contains 3 or more Greek words, un-merge the rightmost Greek word first. Un-merging the center word(s) first may result in the Greek words becoming out of order. When that happens, un-merge the remaining words in that box to properly return the Greek words to their original order.
• Any GL words that were aligned with that Greek word return to the word list.
• The Greek words should remain in the proper order. If the merge contains 3 or more Greek words, un-merge the rightmost Greek word first. Un-merging the center word(s) first may result in the Greek words becoming out of order. When that happens, un-merge the remaining words in that box to properly return the Greek words to their original order.
Drag and drop alignment instructions/constraints (from and to the word list):
"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
o Many languages use indefinite and definite articles differently than does Greek. For English, we must do the following:
Align indefinite articles to their “head word.” For example, both “a” and “servant” should align to *doulos* in Titus 1:1.
Definite articles that English supplies should also be aligned to their “head word.” For example, both “the” and “faith” should align to *pistin* in Titus 1:1.
Greek definite articles that English does not use need to be combined with their Greek head word. For example, *ton* and *logon* need to be combined, then “word” aligned with that combination in Titus 1:3.
o Implicit verbs in Greek/Hebrew that are translated explicitly in the target language should be aligned with the predicate. For example, “he should be” that is supplied in English should be aligned to *philoxenon* along with “hospitable” in Titus 1:8.
o Words with apostrophes will be split and show up as 2 words in the word panel. This allows for proper alignment of the two parts of meaning. In most cases in English these are used to represent possession and will be aligned to a single Greek word in the genitive case. For example, both “God” and “s” will align to *theou* in Titus 1:1.
o Often the Greek and GL part of speech won’t match. That is inevitable. Often a Greek word will be translated as a GL phrase. For example, the three words “does not lie” in English all align with the single word *apseudes* in Titus 1:2.
• Many languages use indefinite and definite articles differently than does Greek. For English, we must do the following:
• Align indefinite articles to their “head word.” For example, both “a” and “servant” should align to *doulos* in Titus 1:1.
• Definite articles that English supplies should also be aligned to their “head word.” For example, both “the” and “faith” should align to *pistin* in Titus 1:1.
• Greek definite articles that English does not use need to be combined with their Greek head word. For example, *ton* and *logon* need to be combined, then “word” aligned with that combination in Titus 1:3.
• Implicit verbs in Greek/Hebrew that are translated explicitly in the target language should be aligned with the predicate. For example, “he should be” that is supplied in English should be aligned to *philoxenon* along with “hospitable” in Titus 1:8.
• Words with apostrophes will be split and show up as 2 words in the word panel. This allows for proper alignment of the two parts of meaning. In most cases in English these are used to represent possession and will be aligned to a single Greek word in the genitive case. For example, both “God” and “s” will align to *theou* in Titus 1:1.
• Often the Greek and GL part of speech won’t match. That is inevitable. Often a Greek word will be translated as a GL phrase. For example, the three words “does not lie” in English all align with the single word *apseudes* in Titus 1:2.
Alignment instructions for the ULT
----------------------------------
@ -200,10 +200,10 @@ Alignment instructions for the ULT
• The ULT is intended to be a fairly literal translation of the original, so that it reproduces the structure of the original language when that is also understandable in the GL. Ideally, then, there would be one GL word aligned with each Greek or Hebrew word. Of course, this is not possible, because languages work very differently from each other. Therefore, we expect that you must align words or phrases in the GL with words or phrases in the Greek or Hebrew that differ in the number of words, order of words, and parts of speech, as described above. Always, however, you should align the GL words to the Greek or Hebrew words whose meaning they express, in whatever combination is necessary to produce the most accurate alignment of the meaning.
• After aligning a verse, there may be words in the GL text that are left over and seem to be extra. If those words are truly necessary for the GL text to make sense, then find the original word or words that they help to express and align them there. But if those words do not express a meaning found in the original text, then it may be that those words should be deleted from the GL text.
• Sometimes, in the process of aligning a verse, you will find:
o A Greek or Hebrew word that is not represented in the GL translation.
o A mistake in the GL translation.
o Words in the GL translation that do not represent anything in the original text.
o A better or more literal way to express something in the GL translation.
• A Greek or Hebrew word that is not represented in the GL translation.
• A mistake in the GL translation.
• Words in the GL translation that do not represent anything in the original text.
• A better or more literal way to express something in the GL translation.
• In those cases, if you are an authorized editor using tC version 0.9.1 or above, you will want to edit the GL translation so that it is more accurate to the original.
• If you notice places where the ULT is wrong or potentially wrong, create an issue for it at https://git.door43.org/Door43/en_ult/issues and we’ll address it in the next release. In the meantime, align the text as well as possible.