Use Hugo/Goldmark "Render Hook Templates" for images and links

ct-martin commented 4 years ago

https://gohugo.io/getting-started/configuration-markup#render-hook-templates

Markdown is semantic and should be kept as such. Display/rendering of Markdown should be handled in the templating. Additionally, I'd like to have better semantic markdown than using non-markdown (shortcodes) since they aren't part of the specification; I want my posts to be able to be run through Pandoc (for example) or any other Markdown reader/converter of choice, without issues.

Objectives:

Semantic images (see also: <figure>)
Security attributes on links (noreferrer, noopener, target="_blank" for outgoing)
Automatic support for AMP
Reduce usage of non-markdown in markdown posts (shortcodes)

Related: #3, #6, #7

ct-martin commented 4 years ago

Also, https://spec.commonmark.org/0.29/#links (images is the section after too)

ct-martin commented 4 years ago

With above commits, as much of what I can do in templates has been done.

Todo:

Revise existing posts for better alt text across sites
Convert as many figure shortcodes to plain markdown as possible
- To consider, attribution links aren't possible in markdown
- Should I make a Markdown edge case via the template (with markdownify on Title)? Pro: formatting in <figcaption>s; Con: not CommonMark compliant

ct-martin commented 4 years ago

Note: it seems that Hugo isn't using the render-image.amp.html template...

TODO: figure out later/file bug report

ct-martin commented 4 years ago

Cleanup across sites is outside the scope of this issue.

Code is already in place to do this; upstream bug filed at https://github.com/gohugoio/hugo/issues/7160

ct-martin / ctmartin-hugo-theme

Use Hugo/Goldmark "Render Hook Templates" for images and links #10