tex/vym.tex
author insilmaril
Fri Jul 08 08:06:36 2005 +0000 (2005-07-08)
changeset 124 e0f6a21cc6d6
parent 106 4083860dd82e
child 125 8cdfa8dda71e
permissions -rw-r--r--
corrected vym.tex
insilmaril@28
     1
\documentclass{article}
insilmaril@28
     2
\usepackage{a4}
insilmaril@28
     3
\usepackage[latin1]{inputenc}
insilmaril@28
     4
\usepackage{verbatim}
insilmaril@28
     5
\usepackage{hyperref}
insilmaril@28
     6
\usepackage{graphicx}
insilmaril@28
     7
\usepackage{longtable}
insilmaril@28
     8
insilmaril@28
     9
insilmaril@28
    10
%\input{udmath}
insilmaril@28
    11
insilmaril@28
    12
insilmaril@28
    13
\hypersetup{bookmarks, bookmarksopen,
insilmaril@28
    14
  pdftitle={VYM - a tool for visual thinking },
insilmaril@28
    15
  pdfauthor={Uwe Drechsel},    
insilmaril@28
    16
  pdfsubject={map},
insilmaril@28
    17
  pdfkeywords={map, tool},
insilmaril@28
    18
  pdfpagemode={UseOutlines},                                 
insilmaril@28
    19
  bookmarksopenlevel={1},   
insilmaril@28
    20
  colorlinks={true},     
insilmaril@28
    21
  linkcolor={blue},
insilmaril@28
    22
  urlcolor={green},
insilmaril@28
    23
  citecolor={red}} 
insilmaril@28
    24
insilmaril@28
    25
insilmaril@28
    26
\newcommand{\vym}{{\sc vym }}
insilmaril@28
    27
\newcommand{\ra}{$\longrightarrow$}
insilmaril@28
    28
\newcommand{\la}{$\longleftarrow$}
insilmaril@28
    29
\newcommand{\ua}{$\uparrow$}
insilmaril@28
    30
\newcommand{\da}{$\downarrow$}
insilmaril@28
    31
\newcommand{\key}[1]{[#1]}
insilmaril@28
    32
insilmaril@28
    33
\begin{document}
insilmaril@28
    34
\title{VYM \\ -- \\View Your Mind}
insilmaril@28
    35
\author{\textcopyright Uwe Drechsel  }
insilmaril@28
    36
insilmaril@28
    37
\maketitle
insilmaril@28
    38
insilmaril@28
    39
\tableofcontents
insilmaril@28
    40
insilmaril@28
    41
\newpage
insilmaril@28
    42
insilmaril@28
    43
\section{Introduction}
insilmaril@28
    44
\subsection{What is a \vym map?}
insilmaril@28
    45
A \vym map (in short words {\em map}) is a tree like structure:
insilmaril@28
    46
\begin{center}
insilmaril@28
    47
	\includegraphics[width=12cm]{example1.png}
insilmaril@28
    48
\end{center}
insilmaril@28
    49
Such maps can be drawn by hand on paper or a flip chart and help to
insilmaril@28
    50
structure your thoughs. While a tree like structure like above can be
insilmaril@28
    51
drawn by hand or any drawing software \vym offers
insilmaril@28
    52
much more features to work with such maps. \vym is not another drawing
insilmaril@28
    53
software, but a tool to store and modify information in an intuitive
insilmaril@28
    54
way. For example you can reorder parts of the map by pressing a key or
insilmaril@28
    55
add various information like a complete email by a simple mouse click.
insilmaril@28
    56
insilmaril@28
    57
\subsection{Why should I use maps? Time, Space and your Brain.}
insilmaril@28
    58
\subsubsection*{Space}
insilmaril@28
    59
A map can concentrate a very complex content on little space e.g. a
insilmaril@28
    60
piece of paper. It helps to use both sides of your brain: the logical
insilmaril@28
    61
side and also your creative side (e.g. by using pictures, colors and
insilmaril@28
    62
keywords in a map, so called {\em anchors}).  It is a technique to
insilmaril@28
    63
organize the way you think: It can help you by developing, sorting and
insilmaril@28
    64
memorizing your thoughts. 
insilmaril@28
    65
insilmaril@28
    66
\subsubsection*{Time}
insilmaril@28
    67
Because you just use keywords and drawings, it is much faster than good
insilmaril@28
    68
old fashioned notes. Your brain memorizes things by associating them to
insilmaril@28
    69
other things -- a map makes use of those connections and stimulates
insilmaril@28
    70
new asccociations. 
insilmaril@28
    71
insilmaril@28
    72
\subsubsection*{Your Brain}
insilmaril@28
    73
In 1960 the Prof. {\sc Roger Sperry} discovered that both hemispheres
insilmaril@28
    74
of the human brain have different tasks (of course both of them
insilmaril@28
    75
basically {\em can} do the same): The left side is specialised in 
insilmaril@28
    76
\begin{itemize}
insilmaril@28
    77
   \item verbal speech and writing 
insilmaril@28
    78
   \item numbers
insilmaril@28
    79
   \item logical thinking
insilmaril@28
    80
   \item analyzing and details
insilmaril@28
    81
   \item science
insilmaril@28
    82
   \item linear thinking
insilmaril@28
    83
   \item concept of time
insilmaril@28
    84
\end{itemize}
insilmaril@28
    85
while the right side of the human brain is specialised in
insilmaril@28
    86
\begin{itemize}
insilmaril@28
    87
    \item body language
insilmaril@28
    88
    \item visual thinking, day dreams
insilmaril@28
    89
    \item intuition and emotion
insilmaril@28
    90
    \item overview of things
insilmaril@28
    91
    \item creativity
insilmaril@28
    92
    \item art, music, dancing
insilmaril@28
    93
    \item non-linear thinking, connecting things
insilmaril@28
    94
    \item spatial awareness
insilmaril@28
    95
\end{itemize}    
insilmaril@28
    96
In our science oriented society we have learned to mainly rely on our
insilmaril@28
    97
left side of the brain, the "rational" one. In other cultures,
insilmaril@28
    98
especially like the native americans and other "old" cultures, the right
insilmaril@28
    99
side is much more important. maps are just one way to stimulate the
insilmaril@28
   100
other side and make use of additional ressources we all have.
insilmaril@28
   101
insilmaril@28
   102
insilmaril@28
   103
\subsection{Where could I use a map?}
insilmaril@28
   104
Here are some examples, how you can use those maps
insilmaril@28
   105
\begin{itemize}
insilmaril@28
   106
    \item to prepare articles, papers, books, talks, \ldots
insilmaril@28
   107
    \item to sort complex data
insilmaril@28
   108
    \item to memorize facts, persons, vocabulary, \ldots
insilmaril@28
   109
    \item to sort emails, files and bookmarks on your computer
insilmaril@28
   110
    \item to moderate conferences
insilmaril@28
   111
\end{itemize}
insilmaril@28
   112
insilmaril@28
   113
\subsection{What you shouldn't do with a map...}
insilmaril@28
   114
A map drawn by somebody shows the way the author thinks. There is
insilmaril@28
   115
no right or wrong in the way it is drawn, so there is no way to critize
insilmaril@28
   116
it. "It is, what it is" ({\sc F.~Lehmann}).
insilmaril@28
   117
insilmaril@28
   118
%\section{Tutorials}
insilmaril@28
   119
%TODO
insilmaril@28
   120
insilmaril@28
   121
\section{Concept}
insilmaril@28
   122
insilmaril@28
   123
%TODO may add a general introduction here...
insilmaril@28
   124
insilmaril@28
   125
\vym uses two windows: an editor for the map itself and another one for
insilmaril@28
   126
notes, which are part of the map. Let's call them {\em mapeditor} and
insilmaril@28
   127
{\em noteeditor}: 
insilmaril@28
   128
\begin{center}
insilmaril@28
   129
	\includegraphics[width=8cm]{windows.png}
insilmaril@28
   130
\end{center}
insilmaril@28
   131
Usually you will work in the {\em mapeditor} by just adding new
insilmaril@28
   132
branches, moving around and reordering them. The various ways to do this
insilmaril@28
   133
will be explained in \ref{mapeditor}. You can store additional
insilmaril@28
   134
information e.g. the content of a email easily in a {\em branch}: Just
insilmaril@28
   135
type or copy\&paste it into the {\em noteeditor}. Working with notes is
insilmaril@28
   136
explained in \ref{noteeditor}
insilmaril@28
   137
insilmaril@28
   138
The map itself has always a {\em mapcenter}.  The
insilmaril@28
   139
mapcenter has {\em branches} just like the trunk of a tree. Each branch
insilmaril@28
   140
in turn may have branches again.
insilmaril@28
   141
\begin{center}
insilmaril@28
   142
	\includegraphics[width=10cm]{branches.png}
insilmaril@28
   143
\end{center}
insilmaril@28
   144
We will call a branch directly connected to the mapcenter a {\em
insilmaril@28
   145
mainbranch}, because it determines the position of all its child
insilmaril@28
   146
branches.
insilmaril@28
   147
insilmaril@28
   148
The mapcenter and the branches all have a {\em heading}. This is the
insilmaril@28
   149
text you see in the mapeditor. Usually it should just be one or a few
insilmaril@28
   150
words, so that one can easily keep track of the whole map.
insilmaril@28
   151
insilmaril@28
   152
insilmaril@28
   153
In the toolbar above the mapeditor you see various symbols.
insilmaril@28
   154
\begin{center}
insilmaril@28
   155
	\includegraphics[width=8cm]{default-flags.png}
insilmaril@28
   156
\end{center}
insilmaril@28
   157
These are called {\em flags} and can be used to mark branches in the
insilmaril@28
   158
map, e.g. if something is important or questionable. 
insilmaril@28
   159
There are also more flags set by \vym automatically to show additional
insilmaril@28
   160
information, e.g. when a  exists for a  particular branch.
insilmaril@28
   161
insilmaril@104
   162
By default some of these flags are set exclusively e.g. when the \lq
insilmaril@104
   163
thumb-up\rq flag is set, then the \lq thumb down\rq is unset and vice
insilmaril@104
   164
versa. You can change this default behaviour in the settings menu.
insilmaril@104
   165
insilmaril@28
   166
\section{Mapeditor} \label {mapeditor}
insilmaril@28
   167
\subsection{Start a new map}
insilmaril@28
   168
After \vym is started two windows will open: the mapeditor and the
insilmaril@28
   169
noteditor. Usually you will work in both windows, but at the moment we
insilmaril@28
   170
will just need the mapeditor. 
insilmaril@28
   171
insilmaril@28
   172
Select the mapcenter "New map" in the middle of the mapeditor by
insilmaril@28
   173
left-clicking with the mouse. It will turn yellow to show that is
insilmaril@103
   174
selected. There are several ways to add a new branch to the center:
insilmaril@28
   175
\begin{itemize}
insilmaril@103
   176
	\item Using the mouse: Open the context meny by clicking with the
insilmaril@103
   177
	right mouse button (CTRL-Click on Mac) onto the
insilmaril@103
   178
	mapcenter and choose Add \ra Add as child
insilmaril@103
   179
	\item Press \key{Ins} or \key{A}
insilmaril@28
   180
\end{itemize}
insilmaril@28
   181
A new branch will appear and you will be able to type the heading of the
insilmaril@28
   182
branch. Finish adding the new branch by pressing \key{Enter}.
insilmaril@28
   183
%tipp
insilmaril@28
   184
Sometimes it comes handy to add a new branch above or below the current
insilmaril@104
   185
one. Use \key{Ins} together with \key{Shift} or \key{Ctrl}. It is also
insilmaril@104
   186
possible to add a branch in such a way, that the current selection
insilmaril@104
   187
becomes the child of the new branch, which is like inserting it {\em
insilmaril@104
   188
before} the selection. This can be done using the context menu.
insilmaril@28
   189
insilmaril@28
   190
\subsection{Navigate through a map}
insilmaril@28
   191
\subsubsection*{Select branches}
insilmaril@28
   192
To select branches you can use the left button of your mouse or also the
insilmaril@28
   193
arrow keys. Depending on the {\em orientation} of a branch type
insilmaril@28
   194
\key{\la} or \key{\ra} to get nearer to the mapcenter or deeper
insilmaril@28
   195
down into the branches. Within a set of branches, let's call them a 
insilmaril@28
   196
{\em subtree}, you can use \key{\ua} and \key{\da} to go up and down. You can
insilmaril@28
   197
also use \key{Pos1} and \key{End} to select the first and last branch.
insilmaril@28
   198
insilmaril@28
   199
insilmaril@28
   200
\subsubsection*{Zoom a map}
insilmaril@28
   201
While adding more and more branches the size of the map may become
insilmaril@28
   202
bigger than the mapeditor window. You can use the scrollbars on the
insilmaril@28
   203
right and the bottom of your mapeditor window to scroll, but it is
insilmaril@28
   204
easier to just scroll using the left mouse button: Click onto the {\em
insilmaril@28
   205
canvas} itself, the empty space somewhere between the branches. The
insilmaril@28
   206
mouse pointer will change from an arrow to a hand, now move the visible
insilmaril@28
   207
part of the map to show the desired part.
insilmaril@28
   208
insilmaril@28
   209
If you select branches using the arrow keys, the map will scroll
insilmaril@28
   210
to ensure that the selected branch is always visible.
insilmaril@28
   211
insilmaril@28
   212
Working with huge maps, the {\em zoom}-function comes in handy: You can
insilmaril@28
   213
use 
insilmaril@28
   214
\begin{itemize}
insilmaril@28
   215
	\item from the menu View \ra Zoom
insilmaril@28
   216
	\item the toolbar buttons 
insilmaril@28
   217
		\begin{center}
insilmaril@28
   218
			\includegraphics[width=3cm]{zoom-buttons.png}
insilmaril@28
   219
		\end{center}	
insilmaril@28
   220
\end{itemize}	
insilmaril@28
   221
The crossed magnifying lens resets the zoomed view to its original size.
insilmaril@28
   222
insilmaril@28
   223
insilmaril@28
   224
\subsubsection*{Find Function} \label{findwindow}
insilmaril@28
   225
With huge maps there is the need to have a
insilmaril@28
   226
find function. Choose Edit \ra Find to open the Find Window:
insilmaril@28
   227
\begin{center}
insilmaril@28
   228
	\includegraphics[width=6cm]{find-window.png}
insilmaril@28
   229
\end{center}	
insilmaril@28
   230
The text you enter here will be searched in all the headings and also in
insilmaril@28
   231
notes. Everytime you press the "Find"-button it will look for the next
insilmaril@28
   232
occurence, which then will be selected automatically. If the search
insilmaril@28
   233
fails, there will appear a short message "Nothing found" or a few
insilmaril@28
   234
seconds in the {\em statusbar} on the bottom of the mapeditor.
insilmaril@28
   235
insilmaril@28
   236
\subsubsection*{Scroll a part of the map}
insilmaril@28
   237
A very big subtree of a map e.g. a branch with hundreds of childs makes
insilmaril@28
   238
it very hard to keep an overview over the whole map. You can hide all
insilmaril@28
   239
the childs of a branch by {\em scrolling} it -- this function is also
insilmaril@28
   240
often called {\em folding}. Think of the whole subtree as painted onto a
insilmaril@28
   241
big newspaper. You can scroll the paper to a small roll, leaving just
insilmaril@28
   242
the headline readable.
insilmaril@28
   243
insilmaril@28
   244
To scroll or unscroll a branch and its childs, press the
insilmaril@28
   245
\begin{itemize}
insilmaril@103
   246
	\item \key{Scroll} key or  \key{S}
insilmaril@28
   247
	\item press the middle-mouse button or
insilmaril@28
   248
	\item choose the little scroll from the toolbar.
insilmaril@28
   249
\end{itemize}
insilmaril@28
   250
If you select parts of a scrolled branch e.g. using the find function or
insilmaril@28
   251
by using the arrow-keys, it will unscroll temporary. This is shown as a
insilmaril@28
   252
scroll with a little hour glass. If the temporary unscrolled part is not
insilmaril@28
   253
longer needed, it will be hidden again automatically. It is also
insilmaril@28
   254
possible to unscroll all branches using "Edit\ra Unscroll all scrolled
insilmaril@28
   255
branches".
insilmaril@28
   256
insilmaril@28
   257
insilmaril@28
   258
insilmaril@28
   259
\subsection{Modify and move branches}
insilmaril@28
   260
\subsubsection*{Modify the heading of a branch}
insilmaril@28
   261
You can edit the heading by selecting the branch and then
insilmaril@28
   262
\begin{itemize}
insilmaril@28
   263
	\item pressing \key{Enter}
insilmaril@28
   264
	\item double-clicking with left mouse.
insilmaril@28
   265
\end{itemize}
insilmaril@28
   266
Just type the new heading (or edit the old one) and press \key{Enter}.
insilmaril@28
   267
insilmaril@28
   268
\subsubsection*{Move a branch}
insilmaril@28
   269
The easiest way to move a branch is to select it with left-mouse and
insilmaril@28
   270
drag it to the destination while keeping the mouse button pressed.
insilmaril@28
   271
Depending on the branch  it will be
insilmaril@28
   272
\begin{itemize}
insilmaril@28
   273
	\item moved to the destination or
insilmaril@28
   274
	\item {\em linked} to a new {\em parent} (mapcenter or branch)
insilmaril@28
   275
\end{itemize}
insilmaril@28
   276
If you drag the branch over another one or over the mapcenter, you will
insilmaril@28
   277
notice that the  link connecting it to the old parent will be changed to
insilmaril@28
   278
lead to the  new parent which is now under your mousepointer. 
insilmaril@28
   279
If you release the button now, the branch will be relinked.
insilmaril@28
   280
insilmaril@28
   281
If you release the button in the middle of nowhere, the result will
insilmaril@28
   282
depend on the type of branch you are releasing:
insilmaril@28
   283
\begin{itemize}
insilmaril@28
   284
	\item A mainbranch is directly connected to the mapcenter.
insilmaril@28
   285
		It will stay on its new position.
insilmaril@28
   286
	\item An ordinary branch will "jump" back to its original position.	
insilmaril@28
   287
\end{itemize}
insilmaril@28
   288
Thus you can easily rearrange the layout of the mainbranches to avoid
insilmaril@28
   289
overlapping of their subtrees.
insilmaril@28
   290
There is another convenient way to move branches, especially if you want
insilmaril@28
   291
to {\em reorder} a subtree: You can move a branch up or down in a
insilmaril@28
   292
subtree by
insilmaril@28
   293
\begin{itemize}
insilmaril@28
   294
	\item pressing \key{\ua} and \key {\da}
insilmaril@28
   295
	\item selecting Edit \ra Move branch
insilmaril@28
   296
	\item clicking on the toolbar buttons:
insilmaril@28
   297
		\begin{center}
insilmaril@28
   298
			\includegraphics[width=1.5cm]{move-buttons.png}
insilmaril@28
   299
		\end{center}	
insilmaril@28
   300
\end{itemize}
insilmaril@28
   301
%tipp
insilmaril@28
   302
There is yet another way to move branches: If you press \key{Shift} or
insilmaril@28
   303
\key{Ctrl} while moving with the mouse, the branch will be added above
insilmaril@28
   304
or below the one the mouse pointer is over. This helps also to reorder a
insilmaril@28
   305
map.
insilmaril@28
   306
insilmaril@28
   307
\subsection{The right side of your brain - colors and images}
insilmaril@28
   308
\subsubsection*{Change color of a heading}
insilmaril@28
   309
You can also use colors to put more information into a map, e.g. use
insilmaril@28
   310
red, green and more colors to prioritize tasks. Again you can
insilmaril@28
   311
\begin{itemize}
insilmaril@28
   312
	\item use the menu and choose e.g Format \rq Set Color
insilmaril@28
   313
	\item use the toolbar
insilmaril@28
   314
		\begin{center}
insilmaril@28
   315
			\includegraphics[width=3cm]{color-buttons.png}
insilmaril@28
   316
		\end{center}	
insilmaril@28
   317
\end{itemize}
insilmaril@28
   318
The first button (black in the graphic above) shows the actual color.
insilmaril@28
   319
Clicking on it let's you choose another color. You can also "pick"
insilmaril@28
   320
another color by selecting a branch with the desired color and using the
insilmaril@28
   321
"pick color" button. Both of the buttons showing a bucket actually put
insilmaril@28
   322
the current color to the selected branch. While the first one just
insilmaril@28
   323
colors the heading of the selection, the last one also colors all the
insilmaril@28
   324
childs of the selected branch.
insilmaril@28
   325
insilmaril@28
   326
%tipp
insilmaril@28
   327
A very useful function is the "copy color" using the mouse: Select the
insilmaril@28
   328
branch which should get the new color, then press \key{Ctrl} and
insilmaril@28
   329
simultanously click with left-mouse on another branch to copy its color
insilmaril@28
   330
to the first one. Here the childs of the selection also will get the new
insilmaril@28
   331
color, if you just want to color the selection itself, additionally
insilmaril@28
   332
press \key{Shift}.
insilmaril@28
   333
insilmaril@28
   334
\subsubsection*{Use flags}
insilmaril@28
   335
\vym provides various flags. You see them in the toolbar on top of the
insilmaril@28
   336
mapeditor window. (Note: Like all toolbars you can also move them to the
insilmaril@28
   337
left or the right side of the window or even detach them. Just grab the
insilmaril@28
   338
very left "dotted" part of the toolbar with your left-mouse button.) 
insilmaril@28
   339
\begin{center}
insilmaril@28
   340
	\includegraphics[width=8cm]{default-flags.png}
insilmaril@28
   341
\end{center}
insilmaril@28
   342
If you have a branch selected, you can set any number of flags by
insilmaril@28
   343
clicking them in the toolbar. The toolbar buttons change their state and
insilmaril@28
   344
always reflect the flags set in the selected branch.
insilmaril@28
   345
insilmaril@28
   346
Presently \vym uses two kinds of flags: {\em System Flags} and {\em
insilmaril@28
   347
Standard Flags}. The standard flags are those shown in the toolbar.
insilmaril@28
   348
System flags are set by \vym to indicate e.g. that there is additional
insilmaril@28
   349
information in a note (more on this in \ref{noteeditor}). Later versions
insilmaril@28
   350
of \vym may have another kind of flags, which may be edited by the user.
insilmaril@28
   351
insilmaril@28
   352
\subsubsection*{Images}
insilmaril@28
   353
You can add a image to a branch or the mapcenter by clicking with the
insilmaril@28
   354
right-mouse button. A context menu will open, choose "Add Image". A
insilmaril@28
   355
dialog window lets you choose the image to load. 
insilmaril@28
   356
\footnote{Supported image types are: PNG, BMP, XBM, XPM and PNM. It may
insilmaril@28
   357
	also support JPEG, MNG and GIF, if specially configured during
insilmaril@28
   358
	compilation (as done when \vym is part of SUSE LINUX).}
insilmaril@28
   359
While an image is selected in the dialog, you can see a preview of the
insilmaril@28
   360
image.	
insilmaril@28
   361
insilmaril@28
   362
You can position the image anywhere you want, just drag it with left
insilmaril@28
   363
mouse. To relink it to another branch, press \key{Shift} while moving
insilmaril@28
   364
it. To delete it, press \key{Del}. 
insilmaril@28
   365
insilmaril@28
   366
If you right-click onto an image, a context menu will open which let's
insilmaril@28
   367
you first choose one of several image formats. Then a file dialog opens
insilmaril@28
   368
to save the image. Hint: This is used to "export" the image, it will be
insilmaril@28
   369
saved anyway in the map itself! You can also cut and
insilmaril@28
   370
copy images, but it is not possible to add objects to an image\footnote{
insilmaril@28
   371
	Images are regarded as "extra feature". It would make working with
insilmaril@28
   372
	the map much more complex if e.g. images could be linked to images.}
insilmaril@28
   373
insilmaril@28
   374
The option \lq{\bf Use for export} \rq controls the output of exports
insilmaril@28
   375
e.g. to HTML: If set to no, the image won't appear in the {\em text}
insilmaril@28
   376
part of the output. This is useful for large images or if images are
insilmaril@28
   377
used as a kind of frame e.g. the famous cloud symbol around a part of
insilmaril@28
   378
the map. Those shouldn't appear in the middle of the text.
insilmaril@28
   379
insilmaril@28
   380
At the moment image support is preliminary: Images will be saved
insilmaril@28
   381
together with all the other data of a map in the {\tt .vym}-file.
insilmaril@28
   382
Later versions will include more functionality like resizing the images,
insilmaril@28
   383
changing its z-value (put it into background) etc.
insilmaril@28
   384
insilmaril@28
   385
\subsubsection*{Frames}
insilmaril@28
   386
A frame can be added to a branch by clicking with the
insilmaril@28
   387
right-mouse button.  A context menu will open, where you can choose the
insilmaril@28
   388
frame. At the moment just a rectangle resp. "No Frame" will be offered,
insilmaril@28
   389
nevertheless you can use images as frames. Have a look at the demo map
insilmaril@28
   390
{\tt todo.vym} as an example, where the mapcenter is a cloud. You can
insilmaril@28
   391
use an external drawing program like {\tt gimp} to create an image,
insilmaril@28
   392
preferable with an transparency channel, so that you can design frames
insilmaril@28
   393
which don't use a rectangular borderline, just like the cloud.
insilmaril@28
   394
insilmaril@28
   395
insilmaril@28
   396
\subsection{Background design}
insilmaril@28
   397
The design of the background of a map and also of the links connecting
insilmaril@28
   398
various parts of the map can be changed by
insilmaril@28
   399
\begin{itemize}
insilmaril@28
   400
	\item Selecting Format from the menu
insilmaril@28
   401
	\item Right clicking onto the canvas, which will open a context menu
insilmaril@28
   402
\end{itemize}
insilmaril@28
   403
insilmaril@28
   404
\subsubsection*{Background color}
insilmaril@28
   405
The color is set (and also displayed) as "Set background color".
insilmaril@28
   406
insilmaril@28
   407
\subsubsection*{Link color}
insilmaril@28
   408
Links connecting branches can be colored in one of the following ways:
insilmaril@28
   409
\begin{itemize}
insilmaril@28
   410
	\item use the color of the heading of the branch the links is
insilmaril@28
   411
	\item use {\em one} color for all links. The default color is blue.
insilmaril@28
   412
	leading to.
insilmaril@28
   413
\end{itemize}
insilmaril@28
   414
The latter can be set with "Set link color". Check or uncheck the "Use
insilmaril@28
   415
color of heading for link" option to choose one of the two designs for
insilmaril@28
   416
your map.
insilmaril@28
   417
insilmaril@28
   418
\subsubsection*{Link style}
insilmaril@28
   419
\vym offers four different styles for the appearences of links:
insilmaril@28
   420
\begin{itemize}
insilmaril@28
   421
	\item Line
insilmaril@28
   422
	\item Parabel
insilmaril@28
   423
	\item Thick Line
insilmaril@28
   424
	\item Thick Parabel
insilmaril@28
   425
\end{itemize}
insilmaril@28
   426
The "thick" styles only draw links starting at mapcenter thick, the rest
insilmaril@28
   427
of the map is always painted "thin".
insilmaril@28
   428
insilmaril@28
   429
insilmaril@28
   430
\subsection{Link to other documents}
insilmaril@28
   431
Presently \vym supports two kind of links:
insilmaril@28
   432
\begin{itemize}
insilmaril@28
   433
	\item Document, which will be opened in an external webbrowser
insilmaril@28
   434
	\item \vym map, which will be opened in \vym itself
insilmaril@28
   435
\end{itemize}
insilmaril@28
   436
insilmaril@28
   437
\subsubsection*{Webbrowser}
insilmaril@28
   438
Modern Webbrowsers like {\tt konqueror} are able to display various
insilmaril@28
   439
types of files, both local or in the internet. To enter the URL of
insilmaril@28
   440
any document, right-click  onto a branch or use the Edit Menu
insilmaril@28
   441
and choose "Edit URL". Enter the path to your document (or copy and
insilmaril@28
   442
paste it from your browser). Examples for valid paths are:
insilmaril@28
   443
\begin{verbatim}
insilmaril@28
   444
	http://www.insilmaril.de/vym/index.html
insilmaril@28
   445
	file:/usr/share/doc/packages/vym/doc/vym.pdf
insilmaril@28
   446
\end{verbatim}
insilmaril@28
   447
If an URL was entered, a little globe will appear in the branch. By
insilmaril@28
   448
clicking on the globe in the toolbar or the context menu an external
insilmaril@28
   449
browser\footnote{
insilmaril@28
   450
	The browser can be changed in the Settings Menu.}
insilmaril@28
   451
will be started.
insilmaril@28
   452
\begin{center}
insilmaril@28
   453
	\includegraphics[width=0.5cm]{flag-url.png}
insilmaril@28
   454
\end{center}
insilmaril@28
   455
If you want to keep bookmarks in a map, you may want to copy the heading
insilmaril@28
   456
as URL: Right click onto the branch and select "Use heading for URL".
insilmaril@28
   457
insilmaril@28
   458
\subsubsection*{\vym map}
insilmaril@28
   459
To link to to another map right click on a branch or choose "Edit \ra
insilmaril@28
   460
Enter \vym link". A file dialog opens where you can choose the map. A
insilmaril@28
   461
branch with a link is marked with 
insilmaril@28
   462
\begin{center}
insilmaril@28
   463
	\includegraphics[width=0.5cm]{flag-vymlink.png}
insilmaril@28
   464
\end{center}
insilmaril@28
   465
Clicking this flag in the toolbar or in the context menu of a branch
insilmaril@28
   466
will open the map in another tab (see \ref{tabs} for working with
insilmaril@28
   467
multiple maps). To delete an existing link, just press the "Cancel"
insilmaril@28
   468
button.
insilmaril@28
   469
insilmaril@28
   470
Technical note: Internally \vym uses absolute paths, to avoid opening
insilmaril@28
   471
several tabs containing the same map. When a map is saved, this path is
insilmaril@28
   472
converted to a relative one (e.g. {\tt /home/user/vym.map} might become
insilmaril@28
   473
{\tt ./vym.map}. This makes it fairly easy to use multiple maps on
insilmaril@28
   474
different computers or export them to HTML in future.
insilmaril@28
   475
insilmaril@28
   476
\subsection{Multiple maps} \label{tabs}
insilmaril@28
   477
You can work on multiple maps at the same time. Each new map is opened
insilmaril@28
   478
in another {\em tab}. The available tabs are shown just above the
insilmaril@28
   479
mapeditor. You can use the normal cut/copy/paste functions to
insilmaril@28
   480
copy data from one map to another.
insilmaril@28
   481
insilmaril@28
   482
%todo
insilmaril@28
   483
insilmaril@28
   484
%TODO
insilmaril@28
   485
%\subsubsection{Menus}
insilmaril@28
   486
%\subsubsection{Keyboard shortcuts}
insilmaril@28
   487
insilmaril@28
   488
% Settings
insilmaril@28
   489
% Images
insilmaril@28
   490
% Copy & Paste
insilmaril@28
   491
% Working with tabs (multiple maps)
insilmaril@28
   492
% Exporting
insilmaril@28
   493
% Scrolling
insilmaril@28
   494
insilmaril@28
   495
\section{Noteeditor} \label {noteeditor}
insilmaril@28
   496
If you want to save more text in a branch e.g. a complete email, a
insilmaril@28
   497
cooking recipe, or the whole source code of a software project, you can
insilmaril@28
   498
use the noteeditor. Since version 1.4.7 \vym supports formatted text in
insilmaril@28
   499
the noteeditor.
insilmaril@28
   500
insilmaril@28
   501
\subsubsection*{States}
insilmaril@28
   502
Before you can type or paste text into it, you have
insilmaril@28
   503
to select a branch in the mapeditor. Note that the background color
insilmaril@28
   504
of the noteeditor indicates its state:
insilmaril@28
   505
\begin{itemize}
insilmaril@28
   506
	\item black: no branch selected
insilmaril@28
   507
	\item grey: no text entered yet
insilmaril@28
   508
	\item white: text is already available
insilmaril@28
   509
\end{itemize}	
insilmaril@28
   510
To show you in the mapeditor itself that there is a note with more
insilmaril@28
   511
information for a particular branch, a little note flag will appear next
insilmaril@28
   512
to the heading of the branch. See the lower branch on the right side:
insilmaril@28
   513
\begin{center}
insilmaril@28
   514
	\includegraphics[width=8cm]{branches-flags.png}
insilmaril@28
   515
\end{center}
insilmaril@28
   516
insilmaril@28
   517
\subsubsection*{Import and export notes}
insilmaril@28
   518
The note is always saved automatically within the \vym file itself.
insilmaril@28
   519
Nevertheless sometimes it is nice to import a note from an external file
insilmaril@28
   520
or write it. Use "File\ra~Import" and "File\ra~Export" to do so. 
insilmaril@28
   521
insilmaril@28
   522
\subsubsection*{Edit and print note}
insilmaril@28
   523
Editing works like in any simple texteditor, including undo and redo
insilmaril@28
   524
functions. You can delete the complete note by clicking the
insilmaril@28
   525
trashcan. Only the note itself is printed by clicking the printer icon.
insilmaril@28
   526
insilmaril@28
   527
When pasting into the editor using the X11 copy\&paste mechanism, the
insilmaril@28
   528
editor will create a paragraph for each new line. Usually this is not
insilmaril@28
   529
wanted, so there you can convert all paragraphs into linebreaks by using
insilmaril@28
   530
Edit~\ra~Remove~Paragraphs or \key{ALT-X}.
insilmaril@28
   531
insilmaril@28
   532
\subsubsection*{Fonts}
insilmaril@28
   533
The noteeditor is ment to be used for simple notes, not really as full
insilmaril@28
   534
featured text editor. Because of many requests \vym supports now
insilmaril@28
   535
formatted text in the noteeditor\footnote{
insilmaril@28
   536
	\vym uses the QRichtText format, which is basically a subset of the
insilmaril@28
   537
	formatting provided in HTML.}
insilmaril@28
   538
Two default fonts are supported which can be set in the Settings menu.
insilmaril@28
   539
One is a fixed width font, the other has variable width. The fixed font
insilmaril@28
   540
is usually used for emails, source code etc.\ while the variable font is
insilmaril@28
   541
used for simple notes, where one doesn't need fixed character widths.
insilmaril@28
   542
Both fonts can easily switched using the following symbol from the
insilmaril@28
   543
toolbar:
insilmaril@28
   544
\begin{center}
insilmaril@28
   545
	\includegraphics[width=0.5cm]{formatfixedfont.png}
insilmaril@28
   546
\end{center}
insilmaril@28
   547
In the Settings menu both fonts can be set and also which font should be
insilmaril@28
   548
used for default. 
insilmaril@28
   549
insilmaril@28
   550
Additionally to the default fonts any font installed on your system can
insilmaril@28
   551
be used. Please note, that the chosen font also will be used for HTML
insilmaril@28
   552
exports, so you should only use fonts which are available generally.
insilmaril@28
   553
insilmaril@28
   554
\subsubsection*{Colors and formatted text}
insilmaril@28
   555
Colors and text attributes (e.g. italic, bold) can 
insilmaril@28
   556
be set with the buttons above the text. 
insilmaril@28
   557
The text itself is divided in paragraphs. For each paragraph the format
insilmaril@28
   558
can be set (e.g. centered, right). A paragraph is ended when a
insilmaril@28
   559
\key{Return} is entered. If you just want to begin a new line, press
insilmaril@28
   560
\key{CTRL-Return}.
insilmaril@28
   561
insilmaril@28
   562
\subsubsection*{Finding text}
insilmaril@28
   563
The noteeditor itself has no Find function, use Find in the mapeditor,
insilmaril@28
   564
which will also search all notes (see \ref{findwindow}).
insilmaril@28
   565
insilmaril@28
   566
\subsubsection*{Pasting text into note editor}
insilmaril@28
   567
Often you will paste text into the editor from another application e.g.
insilmaril@28
   568
an email. Normally \vym will generate a new paragraph for each new line.
insilmaril@28
   569
This usually is not what you want, so you can choose from the menu
insilmaril@28
   570
insilmaril@28
   571
\paragraph{Edit \ra Convert Paragraphs:}
insilmaril@28
   572
This turns paragraphs in selected text (or all text, if nothing is
insilmaril@28
   573
selected) into linebreaks. This is especially useful for snippets of
insilmaril@28
   574
source code.
insilmaril@28
   575
insilmaril@28
   576
\paragraph{Edit \ra Join Lines:}
insilmaril@28
   577
Tries to format text, so that empty lines are used to delimit
insilmaril@28
   578
paragraphs. This is done for selected text (or all text, if nothing is
insilmaril@28
   579
selected). Especially useful for text like emails, meeting minutes etc.
insilmaril@28
   580
insilmaril@28
   581
\section{Hello world}
insilmaril@28
   582
\vym can export its maps in various formats and can import data from
insilmaril@28
   583
outside (though import is still limited at the moment).
insilmaril@105
   584
Also parts of a map can be exported.
insilmaril@28
   585
insilmaril@28
   586
\subsection{Export}
insilmaril@28
   587
The format in which the map will be exported can be chosen with
insilmaril@28
   588
\begin{itemize}
insilmaril@28
   589
	\item File \ra Export \ra {\em format}
insilmaril@28
   590
\end{itemize}
insilmaril@28
   591
\vym offers both HTML and ASCII export.
insilmaril@28
   592
insilmaril@28
   593
\subsubsection*{Image}
insilmaril@28
   594
\vym supports all image formats which are natively supported by the
insilmaril@28
   595
QT~toolkit:
insilmaril@28
   596
BMP, JPEG, PBM, PGM, PNG, PPN, XPM, and XBM.
insilmaril@28
   597
For use in websites and for sending images by email PNG is a good
insilmaril@28
   598
recommodation regarding quality and size of the image. \vym uses QTs
insilmaril@28
   599
default options for compressing the images.
insilmaril@28
   600
insilmaril@28
   601
\subsubsection*{ASCII}
insilmaril@28
   602
Exporting an image as text is somewhat experimental at the moment. Later
insilmaril@28
   603
this will probably done using stylesheets. So the output may change in
insilmaril@28
   604
future versions of \vym.
insilmaril@28
   605
insilmaril@28
   606
\subsubsection*{HTML}
insilmaril@28
   607
Before a map is exported as HTML, it will be first written as XML into a
insilmaril@28
   608
directory (see \ref{xmlexport}). Then the external program {\tt
insilmaril@28
   609
xsltproc}\footnote{On SUSE Linux {\tt xsltproc} is installed by
insilmaril@28
   610
default.}
insilmaril@28
   611
will be called to process the XML file and generate HTML code.
insilmaril@28
   612
%A script then will transform the XML
insilmaril@28
   613
%version. 
insilmaril@28
   614
A dialog allows to set various options:
insilmaril@28
   615
\begin{itemize}
insilmaril@28
   616
	\item {\bf Include image:} If set, \vym will creat an image map at
insilmaril@28
   617
	the top of the HTML output. Clicking on a branch in the map will
insilmaril@28
   618
	jump to the corresponding section in the output.
insilmaril@28
   619
insilmaril@28
   620
	\item {\bf Colored headings:}
insilmaril@28
   621
	If set to yes, \vym will color the headings in the text part  with the
insilmaril@28
   622
	same colors like in the map.
insilmaril@28
   623
	\item {\bf Show Warnings:}
insilmaril@28
   624
	If set to yes, \vym will ask before overwriting data.
insilmaril@28
   625
	\item {\bf Show output:}
insilmaril@28
   626
	This is useful mainly for debugging. It will show how the processing of
insilmaril@28
   627
	the XML file works by calling the external {\tt xsltproc}.
insilmaril@28
   628
\end{itemize}
insilmaril@28
   629
Additionally the paths to the CSS and XSL stylesheets can be set. By
insilmaril@28
   630
default on SUSE~Linux they will be in {\tt /usr/share/vym/styles}.
insilmaril@28
   631
insilmaril@28
   632
%\paragraph{WIKI style:} This is very useful for easy design of webpages.
insilmaril@28
   633
%Here is a short overview:
insilmaril@28
   634
%\begin{verbatim}
insilmaril@28
   635
%Lines:
insilmaril@28
   636
%	+ Big headlines start with the '+' character.
insilmaril@28
   637
%	- Small headlines start with the '-' character.
insilmaril@28
   638
%	  Normal text doesn't have any starting notation.
insilmaril@28
   639
%	! Notes start with an exclamation.
insilmaril@28
   640
%	. Indented text starts with a dot.
insilmaril@28
   641
%	? Questions start with a question-mark, and
insilmaril@28
   642
%	= Answers starts with the equal-sign.
insilmaril@28
   643
%	* Points for a item-list
insilmaril@28
   644
%	# clues
insilmaril@28
   645
%	
insilmaril@28
   646
%Links:
insilmaril@28
   647
%	use '{...}' or '{(vym homepage) http://www.insilmaril.de/vym/}'
insilmaril@28
   648
%	for external links.
insilmaril@28
   649
%	
insilmaril@28
   650
%Markup:
insilmaril@28
   651
%	|This is bold| text, while 
insilmaril@28
   652
%	|/this text is italic|, 
insilmaril@28
   653
%	|*this is pre-formatted|, and 
insilmaril@28
   654
%	|!this is a note|
insilmaril@28
   655
%\end{verbatim}
insilmaril@28
   656
%
insilmaril@28
   657
%\paragraph{Show output:} This is used for debugging. \vym uses an
insilmaril@28
   658
%the external script {\tt vym2html.sh} to preprocess the XML-data. Then
insilmaril@28
   659
%\vym calls {\tt xsltproc} to generate the HTML page by using various
insilmaril@28
   660
%{\tt .xsl} stylesheets and {\tt wireframe.css}. If you run into problems
insilmaril@28
   661
%here, changing paths in {\tt $\sim$/.qt/vymrc} might help.
insilmaril@28
   662
insilmaril@28
   663
\subsubsection*{XML} \label{xmlexport}
insilmaril@28
   664
The map is written into a directory both as an image and as XML. The
insilmaril@28
   665
directory is set in a file dialog. If the directory is not empty, you
insilmaril@28
   666
will be questioned if you risk to overwrite its contents.
insilmaril@28
   667
insilmaril@28
   668
It is possible to export different maps into the same directory. Each
insilmaril@28
   669
file generated will have the map's name as prefix, e.g. {\tt todo.vym}
insilmaril@28
   670
becomes {\tt todo.xml}, {\tt todo.png}, {\tt todo-image-1.png} and so
insilmaril@28
   671
on. This is useful if e.g. for a website several combined maps have to
insilmaril@28
   672
be stored in the same directory.
insilmaril@28
   673
insilmaril@105
   674
\subsubsection*{Export a part of a map}
insilmaril@105
   675
Select a branch you want to export together with its childs, than open
insilmaril@105
   676
the context menu and choose {\em Save Selection}. This will create a
insilmaril@105
   677
file with the postfix {\tt .vyp}, which is an abbreviation for \lq vym
insilmaril@105
   678
part\rq.
insilmaril@105
   679
insilmaril@28
   680
\subsection{Import} 
insilmaril@28
   681
At the moment \vym can read a directory structure. This is mainly for
insilmaril@28
   682
testing \vym e.g. to easily create huge maps used for benchmarks (yes,
insilmaril@28
   683
there is still room to optimize \vym ;-)
insilmaril@28
   684
insilmaril@28
   685
Many other applications meanwhile can export their data using XML, so
insilmaril@28
   686
volunteers to write import filters are welcome.
insilmaril@28
   687
insilmaril@105
   688
Also parts of a vym map ({\tt .vyp}) can be imported.
insilmaril@105
   689
insilmaril@28
   690
\subsection{File format}
insilmaril@28
   691
\vym maps usually have the postfix "{\tt .vym}" and represent a
insilmaril@28
   692
compressed archive of data. If you want to have a
insilmaril@28
   693
closer look into the data structure, just uncompress the map manually
insilmaril@28
   694
using
insilmaril@28
   695
\begin{verbatim}
insilmaril@28
   696
	unzip vymfile.vym
insilmaril@28
   697
\end{verbatim}
insilmaril@28
   698
A directory named {\tt vymfile} will be created containing further
insilmaril@28
   699
directories both for {\tt images} and {\tt flags}. In the {\tt vymfile}
insilmaril@28
   700
directory you will find the map itself, usually named {\tt vymfile.xml}.
insilmaril@28
   701
insilmaril@28
   702
This file can be loaded directly into \vym, it does not have to be
insilmaril@28
   703
compressed. If you want to compress all the data yourself, use
insilmaril@28
   704
\begin{verbatim}
insilmaril@28
   705
	cd vymfile
insilmaril@28
   706
	zip -r vymfile.vym .
insilmaril@28
   707
\end{verbatim}
insilmaril@28
   708
insilmaril@105
   709
\subsubsection*{Importa part of a map}
insilmaril@105
   710
Select a branch where you want to add a previously save part of a map
insilmaril@105
   711
({\tt .vyp}), then open
insilmaril@105
   712
the context menu and choose {\em Add \ra Import}. For the import you can
insilmaril@105
   713
choose between {\em Import Add} and {\em Import Replace}: The imported
insilmaril@105
   714
data will be added after the selection resp. replace the selection.
insilmaril@28
   715
insilmaril@28
   716
%TODO
insilmaril@28
   717
%\subsubsection{Menus}
insilmaril@28
   718
%\subsubsection{Keyboard shortcuts}
insilmaril@28
   719
%Where does vym save its settings? -> ~/.qt/vymrc
insilmaril@28
   720
insilmaril@105
   721
insilmaril@105
   722
\section{\vym on Mac OS X}
insilmaril@105
   723
\subsection{Overview}
insilmaril@105
   724
Basically there are two ways to run \vym on Macs:
insilmaril@105
   725
\subsubsection{QT Mac Edition:}
insilmaril@105
   726
	\vym here provides the well known Mac look and feel.  \vym is
insilmaril@105
   727
	available as zipped Mac OS X application. It has been compiled and
insilmaril@105
   728
	tested in Mac~OS~10.3, but should also work on Tiger. It is using
insilmaril@105
   729
	the Mac version of Trolltechs QT library.  
insilmaril@105
   730
\subsubsection{X11}
insilmaril@105
   731
	\vym can also be run using the Linux version, but then menus and
insilmaril@105
   732
	handling will also be those of the Linux version e.g. The menu bar
insilmaril@105
   733
	will look different. 
insilmaril@105
   734
insilmaril@105
   735
%TODO  Concept on Mac   context menu, shortcuts...
insilmaril@105
   736
insilmaril@28
   737
\section{History of \vym}
insilmaril@28
   738
\subsection{Future}
insilmaril@28
   739
There are lots of features which might find their way into \vym.
insilmaril@28
   740
Together with \vym you should have received a directory with example
insilmaril@28
   741
maps e.g. on SUSE~LINUX this is
insilmaril@28
   742
\begin{center}
insilmaril@28
   743
	{\tt /usr/share/doc/packages/vym/demos}
insilmaril@28
   744
\end{center}
insilmaril@28
   745
where you find the map {\tt todo.vym}. It lists quite a lot of things to
insilmaril@28
   746
be done in future. If you have more ideas, contact the author at
insilmaril@28
   747
{\tt vym@insilmaril.de}.
insilmaril@28
   748
insilmaril@28
   749
\subsection{Past}
insilmaril@124
   750
\input{vym.changelog}
insilmaril@28
   751
\begin{center}
insilmaril@28
   752
\begin{longtable}{|lcp{8cm}l|} \hline
insilmaril@28
   753
Version	&	&	Comment								& Date	\\ \hline \hline \endhead
insilmaril@28
   754
	\hline \endfoot
insilmaril@124
   755
1.6.8	& - &	Dramatic speedup in some operations 
insilmaril@106
   756
				(e.g. move branch up/down) due to extended 
insilmaril@106
   757
				undo engine							& 2005-06-07 \\ 
insilmaril@104
   758
1.6.7	& - &	Changed default pdf-reader for Mac OSX & 2005-05-27 \\ 
insilmaril@104
   759
		& - &	Bugfix: xLinks stopped working in 1.6.6			&\\
insilmaril@104
   760
		& - &	Bugfix: drawing error when using modModeCopy    &\\
insilmaril@104
   761
		& - &	Bugfix: replaced lrint by qRound for BSD ports	&\\
insilmaril@103
   762
1.6.6	& -	&	Exclusive standard flags			& 2005-05-23 \\
insilmaril@103
   763
1.6.5	& -	&	removing a branch and keeping its childs	& 2005-05-19 \\
insilmaril@98
   764
        & -	&	removing childs of a branch			& \\
insilmaril@98
   765
        & -	&	insert branch and make selection its child& \\
insilmaril@105
   766
        & -	&	restructured branch context menu	
insilmaril@98
   767
				in a basic version (straight line)	& 2005-04-15\\
insilmaril@103
   768
        & -	&	New shortcuts  for use on Mac OS X	& \\
insilmaril@103
   769
        & -	&	Importing directories generates vymlinks now & \\
insilmaril@102
   770
        & -	&	Bugfix: Changing linkstyle now automatically redraws all
insilmaril@102
   771
				links again& \\
insilmaril@103
   772
        & -	&	Bugfix: Paste icon is disabled if clipboard is empty &\\
insilmaril@95
   773
1.6.4	& -	&	xLinks (arbitrary connection between 2 branches) works
insilmaril@95
   774
				in a basic version (straight line)	& 2005-04-15\\
insilmaril@94
   775
1.6.3	& -	&	Bugfix: Saving of selection to a vym part (.vyp)	&2005-03-30\\
insilmaril@94
   776
		& - &	Bugfix: Closing the noteeditor by closing its window now
insilmaril@94
   777
				also toggles the responding toolbar button. &\\
insilmaril@93
   778
1.6.2	& -	&	Introduced Modifier modes: color, link, copy &2005-03-24\\
insilmaril@93
   779
      & -	&	Linking branches is basically possible, though it can't
insilmaril@93
   780
				be edited/saved yet &\\
insilmaril@88
   781
1.6.1	& -	&	Optimized moving of branches: much faster especially 
insilmaril@88
   782
				with huge subtrees					&2005-01-30\\
insilmaril@85
   783
		& -	&	Bugfix: Segfault when loading vym part &\\
insilmaril@85
   784
		& -	&	Bugfix: ugly unitialized lines, when 
insilmaril@85
   785
				temporary drawn link was moved from a 
insilmaril@85
   786
				temporary parent back to canvas		& \\ 
insilmaril@28
   787
1.6.0 	& -	&	Added saving of xhtml settings in map& 2004-12-14 \\ 
insilmaril@28
   788
1.5.2 	& -	&	Added Import of maps with two modes: 
insilmaril@28
   789
				add/replace							& 2004-12-13 \\ 
insilmaril@28
   790
		& - &	Added export of part of maps		& \\
insilmaril@28
   791
		& - &	Added joining of paragraphs in text editor		& \\
insilmaril@28
   792
		& - &	Optimized undo: Only relevant parts are saved, which
insilmaril@28
   793
				dramatically improves e.g. moving branches up/down 
insilmaril@28
   794
				in most maps & \\
insilmaril@28
   795
		& -	&	Bugfix: QTextEdit generates invalid XML code, which
insilmaril@28
   796
				could lead to a parse error, if font name contains a \& &  \\ 
insilmaril@28
   797
		& -	&	Bugfix: Wrong order of mainbranches in Export	&  \\ 
insilmaril@28
   798
		& -	&	Bugfix: zip archive was not deleted before save, which
insilmaril@28
   799
				could lead to much bigger files, e.g. 
insilmaril@28
   800
				when working on older \vym maps or deleted images&  \\ 
insilmaril@28
   801
		& -	&	Bugfix: Printing in Texteditor      &  \\ 
insilmaril@28
   802
		& -	&	Bugfix: Wrong URLs in xhtml output				&  \\
insilmaril@28
   803
      	& -	&	Bugfix: Segfault fixed at Cursor left/right in empty map&  \\
insilmaril@28
   804
1.5.1 	& -	&	More options in xhtml export: external scripts 	& 2004-10-01 \\
insilmaril@28
   805
1.5.0 	& -	&	Public release of all changes since 1.4.1      	& 2004-09-26 \\
insilmaril@28
   806
      	& -	&	New function to replace paragraphs in note editor
insilmaril@28
   807
				by linebreaks, this makes pasted text much nicer& \\
insilmaril@28
   808
      	& -	&	New option to toggle exporting of of floatimages& \\
insilmaril@28
   809
      	& -	&	z-plane of floatimages can be set (manually only)& \\
insilmaril@28
   810
		& - &	Bugfix: Wrong ordering of branches, if mainbranch is
insilmaril@28
   811
				exactly left of center& \\
insilmaril@106
   812
1.4.7 	& -	&	New Export to XHTML by Thomas Schraitle.	& 2004-09-24 \\
insilmaril@28
   813
		& - &	Bugfix: vymLink&	\\
insilmaril@28
   814
		& - &	Bugfix: spaces and dots in filenames	& \\
insilmaril@28
   815
		& - &	Bugfix: Error message if xsltproc is not installed& \\
insilmaril@28
   816
1.4.6 	& -	&	New file format: notes are saved as part of the .xml file
insilmaril@28
   817
			& 2004-09-15	\\
insilmaril@28
   818
		& - &	Note Editor supports Rich Text now.&\\
insilmaril@28
   819
		& - &	Parser now also nows {\tt standardflag} (all letters
insilmaril@28
   820
				lowercase)&\\
insilmaril@28
   821
1.4.5 	& -	&	Correct handling of font size in Heading			& 2004-08-23	\\
insilmaril@28
   822
1.4.4 	& -	&	Selecting with cursor now works between subtrees	& 2004-07-29	\\
insilmaril@28
   823
		& - &	Bugfix: vymLink was set to temporary dir in 1.4.3	& \\
insilmaril@28
   824
		& - &	Bugfix: & \\
insilmaril@28
   825
1.4.3 	& -	&	Optimisation: Reduced canvas objects by only
insilmaril@28
   826
				creating objects for used flags		& 2004-07-19 \\ 
insilmaril@28
   827
		& - &	Better visualization of moving branch above/below target&\\		
insilmaril@28
   828
		& - &	Find Window informs with dialog, if the search failed&\\
insilmaril@28
   829
		& - &	System Flags are clickable now		&\\
insilmaril@28
   830
		& - &	Reworked CSS and XST stylsheets (comments, indent, browser
insilmaril@28
   831
				compatibility)						&\\
insilmaril@28
   832
		& - &	vymLinks are shown in statusbar		&\\
insilmaril@28
   833
		& - &	current directory is save			&\\
insilmaril@28
   834
		& - &	Rewritten load/save to improve multimap handling and
insilmaril@28
   835
				unzipped files&\\
insilmaril@28
   836
		& - &	Bugfix: vymLinks don't get deleted 
insilmaril@28
   837
				when Cancel is pressed				&\\		
insilmaril@28
   838
      	& -	&	Bugfix: Fixed a bunch of bugs in XSL for HTML export&            \\ 
insilmaril@28
   839
      	& -	&	Bugfix: More toolbar buttons disabled, if action not
insilmaril@28
   840
				possible&            \\ 
insilmaril@28
   841
		& - &	Bugfix: Renaming .vymfile now works&\\		
insilmaril@28
   842
		& - &	Bugfix: mapChanged set when toggling flags&\\		
insilmaril@28
   843
		& - &	Bugfix: CTRL-N was used twice		&\\
insilmaril@28
   844
		& - &	Bugfix: Del didn't work on floatimage &\\
insilmaril@28
   845
1.4.2 	& -	&	Bugfix: Float image could not be deleted& \\ 
insilmaril@28
   846
1.4.1 	& -	&	Bugfix: Color of branch not saved	& 2004-05-25 \\ 
insilmaril@28
   847
      	& -	&	Bugfix: wrong path at HTML export	&            \\ 
insilmaril@28
   848
		& -	&	Bugfix: map is not save with special characters in path&  \\ 
insilmaril@28
   849
1.4.0 	& -	&	Ask for confirmation before opening 
insilmaril@28
   850
				a map in multiple editors			& 2004-05-17 \\
insilmaril@28
   851
		& - &	Save state of note editor (visible/minimized)& \\
insilmaril@28
   852
		& - &	Export to HTML						& \\
insilmaril@28
   853
		& - &	Author and Comment is saved in map	& \\
insilmaril@28
   854
		& - &	Stats are shown in Edit MapInfo		& \\
insilmaril@28
   855
		& - &	Changes for OS X port (QCursor, QContextMenuEvent)	& \\
insilmaril@28
   856
		& - &	Bugfix: Fonts from note editor are save now			&\\
insilmaril@28
   857
		& - &	Bugfix: invisible image when parent is scrolled		&\\
insilmaril@28
   858
		& - &	Bugfix: Segfault pressing "enter" for floatimage	&\\
insilmaril@28
   859
		& - &	Bugfix: Images can't be outside of exported area
insilmaril@28
   860
				anymore.& \\
insilmaril@28
   861
		& - &	Bugfix: Filenames with blanks		& \\
insilmaril@28
   862
		& - &	Bugfix: Old maplink is shown when editing maplink& \\
insilmaril@28
   863
		& - &	Bugfix: always show cursor while editing heading & \\
insilmaril@28
   864
1.3.5 	& -	&	Export map to dir					& 2004-04-16 \\
insilmaril@28
   865
		& - &	Export to any of QTs image formats	& \\
insilmaril@28
   866
		& - &	Also right side of selection is always visible now.& \\
insilmaril@28
   867
1.3.4 	& -	&	Load last maps in file menu         & 2004-04-07 \\
insilmaril@28
   868
		& - &	save last image path for loading	& \\
insilmaril@28
   869
		& - &	Also export standard flags to dir.	& \\
insilmaril@28
   870
1.3.3 	& -	&	Enabled <br> in headings as manual linebreak	& 2004-03-26 \\
insilmaril@28
   871
		& -	&	Heading can be copied to URL		&\\
insilmaril@28
   872
		& -	&	Bugfix: GIFs are automatically converted to PNG now&\\
insilmaril@28
   873
1.3.2 	& -	&	Add and move branches above/below selection, Texteditor copy all,& 2004-03-26 \\
insilmaril@28
   874
1.3.1 	& -	&	Export to directory, changed naming in .vym& 2004-03-25 \\
insilmaril@28
   875
1.3.0 	& -	&	Bugfix: Check if map can be saved at all& 2004-03-23 \\
insilmaril@28
   876
1.2.12	& -	&	Select image format before saving image	& 2004-03-22 \\
insilmaril@28
   877
1.2.11	& -	&	Selecting mainbranches by up/down	& 2004-03-18 \\
insilmaril@28
   878
		& -	&	Export ASCII (experimental)			&			\\
insilmaril@28
   879
		& -	&	Each map can be saved individually at quit	&	\\
insilmaril@28
   880
		& -	&	Bugfix: Opening VymLink crashes QT	&			\\
insilmaril@28
   881
		& -	&	Bugfix: 50\% less objects on canvas	&			\\
insilmaril@28
   882
		& -	&	Bugfix: Ignoring LANG, now always written as UTF8&\\
insilmaril@28
   883
1.2.10	& -	&	Sort Mainbranches by angle to y-axis& 2004-03-16 \\
insilmaril@28
   884
		& -	&	Import directory structure			&			\\
insilmaril@28
   885
		& - &	Fix: Set FrameType of MapCenter while loading map &\\
insilmaril@28
   886
1.2.9	& -	&	Jump to another vym map		        & 2004-03-12 \\
insilmaril@28
   887
     	& -	&	Mainbranches are alwas ordered clockwise   &     \\
insilmaril@28
   888
1.2.8	& -	&	Change frame types in context menu  & 2004-03-03 \\
insilmaril@28
   889
1.2.7	& -	&	Copy / Paste and save Floatimages & 2004-02-25 \\
insilmaril@28
   890
1.2.6	& -	&	Closing vym in KDE now asks for save, too	& 2004-02-24 \\
insilmaril@28
   891
		& -	&	Context menu for branches					&  \\
insilmaril@28
   892
		& -	&	Selection is saved in .vym file				&  \\
insilmaril@28
   893
1.2.5	& -	&	URLs to external links can be added & 2004-02-18 \\
insilmaril@28
   894
		& - &	All actions are deactived if not possible & \\
insilmaril@28
   895
1.2.4	& -	&	Images: Can be loaded, saved, relinked to other parents
insilmaril@28
   896
& 2004-02-16 \\
insilmaril@28
   897
1.2.3	& -	&	Zoom: Reset and finer steps shrinking/enlarging	& 2004-01-27 \\
insilmaril@28
   898
1.2.2	& -	&	Editing of links (style and color)	& 2004-01-27 \\
insilmaril@28
   899
1.2.1	& -	&	Bugfix: LineEdit when adding branch has correct position
insilmaril@28
   900
				again.								& 2004-01-27 \\
insilmaril@28
   901
1.2.0	& -	&	Scrolled parts are automatically unscrolled when
insilmaril@28
   902
				selected and scrolled again later.				& 2004-01-23 \\
insilmaril@28
   903
		& - &	Bugfix: Save flag is updated when multiple maps are opened& \\
insilmaril@28
   904
		& - &	Bugfix: Moving of branches is faster and more accurat
insilmaril@28
   905
				when adding to mapcenter& \\
insilmaril@28
   906
1.1.7	& -	&	Bugfix: Remember filename of note in noteeditor	& 2003-12-04 \\
insilmaril@28
   907
1.1.6	& -	&	Find Text also in Notes.	& 2003-12-02 \\
insilmaril@28
   908
1.1.5	& -	&	Bugfix: Correct setting and positioning when relinking branches	& 2003-11-07 \\
insilmaril@28
   909
1.1.4	& -	&	Scroll mode added (folding of subtrees).		& 2003-11-03 \\
insilmaril@28
   910
		& - &	Bugfix: Wrong position of linedit in zoomed view& \\
insilmaril@28
   911
1.1.3	& -	&	Added clear button in find window, bugfixes    & 2003-10-09 \\ 
insilmaril@28
   912
1.1.2	& -	&	Links can be colored with color of heading     & 2003-10-07 \\ 
insilmaril@28
   913
1.1.1	& -	&	Improved visualization of linking to new branch& 2003-09-26 \\ 
insilmaril@28
   914
1.1.0	& -	&	Find Function							& 2003-09-25 \\ 
insilmaril@28
   915
		& -	&	Selection always stays in view		& \\ \hline
insilmaril@28
   916
1.0.1	& -	&	Find function scrolls to result now	& 2003-09-18\\
insilmaril@28
   917
     	& -	&	Bugfix: Adding branch with midmouse	&  \\
insilmaril@28
   918
		& -	&	Bugfix: multiple repositioning of map, 
insilmaril@28
   919
				when noteeditor was changed (speedup)	& \\
insilmaril@28
   920
		& -	&	New Linestyles (still hardcoded)		&	\\ \hline
insilmaril@28
   921
1.0.0	& -	&	First public stable release			& 2003-09-16 \\	 \hline	
insilmaril@28
   922
0.9.0	& -	&	added quick color picker (CTRL + Left Mouse) & ?	\\ \hline
insilmaril@28
   923
0.8.0	& - &	added automatic canvas resizer, removed manual resizing of
insilmaril@28
   924
				canvas & \\
insilmaril@28
   925
insilmaril@28
   926
	& - &	added settings option to paste text into new branch	& \\
insilmaril@28
   927
	& - &	simplified code	& \\
insilmaril@28
   928
	& - &	Added heart flag	& \\
insilmaril@28
   929
	& - &	Choose and switch between fixed and variable width fonts& \\
insilmaril@28
   930
	& - &	note editor		& \\
insilmaril@28
   931
	& -	&	Fixed segfault caused by undo and a call of updateNoteFlag of
insilmaril@28
   932
			note editor	& \\
insilmaril@28
   933
	& - &	Added settings menu to configure autoselect \& autoedit mode	& \\
insilmaril@28
   934
	& - &	autoedit \& autoselect mode	& \\
insilmaril@28
   935
	& - &	Fixed ugly display problem with QT Palette (Klaas Freitag)& \\
insilmaril@28
   936
	& - &	Reduced temporary directories from 4 to 1	& \\
insilmaril@28
   937
	& - &	Added wordwrap in printing of notes	& \\
insilmaril@28
   938
	& - &	New toolbar buttons in texteditor	& \\
insilmaril@28
   939
	& - &	Set background color	& \\
insilmaril@28
   940
	& - &	Fixed bug: Flags in toolbar not updated when selecting map center	& \\ \hline
insilmaril@28
   941
0.7.0	& - & No more segfault, when an object is deleted while being edited & \\
insilmaril@28
   942
	& - & Keep focus constant when zooming in/out & \\
insilmaril@28
   943
	& - & Export as png graphic & \\
insilmaril@28
   944
	& - & Keep Center of map where it is while zooming & \\
insilmaril@28
   945
	& - & Added Standard Flags (Smiley, Hook, Stopsign, ...) & \\
insilmaril@28
   946
	& - & MDI: Multi Document Interface enables working on several
insilmaril@28
   947
		maps simultanously & \\
insilmaril@28
   948
	& - & Enabled creating a new map via argument on commandline & \\
insilmaril@28
   949
	& - & Changed file extension from .mmap to .vym & \\
insilmaril@28
   950
	& - & noteeditor changes color, if empty or nothing is selected & \\
insilmaril@28
   951
	& - & Changes in NoteEditor window are recognized by main window,
insilmaril@28
   952
		too, thus preventing loosing data when quitting the program. & \\ \hline
insilmaril@28
   953
0.6.0	& - &	New rendering engine: Faster, no flickering & \\ \hline
insilmaril@28
   954
0.5.0	& - & Changed printing to use maximum space on paper& \\ 
insilmaril@28
   955
	& - & Note editor is hidden, too, when mapeditor is minimized& \\ 
insilmaril@28
   956
	& - & New (compressed) file format& \\ \hline
insilmaril@28
   957
0.4.0    & - & Size of map is saved& \\ 
insilmaril@28
   958
    & - & Multi Line Headings & \\ 
insilmaril@28
   959
    & - & Reworked Rendering Engine: Much faster now.& \\ 
insilmaril@28
   960
    & - & Reworked Undo: Much faster now.& \\ 
insilmaril@28
   961
    & - & Enabled moving of map center& \\ 
insilmaril@28
   962
    & - & Multi-line headings & \\ \hline
insilmaril@28
   963
0.3.0    & - & Introduced Undo& \\ 
insilmaril@28
   964
    & - & Fixed some bugs & \\  \hline
insilmaril@28
   965
0.2.0    & - & Moving view of map improved:& \\ 
insilmaril@28
   966
	& - & New handling (acrobat reader style)& \\ 
insilmaril@28
   967
	& - & New mousepointer& \\ 
insilmaril@28
   968
    & - & Several tools to color a map& \\ \hline
insilmaril@28
   969
0.1.0 & - & Inital version, basic map layout & \\ 
insilmaril@28
   970
    & - & Data is stored in XML& \\ 
insilmaril@28
   971
\end{longtable}
insilmaril@28
   972
\end{center}
insilmaril@28
   973
insilmaril@28
   974
insilmaril@28
   975
% INDEX
insilmaril@28
   976
% mapeditor
insilmaril@28
   977
% noteditor
insilmaril@28
   978
% branch
insilmaril@28
   979
% mapcenter
insilmaril@28
   980
% heading
insilmaril@28
   981
% flag
insilmaril@28
   982
% orientation 
insilmaril@28
   983
% zoom
insilmaril@28
   984
% orientation
insilmaril@28
   985
% Toolbar
insilmaril@28
   986
% Zoom
insilmaril@28
   987
% Find
insilmaril@28
   988
% statusbar
insilmaril@28
   989
% link
insilmaril@28
   990
% mainbranch
insilmaril@28
   991
% subtree
insilmaril@28
   992
% reorder
insilmaril@28
   993
% scroll
insilmaril@28
   994
% fold
insilmaril@104
   995
% vymlink
insilmaril@104
   996
% xlink
insilmaril@104
   997
% context menu
insilmaril@104
   998
% Mac OS X
insilmaril@28
   999
insilmaril@28
  1000
insilmaril@28
  1001
insilmaril@28
  1002
\end{document}