From d8919f8f457d14b115edd69a3cb664276972fa3c Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Mon, 27 Jul 2026 21:15:53 +0000 Subject: [PATCH] docs: translate custom developer portals page to es, fr, zh --- es.json | 3 +- es/deploy/custom-portal.mdx | 90 +++++++++++++++++++++++++++++++++++++ fr.json | 3 +- fr/deploy/custom-portal.mdx | 90 +++++++++++++++++++++++++++++++++++++ zh.json | 3 +- zh/deploy/custom-portal.mdx | 90 +++++++++++++++++++++++++++++++++++++ 6 files changed, 276 insertions(+), 3 deletions(-) create mode 100644 es/deploy/custom-portal.mdx create mode 100644 fr/deploy/custom-portal.mdx create mode 100644 zh/deploy/custom-portal.mdx diff --git a/es.json b/es.json index 7f8a8c8fc..35a2e624a 100644 --- a/es.json +++ b/es.json @@ -200,7 +200,8 @@ "es/deploy/ghes", "es/deploy/gitlab", "es/deploy/gitlab-self-hosted", - "es/deploy/self-host" + "es/deploy/self-host", + "es/deploy/custom-portal" ] }, { diff --git a/es/deploy/custom-portal.mdx b/es/deploy/custom-portal.mdx new file mode 100644 index 000000000..13d3ec826 --- /dev/null +++ b/es/deploy/custom-portal.mdx @@ -0,0 +1,90 @@ +--- +title: "Portales para desarrolladores personalizados" +description: "Despliega un portal para desarrolladores totalmente personalizado sobre una instalación autoalojada de Mintlify, diseñado y construido por Mintlify y entregado mediante versiones publicadas." +keywords: ["developer portal", "custom presentation layer", "API marketplace", "self-host", "on-prem", "white label", "enterprise"] +--- + + + Los portales personalizados requieren un [plan Enterprise](https://mintlify.com/pricing?ref=custom-portal) y un [despliegue autoalojado](/es/deploy/self-host). Ponte en contacto con tu equipo de cuenta para dimensionar uno. + + +En algunas plataformas, la documentación es solo una de las superficies de un producto más amplio: un marketplace de APIs, un portal para partners o una experiencia para desarrolladores con inicio de sesión, credenciales y soporte integrados. Mintlify cubre estos casos de uso diseñando, construyendo y manteniendo una capa de presentación personalizada que reemplaza el front-end de tu portal actual, mientras tu equipo redacta el contenido a través del editor de Mintlify o de un flujo de trabajo basado en Git. + +El portal se integra con tus APIs, tu gateway y tus sistemas subyacentes existentes, que siguen siendo propiedad de tu equipo y operados por él. + +
+ ## Características +
+ +| Característica | Qué se entrega | Respaldado por | +| --- | --- | --- | +| Capa de presentación personalizada | Una aplicación de front-end completa con tu sistema de diseño, desplegada dentro de tu entorno | Mintlify, junto con la plataforma autoalojada | +| Páginas de producto y catálogo | Marketplace, descubrimiento de productos y superficies de documentación | Contenido mantenido en Mintlify | +| Inicio de sesión | Sesiones autenticadas en todo el portal | Tu proveedor de identidad | +| Aplicaciones y credenciales | Registro de aplicaciones y gestión de credenciales | Tus APIs de backend | +| Suscripciones | Suscripciones a productos y planes | Tus APIs de backend | +| Perfiles y notificaciones | Perfiles de usuario y centros de notificaciones | Tus APIs de backend | +| Soporte | Creación y seguimiento de tickets de soporte | Tus APIs de backend | +| Búsqueda | Búsqueda contextual al inicio de sesión, limitada a lo que el usuario puede acceder | Plataforma de Mintlify | +| Contenido personalizado | Filtrado basado en permisos y grupos aplicado en el servidor en el momento del renderizado, de modo que los usuarios solo ven los productos y páginas a los que tienen acceso | Plataforma de Mintlify y tu proveedor de identidad | +| Versiones continuas | Versiones publicadas con guías de actualización, el mismo modelo operativo que cualquier [despliegue autoalojado](/es/deploy/self-host#updates) | Mintlify | + +
+ ## Flujo de redacción +
+ +El front-end personalizado no afecta a la forma en que se escribe el contenido. Mantén el contenido con el editor o con un flujo de trabajo local basado en Git. Cada cambio pasa por el proceso de revisión de tu repositorio con un rastro de auditoría completo, y la publicación desencadena builds que actualizan el portal automáticamente. Los cambios de contenido no requieren un despliegue del front-end. + +
+ ## Arquitectura +
+ +La capa de presentación personalizada se integra con la plataforma autoalojada de Mintlify para contenido, búsqueda y personalización; con tu gateway de APIs para aplicaciones, suscripciones y soporte; y con tu proveedor de identidad para la autenticación. + +```mermaid +flowchart TD + U[Users] --> CDN[CDN and WAF] + CDN --> PORTAL[Custom presentation layer] + PORTAL --> PLAT[Mintlify platform
content, search, personalization] + PORTAL --> GW[Your API gateway] + GW --> BE[Your backend services
applications, subscriptions, support] + PORTAL --> IDP[Your identity provider] + W[Writers] --> ED[Editor and Git workflow] + ED --> PLAT +``` + +La capa de presentación personalizada y la plataforma de Mintlify se ejecutan dentro del perímetro de tu red, utilizando tu clúster, tus almacenes de datos y tu stack de observabilidad, sin salida a terceros. Tus sistemas de registro subyacentes permanecen sin cambios; el portal accede a ellos a través de tus APIs existentes. + +
+ ## Cómo se desarrolla el proyecto +
+ + + + Tu equipo de cuenta mapea las superficies del portal, tu sistema de diseño y las APIs de backend que consume el portal, y acuerda un contrato de integración con tu equipo de plataforma. + + + El proyecto normalmente implementa primero tu sistema de diseño y las superficies de contenido públicas, para que puedas validar la experiencia frente a tu portal actual antes de la migración. + + + A continuación llegan el inicio de sesión, la gestión de credenciales, las suscripciones y otras experiencias con sesión iniciada, integradas con tu proveedor de identidad y tus APIs de backend. + + + La búsqueda contextual al inicio de sesión y la personalización en el servidor completan la experiencia principal. Las funciones opcionales de IA permanecen deshabilitadas hasta que tu equipo de seguridad o de gobierno de IA las apruebe. + + + +Durante todo el proceso, tu equipo revisa las versiones en entornos no productivos y controla cada migración. + +
+ ## Próximos pasos +
+ + + + Dimensiona un proyecto de portal personalizado y planifica tu lanzamiento. + + + La base de despliegue sobre la que se ejecuta un portal personalizado. + + diff --git a/fr.json b/fr.json index 7f2852a6a..b3c1ad7d4 100644 --- a/fr.json +++ b/fr.json @@ -200,7 +200,8 @@ "fr/deploy/ghes", "fr/deploy/gitlab", "fr/deploy/gitlab-self-hosted", - "fr/deploy/self-host" + "fr/deploy/self-host", + "fr/deploy/custom-portal" ] }, { diff --git a/fr/deploy/custom-portal.mdx b/fr/deploy/custom-portal.mdx new file mode 100644 index 000000000..3fe324d1b --- /dev/null +++ b/fr/deploy/custom-portal.mdx @@ -0,0 +1,90 @@ +--- +title: "Portails développeur personnalisés" +description: "Déployez un portail développeur entièrement personnalisé sur Mintlify auto-hébergé, conçu et développé par Mintlify et livré via des versions numérotées." +keywords: ["developer portal", "custom presentation layer", "API marketplace", "self-host", "on-prem", "white label", "enterprise"] +--- + + + Les portails personnalisés nécessitent un [plan Enterprise](https://mintlify.com/pricing?ref=custom-portal) et un [déploiement auto-hébergé](/fr/deploy/self-host). Contactez votre équipe de compte pour en cadrer un. + + +Pour certaines plateformes, la documentation n'est qu'une des surfaces d'un produit plus vaste — une place de marché d'API, un portail partenaire ou une expérience développeur intégrant la connexion, la gestion des identifiants et le support. Mintlify prend en charge ces cas d'usage en concevant, développant et maintenant une couche de présentation personnalisée qui remplace le front-end de votre portail existant, tandis que votre équipe rédige le contenu via l'éditeur Mintlify ou un workflow adossé à Git. + +Le portail s'intègre à vos API, à votre passerelle et à vos systèmes en aval existants, qui restent détenus et exploités par votre équipe. + +
+ ## Fonctionnalités +
+ +| Fonctionnalité | Ce qui est livré | Assuré par | +| --- | --- | --- | +| Couche de présentation personnalisée | Une application front-end complète dans votre design system, déployée à l'intérieur de votre environnement | Mintlify, aux côtés de la plateforme auto-hébergée | +| Pages produits et catalogue | Surfaces de place de marché, de découverte de produits et de documentation | Contenu maintenu sur Mintlify | +| Connexion | Sessions authentifiées sur l'ensemble du portail | Votre fournisseur d'identité | +| Applications et identifiants | Enregistrement d'applications et gestion des identifiants | Vos API backend | +| Abonnements | Abonnements aux produits et aux plans | Vos API backend | +| Profils et notifications | Profils utilisateur et centres de notifications | Vos API backend | +| Support | Création et suivi de tickets de support | Vos API backend | +| Recherche | Recherche tenant compte de la connexion et limitée à ce à quoi l'utilisateur a accès | Plateforme Mintlify | +| Contenu personnalisé | Filtrage par droits et par groupes appliqué côté serveur au moment du rendu, afin que les utilisateurs ne voient que les produits et pages auxquels ils ont accès | Plateforme Mintlify et votre fournisseur d'identité | +| Versions récurrentes | Versions numérotées avec des guides de mise à niveau, selon le même modèle opérationnel que tout [déploiement auto-hébergé](/fr/deploy/self-host#updates) | Mintlify | + +
+ ## Workflow de rédaction +
+ +Le front-end personnalisé ne change pas la manière dont le contenu est rédigé. Entretenez le contenu avec l'éditeur ou un workflow local adossé à Git. Chaque modification passe par le processus de revue de votre dépôt avec une piste d'audit complète, et la publication déclenche des builds qui mettent à jour le portail automatiquement. Les changements de contenu ne nécessitent pas de déploiement du front-end. + +
+ ## Architecture +
+ +La couche de présentation personnalisée s'intègre à la plateforme Mintlify auto-hébergée pour le contenu, la recherche et la personnalisation ; à votre passerelle API pour les applications, les abonnements et le support ; et à votre fournisseur d'identité pour l'authentification. + +```mermaid +flowchart TD + U[Users] --> CDN[CDN and WAF] + CDN --> PORTAL[Custom presentation layer] + PORTAL --> PLAT[Mintlify platform
content, search, personalization] + PORTAL --> GW[Your API gateway] + GW --> BE[Your backend services
applications, subscriptions, support] + PORTAL --> IDP[Your identity provider] + W[Writers] --> ED[Editor and Git workflow] + ED --> PLAT +``` + +La couche de présentation personnalisée et la plateforme Mintlify s'exécutent à l'intérieur de votre périmètre réseau, en utilisant votre cluster, vos magasins de données et votre stack d'observabilité, sans sortie vers des tiers. Vos systèmes de référence en aval restent inchangés ; le portail y accède via vos API existantes. + +
+ ## Comment se déroule l'engagement +
+ + + + Votre équipe de compte cartographie les surfaces du portail, votre design system et les API backend que le portail consomme, puis convient d'un contrat d'intégration avec votre équipe plateforme. + + + L'engagement implémente typiquement votre design system et les surfaces de contenu publiques en premier, afin que vous puissiez valider l'expérience par rapport à votre portail existant avant la bascule. + + + La connexion, la gestion des identifiants, les abonnements et les autres expériences authentifiées suivent, intégrées à votre fournisseur d'identité et à vos API backend. + + + La recherche tenant compte de la connexion et la personnalisation côté serveur complètent l'expérience de base. Les fonctionnalités d'IA optionnelles restent désactivées jusqu'à ce que votre équipe de sécurité ou de gouvernance de l'IA les approuve. + + + +Tout au long, votre équipe examine les versions dans des environnements hors production et contrôle chaque bascule. + +
+ ## Étapes suivantes +
+ + + + Cadrez un engagement de portail personnalisé et planifiez votre lancement. + + + La base de déploiement sur laquelle s'exécute un portail personnalisé. + + diff --git a/zh.json b/zh.json index 0d1f7b074..5966cc353 100644 --- a/zh.json +++ b/zh.json @@ -197,7 +197,8 @@ "zh/deploy/ghes", "zh/deploy/gitlab", "zh/deploy/gitlab-self-hosted", - "zh/deploy/self-host" + "zh/deploy/self-host", + "zh/deploy/custom-portal" ] }, { diff --git a/zh/deploy/custom-portal.mdx b/zh/deploy/custom-portal.mdx new file mode 100644 index 000000000..03c534dab --- /dev/null +++ b/zh/deploy/custom-portal.mdx @@ -0,0 +1,90 @@ +--- +title: "定制开发者门户" +description: "在自托管 Mintlify 之上部署完全定制的开发者门户，由 Mintlify 设计和构建，并通过版本化发布交付。" +keywords: ["developer portal", "custom presentation layer", "API marketplace", "self-host", "on-prem", "white label", "enterprise"] +--- + + + 定制门户需要 [Enterprise 套餐](https://mintlify.com/pricing?ref=custom-portal)以及[自托管部署](/zh/deploy/self-host)。请联系你的客户团队来规划部署范围。 + + +对某些平台而言，文档只是一个更大产品的一个表层——一个 API 市场、一个合作伙伴门户，或是一个内建了登录、凭据和支持的开发者体验。Mintlify 支持这些用例：由我们设计、构建并持续维护一个定制的呈现层来替换你现有的门户前端，同时你的团队通过 Mintlify 编辑器或基于 Git 的工作流来创作内容。 + +该门户会与你现有的 API、网关和下游系统集成，这些系统仍由你的团队拥有和运营。 + +
+ ## 功能 +
+ +| 功能 | 交付内容 | 支撑方 | +| --- | --- | --- | +| 定制呈现层 | 采用你的设计体系的完整前端应用，部署在你的环境中 | Mintlify，与自托管平台一同交付 | +| 产品与目录页面 | 市场、产品发现和文档界面 | 内容维护在 Mintlify 上 | +| 登录 | 门户内的认证会话 | 你的身份提供方 | +| 应用与凭据 | 应用注册和凭据管理 | 你的后端 API | +| 订阅 | 产品与套餐订阅 | 你的后端 API | +| 个人资料与通知 | 用户资料与通知中心 | 你的后端 API | +| 支持 | 支持工单的创建和跟踪 | 你的后端 API | +| 搜索 | 感知登录状态、限定在用户可访问范围内的搜索 | Mintlify 平台 | +| 个性化内容 | 在渲染时基于权限和分组在服务器端进行过滤，用户只会看到他们有权访问的产品和页面 | Mintlify 平台和你的身份提供方 | +| 持续发布 | 带升级指南的版本化发布，与任意[自托管部署](/zh/deploy/self-host#updates)相同的运营模式 | Mintlify | + +
+ ## 创作流程 +
+ +定制前端不会影响内容的创作方式。你可以通过编辑器或本地基于 Git 的工作流来维护内容。每次变更都会经过你仓库的评审流程，具备完整的审计记录；发布会触发构建自动更新门户。内容变更不需要重新部署前端。 + +
+ ## 架构 +
+ +定制呈现层与自托管的 Mintlify 平台集成以获取内容、搜索和个性化能力；与你的 API 网关集成以处理应用、订阅和支持；并与你的身份提供方集成以完成认证。 + +```mermaid +flowchart TD + U[Users] --> CDN[CDN and WAF] + CDN --> PORTAL[Custom presentation layer] + PORTAL --> PLAT[Mintlify platform
content, search, personalization] + PORTAL --> GW[Your API gateway] + GW --> BE[Your backend services
applications, subscriptions, support] + PORTAL --> IDP[Your identity provider] + W[Writers] --> ED[Editor and Git workflow] + ED --> PLAT +``` + +定制呈现层与 Mintlify 平台都运行在你的网络边界内，使用你的集群、数据存储和可观测性技术栈，没有任何向第三方的外发流量。你的下游记录系统保持不变；门户通过你现有的 API 访问它们。 + +
+ ## 项目如何推进 +
+ + + + 你的客户团队会梳理门户的各个界面、你的设计体系以及门户所调用的后端 API，并与你的平台团队约定集成契约。 + + + 项目通常会先落地你的设计体系和公开的内容界面，让你在切换前可以对照现有门户来验证体验。 + + + 随后交付登录、凭据管理、订阅以及其他需要登录的体验，并与你的身份提供方和后端 API 集成。 + + + 感知登录状态的搜索和服务器端个性化能力完善核心体验。可选的 AI 功能会保持禁用，直到你的安全或 AI 治理团队批准。 + + + +在整个过程中，你的团队会在非生产环境中评审各次发布，并掌控每一次的切换。 + +
+ ## 后续步骤 +
+ + + + 规划定制门户项目并制定上线计划。 + + + 定制门户所依赖的部署基础。 + +