RubyGems - zen - Versions diffs - 0.1a → 0.2 - Mend

zen 0.1a → 0.2

Files changed (414) hide show

@@ -1,909 +0,0 @@
-<!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" xml:lang="en" lang="en">
-  <head>
-    <meta name="Content-Type" content="text/html; charset=utf-8" />
-<title>Module: Zen::Package</title>
-<link rel="stylesheet" href="../css/style.css" type="text/css" media="screen" charset="utf-8" />
-<link rel="stylesheet" href="../css/common.css" type="text/css" media="screen" charset="utf-8" />
-<script type="text/javascript" charset="utf-8">
-  relpath = '..';
-  if (relpath != '') relpath += '/';
-</script>
-<script type="text/javascript" charset="utf-8" src="../js/jquery.js"></script>
-<script type="text/javascript" charset="utf-8" src="../js/app.js"></script>
-  </head>
-  <body>
-    <script type="text/javascript" charset="utf-8">
-      if (window.top.frames.main) document.body.className = 'frames';
-    </script>
-    <div id="header">
-      <div id="menu">
-    <a href="../_index.html">Index (P)</a> &raquo;
-    <span class='title'><span class='object_link'><a href="../Zen.html" title="Zen (module)">Zen</a></span></span>
-     &raquo;
-    <span class="title">Package</span>
-  <div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
-</div>
-      <div id="search">
-  <a id="class_list_link" href="#">Class List</a>
-  <a id="method_list_link" href="#">Method List</a>
-  <a id ="file_list_link" href="#">File List</a>
-</div>
-      <div class="clear"></div>
-    </div>
-    <iframe id="search_frame"></iframe>
-    <div id="content"><h1>Module: Zen::Package
-</h1>
-<dl class="box">
-    <dt class="r1 last">Defined in:</dt>
-    <dd class="r1 last">/Applications/MAMP/htdocs/ruby/zen/zen/lib/zen/base/package.rb</dd>
-</dl>
-<div class="clear"></div>
-<h2>Overview</h2><div class="docstring">
-  <div class="discussion">
-    <p>Module used for registering extensions and themes, setting their details and the whole shebang.
-Packages follow the same directory structure as Rubygems and can actually be installed
-using either Rubygems or by storing them in a custom directory. As long as you require
-the correct file you&#8217;re good to go.</p>
-<p>Packages are added or &#8220;described&#8221; using a simple block and the add() method as following:</p>
-<pre class="code"><span class='const'>Zen</span><span class='op'>::</span><span class='const'>Package</span><span class='period'>.</span><span class='id add'>add</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id ext'>ext</span><span class='op'>|</span>
-  <span class='comment'># ....
-</span><span class='kw'>end</span></pre>
-<p>When using this block you&#8217;re required to set the following attributes:</p>
-<ul>
-	<li>type: the type of package, can either be &#8220;theme&#8221; or &#8220;extension&#8221;</li>
-	<li>name: the name of the package</li>
-	<li>author: the name of the person who made the package</li>
-	<li>version: the current version, either a string or a numeric value</li>
-	<li>about: a small description of the package</li>
-	<li>url: the <span class="caps">URL</span> to the package&#8217;s website</li>
-	<li>identifier: unique identifier for the package. The format is com.<span class="caps">AUTHOR</span>.<span class="caps">NAME</span> for
-extensions and com.<span class="caps">AUTHOR</span>.themes.<span class="caps">NAME</span> for themes.</li>
-	<li>directory: the root directory of the package, set this using <i><span class="caps">DIR</span></i>(&#8216;path&#8217;)</li>
-</ul>
-<p>Optionally you can also specify the attribute &#8220;menu&#8221; (more on that later).</p>
-<h2>Menu Items</h2>
-<p>The package system easily allows modules to add navigation/sub-navigation elements
-to the backend menu. Each extension can have an attribute named &#8220;menu&#8221;, this attribute
-is an array of hashes. Each hash must have the following 2 keys (they&#8217;re symbols):</p>
-<ul>
-	<li>title: the value used for both the title tag and the text of the anchor element</li>
-	<li>url: the <span class="caps">URI</span> the navigation item will point to. Leading slash isn&#8217;t required</li>
-</ul>
-<p>Optionally you can specify child elements using the &#8220;children&#8221; key. This key
-will again contain an array of hashes just like regular navigation elements.
-For example, one could do the following:</p>
-<p><code>ext.menu = [{:title =&gt; "Dashboard", :url =&gt; "admin/dashboard"}]</code></p>
-<p>Adding a number of child elements isn&#8217;t very difficult either:</p>
-<pre class="code"><span class='id ext'>ext</span><span class='period'>.</span><span class='id menu'>menu</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='lbrace'>{</span>
-  <span class='symbol'>:title</span>    <span class='op'>=&gt;</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Dashboard</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='symbol'>:url</span> <span class='op'>=&gt;</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>admin/dashboard</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
-  <span class='symbol'>:children</span> <span class='op'>=&gt;</span> <span class='lbracket'>[</span><span class='lbrace'>{</span><span class='symbol'>:title</span> <span class='op'>=&gt;</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Child</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='symbol'>:url</span> <span class='op'>=&gt;</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>admin/dashboard/child</span><span class='tstring_end'>&quot;</span></span><span class='rbrace'>}</span><span class='rbracket'>]</span>
-<span class='rbrace'>}</span><span class='rbracket'>]</span></pre>
-<p>Once a certain number of navigation elements have been added you can generate the
-<span class="caps">HTML</span> for a fully fledged navigation menu using the build_menu() method. This method
-uses Gestalt to build the <span class="caps">HTML</span> and also takes care of permissions for each user/module.</p>
-<h2>Migrations</h2>
-<p>If your package uses it&#8217;s own database tables it&#8217;s best to use migrations as these make
-it very easy to install/uninstall the extension. Migrations should be put in the root
-directory of your extension. For example, if your extension is in &#8220;foobar&#8221; the migrations
-should be located in &#8220;foobar/migrations&#8221;, the lib directory in &#8220;foobar/lib&#8221;, etc.</p>
-<p>Migrations can be executed using the Rake task &#8220;extension:migrate&#8221; or &#8220;db:migrate&#8221;,
-the latter will install all extensions while the first one will only install the specified
-extension. Migration prototypes can be generated by the Rake task
-&#8220;proto:migration[<span class="caps">DIRECTORY</span>]&#8221; where <span class="caps">DIRECTORY</span> is the path to your migrations directory.</p>
-<h2>Themes</h2>
-<p>Themes are essentially packages like the sections or comments module except that they
-have a few limitations and work a bit different. First of all themes can&#8217;t add navigation
-items to the backend and second they should <em>always</em> have the following directories:</p>
-<ul>
-	<li>theme/lib/theme/templates</li>
-	<li>theme/lib/theme/public</li>
-</ul>
-<p>The templates directory is used to store all Liquid templates and template groups, the public
-directory is used for <span class="caps">CSS</span> files, images and so on. Themes can have migrations just
-like extensions which makes it relatively easy to share a theme with somebody else.</p>
-  </div>
-</div>
-<div class="tags">
-  <h3>Author:</h3>
-<ul class="author">
-    <li>
-        <div class='inline'><p>Yorick Peterse</p></div>
-    </li>
-</ul>
-<h3>Since:</h3>
-<ul class="since">
-    <li>
-        <div class='inline'><p>0.1</p></div>
-    </li>
-</ul>
-</div>
-  <h2>Class Attribute Summary <small>(<a href="#" class="summary_toggle">collapse</a>)</small></h2>
-  <ul class="summary">
-      <li class="public ">
-  <span class="summary_signature">
-      <a href="#classes-class_method" title="classes (class method)">+ (Object) <strong>classes</strong> </a>
-  </span>
-    <span class="summary_desc"><div class='inline'><p>Returns the value of attribute classes.</p></div></span>
-</li>
-      <li class="public ">
-  <span class="summary_signature">
-      <a href="#extensions-class_method" title="extensions (class method)">+ (Object) <strong>extensions</strong> </a>
-  </span>
-    <span class="note title readonly">readonly</span>
-    <span class="summary_desc"><div class='inline'><p>Returns the value of attribute extensions.</p></div></span>
-</li>
-      <li class="public ">
-  <span class="summary_signature">
-      <a href="#themes-class_method" title="themes (class method)">+ (Object) <strong>themes</strong> </a>
-  </span>
-    <span class="note title readonly">readonly</span>
-    <span class="summary_desc"><div class='inline'><p>Returns the value of attribute themes.</p></div></span>
-</li>
-  </ul>
-    <h2>
-      Class Method Summary
-      <small>(<a href="#" class="summary_toggle">collapse</a>)</small>
-    </h2>
-    <ul class="summary">
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#%5B%5D-class_method" title="[] (class method)">+ (Object) <strong>[]</strong>(ident) </a>
-  </span>
-    <span class="summary_desc"><div class='inline'><p>Shortcut method that can be used to retrieve an extension or theme based on the
-given extension identifier.</p></div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#add-class_method" title="add (class method)">+ (Object) <strong>add</strong>(&amp;block) {|package| ... }</a>
-  </span>
-    <span class="summary_desc"><div class='inline'><p>Adds a new package along with all it&#8217;s details such as the name,
-author, version and so on.</p></div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#build_menu-class_method" title="build_menu (class method)">+ (Object) <strong>build_menu</strong>(css_class = ''
-) </a>
-  </span>
-    <span class="summary_desc"><div class='inline'><p>Builds a navigation menu for all installed extensions.</p></div></span>
-</li>
-    </ul>
-  <div id="class_attr_details" class="attr_details">
-    <h2>Class Attribute Details</h2>
-      <span id="classes=-class_method"></span>
-      <span id="classes-class_method"></span>
-      <div class="method_details first">
-  <p class="signature first" id="classes-class_method">
-    + (<tt>Object</tt>) <strong>classes</strong>
-</p><div class="docstring">
-  <div class="discussion">
-    <p>Returns the value of attribute classes</p>
-  </div>
-</div>
-<div class="tags">
-  <h3>Since:</h3>
-<ul class="since">
-    <li>
-        <div class='inline'><p>0.1</p></div>
-    </li>
-</ul>
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-88
-89
-90</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File '/Applications/MAMP/htdocs/ruby/zen/zen/lib/zen/base/package.rb', line 88</span>
-<span class='kw'>def</span> <span class='id classes'>classes</span>
-  <span class='ivar'>@classes</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-      <span id=""></span>
-      <span id="extensions-class_method"></span>
-      <div class="method_details ">
-  <p class="signature " id="extensions-class_method">
-    + (<tt>Object</tt>) <strong>extensions</strong>  <span class="extras">(readonly)</span>
-</p><div class="docstring">
-  <div class="discussion">
-    <p>Returns the value of attribute extensions</p>
-  </div>
-</div>
-<div class="tags">
-  <h3>Since:</h3>
-<ul class="since">
-    <li>
-        <div class='inline'><p>0.1</p></div>
-    </li>
-</ul>
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-86
-87
-88</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File '/Applications/MAMP/htdocs/ruby/zen/zen/lib/zen/base/package.rb', line 86</span>
-<span class='kw'>def</span> <span class='id extensions'>extensions</span>
-  <span class='ivar'>@extensions</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-      <span id=""></span>
-      <span id="themes-class_method"></span>
-      <div class="method_details ">
-  <p class="signature " id="themes-class_method">
-    + (<tt>Object</tt>) <strong>themes</strong>  <span class="extras">(readonly)</span>
-</p><div class="docstring">
-  <div class="discussion">
-    <p>Returns the value of attribute themes</p>
-  </div>
-</div>
-<div class="tags">
-  <h3>Since:</h3>
-<ul class="since">
-    <li>
-        <div class='inline'><p>0.1</p></div>
-    </li>
-</ul>
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-87
-88
-89</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File '/Applications/MAMP/htdocs/ruby/zen/zen/lib/zen/base/package.rb', line 87</span>
-<span class='kw'>def</span> <span class='id themes'>themes</span>
-  <span class='ivar'>@themes</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-  </div>
-  <div id="class_method_details" class="method_details_list">
-    <h2>Class Method Details</h2>
-      <div class="method_details first">
-  <p class="signature first" id="[]-class_method">
-    + (<tt>Object</tt>) <strong>[]</strong>(ident)
-</p><div class="docstring">
-  <div class="discussion">
-    <p>Shortcut method that can be used to retrieve an extension or theme based on the
-given extension identifier.</p>
-  </div>
-</div>
-<div class="tags">
-  <h3>Parameters:</h3>
-<ul class="param">
-    <li>
-        <span class='type'>(<tt>String</tt>)</span>
-        <span class='name'>ident</span>
-        &mdash;
-        <div class='inline'><p>The package&#8217;s identifier</p></div>
-    </li>
-</ul>
-<h3>Returns:</h3>
-<ul class="return">
-    <li>
-        <span class='type'>(<tt>Object</tt>)</span>
-    </li>
-</ul>
-<h3>Author:</h3>
-<ul class="author">
-    <li>
-        <div class='inline'><p>Yorick Peterse</p></div>
-    </li>
-</ul>
-<h3>Since:</h3>
-<ul class="since">
-    <li>
-        <div class='inline'><p>0.1</p></div>
-    </li>
-</ul>
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-155
-156
-157
-158
-159
-160
-161</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File '/Applications/MAMP/htdocs/ruby/zen/zen/lib/zen/base/package.rb', line 155</span>
-<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='op'>[]</span><span class='lparen'>(</span><span class='id ident'>ident</span><span class='rparen'>)</span>
-  <span class='kw'>if</span> <span class='id ident'>ident</span><span class='period'>.</span><span class='id include?'>include?</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>.themes.</span><span class='tstring_end'>'</span></span><span class='rparen'>)</span>
-    <span class='ivar'>@themes</span><span class='lbracket'>[</span><span class='id ident'>ident</span><span class='rbracket'>]</span>
-  <span class='kw'>else</span>
-    <span class='ivar'>@extensions</span><span class='lbracket'>[</span><span class='id ident'>ident</span><span class='rbracket'>]</span>
-  <span class='kw'>end</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-      <div class="method_details ">
-  <p class="signature " id="add-class_method">
-    + (<tt>Object</tt>) <strong>add</strong>(&amp;block) {|package| ... }
-</p><div class="docstring">
-  <div class="discussion">
-    <p>Adds a new package along with all it&#8217;s details such as the name,
-author, version and so on. Extensions can be added using a simple
-block as following:</p>
-Zen::Package.add do |ext|
-ext.name   = &#8220;Name&#8221;
-ext.author = &#8220;Author&#8221;
-end
-<p>When adding a new extension the following setters are required:</p>
-<ul>
-	<li>type</li>
-	<li>name</li>
-	<li>author</li>
-	<li>version</li>
-	<li>about</li>
-	<li>url</li>
-	<li>identifier</li>
-	<li>directory</li>
-</ul>
-  </div>
-</div>
-<div class="tags">
-  <h3>Parameters:</h3>
-<ul class="param">
-    <li>
-        <span class='type'>(<tt>Block</tt>)</span>
-        <span class='name'>block</span>
-        &mdash;
-        <div class='inline'><p>Block containing information about the extension.</p></div>
-    </li>
-</ul>
-<h3>Yields:</h3>
-<ul class="yield">
-    <li>
-        <span class='type'>(<tt>package</tt>)</span>
-    </li>
-</ul>
-<h3>Author:</h3>
-<ul class="author">
-    <li>
-        <div class='inline'><p>Yorick Peterse</p></div>
-    </li>
-</ul>
-<h3>Since:</h3>
-<ul class="since">
-    <li>
-        <div class='inline'><p>0.1</p></div>
-    </li>
-</ul>
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-116
-117
-118
-119
-120
-121
-122
-123
-124
-125
-126
-127
-128
-129
-130
-131
-132
-133
-134
-135
-136
-137
-138
-139
-140
-141
-142
-143
-144
-145</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File '/Applications/MAMP/htdocs/ruby/zen/zen/lib/zen/base/package.rb', line 116</span>
-<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id add'>add</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='id block'>block</span><span class='rparen'>)</span>
-  <span class='id package'>package</span>  <span class='op'>=</span> <span class='const'>Struct</span><span class='period'>.</span><span class='id new'>new</span><span class='lparen'>(</span><span class='symbol'>:type</span><span class='comma'>,</span> <span class='symbol'>:name</span><span class='comma'>,</span> <span class='symbol'>:author</span><span class='comma'>,</span> <span class='symbol'>:version</span><span class='comma'>,</span> <span class='symbol'>:about</span><span class='comma'>,</span> <span class='symbol'>:url</span><span class='comma'>,</span>
-    <span class='symbol'>:identifier</span><span class='comma'>,</span> <span class='symbol'>:directory</span><span class='comma'>,</span> <span class='symbol'>:menu</span><span class='rparen'>)</span><span class='period'>.</span><span class='id new'>new</span>
-  <span class='id required'>required</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='symbol'>:type</span><span class='comma'>,</span> <span class='symbol'>:name</span><span class='comma'>,</span> <span class='symbol'>:author</span><span class='comma'>,</span> <span class='symbol'>:version</span><span class='comma'>,</span> <span class='symbol'>:about</span><span class='comma'>,</span> <span class='symbol'>:url</span><span class='comma'>,</span> <span class='symbol'>:identifier</span><span class='comma'>,</span> <span class='symbol'>:directory</span><span class='rbracket'>]</span>
-  <span class='kw'>yield</span> <span class='id package'>package</span>
-  <span class='id required'>required</span><span class='period'>.</span><span class='id each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id m'>m</span><span class='op'>|</span>
-    <span class='kw'>if</span> <span class='op'>!</span><span class='id package'>package</span><span class='period'>.</span><span class='id respond_to?'>respond_to?</span><span class='lparen'>(</span><span class='id m'>m</span><span class='rparen'>)</span> <span class='kw'>or</span> <span class='id package'>package</span><span class='period'>.</span><span class='id send'>send</span><span class='lparen'>(</span><span class='id m'>m</span><span class='rparen'>)</span><span class='period'>.</span><span class='id nil?'>nil?</span>
-      <span class='id raise'>raise</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>A loaded package has no value set for the setter \&quot;</span><span class='embexpr_beg'>#{</span><span class='id m'>m</span><span class='rbrace'>}</span><span class='tstring_content'>\&quot;</span><span class='tstring_end'>&quot;</span></span>
-    <span class='kw'>end</span>
-  <span class='kw'>end</span>
-  <span class='comment'># Update the root but prevent duplicates
-</span>  <span class='kw'>if</span> <span class='op'>!</span><span class='const'>Ramaze</span><span class='period'>.</span><span class='id options'>options</span><span class='period'>.</span><span class='id roots'>roots</span><span class='period'>.</span><span class='id include?'>include?</span><span class='lparen'>(</span><span class='id package'>package</span><span class='period'>.</span><span class='id directory'>directory</span><span class='rparen'>)</span>
-    <span class='const'>Ramaze</span><span class='period'>.</span><span class='id options'>options</span><span class='period'>.</span><span class='id roots'>roots</span><span class='period'>.</span><span class='id push'>push</span><span class='lparen'>(</span><span class='id package'>package</span><span class='period'>.</span><span class='id directory'>directory</span><span class='rparen'>)</span>
-  <span class='kw'>end</span>
-  <span class='comment'># Themes and extensions each have a different accessor
-</span>  <span class='kw'>if</span> <span class='id package'>package</span><span class='period'>.</span><span class='id type'>type</span><span class='period'>.</span><span class='id to_s'>to_s</span> <span class='op'>==</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>theme</span><span class='tstring_end'>'</span></span>
-    <span class='comment'># Remove the navigation menu
-</span>    <span class='id package'>package</span><span class='period'>.</span><span class='id menu'>menu</span> <span class='op'>=</span> <span class='kw'>nil</span> <span class='kw'>if</span> <span class='op'>!</span><span class='id package'>package</span><span class='period'>.</span><span class='id menu'>menu</span><span class='period'>.</span><span class='id nil?'>nil?</span>
-    <span class='ivar'>@themes</span>                          <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span> <span class='kw'>if</span> <span class='ivar'>@themes</span><span class='period'>.</span><span class='id nil?'>nil?</span>
-    <span class='ivar'>@themes</span><span class='lbracket'>[</span><span class='id package'>package</span><span class='period'>.</span><span class='id identifier'>identifier</span><span class='period'>.</span><span class='id to_s'>to_s</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='id package'>package</span>
-  <span class='kw'>else</span>
-    <span class='ivar'>@extensions</span>                          <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span> <span class='kw'>if</span> <span class='ivar'>@extensions</span><span class='period'>.</span><span class='id nil?'>nil?</span>
-    <span class='ivar'>@extensions</span><span class='lbracket'>[</span><span class='id package'>package</span><span class='period'>.</span><span class='id identifier'>identifier</span><span class='period'>.</span><span class='id to_s'>to_s</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='id package'>package</span>
-  <span class='kw'>end</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-      <div class="method_details ">
-  <p class="signature " id="build_menu-class_method">
-    + (<tt>Object</tt>) <strong>build_menu</strong>(css_class = ''
-)
-</p><div class="docstring">
-  <div class="discussion">
-    <p>Builds a navigation menu for all installed extensions.
-Extensions can have an infinite amount of sub-navigation
-items. This method will generate an unordered list of items
-of which each list item can contain N sub items.</p>
-<p>main UL element.</p>
-  </div>
-</div>
-<div class="tags">
-  <h3>Parameters:</h3>
-<ul class="param">
-    <li>
-        <span class='type'>(<tt>String</tt>)</span>
-        <span class='name'>css_class</span>
-        <em class="default">(defaults to: <tt>''
-</tt>)</em>
-        &mdash;
-        <div class='inline'><p>A string of <span class="caps">CSS</span> classes to apply to the</p></div>
-    </li>
-</ul>
-<h3>Author:</h3>
-<ul class="author">
-    <li>
-        <div class='inline'><p>Yorick Peterse</p></div>
-    </li>
-</ul>
-<h3>Since:</h3>
-<ul class="since">
-    <li>
-        <div class='inline'><p>0.1</p></div>
-    </li>
-</ul>
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-174
-175
-176
-177
-178
-179
-180
-181
-182
-183
-184
-185
-186
-187
-188
-189
-190
-191
-192
-193
-194
-195
-196
-197
-198
-199
-200</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File '/Applications/MAMP/htdocs/ruby/zen/zen/lib/zen/base/package.rb', line 174</span>
-<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id build_menu'>build_menu</span> <span class='id css_class'>css_class</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_end'>'</span></span>
-  <span class='ivar'>@g</span>         <span class='op'>=</span> <span class='const'>Ramaze</span><span class='op'>::</span><span class='const'>Gestalt</span><span class='period'>.</span><span class='id new'>new</span>
-  <span class='id menu_items'>menu_items</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='rbracket'>]</span>
-  <span class='ivar'>@extensions</span><span class='period'>.</span><span class='id each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id ident'>ident</span><span class='comma'>,</span> <span class='id ext'>ext</span><span class='op'>|</span>
-    <span class='kw'>if</span> <span class='op'>!</span><span class='id ext'>ext</span><span class='period'>.</span><span class='id menu'>menu</span><span class='period'>.</span><span class='id nil?'>nil?</span>
-      <span class='id ext'>ext</span><span class='period'>.</span><span class='id menu'>menu</span><span class='period'>.</span><span class='id each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id m'>m</span><span class='op'>|</span>
-        <span class='id menu_items'>menu_items</span><span class='period'>.</span><span class='id push'>push</span><span class='lparen'>(</span><span class='id m'>m</span><span class='rparen'>)</span>
-      <span class='kw'>end</span>
-    <span class='kw'>end</span>
-  <span class='kw'>end</span>
-  <span class='comment'># Sort the menu alphabetical
-</span>  <span class='id menu_items'>menu_items</span> <span class='op'>=</span> <span class='id menu_items'>menu_items</span><span class='period'>.</span><span class='id sort_by'>sort_by</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id item'>item</span><span class='op'>|</span>
-    <span class='id item'>item</span><span class='lbracket'>[</span><span class='symbol'>:title</span><span class='rbracket'>]</span>
-  <span class='kw'>end</span>
-  <span class='ivar'>@g</span><span class='period'>.</span><span class='id ul'>ul</span> <span class='symbol'>:class</span> <span class='op'>=&gt;</span> <span class='id css_class'>css_class</span> <span class='kw'>do</span>
-    <span class='kw'>if</span> <span class='op'>!</span><span class='id menu_items'>menu_items</span><span class='period'>.</span><span class='id empty?'>empty?</span>
-      <span class='id menu_items'>menu_items</span><span class='period'>.</span><span class='id each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id m'>m</span><span class='op'>|</span>
-        <span class='kw'>self</span><span class='period'>.</span><span class='id nav_list'>nav_list</span><span class='lparen'>(</span><span class='id m'>m</span><span class='rparen'>)</span>
-      <span class='kw'>end</span>
-    <span class='kw'>end</span>
-  <span class='kw'>end</span>
-  <span class='kw'>return</span> <span class='ivar'>@g</span><span class='period'>.</span><span class='id to_s'>to_s</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-  </div>
-</div>
-    <div id="footer">
-  Generated on Sun Feb  6 21:24:00 2011 by
-  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.6.4 (ruby-1.9.2).
-</div>
-  </body>
-</html>