Links from the original language words to Translation Words articles. Previously customized links in UHB and UGNT were used (but that didn't enable them to be customized for Gateway Languages).
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.
Robert Hunt b445d01b14 Merge pull request 'Prepare to publish v3' (#25) from prePubV3 into master 3 months ago
LICENSE.md Change HTTP links to HTTPS 5 months ago
README.md Add alt text for image link 5 months ago
manifest.yaml Valid Prepare to publish v3 3 months ago
twl_1CH.tsv Update to new file-naming scheme 7 months ago
twl_1CO.tsv Prepare to publish v2 5 months ago
twl_1JN.tsv Edits to TW links in 1 John and Matthew 5 months ago
twl_1KI.tsv Update after fixing UHB multiple TWLs in one word 5 months ago
twl_1PE.tsv Update to new file-naming scheme 7 months ago
twl_1SA.tsv Update 'twl_1SA.tsv' 4 months ago
twl_1TH.tsv Update to new file-naming scheme 7 months ago
twl_1TI.tsv Update to new file-naming scheme 7 months ago
twl_2CH.tsv Update after fixing UHB multiple TWLs in one word 5 months ago
twl_2CO.tsv Prepare to publish v2 5 months ago
twl_2JN.tsv Update to new file-naming scheme 7 months ago
twl_2KI.tsv Update to new file-naming scheme 7 months ago
twl_2PE.tsv Update to new file-naming scheme 7 months ago
twl_2SA.tsv Update to new file-naming scheme 7 months ago
twl_2TH.tsv Update to new file-naming scheme 7 months ago
twl_2TI.tsv Update to new file-naming scheme 7 months ago
twl_3JN.tsv Update to new file-naming scheme 7 months ago
twl_ACT.tsv Update to new file-naming scheme 7 months ago
twl_AMO.tsv Update to new file-naming scheme 7 months ago
twl_COL.tsv Prepare to publish v2 5 months ago
twl_DAN.tsv Update after fixing UHB multiple TWLs in one word 5 months ago
twl_DEU.tsv Update to new file-naming scheme 7 months ago
twl_ECC.tsv Update to new file-naming scheme 7 months ago
twl_EPH.tsv Update to new file-naming scheme 7 months ago
twl_EST.tsv Prepare to publish v3 3 months ago
twl_EXO.tsv Edit 'twl_EXO.tsv' using 'tc-create-app' 3 months ago
twl_EZK.tsv Update to new file-naming scheme 7 months ago
twl_EZR.tsv Prepare to publish v2 5 months ago
twl_GAL.tsv Update to new file-naming scheme 7 months ago
twl_GEN.tsv Update after fixing UHB multiple TWLs in one word 5 months ago
twl_HAB.tsv Update to new file-naming scheme 7 months ago
twl_HAG.tsv Update to new file-naming scheme 7 months ago
twl_HEB.tsv Update to new file-naming scheme 7 months ago
twl_HOS.tsv Update to new file-naming scheme 7 months ago
twl_ISA.tsv Update to new file-naming scheme 7 months ago
twl_JAS.tsv Update to new file-naming scheme 7 months ago
twl_JDG.tsv Update to new file-naming scheme 7 months ago
twl_JER.tsv Update after fixing UHB multiple TWLs in one word 5 months ago
twl_JHN.tsv Edits to John TW's 4 months ago
twl_JOB.tsv Update to new file-naming scheme 7 months ago
twl_JOL.tsv Fix maqqefs 7 months ago
twl_JON.tsv Fix maqqefs 7 months ago
twl_JOS.tsv Update 'twl_JOS.tsv' 5 months ago
twl_JUD.tsv Update to new file-naming scheme 7 months ago
twl_LAM.tsv Update to new file-naming scheme 7 months ago
twl_LEV.tsv Update after fixing UHB multiple TWLs in one word 5 months ago
twl_LUK.tsv Removed tW link in Luke 12:46 4 months ago
twl_MAL.tsv Update to new file-naming scheme 7 months ago
twl_MAT.tsv Update for latest BP edits 5 months ago
twl_MIC.tsv Update to new file-naming scheme 7 months ago
twl_MRK.tsv Update to latest to prepare for first publish 6 months ago
twl_NAM.tsv Update to new file-naming scheme 7 months ago
twl_NEH.tsv Update for small UHB fixes 5 months ago
twl_NUM.tsv Update to new file-naming scheme 7 months ago
twl_OBA.tsv Fix maqqefs 7 months ago
twl_PHM.tsv Update to new file-naming scheme 7 months ago
twl_PHP.tsv Update to new file-naming scheme 7 months ago
twl_PRO.tsv Update after fixing UHB multiple TWLs in one word 5 months ago
twl_PSA.tsv Update after fixing UHB multiple TWLs in one word 5 months ago
twl_REV.tsv Update to new file-naming scheme 7 months ago
twl_ROM.tsv Update to new file-naming scheme 7 months ago
twl_RUT.tsv Fix maqqefs 7 months ago
twl_SNG.tsv Update to new file-naming scheme 7 months ago
twl_TIT.tsv Update to new file-naming scheme 7 months ago
twl_ZEC.tsv Update to new file-naming scheme 7 months ago
twl_ZEP.tsv Update to new file-naming scheme 7 months ago

README.md

en_twl

Links from the original Bible languages to Translation Words.

Previously the links in UHB and UGNT were used (but that didn't enable the links to be customized for Gateway Languages).

Editing the TWL

To edit the TWL 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

It should look like this:

Screenshot of LibreOffice Text Import dialog

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 entries 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 TWL are structured as TSV files to simplify importing and exporting into various formats for translation and presentation. The TWLs are keyed to the original Greek and Hebrew text, but clones of this repository can be made for the Gateway Languages (GLs), and then the TW links can be adjusted to accommodate the workings of those languages.

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 TWL are structured as one file per book of the Bible and encoded in TSV format, for example, twl_GEN.tsv. The six columns are Reference, ID, Tags, OrigWords, Occurrence, and TWLink.

TWL 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 links came from the English resources and which links have been added by GLs.
    • The Universal ID (UID) of a note is the combination of the Book, Chapter, Verse, and ID values. For example, tit/1/3/swi9.
      • This is a useful way to unambiguously refer to links.
      • An RC link can resolve to a specific note like this: rc://en/tn/help/tit/01/01/swi9.
  • Tags – (optional) any of keyterm or name, separated by ; if there's more than one
  • OrigWords – Original language quote (e.g. ἐφανέρωσεν↔τὸν λόγον αὐτοῦ) but most often just one word
  • Occurrence – Specifies which occurrence in the original language text the entry applies to.
    • -1: entry applies to every occurrence of OrigWords in the verse
    • 0: entry does not occur in original language (for example, “Connecting Statement:”)
    • 1: entry applies to first occurrence of OrigWords only
    • 2: entry applies to second occurrence of OrigWords only
    • etc.
  • TWLink – A Resource Container link to a TranslationWords article, e.g., rc://*/tw/dict/bible/other/peace