schemas - improve document-links docs

news/changelog-1.7.md

@@ -62,6 +62,7 @@ All changes included in 1.7:
 - ([#12319](https://github.com/quarto-dev/quarto-cli/pull/12319)): Provide switchable light and dark brands for a page with `brand.light` and `brand.dark`.
 - ([#12277](https://github.com/quarto-dev/quarto-cli/pull/12277)): Provide light and dark plot and table renderings with `renderings: [light,dark]`
 - ([#11860](https://github.com/quarto-dev/quarto-cli/issues/11860)): ES6 modules that import other local JS modules in documents with `embed-resources: true` are now correctly embedded.
+- ([#10780])(https://github.com/quarto-dev/quarto-cli/issues/10780)): improve `link-external-filter` documentation.
 - ([#1325](https://github.com/quarto-dev/quarto-cli/issues/1325)): Dark Mode pages should not flash light on reload. (Nor should Light Mode pages flash dark.)
 - ([#1470](https://github.com/quarto-dev/quarto-cli/issues/1470)): `respect-user-color-scheme` enables checking the media query `prefers-color-scheme` for user dark mode preference. This is only on page load, not dynamic. Author preference still influences stylesheet order and NoJS experience. Defaults to `false`, leaving to author preference.
 - ([#12307](https://github.com/quarto-dev/quarto-cli/issues/12307)): Tabsets using `tabby.js` in non-boostrap html (`theme: pandoc`, `theme: none` or `minimal: true`) now correctly render reactive content when `server: shiny` is used.

src/resources/editor/tools/vs-code.mjs

@@ -16123,7 +16123,7 @@ var require_yaml_intelligence_resources = __commonJS({
           schema: "string",
           description: {
             short: "A regular expression that can be used to determine whether a link is an internal link.",
-            long: "A regular expression that can be used to determine whether a link is an internal link. For example, \nthe following will treat links that start with http://www.quarto.org as internal links (and others\nwill be considered external):\n\n```\n^(?:http:|https:)\\/\\/www\\.quarto\\.org\\/custom\n```\n"
+            long: "A regular expression that can be used to determine whether a link is an internal link. For example, \nthe following will treat links that start with `http://www.quarto.org/custom` or `https://www.quarto.org/custom`\nas internal links (and others will be considered external):\n\n```\n^(?:http:|https:)\\/\\/www\\.quarto\\.org\\/custom\n```\n"
           }
         },
         {
@@ -21985,7 +21985,7 @@ var require_yaml_intelligence_resources = __commonJS({
           long: "Unique label for code cell. Used when other code needs to refer to\nthe cell (e.g.&nbsp;for cross references <code>fig-samples</code> or\n<code>tbl-summary</code>)"
         },
         "Classes to apply to cell container",
-        "Array of rendering names",
+        "Array of rendering names, e.g.&nbsp;<code>[light, dark]</code>",
         "Array of tags for notebook cell",
         {
           short: "Notebook cell identifier",
@@ -22965,8 +22965,8 @@ var require_yaml_intelligence_resources = __commonJS({
         "Enables tabsets to present content.",
         "Enables smooth scrolling within the page.",
         {
-          short: "Whether the <code>prefers-color-scheme</code> media query controls\ndark mode.",
-          long: "Whether to use the <code>prefers-color-scheme</code> media query to\ndetermine whether to show the user a dark or light page. Otherwise the\nauthor preference (order of <code>light</code> and <code>dark</code> in\n<code>theme</code> or <code>brand</code>) determines what is shown to\nthe user at first visit."
+          short: "Enables setting dark mode based on the\n<code>prefers-color-scheme</code> media query.",
+          long: "If set, Quarto reads the <code>prefers-color-scheme</code> media\nquery to determine whether to show the user a dark or light page.\nOtherwise the author-preferred color scheme is shown."
         },
         {
           short: "Method use to render math in HTML output",

src/resources/editor/tools/yaml/yaml-intelligence-resources.json

@@ -9095,7 +9095,7 @@
       "schema": "string",
       "description": {
         "short": "A regular expression that can be used to determine whether a link is an internal link.",
-        "long": "A regular expression that can be used to determine whether a link is an internal link. For example, \nthe following will treat links that start with http://www.quarto.org as internal links (and others\nwill be considered external):\n\n```\n^(?:http:|https:)\\/\\/www\\.quarto\\.org\\/custom\n```\n"
+        "long": "A regular expression that can be used to determine whether a link is an internal link. For example, \nthe following will treat links that start with `http://www.quarto.org/custom` or `https://www.quarto.org/custom`\nas internal links (and others will be considered external):\n\n```\n^(?:http:|https:)\\/\\/www\\.quarto\\.org\\/custom\n```\n"
       }
     },
     {
@@ -14957,7 +14957,7 @@
       "long": "Unique label for code cell. Used when other code needs to refer to\nthe cell (e.g.&nbsp;for cross references <code>fig-samples</code> or\n<code>tbl-summary</code>)"
     },
     "Classes to apply to cell container",
-    "Array of rendering names",
+    "Array of rendering names, e.g.&nbsp;<code>[light, dark]</code>",
     "Array of tags for notebook cell",
     {
       "short": "Notebook cell identifier",
@@ -15937,8 +15937,8 @@
     "Enables tabsets to present content.",
     "Enables smooth scrolling within the page.",
     {
-      "short": "Whether the <code>prefers-color-scheme</code> media query controls\ndark mode.",
-      "long": "Whether to use the <code>prefers-color-scheme</code> media query to\ndetermine whether to show the user a dark or light page. Otherwise the\nauthor preference (order of <code>light</code> and <code>dark</code> in\n<code>theme</code> or <code>brand</code>) determines what is shown to\nthe user at first visit."
+      "short": "Enables setting dark mode based on the\n<code>prefers-color-scheme</code> media query.",
+      "long": "If set, Quarto reads the <code>prefers-color-scheme</code> media\nquery to determine whether to show the user a dark or light page.\nOtherwise the author-preferred color scheme is shown."
     },
     {
       "short": "Method use to render math in HTML output",

src/resources/schema/document-links.yml

@@ -18,8 +18,8 @@
     short: "A regular expression that can be used to determine whether a link is an internal link."
     long: |
       A regular expression that can be used to determine whether a link is an internal link. For example, 
-      the following will treat links that start with http://www.quarto.org as internal links (and others
-      will be considered external):
+      the following will treat links that start with `http://www.quarto.org/custom` or `https://www.quarto.org/custom`
+      as internal links (and others will be considered external):
 
       ```
       ^(?:http:|https:)\/\/www\.quarto\.org\/custom