content.txt

Emdros is a text database middleware-layer aimed at storage and retrieval of "text plus information

<page ID="1000">

</page>


<page ID="1001">


<P>This is the User's Guide to the Emdros Chunking Tool.</P>

<P>The Emdros Chunking Tool allows you to split running text into
lines and then indent those lines with respect to each other.</P>

</page>


<page ID="1005">

<P>The Emdros Chunking Tool exists in two graphical versions:</P>

<UL>

     <LI>A non-Unicode version

     <LI>A Unicode-aware version

</UL>

</page>


<page ID="1010">

<h2>Introduction</h2>

<index term="configuration file"> 

<P>Before running the Emdros Chunking Tool for the first time on a
database, you need to write a configuration file that matches your
database.  This is a one-off thing: Once it's done, you don't need to
bother with it any more.</P>

<h2>Sample configuration file</h2>

<P>A number of sample configuration files are supplied with Emdros.
You can use these as a starting point for writing your own
configuration file.</P>

<P>One supplied configuration file is called "tisch.cfg", while
another is called "wihebrew.cfg".  You can search for these on your
computer to locate where they are, or see the manual page for
chunkingtool to know where they are installed (on Windows, they are
installed in %EMDROSINSTALLPREFIX%\etc\).  </P>

<h2>Full details</h2>

<P>The "tisch.cfg" file is almost self-documenting.  However, you
can get more information about the details of the configuration file
here:</P>

<UL>

  <LI><page_anchor ID="2000">Configuring the program</page_anchor>

</UL>


</page>


<page ID="1100">

<P>We now explain how to use the program.</P>


</page>

<page ID="1110">

<h2>Getting started</h2>

<P>Once you open the program, you will be presented with the main
screen.  You will then need to "connect" to a database.  Either choose
the menu-item "File|Connect" or press the button <IMG
SRC="connect.png"> "Connect to database".</P>

<h2>Connection dialog</h2>

<P>You will then be given a dialog box allowing you to choose the
Connection Settings.  At the top is a drop-down box allowing you to
choose the backend.  Based on this choice, the dialog box will appear
slightly differently depending whether the backend is:</P>

<UL>
  <LI><page_anchor ID="1115">SQLite 2 or 3</page_anchor>, or
  <LI><page_anchor ID="1118">MySQL or PostgreSQL</page_anchor><index term="MySQL"><index term="PostgreSQL">

</UL>  

<H2>Non-Unicode vs. Unicode</h2>

<P>For each backend, the program exists in two versions:</P>

<UL>

  <LI>A non-Unicode version
  <LI>A Unicode-aware version

</UL>

</page>



<page ID="1115">

<P>The Connection Settings dialog looks like this if you have selected
SQLite 2 or 3 as the backend:</P><index term="Connection settings
dialog">

<IMG SRC="SQLiteConnSettings.png" ALT="SQLite Connection settings dialog">

<h2>Set the configuration file</h2>

<index term="configuration file">
<P>The first thing you should do is press the "Browse" button next to
the "Configuration" edit box, then navigate to where you have your
<page_anchor ID="1010">configuration file</page_anchor>.</P>

<P>Once you've opened the configuration file, the "database" field
will be filled from the "database" value stored in the configuration
file, if any.  If this is not the database you want, simply enter (or
browse for) the database you want.</P>

<P>For example:</P>

<IMG SRC="SQLiteConnSettingsFilled.png" ALT="SQLite Connection
settings dialog, filled with values">

<h2>Press OK</h2>

<P>Once you're done setting the configuration file and the database,
press "OK".  If you want to quit the program instead, press
"Cancel".</P>


</page>



<page ID="1118">

<P>When you start the Emdros Chunking Tool using the MySQL or the<index
term="MySQL"> PostgreSQL backend, you will see this dialog:</P>

<IMG SRC="MyPgSQLConnSettings.png" ALT="MySQL/PostgreSQL Connection
settings dialog"><index term="Connection settings dialog">

<index term="configuration file">
<h2>Set the configuration file</h2>

<P>The first thing you should do is press the "Browse" button next to
the "Configuration" edit box, then navigate to where you have your
<page_anchor ID="1010">configuration file</page_anchor>.</P>

<h2>Database</h2>

<P>Once you've opened the configuration file, the "database" field
will be filled from the "database" value stored in the configuration
file, if any.  If this is not the database you want, simply enter the
database you want.</P>

<h2>Host, user, password</h2>

<P>Most people can leave the "host" and "user" fields as they are, and
simply write the password.</P><index term="password">

<P>The "host" field shows which computer to connect to, i.e., the
computer where the MySQL or PostgreSQL backend is running. "localhost"
means the computer where the Chunking Tool is running.</P>

<P>The "user" field is the database user to connect to the backend as.
Note that this may be different from your computer user name.  The
default is "emdf", since that is the recommended default user to
create when you bootstrap the MySQL or PostgreSQL database (see
"bootstrapping.txt" in the <A
HREF="http://emdros.org/docs-download.html">Emdros
documentation</A>).</P>

<P>The "password" field is for the password of the database user to
connect as.  This is set either by the database administrator, or by
the one who bootstrapped the MySQL or PostgreSQL database.</P><index
term="password">

<h2>Example</h2>


<IMG SRC="MyPgConnSettingsFilled.png" ALT="MySQL/PostgreSQL Connection settings dialog, filled with values">


<h2>Press OK</h2>

<P>Once you're done setting the configuration file and the database,
press "OK".  If you want to quit the program instead, press
"Cancel".</P>



</page>



<page ID="1120">

<P>Once you've pressed "OK" on the "Connection settings" dialog box,
you will see the main screen:</P>


<IMG SRC="MainScreen.png" ALT="The main screen">

<h2>Parts</h2>

<P>The main screen consist of these parts:</P>

<UL>

  <LI>A <page_anchor ID="1140">menu</page_anchor> at the top. 

  <IMG SRC="MenuBar.png" ALT="The menu bar">

  <LI>Below that, a <page_anchor ID="1130">toolbar</page_anchor> with
  buttons. 

  <IMG SRC="ToolBar.png" ALT="The toolbar">

  <LI>Below that, an area that is to display the text you want to
  chunk.  In the picture above, it is all white.

</UL>

<h2>Next</h2>

<P>Next, we describe each of these parts.</P>

</page>



<page ID="1130">

<P>The toolbar looks like this:</P>

<IMG SRC="ToolBar.png" ALT="The toolbar">

<P>The buttons represent actions, each of which will be explained
below.</P>

<h2>New Connection</h2>

<P><strong>New Connection</strong>&nbsp;<IMG SRC="connect.png"
ALT="New Connection">&nbsp;: Connects to a database via a <page_anchor
ID="2000">configuration file</page_anchor> <index term="configuration
file"></P>

<h2>Commit</h2>

<P><strong>Commit</strong>&nbsp;<IMG SRC="commit.png"
ALT="Commit">&nbsp;: Saves the chunking-changes made in the program,
by committing them to the database.</P>

<h2>Split, Combine</h2>

<P><strong>Split</strong>&nbsp;<IMG SRC="flash.png"
ALT="Split">&nbsp;: Splits the current chunk right before the currently
selected box.</P>

<P><strong>Combine</strong>&nbsp;<IMG SRC="together.png"
ALT="Combine">&nbsp;: Combines the chunk containing the currently
selected box with the previous chunk.</P>

<h2>Move left, Move right</h2>

<P><strong>Move left</strong>&nbsp;<IMG SRC="leftarrow.png" ALT="Move
left">&nbsp;: Moves the chunk containing the currently selected box
one tab-stop to the left.</P>

<P><strong>Move right</strong>&nbsp;<IMG SRC="rightarrow.png" ALT="Move
right">&nbsp;: Moves the chunk containing the currently selected box
one tab-stop to the right.</P>

</page>



<page ID="1140">

<P>There are four menus, each explained on its own:</P>

<OL>

  <LI><page_anchor ID="1145">File menu</page_anchor>

  <LI><page_anchor ID="1150">Edit menu</page_anchor>

  <LI><page_anchor ID="1155">Tools menu</page_anchor>

  <LI><page_anchor ID="1160">Help menu</page_anchor>

</OL>


</page>



<page ID="1145">

<h2>Connect...</h2>

<P>The "Connect..." menu item connects to a database via a