From e9ca508e8e54e62d909a2c6737a87983a6e641e5 Mon Sep 17 00:00:00 2001 From: Justin Mayer Date: Mon, 6 May 2013 07:28:25 -0700 Subject: [PATCH] Add more detail to Pygments FAQ entry. Fixes #821 --- docs/faq.rst | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/docs/faq.rst b/docs/faq.rst index f8bc2dca..a8043e07 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -48,8 +48,17 @@ Pygments adds some classes to the generated content. These classes are used by themes to style code syntax highlighting via CSS. Specifically, you can customize the appearance of your syntax highlighting via the ``.highlight pre`` class in your theme's CSS file. To see how various styles can be used to render -Django code, for example, you can use the demo `on the project website -`_. +Django code, for example, use the style selector drop-down at top-right on the +`Pygments project demo site `_. + +You can use the following example commands to generate a starting CSS file from +a Pygments built-in style (in this case, "monokai") and then copy the generated +CSS file to your new theme:: + + pygmentize -S monokai -f html -a .highlight > pygment.css + cp pygment.css path/to/theme/static/css/ + +Don't forget to import your ``pygment.css`` file from your main CSS file. How do I create my own theme? ==============================