Draft Revised instructions for e-Sword Module Installer
Because of faulty information in the existing e-Sword Module Installer download instructions, these are proposed.
Please evaluate and suggest revisions, where the details could be revisee, where necessary. Then please arrange with Josh Bond or with another administrator to REPLACE or to EDIT the existing e-Sword Module Installer Utility for Windows webpage instructions, with the new information. Thank you.
Josh Bond, the webmaster of biblesupport.com has a full-time employment, and personal family details to attend to. He has promised to reconfigure BibleSupport.com website sometime. He needs assistance from other Administrators to do that work.
Existing: Description version 0.6
The e-Sword Module Installer automatically installs your e-Sword modules! It copies your e-Sword module to your e-Sword Resources Location or User Files Location on your Windows PC. This works for e-Sword 9, 10, and 11. Step 1: Download and install the Module Installer. (During or after the download, click "Open" or "Run" to install the Module Installer). Step 2: You can install modules from Windows Explorer, Internet Explorer, or Firefox.
Problem with the words in the existing Description version 0.6:
[1] this does NOT work "automatically", because the module installer is not always loaded into the computer memory.
[2] The Module Installer only works after having been downloaded, and then run; and thereafter is called up only when a user clicks on an e-Sword type module with one of the numerous e-Sword file type extensions after the file name. When the module from biblesupport.com has been fully downloaded, that will merely remain in the download folder, until the user finds that file, and processes that file further.
[3] The user also needs to know the folder into which files are to go, and also what to do if the file goes to the wrong destination.
[4] "Windows Explorer" name was changed to "File Explorer", which is a file manager application included with releases of the Microsoft Windows operating system from Windows 95 onwards.
[5] "Internet Explorer" is a discontinued series of graphical web browsers developed by Microsoft and included in the Microsoft Windows line of operating systems, starting in 1995. Microsoft removed Internet Explorer from the Windows 10 PC during 2021, and replaced it with Microsoft Edge, a cross-platform web browser developed by Microsoft. Microsoft released Edge for Windows 10 and Xbox One in 2015, then for Android and iOS in 2017, for macOS in 2019, and as a preview for Linux in October 2020. Internet Explorer 11 has been retired and is officially out of support as of June 15, 2022. If any site you visit needs Internet Explorer, you can reload it with IE mode in Microsoft Edge. Microsoft Edge is the browser recommended by Microsoft and has been updated. Microsoft Edge has now replaced Internet Explorer for Windows 10, and for Windows 11. Microsoft Edge with Internet Explorer (IE) mode is the only browser with built-in compatibility for legacy web sites and apps.
[6] Firefox from Mozilla works successfully as an internet browser on the Windows PC.
e-Sword Module Installer utility for e-Sword running on the Windows operating system. Proposed revised instructions
Suggestion: Description
Step A. Download this e-Sword Module Installer utility for your Windows Operating System from BibleSupport.com. Move your pointer to the "Download" label. Tap this option. On the following screen read the details. Browse to the bottom of the page, and tap the option to select the option to confirm that you have read and will comply with the details. Follow the browser screen prompts and instructions as the browser offers the download to your PC. Provide all the necessary alternative responses, to authorise your PC to download, and to Keep, and to run, this file with the .exe file type.
Step B. Find the downloaded file and allow your PC to run e-Sword Module Installer on your Microsoft PC. Follow instructions which you see in screen prompts, and provide necessary alternative responses, to authorise your PC to run, and to install, this file. If you do not respond to the prompts as expected, then these prompts will time out, and the process will not continue.
What This will do
This utility will be installed as "C:\Program Files\e-Sword Module Installer\moduleInstaller.exe"
Now you first need to select this file and to run this utility from there, successfully, irrespective of which drive or folder you use to store your e-Sword files.
This utility will associate e-sword type file types (the last four letters after the point in the file name, which should all be spelled in lower-case small letters), with the e-Sword Module Installer from Bible Support.
With e-Sword running, use the Help option "F1" keyboard shortcut function key to call up the e-Sword User's Guide, in PDF format. In this document you will find further details about how to use e-Sword. Please read pages 1,2,3,20,36-44. The Find option, as usual in PDF files, is obtained with Ctrl+F. This means, press the Ctrl key, and while holding that down, press the F key, then release both keys. Then enter the required word which you want to Find in the document, and then tap the Enter. key.
This e-Sword Module Installer from BibleSupport.com works successfully for all versions of e-Sword from version 9 and later, including version 13.0.0 on systems running the Microsoft Windows Operating system. This is not limited only to version 9 and 10, as was specified on page 44 of the e-Sword User's Guide revision 8/1/2014 (2014).
Hereafter, by clicking on an unzipped e-Sword type module, moduleInstaller.exe will help you to copy this module to the relevant e-Sword path and file folders as set up in e-Sword on tab "Options", and "Resource Settings..." where [1] e-Sword files are in the folder shown in the "Resources Location" window, and [2] your user files which you can edit with the Editor options, are in the folder shown in the "User Files Location" window. If you changed your destination drive or path or folder, please change these details in these options in your copy of e-Sword as well, then restart e-Sword.
IN FUTURE, HOW TO INSTALL A MODULE FROM BIBLESUPPORT.COM TO A WINDOWS PC
You will have already downloaded the Bible Support e-Sword Module Installer utility, using your internet browser. After that file has download, successfully, access the downloaded file, and click "open" or "Run" to Install the Module Installer. After Microsoft updates your PC operating system, it will be advisable to restart your PC. You will find the "Restart" option from "Start", "Power" option. Then you can re-run the Module Installer to refresh the registry, to ensure that all e-Sword file type files are still correctly linked in the PC.
Step 1: Download the module from Bible Support. Watch screen prompts, and respond with the necessary options to authorize the PC to Download, to Keep, and to have authorization to run the downloaded files.
Step 2. Run e-Sword, and select "Options > Resource Settings... > Resource Options" and take note of the "Resources Location" window, and the "User Files Location" paths. If you changed the destination drive or path or folder of where you want the files to be found by e-Sword, change these details in this option in e-Sword as well. Then exit e-Sword using the "X" close option in the top right corner.
Step 3. Left-click with your pointer on the downloaded e-Sword module. Select the module. If the letters of the file type (after the point in the filename) are in CAPITAL letters, edit the file name to change them to the equivalent letters in lower case small letters (otherwise the Module Installer will not process the files). If there are extended characters or single quotes inside the filename, change these by removing these characters, which are unnecessary, so that you can read the filename with correct characters..
Files with .exe file type, are linked to a self-extracting wizard, and that should prompt you as to what file they will load, and where they will install that file. Check that the destination drive, path, and folder is where you store your e-Sword files.
Other module files need you to copy them to the e-Sword folders, as detailed to the location found in step 2.
Thereafter you will be able to read the contents of the file module using e-Sword, by closing, and re-running e-Sword.
If the file is in a zip folder, or .zip file type, you will need an unzip application to unzip the file. 7-zip Copyright © 1999-2022 by Igor Pavlov, from www.7-zip.org with Support from www.7-zip.org/support.html is free, and useful, not only as a file archiver with a high compression ratio, but is also useful to view the content of files in a zipped folder. If you notice that there are installation instructions inside the zip file which you received fromBible Support, then please read those instructions, carefully, and follow those instructions. Click the file(s), to be processed by e-Sword Module Installer, one by one, or move a copy of the file to the relevant folder using 7-zip.
Step 4. As prompted by the .exe wizard installation application, or by e-Sword Module Installer move the downloaded files to the relevant e-Sword destination folder, changing the drive and path to the required destination as found in step 2.
Step 5. If the file was a *.exe self-extracting module and the built-in wizard installed the contents to the wrong drive, use file explorer to find the module(s), and copy and move the file(s) to the required drive and path and folder. You can do so manually, or use e-Sword Module Installer, and just click on each file in turn to get a copy made and copied to the correct drive and path and folder.
Step 6. Check that the file was placed in the correct e-Sword file folder, and that the file type extensions (the four letters after the point in the file name), are not in capital letters. If you notice errors in the spelling of the file name, you can correct these, but do not change the file type (the four letters after the point in the file name). Run e-Sword, and check that the file is where you expect to find it, listed on e-Sword tab "Options" > "Resource Settings..." > "Resource Options" on the relevant lists of files of different types. The files will be listed in e-Sword in alpha-numerical order, on the name of the file name. If you want the file to be in a different order, you could change the filename by prefixing an appropriate number before the filename.
If the file type is .topx or .refx or .refi you can view it from the e-Sword Reference Library Window, when a copy is in the "Resources Location" folder. You access the Reference Library on e-Sword menu option "Tools", "Reference Library". There is a quick link to the Reference Library from the icon that looks like three books alongside one another.
If the file type is .topx then you can view (and edit) it with the e-Sword TOPIC EDITOR, when you move a copy to the "User Files Location" folder.
HOW TO RESOLVE PROBLEMS WITH A MODULE FROM BIBLESUPPORT
When a module does not work, write down the name of the file, and the source address from where you obtained it, and the filename as you downloaded the file, and record what you did. Did you change the file name? Also, what was the name of the URL of the option on Bible Support from where you downloaded the file? You will see this on the browser address entry, when you are on the web page.
Write down the steps you took to install it. Did the file get copied into the folder mentioned above as "Resources Location" folder in e-Sword? or into the "User Files Location" folder? Are these folders the same URL address as when you open e-Sword and look in the tab "Options" > "Resource Settings..." "Resource Options" for the files of the appropriate type of e-Sword module? What specific file did NOT appear in those locations, which you expected to find there? Are you logged into your PC on your own name, or using someone else's name?
If you renamed the downloaded file, try to repeat your download without changing the name of the file. Do you reproduce your error? Keep track of each step, noting what you do, on which screen, step by step. What did you do, or not do, to be able to get the file to be authorized to download, to be kept, and to be run, on your PC.
Also list what third-party file security program you have, which may have prevented some file, unknown in its database, to be saved, or to run on your PC. Try turning off your third-party security, while you process the downloaded file. Once successfully loaded, and working, you can re-turn on your third-party file security application.
Check what files were saved into the Virtual Store. This is at "C:\Users\user\AppData\Local\VirtualStore\Program Files (x86)\e-Sword" If the file is there, and you have run e-Sword Module Installer from BibleSuport.com, then click on that file in the VirtualStore folder, to copy it to the relevant folder where you expect the file to be located.
The programmer may have spelled the file name incorrectly. The file type [the four letters after the point in the file name] may have been in CAPITAL letters, instead of lower-case small letters. The Module Installer does not process file names with the file type in CAPITAL letters. If that happened, just rename the letters into the equivalent small letters, and try re-installing it in the correct destination file again.
Report the problem to BibleSupport.com by making a new forum topic entry. Please write only in English. Mention whether you are using Microsoft operating system, what make of PC, and which operating system update your PC has been most recently updated with. Mention which security application, to which version, you have running. Identify which specific file you tried to download, and the download name.
Which browser did you use? Are you running as Administrator, or as user, on your PC? Where did you find the downloaded file on your PC? What happened? The more details you give, the better someone can use their imagination to think though your progress, step by step, and then try to consider all variables that might be on your PC, to discover exactly where the error occurred. Please be aware that many computer companies have been changing security options on the computer devices, and on different browsers, during 2021 and 2022, and you may need to authorize access to specific folders, especially if you have a security application running.
Thank you for your feedback.
Postscript. PLEASE ARRANGE with a programmer who can edit the Module Installer program, so that it will process .lexx and .ovlx files correctly.
Olaf Bacon.
Edited by Olaf Bacon, 22 November 2022 - 12:20 AM.
