website/koha.html in zcc-0.1.0 vs website/koha.html in zcc-0.2.0
- old
+ new
@@ -31,55 +31,68 @@
<div id="main">
<h1>Using Koha with zcc</h1>
<div id="version" class="clickable" onclick='document.location = "http://rubyforge.org/projects/zcc"; return false'>
<p>Get Version</p>
- <a href="http://rubyforge.org/projects/zcc" class="numbers">0.1.0</a>
+ <a href="http://rubyforge.org/projects/zcc" class="numbers">0.2.0</a>
</div>
<p><a href="http://www.koha.org">Koha</a> + <a href="http://zcc.rubyforge.org/zcc.html">zcc</a></p>
<h2>Hints</h2>
-<ol>
+
+ <ol>
<li>Follow all the directions on the <a href="http://zcc.rubyforge.org/zcc.html">main zcc page</a> carefully. Please let me know if you run into problems with configuration.</li>
-</ol>
+ </ol>
-<ol>
+
+ <ol>
<li><a href="http://zcc.rubyforge.org/zcc.html">zcc</a> is <strong>not</strong> a part of Koha and is not developed by the same folks.</li>
-</ol>
+ </ol>
-<ol>
+
+ <ol>
<li><a href="http://zcc.rubyforge.org/zcc.html">zcc</a> only creates utf-8 encoded records. If you want <span class="caps">MARC</span>-8 encoded records you’re on your own. <span class="caps">MARC</span>-8 encoding has already caused enough problems in this world, so I encourage folks to move to <span class="caps">UTF</span>-8 <span class="caps">ASAP</span>. If you use a different encoding that you want supported, please let me know. To set up Koha properly for dealing with <span class="caps">UTF</span>-8 encoded records see <a href="http://wiki.koha.org/doku.php?id=encodingscratchpad&s=utf8">this wiki page</a></li>
-</ol>
+ </ol>
-<ol>
- <li><span class="caps">ZCC</span> currently only works with a default install as paths are hardcoded. If there’s a need I’ll make it configurable for someone. Make sure the Koha modules are a part of your path. I accomplish this by adding “export <span class="caps">PERL5LIB</span>=/usr/local/koha/intranet/modules” and “export <span class="caps">KOHA</span>_CONF=/etc/koha.conf” without the quotes to my .bashrc (or add the path to /etc/profile for the root user). If your paths differ from the preceding saving to Koha will not work.</li>
-</ol>
-<ol>
- <li>You can then have 3 choices on how to get the records into koha:<ul>
- <li>Using the Koha Administration interface you can “Upload <span class="caps">MARC</span> records to the resevoir.” Then complete processing on the records like adding items and barcodes within the Koha web interface. The resevoir may strip out some fields that usually hold local content.</li>
-</ul>
+ <ol>
+ <li><span class="caps">ZCC</span> currently only works with a default install of Koha as paths are hardcoded. If there’s a need I’ll make it configurable for someone. Make sure the Koha modules are a part of your path. I accomplish this by adding “export <span class="caps">PERL5LIB</span>=/usr/local/koha/intranet/modules” (and “export <span class="caps">KOHA</span>_CONF=/etc/koha.conf”?) without the quotes to my .bashrc (or add the path to /etc/profile for the root user). If your paths differ from the preceding saving to Koha will not work.</li>
+ </ol>
-<ul>
+
+ <ol>
+ <li>You then have 3 choices on how to get the records into koha:
+
+ <ul>
+ <li>Use <span class="caps">ZCC</span> to save_record_syntax your <span class="caps">MARC</span> records to file as ‘marc’. Using the Koha Administration interface you can “Upload <span class="caps">MARC</span> records to the resevoir.” Then complete processing on the records like adding items and barcodes within the Koha web interface. The resevoir may strip out some fields that usually hold local content.</li>
+ </ul>
+
+
+ <ul>
<li>If you have processed your records fully to include item numbers and barcodes, you can use the bulkmarcimport script to put the records directly into your database. I’ve used bulkmarcimport without modification without problem. You may have different results and I’d like to hear them.</li>
-</ul>
+ </ul>
+
<pre syntax="ruby">perl
/usr/local/koha/intranet/scripts/misc/migration_tools/bulkmarcimport.pl -v -file
/path/to/marc-file.mrc</pre>
+
<p>That is all one line.</p>
-<ul>
+ <ul>
<li>Or configure the save_record_syntax of your zcc.yaml file to ‘koha2’. If this gives you errors make sure you have exported environment variables with: “export -p”. You may also need to change the permissions on /etc/koha.conf to allow all users to view the file. If you get errors you can (though it might not be the best solution) do the following as root:</li>
-</ul>
+ </ul>
+
<pre>chmod 644 /etc/koha.conf</pre></li>
-</ol>
+ </ol>
+
<h1>Contact</h1>
+
<p>I use <span class="caps">ZCC</span> and Koha for my own work. So I’m very interested in making <span class="caps">ZCC</span> work better with Koha. Please send your comments, suggestions and patches to <a href="mailto:jronallo+zcc@gmail.com">Jason Ronallo</a></p>
</div>