babelquarto: render a Quarto multilingual project, book or website

[maelle]

Submitting Author Name: Maëlle Salmon
Submitting Author Github Handle: @maelle
Other Package Authors Github handles: (comma separated, delete if none) @Nenuial
Repository: https://github.com/ropensci-review-tools/babelquarto/
Version submitted: 0.0.1
Submission type: Standard
Editor: @ronnyhdez
Reviewers: @EllaKaye, @joaojcorreia

Archive: TBD
Version accepted: TBD
Language: en

---

• Paste the full DESCRIPTION file inside a code block below:

Package: babelquarto
Title: Renders a Multilingual Quarto Book
Version: 0.0.1
Authors@R: c(
    person("Maëlle", "Salmon", , "msmaellesalmon@gmail.com", role = c("cre", "aut"),
           comment = c(ORCID = "0000-0002-2815-0399")),
    person("Johannes", "Ranke", role = "ctb"),
    person("Joel H.", "Nitta", , "joelnitta@gmail.com", role = "ctb",
           comment = c(ORCID = "0000-0003-4719-7472")),
    person("Pascal", "Burkhard", , "pascal.burkhard@gmail.com", role = "aut",
           comment = c(ORCID = "0009-0001-5504-5084")),
    person("rOpenSci", role = "fnd",
           comment = c(ROR = "019jywm96"))
  )
Description: Automate rendering and cross-linking of Quarto books following a 
    prescribed structure.
License: MIT + file LICENSE
Encoding: UTF-8
Roxygen: list(markdown = TRUE, roclets = c("collate", "rd", "namespace", "devtag::dev_roclet"))
RoxygenNote: 7.3.2.9000
Imports: 
    brio,
    cli,
    fs,
    purrr,
    quarto,
    rlang,
    sys,
    whoami,
    withr,
    xml2,
    yaml
Depends:
   R (>= 4.1.0)
Suggests: 
    servr,
    testthat (>= 3.0.0)
URL: https://github.com/ropensci-review-tools/babelquarto
BugReports: https://github.com/ropensci-review-tools/babelquarto/issues
Config/testthat/edition: 3
VignetteBuilder:
    quarto

Scope

• Please indicate which category or categories from our package fit policies this package falls under: (Please check an appropriate box below. If you are unsure, we suggest you make a pre-submission inquiry.):

  • data retrieval
  • data extraction
  • data munging
  • data deposition
  • data validation and testing
  • workflow automation
  • version control
  • citation management and bibliometrics
  • scientific software wrappers
  • field and lab reproducibility tools
  • database software bindings
  • geospatial data
  • translation
  • rOpenSci tools

• Explain how and why the package falls under these categories (briefly, 1-2 sentences):

It was developed by rOpenSci staff.
Based on https://devdevguide.netlify.app/softwarereview_policies#aims-and-scope, it also falls under the "traduction" category as it allows to publish multilingual documentation.

• Who is the target audience and what are scientific applications of this package?

This package is useful for Quarto users who need to publish a multilingual Quarto website or book, as it is not possible in native Quarto yet.
The package can be used to publish any kind of Quarto website/book but use cases include, beyond several rOpenSci guides, Joel Nitta's personal website, a R handbook for epidemiologists, a website for training courses in epidemiology.

• Are there other R packages that accomplish the same thing? If so, how does yours differ or meet our criteria for best-in-category?

No, not to my knowledge. 😄

• (If applicable) Does your package comply with our guidance around Ethics, Data Privacy and Human Subjects Research?

N/A

• If you made a pre-submission inquiry, please paste the link to the corresponding issue, forum post, or other discussion, or @tag the editor you contacted.

• Explain reasons for any pkgcheck items which your package is unable to pass.

Technical checks

Confirm each of the following by checking the box.

• I have read the rOpenSci packaging guide.
• I have read the author guide and I expect to maintain this package for at least 2 years or to find a replacement.

This package:

• does not violate the Terms of Service of any service it interacts with.
• has a CRAN and OSI accepted license.
• contains a README with instructions for installing the development version.
• includes documentation with examples for all functions, created with roxygen2.
• contains a vignette with examples of its essential functions and uses.
• has a test suite.
• has continuous integration, including reporting of test coverage.

Publication options

• Do you intend for this package to go on CRAN?

• Do you intend for this package to go on Bioconductor?

• Do you wish to submit an Applications Article about your package to Methods in Ecology and Evolution? If so:

MEE Options

• The package is novel and will be of interest to the broad readership of the journal.
• The manuscript describing the package is no longer than 3000 words.
• You intend to archive the code for the package in a long-term repository which meets the requirements of the journal (see MEE's Policy on Publishing Code)
• (Scope: Do consider MEE's Aims and Scope for your manuscript. We make no guarantee that your manuscript will be within MEE scope.)
• (Although not required, we strongly recommend having a full manuscript prepared when you submit here.)
• (Please do not submit your package separately to Methods in Ecology and Evolution)

Code of conduct

• I agree to abide by rOpenSci's Code of Conduct during the review process and in maintaining my package should it be accepted.

[ropensci-review-bot]

Thanks for submitting to rOpenSci, our editors and @ropensci-review-bot will reply soon. Type @ropensci-review-bot help for help.

[ropensci-review-bot]

🚀

The following problem was found in your submission template:

• 'author1' variable must be GitHub handle only ('@myhandle')
  Editors: Please ensure these problems with the submission template are rectified. Package checks have been started regardless.

👋

[maelle]

I have now removed the space between the "@" and the username. 😅

[maelle]

@ropensci-review-bot check package

[ropensci-review-bot]

Thanks, about to send the query.

[ropensci-review-bot]

🚀

Editor check started

👋

[ropensci-review-bot]

Checks for babelquarto (v0.0.1)

git hash: d27894e7

• ✔️ Package name is available
• ✔️ has a 'codemeta.json' file.
• ✔️ has a 'contributing' file.
• ✔️ uses 'roxygen2'.
• ✔️ 'DESCRIPTION' has a URL field.
• ✔️ 'DESCRIPTION' has a BugReports field.
• ✔️ Package has at least one HTML vignette
• ✔️ All functions have examples.
• ✖️ Package fails continuous integration checks.
• ✔️ Package coverage is 96.7%.
• ✔️ All goodpractice linters passed.
• ✔️ R CMD check found no errors.
• ✔️ R CMD check found no warnings.
• 👀 Function names are duplicated in other packages

Important: All failing checks above must be addressed prior to proceeding

(Checks marked with 👀 may be optionally addressed.)

Package License: MIT + file LICENSE

---

1. Package Dependencies

Details of Package Dependency Usage (click to open)

The table below tallies all function calls to all packages ('ncalls'), both internal (r-base + recommended, along with the package itself), and external (imported and suggested packages). 'NA' values indicate packages to which no identified calls to R functions could be found. Note that these results are generated by an automated code-tagging system which may not be entirely accurate.

type	package	ncalls
internal	base	71
internal	babelquarto	22
internal	stats	5
internal	utils	1
imports	fs	22
imports	brio	10
imports	purrr	8
imports	xml2	7
imports	cli	3
imports	withr	2
imports	yaml	2
imports	quarto	1
imports	whoami	1
imports	rlang	NA
imports	sys	NA
suggests	servr	NA
suggests	testthat	NA
linking_to	NA	NA

Click below for tallies of functions used in each package. Locations of each call within this package may be generated locally by running 's <- pkgstats::pkgstats(<path/to/repo>)', and examining the 'external_calls' table.

base

c (9), file.path (9), grep (9), sprintf (7), list (6), if (4), any (2), for (2), is.null (2), length (2), seq (2), setdiff (2), sub (2), Sys.getenv (2), trimws (2), args (1), class (1), dir (1), file (1), grepl (1), lapply (1), nzchar (1), unlist (1), which (1)

babelquarto

read_yaml (5), site_url (4), create_new_lang_file (2), add_cross_links (1), add_links (1), create_other_language_link (1), filter_freeze_directory (1), find_language_name (1), lang_code_chapter_list (1), on_ci (1), path_rel (1), quarto_multilingual_book (1), quarto_multilingual_project (1), replace_true_false (1)

fs

dir_ls (8), path_rel (4), path (3), file_delete (2), file_exists (2), dir_exists (1), path_ext_set (1), path_file (1)

brio

read_lines (7), write_lines (3)

purrr

keep (3), map_chr (3), map (1), walk (1)

xml2

xml_find_first (5), read_html (1), xml_add_child (1)

stats

start (4), profile (1)

cli

cli_abort (3)

withr

local_tempdir (2)

yaml

read_yaml (2)

quarto

quarto_path (1)

utils

data (1)

whoami

fullname (1)

NOTE: Some imported packages appear to have no associated function calls; please ensure with author that these 'Imports' are listed appropriately.

---

2. Statistical Properties

This package features some noteworthy statistical properties which may need to be clarified by a handling editor prior to progressing.

Details of statistical properties (click to open)

The package has:

• code in R (100% in 5 files) and
• 2 authors
• no vignette
• no internal data file
• 11 imported packages
• 8 exported functions (median 9 lines of code)
• 34 non-exported functions in R (median 18 lines of code)

---

Statistical properties of package structure as distributional percentiles in relation to all current CRAN packages
The following terminology is used:

• loc = "Lines of Code"
• fn = "function"
• exp/not_exp = exported / not exported

All parameters are explained as tooltips in the locally-rendered HTML version of this report generated by the checks_to_markdown() function

The final measure (fn_call_network_size) is the total number of calls between functions (in R), or more abstract relationships between code objects in other languages. Values are flagged as "noteworthy" when they lie in the upper or lower 5th percentile.

measure	value	percentile	noteworthy
files_R	5	31.4
files_vignettes	0	0.0	TRUE
files_tests	7	80.9
loc_R	828	60.1
loc_tests	871	80.8
num_vignettes	0	0.0	TRUE
n_fns_r	42	49.8
n_fns_r_exported	8	38.7
n_fns_r_not_exported	34	54.9
n_fns_per_file_r	4	65.7
num_params_per_fn	3	29.3
loc_per_fn_r	16	51.7
loc_per_fn_r_exp	9	19.7
loc_per_fn_r_not_exp	18	60.1
rel_whitespace_R	13	51.1
rel_whitespace_tests	15	73.8
doclines_per_fn_exp	32	36.7
doclines_per_fn_not_exp	0	0.0	TRUE
fn_call_network_size	28	52.2

---

2a. Network visualisation

Click to see the interactive network visualisation of calls between objects in package

---

3. goodpractice and other checks

Details of goodpractice checks (click to open)

---

3b. goodpractice results

Test coverage with covr

Package coverage: 96.75

Cyclocomplexity with cyclocomp

The following function have cyclocomplexity >= 15:

function	cyclocomplexity
add_links	21

---

4. Other Checks

Details of other checks (click to open)

✖️ The following function name is duplicated in other packages:

• • render_book from bookdown

---

Package Versions

package	version
pkgstats	0.2.0.61
pkgcheck	0.1.2.207

---

Editor-in-Chief Instructions:

Processing may not proceed until the items marked with ✖️ have been resolved.

[ropensci-review-bot]

Checks for babelquarto (v0.0.1)

git hash: d27894e7

• ✔️ Package name is available
• ✔️ has a 'codemeta.json' file.
• ✔️ has a 'contributing' file.
• ✔️ uses 'roxygen2'.
• ✔️ 'DESCRIPTION' has a URL field.
• ✔️ 'DESCRIPTION' has a BugReports field.
• ✔️ Package has at least one HTML vignette
• ✔️ All functions have examples.
• ✖️ Package fails continuous integration checks.
• ✔️ Package coverage is 96.7%.
• ✔️ All goodpractice linters passed.
• ✔️ R CMD check found no errors.
• ✔️ R CMD check found no warnings.
• 👀 Function names are duplicated in other packages

Important: All failing checks above must be addressed prior to proceeding

(Checks marked with 👀 may be optionally addressed.)

Package License: MIT + file LICENSE

---

1. Package Dependencies

Details of Package Dependency Usage (click to open)

The table below tallies all function calls to all packages ('ncalls'), both internal (r-base + recommended, along with the package itself), and external (imported and suggested packages). 'NA' values indicate packages to which no identified calls to R functions could be found. Note that these results are generated by an automated code-tagging system which may not be entirely accurate.

type	package	ncalls
internal	base	71
internal	babelquarto	22
internal	stats	5
internal	utils	1
imports	fs	22
imports	brio	10
imports	purrr	8
imports	xml2	7
imports	cli	3
imports	withr	2
imports	yaml	2
imports	quarto	1
imports	whoami	1
imports	rlang	NA
imports	sys	NA
suggests	servr	NA
suggests	testthat	NA
linking_to	NA	NA

Click below for tallies of functions used in each package. Locations of each call within this package may be generated locally by running 's <- pkgstats::pkgstats(<path/to/repo>)', and examining the 'external_calls' table.

base

c (9), file.path (9), grep (9), sprintf (7), list (6), if (4), any (2), for (2), is.null (2), length (2), seq (2), setdiff (2), sub (2), Sys.getenv (2), trimws (2), args (1), class (1), dir (1), file (1), grepl (1), lapply (1), nzchar (1), unlist (1), which (1)

babelquarto

read_yaml (5), site_url (4), create_new_lang_file (2), add_cross_links (1), add_links (1), create_other_language_link (1), filter_freeze_directory (1), find_language_name (1), lang_code_chapter_list (1), on_ci (1), path_rel (1), quarto_multilingual_book (1), quarto_multilingual_project (1), replace_true_false (1)

fs

dir_ls (8), path_rel (4), path (3), file_delete (2), file_exists (2), dir_exists (1), path_ext_set (1), path_file (1)

brio

read_lines (7), write_lines (3)

purrr

keep (3), map_chr (3), map (1), walk (1)

xml2

xml_find_first (5), read_html (1), xml_add_child (1)

stats

start (4), profile (1)

cli

cli_abort (3)

withr

local_tempdir (2)

yaml

read_yaml (2)

quarto

quarto_path (1)

utils

data (1)

whoami

fullname (1)

NOTE: Some imported packages appear to have no associated function calls; please ensure with author that these 'Imports' are listed appropriately.

---

2. Statistical Properties

This package features some noteworthy statistical properties which may need to be clarified by a handling editor prior to progressing.

Details of statistical properties (click to open)

The package has:

• code in R (100% in 5 files) and
• 2 authors
• no vignette
• no internal data file
• 11 imported packages
• 8 exported functions (median 9 lines of code)
• 34 non-exported functions in R (median 18 lines of code)

---

Statistical properties of package structure as distributional percentiles in relation to all current CRAN packages
The following terminology is used:

• loc = "Lines of Code"
• fn = "function"
• exp/not_exp = exported / not exported

All parameters are explained as tooltips in the locally-rendered HTML version of this report generated by the checks_to_markdown() function

The final measure (fn_call_network_size) is the total number of calls between functions (in R), or more abstract relationships between code objects in other languages. Values are flagged as "noteworthy" when they lie in the upper or lower 5th percentile.

measure	value	percentile	noteworthy
files_R	5	31.4
files_vignettes	0	0.0	TRUE
files_tests	7	80.9
loc_R	828	60.1
loc_tests	871	80.8
num_vignettes	0	0.0	TRUE
n_fns_r	42	49.8
n_fns_r_exported	8	38.7
n_fns_r_not_exported	34	54.9
n_fns_per_file_r	4	65.7
num_params_per_fn	3	29.3
loc_per_fn_r	16	51.7
loc_per_fn_r_exp	9	19.7
loc_per_fn_r_not_exp	18	60.1
rel_whitespace_R	13	51.1
rel_whitespace_tests	15	73.8
doclines_per_fn_exp	32	36.7
doclines_per_fn_not_exp	0	0.0	TRUE
fn_call_network_size	28	52.2

---

2a. Network visualisation

Click to see the interactive network visualisation of calls between objects in package

---

3. goodpractice and other checks

Details of goodpractice checks (click to open)

---

3b. goodpractice results

Test coverage with covr

Package coverage: 96.75

Cyclocomplexity with cyclocomp

The following function have cyclocomplexity >= 15:

function	cyclocomplexity
add_links	21

---

4. Other Checks

Details of other checks (click to open)

✖️ The following function name is duplicated in other packages:

• • render_book from bookdown

---

Package Versions

package	version
pkgstats	0.2.0.61
pkgcheck	0.1.2.207

---

Editor-in-Chief Instructions:

Processing may not proceed until the items marked with ✖️ have been resolved.

[maelle]

Fixed the CI, pesky Windows build.

[maelle]

@ropensci-review-bot check package

[ropensci-review-bot]

Thanks, about to send the query.

[ropensci-review-bot]

🚀

Editor check started

👋

[ropensci-review-bot]

Checks for babelquarto (v0.0.1)

git hash: 17852bab

• ✔️ Package name is available
• ✔️ has a 'codemeta.json' file.
• ✔️ has a 'contributing' file.
• ✔️ uses 'roxygen2'.
• ✔️ 'DESCRIPTION' has a URL field.
• ✔️ 'DESCRIPTION' has a BugReports field.
• ✔️ Package has at least one HTML vignette
• ✔️ All functions have examples.
• ✔️ Package has continuous integration checks.
• ✔️ Package coverage is 96.8%.
• ✔️ All goodpractice linters passed.
• ✔️ R CMD check found no errors.
• ✔️ R CMD check found no warnings.
• 👀 Function names are duplicated in other packages

(Checks marked with 👀 may be optionally addressed.)

Package License: MIT + file LICENSE

---

1. Package Dependencies

Details of Package Dependency Usage (click to open)

The table below tallies all function calls to all packages ('ncalls'), both internal (r-base + recommended, along with the package itself), and external (imported and suggested packages). 'NA' values indicate packages to which no identified calls to R functions could be found. Note that these results are generated by an automated code-tagging system which may not be entirely accurate.

type	package	ncalls
internal	base	71
internal	babelquarto	22
internal	stats	5
internal	utils	1
imports	fs	22
imports	brio	10
imports	purrr	8
imports	xml2	7
imports	cli	3
imports	withr	2
imports	yaml	2
imports	quarto	1
imports	whoami	1
imports	rlang	NA
imports	sys	NA
suggests	servr	NA
suggests	testthat	NA
linking_to	NA	NA

Click below for tallies of functions used in each package. Locations of each call within this package may be generated locally by running 's <- pkgstats::pkgstats(<path/to/repo>)', and examining the 'external_calls' table.

base

c (9), file.path (9), grep (9), sprintf (7), list (6), if (4), any (2), for (2), is.null (2), length (2), seq (2), setdiff (2), sub (2), Sys.getenv (2), trimws (2), args (1), class (1), dir (1), file (1), grepl (1), lapply (1), nzchar (1), unlist (1), which (1)

babelquarto

read_yaml (5), site_url (4), create_new_lang_file (2), add_cross_links (1), add_links (1), create_other_language_link (1), filter_freeze_directory (1), find_language_name (1), lang_code_chapter_list (1), on_ci (1), path_rel (1), quarto_multilingual_book (1), quarto_multilingual_project (1), replace_true_false (1)

fs

dir_ls (8), path_rel (4), path (3), file_delete (2), file_exists (2), dir_exists (1), path_ext_set (1), path_file (1)

brio

read_lines (7), write_lines (3)

purrr

keep (3), map_chr (3), map (1), walk (1)

xml2

xml_find_first (5), read_html (1), xml_add_child (1)

stats

start (4), profile (1)

cli

cli_abort (3)

withr

local_tempdir (2)

yaml

read_yaml (2)

quarto

quarto_path (1)

utils

data (1)

whoami

fullname (1)

NOTE: Some imported packages appear to have no associated function calls; please ensure with author that these 'Imports' are listed appropriately.

---

2. Statistical Properties

This package features some noteworthy statistical properties which may need to be clarified by a handling editor prior to progressing.

Details of statistical properties (click to open)

The package has:

• code in R (100% in 5 files) and
• 2 authors
• no vignette
• no internal data file
• 11 imported packages
• 8 exported functions (median 9 lines of code)
• 34 non-exported functions in R (median 18 lines of code)

---

Statistical properties of package structure as distributional percentiles in relation to all current CRAN packages
The following terminology is used:

• loc = "Lines of Code"
• fn = "function"
• exp/not_exp = exported / not exported

All parameters are explained as tooltips in the locally-rendered HTML version of this report generated by the checks_to_markdown() function

The final measure (fn_call_network_size) is the total number of calls between functions (in R), or more abstract relationships between code objects in other languages. Values are flagged as "noteworthy" when they lie in the upper or lower 5th percentile.

measure	value	percentile	noteworthy
files_R	5	31.4
files_vignettes	0	0.0	TRUE
files_tests	7	80.9
loc_R	830	60.2
loc_tests	871	80.8
num_vignettes	0	0.0	TRUE
n_fns_r	42	49.8
n_fns_r_exported	8	38.7
n_fns_r_not_exported	34	54.9
n_fns_per_file_r	4	65.7
num_params_per_fn	3	29.3
loc_per_fn_r	16	51.7
loc_per_fn_r_exp	9	19.7
loc_per_fn_r_not_exp	18	60.1
rel_whitespace_R	13	51.6
rel_whitespace_tests	15	73.8
doclines_per_fn_exp	32	36.7
doclines_per_fn_not_exp	0	0.0	TRUE
fn_call_network_size	28	52.2

---

2a. Network visualisation

Click to see the interactive network visualisation of calls between objects in package

---

3. goodpractice and other checks

Details of goodpractice checks (click to open)

3a. Continuous Integration Badges

GitHub Workflow Results

id	name	conclusion	sha	run_number	date
16373119538	format-suggest.yaml	success	858cd3	4	2025-07-18
16373119552	lint-changed-files.yaml	failure	858cd3	52	2025-07-18
17043953257	pkgcheck	success	17852b	13	2025-08-18
17043953242	R-CMD-check.yaml	success	17852b	274	2025-08-18
17043953245	test-coverage.yaml	success	17852b	6	2025-08-18

---

3b. goodpractice results

Test coverage with covr

Package coverage: 96.75

Cyclocomplexity with cyclocomp

The following function have cyclocomplexity >= 15:

function	cyclocomplexity
add_links	21

---

4. Other Checks

Details of other checks (click to open)

✖️ The following function name is duplicated in other packages:

• • render_book from bookdown

---

Package Versions

package	version
pkgstats	0.2.0.61
pkgcheck	0.1.2.207

---

Editor-in-Chief Instructions:

This package is in top shape and may be passed on to a handling editor

[mpadge]

@ropensci-review-bot assign @ronnyhdez as editor