mirror of
https://github.com/retailcrm/NelmioApiDocBundle.git
synced 2025-02-02 23:59:26 +03:00
48aaca92e3
* Fix NelmioApiDocBundle view customization instructions "Just create a file..." was not OK (missing views/ subdirectory, wrong SwaggerUi case) The path showcased as code-block's first row was OK * View customization instructions: remove unnecessary /views/ subdirectory
39 lines
1.4 KiB
ReStructuredText
39 lines
1.4 KiB
ReStructuredText
Customization
|
|
=============
|
|
|
|
The look and feel of the Swagger UI can be customized.
|
|
|
|
|
|
Overwrite Twig Template
|
|
-----------------------
|
|
|
|
If you want to customize parts of the template, you can create your own Twig template.
|
|
This allows to change the title, the header, add additional or replace existing styles or scripts.
|
|
|
|
Take a look at the Twig documentation `how to extend templates <https://twig.symfony.com/doc/2.x/tags/extends.html>`_.
|
|
|
|
The following example will add additional scripts and a custom style to the template.
|
|
Just create a file ``templates/bundles/NelmioApiDocBundle/SwaggerUi/index.html.twig``.
|
|
|
|
.. code-block:: twig
|
|
|
|
{# templates/bundles/NelmioApiDocBundle/SwaggerUi/index.html.twig #}
|
|
|
|
{#
|
|
To avoid a "reached nested level" error an exclamation mark `!` has to be added
|
|
See https://symfony.com/blog/new-in-symfony-3-4-improved-the-overriding-of-templates
|
|
#}
|
|
{% extends '@!NelmioApiDoc/SwaggerUi/index.html.twig' %}
|
|
|
|
{% block stylesheets %}
|
|
{{ parent() }}
|
|
<link rel="stylesheet" href="{{ asset('css/custom-swagger-styles.css') }}">
|
|
{% endblock stylesheets %}
|
|
|
|
{% block javascripts %}
|
|
{{ parent() }}
|
|
<script type="text/javascript" src="{{ asset('js/custom-request-signer.js') }}"></script>
|
|
{% endblock javascripts %}
|
|
|
|
You can have a look at the original template to see which blocks can be overridden.
|