From 70e89d15ca56192e91fdd310ca7d91ba1a2b7751 Mon Sep 17 00:00:00 2001 From: Charlotte Wickham Date: Tue, 22 Sep 2026 15:17:05 -0700 Subject: [PATCH 1/2] Give the visual editor screenshots real alt text Seven raw tags used fig-alt=, which only Quarto's Markdown image syntax understands. The browser ignored it, so the images had no accessible name. Convert them to Markdown images with an empty caption so they stay plain images, not figures. --- docs/tools/_code-oss-visual-editor.md | 2 +- docs/visual-editor/options.qmd | 6 +++--- docs/visual-editor/technical.qmd | 6 +++--- 3 files changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/tools/_code-oss-visual-editor.md b/docs/tools/_code-oss-visual-editor.md index b790924bda..f5c944a8d0 100644 --- a/docs/tools/_code-oss-visual-editor.md +++ b/docs/tools/_code-oss-visual-editor.md @@ -125,7 +125,7 @@ Options enable configuration of appearance (font size, content width, etc.), mar Zotero references will also show up automatically in visual editor completions: - +![](/docs/visual-editor/images/visual-editing-citation-completions.png){width="426" fig-alt="Someone has typed '@' in the Visual Editor. In light gray to the right of the '@' is a magnifying glass followed by the text 'or DOI'. Underneath this is a pop-up menu showing available citations. Each citation has a title of the form '@citation' in black, the title of the cited material in gray underneath it, an icon to the left, and the reference to the right in gray. Some of the icons have a small red 'Z' on the bottom right corner, indicating that the corresponding reference comes from a Zotero library."} Items from Zotero will appear alongside items from your bibliography with a small "Z" logo juxtaposed over them. If you insert a citation from Zotero that isn't already in your bibliography then it will be automatically added to the bibliography. diff --git a/docs/visual-editor/options.qmd b/docs/visual-editor/options.qmd index 2e83af41af..5eb4c626e4 100644 --- a/docs/visual-editor/options.qmd +++ b/docs/visual-editor/options.qmd @@ -66,7 +66,7 @@ If you are at the beginning of a line (as displayed above) you can also enter pl You can customize visual editing options within **R Markdown -> Visual** (note that the visual editor was originally created for use with R Markdown so its options are located there --- these options are also applicable to usage with Quarto): - +![](images/visual-editing-options.png){.illustration width="585" fig-alt="The global options window in RStudio. It is currently displaying the Visual subsection of the R Markdown section."} | Option | Description | |-----------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -84,7 +84,7 @@ You can customize visual editing options within **R Markdown -> Visual** (note t You can customize visual editor citation options within **R Markdown -> Citations**: - +![](images/visual-editing-options-citations.png){.illustration width="585" fig-alt="The global options window in RStudio. It is currently displaying the Citation subsection of the R Markdown section."} | Option | Description | |--------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -97,7 +97,7 @@ You can customize visual editor citation options within **R Markdown -> Citation Global options that affect the way markdown is written can also be customized on a per-project basis. You can do this using the **R Markdown** pane of the **Project Options** dialog: - +![](images/visual-editing-project-options.png){.illustration width="541" fig-alt="The Project Options dialog in RStudio. It is currently displaying the R Markdown section."} By default projects inherit the current global settings for markdown writing and Zotero libraries. diff --git a/docs/visual-editor/technical.qmd b/docs/visual-editor/technical.qmd index d0d3107724..eb21af4f22 100644 --- a/docs/visual-editor/technical.qmd +++ b/docs/visual-editor/technical.qmd @@ -232,7 +232,7 @@ Note that for PubMed queries you can use the full supported query syntax. For ex Zotero references will also show up automatically in completions: - +![](images/visual-editing-citation-completions.png){width="426" fig-alt="Someone has typed '@' in the Visual Editor. In light gray to the right of the '@' is a magnifying glass followed by the text 'or DOI'. Underneath this is a pop-up menu showing available citations. Each citation has a title of the form '@citation' in black, the title of the cited material in gray underneath it, an icon to the left, and the reference to the right in gray. Some of the icons have a small red 'Z' on the bottom right corner, indicating that the corresponding reference comes from a Zotero library."} Items from Zotero will appear alongside items from your bibliography with a small "Z" logo juxtaposed over them. If you insert a citation from Zotero that isn't already in your bibliography then it will be automatically added to the bibliography. @@ -244,7 +244,7 @@ If you are running both RStudio and Zotero on your desktop, then no additional c For example, here we specify a project-level option to use the *Reproducible Research Series (Year 1)* group library: - +![](images/visual-editing-citation-zotero-group.png){.illustration width="543" fig-alt="The Project Options pane in RStudio. The R Markdown section is selected. Under the 'Visual Mode: Zotero' options, there is an option labeled 'Use libraries' followed by a drop down menu with the value 'Selected Libraries' currently selected. Underneath this is a white box different library options and buttons to select them. The 'My Library' option is unselected and the 'Reproducible Research Series (Year 1) option is selected."} You can also specify one or more libraries within YAML. For example: @@ -288,7 +288,7 @@ Be sure to **record your key** after generating it (i.e. copy it to the clipboar Finally, go to the **R Markdown -\> Citations** preferences to connect Zotero to RStudio using your key: - +![](images/visual-editing-citations-zotero-options.png){.illustration width="585" fig-alt="The global options menu in R Studio. The Citations subsection of the R Markdown section is selected, and there is a value pasted into the 'Zotero Web API Key' box."} Set the Zotero Library option to "Web", then paste in your Zotero Web API Key. You can use **Verify Key...** button to confirm that your Zotero API key is working correctly. From 50df3aa1742e9f6407f5965270ba1b201d2e7439 Mon Sep 17 00:00:00 2001 From: Charlotte Wickham Date: Tue, 22 Sep 2026 15:19:13 -0700 Subject: [PATCH 2/2] Fix the alt text for the Zotero group library screenshot --- docs/visual-editor/technical.qmd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/visual-editor/technical.qmd b/docs/visual-editor/technical.qmd index eb21af4f22..d0cf04230c 100644 --- a/docs/visual-editor/technical.qmd +++ b/docs/visual-editor/technical.qmd @@ -244,7 +244,7 @@ If you are running both RStudio and Zotero on your desktop, then no additional c For example, here we specify a project-level option to use the *Reproducible Research Series (Year 1)* group library: -![](images/visual-editing-citation-zotero-group.png){.illustration width="543" fig-alt="The Project Options pane in RStudio. The R Markdown section is selected. Under the 'Visual Mode: Zotero' options, there is an option labeled 'Use libraries' followed by a drop down menu with the value 'Selected Libraries' currently selected. Underneath this is a white box different library options and buttons to select them. The 'My Library' option is unselected and the 'Reproducible Research Series (Year 1) option is selected."} +![](images/visual-editing-citation-zotero-group.png){.illustration width="543" fig-alt="The Project Options pane in RStudio. The R Markdown section is selected. Under the 'Visual Mode: Zotero' options, there is an option labeled 'Use libraries' followed by a drop down menu with the value 'Selected Libraries' currently selected. Underneath this is a white box that lists the libraries, each with a checkbox. The 'My Library' option is unselected and the 'Reproducible Research Series (Year 1)' option is selected."} You can also specify one or more libraries within YAML. For example: