Difference between revisions of "Menu theme development guide"

From MythTV Official Wiki
Jump to: navigation, search
(Overview)
Line 1: Line 1:
 
==Introduction==
 
==Introduction==
Menu themes allow the user to customize where certain myth features are located.  By creating a customized menu theme, users can tailor MythTV to there own usage.  The goal of this guide is to familiarize users with the menu's XML format and to create a comprehensive list of actions that will allow the user to invoke plugins and other menus.
+
Menu themes allow the user to customize where certain myth features are located.  By creating a customized menu theme, users can tailor MythTV to there own usage.  The goal of this guide is to familiarize users with the menu's XML format and to create a comprehensive list of actions that will allow the user to invoke plugins and other menus.  This document assumes that mythtv is installed in the "/usr" directory.  If it is installed in the "/usr/local" directory, substitute everywhere that says "/usr/" with "/usr/local/".
  
 
==Overview==
 
==Overview==
  
 
Menu themes are a series of XML documents.  The XML document defines what "buttons" are shown on each menu.  Each XML document describes one menu.
 
Menu themes are a series of XML documents.  The XML document defines what "buttons" are shown on each menu.  Each XML document describes one menu.
 +
 +
==First Step==
 +
The first step is to create a directory to hold the menu's XML document.  If unsure, a good place is in the home folder.  The directory can be called anything that is not already a theme of any kind.  To find out what not to call the menu theme, use the following command in a terminal:
 +
 +
$ ls /usr/share/mythtv/themes
 +
 +
Type the following to create a directory for a menutheme in "~/mymenuthemes/mymenu".
 +
 +
$ cd ~
 +
$ mkdir mymenuthemes
 +
$ cd mymenuthemes
 +
$ mkdir mymenu
 +
$ cd mymenu
 +
 +
It is generally a good idea to sketch out how the new menu is to be laid out.  This will decrease the chance of error as well as speed up the development process.

Revision as of 00:02, 13 March 2006

Introduction

Menu themes allow the user to customize where certain myth features are located. By creating a customized menu theme, users can tailor MythTV to there own usage. The goal of this guide is to familiarize users with the menu's XML format and to create a comprehensive list of actions that will allow the user to invoke plugins and other menus. This document assumes that mythtv is installed in the "/usr" directory. If it is installed in the "/usr/local" directory, substitute everywhere that says "/usr/" with "/usr/local/".

Overview

Menu themes are a series of XML documents. The XML document defines what "buttons" are shown on each menu. Each XML document describes one menu.

First Step

The first step is to create a directory to hold the menu's XML document. If unsure, a good place is in the home folder. The directory can be called anything that is not already a theme of any kind. To find out what not to call the menu theme, use the following command in a terminal:

$ ls /usr/share/mythtv/themes

Type the following to create a directory for a menutheme in "~/mymenuthemes/mymenu".

$ cd ~
$ mkdir mymenuthemes
$ cd mymenuthemes
$ mkdir mymenu
$ cd mymenu

It is generally a good idea to sketch out how the new menu is to be laid out. This will decrease the chance of error as well as speed up the development process.