quarto-dev / quarto-cli

Open-source scientific and technical publishing system built on Pandoc.
https://quarto.org
Other
3.81k stars 309 forks source link

Epic: Extensions Section #9094

Open cwickham opened 6 months ago

cwickham commented 6 months ago
cwickham commented 3 months ago

Moving some comments out of #7900:

I've seen many users using Lua filters without using Quarto extensions mechanism. I think some users don't know they don't have to write extensions to use a Lua filter (especially all the Lua filters developed initially for Pandoc).

Here the "Extensions" pages should be read as "Extend Quarto with Lua filters, shortcodes formats and possibly distribue as Quarto extensions" but I feel users are reading this as "Use Quarto Extension mechanism", especially since this part starts with a listings of extension followed by how to create extensions.

(my two cents)

FYI, in discussions, there are several simple examples of Lua filters (a lot written by @cscheid):

https://github.com/quarto-dev/quarto-cli/discussions?discussions_q=label%3Alua

Originally posted by @mcanouil in https://github.com/quarto-dev/quarto-cli/issues/7900#issuecomment-1852907886