[% INCLUDE full_header.tmpl title="Cocoa/Perl CEDICT interface - sporkstorms.org" %]
<div class="padded">
	<h2>Cocoa/Perl CEDICT interface</h2>
	<p>
	<code>CocoaPerlCEDICT</code> is an OS X Cocoa interface to the
	CEDICT Chinese English Dictionary (Mandarin/Putonghua).
	</p>
	<p>
	This is the shiny new version.  If for whatever reason you want the old
	interface to <code>Lingua::ZH::CEDICT</code>, go to
	<a href="ss_cedict1.html">the old CocoaPerlCEDICT</a> page.
	</p>
</div>
[% INCLUDE toprow_footer.tmpl %]
[% WRAPPER firstcol.tmpl %]
	[% INCLUDE navbox.tmpl %]
[% END %]
[% WRAPPER secondcol.tmpl %]
	<ul>
		<li><a href="#about">about</a></li>
		<li><a href="#screenshot">screenshot</a></li>
		<li><a href="#download">download</a></li>
		<li><a href="#requirements">requirements</a></li>
		<li><a href="#credits">additional thanks and credits</a></li>
		<li><a href="#license">license and copyright</a></li>
	</ul>

	<a name="about"></a>
	<h3>about</h3>
	<p>
	<code>CocoaPerlCEDICT</code> provides an interface to a Chinese-English
	dictionary.  It supports looking up words by their English definition,
	traditional Chinese text, simplified Chinese text,
	and Pinyin pronounciation <small>(optionally filtering only those with
	an exact tone match)</small>.
	</p>
	<p>
	The layout of its interface is partly based on that of
	<a href="http://sourceforge.net/projects/oridict/">OriDict</a>, 
	and the application icon from it is used.
	</p>
	<p>notable features:</p>
	<ul>
		<li>Search by English, Pinyin, Pinyin with tone, traditional
			Chinese, and simplified Chinese</li>
		<li>Filter results: "begins with", "ends with", "exact match",
			"partial match"
		</li>
		<li>Optionally show tone marks instead of digits.  Example:
			<code>pin1 yin1</code> becomes <code>p&#299;n y&#299;n</code>
		</li>
		<li>Separate font faces and sizes for Chinese and Roman (English,
			Pinyin)
		</li>
		<li>Convenient font resizing with sliders on the main window</li>
		<li>Easy modification of program behavior.  Just edit the Perl
			modules within the application bundle. No need
			to recompile.
		</li>
		<li>Resize and rearrange the columns. The application remembers
			these settings and restores them each time you run it</li>
		<li>Control-click an entry to bring up a copy menu. This allows
			you to quickly and easily copy any part of the definition, or
			the entire definition, to the system's pasteboard.
			<br />
			The first item in the menu is always the section of the
			definition you clicked on.
		</li>
	</ul>
	<p>
	This application is a testiment to the virtues of rapid development
	using CamelBones.  The original version was thrown together in
	<b>under an hour!</b>   This new version (with many more features)
	took an additional few hours, which is still quite impressive when
	compared to how long this application would take to write in Objective
	C.
	</p>

	<a name="screenshot"></a>
	<h3>screenshot</h3>
	<div style="text-align:center">
		<img src="uploads/cedict2.jpg" alt="CocoaPerlCEDICT" />
	</div>

	<a name="download"></a>
	<h3>download</h3>
	<p>
	<a href="code/CocoaPerlCEDICT-2.0.tgz">application</a>
	<small>(0.98 MB - contains the dictionary data)</small>
	<br />
	<a href="code/CocoaPerlCEDICT-src-2.0.tgz">source</a>
	<small>(1.9 MB - contains the dictionary data)</small>
	</p>

	<a name="requirements"></a>
	<h3>requirements</h3>
	<ul>
		<li>OS X 10.3.
		<p>
		If you want to run this program on an earlier version
		of OS X and are willing to put a little work into it, let me know
		and I'll be glad to help you get it running.  I don't have a
		10.2 or 10.1 installation to work with, so I will need your
		assistance to test it.
		</p>
		</li>
		<li><a href="http://camelbones.sourceforge.net/index.php">Camelbones</a>
			<p>
			If you just want to run CamelBones apps,
			<a href="http://camelbones.sourceforge.net/download/runtime-install.php">install the runtime</a> framework.
			<br />
			In order to write your own Cocoa/Perl applications,
			<a href="http://camelbones.sourceforge.net/download/dev-install.php">install the developer package</a>.
			</p>
		</li>
		<li><code>Storable.pm</code> Perl module
			<p>You should already have this module installed on your
			system.</p>
			<p>
			If the program does not work, it may not be.
			An easy way to determine whether it's installed is 
			to bring up the Terminal
			program and type<br />
			<code>perl&nbsp;-MStorable&nbsp;-e&nbsp;"1"</code>
			<br />
			If no errors are spit out, you're fine.
			</p>
			<p>
			If you find that you do not have the module installed, you'll
			need to install it manually.
			Here's a quick overview in case you've never installed Perl
			modules before. This may seem rather troublesome.
			</p>
			<ul>
				<li>You will probably need your <code>root</code> account
					enabled.
					<a href="http://docs.info.apple.com/article.html?artnum=106290">Here's how.</a>
				</li>
				<li>Open a terminal (<code>Terminal</code> in your
					<code>Applications -&gt; Utilities</code> folder).
				</li>
				<li>Type <code>sudo perl -MCPAN -e "install Storable"</code>.
					It will ask for a password.  If it said something like
					"sorry try again", "you aren't authorized..." or
					anything to that effect, continue reading. Otherwise
					skip to the next step.
					<br />
					Try typing <code>su</code>, then enter the password.
					if it didn't spit out any errors, type <code>
						perl -MCPAN -e "install Storable"</code>.
				</li>
				<li>Answer any questions the CPAN installation gives you.
					Let it install any dependencies that are required.
				</li>
				<li>All done.</li>
			</ul>
		</li>
	</ul>

	<a name="credits"></a>
	<h3>additional thanks and credits</h3>
	<p>
	This heart of this application uses the
	<a href="http://camelbones.sourceforge.net">Camel Bones</a>
	framework.  Camel Bones allows you to use Cocoa with Perl, and is
	absolutely wonderful for quickly writing GUI applications.  It's written
	by Sherm Pendley and released as <a href="http://www.gnu.org/philosophy/free-sw.html">free software</a> (under the <a href="http://www.gnu.org/licenses/licenses.html#LGPL">LGPL</a>).
	</p>
	<p>
	The CEDICT is a Chinese/English dictionary project started by Paul
	Denisowski.  More information and the original dictionary files
	<a href="http://www.mandarintools.com/cedict.html">can be found here</a>.
	</p>
	<p>
	<code>CocoaPerlCEDICT</code> uses a class called
	<code>RowResizableTableView</code> written by Evan Jones.  It allows
	variable row heights within an <code>NSTableView</code> (he's also
	written a similar class for <code>NSOutlineView</code>s)
	<br />
	<a href="http://evanjones.ca/software/osx-tableview.html">Check it out
	here</a>
	</p>
	<p>
	The application icon is from <a href="http://sourceforge.net/projects/oridict/">OriDict</a>
	</p>
	<p>
	The essence of, and lookup table for the
	<code>MyCEDICT::Definition::pinyin_utf8()</code> method is from
	the <code>Lingua::ZH::CEDICT</code> Perl module.
	</p>

	<a name="license"></a>
	<h3>License and Copyright</h3>
	<p>
		CocoaPerlCEDICT is Copyright &copy; 2004, Mark A. Stratman &lt;<a href="mailto:mark[AT]sporkstorms[DOT]org">mark&#064;sporkstorms&#046;org</a>&gt;
	</p>
	<p>
		It is licensed under the <a href="http://www.gnu.org/copyleft/gpl.html">GNU General Public License</a>.
		<br />
		You can redistribute it and/or modify it under the terms of the
		GNU General Public License as published by the Free Software
		Foundation; either version 2 of the License, or (at your option)
		any later version.
	</p>
	<p>
		This program is distributed in the hope that it will be useful,
		but WITHOUT ANY WARRANTY; without even the implied warranty of
		MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
		GNU General Public License for more details.
	</p>

[% END %]

[% INCLUDE footer.tmpl %]