publishing_prep (#1214)

This commit is contained in:
Jesse Griffin 2019-05-21 19:42:40 +00:00 committed by Gogs
parent 36b0e7fb33
commit 1d1940dc3c
3 changed files with 88 additions and 87 deletions

View File

@ -1,11 +1,11 @@
*unfoldingWord® translationNotes*
*unfoldingWord® Translation Notes*
*Copyright © 2019 by unfoldingWord*
This work is made available under the Creative Commons Attribution-ShareAlike 4.0 International License (CC BY-SA). To view a copy of this license, visit [http://creativecommons.org/licenses/by-sa/4.0/](http://creativecommons.org/licenses/by-sa/4.0/) or send a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.
This work is made available under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit [http://creativecommons.org/licenses/by-sa/4.0/](http://creativecommons.org/licenses/by-sa/4.0/) or send a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.
unfoldingWord® is a registered trademark of unfoldingWord. Use of the unfoldingWord name or logo requires the written permission of unfoldingWord. Under the terms of the CC BY-SA license, you may copy and redistribute this unmodified work as long as you keep the unfoldingWord® trademark intact. If you modify a copy or translate this work, thereby creating a derivative work, you must remove the unfoldingWord® trademark.
On the derivative work, you must indicate what changes you have made and attribute the work as follows: “The original work by unfoldingWord is available from [https://unfoldingword.bible/tn/](https://unfoldingword.bible/tn/)”. You must also make your derivative work available under the same license (CC BY-SA).
On the derivative work, you must indicate what changes you have made and attribute the work as follows: “The original work by unfoldingWord is available from [unfoldingword.org/utn](https://www.unfoldingword.org/utn)”. You must also make your derivative work available under the same license (CC BY-SA).
If you would like to notify unfoldingWord regarding your translation of this work, please contact us at [https://unfoldingword.bible/contact/](https://unfoldingword.bible/contact/).
If you would like to notify unfoldingWord regarding your translation of this work, please contact us at [unfoldingword.org/contact/](https://www.unfoldingword.org/contact/).

View File

@ -1,14 +1,15 @@
# unfoldingWord® translationNotes
<img src="https://cdn.door43.org/assets/uw-icons/logo-utn-256.png" alt="drawing" width="100"/>
# unfoldingWord® Translation Notes
This is the repository for the unfoldingWord® translationNotes (tN) resource.
This is the repository for the unfoldingWord® Translation Notes (UTN) resource.
## Description
unfoldingWord® tN 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.
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.
## Editing the tNs
## Editing the UTN
To edit the tN files there are three options:
To edit the UTN files there are three options:
* Use LibreOffice (Recommended)
* Use a text editor on your computer
@ -52,15 +53,15 @@ If you only need to change a word or two, this may be the quickest way to make y
## Structure
The tN 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.
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 tNs 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`.
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`.
### tN TSV Column Description
### UTN TSV Column Description
The following lists each column with a brief description and example.
@ -113,14 +114,14 @@ Here are some important technical *notes* to keep in mind as you translate tN:
* 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](https://git.door43.org/unfoldingWord/en_tn#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](https://help.door43.org/en/knowledgebase/15-door43-content-service/docs/41-translate-content-online) to get a copy of this repository to begin your work.
The section above on [Editing the tNs](https://git.door43.org/unfoldingWord/en_tn#editing-the-utn) 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](https://help.door43.org/en/knowledgebase/15-door43-content-service/docs/41-translate-content-online) to get a copy of this repository to begin your work.
### Add Notes
As a translator of tN into a GL, you may need to [add new notes](http://gl-manual.readthedocs.io/en/latest/gl_translation.html#may-i-add-a-note-that-would-help-with-translation-in-my-language). Follow these steps to do this:
As a translator of UTN into a GL, you may need to [add new notes](http://gl-manual.readthedocs.io/en/latest/gl_translation.html#may-i-add-a-note-that-would-help-with-translation-in-my-language). 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 [tN TSV Column Description](https://git.door43.org/unfoldingWord/en_tn#tn-tsv-column-description) above, taking note of these instructions:
2. Fill out each field for the row according to the [UTN TSV Column Description](https://git.door43.org/unfoldingWord/en_tn#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 don't 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.

View File

@ -368,12 +368,12 @@ dublin_core:
description: '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.'
format: 'text/tsv'
identifier: 'tn'
issued: '2019-02-08'
issued: '2019-05-21'
language:
direction: 'ltr'
identifier: 'en'
title: 'English'
modified: '2018-02-08'
modified: '2019-05-21'
publisher: 'unfoldingWord'
relation:
- 'en/ult'
@ -382,11 +382,11 @@ dublin_core:
source:
- identifier: 'tn'
language: 'en'
version: '14'
version: '15'
subject: 'TSV Translation Notes'
title: 'translationNotes'
title: 'unfoldingWord® Translation Notes'
type: 'help'
version: '14'
version: '15'
checking:
checking_entity:
@ -395,7 +395,7 @@ checking:
projects:
-
title: 'Genesis translationNotes'
title: 'Genesis unfoldingWord® Translation Notes'
versification: ''
identifier: 'gen'
sort: 1
@ -403,7 +403,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Exodus translationNotes'
title: 'Exodus unfoldingWord® Translation Notes'
versification: ''
identifier: 'exo'
sort: 2
@ -411,7 +411,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Leviticus translationNotes'
title: 'Leviticus unfoldingWord® Translation Notes'
versification: ''
identifier: 'lev'
sort: 3
@ -419,7 +419,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Numbers translationNotes'
title: 'Numbers unfoldingWord® Translation Notes'
versification: ''
identifier: 'num'
sort: 4
@ -427,7 +427,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Deuteronomy translationNotes'
title: 'Deuteronomy unfoldingWord® Translation Notes'
versification: ''
identifier: 'deu'
sort: 5
@ -435,7 +435,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Joshua translationNotes'
title: 'Joshua unfoldingWord® Translation Notes'
versification: ''
identifier: 'jos'
sort: 6
@ -443,7 +443,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Judges translationNotes'
title: 'Judges unfoldingWord® Translation Notes'
versification: ''
identifier: 'jdg'
sort: 7
@ -451,7 +451,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Ruth translationNotes'
title: 'Ruth unfoldingWord® Translation Notes'
versification: ''
identifier: 'rut'
sort: 8
@ -459,7 +459,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: '1 Samuel translationNotes'
title: '1 Samuel unfoldingWord® Translation Notes'
versification: ''
identifier: '1sa'
sort: 9
@ -467,7 +467,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: '2 Samuel translationNotes'
title: '2 Samuel unfoldingWord® Translation Notes'
versification: ''
identifier: '2sa'
sort: 10
@ -475,7 +475,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: '1 Kings translationNotes'
title: '1 Kings unfoldingWord® Translation Notes'
versification: ''
identifier: '1ki'
sort: 11
@ -483,7 +483,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: '2 Kings translationNotes'
title: '2 Kings unfoldingWord® Translation Notes'
versification: ''
identifier: '2ki'
sort: 12
@ -491,7 +491,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: '1 Chronicles translationNotes'
title: '1 Chronicles unfoldingWord® Translation Notes'
versification: ''
identifier: '1ch'
sort: 13
@ -499,7 +499,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: '2 Chronicles translationNotes'
title: '2 Chronicles unfoldingWord® Translation Notes'
versification: ''
identifier: '2ch'
sort: 14
@ -507,7 +507,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Ezra translationNotes'
title: 'Ezra unfoldingWord® Translation Notes'
versification: ''
identifier: 'ezr'
sort: 15
@ -515,7 +515,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Nehemiah translationNotes'
title: 'Nehemiah unfoldingWord® Translation Notes'
versification: ''
identifier: 'neh'
sort: 16
@ -523,7 +523,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Esther translationNotes'
title: 'Esther unfoldingWord® Translation Notes'
versification: ''
identifier: 'est'
sort: 17
@ -531,7 +531,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Job translationNotes'
title: 'Job unfoldingWord® Translation Notes'
versification: ''
identifier: 'job'
sort: 18
@ -539,7 +539,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Psalms translationNotes'
title: 'Psalms unfoldingWord® Translation Notes'
versification: ''
identifier: 'psa'
sort: 19
@ -547,7 +547,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Proverbs translationNotes'
title: 'Proverbs unfoldingWord® Translation Notes'
versification: ''
identifier: 'pro'
sort: 20
@ -555,7 +555,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Ecclesiastes translationNotes'
title: 'Ecclesiastes unfoldingWord® Translation Notes'
versification: ''
identifier: 'ecc'
sort: 21
@ -563,7 +563,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Song of Solomon translationNotes'
title: 'Song of Solomon unfoldingWord® Translation Notes'
versification: ''
identifier: 'sng'
sort: 22
@ -571,7 +571,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Isaiah translationNotes'
title: 'Isaiah unfoldingWord® Translation Notes'
versification: ''
identifier: 'isa'
sort: 23
@ -579,7 +579,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Jeremiah translationNotes'
title: 'Jeremiah unfoldingWord® Translation Notes'
versification: ''
identifier: 'jer'
sort: 24
@ -587,7 +587,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Lamentations translationNotes'
title: 'Lamentations unfoldingWord® Translation Notes'
versification: ''
identifier: 'lam'
sort: 25
@ -595,7 +595,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Ezekiel translationNotes'
title: 'Ezekiel unfoldingWord® Translation Notes'
versification: ''
identifier: 'ezk'
sort: 26
@ -603,7 +603,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Daniel translationNotes'
title: 'Daniel unfoldingWord® Translation Notes'
versification: ''
identifier: 'dan'
sort: 27
@ -611,7 +611,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Hosea translationNotes'
title: 'Hosea unfoldingWord® Translation Notes'
versification: ''
identifier: 'hos'
sort: 28
@ -619,7 +619,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Joel translationNotes'
title: 'Joel unfoldingWord® Translation Notes'
versification: ''
identifier: 'jol'
sort: 29
@ -627,7 +627,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Amos translationNotes'
title: 'Amos unfoldingWord® Translation Notes'
versification: ''
identifier: 'amo'
sort: 30
@ -635,7 +635,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Obadiah translationNotes'
title: 'Obadiah unfoldingWord® Translation Notes'
versification: ''
identifier: 'oba'
sort: 31
@ -643,7 +643,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Jonah translationNotes'
title: 'Jonah unfoldingWord® Translation Notes'
versification: ''
identifier: 'jon'
sort: 32
@ -651,7 +651,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Micah translationNotes'
title: 'Micah unfoldingWord® Translation Notes'
versification: ''
identifier: 'mic'
sort: 33
@ -659,7 +659,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Nahum translationNotes'
title: 'Nahum unfoldingWord® Translation Notes'
versification: ''
identifier: 'nam'
sort: 34
@ -667,7 +667,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Habakkuk translationNotes'
title: 'Habakkuk unfoldingWord® Translation Notes'
versification: ''
identifier: 'hab'
sort: 35
@ -675,7 +675,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Zephaniah translationNotes'
title: 'Zephaniah unfoldingWord® Translation Notes'
versification: ''
identifier: 'zep'
sort: 36
@ -683,7 +683,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Haggai translationNotes'
title: 'Haggai unfoldingWord® Translation Notes'
versification: ''
identifier: 'hag'
sort: 37
@ -691,7 +691,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Zechariah translationNotes'
title: 'Zechariah unfoldingWord® Translation Notes'
versification: ''
identifier: 'zec'
sort: 38
@ -699,7 +699,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Malachi translationNotes'
title: 'Malachi unfoldingWord® Translation Notes'
versification: ''
identifier: 'mal'
sort: 39
@ -707,7 +707,7 @@ projects:
categories: [ 'bible-ot' ]
-
title: 'Matthew translationNotes'
title: 'Matthew unfoldingWord® Translation Notes'
versification: ''
identifier: 'mat'
sort: 40
@ -715,7 +715,7 @@ projects:
categories: [ 'bible-nt' ]
-
title: 'Mark translationNotes'
title: 'Mark unfoldingWord® Translation Notes'
versification: ''
identifier: 'mrk'
sort: 41
@ -723,7 +723,7 @@ projects:
categories: [ 'bible-nt' ]
-
title: 'Luke translationNotes'
title: 'Luke unfoldingWord® Translation Notes'
versification: ''
identifier: 'luk'
sort: 42
@ -731,7 +731,7 @@ projects:
categories: [ 'bible-nt' ]
-
title: 'John translationNotes'
title: 'John unfoldingWord® Translation Notes'
versification: ''
identifier: 'jhn'
sort: 43
@ -739,7 +739,7 @@ projects:
categories: [ 'bible-nt' ]
-
title: 'Acts translationNotes'
title: 'Acts unfoldingWord® Translation Notes'
versification: ''
identifier: 'act'
sort: 44
@ -747,7 +747,7 @@ projects:
categories: [ 'bible-nt' ]
-
title: 'Romans translationNotes'
title: 'Romans unfoldingWord® Translation Notes'
versification: ''
identifier: 'rom'
sort: 45
@ -755,7 +755,7 @@ projects:
categories: [ 'bible-nt' ]
-
title: '1 Corinthians translationNotes'
title: '1 Corinthians unfoldingWord® Translation Notes'
versification: ''
identifier: '1co'
sort: 46
@ -763,7 +763,7 @@ projects:
categories: [ 'bible-nt' ]
-
title: '2 Corinthians translationNotes'
title: '2 Corinthians unfoldingWord® Translation Notes'
versification: ''
identifier: '2co'
sort: 47
@ -771,7 +771,7 @@ projects:
categories: [ 'bible-nt' ]
-
title: 'Galatians translationNotes'
title: 'Galatians unfoldingWord® Translation Notes'
versification: ''
identifier: 'gal'
sort: 48
@ -779,7 +779,7 @@ projects:
categories: [ 'bible-nt' ]
-
title: 'Ephesians translationNotes'
title: 'Ephesians unfoldingWord® Translation Notes'
versification: ''
identifier: 'eph'
sort: 49
@ -787,7 +787,7 @@ projects:
categories: [ 'bible-nt' ]
-
title: 'Philippians translationNotes'
title: 'Philippians unfoldingWord® Translation Notes'
versification: ''
identifier: 'php'
sort: 50
@ -795,7 +795,7 @@ projects:
categories: [ 'bible-nt' ]
-
title: 'Colossians translationNotes'
title: 'Colossians unfoldingWord® Translation Notes'
versification: ''
identifier: 'col'
sort: 51
@ -803,7 +803,7 @@ projects:
categories: [ 'bible-nt' ]
-
title: '1 Thessalonians translationNotes'
title: '1 Thessalonians unfoldingWord® Translation Notes'
versification: ''
identifier: '1th'
sort: 52
@ -811,7 +811,7 @@ projects:
categories: [ 'bible-nt' ]
-
title: '2 Thessalonians translationNotes'
title: '2 Thessalonians unfoldingWord® Translation Notes'
versification: ''
identifier: '2th'
sort: 53
@ -819,7 +819,7 @@ projects:
categories: [ 'bible-nt' ]
-
title: '1 Timothy translationNotes'
title: '1 Timothy unfoldingWord® Translation Notes'
versification: ''
identifier: '1ti'
sort: 54
@ -827,7 +827,7 @@ projects:
categories: [ 'bible-nt' ]
-
title: '2 Timothy translationNotes'
title: '2 Timothy unfoldingWord® Translation Notes'
versification: ''
identifier: '2ti'
sort: 55
@ -835,7 +835,7 @@ projects:
categories: [ 'bible-nt' ]
-
title: 'Titus translationNotes'
title: 'Titus unfoldingWord® Translation Notes'
versification: ''
identifier: 'tit'
sort: 56
@ -843,7 +843,7 @@ projects:
categories: [ 'bible-nt' ]
-
title: 'Philemon translationNotes'
title: 'Philemon unfoldingWord® Translation Notes'
versification: ''
identifier: 'phm'
sort: 57
@ -851,7 +851,7 @@ projects:
categories: [ 'bible-nt' ]
-
title: 'Hebrews translationNotes'
title: 'Hebrews unfoldingWord® Translation Notes'
versification: ''
identifier: 'heb'
sort: 58
@ -859,7 +859,7 @@ projects:
categories: [ 'bible-nt' ]
-
title: 'James translationNotes'
title: 'James unfoldingWord® Translation Notes'
versification: ''
identifier: 'jas'
sort: 59
@ -867,7 +867,7 @@ projects:
categories: [ 'bible-nt' ]
-
title: '1 Peter translationNotes'
title: '1 Peter unfoldingWord® Translation Notes'
versification: ''
identifier: '1pe'
sort: 60
@ -875,7 +875,7 @@ projects:
categories: [ 'bible-nt' ]
-
title: '2 Peter translationNotes'
title: '2 Peter unfoldingWord® Translation Notes'
versification: ''
identifier: '2pe'
sort: 61
@ -883,7 +883,7 @@ projects:
categories: [ 'bible-nt' ]
-
title: '1 John translationNotes'
title: '1 John unfoldingWord® Translation Notes'
versification: ''
identifier: '1jn'
sort: 62
@ -891,7 +891,7 @@ projects:
categories: [ 'bible-nt' ]
-
title: '2 John translationNotes'
title: '2 John unfoldingWord® Translation Notes'
versification: ''
identifier: '2jn'
sort: 63
@ -899,7 +899,7 @@ projects:
categories: [ 'bible-nt' ]
-
title: '3 John translationNotes'
title: '3 John unfoldingWord® Translation Notes'
versification: ''
identifier: '3jn'
sort: 64
@ -907,7 +907,7 @@ projects:
categories: [ 'bible-nt' ]
-
title: 'Jude translationNotes'
title: 'Jude unfoldingWord® Translation Notes'
versification: ''
identifier: 'jud'
sort: 65
@ -915,9 +915,9 @@ projects:
categories: [ 'bible-nt' ]
-
title: 'Revelation translationNotes'
title: 'Revelation unfoldingWord® Translation Notes'
versification: ''
identifier: 'rev'
sort: 66
path: './en_tn_67-REV.tsv'
categories: [ 'bible-nt' ]
categories: [ 'bible-nt' ]