Source Code Access

We are currently in the process of migrating our code from Subversion (SVN) to git. JSword currently is managed with git and the rest is managed with SVN.

The git root is currently hosted at Github:
https://github.com/crosswire/jsword.git
Anyone can access the code without a password and can be browsed at this url.
Our development is done in trunk and each release is tagged under tags. We will use branches for release maintenance.

The SVN root is:
https://crosswire.org/svn/jsword
Anyone can access the code without a password and can be browsed at this url.
Our development is done in trunk and each release is tagged under tags. We have not used branches for development.

We have broken up JSword into subprojects. These are:

1. jsword - Consists of two parts:
   • org.crosswire.common - This is a base, general purpose set of common utilities
   • org.crosswire.jsword - the core Sword api. Its basic provisions are:
     • Read Sword modules, extracting passages as requested.
     • Convert passages in Sword Modules into OSIS.
     • Run xslt on OSIS.
     • Build Lucene indexes for a Sword Modules.
     • and ....
2. bibledesktop - Consists of two parts:
   • org.crosswire.bibledesktop - A GUI that exposes JSword functionality.
   • org.crosswire.common.swing - Like org.crosswire.common but specific to swing.
3. jsword-web - The code and html for the JSword website. This project also contains the ant build.xml file that is used for nightly builds.
4. bibledesktop-web - The code and html for the BibleDesktop website.
5. jsword-limbo - Code that we could not part with. It is either code that we no longer use or code that we were thinking of using.
6. biblemapper - Provides an analytical view of a Bible. Currently this is not used.

To get started you will need the first project, and to do BibleDesktop development you also need the bibledesktop project. For the jsword project do a git clone using the following form:
git clone https://github.com/crosswire/jsword.git.

For each of the other subprojects you wish to use, cd to the directory you wish to check out and then do a SVN checkout following this form:
For the bibledesktop project, so if you are using the command line you would
svn checkout https://crosswire.org/svn/jsword/trunk/bibledesktop bibledesktop.

For detailed instruction on how to use Eclipse as a git/SVN client see: Using Eclipse with JSword