Difference between revisions of "Template:Bibleverse/doc"

From blackwiki
Jump to navigation Jump to search
imported>Jonesey95
(→‎List of versions: add NIV example)
 
(51 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]].}}
{{info|This template is being used for the discussion at [[Wikipedia:Citing sources/Bible]] to show different proposed solutions for the issue of properly citing the Bible.}}
 
  
 
==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'''.
+
==List of versions==
*Verse references may be simplified (for example, no range or entire chapter).
 
  
==List of sources==
+
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>
A list of sources and codes that may be used to trigger them is at the [http://bibref.joelnothman.com/bibref.php Bible Verse Finder].
 
 
 
Here is a sample list (this list is subject to change, please check link above):
 
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]]
 
|-
 
|ASV||8||[[American Standard Version]]
 
|-
 
|CEV||46||[[Contemporary English Version]]
 
|-
 
|DAR||16||[[Darby Translation]]
 
|-
 
|DR||63||[[Douay-Rheims]] 1899 American Edition
 
|-
 
|ESV||47||[[English Standard Version]]
 
|-
 
|GNT||86||[[Good News Translation]]
 
|-
 
|HCSB||77||[[Holman Christian Standard Bible]]
 
 
|-
 
|-
|HE||105||Hebrew-English - parallel [[Masoretic Text|MT]] and old [[JPS Tanakh|JPS 1917]] (Mechon Mamre)
+
|ESV|||[[English Standard Version]] ||| [http://www.esvbible.org ESV.org] ||| {{Bibleverse|John|3:16|ESV}}
 
|-
 
|-
|JP||125||Hebrew-English - parallel [[Masoretic Text|MT]] and modern [[Judaica Press|JP 1964]] Tanakh (Jewish Bible)
+
|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}}
 
|-
 
|-
|JPR||126||Hebrew-English - parallel [[Masoretic Text|MT]] and miodern [[Judaica Press|JP 1964]] Tanakh with [[Rashi]]'s commentary
+
|KJV|||[[King James Version]] ||| [[s:Bible (King James)|Wikisource]] ||| {{Bibleverse|John|3:16|KJV}}
 
|-
 
|-
|KJ21||48||[[21st Century King James Version]]
+
|NIV|||[[New International Version]] ||| [https://www.biblica.com Biblica] ||| {{Bibleverse|John|3:16|NIV}}
 
|-
 
|-
|KJV||9||[[King James Version]]
+
|NRSV|||[[New Revised Standard Version]] ||| [http://bible.oremus.org/ Oremus] ||| {{Bibleverse|John|3:16|NRSV}}
 
|-
 
|-
|TM||65||[[The Message (Bible)|The Message]]
+
|NRSVAE|||[[New Revised Standard Version]], Anglicized Edition ||| [http://bible.oremus.org/ Oremus] ||| {{Bibleverse|John|3:16|NRSVAE}}
 
|-
 
|-
|NASB||49||[[New American Standard Bible]]
+
|NKJV||[[New King James Version]] ||| [https://www.biblegateway.com/ Bible Gateway] ||| {{Bibleverse|Matthew|18:21–22|NKJV}}
|-
 
|NCV||78||[[New Century Version]]
 
|-
 
|NIRV||76||[[New International Reader's Version]]
 
|-
 
|NIV||31||[[New International Version]]
 
|-
 
|NIVUK||64||[[New International Version]] - UK
 
|-
 
|NKJV||50||[[New King James Version]]
 
|-
 
|NLT||51||[[New Living Translation]]
 
|-
 
|NLV||74||[[New Life Version]]
 
|-
 
|TNIV||72||[[Today's New International Version]]
 
|-
 
|WNT||53||[[Wyclif's Bible]]
 
|-
 
|YLT||15||[[Young's Literal Translation]]
 
 
|}
 
|}
  
==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|1:1-4:18|31}} </nowiki> produces a link to the NIV translation (31 in the source list as linked below): {{Bibleverse|1 Samuel|1:1-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 the various Bible editions at www.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. Note: The sources at biblegateway.com are only Christian Bible sources, e.g. a bible source misleadingly labeled ''Orthodox Jewish Bible (OJB)'' is in fact a Christian Messianic Bible translation, which will not be used by Orthodox Judaism.",
+
"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.",
 
"params": {
 
"params": {
 
   "1": {
 
   "1": {
 
     "label": "Book",
 
     "label": "Book",
     "description": "The name of the book. Forms 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 103: 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 109: 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