Metadata and Other Structures in texor

This is a small sample article to demonstrate handling of metadata and other structures during conversion in texor package.

Abhishek Ulayil (Institute of Actuaries of India (Student))
2025-09-01

1 Introduction

There is a difference in the structure of metadata and generally R Markdown has more metadata entries than its LaTeX counterpart. So for the conversion, the main task is to transform the metadata and include it in the generated R Markdown file, matching the LaTeX metadata as closely as possible.

When used with the -s or standalone mode, pandoc reads out some of the existing meta data. The extracted metadata are listed below.

Metadata read from LaTeX file

The \address{..} section must be typeset in this manner for the most effective conversion.

\address{
Abhishek Ulayil\\ % Your Name in the first Line
Institute of Actuaries of India (Student)\\% Your affiliation which includes post and/or org
Mumbai, India\\ % Your City/Country
ORCiD: 0009-0000-6935-8690\\% ORCID number with prefix ORCiD: 
}
Metadata read from DESCRIPTION file

Some metadata like the volume and issue were picked up from the folder structure for some legacy articles, where the DESCRIPTION file was not available.

Other supported commands in conversion
Table 1: Other commands supported by texor and pandoc
Command Render
\acronym{A} A
\R R
\pkg{texor} texor
\CRANpkg{texor} texor
\BIOpkg{Biobase} Biobase
\ctv{ReproducibleResearch} ReproducibleResearch
\command{help} help

2 Miscellaneous

Citations

Table 2 represents all the ways one can use citations in LaTeX and expect the generated output.

Table 2: Different forms of citation in LaTeX.
Command Render
\citet{pandoc} Krewinkel and A.  Lucero (2023)
\citep{pandoc} (Krewinkel and A.  Lucero 2023)
\citet*{pandoc} Krewinkel and A.  Lucero (2023)
\citep*{pandoc} (Krewinkel and A.  Lucero 2023)
\citeyear{pandoc} (2023)
\citeauthor{pandoc} Krewinkel and A.  Lucero (2023)
\cite{pandoc} (Krewinkel and A.  Lucero 2023)
Footnotes

Footnotes do not work in tabular environments in LaTeX but do work in R Markdown tables1. Custom footnote numbering works in LaTeX but does not work in R Markdown2. These features are demonstrated in Table 3.

Table 3: Demonstration of footnotes.
Command Render
\acronym{A}\footnote{This works in HTML, but not in LaTeX} A3
\R\footnote[25]{HTML shows 4 rather than 25} R4
Block quotes

This block quote should justify an example.

Most links work just fine using \href and the \url command will work flawlessly, as demonstrated in Table  4.

Table 4: Links
Command Render
\href{www.google.com}{Google} Google
\url{www.google.com} www.google.com
Table \ref{table:3} Table 3
Section \nameref{misc} Section 2
\autoref{table:3} 3
Note

Certain reference commands like \nameref{} and \autoref{} may not work as intended in HTML.

Lists

An example of usage of lists in LaTeX and texor generated HTML.

itemize
enumerate

  1. A

  2. B

description
rebib

Convert and Aggregate Bibliographies

texor

Converting ‘LaTeX’ ‘R Journal’ Articles into ‘RJ-web-articles’

Note:

Some options for lists such as special numbering schemes or markups to description item points might not work as intended and the generated HTML might be simple.

Colored text

Some commands to describe colored text also work during conversion, such as \textcolor{blue}{Blue Text} Blue Text.

3 Theorem environments

Theorem 1. This is a sample theorem..

Proposition 1. As with \(X \in \mathbb{R}\) this proposition ...

Remark 1. texor makes the article conversion easier.

Pandoc supports default LaTeX theorem environments. One can refer to these environments like Theorem 1,Proposition 1 and Remark 1 made here. However custom theorem environments are not supported yet.

4 Summary

In summary the texor package alongside pandoc supports:

5 CRAN packages used

texor

6 CRAN Task Views implied by cited packages

7 Bioconductor packages used

Biobase

8 Note

This article is converted from a Legacy LaTeX article using the texor package. The pdf version is the official version. To report a problem with the html, refer to CONTRIBUTE on the R Journal homepage.

A. Krewinkel and A.  Lucero. pandoc 3.0 Release notes. pandoc, 2023. URL https://pandoc.org/releases.html.

  1. Footnotes in paragraph text work in both LaTeX and R markdown↩︎

  2. Footnote 25↩︎

  3. This works in HTML, but not in LaTeX↩︎

  4. HTML shows 4 rather than 25

    ↩︎

References

Reuse

Text and figures are licensed under Creative Commons Attribution CC BY 4.0. The figures that have been reused from other sources don't fall under this license and can be recognized by a note in their caption: "Figure from ...".

Citation

For attribution, please cite this work as

Ulayil, "Metadata and Other Structures in texor", The R Journal, 2025

BibTeX citation

@article{RJ-2025-000,
  author = {Ulayil, Abhishek},
  title = {Metadata and Other Structures in texor},
  journal = {The R Journal},
  year = {2025},
  note = {https://rjournal.github.io/},
  volume = {17},
  issue = {3},
  issn = {2073-4859},
  pages = {1}
}