hugo/docs/content/en/readfiles/bfconfig.md
2019-03-04 11:27:18 +01:00

8.4 KiB
Raw Blame History

Blackfriday Options

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. If true, it may be fine-tuned with the angledQuotes, fractions, smartDashes, and latexDashes flags (see below).
smartypantsQuotesNBSP
default: false
Blackfriday flag: HTML_SMARTYPANTS_QUOTES_NBSP
Purpose: true enables French style Guillemets with non-breaking space inside the quotes.
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 512(<sup>5</sup>&frasl;<sub>12</sub>).
Caveat: Even with fractions = false, Blackfriday still converts 1/2, 1/4, and 3/4 respectively to ½ (&frac12;), ¼ (&frac14;) and ¾ (&frac34;), 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. If true, its behavior can be modified with the latexDashes flag below.
latexDashes
default: true
Blackfriday flag: HTML_SMARTYPANTS_LATEX_DASHES
Purpose: false disables LaTeX-style smart dashes and selects conventional smart dashes. Assuming smartDashes:
If true, -- is translated into (&ndash;), whereas --- is translated into — (&mdash;).
However, spaced single hyphen between two words is translated into an en dash— e.g., "12 June - 3 July" becomes 12 June &ndash; 3 July upon rendering.
hrefTargetBlank
default: false
Blackfriday flag: HTML_HREF_TARGET_BLANK
Purpose: true opens external links absolute links in a new window or tab. While the target="_blank" attribute is typically used for external links, Blackfriday does that for all absolute links (ref). One needs to make note of this if they use absolute links throughout, for internal links too (for example, by setting canonifyURLs to true or via absURL).
nofollowLinks
default: false
Blackfriday flag: HTML_NOFOLLOW_LINKS
Purpose: true creates external links absolute links with nofollow being added to their rel attribute. Thereby crawlers are advised to not follow the link. While the rel="nofollow" attribute is typically used for external links, Blackfriday does that for all absolute links. One needs to make note of this if they use absolute links throughout, for internal links too (for example, by setting canonifyURLs to true or via absURL).
noreferrerLinks
default: false
Blackfriday flag: HTML_NOREFERRER_LINKS
Purpose: true creates external links absolute links with noreferrer being added to their rel attribute. Thus when following the link no referrer information will be leaked. While the rel="noreferrer" attribute is typically used for external links, Blackfriday does that for all absolute links. One needs to make note of this if they use absolute links throughout, for internal links too (for example, by setting canonifyURLs to true or via absURL).
plainIDAnchors
default true
Blackfriday flag: FootnoteAnchorPrefix and HeaderIDSuffix
Purpose: true renders any heading and footnote IDs without the document ID.
Example: renders #my-heading instead of #my-heading:bec3ed8ba720b970
extensions
default: []
Purpose: Enable one or more Blackfriday's Markdown extensions (EXTENSION_*).
Example: Include hardLineBreak in the list to enable Blackfriday's EXTENSION_HARD_LINE_BREAK.
See Blackfriday extensions section for information on all extensions.
extensionsmask
default: []
Purpose: Disable one or more of Blackfriday's Markdown extensions (EXTENSION_*).
Example: Include autoHeaderIds as false in the list to disable Blackfriday's EXTENSION_AUTO_HEADER_IDS.
See Blackfriday extensions section for information on all extensions.
skipHTML
default: false
Blackfriday flag: HTML_SKIP_HTML
Purpose: true causes any HTML in the markdown files to be skipped.

Blackfriday extensions

noIntraEmphasis
default: enabled
Purpose: The "_" character is commonly used inside words when discussing code, so having Markdown interpret it as an emphasis command is usually the wrong thing. When enabled, Blackfriday lets you treat all emphasis markers as normal characters when they occur inside a word.
tables
default: enabled
Purpose: When enabled, tables can be created by drawing them in the input using the below syntax: Example:
     Name | Age
  --------|------
      Bob | 27
    Alice | 23
fencedCode
default: enabled
Purpose: When enabled, in addition to the normal 4-space indentation to mark code blocks, you can explicitly mark them and supply a language (to make syntax highlighting simple).

You can use 3 or more backticks to mark the beginning of the block, and the same number to mark the end of the block.

Example:

   ```md
  # Heading Level 1
  Some test
  ## Heading Level 2
  Some more test
  ```
autolink
default: enabled
Purpose: When enabled, URLs that have not been explicitly marked as links will be converted into links.
strikethrough
default: enabled
Purpose: When enabled, text wrapped with two tildes will be crossed out.
Example: ~~crossed-out~~
laxHtmlBlocks
default: disabled
Purpose: When enabled, loosen up HTML block parsing rules.
spaceHeaders
default: enabled
Purpose: When enabled, be strict about prefix header rules.
hardLineBreak
default: disabled
Purpose: When enabled, newlines in the input translate into line breaks in the output.
tabSizeEight
default: disabled
Purpose: When enabled, expand tabs to eight spaces instead of four.
footnotes
default: enabled
Purpose: When enabled, Pandoc-style footnotes will be supported. The footnote marker in the text that will become a superscript text; the footnote definition will be placed in a list of footnotes at the end of the document.
Example:
  This is a footnote.[^1]

  [^1]: the footnote text.
noEmptyLineBeforeBlock
default: disabled
Purpose: When enabled, no need to insert an empty line to start a (code, quote, ordered list, unordered list) block.
headerIds
default: enabled
Purpose: When enabled, allow specifying header IDs with {#id}.
titleblock
default: disabled
Purpose: When enabled, support Pandoc-style title blocks.
autoHeaderIds
default: enabled
Purpose: When enabled, auto-create the header ID's from the headline text.
backslashLineBreak
default: enabled
Purpose: When enabled, translate trailing backslashes into line breaks.
definitionLists
default: enabled
Purpose: When enabled, a simple definition list is made of a single-line term followed by a colon and the definition for that term.
Example:
  Cat
  : Fluffy animal everyone likes

  Internet
  : Vector of transmission for pictures of cats

Terms must be separated from the previous definition by a blank line.

joinLines
default: enabled
Purpose: When enabled, delete newlines and join the lines.