Una de las mejores características de nuestra Base de Conocimiento es la capacidad de mostrar instrucciones personalizadas para los sistemas operativos (Windows, macOS, Linux) y las versiones de Firefox. Podemos decir, por ejemplo, que una determinada sección de un artículo de ayuda es "para" los usuarios de Windows y los usuarios de Mac y Linux no la verán. La característica está diseñada para funcionar de forma invisible. Cuando alguien abre un artículo de ayuda, detectaremos automáticamente qué sistema operativo y versión de Firefox está utilizando y mostraremos las instrucciones adecuadas. Este artículo repasa los detalles de cómo usar el marcado {for} en los artículos de la Base de Conocimiento.
Tabla de contenidos
- 1 Cómo adecuar las instrucciones a los distintos sistemas operativos y versiones de Firefox
- 2 Sintaxis básica y funcionamiento
- 2.1 Sistemas operativos
- 2.2 Versiones de Firefox
- 2.3 Combinar sistemas operativos y versiones de Firefox
- 2.4 Negar condiciones
- 2.5 Aprovechar las etiquetas {for} para un control avanzado de versiones
- 2.6 Cuándo se muestra el contenido
- 2.7 Abreviaturas de sistema operativo y producto
- 2.8 Contextos en línea y a nivel de bloque
- 3 Mejores prácticas para usar {for} en los artículos
- 4 Guías completas de la Base de Conocimiento
Cómo adecuar las instrucciones a los distintos sistemas operativos y versiones de Firefox
Para poder seguir el ejemplo de este artículo, tendrás que cambiar el selector de artículos a diferentes sistemas operativos y versiones de Firefox. Se encuentra en el panel derecho del artículo, en Editing Tools.
Sintaxis básica y funcionamiento
Sistemas operativos
Esta es la sintaxis para mostrar una imagen para Windows 10:
{for win10}[[Image:Windows Logo]]{/for}
- Cambia el selector a Windows 10 para ver la imagen:
- Si cambias el selector a Windows XP, Windows 7, Windows 8, Windows 11, Mac o Linux, la imagen de arriba no se mostrará porque no es "para" ellos.
Aunque el selector de Windows no existe, puedes escribir instrucciones que se apliquen a todas las versiones de Windows:
{for win}[[Image:Image:vista.jpg]]{/for}
- Cambia el selector a Windows XP, Windows 7/Vista, Windows 8, Windows 10 o Windows 11 para ver la imagen:
- Si cambias el selector a Mac o Linux, la imagen de arriba no se mostrará porque no es "para" ellos.
Versiones de Firefox
Esta es la sintaxis para mostrar algo para Firefox 140 y superior:
{for fx140}[[Image:Firefox Quantum Logo]]{/for}
- Cambia el selector a Firefox 140 o superior para ver la imagen:
- Si cambias el selector a Firefox 139 o inferior, la imagen de arriba desaparecerá porque no es "para" esas versiones.
Mostrar instrucciones para una sola versión de Firefox
Para mostrar instrucciones solo para Firefox 140, utiliza el operador "=":
{for =fx140}[[Image:Firefox Quantum Logo]]{/for}
- Ahora la imagen solo se muestra cuando cambias el selector a Firefox 140:
Combinar sistemas operativos y versiones de Firefox
Puedes especificar un sistema operativo y una versión de Firefox separándolos con una coma:
{for win,fx140}[[Image:Windows Logo]][[Image:Firefox Quantum Logo]]{/for}
- Cambia el selector a Windows y Firefox 140 o superior para ver las imágenes:
Una situación más compleja con un "para" implícito se puede escribir así:
{for mac, win10, win11, =fx128, fx140}[[Image:Windows Logo]][[Image:macos.jpg]][[Image:Firefox Quantum Logo]]{/for}
- Cambia el selector a Mac o Windows 10 o Windows 11 y Firefox 128 o Firefox 140 y superior para ver las imágenes:
Negar condiciones
Puedes negar una condición precediéndola con la palabra not
. Una condición negada es verdadera si y solo si la condición es falsa. Por ejemplo, la condición
not fx140
es verdadera si la versión de Firefox es inferior a 140.
Aprovechar las etiquetas {for} para un control avanzado de versiones
Con las frecuentes actualizaciones y lanzamientos de características en Firefox, las etiquetas for juegan un papel clave en la curación de contenido dirigido, permitiéndonos entregar información relevante a los usuarios basada en su versión específica de Firefox. Las aplicaciones clave de estas etiquetas incluyen:
- Acceso anticipado para usuarios de Nightly y Beta: Nos permite presentar próximas características o cambios a los usuarios que están en los canales Nightly y Beta, dándoles un aviso sobre lo que podrían encontrar. Esto asegura que nuestros usuarios más comprometidos y técnicos puedan comenzar a explorar nuevas funcionalidades antes que la comunidad en general.
- Localización antes del lanzamiento: Las etiquetas for nos permiten publicar contenido para las próximas versiones antes de su lanzamiento público. Esto permite a nuestra comunidad de localización preparar las traducciones con antelación, garantizando el soporte en múltiples idiomas en el momento en que una nueva versión se lance en el canal de Producción.
- Evitar la confusión entre el público general: Usando las etiquetas for, evitamos estratégicamente exponer a nuestro público general a información prematura, previniendo así la confusión sobre lo que está disponible actualmente en su versión actual de Firefox.
Cuándo se muestra el contenido
Formalmente, el marcado entre {for} y {/for} se mostrará si se cumplen estas dos condiciones:
- La etiqueta {for} no tiene ninguna condición de sistema operativo (SO), o tiene al menos una condición de SO que es verdadera con respecto al SO que el usuario está usando (o ha seleccionado manually).
- La etiqueta {for} no tiene ninguna condición de versión de Firefox, o tiene al menos una condición de versión de Firefox que es verdadera con respecto a la versión de Firefox que el usuario está usando (o ha seleccionado manualmente).
De lo contrario, el contenido de {for}…{/for} no se muestra.
Otros aspectos a tener en cuenta:
- Los espacios después de las comas son opcionales.
- {for} y otro marcado wiki no funcionan en los resúmenes de búsqueda de artículos.
- Los encabezados que están ocultos por bloques {for} no aparecen en la tabla de contenidos de la página. Si el usuario hace que se muestren seleccionando manualmente la combinación correcta de SO/navegador, las entradas de la tabla de contenidos aparecen instantáneamente.
Abreviaturas de sistema operativo y producto
Estas son las abreviaturas de sistema operativo y producto disponibles para usar con {for}:
- win (Windows)
- winxp (Windows XP/2000/Server 2003)
- win7 (Windows 7/Vista/Server 2008)
- win8 (Windows 8/8.1/Server 2012)
- win10 (Windows 10)
- win11 (Windows 11)
- mac (macOS)
- linux (Linux)
- fxN donde N = la versión de Firefox (escritorio), por ejemplo fx115, fx116, fx117, etc.
- mN donde N = la versión de Firefox for Android (móvil), por ejemplo m115, m116, m117, etc.
- tbN donde N = la versión de Thunderbird, por ejemplo tb91, tb102, tb115, etc.
Debes usar fxN en los artículos de soporte de Firefox, mN en los artículos de soporte de Firefox for Android y tbN en los artículos de soporte de Thunderbird.
Contextos en línea y a nivel de bloque
{for} se puede utilizar tanto en contextos en línea como a nivel de bloque (en el sentido de HTML). La forma en línea tiene efecto cuando se trabaja dentro de una línea de texto:
Esto es un uso {for win}en línea{/for}.
La forma de bloque se utiliza para envolver párrafos enteros, listas ordenadas, encabezados, etc. La única advertencia es que, al usar la forma de bloque, {for} y {/for} deben estar cada uno en una línea por sí solos. De lo contrario, podría considerarse parte de un párrafo vecino y producir resultados sorprendentes.
- {for win}
- Esto es a nivel de bloque.
- *Uno
- *Dos
- {/for}
Mejores prácticas para usar {for} en los artículos
Al escribir instrucciones para diferentes sistemas operativos, es mejor escribir oraciones y párrafos completos para cada versión de SO/Firefox, incluso si significa duplicar cosas. Esto hace que el artículo sea más fácil de entender, mantener y localizar. Cuando llega el momento, por ejemplo, de eliminar instrucciones específicas para Firefox 140 e inferiores, esas secciones simplemente se pueden eliminar en lugar de intentar extirparlas de una sección más grande.
- La forma incorrecta de usar {for}:
- #{for not fx140}{for win,linux}At the top of the Firefox window{/for}{for mac}On the menu bar{/for}, click on the {/for}{for fx140}Click the menu button, go over to the {menu History} menu{/for}{for winxp,mac,linux,not fx140}{menu Tools} menu{/for}{for win10,win11,not fx140}{menu Firefox} menu, go over to the {menu History} menu{/for} and select {menu Clear Recent History…}
- La forma correcta de usar {for}:
- {for not fx140}
- #{for win10,win11}At the top of the Firefox window, click on the {menu Firefox} menu, go over to the {menu History} menu and select {menu Clear Recent History…}{/for}{for mac}On the menu bar, click on the {menu Tools} menu and select {menu Clear Recent History…}{/for}{for winxp,linux}At the top of the Firefox window, click on the {menu Tools} menu and select {menu Clear Recent History…}{/for}
- {/for}
- {for fx140}
- #Click the menu button, go over to the {menu History} menu and select {menu Clear Recent History…}
- {/for}
- En el siguiente ejemplo, tratamos Firefox 140 e inferiores, Firefox 141/142 y Firefox 143 y superiores como tres conjuntos diferentes de instrucciones. Suele ser el caso, pero cada vez más, a medida que cambiamos Firefox cada cuatro semanas, veremos más cambios en versiones posteriores. Se verán así:
- {for not fx141}
- #Las instrucciones antiguas.
- {/for}
- {for =fx141,=fx142}
- #Las instrucciones nuevas.
- {/for}
- {for fx143}
- #Las NUEVAS instrucciones nuevas.
- {/for}
Guías completas de la Base de Conocimiento
Consulta más guías sobre la contribución a la Base de Conocimiento.