aboutsummaryrefslogtreecommitdiffstats
path: root/docs/extensions
diff options
context:
space:
mode:
authorWaylan Limberg <waylan.limberg@icloud.com>2016-06-06 10:47:39 -0400
committerWaylan Limberg <waylan.limberg@icloud.com>2016-06-06 10:47:39 -0400
commit4bf178ed08f3bec2cc37e16ee528d572fe1fb60b (patch)
treea4d0138b70fb81189ed41d102a9fbc81d4f2696d /docs/extensions
parentdf340160e8ab1de914b3c97a730fc9a1a6dea158 (diff)
parentffaa91d202a95294c6d2a3069ff1f4c3da25f410 (diff)
downloadmarkdown-4bf178ed08f3bec2cc37e16ee528d572fe1fb60b.tar.gz
markdown-4bf178ed08f3bec2cc37e16ee528d572fe1fb60b.tar.bz2
markdown-4bf178ed08f3bec2cc37e16ee528d572fe1fb60b.zip
Merge pull request #480 from krother/patch-1
edited setup docs for CodeHilite with Pygments
Diffstat (limited to 'docs/extensions')
-rw-r--r--docs/extensions/code_hilite.txt23
1 files changed, 15 insertions, 8 deletions
diff --git a/docs/extensions/code_hilite.txt b/docs/extensions/code_hilite.txt
index 5e802b8..575ee48 100644
--- a/docs/extensions/code_hilite.txt
+++ b/docs/extensions/code_hilite.txt
@@ -20,20 +20,27 @@ This extension is included in the standard Markdown library.
Setup
-----
+### Step 1: download and install Pygments ###
+
You will also need to [download][dl] and install the Pygments package on your
-`PYTHONPATH`. You will need to determine the appropriate CSS classes and create
-appropriate rules for them, which are either defined in or linked from the
-header of your HTML templates. See the excellent [documentation][] for more
+`PYTHONPATH`. The CodeHilite extension will produce HTML output without Pygments,
+but it won't highlight anything.
+
+[dl]: http://pygments.org/download/
+
+### Step 2: add CSS classes ###
+
+You will need to determine the appropriate CSS classes and/or JavaScript with
+appropriate rules. The CSS classes either need to be defined in or linked from
+the header of your HTML templates. Ready-made [CSS files for Python][rich] are available.
+
+See the excellent [documentation][] for more
details. If no language is defined, Pygments will attempt to guess the
language. When that fails, the code block will not be highlighted.
-[dl]: http://pygments.org/download/
+[rich]: https://github.com/richleland/pygments-css
[documentation]: http://pygments.org/docs
-!!! Note
- The CSS and/or JavaScript is not included as part of this extension
- but must be provided by the end user. The Pygments project provides
- default CSS styles which you may find to be a useful starting point.
Syntax
------