Как использовать For

Одна из великолепных особенностей нашей Базы Знаний - это возможность показать адаптируемые инструкции для разных операционных систем и версий Firefox. Мы можем сказать, например, что определенная часть статьи справки только для ("for") пользователей Windows, и пользователи Mac и Linux её не увидят. Эта статья рассказывает, как использовать {for} в статьях Базы Знаний.

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

Далее приведен синтаксис для указания одного условия: {for mac}Приветтт!{/for}
Измените "Помощь с :" селектор на Mac, чтобы посмотреть сообщение => Приветтт!

Вы можете указать два условия, например, так: {for mac,fx4}Приветтт!{/for}
Измените "Помощь с :" селектор на Mac и Firefox 4, чтобы увидеть сообщение => Приветтт!

Можно написать более сложное условие с использованием "or", например, так:
{for mac, win, fx35, fx4}Вы используете Mac или Windows и используете Firefox 3.5-3.6 или 4.{/for}
Измените "Помощь с :" селектор на Mac или Windows и Firefox 3.5-3.6 или Firefox4, чтобы посмотреть сообщение =>Вы используете Mac или Windows и используете Firefox 3.5-3.6 или 4.

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

• В список {for} включена, по крайней мере, одна операционная система, и пользователь использует эту систему (или выбрал ее вручную).
• В список {for} включена, по крайней мере, одна версия Firefox, и пользователь её использует (или выбрал её вручную).

Иначе, содержание {for}...{/for} не будет показано.

Несколько особенностей на заметку:

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

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

Ниже приведены аббревиатуры доступных для использования {for}:

• 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 (может быть изменено позднее))

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

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

Это {для fx35, fx4} строчное использование {/for}.

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

{for fx35, fx4}
Это блочный уровень.
*Один
*Два
{/for}

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

Когда вы редактируете статью Базы Знаний, вы можете использовать кнопку {for} в панели инструментов, чтобы поставить разметку документа.

1. Подсветите текст, который вы хотите поместить в скобки {for}.
2. Нажмите Показать для... в панели инструментов редактирования.
3. Поставьте галочки рядом с версиями Firefox и операционных систем, для которых вы хотите видеть этот контекст, и затем нажмите Добавить правило. Настроенные теги {for} появятся вокруг подсвеченной секции.

Как использовать оператор "not"

Так как время от времени База Знаний будет сталкиваться с добавлением новых операционных систем и версий браузера, то у нас есть специальный способ сказать, например, "Любая операционная система, кроме". Эту роль выполняет синтаксис {for not}.

В статье для мобильной версии мы можем сказать {for not maemo} вы можете использовать щипок, чтобы изменить размер рисунка...{/for}, и если мы когда-нибудь добавим, например, iOS к поддерживаемым операционным системам, то синтаксис будет работать без необходимости редактирования.

Добавление слова "not" приводит к тому, что контекст {for} будет показан, когда он был бы спрятан и наоборот.