Fixed formatting problems of 'ref/contrib/comments/index.txt'.

sgryjp · sgryjp · commit 1db24f718114 · 2014-12-27T16:30:35.000+09:00
インデント不正の修正や余分な行末空白の削除など。
diff --git a/ref/contrib/comments/index.txt b/ref/contrib/comments/index.txt
@@ -1,8 +1,8 @@
-===========================
+======================
 コメントフレームワーク
-===========================
+======================
 
-:revision-up-to: 17812 (1.4) unfinished
+:revision-up-to: 17812 (1.4)
 
 .. module:: django.contrib.comments
    :synopsis: Django のコメントフレームワークです。
@@ -21,43 +21,43 @@ Django には単純ながらカスタマイズ可能なコメントフレーム
     </ref/contrib/comments/upgrade>` を参照してください。
 
 クイックスタートガイド
-==========================
+======================
 
 ``comments`` を使うには、以下のステップに従います:
 
-    #. :setting:`INSTALLED_APPS` に ``'django.contrib.comments'`` を
-       インストールします。
+#. :setting:`INSTALLED_APPS` に ``'django.contrib.comments'`` を
+   インストールします。
 
-    #. ``manage.py syncdb`` を実行して、コメントフレームワークのテーブルを
-       生成します。
+#. ``manage.py syncdb`` を実行して、コメントフレームワークのテーブルを
+   生成します。
 
-    #. コメントアプリケーションの URL をプロジェクトの ``urls.py`` にマップ
-       します:
-   
-       .. code-block:: python
+#. コメントアプリケーションの URL をプロジェクトの ``urls.py`` にマップ
+   します:
 
-            urlpatterns = patterns('',
-                ...
-                (r'^comments/', include('django.contrib.comments.urls')),
-                ...
-            )
+   .. code-block:: python
 
-    #. :ref:`コメントテンプレートタグ <comment-template-tags>` を使って、
-       コメント機能をテンプレートに埋め込みます。
+        urlpatterns = patterns('',
+            ...
+            (r'^comments/', include('django.contrib.comments.urls')),
+            ...
+        )
+
+#. :ref:`コメントテンプレートタグ <comment-template-tags>` を使って、
+   コメント機能をテンプレートに埋め込みます。
 
 :doc:`/ref/contrib/comments/settings` も調べておきましょう。
-    
+
 .. _comment-template-tags:
 
 コメントテンプレートタグ
-==========================
+========================
 
 コメントシステムは、主にテンプレートタグを使って操作します。テンプレートタ
 グを使えば、コメントをポストするためのフォームや、ポストされたコメントを埋
 め込めます。
 
 他のカスタムテンプレートタグライブラリと同様、使うには
-:ref:`カスタムタグライブラリをロード <loading-custom-template-libraries>` 
+:ref:`カスタムタグライブラリをロード <loading-custom-template-libraries>`
 しておかねばなりません::
 
     {% load comments %}
@@ -73,30 +73,30 @@ Django のコメントは、全て何らかのオブジェクトに「結びつ
 以下のタグを使うと、 2 種類の方法で、コメントを結びつけたいオブジェクトを指
 定できます:
 
-    #. オブジェクトを直接参照する方法 -- より一般的な方法です。たいていの場
-       合、コメントを結びつけたいオブジェクトはテンプレートコンテキストの中
-       に入っているはずです。そのオブジェクトを使います。
-       
-       例えば、あるブログのエントリ表示ページに ``entry`` という変数が入っ
-       ていて、エントリオブジェクトを表現しているなら、以下のようにして、
-       ``entry`` に結び付いたコメントの数を表示できます::
-       
-            {% get_comment_count for entry as comment_count %}.
-            
-    #. オブジェクトをコンテンツタイプとオブジェクト id で指定する方法。何ら
-       かの理由で、コメントを結び付ける対象のオブジェクトに直接アクセスでき
-       ない場合に使います。
-
-       上のような例で、オブジェクトの id が ``14`` だと分かっていて、かつ対
-       象のオブジェクトにアクセスできないなら、以下のようにします::
-       
-            {% get_comment_count for blog.entry 14 as comment_count %}
-            
-       この例の ``blog.entry`` は、アプリケーションラベルと (小文字にした)
-       モデルクラス名をつなげたものです。
+#. オブジェクトを直接参照する方法 -- より一般的な方法です。たいていの場
+   合、コメントを結びつけたいオブジェクトはテンプレートコンテキストの中
+   に入っているはずです。そのオブジェクトを使います。
+
+   例えば、あるブログのエントリ表示ページに ``entry`` という変数が入っ
+   ていて、エントリオブジェクトを表現しているなら、以下のようにして、
+   ``entry`` に結び付いたコメントの数を表示できます::
+
+        {% get_comment_count for entry as comment_count %}.
+
+#. オブジェクトをコンテンツタイプとオブジェクト id で指定する方法。何ら
+   かの理由で、コメントを結び付ける対象のオブジェクトに直接アクセスでき
+   ない場合に使います。
+
+   上のような例で、オブジェクトの id が ``14`` だと分かっていて、かつ対
+   象のオブジェクトにアクセスできないなら、以下のようにします::
+
+        {% get_comment_count for blog.entry 14 as comment_count %}
+
+   この例の ``blog.entry`` は、アプリケーションラベルと (小文字にした)
+   モデルクラス名をつなげたものです。
 
 コメントを表示する
--------------------
+------------------
 
 .. To display a list of comments, you can use the template tags
    :ttag:`render_comment_list` or :ttag:`get_comment_list`.
@@ -231,7 +231,7 @@ Django のコメントは、全て何らかのオブジェクトに「結びつ
 .. templatetag:: get_comment_count
 
 コメントの数を数える
-----------------------
+--------------------
 
 オブジェクトに結びつけられたコメントの数を取得するには、
 :ttag:`get_comment_count` を使います::
@@ -241,20 +241,20 @@ Django のコメントは、全て何らかのオブジェクトに「結びつ
 例を挙げましょう::
 
         {% get_comment_count for event as comment_count %}
-        
+
         <p>This event has {{ comment_count }} comments.</p>
-        
+
 
 コメント投稿フォームを表示する
---------------------------------
+------------------------------
 
 ユーザがコメントを投稿できるようフォームを表示するには、
 :ttag:`render_comment_form` や :ttag:`get_comment_form` を使います。
 
 .. templatetag:: render_comment_form
 
 コメントフォームを手軽に出力する
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 コメントフォームを表示する最も簡単な方法は、
 :ttag:`render_comment_form` を使うやり方です::
@@ -271,15 +271,15 @@ Django のコメントは、全て何らかのオブジェクトに「結びつ
 .. templatetag:: get_comment_form
 
 カスタムのコメントフォームを出力する
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 コメントフォームのルック&フィールを制御したければ、
 :ttag:`get_comment_form` を使って :doc:`フォームオブジェクト
 </topics/forms/index>` を取得し、テンプレート内で使います::
 
     {% get_comment_form for [object] as [varname] %}
 
-これで、フォームは以下のように書けます::    
+これで、フォームは以下のように書けます::
 
     {% get_comment_form for event as form %}
     <table>
@@ -302,7 +302,7 @@ Django のコメントは、全て何らかのオブジェクトに「結びつ
 .. templatetag:: comment_form_target
 
 コメントフォームターゲットを取得する
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 上の例では、 :ttag:`comment_form_target` というもう一つのタグを使って、フォー
 ムの ``action`` 属性を取得していたことに気づいたでしょうか。このタグは、常
@@ -328,34 +328,34 @@ Django のコメントは、全て何らかのオブジェクトに「結びつ
 .. _notes-on-the-comment-form:
 
 コメントフォームに関する注意
---------------------------------
+----------------------------
 
 コメントシステムの使っているフォームには、スパムを防ぐための重要な属性があ
 ります。これらの属性についてよく知っておきましょう:
 
-    * フォームには、タイムスタンプやコメントを結び付ける対象のオブジェクト、
-      これらの情報を検証するための「セキュリティハッシュ(security hash)」な
-      ど、いくつもの隠しフィールドが入っています。コメントスパム屋がよくや
-      るように、これらのフィールドの値を改ざんしようとすると、コメントの投
-      稿に失敗します。
-      
-      自作のコメントフォームを出力するときには、この隠しフィールドの値を変
-      更せずに渡してください。
-      
-    * タイムスタンプは、長時間再生攻撃が繰り返されるのを防ぐために使われま
-      す。フォームのリクエストからコメントのポストまで長時間経っている場合、
-      フォームの提出は拒否されます。
-      
-    * コメントフォームには、「 `ハニーポット`_ (honeypot_)」フィールドがあ
-      ります。このフィールドはトラップです: このフィールドに何らかのデータ
-      が入力されると、そのコメントはスパムであると見なされます (スパムプロ
-      グラムは、有効なフォーム入力を偽装するために、全てのフィールドを自動
-      的に埋めようとするからです)。
-
-      デフォルトのフォームは、 CSS を使ってこのフォームを隠し、ラベルにも
-      警告の文字列を入れます。カスタムのテンプレートでコメントフォームを使
-      うときにも、同じようにしてください。
-    
+* フォームには、タイムスタンプやコメントを結び付ける対象のオブジェクト、
+  これらの情報を検証するための「セキュリティハッシュ(security hash)」な
+  ど、いくつもの隠しフィールドが入っています。コメントスパム屋がよくや
+  るように、これらのフィールドの値を改ざんしようとすると、コメントの投
+  稿に失敗します。
+
+  自作のコメントフォームを出力するときには、この隠しフィールドの値を変
+  更せずに渡してください。
+
+* タイムスタンプは、長時間再生攻撃が繰り返されるのを防ぐために使われま
+  す。フォームのリクエストからコメントのポストまで長時間経っている場合、
+  フォームの提出は拒否されます。
+
+* コメントフォームには、「 `ハニーポット`_ (honeypot_)」フィールドがあ
+  ります。このフィールドはトラップです: このフィールドに何らかのデータ
+  が入力されると、そのコメントはスパムであると見なされます (スパムプロ
+  グラムは、有効なフォーム入力を偽装するために、全てのフィールドを自動
+  的に埋めようとするからです)。
+
+  デフォルトのフォームは、 CSS を使ってこのフォームを隠し、ラベルにも
+  警告の文字列を入れます。カスタムのテンプレートでコメントフォームを使
+  うときにも、同じようにしてください。
+
 .. The comments app also depends on the more general :doc:`Cross Site Request
    Forgery protection </ref/contrib/csrf>` that comes with Django.  As described in
    the documentation, it is best to use ``CsrfViewMiddleware``.  However, if you
