Note: The following steps may be unnecessary if you are using the latest Wine for Puppy and the latest e-Sword since there have been significant improvements in both and they now work well together. Seepost on page 8 for updated procedures.Rick Meyers, developer wrote:e-Sword is a fast and effective way to study the Bible. e-Sword is feature rich and user friendly with more capabilities than you would expect in a free software package. The fact that e-Sword is free is just one of the blessings and does not speak of the quality of the software. I make my living writing software and I believe I have put forth my best effort in this endeavor. The real work, however, was put in by the godly men and women who devoted countless years creating the texts that have been made available for our benefit.
In His service,
Rick Meyers
The following steps should result in a successful e-Sword installation using puppy 431 and the latest wine .pet . It has also been successfully tested on Puppy 432, dpup-484, and the latest Puppy Lucid, Lighthouse, Wary and Quirky. Amazingly, e-Sword on my hardware is quicker and more responsive under Wine than it is under it's native windows.
1. Download from green_dome's latest wine-1.4-rc5 which works great.
2. Download e-Sword installation files, setup972.exe plus any other desired modules. Unfortunately this link now just downloads the latest e-Sword and is no longer active to download modules, see EDIT below.
3. Before installation, two missing files, needed by e-Sword,MFC42.DLL and msls31.dll must be located and copied to /root/.wine "C:\\windows\\system32", otherwise the installation file will not work properly.
4. Next in order for the graphics to work properly, use Wine configuration (in console winecfg) to set riched20.dll and oleaut32.dll to native. Press the Libraries tab > type riched20.dll > press add > press edit > choose Native (windows). Do the same for oleaut32.dll.
NOTE1: Known problem, the e-Sword Graphics Viewer may not work with wine versions higher than 1.1.40-i486.pet.
NOTE2: For the e-Sword Graphics Viewer to work with wine versions higher than 1.1.40-i486.pet, the above dlls may need to be set to (Native then builtin), otherwise e-Sword may not start. Also, to see the graphic, you may need to select Print Preview in the Graphics viewer, next, close the Print Preview, then click on the Fit Width button.
5. Install setup972.exe by double clicking on the file. Install the additional modules that were downloaded ie. clarke.exe, isv.exe, asv.exe, smith.exe, and spurgeons.exe by double clicking on the files.
6. The next step is to place the e-Sword.desktop in the proper location so that it will show up in the menu correctly. The setup972.exe file places e-Sword.desktop in /root/Desktop and /root/.wine/drive_c/users/Desktop, but it fails on some distributions. Just click on the e-Sword.desktop to start the program. However, in order for e-Sword to display properly in the menu, e-Sword.desktop must be placed in /usr/share/applications and edited in order for it to show up in a proper category.
a. Goto /root/Desktop and copy the file e-Sword.desktop to /usr/share/applications. Note: Some pups won't have the /root/desktop directory, if so, step 7 should work.
b. Open /usr/share/applications/e-Sword.desktop in an editor and add the following code Categories=WordProcessor which will allow e-Sword to show up in the Document menu. If you want it to show up on your desktop, also copy your corrected e-Sword.desktop file to the desktop.
c. Execute the code fixmenus in a console.
d. Restart X, then e-Sword should show up as a menu item in the Document menu. Click on it and e-Sword should start.
7. If e-Sword doesn't start in step 6, or the e-Sword.desktop file was not located, try the following:
a. Execute the code env WINEPREFIX="/root/.wine" wine "C:\\Program Files\\e-Sword\\e-Sword.exe" in a console. E-sword should start and now all that's needed is a proper e-Sword.desktop file.
b. Use Pfind or other search tool to locate e-Sword.desktop and place it in /usr/share/applications and edit it as in step 6 above. Or you can open an editor, insert the following code and save it in /usr/share/applications.
Code: Select all
Name=e-Sword
Icon=/usr/share/pixmaps/esword.png
Comment=Bible study
Exec=env WINEPREFIX=/root/.wine wine "C:\Program Files\e-Sword\e-Sword.exe"
Terminal=false
Type=Application
Categories=WordProcessor
GenericName=e-Sword
8. Another helpful addition is to create an executable file and place it in usr/bin. To do this, prepare a text file named esword.sh containing the code env WINEPREFIX=/root/.wine wine "C:\Program Files\e-Sword\e-Sword.exe", make sure that it is executable by checking properties and changing it to executable. This will allow you to start e-Sword from a console easily, or to add it to the Favorites menu in pups such as Stardust and Puppy 4.4CE or to add it to wbar if your pup has wbar.
NOTE:
It is important, after a successful installation, to make a backup of it. Just copy root/.wine to mnt/home. Another alternative approach is to move root/.wine to mnt/home and then copy a link to root/. This keeps the wine programs out of the save file (less danger of corruption) and provides the flexibility to use it with different pups. I still place the other needed files in /usr/bin and /usr/share/applications and /usr/share/pixmaps, of course they could be moved to an e-Sword directory in mnt/home and linked back to the proper locations. Also, you need to make backup copies of files that you added: /usr/bin/esword.sh. /usr/share/applications/e-Sword.desktop and/usr/share/pixmaps/esword.png since these will also be needed for new installations.
Also, in a new installation of another pup, all you will need to do is install Wine, then delete root/.wine and add a link to your /mnt/home/.wine. Then copy or link to /usr/bin/esword.sh, /usr/share/applications, /e-Sword.desktop, and/usr/share/pixmaps/esword.png.
These procedures are an adaptation of manual procedures developed by david_kt for Ubuntu. Thank you David.
EDIT (Jan 2011):
Rick responded that I need to roll back to version 9.7.2. This does not work for new users because the e-Sword web site links only to latest version.Jim1911 wrote:There is a new e-Sword update, e-Sword v9.8.2 application installation. Unfortunately, Rick Meyer, developer of e-Sword, has changed his site and now the only way to download modules is by using a new Module Downloader that is a main feature of the latest 9.8 version. See attachment.
The Module Downloader is a great feature for Windows users because it shows what you have installed and enables downloads, but it does not work under Linux.
The good news is that you can update to e-Sword v9.8.2 by downloading setup982.exe with your browser and click on it. Except for the downloading feature, it works great.
I have asked Rick to restore browser access to the download area as it was prior to 9.8 so that Linux users can still get new modules and updates.
However, although there are no download links, I discovered that a browser can still be used to access the web site download areas for new modules or updates by entering a complete link for the download as follows: Note: These links are no longer active.
Bibles- www.e-sword.net/bibles.html
Commentaries - www.e-sword.net/commentaries.html
Dictionaries - www.e-sword.net/dictionaries.html
Devotions - www.e-sword.net/devotions.html
Graphics - www.e-sword.net/graphics.html
Extras - www.e-sword.net/extras.html