Редактирование, форматирование и отключение переменных

В этом разделе:

Этот раздел описывает, как редактировать переменные в редакторе Help & Manual, как форматировать содержимое переменных в вашем выводе (то есть полужирным текстом или стилями текста) и как отключить переменные так, чтобы в вашем выводе было отображено имя переменной вместо содержимого переменной.

Как редактировать переменные в редакторе Help & Manual:

В отличие от Help & Manual 3, где переменные были нередактируемыми объектами, переменные теперь вставлены в редакторе Help & Manual как простой текст, который может быть отредактирован. Когда Вы используете функцию Вставить > Текстовая переменная, переменные подсвечены для легкой идентификации, и Вы можете дважды щелкнуть на них, чтобы отобразить список переменных, но они - действительно полностью редактируемый текст. Подсветка - только для удобства редактирования, чтобы сделать переменные лучше видимыми.

Редактирование переменных, вставленных со Вставить > Текстовая переменная:

Переменные, вставленные со Вставить > Текстовая переменная, подсвечены зеленым для простой идентификации. Вы можете редактировать их, конечно.

·	Чтобы Редактировать переменную, просто нажмите в подсвеченном имени переменной и печатайте. (Если Вы измените переменную на несуществующую, она не будет работать, конечно...),

·	Чтобы Отобразить список переменных, дважды щелкните на подсвеченной переменной в редакторе. Если Вы потом выберете другую переменную из списка, то она заменит оригинальную переменную в редакторе.

Редактирование переменных, напечатанных вручную:

Переменные, напечатанные вручную - обычный текст и могут быть отредактированы обычно. Они не могут быть подсвечены, и Вы не можете дважды щелкнуть на них, чтобы отобразить список переменных.

Специальный случай - подсвеченные переменные в начале параграфа:

Если подсвеченная переменная - в начале параграфа, Вы не можете вставить никакого текста перед ней; весь текст, который Вы печатаете слева от переменной, будет также подсвечен. Вот - как решить эту проблему:

1.	Нажмите слева от переменной и нажмите ENTER, чтобы создать новый параграф.

2.	Нажмите клавишу "пробел" и напечатайте ваш текст.

3.	Нажмите справа от нового текста и нажмите Delete, чтобы поднять переменную в тот же параграф.

Если Вы напечатаете текст вместо того, чтобы нажать клавишу "пробел", то он будет подсвечен как переменная. Чтобы исправить это, щелкните правой кнопкой мыши на подсветке, и выберите Преобразовать в обычный текст.

Как использовать форматирование и стили с переменными:

Значения переменных сохранены как простой текст, без любой информации форматирования. Однако, Вы можете легко превратить содержимое переменных в форматированный текст с полужирным, подчеркиванием или стилями в вашем выводе, форматируя переменную в редакторе Help & Manual.

Форматирование переменных вручную:

1.	Выберите переменную в редакторе так, чтобы вся переменная была подсвечена (это - и для переменных, напечатанных вручную, и для переменных, вставленных со Вставить > Текстовая переменная).

Делайте все возможное, чтобы выбрать всю переменную - если Вы форматируете только часть переменной, она больше не может быть правильно идентифицирована компилятором!

2.	Используйте Формат > Шрифт или форматирующие кнопки в Инструментальной панели, чтобы форматировать переменную. Например, если Вы будете форматировать переменную полужирным и курсивным, то значение переменной будет полужирным и курсивным в вашем выводе.

Форматирование переменных со стилями:

Если Вы будете включать переменные в параграфы, которые используют стили параграфа и шрифта, Вы не должны ничего делать - значения переменных будут автоматически отформатированы, как остальная часть текста в параграфе.

Если Вы определили текстовые стили (см. Определение стилей), Вы можете применить их к переменным:

1.	Выберите переменную в редакторе так, чтобы вся переменная была подсвечена (и для переменных, напечатанных вручную и для переменных, вставленных со Вставить > Текстовая переменная).

Здесь также, делайте все возможное, чтобы выбрать всю переменную - если Выформатируете только часть переменной, она больше не может быть правильно идентифицирована компилятором!

2.	Примените ваш текстовый стиль, выбрав его в селекторе стиля в Инструментальной панели, нажимая комбинацию "горячих клавиш", которую Вы определили для стиля, или выбрав Формат > Форматировать со стилем.

Как отключить переменные так, чтобы были напечатаны имена переменной:

Иногда Вы можете хотеть включить переменные непосредственно, а не их значения в вашем выводе. Например, это было необходимо в этой справке во всех местах, где отображены примеры переменных - если бы мы не отключили переменные здесь, то отобразились бы значения переменных, и примеры не имели бы смысла!

Чтобы отключить переменные, просто напечатайте обратный слеш \ между открывающим тэгом <% и именем переменной. Это работает точно тем же способом для всех переменных везде в вашем проекте. Это также работает и для зеленых подсвеченных переменных, вставленных со Вставить > Текстовая переменная, и переменных, напечатанных вручную.

Отметьте, что Вы должны отключить только переменные, которые фактически определены в месте, где Вы используете их. Вы не должны использовать обратный слеш, чтобы отключать неопределенные переменные или для переменных, которые не поддерживаются там, где Вы используете их. Например, если Вы напечатаете специальные переменные шаблона HTML в разделе, то имена переменной будут отображены в выводе, потому что они не определены там.

Чтобы также включить обратный слеш, как показано в примеры ниже, просто напечатайте два обратных слеша!

Примеры:

Стобы ввести обратный слеш в подсвеченные переменные, просто нажмите в переменной и начинайте печатать.

<%\TIMELONG%>

<%\NOW%>

<%\AUTHOR%>

Все примеры слева были напечатаны с двумя обратными слешами в переменной, чтобы показать, как они введены в редакторе. С единственным слешем Вы просто видели бы имя переменной в выводе.

<%TOPIC_TEXT%>
<%FANTASY_VARIABLE%>

Эти два примера были введены без обратных слешей. Они не должны быть заблокированы, потому что они не поддерживаются в обычных разделах - первая - переменная шаблона HTML, вторая просто не определена.

Как отключать подсветку переменных:

Зеленая подсветка, отображенная для переменных, вставленных со Вставить > Текстовая переменная, использует ту же систему, как подсвечивание, используемое для гиперссылок. Вы можете выключить подсветку, щелкая правой кнопкой мыши на переменной, и выбрав Преобразовать в обычный текст в отображенном контекстном меню.

·	Переменная работает, когда Вы делаете это, но так же, как напечатанная вручную переменная. Вы не можете больше отобразить список переменных двойным щелчком.

Это не обратимо! Вы можете отменить это с Правка > Отменить, Ctrl+Z или

непосредственно после создания изменения, но позже Вы не можете конвертировать неподсвеченную переменную в подсвеченную. Единственная альтернатива - повторно ввести переменную со Вставить > Текстовая переменная.

См. также:

Переменные и условный вывод (Справочная информация)