Skip to content

Commit 70e67f9

Browse files
committed
Merge branch '3.0' into 3.1
2 parents 4cb2a9d + d7d851d commit 70e67f9

File tree

120 files changed

+2151
-2267
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

120 files changed

+2151
-2267
lines changed

_build/_theme/_templates/globaltoc.html

+1-2
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,6 @@
11
<div class=submenu>
22
{% set menu = [
3-
('The Book', 'book/index'),
4-
('The Cookbook', 'cookbook/index'),
3+
('Home', 'index'),
54
('The Components', 'components/index'),
65
('The Best Practices', 'best_practices/index'),
76
('The Quick Tour', 'quick_tour/index'),

assetic/apply_to_option.rst

+1-1
Original file line numberDiff line numberDiff line change
@@ -116,7 +116,7 @@ You can also combine multiple CoffeeScript files into a single output file:
116116

117117
Both files will now be served up as a single file compiled into regular JavaScript.
118118

119-
.. _cookbook-assetic-apply-to:
119+
.. _assetic-apply-to:
120120

121121
Filtering Based on a File Extension
122122
-----------------------------------

assetic/asset_management.rst

+17-17
Original file line numberDiff line numberDiff line change
@@ -87,8 +87,8 @@ your application:
8787
Introducing Assetic
8888
-------------------
8989

90-
Assetic combines two major ideas: :ref:`assets <cookbook-assetic-assets>` and
91-
:ref:`filters <cookbook-assetic-filters>`. The assets are files such as CSS,
90+
Assetic combines two major ideas: :ref:`assets <assetic-assets>` and
91+
:ref:`filters <assetic-filters>`. The assets are files such as CSS,
9292
JavaScript and image files. The filters are things that can be applied to
9393
these files before they are served to the browser. This allows a separation
9494
between the asset files stored in the application and the files actually presented
@@ -117,7 +117,7 @@ load them from anywhere) before serving them. This means you can:
117117

118118
* Run image optimizations on your images
119119

120-
.. _cookbook-assetic-assets:
120+
.. _assetic-assets:
121121

122122
Assets
123123
------
@@ -126,12 +126,12 @@ Using Assetic provides many advantages over directly serving the files.
126126
The files do not need to be stored where they are served from and can be
127127
drawn from various sources such as from within a bundle.
128128

129-
You can use Assetic to process :ref:`CSS stylesheets <cookbook-assetic-including-css>`,
130-
:ref:`JavaScript files <cookbook-assetic-including-javascript>` and
131-
:ref:`images <cookbook-assetic-including-image>`. The philosophy
129+
You can use Assetic to process :ref:`CSS stylesheets <assetic-including-css>`,
130+
:ref:`JavaScript files <assetic-including-javascript>` and
131+
:ref:`images <assetic-including-image>`. The philosophy
132132
behind adding either is basically the same, but with a slightly different syntax.
133133

134-
.. _cookbook-assetic-including-javascript:
134+
.. _assetic-including-javascript:
135135

136136
Including JavaScript Files
137137
~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -172,7 +172,7 @@ To include JavaScript files, use the ``javascripts`` tag in any template:
172172
173173
.. tip::
174174

175-
You can also include CSS stylesheets: see :ref:`cookbook-assetic-including-css`.
175+
You can also include CSS stylesheets: see :ref:`assetic-including-css`.
176176

177177
In this example, all files in the ``Resources/public/js/`` directory of the
178178
AppBundle will be loaded and served from a different location. The actual
@@ -184,9 +184,9 @@ rendered tag might simply look like:
184184

185185
This is a key point: once you let Assetic handle your assets, the files are
186186
served from a different location. This *will* cause problems with CSS files
187-
that reference images by their relative path. See :ref:`cookbook-assetic-cssrewrite`.
187+
that reference images by their relative path. See :ref:`assetic-cssrewrite`.
188188

189-
.. _cookbook-assetic-including-css:
189+
.. _assetic-including-css:
190190

191191
Including CSS Stylesheets
192192
~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -229,7 +229,7 @@ except with the ``stylesheets`` tag:
229229
230230
But because Assetic changes the paths to your assets, this *will* break any
231231
background images (or other paths) that uses relative paths, unless you use
232-
the :ref:`cssrewrite <cookbook-assetic-cssrewrite>` filter.
232+
the :ref:`cssrewrite <assetic-cssrewrite>` filter.
233233

234234
.. note::
235235

@@ -240,7 +240,7 @@ the :ref:`cssrewrite <cookbook-assetic-cssrewrite>` filter.
240240
that there is a known issue that causes the ``cssrewrite`` filter to fail
241241
when using the ``@AppBundle`` syntax for CSS stylesheets.
242242

243-
.. _cookbook-assetic-including-image:
243+
.. _assetic-including-image:
244244

245245
Including Images
246246
~~~~~~~~~~~~~~~~
@@ -272,7 +272,7 @@ You can also use Assetic for image optimization. More information in
272272
`LiipImagineBundle`_ community bundle, which allows to compress and
273273
manipulate images (rotate, resize, watermark, etc.) before serving them.
274274

275-
.. _cookbook-assetic-cssrewrite:
275+
.. _assetic-cssrewrite:
276276

277277
Fixing CSS Paths with the ``cssrewrite`` Filter
278278
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -333,7 +333,7 @@ the JavaScript files.
333333
If you're new to Assetic and try to use your application in the ``prod``
334334
environment (by using the ``app.php`` controller), you'll likely see
335335
that all of your CSS and JS breaks. Don't worry! This is on purpose.
336-
For details on using Assetic in the ``prod`` environment, see :ref:`cookbook-assetic-dumping`.
336+
For details on using Assetic in the ``prod`` environment, see :ref:`assetic-dumping`.
337337

338338
And combining files doesn't only apply to *your* files. You can also use Assetic to
339339
combine third party assets, such as jQuery, with your own into a single file:
@@ -437,7 +437,7 @@ with the ``@named_asset`` notation:
437437
<script src="<?php echo $view->escape($url) ?>"></script>
438438
<?php endforeach ?>
439439
440-
.. _cookbook-assetic-filters:
440+
.. _assetic-filters:
441441

442442
Filters
443443
-------
@@ -557,7 +557,7 @@ done from the template and is relative to the public document root:
557557
via configuration on each deployment. For more information, see the
558558
:ref:`reference-framework-assets-version` configuration option.
559559

560-
.. _cookbook-assetic-dumping:
560+
.. _assetic-dumping:
561561

562562
Dumping Asset Files
563563
-------------------
@@ -591,7 +591,7 @@ by Symfony (as the asset files are in the ``dev`` environment). This is on
591591
purpose - letting Symfony generate these files dynamically in a production
592592
environment is just too slow.
593593

594-
.. _cookbook-assetic-dump-prod:
594+
.. _assetic-dump-prod:
595595

596596
Instead, each time you use your application in the ``prod`` environment (and therefore,
597597
each time you deploy), you should run the following command:

assetic/uglifyjs.rst

+4-4
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ to combine and minify JavaScript assets so that they require less HTTP requests
1111
and make your site load faster. `UglifyCSS`_ is a CSS compressor/beautifier
1212
that is very similar to UglifyJS.
1313

14-
In this cookbook, the installation, configuration and usage of UglifyJS is
14+
In this article, the installation, configuration and usage of UglifyJS is
1515
shown in detail. UglifyCSS works pretty much the same way and is only
1616
talked about briefly.
1717

@@ -236,14 +236,14 @@ apply this filter when debug mode is off (e.g. ``app.php``):
236236
<?php endforeach ?>
237237
238238
To try this out, switch to your ``prod`` environment (``app.php``). But before
239-
you do, don't forget to :ref:`clear your cache <book-page-creation-prod-cache-clear>`
240-
and :ref:`dump your assetic assets <cookbook-assetic-dump-prod>`.
239+
you do, don't forget to :ref:`clear your cache <page-creation-prod-cache-clear>`
240+
and :ref:`dump your assetic assets <assetic-dump-prod>`.
241241

242242
.. tip::
243243

244244
Instead of adding the filters to the asset tags, you can also configure which
245245
filters to apply for each file in your application configuration file.
246-
See :ref:`cookbook-assetic-apply-to` for more details.
246+
See :ref:`assetic-apply-to` for more details.
247247

248248
Install, Configure and Use UglifyCSS
249249
------------------------------------

assetic/yuicompressor.rst

+1-1
Original file line numberDiff line numberDiff line change
@@ -173,7 +173,7 @@ apply this filter when debug mode is off.
173173
example in the ``yui_js`` filter ``apply_to: "\.js$"``. To only have the filter
174174
applied in production, add this to the ``config_prod`` file rather than the
175175
common config file. For details on applying filters by file extension,
176-
see :ref:`cookbook-assetic-apply-to`.
176+
see :ref:`assetic-apply-to`.
177177

178178
.. _`YUI Compressor`: http://yui.github.io/yuicompressor/
179179
.. _`Download the JAR`: https://github.com/yui/yuicompressor/releases

best_practices/creating-the-project.rst

+2-2
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,8 @@ Installer**, which has to be installed before creating your first project.
1212

1313
Use the Symfony Installer to create new Symfony-based projects.
1414

15-
Read the :doc:`installation & setup chapter </setup>` of the Symfony Book to
16-
learn how to install and use the Symfony Installer.
15+
Read the :doc:`/setup` article learn how to install and use the Symfony
16+
Installer.
1717

1818
.. _linux-and-mac-os-x-systems:
1919
.. _windows-systems:

best_practices/forms.rst

+3-5
Original file line numberDiff line numberDiff line change
@@ -69,8 +69,7 @@ To use the class, use ``createForm()`` and pass the fully qualified class name::
6969
Registering Forms as Services
7070
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7171

72-
You can also
73-
:ref:`register your form type as a service <form-cookbook-form-field-service>`.
72+
You can also :ref:`register your form type as a service <form-field-service>`.
7473
This is only needed if your form type requires some dependencies to be injected
7574
by the container, otherwise it is unnecessary overhead and therefore *not*
7675
recommended to do this for all form type classes.
@@ -167,9 +166,8 @@ all of the fields:
167166

168167
If you need more control over how your fields are rendered, then you should
169168
remove the ``form_widget(form)`` function and render your fields individually.
170-
See the :doc:`/form/form_customization` cookbook article for more information
171-
on this and how you can control *how* the form renders at a global level
172-
using form theming.
169+
See :doc:`/form/form_customization` for more information on this and how you
170+
can control *how* the form renders at a global level using form theming.
173171

174172
Handling Form Submits
175173
---------------------

best_practices/security.rst

+1-1
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ Authentication and Firewalls (i.e. Getting the User's Credentials)
66

77
You can configure Symfony to authenticate your users using any method you
88
want and to load user information from any source. This is a complex topic, but
9-
the :doc:`Security Cookbook Section </security>` has a lot of information about
9+
the :doc:`Security guide</security>` has a lot of information about
1010
this.
1111

1212
Regardless of your needs, authentication is configured in ``security.yml``,

bundles.rst

+7-7
Original file line numberDiff line numberDiff line change
@@ -16,8 +16,8 @@ in your application and to optimize them the way you want.
1616

1717
.. note::
1818

19-
While you'll learn the basics here, an entire cookbook entry is devoted
20-
to the organization and best practices of :doc:`bundles </bundles/best_practices>`.
19+
While you'll learn the basics here, an entire article is devoted to the
20+
organization and best practices of :doc:`bundles </bundles/best_practices>`.
2121

2222
A bundle is simply a structured set of files within a directory that implement
2323
a single feature. You might create a BlogBundle, a ForumBundle or
@@ -167,12 +167,12 @@ of the most common elements of a bundle:
167167
A bundle can be as small or large as the feature it implements. It contains
168168
only the files you need and nothing else.
169169

170-
As you move through the book, you'll learn how to persist objects to a database,
171-
create and validate forms, create translations for your application, write
172-
tests and much more. Each of these has their own place and role within the
173-
bundle.
170+
As you move through the guides, you'll learn how to persist objects to a
171+
database, create and validate forms, create translations for your application,
172+
write tests and much more. Each of these has their own place and role within
173+
the bundle.
174174

175-
Learn More
175+
Learn more
176176
----------
177177

178178
.. toctree::

bundles/best_practices.rst

+4-3
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ This article is all about how to structure your **reusable bundles** so that
1313
they're easy to configure and extend. Many of these recommendations do not
1414
apply to application bundles because you'll want to keep those as simple
1515
as possible. For application bundles, just follow the practices shown throughout
16-
the book and cookbook.
16+
the guides.
1717

1818
.. seealso::
1919

@@ -414,10 +414,11 @@ The ``composer.json`` file should include at least the following metadata:
414414
In order to make it easier for developers to find your bundle, register it on
415415
`Packagist`_, the official repository for Composer packages.
416416

417-
Learn more from the Cookbook
418-
----------------------------
417+
Learn more
418+
----------
419419

420420
* :doc:`/bundles/extension`
421+
* :doc:`/bundles/configuration`
421422

422423
.. _`PSR-0`: http://www.php-fig.org/psr/psr-0/
423424
.. _`PSR-4`: http://www.php-fig.org/psr/psr-4/

0 commit comments

Comments
 (0)