!!! How To Create a Bibliographic Entry

This is an [Recipe] used for the [References] page.

* __Author:__ [Murray Altheim]

!! Bibliographic Entries

A bibliographic entry like: 

* ''[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.

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)|References#section-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:

* the __title__ of the work
* the __author__ of the work
* the __publisher__ or publication of the work
* the publication __date__
* a __link__ to the work

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:

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

* ''[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.

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.)''

----

[{Tag Recipe}]