<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<title>edelib: Theme layout and search locations</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">edelib
 <span id="projectnumber">2.0.0</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- Generated by Doxygen 1.7.6.1 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li class="current"><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li><a href="annotated.html"><span>Classes</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="themedoc.html">Themes and theming details</a> </li>
</ul>
</div>
</div>
<div class="header">
<div class="headertitle">
<div class="title">Theme layout and search locations </div> </div>
</div><!--header-->
<div class="contents">
<div class="textblock"><h2><a class="anchor" id="themelayout_layout"></a>
Theme layout</h2>
<p>Theme is directory with a bunch of <em>Theme files</em> and files used by theme, like images or sound files. Knowing this, you can conclude how theme name is a name of this directory and when Theme engine start to look for named theme, it will try to find a directory with this name.</p>
<p>For example, here is an example layout for a <em>Foo</em> theme: </p>
<div class="fragment"><pre class="fragment">Foo/
main.ewt
application1.ewt
application2.ewt
sounds/
on-click.ogg
window-close.ogg
window-hide.ogg
images/
img1.png
img2.png
</pre></div><p>Here, <em>main.ewt</em> will include (via <em>(include)</em> directive) <em>application1.ewt</em> and <em>application2.ewt</em> files, like: </p>
<div class="fragment"><pre class="fragment">;; main.ewt
;; theme information
(theme.name <span class="stringliteral">"Foo"</span>)
(theme.author <span class="stringliteral">"John Foo <john@foo.com>"</span>)
(theme.sample <span class="stringliteral">"img.jpg"</span>)
;; styles
(theme.style <span class="stringliteral">"ede"</span> [
background_color <span class="stringliteral">"#ffffff"</span>
background_color2 <span class="stringliteral">"#043456"</span>
icon_theme <span class="stringliteral">"edeneu"</span>
])
;; include the rest
(include <span class="stringliteral">"application1.ewt"</span>)
(include <span class="stringliteral">"application2.ewt"</span>)
</pre></div><p>Or, <em>main.ewt</em> does not have to have any style code; it can only serve as loader for a bunch of styles separated in a special file. Combinations are limitless.</p>
<h2><a class="anchor" id="themedefault"></a>
Default theme and default locations</h2>
<p>Default theme that will be loaded is <em>default</em>. This name can be either a directory or symbolic link to desired theme. Knowing this, changing theme is simply creating symbolic link on target theme.</p>
<p>Themes will be searched in <em>$XDG_DATA_DIRS/themes</em> directories. If Theme class has a prefix (default is "ede"), themes will be searched in <em>$XDG_DATA_DIRS/themes/prefix</em>. </p>
</div></div><!-- contents -->
<hr class="footer"/><address class="footer"><small>
Generated on Tue Jun 5 2012 17:49:02 for edelib by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.7.6.1
</small></address>
</body>
</html>
