{"title":"Feed 聚合框架","version":"4.0","locale":"zh-hans","docname":"ref/contrib/syndication","url":"/zh-hans/4.0/ref/contrib/syndication/","canonical":"https://djangodocs.dev/zh-hans/4.0/ref/contrib/syndication/","summary":"Django 提供了一个高级的 feed 聚合生成框架来创建 RSS 和 Atom feed。 要创建任何聚合 feed，你只需要写一个简短的 Python 类。你可以创建任何你想要的 feed。 Django 还提供了一个低级别的 feed 生成 API。如果你想在网络内容之外或以其他较低级别的方式生成…","html":"

Feed 聚合框架Link to this heading#

\n

Django 提供了一个高级的 feed 聚合生成框架来创建 RSS 和 Atom feed。

\n

要创建任何聚合 feed，你只需要写一个简短的 Python 类。你可以创建任何你想要的 feed。

\n

Django 还提供了一个低级别的 feed 生成 API。如果你想在网络内容之外或以其他较低级别的方式生成 feed，可以使用这个 API。

\n
\n

高级框架Link to this heading#

\n
\n

概况Link to this heading#

\n

高级 feed 生成框架由 Feed 类提供。要创建一个 feed，需要写一个 Feed 类，并在你的 URLconf 中指向它的一个实例。

\n
\n
\n

Feed 类Link to this heading#

\n

Feed 类是一个 Python 类，它表示一个聚合 feed。Feed 可以是简单的（例如，一个“站点新闻”feed，或者一个显示博客最新条目的基本 feed），也可以是更复杂的（例如，一个显示特定类别中所有博客条目的 feed，其中类别是可变的）。

\n

Feed 类子类 django.contrib.syndication.views.Feed。它们可以存在于你代码库的任何地方。

\n

Feed 类的实例是可以在你的 URLconf 中使用的视图。

\n
\n
\n

一个简单的例子Link to this heading#

\n

这个简单的例子，取自于一个假设的警拍新闻网站，描述了一个最新的五个新闻项目的 feed：

\n
Code
from django.contrib.syndication.views import Feed\nfrom django.urls import reverse\nfrom policebeat.models import NewsItem\n\nclass LatestEntriesFeed(Feed):\n    title = "Police beat site news"\n    link = "/sitenews/"\n    description = "Updates on changes and additions to police beat central."\n\n    def items(self):\n        return NewsItem.objects.order_by('-pub_date')[:5]\n\n    def item_title(self, item):\n        return item.title\n\n    def item_description(self, item):\n        return item.description\n\n    # item_link is only needed if NewsItem has no get_absolute_url method.\n    def item_link(self, item):\n        return reverse('news-item', args=[item.pk])\n
\n

要连接到这个 feed 的 URL，在你的 URLconf 中放入一个 Feed 对象的实例。例如：

\n
Code
from django.urls import path\nfrom myproject.feeds import LatestEntriesFeed\n\nurlpatterns = [\n    # ...\n    path('latest/feed/', LatestEntriesFeed()),\n    # ...\n]\n
\n

注意：

\n\n

还剩下一件事要做。在一个 RSS Feed 中，每个 <item> 都有一个 <title>、<link> 和 <description>。我们需要告诉框架在这些元素中放入哪些数据。

\n\n
\n
\n

一个复杂的例子Link to this heading#

\n

该框架还支持更复杂的 feed，通过参数。

\n

例如，一个网站可以为一个城市的每一个警察局提供最近发生的犯罪行为的 RSS feed。如果为每个警察巡逻创建一个单独的 Feed 类，那就太傻了；那会违反 DRY 原则，并且会把数据和编程逻辑联系起来。相反，聚合框架让你访问从你的 URLconf 传递的参数，这样 feed 就可以根据 URL 中的信息输出项目。

\n

可以通过这样的网址访问警察局 feed：

\n\n

这些可以用 URLconf 行来匹配，如：

\n
Code
path('beats/<int:beat_id>/rss/', BeatFeed()),\n
\n

像视图一样，URL 中的参数和请求对象一起传递给 get_object() 方法。

\n

以下是这些特定警察局 feed 的代码：

\n
Code
from django.contrib.syndication.views import Feed\n\nclass BeatFeed(Feed):\n    description_template = 'feeds/beat_description.html'\n\n    def get_object(self, request, beat_id):\n        return Beat.objects.get(pk=beat_id)\n\n    def title(self, obj):\n        return "Police beat central: Crimes for beat %s" % obj.beat\n\n    def link(self, obj):\n        return obj.get_absolute_url()\n\n    def description(self, obj):\n        return "Crimes recently reported in police beat %s" % obj.beat\n\n    def items(self, obj):\n        return Crime.objects.filter(beat=obj).order_by('-crime_date')[:30]\n
\n

为了生成 feed 的 <title>、<link> 和 <description>，Django 使用了 title()、link() 和 description() 方法。在前面的例子中，它们是字符串类属性，但这个例子说明它们可以是字符串 或 方法。对于每一个 title、link 和``description``，Django 都遵循这个算法。

\n\n

还请注意，items() 也遵循同样的算法——首先，它尝试 items(obj)，然后是 items()，最后是 items 类属性（应该是一个列表）。

\n

我们是用一个模板来描述项目。可以是这样的最小化：

\n
Django template
{{ obj.description }}\n
\n

但是，你可以根据需要自由添加格式。

\n

下面的 ExampleFeed 类给出了关于 Feed 类的方法和属性的完整文档。

\n
\n
\n

指定 feed 的类型Link to this heading#

\n

默认情况下，这个框架中产生的 feed 使用 RSS 2.0。

\n

要改变这一点，可以在你的 Feed 类中添加一个 feed_type 属性，像这样：

\n
Code
from django.utils.feedgenerator import Atom1Feed\n\nclass MyFeed(Feed):\n    feed_type = Atom1Feed\n
\n

请注意，你把 feed_type 设置为一个类对象，而不是一个实例。

\n

目前可用的 feed 类型有：

\n\n
\n
\n

封面Link to this heading#

\n

要指定封面，如创建播客 feed 时使用的封面，使用 item_enclosures 钩子，或者，如果每个项目只有一个封面，则使用 item_enclosure_url、item_enclosure_length 和 item_enclosure_mime_type` 钩子。请看下面的 ExampleFeed 类的使用示例。

\n
\n
\n

语言Link to this heading#

\n

由聚合框架创建的 Feed 会自动包含相应的 <language> 标签（RSS 2.0）或 xml:lang 属性（Atom）。默认情况下，这是 django.utils.translation.get_language()。你可以通过设置 language 类属性来改变它。

\n
\n
\n

URLLink to this heading#

\n

link 方法／属性可以返回一个绝对路径（例如 "/blog/"），也可以返回一个带有完全限定的域名和协议的 URL（例如 "https://www.example.com/blog/"）。如果 link 没有返回域名，聚合框架会根据你的 SITE_ID  配置，插入当前网站的域名。

\n

Atom feeds 需要一个 <link rel="self">，定义 feed 的当前位置。聚合框架会根据 SITE_ID 设置，使用当前网站的域名自动填充。

\n
\n
\n

同时发布 Atom 和 RSS feedLink to this heading#

\n

有些开发者喜欢同时提供 Atom 和 RSS 版本的 feed。要做到这一点，你可以创建一个 Feed 类的子类，并将 feed_type 设置为不同的内容。然后更新你的 URLconf 来添加额外的版本。

\n

这有一个完整的例子：

\n
Code
from django.contrib.syndication.views import Feed\nfrom policebeat.models import NewsItem\nfrom django.utils.feedgenerator import Atom1Feed\n\nclass RssSiteNewsFeed(Feed):\n    title = "Police beat site news"\n    link = "/sitenews/"\n    description = "Updates on changes and additions to police beat central."\n\n    def items(self):\n        return NewsItem.objects.order_by('-pub_date')[:5]\n\nclass AtomSiteNewsFeed(RssSiteNewsFeed):\n    feed_type = Atom1Feed\n    subtitle = RssSiteNewsFeed.description\n
\n\n

并附带 URLconf：

\n
Code
from django.urls import path\nfrom myproject.feeds import AtomSiteNewsFeed, RssSiteNewsFeed\n\nurlpatterns = [\n    # ...\n    path('sitenews/rss/', RssSiteNewsFeed()),\n    path('sitenews/atom/', AtomSiteNewsFeed()),\n    # ...\n]\n
\n
\n
\n

Feed 类参考Link to this heading#

\n
\n
\nclass views.FeedLink to this definition#
\n
\n\n

这个例子说明了 Feed 类的所有可能的属性和方法：

\n
Code
from django.contrib.syndication.views import Feed\nfrom django.utils import feedgenerator\n\nclass ExampleFeed(Feed):\n\n    # FEED TYPE -- Optional. This should be a class that subclasses\n    # django.utils.feedgenerator.SyndicationFeed. This designates\n    # which type of feed this should be: RSS 2.0, Atom 1.0, etc. If\n    # you don't specify feed_type, your feed will be RSS 2.0. This\n    # should be a class, not an instance of the class.\n\n    feed_type = feedgenerator.Rss201rev2Feed\n\n    # TEMPLATE NAMES -- Optional. These should be strings\n    # representing names of Django templates that the system should\n    # use in rendering the title and description of your feed items.\n    # Both are optional. If a template is not specified, the\n    # item_title() or item_description() methods are used instead.\n\n    title_template = None\n    description_template = None\n\n    # LANGUAGE -- Optional. This should be a string specifying a language\n    # code. Defaults to django.utils.translation.get_language().\n    language = 'de'\n\n    # TITLE -- One of the following three is required. The framework\n    # looks for them in this order.\n\n    def title(self, obj):\n        """\n        Takes the object returned by get_object() and returns the\n        feed's title as a normal Python string.\n        """\n\n    def title(self):\n        """\n        Returns the feed's title as a normal Python string.\n        """\n\n    title = 'foo' # Hard-coded title.\n\n    # LINK -- One of the following three is required. The framework\n    # looks for them in this order.\n\n    def link(self, obj):\n        """\n        # Takes the object returned by get_object() and returns the URL\n        # of the HTML version of the feed as a normal Python string.\n        """\n\n    def link(self):\n        """\n        Returns the URL of the HTML version of the feed as a normal Python\n        string.\n        """\n\n    link = '/blog/' # Hard-coded URL.\n\n    # FEED_URL -- One of the following three is optional. The framework\n    # looks for them in this order.\n\n    def feed_url(self, obj):\n        """\n        # Takes the object returned by get_object() and returns the feed's\n        # own URL as a normal Python string.\n        """\n\n    def feed_url(self):\n        """\n        Returns the feed's own URL as a normal Python string.\n        """\n\n    feed_url = '/blog/rss/' # Hard-coded URL.\n\n    # GUID -- One of the following three is optional. The framework looks\n    # for them in this order. This property is only used for Atom feeds\n    # (where it is the feed-level ID element). If not provided, the feed\n    # link is used as the ID.\n\n    def feed_guid(self, obj):\n        """\n        Takes the object returned by get_object() and returns the globally\n        unique ID for the feed as a normal Python string.\n        """\n\n    def feed_guid(self):\n        """\n        Returns the feed's globally unique ID as a normal Python string.\n        """\n\n    feed_guid = '/foo/bar/1234' # Hard-coded guid.\n\n    # DESCRIPTION -- One of the following three is required. The framework\n    # looks for them in this order.\n\n    def description(self, obj):\n        """\n        Takes the object returned by get_object() and returns the feed's\n        description as a normal Python string.\n        """\n\n    def description(self):\n        """\n        Returns the feed's description as a normal Python string.\n        """\n\n    description = 'Foo bar baz.' # Hard-coded description.\n\n    # AUTHOR NAME --One of the following three is optional. The framework\n    # looks for them in this order.\n\n    def author_name(self, obj):\n        """\n        Takes the object returned by get_object() and returns the feed's\n        author's name as a normal Python string.\n        """\n\n    def author_name(self):\n        """\n        Returns the feed's author's name as a normal Python string.\n        """\n\n    author_name = 'Sally Smith' # Hard-coded author name.\n\n    # AUTHOR EMAIL --One of the following three is optional. The framework\n    # looks for them in this order.\n\n    def author_email(self, obj):\n        """\n        Takes the object returned by get_object() and returns the feed's\n        author's email as a normal Python string.\n        """\n\n    def author_email(self):\n        """\n        Returns the feed's author's email as a normal Python string.\n        """\n\n    author_email = 'test@example.com' # Hard-coded author email.\n\n    # AUTHOR LINK --One of the following three is optional. The framework\n    # looks for them in this order. In each case, the URL should include\n    # the "http://" and domain name.\n\n    def author_link(self, obj):\n        """\n        Takes the object returned by get_object() and returns the feed's\n        author's URL as a normal Python string.\n        """\n\n    def author_link(self):\n        """\n        Returns the feed's author's URL as a normal Python string.\n        """\n\n    author_link = 'https://www.example.com/' # Hard-coded author URL.\n\n    # CATEGORIES -- One of the following three is optional. The framework\n    # looks for them in this order. In each case, the method/attribute\n    # should return an iterable object that returns strings.\n\n    def categories(self, obj):\n        """\n        Takes the object returned by get_object() and returns the feed's\n        categories as iterable over strings.\n        """\n\n    def categories(self):\n        """\n        Returns the feed's categories as iterable over strings.\n        """\n\n    categories = ("python", "django") # Hard-coded list of categories.\n\n    # COPYRIGHT NOTICE -- One of the following three is optional. The\n    # framework looks for them in this order.\n\n    def feed_copyright(self, obj):\n        """\n        Takes the object returned by get_object() and returns the feed's\n        copyright notice as a normal Python string.\n        """\n\n    def feed_copyright(self):\n        """\n        Returns the feed's copyright notice as a normal Python string.\n        """\n\n    feed_copyright = 'Copyright (c) 2007, Sally Smith' # Hard-coded copyright notice.\n\n    # TTL -- One of the following three is optional. The framework looks\n    # for them in this order. Ignored for Atom feeds.\n\n    def ttl(self, obj):\n        """\n        Takes the object returned by get_object() and returns the feed's\n        TTL (Time To Live) as a normal Python string.\n        """\n\n    def ttl(self):\n        """\n        Returns the feed's TTL as a normal Python string.\n        """\n\n    ttl = 600 # Hard-coded Time To Live.\n\n    # ITEMS -- One of the following three is required. The framework looks\n    # for them in this order.\n\n    def items(self, obj):\n        """\n        Takes the object returned by get_object() and returns a list of\n        items to publish in this feed.\n        """\n\n    def items(self):\n        """\n        Returns a list of items to publish in this feed.\n        """\n\n    items = ('Item 1', 'Item 2') # Hard-coded items.\n\n    # GET_OBJECT -- This is required for feeds that publish different data\n    # for different URL parameters. (See "A complex example" above.)\n\n    def get_object(self, request, *args, **kwargs):\n        """\n        Takes the current request and the arguments from the URL, and\n        returns an object represented by this feed. Raises\n        django.core.exceptions.ObjectDoesNotExist on error.\n        """\n\n    # ITEM TITLE AND DESCRIPTION -- If title_template or\n    # description_template are not defined, these are used instead. Both are\n    # optional, by default they will use the string representation of the\n    # item.\n\n    def item_title(self, item):\n        """\n        Takes an item, as returned by items(), and returns the item's\n        title as a normal Python string.\n        """\n\n    def item_title(self):\n        """\n        Returns the title for every item in the feed.\n        """\n\n    item_title = 'Breaking News: Nothing Happening' # Hard-coded title.\n\n    def item_description(self, item):\n        """\n        Takes an item, as returned by items(), and returns the item's\n        description as a normal Python string.\n        """\n\n    def item_description(self):\n        """\n        Returns the description for every item in the feed.\n        """\n\n    item_description = 'A description of the item.' # Hard-coded description.\n\n    def get_context_data(self, **kwargs):\n        """\n        Returns a dictionary to use as extra context if either\n        description_template or item_template are used.\n\n        Default implementation preserves the old behavior\n        of using {'obj': item, 'site': current_site} as the context.\n        """\n\n    # ITEM LINK -- One of these three is required. The framework looks for\n    # them in this order.\n\n    # First, the framework tries the two methods below, in\n    # order. Failing that, it falls back to the get_absolute_url()\n    # method on each item returned by items().\n\n    def item_link(self, item):\n        """\n        Takes an item, as returned by items(), and returns the item's URL.\n        """\n\n    def item_link(self):\n        """\n        Returns the URL for every item in the feed.\n        """\n\n    # ITEM_GUID -- The following method is optional. If not provided, the\n    # item's link is used by default.\n\n    def item_guid(self, obj):\n        """\n        Takes an item, as return by items(), and returns the item's ID.\n        """\n\n    # ITEM_GUID_IS_PERMALINK -- The following method is optional. If\n    # provided, it sets the 'isPermaLink' attribute of an item's\n    # GUID element. This method is used only when 'item_guid' is\n    # specified.\n\n    def item_guid_is_permalink(self, obj):\n        """\n        Takes an item, as returned by items(), and returns a boolean.\n        """\n\n    item_guid_is_permalink = False  # Hard coded value\n\n    # ITEM AUTHOR NAME -- One of the following three is optional. The\n    # framework looks for them in this order.\n\n    def item_author_name(self, item):\n        """\n        Takes an item, as returned by items(), and returns the item's\n        author's name as a normal Python string.\n        """\n\n    def item_author_name(self):\n        """\n        Returns the author name for every item in the feed.\n        """\n\n    item_author_name = 'Sally Smith' # Hard-coded author name.\n\n    # ITEM AUTHOR EMAIL --One of the following three is optional. The\n    # framework looks for them in this order.\n    #\n    # If you specify this, you must specify item_author_name.\n\n    def item_author_email(self, obj):\n        """\n        Takes an item, as returned by items(), and returns the item's\n        author's email as a normal Python string.\n        """\n\n    def item_author_email(self):\n        """\n        Returns the author email for every item in the feed.\n        """\n\n    item_author_email = 'test@example.com' # Hard-coded author email.\n\n    # ITEM AUTHOR LINK -- One of the following three is optional. The\n    # framework looks for them in this order. In each case, the URL should\n    # include the "http://" and domain name.\n    #\n    # If you specify this, you must specify item_author_name.\n\n    def item_author_link(self, obj):\n        """\n        Takes an item, as returned by items(), and returns the item's\n        author's URL as a normal Python string.\n        """\n\n    def item_author_link(self):\n        """\n        Returns the author URL for every item in the feed.\n        """\n\n    item_author_link = 'https://www.example.com/' # Hard-coded author URL.\n\n    # ITEM ENCLOSURES -- One of the following three is optional. The\n    # framework looks for them in this order. If one of them is defined,\n    # ``item_enclosure_url``, ``item_enclosure_length``, and\n    # ``item_enclosure_mime_type`` will have no effect.\n\n    def item_enclosures(self, item):\n        """\n        Takes an item, as returned by items(), and returns a list of\n        ``django.utils.feedgenerator.Enclosure`` objects.\n        """\n\n    def item_enclosures(self):\n        """\n        Returns the ``django.utils.feedgenerator.Enclosure`` list for every\n        item in the feed.\n        """\n\n    item_enclosures = []  # Hard-coded enclosure list\n\n    # ITEM ENCLOSURE URL -- One of these three is required if you're\n    # publishing enclosures and you're not using ``item_enclosures``. The\n    # framework looks for them in this order.\n\n    def item_enclosure_url(self, item):\n        """\n        Takes an item, as returned by items(), and returns the item's\n        enclosure URL.\n        """\n\n    def item_enclosure_url(self):\n        """\n        Returns the enclosure URL for every item in the feed.\n        """\n\n    item_enclosure_url = "/foo/bar.mp3" # Hard-coded enclosure link.\n\n    # ITEM ENCLOSURE LENGTH -- One of these three is required if you're\n    # publishing enclosures and you're not using ``item_enclosures``. The\n    # framework looks for them in this order. In each case, the returned\n    # value should be either an integer, or a string representation of the\n    # integer, in bytes.\n\n    def item_enclosure_length(self, item):\n        """\n        Takes an item, as returned by items(), and returns the item's\n        enclosure length.\n        """\n\n    def item_enclosure_length(self):\n        """\n        Returns the enclosure length for every item in the feed.\n        """\n\n    item_enclosure_length = 32000 # Hard-coded enclosure length.\n\n    # ITEM ENCLOSURE MIME TYPE -- One of these three is required if you're\n    # publishing enclosures and you're not using ``item_enclosures``. The\n    # framework looks for them in this order.\n\n    def item_enclosure_mime_type(self, item):\n        """\n        Takes an item, as returned by items(), and returns the item's\n        enclosure MIME type.\n        """\n\n    def item_enclosure_mime_type(self):\n        """\n        Returns the enclosure MIME type for every item in the feed.\n        """\n\n    item_enclosure_mime_type = "audio/mpeg" # Hard-coded enclosure MIME type.\n\n    # ITEM PUBDATE -- It's optional to use one of these three. This is a\n    # hook that specifies how to get the pubdate for a given item.\n    # In each case, the method/attribute should return a Python\n    # datetime.datetime object.\n\n    def item_pubdate(self, item):\n        """\n        Takes an item, as returned by items(), and returns the item's\n        pubdate.\n        """\n\n    def item_pubdate(self):\n        """\n        Returns the pubdate for every item in the feed.\n        """\n\n    item_pubdate = datetime.datetime(2005, 5, 3) # Hard-coded pubdate.\n\n    # ITEM UPDATED -- It's optional to use one of these three. This is a\n    # hook that specifies how to get the updateddate for a given item.\n    # In each case, the method/attribute should return a Python\n    # datetime.datetime object.\n\n    def item_updateddate(self, item):\n        """\n        Takes an item, as returned by items(), and returns the item's\n        updateddate.\n        """\n\n    def item_updateddate(self):\n        """\n        Returns the updateddate for every item in the feed.\n        """\n\n    item_updateddate = datetime.datetime(2005, 5, 3) # Hard-coded updateddate.\n\n    # ITEM CATEGORIES -- It's optional to use one of these three. This is\n    # a hook that specifies how to get the list of categories for a given\n    # item. In each case, the method/attribute should return an iterable\n    # object that returns strings.\n\n    def item_categories(self, item):\n        """\n        Takes an item, as returned by items(), and returns the item's\n        categories.\n        """\n\n    def item_categories(self):\n        """\n        Returns the categories for every item in the feed.\n        """\n\n    item_categories = ("python", "django") # Hard-coded categories.\n\n    # ITEM COPYRIGHT NOTICE (only applicable to Atom feeds) -- One of the\n    # following three is optional. The framework looks for them in this\n    # order.\n\n    def item_copyright(self, obj):\n        """\n        Takes an item, as returned by items(), and returns the item's\n        copyright notice as a normal Python string.\n        """\n\n    def item_copyright(self):\n        """\n        Returns the copyright notice for every item in the feed.\n        """\n\n    item_copyright = 'Copyright (c) 2007, Sally Smith' # Hard-coded copyright notice.\n\n    # ITEM COMMENTS URL -- It's optional to use one of these three. This is\n    # a hook that specifies how to get the URL of a page for comments for a\n    # given item.\n\n    def item_comments(self, obj):\n        """\n        Takes an item, as returned by items(), and returns the item's\n        comments URL as a normal Python string.\n        """\n\n    def item_comments(self):\n        """\n        Returns the comments URL for every item in the feed.\n        """\n\n    item_comments = 'https://www.example.com/comments' # Hard-coded comments URL\n
\n\n
\n
\n
\n

低级框架Link to this heading#

\n

在幕后，高级 RSS 框架使用一个低级框架来生成 feed 的 XML。这个框架存在于一个模块中：django/utils/feedgenerator.py。

\n

你可以自己使用这个框架，进行低级的 feed 生成。你也可以创建自定义的 feed 生成器子类，用于 feed_type Feed 选项。

\n
\n

SyndicationFeed 类Link to this heading#

\n

feedgenerator 模块包含一个基类：

\n\n

和几个子类：

\n\n

这三个类中的每一个都知道如何将某种类型的 feed 渲染成 XML。它们共享这个接口：

\n
\n
SyndicationFeed.__init__()

用给定的元数据字典初始化 feed，该字典适用于整个 feed。所需的关键字参数有：

\n
    \n

  • title

    • \n

  • link

    • \n

  • description

    • \n
\n

还有一堆其他可选的关键词：

\n
    \n

  • language

    • \n

  • author_email

    • \n

  • author_name

    • \n

  • author_link

    • \n

  • subtitle

    • \n

  • categories

    • \n

  • feed_url

    • \n

  • feed_copyright

    • \n

  • feed_guid

    • \n

  • ttl

    • \n
\n

你传递给 __init__ 的任何额外的关键字参数将被存储在 self.feed 中，供 自定义 feed 生成器 使用。

\n

所有参数都应该是字符串，但 categories 除外，它应该是一个字符串序列。请注意，在 XML 文档中，有些控制字符是 不允许的 。如果你的内容中有一些，你可能会在生成 feed 时遇到一个 ValueError。

\n
\n
SyndicationFeed.add_item()

用给定的参数将一个项目添加到 feed 中。

\n

必须的关键字参数是：

\n
    \n

  • title

    • \n

  • link

    • \n

  • description

    • \n
\n

可选的关键字参数是：

\n
    \n

  • author_email

    • \n

  • author_name

    • \n

  • author_link

    • \n

  • pubdate

    • \n

  • comments

    • \n

  • unique_id

    • \n

  • enclosures

    • \n

  • categories

    • \n

  • item_copyright

    • \n

  • ttl

    • \n

  • updateddate

    • \n
\n

额外的关键字参数将被存储在 自定义 feed 生成器 。

\n

所有参数，如果给定，都应该是字符串，除了：

\n
    \n

  • pubdate 应该是一个 Python datetime 对象。

    • \n

  • updateddate 应该是一个 Python datetime 对象。

    • \n

  • enclosures 应该是一个 django.utils.feedgenerator.Eclosure 实例的列表。

    • \n

  • categories 应是一个字符串序列。

    • \n
\n
\n
SyndicationFeed.write()

将给定编码的 feed 输出到 outfile，一个类似文件的对象。

\n
\n
SyndicationFeed.writeString()

以给定编码的字符串形式返回 feed。

\n
\n
\n

例如，要创建一个 Atom 1.0 feed 并将其打印成标准输出：

\n
Code
>>> from django.utils import feedgenerator\n>>> from datetime import datetime\n>>> f = feedgenerator.Atom1Feed(\n...     title="My Blog",\n...     link="https://www.example.com/",\n...     description="In which I write about what I ate today.",\n...     language="en",\n...     author_name="Myself",\n...     feed_url="https://example.com/atom.xml")\n>>> f.add_item(title="Hot dog today",\n...     link="https://www.example.com/entries/1/",\n...     pubdate=datetime.now(),\n...     description="<p>Today I had a Vienna Beef hot dog. It was pink, plump and perfect.</p>")\n>>> print(f.writeString('UTF-8'))\n<?xml version="1.0" encoding="UTF-8"?>\n<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">\n...\n</feed>\n
\n
\n
\n

自定义 feed 生成器Link to this heading#

\n

如果你需要制作一个自定义的 feed 格式，你有几个选择。

\n

如果 feed 格式是完全自定义的，你会想要子类化 SyndicationFeed 并完全替换 write() 和 writeString() 方法。

\n

然而，如果 feed 格式是 RSS 或 Atom 的衍生产品（即 GeoRSS ，苹果的 iTunes podcast format 等），你就有了更好的选择。这些类型的 feeds 通常会向底层格式添加额外的元素和／或属性，而且 SyndicationFeed 调用一组方法来获取这些额外的属性。因此，你可以子类化适当的 feed 生成器类（Atom1Feed 或 Rss201rev2Feed）并扩展这些回调。它们是：

\n
\n
SyndicationFeed.root_attributes(self)

返回一个属性的 dict 以添加到根 feed 元素（feed／channel）。

\n
\n
SyndicationFeed.add_root_elements(self, handler)

回调以在根 feed 元素（feed／channel）中添加元素。handler 是一个 XMLGenerator，来自 Python 内置的 SAX 库;你将调用它上的方法来添加到正在处理的 XML 文档中。

\n
\n
SyndicationFeed.item_attributes(self, item)

返回要添加到每个项目（item／entry）元素的 dict 属性。参数 item 是传递给 SyndicationFeed.add_item() 的所有数据的字典。

\n
\n
SyndicationFeed.add_item_elements(self, handler, item)

回调为每个项目（item／entry）元素添加元素。handler 和 item 同上。

\n
\n
\n\n

例如，你可以这样开始实现一个 iTunes RSS feed 生成器：

\n
Code
class iTunesFeed(Rss201rev2Feed):\n    def root_attributes(self):\n        attrs = super().root_attributes()\n        attrs['xmlns:itunes'] = 'http://www.itunes.com/dtds/podcast-1.0.dtd'\n        return attrs\n\n    def add_root_elements(self, handler):\n        super().add_root_elements(handler)\n        handler.addQuickElement('itunes:explicit', 'clean')\n
\n

对于一个完整的自定义 feed 类来说，还有很多工作要做，但上面的例子应该展示了基本的想法。

\n
\n
","rootId":"module-django.contrib.syndication","toc":[{"title":"高级框架","anchor":"the-high-level-framework","children":[{"title":"概况","anchor":"overview","children":[]},{"title":"Feed 类","anchor":"feed-classes","children":[]},{"title":"一个简单的例子","anchor":"a-simple-example","children":[]},{"title":"一个复杂的例子","anchor":"a-complex-example","children":[]},{"title":"指定 feed 的类型","anchor":"specifying-the-type-of-feed","children":[]},{"title":"封面","anchor":"enclosures","children":[]},{"title":"语言","anchor":"language","children":[]},{"title":"URL","anchor":"urls","children":[]},{"title":"同时发布 Atom 和 RSS feed","anchor":"publishing-atom-and-rss-feeds-in-tandem","children":[]},{"title":"Feed 类参考","anchor":"feed-class-reference","children":[]}]},{"title":"低级框架","anchor":"the-low-level-framework","children":[{"title":"SyndicationFeed 类","anchor":"syndicationfeed-classes","children":[]},{"title":"自定义 feed 生成器","anchor":"custom-feed-generators","children":[]}]}],"breadcrumbs":[{"docname":"ref/index","title":"API 参考","url":"/zh-hans/4.0/ref/"},{"docname":"ref/contrib/index","title":"contrib 包","url":"/zh-hans/4.0/ref/contrib/"}],"prev":{"docname":"ref/contrib/staticfiles","title":"staticfiles 应用","url":"/zh-hans/4.0/ref/contrib/staticfiles/"},"next":{"docname":"ref/csrf","title":"跨站请求伪造保护","url":"/zh-hans/4.0/ref/csrf/"},"formats":{"html":"/zh-hans/4.0/ref/contrib/syndication/","markdown":"/zh-hans/4.0/ref/contrib/syndication.md","json":"/zh-hans/4.0/ref/contrib/syndication.json"},"source":"https://github.com/django/django/blob/stable/4.0.x/docs/ref/contrib/syndication.txt","official":"https://docs.djangoproject.com/zh-hans/4.0/ref/contrib/syndication/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}