Update 'docs/gl_checking.rst'

This commit is contained in:
Perry J Oakes 2018-06-05 22:04:20 +00:00
parent 7bb1e7f2df
commit 2a173051f9
1 changed files with 35 additions and 35 deletions

View File

@ -148,84 +148,84 @@ Additional questions that can help you to evaluate if the translation has been s
Aligning Gateway Language Translations
======================================
The purpose of the aligning tool in tC is to create highlighting that will appear for the MTT who will use the GL text as a source text for an OL translation. This highlighting will show the user of the GL text how that GL text represents the meaning of the original biblical language text. When the MTT uses the translationWords or translationNotes tools in tC, the aligned GL text will allow tC to highlight the word or phrase that the tC check is talking about in both the original biblical language and the GL. This will help the MTT to see how the biblical language expressed that meaning, how the GL expressed that meaning, and how he might express that same meaning in the target language.
The purpose of the aligning tool in translationCore (tC) is to create highlighting that will appear for the OL translator who will use the GL text as a source text for an OL translation. This highlighting will show the user of the GL text how that GL text represents the meaning of the original biblical language text. When the OL translator uses the translationWords or translationNotes tools in tC, the aligned GL text will allow tC to highlight the word or phrase that the tC check is talking about in both the original biblical language and the GL. This will help the OL translator to see how the biblical language expressed that meaning, how the GL expressed that meaning, and how he might express that same meaning in the target language.
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.8.0, Only Titus projects can be opened, and Only the Alignment tool is available.
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.
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 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.
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 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.
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 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.
Expected behavior when un-merging Greek words:
""""""""""""""""""""""""""""""""""""""""""""""
o Any GL words that were aligned with that Greek word return to the word list.
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.
Drag and drop alignment instructions/constraints(from and to the word list):
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 wont 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.
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 wont 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
----------------------------------
• 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.
• In those cases, you will want to edit the GL translation so that it is more accurate to the original. This will be possible in tC version 0.9. Until then, the GL text will need to be edited elsewhere.
• If you notice places where the ULT is wrong or potentially wrong, create an issue for it at https://git.door43.org/Door43/en_ulb/issues and well address it in the next release. In the meantime, align the text as well as possible.
• 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.
• 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 well address it in the next release. In the meantime, align the text as well as possible.
Alignment instructions for the UST
----------------------------------
• The UST is intended to be, above all, a clear translation. Therefore, it adds words and phrases to explain the meaning of the original for the reader. These words and phrases should be aligned with the word or words that they are explaining. For example, in Titus 1:1, the sentence, “I am a servant” must be aligned with the single word, doulos.
• When aligning the many words of the UST that explain single words of the original, often the GL words will be so many that they will run behind the next word of the original. The words are still there, but you cannot see them. This is a problem that will be fixed in tC 0.9.
• Be sure that the dotted outline of the word box where you want to drop the GL word turns blue before you drop it. That is the indication that tC gives you of where the word will drop. If you pay attention to this, you will avoid having the GL word drop in the wrong place, such as to the string of words that may be running behind that word.
• Sometimes, for the sake of clarity, the GL of the UST will repeat things that are only mentioned once in the original. This often happens with subjects or objects of sentences. For example, in Titus 2:9 the English UST refers to “their masters” twice, although the Greek only has idiois despotais once. In these cases, You should align each occurrence of the repeated reference with the same Greek words, so that the highlighting will show that each of these represents the meaning conveyed by those same words of the original.
• The UST is intended to be, above all, a clear translation. Therefore, it adds words and phrases to explain the meaning of the original for the reader. These words and phrases should be aligned with the word or words that they are explaining. For example, in Titus 1:1, the sentence, “I am a servant” must be aligned with the single word, *doulos*.
• Be sure that the dotted outline of the word box where you want to drop the GL word turns blue before you drop it. That is the indication that tC gives you of where the word will drop. If you pay attention to this, you will avoid having the GL word drop in the wrong place.
• Sometimes, for the sake of clarity, the GL of the UST will repeat things that are only mentioned once in the original. This often happens with subjects or objects of sentences. For example, in Titus 2:9 the English UST refers to “their masters” twice, although the Greek only has *idiois despotais* once. In these cases, You should align each occurrence of the repeated reference with the same Greek words, so that the highlighting will show that each of these represents the meaning conveyed by those same words of the original.
• Some of the words and sentences of the UST do not directly represent the meaning of the original words. This is information that is only implied by the original words, but included in the UST because it is necessary for understanding the meaning of the original. For example, in Titus 1:1, the sentence, “I, Paul, write this letter to you, Titus” includes information that is not there in the original words, such as the fact that what the reader is about to read is a letter, and that it is written to someone named Titus. This information, however, makes the text more clear and understandable. For the aligning, then, all of this explanation must be aligned with the single word that it is explaining, Paulos.
• If you notice places where the UST is wrong or potentially wrong, create an issue for it at https://git.door43.org/Door43/en_udb/issues and well address it in the next release. In the meantime, align the text as well as possible.
• If you notice places where the UST is wrong or potentially wrong, create an issue for it at https://git.door43.org/Door43/en_ust/issues and well address it in the next release. In the meantime, align the text as well as possible.
Alignment Anomalies
^^^^^^^^^^^^^^^^^^^
In tC 0.8.0:
In tC 0.9.0:
""""""""""""
• Under certain circumstances both the GL and Greek words can get merged in the wrong order. Un-merge all of those words and re-merge them to correct the problem.
• Under certain circumstances words that get returned to the word list due to the un-merging of Greek words do not get placed in the project sequence in the word list.
• We are unsure about the accuracy of the tokenization of the Hindi ULT
• If a GL word is accidentally dropped while it is still in the word list frame, both it and the word list get hidden. Click in the word list area to make them visible again.
• When moving from verse to verse, the target area is not automatically scrolled to the top. There may be Greek words hidden behind the scripture pane. Manually scroll to the top when that situation occurs.