Difference between revisions of "Template:Bibleverse/doc"

From blackwiki
Jump to navigation Jump to search
imported>Little Mountain 5
(rm now optional "Book#" parameter)
imported>Jonesey95
(→‎List of versions: add NIV example)
 
(57 intermediate revisions by 24 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==
Code format:
+
This template is used to provide sources for [[Bible citation|Bible verse references]].
:<font color="red">(</font><code><nowiki>{{Bibleverse|BOOK|c:v&ndash;c:v|SOURCE}}</nowiki></code><font color="red">)</font></pre>
 
  
:<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.)
+
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.
  
;Example: <code><nowiki>{{Bibleverse|John|3:16|KJV}}</nowiki></code> yields: {{Bibleverse|John|3:16|KJV}}
+
Code format:
 +
:{{tlc|Bibleverse|Bible book name|c:v&ndash;c:v|version}}
  
In text, with parentheses, this looks like this ({{Bibleverse|John|3:16|KJV}}).
+
;Example: <code><nowiki>{{Bibleverse|Genesis|1:1|KJV}}</nowiki></code> yields: {{Bibleverse|Genesis|1:1|KJV}}
  
; Detail
+
* 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.
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.  
+
* Verse references may be simplified (for example, no range or entire chapter).
  
*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):
+
{|class="wikitable sortable"
{| class="wikitable"
+
!Code
! Code !! Translation
+
!Version
 +
!External site
 +
!Example usage
 
|-
 
|-
| colspan = 2 | ''(do not include or, just number or text)''
+
|ESV|||[[English Standard Version]] ||| [http://www.esvbible.org ESV.org] ||| {{Bibleverse|John|3:16|ESV}}
 
|-
 
|-
| 1000 || Show user all options
+
|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}}
 
|-
 
|-
| 31 or NIV || New International Version (BibleGateway)
+
|KJV|||[[King James Version]] ||| [[s:Bible (King James)|Wikisource]] ||| {{Bibleverse|John|3:16|KJV}}
 
|-
 
|-
| 49 or NASB || New American Standard Bible (BibleGateway)
+
|NIV|||[[New International Version]] ||| [https://www.biblica.com Biblica] ||| {{Bibleverse|John|3:16|NIV}}
 
|-
 
|-
| 9 or KJV || King James Version (BibleGateway)
+
|NRSV|||[[New Revised Standard Version]] ||| [http://bible.oremus.org/ Oremus] ||| {{Bibleverse|John|3:16|NRSV}}
 
|-
 
|-
| 105 or HE || Hebrew-English - parallel MT and JPS 1917 (Mechon Mamre)
+
|NRSVAE|||[[New Revised Standard Version]], Anglicized Edition ||| [http://bible.oremus.org/ Oremus] ||| {{Bibleverse|John|3:16|NRSVAE}}
 
|-
 
|-
| 65 or TM || The Message (BibleGateway)
+
|NKJV||[[New King James Version]] ||| [https://www.biblegateway.com/ Bible Gateway] ||| {{Bibleverse|Matthew|18:21–22|NKJV}}
 
|}
 
|}
  
==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 (31 in the source list as linked below): {{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}}
 
  
 +
==Redirects==
 +
* {{t|Niv}}
 +
* {{t|Nasb}}
 +
* {{t|Esv}}
 +
* {{t|Nkjv}}
 +
* {{t|Bverse}}
 +
* {{t|Bibleref}}
 +
* {{t|Bible}}
 +
* {{t|KJV}}
 +
* {{t|Cite bible}}
 +
* {{t|Rsv}}
 +
* {{t|Tanakhverse}}
  
==Template data==
+
==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 64: 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 70: 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||
  
 
+
<!-- Categories below this line, please; interwikis at Wikidata -->
<includeonly>
 
<!-- 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