References: Difference between revisions

Jump to navigation Jump to search
No edit summary
No edit summary
(46 intermediate revisions by 11 users not shown)
Line 1: Line 1:
__NOTOC__
==Introduction==
A reference or footnote is a note placed at the bottom of a page of a document to comment on a part of the main text, or to provide a reference for it, or both. The connection between the relevant text and its footnote is indicated by a number which appears both after the relevant text and before the footnote.


Footnotes are sometimes useful for relevant text that would distract from the main point if embedded in the main text, yet are helpful in explaining a point in greater detail. Footnotes are also often used to cite references that are relevant to a text. Citation of sources is '''required by WikiDoc'''.
<ref name="MesaSabbagh2018">{{cite journal|last1=Mesa|first1=Juan Simon Rico|last2=Sabbagh|first2=Abdallah El|last3=Luis|first3=Sushil|title=EARLY CORONARY ARTERY DISEASE IN A YOUNG MALE WITH HEPATIC CIRRHOSIS|journal=Journal of the American College of Cardiology|volume=71|issue=11|year=2018|pages=A2191|issn=07351097|doi=10.1016/S0735-1097(18)32732-3}}</ref>


==Preferred method of adding references==
{{CMG}}
One goal of WikiDoc is to create reference lists that allow you to click on the PubMed ID number at the end of the reference and go to the primary article itself. This greatly facilitates locating references.  Therefore, the preferred method of citing references includes a method by which not only the article is cited, but also the PubMed ID number.
 
==Overview==
WikiDoc has a reference manager that allows users to insert references based upon their PubMed ID number.  If you move the text, the reference moves with it!  All the references are automatically inserted at the bottom.  You click on the reference and you go to the article.  It is simple!
 
==Where do I type in the references?==
Usually you would type a number in the text like this (1) or this <sup>1</sup> which refers to a reference you would like to cite. You would then type in the reference at the end of the article. '''This is not the preferred method in WikiDoc.'''
 
WikiDoc features an automated reference manager. The advantages of this reference manager are that:
:#The references are numbered automatically!
:#When you move the text, the reference moves with it!
:#You can click on the reference and go directly to the article!
 
Unlike the usual format where you type in the references at the end of the article, when you use the WikiDoc reference manager, you insert code for the reference right after the material you want to add a reference to. You use a software program to add in the references. The next section describes how to use the software program.
 
==Using the WikiDoc reference manager==
One goal of WikiDoc is to create reference lists that allow you to click on the PubMed ID number at the end of the reference and go to the primary article itself. This greatly facilitates locating references.  Therefore, the preferred method of citing references includes the use of a reference manager that uses the PubMed ID number to create the reference.  The reference manager uses not only PubMed IDs but also DrugBank ID, HGNC ID, ISBN, PubMed ID, PubMed Central ID, PubChem ID, or URLs.


The preferred method for inserting a reference is as follows:
The preferred method for inserting a reference is as follows:


#Use PubMed to locate the article you are interested in [http://www.ncbi.nlm.nih.gov/pubmed/ by clicking here]  
'''Step 1:''' Use PubMed to locate the article you are interested in [http://www.ncbi.nlm.nih.gov/pubmed/ by clicking here]
#Copy the PubMed ID number from the article. The word PubMed ID is often abbreviated PMID and this number is located at the bottom of the abstract.  You can use the search function on Firefox or Internet explorer to locate the word PMID and the number will follow this abbreviation.  It will look something like this:
'''Step 2:''' Copy the PubMed ID number from the article. The word PubMed ID is often abbreviated PMID and this number is located at the bottom of the abstract.  You can use the search function on Firefox or Internet explorer to locate the word PMID and the number will follow this abbreviation.  It will look something like this:
 
<nowiki>PMID: 19032997</nowiki>
<nowiki>PMID: 19032997</nowiki>
#Paste the PubMed ID number (PMID) into a software program that creates the reference you are going to paste into the text of your article. You can access software for converting a pubmed ID number into a reference [http://diberri.dyndns.org/cgi-bin/templatefiller/?type=&id= by clicking here]
#Make sure the button that says ref tag is checked in the software program.
#Copy the output from the software programs. For example, the output for the PMID above (19032997) is as follows:


<nowiki><ref name="pmid19032997">{{cite journal |author=Gibson CM, Pride YB, Frederick PD, ''et al'' |title=Trends in reperfusion strategies, door-to-needle and door-to-balloon times, and in-hospital mortality among patients with ST-segment elevation myocardial infarction enrolled in the National Registry of Myocardial Infarction from 1990 to 2006 |journal=Am. Heart J. |volume=156 |issue=6 |pages=1035–44 |year=2008 |month=December |pmid=19032997 |doi=10.1016/j.ahj.2008.07.029 |url=}}</ref></nowiki>
('''NOTE''': Please do not use the article itself as a reference. Instead, use the PMID #, as mentioned above)
#Paste this output from the reference manager softwre right where you want the superscript number to appear in the text.
 
'''Step 3:''' Paste the PubMed ID number (PMID) into a software program that creates the Wiki language code for the reference you are going to paste into the text of your article. You can access software for converting a pubmed ID number from one of the following:
* '''[http://sumsearch.org/cite SUMSearch Biomedical Citation Maker]''' (converts PMID into wiki reference markups with embedded sumsearch link)
* '''[http://reftag.appspot.com/doiweb.py?doi= DOI Wikipedia reference generator]''' (converts DOI into wiki reference markups)
* '''[http://neuro.imm.dtu.dk/cgi-bin/brede_bib_pmid2wpcitejournal.py?pmid=0 DTU Informatics PMID to Cite journal]''' (converts PMID into wiki reference markups)
* '''[http://www.ottobib.com OttoBib]''' (converts ISBN into wiki reference markups)
* '''[http://tools.wmflabs.org/citation-template-filling/cgi-bin/index.cgi Dave's Template Filler]''' (converts DrugBank ID, HGNC ID, ISBN, PubMed ID, PubMed Central ID, PubChem ID, or URL into wiki reference markups)
<!--
* [http://toolserver.org/~holek/cite-gen/index.php Citation template generator] (converts PubMed ID, ISBN, or URL into wiki reference markups)
* [http://diberri.crabdance.com/cgi-bin/templatefiller/index.cgi? David Iberri template filler]
-->
 
'''Step 4:''' When using the reference manager, make sure the button that says '''add ref tag''' is checked
 
'''Step 5:''' Press '''submit''' to generate the Wiki language that can be inserted in your article.
 
'''Step 6:''' Copy the Wiki language from the software program. For example, the output for the PMID above (19032997) is as follows:


For example, using the above reference, you migh type something like this:
<nowiki><ref name="pmid19032997">{{cite journal |author=Gibson CM, Pride YB, Frederick PD, ''et al.'' |title=Trends in reperfusion strategies, door-to-needle and door-to-balloon times, and in-hospital mortality among patients with ST-segment elevation myocardial infarction enrolled in the National Registry of Myocardial Infarction from 1990 to 2006 |journal=Am. Heart J. |volume=156 |issue=6 |pages=1035–44 |year=2008 |month=December |pmid=19032997 |doi=10.1016/j.ahj.2008.07.029 |url=}}</ref></nowiki>


<nowiki>Gibson et al recently summarized the improvements made in clincial oucomes as a result of 15 years of quality improvement efforts in the NRMI registry  <ref name="pmid19032997">{{cite journal |author=Gibson CM, Pride YB, Frederick PD, ''et al'' |title=Trends in reperfusion strategies, door-to-needle and door-to-balloon times, and in-hospital mortality among patients with ST-segment elevation myocardial infarction enrolled in the National Registry of Myocardial Infarction from 1990 to 2006 |journal=Am. Heart J. |volume=156 |issue=6 |pages=1035–44 |year=2008 |month=December |pmid=19032997 |doi=10.1016/j.ahj.2008.07.029 |url=}}</ref></nowiki>
'''Step 7:''' Paste this output from the reference manager software right where you want the superscript number to appear in the text.


==Add a Reference or Footnote==
For example, using the above reference, you might type something like this:
#Place a '''<nowiki><ref> ... </ref></nowiki>''' immediately after the sentence where you want a footnote number to appear.
 
#Next, type the text of the note between the ref tags. For example if I typed this
<nowiki>Gibson et al recently summarized the improvements made in clincial outcomes as a result of 15 years of quality improvement efforts in the NRMI registry  <ref name="pmid19032997">{{cite journal |author=Gibson CM, Pride YB, Frederick PD, ''et al.'' |title=Trends in reperfusion strategies, door-to-needle and door-to-balloon times, and in-hospital mortality among patients with ST-segment elevation myocardial infarction enrolled in the National Registry of Myocardial Infarction from 1990 to 2006 |journal=Am. Heart J. |volume=156 |issue=6 |pages=1035–44 |year=2008 |month=December |pmid=19032997 |doi=10.1016/j.ahj.2008.07.029 |url=}}</ref></nowiki>
 
This would generate text that looks like this:
 
Gibson et al recently summarized the improvements made in clincial outcomes as a result of 15 years of quality improvement efforts in the NRMI registry<ref name="pmid19032997">{{cite journal |author=Gibson CM, Pride YB, Frederick PD, ''et al.'' |title=Trends in reperfusion strategies, door-to-needle and door-to-balloon times, and in-hospital mortality among patients with ST-segment elevation myocardial infarction enrolled in the National Registry of Myocardial Infarction from 1990 to 2006 |journal=Am. Heart J. |volume=156 |issue=6 |pages=1035–44 |year=2008 |month=December |pmid=19032997 |doi=10.1016/j.ahj.2008.07.029 |url=}}</ref>
 
{{Reflist|2}}
 
==What if I don't want to use the reference manager? What if I just want to type the references in myself?==
You are not required to use the reference manager. You can do the following:
 
'''Step 1:''' Place a '''<nowiki><ref> ... </ref></nowiki>''' immediately after the sentence where you want a footnote number to appear.
 
'''Step 2:''' Type the text of the note between the ref tags. For example if I typed this
  This was on of the first articles I published <nowiki><ref>J Fam Pract. 2000 Oct;49(10):921-3.</ref> </nowiki>
  This was on of the first articles I published <nowiki><ref>J Fam Pract. 2000 Oct;49(10):921-3.</ref> </nowiki>
It would appear as this
It would appear as this
  This was on of the first articles I published <ref>J Fam Pract. 2000 Oct;49(10):921-3.</ref>
==Finally Add a Reference Section at the Bottom of Your Article==
  This was one of the first articles I published<ref>J Fam Pract. 2000 Oct;49(10):921-3.</ref>
#Place the '''<nowiki><references/></nowiki>''' tag in a "Notes" or "References" section near the end of the article and the list of notes will be generated here.
 
'''Note:''' If you intend on using the same manual reference more than once, you will need to assign a name to the reference.  You can do this by writing '''<nowiki><ref name="anythingyouwanthere"> ... </ref></nowiki>'''.  Your name can be anything you want.  Without a name, every manual reference will be viewed as a unique reference.  This means that a reference used multiple times will show up as multiple references instead of just the one.
 
==How do I make the references appear at the bottom of the article?==
===The preferred method===
 
Put the following code in:
 
<pre>
==References==
{{Reflist|2}}
</pre>
 
This will generate your references in small font, in two columns, with links to the original article and abstract. It will return text that looks like this:
 
{{Reflist|2}}
 
<!--
===Alternate "old school" method: No longer in use===
In reference to the code below, we are no longer using it. If you see this code being used please change it to the above format.
 
<nowiki>==References==</nowiki>
 
<nowiki><references/></nowiki>


This generates one column output that looks like this:


{{WH}}
<references/>
-->
[[Category:Help]]


{{WS}}
{{WikiDoc Help Menu}}
{{WikiDoc Sources}}

Revision as of 16:23, 13 December 2018

[1]

Editor-In-Chief: C. Michael Gibson, M.S., M.D. [1]

Overview

WikiDoc has a reference manager that allows users to insert references based upon their PubMed ID number. If you move the text, the reference moves with it! All the references are automatically inserted at the bottom. You click on the reference and you go to the article. It is simple!

Where do I type in the references?

Usually you would type a number in the text like this (1) or this 1 which refers to a reference you would like to cite. You would then type in the reference at the end of the article. This is not the preferred method in WikiDoc.

WikiDoc features an automated reference manager. The advantages of this reference manager are that:

  1. The references are numbered automatically!
  2. When you move the text, the reference moves with it!
  3. You can click on the reference and go directly to the article!

Unlike the usual format where you type in the references at the end of the article, when you use the WikiDoc reference manager, you insert code for the reference right after the material you want to add a reference to. You use a software program to add in the references. The next section describes how to use the software program.

Using the WikiDoc reference manager

One goal of WikiDoc is to create reference lists that allow you to click on the PubMed ID number at the end of the reference and go to the primary article itself. This greatly facilitates locating references. Therefore, the preferred method of citing references includes the use of a reference manager that uses the PubMed ID number to create the reference. The reference manager uses not only PubMed IDs but also DrugBank ID, HGNC ID, ISBN, PubMed ID, PubMed Central ID, PubChem ID, or URLs.

The preferred method for inserting a reference is as follows:

Step 1: Use PubMed to locate the article you are interested in by clicking here

Step 2: Copy the PubMed ID number from the article. The word PubMed ID is often abbreviated PMID and this number is located at the bottom of the abstract. You can use the search function on Firefox or Internet explorer to locate the word PMID and the number will follow this abbreviation. It will look something like this:

PMID: 19032997

(NOTE: Please do not use the article itself as a reference. Instead, use the PMID #, as mentioned above)

Step 3: Paste the PubMed ID number (PMID) into a software program that creates the Wiki language code for the reference you are going to paste into the text of your article. You can access software for converting a pubmed ID number from one of the following:

Step 4: When using the reference manager, make sure the button that says add ref tag is checked

Step 5: Press submit to generate the Wiki language that can be inserted in your article.

Step 6: Copy the Wiki language from the software program. For example, the output for the PMID above (19032997) is as follows:

<ref name="pmid19032997">{{cite journal |author=Gibson CM, Pride YB, Frederick PD, ''et al.'' |title=Trends in reperfusion strategies, door-to-needle and door-to-balloon times, and in-hospital mortality among patients with ST-segment elevation myocardial infarction enrolled in the National Registry of Myocardial Infarction from 1990 to 2006 |journal=Am. Heart J. |volume=156 |issue=6 |pages=1035–44 |year=2008 |month=December |pmid=19032997 |doi=10.1016/j.ahj.2008.07.029 |url=}}</ref>

Step 7: Paste this output from the reference manager software right where you want the superscript number to appear in the text.

For example, using the above reference, you might type something like this:

Gibson et al recently summarized the improvements made in clincial outcomes as a result of 15 years of quality improvement efforts in the NRMI registry <ref name="pmid19032997">{{cite journal |author=Gibson CM, Pride YB, Frederick PD, ''et al.'' |title=Trends in reperfusion strategies, door-to-needle and door-to-balloon times, and in-hospital mortality among patients with ST-segment elevation myocardial infarction enrolled in the National Registry of Myocardial Infarction from 1990 to 2006 |journal=Am. Heart J. |volume=156 |issue=6 |pages=1035–44 |year=2008 |month=December |pmid=19032997 |doi=10.1016/j.ahj.2008.07.029 |url=}}</ref>

This would generate text that looks like this:

Gibson et al recently summarized the improvements made in clincial outcomes as a result of 15 years of quality improvement efforts in the NRMI registry[2]

  1. Mesa, Juan Simon Rico; Sabbagh, Abdallah El; Luis, Sushil (2018). "EARLY CORONARY ARTERY DISEASE IN A YOUNG MALE WITH HEPATIC CIRRHOSIS". Journal of the American College of Cardiology. 71 (11): A2191. doi:10.1016/S0735-1097(18)32732-3. ISSN 0735-1097.
  2. Gibson CM, Pride YB, Frederick PD; et al. (2008). "Trends in reperfusion strategies, door-to-needle and door-to-balloon times, and in-hospital mortality among patients with ST-segment elevation myocardial infarction enrolled in the National Registry of Myocardial Infarction from 1990 to 2006". Am. Heart J. 156 (6): 1035–44. doi:10.1016/j.ahj.2008.07.029. PMID 19032997. Unknown parameter |month= ignored (help)

What if I don't want to use the reference manager? What if I just want to type the references in myself?

You are not required to use the reference manager. You can do the following:

Step 1: Place a <ref> ... </ref> immediately after the sentence where you want a footnote number to appear.

Step 2: Type the text of the note between the ref tags. For example if I typed this

This was on of the first articles I published <ref>J Fam Pract. 2000 Oct;49(10):921-3.</ref> 

It would appear as this

This was one of the first articles I published[1]

Note: If you intend on using the same manual reference more than once, you will need to assign a name to the reference. You can do this by writing <ref name="anythingyouwanthere"> ... </ref>. Your name can be anything you want. Without a name, every manual reference will be viewed as a unique reference. This means that a reference used multiple times will show up as multiple references instead of just the one.

How do I make the references appear at the bottom of the article?

The preferred method

Put the following code in:

==References==
{{Reflist|2}}

This will generate your references in small font, in two columns, with links to the original article and abstract. It will return text that looks like this:

  1. J Fam Pract. 2000 Oct;49(10):921-3.


Template:WikiDoc Sources