Added information about the cssrewrite filter not working with the @AcmeFooBundle syntax. [kriswallsmith/assetic#53]

gm-olivier · weaverryan · commit e03cc0624f65 · 2013-02-26T21:44:28.000-06:00
kriswallsmith/assetic#53 (comment)
diff --git a/cookbook/assetic/asset_management.rst b/cookbook/assetic/asset_management.rst
@@ -88,10 +88,42 @@ The actual rendered tag might simply look like:
 .. note::
 
     This is a key point: once you let Assetic handle your assets, the files are
-    served from a different location. This *can* cause problems with CSS files
+    served from a different location. This *will* cause problems with CSS files
     that reference images by their relative path. However, this can be fixed
     by using the ``cssrewrite`` filter, which updates paths in CSS files
     to reflect their new location.
+    
+    Unfortunately, the ``cssrewrite`` filter does not work when using the
+    ``@AcmeFooBundle`` syntax to reference the assets. This is a known
+    limitation. A workaround is to use the ``output`` option to change the
+    location the files are served from to a path from which the relative paths
+    work, e.g.: 
+
+    .. configuration-block::
+
+        .. code-block:: html+jinja
+
+            {% stylesheets
+                output='bundles/acmefoo/css/compiled.css'
+                '@AcmeFooBundle/Resources/public/css/*'
+            %}
+                <link rel="stylesheet" href="{{ asset_url }}" />
+            {% endstylesheets %}
+
+        .. code-block:: html+php
+
+            <?php foreach ($view['assetic']->stylesheets(
+                array('@AcmeFooBundle/Resources/public/css/*'),
+                array(),
+                array('output' => 'bundles/acmefoo/css/compiled.css')
+            ) as $url): ?>
+                <link rel="stylesheet" href="<?php echo $view->escape($url) ?>" />
+            <?php endforeach; ?>
+    
+    Of course, this assumes that all the CSS files you serve in this block use
+    relative paths that start from the same location, which is not always
+    convenient. This is the reason this is called a *workaround* and not a
+    *solution*.
 
 Combining Assets
 ~~~~~~~~~~~~~~~~
