[指南] RSS 檢測與故障排除 @地瓜大的飛翔旅程

章節連結

RSS網址和檢測網站
常見錯誤訊息

1. XML or text declaration not at start of entity
2. Xml parsing error: …… not well-formed (invalid token)

自訂 Feedly 中的 Logo 和背景圖 (WordPress)
參考資料

RSS 的訂閱服務，是一個 Blog 站的基本功能之一。縱使現今使用 RSS 的人也越來越少，但 Blog 還是需要提供一個方便人家訂閱你的管道。這篇主要講述如何面對 RSS 無法正常被解析以及排除方法。

RSS網址和檢測網站

當你要公布你的RSS網址之前，請先上 http://www.feedvalidator.org/ 檢測。Wordpress 系統中，預設的 RSS 為開啟，網址為：

// RSS Link
http://example.com/feed/
http://example.com/feed/rss/
http://example.com/feed/rss2/
http://example.com/feed/rdf/
http://example.com/feed/atom/

// RSS Link

http://example.com/feed/

http://example.com/feed/rss/

http://example.com/feed/rss2/

http://example.com/feed/rdf/

http://example.com/feed/atom/

常見錯誤訊息

1. XML or text declaration not at start of entity

由於 XML 是一種相當嚴格的標記語言，多一個空行或是一個空白，都有可能導致出錯。通常，插件或是主題的 functions.php 中，在開啟的 php 標記前，不可以有多餘的空行或是空白。

另外，function 中的 “}” 結尾後方，不可以有任何的空白、字串、換行符號，不然也是會出現錯誤。最後，文件末端不需要有關閉的 php 標記。

2. Xml parsing error: …… not well-formed (invalid token)

這類的錯誤，有可能是插件造成、主題造成或者是文章內的某一個符號或文字，導致的錯誤。所以解決方法有：
A. 關閉所有的插件，一個一個重開測試
B. 更換主題
C. 將出錯的文章(通常是第一篇)轉成草稿，然後把報錯的那段文字改寫或是刪除後再重試。

自訂 Feedly 中的 Logo 和背景圖 (WordPress)

// functions.php
function offf_add_namespace() {
    echo 'xmlns:webfeeds="http://webfeeds.org/rss/1.0"';
}
add_action( 'rss2_ns', 'offf_add_namespace' );

function offf_add_header_information() {
    echo '<webfeeds:icon>https://url/to/logo.svg</webfeeds:icon>
    <webfeeds:logo>https://url/to/logo.svg</webfeeds:logo>';
}
add_action( 'rss2_head', 'offf_add_header_information' );