How To Create A Bibliographic Entry

How To Create a Bibliographic Entry#

This is an Recipe used for the References page.

Bibliographic Entries#

A bibliographic entry like:

has the source: 

! Brooks1985

* ''[A Robust Layered Control System for a Mobile Robot|https://people.csail.mit.edu/brooks/papers/AIM-864.pdf]'', \\
   Rodney A. Brooks, A.I. Memo 864, MIT Artificial Intelligence Laboratory, September 1985.

and a link to it such as (Brooks1985) has the source: 

[(Brooks1985)|References#section-Brooks1985]

We'll explain the how and why of this below...

How do I Create a Bibliographic Entry?#

A typical bibliographic reference includes a Reference Identifier followed by:

Generally, the Reference Identifier will be the last name of the author and the year, e.g., "Brooks1985". It should not include any spaces. We'll cover that more below.

Reference Information#

Include the title, author, publisher/publication and date. You can either expose the link URL (a link to a web page or PDF) by enclosing it in square brackets or hide it, using the work's title as the link text. The title of the work is generally styled in italics (surrounded by two single quotes). A new line can be created by double backslashes.

For example:

or

See Text Formatting Rules for more details on formatting text.

The Reference Identifier/Link Target#

In order to provide link targets so that other pages can link to the bibliographic reference, each reference should follow a "!" heading, where the heading title is the intended reference identifier (called a "link target" on the web).

For example, to create a bibliographic reference for Rodney Brooks' 1985 article on subsumption architectures we'd use the reference identifier "Brooks1985":

Brooks1985#

as: 

! Brooks1985

You can look at the source of this page to see how this was done (using "View Page Source" item under the "More..." menu near top-right). The latter of the two examples above has the source: 

! Brooks1985

* ''[A Robust Layered Control System for a Mobile Robot|https://people.csail.mit.edu/brooks/papers/AIM-864.pdf]'', \\
   Rodney A. Brooks, A.I. Memo 864, MIT Artificial Intelligence Laboratory, September 1985.

To link to a reference you include the page name followed by "#" and the section identifier for the bibliographic reference. You can find the section identifier by hovering over the heading; a small "#" icon will pop up to the right of the heading title. You can hover over that icon to see the link identifier in your browser (generally, a right click menu to "Copy Link Location", but don't use the whole URL, just the page name and fragment identifier).

In the case where an author has created more than one article for a given year, you can add an "a", "b", or some distinguishing mark to the end of the reference identifier, e.g. "Brooks1985a".

Linking to the Bibliographic Reference#

On this page (normally it would be on the References page), the link to the Brooks1985 bibliographic reference would look like: 

[Brooks1985|HowToCreateABibliographicEntry#section-HowToCreateABibliographicEntry-Brooks1985]
Stylistically, a bibliographic reference is normally surrounded by square brackets, which on this wiki would create a link. We can't do that. So, on this wiki we'll resort to using plain-old parenthesis, as in: "(Brooks1985)". This means source for the "(Brooks1985)" link looks like: 
[(Brooks1985)|HowToCreateABibliographicEntry#section-HowToCreateABibliographicEntry-Brooks1985]
That is:   "[" + "(" + ReferenceId + ")" + "|" + PageName + "#section-" + ReferenceId + "]".

(sorry, it's a bit complicated... hopefully this explanation helped.)

Tags:  Recipe

Copyright 2020 NZPRG. All Rights Reserved. Distributed under a Creative Commons Attribution 4.0 International license