Cómo utilizar "for"

Contributors, Firefox Contributors, Firefox Actualizado por última vez: 1 semana, 5 días ago
This is a machine-generated translation of the English content. It has not been reviewed by a human, and may contain errors. If you would like to revise this content, you can start here.

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.

Localizadores: Al localizar artículos con elementos {for} y {/for} en el contenido, no traduzcan nada dentro de los corchetes { y }! Manténganlos tal como se ven en el texto original. Esto es importante para que el elemento funcione correctamente.

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.

CustomizeThisArticle-2025

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:
    Windows Logo
  • 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:
    vista.jpg
  • 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:
    Firefox Quantum Logo
  • 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:
    Firefox Quantum Logo

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:
    Windows LogoFirefox Quantum Logo

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:
    Windows Logomacos.jpgFirefox Quantum Logo

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.

Cualquier contenido encerrado dentro de una etiqueta {for}, dirigido a versiones anteriores de Firefox, permanece visible para los usuarios de esas versiones aunque esas versiones no estén listadas en el selector de versiones.

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.

These fine people helped write this article:

Illustration of hands

Voluntario

Grow and share your expertise with others. Answer questions and improve our knowledge base.

Learn More