| OLD | NEW |
|---|
| (Empty) |
| 1 <refentry xmlns="http://docbook.org/ns/docbook" | |
| 2 xmlns:xlink="http://www.w3.org/1999/xlink" | |
| 3 xmlns:xi="http://www.w3.org/2001/XInclude" | |
| 4 xmlns:src="http://nwalsh.com/xmlns/litprog/fragment" | |
| 5 xmlns:xsl="http://www.w3.org/1999/XSL/Transform" | |
| 6 version="5.0" xml:id="bibliography.collection"> | |
| 7 <refmeta> | |
| 8 <refentrytitle>bibliography.collection</refentrytitle> | |
| 9 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo> | |
| 10 </refmeta> | |
| 11 <refnamediv> | |
| 12 <refname>bibliography.collection</refname> | |
| 13 <refpurpose>Name of the bibliography collection file</refpurpose> | |
| 14 </refnamediv> | |
| 15 | |
| 16 <refsynopsisdiv> | |
| 17 <src:fragment xml:id="bibliography.collection.frag"> | |
| 18 <xsl:param name="bibliography.collection">http://docbook.sourceforge.net/release
/bibliography/bibliography.xml</xsl:param> | |
| 19 | |
| 20 </src:fragment> | |
| 21 </refsynopsisdiv> | |
| 22 | |
| 23 <refsection><info><title>Description</title></info> | |
| 24 | |
| 25 <para>Maintaining bibliography entries across a set of documents is tedious, tim
e | |
| 26 consuming, and error prone. It makes much more sense, usually, to store all of | |
| 27 the bibliography entries in a single place and simply <quote>extract</quote> | |
| 28 the ones you need in each document.</para> | |
| 29 | |
| 30 <para>That's the purpose of the | |
| 31 <parameter>bibliography.collection</parameter> parameter. To setup a global | |
| 32 bibliography <quote>database</quote>, follow these steps:</para> | |
| 33 | |
| 34 <para>First, create a stand-alone bibliography document that contains all of | |
| 35 the documents that you wish to reference. Make sure that each bibliography | |
| 36 entry (whether you use <tag>biblioentry</tag> or <tag>bibliomixed</tag>) | |
| 37 has an ID.</para> | |
| 38 | |
| 39 <para>My global bibliography, <filename>~/bibliography.xml</filename> begins | |
| 40 like this:</para> | |
| 41 | |
| 42 <informalexample> | |
| 43 <programlisting><!DOCTYPE bibliography | |
| 44 PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" | |
| 45 "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"> | |
| 46 <bibliography><title>References</title> | |
| 47 | |
| 48 <bibliomixed id="xml-rec"><abbrev>XML 1.0</abbrev>Tim Bray, | |
| 49 Jean Paoli, C. M. Sperberg-McQueen, and Eve Maler, editors. | |
| 50 <citetitle><ulink url="http://www.w3.org/TR/REC-xml">Extensible Mark
up | |
| 51 Language (XML) 1.0 Second Edition</ulink></citetitle>. | |
| 52 World Wide Web Consortium, 2000. | |
| 53 </bibliomixed> | |
| 54 | |
| 55 <bibliomixed id="xml-names"><abbrev>Namespaces</abbrev>Tim Bra
y, | |
| 56 Dave Hollander, | |
| 57 and Andrew Layman, editors. | |
| 58 <citetitle><ulink url="http://www.w3.org/TR/REC-xml-names/">Namespac
es in | |
| 59 XML</ulink></citetitle>. | |
| 60 World Wide Web Consortium, 1999. | |
| 61 </bibliomixed> | |
| 62 | |
| 63 <!-- ... --> | |
| 64 </bibliography> | |
| 65 </programlisting> | |
| 66 </informalexample> | |
| 67 | |
| 68 <para>When you create a bibliography in your document, simply | |
| 69 provide <emphasis>empty</emphasis> <tag>bibliomixed</tag> | |
| 70 entries for each document that you wish to cite. Make sure that these | |
| 71 elements have the same ID as the corresponding <quote>real</quote> | |
| 72 entry in your global bibliography.</para> | |
| 73 | |
| 74 <para>For example:</para> | |
| 75 | |
| 76 <informalexample> | |
| 77 <programlisting><bibliography><title>Bibliography</title> | |
| 78 | |
| 79 <bibliomixed id="xml-rec"/> | |
| 80 <bibliomixed id="xml-names"/> | |
| 81 <bibliomixed id="DKnuth86">Donald E. Knuth. <citetitle>Computers and | |
| 82 Typesetting: Volume B, TeX: The Program</citetitle>. Addison-Wesley, | |
| 83 1986. ISBN 0-201-13437-3. | |
| 84 </bibliomixed> | |
| 85 <bibliomixed id="relaxng"/> | |
| 86 | |
| 87 </bibliography></programlisting> | |
| 88 </informalexample> | |
| 89 | |
| 90 <para>Note that it's perfectly acceptable to mix entries from your | |
| 91 global bibliography with <quote>normal</quote> entries. You can use | |
| 92 <tag>xref</tag> or other elements to cross-reference your | |
| 93 bibliography entries in exactly the same way you do now.</para> | |
| 94 | |
| 95 <para>Finally, when you are ready to format your document, simply set the | |
| 96 <parameter>bibliography.collection</parameter> parameter (in either a | |
| 97 customization layer or directly through your processor's interface) to | |
| 98 point to your global bibliography.</para> | |
| 99 | |
| 100 <para>A relative path in the parameter is interpreted in one | |
| 101 of two ways:</para> | |
| 102 <orderedlist numeration="loweralpha"> | |
| 103 <listitem> | |
| 104 <para>If your document contains no links to empty bibliographic elements, | |
| 105 then the path is relative to the file containing | |
| 106 the first <tag>bibliomixed</tag> element in the document.</para> | |
| 107 </listitem> | |
| 108 <listitem> | |
| 109 <para>If your document does contain links to empty bibliographic elements, | |
| 110 then the path is relative to the file containing | |
| 111 the first such link element in the document.</para> | |
| 112 </listitem> | |
| 113 </orderedlist> | |
| 114 <para>Once the collection file is opened by the first instance described | |
| 115 above, it stays open for the current document | |
| 116 and the relative path is not reinterpreted again.</para> | |
| 117 | |
| 118 <para>The stylesheets will format the bibliography in your document as if | |
| 119 all of the entries referenced appeared there literally.</para> | |
| 120 | |
| 121 </refsection> | |
| 122 </refentry> | |
| OLD | NEW |
|---|
Chromium Code Reviews
Issue 1394993002:
Doing some cleanup. (Closed)
Base URL: https://github.com/dart-lang/www.dartlang.org.git@master