Seleccionar la variante de dispositivo de Docs
Cambia un artículo público de Docs entre Móvil, Tablet y Web para que la página recargue el índice público y el artículo seleccionado con la plataforma elegida, y después muestre la variante de media disponible más cercana.
En este artículo
Usa esta guía cuando un lector público, un operador de soporte o un productor de capturas necesite revisar el mismo artículo de Docs en contexto Móvil, Tablet o Web.
El selector Dispositivo es estado temporal de la página. Cambia la plataforma enviada a la API pública de Docs y afecta a la resolución de media, pero no guarda una preferencia ni cambia datos de producto.
Antes de empezar
- Hay una ruta pública de Docs disponible en /docs, /manual, /wiki o una ruta de artículo bajo uno de esos prefijos.
- El servicio público de docs puede cargar el bundle de docs generado y la página de la landing puede alcanzar PUBLIC_API_BASE_URL.
- El tema actual de la landing resuelve a claro u oscuro; el selector Dispositivo no elige el tema.
- Para un ejemplo visible de variante de media en español, usa /docs/calendarios/es-ver-calendario-general porque tiene variantes de media de calendario publicadas.
- No se requiere inicio de sesión en Grupo Marea Demo, rol de organización, pertenencia a ubicación ni sesión demo para esta acción pública.
Instrucciones
- 1.
Abre un artículo público
Abre /docs/calendarios/es-ver-calendario-general, o abre /docs, /manual o /wiki y deja que la página seleccione el primer artículo disponible. La página pública debe cargarse sin pedir una cuenta.
- 2.
Comprueba el dispositivo actual
Localiza el selector segmentado Dispositivo en la cabecera del artículo. Ofrece solo Móvil, Tablet y Web. El valor inicial se detecta a partir de la ventana: móvil por debajo de 768px, tablet para puntero grueso o hasta 1180px, y web en el resto de casos.
- 3.
Selecciona una variante
Haz clic en Móvil, Tablet o Web. La página vuelve a solicitar el índice público y después el artículo seleccionado usando el mismo locale y tema con la nueva plataforma. Si el usuario cambia de dispositivo rápidamente, la petición anterior se cancela y gana la última elección.
- 4.
Revisa la media actualizada
Cuando termine la carga, revisa el contenido del artículo y la media. La media prueba primero la plataforma y el tema seleccionados y después cae a otra variante de asset disponible. Si no existe ninguna fuente, permanece el marcador de media pendiente.
- 5.
Mantén clara la frontera
Trata Dispositivo como un control de visualización de la documentación pública. No es la plataforma del terminal TPV, no edita documentación, no envía búsquedas y no se almacena en la URL, el almacenamiento del navegador, la cuenta ni el estado del backend.
Validaciones y límites
- El selector público renderiza exactamente tres valores: Móvil, Tablet y Web.
- Las peticiones de Docs incluyen locale, platform y theme; q solo lo envían los llamantes de la API o los flujos de búsqueda cuando se proporciona.
- La ruta pública de Docs no requiere autenticación para esta acción.
- El backend normaliza el locale a es o en, platform/device a mobile, tablet o web, y theme a light o dark.
- Los valores de plataforma inválidos u omitidos se normalizan a web para los llamantes directos de la API.
- La respuesta de índice devuelve platform, pero article_count y la pertenencia a secciones no dependen de la plataforma.
- El detalle del artículo se resuelve por slug de sección y slug de artículo, o por id heredado de artículo cuando solo se proporciona un segmento de ruta.
- La resolución de media puede devolver src, resolved_platform, resolved_theme, available_platforms y available_themes; la media ausente renderiza el marcador pendiente.
- La frescura del contenido actual debe comprobarse cuando las capturas dependan de media: backend/docs-content/articles.json se generó el 2026-06-18 mientras que el contexto de actualización está fechado el 2026-06-24.
Resultado esperado
El lector permanece en el artículo público, el botón del dispositivo seleccionado queda resaltado y el artículo se recarga a través de /api/public/docs con la plataforma seleccionada para que la media pueda resolverse a la variante de dispositivo y tema disponible más cercana.