Giter Club home page Giter Club logo

blinx's Introduction

Blinx

Blinx is a Microsoft Word (for Windows) add-in that converts Bible references within Word into Bible links: Have a look at this example Word document or even this pdf. These Blinks contain the passage (stored as an endnote in the Word document), which becomes visible as a tooltip when the mouse pointer is hovering over it. They are also hyperlinks to an online Bible ("ctrl-left click" on the link). On computers where the Blinx add-on and BibleWorks are installed, a "right-click" on the link opens it directly in BibleWorks.

The following screencast demonstrates the main features of the add-in:

Blinx demo

Requirements1

  • Windows (Windows XP+)
  • Microsoft Word (2003+)
  • Internet Explorer 8+ with an active internet connection or alternatively BibleWorks (7+) or Logos (4+).

Installation

Usage

  • Important: The execution of Blinx can always be interrupted by pressing "Ctrl-Break"
  • The add-in contains 5 functions that can either be accessed through the Blinx toolbar (in the Add-Ins tab in Word 2007+) or through keyboard shortcuts:
    • Create Blink icon Create Blink (Alt-B): Converts all Bible references within the selection or the closest one to the left of the cursor into a pure Bible link without passage.
    • Create Blink & tooltip icon Create Blink & tooltip (Alt-B): Converts all Bible references within the selection or the closest one to the left of the cursor into a Bible link with the passage as tooltip.
    • Create Blink & insert text icon Create Blink & insert text (Alt-Shift-B): Converts all Bible references within the selection or the closest one to the left of the cursor into a Bible link and inserts the passage into the text.
    • Unlink Blinks and hyperlinks icon Unlink Blinks and hyperlinks (Alt-U): Converts all Blinks or hyperlinks within the selection or the closest one to the left of the cursor into normal text.
    • Open Blinx options dialog icon Open Blinx options dialog (Ctrl-Alt-Shift-B):
      • Language of Bible references: English, German - Bible translation: ESV, NIV, NASB, KJV, ...
      • Online Bible for hyperlinks
      • Length of passage tooltips
      • Reset Blinx (which can solve a few issues)
      • Abbreviations for all Bible books, which can be edited with a double-click.2
  • If a text is selected that contains Bible reference hyperlinks from a Logos export and BibleWorks resource, these will be converted too.

Copyright

  • The current version of Blinx obtains Bible passages either from BibleWorks or Logos (if installed) or otherwise from www.biblegateway.com for this initial proof of concept.
  • All modern Bible versions are copyrighted. See www.biblegateway.com/versions for copyright regulations of various Bible versions. For extensive quotes in a publication (usually if over 200 verses or more than 10% of a biblical book), a permission in writing needs to be obtained from the appropriate copyright owner.
  • Copyright notices will need to be added manually, especially if the document is to be shared.

Limitiations & known issues

  • The support for Logos is experimental. The "Copy Bible Verses" settings from within Logos are used automatically to determine the Bible version and format. The Bible version in Blinx should then be selected to match this one. And the Logos format is not yet preserved on insert.
  • It is not yet possible to choose the app that should be used. BibleWorks will be checked first and, if not present, Logos and, if not present either, BibleGateway via Internet Explorer.
  • The reference links contain a special Unicode space between the book name and the chapter number. If it is not displayed as a space, choose an appropriate font (e.g. Times New Roman, Arial, Tahoma, Calibri ...)
  • A bug in BibleWorks means that every creation of a Blink will reset the display versions to what they were at the start-up of BibleWorks. If you restart (or just close) BibleWorks, the current display versions will be the new default versions for every following Blink creation.
  • Running Blinx might reset some formatting options of a previous search/replace in Word.
  • The initial start-up of BibleWorks, Logos or Internet Explorer (hidden) can take up to 20 sec on slower computers.
  • BibleGateway limits passage lookups to about 5500 words.
  • Further issues are mentioned in Issues.doc.

Let me know about bugs or improvements that would be useful at https://github.com/renehamburger/blinx/issues.

Roadmap

  • For the present Word add-on, there are 2 remaining objectives:
  • A complete redesign of the core functionality of the plugin into a cross-platform library that could also be made available through a public API would be desirable. See blinx-core for an initial proof of concept.
  • A plugin system could be used to add any data source for retrieving Scripture passages (e.g., BibleWorks, Logos, theWord, free online Bibles & Bible APIs).
  • Custom add-ons for Word, Open Office Writer, Adobe Acrobat, Google Docs could then be added to creating Bible links on the fly.
  • (The example pdf linked above was generated with an alpha version of such an Adobe Acrobat plugin.)
  • I'm looking for other developers to join the project before embarking on it.

[1] The add-in should also work with some earlier versions of these applications.

[2] Blinx will only recognize the abbreviations in this list (allowing for variations like Roman numerals instead of 1/2/3 before book names, additional full stops, additional or fewer spaces…) Chapter-verse separator can be either ":" or ".".  The book name must be separated from the rest of the reference by at least 1 space or 1 full stop (e.g. "Jn 3:16" or "Jn.3:16").

blinx's People

Contributors

rene-leanix avatar renehamburger avatar deanwiles avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.