[1146] | 1 | <?xml version="1.0" encoding="utf-8" ?>
|
---|
| 2 | <!--
|
---|
| 3 | Warning:
|
---|
| 4 | The Sandcastle Styles patch must be applied for the bibliography feature
|
---|
| 5 | to work. Visit http://www.codeplex.com/SandcastleStyles and apply the latest patch
|
---|
| 6 | -before- creating a new DocProject or DocSite.
|
---|
| 7 |
|
---|
| 8 | Auto-Generated Bibliography
|
---|
| 9 |
|
---|
| 10 | The bibliography feature looks for <cite>name</cite> elements in XML documentation
|
---|
| 11 | and <ddue:cite>name</ddue:cite> elements in MAML and automatically generates links
|
---|
| 12 | to a bibliography section, which is generated at the bottom of each topic.
|
---|
| 13 |
|
---|
| 14 | To use this feature in MAML you must also add the <ddue:bibliography/> element
|
---|
| 15 | somewhere in your topics; preferably, right before the <ddue:relatedTopics> section.
|
---|
| 16 |
|
---|
| 17 | This file is used to describe the entries in the bibliographies for every topic
|
---|
| 18 | that is generated. For example, add a remarks section such as the following to
|
---|
| 19 | the XML documentation comments in one of your APIs.
|
---|
| 20 |
|
---|
| 21 | <remarks>
|
---|
| 22 | <para>
|
---|
| 23 | Sandcastle is a popular download<cite>sandcastle activity</cite>.
|
---|
| 24 | </para>
|
---|
| 25 | <para>
|
---|
| 26 | Sandcastle Styles<cite>sandcastle styles</cite> adds even more value.
|
---|
| 27 | </para>
|
---|
| 28 | <para>
|
---|
| 29 | I expect Sandcastle's popularity<cite>sandcastle activity</cite> to increase
|
---|
| 30 | as more community members become aware of its usefulness, with the help of
|
---|
| 31 | projects like Sandcastle Styles<cite>sandcastle styles</cite>.
|
---|
| 32 | </para>
|
---|
| 33 | </remarks>
|
---|
| 34 |
|
---|
| 35 | Then add the following reference elements to this file to describe those citations.
|
---|
| 36 |
|
---|
| 37 | <reference name="sandcastle activity">
|
---|
| 38 | <title>Sandcastle Activity Statistics</title>
|
---|
| 39 | <author>Microsoft</author>
|
---|
| 40 | <publisher>CodePlex.com</publisher>
|
---|
| 41 | <link>http://www.codeplex.com/Sandcastle/stats/view</link>
|
---|
| 42 | </reference>
|
---|
| 43 | <reference name="sandcastle styles">
|
---|
| 44 | <title>Sandcastle Styles</title>
|
---|
| 45 | <author>Paul Selormey, Eric Woodruff, Dave Sexton</author>
|
---|
| 46 | <publisher>CodePlex.com</publisher>
|
---|
| 47 | <link>http://www.codeplex.com/SandcastleStyles</link>
|
---|
| 48 | </reference>
|
---|
| 49 |
|
---|
| 50 | Building documentation now will produce your auto-generated reference topic with a
|
---|
| 51 | bibliography section near the bottom. Each <cite>name</cite> is replaced in-line
|
---|
| 52 | with a hyperlink such as [1], [2], [3], [n]..., linking to the corresponding
|
---|
| 53 | entries in the bibliography section.
|
---|
| 54 |
|
---|
| 55 | - The title element is required.
|
---|
| 56 | - The author element is required.
|
---|
| 57 | - The publisher element is optional.
|
---|
| 58 | - The link element is optional.
|
---|
| 59 | - Reference names are case-sensitive.
|
---|
| 60 | - If a matching reference is not found, the cite element is processed as regular
|
---|
| 61 | markup. Currently, the transformations will remove the outer <cite> element but
|
---|
| 62 | inner text and content may pass through to the topic.
|
---|
| 63 | -->
|
---|
| 64 | <bibliography>
|
---|
| 65 | <!-- Add <reference> elements here -->
|
---|
| 66 | </bibliography>
|
---|