Difference between revisions of "Template:Bibleverse/doc"

From blackwiki
Jump to navigation Jump to search
(m.e)
imported>Jonesey95
(→‎List of versions: add NIV example)
 
(55 intermediate revisions by 23 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 [//tools.wmflabs.org/bibleversefinder/bibleversefinder.php#srcref tools.wmflabs.org/bibleversefinder/bibleversefinder.php#srcref]
 
 
 
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]]
+
|ESV|||[[English Standard Version]] ||| [http://www.esvbible.org ESV.org] ||| {{Bibleverse|John|3:16|ESV}}
 
|-
 
|-
|ASV||8||[[American Standard Version]]
+
|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}}
 
|-
 
|-
|CEV||46||[[Contemporary English Version]]
+
|KJV|||[[King James Version]] ||| [[s:Bible (King James)|Wikisource]] ||| {{Bibleverse|John|3:16|KJV}}
|-
 
|DAR||16||[[Darby Translation]]
 
|-
 
|DR||63||[[Douay-Rheims]] 1899 American Edition
 
 
|-
 
|-
|ESV||47||[[English Standard Version]]
+
|NIV|||[[New International Version]] ||| [https://www.biblica.com Biblica] ||| {{Bibleverse|John|3:16|NIV}}
|-
 
|GNT||86||[[Good News Translation]]
 
 
|-
 
|-
|HCSB||77||[[Holman Christian Standard Bible]]
+
|NRSV|||[[New Revised Standard Version]] ||| [http://bible.oremus.org/ Oremus] ||| {{Bibleverse|John|3:16|NRSV}}
 
|-
 
|-
|HE||105||Hebrew-English - parallel [[Masoretic Text|MT]] and [[JPS Tanakh|JPS 1917]] (Mechon Mamre)
+
|NRSVAE|||[[New Revised Standard Version]], Anglicized Edition ||| [http://bible.oremus.org/ Oremus] ||| {{Bibleverse|John|3:16|NRSVAE}}
 
|-
 
|-
|KJ21||48||[[21st Century King James Version]]
+
|NKJV||[[New King James Version]] ||| [https://www.biblegateway.com/ Bible Gateway] ||| {{Bibleverse|Matthew|18:21–22|NKJV}}
|-
 
|KJV||9||[[King James Version]]
 
|-
 
|TM||65||[[The Message (Bible)|The Message]]
 
|-
 
|NASB||49||[[New American Standard Bible]]
 
|-
 
|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.",
+
"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 99: 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 105: 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