#### 2022-09-19

Interlinear glosses are a way of writing linguistic examples in a language other than the language of the main text (typically English). They first have a couple of lines of vertically aligned bits (however words are split in the original language) with, normally, some morphological information, and finally they might close with a free translation of the example. Most often they follow the Leipzig Glossing Rules.

R Markdown (Allaire et al. 2022) is an R package for literate programming, where you can weave together text and code. You can use R Markdown to write your papers, focusing on content rather than formatting, confident that the same source (pretty much) can turn into both a beautiful PDF file or a gorgeous web page with the minimum of effort. Yes, once you’re used to it, it’s not harder than writing in MS Word. I’ve written a bit about it in case you’re interested.

Mixing R Markdown and interlinear glosses has proved challenging. This package offers you some wrapping functions that call the expex $$LaTeX$$ package for PDF output and leipzig.js for HTML output and generate flextable::flextable() tables for MS Word output. You don’t really need to know any Latex or Javascript or HTML to take advantage of both of them.

The package also takes care of cross-references, giving you a handy function gloss() to sprinkle around your text every time you want to reference one of your examples. Go ahead and check out the articles and the rendered versions of vignette("glossr_how").

I’m sure there is a lot of functionality in both expex and leipzig.js that this package doesn’t cover… yet. Please, go ahead and report any problems, suggestions and tasks for the wishlist in the issues section of the repository. Or fork it and contribute if you’d like!

# Acknowledgements

While this is a matter I’ve wondered about for a while, it was really kicked off by Giulia Mazzola’s worries. I’m converting her to the R Markdown crowd and I couldn’t let her resolve weaken because of these small matters. Thank you for your encouragement and appreciation!

I also want to thank Thomas Van Hoey for taking a look at the package, giving me suggestions and offering me examples.

Last but not least, I’d like to acknowledge the source of the examples in the small “dataset” provided by this package. These glosses were taken from Shindo (2015) and Pustet (2015). Any mistakes are mine.

# Alternatives

Shortly before1 this package, another R package came out to render glosses in R Markdown with HTML output: lingglosses. Unlike glossr, it is tailored for HTML, where it creates a table to render the glosses, much like glossr does for Word2. It also allows grammaticality judgements, inline examples and sign language glosses, offers a list of abbreviations and generates a table from your glosses. In short, they have different focuses, so take a look and see what works for you :)

# References

Allaire, JJ, Yihui Xie, Jonathan McPherson, Javier Luraschi, Kevin Ushey, Aron Atkins, Hadley Wickham, Joe Cheng, Winston Chang, and Richard Iannone. 2022. Rmarkdown: Dynamic Documents for r. https://CRAN.R-project.org/package=rmarkdown.
Pustet, Regina. 2015. “The Syntax of Temperature Predications.” In The Linguistics of Temperature, edited by Maria Koptjevskaja-Tamm, 889–916. Typological Studies in Language. Amsterdam: John Benjamins Publishing Company.
Shindo, Mika. 2015. “Subdomains of Temperature Concepts in Japanese.” In The Linguistics of Temperature, edited by Maria Koptjevskaja-Tamm, 639–65. Typological Studies in Language. Amsterdam: John Benjamins Publishing Company.

1. A few months earlier, but I didn’t find out until a few days after.↩︎

2. The markup is therefore different than the one given by leipzig.js↩︎