From 1144e2a94cf3f78dedda0b88649ce789fb8d1edf Mon Sep 17 00:00:00 2001 From: Waylan Limberg Date: Sun, 16 Feb 2014 14:41:13 -0500 Subject: Cleaned up some minor issues with recent changes to docs. --- docs/extensions/code_hilite.txt | 21 +++++++++++---------- 1 file changed, 11 insertions(+), 10 deletions(-) (limited to 'docs/extensions/code_hilite.txt') diff --git a/docs/extensions/code_hilite.txt b/docs/extensions/code_hilite.txt index 2cdb123..f0648e1 100644 --- a/docs/extensions/code_hilite.txt +++ b/docs/extensions/code_hilite.txt @@ -32,7 +32,8 @@ language. When that fails, the code block will display as un-highlighted code. !!! Note The css and/or javascript is not included as part of this extension - but shall always be provided by the end user. + 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 ------ @@ -90,9 +91,9 @@ Will result in: # Code goes here ... -Certain lines can be selected for emphasis with the colon syntax. By -default, emphasized lines have a yellow background. This is useful to -direct the reader's attention. +Certain lines can be selected for emphasis with the colon syntax. When +using Pygments' default css styles, emphasized lines have a yellow background. +This is useful to direct the reader's attention to specific lines. :::python hl_lines="1 3" # This line is emphasized @@ -135,7 +136,7 @@ configuring extensions. The following options are provided to configure the output: -* **linenums**: +* **`linenums`**: Use line numbers. Possible values are `True` for yes, `False` for no and `None` for auto. Defaults to `None`. @@ -145,22 +146,22 @@ The following options are provided to configure the output: Using `False` will turn off all line numbers, even when using SheBangs (`#!`) for language identification. -* **guess_lang**: +* **`guess_lang`**: Automatic language detection. Defaults to `True`. Using `False` will prevent Pygments from guessing the language, and thus highlighting blocks only when you explicitly set the language. -* **css_class**: +* **`css_class`**: Set CSS class name for the wrapper `
` tag. Defaults to `codehilite`. -* **pygments_style**: +* **`pygments_style`**: Pygments HTML Formatter Style (ColorScheme). Defaults to `default`. !!! Note This is useful only when `noclasses` is set to `True`, otherwise the - CSS style shall be provided by the end user. + CSS styles must be provided by the end user. -* **noclasses**: +* **`noclasses`**: Use inline styles instead of CSS classes. Defaults to `False`. -- cgit v1.2.3