Eloquent: Difference between revisions
No edit summary |
No edit summary |
||
| Line 7: | Line 7: | ||
MacSword is OpenSource Bible software, under the [http://www.gnu.org/licenses/gpl-2.0.html GNU General Public License] for the Macintosh. It is based on the [http://www.crosswire.org/sword/index.jsp Sword Project]. Because of this, it is compatible with all of the Sword Project modules. (According to the MacSword web page, there are over 200 modules available in 50 languages) The nature of the Sword Project is such, that with the right tools, and a little effort, one can also create their own modules. In fact, it is the fact that MacSword is a part of the Sword Project that sets it apart from the other Bible software programs on the market. While all the rest rely on proprietary file formats, which are unique to themselves, MacSword, by relying on the Sword Project modules, enters the realm of cross-platform Bible tools, which allow for a common base of study tools, whether you are using a Mac, Window-based or Linux-based computer. Furthermore, there are also programs for the iPhone ([[Bible_software_for_iPhone#PocketSword|PocketSword]]) and Android (AndBible), as well, which also use the Sword Project modules. Because of its open-source nature, MacSword tends to rely on older, out-of-copyright works, but it is entirely capable of opening protected, copyrighted works. For instance, it is possible to purchase the NETBible for the Sword Project and MacSword. | MacSword is OpenSource Bible software, under the [http://www.gnu.org/licenses/gpl-2.0.html GNU General Public License] for the Macintosh. It is based on the [http://www.crosswire.org/sword/index.jsp Sword Project]. Because of this, it is compatible with all of the Sword Project modules. (According to the MacSword web page, there are over 200 modules available in 50 languages) The nature of the Sword Project is such, that with the right tools, and a little effort, one can also create their own modules. In fact, it is the fact that MacSword is a part of the Sword Project that sets it apart from the other Bible software programs on the market. While all the rest rely on proprietary file formats, which are unique to themselves, MacSword, by relying on the Sword Project modules, enters the realm of cross-platform Bible tools, which allow for a common base of study tools, whether you are using a Mac, Window-based or Linux-based computer. Furthermore, there are also programs for the iPhone ([[Bible_software_for_iPhone#PocketSword|PocketSword]]) and Android (AndBible), as well, which also use the Sword Project modules. Because of its open-source nature, MacSword tends to rely on older, out-of-copyright works, but it is entirely capable of opening protected, copyrighted works. For instance, it is possible to purchase the NETBible for the Sword Project and MacSword. | ||
== Installing MacSword == | == Installing MacSword == | ||
Installing MacSword is as simple as downloading a dmg file from the MacSword web site's [http://www.macsword.com/download/ MacSword Download Page]. This dmg download contains both the application and a movie that shows how to install modules. Of course, once you need to upgrade in the future, you don't need to download the dmg, and can just download the application file, which is about half the size, also from the same download page. | |||
== Installing Modules == | == Installing Modules == | ||
As stated, the full dmg download includes a movie showing how to install modules, but if you would like, you can watch the movie by clicking this link: [http://www.macsword.com/macsword2/screencasts/MS2_ModuleInstaller.mov Module Installer Movie]. It is not immediately apparent where MacSword installs the modules, so I shall say a word or two here. By default, MacSword installs its module files in the following folder: | |||
/Users/<username>/Library/Application Support/Sword | |||
Unlike earlier versions of MacSword (1.4 and earlier), it is not possible to change this folder. However, with a little effort, and the usage of what are called "symbolic links", it is possible to store the files elsewhere. However, if you just want easier access to this folder, you can simply make an alias using the Finder, and drag the folder to a more convenient location (for instance, your user folder or your Documents folder). | |||
It is also possible to install your own modules, but it is a bit more complicated to do so. In fact, it is not recommended that you do this unless you absolutely have to. For instance, if you have a module that is not found on any repository, you would need to manually install a module. In order to install your own modules, you really need to have a good understanding of your Mac's file structure, and how the Finder works. If you feel uncomfortable following these instructions, it would be best to ask on the Mac-Ministry mailing list for help. | |||
The very first thing you need to do is to quit MacSword if it's running. For the sake of this example, I have downloaded the OSX version of the [http://www.crosswire.org/sword/modules/ModInfo.jsp?modName=SBLGNTApp SBLGNTApp] file. When the zip file is unzipped, there are two folders inside the .swd folder. The first is named "mods.d", and the second is named "modules". The mods.d folder contains the configuration file for this module, and must be placed in the folder with the same name within Sword folder mentioned above. The "modules" folder contains a tree of folders. In this case, the structure looks like this: "/modules/comments/zcom/sblgntapp/". Inside that last folder are three files, "nt.bzs", "nt.bzv", and "nt.bzz". What we need to know is this. You need to find the "modules" inside your Sword folder, then find the "comments" folder, and then the "zcom" folder. Inside that folder, you can drop the folder named "sblgntapp". It is possible that you do not have a folder named "zcom" or a folder named "comments". In such a circumstance, it would be easiest to navigate to the last folder you have and copy the remaining folders into that. For instance, if you have a "comments" folder, but no "zcom" folder inside that, copy the "zcom" folder from the sblgntapp.swd folder, into your Sword's "comments" folder. Once all the files are copied, you will want to launch MacSword to see the modules you've installed. | |||
== More to come… == | |||
== Setting up MacSword == | == Setting up MacSword == | ||
Revision as of 14:24, 21 February 2011
Mac Sword This page is a work in progress, but will hopefully be added to over the coming weeks.
About MacSword
First of all, what is MacSword?
MacSword is OpenSource Bible software, under the GNU General Public License for the Macintosh. It is based on the Sword Project. Because of this, it is compatible with all of the Sword Project modules. (According to the MacSword web page, there are over 200 modules available in 50 languages) The nature of the Sword Project is such, that with the right tools, and a little effort, one can also create their own modules. In fact, it is the fact that MacSword is a part of the Sword Project that sets it apart from the other Bible software programs on the market. While all the rest rely on proprietary file formats, which are unique to themselves, MacSword, by relying on the Sword Project modules, enters the realm of cross-platform Bible tools, which allow for a common base of study tools, whether you are using a Mac, Window-based or Linux-based computer. Furthermore, there are also programs for the iPhone (PocketSword) and Android (AndBible), as well, which also use the Sword Project modules. Because of its open-source nature, MacSword tends to rely on older, out-of-copyright works, but it is entirely capable of opening protected, copyrighted works. For instance, it is possible to purchase the NETBible for the Sword Project and MacSword.
Installing MacSword
Installing MacSword is as simple as downloading a dmg file from the MacSword web site's MacSword Download Page. This dmg download contains both the application and a movie that shows how to install modules. Of course, once you need to upgrade in the future, you don't need to download the dmg, and can just download the application file, which is about half the size, also from the same download page.
Installing Modules
As stated, the full dmg download includes a movie showing how to install modules, but if you would like, you can watch the movie by clicking this link: Module Installer Movie. It is not immediately apparent where MacSword installs the modules, so I shall say a word or two here. By default, MacSword installs its module files in the following folder: /Users/<username>/Library/Application Support/Sword
Unlike earlier versions of MacSword (1.4 and earlier), it is not possible to change this folder. However, with a little effort, and the usage of what are called "symbolic links", it is possible to store the files elsewhere. However, if you just want easier access to this folder, you can simply make an alias using the Finder, and drag the folder to a more convenient location (for instance, your user folder or your Documents folder).
It is also possible to install your own modules, but it is a bit more complicated to do so. In fact, it is not recommended that you do this unless you absolutely have to. For instance, if you have a module that is not found on any repository, you would need to manually install a module. In order to install your own modules, you really need to have a good understanding of your Mac's file structure, and how the Finder works. If you feel uncomfortable following these instructions, it would be best to ask on the Mac-Ministry mailing list for help.
The very first thing you need to do is to quit MacSword if it's running. For the sake of this example, I have downloaded the OSX version of the SBLGNTApp file. When the zip file is unzipped, there are two folders inside the .swd folder. The first is named "mods.d", and the second is named "modules". The mods.d folder contains the configuration file for this module, and must be placed in the folder with the same name within Sword folder mentioned above. The "modules" folder contains a tree of folders. In this case, the structure looks like this: "/modules/comments/zcom/sblgntapp/". Inside that last folder are three files, "nt.bzs", "nt.bzv", and "nt.bzz". What we need to know is this. You need to find the "modules" inside your Sword folder, then find the "comments" folder, and then the "zcom" folder. Inside that folder, you can drop the folder named "sblgntapp". It is possible that you do not have a folder named "zcom" or a folder named "comments". In such a circumstance, it would be easiest to navigate to the last folder you have and copy the remaining folders into that. For instance, if you have a "comments" folder, but no "zcom" folder inside that, copy the "zcom" folder from the sblgntapp.swd folder, into your Sword's "comments" folder. Once all the files are copied, you will want to launch MacSword to see the modules you've installed.