Saltar al contenido principal

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 (/tools/scripts/snippets/)

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