Difference between revisions of "Proper referencing"

From AlchemistryWiki
Jump to navigation Jump to search
Line 18: Line 18:
 
=== Information in the reference ===
 
=== Information in the reference ===
  
Reference creation is very easy.   
+
Reference creation is very easy.  Simply start with:
 
<nowiki>
 
<nowiki>
{{Reference|
+
{{Reference}}
first author = Jayachandran|
+
<\nowiki>
authors = Guha Jayachandran, Michael R. Shirts, Sanghyun Park and Vijay S. Pande|
+
to access the Reference template.  From there, add variables to add information in the format:
group = Pande Group |
+
<nowiki>
year = 2006 |  
+
{{Reference|title=your title|first author=your first author}
volume = 125 |  
+
<\nowiki>
pages = 084901 |
+
And so forth. For example:
doi = 10.1063/1.2221680 |
+
 
title = Parallelized-over-parts computation of absolute binding free energy with docking and molecular dynamics|
+
<nowiki>
journal = J. Chem. Phys.}}
+
{{Reference|  
 +
first author = Jayachandran|  
 +
authors = Guha Jayachandran, Michael R. Shirts, Sanghyun Park and Vijay S. Pande|  
 +
group = Pande Group |  
 +
year = 2006 |  
 +
volume = 125 |  
 +
pages = 084901 |  
 +
doi = 10.1063/1.2221680 |
 +
title = Parallelized-over-parts computation of absolute binding free energy with docking and molecular dynamics| <br>
 +
journal = J. Chem. Phys.}}  
 
</nowiki>
 
</nowiki>
  
This will automatically produce a properly formatting reference, along with automatically categorizing it by year, by first author, and by group, and provide a link to the DOI.
+
This will automatically produce a properly formatted reference, along with automatically categorizing it by year, by first author, and by group, and provide a link to the DOI.  The order does not matter, as long as the variable names are correct.
 
   
 
   
 
Any commentary you can add is also very important!  Let us know what other papers it depends on, and what other papers it has influenced.
 
Any commentary you can add is also very important!  Let us know what other papers it depends on, and what other papers it has influenced.

Revision as of 13:25, 18 October 2007

Selecting a unique name

To add a reference, first select a name. To name the paper uniquely, name it {FirstAuthorName}{JournalAbbreviation}{Year}{letter} where the 'letter' is a,b,c, and so forth, noting duplicates. So M. R. Shirts and V. S. Pande, J. Chem. Phys. from 2005 becomes MRShirtsJChemPhys2005a.

Papers that have not yet appeared in print editions are fine, as long as you can provide a link to an online version of the article through the journal site. If you wish to link a preprint, add "Preprint" after the journal name (or in place of the Journal name if there not yet a journal), and replace it when it has been published.

If you are not sure of the journal abbreviation, please look it up [here]

Adding the reference

In MediaWiki, one must first add the name to existing text, and then save it (i.e., it cannot be created free floating). It most cases, papers will be added because they are being added as references in already created text. If you just want to add it, save the name to -any- page, add the reference, categorize it, and then delete the reference in the page that linked to it. Be sure to at least categorize it, or else it will be lost!

If you wish to add a citation, but want the link to appear with alternate text, that can be done by

    [[name | alternate text here]] 

Following these practices will make it easier to modify this database later!

Information in the reference

Reference creation is very easy. Simply start with: {{Reference}} <\nowiki> to access the Reference template. From there, add variables to add information in the format: <nowiki> {{Reference|title=your title|first author=your first author} <\nowiki> And so forth. For example: <nowiki> {{Reference| first author = Jayachandran| authors = Guha Jayachandran, Michael R. Shirts, Sanghyun Park and Vijay S. Pande| group = Pande Group | year = 2006 | volume = 125 | pages = 084901 | doi = 10.1063/1.2221680 | title = Parallelized-over-parts computation of absolute binding free energy with docking and molecular dynamics| <br> journal = J. Chem. Phys.}}

This will automatically produce a properly formatted reference, along with automatically categorizing it by year, by first author, and by group, and provide a link to the DOI. The order does not matter, as long as the variable names are correct.

Any commentary you can add is also very important! Let us know what other papers it depends on, and what other papers it has influenced.

Adding categories

At the end, add categories to which the reference belongs, in addition to the automatically generated categories. All papers at least belong to the category of the year of their paper. Categories are added by the text:

    [[Category:Solvation Free Energy Calculations]]

Courtesy

Please be polite when editing the commentary on references! Don't discredit research unless you have solid reasoning, or a link to a study that contradicts it.