Merge pull request #12492 from quarto-dev/improve/create-shortcode

shortcode extension template - use new params and link to docs

Author: cscheid

news/changelog-1.7.md

@@ -176,3 +176,4 @@ All changes included in 1.7:
 - ([#12338](https://github.com/quarto-dev/quarto-cli/issues/12338)): Add an additional workaround for the SCSS parser used in color variable extraction.
 - ([#12369](https://github.com/quarto-dev/quarto-cli/pull/12369)): `quarto preview` correctly throws a YAML validation error when a `format` key does not conform.
 - ([#12459](https://github.com/quarto-dev/quarto-cli/pull/12459)): Add `.page-inset-*` classes to completions.
+- ([#12492](https://github.com/quarto-dev/quarto-cli/pull/12492)): Improve shortcode extension template with new parameters and a link to docs.

src/resources/create/extensions/shortcode/_extensions/qstart-filesafename-qend/qstart-filesafename-qend.ejs.lua

@@ -1,5 +1,7 @@
 return {
-  ['<%= filesafename %>'] = function(args, kwargs, meta) 
+  ['<%= filesafename %>'] = function(args, kwargs, meta, raw_args, context) 
+    -- see https://quarto.org/docs/extensions/shortcodes.html
+    -- for documentation on shortcode development
     return pandoc.Str("Hello from ${title}!")
   end
 }