Skip to content
This repository has been archived by the owner on Jul 28, 2023. It is now read-only.

Home

Jump to bottom
Antony Corbett edited this page Jul 6, 2019 · 22 revisions

The main application instructions are contained in the readme file. Below is a description of the function that imports Bible notes. This is an advanced function and requires you to prepare your notes in a particular way before importing.

Import Bible Notes

In addition to merging JW Library backup files, JWLMerge also allows you to import Bible notes into a backup file. This is useful if you maintain a collection of research notes using other software as these can be made available in JW Library. To import a text file containing your notes, go to the DETAILS page of a backup file and click the Import Bible Notes button (bottom left of the window).

Text File Format

JWLMerge needs to be able to determine which Bible is used and which verse each note corresponds to. The required format of the imported notes file is described below:

  1. The file should be in text format with a "txt" extension.
  2. The first line of the file should specify the Bible version, e.g. [BibleKeySymbol=nwtsty]
  3. The second line of the file should specify the language, e.g. [MepsLanguageId=0]

The values to use for items 2 and 3 above can be discovered by opening the Details page of one of your existing backup files and examining the KeySymbol and MepsLanguage columns in the Location grid.

Your notes follow. Each note should start with a verse specification in the following form:

[BOOK:CHAP:VS:WORD1:WORD2:COL]

  • BOOK = the 1-based Bible book index, e.g. 1 = Genesis, 66 = Revelation.
  • CHAP = the chapter.
  • VS = the verse.
  • WORD1 = the 0-based index of the first token in the verse to which the note applies.
  • WORD2 = the 0-based index of the last token in the verse to which the note applies.
  • COL = the colour index to use.

An abbreviated form of the verse specification can also be used as follows:

[BOOK:CHAP:VS]

This means the note applies to the whole verse.

The remaining content is the body of your note. You can use mutliple lines. If the first line of a multi-line note is less that or equal to 50 characters in length then it is used as the note's title.

Example

By way of example, the contents of a very simple import file are shown below. Both of the notes are on Genesis 3:15; the first refers to the verse as a whole and the second to a single word in the verse:

[BibleKeySymbol=nwtsty]
[MepsLanguageId=0]

[1:3:15]
First Prophecy

A prophecy. A covenant. The brevity and symbolic language of the 
statement left many questions unanswered!

[1:3:15:4:4:0]
Enmity

There was also enmity on the part of the woman toward the Serpent. 
Satan had called into question the integrity of every one of God's 
intelligent creatures, including all the angels ... they could not 
do otherwise than feel a loathing toward him.

Notes

You cannot apply any formatting to the notes - this is not supported in JW Library.

The import routine checks for a matching note by comparing the verse specification (as described above) and the title. Thus you may have multiple notes on a single verse with each differentiated by its title. If a match is found it is updated (if the content has changed). If a match is not found a new note is inserted. Existing notes that do not have a matching entry in the import file are retained.

Clone this wiki locally