[Django]: Django和訳ドキュメント sync to r5272

Django オンラインドキュメント和訳更新しました。 Revision 5272 (2007/05/17). 「Django プロジェクトに協力するために - コーディングスタイル - モデルのスタイル」「モデル API リファレンス - モデルのメソッド - get_absolute_url 」「配信フィードフレームワーク - 高水準フレームワーク - Feed クラス」についての記述が更新されています。

以下、 diff -r 5241:5272 の主な変更分です。

モデルのスタイル

フィールド名は全て小文字で，キャメルケース (camelCase のような書き方) はせず，アンダースコアを使います．

以下のような書き方をします:
class Person(models.Model):
    first_name = models.CharField(maxlength=20)
    last_name = models.CharField(maxlength=40)
以下のような書き方をしてはなりません:
class Person(models.Model):
    FirstName = models.CharField(maxlength=20)
    Last_Name = models.CharField(maxlength=40)
class Meta はフィールドの定義を書いた後に書きます．また，フィールド定義とクラス定義の間には一行空行を入れます．

以下のように書きます:
class Person(models.Model):
    first_name = models.CharField(maxlength=20)
    last_name = models.CharField(maxlength=40)

    class Meta:
        verbose_name_plural = 'people'
以下のような書き方をしてはなりません:
class Person(models.Model):
    first_name = models.CharField(maxlength=20)
    last_name = models.CharField(maxlength=40)
    class Meta:
        verbose_name_plural = 'people'
以下のような書き方もよくありません:
class Person(models.Model):
    class Meta:
        verbose_name_plural = 'people'

    first_name = models.CharField(maxlength=20)
    last_name = models.CharField(maxlength=40)
モデルの内部クラスや標準メソッドの順番は以下のようにします (ただし，どれも必須ではないので省略してもかまいません):

全てのデータベースフィールド

class Meta

class Admin

def __str__()

def save()

def get_absolute_url()

カスタムのメソッド定義
choices をモデルフィールドに定義する場合，選択肢は，各選択項目のタプルからなるタプルで定義します．定義はモデルモジュールの冒頭か，各モデルクラスのすぐ上に置き，全て大文字の変数名を付けます．例えば以下のようにします:
GENDER_CHOICES = (
    ('M', 'Male'),
    ('F', 'Female'),
)

get_absolute_url

Note

get_absolute_url() の返す文字列は ASCII 文字だけで構成しなければなりません (RFC 2396 の URI 仕様でそのように要求されています)．また，必要に応じて URL エンコードせねばなりません． get_absolute_url() を使うコードやテンプレートが， get_absolute_url() の返す文字列を，追加の処理を施さなくても直接利用できるようにせねばならないのです．

Feed クラス

get_absolute_url() や item_link() は，いずれも通常の Python 文字列で URL を返さねばなりません．また， get_absolute_url() と同様， item_link() の返す値は直接 URL に組み込めなければなりません．このため，プログラマは，必要に応じて URL のクオート処理や変換を行って，全ての文字が ASCII 文字からなる値に変換する責任があります．