[Checkins] SVN: grok/www/ Searching tutorial added with a link from
index.html
Darryl Cousins
darryl at darrylcousins.net.nz
Tue Jul 3 17:15:18 EDT 2007
Log message for revision 77381:
Searching tutorial added with a link from index.html
Changed:
U grok/www/index.html
A grok/www/searching.html
-=-
Modified: grok/www/index.html
===================================================================
--- grok/www/index.html 2007-07-03 19:56:05 UTC (rev 77380)
+++ grok/www/index.html 2007-07-03 21:15:18 UTC (rev 77381)
@@ -110,6 +110,12 @@
</pre>
</div>
<div class="section">
+<h2><a id="me-grok-mini-tutorials" name="me-grok-mini-tutorials">ME GROK MINI-TUTORIALS</a></h2>
+<ul class="simple">
+<li><a class="reference" href="searching.html">Newbie Search Tutorial</a></li>
+</ul>
+</div>
+<div class="section">
<h2><a id="me-grok-sprints-and-blogs" name="me-grok-sprints-and-blogs">ME GROK SPRINTS AND BLOGS!</a></h2>
<p>Grok development is often done in the form of sprints. A sprint is a when a
group of developers get together in the same place and all work on a focused
Added: grok/www/searching.html
===================================================================
--- grok/www/searching.html (rev 0)
+++ grok/www/searching.html 2007-07-03 21:15:18 UTC (rev 77381)
@@ -0,0 +1,171 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+ <title>Newbie Search Tutorial</title><meta name="description" content="Grok - now even cavemen can use Zope3" />
+ <meta name="keywords" content="Grok, internet, zope, zope3, software, web apps, web applications, python" />
+ <style type="text/css"><!-- @import url(./resources/grok.css); --></style>
+</head>
+
+<body>
+<div class="header">
+
+ <a href="http://grok.zope.org">
+ <img src="./resources/grok-header.jpg" alt="GROK" /></a>
+ <ul id="navigation">
+ <li>
+ <a href="/index.html" class="" title="Home">Home</a></li>
+ <li>
+ <a href="/about.html" class="" title="About">About</a></li>
+ <li>
+ <a href="/tutorial.html" class=""
+ title="Tutorial">Tutorial</a></li>
+ </ul>
+</div>
+
+
+<div class="roundcont">
+
+ <div class="roundtop">
+ <img src="./resources/corner-topleft.jpg" alt="" width="45" height="45" class="corner" style="display: none" />
+ </div>
+
+ <div class="content">
+
+ <h1 class="title">Newbie Search Tutorial</h1>
+<div class="section">
+<h2><a id="introduction" name="introduction">Introduction</a></h2>
+<p>Grok supports the vanilla indexing services available in Zope 3 straight out of the box. Catalog uses developer defined indexes for searching. In other words, you have to define the indexes you want to use to search you objects before you perform the actual search.</p>
+<ul class="simple">
+<li>FieldIndex: search matching an entire field</li>
+<li>SetIndex: search for keywords in a field</li>
+<li>TextIndex: full-text searching</li>
+<li>ValueSearch: search for values using ranges</li>
+</ul>
+<p>The time for Zope to generate a new index is proportional to the amount of objects that need to be analysed.</p>
+</div>
+<div class="section">
+<h2><a id="setup" name="setup">Setup</a></h2>
+<p>The egg (package) containing the search functionality is called [zc.catalog-x.x.x-py2.x.egg] and is installed when "buildout.cfg" contains "zope.app.catalog" in the list of the directive "zcml=". This is the default configuration.</p>
+<p>Some applications might require specific versions of catalog. This is specified in the "setup.py" script. The following directive indicates that zc.catalog version 1.1.1 is required.</p>
+<pre class="literal-block">
+install_requires=['setuptools',
+ 'grok',
+ 'zc.catalog==1.1.1',
+ 'hurry.query',
+ 'hurry.workflow',
+ ],
+</pre>
+<p>The "hurry.query" package gives you some simple tools to perform advanced searching. (add "hurry.query" to "zcml=" in "buildout.cfg")</p>
+</div>
+<div class="section">
+<h2><a id="example" name="example">Example</a></h2>
+<pre class="literal-block">
+# interfaces.py
+class IProtonObject(Interface):
+ """
+ This is an interface to the class who's objects I want to index.
+ """
+ body = schema.Text(title=u'Body', required=False)
+</pre>
+<pre class="literal-block">
+# protonobject.py
+class ProtonObject(grok.Model):
+ """
+ This is the actual class.
+ """
+ interface.implements(interfaces.IProtonObject)
+
+ def __init__(self, body):
+ self.body = body
+</pre>
+<pre class="literal-block">
+# app.py
+from hurry.query.query import Query, Text
+# hurry.query is a simplified search query language that
+# allows you to create ANDs and ORs.
+
+class ContentIndexes(grok.Indexes):
+ """
+ This is where I setup my indexes. I have two indexes;
+ one full-text index called "text_body",
+ one field index called "body".
+ """
+ grok.site(ProtonCMS)
+
+ grok.context(interfaces.IProtonObject)
+ # grok.context() tells Grok that objects implementing
+ # the interface IProtonObject should be indexed.
+
+ grok.name('proton_catalog')
+ # grok.name() tells Grok what to call the catalog.
+ # if you have named the catalog anything but "catalog"
+ # you need to specify the name of the catalog in your
+ # queries.
+
+ text_body = index.Text(attribute='body')
+ body = index.Field(attribute='body')
+ # The attribute='body' parameter is actually unnecessary if the attribute to
+ # be indexed has the same name as the index.
+
+class Index(grok.View):
+ grok.context(ProtonCMS)
+
+ def search_content(self, search_query):
+ # The following query does a search on the field index "body".
+ # It will return a list of object where the entire content of the body attribute
+ # matches the search term exactly. I.e. search_query == body
+ result_a = Query().searchResults(
+ query.Eq(('proton_catalog', 'body'), search_query)
+ )
+
+ # The following query does a search on the full-text index "text_body".
+ # It will return objects that match the search_query. You can use wildcards and
+ # boolean operators.
+ #
+ # Examples:
+ # "grok AND zope" returns objects where "body" contains the words "grok" and "zope"
+ # "grok or dev*" returns objects where "body" contains the word "grok" or any word
+ # beginning with "dev"
+ result_b = Query().searchResults(
+ Text( ('proton_catalog', 'text_body'), search_query)
+ )
+
+ return result_a, result_b
+</pre>
+</div>
+<div class="section">
+<h2><a id="note" name="note">Note</a></h2>
+<p>In the above example, the indexes are only added when a new application is installed. You will have to manually create new indexes if you wish to add them to an existing application.</p>
+</div>
+<div class="section">
+<h2><a id="learning-more" name="learning-more">Learning More</a></h2>
+<p>The "hurry.query" package contains the DocTest "query.txt" that shows how to perform more complex search queries.</p>
+</div>
+
+ </div>
+
+ <div class="roundbottom">
+ <img src="./resources/corner-bottomleft.jpg" alt="" width="45" height="45" class="corner" style="display: none" />
+ </div>
+
+</div>
+
+<div class="footer">
+
+ <table><tr><td>
+ Grok cooks around the campfire of <br />
+ <a href="http://wiki.zope.org/zope3/FrontPage"><img src="./resources/zopelogo.gif" alt="Zope" style="padding: 0.5em;" /></a>
+ </td><td>
+ and roams free on the savannah of<br />
+ <a href="http://www.python.org"><img src="./resources/python-logo.gif" style="padding: 0.5em;" alt="Python" /></a>
+ </td></tr>
+ </table>
+
+ <p>Hosting provided by <a href="http://quintagroup.com/"><b>Quintagroup</b></a></p>
+</div>
+
+</body>
+</html>
More information about the Checkins
mailing list