DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:bible

bible Plugin

Compatible with DokuWiki

unknown

plugin A DokuWiki plugin that recognizes bible verses in prose and converts them to acronyms displaying the verse

Last updated on
2012-10-17
Provides
Syntax
Repository
Source

This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.

Tagged with bible, catholic, christian, religious

This plugin recognizes bible verses (Mark 3:1, Amos 1:4-13) in prose and converts them to the equivalent of HTML <acronym>s which display the verse as the hover-text. That way, if a user hovers over “Mark 3:1,” pop-up text allows him to read about when Jesus first met a Dokuwiki developer: “and he entered again into the synagogue, and there was a man there who had a withered hand.”

While the plugin is verbosely commented for easy modification and expanded bible support, version 1.0 supports only the Douay Rhiems (“old” Catholic)1) translation of the bible.

God Bless!

Installation

  1. Unzip the file
  2. drop the contents into your …/lib/plugins/ directory and upload to your server.
  3. Any existing pages will need to be re-built (no change to the page is required, but rebuilding gives Dokuwiki a chance to re-parse your text

OR

Install the plugin using the Plugin Manager and the download URL above, which points to latest version of the plugin. Refer to Plugins on how to install plugins manually.

Examples/Usage

Simply write valid bible verse addresses in the text body of your page:

====== PlayGround ======
\\
As seen in the bible, Mark 3:1 , He tests his wiki code. Not HTML code.\\
Lets try some more: 1 Machabees 1:1, and maybe Amos 2:2 and how about 2 Peter 1:1; Romans 3:3\\
Good?
\\
Mark 3:3\\
Mark 1:1\\
Mark 2:22-25\\
Amos 1:1-25\\
Mark 3:1-5
\\
Okay, all is good.

Results in a Rendered Page.jpg where hovering over links look like: Hovering Mouse

Syntax

To quote Mark chapter 3, verse one:

Mark 3:1

To quote Mark chapter 3, verse one through 9:

Mark 3:1-9

To quote Second Kings chapter 11 verse 8:

2 Kings 11:8

Configuration and Settings

No custom configurations have been added. But that'd be great. You should add some (bible edition, language?).

Development

syntax.php is the only workhorse file, and is heavily commented for easy modification. It contains all 6 required functions and one custom function of my own at the bottom.

To add new translations of the bible:

  1. create a directory for the bible text files (like “bible_NAB”).
  2. Separate the bible by chapter into separate text files called CHAPTER.txt, using underscores for spaces (like “1_Kings.txt”).
  3. Make sure that each verse of the bible is a separate line that looks like 'CHAPTER#:VERSE#. CONTENT' (like “1:1. In the beginning God created heaven, and earth.”).
  4. Now modify syntax.php to set the variable $validBibleBooksArr to contain the valid books (I use 73 for the Catholic bible, but Protestant bibles have only 66 books).
  5. Modify syntax.php to correct $filename to point to your bible text files instead of “bible_douayRheims/”

Change Log

  • 2012-10-17
    • Initial release

Known Bugs and Issues

Listing a match in the regexp that is an invalid bible verse will cause a warning/error to print out at the top of your page. This is by design, but it might be preferable to just ignore those.

For example:

Genesis 7782:448448

ToDo/Wish List

  • More translations of the bible would be great.
  • Configuration options for choosing the desired translation would be great.

FAQ

Discussion

1)
I'm aware that NAB is the new translation but it is -as of right now- not available for download in text format. If you find it, please upgrade the plugin!
plugin/bible.txt · Last modified: 2014-03-20 14:11 by Aleksandr