rfc2629.txt

著名的RFC文档,其中有一些文档是已经翻译成中文的的.

   produced the document, and the "keyword" elements identify useful
   search terms.












Rose                         Informational                      [Page 8]

RFC 2629            Writing I-Ds and RFCs using XML            June 1999


2.2.5 The abstract Element

   A document may have an "abstract" element, which contains one or more
   "t" elements (Section 2.3.1.1). In general, only a single "t" element
   is present, e.g.,

       <abstract>
           <t>This memo presents a technique for using XML
           (Extensible Markup Language) as a source format
           for documents in the Internet-Drafts (I-Ds) and
           Request for Comments (RFC) series.</t>
       </abstract>

2.2.6 The note Element

   A document may have one or more "note" elements, each of which
   contains one or more "t" elements (Section 2.3.1.1). There is a
   mandatory "title" attribute. In general, the "note" element contains
   text from the IESG, e.g.,

       <note title="IESG Note">
           <t>The IESG has something to say.</t>
       </note>

2.2.7 Status, Copyright Notice, Table of Contents

   Note that text relating to the memo's status, copyright notice, or
   table of contents is not included in the document's markup -- this is
   automatically inserted by an XML application when it produces either
   a text or HTML version of the document.

2.2.7.1 Conformance with RFC 2026

   If an Internet-Draft is being produced, then the "ipr" attribute
   should be present in the "<rfc>" tag at the beginning of the file.
   The value of the attribute should be one of:

   full2026: indicating that the document is in full conformance with
      all the provisions of Section 10 of RFC 2026;

   noDerivativeWorks2026: indicating that the document is in full
      conformance with all the provisions of Section 10 of RFC 2026
      except that the right to produce derivative works is not granted;
      or,

   none: indicating that the document is NOT offered in accordance with
      Section 10 of RFC 2026, and the author does not provide the IETF
      with any rights other than to publish as an Internet-Draft.



Rose                         Informational                      [Page 9]

RFC 2629            Writing I-Ds and RFCs using XML            June 1999


   In the latter case, a copyright notice will not be automatically
   inserted during processing by an XML application.

   Consult [3] for further details.

   Finally, if the Internet-Draft is being submitted to an automated
   process, then the "docName" attribute should be present in the
   "<rfc>" tag at the beginning of the file. The value of this attribute
   contains the document (not file) name associated with this Internet-
   Draft, e.g.,

       <rfc ipr="full" docName="draft-mrose-writing-rfcs-01">
           ...
       </rfc>

2.2.8 Everything in the Front

   So, putting it all together, we have, e.g.,

       <front>
           <title>Writing I-Ds and RFCs using XML</title>

           <author initials="M.T." surname="Rose"
                   fullname="Marshall T. Rose">
               <organization>Invisible Worlds, Inc.</organization>

               <address>
                   <postal>
                       <street>660 York Street</street>
                       <street>M/S 40</street>
                       <city>San Francisco</city> <region>CA</region>
                       <code>94110</code>
                       <country>US</country>
                   </postal>

                   <phone>[phone]</phone>
                   <email>[e-mail]</email>
                   <uri>http://invisible.net/</uri>
               </address>
           </author>

           <date month="February" year="1999" />

           <area>General</area>
           <workgroup>RFC Beautification Working Group</workgroup>
           <keyword>RFC</keyword>
           <keyword>Request for Comments</keyword>
           <keyword>I-D</keyword>



Rose                         Informational                     [Page 10]

RFC 2629            Writing I-Ds and RFCs using XML            June 1999


           <keyword>Internet-Draft</keyword>
           <keyword>XML</keyword>
           <keyword>Extensible Markup Language</keyword>
           <abstract>
               <t>This memo presents a technique for using XML
               (Extensible Markup Language) as a source format
               for documents in the Internet-Drafts (I-Ds) and
               Request for Comments (RFC) series.</t>
           </abstract>
       </front>

2.3 The Middle

   The "middle" element contains all the sections of the document except
   for the bibliography and appendices:

       ...
       </front>
       <middle>
           <section ...>
           <section ...>
           <section ...>
       </middle>
       <back>
       ...

   The "middle" element consists of one or more "section" elements.

2.3.1 The section Element

   Each "section" element contains a section of the document. There is a
   mandatory attribute, "title", that identifies the title of the
   section. There is also an optional attribute, "anchor", that is used
   for cross-referencing with the "xref" element (Section 2.3.1.4),
   e.g.,

       <section anchor="intro" title="Introduction">
           ...
       </section>












Rose                         Informational                     [Page 11]

RFC 2629            Writing I-Ds and RFCs using XML            June 1999


   The "section" element is recursive -- each contains any number and
   combination of "t", "figure", and "section" elements, e.g.,

       <section title="The Middle">
           ...
           <section title="The section Element">
               ...
               <section title="The t Element">...</section>
               <section title="The list Element">...</section>
               <section title="The figure Element">...</section>
               <section title="The xref Element">...</section>
               <section title="The eref Element">...</section>
               <section title="The iref Element">...</section>
           </section>
       </section>

2.3.1.1 The t Element

   The "t" element contains any number and combination of paragraphs,
   lists, and figures. If a cross-reference is needed to a section,
   figure, or reference, the "xref" element (Section 2.3.1.4) is used;
   similarly, if an external-reference is needed, the "eref" element
   (Section 2.3.1.5) is used. Indexing of text is provided by the the
   "iref" element (Section 2.3.1.6).

2.3.1.2 The list Element

   The "list" element contains one or more items. Each item is a "t"
   element, allowing for recursion, e.g.,

       <list style="numbers">
           <t>The pfirst item.</t>
           <t>The second item, which contains two bulleted sub-items:
               <list style="symbols">
                   <t>The first sub-item.</t>
                   <t>The second sub-item.</t>
               </list>
           </t>
       </list>

   The "list" element has an optional attribute, "style", having the
   value "numbers" (for numeric lists), "symbols" (for bulleted lists),
   "hanging" (for hanging lists), or, "empty" (for indented text). If a
   "list" element is nested, the default value is taken from its closest
   parent; otherwise, the default value is "empty".






Rose                         Informational                     [Page 12]

RFC 2629            Writing I-Ds and RFCs using XML            June 1999


   When nested within a "hanging list" element, the "t" element has an
   optional attribute, "hangText" that specifies the text to be
   inserted, e.g.,

       <list style="hanging">
           <t hangText="full2026:">indicating that the document is in
           full conformance with all the provisions of Section 10 of RFC
           2026;</t>

           <t hangText="noDerivativeWorks2026:">indicating that the
           document is in full conformance with all the provisions of
           Section 10 of RFC 2026 except that the right to produce
           derivative works is not granted; or,</t>

           <t hangText="none:">indicating that the document is NOT
           offered in accordance with Section 10 of RFC 2026, and the
           author does not provide the IETF with any rights other than
           to publish as an Internet-Draft.</t>
       </list>

2.3.1.3 The figure Element

   The "figure" element groups an optional "preamble" element, an
   "artwork" element, and an optional "postamble" element together. The
   "figure" element also has an optional "anchor" attribute that is used
   for cross-referencing with the "xref" element (Section 2.3.1.4).
   There is also an optional "title" attribute that identifies the title
   of the figure.

   The "preamble" and "postamble" elements, if present, are simply text.
   If a cross-reference is needed to a section, figure, or reference,
   the "xref" element (Section 2.3.1.4) is used; similarly, if an
   external-reference is needed, the "eref" element (Section 2.3.1.5) is
   used. Indexing of text is provided by the the "iref" element (Section
   2.3.1.6).

   The "artwork" element, which must be present, contains "ASCII
   artwork". Unlike text contained in the "t", "preamble", or
   "postamble" elements, both horizontal and vertical whitespace is
   significant in the "artwork" element.











Rose                         Informational                     [Page 13]

RFC 2629            Writing I-Ds and RFCs using XML            June 1999


   So, putting it all together, we have, e.g.,

       <figure anchor="figure_example">
           <preamble>So,
           putting it all together, we have, e.g.,</preamble>
           <artwork>
               ascii artwork goes here...

               be sure to use "&lt;" or "&amp;" instead of "<" and "&",
               respectively!
           </artwork>
           <postamble>which is a very simple example.</postamble>
       </figure>

   which is a very simple example.

   If you have artwork with a lot of "<" characters, then there's an XML
   trick you can use:

       <figure>
           <preamble>If you have artwork with a lot of "&lt;"
           characters, then there's an XML trick you can
           use:</preamble>
           <artwork><![CDATA[
               ascii artwork goes here...

               just don't use "]]" in your artwork!
           ]]></artwork>
           <postamble>The "&lt;![CDATA[ ... ]]>" construct is called
           a CDATA block -- everything between the innermost brackets
           is left alone by the XML application.</postamble>
       </figure>

   The "<![CDATA[ ... ]]>" construct is called a CDATA block --
   everything between the innermost brackets is left alone by the XML
   application.

   Because the "figure" element represents a logical grouping of text
   and artwork, an XML application producing a text version of the
   document should attempt to keep these elements on the same page.
   Because RFC 2223 [2] allows no more than 69 characters by 49 lines of
   content on each page, XML applications should be prepared to
   prematurely introduce page breaks to allow for better visual
   grouping.







Rose                         Informational                     [Page 14]

RFC 2629            Writing I-Ds and RFCs using XML            June 1999


   Finally, the "artwork" element has two optional attributes: "name"
   and "type". The former is used to suggest a filename to use when
   storing the content of the "artwork" element, whilst the latter
   contains a suggestive data-typing for the content.

2.3.1.4 The xref Element

   The "xref" element is used to cross-reference sections, figures, and
   references. The mandatory "target" attribute is used to link back to
   the "anchor" attribute of the "section", "figure", and "reference"
   elements. The value of the "anchor" and "target" attributes should be
   formatted according to the token syntax in Section 2.1.

   If used as an empty element, e.g.,

       according to the token syntax in <xref target="xml_basics" />.

   then the XML application inserts an appropriate phrase during
   processing, such as "Section 2.1" or "<a href="#xml_basics">XML
   Basics</a>".

   If used with content, e.g.,

       conforming to <xref target="refs.RFC2223">RFC 2223</xref>.

   then the XML application inserts an appropriate designation during
   processing, such as "RFC 2223 [2]" or "<a href="#refs.RFC2223">RFC
   2223</a>". Although the XML application decides what "an appropriate
   designation" might be, its choice is consistent throughout the
   processing of the document.

2.3.1.5 The eref Element

   The "eref" element is used to reference external documents. The
   mandatory "target" attribute is a URI [4], e.g.,

       <eref target="http://metalab.unc.edu/xml/">Cafe con Leche</eref>

   Note that while the "target" attribute is always present, the "eref"
   element may be empty, e.g.,

       <eref target="http://invisible.net/" />

   and the XML application inserts an appropriate designation during
   processing such as "[9]" or "<a
   href="http://invisible.net/">http://invisible.net/</a>".





Rose                         Informational                     [Page 15]

RFC 2629            Writing I-Ds and RFCs using XML            June 1999


2.3.1.6 The iref Element

   The "iref" element is used to add information to an index. The
   mandatory "item" attribute is the primary key the information is
   stored under, whilst the optional "subitem" attribute is the
   secondary key, e.g.,

       <iref item="indexing" subitem="how to" />

   Finally, note that the "iref" element is always empty -- it never
   contains any text.

2.3.1.7 The vspace Element

   The "vspace" element, which may occur only inside the "t" element, is
   used by the author to provide formatting guidance to the XML
   application. There is an attribute, "blankLines", that indicates the
   number of blank lines that should be inserted. A physical linebreak
   is specified by using the default value, "0".

   In addition, the "vspace" element can be used to force a new physical
   paragraph within a list item, e.g.,

       <list style="numbers">