Merge pull request #411 from symfony-cmf/separate-sonata-doc

move sonata reference documentation to sonata

Author: wouterj

book/static_content.rst

@@ -76,8 +76,7 @@ Admin Support
 
 The last component needed to handle the included content types is an
 administration panel. Symfony CMF can optionally support
-`SonataDoctrinePHPCRAdminBundle`_, a back office generation tool. For more
-information about it, please refer to the bundle's `documentation section`_.
+SonataDoctrinePHPCRAdminBundle_, a back office generation tool.
 
 In ContentBundle, the required administration panels are already declared in
 the ``Admin`` folder and configured in ``Resources/config/admin.xml``, and
@@ -101,5 +100,4 @@ or use as inspiration to develop your own content types, Controllers and Admin
 panels.
 
 .. _`multilanguage support in PHPCR-ODM`: http://docs.doctrine-project.org/projects/doctrine-phpcr-odm/en/latest/reference/multilang.html
-.. _`SonataDoctrinePHPCRAdminBundle`: https://github.com/sonata-project/SonataDoctrinePhpcrAdminBundle
-.. _`documentation section`: https://github.com/sonata-project/SonataDoctrinePhpcrAdminBundle/tree/master/Resources/doc
+.. _SonataDoctrinePHPCRAdminBundle: https://github.com/sonata-project/SonataDoctrinePhpcrAdminBundle

book/structuring_content.rst

@@ -21,15 +21,15 @@ Symfony CMF Menu System
 ~~~~~~~~~~~~~~~~~~~~~~~
 
 Symfony CMF SE includes the MenuBundle, a tool that allow you to dynamically
-define your menus. It extends the `KnpMenuBundle`_, with a set of
+define your menus. It extends the KnpMenuBundle_, with a set of
 hierarchical, multi language menu elements, along with the tools to persist
 them in the chosen content store. It also includes the administration panel
 definitions and related services needed for integration with the
-`SonataDoctrinePhpcrAdminBundle`_.
+SonataDoctrinePHPCRAdminBundle_.
 
 .. note::
 
-    The MenuBundle extends and greatly relies on the `KnpMenuBundle`_, so you
+    The MenuBundle extends and greatly relies on the KnpMenuBundle_, so you
     should carefully read `KnpMenuBundle's documentation`_. For the rest of
     this page we assume you have done so and are familiar with concepts like
     Menu Providers and Menu Factories.
@@ -114,7 +114,7 @@ The included implementation focuses on generating ``MenuItem`` instances from
 ``NodeInterface`` instances, as this is usually the best approach to handle
 tree-like structures typically used by a CMS. Other approaches are implemented in
 the base classes, and their respective documentation pages can be found in
-`KnpMenuBundle`_'s page.
+KnpMenuBundle_'s page.
 
 ``ContentAwareFactory`` is responsible for loading the full menu hierarchy and
 transforming the ``MenuNode`` instances from the root node it receives from
@@ -179,12 +179,12 @@ Admin Support
 
 The MenuBundle also includes the administration panels and respective services
 needed for integration with the backend admin tool
-:doc:`SonataDoctrinePhpcrAdminBundle <../bundles/doctrine_phpcr_admin>`
+SonataDoctrinePHPCRAdminBundle_.
 
 The included administration panels are automatically available but need to
 be explicitly put on the dashboard if you want to use them. See
 :doc:`../cookbook/creating_cms_using_cmf_and_sonata` for instructions on how
-to install SonataDoctrinePhpcrAdminBundle.
+to install SonataDoctrinePHPCRAdminBundle.
 
 Configuration
 ~~~~~~~~~~~~~
@@ -193,10 +193,10 @@ This bundle is configurable using a set of parameters, but all of them are
 optional. You can go to the :doc:`../bundles/menu/index` reference page for the full
 configuration options list and additional information.
 
-.. _`KnpMenuBundle`: https://github.com/knplabs/KnpMenuBundle
-.. _`SonataDoctrinePhpcrAdminBundle`: https://github.com/sonata-project/SonataDoctrinePhpcrAdminBundle
+.. _KnpMenuBundle: https://github.com/knplabs/KnpMenuBundle
 .. _`KnpMenuBundle's documentation`: https://github.com/KnpLabs/KnpMenuBundle/blob/master/Resources/doc/index.md
 .. _`respective documentation page`: https://github.com/KnpLabs/KnpMenuBundle/blob/master/Resources/doc/index.md#rendering-menus
 .. _`Doctrine PHPCR documentation page`: http://docs.doctrine-project.org/projects/doctrine-phpcr-odm/en/latest/reference/association-mapping.html#references
 .. _`Multi language support in PHPCR-ODM`: http://docs.doctrine-project.org/projects/doctrine-phpcr-odm/en/latest/reference/multilang.html
 .. _`KnpMenu`: https://github.com/knplabs/KnpMenu
+.. _SonataDoctrinePHPCRAdminBundle: http://sonata-project.org/bundles/doctrine-phpcr-admin/master/doc/index.html

bundles/block/types.rst

@@ -29,8 +29,8 @@ Sonata Admin
 ~~~~~~~~~~~~
 
 All block types provided by the Symfony2 CMF BlockBundle come with a admin
-classes for :doc:`../doctrine_phpcr_admin`. To activate the admin services,
-it is enough to load the SonataDoctrinePhpcrAdminBundle in your application
+classes for SonataDoctrinePHPCRAdminBundle_. To activate the admin services,
+it is enough to load the SonataDoctrinePHPCRAdminBundle in your application
 kernel and configure the sonata dashboard as desired.
 
 .. _bundles-block-types-admin_extension:
@@ -410,3 +410,4 @@ for further information.
 .. _`LiipImagineBundle`: https://github.com/liip/LiipImagineBundle
 .. _`LiipImagineBundle documentation`: https://github.com/liip/LiipImagineBundle/tree/master/Resources/doc
 .. _`sub-request`: http://symfony.com/doc/current/book/internals.html#internal-requests
+.. _SonataDoctrinePHPCRAdminBundle: http://sonata-project.org/bundles/doctrine-phpcr-admin/master/doc/index.html

bundles/doctrine_phpcr_admin.rst

@@ -16,7 +16,6 @@ Bundles
     routing/index
     search/index
     simple_cms/index
-    doctrine_phpcr_admin
     tree_browser/index
 
 .. include:: map.rst.inc

bundles/index.rst

@@ -95,6 +95,6 @@ help with integrating PHPCR concepts into the Symfony Framework.
 
   * :doc:`phpcr_odm`
 
-* **SonataDoctrinePhpcrAdminBundle**
+* SonataDoctrinePHPCRAdminBundle_
 
-  * :doc:`doctrine_phpcr_admin`
+.. _SonataDoctrinePHPCRAdminBundle: http://sonata-project.org/bundles/doctrine-phpcr-admin/master/doc/index.html

bundles/map.rst.inc

@@ -4,14 +4,13 @@
 Menu Admin with Sonata PHPCR-ODM
 ================================
 
-If the :doc:`SonataDoctrinePhpcrAdminBundle <../doctrine_phpcr_admin>` is
-loaded in the application kernel, menu node and menu documents can be
-administrated in Sonata admin. For instructions on how to configure Sonata,
-see :doc:`../doctrine_phpcr_admin`.
+If the SonataDoctrinePHPCRAdminBundle_ is loaded in the application kernel,
+menu node and menu documents can be administrated in Sonata admin. For
+instructions on how to configure Sonata, see `configuring sonata admin`_.
 
 Loading of Sonata is controlled with the ``use_sonata_admin`` configuration
 setting. By default, this option is automatically set based on whether
-SonataDoctrinePhpcrAdminBundle is available, but you can explicitly
+SonataDoctrinePHPCRAdminBundle is available, but you can explicitly
 disable the flag to not provide the Sonata services even if Sonata would be
 available. You can also explicitly enable the flag to get an error if Sonata
 becomes unavailable.
@@ -128,3 +127,5 @@ configuration in the ``sonata_admin`` section of your project configuration:
 See the `Sonata Admin extension documentation`_ for more information.
 
 .. _`Sonata Admin extension documentation`: http://sonata-project.org/bundles/admin/master/doc/reference/extensions.html
+.. _SonataDoctrinePHPCRAdminBundle: http://sonata-project.org/bundles/doctrine-phpcr-admin/master/doc/index.html
+.. _`configuring sonata admin`: http://sonata-project.org/bundles/doctrine-phpcr-admin/master/doc/reference/configuration.html

bundles/menu/sonata_admin.rst

@@ -580,7 +580,7 @@ to a list of allowed managed documents. Please refer to the
 `Symfony documentation on the entity form type`_ for more details,
 including how you can configure a query.
 
-If you are using Sonata Admin, you might want to look into
+If you are using SonataDoctrinePHPCRAdminBundle_, you might want to look into
 ``sonata_type_collection``. This form type allows to edit related
 documents (references as well as children) inline and also to create
 and remove them on the fly.
@@ -618,10 +618,10 @@ The minimal code required to use this type looks as follows::
 
 .. tip::
 
-    When building an admin interface with
-    :doc:`Sonata Admin <doctrine_phpcr_admin>` there is also the
-    ``sonata_type_model`` that is more powerful, allowing to add to the
-    referenced documents on the fly. Unfortunately it is `currently broken`_.
+    When building an admin interface with the SonataDoctrinePHPCRAdminBundle_
+    there is also the ``sonata_type_model`` that is more powerful, allowing to
+    add to the referenced documents on the fly. Unfortunately it is
+    `currently broken`_.
 
 phpcr_reference
 ~~~~~~~~~~~~~~~
@@ -868,6 +868,7 @@ Dumping nodes under ``/cms/simple`` including their properties:
 .. _`Symfony event subscriber`: http://symfony.com/doc/master/components/event_dispatcher/introduction.html#using-event-subscribers
 .. _`Symfony cookbook entry`: http://symfony.com/doc/current/cookbook/doctrine/event_listeners_subscribers.html
 .. _`Symfony documentation on the entity form type`: http://symfony.com/doc/current/reference/forms/types/entity.html
+.. _SonataDoctrinePHPCRAdminBundle: http://sonata-project.org/bundles/doctrine-phpcr-admin/master/doc/index.html
 .. _`currently broken`: https://github.com/sonata-project/SonataDoctrineORMAdminBundle/issues/145
 .. _`DoctrineMigrationsBundle`: http://symfony.com/doc/current/bundles/DoctrineMigrationsBundle/index.html
 .. _`DoctrineFixturesBundle`: http://symfony.com/doc/current/bundles/DoctrineFixturesBundle/index.html

bundles/phpcr_odm.rst

@@ -276,13 +276,12 @@ need content, you can just not set it in the route document.
 Sonata Doctrine PHPCR-ODM Admin classes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-If the :doc:`SonataDoctrinePhpcrAdminBundle <../doctrine_phpcr_admin>` is
-loaded in the application kernel, route and redirect route documents can be
-administrated in sonata admin. For instructions on how to configure Sonata,
-see :doc:`../doctrine_phpcr_admin`.
+If the SonataDoctrinePHPCRAdminBundle_ is loaded in the application kernel,
+route and redirect route documents can be administrated in sonata admin. For
+instructions on how to configure Sonata, see `configuring sonata admin`_.
 
 By default, ``use_sonata_admin`` is automatically set based on whether
-SonataDoctrinePhpcrAdminBundle is available, but you can explicitly
+SonataDoctrinePHPCRAdminBundle is available, but you can explicitly
 disable it to not have it even if sonata is enabled, or explicitly enable to
 get an error if Sonata becomes unavailable.
 
@@ -569,3 +568,5 @@ Read on in the chapter :doc:`customizing the dynamic router <dynamic_customize>`
 .. _`PHPCR-ODM`: http://www.doctrine-project.org/projects/phpcr-odm.html
 .. _`Sonata Admin extension documentation`: http://sonata-project.org/bundles/admin/master/doc/reference/extensions.html
 .. _`URL generating capabilities of Symfony2`: http://symfony.com/doc/current/book/routing.html#generating-urls
+.. _SonataDoctrinePHPCRAdminBundle: http://sonata-project.org/bundles/doctrine-phpcr-admin/master/doc/index.html
+.. _`configuring sonata admin`: http://sonata-project.org/bundles/doctrine-phpcr-admin/master/doc/reference/configuration.html