<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN">

<article>

<artheader>

 <title>
  <inlinemediaobject>
   <imageobject>
   <imagedata fileref="Rebbe.jpg" width="100" depth="98" align="right">
   </imageobject>
  </inlinemediaobject>
  Chitas in English for the Palm OS Device
 </title>

 <author>
  <firstname>Chitas in</firstname>
  <surname>English</surname>
  <affiliation>
  <address><email>ChitasInEnglish@netscape.net</email></address>
  </affiliation>
 </author>

 <abstract>
 <para> 
  <informalfigure>
   <mediaobject>
   <imageobject>
   <imagedata fileref="logo_small.jpg" align="left" depth="100" width="92">
   </imageobject>
   </mediaobject>
  </informalfigure>
 </para>

 <para>
 Find out how you can learn <emphasis>Chitas</emphasis> (Chumash with Rashi, Thillim, Tanya) in English on your Palm powered device.
 </para>

 <para>
 <emphasis>Iyar 2, 5763 - May 4, 2003. Birthday of the Rebbe Maharash</emphasis>
 </para> 
 </abstract>

</artheader>

<sect1 id="preface">
 <title>Preface</title>
 
 <para>
 One of the reasons why I bought a Palm OS powered CLIE was to be able to study <emphasis>Chitas</emphasis> in English on the go. 
 I was rather disappointed to find out that it was not readily available for download.
 </para>

 <para>
 After finding a freely available software that was especially designed to display two related texts on one screen,
 I set out to turn the <emphasis>Chumash</emphasis> text and Rashi's commentary into a format that this software can display. 
 I am sharing the results here with you.
 </para>

 <figure>
  <title>Devarim 30:14 (P. Nitzavim) - The verse upon which Tanya is based</title>
  <mediaobject>
   <imageobject>
   <imagedata fileref="Preface.jpg" format="jpg" width="328" depth="331">
   </imageobject>
  </mediaobject> 
 </figure>

 <para>
 The screenshots throughout this document have resolution 160x160.
 </para>
</sect1>

<sect1 id="intro">
 <title>Introduction</title>

 <sect2 id="cycle">
 <title><emphasis>Chitas</emphasis> Study Cycle</title>
 
 <para>
 As instituted by the Previous Lubavitcher Rebbe, the Rebbe Rayatz:
 <command>Ch</command>umash, <command>T</command>ehillim, <command>T</command>anya.
 </para>

 <para>
 The following are excerpts from <ulink url="http://www.sichosinenglish.org/books/sefer-haminhagim/">Sefer
 HaMinhagim, The Book of Chabad-Lubavitch Customs</ulink>
 (<ulink url="http://www.sichosinenglish.org/books/sefer-haminhagim/19.htm">complete entry</ulink>):
 </para>

 <para>
 <orderedlist>
  <listitem>
  <para>
  <command>Chumash with the Commentary of Rashi</command>: Every day one studies one passage of
  the current week's <emphasis>Sidra</emphasis> [i.e., the <emphasis>Sidra</emphasis> to be publicly read on
  the forthcoming <emphasis>Shabbos</emphasis>] with
  the commentary of <emphasis>Rashi</emphasis>. Thus, on the first day of the week one reaches
  <emphasis>Sheini</emphasis>, on the second one reaches <emphasis>Shlishi,</emphasis> and so on. [...]
  </para>
  </listitem>

  <listitem>
  <para>
  <command>Tehillim</command>: After the morning prayers every day including <emphasis>Shabbos</emphasis>,
  <emphasis>Yom-Tov</emphasis>, Rosh HaShanah and Yom Kippur [after <emphasis>Mussaf</emphasis>] one recites
  chapters of <emphasis>Tehillim</emphasis> as apportioned for the days of the month. [...] 
  When the 29th is the last day of the month, one reads the portion for the 30th day as well.[...] As is well
  known, <emphasis>Tehillim</emphasis> (including the above-mentioned daily portion) is not read at night, from
  the appearance of the stars until after midnight. However, one does study <emphasis>Chumash</emphasis> and
  <emphasis>Tanya</emphasis>. The above restriction does not apply on Rosh HaShanah, the Days of Penitence,
  Yom Kippur and Hoshana Rabbah.
  </para>
  </listitem>

  <listitem>
  <para>
  <command>Tanya</command>: The daily passages should be studied as set out in the annual study guide entitled
  <emphasis>Moreh Shiur</emphasis> [which appears as the first appendix to all current editions of the
  <emphasis>Tanya</emphasis>].
  </para>
  </listitem>
 </orderedlist>
 </para>

 <figure>
 <title>Bereishit 35:5 (P. Vayishlach) - "Fear," in the original "<emphasis>Chitas</emphasis>"</title>
 <mediaobject>
  <imageobject>
  <imagedata fileref="Chitas.jpg" format="jpg" width="328" depth="331">
  </imageobject>
 </mediaobject>
 </figure>
 
 <para>
 Above you see a screenshot displaying Bereishit 35:5 with Rashi (Parshat Vayishlach, 5th portion, about 38th verse in this portion).
 </para>
 </sect2>
</sect1>

<sect1 id="software">
 <title>The Reader Software</title>
 
 <para>
 As I mentioned already in <xref LinkEnd="preface">, the only work I did on this project
 was <emphasis>converting</emphasis> the existing text to a format that the reader software can present. I was completly
 relying on preexisting text and software.  Below you can see the "About" screen of the reader software.
 </para>

 <figure>
 <title>"About" Screen of the Reader Software</title>
 <mediaobject>
  <imageobject>
  <imagedata fileref="Reader.jpg" format="jpg" depth="331" width="328">
  </imageobject>
 </mediaobject>
 </figure>
 
 <sect2 id="copy">
  <title>Copyright & Download</title>
 
  <para>
  This software is distributed under the <ulink url="license.txt">GNU General Public License</ulink>. You may download
  the software 
  <itemizedlist>
   <listitem>
   <para><ulink url="PalmBible_eng.1.0.release.3.zip">as a compiled, ready-to-use application</ulink> (27 kB) or</para>
   </listitem>
   <listitem>
   <para><ulink url="PalmBible_src.1.0.release.3.zip">as source code</ulink> (222 kB) as well.</para>
   </listitem>
  </itemizedlist>
  </para>

  <para>
  Please, see the license (also included with the above distributions) for all terms and conditions including
  the fact that the software is provided with NO warranty.
  </para>

  <para>
  Installing and using the program from the compiled distribution above is straightforward.
  (Note:  Sometimes you do need to reset your PDA after installing a new text for the reader, and 
  occasionally the reader does crash the OS and then you have to do the pin-in-the-hole trick. This
  happens rather seldom, and so far I have not found it too disruptive.)
  </para>
 </sect2>

 <sect2 id="hebrew">
  <title>Hebrew Fonts</title>

  <para>
  Although the Rashi text is in English, nevertheless it was necessary for the translators to quote Hebrew
  words/phrases to make Rashi's point more readily understandable.  For this reason it is helpful to have Hebrew fonts
  on your handheld.  You can either purchase <ulink url="http://www.penticon.com/hl.html">Hebrew Lite</ulink> or
  <ulink url="http://www.penticon.com/hs.html">Hebrew Support+</ulink> from <ulink url="http://www.penticon.com/">
  Penticon Technologies</ulink> (free evaluation copies are available) or use the free <emphasis>fonthack123</emphasis>.
  </para>

  <figure>
  <title>Bereishit 1:1 (P. Bereishit) - Example of Proper Rendering of Hebrew Text</title>
  <mediaobject>
   <imageobject>
   <imagedata fileref="HebrewFont.jpg" format="jpg" width="328" depth="328">
   </imageobject>
  </mediaobject>
  </figure>
  
  <para>
  I am not familiar with <emphasis>fonthack123</emphasis> so I cannot provide any details on this except that
  my understanding is that it works.  If you are more familiar with it, and can provide details on download,
  installation etc., I would appreciate.
  </para>

  <para>
  Without some sort of Hebrew fonts, the Hebrew text will appear like this:
  </para>

  <figure>
  <title>Rendering of Hebrew Text without Hebrew Font</title>
  <mediaobject>
   <imageobject>
   <imagedata fileref="NoHebrew.jpg" format="jpg" width="326" depth="92">
   </imageobject>
  </mediaobject>
  </figure>
 </sect2>
</sect1>

<sect1 id="chumash">
 <title>Chumash Text with Rashi</title>

 <sect2 id="credit">
  <title>Credit</title>
 
  <para>
  The text for the reader software was entirely derived from <ulink url="http://www.chabad.org/">Chabad.org</ulink>'s
  <ulink url="http://www.chabad.org/dailystudy/default.asp">Daily Study</ulink> sections.  In the footer of each of their
  Chumash with Rashi pages they indicate that the text is <ulink url="http://www.chabad.org//parshah/rashi/JPcredit.asp">
  "Graciously provided & © by Judaica Press"</ulink>. Following that link takes you to a page with the contact
  information for Judaica Press, and a link to their product order page where you can order "The Judaica Press Complete
  Tanach with Rashi" on CD.
  </para>
  
  <figure>
  <title>Chumash Text Version and Copyright Info</title>
  <mediaobject>
   <imageobject>
   <imagedata fileref="TextCredit.jpg" format="jpg" width="328" depth="328">
   </imageobject>
  </mediaobject>
  </figure>

  <para>
  At the bottom of each of the Chumash and Rashi pages Chabad.org also indicates "© 2001-2003 Chabad-Lubavitch Media Center."
  </para>
 </sect2>

 <sect2 id="contrib">
  <title>Contribution of 'Chitas in English'</title>

  <para>
  My contribution was to download the text from the website and to convert it to a format that the reader can
  interpret.  The only minor modifications I made (as of version 1.01) are:
  <itemizedlist>
   <listitem><para>
   Removing the Hebrew vowels, since neither Penticon Hebrew Support nor <emphasis>fonthack123</emphasis> is able
   to display them.
   </para></listitem>
   <listitem><para>
   Adding Rashi to the first pasuk of Parshat <ulink url="http://www.chabad.org/Parshah/Rashi/default.asp?tDate=12/1/2002">
   Mikeitz</ulink>
   and <ulink url="http://www.chabad.org/Parshah/Rashi/default.asp?tDate=1/5/2003">Bo</ulink>.
   </para></listitem>  
   <listitem><para>
   Separating Parshat Matot-Massei into Matot and Massei (even though the next time these two parshiot are read
   separately is going to be in 2005, I did it for the sake of completeness).
   </para></listitem>
   <listitem><para>
   Adding some features, see <xref LinkEnd="features">.
   </para></listitem>
  </itemizedlist>
  </para>
 </sect2>
 
 <sect2 id="download">
  <title>Download</title>

  <para>
  The <emphasis>.pdb</emphasis> files (<emphasis>zipped</emphasis>):
  <itemizedlist>
   <listitem><para>
   <ulink url="Chumash-v1.01.zip">Chumash v1.01</ulink> (278 kB - unzipped 388 kB)
   </para></listitem>
   <listitem><para>
   <ulink url="Rashi-v1.01.zip">Rashi v1.01</ulink> (744 kb - unzipped 1 MB)
   </para></listitem>
  </itemizedlist>
  </para>

  <para>
  Just HotSync them to your PDA and they will be available from the reader.
  </para>
 </sect2>

 <sect2 id="logic">
  <title>Logic of the Presentation</title>
  
  <para>
  The reader program breakes the text down into different sections.  Since the text I am making available here is
  specifically ment to be studied as part of the <emphasis>Chitas</emphasis> Study Cycle, see <xref LinkEnd="cycle">, 
  the meaning of these sections was changed slightly:
  </para>
  
  <para>
  <table frame="all">
   <title>Breakdown of the Texts</title>
   <tgroup cols="4">
   <colspec colnum="1" colname="col1">
   <colspec colnum="2" colname="col2">
   <colspec colnum="3" colname="col3">
   <colspec colnum="4" colname="col4">
   <spanspec namest="col2" nameend="col3" spanname="span-horiz" align="center">
   <thead>
    <row>
     <entry>Logical Section</entry>
     <entry>Original Meaning</entry>
     <entry>Meaning in the context of <emphasis>Chumash Chitas</emphasis></entry>
     <entry></entry>
    </row>
   </thead>
   <tbody>
    <row>
     <entry>Book</entry>
     <entry>A named book</entry>
     <entry>A weekly parsha</entry>
     <entry>A</entry>
    </row>
    <row>
     <entry morerows="1">Chapter</entry>
     <entry>A numbered chapter</entry>
     <entry>One of seven daily portions</entry>
     <entry morerows="1">B</entry>
    </row>
    <row>
     <entry spanname="span-horiz">(automatic numbering restarts in each book/weekly parsha)</entry>
    </row>
    <row>
     <entry morerows="1">Verse</entry>
     <entry>A numbered verse</entry>
     <entry>A numbered verse, but sometimes used as a placeholder etc., so the automatic verse numbers are not very meaningful</entry>
     <entry morerows="1">C</entry>
    </row>
    <row>
     <entry spanname="span-horiz">(automatic numbering restarts in each chapter/daily partion)</entry>
    </row>
   </tbody>
   </tgroup>
  </table>
  </para>

  <figure>
  <title>Recommended Settings</title>
  <mediaobject>
   <imageobject>
   <imagedata fileref="Preferences.jpg" format="jpg" width="328" depth="328">
   </imageobject>
  </mediaobject>
  </figure>
  
  <para>
  As can be seen on the "Preferences" screen above, the reader can display various information.
  The meaning of these in our context is the following:
  </para>

  <para>
  <table frame="all">
   <title>Information Included in the Texts</title>
   <tgroup cols="3">
   <tbody>
    <row>
     <entry>"Book"</entry>
     <entry>Chapter number (appears at the beginning of each daily portion and at the beginning of each new chapter)</entry>
     <entry>1</entry>
    </row>
    <row> 
     <entry>"Chap. No."</entry>
     <entry>Correct pasuk number</entry>
     <entry>2</entry>
    </row>
    <row>
     <entry>"Title"</entry>
     <entry>Rashi's quote from the pasuk</entry>
     <entry>3</entry>
    </row>
    <row>
     <entry>"Text"</entry>
     <entry>Text of pasuk or Rashi's commentary</entry>
     <entry>4</entry>
    </row>
    <row>
     <entry>"Verse No."</entry>
     <entry>Automatic verse numbers (not very useful - see above)</entry>
     <entry>C</entry>
    </row>
   </tbody>
   </tgroup>
  </table>
  </para>

  <figure>
  <title>Bereishit 12:1 (P. Lech-Lecha) - Example of Sections and Information Included</title>
  <mediaobject>
   <imageobject>
   <imagedata fileref="TextTypeSampleScreen.jpg" format="jpg" width="472" depth="365">
   </imageobject>
  </mediaobject>
  </figure>
 </sect2>
 
 <sect2 id="features">
  <title>Features</title>
  
  <figure>
  <title>Devarim 6:3 (P. Va'etchanan) - Example of Features Added</title>
  <mediaobject>
   <imageobject>
   <imagedata fileref="ChumashFeatures.jpg" format="jpg" width="328" depth="328">
   </imageobject>
  </mediaobject>
  </figure>
  
  <para>
  I added the following features to make it easier to use these texts for studying Chumash Chitas (see screenshot
  above of Parshat Va'etchanan, 5th portion):
  </para>
  
  <para>
  <itemizedlist>
   <listitem><para>
   [No Rashi] - If there is no Rashi on a particular pasuk (such as 6:3 above), I indicated this right
   after the pasuk number.  This way you do not have to look for it on the bottom panel.
   </para></listitem>
   <listitem><para>
   At the end of each daily portion I added '* * *', to make it easier to notice the end of sections.
   </para></listitem>
   <listitem><para>
   For those parshiot that may be read separately or joint together, I included both versions, and added a note
   at the beginning of the first parsha (see below).
   </para></listitem>
  </itemizedlist>
  </para>
  
  <figure>
  <title>Vayikra 12:1 (P. Tazria) - Example of "Double Parsha"</title>
  <mediaobject>
   <imageobject>
   <imagedata fileref="DoubleList.jpg" format="jpg" width="328" depth="209">
   </imageobject>
  </mediaobject>
  <mediaobject>
   <imageobject>
   <imagedata fileref="DoubleDetail.jpg" format="jpg" width="328" depth="328">
   </imageobject>
  </mediaobject>
  </figure>

 </sect2>
</sect1> 

<sect1 id="contact">
 <title>Contact Info</title>
 
 <para>
 Please, send me your comments, suggestions or any other feedback you might have.
 </para>

 <figure>
 <title>Devarim 6:7 (P. Va'etchanan) - A verse from the <emphasis>Shemah</emphasis> prayer</title>
 <mediaobject>
  <imageobject>
  <imagedata fileref="Contact.jpg" format="jpg" width="328" depth="328">
  </imageobject>
 </mediaobject>
 </figure>


 <para> 
  <informalfigure>
   <mediaobject>
   <imageobject>
   <imagedata fileref="logo_small.jpg" depth="100" width="92" align="right">
   </imageobject>
   </mediaobject>
  </informalfigure>
 </para>
 
 <para>
 Or just drop a note saying you are using this Chumash with Rashi text to study Chumash Chitas on your PDA.
 </para>

 <para>
 Address: <email>ChitasInEnglish@netscape.net</email>
 </para> 

 <para>
 Looking forward to hearing from you.
 </para>
</sect1>
</article>
