Одна из замечательных возможностей нашей Базы знаний — это возможность отображать инструкции, адаптированные для операционных систем (Windows, macOS, Linux) и версий Firefox. Мы можем, например, указать, что определённый раздел статьи справки предназначен «для» пользователей Windows, и пользователи Mac и Linux его не увидят. Эта функция разработана так, чтобы работать незаметно. Когда кто-то открывает статью справки, мы автоматически определяем, какую операционную систему и версию Firefox он использует, и показываем соответствующие инструкции. В этой статье подробно рассматривается, как использовать разметку {for} в статьях Базы знаний.

Как переключать инструкции для разных операционных систем или версий Firefox

Чтобы следовать примерам в этой статье, вам придётся переключать селектор статьи на разные операционные системы и версии Firefox. Он расположен на правой панели статьи, в разделе Инструменты редактирования.

Основной синтаксис и поведение

Операционные системы

Вот синтаксис для отображения изображения для Windows 10:

{for win10}[[Image:Windows Logo]]{/for}

• Измените селектор на Windows 10, чтобы увидеть изображение:

  

Хотя селектора для Windows не существует, вы можете написать инструкции, которые применяются ко всем версиям Windows:

{for win}[[Image:Image:vista.jpg]]{/for}

• Измените селектор на Windows XP, Windows 7/Vista, Windows 8, Windows 10 или Windows 11, чтобы увидеть изображение:

  

Версии Firefox

Вот синтаксис для отображения чего-либо для Firefox 140 и выше:

{for fx140}[[Image:Firefox Quantum Logo]]{/for}

• Измените селектор на Firefox 140 или выше, чтобы увидеть изображение:

  

Отображение инструкций только для одной версии Firefox

Чтобы показать инструкции только для Firefox 140, используйте оператор «=»:

{for =fx140}[[Image:Firefox Quantum Logo]]{/for}

• Теперь изображение отображается, только когда вы меняете селектор на Firefox 140:

  

Комбинирование операционных систем и версий Firefox

Вы можете указать операционную систему и версию Firefox, разделив их запятой:

{for win,fx140}[[Image:Windows Logo]][[Image:Quantum Logo]]{/for}

• Измените селектор на Windows и Firefox 140 или выше, чтобы увидеть изображения:

  

Более сложную ситуацию с неявным «для» можно записать так:

{for mac, win10, win11, =fx128, fx140}[[Image:Windows Logo]][[Image:macos.jpg]][[Image:Firefox Quantum Logo]]{/for}

• Измените селектор на Mac или Windows 10 или Windows 11 и Firefox 128 или Firefox 140 и выше, чтобы увидеть изображения:

  

Отрицание условий

Вы можете отрицать условие, поставив перед ним слово not. Отрицаемое условие истинно тогда и только тогда, когда условие ложно. Например, условие

not fx140

истинно, если версия Firefox меньше 140.

Использование тегов {for} для расширенного контроля версий

В условиях частых обновлений и выпусков новых функций в Firefox теги for играют ключевую роль в целенаправленном подборе контента, позволяя нам предоставлять пользователям актуальную информацию в зависимости от их конкретной версии Firefox. Ключевые применения этих тегов включают:

• Ранний доступ для пользователей Nightly и Beta: Это позволяет нам представлять будущие функции или изменения пользователям, использующим каналы Nightly и Beta, предупреждая их о том, что они могут обнаружить. Это гарантирует, что наши самые вовлечённые и технически подкованные пользователи смогут начать изучать новые функции раньше остального сообщества.
• Локализация до запуска: теги for позволяют нам публиковать контент для будущих версий до их публичного выпуска. Это позволяет нашему сообществу локализаторов готовить переводы заранее, гарантируя многоязычную поддержку в момент выхода новой версии на основном канале (Production).
• Предотвращение путаницы среди широкой аудитории: Используя теги for, мы стратегически избегаем предоставления нашей основной аудитории преждевременной информации, тем самым предотвращая путаницу в отношении того, что доступно в их текущей версии Firefox.

Когда отображается содержимое

Формально разметка между {for} и {/for} будет отображаться, если выполнены оба этих условия:

• Тег {for} не содержит условия для операционной системы (ОС), или он содержит хотя бы одно истинное условие для ОС, которую использует пользователь (или выбрал вручную).
• Тег {for} не содержит условия для версии Firefox, или он содержит хотя бы одно истинное условие для версии Firefox, которую использует пользователь (или выбрал вручную).

В противном случае содержимое {for}…{/for} не отображается.

Несколько других моментов, которые следует отметить:

• Пробелы после запятых необязательны.
• {for} и другая вики-разметка не работают в кратких описаниях статей для поиска.
• Заголовки, скрытые блоками {for}, не появляются в оглавлении страницы. Если пользователь отобразит их, вручную выбрав правильную комбинацию ОС/браузера, записи в оглавлении мгновенно появятся.

Аббревиатуры операционных систем и продуктов

Это аббревиатуры операционных систем и продуктов, доступные для использования с {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, где N = версия Firefox (для настольных ПК), например, fx115, fx116, fx117 и т.д.
• mN, где N = версия Firefox for Android (мобильная), например, m115, m116, m117 и т.д.
• tbN, где N = версия Thunderbird, например, tb91, tb102, tb115 и т.д.

Вы должны использовать fxN в статьях поддержки Firefox, mN в статьях поддержки Firefox for Android и tbN в статьях поддержки Thunderbird.

Встроенный и блочный контексты

{for} можно использовать как во встроенном, так и в блочном контексте (в смысле HTML). Встроенная форма применяется при работе внутри строки текста:

Это {for win}встроенное использование{/for}.

Блочная форма используется для обрамления целых абзацев, упорядоченных списков, заголовков и так далее. Единственное предостережение: при использовании блочной формы теги {for} и {/for} должны находиться каждый на своей строке. В противном случае они могут быть восприняты как часть соседнего абзаца и привести к неожиданным результатам.

{for win}

Это блочный уровень.

*Один

*Два

{/for}

Рекомендации по использованию {for} в статьях

При написании инструкций для разных операционных систем лучше всего писать полные предложения и абзацы для каждой версии ОС/Firefox, даже если это означает дублирование. Это облегчает понимание, поддержку и локализацию статьи. Когда придёт время, например, удалить конкретные инструкции для Firefox 140 и ниже, эти разделы можно будет просто удалить, а не пытаться вырезать их из более крупного раздела.

• Неправильный способ использования {for}:

  #{for not fx140}{for win,linux}В верхней части окна Firefox{/for}{for mac}В строке меню{/for}, нажмите на {/for}{for fx140}Нажмите кнопку меню, перейдите в меню History{/for}{for winxp,mac,linux,not fx140}меню Tools{/for}{for win10,win11,not fx140}меню Firefox, перейдите в меню History{/for} и выберите Clear Recent History…

• Правильный способ использования {for}:

  {for not fx140}

  #{for win10,win11}В верхней части окна Firefox нажмите на меню Firefox, перейдите в меню History и выберите Clear Recent History…{/for}{for mac}В строке меню нажмите на меню Tools и выберите Clear Recent History…{/for}{for winxp,linux}В верхней части окна Firefox нажмите на меню Tools и выберите Clear Recent History…{/for}

  {/for}

  {for fx140}

  #Нажмите кнопку меню, перейдите в меню History и выберите Clear Recent History…

  {/for}

• В следующем примере мы рассматриваем Firefox 140 и ниже, Firefox 141/142 и Firefox 143 и выше как три разных набора инструкций. Так бывает часто, но по мере того, как мы меняем Firefox каждые четыре недели, мы будем видеть всё больше изменений в более поздних версиях. Они будут выглядеть так:

  {for not fx141}

  #Старые инструкции.

  {/for}

  {for =fx141,=fx142}

  #Новые инструкции.

  {/for}

  {for fx143}

  #НОВЫЕ новые инструкции.

  {/for}

Полные руководства по Базе знаний

Смотрите дополнительные руководства по участию в Базе знаний.