Django には、RSS と Atom フィードを作成するための高レベルな配信 (syndication) フィード生成フレームワークが付属しています。
\n任意の配信フィードを作成するには、短い Python クラスを書くだけで済みます。好きなだけフィードを作成できます。
\nDjangoには、低レベルのフィード生成APIも付属しています。ウェブコンテキストの外や、他の低レベルな方法でフィードを生成したい場合に使用してください。
\n高レベルのフィード生成フレームワークは Feed クラスによって提供されます。フィードを作成するには、 Feed クラスを記述し、 URLconf でそのインスタンスを指定します。
Feed クラスLink to this heading#Feed クラスは配信フィードを表す Python クラスです。フィードは単純なもの (例えば、"サイトニュース" フィードや、ブログの最新エントリを表示する基本的なフィード) もあれば、より複雑なもの (例えば、特定のカテゴリに属する全てのブログエントリを表示するフィード (カテゴリは可変)) もあります。
フィードクラスは django.contrib.syndication.views.Feed のサブクラスです。これらはコードベースのどこにでも置くことができます。
この単純な例は、ある警察のニュースサイトから引用したもので、最新の5つのニュースのフィードを記述しています:
\nfrom django.contrib.syndication.views import Feed\nfrom django.urls import reverse\nfrom policebeat.models import NewsItem\n\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このフィードにURLを接続するには、 URLconf にFeedオブジェクトのインスタンスを配置します。例えば:
\nfrom django.urls import path\nfrom myproject.feeds import LatestEntriesFeed\n\nurlpatterns = [\n # ...\n path("latest/feed/", LatestEntriesFeed()),\n # ...\n]\n備考:
\nFeedクラスは django.contrib.syndication.views.Feed のサブクラスです。
title、link、および description は、それぞれ標準RSSの <title>, <link>, <description> 要素に対応します。
items() は、フィードに含めるべきオブジェクトのリストを返すメソッドです。この例では、Djangoの ORM を使用して NewsItem オブジェクトを返しますが、 items() は必ずモデルインスタンスを返す必要はありません。Django モデルを使用することで、いくつかの機能が「タダ」で提供されますが、 items() は任意の種類のオブジェクトを返すことができます。
Atom フィードを作成する場合、RSS フィードではなく、description 属性の代わりに subtitle 属性を設定してください。例については、後述の Publishing Atom and RSS feeds in tandem を参照してください。
まだやるべきことが一つあります。RSSフィードでは、各 <item> には <title>, <link>, そして <description> が含まれています。これらの要素にどんなデータを入れるべきか、フレームワークに伝える必要があります。
<title> と <description> の内容について、Djangoは Feed クラスでメソッド item_title() と item_description() を呼び出そうとします。これらには、オブジェクト自体を表す単一のパラメータ item が渡されます。これらはオプションであり、デフォルトではオブジェクトの文字列表現が両方に使用されます。
タイトルや説明文に特別な書式を設定したい場合は、 Django テンプレート を代わりに使用できます。そのパスは Feed クラスの title_template と description_template 属性で指定できます。テンプレートはアイテムごとにレンダリングされ、2つのテンプレートコンテキスト変数に渡されます:
{{ obj }} -- 現在のオブジェクト (items() で返したオブジェクトのいずれか)。
{{ site }} ―― 現在のサイトを表す django.contrib.sites.models.Site オブジェクト。これは {{ site.domain }} や {{ site.name }} に便利です。Django サイトフレームワークがインストールされていない場合は、これは RequestSite オブジェクトに設定されます。詳細は、サイトフレームワークのドキュメントの RequestSite のセクション を参照してください。
記述テンプレートを使用した以下の a complex example を参照してください。
\n必要な変数が2つ以上ある場合、タイトルと説明テンプレートに追加情報を渡す方法もあります。その場合は、Feed サブクラス内で get_context_data メソッドの実装を提供できます。例えば:
from mysite.models import Article\nfrom django.contrib.syndication.views import Feed\n\n\nclass ArticlesFeed(Feed):\n title = "My articles"\n description_template = "feeds/articles.html"\n\n def items(self):\n return Article.objects.order_by("-pub_date")[:5]\n\n def get_context_data(self, **kwargs):\n context = super().get_context_data(**kwargs)\n context["foo"] = "bar"\n return context\nテンプレートは以下の通りです:
\nSomething about {{ foo }}: {{ obj.description }}\nこのメソッドは、items() で返されたリストの各アイテムごとに、次のキーワード引数とともに一度ずつ呼び出されます:
item: 現在のアイテム。後方互換性のため、このコンテキスト変数の名前は {{ obj }} です。
obj: get_object() で返されるオブジェクト。デフォルトでは、テンプレートでの混乱を避けるため {{ obj }} (前述) で公開されませんが、 get_context_data() の実装で使用できます。
site: 上記で説明した現在のサイト。
request: 現在のリクエスト。
get_context_data() の動作は ジェネリックビュー と同様です。親クラスからコンテキストデータを取得するために super() を呼び出し、自分のデータを追加して、修正された辞書を返すことになっています。
<link> の内容を指定するには、2つの選択肢があります。items() の各項目に対して、Djangoはまず Feed クラス上の item_link() メソッドを呼び出すことを試みます。タイトルや説明と同様に、これには単一のパラメータ item が渡されます。そのメソッドが存在しない場合、Djangoはそのオブジェクト上で get_absolute_url() メソッドを実行しようとします。get_absolute_url() および item_link() は、いずれも項目のURLを通常のPython文字列として返すべきです。get_absolute_url() と同様に、item_link() の結果はURLに直接含まれるため、メソッド内で必要なURLクォーティングおよびASCIIへの変換をすべて自身で行う責任があります。
このフレームワークは、引数を通じて、より複雑なフィードもサポートしています。
\nたとえば、あるウェブサイトが、都市内の各警察管轄地域の最近の犯罪についてのRSSフィードを提供しているとします。各警察の管轄地域ごとに Feed クラスを別々に作成するのは愚かなことです。それは DRY原則 に反し、データをプログラミングロジックに結びつけてしまいます。代わりに、配信 (syndication) フレームワークを使用すると、URLconf から渡された引数にアクセスできます。そのため、フィードのURL内の情報に基づいてアイテムを出力できます。
警察の管轄地域のフィードは次のようなURLを介してアクセスできます:
\n/beats/613/rss/ ―― 613番担当地域の最近の犯罪情報を返します。
"/beats/1424/rss/" ―― 1424番担当地域の最近の犯罪を返します。
これらは、次のような URLconf 行とマッチするでしょう:
\npath("beats/<int:beat_id>/rss/", BeatFeed()),\nビューと同様に、URLの引数はリクエストオブジェクトと共に get_object() メソッドに渡されます。
これらの管轄地域に特化したフィードのコードは以下の通りです:
\nfrom django.contrib.syndication.views import Feed\n\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フィードの <title>, <link>, <description> を生成するために、 Django は title(), link(), description() メソッドを使います。前の例では、これらは文字列のクラス属性でしたが、この例では、文字列 または メソッドを指定できます。 title、link、description のそれぞれについて、 Django は以下のアルゴリズムに従います
まず、 obj を引数にして、メソッドを呼び出そうとします。ここで、 obj は get_object() によって返されたオブジェクトです
それが失敗した場合、引数なしでメソッドを呼び出そうとします。
それができない場合は、クラス属性を使用します。
また、items() も同じアルゴリズムに従います。最初に items(obj) を試し、次に items()、最後に items クラス属性（リストであるべきです）を試します。
アイテムの説明用にテンプレートを使用しています。これは最小限の例です:
\n{{ obj.description }}\nただし、フォーマットは必要に応じて追加できます。
\n以下の ExampleFeed クラスは、 Feed クラスのメソッドと属性に関する完全なドキュメントを提供します。
デフォルトでは、このフレームワークで作成されたフィードはRSS 2.0を使用します。
\nこれを変更するには、次のように Feed クラスに feed_type 属性を追加します:
from django.utils.feedgenerator import Atom1Feed\n\n\nclass MyFeed(Feed):\n feed_type = Atom1Feed\nfeed_type にはインスタンスではなく、クラスオブジェクトを設定することに注意してください。
現在利用可能なフィードタイプは以下の通りです:
\ndjango.utils.feedgenerator.Rss201rev2Feed (RSS 2.01。デフォルト。)
django.utils.feedgenerator.RssUserland091Feed (RSS 0.91.)
django.utils.feedgenerator.Atom1Feed (Atom 1.0.)
ポッドキャストフィードを作成する際に使用されるエンクロージャ (enclosure) を指定するには、item_enclosures フックを使用するか、またはアイテムごとに1つのエンクロージャのみを持つ場合は代わりに item_enclosure_url、item_enclosure_length、item_enclosure_mime_type フックを使用します。使用例については、以下の ExampleFeed クラスを参照してください。
配信フレームワークによって作成されたフィードは、自動的に適切な <language> タグ (RSS 2.0) または xml:lang 属性 (Atom) を含みます。デフォルトでは django.utils.translation.get_language() です。 language クラス属性を設定することで変更できます。
link メソッド/属性は絶対パス (例: "/blog/") または完全修飾ドメインとプロトコルを含むURL (例："https://www.example.com/blog/") を返すことができます。もし link がドメインを返さない場合、配信フレームワークは SITE_ID 設定 に従って、現在のサイトのドメインを挿入します。
Atom フィードには、フィードの現在の場所を定義する <link rel="self"> が必要です。配信フレームワークは、SITE_ID 設定に従って、現在のサイトのドメインを使用して、これを自動的に設定します。
フィードの Atom 版と RSS 版の 両方 を利用したい開発者もいるでしょう。そのためには、 Feed クラスのサブクラスを作成し、 feed_type を別のものに設定します。それから URLconf を更新して、追加バージョンを追加します。
すべての例を示します:
\nfrom django.contrib.syndication.views import Feed\nfrom policebeat.models import NewsItem\nfrom django.utils.feedgenerator import Atom1Feed\n\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\n\nclass AtomSiteNewsFeed(RssSiteNewsFeed):\n feed_type = Atom1Feed\n subtitle = RssSiteNewsFeed.description\nそして、それに伴うURLconfは次のとおりです:
\nfrom 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]\nFeed クラスのリファレンスLink to this heading#この例は、 Feed クラスの可能な全ての属性とメソッドを示しています:
from django.contrib.syndication.views import Feed\nfrom django.utils import feedgenerator\n\n\nclass ExampleFeed(Feed):\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 scheme (such as "https://") 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 # STYLESHEETS -- Optional. To set, provide one of the following three.\n # The framework looks for them in this order.\n\n def stylesheets(self, obj):\n """\n Takes the object returned by get_object() and returns the feed's\n stylesheets (as URL strings or as Stylesheet instances).\n """\n\n def stylesheets(self):\n """\n Returns the feed's stylesheets (as URL strings or Stylesheet\n instances).\n """\n\n # Hardcoded stylesheets.\n stylesheets = ["/stylesheet1.xsl", "stylesheet2.xsl"]\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 scheme (such as "https://") 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舞台裏では、高水準のRSSフレームワークがフィードのXMLを生成するために、より低水準のフレームワークを使用しています。このフレームワークは単一のモジュールに存在します: django/utils/feedgenerator.py 。
\nこのフレームワークを使用して、低レベルのフィードを生成します。独自のフィードジェネレータサブクラスを作成して feed_type Feed オプションで使用することもできます。
カスタムフィード形式を作成する必要がある場合、いくつかのオプションがあります。
\nフィードフォーマットが完全にカスタムである場合は、SyndicationFeed をサブクラス化し、write() メソッドと writeString() メソッドを完全に置き換える必要があります。
しかし、フィードフォーマットがRSSやAtom（例えば、 GeoRSS 、Appleの iTunes podcast format など）の派生形式である場合、より良い選択肢があります。これらのタイプのフィードは、通常、基本となるフォーマットに追加の要素や属性を追加し、 SyndicationFeed がこれらの追加属性を取得するために呼び出す一連のメソッドがあります。したがって、適切なフィードジェネレータクラス (Atom1Feed または Rss201rev2Feed) をサブクラス化し、これらのコールバックを拡張できます。それらは次のとおりです:
SyndicationFeed.root_attributes(self)ルートフィード要素 (feed/channel) に追加する属性の dict を返します。
SyndicationFeed.add_root_elements(self, handler)ルートフィード要素 (feed/channel) 内に要素を追加するためのコールバックです。handler はPythonの組み込みSAXライブラリからの XMLGenerator です。処理中のXMLドキュメントに追加するには、これに対してメソッドを呼び出します。
SyndicationFeed.item_attributes(self, item)各アイテム (item/entry) 要素に追加する属性の dict を返します。引数の item は、 SyndicationFeed.add_item() に渡されるすべてのデータの辞書です。
SyndicationFeed.add_item_elements(self, handler, item)各アイテム (item/entry) 要素に要素を追加するためのコールバックです。 handler と item は上記の通りです。
たとえば、iTunesのRSSフィードジェネレーターの実装を次のように始めることができます:
\nclass 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完全なカスタムフィードクラスを作成するには、まだ多くの作業が必要ですが、上記の例で基本的な考え方を示すことができるはずです。
\nRSS フィードをブラウザで見やすく表示させたい場合は、XML ファイルに対してスタイル情報を指定する必要があります。通常、XSLT や CSS 形式で指定します。
\nスタイル情報を RSS フィードに追加するには、フィードクラスの stylesheets 属性を設定します。
\nURLをハードコードした場合。
\nfrom django.contrib.syndication.views import Feed\n\n\nclass FeedWithHardcodedStylesheet(Feed):\n stylesheets = [\n "https://example.com/rss_stylesheet.xslt",\n ]\nDjango の静的ファイルシステムを使うこともできます。
\nfrom django.contrib.syndication.views import Feed\nfrom django.templatetags.static import static\n\n\nclass FeedWithStaticFileStylesheet(Feed):\n stylesheets = [\n static("rss_styles.xslt"),\n ]\n別の方法として、プロジェクト内に XSLT ドキュメントをレンダリングするビューを用意することもできます。その場合、以下のようにリンクを指定できます。
\nfrom django.contrib.syndication.views import Feed\nfrom django.urls import reverse_lazy\n\n\nclass FeedWithStylesheetView(Feed):\n stylesheets = [\n reverse_lazy("your-custom-view-name"),\n ]\n通常、与えられたURLの拡張子から MIME タイプが推測されますが、うまくいかない場合は Stylesheet クラスを使用して指定することもできます。
from django.contrib.syndication.views import Feed\nfrom django.utils.feedgenerator import Stylesheet\n\n\nclass FeedWithHardcodedStylesheet(Feed):\n stylesheets = [\n Stylesheet("https://example.com/rss_stylesheet", mimetype="text/xsl"),\n ]\n同様に、 screen (Djangoのデフォルト)ではなく media 属性を使用したい場合も、 Stylesheet クラスを使用することができます。
from django.contrib.syndication.views import Feed\nfrom django.utils.feedgenerator import Stylesheet\n\n\nclass FeedWithHardcodedStylesheet(Feed):\n stylesheets = [\n Stylesheet("https://example.com/rss_stylesheet.xslt", media="print"),\n ]\nこれらのオプションは複数のスタイルシートを使用する際に並列させることができます。
\nfrom django.contrib.syndication.views import Feed\nfrom django.utils.feedgenerator import Stylesheet\n\n\nclass MultiStylesheetFeed(Feed):\n stylesheets = [\n "/stylesheet1.xsl",\n Stylesheet("/stylesheet2.xsl"),\n ]\n