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.

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:

  

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:

  

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:

  

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.