Metadata-Version: 1.0
Name: falkolab.ext3.layer
Version: 1.0.1
Summary: Zope3 UI Layer, resource and viewlets bundles for ExtJS v3 JavaScript library.
Home-page: http://falkolab.ru/
Author: Andrey Tkachenko
Author-email: falko.lab@gmail.com
License: ZPL 2.1
Description: <p>Zope3 UI Layer, resource and viewlets bundles for ExtJS v3 JavaScript library</p>
        <div class="section" id="introduction">
        <h1>Introduction</h1>
        <p>Download ExtJS v3.x (<a class="reference external" href="http://extjs.com/products/extjs/download.php">http://extjs.com/products/extjs/download.php</a>)
        and put it in your operating system anywhere.
        For example for me it is the following path: /usr/lib/ext-3
        Within this folder must be located extracted ExtJS v3 framework distribution.</p>
        <p>Anywhere in you project register resource directory has named as <cite>ext-3</cite>.
        For example:</p>
        <pre class="literal-block">
        &lt;resourceDirectory
        layer=&quot;falkolab.ext3.layer.IExtJSLayer&quot;
        name=&quot;ext-3&quot;
        directory=&quot;/usr/lib/ext-3&quot;
        /&gt;
        </pre>
        <p>This package will looking for the resourceDirectory named <cite>ext-3</cite>,
        so it's important that you use the same <cite>name</cite> in the resourceDirectory statement.</p>
        </div>
        <div class="section" id="how-to-use">
        <h1>How to use?</h1>
        <p>This package provide two Viewlet Managers: IExtLayerCSS and IExtLayerJavaScript.
        You may use it in you project skin template. For example like this:</p>
        <pre class="literal-block">
        &lt;!DOCTYPE html PUBLIC &quot;-//W3C//DTD XHTML 1.0 Transitional//EN&quot;
        &quot;http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd&quot;&gt;
        &lt;html xmlns=&quot;http://www.w3.org/1999/xhtml&quot; xml:lang=&quot;en&quot; lang=&quot;en&quot;
        i18n:domain=&quot;mysite&quot;&gt;
        &lt;head&gt;
        ...
        &lt;meta http-equiv=&quot;Content-Type&quot; content=&quot;text/html;charset=utf-8&quot; /&gt;
        &lt;meta http-equiv=&quot;cache-control&quot; content=&quot;no-cache&quot; /&gt;
        &lt;meta http-equiv=&quot;pragma&quot; content=&quot;no-cache&quot; /&gt;
        &lt;tal:block replace=&quot;structure provider:IExtLayerCSS&quot; /&gt;
        &lt;tal:block replace=&quot;structure provider:IExtLayerJavaScript&quot; /&gt;
        &lt;/head&gt;
        &lt;body&gt;
        ...
        &lt;/body&gt;
        &lt;/html&gt;
        </pre>
        <p>Or derive/implement your own managers for falkolab.ext3.layer.IExtLayerCSS
        and falkolab.ext3.layer.IExtLayerJavaScript interfaces.</p>
        <p>NOTE: For necessary script including order, please use ordered manager:
        zope.viewlet.manager.WeightOrderedViewletManager</p>
        <p>This package contain several viewlet bunles for ExtJS. Use one of them according base
        library you use:</p>
        <table border="1" class="docutils">
        <colgroup>
        <col width="20%" />
        <col width="80%" />
        </colgroup>
        <tbody valign="top">
        <tr><td>ext-all.css</td>
        <td>All ExtJS library CSS styles.</td>
        </tr>
        <tr><td>ext-standalone</td>
        <td>ExtJS library with own adapter (without any external dependences).
        IExtStandaloneLayer and IExtStandaloneDebugLayer layers.</td>
        </tr>
        <tr><td>ext-jquery</td>
        <td>ExtJS library with jQuery adapter (WARNING: read note below).
        IExtJQueryLayer and IExtJQueryDebugLayer layers.</td>
        </tr>
        <tr><td>ext-yui</td>
        <td>ExtJS library with YUI adapter (WARNING: read note below).
        IExtYUILayer and IExtYUIDebugLayer layers.</td>
        </tr>
        <tr><td>ext-prototype</td>
        <td>ExtJS library with Prototype adapter (WARNING: read note below).
        IExtPrototypeLayer and  IExtPrototypeDebugLayer layers.</td>
        </tr>
        </tbody>
        </table>
        <p>NOTE: For bundles which dependet on external library jQuery, YUI or Prototype
        you must manualy register corresponding resources in your project and place it to
        your template before this package inclusions.
        Please see <a class="reference external" href="http://extjs.com/learn/Ext_Getting_Started#What_is_the_proper_include_order_for_my_JavaScript_files.3F">http://extjs.com/learn/Ext_Getting_Started#What_is_the_proper_include_order_for_my_JavaScript_files.3F</a>
        for details.</p>
        <p>Skin layer system example:</p>
        <pre class="literal-block">
        from z3c.layer.pagelet import IPageletBrowserLayer
        from zope.viewlet.interfaces import IViewletManager
        from zope.publisher.interfaces.browser import IBrowserRequest
        from falkolab.ext3.layer import  IExtJQueryLayer, IExtJQueryDebugLayer
        from falkolab.ext3.layer.interfaces import IExtLayerCSS, IExtLayerJavaScript
        
        class myskin(IExtJQueryLayer):
        &quot;&quot;&quot; layer for skin base components &quot;&quot;&quot;
        
        class IMySkin(myskin, IPageletBrowserLayer):
        &quot;&quot;&quot; IMySkin skin &quot;&quot;&quot;
        
        class IMyDebugSkin(IExtJQueryDebugLayer, IMySkin):
        &quot;&quot;&quot; IMySkin debug skin &quot;&quot;&quot;
        
        class ITitle(IViewletManager):
        &quot;&quot;&quot;Title viewlet manager.&quot;&quot;&quot;
        
        # This two interfaces for case when you use own Viewlet Managers
        # registration for combine site templete and falkolab.ext3.layer viewlets.
        class ICSS(IExtLayerCSS):
        &quot;&quot;&quot;CSS viewlet manager.&quot;&quot;&quot;
        
        class IJavaScript(IExtLayerJavaScript):
        &quot;&quot;&quot;JavaScript viewlet manager.&quot;&quot;&quot;
        </pre>
        </div>
        <div class="section" id="changes">
        <h1>CHANGES</h1>
        <div class="section" id="id1">
        <h2>1.0.1 (2009-09-30)</h2>
        <ul>
        <li><dl class="first docutils">
        <dt>bugfix: Replacement adapter script name for viewlets</dt>
        <dd><p class="first last">in compliance with debug version</p>
        </dd>
        </dl>
        </li>
        </ul>
        </div>
        <div class="section" id="a-2009-06-05">
        <h2>1.0.0a (2009-06-05)</h2>
        <ul class="simple">
        <li>Initial release.</li>
        </ul>
        </div>
        </div>
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: Zope3
Classifier: Environment :: Web Environment
Classifier: License :: OSI Approved :: Zope Public License
Classifier: Programming Language :: Python
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: User Interfaces
