Help:Simple Wiki Bibliography

From CNBH Acoustic Scale Wiki

Jump to: navigation, search

The Simple Wiki Bibliography is inspired by the BibTeX natbib package. It comes in two parts: a reference manager and a set of commands to cite papers and produce a reference list. While using the reference manager, keep in mind that it is in alpha version...

Contents

Reference manager

The reference manager can be accessed here. You must first import your references in the manager in order to be able to cite them in a text. For the moment only BibTeX can be imported as most reference manager softwares are able to export in this format. You can also import entries using their PubMed number (PMID). Other import method such as EndNote and ISI will be added in the future.

Once you have imported your references, they will be available for citation. All you need is a citation reference. To find it, you can search papers in the reference manager. Just copy the reference (e.g. andrews:1998) and paste it in a citation tag, as described below.

Important note: for the moment, the reference manager only handles files coded in utf-8. If you want to import a file with another encoding, convert it first to utf-8.

Citation

Basic commands

To cite a paper, just invoke a citation tag. Here are the different citation tag available:

<citet r="andrews:1998, cooper:2007"/>, for a citation in text.

<citep r="andrews:1998, cooper:2007"/>, for a citation between parentheses.

<citetL r="andrews:1998, cooper:2007"/>, for a citation in text with the whole list of authors.

<citepL r="andrews:1998, cooper:2007"/>, for a citation between parentheses with the whole list of authors.

<citea r="andrews:1998"/>, to print only the authors with no year.

<citeaL r="andrews:1998"/>, to print all the authors with no year.

<citey r="andrews:1998"/>, to print the year only.

<cites r="andrews:1998"/>, like <code>citep</code> without the round brackets.

Will produce:

Andrews et al. (1998), Cooper and Roberts (2007), for a citation in text.

(Andrews et al., 1998; Cooper and Roberts, 2007), for a citation between parentheses.

Andrews, Dowling, Bartlett and Halpern (1998), Cooper and Roberts (2007), for a citation in text with the whole list of authors.

(Andrews, Dowling, Bartlett and Halpern, 1998; Cooper and Roberts, 2007), for a citation between parentheses with the whole list of authors.

Andrews et al., to print only the authors with no year.

Andrews, Dowling, Bartlett and Halpern, to print all the authors with no year.

1998, to print the year only.

Andrews et al., 1998, like citep without the round brackets.

To produce the reference list, just use:

<bibliography/>

See the result at the bottom of this page. You can also change the title of the bibliography:

<bibliography t="== Bibliography =="/>

Advanced commands

If you want to add a paper to the reference list without showing the citation in the text, you can use the following tag:

<nocite r="bacon:2004"/>

If you want to produce a citation in parentheses but with text before and after:

<citep before="text before," r="brokx:1982, byrne:1994" after="text after"/>

Will produce:

(text before, Brokx and Nooteboom, 1982; Byrne et al., 1994 text after)

If you use a reference that is not in the database, it will display like this: !! Unknown ref toto au pays des merveilles !! so that you cannot miss it...

It is also possible to display a complete reference by using the bibref tag:

<bibref r="ives:2008"/>

Will produce:

Ives, D.T. and Patterson, R.D. (2008). “Pitch strength decreases as F0 and harmonic resolution increase in complex tones composed exclusively of high harmonics.” J. Acoust. Soc. Am., 123, p.2670-9.

More advanced commands

The style used for the bibliography can be defined at the beginning of the article, at least before the first citation though multiple and later calls will not produce an error. The style must be defined this way:

<bibliostyle s="style name"/>

However, for the moment, only the "default" style exists. If a style that does not exist is called, the system falls back to the default style.

If you have a paper that was initially built against another bibliography database with different entry references, you do not have to replace all the references in the text. You can simply use the bibmap tag:

<bibmap m="ref_in_the_text@=ref_in_the_database, ref_txt2@=ref_db2"/>

You just have to provide a comma separated list of expression of the form: id of the reference in the text @= id of the reference in the swBib database. If you put many bibmap tags they will be concatenated. You can also still use directly the ids of the swBib database since their not mapped to another entry.

For example:

<bibmap m="myRef1@=brokx:1982"/><citet r="myRef1, byrne:1994"/>

Will produce: Brokx and Nooteboom (1982), Byrne et al. (1994).

Mapping tags should be defined at the beginning of the document.

References

Personal tools
Namespaces
Variants
Views
Actions
Navigation