docs: Improve custom listing using raw HTML#1677
docs: Improve custom listing using raw HTML#1677mcanouil wants to merge 6 commits intoquarto-dev:mainfrom
Conversation
|
/deploy-preview |
📝 Preview Deployment🔍 Full site preview: https://deploy-preview-1677.quarto.org 🔄 Modified Documents |
cderv
left a comment
cderv
left a comment
There was a problem hiding this comment.
I think I would revisit the order and explain, for the start, that EJS templates are processed as a markdown document, and explain that it is best to use Raw HTML to
- avoid performance issue when processing part that are meant to be HTML with no Markdown
- avoid escaping problem for those part too
Then show an example for a simple template having only HTML, and then your example with mixing Markdown and HTML.
Internally, we use .ejs.md extension, not sure why we don't use that too for our recommendation. This makes it kind of clear
Anyhow, just sharing though. I'll let @cwickham review
|
/deploy-preview |
📝 Preview Deployment🔍 Full site preview: https://deploy-preview-1677.quarto.org 🔄 Modified Documents |
|
/deploy-preview |
|
@cderv this is looking good, do you want to take one final look and merge? |
📝 Preview Deployment🔍 Full site preview: https://deploy-preview-1677.quarto.org 🔄 Modified Documents |
3 participants
Enhance clarity and formatting in the custom listing documentation, ensuring better understanding and usability for users creating EJS templates.
From quarto-dev/quarto-cli#11769