[openbox] two menu files when using a separate taskbar/launcher and other questions
Peter Chiocchetti
dub at lazy.shacknet.nu
Mon Jul 26 20:24:07 EDT 2004
On Mon, Jul 26, 2004 at 10:20:26AM -0700, Marc Wilson wrote:
>
> > Is there a GUI tool for managing the menu file(s)?
>
> Someone was working on the necessary to use a XML editor for it, but I
> don't know if it ever went anywhere. It's not like it's hard to write a
> menu file in $EDITOR. What seems to bite people is the idea of nesting a
> menu within a menu.
I wrote the xml schema description for the menu file format:
the debian package installs it in /usr/share/openbox/menu.xsd.
the according /etc/xdg/openbox/menu.xml points at it, so you
can just cp it to yr. home dir. and start up xerlin, to edit
in a GUI.
despite the familiar tree widgets, this is for people, who can
do it with text, but prefer the GUI - its not for those, that
could not do with joe/vi etc. unfortunately, xerlin suffers
from a failure to behave well with unordered sequences - its a
very smart application nevertheless.
additionally, the menu format allows the "menu" element to
both define a menu tree and declare a reference to a menu
defined somewhere else in the file; with both these being
possible in the same place, xsd cannot, AFAIK, be tailored to
force the difference.
in rc.xml eg. xsd cannot help you from putting a desktop
element inside a keybind's action element whose name attribute
isnt Desktop. so even the xsd based xml editor cannot prevent
you from producing non working or senseless files.
pch.
PS: to the maintainer: though of little use, attached an
updated rc.xsd (new dialog element) and menu.xsd file - the
source distribution may use macros in the first two lines.
-------------- next part --------------
<?xml version="1.0" encoding="UTF-8"?>
<!--
xml Schema for the openbox windowmanager menu file
Changes:
Don Aug 14 21:10:27 CEST 2003 - pch(a)myzel.net
split from rc3.xsd
Mon Sep 8 12:33:57 CEST 2003 - pch(a)myzel.net
up to beta1
Die Sep 16 21:22:59 CEST 2003 - pch(a)myzel.net
use a namespace
Fri Sep 19 14:36:33 EDT 2003 - xor(a)orodu.net
use openbox.org for namespace
Mon Sep 22 02:42:10 EDT 2003 - xor(a)orodu.net
fix some capitalization
Die Jul 27 00:27:36 CEST 2004 - pch(a)myzel.net
some clean up
-->
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://openbox.org/"
xmlns:ob="http://openbox.org/"
elementFormDefault="qualified">
<!--
root node
-->
<xs:element name="openbox_menu">
<xs:complexType mixed="false">
<xs:sequence>
<xs:element maxOccurs="unbounded" name="menu" type="ob:menu"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<!--
complex types
-->
<xs:complexType name="menu">
<xs:sequence maxOccurs="unbounded" minOccurs="0">
<xs:element maxOccurs="unbounded" minOccurs="0" name="menu" type="ob:menu"/>
<xs:element maxOccurs="unbounded" minOccurs="0" name="item" type="ob:item"/>
<xs:element maxOccurs="unbounded" minOccurs="0" name="separator" type="ob:empty"/>
</xs:sequence>
<xs:attribute name="label" type="xs:string" use="optional"/>
<xs:attribute name="execute" type="xs:string" use="optional"/>
<xs:attribute name="id" type="xs:string" use="required"/>
</xs:complexType>
<xs:complexType name="empty" />
<xs:complexType name="item">
<xs:sequence>
<xs:element minOccurs="0" name="action">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" name="execute" type="xs:string"/>
</xs:sequence>
<xs:attribute name="name" type="ob:actionname" use="required"/>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="label" type="xs:string" use="required"/>
</xs:complexType>
<!--
simple types / restrictions
-->
<xs:simpleType name="actionname">
<xs:restriction base="xs:string">
<xs:enumeration value="Execute"/>
<xs:enumeration value="Restart"/>
<xs:enumeration value="Reconfigure"/>
<xs:enumeration value="Exit"/>
</xs:restriction>
</xs:simpleType>
</xs:schema>
-------------- next part --------------
<?xml version="1.0" encoding="UTF-8"?>
<!--
xml Schema for the openbox windowmanager configuration file
Changes:
Son Aug 10 15:49:10 CEST 2003 - pch(a)myzel.net
restrictions added, up to current format
Don Aug 14 21:10:27 CEST 2003 - pch(a)myzel.net
up to current (from action.c,config.c)
Don Aug 21 23:07:30 CEST 2003 - pch(a)myzel.net
new element - follow
Mon Sep 1 00:57:55 CEST 2003 - pch(a)myzel.net
up to alpha7
Mit Sep 3 12:40:10 CEST 2003 - pch(a)myzel.net
up to alpha8, a little documentation
Mon Sep 8 11:52:07 CEST 2003 - pch(a)myzel.net
up to cvs 1.12
Mon Sep 15 14:27:42 CEST 2003 - pch(a)myzel.net
up to cvs 1.14
Die Sep 16 20:56:37 CEST 2003 - pch(a)myzel.net
use a namespace
Fri Sep 19 14:36:33 EDT 2003 - xor(a)orodu.net
use openbox.org for namespace
Mon Sep 22 02:34:53 EDT 2003 - xor(a)orodu.net
add the focusLast and raiseOnFocus options
fix some capitalization
Mon Sep 22 14:08:16 EDT 2003 - xor(a)orodu.net
update hideTimeout to hideDelay
Die Jul 27 00:53:30 CEST 2004 - pch(a)myzel.net
add dialog element
-->
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://openbox.org/"
xmlns:ob="http://openbox.org/"
elementFormDefault="qualified">
<!--
root node
-->
<xs:element name="openbox_config">
<xs:annotation>
<xs:documentation>all these elements are expected in a openbox config file</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="resistance" type="ob:resistance"/>
<xs:element name="focus" type="ob:focus"/>
<xs:element name="theme" type="ob:theme"/>
<xs:element name="desktops" type="ob:desktops"/>
<xs:element name="resize" type="ob:resize"/>
<xs:element name="dock" type="ob:dock"/>
<xs:element name="dialog" type="ob:dialog"/>
<xs:element name="keyboard" type="ob:keyboard"/>
<xs:element name="mouse" type="ob:mouse"/>
<xs:element name="menu" type="ob:menu"/>
<xs:element name="placement" type="ob:placement"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<!--
complex types
-->
<xs:complexType name="resistance">
<xs:annotation>
<xs:documentation>defines behaviour of windows when close to eachother or the screen edge</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="strength" type="xs:integer"/>
<xs:element name="screen_edge_strength" type="xs:integer"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="focus">
<xs:annotation>
<xs:documentation>defines aspects of window focus</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="focusNew" type="ob:yesorno"/>
<xs:element name="focusLast" type="ob:yesorno"/>
<xs:element name="followMouse" type="ob:yesorno"/>
<xs:element name="focusDelay" type="xs:integer"/>
<xs:element name="raiseOnFocus" type="ob:yesorno"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="placement">
<xs:annotation>
<xs:documentation>defines how new windows are placed</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="policy" type="ob:placementpolicy"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="theme">
<xs:sequence>
<xs:element name="name" type="xs:string"/>
<xs:element name="titlelayout" type="xs:string"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="desktops">
<xs:sequence>
<xs:element name="number" type="xs:integer"/>
<xs:element name="names">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="name" type="xs:string"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="firstdesk" type="xs:integer"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="resize">
<xs:sequence>
<xs:element name="drawContents" type="ob:yesorno"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="dock">
<xs:sequence>
<xs:element name="position" type="ob:position"/>
<xs:element name="stacking" type="ob:stacking"/>
<xs:element name="direction" type="ob:direction"/>
<xs:element name="floatingX" type="xs:integer"/>
<xs:element name="floatingY" type="xs:integer"/>
<xs:element name="autoHide" type="ob:yesorno"/>
<xs:element name="hideDelay" type="xs:integer"/>
<xs:element name="moveButton" type="ob:button"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="dialog">
<xs:sequence>
<xs:element name="focus" type="ob:yesorno"/>
<xs:element name="desktop" type="ob:yesorno"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="action">
<xs:sequence>
<xs:element minOccurs="0" name="menu" type="xs:string"/>
<xs:element minOccurs="0" name="desktop" type="xs:integer"/>
<xs:element minOccurs="0" name="follow" type="ob:yesorno"/>
<xs:element minOccurs="0" name="execute" type="xs:string"/>
<xs:element minOccurs="0" name="dialog" type="ob:yesorno"/>
</xs:sequence>
<xs:attribute name="name" type="ob:actionname" use="required"/>
</xs:complexType>
<xs:complexType name="keybind">
<xs:sequence>
<xs:element maxOccurs="unbounded" name="action" type="ob:action"/>
</xs:sequence>
<xs:attribute name="key" type="ob:keyname" use="required"/>
</xs:complexType>
<xs:complexType name="keyboard">
<xs:sequence>
<xs:element name="chainQuitKey" type="ob:keyname"/>
<xs:element maxOccurs="unbounded" name="keybind" type="ob:keybind"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="mousebind">
<xs:sequence>
<xs:element maxOccurs="unbounded" name="action" type="ob:action"/>
</xs:sequence>
<xs:attribute name="action" type="ob:mouseaction" use="required"/>
<xs:attribute name="button" type="ob:button" use="required"/>
</xs:complexType>
<xs:complexType name="context">
<xs:sequence>
<xs:element maxOccurs="unbounded" name="mousebind" type="ob:mousebind"/>
</xs:sequence>
<xs:attribute name="name" type="ob:contextname" use="required"/>
</xs:complexType>
<xs:complexType name="mouse">
<xs:sequence>
<xs:element name="dragThreshold" type="xs:integer"/>
<xs:element name="doubleClickTime" type="xs:integer"/>
<xs:element maxOccurs="unbounded" name="context" type="ob:context"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="menu">
<xs:sequence>
<xs:element maxOccurs="unbounded" name="file" type="xs:string"/>
</xs:sequence>
</xs:complexType>
<!--
simple types / restrictions
-->
<xs:simpleType name="yesorno">
<xs:restriction base="xs:string">
<xs:enumeration value="yes"/>
<xs:enumeration value="no"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="placementpolicy">
<xs:restriction base="xs:string">
<xs:enumeration value="Smart"/>
<xs:enumeration value="UnderMouse"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="position">
<xs:restriction base="xs:string">
<xs:enumeration value="TopLeft"/>
<xs:enumeration value="Top"/>
<xs:enumeration value="TopRight"/>
<xs:enumeration value="Right"/>
<xs:enumeration value="BottomRight"/>
<xs:enumeration value="Bottom"/>
<xs:enumeration value="BottomLeft"/>
<xs:enumeration value="Left"/>
<xs:enumeration value="Floating"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="stacking">
<xs:restriction base="xs:string">
<xs:enumeration value="Top"/>
<xs:enumeration value="Normal"/>
<xs:enumeration value="Bottom"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="direction">
<xs:restriction base="xs:string">
<xs:enumeration value="Horizontal"/>
<xs:enumeration value="Vertical"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="keyname">
<xs:restriction base="xs:string">
<xs:pattern value="(A-)?(S-)?(A-)?(C-)?(A-)?(S-)?(A-)?[a-zA-Z0-9]*"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="contextname">
<xs:restriction base="xs:string">
<xs:enumeration value="Desktop"/>
<xs:enumeration value="Client"/>
<xs:enumeration value="Titlebar"/>
<xs:enumeration value="Handle"/>
<xs:enumeration value="Frame"/>
<xs:enumeration value="TLCorner"/>
<xs:enumeration value="TRCorner"/>
<xs:enumeration value="BLCorner"/>
<xs:enumeration value="BRCorner"/>
<xs:enumeration value="Maximize"/>
<xs:enumeration value="AllDesktops"/>
<xs:enumeration value="Shade"/>
<xs:enumeration value="Iconify"/>
<xs:enumeration value="Icon"/>
<xs:enumeration value="Close"/>
<xs:enumeration value="MoveResize"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="button">
<xs:restriction base="xs:string">
<xs:enumeration value="Left"/>
<xs:enumeration value="Middle"/>
<xs:enumeration value="Right"/>
<xs:enumeration value="Up"/>
<xs:enumeration value="Down"/>
<xs:enumeration value="A-Left"/>
<xs:enumeration value="A-Middle"/>
<xs:enumeration value="A-Right"/>
<xs:enumeration value="A-Up"/>
<xs:enumeration value="A-Down"/>
<xs:enumeration value="C-A-Left"/>
<xs:enumeration value="C-A-Middle"/>
<xs:enumeration value="C-A-Right"/>
<xs:enumeration value="C-A-Up"/>
<xs:enumeration value="C-A-Down"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="mouseaction">
<xs:restriction base="xs:string">
<xs:enumeration value="Click"/>
<xs:enumeration value="DoubleClick"/>
<xs:enumeration value="Drag"/>
<xs:enumeration value="Press"/>
<xs:enumeration value="Release"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="actionname">
<xs:restriction base="xs:string">
<xs:enumeration value="Activate"/>
<xs:enumeration value="Close"/>
<xs:enumeration value="Desktop"/>
<xs:enumeration value="DesktopDown"/>
<xs:enumeration value="DesktopLast"/>
<xs:enumeration value="DesktopLeft"/>
<xs:enumeration value="DesktopNext"/>
<xs:enumeration value="DesktopPrevious"/>
<xs:enumeration value="DesktopRight"/>
<xs:enumeration value="DesktopUp"/>
<xs:enumeration value="DirectionalFocusEast"/>
<xs:enumeration value="DirectionalFocusNorth"/>
<xs:enumeration value="DirectionalFocusNortheast"/>
<xs:enumeration value="DirectionalFocusNorthwest"/>
<xs:enumeration value="DirectionalFocusSouth"/>
<xs:enumeration value="DirectionalFocusSoutheast"/>
<xs:enumeration value="DirectionalFocusSouthwest"/>
<xs:enumeration value="DirectionalFocusWest"/>
<xs:enumeration value="Execute"/>
<xs:enumeration value="Exit"/>
<xs:enumeration value="Focus"/>
<xs:enumeration value="GrowToEdgeEast"/>
<xs:enumeration value="GrowToEdgeNorth"/>
<xs:enumeration value="GrowToEdgeSouth"/>
<xs:enumeration value="GrowToEdgeWest"/>
<xs:enumeration value="Iconify"/>
<xs:enumeration value="Kill"/>
<xs:enumeration value="Lower"/>
<xs:enumeration value="MaximizeFull"/>
<xs:enumeration value="MaximizeHorz"/>
<xs:enumeration value="MaximizeVert"/>
<xs:enumeration value="Move"/>
<xs:enumeration value="MoveRelativeHorz"/>
<xs:enumeration value="MoveRelativeVert"/>
<xs:enumeration value="MoveToEdgeEast"/>
<xs:enumeration value="MoveToEdgeNorth"/>
<xs:enumeration value="MoveToEdgeSouth"/>
<xs:enumeration value="MoveToEdgeWest"/>
<xs:enumeration value="NextWindow"/>
<xs:enumeration value="NextWindowLinear"/>
<xs:enumeration value="PreviousWindow"/>
<xs:enumeration value="PreviousWindowLinear"/>
<xs:enumeration value="Raise"/>
<xs:enumeration value="RaiseLower"/>
<xs:enumeration value="Resize"/>
<xs:enumeration value="ResizeRelativeHorz"/>
<xs:enumeration value="ResizeRelativeVert"/>
<xs:enumeration value="Restart"/>
<xs:enumeration value="SendToBottomLayer"/>
<xs:enumeration value="SendToDesktop"/>
<xs:enumeration value="SendToDesktopDown"/>
<xs:enumeration value="SendToDesktopLeft"/>
<xs:enumeration value="SendToDesktopNext"/>
<xs:enumeration value="SendToDesktopPrevious"/>
<xs:enumeration value="SendToDesktopRight"/>
<xs:enumeration value="SendToDesktopUp"/>
<xs:enumeration value="SendToNormalLayer"/>
<xs:enumeration value="SendToTopLayer"/>
<xs:enumeration value="Shade"/>
<xs:enumeration value="ShadeLower"/>
<xs:enumeration value="ShowDesktop"/>
<xs:enumeration value="ShowMenu"/>
<xs:enumeration value="ToggleAlwaysOnBottom"/>
<xs:enumeration value="ToggleAlwaysOnTop"/>
<xs:enumeration value="ToggleDecorations"/>
<xs:enumeration value="ToggleMaximizeFull"/>
<xs:enumeration value="ToggleMaximizeHorz"/>
<xs:enumeration value="ToggleMaximizeVert"/>
<xs:enumeration value="ToggleOmnipresent"/>
<xs:enumeration value="ToggleShade"/>
<xs:enumeration value="ToggleShowDesktop"/>
<xs:enumeration value="Unfocus"/>
<xs:enumeration value="UnmaximizeFull"/>
<xs:enumeration value="UnmaximizeHorz"/>
<xs:enumeration value="UnmaximizeVert"/>
<xs:enumeration value="Unshade"/>
<xs:enumeration value="UnshadeRaise"/>
<xs:enumeration value="UnShowDesktop"/>
</xs:restriction>
</xs:simpleType>
</xs:schema>
More information about the openbox
mailing list