Support Mmark Asides (mirror Alert Shortcode)

[HughP]

There doesn't seem to be any default styling for aside elements in post or pages. Is this a correct observation. I looked at the code base for asides and didn't find anything.

I know that BlackFriday does not support asides but mmark does viaA>. And hugo supports both. I was researching mmark for it's reported support for citations relevant to #830.

Should I propose a styling for an aside in the theme?

[gcushen]

BlackFriday does not support asides

Academic is currently intended for use only with the built-in Blackfriday Markdown parser.

One can attempt to use Hugo with other Markdown parsers like Mmark and Pandoc if they wish, but officially integrating/testing with these is not on the roadmap. Note that Mmark is not a general Markdown parser and does not have feature parity with either GitHub Markdown or Blackfriday.

If Blackfriday add support, then I'll re-open :)

[gcushen]

Actually, the Hugo docs were out of date on the comparison with Mmark.

After investigating further, I now recommend technical content writers to use Mmark (add markup: mmark to YAML front matter). By using Mmark, there is also no need to escape LaTeX math to prevent it being parsed as Markdown. Hopefully Hugo team update to Mmark v2 as that will bring a lot of much needed technical functionality and fix many current issues.

Consider adding your support for a site wide Mmark option here: gohugoio/hugo#6101

Asides already exist in the form of the Alert shortcode. I have just updated the styles so that A>... in Mmark reflects this.

[gcushen]

See it in action in the latest demo of writing technical content: https://academic-demo.netlify.com/post/writing/

[HughP]

My understanding of the proper html5 syntax for asides is that they are equivalent to pull quotes. https://en.wikipedia.org/wiki/Pull_quote for visual examples see: https://www.google.com/search?q=pull+quotes&client=ubuntu&hs=pXR&source=lnms&tbm=isch&sa=X&ved=0ahUKEwiS_7iKmsXjAhVJsVQKHQO_C4EQ_AUIECgB&biw=1441&bih=893 While it might be debatable on if alerts (usually blue), warnings (usually red), and notes (usually yellow) could also fit under the HTML5 guideline specifications as asides, they don't strike me the same as pull quotes. To me they are more like margin notes, or inline foot notes (which might all be asides).

…

On Sat, Jul 20, 2019 at 11:49 AM George ***@***.***> wrote: See it in action in the latest demo of writing technical content: https://academic-demo.netlify.com/post/writing/ — You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub <#1214>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AAAJ2JQBK27D2SEMNYGND3TQANM2VANCNFSM4IFJPAMA> .