How to conditionally move contents out of the margins?

[benkeks]

Description

I have a nice two-column book (PDF and HTML) with figures in margins and the main body. Now, I am creating a single-column version. I want to use conditional content ({.content-visible when-profile=...} etc.) together with the {{< contents my-id >}} macro to control where to put the figures in the derived document.

I've already found out that {{< contents ... >}} does not work directly with the margin figures, but one has to wrap them in other divs.

Error Quarto yields if one tries to contents-move a margin figure

[Malformed document] Found `contents` shortcode without a corresponding div with id: fig-margin-stuff.
This might happen because the shortcode is used in div context, while the id corresponds to a span.
Removing from document.

(To me as an outsider, it is not obvious that/why margin figure divs are no divs by Quarto's logic. I assume this is because of some internal special handling.)

Here's an example document where I try to move a margin figure to .column-body in the PDF version. But the margin figure stays in the margin.

---
title: "Moving content from margin"
---

::: {#wrapper-margin}
:::: {#fig-margin-stuff .column-margin}
$e = mc^2$

My fancy margin figure.
::::
:::

The document uses both, figures in the margin and in the main body...

:::{#wrapper-main}
:::: {#fig-main-stuff}
$mc^2 = e$

My fancy body figure.
::::
:::

::: {.content-visible when-format="pdf"}

Apparently, it is not possible to move a figure conditionally from the margin to the main body.

(This is PDF output.)

::::{.column-body}
{{< contents wrapper-margin >}}
::::

:::

The converse works, that is, I can move stuff into the margin, e.g. in the HTML version here:

::: {.content-visible when-format="html"}
(This is HTML output.)

But it is possible to conditionally move a figure to the margin.

:::: {.column-margin}
{{< contents wrapper-main >}}
::::

So far, the best to no change the whole document I came up with is to force all margin figures in PDF into usual figures.

\renewenvironment{marginfigure}{
    \begin{figure}[tbp]
}{
    \end{figure}
}

In practice, I want to have more fine-grained control. In particular, I'd like to place some previous margin figures side-by-side. For this, I hope to get some more fine-grained control on the Quarto-side of things using the contents shortcode. But how to get it to work?

[mcanouil]

I personally use "Div Reuse" (https://github.com/mcanouil/quarto-div-reuse) and conditional contents to get different layout.

edit: it appears to not work very well with cross-references.

[mcanouil]

About the example provided, you are not moving a content from margin to body, you are moving a margin element INTO body.

What you are doing	What is done
::: {#wrapper-margin} :::: {#fig-margin-stuff .column-margin} $e = mc^2$ My fancy margin figure. :::: ::: ::::{.column-body} {{< contents wrapper-margin >}} ::::	::::{.column-body} :::: {#fig-margin-stuff .column-margin} $e = mc^2$ My fancy margin figure. :::: ::::

[mcanouil]

Even-though, the provided example is not straightforward, below is one approach.
Note that I don't understand why you want to move the margin figure instead of only displaying it in the margin for the appropriate format, but again it might be that your example content does not depict the real situation.

---
title: "Moving content from margin"
format:
  pdf: default
  html: default
filters:
  - path: div-reuse
    at: post-quarto
---

The document uses both, figures in the margin and in the main body...

:::: {#margin-stuff}
:::: {#fig-margin-stuff}
$e = mc^2$

My fancy margin figure.
:::
:::

:::: {.content-visible when-format="html"}
:::: {reuse="margin-stuff" .column-margin}
:::
:::

:::: {.content-visible when-format="pdf"}
Apparently, it is not possible to move a figure conditionally from the margin to the main body.

(This is PDF output.)

:::: {reuse="margin-stuff"}
:::
:::

[benkeks]

Hi @mcanouil , many thanks for looking into it!

The background (“real situation”) had to do with me having a nice 200-page document employing many margin figures where I wanted to specify some layout adjustments for the margin-less version without creating too much clutter in the source nor breaking the margin version.

In the end, I've arrived at something that seems quite hack-y using the many {{< contents >}} macros. Your reuse macro using special divs might indeed be more sensible for my problem than the builtin macro. 👍