[% 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).  It is a Mandarin dictionary, and
	this application uses traditional characters (繁體字).

	</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="#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,
	Pinyin pronounciation, or traditional Chinese text.
	</p>
	<p>
	The layout of its interface is largely 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, or Chinese</li>
		<li>Filter results: "begins with", "ends with", "exact match",
			"partial match"
		</li>
		<li>Tone marks.  Example: <code>pin1 yin1</code> becomes
			<code>p&#299;n y&#299;n</code>.
		</li>
		<li>Convenient font resizing with a slider</li>
		<li>Easy modification of program behavior.  Just edit the Perl
			modules (<small><code>CocoaPerlCEDICTWindowController.pm</code>
			most commonly</small>) within the application bundle. No need
			to recompile.
			<br />
			An example of the type of change you might want to make is
			to modify the font styles/colours and the order the parts of
			each record (Chinese, Pinyin, and English) are displayed.
		</li>
	</ul>
	<p>
	This application is a testiment to the virtues of rapid development
	using CamelBones (and obviously CPAN).  It was thrown together in
	<b>under an hour!</b>
	</p>

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

	<a name="download"></a>
	<h3>download</h3>
	<p>
	<a href="code/CocoaPerlCEDICT.tgz">application</a>
	<br />
	<a href="code/CocoaPerlCEDICT-src.tgz">source</a>
	</p>

	<a name="requirements"></a>
	<h3>requirements</h3>
	<ul>
		<li>OS X 10.3</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><a href="http://search.cpan.org/~crenz/Lingua-ZH-CEDICT-0.03/">Lingua::ZH::CEDICT</a>
			<p>
			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 Lingua::ZH::CEDICT"</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 Lingua::ZH::CEDICT"</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="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 %]