<div dir="ltr">Hi Carrie<div><br></div><div>Great that you want to get started with STEP (or look into it). We've got lost of resources on our confluence instance: <a href="https://stepweb.atlassian.net/wiki/spaces/TYNSTEP/pages/3768323/Setting+up+a+development+environment">https://stepweb.atlassian.net/wiki/spaces/TYNSTEP/pages/3768323/Setting+up+a+development+environment</a> It should be pretty comprehensive.</div><div><br></div><div>In brief through, for STEP, you need to do the following:</div><div><br></div><div>git clone git@github.com:tyndale/jsword.git</div><div>cd jsword</div><div>git checkout jsword-tyndale-house (we use a slightly different branch)</div><div>mvn clean install (or mvn clean install -DskipTests)</div><div>cd ..</div><div><br></div><div>git@github.com:tyndale/step.git</div><div>cd step</div><div>mvn clean install (or mvn clean install -DskipTests)</div><div><br></div><div>In terms of how you 'run it', STEP works in a web application, so you need to deploy to something like Tomcat. Alternatively, you can look under step-server - the mvn (maven) command should be building a runnable JAR file.</div><div><br></div><div>Thanks</div><div>Chris</div><div><br></div></div><div class="gmail_extra"><br><div class="gmail_quote">On 6 October 2017 at 07:10, DM Smith <span dir="ltr"><<a href="mailto:dmsmith@crosswire.org" target="_blank">dmsmith@crosswire.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div style="word-wrap:break-word;line-break:after-white-space">Hi Carrie,<div>I was concerned that something was wrong with the code. You only need to check out JSword and Bible Desktop into the same folder and then run ant to build the code. I just did the following and “it just worked”. I’ve got ant and JDK Java 8 installed and on the PATH. I’ve been at JavaOne this week and from what I learned, it probably won’t build under Java 9, because of the new module system (aka Jigsaw). You should be able to use Java 5, 6, 7 or 8 for building it.</div><div><br></div><div>Our fundamental and primary way to build and run is to use ant.</div><div><br></div><div><div>#First create a folder</div><div>mkdir bd</div><div>#Then go into it</div><div>cd bd</div><div>#get the code for JSword</div><div>git clone <a href="https://github.com/crosswire/jsword.git" target="_blank">https://github.com/crosswire/<wbr>jsword.git</a></div><div>#Then go into the root of that checkout</div><div>cd jsword</div><div># And build the code.</div><div># Note: the default target will run all kinds of stuff besides tbe build, such as QA stuff</div><div># Note: this will also get all the third-party dependencies using ivy</div><div>ant build</div><div># Then get BibleDesktop into the same folder as you got JSword</div><div>cd ..</div><div>svn checkout <a href="https://crosswire.org/svn/jsword/trunk/bibledesktop" target="_blank">https://crosswire.org/svn/<wbr>jsword/trunk/bibledesktop</a> bibledesktop</div><div># Go into the root of that checkout, just like we did for JSword</div><div>cd bibledesktop</div><div># Then build it. Like JSword the default target will do more stuff like QA and packaging</div><div>ant build</div><div># Then run the program</div><div>ant exec</div><div><br></div><div>The above should work on Linux or Mac from a terminal window. If you are on Windows you’ll probably have to install ant. And you’ll have to adjust the commands above.</div><div><br></div><div>As far as running it on the command line, bibledesktop/etc/bin/ has BibleDesktop.bat and BibleDesktop.sh will do that if you place all the jars in the proper folder structure. Just copy the appropriate one to bd/jsword/lib/jars. Go into that folder and execute it. For the Mac, I had to set JSWORD_HOME=/usr (which is wrong, but gets Mac to get the right Java.)</div><div><br></div><div>When you do run it from the command line, you’ll get all kinds of diagnostics which normally goes to the console.</div><div><br></div><div>Hope this helps.</div><div><br></div><div>BTW, I use Eclipse for development on a Mac. Others use NetBeans. Some use Maven instead of ant for builds.</div><div><br></div><div>Let us know if you have any other questions.</div><div><br></div><div>In Christ,</div><div><span class="m_-5573681152395990027Apple-tab-span" style="white-space:pre-wrap"> </span>DM Smith</div><div><div class="h5"><div><br></div><div><br></div><div><br><blockquote type="cite"><div>On Oct 5, 2017, at 7:30 PM, Carrie Steggerda <<a href="mailto:carriesteggerda@gmail.com" target="_blank">carriesteggerda@gmail.com</a>> wrote:</div><br class="m_-5573681152395990027Apple-interchange-newline"><div><div dir="ltr"><div><div><div><div><div>Hi,<br><br></div>Thank you for your response. I have tried running the code, as I am interested in being able to actually run the software from the terminal. I was wondering how you guys compile and run it on your end? I've tried compiling it all, but I seem to always get errors, and my professor does as well when she attempts running it.<br></div>Even if we get it to compile, which file is the run file? The closest file I've seen is perhaps running java Desktop.java (located in /trunk/bibledesktop/src/main/<wbr>java/org/crosswire/<wbr>bibledesktop/desktop)<br><br></div>Could you help me with figuring this out?<br></div><div>I'd also be interested where the run file for STEP is - I've looked through the code but can't seem to figure out where/how to run that from the terminal either.<br></div>Thanks!<br></div>Carrie<br></div><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Oct 2, 2017 at 10:26 AM, Sijo Cherian <span dir="ltr"><<a href="mailto:sijo.cherian@gmail.com" target="_blank">sijo.cherian@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">Carrie,<div><br></div><div>Bibledesktop code is not in git mirror , but only in subversion</div><div><br></div><div>see the svn checkout instruction at bottom of <a href="https://www.crosswire.org/jsword/svn.html" target="_blank">https://www.crosswire.org/j<wbr>sword/svn.html</a></div><div><br></div><div>STEP frontend, also uses Jsword. It is built by Tyndale, code is at</div><div><a href="https://github.com/tyndale/step" target="_blank">https://github.com/tyndale/ste<wbr>p</a><br></div><div><br></div><div><br></div><div>/s</div></div><div class="gmail_extra"><br><div class="gmail_quote"><div><div class="m_-5573681152395990027h5">On Sun, Oct 1, 2017 at 2:51 PM, Carrie Steggerda <span dir="ltr"><<a href="mailto:carriesteggerda@gmail.com" target="_blank">carriesteggerda@gmail.com</a>></span> wrote:<br></div></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div><div class="m_-5573681152395990027h5"><div dir="ltr">Hi DM,<div><br></div><div>Thanks for the info. Where can I find the code for the BibleDesktop code in Swing? (or what is the name for it?) The only swing file I can find is jsword-1.6 called "jsword-common-swing-1.6.jar" and I can't seem to run that file. I'd love to be able to play around with the graphical interface and see the code behind it.</div><div><br></div><div>Thanks,</div><div>Carrie</div></div><div class="m_-5573681152395990027m_1366621766698441686HOEnZb"><div class="m_-5573681152395990027m_1366621766698441686h5"><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Sep 28, 2017 at 7:54 PM, DM Smith <span dir="ltr"><<a href="mailto:dmsmith@crosswire.org" target="_blank">dmsmith@crosswire.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div style="word-wrap:break-word;line-break:after-white-space">Carrie,<div><br></div><div>Welcome!</div><div><br></div><div>I’ve added you to the jsword-devel mailing list. The password is mailed in clear text on the first of every month. So don’t using one that is important.</div><div><br></div><div>JSword is located at GitHub and BibleDesktop is hosted at CrossWire using SVN.</div><div><br></div><div>I use Eclipse to develop. Others use NetBeans or some other IDE. We’ve got Maven integration, which I don’t use, so I can’t vouch for it. Chris Burrell set that up. We do a nightly build on the CrossWire servers and run automated tests.</div><div><br></div><div>The BibleDesktop code is in Swing. It’d be great to replace the browser component with JavaFX. Perhaps more.</div><div><br></div><div>Also consider STEP from Tyndale. This is another frontend, more recent, that uses an embedded webserver to serve Books aka modules.</div><div><br></div><div>Start at <a href="http://www.crosswire.org/jsword" target="_blank">www.crosswire.org/jsword</a> for more dev info.</div><div><br></div><div>In His Service,</div><div><span class="m_-5573681152395990027m_1366621766698441686m_5053324610973322595m_4457967807315477502Apple-tab-span" style="white-space:pre-wrap"> </span>DM Smith</div><div><br></div><div><br><div><br><blockquote type="cite"><div><div class="m_-5573681152395990027m_1366621766698441686m_5053324610973322595h5"><div>On Sep 28, 2017, at 12:50 PM, Carrie Steggerda <<a href="mailto:carriesteggerda@gmail.com" target="_blank">carriesteggerda@gmail.com</a>> wrote:</div><br class="m_-5573681152395990027m_1366621766698441686m_5053324610973322595m_4457967807315477502Apple-interchange-newline"></div></div><div><div><div class="m_-5573681152395990027m_1366621766698441686m_5053324610973322595h5"><div dir="ltr">Hi,<div><br></div><div>I am a computer science student currently learning about open source software, and have picked JSword as my class project to study on and contribute to. I'd like to subscribe to the mailing list for JSword Developers, and was wondering if I could get some more information on how the development for JSword works. I was wondering what system you use to run your nightly builds, and if you pull the code you have and test it every night, (or exactly how often you run nightly builds). I am also looking at the interface for BibleDesktop, and am wondering if you provide the code for the graphical interface, and where I could find it. I'd be interested in experimenting with the GUI code.</div><div><br></div><div>Thanks!</div><div>Carrie Steggerda</div></div></div></div>
______________________________<wbr>_________________<br>sword-support mailing list<br><a href="mailto:sword-support@crosswire.org" target="_blank">sword-support@crosswire.org</a><br></div></blockquote></div><br></div></div></blockquote></div><br></div>
</div></div><br></div></div>______________________________<wbr>_________________<br>
jsword-devel mailing list<br>
<a href="mailto:jsword-devel@crosswire.org" target="_blank">jsword-devel@crosswire.org</a><br>
<a href="http://www.crosswire.org/mailman/listinfo/jsword-devel" rel="noreferrer" target="_blank">http://www.crosswire.org/mailm<wbr>an/listinfo/jsword-devel</a><br>
<br></blockquote></div><span class="m_-5573681152395990027HOEnZb"><font color="#888888"><br><br clear="all"><div><br></div>-- <br><div class="m_-5573681152395990027m_1366621766698441686gmail_signature" data-smartmail="gmail_signature">Regards,<br>Sijo</div>
</font></span></div>
<br>______________________________<wbr>_________________<br>
jsword-devel mailing list<br>
<a href="mailto:jsword-devel@crosswire.org" target="_blank">jsword-devel@crosswire.org</a><br>
<a href="http://www.crosswire.org/mailman/listinfo/jsword-devel" rel="noreferrer" target="_blank">http://www.crosswire.org/mailm<wbr>an/listinfo/jsword-devel</a><br>
<br></blockquote></div><br></div>
______________________________<wbr>_________________<br>jsword-devel mailing list<br><a href="mailto:jsword-devel@crosswire.org" target="_blank">jsword-devel@crosswire.org</a><br><a href="http://www.crosswire.org/mailman/listinfo/jsword-devel" target="_blank">http://www.crosswire.org/<wbr>mailman/listinfo/jsword-devel</a><br></div></blockquote></div><br></div></div></div></div><br>______________________________<wbr>_________________<br>
jsword-devel mailing list<br>
<a href="mailto:jsword-devel@crosswire.org">jsword-devel@crosswire.org</a><br>
<a href="http://www.crosswire.org/mailman/listinfo/jsword-devel" rel="noreferrer" target="_blank">http://www.crosswire.org/<wbr>mailman/listinfo/jsword-devel</a><br>
<br></blockquote></div><br></div>