I am currently developing an R package that translates R expressions to Html
and Latex, things like dbinom(x, size, prob) to P\left(x; N,
\pi\right)Generation of Rd files may be an interesting use case. It's still at
an early stage, I appreciate contributions and interesting feature
requests.github.com/mgondan/mathmlVon meinem/meiner Galaxy gesendet
-------- Ursprüngliche Nachricht --------Von: Ivan Krylov
<krylov.r...@gmail.com> Datum: 12.08.22 08:16 (GMT+01:00) An: Marius Hofert
<marius.hof...@uwaterloo.ca> Cc: r-package-devel@r-project.org Betreff: Re:
[R-pkg-devel] How to write a 'cases' environment in .Rd files? On Thu, 11 Aug
2022 18:43:44 +0000Marius Hofert <marius.hof...@uwaterloo.ca> wrote:> Since
recently, r-devel-linux-x86_64-debian-clang and>
r-devel-linux-x86_64-debian-gcc trigger the note 'Undefined control> sequence:
\cases in F(x) = \cases{...', possibly due to KaTeX> rendering help pages. I
looked around quite a bit but couldn't find a> way to implement 'cases'
environments. For example,> https://katex.org/docs/supported.html#environments
mentions> \begin{cases} \end{cases}, so I tried> > \deqn{F(x) = \begin{cases}>
1,&\text{if}\ x > 0,\\> 0,&\text{if} x = 0.}}{...}> > but that triggers:> >
...> * checking PDF version of manual ... WARNING> LaTeX errors when creating
PDF version.> This typically indicates Rd problems.> LaTeX errors found:> !
Misplaced alignment tab character &There is a possible workaround, but it's the
opposite of beautiful. Youcan use conditional text to compile one version of
the formula for HTMLhelp and another one for PDF
help:\ifelse{html}{\eqn{\begin{cases}...}}{\eqn{\cases{...}}{ascii}}It's as
tedious as it looks. For extra style(?) points, you can put athree-argument
user-defined macro in man/macros/whatever.Rd thatforwards its arguments to one
of the \ifelse branches. As far as Iremember, \newcommand{}{} has to fit on one
line, but in R ≥ 3.6.0,macros themselves can take multi-line arguments.If
you're targeting an earlier version of R, you can make multi-linearguments work
by forcing R to cache the parse tree of the man pagewhile building a source
tarball with a newer R version using\Sexpr[stage=build]{}, costing you some
time during R CMD build and aslightly larger source tarball. (It's an
implementation detail that onenormally shouldn't depend upon. Thankfully, as of
2022, there won't beany newer versions of R ≤ 3.5.x to break it.) Support
forman/macros/*.Rd only appeared in R-3.2.0, so I haven't
researchedcompatibility tricks for even older versions of R.-- Best
regards,ivan______________________________________________r-package-de...@r-project.org
mailing listhttps://stat.ethz.ch/mailman/listinfo/r-package-devel
[[alternative HTML version deleted]]
______________________________________________
R-package-devel@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-package-devel
