Vista previa local para autores de contenido

Previsualice sus documentos localmente antes de enviar los cambios. Todo lo que necesita es Docker y un directorio docs/.

Requisitos previos

• Docker Desktop instalado y en ejecución
• Su repositorio de contenido clonado localmente con un directorio docs/ que contenga al menos index.mdx

Iniciar el servidor de desarrollo

Desde la raíz de su repositorio de contenido, ejecute:

docker run --rm -it \
  -v "$(pwd)/docs:/content/docs" \
  -p 4321:4321 \
  -e MODE=dev \
  ghcr.io/f5-sales-demo/docs-builder:latest

Abra http://localhost:4321 una vez que el servidor se inicie.

Nota

Los cambios en los archivos de su host requieren reiniciar el contenedor. Deténgalo con Ctrl+C y vuelva a ejecutar el comando para aplicar las ediciones.

Imágenes y recursos estáticos

Coloque las imágenes en un subdirectorio como docs/images/. El contenedor las detecta automáticamente — no se necesitan montajes de volumen adicionales.

Haga referencia a ellas en su MDX con una ruta relativa a la raíz:

![Diagrama de arquitectura](/images/architecture.png)

Solución de problemas

Puerto ya en uso — Asigne un puerto de host diferente: -p 8080:4321, luego abra http://localhost:8080.

El contenido no aparece — Verifique que docs/index.mdx exista. Revise la salida del contenedor en busca del mensaje ERROR: No content found.

Imagen desactualizada — Descargue la versión más reciente:

docker pull ghcr.io/f5-sales-demo/docs-builder:latest

Lectura adicional

• Compilación con Docker — Detalles de la imagen, variables de entorno y compilaciones de producción
• Arquitectura — Modelo de inyección de contenido y diseño del sistema de temas