git.iko.soy/typeable/pandoc
on master help sign in
Add generic `attributes` extension.

This allows attributes to be added to any block or inline element, in principle. (Though in many cases this will be done by adding a Div or Span container, since pandoc's AST doesn't have a slot for attributes for most elements.) Currently this is only possible with the commonmark and gfm readers. Add `Ext_attributes` constructor for `Extension` [API change].

commitfdcbe4b39b54c22610277834f2e9b711e5b5ef1d authorJohn MacFarlane <jgm@berkeley.edu> dateSun 26 Apr 2020, 15:39 (6 years ago) parent610a16a
3 files changed+34−8
compare with master
unifiedsplit
MANUAL.txt+31 src/Text/Pandoc/Extensions.hs+2−4 src/Text/Pandoc/Readers/CommonMark.hs+1−4
MANUAL.txt+31
@@ -4935,6 +4935,37 @@ in pandoc, but may be enabled by adding `+EXTENSION` to the format
49354935name, where `EXTENSION` is the name of the extension. Thus, for
49364936example, `markdown+hard_line_breaks` is Markdown with hard line breaks.
49374937
4938+#### Extension: `attributes` ####
4939+
4940+Allows attributes to be attached to any inline or block-level
4941+element. The syntax for the attributes is the same as that
4942+used in [`header_attributes`][Extension: `header_attributes`].
4943+
4944+- Attributes that occur immediately after an inline
4945+ element affect that element. If they follow a space, then they
4946+ belong to the space. (Hence, this option subsumes
4947+ `inline_code_attributes` and `link_attributes`.)
4948+- Attributes that occur immediately before a block
4949+ element, on a line by themselves, affect that
4950+ element.
4951+- Consecutive attribute specifiers may be used,
4952+ either for blocks or for inlines. Their attributes
4953+ will be combined.
4954+- Attributes that occur at the end of the text of
4955+ a Setext or ATX heading (separated by whitespace
4956+ from the text) affect the heading element. (Hence, this
4957+ option subsumes `header_attributes`.)
4958+- Attributes that occur after the opening fence
4959+ in a fenced code block affect the code block element. (Hence,
4960+ this option subsumes `fenced_code_attributes`.)
4961+- Attributes that occur at the end of a reference
4962+ link definition affect links that refer to that
4963+ definition.
4964+
4965+Note that pandoc's AST does not currently allow attributes
4966+to be attached to arbitrary elements. Hence a Span or Div
4967+container will be added if needed.
4968+
49384969#### Extension: `old_dashes` ####
49394970
49404971Selects the pandoc <= 1.8.2.1 behavior for parsing smart dashes:
src/Text/Pandoc/Extensions.hs+2−4
@@ -150,6 +150,7 @@ data Extension =
150150 | Ext_tex_math_single_backslash -- ^ TeX math btw \(..\) \[..\]
151151 | Ext_yaml_metadata_block -- ^ YAML metadata block
152152 | Ext_gutenberg -- ^ Use Project Gutenberg conventions for plain
153+ | Ext_attributes -- ^ Generic attribute syntax
153154 deriving (Show, Read, Enum, Eq, Ord, Bounded, Data, Typeable, Generic)
154155
155156-- | Extensions to be used with pandoc-flavored markdown.
@@ -447,11 +448,8 @@ getAllExtensions f = universalExtensions <> getAll f
447448 , Ext_fenced_divs
448449 , Ext_bracketed_spans
449450 , Ext_raw_attribute
450− , Ext_inline_code_attributes
451− , Ext_fenced_code_attributes
452− , Ext_link_attributes
453− , Ext_header_attributes
454451 , Ext_implicit_header_references
452+ , Ext_attributes
455453 ]
456454 getAll "commonmark" = getAll "gfm"
457455 getAll "org" = autoIdExtensions <>
src/Text/Pandoc/Readers/CommonMark.hs+1−4
@@ -48,10 +48,7 @@ readCommonMark opts s = do
4848 [ fencedDivSpec | isEnabled Ext_fenced_divs opts ] ++
4949 [ bracketedSpanSpec | isEnabled Ext_bracketed_spans opts ] ++
5050 [ rawAttributeSpec | isEnabled Ext_raw_attribute opts ] ++
51− [ attributesSpec | isEnabled Ext_link_attributes opts ||
52− isEnabled Ext_inline_code_attributes opts ||
53− isEnabled Ext_fenced_code_attributes opts ||
54− isEnabled Ext_header_attributes opts ] ++
51+ [ attributesSpec | isEnabled Ext_attributes opts ] ++
5552 [ pipeTableSpec | isEnabled Ext_pipe_tables opts ] ++
5653 [ autolinkSpec | isEnabled Ext_autolink_bare_uris opts ] ++
5754 [ emojiSpec | isEnabled Ext_emoji opts ] ++