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