Difference between revisions of "Template:Bibleverse/doc"

From blackwiki
Jump to navigation Jump to search
imported>Telpardec
(restored wmflabs link - removed IP editorial - updated short list - copyedit - some versions link to other sites than biblegateway)
imported>Jonesey95
(→‎List of versions: add NIV example)
 
(50 intermediate revisions by 21 users not shown)
Line 1: Line 1:
 
{{Documentation subpage}}
 
{{Documentation subpage}}
<!--
+
<!-- Place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
    PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE
+
{{Lua|Module:Bibleverse}}
-->
+
{{Notice |heading=Usage of this template inline in the body of an article is discouraged |This template creates an external link. The [[WP:external links|external links content guideline]] states that "external links should not normally be used in the body of an article". Place external links to the Bible in [[WP:parenthetical citations| parenthetical citations]] or [[WP:footnotes|footnotes]].}}
  
 
==Usage==
 
==Usage==
 +
This template is used to provide sources for [[Bible citation|Bible verse references]].
 +
 +
This template creates an external link. The [[WP:external links|external links content guideline]] states that "external links should not normally be used in the body of an article". '''Place external links to the Bible in [[WP: parenthetical citations| parenthetical citations]] or [[WP:footnotes|footnotes]],''' but be aware that the Bible may be considered a [[WP:primary source|primary source]], which should be used with care in sourcing Wikipedia articles.
 +
 
Code format:
 
Code format:
:<font color="red">(</font>{{tlc|Bibleverse|BOOK|c:v&ndash;c:v|SOURCE (optional)}}<font color="red">)</font>
+
:{{tlc|Bibleverse|Bible book name|c:v&ndash;c:v|version}}
 
 
:<font color="crimson"> Note parentheses:</font> (See [[WP:EL]]). Inline external links (this template links offsite) '''must be separated''' from the article text by parentheses. (Parentheses are deliberately not included in this template to allow for flexible usage.)
 
  
 
;Example: <code><nowiki>{{Bibleverse|Genesis|1:1|KJV}}</nowiki></code> yields: {{Bibleverse|Genesis|1:1|KJV}}
 
;Example: <code><nowiki>{{Bibleverse|Genesis|1:1|KJV}}</nowiki></code> yields: {{Bibleverse|Genesis|1:1|KJV}}
  
In text, with parentheses, this looks like this ({{Bibleverse|Genesis|1:1|KJV}}).
+
* Shorthand can be used for the names, such as '''1 Sam''' or '''Deut'''. See the ''[http://hbl.gcc.libguides.com/BibleAbbrevChicago Chicago Manual of Style]'' for other acceptable abbreviations.
 
+
* Verse references may be simplified (for example, no range or entire chapter).
; Detail
 
This template is used to provide sources for Bible verse references. See the [[Template talk:Bibleverse|talk page]] for more usages, examples and source codes.
 
 
 
*You can use shorthand for the names, such as '''Sam''' or '''Deut'''.
 
*Verse references may be simplified (for example, no range or entire chapter).
 
*Use a hyphen, not a dash, to separate ranges. The dash does not work in all operating system and browser combinations.
 
  
==List of sources==
+
==List of versions==
A list of sources and codes that may be used to trigger them is at [//tools.wmflabs.org/bibleversefinder/bibleversefinder.php#srcref Bible Verse Finder]
 
  
Here is a sample list (this list is subject to change, please check link above):
+
The following is a partial list of available Bible versions and the external sites used by the template to link them. The default version is the [[New Revised Standard Version]] because it is most commonly preferred by biblical scholars:<ref>[https://web.archive.org/web/20161012024005/http://courses.missouristate.edu/markgiven/rel102/bt.htm A Discussion of Bible Translations and Biblical Scholarship]</ref>
Use either letter abbreviations in caps or the numerical value.  
 
  
 
{|class="wikitable sortable"
 
{|class="wikitable sortable"
 
!Code
 
!Code
!Number
+
!Version
!Title
+
!External site
|-
+
!Example usage
|AB||45||[[Amplified Bible]] (Bible Gateway)
 
|-
 
|ASV||8||[[American Standard Version]] (Bible Gateway)
 
|-
 
|BBC||122||BibleCommenter.com (BibleHub commentaries)
 
|-
 
|DAR||16||[[Darby Translation]] (Bible Gateway)
 
|-
 
|||63||[[Douay-Rheims]] 1899 American Edition (Bible Gateway)
 
|-
 
|ESV||47||[[English Standard Version]] (Bible Gateway)
 
|-
 
|HCSB||77||[[Holman Christian Standard Bible]] (Bible Gateway)
 
|-
 
|HE||105||Hebrew-English - parallel [[Masoretic Text|MT]] and [[JPS Tanakh|JPS 1917]] (Mechon Mamre)
 
|-
 
|JP||125||Hebrew-English - parallel [[Masoretic Text|MT]] and [[Judaica Press|JP 1964]] Tanakh (Jewish Bible)
 
|-
 
|JPR||126||Hebrew-English - parallel [[Masoretic Text|MT]] and [[Judaica Press|JP 1964]] with [[Rashi]]'s commentary
 
|-
 
|KJ21||48||[[21st Century King James Version]] (Bible Gateway)
 
|-
 
|KJV||9||[[King James Version]] (Bible Gateway)
 
|-
 
|TM||65||[[The Message (Bible)|The Message]] (Bible Gateway)
 
 
|-
 
|-
|NAB||130||[[New American Bible]] (USCCB)
+
|ESV|||[[English Standard Version]] ||| [http://www.esvbible.org ESV.org] ||| {{Bibleverse|John|3:16|ESV}}
 
|-
 
|-
|NASB||49||[[New American Standard Bible]] (Bible Gateway)
+
|HE|||Hebrew-English—parallel [[Masoretic Text|MT]] and [[Jewish Publication Society of America Version|JPS 1917]] ||| [http://www.mechon-mamre.org/p/pt/pt0.htm Mechon Mamre] ||| {{Bibleverse|Genesis|1:1|HE}}
 
|-
 
|-
|NIV||31||[[New International Version]] (Bible Gateway)
+
|KJV|||[[King James Version]] ||| [[s:Bible (King James)|Wikisource]] ||| {{Bibleverse|John|3:16|KJV}}
 
|-
 
|-
|NKJV||50||[[New King James Version]] (Bible Gateway)
+
|NIV|||[[New International Version]] ||| [https://www.biblica.com Biblica] ||| {{Bibleverse|John|3:16|NIV}}
 
|-
 
|-
|NLT||51||[[New Living Translation]] (Bible Gateway)
+
|NRSV|||[[New Revised Standard Version]] ||| [http://bible.oremus.org/ Oremus] ||| {{Bibleverse|John|3:16|NRSV}}
 
|-
 
|-
|NRSV||131||[[New Revised Standard Version]] (Oremus)
+
|NRSVAE|||[[New Revised Standard Version]], Anglicized Edition ||| [http://bible.oremus.org/ Oremus] ||| {{Bibleverse|John|3:16|NRSVAE}}
 
|-
 
|-
|WNT||53||[[Wyclif's Bible|Wycliffe New Testament]] (Bible Gateway)
+
|NKJV||[[New King James Version]] ||| [https://www.biblegateway.com/ Bible Gateway] ||| {{Bibleverse|Matthew|18:21–22|NKJV}}
|-
 
|YLT||15||[[Young's Literal Translation]] (Bible Gateway)
 
 
|}
 
|}
  
==Alternative version==
+
=={{anchor|Alternative usage}} Alternative version==
An alternative version of this template is available that does not include the book name: [[Template:Bibleverse-nb]]. It can be used to create lists of verses, e.g. <nowiki> [[Book of Exodus|Exodus]] {{Bibleverse-nb||Exodus|1:2-3|HE}}; {{Bibleverse-nb||Exodus|13:10|HE}} </nowiki>
+
<!-- an edit summary links to this section anchor -->
:produces: [[Book of Exodus|Exodus]] {{Bibleverse-nb||Exodus|1:2-3|HE}}; {{Bibleverse-nb||Exodus|13:10|HE}}
+
An alternative version of this template is available that does not include the book name: [[Template:Bibleverse-nb]]. It can be used to create lists of verses, e.g. <code><nowiki> [[Book of Exodus|Exodus]] {{Bibleverse-nb||Exodus|1:2–3|HE}}; {{Bibleverse-nb||Exodus|13:10|HE}} </nowiki></code> produces: [[Book of Exodus|Exodus]] <span class=plainlinks>{{Bibleverse-nb||Exodus|1:2–3|HE}}; {{Bibleverse-nb||Exodus|13:10|HE}}</span>
  
 
==Examples==
 
==Examples==
*Example1: <nowiki> {{Bibleverse|1 Samuel|3:16-4:18|31}} </nowiki> produces a link to the NIV translation (source #31): {{Bibleverse|1 Samuel|3:16-4:18|31}}
+
*Example: <nowiki> {{Bibleverse|Genesis|1:15–16|HE}} </nowiki> produces: {{Bibleverse|Genesis|1:15–16|HE}}
*Example2:  <nowiki> {{Bibleverse|Genesis|1:15-16|HE}} </nowiki> produces: {{Bibleverse|Genesis|1:15-16|HE}}
 
  
==Template data==
+
==Redirects==
 +
* {{t|Niv}}
 +
* {{t|Nasb}}
 +
* {{t|Esv}}
 +
* {{t|Nkjv}}
 +
* {{t|Bverse}}
 +
* {{t|Bibleref}}
 +
* {{t|Bible}}
 +
* {{t|KJV}}
 +
* {{t|Cite bible}}
 +
* {{t|Rsv}}
 +
* {{t|Tanakhverse}}
 +
 
 +
==References==
 +
{{reflist}}
 +
 
 +
==TemplateData==
 +
{{TemplateData header}}
 
<templatedata>{
 
<templatedata>{
 
"description": "A template to generate a link to selected Bible editions at several sites including biblegateway.com. This template will create a link with the name of the book and specified chapter and verse, or range of chapters and verses, or just an entire chapter. Use Bibleverse-nb to create a link without the book name in the anchor text of the link.",
 
"description": "A template to generate a link to selected Bible editions at several sites including biblegateway.com. This template will create a link with the name of the book and specified chapter and verse, or range of chapters and verses, or just an entire chapter. Use Bibleverse-nb to create a link without the book name in the anchor text of the link.",
Line 89: Line 72:
 
   "1": {
 
   "1": {
 
     "label": "Book",
 
     "label": "Book",
     "description": "The name of the book. Formats are listed at tools.wmflabs.org/bibleversefinder/biblebooks_bibleref.txt",
+
     "description": "The name of the book.",
 
     "type": "string",
 
     "type": "string",
 
     "required": true
 
     "required": true
Line 95: Line 78:
 
   "2": {
 
   "2": {
 
     "label": "Chapter:verse",
 
     "label": "Chapter:verse",
     "description": "The chapter and verse to be cited. Also, the range to be cited, or just the chapter. For example: '5:4', '1:1-2', '21:1-24:7' or '6'. Do not include any spaces.",
+
     "description": "The chapter and verse to be cited. Also, the range to be cited, or just the chapter. For example: '5:4', '1:1–2', '21:1–24:7' or '6'. Do not include any spaces.",
 
     "type": "string",
 
     "type": "string",
 
     "required": true
 
     "required": true
Line 101: Line 84:
 
   "3": {
 
   "3": {
 
     "label": "Source",
 
     "label": "Source",
     "description": "The edition to be cited. Leave blank to generate a list of links to all available editions.  Given in common abbreviations (e.g., 'KJV', 'NIV') or according to the numbers or abbreviations listed at tools.wmflabs.org/bibleversefinder/bibleversefinder.php#srcref",
+
     "description": "The edition to be cited. Given in common abbreviations (e.g., 'KJV', 'NIV', 'HE', 'ESV', 'NRSVAE'). Default is 'NRSV'.",
 
     "type": "string",
 
     "type": "string",
 
     "required": false
 
     "required": false
 
   }
 
   }
}}</templatedata>
+
}}</templatedata><includeonly>{{Sandbox other||
  
<includeonly>
+
<!-- Categories below this line, please; interwikis at Wikidata -->
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
 
 
[[Category:Bible external link templates]]
 
[[Category:Bible external link templates]]
 
+
}}</includeonly>
</includeonly>
 

Latest revision as of 16:46, 28 August 2020

Usage

This template is used to provide sources for Bible verse references.

This template creates an external link. The external links content guideline states that "external links should not normally be used in the body of an article". Place external links to the Bible in parenthetical citations or footnotes, but be aware that the Bible may be considered a primary source, which should be used with care in sourcing Wikipedia articles.

Code format:

{{Bibleverse|Bible book name|c:v–c:v|version}}
Example
{{Bibleverse|Genesis|1:1|KJV}} yields: Genesis 1:1
  • Shorthand can be used for the names, such as 1 Sam or Deut. See the Chicago Manual of Style for other acceptable abbreviations.
  • Verse references may be simplified (for example, no range or entire chapter).

List of versions

The following is a partial list of available Bible versions and the external sites used by the template to link them. The default version is the New Revised Standard Version because it is most commonly preferred by biblical scholars:[1]

Code Version External site Example usage
ESV English Standard Version ESV.org John 3:16
HE Hebrew-English—parallel MT and JPS 1917 Mechon Mamre Genesis 1:1
KJV King James Version Wikisource John 3:16
NIV New International Version Biblica John 3:16
NRSV New Revised Standard Version Oremus John 3:16
NRSVAE New Revised Standard Version, Anglicized Edition Oremus John 3:16
NKJV New King James Version Bible Gateway Matthew 18:21–22

Alternative version

An alternative version of this template is available that does not include the book name: Template:Bibleverse-nb. It can be used to create lists of verses, e.g. [[Book of Exodus|Exodus]] {{Bibleverse-nb||Exodus|1:2–3|HE}}; {{Bibleverse-nb||Exodus|13:10|HE}} produces: Exodus 1:2–3; 13:10

Examples

Redirects

References

TemplateData

This is the TemplateData documentation for this template used by VisualEditor and other tools; see the monthly parameter usage report for this template.

TemplateData for Bibleverse

A template to generate a link to selected Bible editions at several sites including biblegateway.com. This template will create a link with the name of the book and specified chapter and verse, or range of chapters and verses, or just an entire chapter. Use Bibleverse-nb to create a link without the book name in the anchor text of the link.

Template parameters

ParameterDescriptionTypeStatus
Book1

The name of the book.

Stringrequired
Chapter:verse2

The chapter and verse to be cited. Also, the range to be cited, or just the chapter. For example: '5:4', '1:1–2', '21:1–24:7' or '6'. Do not include any spaces.

Stringrequired
Source3

The edition to be cited. Given in common abbreviations (e.g., 'KJV', 'NIV', 'HE', 'ESV', 'NRSVAE'). Default is 'NRSV'.

Stringoptional