Added the description of the new base_path option

javiereguiluz · javiereguiluz · commit fccd261f6cc0 · 2015-04-16T17:05:43.000+02:00
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
@@ -424,6 +424,30 @@ assets
     The ``assets`` option was introduced in Symfony 2.7. Prior to Symfony
     2.7, the ``templating`` option provided equivalent configuration options.
 
+base_path
+.........
+
+**default**: ``''`` (empty string)
+
+.. versionadded:: 2.7
+    The ``base_path`` option was introduced in Symfony 2.7.
+
+The path to prepend when generating the asset's relative URL. For example, if
+the application defines the following configuration:
+
+.. code-block:: yaml
+
+    # app/config/config.yml
+    framework:
+        assets:
+            base_path: static/images/
+
+The ``asset('logos/default.png')`` function will no longer generate the
+``/logos/default.png`` relative URL but ``/static/images/logos/default.png``.
+
+The value of the ``base_path`` option is appended after the global base path
+defined in the ``router.request_context.base_url`` option (if any).
+
 base_urls
 .........
 
