Re: FIguring out pandoc AST and types

["'Daniel Gnoutcheff' via pandoc-discuss" <pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org>]

On 9/17/21 12:18 AM, Harsh Donga wrote:
> Sorry to bother you,
> 
> I could read in the documentation that Attr stores (identifier, classes, 
> key-value pairs)
> What do these actually mean? can you share an example?

The AST corresponds closely to Pandoc's Markdown dialect, so a good way 
to learn about an AST type is to study the User's Manual sections that 
document the corresponding Markdown features.  You may have noticed that 
the Attr type is used by the Header, CodeBlock, Div, Code, Link, Image, 
and Span data constructors.  In Pandoc's Markdown, headings, code 
blocks, div blocks, code inlines, links, images, and spans all can have 
"attributes".  The relevant manual sections discuss their syntax and how 
they are used (or ignored) by writers:

- <https://pandoc.org/MANUAL.html#extension-header_attributes>
- <https://pandoc.org/MANUAL.html#extension-fenced_code_attributes>
- <https://pandoc.org/MANUAL.html#extension-fenced_divs>
- <https://pandoc.org/MANUAL.html#extension-inline_code_attributes>
- <https://pandoc.org/MANUAL.html#extension-link_attributes>
- <https://pandoc.org/MANUAL.html#extension-bracketed_spans>

I would just add that Pandoc's HTML writer converts Attr values into 
HTML tag attributes, including those classes and key-value pairs that 
Pandoc does not itself recognize.  Attributes and classes that mean 
nothing to Pandoc can become meaningful if, for example, you provide a 
custom template with CSS or JavaScript that does something with them.

HTH!

Later,
Daniel G.