from http://www.opml.org/spec & http://www.opml.org/spec2
跟RSS打交道經(jīng)?？吹絆PML, 它的主要用途是用來批量導(dǎo)入導(dǎo)出RSS Feed。一個OPML文件中可以包含大量的RSS Feed信息，一個應(yīng)用場景是:可以把網(wǎng)站的多個RSS FEED(甚至包含層次結(jié)構(gòu))寫在在一個OPML文件里,讓用戶在RSS閱讀器一次訂閱,不再手工添加一條條的RSS FEED費時費力了.雖然有人對其格式有所詬病,但是它已成為目前事實上的標(biāo)準(zhǔn).
一時好奇,尋根究底,到官方網(wǎng)站上仔細(xì)研究了下,下面是順手翻譯的OPML 1.0 規(guī)范. (略去了一些不影響理解OPML格式的內(nèi)容)也許你也奇怪沒有看到xmlUrl, htmlUrl等常見的東東,其實現(xiàn)在存在很多種不一樣格式的OPML文件用于訂閱RSS, 比如"htmlUrl" & "xmlUrl" vs "htmlurl" & "xmlurl", type="rss" vs. no type attribute, "title" and "description" vs. "text", and version="RSS" & version="RSS2" vs. no version attribute.請看看2006年3月的2.0規(guī)范草稿吧.因為沒有定稿,暫不翻譯,納入了對大量使用的RSS訂閱情形進(jìn)行了特別的格式增訂:主要是要求outline元素必須有type, text, xmlUrl屬性,可選description, htmlUrl, language, title, version屬性.另外outline元素的類型type有以下幾種建議類型:include, link, rss
OPML 1.0 規(guī)范
關(guān)于本文檔
本文檔用于描述OPML(Outline Processor Markup Language)格式: 是一種用XML 1.0存儲大綱內(nèi)容的"大綱處理標(biāo)記語言". "大綱"指滿足這樣條件的一棵樹:其每個節(jié)點都有一組string類型的命名屬性.
例子
"大綱"可用于規(guī)范, 法律條款, 產(chǎn)品計劃, 演講稿, 電影劇本, 通信錄, 日記, 討論組, 聊天系統(tǒng)和小說等."大綱處理器"是指使用戶能讀,寫,識別"大綱"結(jié)構(gòu)的程序.一些示例OPML文檔: 播放列表, 規(guī)范, 演講稿.
目標(biāo)
OPML格式旨在為不同"大綱處理器"提供一種交換數(shù)據(jù)的方式.設(shè)計目標(biāo)是簡單,自描述,可擴(kuò)展,人可閱讀,能存儲和表達(dá)很大范圍內(nèi)的數(shù)據(jù),且能方便地瀏覽和編輯. 在版本的進(jìn)化中將保持這種設(shè)計目標(biāo).一個技術(shù)人員在閱讀一個網(wǎng)頁后應(yīng)該能完全理解這種格式.
這是一種開放的格式, 也就是說其他"大綱處理器"開發(fā)者和服務(wù)提供者可以為兼容Radio UserLand 或其他目的自由地使用此格式.
<opml>是什么?
<opml>是一個XML元素, 僅有一個必需的屬性:version; 須具有一個<head>和一個<body>元素.version屬性是一個版本信息字符串, 形如x.y, 其中x,y都是數(shù)字.
<head>是什么?
<head>包含如下所述的0個或多個屬性:
<title> 文檔標(biāo)題.
<dateCreated> 文檔創(chuàng)建時間.
<dateModified> 文檔最后修改時間.
<ownerName> 文檔擁有者.
<ownerEmail> 文檔擁有者Email地址
<expansionState> 一個逗號分隔的展開行行號列表. 列表中的行號告知哪些標(biāo)題(headline)是展開的. 順序是很重要的. 如列表中的元素X, 則從頭開始數(shù)X下, 那一行應(yīng)該是展開的.
<vertScrollState> 是一個數(shù)字,它指示了大綱的哪一行應(yīng)該在窗口的最上面.該數(shù)字是在考慮了"展開狀態(tài)"后計算出來的.
<windowTop> 是一個數(shù)字,指示了窗口的上沿的位置.
<windowLeft> 是一個數(shù)字,指示了窗口的左側(cè)的位置.
<windowBottom> 是一個數(shù)字,指示了窗口的下沿的位置.
<windowRight> 是一個數(shù)字,指示了窗口的右側(cè)的位置.
<head>注意事項
<head>的子元素有可能被程序忽略. 如果一個大綱在另一個大綱中打開, 程序不能使用windowXxx元素, 因為這些元素只定義了該大綱自身在窗口中打開時大小和位置.
所有日期時間相關(guān)的元素,格式服從RFC 822.
你在程序中加載opml時, 可以自由決定是否使用expansionState. 定義它是因為有時可能需要用到.
<body>是什么?
body> 包含一個或更多的<outline> 元素
<outline>是什么?
一個<outline> 是一個可能包含一個或多個屬性及任意數(shù)目<outline>子元素的XML元素.
常用屬性:
text: 在瀏覽或編輯大綱時顯示的文字. 無長度限制.
type: 借以說明其他屬性的意義.
isComment: 取值為"true" 或 "false"的字符串, 指示該outline是否是評論. 按慣例如果一個outline是評論,其子元素outline也都是評論. 如果無此屬性,則表示非評論.
isBreakpoint: 取值為"true" or "false"的字符串, 指示該outline是否設(shè)置了斷點. 該屬性主要是用于編輯和運行腳本的outline. 如果無此屬性,則表示未設(shè)置斷點.
兼容性
1.0版本之前有個根元素outlineDocument. Radio UserLand會繼續(xù)讀取該元素outlineDocument. .
限制
<outline>元素的屬性和子元素數(shù)目無限制.
注意
OPML是一種文件格式, 不是協(xié)議.
一般說來,通過HTTP 獲取OPML文檔時MIME類型為text/xml.
Copyright and disclaimer
© Copyright 2000 UserLand Software, Inc. All Rights Reserved.
