Add how to override swagger templates (#435)

cduran433 · dunglas · commit 63e94f97c18f · 2018-03-15T11:09:17.000+01:00
* Add how to override swagger templates

* Improve the "Overriding the UI Template" section
diff --git a/core/swagger.md b/core/swagger.md
@@ -261,3 +261,20 @@ $ docker-compose exec php bin/console api:swagger:export
 $ docker-compose exec php bin/console api:swagger:export --yaml
 # Swagger documentation in YAML format...
 ```
+
+## Overriding the UI Template
+
+As described [in the Symfony documentation](https://symfony.com/doc/current/templating/overriding.html), it's possible to override the Twig template that loads Swagger UI and renders the documentation:
+
+```twig
+{# templates/bundles/ApiPlatformBundle/SwaggerUi/index.html.twig #}
+<!DOCTYPE html>
+<html>
+<head>
+    <meta charset="UTF-8">
+    <title>{% if title %}{{ title }} {% endif %}My custom template</title>
+    {# ... #}
+</html>
+```
+
+You may want to copy the [one shipped with API Platform](https://github.com/api-platform/core/blob/master/src/Bridge/Symfony/Bundle/Resources/views/SwaggerUi/index.html.twig) and customize it.
