Visión general
La carpeta de fragmentos contiene:
- Componentes - Componentes personalizados de React/JSX organizados por propósito
- Datos - Archivos de datos reutilizables (cadenas de código, variables, especificaciones de API)
- Páginas - Contenido MDX modular importado a las páginas principales de la documentación
- Scripts - Scripts de automatización y generación
- Automaciones - Archivos de automatización de recuperación y procesamiento de datos
- Activos - Imágenes, logotipos, archivos multimedia y activos estáticos
- Estilos - Definiciones de tema y estilo
- SnippetsWiki - Documentación interna sobre el sistema de fragmentos
Estructura de directorios
Componentes (/snippets/components/)
Componentes personalizados de React/JSX organizados por propósito:
Primitivos (/snippets/components/primitives/)
buttons.jsx - Componentes de botón (BasicBtn, DownloadButton)
divider.jsx - Componente CustomDivider
icons.jsx - Iconos de marca Livepeer (LivepeerIcon, LivepeerSVG, etc.)
links.jsx - Componentes de enlace y navegación (GotoLink, GotoCard, CustomCallout, etc.)
text.jsx - Componentes de texto (Subtitle, CopyText, etc.)
Layout (/snippets/components/layout/)
cards.jsx - Componentes de diseño de tarjetas (PostCard, BlogCard, ScrollBox)
lists.jsx - Componentes de lista (BasicList, IconList, StepList, etc.)
ListSteps.jsx - Componente ListSteps para renderizar listas como pasos
steps.jsx - Componentes de paso con estilo (StyledSteps, StyledStep)
table.jsx - Componente DynamicTable
quadGrid.jsx - Componente de diseño QuadGrid
text.jsx - Componentes de diseño de texto (AccordionLayout)
Mostrar (/snippets/components/display/)
video.jsx - Componentes de video (YouTubeVideo, CardVideo, LinkedInEmbed)
image.jsx - Componentes de imagen (Image, LinkImage)
embed.jsx - Componentes incrustados (MarkdownEmbed, EmbedMarkdown)
zoomable-diagram.jsx - Componente ScrollableDiagram
quote.jsx - Componentes de cita (Quote, FrameQuote)
frameMode.jsx - Componentes de encabezado en modo Frame (PageHeader, H1-H6, P, Divider)
showcaseCards.jsx - Componente ShowcaseCards
socialLinks.jsx - Componente SocialLinks
CardCarousel.jsx - Componente CardCarousel
Contenido (/snippets/components/content/)
code.jsx - Componentes de visualización de código (CustomCodeBlock, CodeComponent, ComplexCodeBlock)
external-content.jsx - Componente ExternalContent para cargar documentos externos
release.jsx - Componente LatestVersion
responseField.jsx - Componentes de campos de respuesta de la API (ResponseFieldGroup, ValueResponseField, etc.)
Integraciones (/snippets/components/integrations/)
coingecko.jsx - Componente CoinGeckoExchanges
Dominio (/snippets/components/domain/)
Componentes específicos del dominio organizados por sección de documentación:
04_GATEWAYS/ - Componentes específicos de la puerta de enlace
callouts.jsx - Llamadas de atención/advertencia de la puerta de enlace
quickstartTabs.jsx - Componentes de interfaz de usuario de inicio rápido de la puerta de enlace
SHARED/ - Componentes compartidos entre dominios
HeroGif.jsx - Componente de animación de estrellas
Portals.jsx - Componentes de diseño de la página de portal
previewCallouts.jsx - Llamados a la acción de vista previa/pendiente
Datos (/snippets/data/)
Archivos de datos reutilizables para cadenas de código, variables y referencias:
gateways/ - Archivos de datos relacionados con el gateway
code.jsx - Cadenas de código de Docker e instalación
flags.jsx - Marcas de configuración
quickstart.jsx - Datos de inicio rápido
linux/ - Datos de código específicos de Linux
references/ - Datos de referencia
chainlist.jsx - Datos de RPC de Chainlist
variables/ - Definiciones variables
home.mdx - Variables de la página de inicio
variables.mdx - Variables globales
API/ - Datos relacionados con la API
README.md - Guía para generar documentación de API
openapi.yaml - Especificaciones OpenAPI
Páginas (/snippets/pages/)
Contenido MDX modular importado en las páginas principales de la documentación:
00_HOME/ - Contenido de la página de inicio
01_ABOUT/ - Contenido de la sección Acerca de
04_GATEWAYS/ - Contenido de la documentación de Gateway
run/quickstart/ - Vista rápida por sistema operativo y modo
05_GPUS/ - Contenido relacionado con la GPU
08_SHARED/ - Contenido de página compartida
Scripts de automatización y generación:
update-component-library.sh - Actualiza automáticamente la lista de bibliotecas de componentes
generate-api-docs.sh - Genera documentación de API a partir de especificaciones OpenAPI
generate-seo.js - Genera metadatos de SEO
fetch-external-docs.sh - Recupera documentación externa
fetch-openapi-specs.sh - Recupera especificaciones OpenAPI
fetch-lpt-exchanges.sh - Recupera datos de intercambio de LPT
generate-data/ - Scripts de generación de datos
scripts/terminology-search.js - Descubre terminología del glosario
scripts/generate-glossary.js - Genera términos del glosario
paths.config.json - Configuración de rutas de scripts
Automatizaciones (/snippets/automations/)
Archivos de automatización de recuperación y procesamiento de datos:
blog/ - Datos de blog (integración con Ghost)
discord/ - Datos de anuncios de Discord
forum/ - Integración de datos del foro
globals/ - Datos de automatización global (versiones, etc.)
luma/ - Integración del calendario de Luma
youtube/ - Integración de datos de YouTube
showcase/ - Datos del proyecto de muestra
scripts/ - scripts de flujo de trabajo de n8n (JSON)
Activos (/snippets/assets/)
Activos estáticos que incluyen imágenes, logotipos y medios:
logos/ - Livepeer logotipos y activos de marca
domain/ - Activos específicos del dominio organizados por sección
media/ - Archivos multimedia (gifs, imágenes, videos)
site/ - Activos de todo el sitio (favicon, imágenes)
data/ - Archivos de datos (exportaciones HTML, etc.)
Estilos (/snippets/styles/)
themeStyles.jsx - Definiciones de estilo de tema (obsoleto - usar Propiedades CSS personalizadas en style.css en su lugar)
SnippetsWiki (/snippets/snippetsWiki/)
Documentación interna sobre el sistema de fragmentos:
index.mdx - Vista general de la carpeta de fragmentos
mintlify-behaviour.mdx - Patrones y trampas específicos de Mintlify
theme-colors.mdx - Documentación del sistema de colores de tema
componentLibrary/ - Documentación de la biblioteca de componentes
index.mdx - Estructura de componente auto-generada (actualizada por script)
examples/ - Ejemplos de componentes
Resumen de la cantidad de archivos
- Componentes: ~50+ archivos JSX/TSX en 6 categorías
- Archivos de datos: ~20+ archivos JSX/MDX
- Módulos de página: ~20+ archivos MDX
- Scripts: ~10+ scripts de shell/JS
- Automaciones: ~15+ archivos JSX/JSON
- Recursos: 100+ archivos de imagen/media
- Total: 200+ archivos en la carpeta de fragmentos
Patrones de uso
Importar componentes
// Import from components
import { YouTubeVideo } from "/snippets/components/display/video.jsx";
import { GotoCard } from "/snippets/components/primitives/links.jsx";
import { CustomCodeBlock } from "/snippets/components/content/code.jsx";
Importar datos
// Import data files
import { DOCKER_CODE } from "/snippets/data/gateways/code.jsx";
import { latestVersion } from "/snippets/automations/globals/globals.jsx";
Módulos de página de importación
// Import MDX page modules
import DockerOffChainTab from "/snippets/pages/04_GATEWAYS/run/quickstart/views/docker/dockerOffChainTab.mdx";
Automatización
La lista de la biblioteca de componentes es automatizada:
Secuencia de comandos: tools/scripts/snippets/update-component-library.sh
Salida: snippets/snippetsWiki/componentLibrary/index.mdx
Uso:
./tools/scripts/snippets/update-component-library.sh
Este script genera automáticamente una estructura de árbol que enumera todos los componentes en snippets/components/.
Recursos relacionados
Last modified on March 1, 2026