Citation: Cite references from a bibliography
How do I link to an item in a bibliography? What options are there for controlling how the link text appears?
Woodcut of a scholar with glasses
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 (re-using the bib list we defined before).
In cite(Morville:2005), we learn that finding things is useful.
(:bib page=TipOfTheWeek.00002:)
(:bibend:)
This produces:
In the above markup clip, we are able to cite a book described on another page, by using the page=… option to bring that page’s citation list into the current page. A word on terminology… A citation is a reference to a published item with sufficient detail to identify the item uniquely. The cite markup provides a reference from the body of the text to the citation in the bibliography; the citation provides a reference from the bibliography to the source. A bibliography is sometimes called a “list of references”.
On this page, the list of references includes only those items cited on the page. For many uses, cite(key) is all the writer needs. However, the cite markup also offers a number of ways to vary the form of the body reference. For example:
- cite(Benkler:2006"p.42") → Benkler (2006, p.42)
- citeT(Benkler:2006) → Benkler
- citeY(Benkler:2006) → (2006)
- citeP(Varney:2006) → (Varney, 2006)
- cite-P("see"Varney:2006) → see Varney, 2006
As far as we can determine, the wiki citation feature is unique to Wikipublisher.
1 Unfortunately, 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
References for 00007
Benkler, Y. (2006). The Wealth of Networks: How Social Production Transforms Markets and Freedom. New Haven and London: Yale University Press. yalepress.yale.edu/YUPBOOKS/book.asp?isbn=0300110561, accessed on 30 May 2007.
Morville, P. (2005). Ambient Findability: what we find changes who we become. Sebastopol: O’Reilly Media, Inc. www.oreilly.com/catalog/ambient/, accessed on 10 June 2007.
Varney, D. (2006). Service transformation: A better service for citizens and businesses, a better deal for the taxpayer. UK: HM Treasury. www.hm-treasury.gov.uk/pre_budget_report/prebud_pbr06/other_docs/prebud_pbr06_varney.cfm, accessed on 11 June 2007.
