Chinaunix首页 | 论坛 | 博客
  • 博客访问: 445422
  • 博文数量: 403
  • 博客积分: 0
  • 博客等级: 民兵
  • 技术积分: -70
  • 用 户 组: 普通用户
  • 注册时间: 2016-09-05 12:45
文章分类

全部博文(403)

文章存档

2014年(3)

2013年(1)

2012年(3)

2011年(21)

2010年(13)

2009年(64)

2008年(9)

2007年(36)

2006年(253)

分类: 系统运维

2006-10-23 11:46:11

关于本文档资料

本文档资料提供了一些关于网络通信的信息,没有详尽的描述某一种特定的标准。本文档资料的
可扩展性是无限的。

版权声明
Copyright(C)TheInternetSociety(1999).AllRightsReserved.

概述

本文档资料描述了使用可扩展标志语言(XML)为格式来描述I-Ds以及RFC系列文档。
1.简介

本文档资料描述如何用可扩展标志语言[1](XML)写I-D和RFC文挡。本文档有三个目标:

1. 对于类似RFC的结构简单的文档,使用简单的XMLDTD(文档类型定义)就能满足处理要求,同时
也允许有复杂的描述性特征.

2. 描述可处理XML源文件的软件,包括一些工具,可以产生符合RFC2223[2],HTML格式等的文档.

3.对前两个目标进行一些概念上的验证(本文档用上述DTD描述且使用上述软件).

讨论使用XML作为RFC-like文档的源格式的政治上的分支超出了本规章的范围.我们宁愿说XML
只是在纯文本的基础上加上最少的变化:

o允许使用所熟悉的编辑器编辑传统的类似RFC文档文本;

o在已有的软件环境中需要加入一些东西,虽然很少;

o允许使用有组织的或无组织的机制进行信息的组织,查询和抽取.

2.使用DTD写I-Ds和RFC

本章节没有提供对XML的正式的或全面的描述.而只是讨论了使用文档类型申明(DTD)写类似RFC文
档所需要的内容.

如果你已经对XML很熟悉,那就跳到附录B直接去看DTD.

2.1XML基础

写XML时得规则很少,语法也很简单.有以下五点需要注意:

1. 一个"元素"通常指一个开始标签,一个结束标签,及之间的所有字段,例:
"文本与/或嵌套元素"

2.一个"empty元素"包含了开始标签和结束标签,如"".在HTML中没有这种用法.

3."attribute"是元素的一部分.如果有,它们出现在开始标签中,如"".当
然,它们也可以出现在空元素中,如"".

4."entity"是一段以"&"开始的宏文本,不要感到麻烦,只有需要在文本中要有"&"或"<"符号时
才会用到它.

5."token"是字符型字段.以字母或下划线("_")开头.后面的字符只能是字母,数字,下划线或者
句点(".").

首先,你的XML源程序应从XML申明开始,接着是DTD引用,然后是"rfc"元素.




...


不用去管前两行—申明和引用—只要把它们看成是透明的就行了.""标签之后不能再出现
其他任何东西.

其次,保证所有的元素是完全匹配且是正确嵌套的.

一个完全匹配的元素是以""开始,最终以""结束.(空元素总是匹配的)
元素应正确嵌套以免出现交叉重复.
例如,


...

...

...


是正确嵌套的.

但是,


...

...

...


元素出现交叉,所以元素没有正确嵌套.

第三,永远不要在文档里使用"<"或"&"等.而应该分别使用"<"或"&".

第四,XML中有两种引用特征符号,'单引号'和"引号".要保证所有的属性值都是被引用的.例:
"",如果属性值包含其中一种引用特征符号,那就使用另一种引用特征符号
把属性值引用进来,如,"",如果属性值里两种引用特征符号都含有的话,那就使
用其中的一种来引用属性值,并将属性值中的这种符号用'''(单引号)或"""(引号)来代
替,如:
"".

如果你想在源文件中加入注释,其语法如下:


最后请注意,XML是区分大小写的.

2.2开头部分

紧跟在""标签后的是"front"元素:















...


(请注意在所有的例子中的文字缩进只是为了解释得更清楚.)

"front"元素包含有一个"title"元素,一个或多个"author"元素,一个"date"元素,一个或
多个可选的"area"元素,,一个或多个可选的"workgroup"元素,一个或多个可选的"keyword"元
素,一个可选的"abstract"元素.还有,一个或多个可选的"note"元素.

2.2.1title元素
"title"元素标识了文档的标题.因为标题是在文档的开头部分(符合[2]的格式),如果标题长度超
过42个字符,就需要提供一个简称,如,


TheIETF'sDiscussionon"SourceFormatofRFCdocuments"


2.2.2author元素
每一个"author"元素标识了一个文档的作者.因为一篇文档可能不只一个作者,所以可以出现一个
以上的"author"元素.如果作者是人名,则""标签内必须要有三个属性:"initials",
"surname",和"fullname",如,
fullname="MarshallT.Rose">

"author"元素本身包含了一个"organization"元素和一个可选的"address"元素.

"organization"元素类似与"title"元素,表示一串很长的组织名,其中用"abbrev"属性表示它
的简称,如,

USC/InformationSciencesInstitute


"address"元素包含一个可选的"postal"元素,一个可选的"phone"元素,一个可选的
"facsimile"元素,一个可选的"email"元素,和一个可选的"uri"元素.
"postal"元素包括一个或多个"street"元素,后面跟着以下元素的组合:"city","region"(国
家或省份),"code"(缩略号或邮政编码),和"country"元素,如:


660YorkStreet
M/S40
SanFranciscoCA
94110
US

这里的弹性机制兼容了不同国家不同格式的邮政地址.但要注意,这里虽然没有提及"city",
"region","code",和"country"元素的顺序,大多数情况下每一个都会出现.然而这些元素在XML
应用程序处理过程中不能重复出现.(如,显示程序应能保持包含在这些元素的信息的顺序).

最后,"country"元素的内容应该是符合ISO3166的双字节码.
"phone","facsimile","email",及"uri"元素都只能出现一次,如:

+14156953975
mrose@not.invisible.net


2.2.3date元素
"date"元素标识了文档的出版时间,它包括一个"month"和一个"year",如:

"date"元素也有一个可选的属性.
2.2.4MetaData元素s
"front"元素也可能包含metadata–此元素间的内容不会在印刷版的文档中显示出来.
一篇文档有一个或多个可选的"area","workgroup"和"keyword"元素,如:
General
RFCBeautificationWorkingGroup
RFC
RequestforComments
I-D
Internet-Draft
XML
ExtensibleMarkupLanguage

"area"元素标识了文档的大致范畴,(如,"Applications","General","Internet",
"Management","Operations","Routing","Security","Transport",或"User"中的一个),而
"workgroup"元素标识了制订本文档的IETF工作组,"keyword"元素标识了一些有用的搜索条件.

2.2.5abstract元素

一篇文档可能有一个"abstract"元素,它包含了一个或多个"t"元素(见2.3.1.1).一般地说,只
有一个"t"元素会出现,如,

ThismemopresentsatechniqueforusingXML
(ExtensibleMarkupLanguage)asasourceformat
fordocumentsintheInternet-Drafts(I-Ds)and
RequestforComments(RFC)series.



2.2.6note元素

一篇文档可以有一个或多个"note"元素,其中每一个元素可以包含一个或多个"t"元素(见
2.3.1.1).其中有一个必须的"title"属性.一般地说,"note"元素包含从IESG来的文本,例:


TheIESGhassomethingtosay.


2.2.7状态,版权申明,目录

注意到有关文档状态,版权申明,或目录等内容并没有包含在文档中–当XML应用程序创建文本文
档或HTML文档时,它会被自动插入到XML应用程序中.

2.2.7.1与RFC2026相一致

如果提出了Internet草案,则"ipr"必须在文件开始处加入到""标签中.该属性的值必须为
以下之一:
full2026:说明此文档是完全顺应RFC2026第10章规定的;

noDerivativeWorks2026:说明此文档是完全顺应RFC2026第10章规定,但没有经过授权不能有相
关派生工作.
或:

none:说明此文档不是顺应RFC2026第10章规定的,除了作为Internet草案出版之外,作者不提供
予其它任何权利.
后面这种情况,XML应用程序在创建过程中不会自动插入版权申明.

更多详细情况请参阅[3].

最后,如果该Internet草案是被提交到自动处理过程中,则"docName"必须在文件开始处加入到
""标签中.该属性的值包含与Internet草案关联文档(不是文件)的名称.如,


...


2.2.8开始中的一切
现在,把它们连在一起,我们有下例,


WritingI-DsandRFCsusingXML

fullname="MarshallT.Rose">
InvisibleWorlds,Inc.



660YorkStreet
M/S40
SanFranciscoCA
94110
US


+14156953975
mrose@not.invisible.net






General
RFCBeautificationWorkingGroup
RFC
RequestforComments
I-D

Internet-Draft
XML
ExtensibleMarkupLanguage

ThismemopresentsatechniqueforusingXML
(ExtensibleMarkupLanguage)asasourceformat
fordocumentsintheInternet-Drafts(I-Ds)and
RequestforComments(RFC)series.




2.3Middle

"middle"元素包含文档的除参考书目和附录之外的所有章节:

...







...

"middle"元素包含一个或多个"section"元素s.

2.3.1section元素

每一个"section"元素包含了文档的一个章节.有一个必须的属性,就是"title",标识了该章节的
标题.还有一个可选的属性"anchor",它和"xref"元素一起使用,以能进行联结.(见2.3.1.4),
例:


...


"section"元素是可以递归的–每一个元素可以包含以下"t","figure",和"section"元素的
任意组合,如,


...

...
...
...
...
...
...
...



2.3.1.1t元素

"t"元素可包含任意段落,列表和图片的组合.如果在章节,图片或者参考中需要有交叉联结
(cross-reference),则可以使用"xref"元素(见2.3.1.4);同样,如果有外部联结,则使用"eref"元
素(见2.3.1.5)."iref"元素可以提供文本的索引(见2.3.1.6).

2.3.1.2list元素

"list"元素包含一个或多个条目.每一个条目是一个"t"元素,允许递归,如,


Thepfirstitem.
Theseconditem,whichcontainstwobulletedsub-items:

Thefirstsub-item.
Thesecondsub-item.




"list"元素有一个可选的属性"style",其值可以为"numbers"(数值型列表),"symbols"(子弹
型列表),"hanging"(悬挂型列表),或,"empty"(锯齿型列表).如果"list"元素是嵌套的,它的
缺省值来自于它最近的父元素,否则它的缺省值是"empty".

嵌套了"hanginglist"元素时,"t"元素有一个可选属性"hangText",它标识了被插入的文本,
如:


indicatingthatthedocumentisin
fullconformancewithalltheprovisionsofSection10ofRFC
2026;

indicatingthatthe
文档isinfullconformancewithalltheprovisionsof
Section10ofRFC2026exceptthattherighttoproduce
derivativeworksisnotgranted;or,

indicatingthatthedocumentisNOT
offeredinaccordancewithSection10ofRFC2026,andthe
authordoesnotprovidetheIETFwithanyrightsotherthan
topublishasanInternet-Draft.


2.3.1.3figure元素

"figure"元素组合了一个可选的"preamble"元素,一个"artwork"元素,及一个可选的
"postamble"元素."figure"元素还有一个可选的属性"anchor",它和"xref"元素一起使用用来进
行交叉联结(见2.3.1.4).它还有一个可选属性,用来标识图片的标题.

"preamble和"postamble"元素如果出现,只是简单的文本.如果在章节,图片或者参考中需要有交
叉联结(cross-reference),则可以使用"xref"元素(见2.3.1.4);同样,如果有外部联结,则使用
"eref"元素(见2.3.1.5)."iref"元素可以提供文本的索引(见2.3.1.6).

"artwork"元素是必需的,它包含"ASCIIartwork".它不象在"t","preamble",或"postamble"元
素中包含文本,"artwork"元素中水平和垂直的whitespace都是有意义的.

现在,把它们连在一起,我们有下例,

So,
puttingitalltogether,wehave,e.g.,


asciiartworkgoeshere...

besuretouse"<"or"&"insteadof"<"and"&",
respectively!

whichisaverysimpleexample.

这只是一个很简单的例子.

如果你的作品中有很多"<"符号,有一种XML技巧可以使用:

Ifyouhaveartworkwithalotof"<"
characters,thenthere'sanXMLtrickyoucan
use:

asciiartworkgoeshere...

justdon'tuse">"inyourartwork!
>>

The">"constructiscalled
aCDATAblock--everythingbetweentheinnermostbrackets
isleftalonebytheXMLapplication.



这里">"构造了一种CDATA节–最里面的括号之间的所有内容,XML应用程序
都将进行单独处理.
因为"figure"元素描述了文本或者作品的逻辑组合,XML应用程序生成的文本中在同一页必须保
持这些相同的元素.
因为RFC2223[2]只允许一页不超过49行,一行不超过69字符.为了页面的美观,XML应用程序
应该应能适当做好断页工作.
最后,"artwork"元素有两个可选属性:"name"和"type".前者用来表示"artwork"元素间内容的
名称,而后者用来表示其内容的数据类型.

2.3.1.4xref元素

"xref"元素用来在章节,图片和参考间进行交叉联结.其必须属性"target"用来联结到
"section","figure",或"reference"元素中的"anchor"属性."anchor"的值和"target"属性必须符合
2.1节的语法规定.

如果作为一个空元素使用,如:

根据标志语法.

则XML应用程序在处理中插入适当短语,比如"Section2.1"或"XML
Basics".

如果有内容,如,

顺应RFC2223.

则XML应用程序在处理中插入适当名称,比如"RFC2223[2]"或"RFC
2223".虽然这里的"适当名称"是由XML应用程序决定的,它的选择在文档处理过程中是保持
一致的.

2.3.1.5eref元素

"eref"元素用来说明外部文档.有一个必须属性"target",它是一个URI[4],例,

CafeconLeche

注意"target"属性是必须有的,但"eref"元素却可以是空元素,例:



在处理中XML应用程序会插入适当指示,如"[9]"或是"href="">".

2.3.1.6iref元素

iref"元素用来给索引增添信息,其必须属性"item"是所存放信息的主键,而可选属性"subitem"
是第二键.例:


最后,注意"iref"元素总是空的–它从不会包含任何文本内容.

2.3.1.7vspace元素

"vspace"元素可能只会在出现在"t"元素内,作者用来给出XML应用程序的格式设定.有一个属性,
"blankLines",表示应插入的空行数.如果用缺省值"0"表示物理空行.

另外,"vspace"元素可用来在列表项目中强制产生一物理段落,如:


Thisislistitem.

Thisispartofthesamelistitem,
althoughwhendisplayed,itappears
asaseparatephysicalparagraph.



XML应用程序生成文本文档时需进行仔细实践,当遇到"blankLines"值时可能会引起分页.–在
极端情况下,如果"vspace"元素产生分页,则不能再插入空行.这就允许作者通过使用一些大的属性
值来"强制"产生分页.例:"blankLines='100'".

最后,注意"vspace"元素总是空的–它从不包含任何文本内容.

2.4Backmatter

最后,back"元素用来显示参考附录:

...











back"元素包含可选的"references"元素,已及一个或多个可选的"section"元素."back"元
素本身也是可选的,如果你的文档中没有什么参考或者附录的话,就不需要包括它.

2.4.1references元素

"references"元素包含了文档的参考书目.它包含一个或多个"reference"元素.每一个
"reference"元素包含一个"front"元素及一个或多个可选的"seriesInfo"元素.我们已经在2.2
章中讨论了"front"元素."seriesInfo"元素有两个属性,"name"和"value"分别标识了文档的序列
条目.

"reference"元素有一个可选的"anchor"属性,和"xref"元素(Section2.3.1.4)一起用于联结,
如:



InternetOfficialProtocolStandards
fullname="JonPostel">

USC/InformationSciencesInstitute









"reference"元素还有一个可选的"target"属性用于内部参照(见2.3.1.5).XML应用程序如果
产生HTML文档则会相应用到"target"属性;当然,如果"seriesInfo"元素的"name"属性有"RFC"值的
话,那XML应用程序应自动为"target"属性提供一最佳值
(如,"").

2.4.2附录

要在参考书目之后加入附录,只需简单的增加多个"section"元素.(举个例子,请看2.4.章开头的
例子)

2.4.3版权申明

文档的版权申明包括在文档的结构中--XML应用程序在产生文本文件或HTML文件时会自动插入.

3.处理XML源文件

本章重点是关于XML源文件操作的应用程序.有大量XML工具可以获得,参见CafeconLeche[5].

有两类XML工具:可检查类与非检查类.两类都对源文件进行语法检查(2.1所述语法).然而,为
了保证源文件是结构良好的,一些补充的类工具可以检查DTD参照是否与文件匹配.可以获得很多检查
和非检查类的工具.

3.1编辑

有一些XML编辑器可以获取.一个理想的编辑器应该可以进行检查.有两类标签:

o编辑器可以列出整个文档的结构;并且:

o编辑器可以确认源文件DTD是否符合语法规则.

Emacs对XML的支持主要有两种模式:tdtd[6]和psgml[7].后一种模式允许你对源文件进行
确认.(通过调用一内部程序).如果你访问Emacs中的源文件而且其主模式不是"SGML"或"XML",那么
通常它是把这些行加到".emacs"文件中:

(setqauto-mode-alist
(cons(cons"\\.xml$"'sgml-mode)auto-mode-alist))

然后重启动Emacs.如果不行,试一下上面的源程序.

作者在编辑源程序时在Emacs中使用了所有两种sgml模式,编辑器是一种商业化编辑器Clip!,版
本是1.5[8].

3.1.1检查

如果编辑器不能进行检查,那就要运行程序来检查源文件.

作者为此使用了AlphaWorksXMLparser[9].它需要你的系统里有Java虚拟机.除了Java,他还
能检查C,Perl,Python,和Tcl.

3.2转换为文本模式

作者曾写过一个工具:xml2rfc[10],它可以读源文件并产生文本格式和HTML格式的版本.
(本章程就是用xml2rfc处理的.)注意到xml2rfc不是一个检查工具,所以最好使用一个可检查的
编辑器或者是运行一个解析工具.

3.3转换为HTML格式

XML类型语言(XSL)用来描述如何将源文件转换为其他格式的文件.所以最好使用支持XSL的格式
化器以便将XML源文件转换为HTML格式.

然而,XSL技术还没有完全成型.(所以本文档资料内没有包含这方面的参考资料,因为也许在你看
到时就已经过时了.)所以作为临时过渡,作者使用了xml2rfc工具,虽然它在HTML布局方面没有提供
太大的余地.

3.4预览

支持XSL或CSS的流览器可以直接预览源文件.

当前,作者没有使用任何流览器,没有将源文件转换为文本或HTML格式.

3.5查找

作为文本编辑器,所有的文本查找工具(如,grep)都可以在源文件中使用.当然,有一些可阅读结
构化源程序的的查找工具可以获得.

作者为此使用了sgrep,版本为1.9[11],如下:

sgrep-gxml'elements("title")notin'elements("back")'\
writing-rfcs.xml

它从源文件中查找title元素.

4.安全考虑

本文档资料中没有提到安全条目;但根据[2],你的文档在接近结尾处包含有一段内容,它讨论文
档主要协议或过程的安全性问题,如:


...

本文档资料中没有提到安全条目;
但,但根据[2],
你的文档在接近结尾处包含有一段内容,它讨论文档主要
协议或过程的安全性问题.




参考资料:

[1]WorldWideWebConsortium,"ExtensibleMarkupLanguage(XML)
1.0",W3CXML,February1998.

[2]Postel,J.andJ.Reynolds,"InstructionstoRFCAuthors",RFC
2223,October1997.

[3]Bradner,S.,"TheInternetStandardsProcess--Revision3",BCP
9,RFC2026,October1996.

[4]Berners-Lee,T.,Fielding,R.andL.Masinter,"UniformResource
Identifiers(URI):GenericSyntax",RFC2396,August1998.

[5]

[6]

[7]

[8]

[9]

[10]

[11]~jjaakkol/sgrep.html

作者地址:

MarshallT.Rose
InvisibleWorlds,Inc.
660YorkStreet
SanFrancisco,CA94110
US

Phone:+14156953975
EMail:mrose@not.invisible.net
URI:

附录A.rfc元素

""标签在文件的开始处,它有一个"ipr"属性(2.2.7.1章),产生一个Internet草案.然而,
当RFC编辑器在标签内添加了其他属性时,就产生了一篇RFC,如:

obsoletes="2000,1920,1880,1800,..."
category="std"
seriesNo="1">

最起码,"number"属性是应该有的.

其他的属性有:

o"obsoletes",RFC数用豆号分开,文档陈旧;

o"updates",用豆号分开,文档更新;

o"category",值为以下之一:

1."std",标准文档;

2."bcp",最流行文档;

3."exp",试验草案文档;

4."historic",历史文档;或,

5."info",缺省值,信息文档.

o"seriesNo",STD(std),BCP(bcp),或FYI(info)系列的相应号码.

最后,还有一个特殊的实体"&rfc.number;".作者在引用RFC文档自身的页数时需要用到它.打印
的文档中会出现有一适当的标记(如"XXXX").

附录B.RFCDTD



























number%NUMBER;#IMPLIED
obsoletes%NUMBERS;""
updates%NUMBERS;""
category(std|bcp|info|exp|historic)
"info"
seriesNo%NUMBER;#IMPLIED
ipr(full2026|noDerivativeWorks2026|none)
#IMPLIED
docName%ATEXT;#IMPLIED>



abstract?,note*)>



abbrev%ATEXT;#IMPLIED>



initials%ATEXT;#IMPLIED
surname%ATEXT;#IMPLIED
fullname%ATEXT;#IMPLIED>

(%CTEXT;)>
abbrev%ATEXT;#IMPLIED>
















day%DAY;#IMPLIED
month%MONTH;#REQUIRED
year%YEAR;#REQUIRED>








title%ATEXT;#REQUIRED>






anchorID#IMPLIED
title%ATEXT;#REQUIRED>


hangText%ATEXT;#IMPLIED>



style(numbers|symbols|hanging|empty)
"empty">


targetIDREF#REQUIRED
pageno(true|false)"false">


target%URI;#REQUIRED>


item%ATEXT;#REQUIRED
subitem%ATEXT;"">


blankLines%NUMBER;"0">


anchorID#IMPLIED
title%ATEXT;"">



xml:space(default|preserve)"preserve">









anchorID#IMPLIED
target%URI;#IMPLIED>

name%ATEXT;#REQUIRED
value%ATEXT;#REQUIRED>

附录C.感谢

作者对下列作出贡献者深表感谢:AlanBarrett,BradBurdick,BrianCarpenter,SteveDeering,
PatrikFaltstrom,JimGettys,CarlMalamud,ChrisNewman,KurtStarsinic,以及,FrankStrauss.

索引

I
索引
howto16

完全版权申明(英文原文)

Copyright(C)TheInternetSociety(1999).AllRightsReserved.

Thisdocumentandtranslationsofitmaybecopiedandfurnishedto
others,andderivativeworksthatcommentonorotherwiseexplainit
orassistinitsimplementationmaybeprepared,copied,published
anddistributed,inwholeorinpart,withoutrestrictionofany
kind,providedthattheabovecopyrightnoticeandthisparagraphare
includedonallsuchcopiesandderivativeworks.However,this
documentitselfmaynotbemodifiedinanyway,suchasbyremoving
thecopyrightnoticeorreferencestotheInternetSocietyorother
Internetorganizations,exceptasneededforthepurposeof
developingInternetstandardsinwhichcasetheproceduresfor
copyrightsdefinedintheInternetStandardsprocessmustbe
followed,orasrequiredtotranslateitintolanguagesotherthan
English.

Thelimitedpermissionsgrantedaboveareperpetualandwillnotbe
revokedbytheInternetSocietyoritssuccessorsorassigns.

Thisdocumentandtheinformationcontainedhereinisprovidedonan
"ASIS"basisandTHEINTERNETSOCIETYANDTHEINTERNETENGINEERING
TASKFORCEDISCLAIMSALLWARRANTIES,EXPRESSORIMPLIED,INCLUDING
BUTNOTLIMITEDTOANYWARRANTYTHATTHEUSEOFTHEINFORMATION
HEREINWILLNOTINFRINGEANYRIGHTSORANYIMPLIEDWARRANTIESOF
MERCHANTABILITYORFITNESSFORAPARTICULARPURPOSE.

阅读(2220) | 评论(0) | 转发(0) |
给主人留下些什么吧!~~