Internet Architecture Board (IAB)                     J. Hildebrand, Ed.
Request for Comments: 7992                                       Mozilla
Category: Informational                                       P. Hoffman
ISSN: 2070-1721                                                    ICANN
                                                           December 2016
        
Internet Architecture Board (IAB)                     J. Hildebrand, Ed.
Request for Comments: 7992                                       Mozilla
Category: Informational                                       P. Hoffman
ISSN: 2070-1721                                                    ICANN
                                                           December 2016
        

HTML Format for RFCs

RFCs的HTML格式

Abstract

摘要

In order to meet the evolving needs of the Internet community, the canonical format for RFCs is changing from a plain-text, ASCII-only format to an XML format that will, in turn, be rendered into several publication formats. This document defines the HTML format that will be rendered for an RFC or Internet-Draft.

为了满足互联网社区不断发展的需求,RFC的标准格式正在从纯文本、仅ASCII格式转变为XML格式,而XML格式又将被转换为多种出版物格式。本文档定义了将为RFC或Internet草稿呈现的HTML格式。

Status of This Memo

关于下段备忘

This document is not an Internet Standards Track specification; it is published for informational purposes.

本文件不是互联网标准跟踪规范;它是为了提供信息而发布的。

This document is a product of the Internet Architecture Board (IAB) and represents information that the IAB has deemed valuable to provide for permanent record. It represents the consensus of the Internet Architecture Board (IAB). Documents approved for publication by the IAB are not a candidate for any level of Internet Standard; see Section 2 of RFC 7841.

本文件是互联网体系结构委员会(IAB)的产品,代表IAB认为有价值提供永久记录的信息。它代表了互联网体系结构委员会(IAB)的共识。IAB批准发布的文件不适用于任何级别的互联网标准;见RFC 7841第2节。

Information about the current status of this document, any errata, and how to provide feedback on it may be obtained at http://www.rfc-editor.org/info/rfc7992.

有关本文件当前状态、任何勘误表以及如何提供反馈的信息,请访问http://www.rfc-editor.org/info/rfc7992.

Copyright Notice

版权公告

Copyright (c) 2016 IETF Trust and the persons identified as the document authors. All rights reserved.

版权所有(c)2016 IETF信托基金和确定为文件作者的人员。版权所有。

This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document.

本文件受BCP 78和IETF信托有关IETF文件的法律规定的约束(http://trustee.ietf.org/license-info)自本文件出版之日起生效。请仔细阅读这些文件,因为它们描述了您对本文件的权利和限制。

Table of Contents

目录

   1.  Introduction  . . . . . . . . . . . . . . . . . . . . . . . .   4
   2.  Requirements for the HTML Format  . . . . . . . . . . . . . .   5
     2.1.  Requirements for Accessibility  . . . . . . . . . . . . .   6
   3.  HTML Version  . . . . . . . . . . . . . . . . . . . . . . . .   7
   4.  HTML Syntax . . . . . . . . . . . . . . . . . . . . . . . . .   7
   5.  Common Items  . . . . . . . . . . . . . . . . . . . . . . . .   8
     5.1.  IDs . . . . . . . . . . . . . . . . . . . . . . . . . . .   8
     5.2.  Pilcrows  . . . . . . . . . . . . . . . . . . . . . . . .   8
   6.  Front Matter  . . . . . . . . . . . . . . . . . . . . . . . .   9
     6.1.  DOCTYPE . . . . . . . . . . . . . . . . . . . . . . . . .   9
     6.2.  Root Element  . . . . . . . . . . . . . . . . . . . . . .   9
     6.3.  <head> Element  . . . . . . . . . . . . . . . . . . . . .   9
       6.3.1.  Charset Declaration . . . . . . . . . . . . . . . . .   9
       6.3.2.  Document Title  . . . . . . . . . . . . . . . . . . .  10
       6.3.3.  Document Metadata . . . . . . . . . . . . . . . . . .  10
       6.3.4.  Link to XML Source  . . . . . . . . . . . . . . . . .  10
       6.3.5.  Link to License . . . . . . . . . . . . . . . . . . .  10
       6.3.6.  Style . . . . . . . . . . . . . . . . . . . . . . . .  11
       6.3.7.  Links . . . . . . . . . . . . . . . . . . . . . . . .  11
     6.4.  Page Headers and Footers  . . . . . . . . . . . . . . . .  12
     6.5.  Document Information  . . . . . . . . . . . . . . . . . .  13
     6.6.  Table of Contents . . . . . . . . . . . . . . . . . . . .  14
   7.  Main Body . . . . . . . . . . . . . . . . . . . . . . . . . .  14
   8.  Back Matter . . . . . . . . . . . . . . . . . . . . . . . . .  14
     8.1.  Index . . . . . . . . . . . . . . . . . . . . . . . . . .  14
       8.1.1.  Index Contents  . . . . . . . . . . . . . . . . . . .  15
       8.1.2.  Index Letters . . . . . . . . . . . . . . . . . . . .  15
       8.1.3.  Index Items . . . . . . . . . . . . . . . . . . . . .  16
       8.1.4.  Index Subitems  . . . . . . . . . . . . . . . . . . .  16
     8.2.  Authors' Addresses Section  . . . . . . . . . . . . . . .  17
     8.3.  Document Information  . . . . . . . . . . . . . . . . . .  18
   9.  Elements  . . . . . . . . . . . . . . . . . . . . . . . . . .  18
     9.1.  <abstract>  . . . . . . . . . . . . . . . . . . . . . . .  18
     9.2.  <address> . . . . . . . . . . . . . . . . . . . . . . . .  19
     9.3.  <annotation>  . . . . . . . . . . . . . . . . . . . . . .  19
     9.4.  <area>  . . . . . . . . . . . . . . . . . . . . . . . . .  19
     9.5.  <artwork> . . . . . . . . . . . . . . . . . . . . . . . .  20
       9.5.1.  Text Artwork  . . . . . . . . . . . . . . . . . . . .  20
       9.5.2.  SVG Artwork . . . . . . . . . . . . . . . . . . . . .  20
       9.5.3.  Other Artwork . . . . . . . . . . . . . . . . . . . .  21
     9.6.  <aside> . . . . . . . . . . . . . . . . . . . . . . . . .  21
     9.7.  <author>  . . . . . . . . . . . . . . . . . . . . . . . .  21
       9.7.1.  Authors in Document Information . . . . . . . . . . .  22
       9.7.2.  Authors of This Document  . . . . . . . . . . . . . .  22
       9.7.3.  Authors of References . . . . . . . . . . . . . . . .  24
     9.8.  <back>  . . . . . . . . . . . . . . . . . . . . . . . . .  24
        
   1.  Introduction  . . . . . . . . . . . . . . . . . . . . . . . .   4
   2.  Requirements for the HTML Format  . . . . . . . . . . . . . .   5
     2.1.  Requirements for Accessibility  . . . . . . . . . . . . .   6
   3.  HTML Version  . . . . . . . . . . . . . . . . . . . . . . . .   7
   4.  HTML Syntax . . . . . . . . . . . . . . . . . . . . . . . . .   7
   5.  Common Items  . . . . . . . . . . . . . . . . . . . . . . . .   8
     5.1.  IDs . . . . . . . . . . . . . . . . . . . . . . . . . . .   8
     5.2.  Pilcrows  . . . . . . . . . . . . . . . . . . . . . . . .   8
   6.  Front Matter  . . . . . . . . . . . . . . . . . . . . . . . .   9
     6.1.  DOCTYPE . . . . . . . . . . . . . . . . . . . . . . . . .   9
     6.2.  Root Element  . . . . . . . . . . . . . . . . . . . . . .   9
     6.3.  <head> Element  . . . . . . . . . . . . . . . . . . . . .   9
       6.3.1.  Charset Declaration . . . . . . . . . . . . . . . . .   9
       6.3.2.  Document Title  . . . . . . . . . . . . . . . . . . .  10
       6.3.3.  Document Metadata . . . . . . . . . . . . . . . . . .  10
       6.3.4.  Link to XML Source  . . . . . . . . . . . . . . . . .  10
       6.3.5.  Link to License . . . . . . . . . . . . . . . . . . .  10
       6.3.6.  Style . . . . . . . . . . . . . . . . . . . . . . . .  11
       6.3.7.  Links . . . . . . . . . . . . . . . . . . . . . . . .  11
     6.4.  Page Headers and Footers  . . . . . . . . . . . . . . . .  12
     6.5.  Document Information  . . . . . . . . . . . . . . . . . .  13
     6.6.  Table of Contents . . . . . . . . . . . . . . . . . . . .  14
   7.  Main Body . . . . . . . . . . . . . . . . . . . . . . . . . .  14
   8.  Back Matter . . . . . . . . . . . . . . . . . . . . . . . . .  14
     8.1.  Index . . . . . . . . . . . . . . . . . . . . . . . . . .  14
       8.1.1.  Index Contents  . . . . . . . . . . . . . . . . . . .  15
       8.1.2.  Index Letters . . . . . . . . . . . . . . . . . . . .  15
       8.1.3.  Index Items . . . . . . . . . . . . . . . . . . . . .  16
       8.1.4.  Index Subitems  . . . . . . . . . . . . . . . . . . .  16
     8.2.  Authors' Addresses Section  . . . . . . . . . . . . . . .  17
     8.3.  Document Information  . . . . . . . . . . . . . . . . . .  18
   9.  Elements  . . . . . . . . . . . . . . . . . . . . . . . . . .  18
     9.1.  <abstract>  . . . . . . . . . . . . . . . . . . . . . . .  18
     9.2.  <address> . . . . . . . . . . . . . . . . . . . . . . . .  19
     9.3.  <annotation>  . . . . . . . . . . . . . . . . . . . . . .  19
     9.4.  <area>  . . . . . . . . . . . . . . . . . . . . . . . . .  19
     9.5.  <artwork> . . . . . . . . . . . . . . . . . . . . . . . .  20
       9.5.1.  Text Artwork  . . . . . . . . . . . . . . . . . . . .  20
       9.5.2.  SVG Artwork . . . . . . . . . . . . . . . . . . . . .  20
       9.5.3.  Other Artwork . . . . . . . . . . . . . . . . . . . .  21
     9.6.  <aside> . . . . . . . . . . . . . . . . . . . . . . . . .  21
     9.7.  <author>  . . . . . . . . . . . . . . . . . . . . . . . .  21
       9.7.1.  Authors in Document Information . . . . . . . . . . .  22
       9.7.2.  Authors of This Document  . . . . . . . . . . . . . .  22
       9.7.3.  Authors of References . . . . . . . . . . . . . . . .  24
     9.8.  <back>  . . . . . . . . . . . . . . . . . . . . . . . . .  24
        
     9.9.  <bcp14> . . . . . . . . . . . . . . . . . . . . . . . . .  25
     9.10. <blockquote>  . . . . . . . . . . . . . . . . . . . . . .  25
     9.11. <boilerplate> . . . . . . . . . . . . . . . . . . . . . .  26
     9.12. <br>  . . . . . . . . . . . . . . . . . . . . . . . . . .  26
     9.13. <city>  . . . . . . . . . . . . . . . . . . . . . . . . .  26
     9.14. <code>  . . . . . . . . . . . . . . . . . . . . . . . . .  26
     9.15. <country> . . . . . . . . . . . . . . . . . . . . . . . .  26
     9.16. <cref>  . . . . . . . . . . . . . . . . . . . . . . . . .  27
     9.17. <date>  . . . . . . . . . . . . . . . . . . . . . . . . .  27
     9.18. <dd>  . . . . . . . . . . . . . . . . . . . . . . . . . .  27
     9.19. <displayreference>  . . . . . . . . . . . . . . . . . . .  27
     9.20. <dl>  . . . . . . . . . . . . . . . . . . . . . . . . . .  27
     9.21. <dt>  . . . . . . . . . . . . . . . . . . . . . . . . . .  27
     9.22. <em>  . . . . . . . . . . . . . . . . . . . . . . . . . .  28
     9.23. <email> . . . . . . . . . . . . . . . . . . . . . . . . .  28
     9.24. <eref>  . . . . . . . . . . . . . . . . . . . . . . . . .  28
     9.25. <figure>  . . . . . . . . . . . . . . . . . . . . . . . .  28
     9.26. <front> . . . . . . . . . . . . . . . . . . . . . . . . .  28
     9.27. <iref>  . . . . . . . . . . . . . . . . . . . . . . . . .  29
     9.28. <keyword> . . . . . . . . . . . . . . . . . . . . . . . .  29
     9.29. <li>  . . . . . . . . . . . . . . . . . . . . . . . . . .  29
     9.30. <link>  . . . . . . . . . . . . . . . . . . . . . . . . .  29
     9.31. <middle>  . . . . . . . . . . . . . . . . . . . . . . . .  29
     9.32. <name>  . . . . . . . . . . . . . . . . . . . . . . . . .  29
     9.33. <note>  . . . . . . . . . . . . . . . . . . . . . . . . .  30
     9.34. <ol>  . . . . . . . . . . . . . . . . . . . . . . . . . .  30
       9.34.1.  Percent Styles . . . . . . . . . . . . . . . . . . .  30
       9.34.2.  Standard Styles  . . . . . . . . . . . . . . . . . .  30
     9.35. <organization>  . . . . . . . . . . . . . . . . . . . . .  31
     9.36. <phone> . . . . . . . . . . . . . . . . . . . . . . . . .  31
     9.37. <postal>  . . . . . . . . . . . . . . . . . . . . . . . .  31
     9.38. <postalLine>  . . . . . . . . . . . . . . . . . . . . . .  32
     9.39. <refcontent>  . . . . . . . . . . . . . . . . . . . . . .  32
     9.40. <reference> . . . . . . . . . . . . . . . . . . . . . . .  33
     9.41. <referencegroup>  . . . . . . . . . . . . . . . . . . . .  33
     9.42. <references>  . . . . . . . . . . . . . . . . . . . . . .  34
     9.43. <region>  . . . . . . . . . . . . . . . . . . . . . . . .  34
     9.44. <relref>  . . . . . . . . . . . . . . . . . . . . . . . .  35
       9.44.1.  displayFormat='of' . . . . . . . . . . . . . . . . .  35
       9.44.2.  displayFormat='comma'  . . . . . . . . . . . . . . .  35
       9.44.3.  displayFormat='parens' . . . . . . . . . . . . . . .  36
       9.44.4.  displayFormat='bare' . . . . . . . . . . . . . . . .  36
     9.45. <rfc> . . . . . . . . . . . . . . . . . . . . . . . . . .  37
     9.46. <section> . . . . . . . . . . . . . . . . . . . . . . . .  37
     9.47. <seriesInfo>  . . . . . . . . . . . . . . . . . . . . . .  37
     9.48. <sourcecode>  . . . . . . . . . . . . . . . . . . . . . .  38
     9.49. <street>  . . . . . . . . . . . . . . . . . . . . . . . .  38
     9.50. <strong>  . . . . . . . . . . . . . . . . . . . . . . . .  38
        
     9.9.  <bcp14> . . . . . . . . . . . . . . . . . . . . . . . . .  25
     9.10. <blockquote>  . . . . . . . . . . . . . . . . . . . . . .  25
     9.11. <boilerplate> . . . . . . . . . . . . . . . . . . . . . .  26
     9.12. <br>  . . . . . . . . . . . . . . . . . . . . . . . . . .  26
     9.13. <city>  . . . . . . . . . . . . . . . . . . . . . . . . .  26
     9.14. <code>  . . . . . . . . . . . . . . . . . . . . . . . . .  26
     9.15. <country> . . . . . . . . . . . . . . . . . . . . . . . .  26
     9.16. <cref>  . . . . . . . . . . . . . . . . . . . . . . . . .  27
     9.17. <date>  . . . . . . . . . . . . . . . . . . . . . . . . .  27
     9.18. <dd>  . . . . . . . . . . . . . . . . . . . . . . . . . .  27
     9.19. <displayreference>  . . . . . . . . . . . . . . . . . . .  27
     9.20. <dl>  . . . . . . . . . . . . . . . . . . . . . . . . . .  27
     9.21. <dt>  . . . . . . . . . . . . . . . . . . . . . . . . . .  27
     9.22. <em>  . . . . . . . . . . . . . . . . . . . . . . . . . .  28
     9.23. <email> . . . . . . . . . . . . . . . . . . . . . . . . .  28
     9.24. <eref>  . . . . . . . . . . . . . . . . . . . . . . . . .  28
     9.25. <figure>  . . . . . . . . . . . . . . . . . . . . . . . .  28
     9.26. <front> . . . . . . . . . . . . . . . . . . . . . . . . .  28
     9.27. <iref>  . . . . . . . . . . . . . . . . . . . . . . . . .  29
     9.28. <keyword> . . . . . . . . . . . . . . . . . . . . . . . .  29
     9.29. <li>  . . . . . . . . . . . . . . . . . . . . . . . . . .  29
     9.30. <link>  . . . . . . . . . . . . . . . . . . . . . . . . .  29
     9.31. <middle>  . . . . . . . . . . . . . . . . . . . . . . . .  29
     9.32. <name>  . . . . . . . . . . . . . . . . . . . . . . . . .  29
     9.33. <note>  . . . . . . . . . . . . . . . . . . . . . . . . .  30
     9.34. <ol>  . . . . . . . . . . . . . . . . . . . . . . . . . .  30
       9.34.1.  Percent Styles . . . . . . . . . . . . . . . . . . .  30
       9.34.2.  Standard Styles  . . . . . . . . . . . . . . . . . .  30
     9.35. <organization>  . . . . . . . . . . . . . . . . . . . . .  31
     9.36. <phone> . . . . . . . . . . . . . . . . . . . . . . . . .  31
     9.37. <postal>  . . . . . . . . . . . . . . . . . . . . . . . .  31
     9.38. <postalLine>  . . . . . . . . . . . . . . . . . . . . . .  32
     9.39. <refcontent>  . . . . . . . . . . . . . . . . . . . . . .  32
     9.40. <reference> . . . . . . . . . . . . . . . . . . . . . . .  33
     9.41. <referencegroup>  . . . . . . . . . . . . . . . . . . . .  33
     9.42. <references>  . . . . . . . . . . . . . . . . . . . . . .  34
     9.43. <region>  . . . . . . . . . . . . . . . . . . . . . . . .  34
     9.44. <relref>  . . . . . . . . . . . . . . . . . . . . . . . .  35
       9.44.1.  displayFormat='of' . . . . . . . . . . . . . . . . .  35
       9.44.2.  displayFormat='comma'  . . . . . . . . . . . . . . .  35
       9.44.3.  displayFormat='parens' . . . . . . . . . . . . . . .  36
       9.44.4.  displayFormat='bare' . . . . . . . . . . . . . . . .  36
     9.45. <rfc> . . . . . . . . . . . . . . . . . . . . . . . . . .  37
     9.46. <section> . . . . . . . . . . . . . . . . . . . . . . . .  37
     9.47. <seriesInfo>  . . . . . . . . . . . . . . . . . . . . . .  37
     9.48. <sourcecode>  . . . . . . . . . . . . . . . . . . . . . .  38
     9.49. <street>  . . . . . . . . . . . . . . . . . . . . . . . .  38
     9.50. <strong>  . . . . . . . . . . . . . . . . . . . . . . . .  38
        
     9.51. <sub> . . . . . . . . . . . . . . . . . . . . . . . . . .  38
     9.52. <sup> . . . . . . . . . . . . . . . . . . . . . . . . . .  38
     9.53. <t> . . . . . . . . . . . . . . . . . . . . . . . . . . .  38
     9.54. <table> . . . . . . . . . . . . . . . . . . . . . . . . .  39
     9.55. <tbody> . . . . . . . . . . . . . . . . . . . . . . . . .  39
     9.56. <td>  . . . . . . . . . . . . . . . . . . . . . . . . . .  39
     9.57. <tfoot> . . . . . . . . . . . . . . . . . . . . . . . . .  39
     9.58. <th>  . . . . . . . . . . . . . . . . . . . . . . . . . .  39
     9.59. <thead> . . . . . . . . . . . . . . . . . . . . . . . . .  39
     9.60. <title> . . . . . . . . . . . . . . . . . . . . . . . . .  39
     9.61. <tr>  . . . . . . . . . . . . . . . . . . . . . . . . . .  39
     9.62. <tt>  . . . . . . . . . . . . . . . . . . . . . . . . . .  40
     9.63. <ul>  . . . . . . . . . . . . . . . . . . . . . . . . . .  40
     9.64. <uri> . . . . . . . . . . . . . . . . . . . . . . . . . .  40
     9.65. <workgroup> . . . . . . . . . . . . . . . . . . . . . . .  40
     9.66. <xref>  . . . . . . . . . . . . . . . . . . . . . . . . .  40
     9.67. <svg xmlns='http://www.w3.org/2000/svg'>  . . . . . . . .  41
   10. Security Considerations . . . . . . . . . . . . . . . . . . .  41
   11. References  . . . . . . . . . . . . . . . . . . . . . . . . .  41
     11.1.  Normative References . . . . . . . . . . . . . . . . . .  41
     11.2.  Informative References . . . . . . . . . . . . . . . . .  42
   IAB Members at the Time of Approval . . . . . . . . . . . . . . .  43
   Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . . .  43
   Authors' Addresses  . . . . . . . . . . . . . . . . . . . . . . .  43
        
     9.51. <sub> . . . . . . . . . . . . . . . . . . . . . . . . . .  38
     9.52. <sup> . . . . . . . . . . . . . . . . . . . . . . . . . .  38
     9.53. <t> . . . . . . . . . . . . . . . . . . . . . . . . . . .  38
     9.54. <table> . . . . . . . . . . . . . . . . . . . . . . . . .  39
     9.55. <tbody> . . . . . . . . . . . . . . . . . . . . . . . . .  39
     9.56. <td>  . . . . . . . . . . . . . . . . . . . . . . . . . .  39
     9.57. <tfoot> . . . . . . . . . . . . . . . . . . . . . . . . .  39
     9.58. <th>  . . . . . . . . . . . . . . . . . . . . . . . . . .  39
     9.59. <thead> . . . . . . . . . . . . . . . . . . . . . . . . .  39
     9.60. <title> . . . . . . . . . . . . . . . . . . . . . . . . .  39
     9.61. <tr>  . . . . . . . . . . . . . . . . . . . . . . . . . .  39
     9.62. <tt>  . . . . . . . . . . . . . . . . . . . . . . . . . .  40
     9.63. <ul>  . . . . . . . . . . . . . . . . . . . . . . . . . .  40
     9.64. <uri> . . . . . . . . . . . . . . . . . . . . . . . . . .  40
     9.65. <workgroup> . . . . . . . . . . . . . . . . . . . . . . .  40
     9.66. <xref>  . . . . . . . . . . . . . . . . . . . . . . . . .  40
     9.67. <svg xmlns='http://www.w3.org/2000/svg'>  . . . . . . . .  41
   10. Security Considerations . . . . . . . . . . . . . . . . . . .  41
   11. References  . . . . . . . . . . . . . . . . . . . . . . . . .  41
     11.1.  Normative References . . . . . . . . . . . . . . . . . .  41
     11.2.  Informative References . . . . . . . . . . . . . . . . .  42
   IAB Members at the Time of Approval . . . . . . . . . . . . . . .  43
   Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . . .  43
   Authors' Addresses  . . . . . . . . . . . . . . . . . . . . . . .  43
        
1. Introduction
1. 介绍

As described in [RFC7990], the RFC Series is changing. One of those changes includes the RFC Editor publishing a non-canonical HTML version of RFCs.

如[RFC7990]所述,RFC系列正在发生变化。其中一个更改包括RFC编辑器发布RFC的非规范HTML版本。

This document describes the HTML format that will be used as one of the publication formats for the RFC Series. It defines a strict subset of HTML appropriate for RFC Series documents. The visual layout of the document will be defined through a cascading style sheet (CSS) [W3C.REC-CSS2-20110607]. The CSS will be included in the HTML file but will be described in [RFC7993].

本文档描述了将用作RFC系列出版物格式之一的HTML格式。它定义了适用于RFC系列文档的严格HTML子集。文档的视觉布局将通过层叠样式表(CSS)[W3C.REC-CSS2-20110607]定义。CSS将包含在HTML文件中,但将在[RFC7993]中描述。

The details (particularly any vocabularies) described in this document are expected to change based on experience gained in implementing the new publication toolsets. Revised documents will be published capturing those changes as the toolsets are completed. Other implementers must not expect those changes to remain backwards compatible with the details described in this document.

本文档中描述的详细信息(尤其是词汇表)预计将根据在实施新发布工具集过程中获得的经验进行更改。修订后的文档将在工具集完成后发布,以捕获这些更改。其他实施者不得期望这些更改与本文档中描述的细节保持向后兼容。

2. Requirements for the HTML Format
2. HTML格式的要求

This section lists the design requirements used to create the HTML format described in this document. These requirements build on those found in [RFC6949]. Many of these requirements are naturally fulfilled by using the output of the preparation tool [RFC7998].

本节列出了用于创建本文档中描述的HTML格式的设计要求。这些要求以[RFC6949]中的要求为基础。通过使用准备工具[RFC7998]的输出,这些要求中的许多自然得到了满足。

o The HTML has to render correctly on a list of browser versions that the RFC Editor will keep up to date outside of this document.

o HTML必须在RFC编辑器将在此文档之外保持最新的浏览器版本列表上正确呈现。

o The format will consist of a subset of HTML deemed to be widely implemented by common browsers at the time the specification is created, likely to continue to be widely implemented, and unlikely to cause security issues. This will maximize the chances that future HTML renderers (such as new web browsers) will continue to produce readable text from the HTML format without the format needing to be changed frequently.

o 该格式将由HTML的子集组成,这些HTML在创建规范时被认为是由普通浏览器广泛实现的,可能会继续被广泛实现,并且不太可能导致安全问题。这将最大限度地提高未来HTML呈现器(如新的web浏览器)继续从HTML格式生成可读文本的可能性,而无需频繁更改格式。

o These requirements are expected to change in the future to reflect the expectation that HTML rendering will be required for current versions of browsers and platforms, while ideally continuing to render correctly on recent versions of those browsers.

o 这些要求预计将在未来发生变化,以反映当前版本的浏览器和平台将需要HTML呈现的预期,同时理想情况下继续在这些浏览器的最新版本上正确呈现。

o The HTML documents from the RFC Editor or Internet-Drafts directory may be re-rendered from the canonical XML format in the future to ensure the ongoing readability of the documents. The intent is that any re-rendering would be due to exceptional circumstances rather than for minor annoyances.

o 将来,RFC编辑器或Internet草稿目录中的HTML文档可能会从规范XML格式重新呈现,以确保文档的持续可读性。其目的是,任何重新渲染都是由于特殊情况,而不是因为小麻烦。

o The HTML must display adequately in at least one text-based browser. Some consumers of the RFC Series can only access the documents on text-based terminals.

o HTML必须至少在一个基于文本的浏览器中充分显示。RFC系列的某些使用者只能在基于文本的终端上访问文档。

o The HTML document will be self-contained, without requiring external files for images, CSS, JavaScript, or the like. This will allow the HTML file to be moved over various non-HTTP transports (such as email, FTP, and rsync) without breakage.

o HTML文档将是自包含的,不需要图像、CSS、JavaScript等外部文件。这将允许HTML文件在各种非HTTP传输(如电子邮件、FTP和rsync)上移动而不会中断。

o JavaScript will be supported on a limited basis. It will not be permitted to overwrite or change any text present in the rendered HTML. It may, on a limited basis, add additional text that provides post-publication metadata or pointers if warranted. All such text will be clearly marked as additional.

o JavaScript将在有限的基础上得到支持。不允许覆盖或更改呈现HTML中的任何文本。它可能会在有限的基础上添加额外的文本,以提供发布后元数据或指针(如有必要)。所有此类文本将明确标记为附加文本。

o The HTML document will allow easy local override of the default CSS formatting. This will allow users who have a different visual style that they prefer to make RFCs display with that style without having to alter the contents of the HTML document. This

o HTML文档将允许轻松地本地覆盖默认CSS格式。这将允许具有不同视觉样式的用户使用该样式显示RFC,而无需更改HTML文档的内容。这

might also be valuable for allowing people with specific accessibility needs to use a customized CSS.

对于允许具有特定可访问性需求的人使用定制的CSS来说,这可能也是很有价值的。

o HTML tags in documents will rarely have attributes whose only purpose is to affect the rendered styling, and those will only be used if it would not be possible to specify that styling in a CSS. No such attributes are known at this time.

o 文档中的HTML标记很少具有仅用于影响呈现样式的属性,并且只有在无法在CSS中指定该样式时才会使用这些属性。目前尚不知道此类属性。

o Both user-defined and auto-generated anchors must be supported and linkable, with user-defined anchors appearing in an "id" attribute. Auto-generated anchors will be generated for every heading, paragraph, and so on, not just those that do not have user-defined anchors. User-defined anchors may, and auto-generated anchors will, appear next to paragraphs, figures, tables, blockquotes, and section titles.

o 用户定义的锚和自动生成的锚都必须受支持并可链接,用户定义的锚显示在“id”属性中。将为每个标题、段落等生成自动生成的锚定,而不仅仅是那些没有用户定义锚定的锚定。用户定义的锚定可能会出现在段落、图表、表格、块引号和章节标题旁边,自动生成的锚定也会出现在段落、图表、表格、块引号和章节标题旁边。

o All sections, subsections, figures, and paragraphs should have stable numbered link anchors. Additionally, anchors expressed in the source XML should be exposed as anchors in the HTML output as well.

o 所有章节、小节、图和段落应具有稳定的编号链接锚。此外,源XML中表示的锚也应该在HTML输出中作为锚公开。

o The HTML must make it easy to separate sections along with all of their subsections into separate files. This will make creating EPUB documents easier in the future.

o HTML必须能够轻松地将部分及其所有子部分分离到单独的文件中。这将使将来创建EPUB文档变得更容易。

o The HTML produced for Internet-Drafts will differ from that produced by the RFC Editor due to differences in the output from the prep tool.

o 由于prep工具的输出不同,为Internet草稿生成的HTML将不同于RFC编辑器生成的HTML。

o The abstract must be marked up or tagged in a way that popular search engines will extract it as a summary.

o 摘要必须以流行搜索引擎将其提取为摘要的方式进行标记或标记。

2.1. Requirements for Accessibility
2.1. 无障碍要求

o Normative information must be easily accessible to the following consumers:

o 规范性信息必须便于以下消费者获取:

* People with impaired vision, including those that use large fonts and those that use screen readers

* 视力受损的人,包括使用大字体的人和使用屏幕阅读器的人

* People with difficulty distinguishing between colors

* 难以区分颜色的人

* People who use devices with small screens, such as cell phones

* 使用小屏幕设备的人,如手机

o Specific instances where goals for accessibility are important in the design choices of the format have been called out in the text.

o 文中列举了可访问性目标在格式设计选择中很重要的具体实例。

o Note: designing for these consumers does not preclude the use of features they cannot use, but it does require that key semantic data not be lost when read using the tools and settings that are required by a given constituency.

o 注意:为这些消费者设计并不排除使用他们无法使用的功能,但它确实要求在使用给定选区所需的工具和设置读取时,关键语义数据不会丢失。

3. HTML Version
3. HTML版本

The RFC Editor will periodically determine which version of the HTML specification will be referenced for tools generating the format defined in this document. The starting version will be that defined in [W3C.REC-html5-20141028], commonly known as "HTML5". Although the HTML specification mandates several of the syntax and structure rules described in this document, they are called out here for emphasis.

RFC编辑器将定期确定生成本文档中定义的格式的工具将引用哪个版本的HTML规范。起始版本将是[W3C.REC-html5-20141028]中定义的版本,通常称为“html5”。尽管HTML规范规定了本文档中描述的几种语法和结构规则,但此处将它们作为重点。

4. HTML Syntax
4. HTML语法

The processor emitting HTML from the XML source will follow these rules:

从XML源发出HTML的处理器将遵循以下规则:

o The HTML output is encoded as UTF-8, as specified in [RFC3629].

o HTML输出编码为UTF-8,如[RFC3629]所述。

o The document is valid HTML.

o 该文档是有效的HTML。

o Double quotes (U+0022 QUOTATION MARK: ") are used to quote attribute values unless the HTML specification forbids quoting a particular attribute.

o 双引号(U+0022引号:)用于引用属性值,除非HTML规范禁止引用特定属性。

o Each logical line is terminated solely with a \n (U+000A: LINE FEED), otherwise known as "Unix-style" line endings.

o 每个逻辑行仅以一个\n(U+000A:换行符)终止,否则称为“Unix样式”行结束符。

o Code points below (U+0020: SPACE) or character entity references that generate them (e.g. &#9;), other than (U+000A: LINE FEED) may not be used. Note: this rule explicitly forbids \t (U+0009: CHARACTER TABULATION), \f (U+000C: FORM FEED), and \r (U+000D: CARRIAGE RETURN) from appearing in the HTML output.

o 除了(U+000A:换行符)之外,不能使用下面的代码点(U+0020:空格)或生成它们的字符实体引用(例如&#9;)。注意:此规则明确禁止\t(U+0009:字符制表)、\f(U+000C:表单提要)和\r(U+000D:回车符)出现在HTML输出中。

o Comments in the source XML, if any, will not be copied into the HTML.

o 源XML中的注释(如果有)将不会复制到HTML中。

o The HTML output will be pretty-printed, using whatever consistent rules are deemed best by the developers of the HTML production tools.

o HTML输出将被打印出来,使用HTML生产工具的开发人员认为最好的一致性规则。

Note: none of these rules affect the rendered output of the HTML, but they are intended to increase the chance that text comparison tools (e.g., "diff") that operate on the HTML output are easier to write.

注意:这些规则都不会影响HTML的呈现输出,但它们旨在增加操作HTML输出的文本比较工具(例如,“diff”)更容易编写的可能性。

5. Common Items
5. 常见项目

This section lists items that are common across multiple parts of the HTML document.

本节列出HTML文档多个部分中常见的项目。

5.1. IDs
5.1. 身份证

HTML elements that are generated from XML elements that include an "anchor" attribute will use the value of the "anchor" attribute as the value of the "id" attribute of the corresponding HTML element. The prep tool produces XML with "anchor" attributes in all elements that need them. Some HTML constructs (such as <section>) will use multiple instances of these identifiers.

从包含“anchor”属性的XML元素生成的HTML元素将使用“anchor”属性的值作为相应HTML元素的“id”属性的值。prep工具在所有需要它们的元素中生成具有“锚定”属性的XML。一些HTML构造(如<section>)将使用这些标识符的多个实例。

5.2. Pilcrows
5.2. 矮人

Each paragraph, artwork, or sourcecode segment outside of a <figure> or <table> element will be appended with a space and a "pilcrow" (U+00B6: PILCROW SIGN), otherwise known as a "paragraph sign". For the purposes of clarity in ASCII renderings of this document, in this document pilcrows are rendered as "&para;". The pilcrow will be linked to the "id" attribute on the XML entity to which it is associated using an <a> element of class "pilcrow". For example:

<figure>或<table>元素外部的每个段落、艺术品或源代码段将附加一个空格和一个“pilcrow”(U+00B6:pilcrow符号),也称为“段落符号”。为清晰起见,在本文件的ASCII呈现中,pilcrow呈现为“&para;”。pilcrow将使用类“pilcrow”的<a>元素链接到与其关联的XML实体上的“id”属性。例如:

   <p id="s-1.1-1">
     Some paragraph text. <a class="pilcrow" href="#s-1.1-1">&para;</a>
   </p>
        
   <p id="s-1.1-1">
     Some paragraph text. <a class="pilcrow" href="#s-1.1-1">&para;</a>
   </p>
        

The pilcrow will normally be invisible unless the element it is attached to is moused over. The pilcrow will be surrounded by a link that points to the element it is attached to.

皮尔克罗通常是不可见的,除非它所连接的元素被鼠标移到上面。pilcrow将被一个指向它所附着的元素的链接包围。

Pilcrows are never included inside a <table> or <figure> element, since the figure number or table number serves as an adequate link target.

Pilcrow从不包含在<table>或<figure>元素中,因为图号或表号作为适当的链接目标。

Elements that might otherwise contain a pilcrow do not get marked with a pilcrow if they contain one or more child elements that are marked with a pilcrow. For example:

如果可能包含pilcrow的元素包含一个或多个子元素并用pilcrow标记,则不会用pilcrow标记这些元素。例如:

   <blockquote id="s-1.2-1">
     <p id="s-1.2-2">Four score and seven years ago our fathers brought
       forth on this continent, a new nation, conceived in Liberty, and
       dedicated to the proposition that all men are created equal.
       <a href="#s-1.2-2" class="pilcrow">&para;</a></p>
     <!-- NO pilcrow here -->
   </blockquote>
        
   <blockquote id="s-1.2-1">
     <p id="s-1.2-2">Four score and seven years ago our fathers brought
       forth on this continent, a new nation, conceived in Liberty, and
       dedicated to the proposition that all men are created equal.
       <a href="#s-1.2-2" class="pilcrow">&para;</a></p>
     <!-- NO pilcrow here -->
   </blockquote>
        
6. Front Matter
6. 前沿问题

The front matter of the HTML format contains processing information, metadata of various types, and styling information that applies to the document as a whole. This section describes HTML that is not necessarily a direct transform from the XML format. For more details on each of the tags that generate content in this section, see Section 9.

HTML格式的前端包含处理信息、各种类型的元数据以及应用于整个文档的样式信息。本节描述的HTML不一定是XML格式的直接转换。有关本节中生成内容的每个标记的更多详细信息,请参阅第9节。

6.1. DOCTYPE
6.1. DOCTYPE

The DOCTYPE of the document is "html", which declares that the document is compliant with HTML5. The document will start with exactly this string:

文档的DOCTYPE是“html”,它声明文档符合HTML5。文档将以以下字符串开头:

   <!DOCTYPE html>
        
   <!DOCTYPE html>
        
6.2. Root Element
6.2. 根元素

The root element of the document is <html>. This element includes a "lang" attribute, whose value is a language tag, as discussed in [RFC5646], that describes the natural language of the document. The language tag to be included is "en". The class of the <html> element will be copied verbatim from the XML <rfc> element's <front> element's <seriesInfo> element's "name" attributes (separated by spaces; see Section 2.47.3 of [RFC7991]), allowing CSS to style RFCs and Internet-Drafts differently from one another (if needed):

文档的根元素是<html>。该元素包括一个“lang”属性,其值是一个语言标记,如[RFC5646]中所述,描述文档的自然语言。要包含的语言标签为“en”。<html>元素的类将从XML<rfc>元素的<front>元素的<seriesInfo>元素的“name”属性(用空格分隔;请参见[RFC7991]的第2.47.3节)逐字复制,允许CSS以不同的方式设置rfc和Internet草稿的样式(如果需要):

   <html lang="en" class="RFC">
        
   <html lang="en" class="RFC">
        
6.3. <head> Element
6.3. <head>元素

The root <html> will contain a <head> element that contains the following elements, as needed.

根<html>将包含一个<head>元素,该元素根据需要包含以下元素。

6.3.1. Charset Declaration
6.3.1. 字符集声明

In order to be correctly processed by browsers that load the HTML using a mechanism that does not provide a valid content-type or charset (such as from a local file system using a "file:" URL), the HTML <head> element contains a <meta> element, whose "charset" attribute value is "utf-8":

为了让浏览器能够正确地处理使用不提供有效内容类型或字符集的机制(例如从使用“文件:”URL的本地文件系统)加载HTML的HTML,HTML<head>元素包含一个<meta>元素,其“字符集”属性值为“utf-8”:

   <meta charset="utf-8">
        
   <meta charset="utf-8">
        
6.3.2. Document Title
6.3.2. 文件标题

The contents of the <title> element from the XML source will be placed inside an HTML <title> element in the header.

XML源中<title>元素的内容将放在标题中的HTML<title>元素中。

6.3.3. Document Metadata
6.3.3. 文档元数据

The following <meta> elements will be included:

将包括以下<meta>元素:

o author - one each for the each of the "fullname"s and "asciiFullname"s of all of the <author>s from the <front> of the XML source

o author-XML源的<front>中所有<author>的“fullname”和“asciiFullname”各一个

o description - the <abstract> from the XML source

o description-来自XML源的<abstract>

o generator - the name and version number of the software used to create the HTML

o 生成器-用于创建HTML的软件的名称和版本号

o keywords - comma-separated <keyword>s from the XML source

o 关键字-从XML源中以逗号分隔的<keyword>s

For example:

例如:

   <meta name="author" content="Joe Hildebrand">
   <meta name="author" content="JOE HILDEBRAND">
   <meta name="author" content="Heather Flanagan">
   <meta name="description" content="This document defines...">
   <meta name="generator" content="xmljade v0.2.4">
   <meta name="keywords" content="html,css,rfc">
        
   <meta name="author" content="Joe Hildebrand">
   <meta name="author" content="JOE HILDEBRAND">
   <meta name="author" content="Heather Flanagan">
   <meta name="description" content="This document defines...">
   <meta name="generator" content="xmljade v0.2.4">
   <meta name="keywords" content="html,css,rfc">
        

Note: the HTML <meta> tag does not contain a closing slash.

注意:HTML<meta>标记不包含结束斜杠。

6.3.4. Link to XML Source
6.3.4. 链接到XML源

The <head> element contains a <link> tag, with "rel" attribute of "alternate", "type" attribute of "application/rfc+xml", and "href" attribute pointing to the prepared XML source that was used to generate this document.

<head>元素包含一个<link>标记,其中“rel”属性为“alternate”,“type”属性为“application/rfc+xml”,而“href”属性指向用于生成此文档的准备好的xml源。

   <link rel="alternate" type="application/rfc+xml" href="source.xml">
        
   <link rel="alternate" type="application/rfc+xml" href="source.xml">
        
6.3.5. Link to License
6.3.5. 链接到许可证

The <head> element contains a <link> tag, with "rel" attribute of "license" and "href" attribute pointing to the an appropriate copyright license for the document.

<head>元素包含一个<link>标记,其中“rel”属性为“license”,而“href”属性指向文档的相应版权许可证。

   <link rel="license"
      href="https://trustee.ietf.org/trust-legal-provisions.html">
        
   <link rel="license"
      href="https://trustee.ietf.org/trust-legal-provisions.html">
        
6.3.6. Style
6.3.6. 风格

The <head> element contains an embedded CSS in a <style> element. The styles in the style sheet are to be set consistently between documents by the RFC Editor, according to the best practices of the day.

<head>元素在<style>元素中包含嵌入式CSS。RFC编辑器将根据当时的最佳实践,在文档之间一致地设置样式表中的样式。

To ensure consistent formatting, individual style attributes should not be used in the main portion of the document.

为确保格式一致,文档的主要部分不应使用单个样式属性。

Different readers of a specification will desire different formatting when reading the HTML versions of RFCs. To facilitate this, the <head> element also includes a <link> to a style sheet in the same directory as the HTML file, named "rfc-local.css". Any formatting in the linked style sheet will override the formatting in the included style sheet. For example:

在阅读RFC的HTML版本时,规范的不同读者需要不同的格式。为了方便起见,<head>元素还包括一个<link>,指向与HTML文件位于同一目录中的样式表,名为“rfc local.css”。链接样式表中的任何格式都将替代包含的样式表中的格式。例如:

   <style>
     body {}
     ...
   </style>
   <link rel="stylesheet" type="text/css" href="rfc-local.css">
        
   <style>
     body {}
     ...
   </style>
   <link rel="stylesheet" type="text/css" href="rfc-local.css">
        
6.3.7. Links
6.3.7. 链接

Each <link> element from the XML source is copied into the HTML header. Note: the HTML <link> element does not include a closing slash.

XML源中的每个<link>元素都被复制到HTML头中。注意:HTML<link>元素不包含结束斜杠。

6.4. Page Headers and Footers
6.4. 页眉和页脚

In order to simplify printing by HTML renderers that implement [W3C.WD-css3-page-20130314], a hidden HTML <table> tag of class "ears" is added at the beginning of the HTML <body> tag, containing HTML <thead> and <tfoot> tags, each of which contains an HTML <tr> tag, which contains three HTML <td> tags with class "left", "center", and "right", respectively.

为了简化实现[W3C.WD-css3-page-20130314]的HTML呈现器的打印,在HTML<body>标记的开头添加了一个隐藏的HTML<table>类“ears”标记,其中包含HTML<thead>和<tfoot>标记,每个标记都包含一个HTML<tr>标记,其中包含三个带有类“left”、“center”和“right”的HTML<td>标记,分别地

The <thead> corresponds to the top of the page, the <tfoot> to the bottom. The string "[Page]" can be used as a placeholder for the page number. In practice, this must always be in the <tfoot>'s right <td>, and no control of the formatting of the page number is implied.

<thead>对应于页面的顶部,<tfoot>对应于页面的底部。字符串“[Page]”可用作页码的占位符。实际上,这必须始终位于<tfoot>的右侧<td>,并且不意味着控制页码的格式。

   <table class="ears">
     <thead>
       <tr>
         <td class="left">Internet-Draft</td>
         <td class="center">HTML RFC</td>
         <td class="right">March 2016</td>
       </tr>
     </thead>
     <tfoot>
       <tr>
         <td class="left">Hildebrand</td>
         <td class="center">Expires September 2, 2016</td>
         <td class="right">[Page]</td>
       </tr>
     </tfoot>
   </table>
        
   <table class="ears">
     <thead>
       <tr>
         <td class="left">Internet-Draft</td>
         <td class="center">HTML RFC</td>
         <td class="right">March 2016</td>
       </tr>
     </thead>
     <tfoot>
       <tr>
         <td class="left">Hildebrand</td>
         <td class="center">Expires September 2, 2016</td>
         <td class="right">[Page]</td>
       </tr>
     </tfoot>
   </table>
        
6.5. Document Information
6.5. 文件信息

Information about the document as a whole will appear as the first child of the HTML <body> element, embedded in an HTML <dl> element with id="identifiers". The defined terms in the definition list are "Workgroup:", "Series:", "Status:", "Published:", and "Author:" or "Authors:" (as appropriate). For example:

关于文档整体的信息将作为HTML<body>元素的第一个子元素出现,嵌入到带有id=“identifiers”的HTML<dl>元素中。定义列表中定义的术语为“工作组:”、“系列:”、“状态:”、“已发布:”、“作者:”、“作者:”(视情况而定)。例如:

   <dl id="identifiers">
     <dt>Workgroup:</dt>
       <dd class="workgroup">rfc-interest</dd>
     <dt>Series:</dt>
       <dd class="series">Internet-Draft</dd>
     <dt>Status:</dt>
       <dd class="status">Informational</dd>
     <dt>Published:</dt>
       <dd><time datetime="2014-10-25"
                 class="published">2014-10-25</time></dd>
     <dt>Authors:</dt>
       <dd class="authors">
         <div class="author">
           <span class="initial">J.</span>
           <span class="surname">Hildebrand</span>
           (<span class="organization">Cisco Systems, Inc.</span>)
           <span class="editor">Ed.</span>
         </div>
         <div class="author">
           <span class="initial">H.</span>
           <span class="surname">Flanagan</span>
           (<span class="organization">RFC Editor</span>)
         </div>
       </dd>
   </dl>
        
   <dl id="identifiers">
     <dt>Workgroup:</dt>
       <dd class="workgroup">rfc-interest</dd>
     <dt>Series:</dt>
       <dd class="series">Internet-Draft</dd>
     <dt>Status:</dt>
       <dd class="status">Informational</dd>
     <dt>Published:</dt>
       <dd><time datetime="2014-10-25"
                 class="published">2014-10-25</time></dd>
     <dt>Authors:</dt>
       <dd class="authors">
         <div class="author">
           <span class="initial">J.</span>
           <span class="surname">Hildebrand</span>
           (<span class="organization">Cisco Systems, Inc.</span>)
           <span class="editor">Ed.</span>
         </div>
         <div class="author">
           <span class="initial">H.</span>
           <span class="surname">Flanagan</span>
           (<span class="organization">RFC Editor</span>)
         </div>
       </dd>
   </dl>
        
6.6. Table of Contents
6.6. 目录

The table of contents will follow the boilerplate if the XML's <rfc> element's "tocInclude" attribute has the value "true". An HTML <h2> heading containing the text "Table of Contents" will be followed by a <nav> element that contains a <ul> element for each depth of the section hierarchy. Each section will be represented by a <li> element containing links by the section number (from the "pn" attribute) and by the name (from the "slugifiedName" attribute of the <name> child element). Each <nav>, <ul>, and <li> element will have the class "toc".

如果XML的<rfc>元素的“tocclude”属性的值为“true”,则目录将遵循样板文件。包含文本“目录”的HTML<h2>标题后面将跟随一个<nav>元素,该元素包含一个<ul>元素,用于节层次结构的每个深度。每个节将由一个<li>元素表示,该元素包含节号(来自“pn”属性)和名称(来自<name>子元素的“slugifiedName”属性)的链接。每个<nav>、<ul>和<li>元素都将具有类“toc”。

For example:

例如:

<h2 id="toc">Table of Contents</h2> <nav class="toc"> <ul class="toc"> <li class="toc"> <a href="s-1">1</a>. <a href="n-introduction">Introduction</a> </li> <ul class="toc"> <li class="toc"> <a href="s-1.1">1.1</a>. <a href="n-sub-intro">Sub Intro</a> </li> ...

目录<a href=“n-introduction”>简介</a></li><ul class=“toc”><li class=“toc”><a href=“s-1.1”>1.1</a><a href=“n-sub-intro”>sub-intro</a></li>。。。

7. Main Body
7. 主体

The main body of the HTML document is processed according to the rules in Section 9.

HTML文档的主体根据第9节中的规则进行处理。

8. Back Matter
8. 背景

The back matter of the HTML document includes an index (if generated), information about the authors, and further information about the document itself.

HTML文档的背景内容包括索引(如果生成)、关于作者的信息以及关于文档本身的进一步信息。

8.1. Index
8.1. 指数

The index will be produced as dictated by the RFC Editor's Style Guide [RFC-STYLE] if and only if the XML document's <rfc> element has an "indexInclude" attribute with the value "true" and there is one or more <iref> elements in the document.

当且仅当XML文档的<RFC>元素具有值为“true”的“indexInclude”属性且文档中有一个或多个<iref>元素时,才会按照RFC编辑器的样式指南[RFC-Style]的指示生成索引。

8.1.1. Index Contents
8.1.1. 索引内容

The index section will start with an <h2> heading containing the text "Index", followed by links to each of the lettered portions of the index. Links are not generated for letters that do not occur as the first letter of an index item.

索引部分将以包含文本“index”的<h2>标题开始,然后是指向索引每个字母部分的链接。不会为不作为索引项的第一个字母出现的字母生成链接。

For example:

例如:

<h2>Index</h2> <div class="index"> <div class="indexIndex"> <a href="#rfc.index.C">C</a> <a href="#rfc.index.P">P</a> </div> ...

<h2>索引</h2><div class=“Index”><div class=“indexIndex”><a href=“#rfc.Index.C”>C</a><a href=“#rfc.Index.P”>P</a><。。。

8.1.2. Index Letters
8.1.2. 索引字母

The index letter is followed by a <ul> tag that contains an <li> tag for each first letter represented in the index. This <li> tag has the class "indexChar" and contains an <a> tag with the id pointed to by the index letter as well as an "href" attribute to itself. The <li> tag also includes a <ul> tag that will contain the index items.

索引字母后面是一个<ul>标记,该标记包含索引中表示的每个第一个字母的<li>标记。此<li>标记具有类“indexChar”,并包含一个<a>标记,该标记的id由索引字母指向,并且其本身具有一个“href”属性。<li>标记还包括一个<ul>标记,该标记将包含索引项。

For example:

例如:

<ul> <li class="indexChar"> <a href="#rfc.index.C" id="rfc.index.C">C</a> <ul> <!-- items go here --> </ul> </li> ...

<ul><li class=“indexChar”><a href=“#rfc.index.C”id=“rfc.index.C”>C</a><ul><!--物品放在这里--></ul></li>。。。

8.1.3. Index Items
8.1.3. 索引项

Each index item can have multiple <iref> elements to point to, all with the same item attribute. Each index item is represented by an <li> tag of class "indexItem" containing a <span> of class "irefItem" for the item text and one of class "irefRefs" for the generated references (if there is at least one reference to the item not having a subitem). Each generated reference contains an <a> tag containing the section number where the <iref> is found, with an "href" attribute pointing to the "irefid" attribute of the <iref> element from the XML document. If the primary attribute of the <iref> element has the value "true", the <a> element in the HTML document will have the class "indexPrimary". Commas may be used to separate the generated references.

每个索引项都可以指向多个<iref>元素,所有元素都具有相同的项属性。每个索引项由类“indexItem”的<li>标记表示,该标记包含项文本的类“irefItem”的<span>,以及生成的引用的类“irefRefs”的一个(如果至少有一个引用项没有子项)。每个生成的引用都包含一个<a>标记,其中包含找到<iref>的节号,带有一个“href”属性,指向XML文档中<iref>元素的“irefid”属性。如果<iref>元素的主属性的值为“true”,则HTML文档中的<a>元素将具有类“indexPrimary”。逗号可用于分隔生成的引用。

For example:

例如:

<li class="indexItem"> <span class="irefItem">Bullets</span> <span class="irefRefs"> <a class="indexPrimary" href="#s-Bullets-1">2</a>, <a href="#s-Bullets-2">2</a> </span> <!-- subitems go here --> </li> ...

<li class=“indexItem”><span class=“irefItem”>项目符号</span><span class=“irefRefs”><a class=“indexPrimary”href=“#s-bollets-1”>2</a>,<a href=“#s-bollets-2”>2</a><span><子项位于此处--></li>。。。

8.1.4. Index Subitems
8.1.4. 索引子项

If an index item has at least one subitem, the <li> of that item will contain a <ul>, with one <li> for each subitem, of class "indexSubItem". The format for each subitem is similar to that used for items, except the class of the first <span> tag is "irefSubItem".

如果索引项至少有一个子项,则该项的<li>将包含一个<ul>,每个子项有一个<li>,属于“indexSubItem”类。每个子项的格式与用于项的格式类似,但第一个<span>标记的类为“irefSubItem”。

For example:

例如:

<ul> <li class="indexSubItem"> <span class="irefSubItem">Ordered</span> <span class="irefRefs"> <a href="#s-Bullets-Ordered-1">2</a> </span> </li> </ul> ...

<ul><li class=“indexSubItem”><span class=“irefSubItem”>订购</span><span class=“irefRefs”><a href=“#s-Bullets-Ordered-1”>2</a></span>/li></ul。。。

8.2. Authors' Addresses Section
8.2. 作者地址组

At the end of the document, author information will be included inside an HTML <section> element whose "id" attribute is "author-addresses". The class names of the constituent HTML tags have been chosen to match the class names in [HCARD].

在文档末尾,作者信息将包含在一个HTML<section>元素中,该元素的“id”属性是“author addresses”。已选择组成HTML标记的类名,以匹配[HCARD]中的类名。

The information for each author will be separated by an HTML <hr> element with class "addr".

每个作者的信息将由类为“addr”的HTML<hr>元素分隔。

   <section id="author-addresses">
     <h2>
       <a class="selfRef" href="#author-addresses">
         Authors' Addresses
       </a>
     </h2>
     <address class="vcard">
       <div class="nameRole"><span class="fn">Joe Hildebrand</span>
         (<span class="role">editor</span>)</div>
       <div class="org">Cisco Systems, Inc.</div>
     </address>
     <hr class="addr">
     <address class="vcard">
       <div class="nameRole"><span class="fn">Heather Flanagan</span>
         (<span class="role">editor</span>)</div>
       <div class="org">RFC Series Editor</div>
     </address>
   </section>
        
   <section id="author-addresses">
     <h2>
       <a class="selfRef" href="#author-addresses">
         Authors' Addresses
       </a>
     </h2>
     <address class="vcard">
       <div class="nameRole"><span class="fn">Joe Hildebrand</span>
         (<span class="role">editor</span>)</div>
       <div class="org">Cisco Systems, Inc.</div>
     </address>
     <hr class="addr">
     <address class="vcard">
       <div class="nameRole"><span class="fn">Heather Flanagan</span>
         (<span class="role">editor</span>)</div>
       <div class="org">RFC Series Editor</div>
     </address>
   </section>
        
8.3. Document Information
8.3. 文件信息

A few bits of metadata about the document that are less important to most readers are included after the author information. These are gathered together into a <div> of class "docInfo".

在作者信息之后,会包含一些对大多数读者不太重要的文档元数据。这些被收集到一个类“docInfo”的<div>。

The finalized time is copied from the <rfc> element's "prepTime" attribute. The rendered time is the time that this HTML was generated.

最终确定的时间是从<rfc>元素的“prepTime”属性复制的。呈现时间是生成此HTML的时间。

For example:

例如:

   <div class="docInfo">
     <span class="finalized">
       Finalized: <time
       datetime="2015-04-29T18:59:08Z">2015-04-29T18:59:08Z</time>
     </span>
     <span class="rendered">
       Rendered: <time
       datetime="2015-04-29T18:59:10Z">2015-04-29T18:59:10Z</time>
     </span>
   </div>
        
   <div class="docInfo">
     <span class="finalized">
       Finalized: <time
       datetime="2015-04-29T18:59:08Z">2015-04-29T18:59:08Z</time>
     </span>
     <span class="rendered">
       Rendered: <time
       datetime="2015-04-29T18:59:10Z">2015-04-29T18:59:10Z</time>
     </span>
   </div>
        
9. Elements
9. 元素

This section describes how each of the XML elements from [RFC7991] is rendered to HTML. Many of the descriptions have examples to clarify how elements will be rendered.

本节介绍如何将[RFC7991]中的每个XML元素呈现为HTML。许多描述都有示例来说明如何呈现元素。

9.1. <abstract>
9.1. <abstract>

The abstract is rendered in a similar fashion to a <section> with anchor="abstract" and <name>Abstract</name>, but without a section number.

摘要的呈现方式与使用anchor=“abstract”和<name>abstract</name>的<section>类似,但没有节号。

   <section id="abstract">
     <h2><a href="#abstract" class="selfRef">Abstract</a></h2>
     <p id="s-abstract-1">This document defines...
       <a href="#s-abstract-1" class="pilcrow">&para;</a>
     </p>
   </section>
        
   <section id="abstract">
     <h2><a href="#abstract" class="selfRef">Abstract</a></h2>
     <p id="s-abstract-1">This document defines...
       <a href="#s-abstract-1" class="pilcrow">&para;</a>
     </p>
   </section>
        
9.2. <address>
9.2. <地址>

This element is used in the Authors' Addresses section. It is rendered as an HTML <address> tag of class "vcard". If none of the descendant XML elements has an "ascii" attribute, the <address> HTML tag includes the HTML rendering of each of the descendant XML elements. Otherwise, the <address> HTML tag includes an HTML <div> tag of class "ascii" (containing the HTML rendering of the ASCII variants of each of the descendant XML elements), an HTML <div> tag of class "alternative-contact", (containing the text "Alternate contact information:"), and an HTML <div> tag of class "non-ascii" (containing the HTML rendering of the non-ASCII variants of each of the descendant XML elements).

此元素用于“作者地址”部分。它被呈现为类“vcard”的HTML<address>标记。如果没有任何子代XML元素具有“ascii”属性,则<address>HTML标记包含每个子代XML元素的HTML呈现。否则,<address>HTML标记包括类“ascii”的HTML<div>标记(包含每个后代XML元素的ascii变体的HTML呈现)、类“alternative contact”的HTML<div>标记(包含文本“alternative contact information:”)和类“non-ascii”的HTML<div>标记(包含每个子XML元素的非ASCII变体的HTML呈现)。

Note: the following example shows some ASCII equivalents that are the same as their nominal equivalents for clarity; normally, the ASCII equivalents would not be included for these cases.

注:以下示例显示了一些ASCII等价物,为清晰起见,这些等价物与其标称等价物相同;通常,这些情况下不包括ASCII等价物。

   <address class="vcard">
     <div class="ascii">
       <div class="nameRole"><span class="fn">Joe Hildebrand</span>
         (<span class="role">editor</span>)</div>
       <div class="org">Cisco Systems, Inc.</div>
     </div>
     <div class="alternative-contact">
       Alternate contact information:
     </div>
     <div class="non-ascii">
       <div class="nameRole"><span class="fn">Joe Hildebrand</span>
         (<span class="role">editor</span>)</div>
       <div class="org">Cisco Systems, Inc.</div>
     </div>
   </address>
        
   <address class="vcard">
     <div class="ascii">
       <div class="nameRole"><span class="fn">Joe Hildebrand</span>
         (<span class="role">editor</span>)</div>
       <div class="org">Cisco Systems, Inc.</div>
     </div>
     <div class="alternative-contact">
       Alternate contact information:
     </div>
     <div class="non-ascii">
       <div class="nameRole"><span class="fn">Joe Hildebrand</span>
         (<span class="role">editor</span>)</div>
       <div class="org">Cisco Systems, Inc.</div>
     </div>
   </address>
        
9.3. <annotation>
9.3. <annotation>

This element is rendered as the text ", " (a comma and a space) followed by a <span> of class "annotation" at the end of a <reference> element, the <span> containing appropriately transformed elements from the children of the <annotation> tag.

该元素呈现为文本“,”(逗号和空格),后跟<reference>元素末尾的<span>类“annotation”,该<span>包含来自<annotation>标记子元素的适当转换的元素。

    <span class="annotation">Some <em>thing</em>.</span>
        
    <span class="annotation">Some <em>thing</em>.</span>
        
9.4. <area>
9.4. <area>

Not currently rendered to HTML.

当前未呈现为HTML。

9.5. <artwork>
9.5. <artwork>

Artwork can consist of either inline text or SVG. If the artwork is not inside a <figure> element, a pilcrow (Section 5.2) is included. Inside a <figure> element, the figure title serves the purpose of the pilcrow. If the "align" attribute has the value "right", the CSS class "alignRight" will be added. If the "align" attribute has the value "center", the CSS class "alignCenter" will be added.

艺术品可以由内联文本或SVG组成。如果艺术品不在<figure>元素内,则包括一个pilcrow(第5.2节)。在<figure>元素中,figure标题用于pilcrow。如果“align”属性的值为“right”,则将添加CSS类“alignRight”。如果“align”属性的值为“center”,则会添加CSS类“alignCenter”。

9.5.1. Text Artwork
9.5.1. 文字艺术品

Text artwork is rendered inside an HTML <pre> element, which is contained by a <div> element for consistency with SVG artwork. Note that CDATA blocks are not a part of HTML, so angle brackets and ampersands (i.e., <, >, and &) must be escaped as &lt;, &gt;, and &amp;, respectively.

文本艺术品在HTML<pre>元素中呈现,该元素包含在<div>元素中,以与SVG艺术品保持一致。请注意,CDATA块不是HTML的一部分,因此尖括号和符号(即<、>、和&)必须作为&lt;,转义&gt;,及;,分别地

The <div> element will have CSS classes of "artwork", "art-text", and "art-" prepended to the value of the <artwork> element's "type" attribute, if it exists.

<div>元素将有CSS类“artwork”、“art text”和“art-”,在<artwork>元素的“type”属性(如果存在)的值之前。

   <div class="artwork art-text art-ascii-art"  id="s-1-2">
     <pre>
    ______________
   &lt; hello, world &gt;
    --------------
     \   ^__^
      \  (oo)\_______
         (__)\       )\/\
             ||----w |
             ||     ||
     </pre>
     <a class="pilcrow" href="#s-1-2">&para;</a>
   </div>
        
   <div class="artwork art-text art-ascii-art"  id="s-1-2">
     <pre>
    ______________
   &lt; hello, world &gt;
    --------------
     \   ^__^
      \  (oo)\_______
         (__)\       )\/\
             ||----w |
             ||     ||
     </pre>
     <a class="pilcrow" href="#s-1-2">&para;</a>
   </div>
        
9.5.2. SVG Artwork
9.5.2. SVG艺术品

SVG artwork will be included inline. The SVG is wrapped in a <div> element with CSS classes "artwork" and "art-svg".

SVG艺术作品将包含在内。SVG被包装在一个<div>元素中,其中包含CSS类“artwork”和“art SVG”。

If the SVG "artwork" element is a child of <figure> and the artwork is specified as align="right", an empty HTML <span> element is added directly after the <svg> element, in order to get right alignment to work correctly in HTML rendering engines that do not support the flex-box model.

如果SVG“artwork”元素是<figure>的子元素,并且artwork被指定为align=“right”,则将在<SVG>元素之后直接添加一个空的HTML<span>元素,以便获得正确的对齐,以便在不支持flex box模型的HTML渲染引擎中正常工作。

Note: the "alt" attribute of <artwork> is not currently used for SVG; instead, the <title> and <desc> tags are used in the SVG.

注意:<artwork>的“alt”属性当前未用于SVG;相反,SVG中使用了<title>和<desc>标记。

   <div class="artwork art-svg" id="s-2-17">
     <svg width="100" height="100" xmlns="http://www.w3.org/2000/svg">
       <desc>Alt text here</desc>
       <circle
         cx="50" cy="50" r="40"
         stroke="green" stroke-width="4" fill="yellow" />
     </svg>
     <a href="#s-2-17" class="pilcrow">&para;</a>
   </div>
        
   <div class="artwork art-svg" id="s-2-17">
     <svg width="100" height="100" xmlns="http://www.w3.org/2000/svg">
       <desc>Alt text here</desc>
       <circle
         cx="50" cy="50" r="40"
         stroke="green" stroke-width="4" fill="yellow" />
     </svg>
     <a href="#s-2-17" class="pilcrow">&para;</a>
   </div>
        
9.5.3. Other Artwork
9.5.3. 其他艺术品

Other artwork will have a "src" attribute that uses the "data" URI scheme defined in [RFC2397]. Such artwork is rendered in an HTML <img> element. Note: the HTML <img> element does not have a closing slash.

其他艺术品将具有“src”属性,该属性使用[RFC2397]中定义的“数据”URI方案。这样的艺术品在HTML<img>元素中呈现。注意:HTML<img>元素没有结束斜杠。

Note: such images are not yet allowed in RFCs even though the format supports them. A limited set of "data:" mediatypes for artwork may be allowed in the future.

注意:RFC中尚不允许使用此类图像,即使格式支持它们。未来可能会允许使用一组有限的“数据:”艺术作品媒体类型。

   <div class="artwork art-logo" id="s-2-58">
     <img alt="IETF logo"
          src="data:image/gif;charset=utf-8;base64,...">
     <a class="pilcrow" href="#s-2-58">&para;</a>
   </div>
        
   <div class="artwork art-logo" id="s-2-58">
     <img alt="IETF logo"
          src="data:image/gif;charset=utf-8;base64,...">
     <a class="pilcrow" href="#s-2-58">&para;</a>
   </div>
        
9.6. <aside>
9.6. <旁白>

This element is rendered as an HTML <aside> element, with all child content appropriately transformed.

此元素呈现为HTML<aside>元素,所有子内容都经过适当转换。

   <aside id="s-2.1-2">
     <p id="s-2.1-2.1">
       A little more than kin, and less than kind.
       <a class="pilcrow" href="#s-2.1-2.1">&para;</a>
     </p>
   </aside>
        
   <aside id="s-2.1-2">
     <p id="s-2.1-2.1">
       A little more than kin, and less than kind.
       <a class="pilcrow" href="#s-2.1-2.1">&para;</a>
     </p>
   </aside>
        
9.7. <author>
9.7. <author>

The <author> element is used in several places in the output. Different rendering is used for each.

<author>元素在输出中的多个位置使用。对每个对象使用不同的渲染。

9.7.1. Authors in Document Information
9.7.1. 文献信息中的作者

As seen in the Document Information at the beginning of the HTML, each document author is rendered as an HTML <div> tag of class "author".

如HTML开头的文档信息所示,每个文档作者都被呈现为类“author”的HTML<div>标记。

Inside the <div class="author"> HTML tag, the author's initials and surname (or the fullname, if it exists and the others do not) will be rendered in an HTML <div> tag of class "author-name". If the <author> contains "asciiInitials" and "asciiSurname" attributes, or contains as "asciiFullname" attribute, the author's name is rendered twice, with the first being the non-ASCII version, wrapped in an HTML <span> tag of class "non-ascii", followed by the ASCII version wrapped in an HTML <span> tag of class "ascii", wrapped in parentheses. If the <author> has a "role" attribute of "editor", the <div class="author-name"> will also contain the text ", " (comma, space), followed by an HTML <span> tag of class "editor", which contains the text "Ed.".

在<div class=“author”>HTML标记中,作者的姓名首字母和姓氏(或全名,如果存在,其他则不存在)将呈现在类“author name”的HTML<div>标记中。如果<author>包含“asciiInitials”和“asciiSurname”属性,或包含“asciiFullname”属性,则作者的姓名将呈现两次,第一次是非ASCII版本,包装在类“non-ASCII”的HTML<span>标记中,然后是包装在类“ASCII”的HTML<span>标记中的ASCII版本,包装在括号中。如果<author>具有“editor”的“role”属性,则<div class=“author name”>还将包含文本“,”(逗号,空格),后跟类“editor”的HTML<span>标记,其中包含文本“Ed.”。

If the <author> element contains an <organization> element, it is also rendered inside the <div class="author"> HTML tag.

如果<author>元素包含<organization>元素,那么它也会在<div class=“author”>HTML标记中呈现。

   <div class="author">
     <div class="author-name">
       H. Flanagan,
       <span class="editor">Ed.</span></div>
     <div class="org">Test Org</div>
   </div>
   <div class="author">
     <div class="author-name">
       <span class="non-ascii">Hildebrand</span>
       (<span class="ascii">HILDEBRAND</span>)
     </div>
     <div class="org">
       <span class="non-ascii">Test Org</span>
       (<span class="ascii">TEST ORG</span>)
     </div>
   </div>
        
   <div class="author">
     <div class="author-name">
       H. Flanagan,
       <span class="editor">Ed.</span></div>
     <div class="org">Test Org</div>
   </div>
   <div class="author">
     <div class="author-name">
       <span class="non-ascii">Hildebrand</span>
       (<span class="ascii">HILDEBRAND</span>)
     </div>
     <div class="org">
       <span class="non-ascii">Test Org</span>
       (<span class="ascii">TEST ORG</span>)
     </div>
   </div>
        
9.7.2. Authors of This Document
9.7.2. 本文件的作者

As seen in the Authors' Addresses section, at the end of the HTML, each document author is rendered into an HTML <address> element with the CSS class "vcard".

正如在Authors'Addresses部分中所看到的,在HTML的末尾,每个文档作者都被呈现到一个带有CSS类“vcard”的HTML<address>元素中。

   The HTML <address> element will contain an HTML <div> with CSS class
   "nameRole".  That div will contain an HTML <span> element with CSS
   class "fn" containing the value of the "fullname" attribute of the
        
   The HTML <address> element will contain an HTML <div> with CSS class
   "nameRole".  That div will contain an HTML <span> element with CSS
   class "fn" containing the value of the "fullname" attribute of the
        

<author> XML element and an HTML <span> element with CSS class "role" containing the value of the "role" attribute of the <author> XML element (if there is a role). Parentheses will surround the <span class="role">, if it exists.

<author>XML元素和一个HTML<span>元素,其中CSS类“role”包含<author>XML元素的“role”属性值(如果有角色)。括号将围绕<span class=“role”>(如果存在)。

<address class="vcard"> <div class="nameRole"> <span class="fn">Joe Hildebrand</span> (<span class="role">editor</span>) </div> ...

乔·希尔德布兰德(Joe Hildebrand)编辑。。。

After the name, the <organization> and <address> child elements of the author are rendered inside the HTML <address> tag.

在名称之后,作者的<organization>和<address>子元素在HTML<address>标记中呈现。

When the <author> element, or any of its descendant elements, has any attribute that starts with "ascii", all of the author information is displayed twice. The first version is wrapped in an HTML <div> tag with class "ascii"; this version prefers the ASCII version of information, such as "asciiFullname", but falls back on the non-ASCII version if the ASCII version doesn't exist. The second version is wrapped in an HTML <div> tag with class "non-ascii"; this version prefers the non-ASCII version of information, such as "fullname", but falls back on the ASCII version if the non-ASCII version does not exist. Between these two HTML <div>s, a third <div> is inserted, with class "alternative-contact", containing the text "Alternate contact information:".

当<author>元素或其任何子元素具有以“ascii”开头的任何属性时,所有作者信息将显示两次。第一个版本被包装在一个HTML<div>标签中,标签的类为“ascii”;此版本更喜欢ASCII版本的信息,如“asciiFullname”,但如果ASCII版本不存在,则使用非ASCII版本。第二个版本被包装在一个HTML<div>标记中,该标记具有类“non-ascii”;此版本更喜欢非ASCII版本的信息,如“全名”,但如果不存在非ASCII版本,则使用ASCII版本。在这两个HTML<div>之间插入第三个<div>,类为“alternative contact”,包含文本“alternative contact information:”。

   <address class="vcard">
     <div class="ascii">
       <div class="nameRole">
         <span class="fn">The ASCII name</span>
       </div>
     </div>
     <div class="alternative-contact">
       Alternate contact information:
     </div>
     <div class="non-ascii">
       <div class="nameRole">
         <span class="fn">The non-ASCII name</span>
         (<span class="role">editor</span>)
       </div>
     </div>
   </address>
        
   <address class="vcard">
     <div class="ascii">
       <div class="nameRole">
         <span class="fn">The ASCII name</span>
       </div>
     </div>
     <div class="alternative-contact">
       Alternate contact information:
     </div>
     <div class="non-ascii">
       <div class="nameRole">
         <span class="fn">The non-ASCII name</span>
         (<span class="role">editor</span>)
       </div>
     </div>
   </address>
        
9.7.3. Authors of References
9.7.3. 参考文献的作者

In the output generated from a reference element, author tags are rendered inside an HTML <span> element with CSS class "refAuthor". See Section 4.8.6.2 of [RFC7322] for guidance on how author names are to appear.

在引用元素生成的输出中,author标记在带有CSS类“refAuthor”的HTML<span>元素中呈现。有关如何显示作者姓名的指南,请参见[RFC7322]第4.8.6.2节。

   <span class="refAuthor">Flanagan, H.</span> and
   <span class="refAuthor">N. Brownlee</span>
        
   <span class="refAuthor">Flanagan, H.</span> and
   <span class="refAuthor">N. Brownlee</span>
        
9.8. <back>
9.8. <back>

If there is exactly one <references> child, render that child in a similar way to a <section>. If there are more than one <references> children, render as a <section> whose name is "References", containing a <section> for each <references> child.

如果只有一个子<references>,则以类似于<section>的方式渲染该子对象。如果有多个子<references>,则渲染为名为“references”的<section>,每个<references>子级包含一个<section>。

After any <references> sections, render each <section> child of <back> as an appendix.

在任何<references>部分之后,将<back>的每个<section>子部分作为附录呈现。

   <section id="n-references">
     <h2 id="s-2">
       <a class="selfRef" href="#s-2">2.</a>
       <a class="selfRef" href="#n-references">References</a>
     </h2>
     <section id="n-normative">
       <h3 id="s-2.1">
         <a class="selfRef" href="#s-2.1">2.1.</a>
         <a class="selfRef" href="#n-normative">Normative</a>
       </h3>
       <dl class="reference"></dl>
     </section>
     <section id="n-informational">
       <h3 id="s-2.2">
         <a class="selfRef" href="#s-2.2">2.2.</a>
         <a class="selfRef" href="#n-informational">Informational</a>
       </h3>
       <dl class="reference"></dl>
     </section>
   </section>
   <section id="n-unimportant">
     <h2 id="s-A">
       <a class="selfRef" href="#s-A">Appendix A.</a>
       <a class="selfRef" href="#n-unimportant">Unimportant</a>
     </h2>
   </section>
        
   <section id="n-references">
     <h2 id="s-2">
       <a class="selfRef" href="#s-2">2.</a>
       <a class="selfRef" href="#n-references">References</a>
     </h2>
     <section id="n-normative">
       <h3 id="s-2.1">
         <a class="selfRef" href="#s-2.1">2.1.</a>
         <a class="selfRef" href="#n-normative">Normative</a>
       </h3>
       <dl class="reference"></dl>
     </section>
     <section id="n-informational">
       <h3 id="s-2.2">
         <a class="selfRef" href="#s-2.2">2.2.</a>
         <a class="selfRef" href="#n-informational">Informational</a>
       </h3>
       <dl class="reference"></dl>
     </section>
   </section>
   <section id="n-unimportant">
     <h2 id="s-A">
       <a class="selfRef" href="#s-A">Appendix A.</a>
       <a class="selfRef" href="#n-unimportant">Unimportant</a>
     </h2>
   </section>
        
9.9. <bcp14>
9.9. <bcp14>

This element marks up words like MUST and SHOULD [BCP14] with an HTML <span> element with the CSS class "bcp14".

这个元素用CSS类“BCP14”的HTML<span>元素标记像MUST和SHOULD[BCP14]这样的单词。

You <span class="bcp14">MUST</span> be joking.

你一定是在开玩笑。

9.10. <blockquote>
9.10. <blockquote>

This element renders in a way similar to the HTML <blockquote> element. If there is a "cite" attribute, it is copied to the HTML "cite" attribute. If there is a "quoteFrom" attribute, it is placed inside a <cite> element at the end of the quote, with an <a> element surrounding it (if there is a "cite" attribute), linking to the cited URL.

此元素的呈现方式类似于HTML<blockquote>元素。如果存在“cite”属性,则会将其复制到HTML“cite”属性。如果有一个“quoteFrom”属性,它将被放置在quote末尾的<cite>元素中,并在其周围有一个<a>元素(如果有“cite”属性),链接到引用的URL。

If the <blockquote> does not contain another element that gets a pilcrow (Section 5.2), a pilcrow is added.

如果<blockquote>不包含另一个获取pilcrow的元素(第5.2节),则添加pilcrow。

Note that the "&mdash;" at the beginning of the <cite> element should be a proper emdash, which is difficult to show in the display of the current format.

请注意,<cite>元素开头的“&mdash;”应该是正确的emdash,这在当前格式的显示中很难显示。

   <blockquote id="s-1.2-1"
     cite="http://...">
     <p id="s-1.2-2">Four score and seven years ago our fathers
       brought forth on this continent, a new nation, conceived
       in Liberty, and dedicated to the proposition that all men
       are created equal.
       <a href="#s-1.2-2" class="pilcrow">&para;</a>
     </p>
     <cite>&mdash; <a href="http://...">Abraham Lincoln</a></cite>
   </blockquote>
        
   <blockquote id="s-1.2-1"
     cite="http://...">
     <p id="s-1.2-2">Four score and seven years ago our fathers
       brought forth on this continent, a new nation, conceived
       in Liberty, and dedicated to the proposition that all men
       are created equal.
       <a href="#s-1.2-2" class="pilcrow">&para;</a>
     </p>
     <cite>&mdash; <a href="http://...">Abraham Lincoln</a></cite>
   </blockquote>
        
9.11. <boilerplate>
9.11. <样板文件>

The Status of This Memo and the Copyright statement, together commonly referred to as the document boilerplate, appear after the Abstract. The children of the input <boilerplate> element are treated in a similar fashion to unnumbered sections.

本备忘录和版权声明的状态(通常称为文档样板)出现在摘要之后。input<boilerplate>元素的子元素的处理方式与未编号的部分类似。

<section id="status-of-this-memo"> <h2 id="s-boilerplate-1"> <a href="#status-of-this-memo" class="selfRef"> Status of this Memo</a> </h2> <p id="s-boilerplate-1-1">This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79. <a href="#s-boilerplate-1-1" class="pilcrow">&para;</a> </p> ...

<section id=“本备忘录的状态”><h2 id=“s-boilerplate-1”><a href=“#本备忘录的状态”class=“selfRef”>本备忘录的状态</a>/h2><p id=“s-boilerplate-1-1”>本互联网草案的提交完全符合BCP 78和BCP 79的规定<a href=“#s-boilerplate-1-1”class=“pilcrow”>&para</a> </p>。。。

9.12. <br>
9.12. <br>

This element is directly rendered as its HTML counterpart. Note: in HTML, <br> does not have a closing slash.

此元素直接呈现为其HTML对应项。注意:在HTML中,<br>没有结束斜杠。

9.13. <city>
9.13. <city>

This element is rendered as a <span> element with CSS class "locality".

此元素呈现为CSS类为“locality”的<span>元素。

   <span class="locality">Guilford</span>
        
   <span class="locality">Guilford</span>
        
9.14. <code>
9.14. <code>

This element is rendered as a <span> element with CSS class "postal-code".

此元素呈现为带有CSS类“postal code”的<span>元素。

   <span class="postal-code">GU16 7HF<span>
        
   <span class="postal-code">GU16 7HF<span>
        
9.15. <country>
9.15. <country>

This element is rendered as a <div> element with CSS class "country-name".

此元素呈现为CSS类为“country name”的<div>元素。

   <div class="country-name">England</div>
        
   <div class="country-name">England</div>
        
9.16. <cref>
9.16. <cref>

This element is rendered as a <span> element with CSS class "cref". Any anchor is copied to the "id" attribute. If there is a source given, it is contained inside the "cref" <span> element with another <span> element of class "crefSource".

此元素呈现为CSS类为“cref”的<span>元素。任何定位点都会复制到“id”属性。如果给定了一个源,则它与类“crefSource”的另一个<span>元素一起包含在“cref”<span>元素中。

   <span class="cref" id="crefAnchor">Just a brief comment
   about something that we need to remember later.
   <span class="crefSource">--life</span></span>
        
   <span class="cref" id="crefAnchor">Just a brief comment
   about something that we need to remember later.
   <span class="crefSource">--life</span></span>
        
9.17. <date>
9.17. <date>

This element is rendered as the HTML <time> element. If the "year", "month", or "day" attribute is included on the XML element, an appropriate "datetime" element will be generated in HTML.

此元素呈现为HTML<time>元素。如果XML元素中包含“年”、“月”或“日”属性,则会在HTML中生成适当的“datetime”元素。

If this date is a child of the document's <front> element, it gets the CSS class "published".

如果此日期是文档的<front>元素的子元素,则它将获得CSS类“published”。

If this date is inside a <reference> element, it gets the CSS class "refDate".

如果此日期位于<reference>元素内,则它将获得CSS类“refDate”。

   <time datetime="2014-10" class="published">October 2014</time>
        
   <time datetime="2014-10" class="published">October 2014</time>
        
9.18. <dd>
9.18. <dd>

This element is directly rendered as its HTML counterpart.

此元素直接呈现为其HTML对应项。

9.19. <displayreference>
9.19. <displayreference>

This element does not affect the HTML output, but it is used in the generation of the <reference>, <referencegroup>, <relref>, and <xref> elements.

此元素不影响HTML输出,但用于生成<reference>、<referencegroup>、<relref>和<xref>元素。

9.20. <dl>
9.20. <dl>

This element is directly rendered as its HTML counterpart.

此元素直接呈现为其HTML对应项。

If the hanging attribute is "false", add the "dlParallel" class, else add the "dlHanging" class.

如果挂起属性为“false”,则添加“dlParallel”类,否则添加“dlHanging”类。

If the spacing attribute is "compact", add the "dlCompact" class.

如果间距属性为“compact”,则添加“dlCompact”类。

9.21. <dt>
9.21. <dt>

This element is directly rendered as its HTML counterpart.

此元素直接呈现为其HTML对应项。

9.22. <em>
9.22. <em>

This element is directly rendered as its HTML counterpart.

此元素直接呈现为其HTML对应项。

9.23. <email>
9.23. <email>

This element is rendered as an HTML <div> containing the string "Email:" and an HTML <a> element with the "href" attribute set to the equivalent "mailto:" URI, a CSS class of "email", and the contents set to the email address. If this is the version of the address with ASCII, the "ascii" attribute is preferred to the element text.

此元素呈现为HTML<div>,包含字符串“Email:”和HTML<a>元素,其中“href”属性设置为等效的“mailto:”URI、“Email”的CSS类,内容设置为电子邮件地址。如果这是带有ASCII的地址版本,“ASCII”属性优先于元素文本。

   <div>
     <span>Email:</span>
     <a class="email" href="mailto:joe@example.com">joe@example.com</a>
   </div>
        
   <div>
     <span>Email:</span>
     <a class="email" href="mailto:joe@example.com">joe@example.com</a>
   </div>
        
9.24. <eref>
9.24. <eref>

This element is rendered as an HTML <a> element, with the "href" attribute set to the value of the "target" attribute and the CSS class of "eref".

此元素呈现为HTML<a>元素,其中“href”属性设置为“target”属性的值,CSS类设置为“eref”。

   <a href="https://..." class="eref">the text</a>
        
   <a href="https://..." class="eref">the text</a>
        
9.25. <figure>
9.25. <图>

This element renders as the HTML <figure> element, containing the artwork or sourcecode indicated and an HTML <figcaption> element. The <figcaption> element will contain an <a> element around the figure number. It will also contain another <a> element with CSS class "selfRef" around the figure name, if a name was given.

此元素呈现为HTML<figure>元素,包含指定的插图或源代码以及HTML<figcaption>元素。<figcaption>元素将在地物编号周围包含一个<a>元素。如果给定名称,它还将包含另一个<a>元素,该元素的图形名称周围带有CSS类“selfRef”。

   <figure id="f-1">
     ...
     <figcaption>
       <a href="#f-1">Figure 1.</a>
       <a href="#n-it-figures" id="n-it-figures" class="selfRef">
         It figures
       </a>
     </figcaption>
   </figure>
        
   <figure id="f-1">
     ...
     <figcaption>
       <a href="#f-1">Figure 1.</a>
       <a href="#n-it-figures" id="n-it-figures" class="selfRef">
         It figures
       </a>
     </figcaption>
   </figure>
        
9.26. <front>
9.26. <front>

See "Document Information" (Section 6.5) for information on this element.

有关此要素的信息,请参见“文件信息”(第6.5节)。

9.27. <iref>
9.27. <iref>

This element is rendered as an empty <> tag of class "iref", with an "id" attribute consisting of the <iref> element's "irefid" attribute:

此元素呈现为类“iref”的空标记,其“id”属性由<iref>元素的“irefid”属性组成:

   <span class="iref" id="s-Paragraphs-first-1"/>
        
   <span class="iref" id="s-Paragraphs-first-1"/>
        
9.28. <keyword>
9.28. <keyword>

Each <keyword> element renders its text into the <meta> keywords in the document's header, separated by commas.

每个<keyword>元素将其文本呈现到文档标题中的<meta>关键字中,用逗号分隔。

   <meta name="keywords" content="html,css,rfc">
        
   <meta name="keywords" content="html,css,rfc">
        
9.29. <li>
9.29. <li>

This element is rendered as its HTML counterpart. However, if there is no contained element that has a pilcrow (Section 5.2) attached, a pilcrow is added.

此元素呈现为其HTML对应项。但是,如果没有附加pilcrow(第5.2节)的包含元素,则添加pilcrow。

   <li id="s-2-7">Item <a href="#s-2-7" class="pilcrow">&para;</a></li>
        
   <li id="s-2-7">Item <a href="#s-2-7" class="pilcrow">&para;</a></li>
        
9.30. <link>
9.30. <link>

This element is rendered as its HTML counterpart, in the HTML header.

此元素在HTML标头中呈现为其HTML对应项。

9.31. <middle>
9.31. <middle>

This element does not add any direct output to HTML.

此元素不向HTML添加任何直接输出。

9.32. <name>
9.32. <name>

This element is never rendered directly; it is only rendered when considering a parent element, such as <figure>, <references>, <section>, or <table>.

此元素从不直接渲染;它仅在考虑父元素时呈现,例如<figure>、<references>、<section>或<table>。

9.33. <note>
9.33. <note>

This element is rendered like a <section> element, but without a section number and with the CSS class of "note". If the "removeInRFC" attribute is set to "yes", the generated <div> element will also include the CSS class "rfcEditorRemove".

该元素的呈现方式类似于<section>元素,但没有节号,CSS类为“note”。如果“removeInRFC”属性设置为“yes”,则生成的<div>元素还将包括CSS类“rfcEditorRemove”。

   <section id="s-note-1" class="note rfcEditorRemove">
     <h2>
       <a href="#n-editorial-note" class="selfRef">Editorial Note</a>
     </h2>
     <p id="s-note-1-1">
       Discussion of this draft takes place...
       <a href="#s-note-1-1" class="pilcrow">&para;</a>
     </p>
   </section>
        
   <section id="s-note-1" class="note rfcEditorRemove">
     <h2>
       <a href="#n-editorial-note" class="selfRef">Editorial Note</a>
     </h2>
     <p id="s-note-1-1">
       Discussion of this draft takes place...
       <a href="#s-note-1-1" class="pilcrow">&para;</a>
     </p>
   </section>
        
9.34. <ol>
9.34. <ol>

The output created from an <ol> element depends upon the "style" attribute.

从<ol>元素创建的输出取决于“style”属性。

If the "spacing" attribute has the value "compact", a CSS class of "olCompact" will be added.

如果“spacing”属性的值为“compact”,则会添加一个CSS类“olCompact”。

The group attribute is not copied; the input XML should have start values added by a prep tool for all grouped <ol> elements.

不复制组属性;对于所有分组的<ol>元素,输入XML应该有一个prep工具添加的起始值。

9.34.1. Percent Styles
9.34.1. 百分比样式

If the style attribute includes the character "%", the output is a <dl> tag with the class "olPercent". Each contained <li> element is emitted as a <dt>/<dd> pair, with the generated label in the <dt> and the contents of the <li> in the <dd>.

如果style属性包含字符“%”,则输出是一个类为“olPercent”的<dl>标记。每个包含的<li>元素以<dt>/<dd>对的形式发出,生成的标签在<dt>中,而<li>的内容在<dd>中。

   <dl class="olPercent">
     <dt>Requirement xviii:</dt>
     <dd>Wheels on a big rig</dd>
   </dl>
        
   <dl class="olPercent">
     <dt>Requirement xviii:</dt>
     <dd>Wheels on a big rig</dd>
   </dl>
        
9.34.2. Standard Styles
9.34.2. 标准样式

For all other styles, an <ol> tag is emitted, with any "style" attribute turned into the equivalent HTML attribute.

对于所有其他样式,将发出一个<ol>标记,并将任何“style”属性转换为等效的HTML属性。

   <ol class="compact" type="I" start="18">
     <li>Wheels on a big rig</li>
   </ol>
        
   <ol class="compact" type="I" start="18">
     <li>Wheels on a big rig</li>
   </ol>
        
9.35. <organization>
9.35. <组织>

This element is rendered as an HTML <div> tag with CSS class "org".

此元素呈现为带有CSS类“org”的HTML<div>标记。

If the element contains the "ascii" attribute, the organization name is rendered twice: once with the non-ASCII version wrapped in an HTML <span> tag of class "non-ascii" and then as the ASCII version wrapped in an HTML <span> tag of class "ascii" wrapped in parentheses.

如果元素包含“ascii”属性,则组织名称将呈现两次:一次是非ascii版本包装在类“non-ascii”的HTML<span>标记中,然后是ascii版本包装在类“ascii”的HTML<span>标记中,包装在括号中。

   <div class="org">
     <span class="non-ascii">Test Org</span>
     (<span class="ascii">TEST ORG</span>)
   </div>
        
   <div class="org">
     <span class="non-ascii">Test Org</span>
     (<span class="ascii">TEST ORG</span>)
   </div>
        
9.36. <phone>
9.36. <phone>

This element is rendered as an HTML <div> tag containing the string "Phone:" (wrapped in a span), an HTML <a> tag with CSS class "tel" containing the phone number (and an href with a corresponding "tel:" URI), and an HTML <span> with CSS class "type" containing the string "VOICE".

此元素呈现为一个HTML<div>标记,包含字符串“Phone:”(包装在span中),一个HTML<a>标记,带有CSS类“tel”,包含电话号码(和一个href,带有相应的“tel:”URI),以及一个HTML<span>标记,带有CSS类“type”,包含字符串“VOICE”。

   <div>
     <span>Phone:</span>
     <a class="tel" href="tel:+1-720-555-1212">+1-720-555-1212</a>
     <span class="type">VOICE</span>
   </div>
        
   <div>
     <span>Phone:</span>
     <a class="tel" href="tel:+1-720-555-1212">+1-720-555-1212</a>
     <span class="type">VOICE</span>
   </div>
        
9.37. <postal>
9.37. <postal>

This element renders as an HTML <div> with CSS class "adr", unless it contains one or more <postalLine> child elements; in which case, it renders as an HTML <pre> element with CSS class "label".

此元素呈现为带有CSS类“adr”的HTML<div>,除非它包含一个或多个<postalLine>子元素;在这种情况下,它呈现为带有CSS类“label”的HTML<pre>元素。

When there is no <postalLine> child, the following child elements are rendered into the HTML:

如果没有<postalLine>子元素,则会将以下子元素呈现到HTML中:

o Each <street> is rendered

o 将渲染每个<street>

o A <div> that includes:

o A<div>,包括:

* The rendering of all <city> elements

* 所有<city>元素的渲染

* A comma and a space: ", "

* 逗号和空格“,”

* The rendering of all <region> elements

* 所有<region>元素的渲染

* Whitespace

* 空白

* The rendering of all <code> elements

* 所有<code>元素的呈现

o The rendering of all <country> elements

o 所有<country>元素的渲染

   <div class="adr">
     <div class="street-address">1 Main Street</div>
     <div class="street-address">Suite 1</div>
     <div>
       <span class="city">Denver</span>,
       <span class="region">CO</span>
       <span class="postal-code">80212</span>
     </div>
     <div class="country-name">United States of America</div>
   </div>
        
   <div class="adr">
     <div class="street-address">1 Main Street</div>
     <div class="street-address">Suite 1</div>
     <div>
       <span class="city">Denver</span>,
       <span class="region">CO</span>
       <span class="postal-code">80212</span>
     </div>
     <div class="country-name">United States of America</div>
   </div>
        
9.38. <postalLine>
9.38. <postalLine>

This element renders as the text contained by the element, followed by a newline. However, the last <postalLine> in a given <postal> element should not be followed by a newline. For example:

此元素呈现为元素包含的文本,后跟换行符。但是,给定<postalLine>元素中的最后一个<postalLine>不应后跟换行符。例如:

   <postal>
     <postalLine>In care of:</postalLine>
     <postalLine>Computer Sciences Division</postalLine>
   </postal>
        
   <postal>
     <postalLine>In care of:</postalLine>
     <postalLine>Computer Sciences Division</postalLine>
   </postal>
        

Would be rendered as:

将改为:

   <pre class="label">In care of:
   Computer Sciences Division</pre>
        
   <pre class="label">In care of:
   Computer Sciences Division</pre>
        
9.39. <refcontent>
9.39. <refcontent>

This element renders as an HTML <span> with CSS class "refContent".

此元素呈现为带有CSS类“refContent”的HTML<span>。

   <span class="refContent">Self-published pamphlet</span>
        
   <span class="refContent">Self-published pamphlet</span>
        
9.40. <reference>
9.40. <reference>

If the parent of this element is not a <referencegroup>, this element will render as a <dt> <dd> pair with the defined term being the reference "anchor" attribute surrounded by square brackets and the definition including the correct set of bibliographic information as specified by [RFC7322]. The <dt> element will have an "id" attribute of the reference anchor.

如果该元素的父元素不是<referencegroup>,则该元素将呈现为<dt><dd>对,定义的术语是被方括号包围的引用“锚定”属性,定义包括[RFC7322]指定的正确书目信息集。<dt>元素将具有引用锚点的“id”属性。

   <dl class="reference">
     <dt id="RFC5646">[RFC5646]</dt>
     <dd>
       <span class="refAuthor">Phillips, A.</span>
       <span>and</span>
       <span class="refAuthor">M. Davis</span>
       <span class="refTitle">"Tags for Identifying Languages"</span>,
       ...
     </dd>
   </dl>
        
   <dl class="reference">
     <dt id="RFC5646">[RFC5646]</dt>
     <dd>
       <span class="refAuthor">Phillips, A.</span>
       <span>and</span>
       <span class="refAuthor">M. Davis</span>
       <span class="refTitle">"Tags for Identifying Languages"</span>,
       ...
     </dd>
   </dl>
        

If the child of a <referencegroup>, this element renders as a <div> of class "refInstance" whose "id" attribute is the value of the <source> element's "anchor" attribute.

如果是<referencegroup>的子元素,则该元素呈现为类“refInstance”的<div>,其“id”属性是<source>元素的“anchor”属性的值。

   <div class="refInstance" id="RFC5730">
     ...
   </div>
        
   <div class="refInstance" id="RFC5730">
     ...
   </div>
        
9.41. <referencegroup>
9.41. <referencegroup>

A <referencegroup> is translated into a <dt> <dd> pair, with the defined term being the referencegroup "anchor" attribute surrounded by square brackets, and the definition containing the translated output of all of the child <reference> elements.

<referencegroup>被翻译成<dt><dd>对,定义的术语是被方括号包围的referencegroup“anchor”属性,定义包含所有子<reference>元素的翻译输出。

   <dt id="STD69">[STD69]</dt>
   <dd>
     <div class="refInstance" id="RFC5730">
       <span class="refAuthor">Hollenbeck, S.</span>
       ...
     </div>
     <div class="refInstance" id="RFC5731">
       <span class="refAuthor">Hollenbeck, S.</span>
       ...
     </div>
     ...
   </dd>
        
   <dt id="STD69">[STD69]</dt>
   <dd>
     <div class="refInstance" id="RFC5730">
       <span class="refAuthor">Hollenbeck, S.</span>
       ...
     </div>
     <div class="refInstance" id="RFC5731">
       <span class="refAuthor">Hollenbeck, S.</span>
       ...
     </div>
     ...
   </dd>
        
9.42. <references>
9.42. <references>

If there is at exactly one <references> element, a section is added to the document, continuing with the next section number after the last top-level <section> in <middle>. The <name> element of the <references> element is used as the section name.

如果只有一个<references>元素,则会将一个节添加到文档中,并在<middle>中最后一个顶级<section>之后继续下一节编号。<references>元素的<name>元素用作节名。

   <section id="n-my-references">
     <h2 id="s-3">
       <a href="#s-3" class="selfRef">3.</a>
       <a href="#n-my-references class="selfRef">My References</a>
     </h2>
     ...
   </section>
        
   <section id="n-my-references">
     <h2 id="s-3">
       <a href="#s-3" class="selfRef">3.</a>
       <a href="#n-my-references class="selfRef">My References</a>
     </h2>
     ...
   </section>
        

If there is more than one <references> element, an HTML <section> element is created to contain a subsection for each of the <references>. The section number will be the next section number after the last top-level <section> in <middle>. The name of this section will be "References", and its "id" attribute will be "n-references".

如果有多个<references>元素,则会创建一个HTML<section>元素,以包含每个<references>的子部分。节号将是<middle>中最后一个顶级<section>之后的下一节号。该节的名称将为“References”,其“id”属性将为“n-References”。

   <section id="n-references">
     <h2 id="s-3">
       <a href="#s-3" class="selfRef">3.</a>
       <a href="#n-references" class="selfRef">References</a>
     </h2>
     <section id="n-informative-references">
       <h3 id="s-3.1">
         <a href="#s-3.1" class="selfRef">3.1.</a>
         <a href="#n-informative-references" class="selfRef">
           Informative References</a></h3>
       <dl class="reference">...
       </dl>
     </section>
     ...
   </section>
        
   <section id="n-references">
     <h2 id="s-3">
       <a href="#s-3" class="selfRef">3.</a>
       <a href="#n-references" class="selfRef">References</a>
     </h2>
     <section id="n-informative-references">
       <h3 id="s-3.1">
         <a href="#s-3.1" class="selfRef">3.1.</a>
         <a href="#n-informative-references" class="selfRef">
           Informative References</a></h3>
       <dl class="reference">...
       </dl>
     </section>
     ...
   </section>
        
9.43. <region>
9.43. <region>

This element is rendered as a <span> tag with CSS class "region".

此元素呈现为带有CSS类“region”的<span>标记。

   <span class="region">Colorado</span>
        
   <span class="region">Colorado</span>
        
9.44. <relref>
9.44. <relref>

This element is rendered as an HTML <a> tag with CSS class "relref" and "href" attribute of the "derivedLink" attribute of the element. Different values of the "displayFormat" attribute cause the text inside that HTML <a> tag to change and cause extra text to be generated. Some values of the "displayFormat" attribute also cause another HTML <a> tag to be rendered with CSS class "xref" and an "href" of "#" and the "target" attribute (modified by any applicable <displayreference> XML element) and text inside of the "target" attribute (modified by any applicable <displayreference> XML element). When used, this <a class='xref'> HTML tag is always surrounded by square brackets, for example, "[<a class='xref' href='#foo'>foo</a>]".

此元素呈现为HTML<a>标记,带有该元素“derivedLink”属性的CSS类“relref”和“href”属性。“displayFormat”属性的不同值会导致HTML<a>标记中的文本发生变化,并生成额外的文本。“displayFormat”属性的某些值还导致另一个HTML<a>标记被呈现为CSS类“xref”和“href”的“#”和“target”属性(由任何适用的<displayreference>XML元素修改)以及“target”属性内的文本(由任何适用的<displayreference>XML元素修改)。使用时,此<a class='xref'>HTML标记总是用方括号括起来,例如,“[<a class='xref'href='#foo'>foo</a>]”。

9.44.1. displayFormat='of'
9.44.1. displayFormat='of'

The output is an <a class='relref'> HTML tag, with contents of "Section " and the value of the "section" attribute. This is followed by the word "of" (surrounded by whitespace). This is followed by the <a class='xref'> HTML tag (surrounded by square brackets).

输出是一个<a class='relref'>HTML标记,内容为“Section”,值为“Section”属性。然后是单词“of”(被空格包围)。然后是<a class='xref'>HTML标记(用方括号括起来)。

For example, with an input of:

例如,输入为:

See <relref section="2.3" target="RFC9999" displayFormat="of" derivedLink="http://www.rfc-editor.org/info/rfc9999#s-2.3"/> for an overview.

请参见“derivedLink=”的<relref section=“2.3”target=“RFC9999”displayFormat=“of”http://www.rfc-editor.org/info/rfc9999#s-2.3“/>以获取概述。

The HTML generated will be:

生成的HTML将是:

See <a class="relref" href="http://www.rfc-editor.org/info/rfc9999#s-2.3">Section 2.3</a> of [<a class="xref" href="#RFC9999">RFC9999</a>] for an overview.

请参见http://www.rfc-editor.org/info/rfc9999#s-2.3“>RFC9999</a>]的第2.3节了解概述。

9.44.2. displayFormat='comma'
9.44.2. displayFormat='逗号'

The output is an <a class='xref'> HTML tag (wrapped by square brackets), followed by a comma (","), followed by whitespace, followed by an <a class='relref'> HTML tag, with contents of "Section " and the value of the "section" attribute.

输出是一个<a class='xref'>HTML标记(用方括号括起来),后跟逗号(“,”),后跟空格,后跟<a class='relref'>HTML标记,内容为“Section”,属性值为“Section”。

For example, with an input of:

例如,输入为:

See <relref section="2.3" target="RFC9999" displayFormat="comma" derivedLink="http://www.rfc-editor.org/info/rfc9999#s-2.3"/>, for an overview.

请参见<relref section=“2.3”target=“RFC9999”displayFormat=“逗号”derivedLink=”http://www.rfc-editor.org/info/rfc9999#s-2.3“/>,以获取概述。

The HTML generated will be:

生成的HTML将是:

See [<a class="xref" href="#RFC9999">RFC9999</a>], <a class="relref" href="http://www.rfc-editor.org/info/rfc9999#s-2.3">Section 2.3</a>, for an overview.

请参见[<a class=“xref”href=“#RFC9999”>RFC9999</a>,<a class=“relref”href=”http://www.rfc-editor.org/info/rfc9999#s-2.3“>第2.3节概述。

9.44.3. displayFormat='parens'
9.44.3. displayFormat='parens'

The output is an <a> element with "href" attribute whose value is the value of the "target" attribute prepended by "#", and whose content is the value of the "target" attribute; the entire element is wrapped in square brackets. This is followed by whitespace. This is followed by an <a> element whose "href" attribute is the value of the "derivedLink" attribute and whose content is the value of the "derivedRemoteContent" attribute; the entire element is wrapped in parentheses.

输出是具有“href”属性的<a>元素,其值是由“#”前缀的“target”属性的值,其内容是“target”属性的值;整个元素用方括号括起来。后面是空白。后面是一个<a>元素,其“href”属性是“derivedLink”属性的值,其内容是“derivedRemoteContent”属性的值;整个元素用括号括起来。

For example, if Section 2.3 of RFC 9999 has the title "Protocol Overview", for an input of:

例如,如果RFC 9999第2.3节标题为“协议概述”,则输入:

See <relref section="2.3" target="RFC9999" displayFormat="parens" derivedLink="http://www.rfc-editor.org/info/rfc9999#s-2.3" derivedRemoteContent="Section 2.3"/> for an overview.

请参见<relref section=“2.3”target=“RFC9999”displayFormat=“parens”derivedLink=”http://www.rfc-editor.org/info/rfc9999#s-2.3“derivedRemoteContent=”第2.3节“/>概述。

The HTML generated will be:

生成的HTML将是:

See [<a class="relref" href="#RFC9999">RFC9999</a>] (<a class="relref" href="http://www.rfc-editor.org/info/rfc9999#s-2.3">Section 2.3</a>) for an overview.

请参见[<a class=“relref”href=“#RFC9999”>RFC9999</a>](<a class=“relref”href=”http://www.rfc-editor.org/info/rfc9999#s-2.3“>第2.3节(概述)。

9.44.4. displayFormat='bare'
9.44.4. displayFormat='bare'

The output is an <a> element whose "href" attribute is the value of the "derivedLink" attribute and whose content is the value of the "derivedRemoteContent" attribute.

输出是一个<a>元素,其“href”属性是“derivedLink”属性的值,其内容是“derivedRemoteContent”属性的值。

For this input:

对于此输入:

See <relref section="2.3" target="RFC9999" displayFormat="bare" derivedLink="http://www.rfc-editor.org/info/rfc9999#s-2.3" derivedRemoteContent="Section 2.3"/> and ...

请参见<relref section=“2.3”target=“RFC9999”displayFormat=“bare”derivedLink=”http://www.rfc-editor.org/info/rfc9999#s-2.3“derivedRemoteContent=”第2.3节“/>和。。。

The HTML generated will be:

生成的HTML将是:

See <a class="relref" href="http://www.rfc-editor.org/info/rfc9999#s-2.3">Section 2.3</a> and ...

请参见http://www.rfc-editor.org/info/rfc9999#s-2.3“>第2.3节和。。。

9.45. <rfc>
9.45. <rfc>

Various attributes of this element are represented in different parts of the HTML document.

该元素的各种属性在HTML文档的不同部分中表示。

9.46. <section>
9.46. <section>

This element is rendered as an HTML <section> element, containing an appropriate level HTML heading element (<h2>-<h6>). That heading element contains an <a> element around the part number (pn), if applicable (for instance, <abstract> does not get a section number). Another <a> element is included with the section's name.

此元素呈现为HTML<section>元素,包含适当级别的HTML标题元素(<h2>-<h6>)。该标题元素在零件号(pn)周围包含一个<a>元素(如果适用)(例如,<abstract>没有获得章节号)。另一个<a>元素包含在节的名称中。

   <section id="intro">
     <h2 id="s-1">
       <a href="#s-1" class="selfRef">1.</a>
       <a href="#intro" class="selfRef">Introduction</a>
     </h2>
     <p id="s-1-1">Paragraph <a href="#s-1-1" class="pilcrow">&para;</a>
     </p>
   </section>
        
   <section id="intro">
     <h2 id="s-1">
       <a href="#s-1" class="selfRef">1.</a>
       <a href="#intro" class="selfRef">Introduction</a>
     </h2>
     <p id="s-1-1">Paragraph <a href="#s-1-1" class="pilcrow">&para;</a>
     </p>
   </section>
        
9.47. <seriesInfo>
9.47. <serieinfo>

This element is rendered in an HTML <span> element with CSS name "seriesInfo".

此元素在一个HTML<span>元素中呈现,该元素的CSS名称为“seriesInfo”。

   <span class="seriesInfo">RFC 5646</span>
        
   <span class="seriesInfo">RFC 5646</span>
        
9.48. <sourcecode>
9.48. <sourcecode>

This element is rendered in an HTML <pre> element with a CSS class of "sourcecode". Note that CDATA blocks do not work consistently in HTML, so all <, >, and & must be escaped as &lt;, &gt;, and &amp;, respectively. If the input XML has a "type" attribute, another CSS class of "lang-" and the type is added.

此元素在一个HTML<pre>元素中呈现,该元素的CSS类为“sourcecode”。请注意,CDATA块在HTML中的工作方式不一致,因此所有<、>、和&必须作为&lt;、转义&gt;,及;,分别地如果输入XML有一个“type”属性,则添加另一个CSS类“lang-”和该类型。

If the sourcecode is not inside a <figure> element, a pilcrow (Section 5.2) is included. Inside a <figure> element, the figure title serves the purpose of the pilcrow.

如果源代码不在<figure>元素中,则包含pilcrow(第5.2节)。在<figure>元素中,figure标题用于pilcrow。

   <pre class="sourcecode lang-c">
   #include &lt;stdio.h&gt;
        
   <pre class="sourcecode lang-c">
   #include &lt;stdio.h&gt;
        
   int main(void)
   {
       printf(&quot;hello, world\n&quot;);
       return 0;
   }
   </pre>
        
   int main(void)
   {
       printf(&quot;hello, world\n&quot;);
       return 0;
   }
   </pre>
        
9.49. <street>
9.49. <street>

This element renders as an HTML <div> element with CSS class "street-address".

此元素呈现为带有CSS类“street address”的HTML<div>元素。

   <div class="street-address">1899 Wynkoop St, Suite 600</div>
        
   <div class="street-address">1899 Wynkoop St, Suite 600</div>
        
9.50. <strong>
9.50. <strong>

This element is directly rendered as its HTML counterpart.

此元素直接呈现为其HTML对应项。

9.51. <sub>
9.51. <sub>

This element is directly rendered as its HTML counterpart.

此元素直接呈现为其HTML对应项。

9.52. <sup>
9.52. <sup>

This element is directly rendered as its HTML counterpart.

此元素直接呈现为其HTML对应项。

9.53. <t>
9.53. <t>

This element is rendered as an HTML <p> element. A pilcrow (Section 5.2) is included.

此元素呈现为HTML<p>元素。包括一个木桩(第5.2节)。

   <p id="s-1-1">A paragraph.
     <a href="#s-1-1" class="pilcrow">&para;</a></p>
        
   <p id="s-1-1">A paragraph.
     <a href="#s-1-1" class="pilcrow">&para;</a></p>
        
9.54. <table>
9.54. <table>

This element is directly rendered as its HTML counterpart.

此元素直接呈现为其HTML对应项。

9.55. <tbody>
9.55. <tbody>

This element is directly rendered as its HTML counterpart.

此元素直接呈现为其HTML对应项。

9.56. <td>
9.56. <td>

This element is directly rendered as its HTML counterpart.

此元素直接呈现为其HTML对应项。

9.57. <tfoot>
9.57. <tfoot>

This element is directly rendered as its HTML counterpart.

此元素直接呈现为其HTML对应项。

9.58. <th>
9.58. <th>

This element is directly rendered as its HTML counterpart.

此元素直接呈现为其HTML对应项。

9.59. <thead>
9.59. <thead>

This element is directly rendered as its HTML counterpart.

此元素直接呈现为其HTML对应项。

9.60. <title>
9.60. <title>

The title of the document appears in a <title> element in the <head> element, as described in Section 6.3.2.

文件标题出现在<head>元素的<title>元素中,如第6.3.2节所述。

The title also appears in an <h1> element and follows directly after the Document Information. The <h1> element has an "id" attribute with value "title".

标题也出现在<h1>元素中,紧跟在文档信息之后。<h1>元素有一个值为“title”的“id”属性。

   <h1 id="title">HyperText Markup Language Request For
       Comments Format</h1>
        
   <h1 id="title">HyperText Markup Language Request For
       Comments Format</h1>
        

Inside a reference, the title is rendered as an HTML <span> tag with CSS class "refTitle". The text is surrounded by quotes inside the <span>.

在引用内部,标题呈现为带有CSS类“refTitle”的HTML<span>标记。文本在<span>中用引号括起。

   <span class="refTitle">"Tags for Identifying Languages"</span>
        
   <span class="refTitle">"Tags for Identifying Languages"</span>
        
9.61. <tr>
9.61. <tr>

This element is directly rendered as its HTML counterpart.

此元素直接呈现为其HTML对应项。

9.62. <tt>
9.62. <tt>

This element is rendered as an HTML <code> element.

此元素呈现为HTML<code>元素。

9.63. <ul>
9.63. <ul>

This element is directly rendered as its HTML counterpart. If the "spacing" attribute has the value "compact", a CSS class of "ulCompact" will be added. If the "empty" attribute has the value "true", a CSS class of "ulEmpty" will be added.

此元素直接呈现为其HTML对应项。如果“spacing”属性的值为“compact”,则将添加一个CSS类“ulCompact”。如果“empty”属性的值为“true”,则将添加一个CSS类“ulEmpty”。

9.64. <uri>
9.64. <uri>

This element is rendered as an HTML <div> containing the string "URI:" and an HTML <a> element with the "href" attribute set to the linked URI, CSS class of "url" (note that the value is "url", not "uri" as one might expect), and the contents set to the linked URI.

该元素呈现为一个HTML<div>,包含字符串“URI:”和一个HTML<a>元素,该元素的“href”属性设置为链接的URI,CSS类为“url”(注意,该值为“url”,而不是预期的“URI”),内容设置为链接的URI。

   <div>URI:
     <a href="http://www.example.com"
        class="url">http://www.example.com</a>
   </div>
        
   <div>URI:
     <a href="http://www.example.com"
        class="url">http://www.example.com</a>
   </div>
        
9.65. <workgroup>
9.65. <工作组>

This element does not add any direct output to HTML.

此元素不向HTML添加任何直接输出。

9.66. <xref>
9.66. <xref>

This element is rendered as an HTML <a> element containing an appropriate local link as the "href" attribute. The value of the "href" attribute is taken from the "target" attribute, prepended by "#". The <a> element generated will have class "xref". The contents of the <a> element are the value of the "derivedContent" attribute. If the "format" attribute has the value "default", and the "target" attribute points to a <reference> or <referencegroup> element, then the generated <a> element is surrounded by square brackets in the output.

此元素呈现为HTML<a>元素,包含适当的本地链接作为“href”属性。“href”属性的值取自“target”属性,前缀为“#”。生成的<a>元素将具有类“xref”。<a>元素的内容是“derivedContent”属性的值。如果“format”属性的值为“default”,并且“target”属性指向<reference>或<referencegroup>元素,则生成的<a>元素在输出中被方括号包围。

   <a class="xref" href="#target">Table 2</a>
        
   <a class="xref" href="#target">Table 2</a>
        

or

   [<a class="xref" href="#RFC1234">RFC1234</a>]
        
   [<a class="xref" href="#RFC1234">RFC1234</a>]
        
9.67. <svg xmlns='http://www.w3.org/2000/svg'>
9.67. <svg xmlns=http://www.w3.org/2000/svg'>

This element is rendered as part of the <artwork> element. The "xmlns='http://www.w3.org/2000/svg'" namespace declaration should be included, and the SVG should be serialized as well-formed XML, even for tags that would otherwise not need closing in HTML5.

此元素作为<artwork>元素的一部分进行渲染。“xmlns=”一词http://www.w3.org/2000/svg“”名称空间声明应该包括在内,SVG应该作为格式良好的XML序列化,即使对于不需要在HTML5中关闭的标记也是如此。

10. Security Considerations
10. 安全考虑

Since RFCs are sometimes exchanged outside the normal Web sandboxing mechanism (such as using the "rsync" program to a mirror site) then loaded from a local file, more care must be taken with the HTML than is ordinary on the web.

由于RFC有时在正常的Web沙箱机制之外进行交换(例如使用“rsync”程序到镜像站点),然后从本地文件加载,因此必须比在Web上更小心地处理HTML。

11. References
11. 工具书类
11.1. Normative References
11.1. 规范性引用文件

[BCP14] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997, <http://www.rfc-editor.org/info/bcp14>.

[BCP14]Bradner,S.,“RFC中用于表示需求水平的关键词”,BCP 14,RFC 2119,1997年3月<http://www.rfc-editor.org/info/bcp14>.

[RFC2397] Masinter, L., "The "data" URL scheme", RFC 2397, DOI 10.17487/RFC2397, August 1998, <http://www.rfc-editor.org/info/rfc2397>.

[RFC2397]Masinter,L.,“数据”URL方案,RFC 2397,DOI 10.17487/RFC2397,1998年8月<http://www.rfc-editor.org/info/rfc2397>.

[RFC3629] Yergeau, F., "UTF-8, a transformation format of ISO 10646", STD 63, RFC 3629, DOI 10.17487/RFC3629, November 2003, <http://www.rfc-editor.org/info/rfc3629>.

[RFC3629]Yergeau,F.,“UTF-8,ISO 10646的转换格式”,STD 63,RFC 3629,DOI 10.17487/RFC3629,2003年11月<http://www.rfc-editor.org/info/rfc3629>.

[RFC5646] Phillips, A., Ed. and M. Davis, Ed., "Tags for Identifying Languages", BCP 47, RFC 5646, DOI 10.17487/RFC5646, September 2009, <http://www.rfc-editor.org/info/rfc5646>.

[RFC5646]Phillips,A.,Ed.和M.Davis,Ed.,“识别语言的标签”,BCP 47,RFC 5646,DOI 10.17487/RFC5646,2009年9月<http://www.rfc-editor.org/info/rfc5646>.

[RFC7322] Flanagan, H. and S. Ginoza, "RFC Style Guide", RFC 7322, DOI 10.17487/RFC7322, September 2014, <http://www.rfc-editor.org/info/rfc7322>.

[RFC7322]Flanagan,H.和S.Ginoza,“RFC风格指南”,RFC 7322,DOI 10.17487/RFC7322,2014年9月<http://www.rfc-editor.org/info/rfc7322>.

[RFC7991] Hoffman, P., "The "xml2rfc" Version 3 Vocabulary", RFC 7991, DOI 10.17487/RFC7991, December 2016, <http://www.rfc-editor.org/info/rfc7991>.

[RFC7991]Hoffman,P.“xml2rfc”版本3词汇表”,RFC 7991,DOI 10.17487/RFC7991,2016年12月<http://www.rfc-editor.org/info/rfc7991>.

[RFC7993] Flanagan, H., "Cascading Style Sheets (CSS) Requirements for RFCs", RFC 7993, DOI 10.17487/RFC7993, December 2016, <http://www.rfc-editor.org/info/rfc7993>.

[RFC7993]Flanagan,H.,“RFC的级联样式表(CSS)要求”,RFC 7993,DOI 10.17487/RFC7993,2016年12月<http://www.rfc-editor.org/info/rfc7993>.

[W3C.REC-CSS2-20110607] Bos, B., Celik, T., Hickson, I., and H. Lie, "Cascading Style Sheets Level 2 Revision 1 (CSS 2.1) Specification", World Wide Web Consortium Recommendation REC-CSS2-20110607, June 2011, <http://www.w3.org/TR/2011/REC-CSS2-20110607>.

[W3C.REC-CSS2-20110607]Bos,B.,Celik,T.,Hickson,I.,和H.Lie,“级联样式表第2级修订版1(CSS 2.1)规范”,万维网联盟建议REC-CSS2-20110607,2011年6月<http://www.w3.org/TR/2011/REC-CSS2-20110607>.

[W3C.REC-html5-20141028] Hickson, I., Berjon, R., Faulkner, S., Leithead, T., Navara, E., O'Connor, T., and S. Pfeiffer, "HTML5", World Wide Web Consortium Recommendation REC-html5-20141028, October 2014, <http://www.w3.org/TR/2014/REC-html5-20141028>.

[W3C.REC-html5-20141028]希克森,I.,伯容,R.,福克纳,S.,莱塞德,T.,纳瓦拉,E.,O'Connor,T.,和S.Pfeiffer,“html5”,万维网联盟建议REC-html5-20141028,2014年10月<http://www.w3.org/TR/2014/REC-html5-20141028>.

11.2. Informative References
11.2. 资料性引用

[HCARD] Celik, T., "hCard 1.0", 2015, <http://microformats.org/wiki/hcard>.

[HCARD]塞利克,T.,“HCARD 1.0”,2015年<http://microformats.org/wiki/hcard>.

[RFC-STYLE] RFC Editor, "Style Guide", <https://www.rfc-editor.org/styleguide/>.

[RFC-STYLE]RFC编辑器,“样式指南”<https://www.rfc-editor.org/styleguide/>.

[RFC6949] Flanagan, H. and N. Brownlee, "RFC Series Format Requirements and Future Development", RFC 6949, DOI 10.17487/RFC6949, May 2013, <http://www.rfc-editor.org/info/rfc6949>.

[RFC6949]Flanagan,H.和N.Brownlee,“RFC系列格式要求和未来发展”,RFC 6949,DOI 10.17487/RFC6949,2013年5月<http://www.rfc-editor.org/info/rfc6949>.

[RFC7990] Flanagan, H., "RFC Format Framework", RFC 7990, DOI 10.17487/RFC7990, December 2016, <http://www.rfc-editor.org/info/rfc7990>.

[RFC7990]Flanagan,H.,“RFC格式框架”,RFC 7990,DOI 10.17487/RFC7990,2016年12月<http://www.rfc-editor.org/info/rfc7990>.

[RFC7998] Hoffman, P. and J. Hildebrand, ""xml2rfc" Version 3 Preparation Tool Description", RFC 7998, DOI 10.17487/RFC7998, December 2016, <http://www.rfc-editor.org/info/rfc7998>.

[RFC7998]Hoffman,P.和J.Hildebrand,“xml2rfc”第3版准备工具说明”,RFC 7998,DOI 10.17487/RFC7998,2016年12月<http://www.rfc-editor.org/info/rfc7998>.

[W3C.WD-css3-page-20130314] Grant, M., Etemad, E., Lie, H., and S. Sapin, "CSS Paged Media Module Level 3", World Wide Web Consortium WD WD-css3-page-20130314, March 2013, <http://www.w3.org/TR/2013/WD-css3-page-20130314>.

[W3C.WD-css3-page-20130314]Grant,M.,Etemad,E.,Lie,H.,和S.Sapin,“CSS页面媒体模块3级”,万维网联盟WD-css3-page-20130314,2013年3月<http://www.w3.org/TR/2013/WD-css3-page-20130314>.

IAB Members at the Time of Approval

批准时的IAB成员

The IAB members at the time this memo was approved were (in alphabetical order):

本备忘录批准时,IAB成员为(按字母顺序排列):

Jari Arkko Ralph Droms Ted Hardie Joe Hildebrand Russ Housley Lee Howard Erik Nordmark Robert Sparks Andrew Sullivan Dave Thaler Martin Thomson Brian Trammell Suzanne Woolf

贾里·阿克科·拉尔夫·德罗姆斯·泰德·哈迪·乔·希尔德布兰德·罗斯·霍斯利·李·霍华德·埃里克·诺德马克·罗伯特·斯帕克斯·安德鲁·沙利文·戴夫·泰勒·马丁·汤姆森·布莱恩·特拉梅尔·苏珊娜·伍尔夫

Acknowledgments

致谢

Heather Flanangan was an early coauthor of this document and helped its formation. The authors gratefully acknowledge the contributions of: Patrick Linskey and the members of the RFC Format Design Team (Nevil Brownlee (ISE), Tony Hansen, Ted Lemon, Julian Reschke, Adam Roach, Alice Russo, Robert Sparks (Tools Team liaison), and Dave Thaler).

希瑟·弗拉南根是这份文件的早期合著者,并帮助其形成。作者衷心感谢Patrick Linskey和RFC格式设计团队成员(Nevil Brownlee(ISE)、Tony Hansen、Ted Lemon、Julian Reschke、Adam Roach、Alice Russo、Robert Sparks(工具团队联络员)和Dave Thaler)的贡献。

Authors' Addresses

作者地址

Joe Hildebrand (editor) Mozilla

乔·希尔德布兰德(编辑)Mozilla

   Email: joe-ietf@cursive.net
        
   Email: joe-ietf@cursive.net
        

Paul Hoffman ICANN

保罗·霍夫曼·伊坎

   Email: paul.hoffman@icann.org
        
   Email: paul.hoffman@icann.org