From 3680e329ac6dac20292432680382967be01d2de6 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 13 Aug 2026 15:19:03 +0000 Subject: [PATCH 1/2] docs: vale style audit fixes and rule tuning --- .vale.ini | 2 +- .vale/styles/Mintlify/Acronyms.yml | 37 +++ api-playground/sdk-reference-setup.mdx | 2 +- assistant/use.mdx | 10 +- assistant/widget.mdx | 2 +- customize/custom-scripts.mdx | 370 ++++++++++++------------- dashboard/sso.mdx | 2 +- enterprise-contracting.mdx | 2 +- guides/knowledge-base.mdx | 2 +- organize/settings-seo.mdx | 16 +- 10 files changed, 241 insertions(+), 204 deletions(-) diff --git a/.vale.ini b/.vale.ini index 3df30982ed..d4ccf95a5d 100644 --- a/.vale.ini +++ b/.vale.ini @@ -2,7 +2,7 @@ StylesPath = .vale/styles MinAlertLevel = suggestion -IgnoredScopes = code, tt, img, url, a +IgnoredScopes = code, tt, img, url, a, kbd SkippedScopes = script, style, pre, figure, code Vocab = Mintlify diff --git a/.vale/styles/Mintlify/Acronyms.yml b/.vale/styles/Mintlify/Acronyms.yml index 40321923a3..8f889e5c05 100644 --- a/.vale/styles/Mintlify/Acronyms.yml +++ b/.vale/styles/Mintlify/Acronyms.yml @@ -8,36 +8,54 @@ second: '(?:\b[A-Z][a-z]+ )+\(([A-Z]{3,5})\)' # ... with the exception of these: exceptions: - AAA + - ACS + - AEO + - ANSI - API - ASCII - ASP + - AWS - BETA + - CAA + - CDN + - CIDR - CLI + - CNAME - CPU - CRM + - CSP - CSS - CSV + - CTA + - CTR - DEBUG + - DNS + - DOCX - DOM - DPI - FAQ - GCC - GDB + - GEO - GET - GIF - GPU - GTK - GUI + - HEAD - HTML - HTTP - HTTPS + - IAM - ICO - IDE + - ISO - JAR - JIT - JPEG - JPG - JSON + - JSONC - JSX - JWT - LESS @@ -46,27 +64,39 @@ exceptions: - llms - LLMs - LTS + - MCP + - MDX + - NAT - NET - NEW - NOT - NOTE - NVDA + - OAI + - OIDC - OSS + - PATCH - PATH - PDF - PHP - PNG - POST - PST + - PUT - RAG - RAM + - RBAC - REPL - REST + - ROI + - RPC - RSA - SAML + - SCIM - SCM - SCSS - SDK + - SEO - SKILL - SLA - SQL @@ -76,16 +106,23 @@ exceptions: - SVG - TBD - TCP + - TLS - TODO + - TOML + - TSV - TTF + - TXT - URI - URL - USB + - UTC - UTF - UUID - VPN + - WAVE - WOFF - XML - XSS - YAML + - YYYY - ZIP diff --git a/api-playground/sdk-reference-setup.mdx b/api-playground/sdk-reference-setup.mdx index 94f4f31f61..2d4d2dc7f4 100644 --- a/api-playground/sdk-reference-setup.mdx +++ b/api-playground/sdk-reference-setup.mdx @@ -65,7 +65,7 @@ Add an `sdk` property to a tab or group in your `docs.json`. Mintlify parses the } ``` -Add `sdk` to a [group](/organize/navigation#groups) to generate pages inside one section of a tab instead of an entire tab. Groups and pages inherit the `sdk` settings of the tab or group above them. If a nested group sets its own `sdk`, Mintlify uses those settings instead of the inherited ones. +Add `sdk` to a [group](/organize/navigation#groups) to generate pages inside one section of a tab instead of an entire tab. Groups and pages inherit the `sdk` settings of the parent tab or group. If a nested group sets its own `sdk`, Mintlify uses those settings instead of the inherited ones. ```json { diff --git a/assistant/use.mdx b/assistant/use.mdx index 2dc07d2075..15f755df02 100644 --- a/assistant/use.mdx +++ b/assistant/use.mdx @@ -129,11 +129,11 @@ Limits: **For readers:** Ask your IT team to allow outbound HTTPS requests to the following hostnames from your network. If you can, try the assistant from a personal network to confirm the issue is network-specific. - - `leaves.mintlify.com` — assistant API - - `*.mintlify.dev` — assistant streaming and supporting services - - `*.mintlify.com` — dashboard, API, and analytics - - `hcaptcha.com` and `*.hcaptcha.com` — CAPTCHA verification for the assistant + - `leaves.mintlify.com`—assistant API + - `*.mintlify.dev`—assistant streaming and supporting services + - `*.mintlify.com`—dashboard, API, and analytics + - `hcaptcha.com` and `*.hcaptcha.com`—CAPTCHA verification for the assistant - **For site owners:** If a reader reports that the assistant does not load on their corporate network or VPN, treat it as an outbound network block. It is not a problem with your documentation. Point them to the hostnames above and suggest that they share the list with their IT team. This allowlist applies to the visitor's device or network. You cannot configure it from your site. If you self-host behind a reverse proxy that overwrites the default CSP, see [CSP configuration](/deploy/csp-configuration) for the domains to allow. + **For site owners:** If a reader reports that the assistant does not load on their corporate network or VPN, treat it as an outbound network block. It is not a problem with your documentation. Point them to the preceding hostnames and suggest that they share the list with their IT team. This allowlist applies to the visitor's device or network. You cannot configure it from your site. If you self-host behind a reverse proxy that overwrites the default CSP, see [CSP configuration](/deploy/csp-configuration) for the domains to allow. diff --git a/assistant/widget.mdx b/assistant/widget.mdx index 42fcc38f63..71bf178f5d 100644 --- a/assistant/widget.mdx +++ b/assistant/widget.mdx @@ -294,6 +294,6 @@ If your site uses a Content Security Policy, allow the origins required by your | `script-src` | `https://js.hcaptcha.com` | hCaptcha bot protection | | `connect-src` and `frame-src` | `https://*.hcaptcha.com` | hCaptcha bot protection | -A strict `script-src` policy must still authorize both the loader and initialization script. A strict `style-src` policy must authorize the nonce you pass to `init()`, which the widget copies to its injected stylesheet. Passing `nonce` to `init()` propagates it only to resources the widget creates after initialization. +A strict `script-src` policy must still authorize both the loader and initialization script. A strict `style-src` policy must authorize the nonce you pass to `init()`, which the widget copies to its injected style sheet. Passing `nonce` to `init()` propagates it only to resources the widget creates after initialization. diff --git a/customize/custom-scripts.mdx b/customize/custom-scripts.mdx index e306a21460..1a8690429a 100644 --- a/customize/custom-scripts.mdx +++ b/customize/custom-scripts.mdx @@ -74,81 +74,81 @@ Each ID appears once per page. Use these as `#value` in CSS. For example, `#navb - - `#body-content` — Outermost wrapper for the page body. - - `#content-area` — Primary content area, excluding the sidebar and table of contents. - - `#content` — Inner content element within the content area. - - `#header` — Page-level header element. - - `#banner` — Announcement banner displayed above the navbar. - - `#footer` — Page footer. Also targetable as an element selector: `footer`. - - `#page-title` — The `

` heading at the top of each page. - - `#pagination` — Bottom pagination bar with previous and next page links. - - `#panel` — Floating panel overlay. Also targetable as an element selector: `panel`. - - `#background-color` — Page background color element. + - `#body-content`—Outermost wrapper for the page body. + - `#content-area`—Primary content area, excluding the sidebar and table of contents. + - `#content`—Inner content element within the content area. + - `#header`—Page-level header element. + - `#banner`—Announcement banner displayed above the navbar. + - `#footer`—Page footer. Also targetable as an element selector: `footer`. + - `#page-title`—The `

` heading at the top of each page. + - `#pagination`—Bottom pagination bar with previous and next page links. + - `#panel`—Floating panel overlay. Also targetable as an element selector: `panel`. + - `#background-color`—Page background color element. - - `#navbar` — Top navigation bar. - - `#topbar-cta-button` — Call-to-action button in the topbar. - - `#mobile-nav` — Mobile navigation overlay. - - `#mobile-nav-content` — Content area within the mobile navigation overlay. + - `#navbar`—Top navigation bar. + - `#topbar-cta-button`—Call-to-action button in the topbar. + - `#mobile-nav`—Mobile navigation overlay. + - `#mobile-nav-content`—Content area within the mobile navigation overlay. - - `#sidebar` — The sidebar navigation panel. - - `#sidebar-content` — Scrollable content area within the sidebar. + - `#sidebar`—The sidebar navigation panel. + - `#sidebar-content`—Scrollable content area within the sidebar. - - `#table-of-contents` — Table of contents panel on the right side of the page. - - `#table-of-contents-layout` — Layout wrapper for the table of contents. - - `#table-of-contents-content` — Scrollable content within the table of contents. + - `#table-of-contents`—Table of contents panel on the right side of the page. + - `#table-of-contents-layout`—Layout wrapper for the table of contents. + - `#table-of-contents-content`—Scrollable content within the table of contents. - - `#search-bar-entry` — Search bar trigger in the topbar. - - `#search-bar-entry-mobile` — Search bar trigger on mobile. - - `#search-input` — Text input field within the search modal. + - `#search-bar-entry`—Search bar trigger in the topbar. + - `#search-bar-entry-mobile`—Search bar trigger on mobile. + - `#search-input`—Text input field within the search modal. - - `#assistant-entry` — AI assistant button in the topbar. - - `#assistant-entry-mobile` — AI assistant button on mobile. - - `#chat-assistant-sheet` — AI assistant chat panel. - - `#chat-assistant-textarea` — Text input within the AI assistant panel. + - `#assistant-entry`—AI assistant button in the topbar. + - `#assistant-entry-mobile`—AI assistant button on mobile. + - `#chat-assistant-sheet`—AI assistant chat panel. + - `#chat-assistant-textarea`—Text input within the AI assistant panel. - - `#request-example` — Request example panel in the API playground. - - `#response-example` — Response example panel in the API playground. - - `#api-playground-input` — Input section of the API playground. - - `#endpoints-menu-trigger` — Button that opens the endpoint selector dropdown. + - `#request-example`—Request example panel in the API playground. + - `#response-example`—Response example panel in the API playground. + - `#api-playground-input`—Input section of the API playground. + - `#endpoints-menu-trigger`—Button that opens the endpoint selector dropdown. - - `#ask-assistant-code-block-button` — "Ask Assistant" button that appears on code blocks. - - `#code-snippet-feedback-button` — Feedback button on code snippets. - - `#code-snippet-feedback-textarea` — Text area within the code snippet feedback form. + - `#ask-assistant-code-block-button`—"Ask Assistant" button that appears on code blocks. + - `#code-snippet-feedback-button`—Feedback button on code snippets. + - `#code-snippet-feedback-textarea`—Text area within the code snippet feedback form. - - `#feedback-thumbs-up` — Thumbs-up feedback button at the bottom of a page. - - `#feedback-thumbs-down` — Thumbs-down feedback button at the bottom of a page. - - `#feedback-form` — Feedback form shown after a thumbs-down response. - - `#feedback-form-input` — Text input within the feedback form. - - `#feedback-form-cancel` — Cancel button within the feedback form. - - `#feedback-form-submit` — Submit button within the feedback form. + - `#feedback-thumbs-up`—Thumbs-up feedback button at the bottom of a page. + - `#feedback-thumbs-down`—Thumbs-down feedback button at the bottom of a page. + - `#feedback-form`—Feedback form shown after a thumbs-down response. + - `#feedback-form-input`—Text input within the feedback form. + - `#feedback-form-cancel`—Cancel button within the feedback form. + - `#feedback-form-submit`—Submit button within the feedback form. - - `#page-context-menu` — Contextual options menu for the current page. - - `#page-context-menu-button` — Button that triggers the page context menu. + - `#page-context-menu`—Contextual options menu for the current page. + - `#page-context-menu-button`—Button that triggers the page context menu. - - `#localization-select-trigger` — Button that opens the language selector. - - `#localization-select-content` — Dropdown content of the language selector. - - `#localization-select-item` — Individual language option within the selector. + - `#localization-select-trigger`—Button that opens the language selector. + - `#localization-select-content`—Dropdown content of the language selector. + - `#localization-select-item`—Individual language option within the selector. - - `#changelog-filters` — Filter controls on a changelog page. - - `#changelog-filters-content` — Content area within the changelog filter panel. + - `#changelog-filters`—Filter controls on a changelog page. + - `#changelog-filters-content`—Content area within the changelog filter panel. - - `#multi-view-dropdown` — Dropdown for switching between documentation views. + - `#multi-view-dropdown`—Dropdown for switching between documentation views. - - `#text-selection-tooltip` — Tooltip that appears when you select text on a page. - - `#text-selection-tooltip-button` — Action button within the text selection tooltip. + - `#text-selection-tooltip`—Tooltip that appears when you select text on a page. + - `#text-selection-tooltip-button`—Action button within the text selection tooltip. @@ -158,202 +158,202 @@ Multiple instances of these elements can appear on a page. Use these as `value` - - `accordion` — Collapsible accordion item. - - `accordion-group` — Wrapper grouping multiple accordions. - - `callout` — Callout block (Note, Warning, Tip, etc.). - - `card` — Individual card element. - - `card-group` — Wrapper grouping multiple cards. Deprecated in favor of `columns`, but preserved for backward compatibility. - - `columns` — Multi-column layout wrapper. - - `code-block` — Code block element. - - `code-block-icon` — Icon displayed in a code block header. - - `code-group` — Tabbed group of code blocks. - - `expandable` — Expandable section element. - - `frame` — Frame wrapper for images or embedded content. - - `icon` — Inline icon element. - - `mermaid` — Mermaid diagram wrapper. - - `step` — Individual step within a steps sequence. - - `steps` — Numbered steps container. - - `tab-icon` — Icon displayed within a tab. - - `tabs` — Tabbed content container. - - `tile` — Tile component element. - - `tooltip` — Tooltip element. - - `update` — Changelog update entry. + - `accordion`—Collapsible accordion item. + - `accordion-group`—Wrapper grouping multiple accordions. + - `callout`—Callout block (Note, Warning, Tip, etc.). + - `card`—Individual card element. + - `card-group`—Wrapper grouping multiple cards. Deprecated in favor of `columns`, but preserved for backward compatibility. + - `columns`—Multi-column layout wrapper. + - `code-block`—Code block element. + - `code-block-icon`—Icon displayed in a code block header. + - `code-group`—Tabbed group of code blocks. + - `expandable`—Expandable section element. + - `frame`—Frame wrapper for images or embedded content. + - `icon`—Inline icon element. + - `mermaid`—Mermaid diagram wrapper. + - `step`—Individual step within a steps sequence. + - `steps`—Numbered steps container. + - `tab-icon`—Icon displayed within a tab. + - `tabs`—Tabbed content container. + - `tile`—Tile component element. + - `tooltip`—Tooltip element. + - `update`—Changelog update entry. - - `mdx-content` — Rendered MDX content area. - - `panel` — Floating panel component. Also targetable as an ID selector: `#panel`. - - `eyebrow` — Small label displayed above a page title. - - `link` — Anchor link element. - - `breadcrumb-list` — Breadcrumb navigation list. - - `breadcrumb-item` — Individual breadcrumb item. + - `mdx-content`—Rendered MDX content area. + - `panel`—Floating panel component. Also targetable as an ID selector: `#panel`. + - `eyebrow`—Small label displayed above a page title. + - `link`—Anchor link element. + - `breadcrumb-list`—Breadcrumb navigation list. + - `breadcrumb-item`—Individual breadcrumb item. - - `nav-logo` — Logo in the navigation bar. - - `navbar-link` — Link element within the navigation bar. - - `nav-anchors` — Container for anchor links in the topbar. - - `nav-anchor` — Individual anchor link in the topbar. - - `nav-tabs` — Tab bar in the top navigation. - - `nav-tabs-item` — Individual tab item in the top navigation tab bar. - - `mobile-nav-tabs-item` — Tab item in the mobile navigation tab bar. - - `topbar-right-container` — Right section of the topbar. - - `nav-tag-pill` — Tag pill shown in the navigation. - - `nav-tag-pill-text` — Text within a navigation tag pill. + - `nav-logo`—Logo in the navigation bar. + - `navbar-link`—Link element within the navigation bar. + - `nav-anchors`—Container for anchor links in the topbar. + - `nav-anchor`—Individual anchor link in the topbar. + - `nav-tabs`—Tab bar in the top navigation. + - `nav-tabs-item`—Individual tab item in the top navigation tab bar. + - `mobile-nav-tabs-item`—Tab item in the mobile navigation tab bar. + - `topbar-right-container`—Right section of the topbar. + - `nav-tag-pill`—Tag pill shown in the navigation. + - `nav-tag-pill-text`—Text within a navigation tag pill. - - `nav-dropdown-trigger` — Button that opens a navigation dropdown. - - `nav-dropdown-content` — Content container for a navigation dropdown. - - `nav-dropdown-item` — Individual item within a navigation dropdown. - - `nav-dropdown-item-text-container` — Text wrapper within a dropdown item. - - `nav-dropdown-item-title` — Title text within a dropdown item. - - `nav-dropdown-item-description` — Description text within a dropdown item. - - `nav-dropdown-item-icon` — Icon within a dropdown item. + - `nav-dropdown-trigger`—Button that opens a navigation dropdown. + - `nav-dropdown-content`—Content container for a navigation dropdown. + - `nav-dropdown-item`—Individual item within a navigation dropdown. + - `nav-dropdown-item-text-container`—Text wrapper within a dropdown item. + - `nav-dropdown-item-title`—Title text within a dropdown item. + - `nav-dropdown-item-description`—Description text within a dropdown item. + - `nav-dropdown-item-icon`—Icon within a dropdown item. - - `nav-dropdown-products-selector-trigger` — Button that opens the products selector dropdown. - - `nav-dropdown-products-selector-content` — Content container for the products selector. - - `nav-dropdown-products-selector-item` — Individual product in the selector. - - `nav-dropdown-products-selector-item-title` — Title of a product selector item. - - `nav-dropdown-products-selector-item-description` — Description of a product selector item. - - `nav-dropdown-products-selector-item-icon` — Icon of a product selector item. + - `nav-dropdown-products-selector-trigger`—Button that opens the products selector dropdown. + - `nav-dropdown-products-selector-content`—Content container for the products selector. + - `nav-dropdown-products-selector-item`—Individual product in the selector. + - `nav-dropdown-products-selector-item-title`—Title of a product selector item. + - `nav-dropdown-products-selector-item-description`—Description of a product selector item. + - `nav-dropdown-products-selector-item-icon`—Icon of a product selector item. - - `sidebar-group` — Group of related sidebar links. - - `sidebar-group-icon` — Icon for a sidebar group. - - `sidebar-group-header` — Header label for a sidebar group. - - `sidebar-title` — Top-level title in the sidebar. - - `sidebar-nav-group-divider` — Divider between sidebar navigation groups. + - `sidebar-group`—Group of related sidebar links. + - `sidebar-group-icon`—Icon for a sidebar group. + - `sidebar-group-header`—Header label for a sidebar group. + - `sidebar-title`—Top-level title in the sidebar. + - `sidebar-nav-group-divider`—Divider between sidebar navigation groups. - - `toc` — Table of contents container. - - `toc-item` — Individual heading entry in the table of contents. + - `toc`—Table of contents container. + - `toc-item`—Individual heading entry in the table of contents. - - `footer` — Standard page footer. Also targetable as an ID selector: `#footer`. - - `advanced-footer` — Extended footer with additional columns or content. + - `footer`—Standard page footer. Also targetable as an ID selector: `#footer`. + - `advanced-footer`—Extended footer with additional columns or content. - - `pagination-prev` — Previous page link in the pagination bar. - - `pagination-next` — Next page link in the pagination bar. - - `pagination-title` — Page title shown in the pagination bar. + - `pagination-prev`—Previous page link in the pagination bar. + - `pagination-next`—Next page link in the pagination bar. + - `pagination-title`—Page title shown in the pagination bar. - - `api-section` — Full section for a single API endpoint. - - `api-section-heading` — Heading area for an API endpoint section. - - `api-section-heading-title` — Title within an API endpoint section heading. - - `api-section-heading-subtitle` — Subtitle within an API endpoint section heading. - - `field` — Parameter or property field in the API reference. - - `option-dropdown` — Dropdown for selecting between API options. - - `tryit-button` — "Try it" button that opens the API playground. - - `method-pill` — HTTP method badge (GET, POST, etc.) on an endpoint. - - `method-nav-pill` — HTTP method badge shown in the sidebar navigation. - - `prompt` — Prompt component in the API reference. + - `api-section`—Full section for a single API endpoint. + - `api-section-heading`—Heading area for an API endpoint section. + - `api-section-heading-title`—Title within an API endpoint section heading. + - `api-section-heading-subtitle`—Subtitle within an API endpoint section heading. + - `field`—Parameter or property field in the API reference. + - `option-dropdown`—Dropdown for selecting between API options. + - `tryit-button`—"Try it" button that opens the API playground. + - `method-pill`—HTTP method badge (GET, POST, etc.) on an endpoint. + - `method-nav-pill`—HTTP method badge shown in the sidebar navigation. + - `prompt`—Prompt component in the API reference. - - `chat-assistant-sheet` — AI assistant panel container. - - `chat-assistant-sheet-header` — Header of the AI assistant panel. - - `chat-assistant-sheet-content` — Content area of the AI assistant panel. - - `chat-assistant-input` — Text input within the AI assistant panel. - - `chat-assistant-floating-input` — Floating input variant of the AI assistant. - - `chat-assistant-send-button` — Send button in the AI assistant panel. - - `chat-assistant-disclaimer-text` — Disclaimer text displayed in the AI assistant panel. - - `chat-assistant-payload-item` — Individual message or result item in the assistant panel. - - `starter-question-text` — Suggested starter question shown in an empty assistant panel. + - `chat-assistant-sheet`—AI assistant panel container. + - `chat-assistant-sheet-header`—Header of the AI assistant panel. + - `chat-assistant-sheet-content`—Content area of the AI assistant panel. + - `chat-assistant-input`—Text input within the AI assistant panel. + - `chat-assistant-floating-input`—Floating input variant of the AI assistant. + - `chat-assistant-send-button`—Send button in the AI assistant panel. + - `chat-assistant-disclaimer-text`—Disclaimer text displayed in the AI assistant panel. + - `chat-assistant-payload-item`—Individual message or result item in the assistant panel. + - `starter-question-text`—Suggested starter question shown in an empty assistant panel. - - `feedback-toolbar` — Toolbar containing page feedback controls. - - `contextual-feedback-container` — Container for contextual inline feedback. - - `contextual-feedback-form` — Inline contextual feedback form. - - `contextual-feedback-form-title` — Title of the contextual feedback form. - - `contextual-feedback-input` — Text input within the contextual feedback form. - - `contextual-feedback-button` — Action button within the contextual feedback form. - - `contextual-feedback-form-submit-button` — Submit button for the contextual feedback form. + - `feedback-toolbar`—Toolbar containing page feedback controls. + - `contextual-feedback-container`—Container for contextual inline feedback. + - `contextual-feedback-form`—Inline contextual feedback form. + - `contextual-feedback-form-title`—Title of the contextual feedback form. + - `contextual-feedback-input`—Text input within the contextual feedback form. + - `contextual-feedback-button`—Action button within the contextual feedback form. + - `contextual-feedback-form-submit-button`—Submit button for the contextual feedback form. - - `code-snippet-feedback-popover-content` — Popover content for code snippet feedback. - - `code-snippet-feedback-form` — Feedback form for a code snippet. - - `code-snippet-feedback-textarea` — Text area within the code snippet feedback form. - - `code-snippet-feedback-form-title` — Title of the code snippet feedback form. - - `code-snippet-feedback-form-description` — Description text in the code snippet feedback form. - - `code-snippet-feedback-form-submit-button` — Submit button for the code snippet feedback form. + - `code-snippet-feedback-popover-content`—Popover content for code snippet feedback. + - `code-snippet-feedback-form`—Feedback form for a code snippet. + - `code-snippet-feedback-textarea`—Text area within the code snippet feedback form. + - `code-snippet-feedback-form-title`—Title of the code snippet feedback form. + - `code-snippet-feedback-form-description`—Description text in the code snippet feedback form. + - `code-snippet-feedback-form-submit-button`—Submit button for the code snippet feedback form. - - `login-link` — Link that initiates the login flow. - - `logout-link` — Link that initiates the logout flow. + - `login-link`—Link that initiates the login flow. + - `logout-link`—Link that initiates the logout flow. - - `multi-view-item` — Individual view option in a multi-view switcher. - - `multi-view-dropdown` — Dropdown for selecting between multiple views. - - `multi-view-dropdown-trigger` — Button that opens the multi-view dropdown. - - `multi-view-dropdown-content` — Content area of the multi-view dropdown. - - `multi-view-dropdown-item` — Individual item within the multi-view dropdown. + - `multi-view-item`—Individual view option in a multi-view switcher. + - `multi-view-dropdown`—Dropdown for selecting between multiple views. + - `multi-view-dropdown-trigger`—Button that opens the multi-view dropdown. + - `multi-view-dropdown-content`—Content area of the multi-view dropdown. + - `multi-view-dropdown-item`—Individual item within the multi-view dropdown. - - `directory` — Root container for a directory page. - - `directory-group` — Group of related pages within a directory. - - `directory-page` — Individual page entry in a directory. - - `directory-card` — Card-style page entry in a directory. + - `directory`—Root container for a directory page. + - `directory-group`—Group of related pages within a directory. + - `directory-page`—Individual page entry in a directory. + - `directory-card`—Card-style page entry in a directory. - - `not-found-container` — Root container of the 404 page. - - `not-found-status-code` — Status code display on the 404 page. - - `not-found-title` — Title heading on the 404 page. - - `not-found-description` — Description text on the 404 page. - - `not-found-recommended-pages-list` — List of recommended pages shown on the 404 page. - - `not-found-recommended-page-link` — Individual link in the recommended pages list. + - `not-found-container`—Root container of the 404 page. + - `not-found-status-code`—Status code display on the 404 page. + - `not-found-title`—Title heading on the 404 page. + - `not-found-description`—Description text on the 404 page. + - `not-found-recommended-pages-list`—List of recommended pages shown on the 404 page. + - `not-found-recommended-page-link`—Individual link in the recommended pages list. - - `color` — Color swatch element. - - `color-row` — Row grouping color swatches. - - `color-item` — Individual color item within a color row. + - `color`—Color swatch element. + - `color-row`—Row grouping color swatches. + - `color-item`—Individual color item within a color row. - - `tree` — File tree container. - - `tree-folder` — Folder entry within a file tree. - - `tree-file` — File entry within a file tree. + - `tree`—File tree container. + - `tree-folder`—Folder entry within a file tree. + - `tree-file`—File entry within a file tree. Some elements expose data attributes you can use as CSS selectors. Active state (`data-active`): - - `nav-dropdown-item[data-active]` — Active item in a nav dropdown. - - `mobile-nav-tabs-item[data-active]` — Active tab in the mobile nav. - - `sidebar-group[data-active]` — Active sidebar group. - - `#sidebar-content li[data-active]` — Active sidebar link. - - `.nav-tabs-item[data-active]` — Active top nav tab. Only applies to simple tabs; tabs with dropdown menus do not receive `data-active`. Note the leading `.`: this targets a class on a standard `` element, unlike most other components which use custom element names. - - `toc-item[data-active]` — Active table of contents item. - - `toc-item[data-active-deepest]` — Deepest active table of contents item. Only present on the exact heading currently in view, unlike `data-active` which is also set on its parent headings. + - `nav-dropdown-item[data-active]`—Active item in a nav dropdown. + - `mobile-nav-tabs-item[data-active]`—Active tab in the mobile nav. + - `sidebar-group[data-active]`—Active sidebar group. + - `#sidebar-content li[data-active]`—Active sidebar link. + - `.nav-tabs-item[data-active]`—Active top nav tab. Only applies to simple tabs; tabs with dropdown menus do not receive `data-active`. Note the leading `.`: this targets a class on a standard `` element, unlike most other components which use custom element names. + - `toc-item[data-active]`—Active table of contents item. + - `toc-item[data-active-deepest]`—Deepest active table of contents item. Only present on the exact heading currently in view, unlike `data-active` which is also set on its parent headings. Component name (`data-component-name`): Use `data-component-name` to target specific UI components with a stable selector that persists if internal class names change. - - `[data-component-name="mermaid-container"]` — Mermaid diagram wrapper, including the zoom controls overlay. - - `[data-component-name="mermaid-controls-wrapper"]` — Mermaid zoom and pan controls. - - `[data-component-name="primary-header-button"]` — Primary header button. Sequoia theme only. - - `[data-component-name="theme-toggle"]` — Theme toggle. + - `[data-component-name="mermaid-container"]`—Mermaid diagram wrapper, including the zoom controls overlay. + - `[data-component-name="mermaid-controls-wrapper"]`—Mermaid zoom and pan controls. + - `[data-component-name="primary-header-button"]`—Primary header button. Sequoia theme only. + - `[data-component-name="theme-toggle"]`—Theme toggle. Component part (`data-component-part`): Use `data-component-part` to target sub-elements within a component. - - `[data-component-part="contact-support-button"]` — The `` wrapper around the contact support link in the assistant panel. - - `[data-component-part="contact-support-icon"]` — The `` wrapping the icon. - - `[data-component-part="contact-support-text"]` — The `

` element containing the label. + - `[data-component-part="contact-support-button"]`—The `` wrapper around the contact support link in the assistant panel. + - `[data-component-part="contact-support-icon"]`—The `` wrapping the icon. + - `[data-component-part="contact-support-text"]`—The `

` element containing the label. Badge attributes: - - `[data-badge]` — Any badge element. - - `[data-badge][data-color="blue"]` — Badge filtered by color. - - `[data-badge][data-size="sm"]` — Badge filtered by size. + - `[data-badge]`—Any badge element. + - `[data-badge][data-color="blue"]`—Badge filtered by color. + - `[data-badge][data-size="sm"]`—Badge filtered by size. Current path (`data-current-path`): Use `data-current-path` to style custom CSS on specific pages or subpaths. - - `html[data-current-path="/"]` — Matches the root page. - - `html[data-current-path="/quickstart"]` — Matches a specific page. - - `html[data-current-path^="/api-reference/"]` — Matches any page under a section. + - `html[data-current-path="/"]`—Matches the root page. + - `html[data-current-path="/quickstart"]`—Matches a specific page. + - `html[data-current-path^="/api-reference/"]`—Matches any page under a section. diff --git a/dashboard/sso.mdx b/dashboard/sso.mdx index 26e5ef22cd..03fddaf0b9 100644 --- a/dashboard/sso.mdx +++ b/dashboard/sso.mdx @@ -175,7 +175,7 @@ The resulting SAML assertion should include an `AttributeStatement`. | Name | Name format | Filter | Value | | ---- | ----------- | ------ | ----- | - | `groups` | Unspecified | Matches regex | `.*` | + | `groups` | Unspecified | `Matches regex` | `.*` | Adjust the filter to match the specific groups you want to send to Mintlify. diff --git a/enterprise-contracting.mdx b/enterprise-contracting.mdx index 475da9c0b1..1eb68d466e 100644 --- a/enterprise-contracting.mdx +++ b/enterprise-contracting.mdx @@ -83,7 +83,7 @@ These are structural to how the platform operates. We'll explain each one—not **Why:** We use third-party LLM providers whose output we can't warrant. No software company can guarantee outcomes that depend on customer data, use cases, or third-party integrations. - **What this means for you:** We will warrant in writing that our LLM providers are contractually prohibited from using your data for model training or improvement—which is the protection that actually matters. + **What this means for you:** We warrant in writing that our LLM providers are contractually prohibited from using your data for model training or improvement—which is the protection that actually matters. diff --git a/guides/knowledge-base.mdx b/guides/knowledge-base.mdx index 6ade4decbc..c4c44f0f97 100644 --- a/guides/knowledge-base.mdx +++ b/guides/knowledge-base.mdx @@ -209,7 +209,7 @@ This works well for subject matter experts who know the content but aren't comfo The [agent](/agent/index) in your dashboard creates documentation updates from natural language prompts. Describe what you want to change, and the agent creates a pull request with the updates. -For example, you could prompt the agent with "add a section to the expense policy page explaining how to submit receipts for meals over $50". You could also copy the existing expense policy page into the prompt. The agent would draft the content and open a PR for review. +For example, you could prompt the agent with "add a section to the expense policy page explaining how to submit receipts for meals over $50." You could also copy the existing expense policy page into the prompt. The agent would draft the content and open a PR for review. ### Capture knowledge from Slack diff --git a/organize/settings-seo.mdx b/organize/settings-seo.mdx index b084dd395e..4b2c209358 100644 --- a/organize/settings-seo.mdx +++ b/organize/settings-seo.mdx @@ -29,8 +29,8 @@ Search engine indexing and metadata settings. Specifies which pages search engines should index. - - `navigable` — Index only pages included in your `docs.json` navigation. Defaults to this value. - - `all` — Index every page in your project, including pages not in the navigation. + - `navigable`—Index only pages included in your `docs.json` navigation. Defaults to this value. + - `all`—Index every page in your project, including pages not in the navigation. @@ -49,12 +49,12 @@ Search engine indexing and metadata settings. The organization used as the publisher entity in the [structured data](/optimize/seo#structured-data) emitted on every page. All fields are optional. If you omit this object, Mintlify derives the organization from your site name, docs logo, and site URL. - - `id` — Stable `@id` URL identifying your organization across pages, for example `https://example.com/#organization`. Defaults to `/#organization`. - - `name` — Organization name. Defaults to the site name. - - `legalName` — Registered legal name. - - `url` — Canonical organization homepage URL. - - `logo` — Canonical logo URL used in structured data. Defaults to the docs logo. - - `sameAs` — Array of URLs for official profiles, such as X, LinkedIn, or GitHub. + - `id`—Stable `@id` URL identifying your organization across pages, for example `https://example.com/#organization`. Defaults to `/#organization`. + - `name`—Organization name. Defaults to the site name. + - `legalName`—Registered legal name. + - `url`—Canonical organization homepage URL. + - `logo`—Canonical logo URL used in structured data. Defaults to the docs logo. + - `sameAs`—Array of URLs for official profiles, such as X, LinkedIn, or GitHub. ```json "organization": { From e871402418fda34c8fad8ae3f7d782ccb29cc2f2 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 13 Aug 2026 15:24:06 +0000 Subject: [PATCH 2/2] docs: mirror vale style fixes to es/fr/zh translations --- es/api-playground/sdk-reference-setup.mdx | 2 +- es/assistant/use.mdx | 8 +- es/customize/custom-scripts.mdx | 370 +++++++++++----------- es/dashboard/sso.mdx | 2 +- es/enterprise-contracting.mdx | 2 +- es/organize/settings-seo.mdx | 16 +- fr/api-playground/sdk-reference-setup.mdx | 2 +- fr/assistant/use.mdx | 10 +- fr/customize/custom-scripts.mdx | 370 +++++++++++----------- fr/dashboard/sso.mdx | 2 +- fr/enterprise-contracting.mdx | 2 +- fr/organize/settings-seo.mdx | 16 +- zh/api-playground/sdk-reference-setup.mdx | 2 +- zh/assistant/use.mdx | 8 +- zh/customize/custom-scripts.mdx | 370 +++++++++++----------- zh/dashboard/sso.mdx | 2 +- zh/enterprise-contracting.mdx | 2 +- zh/organize/settings-seo.mdx | 16 +- 18 files changed, 601 insertions(+), 601 deletions(-) diff --git a/es/api-playground/sdk-reference-setup.mdx b/es/api-playground/sdk-reference-setup.mdx index 4bc6314477..f945992595 100644 --- a/es/api-playground/sdk-reference-setup.mdx +++ b/es/api-playground/sdk-reference-setup.mdx @@ -70,7 +70,7 @@ Agrega una propiedad `sdk` a una pestaña o grupo en tu `docs.json`. Mintlify an } ``` -Agrega `sdk` a un grupo para generar páginas dentro de una sección de una pestaña en lugar de en toda la pestaña. Los grupos y páginas heredan la configuración de `sdk` de la pestaña o grupo que está por encima de ellos. Si un grupo anidado define su propio `sdk`, Mintlify usa esa configuración en lugar de la heredada. +Agrega `sdk` a un grupo para generar páginas dentro de una sección de una pestaña en lugar de en toda la pestaña. Los grupos y páginas heredan la configuración de `sdk` de la pestaña o grupo superior. Si un grupo anidado define su propio `sdk`, Mintlify usa esa configuración en lugar de la heredada. ```json { diff --git a/es/assistant/use.mdx b/es/assistant/use.mdx index e0077ad247..23606f19f5 100644 --- a/es/assistant/use.mdx +++ b/es/assistant/use.mdx @@ -145,10 +145,10 @@ Límites: **Para lectores:** Pídele a tu equipo de TI que permita solicitudes HTTPS salientes a los siguientes hosts desde tu red. Si puedes, prueba el assistant desde una red personal para confirmar que el problema es específico de la red. - - `leaves.mintlify.com` — API del assistant - - `*.mintlify.dev` — streaming del assistant y servicios de soporte - - `*.mintlify.com` — dashboard, API y analíticas - - `hcaptcha.com` y `*.hcaptcha.com` — verificación CAPTCHA para el assistant + - `leaves.mintlify.com`—API del assistant + - `*.mintlify.dev`—streaming del assistant y servicios de soporte + - `*.mintlify.com`—dashboard, API y analíticas + - `hcaptcha.com` y `*.hcaptcha.com`—verificación CAPTCHA para el assistant **Para propietarios del sitio:** Si un lector informa que el assistant no se carga en su red corporativa o VPN, casi siempre se trata de un bloqueo de red saliente y no de un problema con tu documentación. Indícale los hosts anteriores y sugiérele que comparta la lista con su equipo de TI. Se trata de una lista de permitidos a nivel de red que se aplica al dispositivo o la red del visitante, no algo que puedas configurar desde tu sitio. Si tu documentación está autoalojada detrás de un proxy inverso que sobrescribe la CSP predeterminada, consulta [Configuración de CSP](/es/deploy/csp-configuration) para conocer los dominios que debes permitir. diff --git a/es/customize/custom-scripts.mdx b/es/customize/custom-scripts.mdx index 0d9e9331c2..9dbf1f1382 100644 --- a/es/customize/custom-scripts.mdx +++ b/es/customize/custom-scripts.mdx @@ -90,81 +90,81 @@ Cada ID aparece una vez por página. Úsalos como `#value` en CSS. Por ejemplo, - - `#body-content` — Contenedor exterior del cuerpo de la página. - - `#content-area` — Área de contenido principal, excluyendo la barra lateral y la tabla de contenidos. - - `#content` — Elemento de contenido interno dentro del área de contenido. - - `#header` — Elemento de encabezado a nivel de página. - - `#banner` — Banner de anuncios que se muestra sobre la barra de navegación. - - `#footer` — Pie de página. También se puede apuntar como selector de elemento: `footer`. - - `#page-title` — El encabezado `

` en la parte superior de cada página. - - `#pagination` — Barra de paginación inferior con enlaces a la página anterior y siguiente. - - `#panel` — Panel flotante superpuesto. También se puede apuntar como selector de elemento: `panel`. - - `#background-color` — Elemento de color de fondo de la página. + - `#body-content`—Contenedor exterior del cuerpo de la página. + - `#content-area`—Área de contenido principal, excluyendo la barra lateral y la tabla de contenidos. + - `#content`—Elemento de contenido interno dentro del área de contenido. + - `#header`—Elemento de encabezado a nivel de página. + - `#banner`—Banner de anuncios que se muestra sobre la barra de navegación. + - `#footer`—Pie de página. También se puede apuntar como selector de elemento: `footer`. + - `#page-title`—El encabezado `

` en la parte superior de cada página. + - `#pagination`—Barra de paginación inferior con enlaces a la página anterior y siguiente. + - `#panel`—Panel flotante superpuesto. También se puede apuntar como selector de elemento: `panel`. + - `#background-color`—Elemento de color de fondo de la página. - - `#navbar` — Barra de navegación superior. - - `#topbar-cta-button` — Botón de llamada a la acción en la barra superior. - - `#mobile-nav` — Superposición de navegación móvil. - - `#mobile-nav-content` — Área de contenido dentro de la superposición de navegación móvil. + - `#navbar`—Barra de navegación superior. + - `#topbar-cta-button`—Botón de llamada a la acción en la barra superior. + - `#mobile-nav`—Superposición de navegación móvil. + - `#mobile-nav-content`—Área de contenido dentro de la superposición de navegación móvil. - - `#sidebar` — Panel de navegación de la barra lateral. - - `#sidebar-content` — Área de contenido con desplazamiento dentro de la barra lateral. + - `#sidebar`—Panel de navegación de la barra lateral. + - `#sidebar-content`—Área de contenido con desplazamiento dentro de la barra lateral. - - `#table-of-contents` — Panel de tabla de contenidos en el lado derecho de la página. - - `#table-of-contents-layout` — Contenedor de diseño para la tabla de contenidos. - - `#table-of-contents-content` — Contenido con desplazamiento dentro de la tabla de contenidos. + - `#table-of-contents`—Panel de tabla de contenidos en el lado derecho de la página. + - `#table-of-contents-layout`—Contenedor de diseño para la tabla de contenidos. + - `#table-of-contents-content`—Contenido con desplazamiento dentro de la tabla de contenidos. - - `#search-bar-entry` — Disparador de la barra de búsqueda en la barra superior. - - `#search-bar-entry-mobile` — Disparador de la barra de búsqueda en móvil. - - `#search-input` — Campo de entrada de texto dentro del modal de búsqueda. + - `#search-bar-entry`—Disparador de la barra de búsqueda en la barra superior. + - `#search-bar-entry-mobile`—Disparador de la barra de búsqueda en móvil. + - `#search-input`—Campo de entrada de texto dentro del modal de búsqueda. - - `#assistant-entry` — Botón del asistente IA en la barra superior. - - `#assistant-entry-mobile` — Botón del asistente IA en móvil. - - `#chat-assistant-sheet` — Panel del chat del asistente IA. - - `#chat-assistant-textarea` — Entrada de texto dentro del panel del asistente IA. + - `#assistant-entry`—Botón del asistente IA en la barra superior. + - `#assistant-entry-mobile`—Botón del asistente IA en móvil. + - `#chat-assistant-sheet`—Panel del chat del asistente IA. + - `#chat-assistant-textarea`—Entrada de texto dentro del panel del asistente IA. - - `#request-example` — Panel de ejemplo de solicitud en el playground de API. - - `#response-example` — Panel de ejemplo de respuesta en el playground de API. - - `#api-playground-input` — Sección de entrada del playground de API. - - `#endpoints-menu-trigger` — Botón que abre el desplegable del selector de endpoints. + - `#request-example`—Panel de ejemplo de solicitud en el playground de API. + - `#response-example`—Panel de ejemplo de respuesta en el playground de API. + - `#api-playground-input`—Sección de entrada del playground de API. + - `#endpoints-menu-trigger`—Botón que abre el desplegable del selector de endpoints. - - `#ask-assistant-code-block-button` — Botón "Preguntar al asistente" que aparece en los bloques de código. - - `#code-snippet-feedback-button` — Botón de retroalimentación en los fragmentos de código. - - `#code-snippet-feedback-textarea` — Área de texto dentro del formulario de retroalimentación de fragmentos de código. + - `#ask-assistant-code-block-button`—Botón "Preguntar al asistente" que aparece en los bloques de código. + - `#code-snippet-feedback-button`—Botón de retroalimentación en los fragmentos de código. + - `#code-snippet-feedback-textarea`—Área de texto dentro del formulario de retroalimentación de fragmentos de código. - - `#feedback-thumbs-up` — Botón de pulgar arriba en la parte inferior de la página. - - `#feedback-thumbs-down` — Botón de pulgar abajo en la parte inferior de la página. - - `#feedback-form` — Formulario de retroalimentación mostrado después de una respuesta negativa. - - `#feedback-form-input` — Campo de texto dentro del formulario de retroalimentación. - - `#feedback-form-cancel` — Botón de cancelar dentro del formulario de retroalimentación. - - `#feedback-form-submit` — Botón de enviar dentro del formulario de retroalimentación. + - `#feedback-thumbs-up`—Botón de pulgar arriba en la parte inferior de la página. + - `#feedback-thumbs-down`—Botón de pulgar abajo en la parte inferior de la página. + - `#feedback-form`—Formulario de retroalimentación mostrado después de una respuesta negativa. + - `#feedback-form-input`—Campo de texto dentro del formulario de retroalimentación. + - `#feedback-form-cancel`—Botón de cancelar dentro del formulario de retroalimentación. + - `#feedback-form-submit`—Botón de enviar dentro del formulario de retroalimentación. - - `#page-context-menu` — Menú de opciones contextuales para la página actual. - - `#page-context-menu-button` — Botón que abre el menú contextual de la página. + - `#page-context-menu`—Menú de opciones contextuales para la página actual. + - `#page-context-menu-button`—Botón que abre el menú contextual de la página. - - `#localization-select-trigger` — Botón que abre el selector de idioma. - - `#localization-select-content` — Contenido del desplegable del selector de idioma. - - `#localization-select-item` — Opción individual de idioma dentro del selector. + - `#localization-select-trigger`—Botón que abre el selector de idioma. + - `#localization-select-content`—Contenido del desplegable del selector de idioma. + - `#localization-select-item`—Opción individual de idioma dentro del selector. - - `#changelog-filters` — Controles de filtro en una página de registro de cambios. - - `#changelog-filters-content` — Área de contenido dentro del panel de filtros del registro de cambios. + - `#changelog-filters`—Controles de filtro en una página de registro de cambios. + - `#changelog-filters-content`—Área de contenido dentro del panel de filtros del registro de cambios. - - `#multi-view-dropdown` — Desplegable para cambiar entre vistas de documentación. + - `#multi-view-dropdown`—Desplegable para cambiar entre vistas de documentación. - - `#text-selection-tooltip` — Tooltip que aparece al seleccionar texto en la página. - - `#text-selection-tooltip-button` — Botón de acción dentro del tooltip de selección de texto. + - `#text-selection-tooltip`—Tooltip que aparece al seleccionar texto en la página. + - `#text-selection-tooltip-button`—Botón de acción dentro del tooltip de selección de texto. @@ -176,202 +176,202 @@ Pueden aparecer múltiples instancias de estos elementos en una página. Úsalos - - `accordion` — Elemento de acordeón desplegable. - - `accordion-group` — Contenedor que agrupa múltiples acordeones. - - `callout` — Bloque de llamada de atención (Note, Warning, Tip, etc.). - - `card` — Elemento de tarjeta individual. - - `card-group` — Contenedor que agrupa múltiples tarjetas. Obsoleto a favor de `columns`, pero conservado por compatibilidad. - - `columns` — Contenedor de diseño multicolumna. - - `code-block` — Elemento de bloque de código. - - `code-block-icon` — Icono mostrado en el encabezado de un bloque de código. - - `code-group` — Grupo con pestañas de bloques de código. - - `expandable` — Elemento de sección expandible. - - `frame` — Contenedor de marco para imágenes o contenido incrustado. - - `icon` — Elemento de icono en línea. - - `mermaid` — Contenedor de diagrama Mermaid. - - `step` — Paso individual dentro de una secuencia de pasos. - - `steps` — Contenedor de pasos numerados. - - `tab-icon` — Icono mostrado dentro de una pestaña. - - `tabs` — Contenedor de contenido con pestañas. - - `tile` — Elemento de componente tile. - - `tooltip` — Elemento de tooltip. - - `update` — Entrada de actualización del registro de cambios. + - `accordion`—Elemento de acordeón desplegable. + - `accordion-group`—Contenedor que agrupa múltiples acordeones. + - `callout`—Bloque de llamada de atención (Note, Warning, Tip, etc.). + - `card`—Elemento de tarjeta individual. + - `card-group`—Contenedor que agrupa múltiples tarjetas. Obsoleto a favor de `columns`, pero conservado por compatibilidad. + - `columns`—Contenedor de diseño multicolumna. + - `code-block`—Elemento de bloque de código. + - `code-block-icon`—Icono mostrado en el encabezado de un bloque de código. + - `code-group`—Grupo con pestañas de bloques de código. + - `expandable`—Elemento de sección expandible. + - `frame`—Contenedor de marco para imágenes o contenido incrustado. + - `icon`—Elemento de icono en línea. + - `mermaid`—Contenedor de diagrama Mermaid. + - `step`—Paso individual dentro de una secuencia de pasos. + - `steps`—Contenedor de pasos numerados. + - `tab-icon`—Icono mostrado dentro de una pestaña. + - `tabs`—Contenedor de contenido con pestañas. + - `tile`—Elemento de componente tile. + - `tooltip`—Elemento de tooltip. + - `update`—Entrada de actualización del registro de cambios. - - `mdx-content` — Área de contenido MDX renderizado. - - `panel` — Componente de panel flotante. También se puede apuntar como selector de ID: `#panel`. - - `eyebrow` — Pequeña etiqueta que se muestra sobre el título de la página. - - `link` — Elemento de enlace anchor. - - `breadcrumb-list` — Lista de navegación por migas de pan. - - `breadcrumb-item` — Elemento individual de miga de pan. + - `mdx-content`—Área de contenido MDX renderizado. + - `panel`—Componente de panel flotante. También se puede apuntar como selector de ID: `#panel`. + - `eyebrow`—Pequeña etiqueta que se muestra sobre el título de la página. + - `link`—Elemento de enlace anchor. + - `breadcrumb-list`—Lista de navegación por migas de pan. + - `breadcrumb-item`—Elemento individual de miga de pan. - - `nav-logo` — Logo en la barra de navegación. - - `navbar-link` — Elemento de enlace dentro de la barra de navegación. - - `nav-anchors` — Contenedor de enlaces de anclaje en la barra superior. - - `nav-anchor` — Enlace de anclaje individual en la barra superior. - - `nav-tabs` — Barra de pestañas en la navegación superior. - - `nav-tabs-item` — Elemento de pestaña individual en la barra de pestañas de la navegación superior. - - `mobile-nav-tabs-item` — Elemento de pestaña en la barra de pestañas de la navegación móvil. - - `topbar-right-container` — Sección derecha de la barra superior. - - `nav-tag-pill` — Etiqueta tipo píldora en la navegación. - - `nav-tag-pill-text` — Texto dentro de una etiqueta tipo píldora de navegación. + - `nav-logo`—Logo en la barra de navegación. + - `navbar-link`—Elemento de enlace dentro de la barra de navegación. + - `nav-anchors`—Contenedor de enlaces de anclaje en la barra superior. + - `nav-anchor`—Enlace de anclaje individual en la barra superior. + - `nav-tabs`—Barra de pestañas en la navegación superior. + - `nav-tabs-item`—Elemento de pestaña individual en la barra de pestañas de la navegación superior. + - `mobile-nav-tabs-item`—Elemento de pestaña en la barra de pestañas de la navegación móvil. + - `topbar-right-container`—Sección derecha de la barra superior. + - `nav-tag-pill`—Etiqueta tipo píldora en la navegación. + - `nav-tag-pill-text`—Texto dentro de una etiqueta tipo píldora de navegación. - - `nav-dropdown-trigger` — Botón que abre un desplegable de navegación. - - `nav-dropdown-content` — Contenedor de contenido de un desplegable de navegación. - - `nav-dropdown-item` — Elemento individual dentro de un desplegable de navegación. - - `nav-dropdown-item-text-container` — Contenedor de texto dentro de un elemento del desplegable. - - `nav-dropdown-item-title` — Texto del título dentro de un elemento del desplegable. - - `nav-dropdown-item-description` — Texto de descripción dentro de un elemento del desplegable. - - `nav-dropdown-item-icon` — Icono dentro de un elemento del desplegable. + - `nav-dropdown-trigger`—Botón que abre un desplegable de navegación. + - `nav-dropdown-content`—Contenedor de contenido de un desplegable de navegación. + - `nav-dropdown-item`—Elemento individual dentro de un desplegable de navegación. + - `nav-dropdown-item-text-container`—Contenedor de texto dentro de un elemento del desplegable. + - `nav-dropdown-item-title`—Texto del título dentro de un elemento del desplegable. + - `nav-dropdown-item-description`—Texto de descripción dentro de un elemento del desplegable. + - `nav-dropdown-item-icon`—Icono dentro de un elemento del desplegable. - - `nav-dropdown-products-selector-trigger` — Botón que abre el desplegable del selector de productos. - - `nav-dropdown-products-selector-content` — Contenedor de contenido del selector de productos. - - `nav-dropdown-products-selector-item` — Producto individual en el selector. - - `nav-dropdown-products-selector-item-title` — Título de un elemento del selector de productos. - - `nav-dropdown-products-selector-item-description` — Descripción de un elemento del selector de productos. - - `nav-dropdown-products-selector-item-icon` — Icono de un elemento del selector de productos. + - `nav-dropdown-products-selector-trigger`—Botón que abre el desplegable del selector de productos. + - `nav-dropdown-products-selector-content`—Contenedor de contenido del selector de productos. + - `nav-dropdown-products-selector-item`—Producto individual en el selector. + - `nav-dropdown-products-selector-item-title`—Título de un elemento del selector de productos. + - `nav-dropdown-products-selector-item-description`—Descripción de un elemento del selector de productos. + - `nav-dropdown-products-selector-item-icon`—Icono de un elemento del selector de productos. - - `sidebar-group` — Grupo de enlaces relacionados en la barra lateral. - - `sidebar-group-icon` — Icono de un grupo de la barra lateral. - - `sidebar-group-header` — Etiqueta de encabezado de un grupo de la barra lateral. - - `sidebar-title` — Título de nivel superior en la barra lateral. - - `sidebar-nav-group-divider` — Divisor entre grupos de navegación de la barra lateral. + - `sidebar-group`—Grupo de enlaces relacionados en la barra lateral. + - `sidebar-group-icon`—Icono de un grupo de la barra lateral. + - `sidebar-group-header`—Etiqueta de encabezado de un grupo de la barra lateral. + - `sidebar-title`—Título de nivel superior en la barra lateral. + - `sidebar-nav-group-divider`—Divisor entre grupos de navegación de la barra lateral. - - `toc` — Contenedor de la tabla de contenidos. - - `toc-item` — Entrada individual de encabezado en la tabla de contenidos. + - `toc`—Contenedor de la tabla de contenidos. + - `toc-item`—Entrada individual de encabezado en la tabla de contenidos. - - `footer` — Pie de página estándar. También se puede apuntar como selector de ID: `#footer`. - - `advanced-footer` — Pie de página extendido con columnas o contenido adicional. + - `footer`—Pie de página estándar. También se puede apuntar como selector de ID: `#footer`. + - `advanced-footer`—Pie de página extendido con columnas o contenido adicional. - - `pagination-prev` — Enlace a la página anterior en la barra de paginación. - - `pagination-next` — Enlace a la página siguiente en la barra de paginación. - - `pagination-title` — Título de página que se muestra en la barra de paginación. + - `pagination-prev`—Enlace a la página anterior en la barra de paginación. + - `pagination-next`—Enlace a la página siguiente en la barra de paginación. + - `pagination-title`—Título de página que se muestra en la barra de paginación. - - `api-section` — Sección completa para un endpoint de API. - - `api-section-heading` — Área de encabezado de una sección de endpoint de API. - - `api-section-heading-title` — Título dentro del encabezado de una sección de endpoint de API. - - `api-section-heading-subtitle` — Subtítulo dentro del encabezado de una sección de endpoint de API. - - `field` — Campo de parámetro o propiedad en la referencia de API. - - `option-dropdown` — Desplegable para seleccionar entre opciones de API. - - `tryit-button` — Botón "Try it" que abre el playground de API. - - `method-pill` — Insignia de método HTTP (GET, POST, etc.) en un endpoint. - - `method-nav-pill` — Insignia de método HTTP que se muestra en la navegación de la barra lateral. - - `prompt` — Componente de prompt en la referencia de API. + - `api-section`—Sección completa para un endpoint de API. + - `api-section-heading`—Área de encabezado de una sección de endpoint de API. + - `api-section-heading-title`—Título dentro del encabezado de una sección de endpoint de API. + - `api-section-heading-subtitle`—Subtítulo dentro del encabezado de una sección de endpoint de API. + - `field`—Campo de parámetro o propiedad en la referencia de API. + - `option-dropdown`—Desplegable para seleccionar entre opciones de API. + - `tryit-button`—Botón "Try it" que abre el playground de API. + - `method-pill`—Insignia de método HTTP (GET, POST, etc.) en un endpoint. + - `method-nav-pill`—Insignia de método HTTP que se muestra en la navegación de la barra lateral. + - `prompt`—Componente de prompt en la referencia de API. - - `chat-assistant-sheet` — Contenedor del panel del asistente IA. - - `chat-assistant-sheet-header` — Encabezado del panel del asistente IA. - - `chat-assistant-sheet-content` — Área de contenido del panel del asistente IA. - - `chat-assistant-input` — Entrada de texto dentro del panel del asistente IA. - - `chat-assistant-floating-input` — Variante de entrada flotante del asistente IA. - - `chat-assistant-send-button` — Botón de enviar en el panel del asistente IA. - - `chat-assistant-disclaimer-text` — Texto de descargo de responsabilidad en el panel del asistente IA. - - `chat-assistant-payload-item` — Mensaje o resultado individual en el panel del asistente. - - `starter-question-text` — Pregunta sugerida de inicio mostrada en un panel de asistente vacío. + - `chat-assistant-sheet`—Contenedor del panel del asistente IA. + - `chat-assistant-sheet-header`—Encabezado del panel del asistente IA. + - `chat-assistant-sheet-content`—Área de contenido del panel del asistente IA. + - `chat-assistant-input`—Entrada de texto dentro del panel del asistente IA. + - `chat-assistant-floating-input`—Variante de entrada flotante del asistente IA. + - `chat-assistant-send-button`—Botón de enviar en el panel del asistente IA. + - `chat-assistant-disclaimer-text`—Texto de descargo de responsabilidad en el panel del asistente IA. + - `chat-assistant-payload-item`—Mensaje o resultado individual en el panel del asistente. + - `starter-question-text`—Pregunta sugerida de inicio mostrada en un panel de asistente vacío. - - `feedback-toolbar` — Barra de herramientas que contiene controles de retroalimentación de la página. - - `contextual-feedback-container` — Contenedor para retroalimentación contextual en línea. - - `contextual-feedback-form` — Formulario de retroalimentación contextual en línea. - - `contextual-feedback-form-title` — Título del formulario de retroalimentación contextual. - - `contextual-feedback-input` — Campo de texto dentro del formulario de retroalimentación contextual. - - `contextual-feedback-button` — Botón de acción dentro del formulario de retroalimentación contextual. - - `contextual-feedback-form-submit-button` — Botón de envío del formulario de retroalimentación contextual. + - `feedback-toolbar`—Barra de herramientas que contiene controles de retroalimentación de la página. + - `contextual-feedback-container`—Contenedor para retroalimentación contextual en línea. + - `contextual-feedback-form`—Formulario de retroalimentación contextual en línea. + - `contextual-feedback-form-title`—Título del formulario de retroalimentación contextual. + - `contextual-feedback-input`—Campo de texto dentro del formulario de retroalimentación contextual. + - `contextual-feedback-button`—Botón de acción dentro del formulario de retroalimentación contextual. + - `contextual-feedback-form-submit-button`—Botón de envío del formulario de retroalimentación contextual. - - `code-snippet-feedback-popover-content` — Contenido del popover para retroalimentación de fragmentos de código. - - `code-snippet-feedback-form` — Formulario de retroalimentación para un fragmento de código. - - `code-snippet-feedback-textarea` — Área de texto dentro del formulario de retroalimentación del fragmento de código. - - `code-snippet-feedback-form-title` — Título del formulario de retroalimentación del fragmento de código. - - `code-snippet-feedback-form-description` — Texto descriptivo en el formulario de retroalimentación del fragmento de código. - - `code-snippet-feedback-form-submit-button` — Botón de envío del formulario de retroalimentación del fragmento de código. + - `code-snippet-feedback-popover-content`—Contenido del popover para retroalimentación de fragmentos de código. + - `code-snippet-feedback-form`—Formulario de retroalimentación para un fragmento de código. + - `code-snippet-feedback-textarea`—Área de texto dentro del formulario de retroalimentación del fragmento de código. + - `code-snippet-feedback-form-title`—Título del formulario de retroalimentación del fragmento de código. + - `code-snippet-feedback-form-description`—Texto descriptivo en el formulario de retroalimentación del fragmento de código. + - `code-snippet-feedback-form-submit-button`—Botón de envío del formulario de retroalimentación del fragmento de código. - - `login-link` — Enlace que inicia el flujo de inicio de sesión. - - `logout-link` — Enlace que inicia el flujo de cierre de sesión. + - `login-link`—Enlace que inicia el flujo de inicio de sesión. + - `logout-link`—Enlace que inicia el flujo de cierre de sesión. - - `multi-view-item` — Opción de vista individual en un conmutador de multi-vista. - - `multi-view-dropdown` — Desplegable para seleccionar entre múltiples vistas. - - `multi-view-dropdown-trigger` — Botón que abre el desplegable de multi-vista. - - `multi-view-dropdown-content` — Área de contenido del desplegable de multi-vista. - - `multi-view-dropdown-item` — Elemento individual dentro del desplegable de multi-vista. + - `multi-view-item`—Opción de vista individual en un conmutador de multi-vista. + - `multi-view-dropdown`—Desplegable para seleccionar entre múltiples vistas. + - `multi-view-dropdown-trigger`—Botón que abre el desplegable de multi-vista. + - `multi-view-dropdown-content`—Área de contenido del desplegable de multi-vista. + - `multi-view-dropdown-item`—Elemento individual dentro del desplegable de multi-vista. - - `directory` — Contenedor raíz para una página de directorio. - - `directory-group` — Grupo de páginas relacionadas dentro de un directorio. - - `directory-page` — Entrada de página individual en un directorio. - - `directory-card` — Entrada de página tipo tarjeta en un directorio. + - `directory`—Contenedor raíz para una página de directorio. + - `directory-group`—Grupo de páginas relacionadas dentro de un directorio. + - `directory-page`—Entrada de página individual en un directorio. + - `directory-card`—Entrada de página tipo tarjeta en un directorio. - - `not-found-container` — Contenedor raíz de la página 404. - - `not-found-status-code` — Visualización del código de estado en la página 404. - - `not-found-title` — Encabezado del título en la página 404. - - `not-found-description` — Texto descriptivo en la página 404. - - `not-found-recommended-pages-list` — Lista de páginas recomendadas mostradas en la página 404. - - `not-found-recommended-page-link` — Enlace individual en la lista de páginas recomendadas. + - `not-found-container`—Contenedor raíz de la página 404. + - `not-found-status-code`—Visualización del código de estado en la página 404. + - `not-found-title`—Encabezado del título en la página 404. + - `not-found-description`—Texto descriptivo en la página 404. + - `not-found-recommended-pages-list`—Lista de páginas recomendadas mostradas en la página 404. + - `not-found-recommended-page-link`—Enlace individual en la lista de páginas recomendadas. - - `color` — Elemento de muestra de color. - - `color-row` — Fila que agrupa muestras de color. - - `color-item` — Elemento de color individual dentro de una fila de colores. + - `color`—Elemento de muestra de color. + - `color-row`—Fila que agrupa muestras de color. + - `color-item`—Elemento de color individual dentro de una fila de colores. - - `tree` — Contenedor de árbol de archivos. - - `tree-folder` — Entrada de carpeta dentro de un árbol de archivos. - - `tree-file` — Entrada de archivo dentro de un árbol de archivos. + - `tree`—Contenedor de árbol de archivos. + - `tree-folder`—Entrada de carpeta dentro de un árbol de archivos. + - `tree-file`—Entrada de archivo dentro de un árbol de archivos. Algunos elementos exponen atributos de datos que puedes usar como selectores CSS. Estado activo (`data-active`): - - `nav-dropdown-item[data-active]` — Elemento activo en un desplegable de navegación. - - `mobile-nav-tabs-item[data-active]` — Pestaña activa en la navegación móvil. - - `sidebar-group[data-active]` — Grupo activo de la barra lateral. - - `#sidebar-content li[data-active]` — Enlace activo de la barra lateral. - - `.nav-tabs-item[data-active]` — Pestaña activa de la navegación superior. Solo se aplica a pestañas simples; las pestañas con menús desplegables no reciben `data-active`. Nota el `.` inicial: esto apunta a una clase en un elemento `` estándar, a diferencia de la mayoría de los otros componentes que usan nombres de elementos personalizados. - - `toc-item[data-active]` — Elemento activo de la tabla de contenidos. - - `toc-item[data-active-deepest]` — Elemento más profundo activo de la tabla de contenidos. Solo presente en el encabezado exacto actualmente visible, a diferencia de `data-active` que también se establece en sus encabezados padres. + - `nav-dropdown-item[data-active]`—Elemento activo en un desplegable de navegación. + - `mobile-nav-tabs-item[data-active]`—Pestaña activa en la navegación móvil. + - `sidebar-group[data-active]`—Grupo activo de la barra lateral. + - `#sidebar-content li[data-active]`—Enlace activo de la barra lateral. + - `.nav-tabs-item[data-active]`—Pestaña activa de la navegación superior. Solo se aplica a pestañas simples; las pestañas con menús desplegables no reciben `data-active`. Nota el `.` inicial: esto apunta a una clase en un elemento `` estándar, a diferencia de la mayoría de los otros componentes que usan nombres de elementos personalizados. + - `toc-item[data-active]`—Elemento activo de la tabla de contenidos. + - `toc-item[data-active-deepest]`—Elemento más profundo activo de la tabla de contenidos. Solo presente en el encabezado exacto actualmente visible, a diferencia de `data-active` que también se establece en sus encabezados padres. Nombre de componente (`data-component-name`): Usa `data-component-name` para apuntar a componentes de interfaz específicos con un selector estable que persiste si los nombres de clases internos cambian. - - `[data-component-name="mermaid-container"]` — Contenedor de diagrama Mermaid, incluyendo la superposición de controles de zoom. - - `[data-component-name="mermaid-controls-wrapper"]` — Controles de zoom y desplazamiento de Mermaid. - - `[data-component-name="primary-header-button"]` — Botón principal del encabezado. Solo en el tema Sequoia. - - `[data-component-name="theme-toggle"]` — Interruptor de tema. + - `[data-component-name="mermaid-container"]`—Contenedor de diagrama Mermaid, incluyendo la superposición de controles de zoom. + - `[data-component-name="mermaid-controls-wrapper"]`—Controles de zoom y desplazamiento de Mermaid. + - `[data-component-name="primary-header-button"]`—Botón principal del encabezado. Solo en el tema Sequoia. + - `[data-component-name="theme-toggle"]`—Interruptor de tema. Parte de componente (`data-component-part`): Usa `data-component-part` para apuntar a sub-elementos dentro de un componente. - - `[data-component-part="contact-support-button"]` — El wrapper `` alrededor del enlace de contacto de soporte en el panel del asistente. - - `[data-component-part="contact-support-icon"]` — El `` que envuelve el icono. - - `[data-component-part="contact-support-text"]` — El elemento `

` que contiene la etiqueta. + - `[data-component-part="contact-support-button"]`—El wrapper `` alrededor del enlace de contacto de soporte en el panel del asistente. + - `[data-component-part="contact-support-icon"]`—El `` que envuelve el icono. + - `[data-component-part="contact-support-text"]`—El elemento `

` que contiene la etiqueta. Atributos de Badge: - - `[data-badge]` — Cualquier elemento de badge. - - `[data-badge][data-color="blue"]` — Badge filtrado por color. - - `[data-badge][data-size="sm"]` — Badge filtrado por tamaño. + - `[data-badge]`—Cualquier elemento de badge. + - `[data-badge][data-color="blue"]`—Badge filtrado por color. + - `[data-badge][data-size="sm"]`—Badge filtrado por tamaño. Ruta actual (`data-current-path`): Usa `data-current-path` para aplicar CSS personalizado en páginas o subrutas específicas. - - `html[data-current-path="/"]` — Coincide con la página raíz. - - `html[data-current-path="/quickstart"]` — Coincide con una página específica. - - `html[data-current-path^="/api-reference/"]` — Coincide con cualquier página dentro de una sección. + - `html[data-current-path="/"]`—Coincide con la página raíz. + - `html[data-current-path="/quickstart"]`—Coincide con una página específica. + - `html[data-current-path^="/api-reference/"]`—Coincide con cualquier página dentro de una sección. diff --git a/es/dashboard/sso.mdx b/es/dashboard/sso.mdx index 06d8083663..8a82194023 100644 --- a/es/dashboard/sso.mdx +++ b/es/dashboard/sso.mdx @@ -193,7 +193,7 @@ La aserción SAML resultante debe incluir un `AttributeStatement`. | Name | Name format | Filter | Value | | ---- | ----------- | ------ | ----- | - | `groups` | Unspecified | Matches regex | `.*` | + | `groups` | Unspecified | `Matches regex` | `.*` | Ajusta el filtro para que coincida con los grupos específicos que deseas enviar a Mintlify. diff --git a/es/enterprise-contracting.mdx b/es/enterprise-contracting.mdx index 583a0fe9c8..98c9759f2f 100644 --- a/es/enterprise-contracting.mdx +++ b/es/enterprise-contracting.mdx @@ -89,7 +89,7 @@ Estas posiciones son estructurales para el funcionamiento de la plataforma. Expl **Por qué:** Utilizamos proveedores de LLM de terceros cuya salida no podemos garantizar. Ninguna empresa de software puede garantizar resultados que dependen de los datos del cliente, casos de uso o integraciones de terceros. - **Lo que esto significa para ti:** Garantizaremos por escrito que nuestros proveedores de LLM tienen prohibido contractualmente usar tus datos para el entrenamiento o la mejora de modelos. Esta es la protección que realmente importa. + **Lo que esto significa para ti:** Garantizamos por escrito que nuestros proveedores de LLM tienen prohibido contractualmente usar tus datos para el entrenamiento o la mejora de modelos. Esta es la protección que realmente importa. diff --git a/es/organize/settings-seo.mdx b/es/organize/settings-seo.mdx index 3ae11e6d85..e07b87c9d2 100644 --- a/es/organize/settings-seo.mdx +++ b/es/organize/settings-seo.mdx @@ -29,8 +29,8 @@ Configuración de indexación y metadatos para motores de búsqueda. Especifica qué páginas deben indexar los motores de búsqueda. - - `navigable` — Indexa solo las páginas incluidas en la navegación de tu `docs.json`. Este es el valor predeterminado. - - `all` — Indexa todas las páginas de tu proyecto, incluyendo páginas que no están en la navegación. + - `navigable`—Indexa solo las páginas incluidas en la navegación de tu `docs.json`. Este es el valor predeterminado. + - `all`—Indexa todas las páginas de tu proyecto, incluyendo páginas que no están en la navegación. @@ -49,12 +49,12 @@ Configuración de indexación y metadatos para motores de búsqueda. Organización utilizada como entidad editora en los [datos estructurados](/es/optimize/seo#structured-data) que se emiten en cada página. Todos los campos son opcionales. Cuando se omiten, Mintlify deriva la organización a partir del nombre de tu sitio, el logo de la documentación y la URL del sitio. - - `id` — URL `@id` estable que identifica tu organización en todas las páginas, por ejemplo `https://example.com/#organization`. Su valor predeterminado es `/#organization`. - - `name` — Nombre de la organización. Su valor predeterminado es el nombre del sitio. - - `legalName` — Nombre legal registrado. - - `url` — URL canónica de la página principal de la organización. - - `logo` — URL canónica del logo utilizada en los datos estructurados. Su valor predeterminado es el logo de la documentación. - - `sameAs` — Arreglo de URLs de perfiles oficiales, como X, LinkedIn o GitHub. + - `id`—URL `@id` estable que identifica tu organización en todas las páginas, por ejemplo `https://example.com/#organization`. Su valor predeterminado es `/#organization`. + - `name`—Nombre de la organización. Su valor predeterminado es el nombre del sitio. + - `legalName`—Nombre legal registrado. + - `url`—URL canónica de la página principal de la organización. + - `logo`—URL canónica del logo utilizada en los datos estructurados. Su valor predeterminado es el logo de la documentación. + - `sameAs`—Arreglo de URLs de perfiles oficiales, como X, LinkedIn o GitHub. ```json "organization": { diff --git a/fr/api-playground/sdk-reference-setup.mdx b/fr/api-playground/sdk-reference-setup.mdx index 3d674e95a3..09e71574f7 100644 --- a/fr/api-playground/sdk-reference-setup.mdx +++ b/fr/api-playground/sdk-reference-setup.mdx @@ -70,7 +70,7 @@ Ajoutez une propriété `sdk` à un onglet ou à un groupe dans votre `docs.json } ``` -Ajoutez `sdk` à un groupe pour générer des pages dans une section d’un onglet plutôt que dans l’onglet entier. Les groupes et pages héritent des paramètres `sdk` de l’onglet ou du groupe situé au-dessus d’eux. Si un groupe imbriqué définit son propre `sdk`, Mintlify utilise ces paramètres à la place de ceux hérités. +Ajoutez `sdk` à un groupe pour générer des pages dans une section d’un onglet plutôt que dans l’onglet entier. Les groupes et pages héritent des paramètres `sdk` de l’onglet ou du groupe parent. Si un groupe imbriqué définit son propre `sdk`, Mintlify utilise ces paramètres à la place de ceux hérités. ```json { diff --git a/fr/assistant/use.mdx b/fr/assistant/use.mdx index 3d1c74bb47..f59ac9bd9e 100644 --- a/fr/assistant/use.mdx +++ b/fr/assistant/use.mdx @@ -145,11 +145,11 @@ Limites : **Pour les lecteurs :** Demandez à votre équipe informatique d'autoriser les requêtes HTTPS sortantes vers les hôtes suivants depuis votre réseau. Si vous le pouvez, essayez l'assistant depuis un réseau personnel pour confirmer que le problème est spécifique au réseau. - - `leaves.mintlify.com` — API de l'assistant - - `*.mintlify.dev` — streaming de l'assistant et services associés - - `*.mintlify.com` — tableau de bord, API et analyses - - `hcaptcha.com` et `*.hcaptcha.com` — vérification CAPTCHA pour l'assistant + - `leaves.mintlify.com`—API de l'assistant + - `*.mintlify.dev`—streaming de l'assistant et services associés + - `*.mintlify.com`—tableau de bord, API et analyses + - `hcaptcha.com` et `*.hcaptcha.com`—vérification CAPTCHA pour l'assistant - **Pour les propriétaires de site :** Si un lecteur signale que l'assistant ne se charge pas sur son réseau d'entreprise ou son VPN, il s'agit presque toujours d'un blocage réseau sortant et non d'un problème avec votre documentation. Indiquez-lui les hôtes ci-dessus et suggérez-lui de partager la liste avec son équipe informatique. Il s'agit d'une liste d'autorisation au niveau réseau qui s'applique à l'appareil ou au réseau du visiteur, et non de quelque chose que vous pouvez configurer depuis votre site. Si votre documentation est auto-hébergée derrière un proxy inverse qui écrase la CSP par défaut, consultez [Configuration de la CSP](/fr/deploy/csp-configuration) pour les domaines à autoriser. + **Pour les propriétaires de site :** Si un lecteur signale que l'assistant ne se charge pas sur son réseau d'entreprise ou son VPN, il s'agit presque toujours d'un blocage réseau sortant et non d'un problème avec votre documentation. Indiquez-lui les hôtes précédents et suggérez-lui de partager la liste avec son équipe informatique. Il s'agit d'une liste d'autorisation au niveau réseau qui s'applique à l'appareil ou au réseau du visiteur, et non de quelque chose que vous pouvez configurer depuis votre site. Si votre documentation est auto-hébergée derrière un proxy inverse qui écrase la CSP par défaut, consultez [Configuration de la CSP](/fr/deploy/csp-configuration) pour les domaines à autoriser. diff --git a/fr/customize/custom-scripts.mdx b/fr/customize/custom-scripts.mdx index c4cdebb12e..21c57e6c15 100644 --- a/fr/customize/custom-scripts.mdx +++ b/fr/customize/custom-scripts.mdx @@ -90,81 +90,81 @@ Chaque ID apparaît une seule fois par page. Utilisez-les comme `#value` en CSS. - - `#body-content` — Conteneur externe du corps de la page. - - `#content-area` — Zone de contenu principale, hors barre latérale et table des matières. - - `#content` — Élément de contenu interne au sein de la zone de contenu. - - `#header` — Élément d'en-tête au niveau de la page. - - `#banner` — Bannière d'annonce affichée au-dessus de la barre de navigation. - - `#footer` — Pied de page. Aussi ciblable en tant que sélecteur d'élément : `footer`. - - `#page-title` — Le titre `

` en haut de chaque page. - - `#pagination` — Barre de pagination en bas avec les liens page précédente et suivante. - - `#panel` — Panneau flottant en superposition. Aussi ciblable en tant que sélecteur d'élément : `panel`. - - `#background-color` — Élément de couleur d'arrière-plan de la page. + - `#body-content`—Conteneur externe du corps de la page. + - `#content-area`—Zone de contenu principale, hors barre latérale et table des matières. + - `#content`—Élément de contenu interne au sein de la zone de contenu. + - `#header`—Élément d'en-tête au niveau de la page. + - `#banner`—Bannière d'annonce affichée au-dessus de la barre de navigation. + - `#footer`—Pied de page. Aussi ciblable en tant que sélecteur d'élément : `footer`. + - `#page-title`—Le titre `

` en haut de chaque page. + - `#pagination`—Barre de pagination en bas avec les liens page précédente et suivante. + - `#panel`—Panneau flottant en superposition. Aussi ciblable en tant que sélecteur d'élément : `panel`. + - `#background-color`—Élément de couleur d'arrière-plan de la page. - - `#navbar` — Barre de navigation supérieure. - - `#topbar-cta-button` — Bouton d'appel à l'action dans la barre supérieure. - - `#mobile-nav` — Superposition de la navigation mobile. - - `#mobile-nav-content` — Zone de contenu au sein de la superposition de navigation mobile. + - `#navbar`—Barre de navigation supérieure. + - `#topbar-cta-button`—Bouton d'appel à l'action dans la barre supérieure. + - `#mobile-nav`—Superposition de la navigation mobile. + - `#mobile-nav-content`—Zone de contenu au sein de la superposition de navigation mobile. - - `#sidebar` — Panneau de navigation de la barre latérale. - - `#sidebar-content` — Zone de contenu défilable au sein de la barre latérale. + - `#sidebar`—Panneau de navigation de la barre latérale. + - `#sidebar-content`—Zone de contenu défilable au sein de la barre latérale. - - `#table-of-contents` — Panneau de la table des matières sur le côté droit de la page. - - `#table-of-contents-layout` — Conteneur de mise en page pour la table des matières. - - `#table-of-contents-content` — Contenu défilable au sein de la table des matières. + - `#table-of-contents`—Panneau de la table des matières sur le côté droit de la page. + - `#table-of-contents-layout`—Conteneur de mise en page pour la table des matières. + - `#table-of-contents-content`—Contenu défilable au sein de la table des matières. - - `#search-bar-entry` — Déclencheur de la barre de recherche dans la barre supérieure. - - `#search-bar-entry-mobile` — Déclencheur de la barre de recherche sur mobile. - - `#search-input` — Champ de saisie dans la fenêtre modale de recherche. + - `#search-bar-entry`—Déclencheur de la barre de recherche dans la barre supérieure. + - `#search-bar-entry-mobile`—Déclencheur de la barre de recherche sur mobile. + - `#search-input`—Champ de saisie dans la fenêtre modale de recherche. - - `#assistant-entry` — Bouton de l'assistant IA dans la barre supérieure. - - `#assistant-entry-mobile` — Bouton de l'assistant IA sur mobile. - - `#chat-assistant-sheet` — Panneau de chat de l'assistant IA. - - `#chat-assistant-textarea` — Champ de saisie dans le panneau de l'assistant IA. + - `#assistant-entry`—Bouton de l'assistant IA dans la barre supérieure. + - `#assistant-entry-mobile`—Bouton de l'assistant IA sur mobile. + - `#chat-assistant-sheet`—Panneau de chat de l'assistant IA. + - `#chat-assistant-textarea`—Champ de saisie dans le panneau de l'assistant IA. - - `#request-example` — Panneau d'exemple de requête dans le playground API. - - `#response-example` — Panneau d'exemple de réponse dans le playground API. - - `#api-playground-input` — Section d'entrée du playground API. - - `#endpoints-menu-trigger` — Bouton qui ouvre le menu déroulant de sélection des endpoints. + - `#request-example`—Panneau d'exemple de requête dans le playground API. + - `#response-example`—Panneau d'exemple de réponse dans le playground API. + - `#api-playground-input`—Section d'entrée du playground API. + - `#endpoints-menu-trigger`—Bouton qui ouvre le menu déroulant de sélection des endpoints. - - `#ask-assistant-code-block-button` — Bouton "Demander à l'assistant" qui apparaît sur les blocs de code. - - `#code-snippet-feedback-button` — Bouton de retour d'expérience sur les extraits de code. - - `#code-snippet-feedback-textarea` — Zone de texte dans le formulaire de retour d'expérience des extraits de code. + - `#ask-assistant-code-block-button`—Bouton "Demander à l'assistant" qui apparaît sur les blocs de code. + - `#code-snippet-feedback-button`—Bouton de retour d'expérience sur les extraits de code. + - `#code-snippet-feedback-textarea`—Zone de texte dans le formulaire de retour d'expérience des extraits de code. - - `#feedback-thumbs-up` — Bouton pouce en haut en bas de la page. - - `#feedback-thumbs-down` — Bouton pouce en bas en bas de la page. - - `#feedback-form` — Formulaire de retour d'expérience affiché après une réponse négative. - - `#feedback-form-input` — Champ de saisie dans le formulaire de retour d'expérience. - - `#feedback-form-cancel` — Bouton d'annulation dans le formulaire de retour d'expérience. - - `#feedback-form-submit` — Bouton d'envoi dans le formulaire de retour d'expérience. + - `#feedback-thumbs-up`—Bouton pouce en haut en bas de la page. + - `#feedback-thumbs-down`—Bouton pouce en bas en bas de la page. + - `#feedback-form`—Formulaire de retour d'expérience affiché après une réponse négative. + - `#feedback-form-input`—Champ de saisie dans le formulaire de retour d'expérience. + - `#feedback-form-cancel`—Bouton d'annulation dans le formulaire de retour d'expérience. + - `#feedback-form-submit`—Bouton d'envoi dans le formulaire de retour d'expérience. - - `#page-context-menu` — Menu d'options contextuelles pour la page actuelle. - - `#page-context-menu-button` — Bouton qui déclenche le menu contextuel de la page. + - `#page-context-menu`—Menu d'options contextuelles pour la page actuelle. + - `#page-context-menu-button`—Bouton qui déclenche le menu contextuel de la page. - - `#localization-select-trigger` — Bouton qui ouvre le sélecteur de langue. - - `#localization-select-content` — Contenu du menu déroulant du sélecteur de langue. - - `#localization-select-item` — Option de langue individuelle dans le sélecteur. + - `#localization-select-trigger`—Bouton qui ouvre le sélecteur de langue. + - `#localization-select-content`—Contenu du menu déroulant du sélecteur de langue. + - `#localization-select-item`—Option de langue individuelle dans le sélecteur. - - `#changelog-filters` — Contrôles de filtre sur une page de journal des modifications. - - `#changelog-filters-content` — Zone de contenu dans le panneau de filtres du journal des modifications. + - `#changelog-filters`—Contrôles de filtre sur une page de journal des modifications. + - `#changelog-filters-content`—Zone de contenu dans le panneau de filtres du journal des modifications. - - `#multi-view-dropdown` — Menu déroulant pour basculer entre les vues de documentation. + - `#multi-view-dropdown`—Menu déroulant pour basculer entre les vues de documentation. - - `#text-selection-tooltip` — Infobulle qui apparaît lorsque vous sélectionnez du texte sur la page. - - `#text-selection-tooltip-button` — Bouton d'action dans l'infobulle de sélection de texte. + - `#text-selection-tooltip`—Infobulle qui apparaît lorsque vous sélectionnez du texte sur la page. + - `#text-selection-tooltip-button`—Bouton d'action dans l'infobulle de sélection de texte. @@ -176,202 +176,202 @@ Plusieurs instances de ces éléments peuvent apparaître sur une page. Utilisez - - `accordion` — Élément accordéon repliable. - - `accordion-group` — Conteneur regroupant plusieurs accordéons. - - `callout` — Bloc d'encadré (Note, Warning, Tip, etc.). - - `card` — Élément de carte individuel. - - `card-group` — Conteneur regroupant plusieurs cartes. Obsolète au profit de `columns`, mais conservé pour la compatibilité. - - `columns` — Conteneur de mise en page multi-colonnes. - - `code-block` — Élément de bloc de code. - - `code-block-icon` — Icône affichée dans l'en-tête d'un bloc de code. - - `code-group` — Groupe d'onglets de blocs de code. - - `expandable` — Élément de section extensible. - - `frame` — Cadre pour les images ou le contenu intégré. - - `icon` — Élément d'icône en ligne. - - `mermaid` — Conteneur de diagramme Mermaid. - - `step` — Étape individuelle dans une séquence d'étapes. - - `steps` — Conteneur d'étapes numérotées. - - `tab-icon` — Icône affichée dans un onglet. - - `tabs` — Conteneur de contenu à onglets. - - `tile` — Élément de composant tuile. - - `tooltip` — Élément d'infobulle. - - `update` — Entrée de mise à jour du journal des modifications. + - `accordion`—Élément accordéon repliable. + - `accordion-group`—Conteneur regroupant plusieurs accordéons. + - `callout`—Bloc d'encadré (Note, Warning, Tip, etc.). + - `card`—Élément de carte individuel. + - `card-group`—Conteneur regroupant plusieurs cartes. Obsolète au profit de `columns`, mais conservé pour la compatibilité. + - `columns`—Conteneur de mise en page multi-colonnes. + - `code-block`—Élément de bloc de code. + - `code-block-icon`—Icône affichée dans l'en-tête d'un bloc de code. + - `code-group`—Groupe d'onglets de blocs de code. + - `expandable`—Élément de section extensible. + - `frame`—Cadre pour les images ou le contenu intégré. + - `icon`—Élément d'icône en ligne. + - `mermaid`—Conteneur de diagramme Mermaid. + - `step`—Étape individuelle dans une séquence d'étapes. + - `steps`—Conteneur d'étapes numérotées. + - `tab-icon`—Icône affichée dans un onglet. + - `tabs`—Conteneur de contenu à onglets. + - `tile`—Élément de composant tuile. + - `tooltip`—Élément d'infobulle. + - `update`—Entrée de mise à jour du journal des modifications. - - `mdx-content` — Zone de contenu MDX rendu. - - `panel` — Composant de panneau flottant. Aussi ciblable en tant que sélecteur d'ID : `#panel`. - - `eyebrow` — Petit libellé affiché au-dessus du titre de la page. - - `link` — Élément de lien ancré. - - `breadcrumb-list` — Liste de navigation fil d'Ariane. - - `breadcrumb-item` — Élément individuel du fil d'Ariane. + - `mdx-content`—Zone de contenu MDX rendu. + - `panel`—Composant de panneau flottant. Aussi ciblable en tant que sélecteur d'ID : `#panel`. + - `eyebrow`—Petit libellé affiché au-dessus du titre de la page. + - `link`—Élément de lien ancré. + - `breadcrumb-list`—Liste de navigation fil d'Ariane. + - `breadcrumb-item`—Élément individuel du fil d'Ariane. - - `nav-logo` — Logo dans la barre de navigation. - - `navbar-link` — Élément de lien dans la barre de navigation. - - `nav-anchors` — Conteneur des liens d'ancrage dans la barre supérieure. - - `nav-anchor` — Lien d'ancrage individuel dans la barre supérieure. - - `nav-tabs` — Barre d'onglets dans la navigation supérieure. - - `nav-tabs-item` — Élément d'onglet individuel dans la barre d'onglets de la navigation supérieure. - - `mobile-nav-tabs-item` — Élément d'onglet dans la barre d'onglets de la navigation mobile. - - `topbar-right-container` — Section droite de la barre supérieure. - - `nav-tag-pill` — Pastille de tag affichée dans la navigation. - - `nav-tag-pill-text` — Texte au sein d'une pastille de tag de navigation. + - `nav-logo`—Logo dans la barre de navigation. + - `navbar-link`—Élément de lien dans la barre de navigation. + - `nav-anchors`—Conteneur des liens d'ancrage dans la barre supérieure. + - `nav-anchor`—Lien d'ancrage individuel dans la barre supérieure. + - `nav-tabs`—Barre d'onglets dans la navigation supérieure. + - `nav-tabs-item`—Élément d'onglet individuel dans la barre d'onglets de la navigation supérieure. + - `mobile-nav-tabs-item`—Élément d'onglet dans la barre d'onglets de la navigation mobile. + - `topbar-right-container`—Section droite de la barre supérieure. + - `nav-tag-pill`—Pastille de tag affichée dans la navigation. + - `nav-tag-pill-text`—Texte au sein d'une pastille de tag de navigation. - - `nav-dropdown-trigger` — Bouton qui ouvre un menu déroulant de navigation. - - `nav-dropdown-content` — Conteneur de contenu d'un menu déroulant de navigation. - - `nav-dropdown-item` — Élément individuel au sein d'un menu déroulant de navigation. - - `nav-dropdown-item-text-container` — Conteneur de texte au sein d'un élément du menu déroulant. - - `nav-dropdown-item-title` — Texte du titre au sein d'un élément du menu déroulant. - - `nav-dropdown-item-description` — Texte de description au sein d'un élément du menu déroulant. - - `nav-dropdown-item-icon` — Icône au sein d'un élément du menu déroulant. + - `nav-dropdown-trigger`—Bouton qui ouvre un menu déroulant de navigation. + - `nav-dropdown-content`—Conteneur de contenu d'un menu déroulant de navigation. + - `nav-dropdown-item`—Élément individuel au sein d'un menu déroulant de navigation. + - `nav-dropdown-item-text-container`—Conteneur de texte au sein d'un élément du menu déroulant. + - `nav-dropdown-item-title`—Texte du titre au sein d'un élément du menu déroulant. + - `nav-dropdown-item-description`—Texte de description au sein d'un élément du menu déroulant. + - `nav-dropdown-item-icon`—Icône au sein d'un élément du menu déroulant. - - `nav-dropdown-products-selector-trigger` — Bouton qui ouvre le menu déroulant du sélecteur de produits. - - `nav-dropdown-products-selector-content` — Conteneur de contenu du sélecteur de produits. - - `nav-dropdown-products-selector-item` — Produit individuel dans le sélecteur. - - `nav-dropdown-products-selector-item-title` — Titre d'un élément du sélecteur de produits. - - `nav-dropdown-products-selector-item-description` — Description d'un élément du sélecteur de produits. - - `nav-dropdown-products-selector-item-icon` — Icône d'un élément du sélecteur de produits. + - `nav-dropdown-products-selector-trigger`—Bouton qui ouvre le menu déroulant du sélecteur de produits. + - `nav-dropdown-products-selector-content`—Conteneur de contenu du sélecteur de produits. + - `nav-dropdown-products-selector-item`—Produit individuel dans le sélecteur. + - `nav-dropdown-products-selector-item-title`—Titre d'un élément du sélecteur de produits. + - `nav-dropdown-products-selector-item-description`—Description d'un élément du sélecteur de produits. + - `nav-dropdown-products-selector-item-icon`—Icône d'un élément du sélecteur de produits. - - `sidebar-group` — Groupe de liens associés dans la barre latérale. - - `sidebar-group-icon` — Icône d'un groupe de la barre latérale. - - `sidebar-group-header` — Libellé d'en-tête d'un groupe de la barre latérale. - - `sidebar-title` — Titre de niveau supérieur dans la barre latérale. - - `sidebar-nav-group-divider` — Séparateur entre les groupes de navigation de la barre latérale. + - `sidebar-group`—Groupe de liens associés dans la barre latérale. + - `sidebar-group-icon`—Icône d'un groupe de la barre latérale. + - `sidebar-group-header`—Libellé d'en-tête d'un groupe de la barre latérale. + - `sidebar-title`—Titre de niveau supérieur dans la barre latérale. + - `sidebar-nav-group-divider`—Séparateur entre les groupes de navigation de la barre latérale. - - `toc` — Conteneur de la table des matières. - - `toc-item` — Entrée d'en-tête individuelle dans la table des matières. + - `toc`—Conteneur de la table des matières. + - `toc-item`—Entrée d'en-tête individuelle dans la table des matières. - - `footer` — Pied de page standard. Aussi ciblable en tant que sélecteur d'ID : `#footer`. - - `advanced-footer` — Pied de page étendu avec des colonnes ou du contenu supplémentaire. + - `footer`—Pied de page standard. Aussi ciblable en tant que sélecteur d'ID : `#footer`. + - `advanced-footer`—Pied de page étendu avec des colonnes ou du contenu supplémentaire. - - `pagination-prev` — Lien vers la page précédente dans la barre de pagination. - - `pagination-next` — Lien vers la page suivante dans la barre de pagination. - - `pagination-title` — Titre de la page affiché dans la barre de pagination. + - `pagination-prev`—Lien vers la page précédente dans la barre de pagination. + - `pagination-next`—Lien vers la page suivante dans la barre de pagination. + - `pagination-title`—Titre de la page affiché dans la barre de pagination. - - `api-section` — Section complète pour un endpoint d'API. - - `api-section-heading` — Zone d'en-tête d'une section d'endpoint d'API. - - `api-section-heading-title` — Titre au sein de l'en-tête d'une section d'endpoint d'API. - - `api-section-heading-subtitle` — Sous-titre au sein de l'en-tête d'une section d'endpoint d'API. - - `field` — Champ de paramètre ou de propriété dans la référence API. - - `option-dropdown` — Menu déroulant pour sélectionner entre les options d'API. - - `tryit-button` — Bouton "Try it" qui ouvre le playground API. - - `method-pill` — Badge de méthode HTTP (GET, POST, etc.) sur un endpoint. - - `method-nav-pill` — Badge de méthode HTTP affiché dans la navigation de la barre latérale. - - `prompt` — Composant prompt dans la référence API. + - `api-section`—Section complète pour un endpoint d'API. + - `api-section-heading`—Zone d'en-tête d'une section d'endpoint d'API. + - `api-section-heading-title`—Titre au sein de l'en-tête d'une section d'endpoint d'API. + - `api-section-heading-subtitle`—Sous-titre au sein de l'en-tête d'une section d'endpoint d'API. + - `field`—Champ de paramètre ou de propriété dans la référence API. + - `option-dropdown`—Menu déroulant pour sélectionner entre les options d'API. + - `tryit-button`—Bouton "Try it" qui ouvre le playground API. + - `method-pill`—Badge de méthode HTTP (GET, POST, etc.) sur un endpoint. + - `method-nav-pill`—Badge de méthode HTTP affiché dans la navigation de la barre latérale. + - `prompt`—Composant prompt dans la référence API. - - `chat-assistant-sheet` — Conteneur du panneau de l'assistant IA. - - `chat-assistant-sheet-header` — En-tête du panneau de l'assistant IA. - - `chat-assistant-sheet-content` — Zone de contenu du panneau de l'assistant IA. - - `chat-assistant-input` — Champ de saisie dans le panneau de l'assistant IA. - - `chat-assistant-floating-input` — Variante de saisie flottante de l'assistant IA. - - `chat-assistant-send-button` — Bouton d'envoi dans le panneau de l'assistant IA. - - `chat-assistant-disclaimer-text` — Texte de clause de non-responsabilité dans le panneau de l'assistant IA. - - `chat-assistant-payload-item` — Message ou résultat individuel dans le panneau de l'assistant. - - `starter-question-text` — Question de démarrage suggérée affichée dans un panneau d'assistant vide. + - `chat-assistant-sheet`—Conteneur du panneau de l'assistant IA. + - `chat-assistant-sheet-header`—En-tête du panneau de l'assistant IA. + - `chat-assistant-sheet-content`—Zone de contenu du panneau de l'assistant IA. + - `chat-assistant-input`—Champ de saisie dans le panneau de l'assistant IA. + - `chat-assistant-floating-input`—Variante de saisie flottante de l'assistant IA. + - `chat-assistant-send-button`—Bouton d'envoi dans le panneau de l'assistant IA. + - `chat-assistant-disclaimer-text`—Texte de clause de non-responsabilité dans le panneau de l'assistant IA. + - `chat-assistant-payload-item`—Message ou résultat individuel dans le panneau de l'assistant. + - `starter-question-text`—Question de démarrage suggérée affichée dans un panneau d'assistant vide. - - `feedback-toolbar` — Barre d'outils contenant les contrôles de retour d'expérience de la page. - - `contextual-feedback-container` — Conteneur pour le retour d'expérience contextuel en ligne. - - `contextual-feedback-form` — Formulaire de retour d'expérience contextuel en ligne. - - `contextual-feedback-form-title` — Titre du formulaire de retour d'expérience contextuel. - - `contextual-feedback-input` — Champ de saisie dans le formulaire de retour d'expérience contextuel. - - `contextual-feedback-button` — Bouton d'action dans le formulaire de retour d'expérience contextuel. - - `contextual-feedback-form-submit-button` — Bouton d'envoi du formulaire de retour d'expérience contextuel. + - `feedback-toolbar`—Barre d'outils contenant les contrôles de retour d'expérience de la page. + - `contextual-feedback-container`—Conteneur pour le retour d'expérience contextuel en ligne. + - `contextual-feedback-form`—Formulaire de retour d'expérience contextuel en ligne. + - `contextual-feedback-form-title`—Titre du formulaire de retour d'expérience contextuel. + - `contextual-feedback-input`—Champ de saisie dans le formulaire de retour d'expérience contextuel. + - `contextual-feedback-button`—Bouton d'action dans le formulaire de retour d'expérience contextuel. + - `contextual-feedback-form-submit-button`—Bouton d'envoi du formulaire de retour d'expérience contextuel. - - `code-snippet-feedback-popover-content` — Contenu du popover pour le retour d'expérience sur les extraits de code. - - `code-snippet-feedback-form` — Formulaire de retour d'expérience pour un extrait de code. - - `code-snippet-feedback-textarea` — Zone de texte dans le formulaire de retour d'expérience de l'extrait de code. - - `code-snippet-feedback-form-title` — Titre du formulaire de retour d'expérience de l'extrait de code. - - `code-snippet-feedback-form-description` — Texte descriptif dans le formulaire de retour d'expérience de l'extrait de code. - - `code-snippet-feedback-form-submit-button` — Bouton d'envoi du formulaire de retour d'expérience de l'extrait de code. + - `code-snippet-feedback-popover-content`—Contenu du popover pour le retour d'expérience sur les extraits de code. + - `code-snippet-feedback-form`—Formulaire de retour d'expérience pour un extrait de code. + - `code-snippet-feedback-textarea`—Zone de texte dans le formulaire de retour d'expérience de l'extrait de code. + - `code-snippet-feedback-form-title`—Titre du formulaire de retour d'expérience de l'extrait de code. + - `code-snippet-feedback-form-description`—Texte descriptif dans le formulaire de retour d'expérience de l'extrait de code. + - `code-snippet-feedback-form-submit-button`—Bouton d'envoi du formulaire de retour d'expérience de l'extrait de code. - - `login-link` — Lien qui initie le processus de connexion. - - `logout-link` — Lien qui initie le processus de déconnexion. + - `login-link`—Lien qui initie le processus de connexion. + - `logout-link`—Lien qui initie le processus de déconnexion. - - `multi-view-item` — Option de vue individuelle dans un commutateur multi-vues. - - `multi-view-dropdown` — Menu déroulant pour sélectionner entre plusieurs vues. - - `multi-view-dropdown-trigger` — Bouton qui ouvre le menu déroulant multi-vues. - - `multi-view-dropdown-content` — Zone de contenu du menu déroulant multi-vues. - - `multi-view-dropdown-item` — Élément individuel au sein du menu déroulant multi-vues. + - `multi-view-item`—Option de vue individuelle dans un commutateur multi-vues. + - `multi-view-dropdown`—Menu déroulant pour sélectionner entre plusieurs vues. + - `multi-view-dropdown-trigger`—Bouton qui ouvre le menu déroulant multi-vues. + - `multi-view-dropdown-content`—Zone de contenu du menu déroulant multi-vues. + - `multi-view-dropdown-item`—Élément individuel au sein du menu déroulant multi-vues. - - `directory` — Conteneur racine d'une page de répertoire. - - `directory-group` — Groupe de pages associées au sein d'un répertoire. - - `directory-page` — Entrée de page individuelle dans un répertoire. - - `directory-card` — Entrée de page sous forme de carte dans un répertoire. + - `directory`—Conteneur racine d'une page de répertoire. + - `directory-group`—Groupe de pages associées au sein d'un répertoire. + - `directory-page`—Entrée de page individuelle dans un répertoire. + - `directory-card`—Entrée de page sous forme de carte dans un répertoire. - - `not-found-container` — Conteneur racine de la page 404. - - `not-found-status-code` — Affichage du code de statut sur la page 404. - - `not-found-title` — Titre de la page 404. - - `not-found-description` — Texte descriptif sur la page 404. - - `not-found-recommended-pages-list` — Liste de pages recommandées affichées sur la page 404. - - `not-found-recommended-page-link` — Lien individuel dans la liste des pages recommandées. + - `not-found-container`—Conteneur racine de la page 404. + - `not-found-status-code`—Affichage du code de statut sur la page 404. + - `not-found-title`—Titre de la page 404. + - `not-found-description`—Texte descriptif sur la page 404. + - `not-found-recommended-pages-list`—Liste de pages recommandées affichées sur la page 404. + - `not-found-recommended-page-link`—Lien individuel dans la liste des pages recommandées. - - `color` — Élément d'échantillon de couleur. - - `color-row` — Ligne regroupant des échantillons de couleur. - - `color-item` — Élément de couleur individuel au sein d'une ligne de couleurs. + - `color`—Élément d'échantillon de couleur. + - `color-row`—Ligne regroupant des échantillons de couleur. + - `color-item`—Élément de couleur individuel au sein d'une ligne de couleurs. - - `tree` — Conteneur d'arborescence de fichiers. - - `tree-folder` — Entrée de dossier dans une arborescence de fichiers. - - `tree-file` — Entrée de fichier dans une arborescence de fichiers. + - `tree`—Conteneur d'arborescence de fichiers. + - `tree-folder`—Entrée de dossier dans une arborescence de fichiers. + - `tree-file`—Entrée de fichier dans une arborescence de fichiers. Certains éléments exposent des attributs de données que vous pouvez utiliser comme sélecteurs CSS. État actif (`data-active`) : - - `nav-dropdown-item[data-active]` — Élément actif dans un menu déroulant de navigation. - - `mobile-nav-tabs-item[data-active]` — Onglet actif dans la navigation mobile. - - `sidebar-group[data-active]` — Groupe actif de la barre latérale. - - `#sidebar-content li[data-active]` — Lien actif de la barre latérale. - - `.nav-tabs-item[data-active]` — Onglet actif de la navigation supérieure. S'applique uniquement aux onglets simples ; les onglets avec menus déroulants ne reçoivent pas `data-active`. Notez le `.` initial : il cible une classe sur un élément `` standard, contrairement à la plupart des autres composants qui utilisent des noms d'éléments personnalisés. - - `toc-item[data-active]` — Élément actif de la table des matières. - - `toc-item[data-active-deepest]` — Élément le plus profond actif de la table des matières. Uniquement présent sur le titre exactement visible, contrairement à `data-active` qui est également défini sur ses titres parents. + - `nav-dropdown-item[data-active]`—Élément actif dans un menu déroulant de navigation. + - `mobile-nav-tabs-item[data-active]`—Onglet actif dans la navigation mobile. + - `sidebar-group[data-active]`—Groupe actif de la barre latérale. + - `#sidebar-content li[data-active]`—Lien actif de la barre latérale. + - `.nav-tabs-item[data-active]`—Onglet actif de la navigation supérieure. S'applique uniquement aux onglets simples ; les onglets avec menus déroulants ne reçoivent pas `data-active`. Notez le `.` initial : il cible une classe sur un élément `` standard, contrairement à la plupart des autres composants qui utilisent des noms d'éléments personnalisés. + - `toc-item[data-active]`—Élément actif de la table des matières. + - `toc-item[data-active-deepest]`—Élément le plus profond actif de la table des matières. Uniquement présent sur le titre exactement visible, contrairement à `data-active` qui est également défini sur ses titres parents. Nom de composant (`data-component-name`) : Utilisez `data-component-name` pour cibler des composants d'interface spécifiques avec un sélecteur stable qui persiste même si les noms de classes internes changent. - - `[data-component-name="mermaid-container"]` — Conteneur de diagramme Mermaid, y compris la superposition des contrôles de zoom. - - `[data-component-name="mermaid-controls-wrapper"]` — Contrôles de zoom et de déplacement Mermaid. - - `[data-component-name="primary-header-button"]` — Bouton principal de l'en-tête. Thème Sequoia uniquement. - - `[data-component-name="theme-toggle"]` — Bascule de thème. + - `[data-component-name="mermaid-container"]`—Conteneur de diagramme Mermaid, y compris la superposition des contrôles de zoom. + - `[data-component-name="mermaid-controls-wrapper"]`—Contrôles de zoom et de déplacement Mermaid. + - `[data-component-name="primary-header-button"]`—Bouton principal de l'en-tête. Thème Sequoia uniquement. + - `[data-component-name="theme-toggle"]`—Bascule de thème. Partie de composant (`data-component-part`) : Utilisez `data-component-part` pour cibler les sous-éléments d'un composant. - - `[data-component-part="contact-support-button"]` — Le wrapper `` autour du lien de contact support dans le panneau assistant. - - `[data-component-part="contact-support-icon"]` — Le `` englobant l'icône. - - `[data-component-part="contact-support-text"]` — L'élément `

` contenant le libellé. + - `[data-component-part="contact-support-button"]`—Le wrapper `` autour du lien de contact support dans le panneau assistant. + - `[data-component-part="contact-support-icon"]`—Le `` englobant l'icône. + - `[data-component-part="contact-support-text"]`—L'élément `

` contenant le libellé. Attributs Badge : - - `[data-badge]` — Tout élément badge. - - `[data-badge][data-color="blue"]` — Badge filtré par couleur. - - `[data-badge][data-size="sm"]` — Badge filtré par taille. + - `[data-badge]`—Tout élément badge. + - `[data-badge][data-color="blue"]`—Badge filtré par couleur. + - `[data-badge][data-size="sm"]`—Badge filtré par taille. Chemin actuel (`data-current-path`) : Utilisez `data-current-path` pour appliquer du CSS personnalisé sur des pages ou des sous-chemins spécifiques. - - `html[data-current-path="/"]` — Correspond à la page racine. - - `html[data-current-path="/quickstart"]` — Correspond à une page spécifique. - - `html[data-current-path^="/api-reference/"]` — Correspond à toute page d'une section. + - `html[data-current-path="/"]`—Correspond à la page racine. + - `html[data-current-path="/quickstart"]`—Correspond à une page spécifique. + - `html[data-current-path^="/api-reference/"]`—Correspond à toute page d'une section. diff --git a/fr/dashboard/sso.mdx b/fr/dashboard/sso.mdx index ff368bb6f5..6783147180 100644 --- a/fr/dashboard/sso.mdx +++ b/fr/dashboard/sso.mdx @@ -193,7 +193,7 @@ L'assertion SAML résultante doit inclure un `AttributeStatement`. | Name | Name format | Filter | Value | | ---- | ----------- | ------ | ----- | - | `groups` | Unspecified | Matches regex | `.*` | + | `groups` | Unspecified | `Matches regex` | `.*` | Ajustez le filtre pour correspondre aux groupes spécifiques que vous souhaitez envoyer à Mintlify. diff --git a/fr/enterprise-contracting.mdx b/fr/enterprise-contracting.mdx index d9b922b4f0..a8631a6e38 100644 --- a/fr/enterprise-contracting.mdx +++ b/fr/enterprise-contracting.mdx @@ -89,7 +89,7 @@ Ces positions sont essentielles au fonctionnement de la plateforme. Nous expliqu **Pourquoi :** Nous utilisons des fournisseurs de LLM tiers dont nous ne pouvons pas garantir les résultats. Aucune entreprise de logiciels ne peut garantir des résultats qui dépendent des données des clients, des cas d'utilisation ou des intégrations tierces. - **Ce que cela signifie pour vous :** Nous garantirons par écrit que nos fournisseurs de LLM auront l’interdiction contractuelle d’utiliser vos données pour l’entraînement ou l’amélioration des modèles. C’est la protection qui compte vraiment. + **Ce que cela signifie pour vous :** Nous garantissons par écrit que nos fournisseurs de LLM ont l’interdiction contractuelle d’utiliser vos données pour l’entraînement ou l’amélioration des modèles. C’est la protection qui compte vraiment. diff --git a/fr/organize/settings-seo.mdx b/fr/organize/settings-seo.mdx index edc28ffcc6..21cfc29a2a 100644 --- a/fr/organize/settings-seo.mdx +++ b/fr/organize/settings-seo.mdx @@ -29,8 +29,8 @@ Paramètres d'indexation et de métadonnées pour les moteurs de recherche. Spécifie quelles pages les moteurs de recherche doivent indexer. - - `navigable` — Indexer uniquement les pages incluses dans la navigation de votre `docs.json`. C'est la valeur par défaut. - - `all` — Indexer toutes les pages de votre projet, y compris les pages qui ne sont pas dans la navigation. + - `navigable`—Indexer uniquement les pages incluses dans la navigation de votre `docs.json`. C'est la valeur par défaut. + - `all`—Indexer toutes les pages de votre projet, y compris les pages qui ne sont pas dans la navigation. @@ -49,12 +49,12 @@ Paramètres d'indexation et de métadonnées pour les moteurs de recherche. Organisation utilisée comme entité éditrice dans les [données structurées](/fr/optimize/seo#structured-data) émises sur chaque page. Tous les champs sont facultatifs. Lorsqu'ils sont omis, Mintlify dérive l'organisation du nom de votre site, du logo de la documentation et de l'URL du site. - - `id` — URL `@id` stable qui identifie votre organisation sur toutes les pages, par exemple `https://example.com/#organization`. Par défaut, `/#organization`. - - `name` — Nom de l'organisation. Par défaut, le nom du site. - - `legalName` — Nom légal enregistré. - - `url` — URL canonique de la page d'accueil de l'organisation. - - `logo` — URL canonique du logo utilisée dans les données structurées. Par défaut, le logo de la documentation. - - `sameAs` — Tableau d'URLs de profils officiels, comme X, LinkedIn ou GitHub. + - `id`—URL `@id` stable qui identifie votre organisation sur toutes les pages, par exemple `https://example.com/#organization`. Par défaut, `/#organization`. + - `name`—Nom de l'organisation. Par défaut, le nom du site. + - `legalName`—Nom légal enregistré. + - `url`—URL canonique de la page d'accueil de l'organisation. + - `logo`—URL canonique du logo utilisée dans les données structurées. Par défaut, le logo de la documentation. + - `sameAs`—Tableau d'URLs de profils officiels, comme X, LinkedIn ou GitHub. ```json "organization": { diff --git a/zh/api-playground/sdk-reference-setup.mdx b/zh/api-playground/sdk-reference-setup.mdx index 9bf6cf9782..5b00ece92f 100644 --- a/zh/api-playground/sdk-reference-setup.mdx +++ b/zh/api-playground/sdk-reference-setup.mdx @@ -70,7 +70,7 @@ phpdoc -d src -t artifacts --template=xml } ``` -在 group 上添加 `sdk`，即可只在 tab 的某一部分生成页面，而不是占用整个 tab。Group 和页面会继承其上方 tab 或 group 的 `sdk` 设置。如果嵌套的 group 定义了自己的 `sdk`，Mintlify 会使用该设置，而不是继承的设置。 +在 group 上添加 `sdk`，即可只在 tab 的某一部分生成页面，而不是占用整个 tab。Group 和页面会继承其父级 tab 或 group 的 `sdk` 设置。如果嵌套的 group 定义了自己的 `sdk`，Mintlify 会使用该设置，而不是继承的设置。 ```json { diff --git a/zh/assistant/use.mdx b/zh/assistant/use.mdx index dc03e6143c..4821c3394d 100644 --- a/zh/assistant/use.mdx +++ b/zh/assistant/use.mdx @@ -145,10 +145,10 @@ https://yourdocs.mintlify.site/quickstart?assistant=How%20do%20I%20get%20started **对读者：** 请你的 IT 团队允许从你的网络向以下主机发起出站 HTTPS 请求。如果可以，请尝试从个人网络使用 AI 助手，以确认问题是网络特定的。 - - `leaves.mintlify.com` — AI 助手 API - - `*.mintlify.dev` — AI 助手流式传输和相关服务 - - `*.mintlify.com` — 仪表盘、API 和分析 - - `hcaptcha.com` 和 `*.hcaptcha.com` — AI 助手的 CAPTCHA 验证 + - `leaves.mintlify.com`—AI 助手 API + - `*.mintlify.dev`—AI 助手流式传输和相关服务 + - `*.mintlify.com`—仪表盘、API 和分析 + - `hcaptcha.com` 和 `*.hcaptcha.com`—AI 助手的 CAPTCHA 验证 **对站点所有者：** 如果读者报告 AI 助手在其公司网络或 VPN 下无法加载，几乎总是出站网络阻止的问题，而不是你的文档存在问题。请将上述主机告知他们，并建议他们把该列表分享给其 IT 团队。这是应用于访问者设备或网络的网络层允许列表，无法通过你的站点进行配置。如果你在覆盖默认 CSP 的反向代理后自托管，请参阅 [CSP 配置](/zh/deploy/csp-configuration)，了解需要允许的域名。 diff --git a/zh/customize/custom-scripts.mdx b/zh/customize/custom-scripts.mdx index ed18c25279..510f78c034 100644 --- a/zh/customize/custom-scripts.mdx +++ b/zh/customize/custom-scripts.mdx @@ -90,81 +90,81 @@ Mintlify 提供两种类型的 CSS 定位钩子： - - `#body-content` — 页面主体的最外层容器。 - - `#content-area` — 主要内容区域，不包括侧边栏和目录。 - - `#content` — 内容区域内的内部内容元素。 - - `#header` — 页面级头部元素。 - - `#banner` — 显示在导航栏上方的公告横幅。 - - `#footer` — 页脚。也可用作元素选择器：`footer`。 - - `#page-title` — 每个页面顶部的 `

` 标题。 - - `#pagination` — 底部分页栏，包含上一页和下一页链接。 - - `#panel` — 浮动面板覆盖层。也可用作元素选择器：`panel`。 - - `#background-color` — 页面背景颜色元素。 + - `#body-content`—页面主体的最外层容器。 + - `#content-area`—主要内容区域，不包括侧边栏和目录。 + - `#content`—内容区域内的内部内容元素。 + - `#header`—页面级头部元素。 + - `#banner`—显示在导航栏上方的公告横幅。 + - `#footer`—页脚。也可用作元素选择器：`footer`。 + - `#page-title`—每个页面顶部的 `

` 标题。 + - `#pagination`—底部分页栏，包含上一页和下一页链接。 + - `#panel`—浮动面板覆盖层。也可用作元素选择器：`panel`。 + - `#background-color`—页面背景颜色元素。 - - `#navbar` — 顶部导航栏。 - - `#topbar-cta-button` — 顶栏中的行动号召按钮。 - - `#mobile-nav` — 移动端导航覆盖层。 - - `#mobile-nav-content` — 移动端导航覆盖层内的内容区域。 + - `#navbar`—顶部导航栏。 + - `#topbar-cta-button`—顶栏中的行动号召按钮。 + - `#mobile-nav`—移动端导航覆盖层。 + - `#mobile-nav-content`—移动端导航覆盖层内的内容区域。 - - `#sidebar` — 侧边栏导航面板。 - - `#sidebar-content` — 侧边栏内可滚动的内容区域。 + - `#sidebar`—侧边栏导航面板。 + - `#sidebar-content`—侧边栏内可滚动的内容区域。 - - `#table-of-contents` — 页面右侧的目录面板。 - - `#table-of-contents-layout` — 目录的布局容器。 - - `#table-of-contents-content` — 目录内可滚动的内容。 + - `#table-of-contents`—页面右侧的目录面板。 + - `#table-of-contents-layout`—目录的布局容器。 + - `#table-of-contents-content`—目录内可滚动的内容。 - - `#search-bar-entry` — 顶栏中的搜索栏触发器。 - - `#search-bar-entry-mobile` — 移动端的搜索栏触发器。 - - `#search-input` — 搜索模态框内的文本输入字段。 + - `#search-bar-entry`—顶栏中的搜索栏触发器。 + - `#search-bar-entry-mobile`—移动端的搜索栏触发器。 + - `#search-input`—搜索模态框内的文本输入字段。 - - `#assistant-entry` — 顶栏中的 AI 助手按钮。 - - `#assistant-entry-mobile` — 移动端的 AI 助手按钮。 - - `#chat-assistant-sheet` — AI 助手聊天面板。 - - `#chat-assistant-textarea` — AI 助手面板内的文本输入。 + - `#assistant-entry`—顶栏中的 AI 助手按钮。 + - `#assistant-entry-mobile`—移动端的 AI 助手按钮。 + - `#chat-assistant-sheet`—AI 助手聊天面板。 + - `#chat-assistant-textarea`—AI 助手面板内的文本输入。 - - `#request-example` — API playground 中的请求示例面板。 - - `#response-example` — API playground 中的响应示例面板。 - - `#api-playground-input` — API playground 的输入区域。 - - `#endpoints-menu-trigger` — 打开端点选择器下拉菜单的按钮。 + - `#request-example`—API playground 中的请求示例面板。 + - `#response-example`—API playground 中的响应示例面板。 + - `#api-playground-input`—API playground 的输入区域。 + - `#endpoints-menu-trigger`—打开端点选择器下拉菜单的按钮。 - - `#ask-assistant-code-block-button` — 代码块上显示的“询问助手”按钮。 - - `#code-snippet-feedback-button` — 代码片段上的反馈按钮。 - - `#code-snippet-feedback-textarea` — 代码片段反馈表单内的文本区域。 + - `#ask-assistant-code-block-button`—代码块上显示的“询问助手”按钮。 + - `#code-snippet-feedback-button`—代码片段上的反馈按钮。 + - `#code-snippet-feedback-textarea`—代码片段反馈表单内的文本区域。 - - `#feedback-thumbs-up` — 页面底部的点赞按钮。 - - `#feedback-thumbs-down` — 页面底部的点踩按钮。 - - `#feedback-form` — 点踩后显示的反馈表单。 - - `#feedback-form-input` — 反馈表单内的文本输入。 - - `#feedback-form-cancel` — 反馈表单内的取消按钮。 - - `#feedback-form-submit` — 反馈表单内的提交按钮。 + - `#feedback-thumbs-up`—页面底部的点赞按钮。 + - `#feedback-thumbs-down`—页面底部的点踩按钮。 + - `#feedback-form`—点踩后显示的反馈表单。 + - `#feedback-form-input`—反馈表单内的文本输入。 + - `#feedback-form-cancel`—反馈表单内的取消按钮。 + - `#feedback-form-submit`—反馈表单内的提交按钮。 - - `#page-context-menu` — 当前页面的上下文选项菜单。 - - `#page-context-menu-button` — 触发页面上下文菜单的按钮。 + - `#page-context-menu`—当前页面的上下文选项菜单。 + - `#page-context-menu-button`—触发页面上下文菜单的按钮。 - - `#localization-select-trigger` — 打开语言选择器的按钮。 - - `#localization-select-content` — 语言选择器的下拉内容。 - - `#localization-select-item` — 选择器中的单个语言选项。 + - `#localization-select-trigger`—打开语言选择器的按钮。 + - `#localization-select-content`—语言选择器的下拉内容。 + - `#localization-select-item`—选择器中的单个语言选项。 - - `#changelog-filters` — 变更日志页面上的过滤控件。 - - `#changelog-filters-content` — 变更日志过滤面板内的内容区域。 + - `#changelog-filters`—变更日志页面上的过滤控件。 + - `#changelog-filters-content`—变更日志过滤面板内的内容区域。 - - `#multi-view-dropdown` — 用于切换文档视图的下拉菜单。 + - `#multi-view-dropdown`—用于切换文档视图的下拉菜单。 - - `#text-selection-tooltip` — 在页面上选择文本时显示的提示框。 - - `#text-selection-tooltip-button` — 文本选择提示框内的操作按钮。 + - `#text-selection-tooltip`—在页面上选择文本时显示的提示框。 + - `#text-selection-tooltip-button`—文本选择提示框内的操作按钮。 @@ -176,202 +176,202 @@ Mintlify 提供两种类型的 CSS 定位钩子： - - `accordion` — 可折叠的手风琴项。 - - `accordion-group` — 包含多个手风琴的容器。 - - `callout` — 标注块（Note、Warning、Tip 等）。 - - `card` — 单个卡片元素。 - - `card-group` — 包含多个卡片的容器。已弃用，推荐使用 `columns`，但为向后兼容而保留。 - - `columns` — 多列布局容器。 - - `code-block` — 代码块元素。 - - `code-block-icon` — 代码块头部显示的图标。 - - `code-group` — 带标签页的代码块组。 - - `expandable` — 可展开区域元素。 - - `frame` — 用于图片或嵌入内容的框架容器。 - - `icon` — 内联图标元素。 - - `mermaid` — Mermaid 图表容器。 - - `step` — 步骤序列中的单个步骤。 - - `steps` — 编号步骤容器。 - - `tab-icon` — 标签页中显示的图标。 - - `tabs` — 标签页内容容器。 - - `tile` — Tile 组件元素。 - - `tooltip` — 提示框元素。 - - `update` — 变更日志更新条目。 + - `accordion`—可折叠的手风琴项。 + - `accordion-group`—包含多个手风琴的容器。 + - `callout`—标注块（Note、Warning、Tip 等）。 + - `card`—单个卡片元素。 + - `card-group`—包含多个卡片的容器。已弃用，推荐使用 `columns`，但为向后兼容而保留。 + - `columns`—多列布局容器。 + - `code-block`—代码块元素。 + - `code-block-icon`—代码块头部显示的图标。 + - `code-group`—带标签页的代码块组。 + - `expandable`—可展开区域元素。 + - `frame`—用于图片或嵌入内容的框架容器。 + - `icon`—内联图标元素。 + - `mermaid`—Mermaid 图表容器。 + - `step`—步骤序列中的单个步骤。 + - `steps`—编号步骤容器。 + - `tab-icon`—标签页中显示的图标。 + - `tabs`—标签页内容容器。 + - `tile`—Tile 组件元素。 + - `tooltip`—提示框元素。 + - `update`—变更日志更新条目。 - - `mdx-content` — 已渲染的 MDX 内容区域。 - - `panel` — 浮动面板组件。也可用作 ID 选择器：`#panel`。 - - `eyebrow` — 页面标题上方显示的小标签。 - - `link` — 锚点链接元素。 - - `breadcrumb-list` — 面包屑导航列表。 - - `breadcrumb-item` — 单个面包屑项。 + - `mdx-content`—已渲染的 MDX 内容区域。 + - `panel`—浮动面板组件。也可用作 ID 选择器：`#panel`。 + - `eyebrow`—页面标题上方显示的小标签。 + - `link`—锚点链接元素。 + - `breadcrumb-list`—面包屑导航列表。 + - `breadcrumb-item`—单个面包屑项。 - - `nav-logo` — 导航栏中的 Logo。 - - `navbar-link` — 导航栏内的链接元素。 - - `nav-anchors` — 顶栏中锚点链接的容器。 - - `nav-anchor` — 顶栏中的单个锚点链接。 - - `nav-tabs` — 顶部导航中的标签页栏。 - - `nav-tabs-item` — 顶部导航标签页栏中的单个标签页项。 - - `mobile-nav-tabs-item` — 移动导航标签页栏中的标签页项。 - - `topbar-right-container` — 顶栏的右侧部分。 - - `nav-tag-pill` — 导航中显示的标签徽章。 - - `nav-tag-pill-text` — 导航标签徽章中的文本。 + - `nav-logo`—导航栏中的 Logo。 + - `navbar-link`—导航栏内的链接元素。 + - `nav-anchors`—顶栏中锚点链接的容器。 + - `nav-anchor`—顶栏中的单个锚点链接。 + - `nav-tabs`—顶部导航中的标签页栏。 + - `nav-tabs-item`—顶部导航标签页栏中的单个标签页项。 + - `mobile-nav-tabs-item`—移动导航标签页栏中的标签页项。 + - `topbar-right-container`—顶栏的右侧部分。 + - `nav-tag-pill`—导航中显示的标签徽章。 + - `nav-tag-pill-text`—导航标签徽章中的文本。 - - `nav-dropdown-trigger` — 打开导航下拉菜单的按钮。 - - `nav-dropdown-content` — 导航下拉菜单的内容容器。 - - `nav-dropdown-item` — 导航下拉菜单中的单个项。 - - `nav-dropdown-item-text-container` — 下拉菜单项中的文本容器。 - - `nav-dropdown-item-title` — 下拉菜单项中的标题文本。 - - `nav-dropdown-item-description` — 下拉菜单项中的描述文本。 - - `nav-dropdown-item-icon` — 下拉菜单项中的图标。 + - `nav-dropdown-trigger`—打开导航下拉菜单的按钮。 + - `nav-dropdown-content`—导航下拉菜单的内容容器。 + - `nav-dropdown-item`—导航下拉菜单中的单个项。 + - `nav-dropdown-item-text-container`—下拉菜单项中的文本容器。 + - `nav-dropdown-item-title`—下拉菜单项中的标题文本。 + - `nav-dropdown-item-description`—下拉菜单项中的描述文本。 + - `nav-dropdown-item-icon`—下拉菜单项中的图标。 - - `nav-dropdown-products-selector-trigger` — 打开产品选择器下拉菜单的按钮。 - - `nav-dropdown-products-selector-content` — 产品选择器的内容容器。 - - `nav-dropdown-products-selector-item` — 选择器中的单个产品。 - - `nav-dropdown-products-selector-item-title` — 产品选择器项的标题。 - - `nav-dropdown-products-selector-item-description` — 产品选择器项的描述。 - - `nav-dropdown-products-selector-item-icon` — 产品选择器项的图标。 + - `nav-dropdown-products-selector-trigger`—打开产品选择器下拉菜单的按钮。 + - `nav-dropdown-products-selector-content`—产品选择器的内容容器。 + - `nav-dropdown-products-selector-item`—选择器中的单个产品。 + - `nav-dropdown-products-selector-item-title`—产品选择器项的标题。 + - `nav-dropdown-products-selector-item-description`—产品选择器项的描述。 + - `nav-dropdown-products-selector-item-icon`—产品选择器项的图标。 - - `sidebar-group` — 侧边栏中的相关链接分组。 - - `sidebar-group-icon` — 侧边栏分组的图标。 - - `sidebar-group-header` — 侧边栏分组的标题标签。 - - `sidebar-title` — 侧边栏中的顶级标题。 - - `sidebar-nav-group-divider` — 侧边栏导航分组之间的分隔线。 + - `sidebar-group`—侧边栏中的相关链接分组。 + - `sidebar-group-icon`—侧边栏分组的图标。 + - `sidebar-group-header`—侧边栏分组的标题标签。 + - `sidebar-title`—侧边栏中的顶级标题。 + - `sidebar-nav-group-divider`—侧边栏导航分组之间的分隔线。 - - `toc` — 目录容器。 - - `toc-item` — 目录中的单个标题条目。 + - `toc`—目录容器。 + - `toc-item`—目录中的单个标题条目。 - - `footer` — 标准页脚。也可用作 ID 选择器：`#footer`。 - - `advanced-footer` — 包含额外列或内容的扩展页脚。 + - `footer`—标准页脚。也可用作 ID 选择器：`#footer`。 + - `advanced-footer`—包含额外列或内容的扩展页脚。 - - `pagination-prev` — 分页栏中的上一页链接。 - - `pagination-next` — 分页栏中的下一页链接。 - - `pagination-title` — 分页栏中显示的页面标题。 + - `pagination-prev`—分页栏中的上一页链接。 + - `pagination-next`—分页栏中的下一页链接。 + - `pagination-title`—分页栏中显示的页面标题。 - - `api-section` — 单个 API 端点的完整部分。 - - `api-section-heading` — API 端点部分的标题区域。 - - `api-section-heading-title` — API 端点部分标题中的标题文本。 - - `api-section-heading-subtitle` — API 端点部分标题中的副标题。 - - `field` — API 参考中的参数或属性字段。 - - `option-dropdown` — 用于在 API 选项之间选择的下拉菜单。 - - `tryit-button` — 打开 API playground 的 "Try it" 按钮。 - - `method-pill` — 端点上的 HTTP 方法徽章（GET、POST 等）。 - - `method-nav-pill` — 侧边栏导航中显示的 HTTP 方法徽章。 - - `prompt` — API 参考中的 prompt 组件。 + - `api-section`—单个 API 端点的完整部分。 + - `api-section-heading`—API 端点部分的标题区域。 + - `api-section-heading-title`—API 端点部分标题中的标题文本。 + - `api-section-heading-subtitle`—API 端点部分标题中的副标题。 + - `field`—API 参考中的参数或属性字段。 + - `option-dropdown`—用于在 API 选项之间选择的下拉菜单。 + - `tryit-button`—打开 API playground 的 "Try it" 按钮。 + - `method-pill`—端点上的 HTTP 方法徽章（GET、POST 等）。 + - `method-nav-pill`—侧边栏导航中显示的 HTTP 方法徽章。 + - `prompt`—API 参考中的 prompt 组件。 - - `chat-assistant-sheet` — AI 助手面板容器。 - - `chat-assistant-sheet-header` — AI 助手面板的头部。 - - `chat-assistant-sheet-content` — AI 助手面板的内容区域。 - - `chat-assistant-input` — AI 助手面板内的文本输入。 - - `chat-assistant-floating-input` — AI 助手的浮动输入变体。 - - `chat-assistant-send-button` — AI 助手面板中的发送按钮。 - - `chat-assistant-disclaimer-text` — AI 助手面板中显示的免责声明文本。 - - `chat-assistant-payload-item` — 助手面板中的单条消息或结果项。 - - `starter-question-text` — 空助手面板中显示的建议起始问题。 + - `chat-assistant-sheet`—AI 助手面板容器。 + - `chat-assistant-sheet-header`—AI 助手面板的头部。 + - `chat-assistant-sheet-content`—AI 助手面板的内容区域。 + - `chat-assistant-input`—AI 助手面板内的文本输入。 + - `chat-assistant-floating-input`—AI 助手的浮动输入变体。 + - `chat-assistant-send-button`—AI 助手面板中的发送按钮。 + - `chat-assistant-disclaimer-text`—AI 助手面板中显示的免责声明文本。 + - `chat-assistant-payload-item`—助手面板中的单条消息或结果项。 + - `starter-question-text`—空助手面板中显示的建议起始问题。 - - `feedback-toolbar` — 包含页面反馈控件的工具栏。 - - `contextual-feedback-container` — 上下文内联反馈的容器。 - - `contextual-feedback-form` — 内联上下文反馈表单。 - - `contextual-feedback-form-title` — 上下文反馈表单的标题。 - - `contextual-feedback-input` — 上下文反馈表单内的文本输入。 - - `contextual-feedback-button` — 上下文反馈表单内的操作按钮。 - - `contextual-feedback-form-submit-button` — 上下文反馈表单的提交按钮。 + - `feedback-toolbar`—包含页面反馈控件的工具栏。 + - `contextual-feedback-container`—上下文内联反馈的容器。 + - `contextual-feedback-form`—内联上下文反馈表单。 + - `contextual-feedback-form-title`—上下文反馈表单的标题。 + - `contextual-feedback-input`—上下文反馈表单内的文本输入。 + - `contextual-feedback-button`—上下文反馈表单内的操作按钮。 + - `contextual-feedback-form-submit-button`—上下文反馈表单的提交按钮。 - - `code-snippet-feedback-popover-content` — 代码片段反馈的弹出内容。 - - `code-snippet-feedback-form` — 代码片段的反馈表单。 - - `code-snippet-feedback-textarea` — 代码片段反馈表单内的文本区域。 - - `code-snippet-feedback-form-title` — 代码片段反馈表单的标题。 - - `code-snippet-feedback-form-description` — 代码片段反馈表单中的描述文本。 - - `code-snippet-feedback-form-submit-button` — 代码片段反馈表单的提交按钮。 + - `code-snippet-feedback-popover-content`—代码片段反馈的弹出内容。 + - `code-snippet-feedback-form`—代码片段的反馈表单。 + - `code-snippet-feedback-textarea`—代码片段反馈表单内的文本区域。 + - `code-snippet-feedback-form-title`—代码片段反馈表单的标题。 + - `code-snippet-feedback-form-description`—代码片段反馈表单中的描述文本。 + - `code-snippet-feedback-form-submit-button`—代码片段反馈表单的提交按钮。 - - `login-link` — 发起登录流程的链接。 - - `logout-link` — 发起登出流程的链接。 + - `login-link`—发起登录流程的链接。 + - `logout-link`—发起登出流程的链接。 - - `multi-view-item` — 多视图切换器中的单个视图选项。 - - `multi-view-dropdown` — 用于在多个视图之间选择的下拉菜单。 - - `multi-view-dropdown-trigger` — 打开多视图下拉菜单的按钮。 - - `multi-view-dropdown-content` — 多视图下拉菜单的内容区域。 - - `multi-view-dropdown-item` — 多视图下拉菜单中的单个项。 + - `multi-view-item`—多视图切换器中的单个视图选项。 + - `multi-view-dropdown`—用于在多个视图之间选择的下拉菜单。 + - `multi-view-dropdown-trigger`—打开多视图下拉菜单的按钮。 + - `multi-view-dropdown-content`—多视图下拉菜单的内容区域。 + - `multi-view-dropdown-item`—多视图下拉菜单中的单个项。 - - `directory` — 目录页的根容器。 - - `directory-group` — 目录内的相关页面分组。 - - `directory-page` — 目录中的单个页面条目。 - - `directory-card` — 目录中以卡片形式显示的页面条目。 + - `directory`—目录页的根容器。 + - `directory-group`—目录内的相关页面分组。 + - `directory-page`—目录中的单个页面条目。 + - `directory-card`—目录中以卡片形式显示的页面条目。 - - `not-found-container` — 404 页面的根容器。 - - `not-found-status-code` — 404 页面上的状态码显示。 - - `not-found-title` — 404 页面上的标题。 - - `not-found-description` — 404 页面上的描述文本。 - - `not-found-recommended-pages-list` — 404 页面上显示的推荐页面列表。 - - `not-found-recommended-page-link` — 推荐页面列表中的单个链接。 + - `not-found-container`—404 页面的根容器。 + - `not-found-status-code`—404 页面上的状态码显示。 + - `not-found-title`—404 页面上的标题。 + - `not-found-description`—404 页面上的描述文本。 + - `not-found-recommended-pages-list`—404 页面上显示的推荐页面列表。 + - `not-found-recommended-page-link`—推荐页面列表中的单个链接。 - - `color` — 色彩样本元素。 - - `color-row` — 色彩样本分组行。 - - `color-item` — 颜色行中的单个颜色项。 + - `color`—色彩样本元素。 + - `color-row`—色彩样本分组行。 + - `color-item`—颜色行中的单个颜色项。 - - `tree` — 文件树容器。 - - `tree-folder` — 文件树中的文件夹条目。 - - `tree-file` — 文件树中的文件条目。 + - `tree`—文件树容器。 + - `tree-folder`—文件树中的文件夹条目。 + - `tree-file`—文件树中的文件条目。 部分元素暴露了可用作 CSS 选择器的数据属性。 激活状态 (`data-active`)： - - `nav-dropdown-item[data-active]` — 导航下拉菜单中的激活项。 - - `mobile-nav-tabs-item[data-active]` — 移动导航中的激活标签页。 - - `sidebar-group[data-active]` — 激活的侧边栏分组。 - - `#sidebar-content li[data-active]` — 激活的侧边栏链接。 - - `.nav-tabs-item[data-active]` — 激活的顶部导航标签页。仅适用于简单标签页；带有下拉菜单的标签页不会接收 `data-active`。注意前导的 `.`：它针对的是标准 `` 元素上的类，与大多数使用自定义元素名称的其他组件不同。 - - `toc-item[data-active]` — 激活的目录项。 - - `toc-item[data-active-deepest]` — 最深层激活的目录项。仅出现在当前可见的确切标题上，与 `data-active` 不同，后者也会设置在其父级标题上。 + - `nav-dropdown-item[data-active]`—导航下拉菜单中的激活项。 + - `mobile-nav-tabs-item[data-active]`—移动导航中的激活标签页。 + - `sidebar-group[data-active]`—激活的侧边栏分组。 + - `#sidebar-content li[data-active]`—激活的侧边栏链接。 + - `.nav-tabs-item[data-active]`—激活的顶部导航标签页。仅适用于简单标签页；带有下拉菜单的标签页不会接收 `data-active`。注意前导的 `.`：它针对的是标准 `` 元素上的类，与大多数使用自定义元素名称的其他组件不同。 + - `toc-item[data-active]`—激活的目录项。 + - `toc-item[data-active-deepest]`—最深层激活的目录项。仅出现在当前可见的确切标题上，与 `data-active` 不同，后者也会设置在其父级标题上。 组件名称 (`data-component-name`)： 使用 `data-component-name` 来定位特定的 UI 组件，该选择器在内部类名更改后仍然有效。 - - `[data-component-name="mermaid-container"]` — Mermaid 图表容器，包含缩放控件覆盖层。 - - `[data-component-name="mermaid-controls-wrapper"]` — Mermaid 缩放和平移控件。 - - `[data-component-name="primary-header-button"]` — 主要头部按钮。仅限 Sequoia 主题。 - - `[data-component-name="theme-toggle"]` — 主题切换开关。 + - `[data-component-name="mermaid-container"]`—Mermaid 图表容器，包含缩放控件覆盖层。 + - `[data-component-name="mermaid-controls-wrapper"]`—Mermaid 缩放和平移控件。 + - `[data-component-name="primary-header-button"]`—主要头部按钮。仅限 Sequoia 主题。 + - `[data-component-name="theme-toggle"]`—主题切换开关。 组件部分 (`data-component-part`)： 使用 `data-component-part` 来定位组件内的子元素。 - - `[data-component-part="contact-support-button"]` — 助手面板中联系支持链接的 `` 包装器。 - - `[data-component-part="contact-support-icon"]` — 包裹图标的 ``。 - - `[data-component-part="contact-support-text"]` — 包含标签的 `

` 元素。 + - `[data-component-part="contact-support-button"]`—助手面板中联系支持链接的 `` 包装器。 + - `[data-component-part="contact-support-icon"]`—包裹图标的 ``。 + - `[data-component-part="contact-support-text"]`—包含标签的 `

` 元素。 Badge 属性： - - `[data-badge]` — 任何 badge 元素。 - - `[data-badge][data-color="blue"]` — 按颜色筛选的 badge。 - - `[data-badge][data-size="sm"]` — 按尺寸筛选的 badge。 + - `[data-badge]`—任何 badge 元素。 + - `[data-badge][data-color="blue"]`—按颜色筛选的 badge。 + - `[data-badge][data-size="sm"]`—按尺寸筛选的 badge。 当前路径 (`data-current-path`)： 使用 `data-current-path` 在特定页面或子路径上应用自定义 CSS 样式。 - - `html[data-current-path="/"]` — 匹配根页面。 - - `html[data-current-path="/quickstart"]` — 匹配特定页面。 - - `html[data-current-path^="/api-reference/"]` — 匹配某个部分下的任何页面。 + - `html[data-current-path="/"]`—匹配根页面。 + - `html[data-current-path="/quickstart"]`—匹配特定页面。 + - `html[data-current-path^="/api-reference/"]`—匹配某个部分下的任何页面。 diff --git a/zh/dashboard/sso.mdx b/zh/dashboard/sso.mdx index b55e566729..91a9ca5c3e 100644 --- a/zh/dashboard/sso.mdx +++ b/zh/dashboard/sso.mdx @@ -193,7 +193,7 @@ Enterprise 管理员可以直接在 Mintlify dashboard 中为 Okta 或 Microsoft | Name | Name format | Filter | Value | | ---- | ----------- | ------ | ----- | - | `groups` | Unspecified | Matches regex | `.*` | + | `groups` | Unspecified | `Matches regex` | `.*` | 调整过滤器以匹配你希望发送到 Mintlify 的特定组。 diff --git a/zh/enterprise-contracting.mdx b/zh/enterprise-contracting.mdx index 73145701ef..235798ae8a 100644 --- a/zh/enterprise-contracting.mdx +++ b/zh/enterprise-contracting.mdx @@ -89,7 +89,7 @@ hidden: true **原因：** 我们使用第三方 LLM 提供商，但无法保证其输出。没有软件公司能够保证依赖于客户数据、使用场景或第三方集成的结果。 - **这对您意味着什么：** 我们将以书面形式保证我们的 LLM 提供商在合同中被禁止将您的数据用于模型训练或改进——这才是真正重要的保护。 + **这对您意味着什么：** 我们以书面形式保证我们的 LLM 提供商在合同中被禁止将您的数据用于模型训练或改进——这才是真正重要的保护。 diff --git a/zh/organize/settings-seo.mdx b/zh/organize/settings-seo.mdx index 7025ea6bf3..55f1af69b3 100644 --- a/zh/organize/settings-seo.mdx +++ b/zh/organize/settings-seo.mdx @@ -29,8 +29,8 @@ keywords: ["SEO", "搜索", "索引", "meta 标签", "描述", "时间戳", "最 指定搜索引擎应索引哪些页面。 - - `navigable` — 仅索引包含在 `docs.json` 导航中的页面。默认为此值。 - - `all` — 索引项目中的每个页面，包括不在导航中的页面。 + - `navigable`—仅索引包含在 `docs.json` 导航中的页面。默认为此值。 + - `all`—索引项目中的每个页面，包括不在导航中的页面。 @@ -49,12 +49,12 @@ keywords: ["SEO", "搜索", "索引", "meta 标签", "描述", "时间戳", "最 用作每个页面所发出[结构化数据](/zh/optimize/seo#structured-data)中发布者实体的组织。所有字段均为可选。省略时，Mintlify 会根据你的站点名称、文档 logo 和站点 URL 推导组织。 - - `id` — 用于在各页面中标识你的组织的稳定 `@id` URL，例如 `https://example.com/#organization`。默认值为 `<站点来源>/#organization`。 - - `name` — 组织名称。默认值为站点名称。 - - `legalName` — 注册的法定名称。 - - `url` — 组织主页的规范 URL。 - - `logo` — 在结构化数据中使用的规范 logo URL。默认值为文档 logo。 - - `sameAs` — 官方主页 URL 数组，例如 X、LinkedIn 或 GitHub。 + - `id`—用于在各页面中标识你的组织的稳定 `@id` URL，例如 `https://example.com/#organization`。默认值为 `<站点来源>/#organization`。 + - `name`—组织名称。默认值为站点名称。 + - `legalName`—注册的法定名称。 + - `url`—组织主页的规范 URL。 + - `logo`—在结构化数据中使用的规范 logo URL。默认值为文档 logo。 + - `sameAs`—官方主页 URL 数组，例如 X、LinkedIn 或 GitHub。 ```json "organization": {