Compare Revisions
Как использовать For
Revision 15316:
Revision 15316 by Unghost on
Revision 307815:
Revision 307815 by SumoBot on
Keywords:
For
Search results summary:
Как использовать For
Узнайте, как использовать разметку «for» в статьях Поддержки Mozilla, чтобы показывать содержимое для разных операционных систем и версий продукта.
Content:
Одна из великолепных особенностей нашей Базы Знаний - это возможность показать адаптируемые инструкции для разных операционных систем и версий Firefox. Мы можем сказать, например, что определенная часть статьи справки только для ("for") пользователей Windows, и пользователи Mac и Linux её не увидят. Эта статья рассказывает, как использовать <nowiki>{</nowiki>for<nowiki>}</nowiki> в статьях Базы Знаний.
__TOC__
== Основы синтаксиса и поведения ==
Далее приведен синтаксис для указания одного условия: '''<code><nowiki>{</nowiki>for mac<nowiki>}</nowiki>Приветтт!<nowiki>{</nowiki>/for<nowiki>}</nowiki></code>'''<br>Измените "Помощь с :" селектор на Mac, чтобы посмотреть сообщение => {for mac}'''Приветтт!'''{/for}
Вы можете указать два условия, например, так: '''<code><nowiki>{</nowiki>for mac,fx4<nowiki>}</nowiki>Приветтт!<nowiki>{</nowiki>/for<nowiki>}</nowiki></code>'''<br>Измените "Помощь с :" селектор на Mac и Firefox 4, чтобы увидеть сообщение => {for mac,fx4}'''Приветтт!'''{/for}
Можно написать более сложное условие с использованием "or", например, так:<br> '''<code><nowiki>{</nowiki>for mac, win, fx35, fx4<nowiki>}</nowiki>Вы используете Mac или Windows и используете Firefox 3.5-3.6 или 4.<nowiki>{</nowiki>/for<nowiki>}</nowiki></code>'''<br>Измените "Помощь с :" селектор на Mac или Windows и Firefox 3.5-3.6 или Firefox4, чтобы посмотреть сообщение =>{for mac,win,fx35,fx4}'''Вы используете Mac или Windows и используете Firefox 3.5-3.6 или 4.'''{/for}
Формально, текст между <nowiki>{</nowiki>for<nowiki>}</nowiki> и <nowiki>{</nowiki>/for<nowiki>}</nowiki> будет виден, если одно из условий выполнено:
* В список <nowiki>{</nowiki>for<nowiki>}</nowiki> включена, по крайней мере, одна операционная система, и пользователь использует эту систему (или выбрал ее вручную).
* В список <nowiki>{</nowiki>for<nowiki>}</nowiki> включена, по крайней мере, одна версия Firefox, и пользователь её использует (или выбрал её вручную).
Иначе, содержание <nowiki>{</nowiki>for<nowiki>}</nowiki>...<nowiki>{</nowiki>/for<nowiki>}</nowiki> не будет показано.
Несколько особенностей на заметку:
* Пробелы после запятых опциональны.
* <nowiki>{</nowiki>for<nowiki>}</nowiki> синтаксис всегда активен.
* Заголовки спрятанные за блоками <nowiki>{</nowiki>for<nowiki>}</nowiki> не показаны в содержании страницы. Если пользователь вручную выберет правильную комбинацию ОС/версии браузера, элементы содержания тут же появятся.
== Аббревиатура Операционных систем и браузера ==
Ниже приведены аббревиатуры доступных для использования <nowiki>{</nowiki>for<nowiki>}</nowiki>:
* win (Windows)
* mac (Mac OS X)
* linux (Linux)
* maemo (Maemo мобильная OS)
* android (Android мобильная OS)
* fx4 (Firefox 4.0 вплоть до, не включая 5 (может быть изменено позже))
* fx35 (Firefox 3.5 вплоть до, но не включая 4)
* fx3 (3.0 вплоть до, но не включая 3.5)
* m4 (Любая версия Firefox Mobile не включая 5 (может быть изменено позднее))
== Строчный и блочный контексты ==
<nowiki>{</nowiki>for<nowiki>}</nowiki> может быть использовано как в строке, так и в блоке (в контексте HTML). Строчная форма проявляется, когда пишется строчка текста:
'''Это <nowiki>{</nowiki>для fx35, fx4<nowiki>}</nowiki> строчное использование <nowiki>{</nowiki>/for<nowiki>}</nowiki>.'''
Блочная форма используется, чтобы охватить целый параграф, списки, заголовки и т. д. Единственное предостережение, что при использовании блочной формы <nowiki>{</nowiki>for<nowiki>}</nowiki> и <nowiki>{</nowiki>/for<nowiki>}</nowiki> сами должны быть в строке. Иначе, часть выражения может быть принята за часть следующего параграфа и воспроизведена неожиданным образом.
'''<nowiki>{</nowiki>for fx35, fx4<nowiki>}</nowiki><br>'''
'''Это блочный уровень.<br>'''
'''<nowiki>*</nowiki>Один<br>'''
'''<nowiki>*</nowiki>Два<br>'''
'''<nowiki>{</nowiki>/for<nowiki>}</nowiki>'''
==Использование кнопки <nowiki>{</nowiki>for<nowiki>}</nowiki> при редактировании статьи==
Когда вы редактируете статью Базы Знаний, вы можете использовать кнопку <nowiki>{</nowiki>for<nowiki>}</nowiki> в панели инструментов, чтобы поставить разметку документа.
#Подсветите текст, который вы хотите поместить в скобки <nowiki>{</nowiki>for<nowiki>}</nowiki>.
#Нажмите {button Показать для...} в панели инструментов редактирования.
#Поставьте галочки рядом с версиями Firefox и операционных систем, для которых вы хотите видеть этот контекст, и затем нажмите {button Добавить правило}. Настроенные теги <nowiki>{</nowiki>for<nowiki>}</nowiki> появятся вокруг подсвеченной секции.
== Как использовать оператор "not" ==
Так как время от времени База Знаний будет сталкиваться с добавлением новых операционных систем и версий браузера, то у нас есть специальный способ сказать, например, "Любая операционная система, кроме". Эту роль выполняет синтаксис <nowiki>{</nowiki>for not<nowiki>}</nowiki>.
В статье для мобильной версии мы можем сказать '''<nowiki>{</nowiki>for not maemo<nowiki>}</nowiki> вы можете использовать щипок, чтобы изменить размер рисунка...<nowiki>{</nowiki>/for<nowiki>}</nowiki>''', и если мы когда-нибудь добавим, например, iOS к поддерживаемым операционным системам, то синтаксис будет работать без необходимости редактирования.
Добавление слова "not" приводит к тому, что контекст <nowiki>{</nowiki>for<nowiki>}</nowiki> будет показан, когда он был бы спрятан и наоборот.
Одна из замечательных возможностей нашей Базы знаний — это возможность отображать инструкции, адаптированные для операционных систем (Windows, macOS, Linux) и версий Firefox. Мы можем, например, указать, что определённый раздел статьи справки предназначен «для» пользователей Windows, и пользователи Mac и Linux его не увидят. Эта функция разработана так, чтобы работать незаметно. Когда кто-то открывает статью справки, мы автоматически определяем, какую операционную систему и версию Firefox он использует, и показываем соответствующие инструкции. В этой статье подробно рассматривается, как использовать разметку <nowiki>{</nowiki>for<nowiki>}</nowiki> в статьях Базы знаний.
{warning}'''Локализаторам:''' При локализации статей с элементами <nowiki>{</nowiki>for<nowiki>}</nowiki> и <nowiki>{</nowiki>/for<nowiki>}</nowiki> в содержимом, '''не переводите''' ничего внутри скобок { и }! Оставляйте их в том же виде, что и в оригинальном тексте. Это важно для правильной работы элемента.{/warning}
__TOC__
= Как переключать инструкции для разных операционных систем или версий Firefox =
Чтобы следовать примерам в этой статье, вам придётся переключать селектор статьи на разные операционные системы и версии Firefox. Он расположен на правой панели статьи, в разделе ''Инструменты редактирования''.
;[[Image:CustomizeThisArticle-2025]]
= Основной синтаксис и поведение =
==Операционные системы==
Вот синтаксис для отображения изображения для '''Windows 10''':
;'''<code><nowiki>{</nowiki>for win10<nowiki>}</nowiki><nowiki>[[</nowiki>Image:Windows Logo]]<nowiki>{</nowiki>/for<nowiki>}</nowiki></code>'''
*Измените селектор на Windows 10, чтобы увидеть изображение:
*;{for win10}[[Image:Windows Logo]]{/for}
{for win10}
*Если вы измените селектор на Windows XP, Windows 7, Windows 8, Windows 11, Mac или Linux, изображение выше не будет показано, потому что оно не предназначено «для» них.
{/for}
Хотя селектора для Windows не существует, вы можете написать инструкции, которые применяются ко всем версиям Windows:
;'''<code><nowiki>{</nowiki>for win<nowiki>}</nowiki><nowiki>[[</nowiki>Image:Image:vista.jpg]]<nowiki>{</nowiki>/for<nowiki>}</nowiki></code>'''
*Измените селектор на Windows XP, Windows 7/Vista, Windows 8, Windows 10 или Windows 11, чтобы увидеть изображение:
*;{for win}[[Image:vista.jpg]]{/for}
{for win}
*Если вы измените селектор на Mac или Linux, изображение выше не будет показано, потому что оно не предназначено «для» них.
{/for}
==Версии Firefox==
Вот синтаксис для отображения чего-либо для '''Firefox 140 и выше''':
;'''<code><nowiki>{</nowiki>for fx140<nowiki>}</nowiki><nowiki>[[</nowiki>Image:Firefox Quantum Logo]]<nowiki>{</nowiki>/for<nowiki>}</nowiki></code>'''
*Измените селектор на Firefox 140 или выше, чтобы увидеть изображение:
*;{for fx140}[[Image:Firefox Quantum Logo]]{/for}
{for fx139}
*Если вы измените селектор на Firefox 139 или ниже, изображение выше исчезнет, потому что оно не предназначено «для» этих версий.
{/for}
===Отображение инструкций только для одной версии Firefox===
Чтобы показать инструкции '''только для Firefox 140''', используйте оператор «=»:
;'''<code><nowiki>{</nowiki>for =fx140<nowiki>}</nowiki><nowiki>[[</nowiki>Image:Firefox Quantum Logo]]<nowiki>{</nowiki>/for<nowiki>}</nowiki></code>'''
*Теперь изображение отображается, только когда вы меняете селектор на Firefox 140:
*;{for =fx140}[[Image:Firefox Quantum Logo]]{/for}
==Комбинирование операционных систем и версий Firefox==
Вы можете указать операционную систему и версию Firefox, разделив их запятой:
;'''<code><nowiki>{</nowiki>for win,fx140<nowiki>}</nowiki><nowiki>[[</nowiki>Image:Windows Logo]]<nowiki>[[</nowiki>Image:Quantum Logo]]<nowiki>{</nowiki>/for<nowiki>}</nowiki></code>'''
*Измените селектор на Windows и Firefox 140 или выше, чтобы увидеть изображения:
*;{for win,fx140}[[Image:Windows Logo]][[Image:Firefox Quantum Logo]]{/for}
Более сложную ситуацию с неявным «для» можно записать так:
;'''<code><nowiki>{</nowiki>for mac, win10, win11, =fx128, fx140<nowiki>}</nowiki><nowiki>[[</nowiki>Image:Windows Logo]]<nowiki>[[</nowiki>Image:macos.jpg]]<nowiki>[[</nowiki>Image:Firefox Quantum Logo]]<nowiki>{</nowiki>/for<nowiki>}</nowiki></code>'''
*Измените селектор на Mac или Windows 10 или Windows 11 и Firefox 128 или Firefox 140 и выше, чтобы увидеть изображения:
*;{for mac, win10, win11, =fx128, fx140}[[Image:Windows Logo]][[Image:macos.jpg]][[Image:Firefox Quantum Logo]]{/for}
==Отрицание условий==
Вы можете отрицать условие, поставив перед ним слово <code>not</code>. Отрицаемое условие истинно тогда и только тогда, когда условие ложно. Например, условие
;'''<code>not fx140</code>'''
истинно, если версия Firefox меньше 140.
==Использование тегов <nowiki>{</nowiki>for<nowiki>}</nowiki> для расширенного контроля версий==
В условиях частых обновлений и выпусков новых функций в Firefox теги ''for'' играют ключевую роль в целенаправленном подборе контента, позволяя нам предоставлять пользователям актуальную информацию в зависимости от их конкретной версии Firefox. Ключевые применения этих тегов включают:
*'''Ранний доступ для пользователей Nightly и Beta:''' Это позволяет нам представлять будущие функции или изменения пользователям, использующим каналы Nightly и Beta, предупреждая их о том, что они могут обнаружить. Это гарантирует, что наши самые вовлечённые и технически подкованные пользователи смогут начать изучать новые функции раньше остального сообщества.
*'''Локализация до запуска:''' теги ''for'' позволяют нам публиковать контент для будущих версий до их публичного выпуска. Это позволяет нашему сообществу локализаторов готовить переводы заранее, гарантируя многоязычную поддержку в момент выхода новой версии на основном канале (Production).
*'''Предотвращение путаницы среди широкой аудитории:''' Используя теги ''for'', мы стратегически избегаем предоставления нашей основной аудитории преждевременной информации, тем самым предотвращая путаницу в отношении того, что доступно в их текущей версии Firefox.
==Когда отображается содержимое==
Формально разметка между <nowiki>{</nowiki>for<nowiki>}</nowiki> и <nowiki>{</nowiki>/for<nowiki>}</nowiki> будет ''отображаться'', если выполнены оба этих условия:
* Тег <nowiki>{</nowiki>for<nowiki>}</nowiki> не содержит условия для операционной системы (ОС), или он содержит хотя бы одно истинное условие для ОС, которую использует пользователь (или выбрал вручную).
* Тег <nowiki>{</nowiki>for<nowiki>}</nowiki> не содержит условия для версии Firefox, или он содержит хотя бы одно истинное условие для версии Firefox, которую использует пользователь (или выбрал вручную).
В противном случае содержимое <nowiki>{</nowiki>for<nowiki>}</nowiki>…<nowiki>{</nowiki>/for<nowiki>}</nowiki> не отображается.
{note}Любой контент, заключённый в тег <nowiki>{</nowiki>for<nowiki>}</nowiki> и предназначенный для более ранних версий Firefox, остаётся видимым для пользователей этих версий, даже если эти версии не указаны в селекторе версий.{/note}
Несколько других моментов, которые следует отметить:
* Пробелы после запятых необязательны.
* <nowiki>{</nowiki>for<nowiki>}</nowiki> и другая вики-разметка не работают в кратких описаниях статей для поиска.
* Заголовки, скрытые блоками <nowiki>{</nowiki>for<nowiki>}</nowiki>, не появляются в оглавлении страницы. Если пользователь отобразит их, вручную выбрав правильную комбинацию ОС/браузера, записи в оглавлении мгновенно появятся.
== Аббревиатуры операционных систем и продуктов ==
Это аббревиатуры операционных систем и продуктов, доступные для использования с <nowiki>{</nowiki>for<nowiki>}</nowiki>:
* 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.
== Встроенный и блочный контексты ==
<nowiki>{</nowiki>for<nowiki>}</nowiki> можно использовать как во встроенном, так и в блочном контексте (в смысле HTML). Встроенная форма применяется при работе внутри строки текста:
'''Это <nowiki>{</nowiki>for win<nowiki>}</nowiki>встроенное использование<nowiki>{</nowiki>/for<nowiki>}</nowiki>.'''
Блочная форма используется для обрамления целых абзацев, упорядоченных списков, заголовков и так далее. Единственное предостережение: при использовании блочной формы теги <nowiki>{</nowiki>for<nowiki>}</nowiki> и <nowiki>{</nowiki>/for<nowiki>}</nowiki> должны находиться каждый на своей строке. В противном случае они могут быть восприняты как часть соседнего абзаца и привести к неожиданным результатам.
;'''<nowiki>{</nowiki>for win<nowiki>}</nowiki>'''
;'''Это блочный уровень.'''
;'''<nowiki>*</nowiki>Один'''
;'''<nowiki>*</nowiki>Два'''
;'''<nowiki>{</nowiki>/for<nowiki>}</nowiki>'''
= Рекомендации по использованию <nowiki>{</nowiki>for} в статьях =
'''При написании инструкций для разных операционных систем лучше всего писать полные предложения и абзацы для каждой версии ОС/Firefox, даже если это означает дублирование.''' Это облегчает понимание, поддержку и локализацию статьи. Когда придёт время, например, удалить конкретные инструкции для Firefox 140 и ниже, эти разделы можно будет просто удалить, а не пытаться вырезать их из более крупного раздела.
*'''Неправильный способ''' использования <nowiki>{</nowiki>for}:
*;<nowiki>#</nowiki><nowiki>{</nowiki>for not fx140}<nowiki>{</nowiki>for win,linux}В верхней части окна Firefox<nowiki>{</nowiki>/for}<nowiki>{</nowiki>for mac}В строке меню<nowiki>{</nowiki>/for}, нажмите на <nowiki>{</nowiki>/for}<nowiki>{</nowiki>for fx140}Нажмите кнопку меню, перейдите в меню {menu History}<nowiki>{</nowiki>/for}<nowiki>{</nowiki>for winxp,mac,linux,not fx140}меню {menu Tools}<nowiki>{</nowiki>/for}<nowiki>{</nowiki>for win10,win11,not fx140}меню {menu Firefox}, перейдите в меню {menu History}<nowiki>{</nowiki>/for} и выберите {menu Clear Recent History…}
*'''Правильный способ''' использования <nowiki>{</nowiki>for}:
*;<nowiki>{</nowiki>for not fx140}
*;<nowiki>#</nowiki><nowiki>{</nowiki>for win10,win11}В верхней части окна Firefox нажмите на меню {menu Firefox}, перейдите в меню {menu History} и выберите {menu Clear Recent History…}<nowiki>{</nowiki>/for}<nowiki>{</nowiki>for mac}В строке меню нажмите на меню {menu Tools} и выберите {menu Clear Recent History…}<nowiki>{</nowiki>/for}<nowiki>{</nowiki>for winxp,linux}В верхней части окна Firefox нажмите на меню {menu Tools} и выберите {menu Clear Recent History…}<nowiki>{</nowiki>/for}
*;<nowiki>{</nowiki>/for}
*;<nowiki>{</nowiki>for fx140}
*;<nowiki>#</nowiki>Нажмите кнопку меню, перейдите в меню {menu History} и выберите {menu Clear Recent History…}
*;<nowiki>{</nowiki>/for}
*В следующем примере мы рассматриваем Firefox 140 и ниже, Firefox 141/142 и Firefox 143 и выше как три разных набора инструкций. Так бывает часто, но по мере того, как мы меняем Firefox каждые четыре недели, мы будем видеть всё больше изменений в более поздних версиях. Они будут выглядеть так:
*;<nowiki>{</nowiki>for not fx141}
*;<nowiki>#</nowiki>Старые инструкции.
*;<nowiki>{</nowiki>/for}
*;<nowiki>{</nowiki>for =fx141,=fx142}
*;<nowiki>#</nowiki>Новые инструкции.
*;<nowiki>{</nowiki>/for}
*;<nowiki>{</nowiki>for fx143}
*;<nowiki>#</nowiki>НОВЫЕ новые инструкции.
*;<nowiki>{</nowiki>/for}
= Полные руководства по Базе знаний =
Смотрите [https://support.mozilla.org/en-US/products/contributor/kb дополнительные руководства по участию в Базе знаний].