From e8aa7b6d40da1c68a18e4a81cbfa48a49a488c39 Mon Sep 17 00:00:00 2001 From: sbreitbart-NOAA Date: Mon, 16 Feb 2026 10:15:09 -0500 Subject: [PATCH 1/3] Update a11y guide with info about how to escape special characters in alt text/captions csv --- vignettes/accessibility_guide.Rmd | 2 ++ 1 file changed, 2 insertions(+) diff --git a/vignettes/accessibility_guide.Rmd b/vignettes/accessibility_guide.Rmd index 592d5f1a..ffe5a9cf 100644 --- a/vignettes/accessibility_guide.Rmd +++ b/vignettes/accessibility_guide.Rmd @@ -185,6 +185,8 @@ recruitment_alt_text <- new_alt_text 3. As stated earlier, if you see text that looks like a placeholder (e.g., "The x axis, showing the year, spans from B.start.year to B.end.year..."), that means that there was at least one instance where our tool failed to extract a specific value from the model results and substitute it into the placeholder. Please make sure that your alt text and captions contain the expected values before moving forward with your report. Check out the inst/resources/captions_alt_text_template.csv file in the `stockplotr` package to view the template with placeholders. The same package's `write_captions()` function shows how values are extracted from the model results and substituted into the placeholders. +4. If you add a special character (e.g., percentage sign (%) or dollar sign ($); see [full list on this wiki page](https://en.wikibooks.org/wiki/LaTeX/Special_Characters#Other_symbols)), please add two backslashes before the character to avoid issues compiling your report later on (specifically, the conversion from Quarto to LaTeX via Pandoc, and then compilation of the LaTeX report after running `add_accessibility()` or `add_alttext()`). For example, "The 95% CI" would be written as "The 95\\\\% CI". + ### More resources Looking for more resources for writing alt text? Check out the [NOAA Library's website for creating accessible documents](https://library.noaa.gov/Section508/CreatingDocs). From a6e60f261a541fe2a094bfe587a6e4d06fbd33f8 Mon Sep 17 00:00:00 2001 From: sbreitbart-NOAA Date: Mon, 16 Feb 2026 10:19:33 -0500 Subject: [PATCH 2/3] Update readme example create_template() arg from 'author' to 'authors' --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 5877e2ec..4917d24e 100644 --- a/README.md +++ b/README.md @@ -83,7 +83,7 @@ asar::create_template( species = "Petrale sole", spp_latin = "Eopsetta jordani", year = 2023, - author = c("Ian G. Taylor"="NWFSC", "Vladlena Gertseva"="NWFSC", "Nick Tolimieri"="NWFSC"), + authors = c("Ian G. Taylor"="NWFSC", "Vladlena Gertseva"="NWFSC", "Nick Tolimieri"="NWFSC"), include_affiliation = TRUE, simple_affiliation = FALSE, param_names = c("nf","sf"), From 1b56a41a47dd6955d3b3296e16e84ae48fd50998 Mon Sep 17 00:00:00 2001 From: sbreitbart-NOAA Date: Tue, 3 Mar 2026 13:31:19 -0500 Subject: [PATCH 3/3] Allow messages in create_template() stating if tables aren't found, and how to make them, to match messaging produced for figures --- R/create_template.R | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/R/create_template.R b/R/create_template.R index 0bef0cb6..db8c0366 100644 --- a/R/create_template.R +++ b/R/create_template.R @@ -616,9 +616,9 @@ create_template <- function( subdir = subdir, tables_dir = tables_dir ) - } |> - suppressMessages() |> - suppressWarnings() + } # |> + # suppressMessages() |> + # suppressWarnings() } else { # extract name for tables.qmd from report folder tables_doc_name <- list.files(file_dir, pattern = "tables.qmd")