labwc/docs/labwc-menu.5.scd
Johan Malm 49dfba1507 menu: support CDATA for <command> element
...in order to support obmenu-generator output such as this:

  <menu id="root-menu" label="Applications">
    <item label="File Manager"><action name="Execute"><command><![CDATA[xdg-open .]]></command></action></item>
    <item label="Terminal"><action name="Execute"><command><![CDATA[xterm]]></command></action></item>
    <item label="Web Browser"><action name="Execute"><command><![CDATA[xdg-open http://]]></command></action></item>
    <item label="Run command"><action name="Execute"><command><![CDATA[gmrun]]></command></action></item>
  </menu>

References:
- https://github.com/trizen/obmenu-generator
- https://aur.archlinux.org/packages/obmenu-generator
- https://trizenx.blogspot.com/2012/02/obmenu-generator.html

Fixes: issue #972
2023-07-04 06:01:47 +01:00

59 lines
1.2 KiB
Markdown

labwc-menu(5)
# NAME
labwc - menu files
# DESCRIPTION
Static menus are built based on content of XML files located at
"~/.config/labwc" and equivalent XDG Base Directories.
# SYNTAX
A menu file must be entirely enclosed within <openbox_menu> and
</openbox_menu> tags. Inside these tags, menus are specified as follows:
```
<menu id="">
<!-- A menu entry with an action, for example to execute an application -->
<item label="">
<action></action>
</item>
<!-- A submenu defined elsewhere -->
<menu id="" />
<!-- Horizontal line >
<separator />
<!-- An inline submenu -->
<menu id="" label="">
...some content...
</menu>
</menu>
```
*menu.id*
Each menu must be given an id, which is a unique identifier of the menu.
This id is used to refer to the menu in a ShowMenu action.
*menu.label*
The title of the menu, shown in its parent. A label must be given when
defining a menu.
*menu.item.label*
The visible name of the menu item.
*menu.item.action*
See labwc-action(5). Note: XML CDATA is supported for this node in
order to maintain compatibility with obmenu-generator.
*menu.separator*
Horizontal line.
# SEE ALSO
labwc(1), labwc-action(5), labwc-config(5), labwc-theme(5)