feat: allow deactivation of float environment in pdf for fenced code

this is a workaround to allow the correct display of fenced code
blocks inside floats in pdf/LaTeX by removing the default treatment
from pandoc.

Author: kandolfp

src/resources/filters/layout/meta.lua

@@ -31,6 +31,7 @@ function layout_meta_inject_latex_packages()
       -- Both options could be undefined, true / false or set to a color value
       local useCodeBlockBorder = (adaptiveTextHighlighting and meta[kCodeBlockBorderLeft] == nil and meta[kCodeBlockBackground] == nil) or (meta[kCodeBlockBorderLeft] ~= nil and meta[kCodeBlockBorderLeft] ~= false)
       local useCodeBlockBg = meta[kCodeBlockBackground] ~= nil and meta[kCodeBlockBackground] ~= false
+      local deactivateCodeBlockBg = meta[kCodeBlockBackground] ~= nil and meta[kCodeBlockBackground] == false
 
       -- if we're going to display a border or background
       -- we need to inject color handling as well as the 
@@ -101,6 +102,16 @@ function layout_meta_inject_latex_packages()
       end
 
 
+      -- if we're NOT going to display a border or background we need to inject
+      -- code to modify the pandoc behavior for fenced code blocks boxes.
+      -- This can be used to especially allow code blocks in other boxes like
+      -- callback
+      if (not useCodeBlockBorder and deactivateCodeBlockBg) then
+        metaInjectLatex(meta, function(inject)
+          inject("\\ifdefined\\Shaded\\renewenvironment{Shaded}{}\\fi")
+        end)
+      end
+
 
       -- enable column layout (packages and adjust geometry)
       if (layoutState.hasColumns or marginReferences() or marginCitations()) and _quarto.format.isLatexOutput() then

src/resources/schema/document-code.yml

@@ -93,6 +93,10 @@
     long: |
       Specifies to apply a background color on code blocks. Provide a hex color to specify that the background color is
       enabled as well as the color of the background.
+
+      For PDF output, if you specify `false`  and `code-block-border-left` is `false` or not set, the code block is not
+      enclosed in a floating LaTeX environment. This is especially useful for long code blocks nested inside a callout block,
+      as it allows correct page breaks to occur. Line numbering and annotations are not affected.
 - name: highlight-style
   tags:
     formats: [$html-all, docx, ms, $pdf-all]

tests/docs/smoke-all/2025/01/21/issue-11698.qmd

@@ -0,0 +1,66 @@
+--- 
+title: "foo"
+code-block-bg: false
+format: pdf
+---
+:::: {.callout-caution icon=false}
+## Self implementation 
+
+Implement the code yourself by filling out the missing sections:
+
+```{python}
+#| code-fold: true
+#| eval: false
+#| code-summary: "Code fragment for implementation."
+#| fig-cap: "Test"
+import numpy as np
+import matplotlib.pyplot as plt
+%config InlineBackend.figure_formats = ["svg"]
+
+frequ = 2 * np.pi * 50
+f = lambda t: 0.8 * np.sin(t * frequ)
+diod = lambda t: (np.exp(1.2 + t) - 1)
+
+t = np.linspace(0, 2 * np.pi / frequ, 1024, endpoint=False)
+x = np.linspace(np.min(f(t)) * 1.3, np.max(f(t)) * 1.1, 1024)
+
+ic = lambda t: diod(f(t))
+
+k = np.arange(0, 16) * 1 / 16
+
+# The provided figures where used to create the illustation
+if True:
+    plt.figure()
+    plt.plot(f(t), t)
+    plt.plot([np.min(t),np.max(t)], [0,0], "gray")
+    plt.axis("off")
+    #plt.savefig("sin.svg", transparent=True)
+    plt.figure()
+    plt.plot(x, diod(x))
+    z = np.array([0, np.min(f(t)), np.max(f(t))])
+    plt.plot(z, diod(z), "bx")
+    plt.axis("off")
+    plt.xlim([-2,5])
+    plt.gcf().patch.set_visible(False)
+    #plt.savefig("diode.svg", transparent=True)
+
+    plt.figure()
+    plt.plot(t, ic(t))
+    plt.plot(2*np.pi*k/frequ, ic(2*np.pi*k/frequ), "ro")
+    plt.axis("off")
+    #plt.savefig("ic.svg", transparent=True, bbox_inches ="tight")
+
+y = ic(k)
+yhat = (np.fft.fft(y))
+#Necessary correction factor for the FFT
+factor = 1 / 16
+yy = factor * yhat
+
+ic_mean = np.mean(ic(np.linspace(0, 1/50, 2**20)))
+c0 = yy[0].real
+effective_value = np.linalg.norm(yy[1:])
+harmonic_distortion = np.linalg.norm(yy[3:-2])/np.linalg.norm(yy[1:])
+```
+::::
+
+Some text that will not be displayed in the correct color.