summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authormilde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04>2013-03-27 16:54:05 +0000
committermilde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04>2013-03-27 16:54:05 +0000
commit2548d2c0e4bc1f88dac29091a211c23c31b9b8bd (patch)
tree0937d4ca6921c8987be0f321015beb1cbf5aba18
parent8fd783f28caeb22b63d6130b64b05b82c8a1e5e8 (diff)
downloaddocutils-2548d2c0e4bc1f88dac29091a211c23c31b9b8bd.tar.gz
Syntax highlight requires a stylesheet.
git-svn-id: http://svn.code.sf.net/p/docutils/code/trunk/docutils@7643 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
-rw-r--r--docs/ref/rst/directives.txt8
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/