mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-14 20:37:55 -05:00
3 KiB
3 KiB
taskLists
- default:
true
Blackfriday flag:
Purpose:false
turns off GitHub-style automatic task/TODO list generation smartypants
- default:
true
Blackfriday flag:HTML_USE_SMARTYPANTS
Purpose:false
disables smart punctuation substitutions, including smart quotes, smart dashes, smart fractions, etc. Iftrue
, it may be fine-tuned with theangledQuotes
,fractions
,smartDashes
, andlatexDashes
flags (see below). angledQuotes
- default:
false
Blackfriday flag:HTML_SMARTYPANTS_ANGLED_QUOTES
Purpose:true
enables smart, angled double quotes. Example: "Hugo" renders to «Hugo» instead of “Hugo”. fractions
- default:
true
Blackfriday flag:HTML_SMARTYPANTS_FRACTIONS
Purpose:false
disables smart fractions.
Example:5/12
renders to 5⁄12(<sup>5</sup>⁄<sub>12</sub>
).
Caveat: Even withfractions = false
, Blackfriday still converts1/2
,1/4
, and3/4
respectively to ½ (½
), ¼ (¼
) and ¾ (¾
), but only these three. smartDashes
- default:
true
Blackfriday flag:HTML_SMARTY_DASHES
Purpose:false
disables smart dashes; i.e., the conversion of multiple hyphens into an en dash or em dash. Iftrue
, its behavior can be modified with thelatexDashes
flag below. latexDashes
- default:
true
Blackfriday flag:HTML_SMARTYPANTS_LATEX_DASHES
Purpose:false
disables LaTeX-style smart dashes and selects conventional smart dashes. AssumingsmartDashes
:
Iftrue
,--
is translated into – (–
), whereas---
is translated into — (—
).
However, spaced single hyphen between two words is translated into an en dash— e.g., "12 June - 3 July
" becomes12 June ndash; 3 July
upon rendering. hrefTargetBlank
- default:
false
Blackfriday flag:HTML_HREF_TARGET_BLANK
Purpose:true
opens external links in a new window or tab. plainIDAnchors
- default
true
Blackfriday flag:FootnoteAnchorPrefix
andHeaderIDSuffix
Purpose:true
renders any heading and footnote IDs without the document ID.
Example: renders#my-heading
instead of#my-heading:bec3ed8ba720b970
extensions
- default:
[]
Blackfriday flag:EXTENSION_*
Purpose: Enable one or more Blackfriday's Markdown extensions (if they aren't Hugo defaults).
Example: IncludehardLineBreak
in the list to enable Blackfriday'sEXTENSION_HARD_LINK_BREAK
extensionsmask
- default:
[]
Blackfriday flag:EXTENSION_*
Purpose: Enable one or more of Blackfriday's Markdown extensions (if they aren't Hugo defaults).
Example: IncludeautoHeaderIds
asfalse
in the list to disable Blackfriday'sEXTENSION_AUTO_HEADER_IDS
.