awips2/docs/cave/d2d-edit-menus.md

55 lines
2.7 KiB
Markdown
Raw Normal View History

# Editing Menus
Any of the menus in the menubar can be customized in the **Localization Perspective**.
---
## Modifying Menus
Once in the **Localization Perspective**, menus can be modified by going to the **D2D** > **Menus** directory in the File Browser. Here there are submenus for different data types and menu structures. Usually the **index.xml** file found in these submenus is the *master* file which the actual menu is based off of. This file can reference other xml files and you may have to modify these *child* xml files to get the results you are looking for.
In order to modify any file, you must right click on it and
select **Copy To > USER (my-username)**. Then you may open this copy and begin to modify it. Once this process has been completed and a change has been made and saved, CAVE will need to be restarted and opened in the D2D perspective to see the change.
This example covers how to add a new menu entry to an existing menu.
1. Switch to the **Localization Perspective**
2. Find the **grid** folder under **D2D** > **Menus**
3. Double-click to expand **index.xml**
4. Right-click to **BASE (common_static)** and select **Copy To...**, then select **USER** level
5. Double-click **USER** to open the editor and copy an existing include tag, and update the *modelName* (this must match an existing product found in the Product Browser) and the *menuName* (this can be anything)
<include installTo="menu:models" fileName="menus/grid/allFamilies.xml">
<substitute key="modelName" value="GEFS" />
<substitute key="menuName" value="GEFS" />
<substitute key="frameCount" value="41" />
<substitute key="TP" value="TP"/>
</include>
6. Once this is completed, save the file and restart CAVE
7. Navigate to the **Models** menu and you should see a new entry with **GEFS**
---
## Removing Menus
This example covers how to remove a menu (in this case **MRMS**) from D2D:
1. Switch to the **Localization Perspective**
2. Find the **mrms** folder under **D2D** > **Menus**
3. Double-click to expand **index.xml**
4. Right-click **BASE** and select **Copy To...**, then select **USER** level
5. Right-click refresh the **mrms** entry
6. Double click **USER** to open the editor and change
<menuContributionFile>
<include installTo="menu:mrms?after=MRMS_MENU_START" fileName="menus/mrms/mrms.xml"/>
</menuContributionFile>
to
<menuContributionFile>
</menuContributionFile>
With this completed, you can now restart CAVE and will not see the MRMS menu anymore. Repeat this example for other product menus, such as **radar**, **upperair**, **tools**, etc., to further customize D2D data menus for any level of localization.