photokandystudios / greekinterlinearbible

Greek Interlinear Bible for iOS devices (currently iPad)... Under Development

Greek Interlinear Bible

NOTE: THIS PROJECT IS NO LONGER UNDER ACTIVE MAINTENANCE. FOR THE NEW PROJECT, PLEASE VISIT https://github.com/photokandyStudios/gbible

Project code for the Greek Interlinear Bible iOS application. This code is COPYRIGHT (C) 2011-2012 photoKandy Studios LLC. Portions are CC-BY-SA and MIT, and the texts are Public Domain. The icons and graphics are COPYRIGHT their respective owners.

If using to learn PhoneGap, feel free to use this code to "inspire" you, but please, don't copy verbatim the code that is not placed under a CC-BY-SA or MIT license. The following code is licensed under a CC-BY-SA or MIT license:

/www/style/ios.css
/www/style/ipad-landscape.css
/www/style/ipad-portrait.css
/www/style/ipad.css
/www/style/iphone-landscape.css
/www/style/iphone-portrait.css
/www/style/iphone.css
/www/style/glossy-black.css

/www/script/ios.js
/www/script/iscroll-lite.js (modified to support longpress)
/www/script/utility.js

/www/index.html +++
/www/ChildBrowser.js
/www/ICloudPlugin.js
/www/ActionSheet.js (modified to support iPad)
/www/phonegap-1.3.0.js
/www/PhoneGapShim1.js
/www/PhoneGapShim2.js
/www/clipboardPlugin.js

Files marked with +++ have portions of (C) code. These are marked by comments in the text.

Attributions

About the Greek Interlinear Bible v1.0

(C) Copyright 2011- 2012 by Kerri Shotts and photoKandy Studios LLC. Portions of the work are obtained from Public Domain and CC-BY-SA sources.

Application Design

Application Designed by photoKandy Studios LLC in HTML, CSS, and Javascript using the PhoneGap framework. Some code fragments based on the following resources:

• Books of the bible, chapter count, and verse count obtained from http://www.deafmissions.com/tally/bkchptrvrs.html
• BlockMove from http://matt.might.net/articles/how-to-native-iphone-ipad-apps-in-javascript/
• processScriptTags based on http://bytes.com/topic/javascript/answers/513633-innerhtml-script-tag
• AJAX SUPPORT MODIFIED FROM http://www.tek-tips.com/viewthread.cfm?qid=1622697&page=13
• iOS Switches as seen on http://vxjs.org/switch.html, with corresponding code.
• iScroll4, as seen here: http://cubiq.org/iscroll-4 with minor bugfixes.
• Determining offset based on parent offset as here: http://stackoverflow.com/a/5932203
• Button CSS based on http://vxjs.org/CSS3/UI/Back_Next_Buttons.htm
• Click-buster and fast buttons from http://code.google.com/intl/en/mobile/articles/fast_buttons.html
• Force Mobile Safari to repaint: http://mrdarcymurphy.tumblr.com/post/5574489334/force-mobile-safari-to-repaint-redraw
• URL Argument Parsing: http://stackoverflow.com/a/7826782
• Left/Right Swipe Detection: http://rabblerule.blogspot.com/2009/08/detecting-swipe-in-webkit.html

Biblical Texts

Note: All Biblical text sources are found at http://www.unboundbible.com/index.cfm?method=downloads.

The Unbound Bible. Converted from original format to JavaScript notation by Kerri Shotts. Conversion maintains original text, references, and order. Empty verses that appear in some texts have been replaced with "[...]" to make this clear.

Greek NT: Byzantine/Majority Text (2000) The Greek New Testament according to the Byzantine Textform, edited by Maurice A. Robinson and William G. Pierpont, 2000 edition This is the edition by Pierpont and Robinson of a Majority, or Byzantine, text of the NT. It is similar to an earlier production of Hodges and Farstad in being based on von Soden's apparatus, but without their stemmatic reconstruction of the Apocalypse and the Pericope Adulterae.

Greek NT: Tischendorf 8th Ed.The Greek Text corresponds to the printed text found in:

Tischendorf, Constantinus, Novum Testamentum Graece, editio octava critica major Vol. I, 1869; Vol. II 1872, Leipzig:Giesecke and Devrient. Vol 3, Prolegomena, ed. by Caspar Rene' Gregory, Leipzig: Hinrichs, 1894.

The text contains no accents or diacritical marks.

This text was prepared from the Westcott-Hort-Nestle Aland text found in the Greek text prepared by Dr. Maurice Robinson. The text was compared to the printed edition of Tischendorf's. Changes were made in the text to make it correspond to the printed edition. The text was proofed against the Tischendorf text.

According to J. Harold Greenlee "His 'eighth major edition' (1869-72) contains a critical apparatus which has never been equaled in comprehensiveness of citation of Greek mss., versions, and patristic evidence. A century later it is still indispensable for serious work in the text of the N.T."

The Greek text is released as a public domain text.

If any errors are found in this text please let me know as soon as possible.

Clint Yale 1014 West Smith Road #26 Bellingham, WA 98226 360-384-1015 [email protected]

Greek NT: Textus Receptus (1550/1894) The Textus Receptus; base text is Stephens 1550, with variants of Scrivener 1894.

Greek NT: Westcott/Hort, UBS4 variants The Westcott-Hort edition of 1881. Readings of Nestle27/UBS4 shown. {1: Refers to Westcott-Hort} while {2: Refers to Nestle-Aland 27th/UBS4}

English: King James Version Imported from http://ccat.sas.upenn.edu/gopher/text/religion/biblical/ University of Pennsylvania CCAT Biblical text archive. English: Young's Literal TranslationPublic Domain.

Dictionary of Greek Words, taken from Strong's Exhaustive Concordance Authored by James Strong, S.T.D., LL.D., 1890. JSON Version (C) Copyright 2009, Open Scriptures. CC-BY-SA. Derived from XML. The XML version of this work was prepared in 2006 by Ulrik Petersen (http://ulrikp.org) from the ASCII e-text version presented below. The XML version contains "real" UTF-8 Greek where the original ASCII e-text version had transliteration. The XML has a stand-alone DTD which should be easy to follow. Ulrik Petersen welcomes bugfixes to the text. Please send them to the address provided on the website: http://ulrikp.org

greekinterlinearbible's Issues

UI: JavaScript popover appears in notes Ui

Appears when you longpress either SAVE or CANCEL. May be linked to either the contextmenu or stopping event propagation.

Feature: Add Strong's Definition to Popover if LongPressed on G#

This would simplify certain times where one is simply after the Strong's definition of a known G# in the text. This keeps one from having to use "Search Strong's..." continuously and switch between views.

UI: Switches don't feel "native"

Known issue, and difficult to implement in CSS. Thinking about switching these to a check-box toggle, ala Alien Blue's settings screen. Seems like it would simplify the issue?

UI: Add timer to hide splash after given period

The idea here is to ensure that, should anything go wrong in startup, the splash screen will still be hidden, revealing the underlying view. It's entirely possible that if something goes very wrong, this view will be black, but if things go mostly right, it may also be a useable interface long enough to tweak the settings.

10-20s should be sufficient for a timer like this.

BUG: Searching from text often includes punctuation

Need to trim this out of the word before sending to the search function.

UI: Get rid of navigation bar above keyboard

BUG: iCloud Sync may truncate items

UI: In Portrait mode on iPad, some of the bg color is visible when loading Bible

UI: ChildBrowser Icons are half-height on retina displays

BUG: Can't dismiss action sheet from dropdown in settings

The best fix here is either to create our own actionsheet (might be best?) or scroll off onto another page with a radio-like checkbox for each item.

I think I'm voting for the actionsheet here.

UI: Since theme, the animation for expanding the chapters in a book is SLOW

Solution is likely to remove the animation.

BUG: can't remove items when using iCloud

You can try and remove an item from localStorage, but at next load, the items reappear.

BUG: When creating/editing a note, the keyboard doesn't automatically appear

See: http://stackoverflow.com/questions/979309/how-do-i-focus-an-html-text-field-on-an-iphone-causing-the-keyboard-to-come-up

Apparently the focus() command has to be done from a click() handler.

BUG: Canceling an empty note stores "null"

It should, instead, not return anything. Instead this causes a note to be created with the above contents if the user clicks "cancel" and the note is empty.

BUG/UI: The area used to hide the searchbar doesn't fill the container if the content is short

This presents an odd-looking interface. See current implementation of Strong's Lookup for an example.

BUG: Menu navigation button doesn't click on Settings page

The slide-right gesture still works, so I suspect something is actually laying over the button and preventing any events from reaching it. Still -- it needs fixin.

Feature: Add Dictionary Lookup

There's some legacy code that used an online lookup function, but iOS 5 does permit direct access to its internal dictionary. So for the English side, we could provide the internal lookup -- I think. See http://iphonedevelopertips.com/core-services/ios-5-look-up-definitions-using-dictionary-service.html

BUG: Native Scrolling implementation is broken on iPad

Sigh

Due to PG's iframe on the page. May have to come up with some sort of funky work-around? Would rather not go back to iScroll -- native scrolling is /much/ better.

Feature: allow reference navigation using search bar

For example, permit "John 3:16", "John 3", "Mat 13:1", "Mt 13:1", "1 Corinthians 1:1", "1Co 1:1". A couple regular expressions should help determine if it is a reference: [A-Za-z\ ][0-9]+ and [A-Za-z\ ][0-9]+:[0-9]+

BUG: Broken on iOS < 5

Specifically:

• Settings apparently don't work correctly (default settings aren't working either)
• Can't click switches to toggle their state
• Can't expand menu navigation
• Crashes on Define... (expected, due to iOS5+ nature, but needs to provide alternate or eliminate here.)
• iCloud toggle needs to go away since not iOS5

TODO: Decide fate of iCloud support in v1.0

Feature/UI: Implement search functionality via native UITableView

Benefit: faster/better scrolling and we would be able to lose the painful animation. Would need a native view + plugin to support it. If we could layer on /top/ of the UIWebView, it would be ideal -- mainly to preserve the appearance of the interface. But if not, that's more than acceptable.

Feature: Add icons to navbar for quick actions

For example: add some icons to highlight the currently selected verse. Same for bookmark. Same for note.

The problem here isn't the iPad -- there's plenty of space up there -- it's the iPhone. To that end, we've moved the search bar down, but there's still /very/ limited room there. Maybe three icons at the most?

A side-benefit of doing this, however, is we could remove the displayed options from the popover/action-sheet that appears on a long-press. This would especially help on the iPhone where the list is already quite long.