summaryrefslogtreecommitdiff
path: root/support/cms4talks/Manual
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /support/cms4talks/Manual
Initial commit
Diffstat (limited to 'support/cms4talks/Manual')
-rw-r--r--support/cms4talks/Manual/CMS4talks.gifbin0 -> 1422 bytes
-rw-r--r--support/cms4talks/Manual/images/copyleft.gifbin0 -> 358 bytes
-rw-r--r--support/cms4talks/Manual/images/foundgui.gifbin0 -> 6190 bytes
-rw-r--r--support/cms4talks/Manual/images/main.gifbin0 -> 9177 bytes
-rw-r--r--support/cms4talks/Manual/images/prefcommands.gifbin0 -> 6153 bytes
-rw-r--r--support/cms4talks/Manual/images/prefpaths.gifbin0 -> 5602 bytes
-rw-r--r--support/cms4talks/Manual/images/slideeditgui.gifbin0 -> 14920 bytes
-rw-r--r--support/cms4talks/Manual/images/talkeditgui.gifbin0 -> 10237 bytes
-rw-r--r--support/cms4talks/Manual/images/talklistgui.gifbin0 -> 10883 bytes
-rw-r--r--support/cms4talks/Manual/images/top.gifbin0 -> 470 bytes
-rw-r--r--support/cms4talks/Manual/images/workingcollection.gifbin0 -> 8504 bytes
-rw-r--r--support/cms4talks/Manual/index.html90
-rw-r--r--support/cms4talks/Manual/manual-printversion.html475
-rw-r--r--support/cms4talks/Manual/manual.html553
14 files changed, 1118 insertions, 0 deletions
diff --git a/support/cms4talks/Manual/CMS4talks.gif b/support/cms4talks/Manual/CMS4talks.gif
new file mode 100644
index 0000000000..c192a0a206
--- /dev/null
+++ b/support/cms4talks/Manual/CMS4talks.gif
Binary files differ
diff --git a/support/cms4talks/Manual/images/copyleft.gif b/support/cms4talks/Manual/images/copyleft.gif
new file mode 100644
index 0000000000..e40b3d5f7b
--- /dev/null
+++ b/support/cms4talks/Manual/images/copyleft.gif
Binary files differ
diff --git a/support/cms4talks/Manual/images/foundgui.gif b/support/cms4talks/Manual/images/foundgui.gif
new file mode 100644
index 0000000000..223044d1aa
--- /dev/null
+++ b/support/cms4talks/Manual/images/foundgui.gif
Binary files differ
diff --git a/support/cms4talks/Manual/images/main.gif b/support/cms4talks/Manual/images/main.gif
new file mode 100644
index 0000000000..084af3dc04
--- /dev/null
+++ b/support/cms4talks/Manual/images/main.gif
Binary files differ
diff --git a/support/cms4talks/Manual/images/prefcommands.gif b/support/cms4talks/Manual/images/prefcommands.gif
new file mode 100644
index 0000000000..09456ac0ca
--- /dev/null
+++ b/support/cms4talks/Manual/images/prefcommands.gif
Binary files differ
diff --git a/support/cms4talks/Manual/images/prefpaths.gif b/support/cms4talks/Manual/images/prefpaths.gif
new file mode 100644
index 0000000000..6cfe07b496
--- /dev/null
+++ b/support/cms4talks/Manual/images/prefpaths.gif
Binary files differ
diff --git a/support/cms4talks/Manual/images/slideeditgui.gif b/support/cms4talks/Manual/images/slideeditgui.gif
new file mode 100644
index 0000000000..3eeeea992e
--- /dev/null
+++ b/support/cms4talks/Manual/images/slideeditgui.gif
Binary files differ
diff --git a/support/cms4talks/Manual/images/talkeditgui.gif b/support/cms4talks/Manual/images/talkeditgui.gif
new file mode 100644
index 0000000000..469fd0d403
--- /dev/null
+++ b/support/cms4talks/Manual/images/talkeditgui.gif
Binary files differ
diff --git a/support/cms4talks/Manual/images/talklistgui.gif b/support/cms4talks/Manual/images/talklistgui.gif
new file mode 100644
index 0000000000..7ab433f633
--- /dev/null
+++ b/support/cms4talks/Manual/images/talklistgui.gif
Binary files differ
diff --git a/support/cms4talks/Manual/images/top.gif b/support/cms4talks/Manual/images/top.gif
new file mode 100644
index 0000000000..e2b511774c
--- /dev/null
+++ b/support/cms4talks/Manual/images/top.gif
Binary files differ
diff --git a/support/cms4talks/Manual/images/workingcollection.gif b/support/cms4talks/Manual/images/workingcollection.gif
new file mode 100644
index 0000000000..86f098cced
--- /dev/null
+++ b/support/cms4talks/Manual/images/workingcollection.gif
Binary files differ
diff --git a/support/cms4talks/Manual/index.html b/support/cms4talks/Manual/index.html
new file mode 100644
index 0000000000..9cddd11498
--- /dev/null
+++ b/support/cms4talks/Manual/index.html
@@ -0,0 +1,90 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+"http://www.w3.org/TR/html4/loose.dtd"> <!--NewPage--> <HTML>
+<HEAD> <TITLE> SlidePool </TITLE>
+
+<META NAME="keywords" CONTENT="SlidePool manual">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="SlidePool manual";
+}
+</SCRIPT>
+<NOSCRIPT>
+</NOSCRIPT>
+
+</HEAD>
+
+<BODY BGCOLOR="white" onload="windowTitle();">
+
+<img src="CMS4talks.gif">
+
+<h1>
+
+CMS4talks - <i>(FAQ)</i>
+
+</h1>
+
+<a href="#whatiscms4talks">What is CMS4talks?</a><br>
+
+<a href="#whatiscms4talksnot">What is CMS4talks not?</a><br>
+
+<a href="#requirements">What do I need for CMS4talks?</a><br>
+
+<a href="#wheredownload">Where Do I get CMS4talks?</a><br>
+
+<a href="#guide">Is there a manual for CMS4talks?</a><br>
+
+<hr>
+
+<a name="whatiscms4talks">
+
+<h3>What is CMS4talks?</h3>
+
+CMS4talks is a small content management system for talks written
+in LaTeX. It helps You to manage all Your talks written in LaTeX.
+You can easily create new talks, search within all Your talks,
+rearange talks, edit slides and export them back to disk.<br>
+
+CMS4talks helps You sharing the same slides among different talks.
+
+<a name="whatiscms4talksnot">
+
+<h3>What is CMS4talks not?</h3>
+
+CMS4talks won't replace Your LaTeX system and it will not enhance
+Your Layout or other LaTex-related things.<p>
+
+<a name="requirements">
+
+<h3>What do I need?</h3>
+
+CMS4talks is written in Java and comes in an archive containing
+all class-files You need. CMS4talks needs properly installed Java
+runtime environment version 1.4 or higher, als well as a MySQL
+data base version 4.1 or higher.<br>
+
+You can get them here:<br>
+
+<a href="http://www.mysql.com/">MySql</a><br>
+
+<a href="http://www.java.com/getjava/">Java download</a><p>
+
+<a name="wheredownload">
+
+<h3>Where do I get CMS4talks?</h3>
+
+You can get it here:<br>
+
+<a href="http://www.ndahl.de/CMS4talks.zip">CMS4talks</a><p>
+
+<a name="guide">
+
+<h3>Is there a manual for CMS4talks?</h3>
+
+Yes, follow this <a href="manual.html">link.</a><p>
+
+
+ </BODY> </HTML>
diff --git a/support/cms4talks/Manual/manual-printversion.html b/support/cms4talks/Manual/manual-printversion.html
new file mode 100644
index 0000000000..fadb4f975d
--- /dev/null
+++ b/support/cms4talks/Manual/manual-printversion.html
@@ -0,0 +1,475 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+"http://www.w3.org/TR/html4/loose.dtd"> <!--NewPage-->
+<HTML>
+
+<HEAD>
+
+<TITLE> CMS4talks - manual </TITLE>
+
+<META NAME="keywords" CONTENT="SlidePool manual">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="stylesheet.css" TITLE="Style">
+
+<!--SCRIPT type="text/javascript"> function windowTitle() {
+ parent.document.title="CMS4talks manual";
+}
+</SCRIPT>
+
+<NOSCRIPT> </NOSCRIPT-->
+
+</HEAD>
+
+<BODY BGCOLOR="white" onload="windowTitle();">
+
+<a name="topofpage"> <img src="CMS4talks.gif" alt="">
+
+<h1>
+
+CMS4talks - <i>user manual</i>
+
+</h1> <p STYLE="page-break-before: always"></p>
+
+<a href="#general">general Overview</a><br>
+
+<a href="#inst">Installation</a><br>
+
+<a href="#slideex">enhance(d) Slide Extraction</a><br>
+
+<a href="#talkeditgui">edit Talks</a><br>
+
+<a href="#slideeditgui">edit Slides</a><br>
+
+<a href="#workingcollection">The Working Collection</a><br>
+
+<a href="#searchfunction">The Search Function</a><br>
+
+
+<hr>
+
+<a name="inst">
+
+<h3>Installation</h3>
+
+<ul>
+
+<li>Get your copy of cms4talks.zip and unzip it to a favoured but
+empty directory.</li>
+
+<li>Make sure your system satisfies the <a
+href="index.html#requirements">requirements</a>.</li>
+
+<li>Ensure that the directory you have chosen is named in the
+classpath for your Java Runtime Environment.</li>
+
+<li>Run "java Install" in our command prompt and follow the
+instructions.</li> </ul>
+
+Now you can start working with <i>CMS</i>4<i>talks</i>.
+
+<hr>
+
+<a name="general">
+
+<h2>general Overwiew</h2>
+
+<h3>The Main Window</h3>
+
+After typing java CMS4talks (Be aware of case sensitivity!) you
+will see the main window.<br>
+
+<img src="images/main.gif"><br>
+
+Lets introduce the buttons (klick on the links for further
+details):
+
+<ul>
+
+<li><a href="#addtalk">add talk</a> - add a talk</li>
+
+<li><a href="#addtalks">add talks</a> - add a whole directory of
+talks</li>
+
+<li><a href="#prefpaths">Preferences: package paths</a> - manage
+the list of directories containing packages </li>
+
+<li><a href="#prefcommands">Preferences: preferred slide
+commands</a> - manage the list of directories containing packages
+</li>
+
+<li><a href="#workingcoll">show working collection</a></li>
+
+<li><a href="#talklist">show talk list</a></li>
+
+
+</ul>
+
+<a name="addtalk">
+
+<h3>add a talk</h3>
+
+After clicking this button a filechooser will pop up and ask you
+for a filename. Specify any talk and press "OK". The chosen file
+will be analyzed and if CMS4talks finds one and only one known
+command that describes slides, the talk will be automatically
+processed, i.e. the slides will be extracted and added to the
+database, as well as a talk representation within CMS4talks will
+be generated.
+
+<p STYLE="page-break-before: always"></p>
+
+<a name="addtalks">
+
+<h3>add talks</h3>
+
+After clicking this button a directorychooser will pop up and ask
+you for a directory. Specify any directory. All files in this
+directory will be analyzed and if they contain slide specifying
+commands or tags, they will be processed as if they where chosen
+by hands.
+
+<a name="prefpaths">
+
+<h3>preferred package paths</h3>
+
+If you click here a list of paths will pop upp. You can simply
+add or delete arbitrarily paths.<br> <img
+src="images/prefpaths.gif"><br>
+
+For succesfully examining given TeX-files CMS4talks needs to know
+where all your packages are being found. All packages in a
+TeX-file will be checked for new commands. All of them which are
+includes in the <a href="#prefcommands">preferred slide commands
+list</a>, whill be handled as commands specifying slides.
+
+
+<a name="prefcommands">
+
+<h3>preferred slide commands list</h3>
+
+If you click here a list of slide specifying TeX-commands will
+pop upp. You can simply add or delete them or change their
+priority.<br> <img src="images/prefcommands.gif"><br>
+
+For succesfully examining given TeX-files CMS4talks needs to know
+which commands specify individual slides.<br>
+
+Lern more about slide commands and enhanced slide extraction <a
+href="#slideex">here</a>.
+
+
+<a name="workingcoll">
+
+<h3>show working collection</h3>
+
+During a CMS4talks session you may want to gather a collection of
+some slides. The working collection is a sort of clipboard where
+you easily can acces often used slides.
+
+<a name="talklist">
+
+<h3>show talk list</h3>
+
+After clicking here a list of all talks contained in CMS4talks
+database appears. It will look similar to the example shown.<br>
+<img src="images/talklistgui.gif"><br>Push &quot;edit&quot; to
+edit selected talk.
+
+
+<hr>
+
+<a name="slideex">
+
+<h2>enhance(d) Slide Extraction</h2>
+
+In your LaTeX-talk slides can be defined in two way. One way is
+that slides are defined between two tags like<br>
+
+<i>\begin{slide}</i> and<br>
+
+<i>\end{slide}</i> or they can be defined in a defined command
+that has the slide and sometimes even the title or some more
+information as its arguments. An example with two arguments could
+be <br>
+
+<i>\creatslide{this is a sample title}{this is the slide`s text
+source}</i>.
+
+For determining in which way slides are defined in your talks
+CMS4talks will ask you every time you want to add a talk. You can
+avoid being asked in most of the times if you provide CMS4talks
+some information:<br>
+
+All talks which shall be loades will parsed an all packages which
+are used within the talk are searched. They will be searched in
+the <a href="#prefpaths">preferred paths list</a>. So keep this
+list up to date.<p>
+
+If you add a talk, all new defined commands and redefined
+commands within the used packages as well as within the talk
+itself will be compared to the <a href="#prefcommands">preferred
+commands list</a>.<br>
+
+If only one of the commands is found in this list, then the slide
+defining command is well defined for this talk, and can be added
+to the system immediately without asking for the right command.
+
+While adding a whole directory (&quot;add talks&quot;) you won't
+be asked for the proper command. Therefore using this function
+requires preferably complete <a href="#prefpaths">preferred paths
+list</a> and <a href="#prefcommands">preferred commands list</a>.
+
+
+<hr>
+
+<a name="talkeditgui">
+
+<h2>edit Talks</h2>
+
+Choosing a talk in the talk list, will pop up a window similar to
+this one:<br>
+
+<img src="images/talkeditgui.gif">
+
+<p STYLE="page-break-before: always"></p>
+
+Lets describe the buttons and functions:
+
+<ul>
+
+<li>undo all changes - loads talk again from database</li>
+
+<li>save changes - saves the changes you made in this
+window<br><b>NOTE:</b>It ist possible to open the same talk in
+several different windows, saving won't recognize that. </li>
+
+<li>save as new - saves a new copy(version) of this talk</li>
+
+
+
+<li><a href="#etg_1st">1st slide</a> - attach talk`s first
+slide</li>
+
+<li><a href="#etg_go">go</a> - go to talk`s first slide</li>
+
+<li><a href="#etg_ex">go</a> - export this talk to disk</li>
+
+</ul>
+
+<a name="etg_1st">
+
+<h3>Attach first Slide to Talk</h3>
+
+Every talk that is added to cms4talk via &quot;add talk&quot; or
+&quot;add talks&quot; should automatically have its first slide
+attached to the talk edit window. If you rearange a talk you can
+attach any other slide as first slide to this talk and it is as
+easy as this: Select in the <a href="#workingcollection">working
+collection</a> the desired slide and push &quot;1st slide&quot;
+in the talk edit window. <b>NOTE:</b>Don`t forget to save changes.
+
+
+
+<a name="etg_go">
+
+<h3>Go to Talk`s first Slide</h3>
+
+If there is a first slide attached to the talk, pushing this
+button will open a slide edit window with the talk`s first slide.
+
+<a name="etg_ex">
+
+<h3>Export a Talk to Disk</h3>
+
+Having edited some slides and rearanged a talk or created a new
+talk, you might want to export it to disk (e.g. for further
+finetuning within your TeX-system an .ps-processing...).<br>
+Pushing &quot;export&quot; will open a filechooser. Select a
+filename and CMS4talks will write the entire talk to disk. If you
+set up the slide order properly the ordering of the slides in
+this talk will be as excepted. Nevertheless if some cycles appear
+(e.g. if you attach a talk`s first slide to some later slides as
+next slide) CMS4talk will recognize that finish before
+cycling.<p> Learn more about the slide order <a
+href="#slideorder">here</a>.
+
+
+<hr>
+
+<a name="slideeditgui">
+
+<h2>edit Slides</h2>
+
+Choosing a slide from a list of search results, the working
+collection or a talk window, will pop up a window similar to
+this:<br>
+
+<img src="images/slideeditgui.gif">
+
+<p>
+
+Lets describe some buttons and functions:
+
+<ul>
+
+<li>undo all changes - loads slide again from database</li>
+
+<li>save changes - saves the changes you made in this
+window<br><b>NOTE:</b>It ist possible to open the same slide in
+several different windows, saving won't recognize that. </li>
+
+<li>save as new - saves a new copy(version) of this slide</li>
+
+
+<li>go - go to next/previous slide</li>
+
+
+<li>add to working collection - add this slide to the working
+collection</li>
+
+<li><a href="#seg_go">go</a> - go to next/previous slide</li>
+
+<li><a href="#seg_prev">prev:</a> - attach previous slide</li>
+
+<li><a href="#seg_next">next:</a> - attach next slide</li>
+
+<li><a href="#seg_go">remove</a> - detach next/previous slide</li>
+
+</ul>
+
+
+
+<a name="seg_go">
+
+<h3>Go to next/previous slide</h3>
+
+Push this button to go to previous/next slide. It will appear in
+the same slide edit window.
+
+<hr>
+
+<a name="slideorder">
+
+<h2>Setting up the Slide Order</h2>
+
+With the possibility of assigning successors and predecessors to
+all slides you can arrange slides in any order. Keep in mind that
+a wise order is the assumption for success in <a
+href="#etg_ex"exporting</a> talks.
+
+
+<a name="seg_prev">
+
+<h3>Attach previous Slide</h3>
+
+If you rearange the slidesī order you can attach any other slide
+as previous slide to this slide, and it is as easy as this:
+Select in the <a href="#workingcollection">working collection</a>
+the desired slide and push &quot;prev:&quot;. <b>NOTE:</b>Don`t
+forget to save changes.
+
+<a name="seg_next">
+
+<h3>Attach next Slide</h3>
+
+You can assign the next slide in the same manner as previous
+slides are assigned.
+
+<p STYLE="page-break-before: always"></p>
+
+<h3>Hint:</h3>
+
+Having the possibility of assigning the next as well as the
+previous slide might be confusing because in fact it is redundant
+having both possibilities. Open the file <i>preferences.ini</i>
+you find in the directory where <i>CMS</i>4<i>talks</i> is
+installed and change the entry <i>true</i> in line #20 to
+<i>false</i>. In future versions this setting may be altered more
+comfortably .
+
+
+<hr>
+
+<a name="workingcollection">
+
+<h2>The Working Collection</h2>
+
+During a <i>CMS</i>4<i>talks</i>-session you probably don't want
+to search often used slides again and again. You can store a list
+of slides in the Working Collection, which looks like that:<br>
+
+<img src="images/workingcollection.gif"><p>
+
+It looks like a list of search results without the choose button.
+And indeed it is implemented just like that.<br> As we have
+already learned, there are some functions which get their slides
+from the working collection. E.g. see sections<br> <a
+href="#etg_1st">&quot;Attach first Slide to Talk&quot;</a> and <a
+href="#seg_prev">&quot;Attach previous Slide&quot;</a>.
+
+
+
+<hr>
+
+<a name="searchfunction">
+
+<h2>The Search Function</h2>
+
+Clicking the &quot;search for slides&quot;-button opens a new
+search results window. It looks similar to this:<br> <img
+src="images/foundgui.gif"><p>
+
+The following buttons are found:
+
+<ul>
+
+<li>refine... - starts a search within the already present
+results<br>i.e. all entries matching the new starts will be
+remained</li>
+
+<li>exclude... - excludes all results from the already present
+ones which match this search</li>
+
+<li>add... - searches further and adds matches to the list of
+results</li>
+
+<li>edit - opens the selected slide in a new slide edit
+window</li>
+
+<li>choose - adds the selected file to the <a
+href="workingcollection">Working Collection</a>
+</li>
+
+</ul>
+
+Clicking one of the three firstnamed buttons opens a small dialog
+prompting for what you want to search (or exclude).
+
+<h4>Wildcards</h4>
+
+You can chose between the search for keywords or for incomplete
+words using wildcards. The wildcard character * will allow you to
+search incomplete words like you know it from google e.g. <br>
+
+You can chose also another wildcard %. Using this wildcard the
+search will be automatically performed in fulltextmode i.e. the
+search will take long time, as the index cannot be used.<br>
+
+In general searches are performed case sensitive. If a search
+does not lead to any results, there will be automatically
+performed a case insensitive search.<br>
+
+Though forcing case insensitive search e.g. for the word
+<i>Sweden</i> can be indirectly done searching for <i>swedeN</i>.
+
+
+
+<hr>
+
+<p align="right"> <a
+href="mailto:jonReplacewithAtinformatik.uni-kiel.de"><img
+src="images/copyleft.gif"></a></p>
+
+
+
+
+ </BODY> </HTML>
diff --git a/support/cms4talks/Manual/manual.html b/support/cms4talks/Manual/manual.html
new file mode 100644
index 0000000000..3ba615900e
--- /dev/null
+++ b/support/cms4talks/Manual/manual.html
@@ -0,0 +1,553 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+"http://www.w3.org/TR/html4/loose.dtd"> <!--NewPage-->
+<HTML>
+
+<HEAD>
+
+<TITLE> CMS4talks - manual </TITLE>
+
+<META NAME="keywords" CONTENT="SlidePool manual">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="stylesheet.css" TITLE="Style">
+
+<!--SCRIPT type="text/javascript"> function windowTitle() {
+ parent.document.title="CMS4talks manual";
+}
+</SCRIPT>
+
+<NOSCRIPT> </NOSCRIPT-->
+
+</HEAD>
+
+<BODY BGCOLOR="white" onload="windowTitle();">
+
+<a name="topofpage"> <img src="CMS4talks.gif" alt="">
+
+<h1>
+
+CMS4talks - <i>user manual</i>
+
+</h1> <p STYLE="page-break-before: always"></p>
+
+<a href="#general">general Overview</a><br>
+
+<a href="#inst">Installation</a><br>
+
+<a href="#slideex">enhance(d) Slide Extraction</a><br>
+
+<a href="#talkeditgui">edit Talks</a><br>
+
+<a href="#slideeditgui">edit Slides</a><br>
+
+<a href="#workingcollection">The Working Collection</a><br>
+
+<a href="#searchfunction">The Search Function</a><br>
+
+
+<hr>
+
+<a name="inst">
+
+<h3>Installation</h3>
+
+<ul>
+
+<li>Get your copy of cms4talks.zip and unzip it to a favoured but
+empty directory.</li>
+
+<li>Make sure your system satisfies the <a
+href="index.html#requirements">requirements</a>.</li>
+
+<li>Ensure that you have the mysql-connector.jar in the classpath
+for your Java Runtime Environment. The file comes along with the
+installation and lies in the directory You have chosen for
+<i>CMS</i>4talks. So if <i>X:\prgs\CMS4talks</i> is Your
+directory then simply add
+<i>;"X:\prgs\CMS4talks\mysql-connector.jar"</i> to Your
+classpath.</li>
+
+<li>Run "java Install" in your command prompt and follow the
+instructions.</li>
+
+<li>It is save to delete all files with suffix <i>.java</i> if
+You don't want to proceed with the development of
+<i>CMS</i>4talks.</li>
+
+</ul>
+
+Now you can start working with <i>CMS</i>4<i>talks</i>.
+
+<hr>
+
+<a name="general">
+
+<h2>general Overwiew</h2>
+
+<h3>The Main Window</h3>
+
+After typing java CMS4talks (Be aware of case sensitivity!) you
+will see the main window.<br>
+
+<img src="images/main.gif"><br>
+
+Lets introduce the buttons (klick on the links for further
+details):
+
+<ul>
+
+<li><a href="#addtalk">add talk</a> - add a talk</li>
+
+<li><a href="#addtalks">add talks</a> - add a whole directory of
+talks</li>
+
+<li><a href="#prefpaths">Preferences: package paths</a> - manage
+the list of directories containing packages </li>
+
+<li><a href="#prefcommands">Preferences: preferred slide
+commands</a> - manage the list of directories containing packages
+</li>
+
+<li><a href="#workingcoll">show working collection</a></li>
+
+<li><a href="#talklist">show talk list</a></li>
+
+
+</ul>
+
+<a name="addtalk">
+
+<h3>add a talk</h3>
+
+After clicking this button a filechooser will pop up and ask you
+for a filename. Specify any talk and press "OK". The chosen file
+will be analyzed and if CMS4talks finds one and only one known
+command that describes slides, the talk will be automatically
+processed, i.e. the slides will be extracted and added to the
+database, as well as a talk representation within CMS4talks will
+be generated.
+
+<p STYLE="page-break-before: always" align="right"><a
+href="#topofpage"><img src="images/top.gif"></a>Go to <a
+href="#topofpage">top</a> of page.</p>
+
+<p STYLE="page-break-before: always"></p>
+
+
+<a name="addtalks">
+
+<h3>add talks</h3>
+
+After clicking this button a directorychooser will pop up and ask
+you for a directory. Specify any directory. All files in this
+directory will be analyzed and if they contain slide specifying
+commands or tags, they will be processed as if they where chosen
+by hands.
+
+<a name="prefpaths">
+
+<h3>preferred package paths</h3>
+
+If you click here a list of paths will pop upp. You can simply
+add or delete arbitrarily paths.<br> <img
+src="images/prefpaths.gif"><br>
+
+For succesfully examining given TeX-files CMS4talks needs to know
+where all your packages are being found. All packages in a
+TeX-file will be checked for new commands. All of them which are
+includes in the <a href="#prefcommands">preferred slide commands
+list</a>, whill be handled as commands specifying slides.
+
+<p STYLE="page-break-before: always" align="right"><a
+href="#topofpage"><img src="images/top.gif"></a>Go to <a
+href="#topofpage">top</a> of page.</p>
+
+<p STYLE="page-break-before: always"></p>
+
+<a name="prefcommands">
+
+<h3>preferred slide commands list</h3>
+
+If you click here a list of slide specifying TeX-commands will
+pop upp. You can simply add or delete them or change their
+priority.<br> <img src="images/prefcommands.gif"><br>
+
+For succesfully examining given TeX-files CMS4talks needs to know
+which commands specify individual slides.<br>
+
+Lern more about slide commands and enhanced slide extraction <a
+href="#slideex">here</a>.
+
+<p STYLE="page-break-before: always" align="right"><a
+href="#topofpage"><img src="images/top.gif"></a>Go to <a
+href="#topofpage">top</a> of page.</p>
+
+<p STYLE="page-break-before: always"></p>
+
+<a name="workingcoll">
+
+<h3>show working collection</h3>
+
+During a CMS4talks session you may want to gather a collection of
+some slides. The working collection is a sort of clipboard where
+you easily can acces often used slides.
+
+<a name="talklist">
+
+<h3>show talk list</h3>
+
+After clicking here a list of all talks contained in CMS4talks
+database appears. It will look similar to the example shown.<br>
+<img src="images/talklistgui.gif"><br>Push &quot;edit&quot; to
+edit selected talk.
+
+<p STYLE="page-break-before: always" align="right"><a
+href="#topofpage"><img src="images/top.gif"></a>Go to <a
+href="#topofpage">top</a> of page.</p>
+
+<p STYLE="page-break-before: always"></p>
+
+<hr>
+
+<a name="slideex">
+
+<h2>enhance(d) Slide Extraction</h2>
+
+In your LaTeX-talk slides can be defined in two way. One way is
+that slides are defined between two tags like<br>
+
+<i>\begin{slide}</i> and<br>
+
+<i>\end{slide}</i> or they can be defined in a defined command
+that has the slide and sometimes even the title or some more
+information as its arguments. An example with two arguments could
+be <br>
+
+<i>\creatslide{this is a sample title}{this is the slide`s text
+source}</i>.
+
+For determining in which way slides are defined in your talks
+CMS4talks will ask you every time you want to add a talk. You can
+avoid being asked in most of the times if you provide CMS4talks
+some information:<br>
+
+All talks which shall be loades will parsed an all packages which
+are used within the talk are searched. They will be searched in
+the <a href="#prefpaths">preferred paths list</a>. So keep this
+list up to date.<p>
+
+If you add a talk, all new defined commands and redefined
+commands within the used packages as well as within the talk
+itself will be compared to the <a href="#prefcommands">preferred
+commands list</a>.<br>
+
+If only one of the commands is found in this list, then the slide
+defining command is well defined for this talk, and can be added
+to the system immediately without asking for the right command.
+
+While adding a whole directory (&quot;add talks&quot;) you won't
+be asked for the proper command. Therefore using this function
+requires preferably complete <a href="#prefpaths">preferred paths
+list</a> and <a href="#prefcommands">preferred commands list</a>.
+
+<p STYLE="page-break-before: always" align="right"><a
+href="#topofpage"><img src="images/top.gif"></a>Go to <a
+href="#topofpage">top</a> of page.</p>
+
+<p STYLE="page-break-before: always"></p>
+
+<hr>
+
+<a name="talkeditgui">
+
+<h2>edit Talks</h2>
+
+Choosing a talk in the talk list, will pop up a window similar to
+this one:<br>
+
+<img src="images/talkeditgui.gif">
+
+<p>
+
+Lets describe the buttons and functions:
+
+<ul>
+
+<li>undo all changes - loads talk again from database</li>
+
+<li>save changes - saves the changes you made in this
+window<br><b>NOTE:</b>It ist possible to open the same talk in
+several different windows, saving won't recognize that. </li>
+
+<li>save as new - saves a new copy(version) of this talk</li>
+
+
+
+<li><a href="#etg_1st">1st slide</a> - attach talk`s first
+slide</li>
+
+<li><a href="#etg_go">go</a> - go to talk`s first slide</li>
+
+<li><a href="#etg_ex">export</a> - export this talk to disk</li>
+
+</ul>
+
+<a name="etg_1st">
+
+<h3>Attach first Slide to Talk</h3>
+
+Every talk that is added to cms4talk via &quot;add talk&quot; or
+&quot;add talks&quot; should automatically have its first slide
+attached to the talk edit window. If you rearange a talk you can
+attach any other slide as first slide to this talk and it is as
+easy as this: Select in the <a href="#workingcollection">working
+collection</a> the desired slide and push &quot;1st slide&quot;
+in the talk edit window. <b>NOTE:</b>Don`t forget to save changes.
+
+<p STYLE="page-break-before: always" align="right"><a
+href="#topofpage"><img src="images/top.gif"></a>Go to <a
+href="#topofpage">top</a> of page.</p>
+
+<p STYLE="page-break-before: always"></p>
+
+
+<a name="etg_go">
+
+<h3>Go to Talk`s first Slide</h3>
+
+If there is a first slide attached to the talk, pushing this
+button will open a slide edit window with the talk`s first slide.
+
+<a name="etg_ex">
+
+<h3>Export a Talk to Disk</h3>
+
+Having edited some slides and rearanged a talk or created a new
+talk, you might want to export it to disk (e.g. for further
+finetuning within your TeX-system and .ps-processing...).<br>
+Clicking &quot;export&quot; will open a filechooser. Select a
+filename and CMS4talks will write the entire talk to disk. If you
+set up the slide order properly the ordering of the slides in
+this talk will be as excepted. Nevertheless if some cycles appear
+(e.g. if you attach a talk`s first slide to some later slides as
+next slide) CMS4talk will recognize that and finish before
+cycling.<p> Learn more about the slide order <a
+href="#slideorder">here</a>.
+
+<p STYLE="page-break-before: always" align="right"><a
+href="#topofpage"><img src="images/top.gif"></a>Go to <a
+href="#topofpage">top</a> of page.</p>
+
+<p STYLE="page-break-before: always"></p>
+
+<hr>
+
+<a name="slideeditgui">
+
+<h2>edit Slides</h2>
+
+Choosing a slide from a list of search results, the working
+collection or a talk window, will pop up a window similar to
+this:<br>
+
+<img src="images/slideeditgui.gif">
+
+<p>
+
+Lets describe some buttons and functions:
+
+<ul>
+
+<li>undo all changes - loads slide again from database</li>
+
+<li>save changes - saves the changes you made in this
+window<br><b>NOTE:</b>It ist possible to open the same slide in
+several different windows, saving won't recognize that. </li>
+
+<li>save as new - saves a new copy(version) of this slide</li>
+
+
+<li>go - go to next/previous slide</li>
+
+
+<li>add this slide to working collection - adds this slide to the
+working collection</li>
+
+<li><a href="#seg_go">go</a> - go to next/previous slide</li>
+
+<li><a href="#seg_prev">prev:</a> - attach previous slide</li>
+
+<li><a href="#seg_next">next:</a> - attach next slide</li>
+
+<li><a href="#seg_talk">talk:</a> - attach talk</li>
+
+<li><a href="#seg_go">remove</a> - detach next/previous slide</li>
+
+</ul>
+
+
+<p STYLE="page-break-before: always" align="right"><a
+href="#topofpage"><img src="images/top.gif"></a>Go to <a
+href="#topofpage">top</a> of page.</p>
+
+<p STYLE="page-break-before: always"></p>
+
+
+<a name="seg_go">
+
+<h3>Go to next/previous slide</h3>
+
+Push this button to go to previous/next slide. It will appear in
+the same slide edit window.
+
+<hr>
+
+<a name="slideorder">
+
+<h2>Setting up the Slide Order</h2>
+
+With the possibility of assigning successors and predecessors to
+all slides you can arrange slides in any order. Keep in mind that
+a wise order is the assumption for success in <a
+href="#etg_ex"exporting</a> talks.
+
+
+<a name="seg_prev">
+
+<h3>Attach previous Slide</h3>
+
+If you rearange the slidesī order you can attach any other slide
+as previous slide to this slide, and it is as easy as this:
+Select in the <a href="#workingcollection">working collection</a>
+the desired slide and push &quot;prev:&quot;. <b>NOTE:</b>Don`t
+forget to save changes.
+
+<a name="seg_next">
+
+<h3>Attach next Slide</h3>
+
+You can assign the next slide in the same manner as previous
+slides are assigned.
+
+
+<h3>Hint:</h3>
+
+Having the possibility of assigning the next as well as the
+previous slide might be confusing because in fact it is redundant
+having both possibilities. Open the file <i>preferences.ini</i>
+you find in the directory where <i>CMS</i>4<i>talks</i> is
+installed and change the entry <i>true</i> in line #20 to
+<i>false</i>. In future versions this setting may be altered more
+comfortably .
+
+<a name="seg_talk">
+
+<h3>Attach Talk</h3>
+
+You can assign a talk slide in the same manner as slides are
+assigned. You simply chose the talk to be attached from the list
+of talks. This function enhances the export to disk: If a slide
+has more than one predecessor, the exporting algorithm first
+checks if there is a predecessing slide which belongs to the
+"right" talk, and choses this slide in that case.
+
+
+<p STYLE="page-break-before: always" align="right"><a
+href="#topofpage"><img src="images/top.gif"></a>Go to <a
+href="#topofpage">top</a> of page.</p>
+
+<p STYLE="page-break-before: always"></p>
+
+<hr>
+
+<a name="workingcollection">
+
+<h2>The Working Collection</h2>
+
+During a <i>CMS</i>4<i>talks</i>-session you probably don't want
+to search often used slides again and again. You can store a list
+of slides in the Working Collection, which looks like that:<br>
+
+<img src="images/workingcollection.gif"><p>
+
+It looks like a list of search results without the choose button.
+And indeed it is implemented just like that.<br> As we have
+already learned, there are some functions which get their slides
+from the working collection. E.g. see sections<br> <a
+href="#etg_1st">&quot;Attach first Slide to Talk&quot;</a> and <a
+href="#seg_prev">&quot;Attach previous Slide&quot;</a>.
+
+<p STYLE="page-break-before: always" align="right"><a
+href="#topofpage"><img src="images/top.gif"></a>Go to <a
+href="#topofpage">top</a> of page.</p>
+
+<p STYLE="page-break-before: always"></p>
+
+
+<hr>
+
+<a name="searchfunction">
+
+<h2>The Search Function</h2>
+
+Clicking the &quot;search for slides&quot;-button opens a new
+search results window. It looks similar to this:<br> <img
+src="images/foundgui.gif"><p>
+
+The following buttons are found:
+
+<ul>
+
+<li>refine... - starts a search within the already present
+results<br>i.e. all entries matching the new starts will be
+remained</li>
+
+<li>exclude... - excludes all results from the already present
+ones which match this search</li>
+
+<li>add... - searches further and adds matches to the list of
+results</li>
+
+<li>edit - opens the selected slide in a new slide edit
+window</li>
+
+<li>choose - adds the selected file to the <a
+href="workingcollection">Working Collection</a>
+</li>
+
+</ul>
+
+Clicking one of the three firstnamed buttons opens a small dialog
+prompting for what you want to search (or exclude).
+
+<h4>Wildcards</h4>
+
+You can chose between the search for keywords or for incomplete
+words using wildcards. The wildcard character * will allow you to
+search incomplete words like you know it from google e.g. <br>
+
+You can chose also another wildcard %. Using this wildcard the
+search will be automatically performed in fulltextmode i.e. the
+search will take long time, as the index cannot be used.<br>
+
+In general searches are performed case sensitive. If a search
+does not lead to any results, there will be automatically
+performed a case insensitive search.<br>
+
+Though forcing case insensitive search e.g. for the word
+<i>Sweden</i> can be indirectly done searching for <i>swedeN</i>.
+
+
+<p STYLE="page-break-before: always" align="right"><a
+href="#topofpage"><img src="images/top.gif"></a>Go to <a
+href="#topofpage">top</a> of page.</p>
+
+<hr>
+
+<p align="right"> <a
+href="mailto:jonReplacewithAtinformatik.uni-kiel.de"><img
+src="images/copyleft.gif"></a></p>
+
+
+
+
+ </BODY> </HTML>