cleaned TBDs away from syndication.txt.

whosaysni · whosaysni · commit f30db882be30 · 2008-09-19T00:00:34.000Z
diff --git a/ref/contrib/syndication.txt b/ref/contrib/syndication.txt
@@ -977,49 +977,50 @@ Feed クラスリファレンス
 カスタムのフィードジェネレータ
 ---------------------------------
 
-.. TBD
-
-If you need to produce a custom feed format, you've got a couple of options.
-    
-If the feed format is totally custom, you'll want to subclass
-``SyndicationFeed`` and completely replace the ``write()`` and
-``writeString()`` methods.
-
-However, if the feed format is a spin-off of RSS or Atom (i.e. GeoRSS_, Apple's
-`iTunes podcast format`_, etc.), you've got a better choice. These types of
-feeds typically add extra elements and/or attributes to the underlying format,
-and there are a set of methods that ``SyndicationFeed`` calls to get these extra
-attributes. Thus, you can subclass the appropriate feed generator class
-(``Atom1Feed`` or ``Rss201rev2Feed``) and extend these callbacks. They are:
+カスタムのフォーマットでフィードを生成したいなら、二つ方法があります。
+
+完全に独自の形式のフィードなら、 ``SyndicationFeed`` をサブクラス化して、
+``write()`` および ``writeString()`` メソッドを完全に書き直すとよいでしょう。
+
+しかし、 (GeoRSS_ や Apple の 
+`iTunes podcast フォーマット <iTunes podcast format>`_ )のように、既存のフィー
+ドフォーマットから派生したものであれば、もっといい選択肢があります。この手
+の派生フォーマットは、元のフォーマットにエレメントや属性を追加していて、
+``SyndicationFeed`` のメソッドには、こうした追加の属性を取得するためのもの
+があります。ですから、適切なフィードクラス (``Atom1Feed`` や
+``Rss201rev2Feed``) をサブクラス化して、コールバックを拡張すればよいのです。
+拡張用のメソッドを以下に示します:
       
 .. _georss: http://georss.org/
 .. _itunes podcast format: http://www.apple.com/itunes/store/podcaststechspecs.html
 
 ``SyndicationFeed.root_attributes(self, )``
-    Return a ``dict`` of attributes to add to the root feed element
-    (``feed``/``channel``).
+    フィードのルート要素 (``feed``/``channel``) に追加する属性の入った
+    ``dict`` を返します。
     
 ``SyndicationFeed.add_root_elements(self, handler)``
-    Callback to add elements inside the root feed element
-    (``feed``/``channel``). ``handler`` is an `XMLGenerator`_ from Python's
-    built-in SAX library; you'll call methods on it to add to the XML
-    document in process.
+    フィードのルート要素 (``feed``/``channel``) 要素に新たに要素を付加する
+    ためのコールバックです。 ``handler`` は Python 組み込み SAX ライブラリ
+    の XMLGenerator_ です。このオブジェクトのメソッドを呼び出して、 処理中
+    の XML ドキュメントに要素を追加します。
     
 ``SyndicationFeed.item_attributes(self, item)``
-    Return a ``dict`` of attributes to add to each item (``item``/``entry``)
-    element. The argument, ``item``, is a dictionary of all the data passed to
-    ``SyndicationFeed.add_item()``.
+    フィードの各要素 (``item``/``entry``) に追加する属性の入った ``dict``
+    を返します。引数 ``item`` は、 ``SyndicationFeed.item()`` に渡された
+    データの入っている ``dict`` です。
     
 ``SyndicationFeed.add_item_elements(self, handler, item)``
-    Callback to add elements to each item (``item``/``entry``) element.
-    ``handler`` and ``item`` are as above.
+    各要素の (``item``/``entry``) 要素に新たに要素を付加するためのコールバッ
+    クです。 ``handler`` と ``item`` は上と同じです。
 
 .. warning::
 
-    If you override any of these methods, be sure to call the superclass methods
-    since they add the required elements for each feed format.
+    これらのメソッドをオーバライドするときは、スーパクラスのメソッドを忘れ
+    ずに呼び出してください。スーパクラス側でも、必須の要素を追加するために
+    これらのメソッドを使っているからです。
 
-For example, you might start implementing an iTunes RSS feed generator like so::
+例えば、 iTunes RSS フィードジェネレータを実装するなら、書き始めは以下のよ
+うになるでしょう::
 
     class iTunesFeed(Rss201rev2Feed):
         def root_attibutes(self):
@@ -1031,7 +1032,7 @@ For example, you might start implementing an iTunes RSS feed generator like so::
             super(iTunesFeed, self).add_root_elements(handler)
             handler.addQuickElement('itunes:explicit', 'clean')
 
-Obviously there's a lot more work to be done for a complete custom feed class,
-but the above example should demonstrate the basic idea.
+もちろん、カスタムのフィードクラスを定義するには他にもたくさん作業が必要で
+すが、上の例を見れば基本的な考え方は理解できるはずです。
 
 .. _XMLGenerator: http://docs.python.org/dev/library/xml.sax.utils.html#xml.sax.saxutils.XMLGenerator
diff --git a/topics/db/managers.txt b/topics/db/managers.txt
@@ -187,15 +187,13 @@
 なくなるような羽目に陥らないように、デフォルトマネジャの選択には細心の注意
 を払ってください。
 
-.. TBD
-
-Using managers for related object access
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+マネジャを使ってリレーション先のオブジェクトにアクセスする
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-By default, Django uses a "bare" (i.e. default) manager when accessing related
-objects (i.e. ``choice.poll``). If this default isn't appropriate for your
-default manager, you can force Django to use a custom manager for related object
-attributes by giving it a ``use_for_related_fields`` property::
+デフォルトでは、 Django は「素の」マネジャを使って (``choice.poll`` のよう
+な)リレーション先のオブジェクトにアクセスします。リレーションを扱うときに
+別のマネジャを使いたいのなら、 ``use_for_related_fields`` プロパティの設定
+されたカスタムマネジャを定義してください::
 
     class MyManager(models.Manager)::
         use_for_related_fields = True
@@ -204,6 +202,8 @@ attributes by giving it a ``use_for_related_fields`` property::
 
         ...
 
+.. TBD
+
 Custom managers and model inheritance
 -------------------------------------
 
