Skip to content

Commit 21b3de9

Browse files
committed
Merge branch 'master' of git://github.com/n8v/symfony-docs into n8v-master
2 parents 17f01e6 + a4149cd commit 21b3de9

File tree

4 files changed

+74
-5
lines changed

4 files changed

+74
-5
lines changed

book/templating.rst

Lines changed: 18 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1089,7 +1089,24 @@ but can return any other format based on the format requested by the user.
10891089
The request format is most often managed by the routing, where a route can
10901090
be configured so that ``/contact`` sets the request format to ``html`` while
10911091
``/contact.xml`` sets the format to ``xml``. For more information, see the
1092-
:doc:`Routing</book/routing>` chapter.
1092+
:ref:`Advanced Example in the Routing chapter <advanced-routing-example>`.
1093+
1094+
To create links that include the format parameter, include a ``_format``
1095+
key in the parameter hash:
1096+
1097+
.. configuration-block::
1098+
1099+
.. code-block:: html+jinja
1100+
1101+
<a href="{{ path('article_show', {'id':123, '_format':pdf}) }}">
1102+
PDF Version</a>
1103+
1104+
.. code-block:: php
1105+
1106+
<a href="<?php echo $view['router']->generate('article_show',
1107+
array('id' => 123, '_format' => 'pdf',) ?>">PDF Version</a>
1108+
1109+
10931110
10941111
Final Thoughts
10951112
--------------

contributing/code/patches.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -106,8 +106,8 @@ while to finish your changes):
106106
$ git checkout BRANCH_NAME
107107
$ git rebase master
108108
109-
When doing the `rebase` command, you might have to fix merge conflicts. `git
110-
st` gives you the *unmerged* files. Resolve all conflicts, then continue the
109+
When doing the ``rebase`` command, you might have to fix merge conflicts. ``git
110+
status`` gives you the *unmerged* files. Resolve all conflicts, then continue the
111111
rebase:
112112

113113
.. code-block:: bash

glossary.rst

Lines changed: 49 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,8 @@ Glossary
5353
an application. Instead of creating services directly, the developer
5454
*trains* the service container (via configuration) on how to create
5555
the services. The service container takes care of lazily instantiating
56-
and injecting dependent services.
56+
and injecting dependent services. See :doc:`/book/service_container`
57+
chapter.
5758

5859
HTTP Specification
5960
The *Http Specification* is a document that describes the Hypertext
@@ -71,6 +72,53 @@ Glossary
7172
to have a ``dev`` environment built for debugging and a ``prod`` environment
7273
that's optimized for speed.
7374

75+
Vendor
76+
A *vendor* is a supplier of PHP libraries and bundles including Symfony2
77+
itself. Despite the usual commercial connotations of the word, vendors
78+
in Symfony often (even usually) include free software. Any library you
79+
add to your Symfony2 project should go in the ``vendor`` directory. See
80+
:ref:`The Architecture: Using Vendors <using-vendors>`.
81+
82+
Acme
83+
*Acme* is a sample company name used in Symfony demos and
84+
documentation. For example, it's used as a namespace where you would
85+
normally use your own company's name. See
86+
`Acme Corporation at Wikipedia`_.
87+
88+
Action
89+
An *action* is controller code that executes for a given
90+
route. Synonomous with *controller*, but most *controller* PHP classes
91+
include several *actions*. See the
92+
:doc:`Controller Chapter </book/controller>`.
93+
94+
Asset
95+
An *asset* is any non-executable, static component of a web application,
96+
including CSS, js, images and video. Assets may be placed directly in
97+
the project's ``web`` directory, or published from a :term:`Bundle` to the web
98+
directory using the ``assets:install`` console task.
99+
100+
Kernel
101+
The *Kernel* is the core of Symfony2. The Kernel object handles HTTP
102+
requests using all the bundles and libraries registered to it. See
103+
:ref:`The Architecture: The Application Directory <the-app-dir>` and the
104+
:doc:`book/internals/kernel` chapter.
105+
106+
Firewall
107+
In Symfony2, a *Firewall* doesn't have to do with networking. Instead,
108+
it defines the authentication mechanisms, either for the whole
109+
application or for just a part of it. See the
110+
:doc:`book/security/overview` chapters.
111+
112+
YAML
113+
*YAML* is a recursive acronym for "YAML Ain't a Markup Language". It's a
114+
lightweight, humane data serialization language used extensively in
115+
Symfony2's configuration files. See the :doc:`reference/YAML` reference
116+
chapter.
117+
118+
119+
120+
74121
.. _`service-oriented architecture`: http://wikipedia.org/wiki/Service-oriented_architecture
75122
.. _`HTTP Wikipedia`: http://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol
76123
.. _`HTTP 1.1 RFC`: http://www.w3.org/Protocols/rfc2616/rfc2616.html
124+
.. _`Acme Corporation at Wikipedia`: http://en.wikipedia.org/wiki/Acme_Corporation

quick_tour/the_architecture.rst

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,6 +41,8 @@ framework and registers the autoloader (see below).
4141
Like any front controller, ``app.php`` uses a Kernel Class, ``AppKernel``, to
4242
bootstrap the application.
4343

44+
.. _the-app-dir:
45+
4446
The Application Directory
4547
~~~~~~~~~~~~~~~~~~~~~~~~~
4648

@@ -264,6 +266,8 @@ instance.
264266
Do you understand now why Symfony2 is so flexible? Share your bundles between
265267
applications, store them locally or globally, your choice.
266268

269+
.. _using-vendors:
270+
267271
Using Vendors
268272
-------------
269273

@@ -321,4 +325,4 @@ topics now? Look no further - go to the official :doc:`/book/index` and pick
321325
any topic you want.
322326

323327
.. _standards: http://groups.google.com/group/php-standards/web/psr-0-final-proposal
324-
.. _convention: http://pear.php.net/
328+
.. _convention: http://pear.php.net/

0 commit comments

Comments
 (0)