• View
• Edit
• History
• Print

00008

 

Citation: Numeric references

My preferred reference style is numbered, rather than author–year. How do I do that?

Detail of a scribe at work

Wikipublisher provides 2 markup rules: cite is inline markup for referencing a citation; and bib (introduced in Tip of the Week 00002) is block markup for defining a list of citations. They work like this.

    In cite(Morville:2005), we learn that finding things is useful.

    (:bib page=TipOfTheWeek.00002 fmt=num:)

    (:bibend:)

This produces:

In the above markup clip, we are able to cite a book described on another page, by using the page=Name option to bring that page’s citation list into the current page.The bib directive also includes a fmt=num option to request numbered references. In addition, an administrator can set group- or site-wide defaults, using the $CiteOpt array. For example, to make numeric references the default, set:

    $CiteOpt['fmt'] = 'num';

On this page, the list of references includes only those items cited on the page. We can include all references by specifying fmt=# (numbered) or fmt=* (author–year) in the bib directive. For many uses, cite(key) is all the writer needs. However, the cite markup offers a number of ways to vary the form of the body reference. For example:

• cite(Benkler:2006"p.42") → [1, p.42]
• citet(Benkler:2006) → Benkler [1]
• citeT(Benkler:2006) → Benkler
• citep(Varney:2006) → 3
• citeP("see"Varney:2006) → [see Varney, 3]

The references are sorted into key order. To list them in the order cited, add sort=cite to the bib directive. For more information on the wiki citation features, see Bibliographies.

¹ The (:markup:) block markup is not fully compatible with (:bib:) markup. This is a side-effect of the way PmWiki evaluates (:markup:) blocks. (↑)

Category: markup

« 00007 · Edit Form · 00009 »