CitationResourcesExamples: Difference between revisions

From IAMC-Documentation
Jump to navigation Jump to search
No edit summary
 
(42 intermediate revisions by one other user not shown)
Line 3: Line 3:
A citation may be defined by bibtex exports or a set of property-value pairs. Surrounding the definition with:
A citation may be defined by bibtex exports or a set of property-value pairs. Surrounding the definition with:
::<nowiki>{{#scite: ... }} </nowiki>
::<nowiki>{{#scite: ... }} </nowiki>
will interpret the definition into an citation text. The format depends on the type of the citation.
will render the definition into an citation text. The format depends on the type of the citation.


The examples below show the different types and their definitions and fields
The examples below show the different types and their definitions and fields
==Article definition==
==Article definition==
* An article from a journal or magazine.  
* An article from a journal or magazine.  
Line 11: Line 12:
* Required fields: author, title, journal, year.  
* Required fields: author, title, journal, year.  
* Optional fields: volume, number, pages, month, doi, note.  
* Optional fields: volume, number, pages, month, doi, note.  
 
''Example with  property-value pairs''
{{#scite: |reference=van vuuren2013a  
{{#scite: |reference=van vuuren2013a  
|type=Journal-article  
|type=Journal-article  
Line 44: Line 45:
  |browselinks=no
  |browselinks=no
  |columns=1
  |columns=1
  |header=Result
  |header= Result
}}
}}
''Bibtex example''
{{#scite:
{{#scite:
|bibtex=
|bibtex=
Line 99: Line 101:
}}
}}


==Bookdefinition==
==Book definition==
* A book with an explicit publisher.  
* A book with an explicit publisher.  
* type = book
* type = book
* Required fields: author or editor, title, publisher, year.  
* Required fields: author or editor, title, publisher, year.  
* Optional fields: volume or number, series, address, edition, month, note. -->
* Optional fields: volume, address, edition, month, doi, note. -->
{{#scite:
{{#scite:
|bibtex=
|bibtex=
Line 113: Line 115:
  publisher = {Association for Computing Machinery and Morgan & Claypool},
  publisher = {Association for Computing Machinery and Morgan & Claypool},
  address = {New York, NY, USA},
  address = {New York, NY, USA},
edition = 2nd,
volume =  1-2,
}  
}  
}}
}}
Line 125: Line 129:
  publisher = {Association for Computing Machinery and Morgan & Claypool},
  publisher = {Association for Computing Machinery and Morgan & Claypool},
  address = {New York, NY, USA},
  address = {New York, NY, USA},
edition = 2nd,
volume =  1-2,
}  
}  
}}
}}
Line 134: Line 140:
  |header=Result
  |header=Result
}}
}}
<!-- type(incollection|inproceedings): A part of a book having its own title. Required fields: author, title, booktitle, publisher, year. Optional fields: editor, volume or number, series, type, chapter, pages, organization, address, edition, month, note. -->
 
== Book chapter, book section, in selection ==
* A part of a book having its own title.
* type = incollection | inproceedings 
* Required fields: author, title, booktitle, publisher, year.  
* Optional fields: editor, volume, chapter, pages, address, edition, month, doi, note.  
{{#scite:vanVuuren2014
{{#scite:vanVuuren2014
|type=incollection
|type=incollection
Line 146: Line 157:
|publisher=PBL Netherlands Environmental Assessment Agency
|publisher=PBL Netherlands Environmental Assessment Agency
|address=The Hague, Netherlands
|address=The Hague, Netherlands
}}
<pre><nowiki>
{{#scite:vanVuuren2014
|type=incollection
|author=Detlef P. van Vuuren; Bas van Ruijven; David Gernaat; Harmen-Sytze de Boer|+sep=;
|title=Energy conversion
|year=2014
|chapter=4.1.2
|pages=89-98
|booktitle=Integrated assessment of global change with IMAGE 3.0
|editor=Elke Stehfest; Detlef van Vuuren;Tom Kram;Lex Bouwman|+sep=;
|publisher=PBL Netherlands Environmental Assessment Agency
|address=The Hague, Netherlands
}}
</nowiki></pre>
{{#referencelist:
|references=vanVuuren2014
|browselinks=no
|columns=1
|header=Result
}}
}}


<!-- type (report|techreport) : A report published by an institution, usually numbered within a series. Required fields: author, title, institution, year. Optional fields: type, number, address, month, note. -->
== Report definition ==
* A report published by an institution, usually numbered within a series
* type = report | techreport
* Required fields: author, title, institution, year.  
* Optional fields: number, address, month, doi, note.
{{#scite:Hof2012
|type=report
|author=A. F. Hof; C. Brink;A. Mendoza Beltrán; M. G. J. Den Elzen|+sep=;
|year=2012
|month=April
|title=Greenhouse gas emission reduction targets for 2030: Conditions for a EU target of 40%
|institution=PBL Netherlands Environmental Assessment Agency
|address=The Hague, Netherlands
}}
<pre><nowiki>
{{#scite:Hof2012
{{#scite:Hof2012
  |type=report
  |type=report
|month=April
  |author=A. F. Hof; C. Brink;A. Mendoza Beltrán; M. G. J. Den Elzen|+sep=;
  |author=A. F. Hof; C. Brink;A. Mendoza Beltrán; M. G. J. Den Elzen|+sep=;
  |year=2012
  |year=2012
Line 156: Line 202:
  |institution=PBL Netherlands Environmental Assessment Agency
  |institution=PBL Netherlands Environmental Assessment Agency
  |address=The Hague, Netherlands
  |address=The Hague, Netherlands
}}
</nowiki></pre>
{{#referencelist:
|references=Hof2012
|browselinks=no
|columns=1
|header=Result
}}
}}


== Webpage definition ==
* a page accessed from internet
* type webpage
* Required fields: author and/or title, accessyear, accessdate, url.
* Optional fields: year, lastupdate, publisher, sourcetype, note, doi.
Rules to use in citing websites:
# Include the author, title of the document, and if available, always include the date the material was updated or posted online. If the page may be changed or moved, include the date of retrieval. Include the URL of the document cited.
# If there is no author, place the title in the author position.
# If there is no date, replace the date with (n.d.) to signify that there is no date for the material.
# Add a description of the source in square brackets after the title, if this is necessary to clarify the type of source e.g. [Bibliography] [PowerPoint slides] [online database]
{{#scite:APAexample1
{{#scite:APAexample1
|type=webpage
|type=webpage
Line 166: Line 230:
|accessdate=August 1
|accessdate=August 1
}}
}}
{{#scite:APAexample2
|type=webpage
|title=APA citation style
|year=2015
|lastupdate=September 15
|sourcetype=text
|url=http://library.concordia.ca/help/citing/apa.php
|accessyear=2016
|accessdate=August 1
|publisher=Concordia University
|address= Montreal, Canada
}}
<pre><nowiki>
{{#scite:APAexample1;
|type=webpage
|title=APA Citation Examples
|year=2016
|url=http://www.umuc.edu/library/libhow/apa_examples.cfm
|accessyear=2016
|accessdate=August 1
}}
{{#scite:APAexample2
|type=webpage
|title=APA citation style
|year=2015
|lastupdate=September 15
|sourcetype=text
|url=http://library.concordia.ca/help/citing/apa.php
|accessyear=2016
|accessdate=August 1
|publisher=Concordia University
|address= Montreal, Canada
}}
</nowiki></pre>


{{#referencelist:
|references=APAexample1;APAexample2|+sep=;
|header=Result
}}
==Other citation types definition ==
* Any other citation type
* type = generic | misc | ...
* Required field: citation text
* Optional field: n.a.
There is no formatting template available for citation types other then above mentioned. You just include a formatted citation text in the definition.
{{#scite:Notenboom2016
|type=essay
|citation text=Jos Notenboom, Pieter Boot (2016, April). ''An essay on the colourful scene of Europe's energy transition''. The Hague, Netherlands: PBL Netherlands Environmental Assessment Agency.
}}
<pre><nowiki>
{{#scite:Notenboom2016
|type=essay
|citation text=Jos Notenboom, Pieter Boot (2016, April).
''An essay on the colourful scene of Europe's energy transition''.
The Hague, Netherlands: PBL Netherlands Environmental Assessment Agency
}}
</nowiki></pre>
{{#referencelist:
|references=Notenboom2016
|header=Result
}}


==Reference list definition==
In order to define a reference list on the References page of the models, use the following code. This should be followed by the citations presented in the formats explained above.
<pre><nowiki>{{#referencelist:
|references=van vuuren2013a;
vanVuuren2007;
Zhai:2016:TDM:2915031;
vanVuuren2014;
Hof2012;
APAexample1;
APAexample2;
Notenboom2016|+sep=;
|listtype=ol
|browselinks=yes
|columns=2
|toc=yes
|header=All references
}}</nowiki></pre>
Results in:
{{#referencelist:
{{#referencelist:
  |references=van vuuren2013a;
  |references=van vuuren2013a;
vanVuuren2007;
vanVuuren2007;
Denning:1991:CUA:102616;
Zhai:2016:TDM:2915031;
Zhai:2016:TDM:2915031;
vanVuuren2014;
vanVuuren2014;
Hof2012;
Hof2012;
APAexample1;|+sep=;
APAexample1;
APAexample2;
Notenboom2016|+sep=;
  |listtype=ol
  |listtype=ol
  |browselinks=yes
  |browselinks=yes
  |columns=1
  |columns=2
  |toc=yes
  |toc=yes
|header=All references
}}
}}

Latest revision as of 09:19, 30 August 2016

Intro

A citation may be defined by bibtex exports or a set of property-value pairs. Surrounding the definition with:

{{#scite: ... }}

will render the definition into an citation text. The format depends on the type of the citation.

The examples below show the different types and their definitions and fields

Article definition

  • An article from a journal or magazine.
  • type = article | journal-article
  • Required fields: author, title, journal, year.
  • Optional fields: volume, number, pages, month, doi, note.

Example with property-value pairs {{#scite: |reference=van vuuren2013a |type=Journal-article |title=A new scenario framework for Climate Change Research: scenario matrix architecture |author=Detlef P. van Vuuren;Elmar Kriegler;Brian C. O’Neill;Kristie L. Ebi;Keywan Riahi;Timothy R. Carter;Jae Edmonds;Stephane Hallegatte;Tom Kram;Ritu Mathur;Harald Winkler|+sep=; |journal=Climatic Change |publisher=Springer Science + Business Media |year=2013 |volume=122 |number=3 |pages=373-386 |doi=10.1007/s10584-013-0906-1 |subject=Atmospheric Science;Global and Planetary Change|+sep=; |issn=0165-0009;1573-1480|+sep=; }}

{{#scite: |reference=van vuuren2013a 
|type=Journal-article 
|title=A new scenario framework for Climate Change Research: scenario matrix architecture |author=Detlef P. van Vuuren;Elmar Kriegler;Brian C. O’Neill;Kristie L. Ebi;Keywan Riahi;Timothy R. Carter;Jae Edmonds;Stephane Hallegatte;Tom Kram;Ritu Mathur;Harald Winkler|+sep=; 
|journal=Climatic Change 
|publisher=Springer Science + Business Media 
|year=2013 
|volume=122 
|number=3 
|pages=373-386 
|doi=10.1007/s10584-013-0906-1 
|subject=Atmospheric Science;Global and Planetary Change|+sep=; 
|issn=0165-0009;1573-1480|+sep=; 
}}

{{#referencelist:

|references=van vuuren2013a
|browselinks=no
|columns=1
|header= Result

}} Bibtex example {{#scite: |bibtex= @Article{vanVuuren2007, author="van Vuuren, Detlef P. and den Elzen, Michel J. G. and Lucas, Paul L. and Eickhout, Bas and Strengers, Bart J. and van Ruijven, Bas and Wonink, Steven and van Houdt, Roy", title="Stabilizing greenhouse gas concentrations at low levels: an assessment of reduction strategies and costs", journal="Climatic Change", year="2007", volume="81", number="2", pages="119--159", abstract="On the basis of the IPCC B2, A1b and B1 baseline scenarios, mitigation scenarios were developed that stabilize greenhouse gas concentrations at 650, 550 and 450 and -- subject to specific assumptions -- 400 ppm CO2-eq. The analysis takes into account a large number of reduction options, such as reductions of non-CO2 gases, carbon plantations and measures in the energy system. The study shows stabilization as low as 450 ppm CO2-eq. to be technically feasible, even given relatively high baseline scenarios. To achieve these lower concentration levels, global emissions need to peak within the first two decades. The net present value of abatement costs for the B2 baseline scenario (a medium scenario) increases from 0.2{\%} of cumulative GDP to 1.1{\%} as the shift is made from 650 to 450 ppm. On the other hand, the probability of meeting a two-degree target increases from 0{\%}--10{\%} to 20{\%}--70{\%}. The mitigation scenarios lead to lower emissions of regional air pollutants but also to increased land use. The uncertainty in the cost estimates is at least in the order of 50{\%}, with the most important uncertainties including land-use emissions, the potential for bio-energy and the contribution of energy efficiency. Furthermore, creating the right socio-economic and political conditions for mitigation is more important than any of the technical constraints.", issn="1573-1480", doi="10.1007/s10584-006-9172-9", url="http://dx.doi.org/10.1007/s10584-006-9172-9" }

}}

{{#scite:
|bibtex=
@Article{vanVuuren2007,
author="van Vuuren, Detlef P.
and den Elzen, Michel J. G.
and Lucas, Paul L.
and Eickhout, Bas
and Strengers, Bart J.
and van Ruijven, Bas
and Wonink, Steven
and van Houdt, Roy",
title="Stabilizing greenhouse gas concentrations at low levels: an assessment of reduction strategies and costs",
journal="Climatic Change",
year="2007",
volume="81",
number="2",
pages="119--159",
abstract="On the basis of the IPCC B2, A1b and B1 baseline scenarios, mitigation scenarios were developed that stabilize greenhouse gas concentrations at 650, 550 and 450 and -- subject to specific assumptions -- 400 ppm CO2-eq. The analysis takes into account a large number of reduction options, such as reductions of non-CO2 gases, carbon plantations and measures in the energy system. The study shows stabilization as low as 450 ppm CO2-eq. to be technically feasible, even given relatively high baseline scenarios. To achieve these lower concentration levels, global emissions need to peak within the first two decades. The net present value of abatement costs for the B2 baseline scenario (a medium scenario) increases from 0.2{\%} of cumulative GDP to 1.1{\%} as the shift is made from 650 to 450 ppm. On the other hand, the probability of meeting a two-degree target increases from 0{\%}--10{\%} to 20{\%}--70{\%}. The mitigation scenarios lead to lower emissions of regional air pollutants but also to increased land use. The uncertainty in the cost estimates is at least in the order of 50{\%}, with the most important uncertainties including land-use emissions, the potential for bio-energy and the contribution of energy efficiency. Furthermore, creating the right socio-economic and political conditions for mitigation is more important than any of the technical constraints.",
issn="1573-1480",
doi="10.1007/s10584-006-9172-9",
url="http://dx.doi.org/10.1007/s10584-006-9172-9"
} 
}}

{{#referencelist:

|references=vanVuuren2007
|browselinks=no
|columns=1
|header=Result

}}

Book definition

  • A book with an explicit publisher.
  • type = book
  • Required fields: author or editor, title, publisher, year.
  • Optional fields: volume, address, edition, month, doi, note. -->

{{#scite: |bibtex= @book{Zhai:2016:TDM:2915031,

author = {Zhai, ChengXiang and Massung, Sean},
title = {Text Data Management and Analysis: A Practical Introduction to Information Retrieval and Text Mining},
year = {2016},
isbn = {978-1-97000-117-4},
publisher = {Association for Computing Machinery and Morgan & Claypool},
address = {New York, NY, USA},
edition = 2nd,
volume =  1-2,

} }}

{{#scite:
|bibtex=
@book{Zhai:2016:TDM:2915031,
 author = {Zhai, ChengXiang and Massung, Sean},
 title = {Text Data Management and Analysis: A Practical Introduction to Information Retrieval and Text Mining},
 year = {2016},
 isbn = {978-1-97000-117-4},
 publisher = {Association for Computing Machinery and Morgan & Claypool},
 address = {New York, NY, USA},
 edition = 2nd,
 volume =  1-2,
} 
}}

{{#referencelist:

|references=Zhai:2016:TDM:2915031
|browselinks=no
|columns=1
|header=Result

}}

Book chapter, book section, in selection

  • A part of a book having its own title.
  • type = incollection | inproceedings
  • Required fields: author, title, booktitle, publisher, year.
  • Optional fields: editor, volume, chapter, pages, address, edition, month, doi, note.

{{#scite:vanVuuren2014 |type=incollection |author=Detlef P. van Vuuren; Bas van Ruijven; David Gernaat; Harmen-Sytze de Boer|+sep=; |title=Energy conversion |year=2014 |chapter=4.1.2 |pages=89-98 |booktitle=Integrated assessment of global change with IMAGE 3.0 |editor=Elke Stehfest; Detlef van Vuuren;Tom Kram;Lex Bouwman|+sep=; |publisher=PBL Netherlands Environmental Assessment Agency |address=The Hague, Netherlands }}

{{#scite:vanVuuren2014
|type=incollection
|author=Detlef P. van Vuuren; Bas van Ruijven; David Gernaat; Harmen-Sytze de Boer|+sep=;
|title=Energy conversion
|year=2014
|chapter=4.1.2
|pages=89-98
|booktitle=Integrated assessment of global change with IMAGE 3.0
|editor=Elke Stehfest; Detlef van Vuuren;Tom Kram;Lex Bouwman|+sep=;
|publisher=PBL Netherlands Environmental Assessment Agency
|address=The Hague, Netherlands
}}

{{#referencelist:

|references=vanVuuren2014
|browselinks=no
|columns=1
|header=Result

}}

Report definition

  • A report published by an institution, usually numbered within a series
  • type = report | techreport
  • Required fields: author, title, institution, year.
  • Optional fields: number, address, month, doi, note.

{{#scite:Hof2012

|type=report
|author=A. F. Hof; C. Brink;A. Mendoza Beltrán; M. G. J. Den Elzen|+sep=;
|year=2012
|month=April
|title=Greenhouse gas emission reduction targets for 2030: Conditions for a EU target of 40%
|institution=PBL Netherlands Environmental Assessment Agency
|address=The Hague, Netherlands

}}

{{#scite:Hof2012
 |type=report
 |month=April
 |author=A. F. Hof; C. Brink;A. Mendoza Beltrán; M. G. J. Den Elzen|+sep=;
 |year=2012
 |title=Greenhouse gas emission reduction targets for 2030: Conditions for a EU target of 40%
 |institution=PBL Netherlands Environmental Assessment Agency
 |address=The Hague, Netherlands
}}

{{#referencelist:

|references=Hof2012
|browselinks=no
|columns=1
|header=Result

}}

Webpage definition

  • a page accessed from internet
  • type webpage
  • Required fields: author and/or title, accessyear, accessdate, url.
  • Optional fields: year, lastupdate, publisher, sourcetype, note, doi.

Rules to use in citing websites:

  1. Include the author, title of the document, and if available, always include the date the material was updated or posted online. If the page may be changed or moved, include the date of retrieval. Include the URL of the document cited.
  2. If there is no author, place the title in the author position.
  3. If there is no date, replace the date with (n.d.) to signify that there is no date for the material.
  4. Add a description of the source in square brackets after the title, if this is necessary to clarify the type of source e.g. [Bibliography] [PowerPoint slides] [online database]

{{#scite:APAexample1 |type=webpage |title=APA Citation Examples |year=2016 |url=http://www.umuc.edu/library/libhow/apa_examples.cfm |accessyear=2016 |accessdate=August 1 }} {{#scite:APAexample2 |type=webpage |title=APA citation style |year=2015 |lastupdate=September 15 |sourcetype=text |url=http://library.concordia.ca/help/citing/apa.php |accessyear=2016 |accessdate=August 1 |publisher=Concordia University |address= Montreal, Canada }}

{{#scite:APAexample1;
|type=webpage
|title=APA Citation Examples
|year=2016
|url=http://www.umuc.edu/library/libhow/apa_examples.cfm
|accessyear=2016
|accessdate=August 1
}}
{{#scite:APAexample2
|type=webpage
|title=APA citation style
|year=2015
|lastupdate=September 15
|sourcetype=text
|url=http://library.concordia.ca/help/citing/apa.php
|accessyear=2016
|accessdate=August 1
|publisher=Concordia University
|address= Montreal, Canada 
}}

{{#referencelist:

|references=APAexample1;APAexample2|+sep=;
|header=Result

}}

Other citation types definition

  • Any other citation type
  • type = generic | misc | ...
  • Required field: citation text
  • Optional field: n.a.

There is no formatting template available for citation types other then above mentioned. You just include a formatted citation text in the definition. {{#scite:Notenboom2016 |type=essay |citation text=Jos Notenboom, Pieter Boot (2016, April). An essay on the colourful scene of Europe's energy transition. The Hague, Netherlands: PBL Netherlands Environmental Assessment Agency. }}

{{#scite:Notenboom2016
|type=essay
|citation text=Jos Notenboom, Pieter Boot (2016, April). 
''An essay on the colourful scene of Europe's energy transition''.
The Hague, Netherlands: PBL Netherlands Environmental Assessment Agency
}}

{{#referencelist:

|references=Notenboom2016
|header=Result

}}

Reference list definition

In order to define a reference list on the References page of the models, use the following code. This should be followed by the citations presented in the formats explained above.

{{#referencelist:
|references=van vuuren2013a;
vanVuuren2007;
Zhai:2016:TDM:2915031;
vanVuuren2014;
Hof2012;
APAexample1;
APAexample2;
Notenboom2016|+sep=;
|listtype=ol
|browselinks=yes
|columns=2
|toc=yes
|header=All references
}}

Results in: {{#referencelist:

|references=van vuuren2013a;

vanVuuren2007; Zhai:2016:TDM:2915031; vanVuuren2014; Hof2012; APAexample1; APAexample2; Notenboom2016|+sep=;

|listtype=ol
|browselinks=yes
|columns=2
|toc=yes

|header=All references }}