From 2965eba3ecfe803ee79daab3413a89f855b706c4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ra=C3=BAl=20Continente?= Date: Mon, 22 May 2017 21:56:58 +0200 Subject: [PATCH 1/2] Update twig_reference.rst --- reference/twig_reference.rst | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst index a8c25096e7d..87204d4f20c 100644 --- a/reference/twig_reference.rst +++ b/reference/twig_reference.rst @@ -567,14 +567,16 @@ file_excerpt .. code-block:: twig - {{ file|file_excerpt(line = null) }} + {{ file|file_excerpt(line, srcContext = 3) }} ``file`` **type**: ``string`` -``line`` *(optional)* +``line`` + **type**: ``integer`` +``srcContext`` *(optional)* **type**: ``integer`` -Generates an excerpt of seven lines around the given ``line``. +Generates an excerpt of a code file around the given ``line`` number. An optional number of displayed lines can be passed. format_file ~~~~~~~~~~~ @@ -611,12 +613,14 @@ file_link .. code-block:: twig - {{ file|file_link(line = null) }} + {{ file|file_link(line) }} -``line`` *(optional)* +``file`` + **type**: ``string`` +``line`` **type**: ``integer`` -Generates a link to the provided file (and optionally line number) using +Generates a link to the provided file and line number using a preconfigured scheme. .. _reference-twig-tags: From 6da185534d32dabd1883c4e12645e16e93cf8aa8 Mon Sep 17 00:00:00 2001 From: Javier Eguiluz Date: Sun, 9 Jul 2017 17:04:17 +0200 Subject: [PATCH 2/2] Minor reword --- reference/twig_reference.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst index 87204d4f20c..44858bccfcb 100644 --- a/reference/twig_reference.rst +++ b/reference/twig_reference.rst @@ -576,7 +576,9 @@ file_excerpt ``srcContext`` *(optional)* **type**: ``integer`` -Generates an excerpt of a code file around the given ``line`` number. An optional number of displayed lines can be passed. +Generates an excerpt of a code file around the given ``line`` number. The +``srcContext`` argument defines the total number of lines to display around the +given line number (use ``-1`` to display the whole file). format_file ~~~~~~~~~~~