Ver la media de un artículo público
Comprueba cómo aparece la media en un artículo público de Docs de Antylogic: las imágenes resueltas se muestran en línea, los vídeos resueltos usan los controles del navegador y la media planificada sin resolver permanece en estado Pendiente de generación.
En este artículo
Usa esta guía cuando un lector público o un operador de soporte necesite comprobar la media adjunta a un artículo de Docs de Antylogic. La página pública de Docs puede abrirse desde /docs, /manual o /wiki sin iniciar sesión.
La página carga la media del artículo desde la API pública de Docs usando el dispositivo seleccionado, el idioma de Docs resuelto y el tema actual. Promociona el primer elemento de media publicado con fuente resuelta y mantiene el resto en la sección de capturas.
Antes de empezar
- Abre el área de Docs de la landing mediante /docs, /manual o /wiki. No se requiere inicio de sesión, pertenencia a organización, pertenencia a ubicación, rol ni sesión demo para esta superficie pública.
- Para el artículo de ES en español, abre la ruta con ?lang=es. Las llamadas directas a la API deben usar locale=es, no es-ES.
- PUBLIC_API_BASE_URL debe alcanzar un backend que sirva /api/public/docs; los valores locales por defecto de la landing usan http://localhost:8081.
- backend/docs-content/articles.json y la raíz de assets de docs deben estar disponibles para que la media resuelta pueda servirse desde /api/public/docs/assets/{path}.
- Usa /docs/asistencia/es-ver-panel-de-asistencia?lang=es para mostrar una imagen resuelta, un vídeo resuelto y marcadores planificados. Usa /docs/accesos/es-access-users-create-location-internal?lang=es para mostrar solo media planificada pendiente.
Instrucciones
- 1.
Abre el artículo público
Abre /docs/asistencia/es-ver-panel-de-asistencia?lang=es desde el sitio de la landing. El título del artículo del tablero de fichaje, la ruta de migas de Docs y el selector Dispositivo deben ser visibles sin petición de inicio de sesión ni de pertenencia.
- 2.
Fija el contexto de dispositivo
Usa el selector Dispositivo cuando la captura necesite una variante concreta. La petición pública del artículo usa locale=es, la plataforma seleccionada como mobile, tablet o web, y el tema claro u oscuro actual.
- 3.
Comprueba la media principal
Después de Reportes y mejoras, confirma que el primer elemento de media publicado con fuente resuelta aparece antes de En este artículo. En el artículo de fichaje en español, la figura principal es el punto de entrada de fichaje desde el inicio de Marea Gran Via.
- 4.
Revisa el resto de capturas
Desplázate hasta Capturas y vídeos del flujo. La media adicional permanece en esta sección, incluido el vídeo de abrir y recorrer el tablero de fichaje, mientras los elementos planificados sin resolver muestran Pendiente de generación.
- 5.
Interpreta los estados de marcador y de asset
Pendiente de generación significa que los metadatos de la media no tienen src resuelto. No es un flujo de subida, edición, publicación ni generación. Si un asset resuelto devuelve después un 404, la página se apoya en el comportamiento normal de fallo de imagen o vídeo del navegador.
- 6.
Verifica un asset directo cuando haga falta
Para QA de capturas, abre /api/public/docs/assets/iphone/light/es/es-ver-panel-de-asistencia/attendance-view-board-open-and-scan.mp4 sustituyendo el prefijo de locale del slug por la ruta real del asset. Un asset de vídeo válido se abre con los controles del navegador; las rutas inválidas, con recorrido de directorios o ausentes las rechaza la ruta pública de assets.
Validaciones y límites
- La superficie pública de media de Docs es de solo lectura y no genera, sube, edita, borra ni publica assets de media.
- La petición de la landing envía locale=es para español, platform o device como mobile, tablet o web, y theme como light o dark.
- El primer elemento de media que está publicado y resuelto se convierte en la figura principal; si ninguno cumple, no se muestra figura principal encima de la visión general.
- Los vídeos resueltos se renderizan con los controles nativos del navegador y no se reproducen automáticamente. Las imágenes resueltas se renderizan en línea con carga diferida y ajuste object-contain.
- Un src vacío tras recortar se trata como no resuelto y renderiza Pendiente de generación en lugar de solicitar un asset.
- Las URLs de assets se limitan a la raíz de assets de docs configurada. Las rutas vacías, de punto, con intento de recorrido y los ficheros ausentes devuelven 400 o 404.
- El test focalizado del backend TestHandleDocsIndexArticleAndAsset verifica el índice público, la reescritura de URLs de media del detalle del artículo y la ruta de servicio de assets.
Resultado esperado
Un lector público puede inspeccionar la media del artículo directamente desde el artículo de Docs de la landing. Las imágenes y vídeos publicados se renderizan cuando sus fuentes resuelven, la media planificada permanece claramente marcada como pendiente y la página nunca expone un flujo público de edición o generación.