readded multilang docs, fix for 280bdf2

Author: lsmith77

bundles/simple_cms.rst

@@ -101,8 +101,39 @@ See the section below for multilanguage support.
 Multi-language support
 ----------------------
 
-@todo: Explain how multilang works now, in particular the use of ``->addLocaleFormat`` on
-the ``Page`` document.
+Setting ``addLocalePattern`` to true in the ``Symfony\Cmf\Bundle\SimpleCmsBundle\Doctrine\Phpcr\Page``
+document will result in prefixing the associated route with ``/{_locale}``. Using the native
+translation capabilities of PHPCR ODM it is now possible to create different versions of the document
+for each language that should be available on the website:
+
+    $page = new Page();
+
+    $page->setPosition($parent, 'hello-world');
+    $page->setTitle('Hello World!');
+    $page->setBody('Really interesting stuff...');
+    $page->setLabel('Hello World');
+    $dm->persist($page);
+    $dm->bindTranslation($page, 'en');
+
+    $page->setTitle('Hallo Welt!');
+    $page->setBody('Super interessante Sachen...');
+    $page->setLabel('Hallo Welt!');
+    $dm->bindTranslation($page, 'de');
+
+    $dm->flush();
+
+.. note::
+
+    Since SimpleCmsBundle only provides a single tree structure, all nodes
+    will have the same node name for all languages. So a url
+    ``http://foo.com/en/hello-world`` for english content will look like
+    ``http://foo.com/de/hello-world`` for german content. At times it might be most
+    feasible to use integers as the node names and simple append the title of
+    the node in the given locale as an anchor. So for example
+    ``http://foo.com/de/1#my title`` and ``http://foo.com/de/1#mein title``.
+    If you need language specific URLs, you want to use the CMF routing bundle
+    and content bundle directly to have a separate route document per
+    language.
 
 Rendering
 ---------