Go to file
Larry Sallee a4c4d12964 Merge pull request 'Minor wording changes in 1Co and 2Th notes' (#3057) from nt_tn_tweak into master
Reviewed-on: https://git.door43.org/unfoldingWord/en_tn/pulls/3057
2022-12-19 14:34:50 +00:00
.github Fix syntax issues ready for v38 (#1591) 2020-12-17 01:37:16 +00:00
LICENSE.md Version 58 (#2340) 2022-03-19 17:54:50 +00:00
README.md Fix dashes (#2055) 2021-09-01 00:22:00 +00:00
manifest.yaml Updated to use new tN filenames 2022-12-16 21:29:39 +00:00
media.yaml Version 58 (#2340) 2022-03-19 17:54:50 +00:00
tn_1CH.tsv Converted from en_tn_13-1CH.tsv to tn_1CH.tsv 2022-12-16 21:27:13 +00:00
tn_1CO.tsv Minor wording changes in 1Co and 2Th notes 2022-12-19 09:34:15 -05:00
tn_1JN.tsv Converted from en_tn_63-1JN.tsv to tn_1JN.tsv 2022-12-16 21:29:26 +00:00
tn_1KI.tsv Converted from en_tn_11-1KI.tsv to tn_1KI.tsv 2022-12-16 21:27:08 +00:00
tn_1PE.tsv Converted from en_tn_61-1PE.tsv to tn_1PE.tsv 2022-12-16 21:29:21 +00:00
tn_1SA.tsv Converted from en_tn_09-1SA.tsv to tn_1SA.tsv 2022-12-16 21:27:03 +00:00
tn_1TH.tsv Converted from en_tn_53-1TH.tsv to tn_1TH.tsv 2022-12-16 21:29:00 +00:00
tn_1TI.tsv Converted from en_tn_55-1TI.tsv to tn_1TI.tsv 2022-12-16 21:29:05 +00:00
tn_2CH.tsv Converted from en_tn_14-2CH.tsv to tn_2CH.tsv 2022-12-16 21:27:15 +00:00
tn_2CO.tsv Converted from en_tn_48-2CO.tsv to tn_2CO.tsv 2022-12-16 21:28:49 +00:00
tn_2JN.tsv Converted from en_tn_64-2JN.tsv to tn_2JN.tsv 2022-12-16 21:29:29 +00:00
tn_2KI.tsv Converted from en_tn_12-2KI.tsv to tn_2KI.tsv 2022-12-16 21:27:10 +00:00
tn_2PE.tsv Converted from en_tn_62-2PE.tsv to tn_2PE.tsv 2022-12-16 21:29:23 +00:00
tn_2SA.tsv Converted from en_tn_10-2SA.tsv to tn_2SA.tsv 2022-12-16 21:27:06 +00:00
tn_2TH.tsv Minor wording changes in 1Co and 2Th notes 2022-12-19 09:34:15 -05:00
tn_2TI.tsv Converted from en_tn_56-2TI.tsv to tn_2TI.tsv 2022-12-16 21:29:07 +00:00
tn_3JN.tsv Converted from en_tn_65-3JN.tsv to tn_3JN.tsv 2022-12-16 21:29:32 +00:00
tn_ACT.tsv Converted from en_tn_45-ACT.tsv to tn_ACT.tsv 2022-12-16 21:28:36 +00:00
tn_AMO.tsv Converted from en_tn_30-AMO.tsv to tn_AMO.tsv 2022-12-16 21:27:57 +00:00
tn_COL.tsv Converted from en_tn_52-COL.tsv to tn_COL.tsv 2022-12-16 21:28:58 +00:00
tn_DAN.tsv Converted from en_tn_27-DAN.tsv to tn_DAN.tsv 2022-12-16 21:27:50 +00:00
tn_DEU.tsv Converted from en_tn_05-DEU.tsv to tn_DEU.tsv 2022-12-16 21:26:54 +00:00
tn_ECC.tsv Converted from en_tn_21-ECC.tsv to tn_ECC.tsv 2022-12-16 21:27:34 +00:00
tn_EPH.tsv Converted from en_tn_50-EPH.tsv to tn_EPH.tsv 2022-12-16 21:28:54 +00:00
tn_EST.tsv Converted from en_tn_17-EST.tsv to tn_EST.tsv 2022-12-16 21:27:22 +00:00
tn_EXO.tsv Converted from en_tn_02-EXO.tsv to tn_EXO.tsv 2022-12-16 21:26:47 +00:00
tn_EZK.tsv Converted from en_tn_26-EZK.tsv to tn_EZK.tsv 2022-12-16 21:27:48 +00:00
tn_EZR.tsv Converted from en_tn_15-EZR.tsv to tn_EZR.tsv 2022-12-16 21:27:18 +00:00
tn_GAL.tsv Converted from en_tn_49-GAL.tsv to tn_GAL.tsv 2022-12-16 21:28:51 +00:00
tn_GEN.tsv Converted from en_tn_01-GEN.tsv to tn_GEN.tsv 2022-12-16 21:26:45 +00:00
tn_HAB.tsv Converted from en_tn_35-HAB.tsv to tn_HAB.tsv 2022-12-16 21:28:09 +00:00
tn_HAG.tsv Converted from en_tn_37-HAG.tsv to tn_HAG.tsv 2022-12-16 21:28:13 +00:00
tn_HEB.tsv Converted from en_tn_59-HEB.tsv to tn_HEB.tsv 2022-12-16 21:29:16 +00:00
tn_HOS.tsv Converted from en_tn_28-HOS.tsv to tn_HOS.tsv 2022-12-16 21:27:52 +00:00
tn_ISA.tsv Converted from en_tn_23-ISA.tsv to tn_ISA.tsv 2022-12-16 21:27:40 +00:00
tn_JAS.tsv Converted from en_tn_60-JAS.tsv to tn_JAS.tsv 2022-12-16 21:29:19 +00:00
tn_JDG.tsv Converted from en_tn_07-JDG.tsv to tn_JDG.tsv 2022-12-16 21:26:58 +00:00
tn_JER.tsv Converted from en_tn_24-JER.tsv to tn_JER.tsv 2022-12-16 21:27:42 +00:00
tn_JHN.tsv Converted from en_tn_44-JHN.tsv to tn_JHN.tsv 2022-12-16 21:28:31 +00:00
tn_JOB.tsv Converted from en_tn_18-JOB.tsv to tn_JOB.tsv 2022-12-16 21:27:25 +00:00
tn_JOL.tsv Converted from en_tn_29-JOL.tsv to tn_JOL.tsv 2022-12-16 21:27:55 +00:00
tn_JON.tsv Converted from en_tn_32-JON.tsv to tn_JON.tsv 2022-12-16 21:28:02 +00:00
tn_JOS.tsv Converted from en_tn_06-JOS.tsv to tn_JOS.tsv 2022-12-16 21:26:56 +00:00
tn_JUD.tsv Converted from en_tn_66-JUD.tsv to tn_JUD.tsv 2022-12-16 21:29:34 +00:00
tn_LAM.tsv Converted from en_tn_25-LAM.tsv to tn_LAM.tsv 2022-12-16 21:27:45 +00:00
tn_LEV.tsv Converted from en_tn_03-LEV.tsv to tn_LEV.tsv 2022-12-16 21:26:49 +00:00
tn_LUK.tsv Converted from en_tn_43-LUK.tsv to tn_LUK.tsv 2022-12-16 21:28:26 +00:00
tn_MAL.tsv Converted from en_tn_39-MAL.tsv to tn_MAL.tsv 2022-12-16 21:28:18 +00:00
tn_MAT.tsv Converted from en_tn_41-MAT.tsv to tn_MAT.tsv 2022-12-16 21:28:20 +00:00
tn_MIC.tsv Converted from en_tn_33-MIC.tsv to tn_MIC.tsv 2022-12-16 21:28:04 +00:00
tn_MRK.tsv Converted from en_tn_42-MRK.tsv to tn_MRK.tsv 2022-12-16 21:28:23 +00:00
tn_NAM.tsv Converted from en_tn_34-NAM.tsv to tn_NAM.tsv 2022-12-16 21:28:06 +00:00
tn_NEH.tsv Converted from en_tn_16-NEH.tsv to tn_NEH.tsv 2022-12-16 21:27:20 +00:00
tn_NUM.tsv Converted from en_tn_04-NUM.tsv to tn_NUM.tsv 2022-12-16 21:26:52 +00:00
tn_OBA.tsv Converted from en_tn_31-OBA.tsv to tn_OBA.tsv 2022-12-16 21:27:59 +00:00
tn_PHM.tsv Converted from en_tn_58-PHM.tsv to tn_PHM.tsv 2022-12-16 21:29:12 +00:00
tn_PHP.tsv Converted from en_tn_51-PHP.tsv to tn_PHP.tsv 2022-12-16 21:28:56 +00:00
tn_PRO.tsv Converted from en_tn_20-PRO.tsv to tn_PRO.tsv 2022-12-16 21:27:31 +00:00
tn_PSA.tsv Converted from en_tn_19-PSA.tsv to tn_PSA.tsv 2022-12-16 21:27:27 +00:00
tn_REV.tsv Converted from en_tn_67-REV.tsv to tn_REV.tsv 2022-12-16 21:29:36 +00:00
tn_ROM.tsv Converted from en_tn_46-ROM.tsv to tn_ROM.tsv 2022-12-16 21:28:40 +00:00
tn_RUT.tsv Converted from en_tn_08-RUT.tsv to tn_RUT.tsv 2022-12-16 21:27:01 +00:00
tn_SNG.tsv Converted from en_tn_22-SNG.tsv to tn_SNG.tsv 2022-12-16 21:27:37 +00:00
tn_TIT.tsv Converted from en_tn_57-TIT.tsv to tn_TIT.tsv 2022-12-16 21:29:09 +00:00
tn_ZEC.tsv Converted from en_tn_38-ZEC.tsv to tn_ZEC.tsv 2022-12-16 21:28:15 +00:00
tn_ZEP.tsv Converted from en_tn_36-ZEP.tsv to tn_ZEP.tsv 2022-12-16 21:28:11 +00:00

README.md

drawing

unfoldingWord® Translation Notes

This is the repository for the unfoldingWord® Translation Notes (UTN) resource.

Description

unfoldingWord® Translation Notes are open-licensed exegetical notes that provide historical, cultural, and linguistic information for translators. It provides translators and checkers with pertinent, just-in-time information to help them make the best possible translation decisions.

Downloading

If you want to download the UTN to use, go here: https://www.unfoldingword.org/utn. UTN is also included in tS and tC.

Editing the UTN

To edit the UTN files there are three options:

  • Use LibreOffice (Recommended)
  • Use a text editor on your computer
  • Use the online web editor in DCS

Each of these options and their caveats are described below.

The first two options require you to clone the repository to your computer first. You may do this on the command line or using a program such as SmartGit. After making changes to the files you will need to commit and push your changes to the server and then create a Pull Request to merge them to the master branch.

Alternately, you may download the master branch as a zip file and extract that locally. After editing you would need to use the upload file feature in DCS to get your changes ready for a Pull Request.

Editing in tC Create

This is the recommended way to edit the TSV files. tC Create is a web-based application that you can access here. NOTE: you need to have a Door43 account in order to use tC Create.

Once you log in, simply follow the prompts to open the file you wish to edit.

When you are done editing, click Save button at the top right corner of the screen.

Editing in a Text Editor

You may also use a regular text editor to make changes to the files.

Note: You must be careful not to delete or add any tab characters when editing with this method.

Editing in DCS

If you only need to change a word or two, this may be the quickest way to make your change. See the protected branch workflow document for step by step instructions.

Note: You must be careful not to delete any tab characters when editing with this method. Also, you CANNOT manually input the tab characters using the tab bar on your keyboard, because DCS will save them as spaces and not as tab separators. The best way to insert tab separators is by copying and pasting tab characters from an existing tNote.

Structure

The UTN are structured as TSV files to simplify importing and exporting into various formats for translation and presentation. This enables the tNs to be keyed to the original Greek and Hebrew text instead of only a Gateway Language translation.

TSV Format Overview

A Tab Separated Value (TSV) file is like a Comma Separated Value file except that the tab character is what divides the values instead of a comma. This makes it easier to include prose text in the files because many languages require the use of commas, single quotes, and double quotes in their sentences and paragraphs.

The UTN are structured as one file per book of the bible and encoded in TSV format, for example, 01-GEN.tsv. The columns are Book, Chapter, Verse, ID, SupportReference, OrigQuote, Occurrence, GLQuote, and OccurrenceNote.

UTN TSV Column Description

The following lists each column with a brief description and example.

  • Book: USFM book code name (e.g. TIT)
  • Chapter: Chapter number (e.g. 1)
  • Verse: Verse number (e.g. 3)
  • ID: Four character alphanumeric string unique within the verse for the resource (e.g. swi9)
    • This will be helpful in identifing which notes are translations of the original English tNs and which notes have been added by GLs.
    • The Universal ID (UID) of a note is the combination of the Book, Chapter, Verse, and ID fields. For example, tit/1/3/swi9.
      • This is a useful way to unambiguously refer to notes.
      • An RC link can resolve to a specific note like this: rc://en/tn/help/tit/01/01/swi9.
  • SupportReference
    • Normally a link to a supporting reference text or blank
    • This will usually be a link to translationAcademy, like rc://*/ta/man/translate/figs-metaphor
  • OrigQuote: Original language quote (e.g. ἐφανέρωσεν…τὸν λόγον αὐτοῦ)
    • Software (such as tC) should use this for determining what is highlighted rather than using the GLQuote field
    • An ellipsis character (…) indicates that the quote is discontinuous, software should interpret this in a non-greedy manner
  • Occurrence: Specifies which occurrence in the original language text the entry applies to.
    • -1: entry applies to every occurrence of OrigQuote in the verse
    • 0: entry does not occur in original language (for example, “Connecting Statement:”)
    • 1: entry applies to first occurrence of OrigQuote only
    • 2: entry applies to second occurrence of OrigQuote only
    • etc.
  • GLQuote: (optional) Gateway language quote (e.g. he revealed his word)
    • Software (such as tC) should disregard this field.
    • This field is a reference text for GL translators
    • For certain notes, this field represents the display text for notes that do not relate to a specific word or phrase in the text. There are two such cases in the tN:
      • “Connecting Statement:” and
      • “General Information:”
    • GL translations teams should not translate this column. They do need to provide a translation of the above 2 statements.
  • OccurrenceNote: The Markdown formatted note itself. For example, Paul speaks of Gods message as if it were an object that could be visibly shown to people. Alternate translation: “He caused me to understand his message” (See: [[rc://en/ta/man/translate/figs-metaphor]])
    • The text should be Markdown formatted, which means the following are also acceptable:
      • Plaintext—if you have no need for extra markup, just use plain text in this column
      • HTML—if you prefer to use inline HTML for markup, that works because it is supported in Markdown

Composing translationNotes

Below are a few formatting guidelines that govern the composition of transationNotes.

  • All tNotes should reference ONLY a single translationAcademy article. If a second article needs to be referenced, an additional tNote should be added.
  • All tNotes should reference one of the “Just-in-Time” articles from translationAcademy, i.e., those with file names beginning with “figs-” or “grammar-” “translate-” or “writing-.”
  • The ULT term/concept being discussed in each Note should be in bold type, NOT in “quotation marks.”
  • Only use quotation marks to indicate suggested translations. Do not precede the suggestion with the word “that” (which turns them into indirect quotes) i.e., You could say that “they were planning to assassinate him.” Corrected to: You could say, “they were planning to assassinate him.”
  • It is not enough to enclose “for example” in commas mid sentence and follow it with an example, i.e., You can say this with an active form, for example, “Mordecai found out what they were planning.” Corrected to: You can say this with an active form such as “Mordecai found out what they were planning.” Another example might include: You can say this with an active form, and you can say who did the action. For example, you can say, “Then the kings servants investigated Mordecais report and found out that it was true.”
  • When beginning a tNotes with the word “Here,” the term should be followed by a comma. For instance: “Here, the ULT term means …”
  • Do NOT include a period at the end of the “Alternate translation:” fragment at the end of a tNote. The “Alternate translation” should be formatted as a floating sentence fragment immediately followed by the translationAcademy hyperlink (if applicable), i.e., Alternation translation: “in the presence of Yahweh” (See: Metaphor)
  • When composing tNotes using tC Create, all hyperlinks should be typed in “Markdown” mode instead of “Preview” mode. Hyperlinks entered in Preview mode will not be saved in their proper format.
  • Scripture references within the same book should be referenced using both chapter and verse, separate by a colon, i.e. 3:16. To use this same example, the proper hyperlink format places the hyperlink text in brackets [3:16] immediately followed by the link itself in parentheses (../03/16.md). There should not be a space between the brackets and the parentheses.
  • The file name in the SupportReference field MUST be an exact match for the hyperlink at the close of the tNote. If they do not match, the link will not work properly.

GL Translators

tN Translation Philosophy

To learn the philosophy of how to translate these notes please see the Translate the translationNotes article in the Gateway Language Manual.

tN Translation Notes

Here are some important technical notes to keep in mind as you translate tN:

  • Only the OccurrenceNote column needs to be translated
  • Do not remove any column in the TSV files
  • You will also need to supply a translation of these 2 phrases which are repeated, “Connecting Statement:” and “General Information:”.
    • These phrases occur many times in the GLQuote column.
    • You may want to use find and replace to update the English text with your GL text. If not, we can do this when preparing the text for publishing.
  • Remember: the GLQuote column is not required to be filled out. Only use this field if it is helpful during the translation process. The software that processes the tNs will use alignment data to identify which words in your GL translation the individual notes refer to.

The section above on Editing the tNs may give you ideas on what software to use. Of course, you can also convert the TSV files into another format, do the translation, and then convert them back to TSV files (just ensure the IDs are preserved if you do this). Follow Translate Content Online to get a copy of this repository to begin your work.

Add Notes

As a translator of UTN into a GL, you may need to add new notes. Follow these steps to do this:

  1. Add a new row in the correct book, chapter, verse order.

  2. Fill out each field for the row according to the UTN TSV Column Description above, taking note of these instructions:

    • Choose a new ID for this note, which must unique among the notes in the verse.
    • If you dont know Greek, put the GL text that the note refers to in the GLQuote field. Have a reviewer who knows Greek and your GL come back and add the approprate text from the UGNT that the note refers to.

License

See the LICENSE file for licensing information.