blob: af7a6db9449bfdf30646519c090e0e7fb173a5eb (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
|
.. _asset_directive:
``asset``
---------
The ``asset`` directive adds an asset override for a single
static file/directory asset.
Attributes
~~~~~~~~~~
``to_override``
A :term:`asset specification` specifying the asset to be
overridden.
``override_with``
A :term:`asset specification` specifying the asset which
is used as the override.
Examples
~~~~~~~~
.. topic:: Overriding a Single Asset File
.. code-block:: xml
:linenos:
<asset
to_override="some.package:templates/mytemplate.pt"
override_with="another.package:othertemplates/anothertemplate.pt"
/>
.. topic:: Overriding all Assets in a Package
.. code-block:: xml
:linenos:
<asset
to_override="some.package"
override_with="another.package"
/>
.. topic:: Overriding all Assets in a Subdirectory of a Package
.. code-block:: xml
:linenos:
<asset
to_override="some.package:templates/"
override_with="another.package:othertemplates/"
/>
Alternatives
~~~~~~~~~~~~
The :meth:`pyramid.config.Configurator.override_asset`
method can be used instead of the ``resource`` ZCML directive.
This directive can also be invoked as the ``resource`` ZCML directive for
backwards compatibility purposes.
See Also
~~~~~~~~
See also :ref:`asset_zcml_directive`.
|
