unfoldingWord® Translation Questions https://www.unfoldingword.org/utq/
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Larry Sallee 94cfe649f5 Merge pull request 'Corrected two notes in Song of Songs' (#143) from sng_bp into master 3 weeks ago
.github Small syntax fixes for v19 (#61) 2 years ago
.gitignore Add missing end breaks (#25) 3 years ago
LICENSE.md Version 30 (#108) 7 months ago
README.md Fixed punctuation in 1Co answer, and removed dead link from README (#96) 11 months ago
manifest.yaml
Valid
Version 37 2 months ago
media.yaml Version 30 (#108) 7 months ago
tq_1CH.tsv Version 27 converted from markdown (#92) 1 year ago
tq_1CO.tsv Edit 'tq_1CO.tsv' using 'tc-create-app' 3 months ago
tq_1JN.tsv Version 27 converted from markdown (#92) 1 year ago
tq_1KI.tsv Version 27 converted from markdown (#92) 1 year ago
tq_1PE.tsv removed non-break space in 1 Peter 3 months ago
tq_1SA.tsv Version 27 converted from markdown (#92) 1 year ago
tq_1TH.tsv Jane's edits to 1 Peter and 1Thessalonians (#113) 6 months ago
tq_1TI.tsv Edit 'tq_1TI.tsv' using 'tc-create-app' 1 month ago
tq_2CH.tsv Version 27 converted from markdown (#92) 1 year ago
tq_2CO.tsv Version 27 converted from markdown (#92) 1 year ago
tq_2JN.tsv Version 27 converted from markdown (#92) 1 year ago
tq_2KI.tsv Version 27 converted from markdown (#92) 1 year ago
tq_2PE.tsv Fixed minor format errors in 2 Peter (#98) 11 months ago
tq_2SA.tsv Version 27 converted from markdown (#92) 1 year ago
tq_2TH.tsv Jane's proofreading edits to NT books (#120) 6 months ago
tq_2TI.tsv Version 27 converted from markdown (#92) 1 year ago
tq_3JN.tsv Version 27 converted from markdown (#92) 1 year ago
tq_ACT.tsv Jane's proofreading edits to NT books (#120) 6 months ago
tq_AMO.tsv Version 27 converted from markdown (#92) 1 year ago
tq_COL.tsv Corrected Colossians 1:21 answer (#112) 6 months ago
tq_DAN.tsv Version 27 converted from markdown (#92) 1 year ago
tq_DEU.tsv Edit 'tq_DEU.tsv' using 'tc-create-app' 1 month ago
tq_ECC.tsv Version 27 converted from markdown (#92) 1 year ago
tq_EPH.tsv Version 27 converted from markdown (#92) 1 year ago
tq_EST.tsv Version 27 converted from markdown (#92) 1 year ago
tq_EXO.tsv Corrected questions numbering in Exodus 3 months ago
tq_EZK.tsv Version 27 converted from markdown (#92) 1 year ago
tq_EZR.tsv Version 27 converted from markdown (#92) 1 year ago
tq_GAL.tsv Jane's proofreading edits to NT books (#120) 6 months ago
tq_GEN.tsv Version 27 converted from markdown (#92) 1 year ago
tq_HAB.tsv Version 27 converted from markdown (#92) 1 year ago
tq_HAG.tsv Version 27 converted from markdown (#92) 1 year ago
tq_HEB.tsv Edit 'tq_HEB.tsv' using 'tc-create-app' 2 months ago
tq_HOS.tsv Version 27 converted from markdown (#92) 1 year ago
tq_ISA.tsv Version 27 converted from markdown (#92) 1 year ago
tq_JAS.tsv Version 27 converted from markdown (#92) 1 year ago
tq_JDG.tsv Version 27 converted from markdown (#92) 1 year ago
tq_JER.tsv Version 27 converted from markdown (#92) 1 year ago
tq_JHN.tsv Fixed verse range in John 18 2 months ago
tq_JOB.tsv Version 27 converted from markdown (#92) 1 year ago
tq_JOL.tsv Version 27 converted from markdown (#92) 1 year ago
tq_JON.tsv Version 27 converted from markdown (#92) 1 year ago
tq_JOS.tsv Version 27 converted from markdown (#92) 1 year ago
tq_JUD.tsv Corrected proofread errors in 2 Peter and Jude (#97) 11 months ago
tq_LAM.tsv Version 27 converted from markdown (#92) 1 year ago
tq_LEV.tsv Version 27 converted from markdown (#92) 1 year ago
tq_LUK.tsv Corrected straight punctuation marks in Luke (#94) 1 year ago
tq_MAL.tsv Version 27 converted from markdown (#92) 1 year ago
tq_MAT.tsv Edit 'tq_MAT.tsv' using 'tc-create-app' 1 month ago
tq_MIC.tsv Version 27 converted from markdown (#92) 1 year ago
tq_MRK.tsv Jane's proofreading edits to NT books (#120) 6 months ago
tq_NAM.tsv Version 27 converted from markdown (#92) 1 year ago
tq_NEH.tsv Version 27 converted from markdown (#92) 1 year ago
tq_NUM.tsv Version 27 converted from markdown (#92) 1 year ago
tq_OBA.tsv Version 27 converted from markdown (#92) 1 year ago
tq_PHM.tsv Fixed two typos in Philemon (#102) 10 months ago
tq_PHP.tsv Minor proofreading edits to Philippians (#106) 7 months ago
tq_PRO.tsv Version 27 converted from markdown (#92) 1 year ago
tq_PSA.tsv Version 27 converted from markdown (#92) 1 year ago
tq_REV.tsv Edit 'tq_REV.tsv' using 'tc-create-app' 4 months ago
tq_ROM.tsv Removed duplicate questions from Romans (#95) 1 year ago
tq_RUT.tsv Version 27 converted from markdown (#92) 1 year ago
tq_SNG.tsv Corrected two notes in Song of Songs 3 weeks ago
tq_TIT.tsv Version 27 converted from markdown (#92) 1 year ago
tq_ZEC.tsv Version 27 converted from markdown (#92) 1 year ago
tq_ZEP.tsv Version 27 converted from markdown (#92) 1 year ago

README.md

UTQ Logo

unfoldingWord® Translation Questions

This is the repository for the unfoldingWord® Translation Questions (UTQ) resource.

Description

unfoldingWord® Translation Questions are comprehension and theological questions for each chapter of the Bible. It enables translators and translation checkers to confirm that the intended meaning of their translations is clearly communicated to the speakers of that language.

Downloading

If you want to download the UTQ to use, go here: https://www.unfoldingword.org/utq/. The UTQ are included in tS and will soon be in tC.

Improving the tQs

Please use the issue queue to provide feedback or suggestions for improvement.

If you want to make your suggested changes then you may use the online editor to do so. See the protected branch workflow document for step by step instructions.

Editing the UTQ

To edit the UTQ 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 LibreOffice

This is the recommended way to edit the TSV files. You may download LibreOffice for free.

After you have the file on your computer, you may open the respective TSV file with LibreOffice. Follow these notes on the Text Import Screen:

  • Set “Separated by” to “Tab”
  • Set “Text Delimiter” to blank, you will need to highlight the character and use backspace or delete to remove it

When you are done editing, click Save and then select “Use Text CSV Format” on the pop up dialogue. Note that even though it says CSV, it will use tab characters as the field separators.

Note: Other spreadsheet editors should not be used because they will add or remove quotation marks which will affect the notes negatively.

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.

Structure

The UTQ are structured as TSV files to simplify importing and exporting into various formats for translation and presentation.

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 UTQ are structured as one file per book of the bible and encoded in TSV format, for example, tq_GEN.tsv. The columns are Reference, ID, Tags, Quote, Occurrence, Question, and Response.

UTQ TSV Column Description

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

  • Reference: Chapter number (e.g. 1) then colon then verse number (e.g. 3) or intro
  • 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 tQs 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/tq/help/tit/01/01/swi9.
  • Tags: not currently used for Translation Questions
  • Quote: currently only used for OBS Translation Questions
  • Occurrence: Specifies which occurrence in the original language text the entry applies to.
    • -1: entry applies to every occurrence of Quote in the verse
    • 0: entry does not occur in original language (for example, “Connecting Statement:”)
    • 1: entry applies to first occurrence of Quote only
    • 2: entry applies to second occurrence of Quote only
    • etc.
  • Question: The character Markdown formatted question.
  • Response: Optional character Markdown formatted response.
    • The Question and Response text should only be characters 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
      • No paragraph Markdown formats

GL Translators

UTQ Translation Philosophy

To learn the philosophy of how to translate the UTQs please see the Translate the unfoldingWord® Translation Questions article in the Gateway Language Manual.

If you are translating online, please fork the Door43-Catalog/en_tq repository, following this workflow: Translate Content Online.

License

See the LICENSE file for licensing information.