NET installation for JSword
version 1.0
The latest
JSword 1.0.3 has been specially tailored to include support for the
NET bible. Open tools->books and you will see a bible.org
tab. Open this, and click 'update available books, and you will
be presented with a tree showing modules and commentaries. In the
first instance, download Bible/English/NETfree and give it a try.
Later, you may wish to take the 'for pay' NET module. This will
need unlocking. Go to the installed books in the tools->books
window, and you will see an unlock button. Click this and you
will be able to enter the key you have purchased. Be sure you get
it absolutely correct. If the incorrect key is entered, the NET
bible will not show. If this happens, go back to the NET bible in
the Tools->books window, and you will see the key you have entered
displayed there. You can then check and edit the key. Make
sure you have all alphabetic characters entered in the correct case.
If you have an
existing Sword installation, and the path to your Sword installation is
properly set up in BibleDesktop, JSword will
discover and use any modules or module cipher keys that are installed
in the ~/.sword/mods.d or modules directories. You got to
Tools->options and click on Sword books, where you can edit to path
to point to your Sword directory. If you are unsure as to where
this is, try looking searching for mods.d and modules. You should
find both of these in a directory called jsword and a further set in a
directory whch normally includes the word 'sword' in the path.
This is the path to include. You can use the
Bible Desktop book manager, or the Bibletime or Gnomesword Module
Managers or Windows Install Manager to
download and update modules
if they are already available on your system. Once Install
Manager has
installed the modules for you, JSword, if configured correctly, will
recognise the NET modules and display them properly.
Most of the
installation instructions below are specific to Linux, although
advanced Windows users should be able to interpret them and recognise
the Windows commands that replace the Unix commands.
The following instructions apply to manual installation of the modules
and are for advanced users only.
If
you are
using Windows and need to edit the .conf files manually, you will need
to use a programmer's editor such as the free Xint editor.
Windows
notepad inserts extra characters and will not unlock the module.
If you do not
have BibleTime, GnomeSword or Sword for Windows, you can
still download the NETfree.zip, NETnotesfree.zip, NET.zip, or
Netnotes.zip module files from ftp.bible.org/sword/packages/rawzip and
install them manually.
From a console
(cut and paste):
cd ~/.sword
The following is
for the Premium versions - all one line:
wget
ftp.bible.org/sword/packages/rawzip/NET.zip
ftp.bible.org/sword/packages/rawzip/NETnotes.zip
This is for the
free versions - all one line:
wget
ftp.bible.org/sword/packages/rawzip/NETnotesfree.zip
ftp.bible.org/sword/packages/rawzip/NETfree.zip
If the unzip
utility is in your path:
unzip -x -n NET
unzip -x -n
NETnotes
or
unzip -x -n
NETnotesfree
unzip -x -n
NETfree
If you are using
the Premium versions of the NET Bible and Notes change directory and
edit the .conf files:
cd mods.d
Alternatively in
Nautilus or Konqueror select View > Show Hidden Files, navigate to
the .zip files in the ~/.sword directory and right-click select extract
here from the pop-up context menu. Ark will notify you that the mods.d
and modules directories won't be extracted if they already exist - just
click the Continue button.
*Note*: If you
wish to use the premium NET modules, you will have to edit the
configuration files ~/.sword/mods.d/NET.conf and
~/.sword/mod.d/NETnotes.conf. Just enter your key number with no extra
spaces on the line in those files that begins with: CipherKey=. For
example:
BlockType=Book
CipherKey=9999FFfF9999FfFF
CompressType=ZIP
From the
console: cd ~/.sword/mods.d and use a text editor such as vim, emacs,
mcedit, and etc. Alternatively, in either Nautilus or Konqueror
navigate to the .conf files and right click on them. Select a text
editor like gedit or kedit from the pop-up context dialog. Enter your
key number and File > Save your changes.
You may
wish to
backup your NET.conf and NETnotes.conf files as these contain the
CipherKey. If you re-install the Sword modules
for any reason they will be lost or overwritten and you can simply copy
your backup into the mods.d directory.
Thanks to
hwilkerson for these instructions