From 4e58c4811acbb3b471efc2d94a0d3851ab9059d5 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien.potencier@gmail.com>
Date: Tue, 7 Jul 2015 09:46:15 +0200
Subject: [PATCH] added a recipe about rendering a template stored in a string

---
 doc/recipes.rst | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/doc/recipes.rst b/doc/recipes.rst
index 7481c403b..72a259e76 100644
--- a/doc/recipes.rst
+++ b/doc/recipes.rst
@@ -421,4 +421,22 @@ logical name, and not the path from the filesystem::
 Now that the ``base.twig`` templates is defined in an array loader, you can
 remove it from the database, and everything else will still work as before.
 
+Rendering a Template Stored in a String
+---------------------------------------
+
+The ``template_from_string`` Twig function allows a template stored in a string
+to be rendered from another template:
+
+.. code-block:: jinja
+
+    {{ include(template_from_string("Hello {{ name }}")) }}
+
+Doing the same in PHP is also possible::
+
+    $twig = new \Twig_Environment(new \Twig_Loader_Array(array()));
+
+    $template = $twig->createTemplate('Hello {{ name }}');
+
+    $rendered = $template->render(array('name' => 'Bob'));
+
 .. _callback: http://www.php.net/manual/en/function.is-callable.php