babelquarto: R package to render multilingual Quarto books

[maelle]

For the dev version of rOpenSci development guide, we use our experimental babelquarto R package.

It builds the book in the different languages and adds from each page a link to the same page in the other language(s), in the left sidebar.

babelquarto expects:

• language registration in _quarto.yml,

babelquarto:
  mainlanguage: en
  languages: es
lang: en

• translated chapters to be saved in files whose filename is the same filename as the original chapter, with the language code before the extension. For instance intro.qmd is translated in intro.es.qmd. In the absence of a translated chapter, it falls back to using the chapter in the default language, which can be useful when the translation is still in progress.

It can use, but doesn't need, translation for the metadata such as title, description, author, part titles (see docs).

babelquarto doesn't handle translation, but we're working on another package for that, babeldown that interfaces the DeepL API. With it one gets an automated translation upon which a human translator can build.

Thanks so much for the Quarto project!