First, this tutorial assumes you have homebrew installed. Homebrew is a fantastic ports manager for Mac OSX and you should get it. Also, you should install eloquent, which is the Mac OSX gui frontend for the Sword Project. Eloquent makes it much easier to install modules for diatheke. The two modules we will use for this tutorial are OSHB and 2TGreek. Many of the other modules are fantastic as well, but these are the two I would recommend.
Second, find out some information about Sword, via Homebrew's brew info command.
Next, you can install sword, with the appropriate brew command.
Once sword has finished installing, you can check it by just entering the command diatheke. This should pull up the following help menu.
After sword is installed, you need to link the diatheke command to the Sword Library. To do this you need to enter the following command into your .profile file. Be very careful when dealing with .profile! Make sure you enter this exactly.
# Setting PATH for sword
SWORD_PATH="/Users/NAME/Library/Application Support/Sword"
export SWORD_PATH
Of course your name will be different from mine, but still it should look something like this:
Now, to save the file in vim you need to prese <esc> and then type :wq. Also, to make the profile active you'll need to quit terminal and restart it. Now, you can try taking diatheke for a spin. You can try by typing diatheke -b OSHB -o v -k Gen 1:1-3. And it should look like this:
Copying and pasting Greek and Hebrew text can be a pain. Diatheke can save you some time and effort, by automatically copying any biblical passage you need into the clipboard. First, make sure you have a ~/bin file. And have the following Path added to your .profile. (once again assuming that you change the user name to suit the computer you are working on).
Now, using vim make a file in the ~/bin folder called gtext. (or gbib would also work).
#!/bin/bash
verse="$(diatheke -b 2TGreek -o a -k $*)" #displays the output in the stdout
echo "$verse"
pbcopy <<< "$verse"
Also do the same thing for htext/hbib (which ever title you are going for).
Although, the code for this is somewhat more complicated, as SBL style dictates that you copy plain text rather than vocalized text, but most people would rather read vocalized text, there are options for both in this code.
#!/bin/bash
verse="$(diatheke -b OSHB -k $2 $3)"
versev="$(diatheke -b OSHB -o v -k $*)"
while getopts "p" opt; do
case $opt in
p)
echo "$verse";
pbcopy <<< "$verse"
exit 0 ;;
\?)
echo "invalid option"
break ;;
esac
done
echo "$versev"
pbcopy <<< "$versev"
Once you get them up and running, you can type the command plus a bible reference/range of texts, and the text will both display in your terminal screen as well as being copied to your clipboard to be pasted in the word processor of your choice.
The option in the Hebrew text could be called up as htext -p Gen 1:1-5. This would bring up plain text, or with out the -p, it brings up vocalized text.
