pandoc-1.16.0.2: Conversion between markup formats

Copyright | Copyright (C) 2012-2015 John MacFarlane
License | GNU GPL, version 2 or above
Maintainer | John MacFarlane <jgm@berkeley.edu>
Stability | alpha
Portability | portable
Safe Haskell | None
Language | Haskell98

Text.Pandoc.Options

Description

Data structures and functions for representing parser and writer options.

Synopsis

- data Extension
  - = Ext_footnotes
  - | Ext_inline_notes
  - | Ext_pandoc_title_block
  - | Ext_yaml_metadata_block
  - | Ext_mmd_title_block
  - | Ext_table_captions
  - | Ext_implicit_figures
  - | Ext_simple_tables
  - | Ext_multiline_tables
  - | Ext_grid_tables
  - | Ext_pipe_tables
  - | Ext_citations
  - | Ext_raw_tex
  - | Ext_raw_html
  - | Ext_tex_math_dollars
  - | Ext_tex_math_single_backslash
  - | Ext_tex_math_double_backslash
  - | Ext_latex_macros
  - | Ext_fenced_code_blocks
  - | Ext_fenced_code_attributes
  - | Ext_backtick_code_blocks
  - | Ext_inline_code_attributes
  - | Ext_markdown_in_html_blocks
  - | Ext_native_divs
  - | Ext_native_spans
  - | Ext_markdown_attribute
  - | Ext_escaped_line_breaks
  - | Ext_link_attributes
  - | Ext_mmd_link_attributes
  - | Ext_autolink_bare_uris
  - | Ext_fancy_lists
  - | Ext_lists_without_preceding_blankline
  - | Ext_startnum
  - | Ext_definition_lists
  - | Ext_compact_definition_lists
  - | Ext_example_lists
  - | Ext_all_symbols_escapable
  - | Ext_intraword_underscores
  - | Ext_blank_before_blockquote
  - | Ext_blank_before_header
  - | Ext_strikeout
  - | Ext_superscript
  - | Ext_subscript
  - | Ext_hard_line_breaks
  - | Ext_ignore_line_breaks
  - | Ext_east_asian_line_breaks
  - | Ext_literate_haskell
  - | Ext_abbreviations
  - | Ext_emoji
  - | Ext_auto_identifiers
  - | Ext_ascii_identifiers
  - | Ext_header_attributes
  - | Ext_mmd_header_identifiers
  - | Ext_implicit_header_references
  - | Ext_line_blocks
  - | Ext_epub_html_exts
  - | Ext_shortcut_reference_links
- pandocExtensions :: Set Extension
- plainExtensions :: Set Extension
- strictExtensions :: Set Extension
- phpMarkdownExtraExtensions :: Set Extension
- githubMarkdownExtensions :: Set Extension
- multimarkdownExtensions :: Set Extension
- data ReaderOptions = ReaderOptions {
  - readerExtensions :: Set Extension
  - readerSmart :: Bool
  - readerStandalone :: Bool
  - readerParseRaw :: Bool
  - readerColumns :: Int
  - readerTabStop :: Int
  - readerOldDashes :: Bool
  - readerApplyMacros :: Bool
  - readerIndentedCodeClasses :: [String]
  - readerDefaultImageExtension :: String
  - readerTrace :: Bool
  - readerTrackChanges :: TrackChanges
  }
- data HTMLMathMethod
  - = PlainMath
  - | LaTeXMathML String
  - | JsMath (Maybe String)
  - | GladTeX
  - | WebTeX String
  - | MathML (Maybe String)
  - | MathJax String
  - | KaTeX String String
- data CiteMethod
  - = Citeproc
  - | Natbib
  - | Biblatex
- data ObfuscationMethod
  - = NoObfuscation
  - | ReferenceObfuscation
  - | JavascriptObfuscation
- data HTMLSlideVariant
  - = S5Slides
  - | SlidySlides
  - | SlideousSlides
  - | DZSlides
  - | RevealJsSlides
  - | NoSlides
- data EPUBVersion
  - = EPUB2
  - | EPUB3
- data WrapOption
  - = WrapAuto
  - | WrapNone
  - | WrapPreserve
- data WriterOptions = WriterOptions {
  - writerStandalone :: Bool
  - writerTemplate :: String
  - writerVariables :: [(String, String)]
  - writerTabStop :: Int
  - writerTableOfContents :: Bool
  - writerSlideVariant :: HTMLSlideVariant
  - writerIncremental :: Bool
  - writerHTMLMathMethod :: HTMLMathMethod
  - writerIgnoreNotes :: Bool
  - writerNumberSections :: Bool
  - writerNumberOffset :: [Int]
  - writerSectionDivs :: Bool
  - writerExtensions :: Set Extension
  - writerReferenceLinks :: Bool
  - writerDpi :: Int
  - writerWrapText :: WrapOption
  - writerColumns :: Int
  - writerEmailObfuscation :: ObfuscationMethod
  - writerIdentifierPrefix :: String
  - writerSourceURL :: Maybe String
  - writerUserDataDir :: Maybe FilePath
  - writerCiteMethod :: CiteMethod
  - writerHtml5 :: Bool
  - writerHtmlQTags :: Bool
  - writerBeamer :: Bool
  - writerSlideLevel :: Maybe Int
  - writerChapters :: Bool
  - writerListings :: Bool
  - writerHighlight :: Bool
  - writerHighlightStyle :: Style
  - writerSetextHeaders :: Bool
  - writerTeXLigatures :: Bool
  - writerEpubVersion :: Maybe EPUBVersion
  - writerEpubMetadata :: String
  - writerEpubStylesheet :: Maybe String
  - writerEpubFonts :: [FilePath]
  - writerEpubChapterLevel :: Int
  - writerTOCDepth :: Int
  - writerReferenceODT :: Maybe FilePath
  - writerReferenceDocx :: Maybe FilePath
  - writerMediaBag :: MediaBag
  - writerVerbose :: Bool
  - writerLaTeXArgs :: [String]
  }
- data TrackChanges
  - = AcceptChanges
  - | RejectChanges
  - | AllChanges
- def :: Default a => a
- isEnabled :: Extension -> WriterOptions -> Bool

# Documentation

data Extension Source

Individually selectable syntax extensions.

Constructors

Ext_footnotes | PandocPHPMMD style footnotes
Ext_inline_notes | Pandoc-style inline notes
Ext_pandoc_title_block | Pandoc title block
Ext_yaml_metadata_block | YAML metadata block
Ext_mmd_title_block | Multimarkdown metadata block
Ext_table_captions | Pandoc-style table captions
Ext_implicit_figures | A paragraph with just an image is a figure
Ext_simple_tables | Pandoc-style simple tables
Ext_multiline_tables | Pandoc-style multiline tables
Ext_grid_tables | Grid tables (pandoc, reST)
Ext_pipe_tables | Pipe tables (as in PHP markdown extra)
Ext_citations | Pandoc/citeproc citations
Ext_raw_tex | Allow raw TeX (other than math)
Ext_raw_html | Allow raw HTML
Ext_tex_math_dollars | TeX math between $..$ or $$..$$
Ext_tex_math_single_backslash | TeX math btw (..) [..]
Ext_tex_math_double_backslash | TeX math btw \(..\) \[..\]
Ext_latex_macros | Parse LaTeX macro definitions (for math only)
Ext_fenced_code_blocks | Parse fenced code blocks
Ext_fenced_code_attributes | Allow attributes on fenced code blocks
Ext_backtick_code_blocks | GitHub style ``` code blocks
Ext_inline_code_attributes | Allow attributes on inline code
Ext_markdown_in_html_blocks | Interpret as markdown inside HTML blocks
Ext_native_divs | Use Div blocks for contents of div tags
Ext_native_spans | Use Span inlines for contents of span
Ext_markdown_attribute | Interpret text inside HTML as markdown iff container has attribute `markdown`
Ext_escaped_line_breaks | Treat a backslash at EOL as linebreak
Ext_link_attributes | link and image attributes
Ext_mmd_link_attributes | MMD style reference link attributes
Ext_autolink_bare_uris | Make all absolute URIs into links
Ext_fancy_lists | Enable fancy list numbers and delimiters
Ext_lists_without_preceding_blankline | Allow lists without preceding blank
Ext_startnum | Make start number of ordered list significant
Ext_definition_lists | Definition lists as in pandoc, mmd, php
Ext_compact_definition_lists | Definition lists without space between items, and disallow laziness
Ext_example_lists | Markdown-style numbered examples
Ext_all_symbols_escapable | Make all non-alphanumerics escapable
Ext_intraword_underscores | Treat underscore inside word as literal
Ext_blank_before_blockquote | Require blank line before a blockquote
Ext_blank_before_header | Require blank line before a header
Ext_strikeout | Strikeout using ~~this~~ syntax
Ext_superscript | Superscript using ^this^ syntax
Ext_subscript | Subscript using ~this~ syntax
Ext_hard_line_breaks | All newlines become hard line breaks
Ext_ignore_line_breaks | Newlines in paragraphs are ignored
Ext_east_asian_line_breaks | Newlines in paragraphs are ignored between East Asian wide characters
Ext_literate_haskell | Enable literate Haskell conventions
Ext_abbreviations | PHP markdown extra abbreviation definitions
Ext_emoji | Support emoji like :smile:
Ext_auto_identifiers | Automatic identifiers for headers
Ext_ascii_identifiers | ascii-only identifiers for headers
Ext_header_attributes | Explicit header attributes {#id .class k=v}
Ext_mmd_header_identifiers | Multimarkdown style header identifiers [myid]
Ext_implicit_header_references | Implicit reference links for headers
Ext_line_blocks | RST style line blocks
Ext_epub_html_exts | Recognise the EPUB extended version of HTML
Ext_shortcut_reference_links | Shortcut reference links

Instances

Bounded Extension Source |
Enum Extension Source |
Eq Extension Source |
Data Extension Source |
Ord Extension Source |
Read Extension Source |
Show Extension Source |
Generic Extension Source |
type Rep Extension Source |

pandocExtensions :: Set Extension Source

plainExtensions :: Set Extension Source

strictExtensions :: Set Extension Source

phpMarkdownExtraExtensions :: Set Extension Source

githubMarkdownExtensions :: Set Extension Source

multimarkdownExtensions :: Set Extension Source

data ReaderOptions Source

Constructors

ReaderOptions |

Fields

readerExtensions :: Set Extension

  Syntax extensions

readerSmart :: Bool

  Smart punctuation

readerStandalone :: Bool

  Standalone document with header

readerParseRaw :: Bool

  Parse raw HTML, LaTeX

readerColumns :: Int

  Number of columns in terminal

readerTabStop :: Int

  Tab stop

readerOldDashes :: Bool

  Use pandoc <= 1.8.2.1 behavior in parsing dashes; -- is em-dash; - before numerial is en-dash

readerApplyMacros :: Bool

  Apply macros to TeX math

readerIndentedCodeClasses :: [String]

  Default classes for indented code blocks

readerDefaultImageExtension :: String

  Default extension for images

readerTrace :: Bool

  Print debugging info

readerTrackChanges :: TrackChanges

Instances

Data ReaderOptions Source |
Read ReaderOptions Source |
Show ReaderOptions Source |
Generic ReaderOptions Source |
Default ReaderOptions Source |
type Rep ReaderOptions Source |

data HTMLMathMethod Source

Constructors

PlainMath |
LaTeXMathML String |
JsMath (Maybe String) |
GladTeX |
WebTeX String |
MathML (Maybe String) |
MathJax String |
KaTeX String String |

Instances

Eq HTMLMathMethod Source |
Data HTMLMathMethod Source |
Read HTMLMathMethod Source |
Show HTMLMathMethod Source |
Generic HTMLMathMethod Source |
type Rep HTMLMathMethod Source |

data CiteMethod Source

Constructors

Citeproc |
Natbib |
Biblatex |

Instances

Eq CiteMethod Source |
Data CiteMethod Source |
Read CiteMethod Source |
Show CiteMethod Source |
Generic CiteMethod Source |
type Rep CiteMethod Source |

data ObfuscationMethod Source

Methods for obfuscating email addresses in HTML.

Constructors

NoObfuscation |
ReferenceObfuscation |
JavascriptObfuscation |

Instances

Eq ObfuscationMethod Source |
Data ObfuscationMethod Source |
Read ObfuscationMethod Source |
Show ObfuscationMethod Source |
Generic ObfuscationMethod Source |
type Rep ObfuscationMethod Source |

data HTMLSlideVariant Source

Varieties of HTML slide shows.

Constructors

S5Slides |
SlidySlides |
SlideousSlides |
DZSlides |
RevealJsSlides |
NoSlides |

Instances

Eq HTMLSlideVariant Source |
Data HTMLSlideVariant Source |
Read HTMLSlideVariant Source |
Show HTMLSlideVariant Source |
Generic HTMLSlideVariant Source |
type Rep HTMLSlideVariant Source |

data EPUBVersion Source

Constructors

EPUB2 |
EPUB3 |

Instances

Eq EPUBVersion Source |
Data EPUBVersion Source |
Read EPUBVersion Source |
Show EPUBVersion Source |
Generic EPUBVersion Source |
type Rep EPUBVersion Source |

data WrapOption Source

Options for wrapping text in the output.

Constructors

WrapAuto | Automatically wrap to width
WrapNone | No non-semantic newlines
WrapPreserve | Preserve wrapping of input source

Instances

Eq WrapOption Source |
Data WrapOption Source |
Read WrapOption Source |
Show WrapOption Source |
Generic WrapOption Source |
type Rep WrapOption Source |

data WriterOptions Source

Options for writers

Constructors

WriterOptions |

Fields

writerStandalone :: Bool

  Include header and footer

writerTemplate :: String

  Template to use in standalone mode

writerVariables :: [(String, String)]

  Variables to set in template

writerTabStop :: Int

  Tabstop for conversion btw spaces and tabs

writerTableOfContents :: Bool

  Include table of contents

writerSlideVariant :: HTMLSlideVariant

  Are we writing S5, Slidy or Slideous?

writerIncremental :: Bool

  True if lists should be incremental

writerHTMLMathMethod :: HTMLMathMethod

  How to print math in HTML

writerIgnoreNotes :: Bool

  Ignore footnotes (used in making toc)

writerNumberSections :: Bool

  Number sections in LaTeX

writerNumberOffset :: [Int]

  Starting number for section, subsection, ...

writerSectionDivs :: Bool

  Put sections in div tags in HTML

writerExtensions :: Set Extension

  Markdown extensions that can be used

writerReferenceLinks :: Bool

  Use reference links in writing markdown, rst

writerDpi :: Int

  Dpi for pixel tofrom inchcm conversions

writerWrapText :: WrapOption

  Option for wrapping text

writerColumns :: Int

  Characters in a line (for text wrapping)

writerEmailObfuscation :: ObfuscationMethod

  How to obfuscate emails

writerIdentifierPrefix :: String

  Prefix for section & note ids in HTML and for footnote marks in markdown

writerSourceURL :: Maybe String

  Absolute URL + directory of 1st source file

writerUserDataDir :: Maybe FilePath

  Path of user data directory

writerCiteMethod :: CiteMethod

  How to print cites

writerHtml5 :: Bool

  Produce HTML5

writerHtmlQTags :: Bool

  Use `q` tags for quotes in HTML

writerBeamer :: Bool

  Produce beamer LaTeX slide show

writerSlideLevel :: Maybe Int

  Force header level of slides

writerChapters :: Bool

  Use "chapter" for top-level sects

writerListings :: Bool

  Use listings package for code

writerHighlight :: Bool

  Highlight source code

writerHighlightStyle :: Style

  Style to use for highlighting

writerSetextHeaders :: Bool

  Use setext headers for levels 1-2 in markdown

writerTeXLigatures :: Bool

  Use tex ligatures quotes, dashes in latex

writerEpubVersion :: Maybe EPUBVersion

  Nothing or EPUB version

writerEpubMetadata :: String

  Metadata to include in EPUB

writerEpubStylesheet :: Maybe String

  EPUB stylesheet specified at command line

writerEpubFonts :: [FilePath]

  Paths to fonts to embed

writerEpubChapterLevel :: Int

  Header level for chapters (separate files)

writerTOCDepth :: Int

  Number of levels to include in TOC

writerReferenceODT :: Maybe FilePath

  Path to reference ODT if specified

writerReferenceDocx :: Maybe FilePath

  Path to reference DOCX if specified

writerMediaBag :: MediaBag

  Media collected by docx or epub reader

writerVerbose :: Bool

  Verbose debugging output

writerLaTeXArgs :: [String]

  Flags to pass to latex-engine

Instances

Data WriterOptions Source |
Show WriterOptions Source |
Generic WriterOptions Source |
Default WriterOptions Source |
type Rep WriterOptions Source |

data TrackChanges Source

Options for accepting or rejecting MS Word track-changes.

Constructors

AcceptChanges |
RejectChanges |
AllChanges |

Instances

Eq TrackChanges Source |
Data TrackChanges Source |
Read TrackChanges Source |
Show TrackChanges Source |
Generic TrackChanges Source |
type Rep TrackChanges Source |

def :: Default a => a

isEnabled :: Extension -> WriterOptions -> Bool Source

Returns True if the given extension is enabled.