Lua - new API quarto.format

.format_identifier()

Author: cscheid

src/resources/lua-types/quarto/format.lua

@@ -239,4 +239,13 @@ Returns an object with the format name and variants as would be interpreted by P
 ]]
 ---@param raw_format string The format's string
 ---@return quarto.format.ParseFormatResult
-function quarto.format.parse_format(raw_format) end
+function quarto.format.parse_format(raw_format) end
+
+--[[
+Returns a table with the format identifier information, including:
+- `target-format`: The full target format name, e.g. `html+variant`
+- `base-format`: The base format name, e.g. `html`
+- `display-name`: A human-readable display name for the format, e.g. `HTML`
+- `extension`: The name of the extension that exposes the format, if present
+]]
+function quarto.format.format_identifier() end

src/resources/pandoc/datadir/_format.lua

@@ -288,6 +288,9 @@ local function _main()
   end
 
   return {
+    format_identifier = function()
+      return param("format-identifier", {})
+    end,
     isAsciiDocOutput = isAsciiDocOutput,
     is_asciidoc_output = isAsciiDocOutput,
     isRawHtml = isRawHtml,

tests/docs/smoke-all/lua/format/format-identifier.lua

@@ -0,0 +1,7 @@
+function Pandoc(doc)
+  local identifier = quarto.format.format_identifier()
+  assert(identifier["target-format"] == "html+test")
+  assert(identifier["base-format"] == "html")
+  assert(identifier["display-name"] == "HTML")
+  return doc
+end

tests/docs/smoke-all/lua/format/format-identifier.qmd

@@ -0,0 +1,6 @@
+---
+format: html+test
+filters:
+  - format-identifier.lua
+---
+