diff options
-rw-r--r-- | docs/ref/rst/directives.txt | 8 |
1 files changed, 5 insertions, 3 deletions
diff --git a/docs/ref/rst/directives.txt b/docs/ref/rst/directives.txt index cc2d47ca7..7d139b9a1 100644 --- a/docs/ref/rst/directives.txt +++ b/docs/ref/rst/directives.txt @@ -484,8 +484,9 @@ Code The "code" directive constructs a literal block. If the code language is specified, the content is parsed by the Pygments_ syntax highlighter and tokens are stored in nested `inline elements`_ with class arguments -according to their syntactic category. The actual highlighting can be -customized with a style-sheet (e.g. one `generated by Pygments`__). +according to their syntactic category. The actual highlighting requires +a style-sheet (e.g. one `generated by Pygments`__, see the +`sandbox/stylesheets`_ for examples). The parsing can be turned off with the syntax_highlight_ configuration setting and command line option or by specifying the language as `:class:`_ @@ -495,7 +496,8 @@ when Pygments_ is not installed or the language is not in the For inline code, use the `"code" role`_. -__ http://pygments.org/docs/cmdline/#generating-styles +__ http://pygments.org/docs/cmdline/#generating-styles +__ http://docutils.sourceforge.net/sandbox/stylesheets/ .. _Pygments: http://pygments.org/ .. _syntax_highlight: ../../user/config.html#syntax-highlight .. _supported languages and markup formats: http://pygments.org/languages/ |