エスケープを追加

Author: hidenorigoto

best_practices/controllers.rst

@@ -9,7 +9,7 @@ Symfonyは薄いコントローラとファットなモデルという哲学を
 
 .. best-practice::
 
-    コントローラを作る場合``FrameworkBundle``のベースコントローラを継承し、
+    コントローラを作る場合\ ``FrameworkBundle``\ のベースコントローラを継承し、
     ルーティング、キャッシュ、セキュリティを設定するときはなるべくアノテーションを使ってください。
 
 
@@ -43,7 +43,7 @@ YAML, XML, PHPなどのいろんなフォーマットで作られた何十もの
         resource: "@AppBundle/Controller/"
         type:     annotation
 
-このように設定すると、``src/AppBundle/Controller/`` ディレクトリとそのサブディレクトリにあるコントローラのアノテーションを読み込んでくれます。・
+このように設定すると、\ ``src/AppBundle/Controller/``\ ディレクトリとそのサブディレクトリにあるコントローラのアノテーションを読み込んでくれます。
 もしアプリケーションに多くのコントローラがある場合、それらを下図のようにサブディレクトリを作ってその中に移動しても全く問題ありません。
 
 
@@ -69,11 +69,11 @@ YAML, XML, PHPなどのいろんなフォーマットで作られた何十もの
 
 .. best-practice::
 
-    コントローラから呼ばれるテンプレートの設定をするのに ``@Template()`` アノテーションを使用しないでください。
+    コントローラから呼ばれるテンプレートの設定をするのに\ ``@Template()``\ アノテーションを使用しないでください。
 
-``@Template``は便利ですがある種の魔法を伴います。魔法を使うに値するとは思えないのでお勧めしません。
+``@Template``\ は便利ですがある種の魔法を伴います。魔法を使うに値するとは思えないのでお勧めしません。
 
-ほとんどの場合、``@Template``はパラメータなしで使われますが、そうするとどのテンプレートが呼ばれるのかわかりづらくなります。
+ほとんどの場合、\ ``@Template``\ はパラメータなしで使われますが、そうするとどのテンプレートが呼ばれるのかわかりづらくなります。
 また、コントローラは必ずレスポンスオブジェクトを返すべきだと言う事を初心者にわかりにくくします。(ビューレイヤーを使わない場合)
 
 コントローラはこんな感じにしよう
@@ -111,7 +111,7 @@ YAML, XML, PHPなどのいろんなフォーマットで作られた何十もの
 ParamConverterを使う
 ------------------------
 
-Doctrineを使っている場合は`ParamConverter`_ を使うことができます。
+Doctrineを使っている場合は\ `ParamConverter`_\ を使うことができます。
 これは自動的にエンティティを取得し、コントローラの引数にしてくれます。
 
 .. best-practice::
@@ -139,16 +139,16 @@ Doctrineを使っている場合は`ParamConverter`_ を使うことができま
         ));
     }
 
-通常、 ``showAction`` では ``$id`` という引数を期待するでしょう。その代わりに ``$post`` 引数を使い ``Post`` クラス(Doctrineのエンティティ)でタイプヒンティングすることで、
-とによって、そのオブジェクトをParamConverterが自動的に``{id}`` の値と一致する``$id`` プロパティを持つオブジェクトを探してくれます。
-また``Post`` が見つからなかった場合は404ページを表示してくれます。
+通常、\ ``showAction``\ では\ ``$id``\ という引数を期待するでしょう。その代わりに\ ``$post``\ 引数を使い\ ``Post``\ クラス(Doctrineのエンティティ)でタイプヒンティングすることで、
+とによって、そのオブジェクトをParamConverterが自動的に\ ``{id}``\ の値と一致する\ ``$id``\ プロパティを持つオブジェクトを探してくれます。
+また\ ``Post``\ が見つからなかった場合は404ページを表示してくれます。
 
 もっと複雑になったときは
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-上記のコードが設定なしで動くのは、ワイルドカード名``{id}``がエンティティのプロパティ名に一致するからです。
+上記のコードが設定なしで動くのは、ワイルドカード名\ ``{id}``\ がエンティティのプロパティ名に一致するからです。
 もしそうでない場合、またはもっと複雑なロジックがある場合、これを実現する簡単な方法は手動でエンティティを取得することです。
-本アプリケーションでは``CommentController``がその事例です。:
+本アプリケーションでは\ ``CommentController``\ がその事例です。:
 
 .. code-block:: php
 
@@ -168,7 +168,7 @@ Doctrineを使っている場合は`ParamConverter`_ を使うことができま
         // ...
     }
 
-``@ParamConverter`` 設定を使うこともできます。そうすればどこまでも柔軟にできます。:
+``@ParamConverter``\ 設定を使うこともできます。そうすればどこまでも柔軟にできます。:
 
 .. code-block:: php