help:citations

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		 Previous revision
help:citations [2020/02/01 17:02] – ↷ Page moved from help:citations to investigations:cerebrospinal_fluid:help:citations icnahelp:citations [2022/04/30 09:56] (current) – administrator@icnapedia.org
Line 1: Line 1:
 +====== Citations & Footnotes ======
  
 +A typical example is shown here[(:cite:test>de Campos FPF, Benvenuti LA (2017) [[https://www.ncbi.nlm.nih.gov/entrez/eutils/elink.fcgi?dbfrom=pubmed&retmode=ref&cmd=prlinks&id=28536680|Eisenmenger syndrome.]] //Autops Case Rep// 7 (1):5-7. [[http://dx.doi.org/10.4322/acr.2017.006|DOI:10.4322/acr.2017.006]] PMID: [[https://pubmed.gov/28536680|28536680]])]
 +
 +If you are using PubMed it is very simple. For e.g This is sentence you want have the PubMed article with id 26234761 as reference for [(:cite:pmid26234761>{{pmid>long:26234761}})].<code>[(:cite:pmid26234761>{{pmid>long:26234761}})]</code>
 +
 +The syntax is quite easy:
 +<code>{{pmid>01234567}} OR {{pmcid>01234567}}
 +or {{pmid>long:01234567}} OR {{pmcid>long:01234567}}</code>
 +
 +You can use the same reference again in the same article. In this case you just need to use [(:cite:pmid26234761)] <code>[(:cite:pmid26234761)]</code>.
 +
 +If the article you are citing do not have a PubMed ID (PMID) the easiest option would be to use this syntax <code>[(:cite:name>citation)]</code> 
 +For e.g <code>[(:cite:knuth1969>Knuth, Donald E. The Art of Computer Programming, Volume 2: Seminumerical Algorithms, First edition, Addison-Wesley, 1969, ISBN 0-201-03802-1)]</code>.
 +
 +The above will give you[(:cite:knuth1969>Knuth, Donald E. The Art of Computer Programming, Volume 2: Seminumerical Algorithms, First edition, Addison-Wesley, 1969, ISBN 0-201-03802-1)]
 +
 +===== Other options =====
 +
 +Alternatively use http://sumsearch.org/cite/ and generate the HTML code (blog format) and enter it like shown below
 +<code>
 +[(:cite:28536680><html>de Campos FPF, Benvenuti LA (2017)
 +<a href="https://www.ncbi.nlm.nih.gov/entrez/eutils/elink.fcgi?dbfrom=pubmed&retmode=ref&cmd=prlinks&id=28536680">Eisenmenger syndrome.</a> 
 +<i>Autops Case Rep</i>
 +7 (1):5-7.  DOI: <a href="http://dx.doi.org/10.4322/acr.2017.006">10.4322/acr.2017.006</a>
 +PMID: <a href="https://pubmed.gov/28536680">28536680</a></html>)]
 +</code>
 +
 +Although not recommended you could use it without HTML like this
 +<code>[(:cite:28536680>de Campos FPF, Benvenuti LA (2017) Eisenmenger syndrome. Autops Case Rep 7 (1):5-7. DOI: 10.4322/acr.2017.006 PMID: 28536680.)]</code>
 +
 +Suppose you want just a footnote then do it like this 
 +
 +<code>[(note1>this is a footnote)]</code>. 
 +
 +Here "note1" is the name of the note so that you can reuse the note.
 +
 +If you do not have the PMID but you have HTML for it then use the [[:playground:pandoc_website|https://pandoc.org/try]] to convert HTML or whatever to dokuwiki syntax and use it like this
 +[(:cite:maron2013>Maron BJ, Haas TS, Maron MS, Lesser JR, Browning JA, Chan RH et al. (2014) [[https://www.ncbi.nlm.nih.gov/entrez/eutils/elink.fcgi?dbfrom=pubmed&retmode=ref&cmd=prlinks&id=24589281|Left atrial remodeling in hypertrophic cardiomyopathy and susceptibility markers for atrial fibrillation identified by cardiovascular magnetic resonance.]] //Am J Cardiol// 113 (8):1394-400. DOI: [[http://dx.doi.org/10.1016/j.amjcard.2013.12.045|10.1016/j.amjcard.2013.12.045]] PMID: [[https://pubmed.gov/24589281|24589281]])]
 +<code>[(:cite:maron2013>Maron BJ, Haas TS, Maron MS, Lesser JR, Browning JA, Chan RH et al. (2014) [[https://www.ncbi.nlm.nih.gov/entrez/eutils/elink.fcgi?dbfrom=pubmed&retmode=ref&cmd=prlinks&id=24589281|Left atrial remodeling in hypertrophic cardiomyopathy and susceptibility markers for atrial fibrillation identified by cardiovascular magnetic resonance.]] //Am J Cardiol// 113 (8):1394-400. DOI: [[http://dx.doi.org/10.1016/j.amjcard.2013.12.045|10.1016/j.amjcard.2013.12.045]] PMID: [[https://pubmed.gov/24589281|24589281]])]</code>
 +
 +There also standard readymade ones like <code>[(:fixme>This part has to be reworked.)]</code> or <code>[(:todo>[//[[:missing_citation|citation needed]]// ])]</code> or <code>[(:cite:todo>[[:missing_citation|citation needed]])]</code> or [(:ref:todo>[//[[:missing_reference|reference needed]]//])]<code>[(:ref:todo>[//[[:missing_reference|reference needed]]//])]</code>
 +
 +Trying wikipedia style but this does not seem to work at present [(HarvRefSys>>| author=Maron BJ, Haas TS, Maron MS, Lesser JR, Browning JA, Chan RH et al.| title=Left atrial remodeling in hypertrophic cardiomyopathy and susceptibility markers for atrial fibrillation identified by cardiovascular magnetic resonance. | journal=Am J Cardiol | year= 2014 | volume= 113 | issue= 8 | pages= 1394-400 | pmid=24589281 | doi=10.1016/j.amjcard.2013.12.045 | pmc= | url=[[https://www.ncbi.nlm.nih.gov/entrez/eutils/elink.fcgi?dbfrom=pubmed&tool=sumsearch.org/cite&retmode=ref&cmd=prlinks&id=24589281|https://www.ncbi.nlm.nih.gov/entrez/eutils/elink.fcgi?dbfrom=pubmed&tool=sumsearch.org/cite&retmode=ref&cmd=prlinks&id=24589281]])]
 +
 +This is an example of a book reference <code>[(:cite:KnuthAoP2>> author : Donald Knuth title : Arts of Programming, Volume 2: Seminumerical Algorithms edition : Third Edition published : 1997 publisher : Addison-Wesley note-pages : xiv + 762 pp. isbn : 0-201-89684-2 url : [[http://en.wikipedia.org/wiki/The_Art_of_Computer_Programming|http://en.wikipedia.org/wiki/The_Art_of_Computer_Programming]] )]</code> and this another example of a book reference where the chapter is also available <code>[(:cite:KnuthAoP2Ch3>> author : Donald Knuth title : Arts of Programming, Volume 2: Seminumerical Algorithms chapter : Random numbers edition : Third Edition published : 1997 publisher : Addison-Wesley note-pages : Ch. 3 isbn : 0-201-89684-2 url : [[http://en.wikipedia.org/wiki/The_Art_of_Computer_Programming|http://en.wikipedia.org/wiki/The_Art_of_Computer_Programming]] )]</code> and in case of a journal it would be like this <code>[(:cite:KnuthLCE1985>> author : Donald Knuth title : Deciphering a linear congruential encryption journal : IEEE Transactions on Information Theory volume : 31(1) published : Jan 1985 publisher : IEEE note-pages : 49-52 issn : 0018-9448 url : [[http://ieeexplore.ieee.org/search/freesrchabstract.jsp?tp=&arnumber=1056997|http://ieeexplore.ieee.org/search/freesrchabstract.jsp?tp=&arnumber=1056997]] )]</code>
 +
 +===== Fields =====
 +
 +The plugin supports the following fields:
 +
 +^  Name  ^  Label  ^  Description  ^  Defined in  ^  Used in  ^|
 +| ::: | ::: | ::: | ::: ^  Basic  ^  Harvard  |
 +|''address''   |Address  |Address of the publisher.|  r, d  | |  n  |
 +|''author''   |Author  |List of the authors.|  r, d  | |  r, n  |
 +|''authors''   |Authors  | ::: | ::: | ::: | ::: |
 +|''booktitle''   |Book title  |The title of the book, if only part of it is being cited.|  r, d  | |  n  |
 +|''chapter''   |Chapter  |Name of a book chapter.|  r, d  | |  n  |
 +|''direct''   |   |Harvard referencing system allows two types of formatting for references: when author name is directly mentioned in the text and when it isn't. Using ''direct'' field you can control this formatting for each individual reference.|  r  | |  r  |
 +|''edition''   |Edition  |Book edition.|  r, d  | |  n  |
 +|''isbn''   |ISBN  |Book number.|  r, d  | |  n  |
 +|''issn''   |ISSN  | ::: | ::: | ::: | ::: |
 +|''journal''   |Journal  |Name of a journal or magazine.|  r, d  | |  n  |
 +|''month''   |Month  |Month of publication.|  r, d  | |  n  |
 +|''note-name''   |Note name  |Fully qualified note name including the namespace.|  d<sup>1</sup>     |  r<sup>2</sup>     | |
 +|''note-page''   |Note page  |Number of pages in a book or page range for an article.|  r, d  | |  n  |
 +|''note-pages''   |Note pages  | ::: | ::: | ::: | ::: |
 +|''note-text''   |Note text  |Text of the note.|  r, d  |  n  |  n<sup>3</sup>     |
 +|''page''   |Page  |Number of pages in a book or page range for an article. When used in a reference, this field defines page that is referred by this particular reference. To define page range for the note from a reference use ''note-pages'' field.|  r, d  | |  r, n  |
 +|''pages''   |Pages  | ::: | ::: | ::: | ::: |
 +|''published''   |Published  |Date of publication. Alternatively it can be specifies with ''month'' and ''year'' fields.|  r, d  | |  r, n  |
 +|''publisher''   |Publisher  |Address and name of the publisher.|  r, d  | |  n  |
 +|''ref-author''   |Reference author  |RefNotes plugin doesn't do any processing on the list of authors. If there are too many of them to include in the reference, you can use ''ref-authors'' to provide an alternative list just for the references.|  r, d  | |  r  |
 +|''ref-authors''   |Reference authors  | ::: | ::: | ::: | ::: |
 +|''title''   |Title  |Title of a book or an article.|  r, d  |  n<sup>4</sup>     |  n  |
 +|''url''   |URL<sup>5</sup>    |Wraps the ''note-text'' or ''title'' into a link.|  r, d  |  n  |  n  |
 +|''volume''   |Volume  |Volume or issue number of a journal.|  r, d  | |  n  |
 +|''year''   |Year  |Year of publication.|  r, d  | |  r, n  |
 +
 +**Legend:**
 +
 +d — defined in reference database.\\
 +r — defined/used in references.\\
 +n — used in notes.
 +
 +===== References =====
 +In order to use in columns see below
 +<columns 100% 50%>
 +
 +~~REFNOTES cite /2 ~~
 +
 +<newcolumn>
 +
 +~~REFNOTES cite ~~
 +
 +</columns>
 +
 +\\