RSS 與 Atom feed 為網站提供了一條高效率的路徑:訪客可以訂閱您的站點,並在新內容上線時收到通知。在重視隱私、對垃圾郵件心存戒備的今天,這種訂閱方式愈顯珍貴——讀者拿到最新資訊,卻不必交出任何個人資料。
RSS 在部落格圈已經是標配,但它的用處絕不限於部落格。任何想經營忠實受眾的網站都能受益。
網站管理者面臨的難題是:RSS 與 Atom 仍相對新鮮,知道的人不多,懂得使用並已安裝合適軟體的人更少。
更棘手的是,您必須在站上放一個 feed 連結供人訂閱,可是訪客一按下去,映入眼簾的往往是一大段 XML 原始碼——這畫面實在稱不上友善。
Web 內容聯播正處於過渡期。它的價值已經被驗證,值得納入網站規劃,但仍有大量使用者尚未準備好訂閱。Apple Safari 是第一個內建 RSS 支援的主流瀏覽器(2005 年),Firefox 1.5、Internet Explorer 7 與 Opera 9 隨後跟上。等到所有主流瀏覽器都具備完善的 RSS 能力,還需要一段時間;而使用者完成版本升級,往往又再慢一兩年。在那之前,您不能假設每位訪客都拿著支援 RSS 的瀏覽器。
因此,在過渡期內,最好準備一個幾乎能與所有瀏覽器協同工作的替代方案。
事情是這樣的:RSS 或 Atom feed 本質上就是一份 XML 文件。使用者點擊連結時,瀏覽器下載文件,然後試著把它當 XML 顯示——也就是原始碼。更糟的是,某些版本的 Internet Explorer 還會跳出安全性警告。
技術上,RSS feed 應使用 application/rss+xml 這個 MIME 類型,Atom 則標示為 application/atom+xml。若 MIME 類型正確,且訪客機器上確實裝了新聞聚合器,瀏覽器就會自動把它啟動起來。
現實是,很少有訪客具備這樣的配置,他們多半會看到一則晦澀的錯誤訊息。於是大多數站點乾脆改用 text/xml 或 application/xml——嚴格說並不正確,但至少瀏覽器能把原始 XML 顯示出來。這只是比錯誤訊息好一點,效果等於對使用者說:這堆東西,您看得懂多少算多少。
還有更糟的情況:因為設定失誤,某些站點把 XML 文件當成 application/octet-stream 送出。網站管理者應該更新伺服器設定以採用正確的 MIME 類型,例如 Apache 上這是在 .htaccess 檔案中處理的。
為了緩解問題,新一代瀏覽器會「嗅探」(sniff)傳入的 XML 文件,讀取開頭幾個位元組來判斷它是 RSS 還是 Atom。但這招的前提,仍然是訪客得用一個支援 RSS 的瀏覽器。
幸而有一個更好的解法:XSLT 樣式表。如果瀏覽器把 feed 當成 XML 處理,樣式表就會把它渲染成一頁清楚的說明;如果瀏覽器認得出這是 RSS 或 Atom feed,樣式表則會被忽略。兩邊都顧到了。
清單 1 是一份關聯了樣式表的 RSS 文件(取自筆者自己的播客 feed)。請留意第二行的 xml-stylesheet 處理指令,這正是通往樣式表的關鍵環節,href 屬性指向樣式表的路徑。
清單 1. RSS 摘錄
<?xml version="1.0" encoding="utf-8"?>
<?xml-stylesheet type="text/xsl" href="rssfeed.xsl"?>
<rss>
<channel>
<title>Déclencheur</title>
<link>https://www.declencheur.com/</link>
<description>Le podcast qui parle photos.</description>
<language>fr</language>
<pubDate>Tue, 11 Jul 2006 15:31:46 +0200</pubDate>
<item>
<title>Cadrage</title>
<link>https://www.declencheur.com/clic/archives/2006/07/esposito</link>
<description><![CDATA[<p>En 20 minutes, Nicolas nous resume son cours
d'esthetique. Il nous livre de nombreuses techniques, astuces et regles
d'esthetique pour ameliorer nos photos.</p>]]></description>
<pubDate>Mon, 03 Jul 2006 21:30:21 +0200</pubDate>
<enclosure length="34812500" type="audio/mpeg"
url="https://www.declencheur.com/clic/medias/2006/decl-2006-07-03.mp3"/>
</item>
</channel>
</rss>
清單 2 就是那份樣式表。熟悉 XSLT 的人幾分鐘內就能寫出類似的东西,但請先讀完下一節提到的那個特殊陷阱。
清單 2. XSLT 樣式表
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet xmlns:xsl="https://www.w3.org/1999/XSL/Transform" version="1.0">
<xsl:output method="html"/>
<xsl:template match="/">
<html>
<head>
<title><xsl:value-of select="rss/channel/title"/></title>
<script type="text/javascript" src="xsl_mop-up.js"/>
</head>
<body onload="go_decoding();">
<h1><a href="{rss/channel/link}">
<xsl:value-of select="rss/channel/title"/></a></h1>
<div id="cometestme" style="display:none;">
<xsl:text disable-output-escaping="yes">&</xsl:text>
</div>
<p>This is an RSS feed, you must install a news aggregator to subscribe to it.
This feed contains the following items:</p>
<p><xsl:value-of select="rss/channel/description"/></p>
<xsl:for-each select="rss/channel/item">
<h2><a href="{link}">
<xsl:value-of select="title"/></a></h2>
<div name="decodeable">
<xsl:value-of select="description" disable-output-escaping="yes"/>
</div>
<xsl:if test="enclosure">
<p><a href="{enclosure/@url}">Extra...</a></p>
</xsl:if>
</xsl:for-each>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
要注意的是,樣式表本身也是一份 XML 文件(就像 RSS 或 Atom feed 一樣),而且會用到命名空間(與 Atom 元素或 RSS 擴充元素的情形相同)。撰寫 XML 時語法必須嚴謹:每個開始標記(如 <p>)都要有對應的結束標記(</p>),空元素則得採用特殊寫法(<br />)。
樣式表中包含兩類內容:控制呈現的 XSLT 指令(位於 https://www.w3.org/1999/XSL/Transform 命名空間,清單 2 中皆以 xsl 前綴開頭),以及控制版面配置的 HTML 標籤。若想讓輸出符合自家網站的版型,編輯 xsl:template 元素的內容即可,但務必保留其中的 XSLT 指令。
xsl:value-of:從 RSS 或 Atom 文件中取值,插入 HTML。它接受一個 select 屬性,值就是您感興趣的元素路徑。例如要取出 feed 標題,路徑寫成 rss/channel/title,因為 title 位於 channel 之下,而 channel 又包在 rss 裡頭。路徑的寫法很直觀:照元素在文件中出現的順序一路列出。若要讀取屬性的值,在屬性名前加上 @,例如 rss/channel/item/enclosure/@url。
xsl:for-each:迴圈指令,透過 select 選出一組元素並逐一處理。清單 2 中被反覆遍歷的是各個 item,每一項都輸出標題、描述與附件連結。
屬性中的大括號:大括號只用在屬性值裡,作用與 xsl:value-of 相當,差別在於它從普通文本中取值。樣式表中多個 href 屬性就是用這種方式填入的。
xsl:if:條件成立時才執行。清單 2 用它判斷該不該輸出附件資訊。
這些只是 XSLT 的皮毛,但搭配複製貼上與清單 2 這個範本,就足以改造出符合自家網站版型的樣式表。若樣式表不如預期運作,建議依序檢查:
xmlns:xsl 屬性)是否正確,且 URI 切勿更動。xml-stylesheet 指令;若您使用的不支援,可改用 FeedBurner 來加工 feed。如果 Firefox 支援 XSLT 的 disable-output-escaping 特性,RSS 與 Atom 的世界會美好許多,可惜它並不支援。
這個特性有個單一明確的用途:處理嵌套在其他標記中的標記,例如 CDATA 區段——而 RSS 與 Atom 大量使用 CDATA 來嵌入 HTML 片段。
有了 disable-output-escaping,您理應能把 feed 中的 HTML 標記正確地放進頁面的 HTML 結構裡。但 Firefox 直接忽略了這道指令,最後把原始 HTML 標籤顯示了出來。
這行為是否符合標準,在 Firefox 社群中爭論已久。無論結論為何,問題就在眼前,得想辦法繞過。
好消息是,Sean M. Burke 寫了一段巧妙的 JavaScript 來規避這個限制,並慷慨地公開讓任何人自由用於任何專案。要讓腳本正常運作,樣式表必須放進一個 id 為 cometestme 的 div,並把需要解除轉義的內容包在名為 decodeable 的段落中;最後,在 HTML 文件載入時呼叫 go_decoding()。
單純列出 feed 中的項目只是起點。畢竟網站上本來就有內容,feed 的設計目的是促成訂閱,而不是複製內容。
常見做法
多數替 feed 掛上 XSLT 樣式表的網站,會在頁面上說明如何安裝聚合器、如何訂閱。聽起來合情合理,但依筆者經驗,看到這類頁面的訪客往往不會真的去裝一套軟體——在病毒與木馬橫行的環境下,任何「請安裝程式」的要求都會引起戒心。
於是不少站點改為引導訪客去用線上聚合器,例如 Google Reader 或 Yahoo!。這看似聰明,但成效令人懷疑:除非訪客本來就訂閱了很多 feed,否則注册一項新服務的意願未必比安裝軟體高。就算他們真的註冊了,之後主動回去開聚合器的機率又有多少?筆者的想法很實際:如果訪客非得把某個網站加入書籤,那我寧願是我的網站。
另一條路
就個人經驗而言,筆者提供了「以電子郵件訂閱」這個選項,透過 RSS-to-email 服務達成。這麼做有個穩妥的假設:所有訪客都有電子郵件地址。加上清楚的說明與一個顯眼的訂閱表單之後,結果相當有意思——在筆者的播客網站上,約每五位訪客就有一位寧願用郵件訂閱,而非 RSS。
RSS 與 Atom 或許是更優雅的技術方案,但對許多訪客來說,沒什麼比一個熟悉的服務更有說服力,而電子郵件正是最熟悉的那一個。
為了避免在多個地方重複撰寫訂閱說明(版本一多,日後就容易不一致),筆者用了清單 3 的樣式表。它比清單 2 簡單得多,作用是做一個 HTML 重定向,把訪客帶到站內的說明頁。
清單 3. 最省事的做法?重定向。
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet xmlns:xsl="https://www.w3.org/1999/XSL/Transform" version="1.0">
<xsl:output method="html"/>
<xsl:template match="rss/channel">
<html>
<head>
<title><xsl:value-of select="title"/></title>
<meta http-equiv="refresh" content="0;url=https://www.declencheur.com/clic/archives/2006/03/abonnement" />
</head>
<body>
<h1><xsl:value-of select="title"/></h1>
<p>Welcome, you are on the RSS feed of <xsl:value-of select="title"/>.
The feed offers free subscription services for <xsl:value-of select="title"/>.</p>
<p>In a moment, you will be redirected to a page with more instructions.
<a href="https://www.declencheur.com/clic/archives/2006/03/abonnement">Click here</a>
if the new page fails to open.</p>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
訪客點開 RSS feed 時,若瀏覽器認不出它,就會被導向說明頁。
這篇文章談的是如何替 RSS 或 Atom feed 準備一張友善的「面孔」。在聚合技術真正普及之前,把這些做法當成一項保險措施提前佈署,是相當值得的投資。