Bibliography:Usage
From Old Bailey Wiki
The OBPO bibliography facility separates content from output, by means of Citation and Display pages.
Contents |
Citations
Citation pages contain the bibliographical data for cited works in the bibliography. You create Citations simply by typing/pasting the information about a work into a page in the usual way and then annotating (marking up) key elements of the text so that SMW can recognise it as structured data. This data can then be extracted, manipulated and shown on display pages in various formats.
This makes the addition of data for the bibliography quite flexible. It doesn't matter how the information is ordered or laid out, providing the necessary information is marked up, and you can include any further information, notes or comments you wish. You can also make corrections or revisions to the marked-up text at any time after initial page creation.
There is a significant limitation to this flexibility that should be remembered, however: you cannot have more than one Citation per wiki page.
Here's an example of what a marked-up citation could look like in an editing screen:
[[Author::Devereaux, S.]]. '[[Title::The City and the Sessions Paper: "Public Justice" in London, 1770-1800]]'. ''[[Journal::Journal of British Studies]]'', [[Volume::35]] ([[Year::1996]]). [[Pages::466-503]]. [[Pubtype::article]]. Subject(s): [[Keyword::Publishing History]].
On the published wiki page, it would simply look like this (see the actual Citation page for this publication):
Devereaux, S. 'The City and the Sessions Paper: "Public Justice" in London, 1770-1800'.
Journal of British Studies, 35 (1996).
466-503. article.
Subject(s): Publishing History.
Display pages
SMW has a special query syntax, using {{#ask:...}}, for extracting and outputting the data contained in Citation pages. The OBPO Bibliography is generated using this syntax, and citations marked up as described below will appear there automatically without you needing to do anything further.
If you want to create customised outputs for your own pages, however, you'll need to learn how to use the #ask syntax. It's a very powerful and sophisticated facility, which enables not simply different search queries but also different layout options. It's quite complex and will not be explained here. Please consult the detailed help in the SMW user manual for guidance. You can try out more advanced searching techniques using SMW's built-in search. (You can also look at the wiki code in existing display pages for hints on inline usage.)
Before you start to add or edit Citations
It's important to read this guidance carefully to ensure that your citation appears in the OBPO Bibliography. It's a bit more complex than ordinary wiki pages, and accuracy in spelling and so on of the markup properties is very important. If you're still uncertain about what to do, you can look at the wiki code of existing citation pages for examples.
Please check before starting that there isn't already a citation for the work in the bibliography!
Please also check the accuracy of the information before adding it to the database. We reserve the right to delete inaccurate or very incomplete citations.
The recommended page name format for OBPO Bibliography citations is <FirstAuthorSurname><YearofPublication>, eg Devereaux1996 or Smith2005. (Add a letter at the end if there's already a work for that author name in that year, or initials after the name if you want to distinguish people with the same surname.)
How to Mark up Citations
The markup uses what are known as Properties. These are applied to text in a similar way to Categories. You probably already know that to add a page to a Category you use this format:
[[Category:categoryname]]
The basic difference between this and the markup for a property in the bibliography is the use of two colons "::" instead of just the one. As with categories and wikilinks, they are enclosed between double square brackets.
For example, for an Author:
[[Author::Smith, J]]
Or, for the title of a journal:
[[Journal::Social History]]
If you want to add wiki markup such as bold or italics for appearance, it needs to go outside the square brackets.
''[[Journal::Social History]]''
If your citation fails to appear in the bibliography as expected, don't panic. Check that there are no typos in the markup, including in the keywords. (The 'Browse Properties' link at the bottom of the sidebar can be helpful for checking this out.)
Basic Properties
Please provide as much of the following information as possible. You should provide as a bare minimum: Author(s)/Editor(s), Title, Year, Booktitle/Journal (where appropriate) and you must provide at least one Keyword if you want the work to appear in the OBPO bibliography.
Author
Example: [[Author::Shoemaker, Robert]]
This is used for the author(s) of a work, not for editors (see Editor). It should ideally be in the form Surname, firstname/initials for all authors.
Where the item has multiple authors, each individual author needs to be separately marked up: eg [[Author::Smith, J]] and [[Author::Brown, Jane]], not [[Author::Smith, J and Brown, Jane]].
Editor
Example: [[Editor::Hitchcock, Tim]]
If there are multiple editors, each one needs to be marked up separately, as with authors. If the author of a chapter being cited is also an editor of the book, s/he should be marked up separately in each capacity.
(Sometimes special editions of journals have named editors. These should probably not be marked up as editors - the output may not work correctly.)
Title
Example: [[Title::Crime in Early Modern Europe]]
Title of the individual work being cited (see also Journal and Booktitle below).
Year
Example: [[Year::1995]]
This is for the year in which the work was published. Please provide this if at all possible; if there is no known publication date for the work, use 'n.d'.
Journal
Example: [[Journal::Criminal Justice History]]
Used to mark up the title of the journal when citing an article.
Volume
Example: [[Volume::100]]
Volume/number of journal (should be provided if possible).
Pages
Example: [[Pages::251-276]]
Page numbers for articles or chapters, if known.
Booktitle
Example: [[Booktitle::Law and Order in Eighteenth-Century England]]
Used to mark up the title of the book when citing a chapter/essay in an edited collection. It is not used in a citation for the book as a whole: for that, use the 'Title' property.
Address
Example: [[Address::London]]
Place of publication, if known.
Keyword
Example: [[Keyword::Crime]]
Used to summarise the key topics of the item, usually single words or short phrases. If multiple keywords are appropriate, each one must be marked up separately.
It's crucial to provide at least one keyword for each citation from the list of existing keywords. Without this the citation won't appear in the bibliography.
You can add any extra keywords you wish for creating custom display pages (these will simply be ignored by the OBPO bibliography).
Finally, it's helpful if you add each Citation page to the Citation Category (using the Add Category box at the bottom of the saved page). You can, of course, add the page to any other additional categories that seem relevant.
Additional properties
The following are also available and can be included in new citations or added to existing ones.
Pubtype
Example: [[Pubtype::book]]
One of the following is recommended:
- book
- article
- chapter
- essay
- dissertation [use for any level university dissertation or thesis]
- other
Note
Example: [[Note::Chapter 1 discusses the sources available]]
This can be used to include some additional information about the cited item in the display page. You can use it more than once in a citation, but each Note can't be more than 255 characters in length. This property is suited to information such as summaries of chapters, appendices, or information about different editions, but it is not recommended for marking up any detailed commentary on an item (which should be left simply as free text).
URL
Example: [[URL::http://www.scholarlyarticles.ac.uk]]
Use this to include web links related to the cited item - could be online versions of the full text, reviews, abstracts, etc. You can include as many as you like in each citation, but each one must be marked up separately, as in the example.
DOI
Example: [[DOI::...]]
write up needed
