KDissert 1.0.7, Thomas Nagy <tnagy2^8@yahoo.fr>
GPL licence (see COPYING)

Delete this program from your computer immediately
if you don't agree with the terms of the licence

It is recommended to have a look at the following documents :
INSTALL :  to see how to run this piece of software
ROADMAP :  make sure to read it carefully before reporting a wish or a bug

The debugging information written into the console during the use of kdissert
can be ignored (except if the application crashes, in this case make a bug report).

Background color : the old color (light-blue) was #E3F1FF

The recommended use is the following (look also in the ROADMAP for the main usecase) :
1 Start by adding objects - add as many unique ideas as possible
2 Switch to link mode and start linking your ideas
3 Delete irrelevant objects, balance the tree (3-4 objects by branch on the average, no more than 5 ancestors)
4 Add text and pictures to the map objects - the more, the better (in reports, pictures especially)
5 Switch to sort mode and sort the branches by order of relevance
6 Generate your documents and work on them (LaTeX, OpenOffice, ..)

Do not forget to read the documentation, the tips and the shortcut editor
Here is a quick list of the advanced features (documentation may not be up-to-date) :
* The summary can be typed directly when one object is selected
* Double-click with ctrl key pressed on links removes them
* Double-click with ctrl key pressed on an object disconnects it
* Clicking sequentially on items with ctrl key held links objects
* Clicking on an item selects it
* Clicking on an item with both ctrl and alt key pressed selects the whole subtree
* Holding shift key during selection allows the selection of multiple items or subtrees
* control+scroll wheel on objects selected increases or decreases their font sizes
* Cycle through the list of roots using control+COMMA (',' - configure it in the shortcut editor)
* Move on the mindmap view with control+arrows, move mindmap objects with alt+arrows
* Use the square on the top right corner of the panels to make them stay
* Use the keys F2 and F3 to switch the focus between the text panel and the map
  Also do not forget to maximize the text panel using the little square on the top-right corner :-)
* Dropping text onto the mindmap or in mindmap items is possible
* The inline editor can be raised using the keys a, e or i - look in the settings dialog
  if the previous behaviour is desired

If you encounter issues with LaTeX documents and unicode, you might solve it by installing
xmltex and related packages (worked for me on Fedora Core 3)

To generate documents on the command-line one may use kdissert like this:
kdissert -g kdisspdflatexarticle -g kdissOOOdoc -p folder file.kdi

It may be convenient to make scripts, the following may be helpful:

-----------------------------------------------------------
#! /bin/sh
DIR=/tmp/atest/
rm -rf $DIR
# generate the document
kdissert -g kdisspdflatexarticle -p $DIR /home/ita/SGD/sgd.kdi
pushd $DIR/kdisspdflatexarticle
# substitutions
perl -pi -e "s/\%\\ \\\\usepackage\[frenchb\]/\\\\usepackage[frenchb]/" main.tex
# compile the latex document
make
rm -f main.pdf
make view
-----------------------------------------------------------

To retrieve the translations:
for i in `cat lst.txt`; do
        echo $i;
        svn cat svn://anonsvn.kde.org/home/kde/trunk/l10n/$i/messages/playground-edu/kdissert.po >> $i.po
done


Enjoy kdissert,
Thomas Nagy

