DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:bible

This is an old revision of the document!


bible Plugin

Compatible with DokuWiki

  • 2024-02-06 "Kaos" unknown
  • 2023-04-04 "Jack Jackrum" unknown
  • 2022-07-31 "Igor" unknown
  • 2020-07-29 "Hogfather" yes

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 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.

So how do you deal with stress? What's your coping mechanism? When you feel pressured, what do you do? Do you sleep rather than do what is needed, perhaps as an avoidance tactic? Do you call your best friend and talk it out? Do you go exercise to burn off some energy or distract your mind? Perhaps you have to steal a moment away from everyone and cry a few tears. Do you write in a journal? Do you blog out your experience so others can read it?

Your task is to reflect on stressors in your life and write about your reactions to pressured situations. In a one-to-two page essay, elaborate on the questions and prompts below.

Be sure to address the following questions and prompts in your essay:

What stresses you? Think of three things and describe what makes these situations stressful. How do they make you feel? (anxious, worried, depressed, sleepy, irritable, hyper, avoidant) How do you currently deal with these three situations? Do you react the same way to each? Are your methods of coping with stress effective? Explain why or why not. What do people close to you think of your stressful reactions and coping methods? (Go ask a parent or close friend if you don't know the answer to this question.) How can you improve your reactions and methods of dealing with stress?

Installation

Search and install the plugin using the Extension Manager.

Alternatively, refer to Plugins on how to install plugins manually:

  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)

PHP 7 and above

In the file syntax.php change the folowing lines:

from

  public function render($mode, &$renderer, $data) {

in:

  public function render($mode, $renderer, $data) {


from

public function handle($match, $state, $pos, &$handler){

in

public function handle($match, $state, $pos, $handler){


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.1706799552.txt.gz · Last modified: 2024-02-01 15:59 by 2601:407:c580:e9e0:5dc3:5e5f:7213:f8d5

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki