fenced div not working in LaTeX because of missing data-latex

[sigbert]

Hi,

I used a fenced div in a R Markdown file without a data-latex attribute which then wrote to the LaTeX file

\leavevmode\vadjust pre{\hypertarget{hello}{}}%
Hello \textbf{world}!

rather than an environment \begin{hello}...\end[hello}.

Since I'am not a native english speaker, it was not clear for me from the R Markdown Cookbook that the attribute data-latex is required. Maybe the documentation could be clarified.

Thanks Sigbert

[cderv]

Thank for the feedback.

This is here:

9.6 Custom blocks (*) | R Markdown Cookbook

We are saying

For LaTeX output, the first class name will be used as the LaTeX environment name. You should also provide an attribute named data-latex in the Div block, which will be the arguments of the environment. This attribute can be an empty string if the environment does not need arguments

Then we only show examples using data-latex for LaTeX output with Rmd.

How would you mentioned it differently ? What would make it more clear ?

Thank you

[sigbert]

I spoke to a native English speaker and there is a difference between "should" and its usual German translation "sollte". I was told that "should" means it is required, but "sollte" in German means I am strongly encouraged to use it, but it is not mandatory.

[jrkrideau]

As a native English speaker (Canada) "should" does not mean required. It seems to mean the same as "sollte".

The problem with the English language is that we have any number of dialects---sometimes close to mutually incomprehensible---plus a huge number of people whose first language is not English , all writing instructions.

Think of Prussia versus Bavaria or Switzerland and multiply by 50.

[cderv]

@jrkrideau

As a native English speaker (Canada) "should" does not mean required. It seems to mean the same as "sollte".

I am happy to take any advice on what to use. I am not a native english speaker, but I was taught and thought should was enough for require, as must was a bit too strong. But happy to use must instead if that makes thinks clearer.