revealjs: how to apply different spans to a block based on execution parameters to change layout and move part os the slide to speaker-notes?

[Gewerd-Strauss]

Description

Hello,

I am trying to generate a revealjs-presentation with dynaamic layouts based on using content-conditionals to apply specific spans.

Take the following code:

---
acronyms:
  fromfile: ./acronyms.yml
  include_unused: false
  insert_loa: false
  loa_title: ''
aliases: []
date: last-modified
date-format: YYYY-MM-DD HH:mm:ss:SSS
filters:
- acronyms
format:
  revealjs:
    height: 1080
    scrollable: false
    slide-number: c/t
    smaller: true
    width: 1920
modification date: 2025-02-03 15:07
params:
  cowplot_cols: 1
  hide_caption: false
  hide_notes: false
tags:
- BE31/presentations
---


# Introduction

## Background and research question

```{r}
#| label: code-setup-extras
#| include: FALSE
#| cache: FALSE
hide_caption <- function(str,hide_param) {
  if (isTRUE(hide_param)) {
    return("")
  } else return(str)
}
```



# Results

<!-- alibi-comment to force printing of next header -->

## Displacements along the X-axis - done, needs speaker-notes

:::: {.columns}

::: {.column width="40%"}  

**Displacement of the \acr{CPL}**

```{r}
#| label: fig-positional_deviations_x-distance-calibration_square_to_lensfront
#| fig-cap: !expr 'hide_caption(paste(stringr::str_c("Shown are the determined areas for the calibration-plate (A) and relative deviation from the target-area of ",get_expected_area(x_distance_calibration_square_to_lensfront)," (B), as a function of the calibration-plate''s distance from the lens-front. The identifier-plate is placed at a distance of ",get_control_group(x_distance_calibration_square_to_lensfront)," cm from the lens-front. The area determined for the calibration-plate scales anti-proportionally to the calibration-plate''s distance from the lens'' along the X-axis.")),params$hide_caption)'
#| echo: false
#| warning: false
plot(cars)
```



::::: {.content-visible when-meta="params.hide_notes"}

<!-- end the first column -->
<!-- and create the second column to hold the next figure -->
<!-- when moving notes to speakers -->

:::



::: {.column width="60%"}  

:::::


```{r}
#| label: fig-positional_deviations_x-distance-calibration_square_to_lensfront-2d
#| echo: false
#| fig-cap: !expr 'hide_caption(paste(stringr::str_c("2D-projection of the setup. The dotted rectangle describes the \\acr{FOV}-cone of the camera, the blue circle the position of the lens. Distances in cm.")),params$hide_caption)'
plot(cars)
```



::::: {.content-hidden when-meta="params.hide_notes"}

::: {.column width="60%"}  
<!-- do not apply a column-class when moving notes to speakers -->

:::::

::::: {.content-visible when-meta="params.hide_notes"}

<!-- instead, end the previous column -->
:::

<!-- and the column-span overall -->
::::

<!-- and set up the notes-span -->
::: {.notes}

:::::

<!-- this text should be printed either in column 2 (if param 'hide_notes=False' ) -->
<!-- or as a speaker if 'hide_notes=True' (see above) -->

- the smallest deviation was yielded when \acr{CPL} and \acr{IDP} are placed at the same distance relative to the lens-front
- accuracy of determined area deteriorates with reduced distance of the \acr{CPL} to the lens-front while the \acr{IDP} is kept static

:::

::::: {.content-hidden when-meta="params.hide_notes"}

<!-- when hide_notes=False, the text above shall occupy the second column.
so then we now need to close the column-env itself
-->

::::

:::::

This code should be runnable, but I am not entirely sure, since it is part of a larger project.

The above should generate either of the following two layouts:

1: normal (example)

2: what I am trying to attempt by setting parameter hide_notes: TRUE when rendering,

e.g. by executing quarto render presentations/colloquium_presentation.qmd --no-cache --execute-params "presentations/layout2.yml", I would like to reach the following layout:

The text marked in yelllow should be transformed to speaker-notes via application of {.notes}-span, and not be visible. I just included it for the sake of understanding my goal.
Please also ignore that the figure-captions are missing in image2, that is not pat of my intended goal but I currently can't regenerate that layout that easily.

THat doesn't work. THe simple solution would be to just rewrite the section of the document to permanently change the structure, but I don't want that.

So my question is, if my understanding of applying spans is somehow flawed, or if I am trying to do the impossible here.

I can provide further details as required.

THank you.
Sincerely,
~Gw

[mcanouil]

Would you mind sharing something simpler with no or minimal dependencies?
If your goal is only to make notes "show or hide", remove everything else and make an example focusing on this goal.

[mcanouil]

Final thing, you could use profiles or format to define different behaviour instead or with of a set of metadata or parameters.
when-format="revealjs" and/or when-format="html" unless-format="revealjs"

[Gewerd-Strauss]

Sorry but why is this has to be that complicated? Note that params is not metadata, it's parameters. You might not see the difference, but it's huge. Parameters are for computations.

Here is a simple example:

quarto render slides.qmd --metadata hide-notes:true

---
title: "Quarto Playground"
format: revealjs
hide-notes: false
---

## Slide 1

:::: {.columns}

::: {.column width=50%}
{{< lipsum 1 >}}
:::

::: {.column width=50%}
![An image]({{< placeholder 600 400 >}}){#fig-placeholder}

:::: {.content-visible when-meta="hide-notes"}

- This is a note
- It is hidden in the slides
- But visible in the notes

::::

:::

:::

:::: {.content-hidden when-meta="hide-notes"}
::: {.notes}

- This is a note
- It is hidden in the slides
- But visible in the notes

:::

::::

I am aware that I could just duplicate the contents into a separate notes-markup, but I am attempting to do this without duplicating all text - cuz that would make updating/altering it really time-consuming.

But as I don't seem to be capable of doing step 1 - that is I cannot seem to use :::: {.content-visible when-meta="hide-notes"} and :::: {.content-hidden when-meta="hide-notes"} to selectively/dynamically start/end divs to reposition the same contents - thus this whole thing is not really viable to pursue further it seems.

---
acronyms:
  fromfile: ./acronyms.yml
  include_unused: false
  insert_loa: false
  loa_title: ''
aliases: []
author:
- acknowledgements: I acknowledge the help I received by a lot of people
  attributes:
    corresponding: 1
    deceased: 0
  email: red
  fnumber: number
  id: string
  metadata:
    date: now
    date-format: MMMM YYYY
  name: redacted
  note: string
  url: redacted
creation date: 2025-01-26 12:18
date: last-modified
date-format: YYYY-MM-DD HH:mm:ss:SSS
filters:
- acronyms
format:
  revealjs:
    height: 1080
    scrollable: false
    slide-number: c/t
    smaller: true
    width: 1920
modification date: 2025-02-03 15:07
params:
  cowplot_cols: 1
  hide__caption: false
hide-notes: true
subtitle: redacted
tags:
- BE31/presentations
---

## Displacements along the X-axis - done, needs speaker-notes

:::: {.columns}

::: {.column width="40%"}  

**Displacement of the CPL**

{{< placeholder 400 200 format=svg >}}


::::: {.content-visible when-meta="hide-notes"}

<!-- end the first column -->
<!-- and create the second column to hold the next figure -->
<!-- when moving notes to speakers -->

:::

::: {.column width="60%"}  

:::::

{{< placeholder 200 400 format=svg >}}



::::: {.content-hidden when-meta="hide-notes"}

::: {.column width="60%"}  
<!-- do not apply a column-class when moving notes to speakers -->

:::::

::::: {.content-visible when-meta="hide-notes"}

<!-- instead, end the previous column -->
:::

<!-- and the column-span overall -->
::::

<!-- and set up the notes-span -->
::: {.notes}

:::::

<!-- this text should be printed either in column 2 (if param 'hide-notes=False' ) -->
<!-- or as a speaker if 'hide-notes=True' (see above) -->

- the smallest deviation was yielded when CPL and IDP are placed at the same distance relative to the lens-front
- accuracy of determined area deteriorates with reduced distance of the CPL to the lens-front while the IDP is kept static

:::

::::: {.content-hidden when-meta="hide-notes"}

<!-- when hide-notes=False, the text above shall occupy the second column.
so then we now need to close the column-env itself
-->

::::

:::::

Meaning the above:

• does not place the second placeholder in its own column but it should
• does not assign span notes to the text but it should

when executed as quarto render file.qmd --no-cache, even though in the metadata printed to the console we find hide-notes: true.
Or to be precise, setting hide-notes: true or hide-notes: false in the file's frontmatter and then not fedding anything specific to quarto render file.qmd will not yield differeing results.

Which leads me to believe that either this is flat-out not possible, or I am really not understanding stuff.

---

Note: your last 2 messages were not read when this was typed and submitted, I will do so now/tomorrow morning, as it is getting late slowly.

[mcanouil]

oh you were doing. I don't think someone can see/understand that from your example with its current complexity.

::: {.content-visible}
:::: {whatever}
:::

This will never work and is invalid.
It's like writing:

<div><div>/div>

You should already see that this is not what you want.

Note that the number of colons does not matter. The above code is the same as below.

::: {.content-visible}
::: {whatever}
:::

[mcanouil]

FYI, Here is an approach to "open" / "close":

• Filter enabling syntactic sugar for using custom typst functions in .qmd file #10381

[mcanouil]

@Gewerd-Strauss The following new extension might be of interest for your use case.

https://github.com/mcanouil/quarto-div-reuse

[mcanouil]

I re-discovered the following extension which could be of help or inspiration

• https://github.com/pagiraud/speakernotes