01
Funciona con material para páginas MkDocs
Guías de índice, páginas de referencia y HTML estático generado a partir de implementaciones públicas de MkDocs o Material para MkDocs sin reemplazar su tema.
MkDocs Bot de soporte
MkDocs Chatbot de IA para MkDocs Documentación
Un chatbot de IA para la documentación de MkDocs y Material for MkDocs. ChattyBox rastrea tu sitio público, responde preguntas como «¿Cómo activo las pestañas de navegación?» desde esas páginas y cita la fuente. No hay canal de indexación de Python ni RAG personalizado que mantener.
Rastrea páginas de documentos publicados
Respuestas citadas en la fuente
Incrustado con un script
No se requiere migración de documentos
No se requiere tarjeta de créditoTu contenido sigue siendo tuyo
Preguntar a ChattyBox
x¿Por dónde debería empezar si necesito una respuesta fiable de este sitio?
Empieza añadiendo la URL de tu sitio web a ChattyBox. Rastrea tu contenido, responde desde las páginas que encuentra y muestra a los visitantes las fuentes detrás de cada respuesta.
iFuentes3^
MkDocs guía
chattybox.ai
Analítica
chattybox.ai
Inicio
chattybox.ai
Haz una pregunta...
Con tecnología de ChattyBox
Construido para MkDocs equipos
Inicie un chatbot con fuente citada sin reconstruir su pila de documentos
ChattyBox rastrea su documentación existente, indexa el contenido para su recuperación e incorpora un chatbot que responde utilizando sus documentos en lugar de la memoria del modelo genérico.
La invalidación de Material conserva el JavaScript del tema y añade un único cargador asíncrono del widget.
MkDocs vanilla usa un directorio de tema personalizado separado en lugar de asumir las rutas de Material.
Las comprobaciones cubren la coexistencia de la búsqueda, la navegación instantánea, los cargadores duplicados y las ventanas de visualización móviles estrechas.
La selección de rastreo consciente de la versión mantiene deliberadas las rutas estables, más recientes y heredadas de mike.
Paso del flujo de trabajo
Rastrea el sitemap desplegado de MkDocs o las rutas estables y versionadas que soportas intencionalmente.
Paso del flujo de trabajo
Prueba preguntas de producto, Python y API y abre cada cita antes de la instalación.
Paso del flujo de trabajo
Para Material, configura theme.custom_dir y extiende base.html desde overrides/main.html conservando el bloque de scripts con super().
Paso del flujo de trabajo
Verifica la búsqueda integrada, la navegación instantánea, los controles móviles, la CSP y cada versión publicada de mike.
Lanzamiento en tres pasos
Pegue su URL MkDocs, pruebe las respuestas citadas y luego instale el widget.
Flujo de trabajo específico de MkDocs
Soporte conversacional para sitios de documentación estática de Python
Los equipos de MkDocs normalmente quieren compilaciones estáticas rápidas, navegación clara y contenido técnico legible. ChattyBox mantiene ese flujo de trabajo intacto mientras agrega un asistente de fuente citada en la parte superior del sitio publicado.
02
Manejar deliberadamente la documentación versionada
Señale ChattyBox a las rutas de versión sobre las que desea que los usuarios pregunten y luego pruebe si las respuestas citan los documentos estables, más recientes o heredados previstos.
03
No hay trabajo de indexación de Python que mantener
Debido a que ChattyBox rastrea el sitio público, los equipos no necesitan agregar indexación vectorial a su proceso de compilación de MkDocs o scripts de CI.
04
Mejorar documentos a partir de preguntas reales.
Utilice preguntas sin respuesta para identificar ejemplos faltantes, pasos de instalación poco claros o páginas de solución de problemas obsoletas en su sitio MkDocs.
Evidencia editorial probada
Rutas de instalación probadas para Material y MkDocs vanilla
Material for MkDocs y el tema integrado de MkDocs admiten ambos la herencia de plantillas, pero deberían usar directorios personalizados separados. La ruta de Material siguiente conserva su bloque de scripts con super(), añade un cargador asíncrono y sobrevive a la navegación instantánea sin reemplazar el comportamiento de búsqueda.
- Autor técnico
- Equipo de documentación de ChattyBox
- Revisor técnico
- Ingeniería de ChattyBox
- Última actualización
- Información verificada
- MkDocs, Material for MkDocs y mike
Vuelve a comprobar los bloques de plantilla y el comportamiento de navegación instantánea tras las actualizaciones del tema, y vuelve a rastrear siempre que se mueva un alias de mike.
| Preocupación de MkDocs | Decisión de implementación | Verificación |
|---|---|---|
| Invalidación de Material | Define theme.name como material y theme.custom_dir como overrides. Extiende base.html, invalida scripts, llama a super() y luego añade el script del widget. | Compila y sirve el sitio, luego confirma que la búsqueda y la navegación de Material siguen funcionando. |
| MkDocs vanilla | Usa theme.name: mkdocs con un directorio custom_theme separado. Añade la invalidación equivalente custom_theme/main.html en lugar de copiar las plantillas de Material. | Ejecuta mkdocs serve y verifica la búsqueda, los enlaces de siguiente y anterior, y el widget en más de una página. |
| Carga asíncrona y duplicados | Conserva un único cargador en el bloque de scripts heredado, dale un ID estable y no añadas el mismo fragmento mediante extra_javascript u otro parcial. | Tras cargas completas y transiciones instantáneas de Material, confirma que document.querySelectorAll("#chattybox-widget").length es 1. |
| Política de Seguridad de Contenido | Permite chattybox.ai en script-src, el origen configurado de la API en connect-src, fonts.googleapis.com en style-src y fonts.gstatic.com en font-src. El widget actual inyecta su CSS de componente, de modo que un style-src estricto también necesita 'unsafe-inline' hasta que exista una compilación con nonce o con hoja de estilos externa. | Comprueba la consola del navegador y el panel de Network por si hay solicitudes de script, estilo, fuente, fetch o WebSocket bloqueadas. |
| Búsqueda, navegación instantánea y móvil | Conserva los scripts del tema con super() y mantén el lanzador lejos del diálogo de búsqueda, el cajón, la paginación y los controles de consentimiento. | Prueba la búsqueda con teclado, varios enlaces instantáneos y una ventana de 390 píxeles sin superposición ni desplazamiento horizontal. |
| versiones de mike | Elige deliberadamente rutas de versión estables, más recientes o explícitas. Vuelve a rastrear tras mover un alias y excluye las versiones no soportadas cuando las respuestas entre versiones puedan inducir a error a los usuarios. | Usa mike serve para probar el cambio de versión y confirma que las citas se resuelven dentro de la versión prevista. |
| Fallo del widget o de las citas | Comprueba la indentación de YAML, el custom_dir activo, el nombre del bloque heredado, la clave de API, la CSP, el contenido del sitemap y si la compilación desplegada incluye la invalidación. | Inspecciona el HTML generado y prueba el artefacto de producción en lugar de depender solo de la recarga en vivo. |
Comprobación de respuesta citada
Prueba una respuesta contra la versión activa
Usa una pregunta del tema con una regla de plantilla verificable, luego abre la cita y confirma que coincide con la versión que seleccionó tu visitante.
Pregunta a las guías de MkDocs
x¿Cómo añado el widget sin romper la búsqueda de Material?
Define theme.custom_dir como overrides, crea overrides/main.html, extiende base.html y añade el cargador asíncrono dentro del bloque de scripts después de super(). Llamar a super() conserva los scripts que Material usa para la búsqueda y la navegación.
Haz una pregunta...
Con tecnología de ChattyBox
Fuentes primarias y evidencia reproducible
Personalización de Material for MkDocsGuía oficial de custom_dir, herencia de plantillas e invalidación de bloques.Navegación instantánea de MaterialComportamiento oficial para el reemplazo de documentos sin una recarga completa de la página.Personalización del tema de MkDocsGuía oficial de directorio de tema personalizado, plantilla base y super() para MkDocs vanilla.Documentación versionada con mikeDespliegue de versiones, alias, versión predeterminada y prueba local de varias versiones.Ejemplos reproducibles de MkDocsProyectos separados de Material y vanilla con invalidaciones de plantilla probadas.
Ruta de instalación
Cómo agregar el widget a MkDocs
Para Material for MkDocs, define theme.custom_dir como overrides, extiende base.html en overrides/main.html y llama a super() antes del script asíncrono del widget. El MkDocs vanilla necesita su propio directorio de tema personalizado y una invalidación main.html equivalente.
- 1Cree un proyecto ChattyBox e ingrese la URL o el mapa del sitio de su sitio MkDocs o Material para MkDocs.
- 2Pruebe preguntas reales de MkDocs en el panel y confirme que las citas apunten a las páginas correctas.
- 3Añade la invalidación probada, compila el sitio y verifica la búsqueda, la navegación, la CSP y el comportamiento en móvil.
overrides/main.html
html
{% extends "base.html" %}
{% block scripts %}
{{ super() }}
<script
id="chattybox-widget"
src="https://chattybox.ai/widget.js"
async
data-api-key="YOUR_API_KEY"
data-api-url="https://adorable-woodpecker-629.convex.site/chat"
data-chattybox-widget="true"
></script>
{% endblock %}Explora lo siguiente
Más formas de usar ChattyBox
01
Chatbot de IA para documentación
Consulte la documentación fuente citada sobre el flujo de trabajo del chatbot que se aplica en todas las plataformas.
Abrir
02
API chatbot de documentación
Responda preguntas sobre puntos finales, parámetros y autenticación de los documentos de referencia de Python y API.
Abrir
03
Chatbot de IA Docusaurus
Compare el mismo flujo de trabajo fundamentado para los sitios de documentación de Docusaurus.
Abrir
04
Explorar todas las guías de la plataforma
Encuentre guías de configuración para Docusaurus, VitePress, Starlight, Nextra, Mintlify, ReadMe y más plataformas de documentos.
Abrir
Preguntas frecuentes
Preguntas comunes
¿ChattyBox funciona con Material for MkDocs?
Sí. ChattyBox puede rastrear páginas públicas MkDocs y Material for MkDocs e incrustarlas como un widget de sitio web estándar.
¿Necesito cambiar mi canal de compilación de Python?
No. Agregue el fragmento del widget a la plantilla de su sitio o anule el tema después de configurar el chatbot.
¿Puede el bot responder desde documentos versionados?
Sí, si las páginas de documentos versionados son públicas y están incluidas en el rastreo o en el mapa del sitio.
¿Puede identificar lagunas en la documentación?
Sí. Los análisis de ChattyBox ayudan a revelar preguntas que su contenido MkDocs aún no responde claramente.
Empieza gratis
No se requiere tarjeta de crédito. Tu contenido no se usa para entrenar modelos.
Crear chatbot gratis
Plan Free. Sin tarjeta.