DW создает все свои меню из структуры,
определенной в XML-файле menus.xml,
в подпапке Configuration/Menus папки приложения
Dreamweaver. Редактирование файла menus.xml
изменяет меню Dreamweaver при следующем
запуске программы. Основные сведения о
XML см. в Справке к Dreamweaver.
Редактируя файл menus.xml,
вы можете добавлять, изменять и удалять
клавиатурные сокращения для пунктов меню,
хотя в большинстве случаев это проще сделать
через редактор клавиатурных сокращений
Keyboard Shortcuts (Edit > Keyboard
Shortcuts ...) Вы также можете переупорядочивать,
переименовывать и удалять пункты меню.
В многопользовательской операционной
системе, когда вы производите в Dreamweaver
изменения, приводящие к модификации файла
menus.xml (такие изменения,
как изменение клавиатурных сокращений
с использованием Редактора Клавиатурных
сокращений), Dreamweaver создает новый
файл menus.xml в вашей пользовательской
конфигурационной папке. Чтобы настроить
menus.xml в многопользовательской
среде, редактируйте копию файла в своей
пользовательской конфигурационной папке
(или скопируйте главный файл menus.xml
в вашу пользовательскую конфигурационную
папку, если DW еще не сделал этого). См.
"О
настройке Dreamweaver в многопользовательских
средах". Если вы открываете menus.xml
в XML-редакторе, то можете встретить сообщения
об ошибках относительно символов амперсанда
(&) в файле menus.xml.
Лучше всего редактировать menus.xml
в обычном текстовом редакторе. (Не редактируйте
его в DW.)
Примечание:
Всегда создавайте резервную копию текущего
файла menus.xml или любого
другого конфигурационного файла, прежде
чем изменять ее. Легко наделать ошибок,
редактируя конфигурационные файлы, и не
существует другого способа отменить ошибочные
изменения, кроме замены файла с ошибками
его предыдущей версией. Если вы забыли
сделать резервную копию: папка Configuration
содержит резервную копию файла menus.xml
с установками по умолчанию menus.bak;
чтобы вернуться к набору меню по умолчанию,
замените menus.xml копией
menus.bak.
Вы можете добавлять определенные виды
команд в меню Commands и изменять их имена,
не прибегая к редактированию файла menus.xml.
Более подробно о menus.xml
см "Об изменении
меню Dreamweaver".
Примечание:
Термин "команда" имеет в Dreamweaver
два значения. Проще говоря, команда —
это частный случай расширения (extension).
Тем не менее, в некоторых контекстах "команда"
приравнивается к термину "пункт меню",
что означает "любой элемент, присутствующий
в меню Dreamweaver", независимо от
того, что он делает или как он это делает.
Чтобы создать новые команды, которые
будут автоматически размещены в меню Commands,
используйте панель History.
Как альтернативу вы можете использовать
Менеджер Расширений (Extension Manager)
для установки новых расширений, включая
команды. См. Справку к Dreamweaver.
Чтобы изменить порядок элементов в меню
Commands, или чтобы переместить элементы
из одного меню в другое, нужно редактировать
файл menus.xml. См. "Переупорядочение
меню и пунктов меню".
Чтобы переименовать созданную
вами команду:
- Выберите Commands > Edit Command List.
Появится диалоговое окно, со списком
всех команд, имена которых вы можете
изменить. (Команды по умолчанию из меню
Commands не появятся в этом списке и
не могут быть отредактированы таким
образом);
- Выберите команду, которую хотите переименовать;
- Введите новое имя для выбранной команды;
- Кликните кнопку Close.
Теперь команда переименована в меню Commands.
Чтобы удалить созданную вами
команду:
- Выберите Commands > Edit Command List.
Появится диалоговое окно, со списком
всех команд, которые вы можете удалить.
(Команды по умолчанию из меню Commands
не появятся в этом списке и не могут
быть удалены таким образом);
- Выберите команду, которую вы хотите
удалить;
- Кликните Delete, а затем подтвердите
удаление команды. Команда удалена. Обратите
внимание, что файл с исходным кодом
команды тоже будет удален; удаление
команды не просто устраняет пункт меню.
Убедитесь, что вы действительно хотите
удалить пункт меню перед тем, как сделать
это. Если вы хотите удалить команду
из меню, не удаляя при этом ее исходный
код, вы можете, найти соответствующий
файл в папке Configuration/Commands
и переместите его в другую папку;
- Кликните кнопку Close.
Редактируя файл menus.xml,
вы можете перемещать пункты из одного
меню в другое, добавлять разделители или
удалять их, и перемещать меню как внутри
одной панели, так и между разными панелями.
Заметьте, что вы можете перемещать пункты
контекстных меню, используя ту же процедуру,
что и для всех других меню.
Смотрите "О синтаксисе
тэгов файла menus.xml".
Чтобы переместить пункт меню:
- Выйдите из Dreamweaver;
- Создайте резервную копию файла
menus.xml;
- Откройте
menus.xml в
текстовом редакторе типа BBEdit, HomeSite,
или Notepad. (Но не открывайте файл
в DW);
- Вырежьте (Ctrl+X)
целиком тэг
menuitem, от
<menuitem в начале до
/> в конце;
- Поместите курсор в новое место для
пункта меню. (Убедитесь, что оно находится
между тэгами
<menu>
и соответствующим ему </menu>;
- Вставьте пункт меню в новое местоположение.
Чтобы создать подменю при перемещении
пункта меню:
- Поместите курсор внутри меню (где-то
между тэгами
<menu>
и соответствующим ему </menu>);
- Вставьте новую пару
<menu></menu>
внутри меню;
- Добавьте новые пункты меню к этому
новому подменю.
Чтобы вставить сепаратор между
двумя пунктами меню:
- Введите тэг "
<separator/>"
между двумя тэгами menuitem.
Чтобы удалить существующий сепаратор:
- Удалите соответствующую строку
<separator/>.
Чтобы переместить меню:
- Выйдите из Dreamweaver;
- Создайте резервную копию файла
menus.xml;
- Откройте
menus.xml в
текстовом редакторе типа BBEdit, HomeSite,
или Notepad. (Не открывайте в DW);
- Вырежьте целое меню и его содержание
от открывающего тэга
<menu>
до закрывающего тэга </menu>;
- Поместите курсор в новое место для
меню. (Убедитесь, что он находится между
тэгом
<menubar> и
соответствующим тэгом </menubar>.);
- Вставьте (Ctrl+V)
меню на его новое место.
Вы можете легко изменить имя любого меню
или любого пункта меню, редактируя файл
menus.xml. См. "О
синтаксисе тэгов файла menus.xml".
Чтобы изменить имя меню или пункта
меню:
- Выйдите из Dreamweaver;
- Создайте резервную копию файла
menus.xml;
- Откройте
menus.xml в
текстовом редакторе типа BBEdit, HomeSite,
или Notepad. (Не открывайте в DW);
- Если вы изменяете пункт меню, найдите
нужный тэг
<menuitem>
и измените значение его атрибута name.
Если вы изменяете меню, найдите нужный
тэг <menu> и измените
значение его атрибута name.
В любом случае, не изменяйте атрибут
id;
- Сохраните и закройте
menus.xml;
затем перезапустите DW для того, чтобы
увидеть изменения.
Если вы испытываете неудобства с набором
клавиатурных сокращений по умолчанию,
вы можете изменить, удалить существующие
клавиатурные сокращения или добавить новые.
Проще всего использовать для этого редактор
клавиатурных сокращений (Edit > Keyboard
Shortcuts...). Также вы можете редактировать
клавиатурные сокращения прямо в файле
menus.xml, если вам так удобнее,
хотя намного легче наделать ошибок при
вводе клавиатурных сокращений в menus.xml,
чем при работе в редакторе клавиатурных
сокращений. См. "О
синтаксисе тэгов файла menus.xml"
Чтобы изменить клавиатурное сокращение
(shortcut):
- Выйдите из Dreamweaver;
- Создайте резервную копию файла
menus.xml;
- Откройте
menus.xml в
текстовом редакторе типа BBEdit, HomeSite,
или Notepad. (Не открывайте в DW);
- Посмотрите на матрицу клавиатурных
сокращений (Keyboard Shortcut Matrix),
которую можно скачать в Центре поддержки
Dreamweaver (Dreamweaver Support Center)
на сайте Macromedia и найдите неиспользуемые
сокращения, или те, которые вы хотите
переназначить;
Если вы переназначаете клавиатурное
сокращение, пометьте это на распечатанной
копии матрицы для будущего использования;
- Если вы переназначаете клавиатурное
сокращение, найдите пункт меню, с которым
связано сокращение, и удалите его атрибут
key="сочетание клавиш";
- Найдите пункт меню, для которого
вы хотите назначить/переназначить клавиатурное
сокращение;
- Если пункт меню уже имеет клавиатурное
сокращение, найдите атрибут
key
в этой строке. Если у него еще нет сокращения,
добавьте key=""
где-нибудь между атрибутами внутри тэга
menuitem;
- Введите новое клавиатурное сокращение
между двойными кавычками атрибута
key.
Используйте знак "плюс" (+)
между клавишами в комбинации клавиш.
Более подробно о модификаторах вы можете
узнать в описании
тэга menuitem.
Если такое сокращение уже используется
где-нибудь еще, и вы не удалили его
в том месте, сокращение будет применено
только к тому пункту меню, который использует
его через файл menus.xml;
Примечание:
Вы можете использовать одно и то же
клавиатурное сокращение для пунктов
меню "только для Windows"
и для пунктов меню "только для
Macintosh".
- Запишите ваше новое клавиатурное сокращение
в соответствующее место Матрицы Клавиатурных
Сокращений.
Dreamweaver предлагает всплывающие и
контекстные меню во многих своих панелях
и диалоговых окнах. Некоторые контекстные
меню определены в файле menus.xml;
некоторые заданы в других XML-файлах.
Вы можете добавлять, изменять и удалять
пункты этих меню вручную, хотя в большинстве
случаев лучше написать расширение, производящее
такие же изменения. Информацию о создании
расширений, которые изменяют большинство
этих XML-файлов, см. "Расширение
Dreamweaver" (Help > Extending
Dreamweaver).
Следующие всплывающие и контекстные меню
Dreamweaver заданы в XML-файлах, использующих
те же тэги, что и файл menus.xml:
- Источники данных (Data sources), перечисленные
во всплывающем меню панели
Bindings
(нужно нажать кнопку со знаком "+"),
заданы в файлах DataSources.xml,
в подпапках папки DataSources;
- Модели поведения сервера (Server
behaviors), перечисленные во всплывающем
меню панели
Server Behaviors
(нужно нажать кнопку со знаком "+"),
заданы в файлах ServerBehaviors.xml,
в подпапках папки ServerBehaviors;
- Форматы сервера (Server formats),
перечисленные во всплывающем меню диалогового
окна
Edit Format List (нужно
нажать кнопку со знаком "+"),
заданы в файлах ServerFormats.xml,
находящихся в подпапках паки ServerFormats;
- Пункты во всплывающих меню форматов
для связи в панели
Bindings
заданы в файлах Formats.xml,
в подпапках папки ServerFormats.
Вы можете добавлять пункты в это меню
изнутри самого DW, используя диалоговое
окно Add Format;
- Пункты меню диалогового окна Tag Library
Editor заданы в файле
TagLibraries/TagImporters/TagImporters.xml;
- Пункты меню для параметров в диалоговом
окне Generate Behavior, являющемся частью
Server Behavior Builder, заданы в файле
Shared/Controls/String Menu/Controls.xml;
- Пункты контекстных меню, ассоциируемых
с Компонентами ColdFusion, заданы в
Components/ColdFusion/CFCs/CFCsMenus.xml;
- Пункты контекстных меню для источников
данных ColdFusion:
Components/ColdFusion/DataSources/DataSourcesMenus.xml;
- Пункты контекстных меню, ассоциируемых
с JavaBeans:
Components/Jsp/JavaBeans/JavaBeanMenus.xml;
- Пункты контекстных меню, ассоциируемых
с различными серверными компонентами,
заданы в XML-файлах в подпапках папки
Components.
Файл menus.xml содержит
структурированный список строк меню, меню,
пунктов меню, сепараторов, и клавиатурных
сокращений и клавиатурных сокращений для
пунктов меню. Эти пункты описаны XML-тэгами,
которые можно редактировать в текстовом
редакторе.
Примечание:
Будьте аккуратны при внесении изменений
в меню. Dreamweaver игнорирует любые меню
или пункты меню, содержащие ошибки синтаксиса
XML.
Строка меню (снабженная открывающими
и закрывающими тэгами menubar)
— это набор разделенных меню; например,
есть главная строка меню (main menu bar),
отдельная строка меню для окна Site (только
для Windows), и строка меню для каждого
контекстного меню. Каждая строка меню
содержит одно или более меню; меню содержится
в тэге menu. Каждое меню
содержит один или более пунктов меню,
каждый из которых описан тэгом menuitem
и его атрибутами. Меню также может содержать
разделители (описываемые тэгами
separator) и подменю.
Вдобавок к клавиатурным сокращениям,
ассоциированным с пунктами меню, Dreamweaver
предоставляет другие разнообразные клавиатурные
сокращения, включая альтернативные шорткаты
и шорткаты, доступные только в определенных
контекстах. Например, Control+Y
(Windows) или Command+Y
(Macintosh) — это шорткат для Redo;
но Control+Shift+Z
или Command+Shift+Z
— это альтернативные шорткаты для
той же команд Redo. Эти альтернативные
шорткаты, как и другие шорткаты, которые
нельзя представить в виде тэгов для пунктов
меню, определены в списках клавиатурных
сокращений в файле menus.xml.
Каждый список шорткатов (описанный тэгом
shortcutlist) содержит один
или более шорткатов, каждый из которых
описан тэгом shortcut.
Следующие разделы описывают синтаксис
тэгов файла menus.xml. Необязательные
атрибуты помечены в списках атрибутов
фигурными скобками ({});
все остальные атрибуты обязательны.
Описание
Предоставляет информацию о строке меню
в структуре меню Dreamweaver.
Атрибуты
name, {app}, id, {platform}
name
Имя строки меню. Хотя имя является обязательным
атрибутом, вы можете присвоить ему пустое
значение ("").
app
Имя приложения, в котором доступна строка
меню. В настоящий момент не используется.
id
Идентификатор (ID) для строки меню. Каждый
идентификатор в файле menus.xml
должен быть уникальным.
platform
Показывает, что строка меню может быть
видна только на определенной платформе.
Допустимые значения — "win"
и "mac".
Содержание
Этот тэг должен содержать один или более
тэгов menu.
Контейнер
Нет.
Пример
Меню главного окна Dreamweaver (Document
window) использует следующий тэг menubar:
<menubar name="Main
Window" id="DWMainWindow">
<!-- здесь идут тэги menu
-->
</menubar>
Описание
Предоставляет информацию о меню или подменю
в структуре меню Dreamweaver.
Атрибуты
name, {app}, id, {platform}
name
Имя меню, отображаемое в строке меню.
Чтобы установить клавишу доступа к меню
(menu's access key) в Windows, используйте
символ подчеркивания (_)
перед буквой доступа. Подчеркивание автоматически
удаляется на Macintosh.
app
Имя приложения, в котором доступно меню.
В настоящий момент не используется.
id
Идентификатор меню. Каждый идентификатор
должен быть уникальным.
platform
Показывает, что меню может быть видно
только на определенной платформе. Допустимые
значения — "win"
и "mac".
Содержание
Этот тэг должен содержать один или более
тэгов menuitem, и один или
более тэгов separator. Он
может содержать другие тэги menu
(для создания подменю) и стандартные тэги
HTML-комментариев.
Контейнер
Этот тэг должен быть включен в тэг menubar.
Пример
<menu name="_File"
id="DWMenu_File">
<!-- здесь идут тэги menuitem,
separator, menu,
или тэг html-комментария -->
</menu>
Описание
Определяет пункт меню для меню Dreamweaver.
Атрибуты
name, id, {app}, {key}, {platform},
{enabled}, {arguments}, {command}, {file},
{checked}, {dynamic}
name
Имя пункта меню, отображающееся
в меню. Подчеркивание показывает, что
следующая буква является клавишей доступа
команды (только для Windows).
id
Используется Dreamweaver'ом для идентификации
пункта меню. Этот идентификатор должен
быть уникальным во всей структуре меню.
Если вы добавляете новые пункты меню в
menus.xml, подстрахуйте уникальность
идентификатора путем включения в него
названия вашей компании или другой уникальной
строки как префикса для каждого идентификатора
пункта меню.
app
Имя приложения, в котором доступен пункт
меню. В настоящий момент не используется.
key
Клавиатурное сокращение для команды, если
оно есть. Используйте следующие строки
для задания клавиш-модификаторов:
-
Cmd указывает на клавишу
Control (Windows) или Command (Macintosh);
-
Alt и Opt
равнозначно задает клавишу Alt (Windows)
или Option (Macintosh);
-
Shift задает клавишу
Shift на обеих платформах;
-
Ctrl указывает на клавишу
Control на обеих платформах;
- Знак плюс (
+) разделяет
клавиши-модификаторы, если задаваемое
клавиатурное сокращение использует более
одного модификатора. Например, Cmd+Opt+5
в атрибуте key означает,
что пункт меню выполняется, когда пользователь
нажимает комбинацию клавиш Control+Alt+5
(Windows) или Command+Option+5 (Macintosh).
- Специальные клавиши определены по
именам: от
F1 до F12,
PgDn, PgUp,
Home, End,
Ins, Del,
Tab, Esc,
BkSp, и Space.
Клавиши-модификаторы также могут применяться
со специальными клавишами.
platform
Показывает, на какой платформе отображается
пункт меню. Допустимые значения —
"win" , что означает
"только Windows", или "mac",
означающее "только Macintosh".
Если вы не задаете атрибут platform,
пункт меню отображается на обеих платформах.
Если вы хотите, чтобы пункт меню по-разному
вел себя на разных платформах, поставьте
два пункта меню с одинаковыми именами
(name), но разными id:
один пункт со значением platform="win"
и другой — с platform="mac";
enabled
Предоставляет код JavaScript (обычно вызов
функции JavaScript), определяющий, доступен
ли в данный момент данный пункт меню.
Если функция возвращает значение false,
данный пункт меню затемнен. Значение по
умолчанию — "true",
но лучше всегда задавать значение для
ясности, даже если оно равно "true";
arguments
Предоставляет Dreamweaver аргументы для
передачи коду в JavaScript-файле, который
вы определяете в атрибуте file.
Заключайте аргументы в одинарные кавычки
(') внутри двойных кавычек,
используемых для ограничения значения
атрибута;
command
Задает JavaScript-выражение, которое выполняется,
когда пользователь выбирает этот пункт
меню. Если код JavaScript довольно сложный,
используйте вместо него файл JavaScript
(заданный в атрибуте file).
Вы должны задать либо атрибут file,
либо атрибут command для
каждого пункта меню;
file
file="Commands/Welcome.htm".)
Учтите, что атрибут file
аннулирует атрибуты command,
enabled, и checked.
Вы должны задать либо атрибут file,
либо атрибут command для
каждого пункта меню. Информацию о создании
командного файла путем использования панель
History, см. Справку Dreamweaver. За информацией
о написании ваших собственных JavaScript-команд,
обратитесь к Расширению Dreamweaver (Help
> Extending Dreamweaver);
checked
JavaScript-выражение, показывающее, имеет
ли пункт меню метку о его выделении в
меню; если выражение разрешается в true,
пункт меню отображен с пометкой (галочкой)
рядом с ним;
dynamic
Если присутствует, указывает, что пункт
меню должен быть определен динамически,
HTML-файлом; этот файл содержит JavaScript-код
для задания текста и состояния пункта
меню. Если вы определяете тэг как dynamic,
вы должны также определить атрибут file.
isdomrequired
Показывает, нужно ли синхронизировать
вид дизайна (Design view) и вид кода (Code
view) перед выполнением кода для этого
пункта меню. Допустимые значения —
"true" (по умолчанию)
и "false". Если
вы устанавливаете этот атрибут в "false",
это означает, что изменения файла, производимые
этим пунктом меню, не используют Dreamweaver
DOM (Объектная Модель Документа Dreamweaver).
Информацию о DOM, ищите в Расширении Dreamweaver
(Help > Extending Dreamweaver).
Содержание
Нет (Пустой тэг).
Контейнер
Этот тэг должен содержаться внутри тэга
menu.
Пример
<menuitem name="_New"
key="Cmd+N" enabled="true"
command="dw.createDocument()"
id="DWMenu_File_New" />
Описание
Показывает, что в соответствующем месте
меню будет отображен сепаратор (разделительная
линия).
Атрибуты
{app}
app
Имя приложения, в котором показывается
сепаратор. В настоящий момент не используется.
Содержание
Нет (Пустой тэг).
Контейнер
Этот тэг должен содержаться внутри тэга
menu.
Пример
<separator/>
Описание
Задает список клавиатурных сокращений
("шорткатов") в файле menus.xml.
Атрибуты
{app}, id, {platform}
app
Имя приложения, в котором доступен список
шорткатов. В настоящий момент не используется.
id
Идентификатор для списка шорткатов.
Может совпадать с идентификатором меню
для строки меню (или контекстного меню)
в Dreamweaver, с которым ассоциированы
шорткаты. Допустимые значения —
"DWMainWindow",
"DWMainSite", "DWTimelineContext",
и "DWHTMLContext".
platform
Показывает, что список будет отображен
только на заданной платформе. Допустимые
значения — "win"
и "mac".
Содержание
Этот тэг содержит один или более тэгов
shortcut. Также может содержать
один или более тэгов комментариев (использующих
синтаксис HTML-комментариев).
Контейнер
Нет.
Пример
<shortcutlist id="DWMainWindow">
<!-- shortcut and comment tags here
--> </shortcutlist>
Описание
Задает клавиатурное сокращение ("шорткат")
в файле menus.xml.
Атрибуты
key, {app}, {platform}, {file},
{arguments}, {command}, id, {name}
key
Комбинация клавиш, активизирующая клавиатурное
сокращение. Детали синтаксиса см. в описании
"<menuitem>";
app
Имя приложения, в котором доступен шорткат.
В настоящий момент не используется;
platform
Задает платформу, на которой должен работать
данный шорткат. Допустимые значения —
"win" и "mac".
Если вы не задаете этот атрибут, шорткат
работает на обеих платформах;
file
Путь к файлу, содержащему сценарий JavaScript,
выполняемый Dreamweaver'ом, когда вы используете
шорткат. Атрибут file аннулирует
атрибут command. Вы должны
задать либо атрибут file,
либо атрибут command для
каждого клавиатурного сокращения;
arguments
Предоставляет Dreamweaver аргументы для
передачи в файл JavaScript, который вы
определили в атрибуте file.
Заключайте аргументы в одинарные кавычки
(') внутри двойных кавычек,
используемых для ограничения значения
атрибута;
command
Код JavaScript, исполняемый Dreamweaver,
когда вы используете данный шорткат. Задайте
file или command
для каждого шортката.
id
Уникальный идентификатор для шортката.
name
Имя для команды, выполняемой через шорткат
в стиле имен для пунктов меню. Например,
атрибут name для шортката
F12 — "Preview in Primary Browser"
("Просмотр в первичном броузере").
Содержание
Нет (Пустой тэг).
Контейнер
Этот тэг должен содержаться внутри тэга
shortcutlist.
Пример
<shortcut key="Cmd+Shift+Z"
file="Menus/MM/Edit_Clipboard.htm"
arguments="’redo’" id="DWShortcuts_Edit_Redo"
/>
[новое окно]>
