作者：HelloGitHub-追夢(mèng)人物 

文中所涉及的示例代碼，已同步更新到 HelloGitHub-Team 倉(cāng)庫

博客提供 RSS 訂閱應(yīng)該是標(biāo)配，這樣讀者就可以通過一些聚合閱讀工具訂閱你的博客，時(shí)時(shí)查看是否有文章更新，而不必每次都跳轉(zhuǎn)到博客上來查看?，F(xiàn)在我們就來為博客添加 RSS 訂閱功能。

RSS 簡(jiǎn)介

RSS（Really Simple Syndication）是一種描述和同步網(wǎng)站內(nèi)容的格式，它采用 XML 作為內(nèi)容傳遞的格式。簡(jiǎn)單來說就是網(wǎng)站可以把內(nèi)容包裝成符合 RSS 標(biāo)準(zhǔn)的 XML 格式文檔。一旦網(wǎng)站內(nèi)容符合一個(gè)統(tǒng)一的規(guī)范，那么人們就可以開發(fā)一種讀取這種規(guī)范化的 XML 文檔的工具來聚合各大網(wǎng)站的內(nèi)容。例如一個(gè)讀者可能關(guān)注了很多的博客網(wǎng)站，如果這些博客網(wǎng)站都支持 RSS 訂閱的話，他就只需要一個(gè)聚合閱讀器訂閱這些博客，就可以在聚合器工具里看到全部博客的更新內(nèi)容，而不必再分別訪問各個(gè)博客去看有沒有內(nèi)容更新了。更多 RSS 的介紹，可參考rss （簡(jiǎn)易信息聚合）。

使用 Django Feed 類

根據(jù)以上對(duì) RSS 的介紹，我們可以發(fā)現(xiàn)關(guān)鍵的地方就是根據(jù)網(wǎng)站的內(nèi)容生成規(guī)范化的 XML 文檔，幸運(yùn)的是，Django 已經(jīng)內(nèi)置了一些生成這個(gè)文檔的方法，下面就使用這些方法來創(chuàng)建 RSS 訂閱文檔。

首先我們?cè)?blog 應(yīng)用的根目錄下（models.py 所在目錄）新建一個(gè) feeds.py 文件以存放和 RSS 功能相關(guān)的代碼。讓后在 feeds.py 中寫入如下代碼：

blog/feeds.py

from django.contrib.syndication.views import Feed

from .models import Post


class AllPostsRssFeed(Feed):
  # 顯示在聚合閱讀器上的標(biāo)題
  title = "HelloDjango-blog-tutorial"

  # 通過聚合閱讀器跳轉(zhuǎn)到網(wǎng)站的地址
  link = "/"

  # 顯示在聚合閱讀器上的描述信息
  description = "HelloDjango-blog-tutorial 全部文章"

  # 需要顯示的內(nèi)容條目
  def items(self):
    return Post.objects.all()

  # 聚合器中顯示的內(nèi)容條目的標(biāo)題
  def item_title(self, item):
    return "[%s] %s" % (item.category, item.title)

  # 聚合器中顯示的內(nèi)容條目的描述
  def item_description(self, item):
    return item.body_html

代碼應(yīng)該不難理解，主要就是指定要生成的 XML 文檔內(nèi)容。各個(gè)屬性和方法的含義已在代碼中注釋，你只需把相關(guān)的內(nèi)容替換成符合你博客的描述即可。

需要注意一點(diǎn)的是這個(gè)方法：

  # 聚合器中顯示的內(nèi)容條目的描述
  def item_description(self, item):
    return item.body_html

item 是文章 （Post 模型的實(shí)例），聚合內(nèi)容的描述我們返回了 body_html 屬性的值。模型中原本使用 body 屬性存儲(chǔ)博客文章的內(nèi)容，但是這些內(nèi)容是以 Markdown 格式的，并非所有的聚合內(nèi)容閱讀器都支持 Markdown 格式的解析，因此我們返回的是已經(jīng)解析后的 HTML 格式內(nèi)容。

但 Post 模型原來并沒有 body_html 這個(gè)屬性的，那它是哪里來的呢？

回顧一下 PostDetailView 這個(gè)視圖，我們?cè)讷@取博客文章 post 的詳細(xì)內(nèi)容的視圖中，使用 markdown 這個(gè) Python 庫在解析 post.body 這個(gè)屬性的值。這個(gè)解析的過程其實(shí)在很多地方都可能用到，不應(yīng)該寫死在 PostDetailView 這個(gè)視圖里，所以我們先將 PostDetailView 視圖的 get_object 方法解析 Markdown 內(nèi)容的過程封裝為一個(gè)函數(shù)，暫且將其放在 blog/models.py 中。

blog/models.py

def generate_rich_content(value):
  md = markdown.Markdown(
    extensions=[
      "markdown.extensions.extra",
      "markdown.extensions.codehilite",
      # 記得在頂部引入 TocExtension 和 slugify
      TocExtension(slugify=slugify),
    ]
  )
  content = md.convert(value)
  m = re.search(r'<div class="toc">\s*<ul>(.*)</ul>\s*</div>', md.toc, re.S)
  toc = m.group(1) if m is not None else ""
  return {"content": content, "toc": toc}

解析過程和原來一樣，只是將解析得到的 HTML 內(nèi)容（content）和目錄（toc）放在一個(gè)字典里返回。

然后，我們來給 Post 模型定義幾個(gè)屬性，以便方便地獲取解析后的內(nèi)容和目錄：

blog/models.py

from django.utils.functional import cached_property

class Post(models.Model):
  # 省略其它代碼
  
  @property
  def toc(self):
    return self.rich_content.get("toc", "")

  @property
  def body_html(self):
    return self.rich_content.get("content", "")

  @cached_property
  def rich_content(self):
    return generate_rich_content(self.body)

首先看到 rich_content 這個(gè)方法，它返回的是 generate_rich_content 函數(shù)調(diào)用后的結(jié)果，即將 body 屬性的值經(jīng) Markdown 解析后的內(nèi)容。但要注意的是我們使用了 django 提供的 cached_property 裝飾器，這個(gè)裝飾器和 Python 內(nèi)置的 property 裝飾器功能一樣，可以將方法轉(zhuǎn)為屬性，這樣就能夠以屬性訪問的方式獲取方法返回的值，不過 cached_property 進(jìn)一步提供緩存功能，它將被裝飾方法調(diào)用返回的值緩存起來，下次訪問時(shí)將直接讀取緩存內(nèi)容，而不需重復(fù)執(zhí)行方法獲取返回結(jié)果。例如對(duì)博客文章內(nèi)容的 Markdown 解析是比較耗時(shí)的，而解析的結(jié)果可能被多次訪問，因此將其緩存起來能起到優(yōu)化作用。

為了更方便地獲取文章的 HTML 格式的內(nèi)容和目錄，我們進(jìn)一步將 generate_rich_content 返回的值放到 toc 和 body_html 兩個(gè)屬性中，這里兩個(gè)屬性都從 rich_content 中取值，cached_property 的作用就發(fā)揮出來了。

添加 URL

接下來就是指定 URL 模式，讓人們?cè)L問這個(gè) URL 后就可以看到 Feed 生成的內(nèi)容。通常 RSS 的 URL 配置直接寫在項(xiàng)目的 urls.py 文件里，即打開 blogproject/urls.py 文件，添加如下代碼：

blogproject/urls.py

from blog.feeds import AllPostsRssFeed

urlpatterns = [
  path('admin/', admin.site.urls),
  path('', include('blog.urls')),
  path('', include('comments.urls')),

  # 記得在頂部引入 AllPostsRssFeed
  path('all/rss/', AllPostsRssFeed(), name='rss'),
]

修改模板

簡(jiǎn)單修改一下 templates/base.html 模板，把 RSS 的 URL 添加到模板中：

<div class="rss">
  <a href="{% url 'rss' %}" rel="external nofollow" ><span class="ion-social-rss-outline"></span> RSS 訂閱</a>
</div>

此外，由于將 Markdown 解析的內(nèi)容放在了 body_html 屬性，將之前博客文章詳情模板里獲取文章內(nèi)容的代碼也做相應(yīng)調(diào)整：

templates/blog/detail.html

<div class="entry-content clearfix">
  {{ post.body_html|safe }}
</div>

運(yùn)行開發(fā)服務(wù)器，在側(cè)邊欄點(diǎn)擊 RSS 訂閱的鏈接，就跳轉(zhuǎn)到 /all/rss/，你會(huì)看到這對(duì)亂碼一樣的東西，這就是生成的 RSS 標(biāo)準(zhǔn)文檔，當(dāng)然這個(gè)文檔不是給你讀的，而是給 RSS 聚合閱讀器工具讀的。

RSS 測(cè)試插件

可以在本地測(cè)試一下訂閱效果，我使用的 Chrome 瀏覽器，安裝了一個(gè) RSS Feed Reader 的應(yīng)用，如果你也使用的 Chrome 瀏覽器，可以從應(yīng)用商店添加它，然后就可以在本地測(cè)試訂閱效果了。如果是其它瀏覽器，自行查找相關(guān) RSS 閱讀插件即可。我本地測(cè)試效果如下：

可以看到訂閱成功了，訂閱界面顯示的信息就是我們?cè)?AllPostsRssFeed 類中指定的相關(guān)信息。大功告成，現(xiàn)在任何人都可以訂閱我們的博客了！

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

最新評(píng)論