mirror of
				https://github.com/labwc/labwc.git
				synced 2025-11-03 09:01:51 -05:00 
			
		
		
		
	...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
		
	
			
		
			
				
	
	
		
			59 lines
		
	
	
	
		
			1.2 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			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)
 |