1.1 --- a/tex/vym.tex Thu Jul 30 12:55:17 2009 +0000
1.2 +++ b/tex/vym.tex Thu Aug 06 17:33:55 2009 +0000
1.3 @@ -1,14 +1,45 @@
1.4 -\documentclass{article}
1.5 -\usepackage{a4}
1.6 -\usepackage[latin1]{inputenc}
1.7 +\documentclass[12pt,a4paper]{article}
1.8 +\usepackage[utf8]{inputenc}
1.9 \usepackage{verbatim}
1.10 \usepackage{hyperref}
1.11 \usepackage{graphicx}
1.12 -\usepackage{longtable}
1.13 +%\usepackage{longtable}
1.14
1.15 +\setlength{\headheight}{0cm}
1.16 +\setlength{\headsep}{0cm}
1.17 +\setlength{\topskip}{0cm}
1.18 +\setlength{\topmargin}{-0.5cm}
1.19
1.20 -%\input{udmath}
1.21 +\setlength{\parskip}{1.5ex}
1.22 +\setlength{\parindent}{0cm}
1.23 +\setlength{\oddsidemargin}{0cm}
1.24 +\setlength{\textwidth}{16cm}
1.25 +\setlength{\textheight}{27cm}
1.26
1.27 +\newlength{\maximgwidth}
1.28 +\setlength{\maximgwidth}{14cm}
1.29 +\newcommand{\maximage}[1]{
1.30 + \begin{center}
1.31 + \includegraphics[width=\maximgwidth]{#1}
1.32 + \end{center}
1.33 +}
1.34 +\newcommand{\hint}[1]{
1.35 + \begin{center}
1.36 + \begin{tabular}{|rp{12cm}|} \hline
1.37 + {\bf Hint}:& #1\\ \hline
1.38 + \end{tabular}
1.39 + \marginpar{\Huge !}
1.40 + \end{center}
1.41 +}
1.42 +
1.43 +\newcommand{\vym}{{\sc vym }}
1.44 +\newcommand{\ra}{$\longrightarrow$}
1.45 +\newcommand{\la}{$\longleftarrow$}
1.46 +\newcommand{\ua}{$\uparrow$}
1.47 +\newcommand{\da}{$\downarrow$}
1.48 +\newcommand{\key}[1]{[#1]}
1.49 +
1.50 +\newenvironment{code}[1] { \verbatim #1}{\endverbatim }
1.51
1.52 \hypersetup{bookmarks, bookmarksopen,
1.53 pdftitle={VYM - a tool for visual thinking },
1.54 @@ -23,237 +54,340 @@
1.55 citecolor={red}}
1.56
1.57
1.58 -\newcommand{\vym}{{\sc vym }}
1.59 -\newcommand{\ra}{$\longrightarrow$}
1.60 -\newcommand{\la}{$\longleftarrow$}
1.61 -\newcommand{\ua}{$\uparrow$}
1.62 -\newcommand{\da}{$\downarrow$}
1.63 -\newcommand{\key}[1]{[#1]}
1.64 +\begin{document}
1.65 +\title{
1.66 + \includegraphics[width=8cm]{images/vym-logo-new.png}
1.67 + \\
1.68 +VYM \\ -- \\View Your Mind\\ {\small Version 1.12.0}}
1.69 +\author{\textcopyright Uwe Drechsel }
1.70
1.71 -\begin{document}
1.72 -\title{VYM \\ -- \\View Your Mind}
1.73 -\author{\textcopyright Uwe Drechsel }
1.74 -%\date{September 26, 2002}
1.75
1.76 \maketitle
1.77
1.78 +\newpage
1.79 +
1.80 \tableofcontents
1.81
1.82 \newpage
1.83
1.84 +\section*{Credits}
1.85 +Many people have sent me their feedback and ideas, and all of that has
1.86 +helped a lot to make \vym better. Thanks to all of you!
1.87 +
1.88 +For this manual I would like to send some special thanks to
1.89 +
1.90 +\begin{itemize}
1.91 + \item {\em Peter Adamson} for lots of feedback and proofreading of my
1.92 + far from perfect english
1.93 + \item The team of {\em AClibre (Academia y Conocimiento Libre)}
1.94 + in Colombia for their translation of
1.95 + the manual to spanish:
1.96 + \begin{center}
1.97 + \begin{tabular}{|p{7cm}|p{5.5cm}|} \hline
1.98 + Encargado & Actividad \\ \hline
1.99 + \begin{itemize}
1.100 + \item Vanessa Carolina Guti\'errez Sanchez
1.101 + \item Erika Tatiana Luque Melo
1.102 + \item Jeffrey Steve Borb\'on Sanabria
1.103 + \item John Edisson Ortiz Rom\'an
1.104 + \end{itemize} &
1.105 + \begin{itemize}
1.106 + \item Traducci\'onl
1.107 + \item Revisi\'on y correcciones varias
1.108 + \item Estructuraci\'on y exporte
1.109 + \item Revisi\'on y correcciones varias
1.110 + \end{itemize} \\ \hline
1.111 + \end{tabular}
1.112 + \end{center}
1.113 +\end{itemize}
1.114 +\newpage
1.115 +
1.116 +
1.117 \section{Introduction}
1.118 \subsection{What is a \vym map?}
1.119 -A \vym map (in short words {\em map}) is a tree like structure:
1.120 -\begin{center}
1.121 - \includegraphics[width=12cm]{example1.png}
1.122 -\end{center}
1.123 -Such maps can be drawn by hand on paper or a flip chart and help to
1.124 -structure your thoughs. While a tree like structure like above can be
1.125 -drawn by hand or any drawing software \vym offers
1.126 -much more features to work with such maps. \vym is not another drawing
1.127 -software, but a tool to store and modify information in an intuitive
1.128 -way. For example you can reorder parts of the map by pressing a key or
1.129 -add various information like a complete email by a simple mouse click.
1.130 +A \vym map (abbreviated below as {\em map}) is a tree-like structure:
1.131 +\maximage{images/example1.png}
1.132 +Such maps can be drawn by hand on a sheet of paper or flip chart and help to
1.133 +structure your thoughts. While a tree like structure like the illustration above can be
1.134 +drawn manually \vym offers much more features to work with such maps.
1.135 +\vym is not just another drawing software application, but a tool to store and modify
1.136 +information in an intuitive way. For example you can reorder parts of
1.137 +the map by pressing a key or add various pieces of information like a complete
1.138 +email by a simple mouse click.
1.139
1.140 -\subsection{Why should I use maps? Time, Space and your Brain.}
1.141 +Once you have finished collecting and organising your ideas, you can
1.142 +easily generate a variety of outputs including for example a
1.143 +presentation in Open~Office based on a {\em map}.
1.144 +
1.145 +\hint{You find the map shown above and others by clicking \begin{center}Help \ra Open vym
1.146 +examples\end{center} in the menu bar.}
1.147 +
1.148 +\subsection{Why should I use {\em maps}? Time, Space and your Brain.}
1.149 \subsubsection*{Space}
1.150 -A map can concentrate a very complex content on little space e.g. a
1.151 +A {\em map} can concentrate very complex content in a small space such as a
1.152 piece of paper. It helps to use both sides of your brain: the logical
1.153 -side and also your creative side (e.g. by using pictures, colors and
1.154 -keywords in a map, so called {\em anchors}). It is a technique to
1.155 -organize the way you think: It can help you by developing, sorting and
1.156 -memorizing your thoughts.
1.157 +side and also your creative side (e.g. by using pictures, colours and
1.158 +keywords in a map, often called {\em anchors}). It is a technique to help
1.159 +organize the way you think and stimulate your creativity: It can help you by developing, sorting and helping to memorise your ideas.
1.160
1.161 \subsubsection*{Time}
1.162 Because you just use keywords and drawings, it is much faster than good
1.163 -old fashioned notes. Your brain memorizes things by associating them to
1.164 -other things -- a map makes use of those connections and stimulates
1.165 +old fashioned 'notes'. Your brain memorizes things by associating them with
1.166 +other things -- a {\em map} makes use of those connections and stimulates
1.167 new asccociations.
1.168
1.169 +
1.170 \subsubsection*{Your Brain}
1.171 -In 1960 the Prof. {\sc Roger Sperry} discovered that both hemispheres
1.172 -of the human brain have different tasks (of course both of them
1.173 -basically {\em can} do the same): The left side is specialised in
1.174 -\begin{itemize}
1.175 - \item verbal speech and writing
1.176 - \item numbers
1.177 - \item logical thinking
1.178 - \item analyzing and details
1.179 - \item science
1.180 - \item linear thinking
1.181 - \item concept of time
1.182 -\end{itemize}
1.183 -while the right side of the human brain is specialised in
1.184 -\begin{itemize}
1.185 - \item body language
1.186 - \item visual thinking, day dreams
1.187 - \item intuition and emotion
1.188 - \item overview of things
1.189 - \item creativity
1.190 - \item art, music, dancing
1.191 - \item non-linear thinking, connecting things
1.192 - \item spatial awareness
1.193 -\end{itemize}
1.194 -In our science oriented society we have learned to mainly rely on our
1.195 -left side of the brain, the "rational" one. In other cultures,
1.196 -especially like the native americans and other "old" cultures, the right
1.197 -side is much more important. maps are just one way to stimulate the
1.198 -other side and make use of additional ressources we all have.
1.199 +In 1960 Prof. {\sc Roger Sperry} discovered that both hemispheres
1.200 +of the human brain undertake different tasks (of course both of them
1.201 +basically {\em can} do the same):
1.202 +\begin{center}
1.203 +\begin{tabular}{|p{5.5cm}|p{5.5cm}|} \hline
1.204 + Left side & Right side \\ \hline
1.205 + \begin{itemize}
1.206 + \item verbal speech and writing
1.207 + \item numbers
1.208 + \item logical thinking
1.209 + \item analysing and details
1.210 + \item science
1.211 + \item linear thinking
1.212 + \item concept of time
1.213 + \end{itemize} &
1.214 + \begin{itemize}
1.215 + \item body language
1.216 + \item visual thinking, day dreams
1.217 + \item intuition and emotion
1.218 + \item overview of things
1.219 + \item creativity
1.220 + \item art, music, dancing
1.221 + \item non-linear thinking, connecting things
1.222 + \item spatial awareness
1.223 + \end{itemize} \\ \hline
1.224 +\end{tabular}
1.225 +\end{center}
1.226 +In our science oriented western society we have learned to mainly rely on our
1.227 +left side of the brain, the "rational" one. In other cultures, such as the native americans and other "old" cultures, the right
1.228 +side is much more important. {\em Map} are just one way to stimulate the
1.229 +other side and make use of additional resources we all have.
1.230
1.231
1.232 -\subsection{Where could I use a map?}
1.233 -Here are some examples, how you can use those maps
1.234 +\subsection{Where could I use a {\em map}?}
1.235 +Here are some examples, how you can use those {\em maps}
1.236 \begin{itemize}
1.237 \item to prepare articles, papers, books, talks, \ldots
1.238 \item to sort complex data
1.239 - \item to memorize facts, persons, vocabulary, \ldots
1.240 + \item to memorize facts, peoples names, vocabulary, \ldots
1.241 \item to sort emails, files and bookmarks on your computer
1.242 \item to moderate conferences
1.243 + \item to brainstorm solutions to problems
1.244 + \item to record the tasks when planning a project
1.245 \end{itemize}
1.246
1.247 -\subsection{What you shouldn't do with a map...}
1.248 -A map drawn by somebody shows the way the author thinks. There is
1.249 -no right or wrong in the way it is drawn, so there is no way to critize
1.250 -it. "It is, what it is" ({\sc F.~Lehmann}).
1.251 +\subsection{What you shouldn't do with a {\em map}...}
1.252 +A {\em map} drawn by somebody shows the way that the author thinks. There is
1.253 +no question of right or wrong in the way it is drawn, so there is no way to criticise
1.254 +it. "It is, what it is" ({\sc F.~Lehmann}).The tool will be of considerable use to the author and only very limited use to anyone else.
1.255 +
1.256 +However, when groups share in creating a {\em map} all of the group will benefit from its use. An example of such use is when a Tutor develops a {\em map} with a group of students during instruction. Another group use is when a Project leader gathers a group of specialists to help {\em map} the tasks that will be required to deliver a project.
1.257
1.258 %\section{Tutorials}
1.259 %TODO
1.260
1.261 -\section{Concept}
1.262 +\subsection{Internet Ressources}
1.263 +A good starting point to learn more about Mindmaps in general is Wikipedia:
1.264 +\begin{itemize}
1.265 + \item English:
1.266 + \href{http://en.wikipedia.org/wiki/Mind_map}{http://en.wikipedia.org/wiki/Mind\_map}
1.267 + \item German:
1.268 + \href{http://de.wikipedia.org/wiki/Mindmap}{http://de.wikipedia.org/wiki/Mindmap}
1.269 +\end{itemize}
1.270
1.271 +
1.272 +
1.273 +
1.274 +\section{The Concept of the \vym application}
1.275 %TODO may add a general introduction here...
1.276 -
1.277 -\vym uses two windows: an editor for the map itself and another one for
1.278 -notes, which are part of the map. Let's call them {\em mapeditor} and
1.279 -{\em noteeditor}:
1.280 -\begin{center}
1.281 - \includegraphics[width=8cm]{windows.png}
1.282 -\end{center}
1.283 -Usually you will work in the {\em mapeditor} by just adding new
1.284 +\subsection{The Mainwindow and its satellites} \label{satellite}
1.285 +\vym comes with several windows, the central one being the {\em
1.286 +mapeditor}.
1.287 +More windows, each having a special purpose, can be opened and arranged
1.288 +around the mainwindow\footnote{
1.289 + The advantage of having separate window instead of integrating them
1.290 + in a combined workspace is flexibility in arranging the windows. For
1.291 + example I usually have the {\em noteeditor} "behind" the {\em
1.292 + mapeditor}. On Linux my windowmanager (KDE) allows me to enter text
1.293 + into a small visible corner of the {\em noteeditor} withour clicking
1.294 + the mouse button in it. I just push the mouse around to set the
1.295 + window focus, a concept which is useful also working with
1.296 + \href{http://www.gimp.org}{http://www.gimp.org}.
1.297 +}.
1.298 +The image below shows the {\em mapeditor}
1.299 +together with the often used {\em noteeditor}:
1.300 +\maximage{images/windows.png}
1.301 +Most of the time you will work in the {\em mapeditor} by just adding new
1.302 branches, moving around and reordering them. The various ways to do this
1.303 will be explained in \ref{mapeditor}. You can store additional
1.304 information e.g. the content of a email easily in a {\em branch}: Just
1.305 type or copy\&paste it into the {\em noteeditor}. Working with notes is
1.306 explained in \ref{noteeditor}
1.307 +
1.308 +Here is a list of the available satellite windows:
1.309 +\begin{itemize}
1.310 + \item Noteeditor (see \ref {noteeditor})
1.311 + \item Historywindow (see \ref{historywindow})
1.312 + \item Branch Property Window (see \ref{propwindow})
1.313 +\end{itemize}
1.314
1.315 -The map itself has always a {\em mapcenter}. The
1.316 -mapcenter has {\em branches} just like the trunk of a tree. Each branch
1.317 -in turn may have branches again.
1.318 -\begin{center}
1.319 - \includegraphics[width=10cm]{branches.png}
1.320 -\end{center}
1.321 +
1.322 +\subsection{Menus and Context menus}
1.323 +At the top of each window you will find the menubar. The options provided there
1.324 +are similar to those you are probably used to from other applications. Note that
1.325 +many (and even more) options are available via {\em context menus}. Those
1.326 +are available if you right-click onto an object in a map (on Mac~OS~X
1.327 +Command-Click).
1.328 +
1.329 +\subsection{Toolbars}
1.330 +The toolbars in the mainwindows give quick access to many functions and
1.331 +also display the state of selected objects in the map. For example a
1.332 +branch may show certain {\em flags}, the corresponding flags are also
1.333 +set in the toolbar.
1.334 +
1.335 +\hint {You can reposition all toolbars by simply grabbing and
1.336 +dragging them with the toolbar handle to a new position. For example you
1.337 +can move the flags-toolbar from its original horizontal position on top
1.338 +of the mapeditor to a vertical position on the right side. Or just
1.339 +insert it again at its original position. Also hiding some of the
1.340 +toolbars is possible by right-clicking on the toolbar handle.}
1.341 +
1.342 +\subsection{Maps}
1.343 +The {\em map} itself has always a {\em mapcenter}. The
1.344 +mapcenter has {\em branches} radiating out from the centre just like the trunk
1.345 +of a tree. Each branch in turn may have branches again.
1.346 + \maximage{images/branches.png}
1.347 We will call a branch directly connected to the mapcenter a {\em
1.348 mainbranch}, because it determines the position of all its child
1.349 branches.
1.350
1.351 The mapcenter and the branches all have a {\em heading}. This is the
1.352 text you see in the mapeditor. Usually it should just be one or a few
1.353 -words, so that one can easily keep track of the whole map.
1.354 +key words, so that one can easily keep track of the whole map.
1.355
1.356
1.357 In the toolbar above the mapeditor you see various symbols.
1.358 -\begin{center}
1.359 - \includegraphics[width=8cm]{default-flags.png}
1.360 -\end{center}
1.361 + \maximage{images/default-flags.png}
1.362 These are called {\em flags} and can be used to mark branches in the
1.363 -map, e.g. if something is important or questionable.
1.364 +{\em map}, e.g. if something is important or questionable.
1.365 There are also more flags set by \vym automatically to show additional
1.366 -information, e.g. when a exists for a particular branch.
1.367 +information, e.g. when a note is attached to a particular branch.
1.368 +
1.369 +By default some of these flags are set exclusively e.g. when the
1.370 +"thumb-up" flag is set, then the "thumb down" is reset and vice
1.371 +versa. You can change this default behaviour in the settings menu (see
1.372 +\ref{settings}).
1.373
1.374 \section{Mapeditor} \label {mapeditor}
1.375 \subsection{Start a new map}
1.376 -After \vym is started two windows will open: the mapeditor and the
1.377 -noteditor. Usually you will work in both windows, but at the moment we
1.378 +After \vym is started two windows will open: the {\em mapeditor} and the {\em noteditor}. Usually you will work in both windows, but at the moment we
1.379 will just need the mapeditor.
1.380
1.381 Select the mapcenter "New map" in the middle of the mapeditor by
1.382 -left-clicking with the mouse. It will turn yellow to show that is
1.383 -selected. There are two ways to add a new branch to the center:
1.384 +left-clicking with the mouse. It will be highlighted yellow to show that is
1.385 +selected. There are several ways to add a new branch to the center:
1.386 \begin{itemize}
1.387 - \item Main menu on top of mapeditor window:
1.388 - Edit \ra Add new Branch
1.389 - \item Press \key{Ins}
1.390 + \item Using the mouse: Open the context menu by clicking with the
1.391 + right mouse button (CTRL-Click on Mac) onto the
1.392 + mapcenter and choose Add \ra Add branch as child
1.393 + \item Press \key{Ins} or \key{A}
1.394 \end{itemize}
1.395 A new branch will appear and you will be able to type the heading of the
1.396 branch. Finish adding the new branch by pressing \key{Enter}.
1.397 %tipp
1.398 -Sometimes it comes handy to add a new branch above or below the current
1.399 -one. Use \key{Ins} together with \key{Shift} or \key{Ctrl}.
1.400 +Sometimes it comes in handy to be able to add a new branch above or below the current
1.401 +one.
1.402 +\begin{itemize}
1.403 + \item Use \key{Shift-A} to add a branch above the selected one or...
1.404 + \item \key{Ctrl-A} to add one below.
1.405 +\end{itemize}
1.406 +It is also
1.407 +possible to add a branch in such a way, that the current selection
1.408 +becomes the child of the new branch, which is like inserting it {\em
1.409 +before} the selection. This can be done using the context menu.
1.410 +
1.411 +\hint{To delete a branch press \key{CTRL-X}. If enabled in the Settings
1.412 +menu (see \ref{settings}), you can also use the \key{Del} key.}
1.413
1.414 \subsection{Navigate through a map}
1.415 \subsubsection*{Select branches}
1.416 To select branches you can use the left button of your mouse or also the
1.417 -arrow keys. Depending on the {\em orientation} of a branch type
1.418 -\key{\la} or \key{\ra} to get nearer to the mapcenter or deeper
1.419 +arrow keys. Depending on the {\em orientation} of a branch tap
1.420 +\key{\la} or \key{\ra} to move nearer to the mapcenter or deeper
1.421 down into the branches. Within a set of branches, let's call them a
1.422 -{\em subtree}, you can use \key{\ua} and \key{\da} to go up and down. You can
1.423 -also use \key{Pos1} and \key{End} to select the first and last branch.
1.424 +{\em subtree}, you can use \key{PgUp} and \key{PgDn} to go up and down. You can
1.425 +also use \key{Home} and \key{End} to select the first and last branch.
1.426
1.427
1.428 -\subsubsection*{Zoom a map}
1.429 +\subsubsection*{Panning the view of a map}
1.430 While adding more and more branches the size of the map may become
1.431 -bigger than the mapeditor window. You can use the scrollbars on the
1.432 -right and the bottom of your mapeditor window to scroll, but it is
1.433 -easier to just scroll using the left mouse button: Click onto the {\em
1.434 -canvas} itself, the empty space somewhere between the branches. The
1.435 -mouse pointer will change from an arrow to a hand, now move the visible
1.436 -part of the map to show the desired part.
1.437 +larger than the mapeditor window. You can use the scrollbars on the
1.438 +right and the bottom of your mapeditor window to scroll the view up or down or left or right. It is easier to just scroll using the left mouse button: Click anywhere on the {\em canvas} itself. Choose an empty space somewhere between the branches. The
1.439 +mouse pointer will change from an arrow to a hand, now move or drag the visible
1.440 +map to show the desired part.
1.441
1.442 If you select branches using the arrow keys, the map will scroll
1.443 to ensure that the selected branch is always visible.
1.444
1.445 +\subsubsection*{Zooming the view of a map}
1.446 Working with huge maps, the {\em zoom}-function comes in handy: You can
1.447 use
1.448 \begin{itemize}
1.449 - \item from the menu View \ra Zoom
1.450 + \item from the menu: View \ra Zoom in, View \ra Zoom out, View \ra reset Zoom.
1.451 \item the toolbar buttons
1.452 \begin{center}
1.453 - \includegraphics[width=3cm]{zoom-buttons.png}
1.454 + \includegraphics[width=3cm]{images/zoom-buttons.png}
1.455 \end{center}
1.456 \end{itemize}
1.457 -The crossed magnifying lens resets the zoomed view to its original size.
1.458 +Clicking the crossed magnifying lens icon will reset the zoomed view to its original size.
1.459
1.460
1.461 \subsubsection*{Find Function} \label{findwindow}
1.462 With huge maps there is the need to have a
1.463 find function. Choose Edit \ra Find to open the Find Window:
1.464 \begin{center}
1.465 - \includegraphics[width=6cm]{find-window.png}
1.466 + \includegraphics[width=6cm]{images/find-window.png}
1.467 \end{center}
1.468 -The text you enter here will be searched in all the headings and also in
1.469 -notes. Everytime you press the "Find"-button it will look for the next
1.470 -occurence, which then will be selected automatically. If the search
1.471 -fails, there will appear a short message "Nothing found" or a few
1.472 +The find function will search for, the text you enter here, in all the branch headings and also in the associated notes. Everytime you press the "Find"-button it will look for the next occurence, which will then be selected automatically. If the search
1.473 +fails, a short message "Nothing found" will appear for a few
1.474 seconds in the {\em statusbar} on the bottom of the mapeditor.
1.475
1.476 -\subsubsection*{Scroll a part of the map}
1.477 -A very big subtree of a map e.g. a branch with hundreds of childs makes
1.478 +\subsubsection*{Keep the overview -- scroll a part of the map}
1.479 +A very big subtree of a map e.g. a branch with hundreds of child branches would make
1.480 it very hard to keep an overview over the whole map. You can hide all
1.481 -the childs of a branch by {\em scrolling} it -- this function is also
1.482 -often called {\em folding}. Think of the whole subtree as painted onto a
1.483 -big newspaper. You can scroll the paper to a small roll, leaving just
1.484 -the headline readable.
1.485 +the children of a branch by {\em scrolling} it -- this function is often called {\em folding}. Think of the whole subtree as painted onto a
1.486 +broadsheet newspaper. You can scroll or fold the paper to a small roll, leaving just
1.487 +the headline visible.
1.488
1.489 -To scroll or unscroll a branch and its childs, press the
1.490 +To scroll or unscroll a branch and its children,
1.491 \begin{itemize}
1.492 - \item \key{Scroll} key or
1.493 + \item press the \key{S}
1.494 \item press the middle-mouse button or
1.495 - \item choose the little scroll from the toolbar.
1.496 + \item choose the scroll icon from the toolbar.
1.497 \end{itemize}
1.498 If you select parts of a scrolled branch e.g. using the find function or
1.499 by using the arrow-keys, it will unscroll temporary. This is shown as a
1.500 -scroll with a little hour glass. If the temporary unscrolled part is not
1.501 +scroll with a little hour glass. If the temporary unscrolled part is no
1.502 longer needed, it will be hidden again automatically. It is also
1.503 possible to unscroll all branches using "Edit\ra Unscroll all scrolled
1.504 branches".
1.505
1.506 -
1.507 +You can also hide parts of the map while exporting it e.g. to a webpage
1.508 +or a presentation, see \ref{hideexport} for details.
1.509
1.510 \subsection{Modify and move branches}
1.511 -\subsubsection*{Modify the heading of a branch}
1.512 +\subsubsection*{Modify the heading}
1.513 You can edit the heading by selecting the branch and then
1.514 \begin{itemize}
1.515 \item pressing \key{Enter}
1.516 + \item pressing \key{F2}
1.517 \item double-clicking with left mouse.
1.518 \end{itemize}
1.519 Just type the new heading (or edit the old one) and press \key{Enter}.
1.520 @@ -288,69 +422,69 @@
1.521 \item selecting Edit \ra Move branch
1.522 \item clicking on the toolbar buttons:
1.523 \begin{center}
1.524 - \includegraphics[width=1.5cm]{move-buttons.png}
1.525 + \includegraphics[width=1.5cm]{images/move-buttons.png}
1.526 \end{center}
1.527 \end{itemize}
1.528 %tipp
1.529 There is yet another way to move branches: If you press \key{Shift} or
1.530 \key{Ctrl} while moving with the mouse, the branch will be added above
1.531 -or below the one the mouse pointer is over. This helps also to reorder a
1.532 -map.
1.533 +or below the one the mouse pointer is over. This can also be used to reorder branches in a map.
1.534
1.535 -\subsection{The right side of your brain - colors and images}
1.536 -\subsubsection*{Change color of a heading}
1.537 -You can also use colors to put more information into a map, e.g. use
1.538 -red, green and more colors to prioritize tasks. Again you can
1.539 +\subsection{Colours and Images - Using the right side of your brain}
1.540 +\subsubsection*{Change colour of a heading}
1.541 +You can also use colours to add more information to a map, e.g. use
1.542 +red, green and more colours to prioritize tasks. Again you can
1.543 \begin{itemize}
1.544 - \item use the menu and choose e.g Format \rq Set Color
1.545 + \item use the menu and choose e.g Format \ra Set Color
1.546 \item use the toolbar
1.547 \begin{center}
1.548 - \includegraphics[width=3cm]{color-buttons.png}
1.549 + \includegraphics[width=3cm]{images/color-buttons.png}
1.550 \end{center}
1.551 \end{itemize}
1.552 -The first button (black in the graphic above) shows the actual color.
1.553 -Clicking on it let's you choose another color. You can also "pick"
1.554 -another color by selecting a branch with the desired color and using the
1.555 -"pick color" button. Both of the buttons showing a bucket actually put
1.556 -the current color to the selected branch. While the first one just
1.557 -colors the heading of the selection, the last one also colors all the
1.558 -childs of the selected branch.
1.559 +The first button (black in the graphic above) shows the current colour.
1.560 +Clicking on it let's you choose another colour. You can also "pick"
1.561 +another colour by selecting a branch with the desired colour and using the
1.562 +"pick colour" button. Both of the icons showing a palette actually apply
1.563 +the current colour to the selected branch. While the first one just
1.564 +colours the heading of the selection, the last one also colours all the
1.565 +children of the selected branch.
1.566
1.567 %tipp
1.568 -A very useful function is the "copy color" using the mouse: Select the
1.569 -branch which should get the new color, then press \key{Ctrl} and
1.570 -simultanously click with left-mouse on another branch to copy its color
1.571 -to the first one. Here the childs of the selection also will get the new
1.572 -color, if you just want to color the selection itself, additionally
1.573 +A very useful function is the "copy colour" using the mouse: Select the
1.574 +branch which should get the new colour, then press \key{Ctrl} and
1.575 +simultanously click with left-mouse on another branch to copy its colour
1.576 +to the first one. Here the children of the selection also will get the new
1.577 +colour, if you just want to colour the selection itself, additionally
1.578 press \key{Shift}.
1.579
1.580 \subsubsection*{Use flags}
1.581 -\vym provides various flags. You see them in the toolbar on top of the
1.582 +\vym provides various flags. They are usually displayed in the toolbar on top of the
1.583 mapeditor window. (Note: Like all toolbars you can also move them to the
1.584 left or the right side of the window or even detach them. Just grab the
1.585 very left "dotted" part of the toolbar with your left-mouse button.)
1.586 -\begin{center}
1.587 - \includegraphics[width=8cm]{default-flags.png}
1.588 -\end{center}
1.589 + \maximage{images/default-flags.png}
1.590 If you have a branch selected, you can set any number of flags by
1.591 clicking them in the toolbar. The toolbar buttons change their state and
1.592 -always reflect the flags set in the selected branch.
1.593 +always reflect the flags set in the selected branch. So, to remove a flag from a branch, select the branch and then click the highlighted flag on the toolbar.
1.594
1.595 -Presently \vym uses two kinds of flags: {\em System Flags} and {\em
1.596 +At present \vym uses two kinds of flags: {\em System Flags} and {\em
1.597 Standard Flags}. The standard flags are those shown in the toolbar.
1.598 System flags are set by \vym to indicate e.g. that there is additional
1.599 information in a note (more on this in \ref{noteeditor}). Later versions
1.600 of \vym may have another kind of flags, which may be edited by the user.
1.601
1.602 \subsubsection*{Images}
1.603 -You can add a image to a branch or the mapcenter by clicking with the
1.604 -right-mouse button. A context menu will open, choose "Add Image". A
1.605 -dialog window lets you choose the image to load.
1.606 +The easiest way to add an image to a branch is by dragging it e.g. from a
1.607 +webbrowser to the mapeditor while a branch is selected there.
1.608 +
1.609 +You can also add an image to a branch by opening the context menu of the
1.610 +branch. Right click the selected branch, choose "Add Image". A
1.611 +dialog window enables you choose the image to load.
1.612 \footnote{Supported image types are: PNG, BMP, XBM, XPM and PNM. It may
1.613 also support JPEG, MNG and GIF, if specially configured during
1.614 compilation (as done when \vym is part of SUSE LINUX).}
1.615 -While an image is selected in the dialog, you can see a preview of the
1.616 -image.
1.617 +While an image is selected in the dialog, a preview of the
1.618 +image is displayed. It is also possible to select multiple images.
1.619
1.620 You can position the image anywhere you want, just drag it with left
1.621 mouse. To relink it to another branch, press \key{Shift} while moving
1.622 @@ -358,7 +492,9 @@
1.623
1.624 If you right-click onto an image, a context menu will open which let's
1.625 you first choose one of several image formats. Then a file dialog opens
1.626 -to save the image. Hint: This is used to "export" the image, it will be
1.627 +to save the image.
1.628 +
1.629 +Hint: This is used to "export" the image, it will be
1.630 saved anyway in the map itself! You can also cut and
1.631 copy images, but it is not possible to add objects to an image\footnote{
1.632 Images are regarded as "extra feature". It would make working with
1.633 @@ -376,36 +512,37 @@
1.634 changing its z-value (put it into background) etc.
1.635
1.636 \subsubsection*{Frames}
1.637 -A frame can be added to a branch by clicking with the
1.638 -right-mouse button. A context menu will open, where you can choose the
1.639 -frame. At the moment just a rectangle resp. "No Frame" will be offered,
1.640 -nevertheless you can use images as frames. Have a look at the demo map
1.641 -{\tt todo.vym} as an example, where the mapcenter is a cloud. You can
1.642 -use an external drawing program like {\tt gimp} to create an image,
1.643 +A frame can be added to a branch in the {\em property window} (see
1.644 +\ref{propwindow}).
1.645 +Alternatively, you can use use images as frames. Have a look at the demo
1.646 +map {\tt todo.vym} as an example, where the mapcenter is a cloud. You
1.647 +can use an external drawing program like {\tt gimp} to create an image,
1.648 preferable with an transparency channel, so that you can design frames
1.649 -which don't use a rectangular borderline, just like the cloud.
1.650 +which don't use a rectangular borderline, just like that cloud.
1.651
1.652
1.653 -\subsection{Background design}
1.654 +\subsection{Design of map background and connecting links }
1.655 The design of the background of a map and also of the links connecting
1.656 various parts of the map can be changed by
1.657 \begin{itemize}
1.658 \item Selecting Format from the menu
1.659 - \item Right clicking onto the canvas, which will open a context menu
1.660 + \item Right clicking on the canvas, which will open a context menu
1.661 \end{itemize}
1.662
1.663 -\subsubsection*{Background color}
1.664 -The color is set (and also displayed) as "Set background color".
1.665 +\subsubsection*{Background }
1.666 +The colour is set (and also displayed) as "Set background colour".
1.667 +Alternatevily you can set an background image, though this is not
1.668 +recommended in general. Working on the map becomes slow and the image
1.669 +currently cannot be positioned freely.
1.670
1.671 -\subsubsection*{Link color}
1.672 -Links connecting branches can be colored in one of the following ways:
1.673 +\subsubsection*{Link colour}
1.674 +Links connecting branches can be coloured in one of two ways:
1.675 \begin{itemize}
1.676 - \item use the color of the heading of the branch the links is
1.677 - \item use {\em one} color for all links. The default color is blue.
1.678 - leading to.
1.679 + \item use the same colour for the heading and for the branch link line.
1.680 + \item use {\em one} colour for all links and choose different colours for the branch headings text. The default colour for branch link lines is blue.
1.681 \end{itemize}
1.682 -The latter can be set with "Set link color". Check or uncheck the "Use
1.683 -color of heading for link" option to choose one of the two designs for
1.684 +The latter can be set with "Set link colour". Check or uncheck the "Use
1.685 +colour of heading for link" option to toggle between the two designs for
1.686 your map.
1.687
1.688 \subsubsection*{Link style}
1.689 @@ -416,49 +553,56 @@
1.690 \item Thick Line
1.691 \item Thick Parabel
1.692 \end{itemize}
1.693 -The "thick" styles only draw links starting at mapcenter thick, the rest
1.694 -of the map is always painted "thin".
1.695 +The "thick" styles only apply to links starting at the mapcenter, link lines for the rest
1.696 +of the map are always painted "thin".
1.697
1.698
1.699 -\subsection{Link to other documents}
1.700 -Presently \vym supports two kind of links:
1.701 +\subsection{Links to other documents and webpages}
1.702 +\vym supports two kind of external links:
1.703 \begin{itemize}
1.704 \item Document, which will be opened in an external webbrowser
1.705 \item \vym map, which will be opened in \vym itself
1.706 \end{itemize}
1.707 +In addition to the external links there also internal ones, leading from one
1.708 +branch in a map to another one. Those are called {\em XLinks} and are explained
1.709 +in section~\ref{xlinks}.
1.710
1.711 \subsubsection*{Webbrowser}
1.712 -Modern Webbrowsers like {\tt konqueror} are able to display various
1.713 -types of files, both local or in the internet. To enter the URL of
1.714 -any document, right-click onto a branch or use the Edit Menu
1.715 -and choose "Edit URL". Enter the path to your document (or copy and
1.716 -paste it from your browser). Examples for valid paths are:
1.717 -\begin{verbatim}
1.718 - http://www.insilmaril.de/vym/index.html
1.719 - file:/usr/share/doc/packages/vym/doc/vym.pdf
1.720 -\end{verbatim}
1.721 -If an URL was entered, a little globe will appear in the branch. By
1.722 +Modern Webbrowsers like {\tt konqueror and Firefox} are able to display various
1.723 +types of files, both local or on the internet. To enter the URL of
1.724 +any document, press \key{U} or right-click onto a branch to open the contextmenu then choose
1.725 +"References\ra Edit URL". If you want to use a file dialog to
1.726 +conveniently choose a local file you can use~\key{U}.
1.727 +
1.728 +After an URL was entered, a little globe will appear in the branch. By
1.729 clicking on the globe in the toolbar or the context menu an external
1.730 browser\footnote{
1.731 - The browser can be changed in the Settings Menu.}
1.732 -will be started.
1.733 + The browser can be changed in the Settings Menu (see \ref{settings}).}
1.734 +will be launched.
1.735 \begin{center}
1.736 - \includegraphics[width=0.5cm]{flag-url.png}
1.737 + \includegraphics[width=0.5cm]{images/flag-url.png}
1.738 \end{center}
1.739 -If you want to keep bookmarks in a map, you may want to copy the heading
1.740 -as URL: Right click onto the branch and select "Use heading for URL".
1.741 +For more information on working with bookmarks and webbrowsers see
1.742 +section \ref{bookmarks}.
1.743 +
1.744 +In the context menu there is also an option to open all URLs found
1.745 +in the selected subtree of the map. That's useful to simultanously open
1.746 +a collection of URLs in the webbrowser, especially if the browser can
1.747 +open them in tabs (like Konqueror).
1.748 +
1.749
1.750 \subsubsection*{\vym map}
1.751 -To link to to another map right click on a branch or choose "Edit \ra
1.752 -Enter \vym link". A file dialog opens where you can choose the map. A
1.753 +To link to to another map right click on a branch and choose "Edit \vym link". A file dialog opens where you can choose the map. A
1.754 branch with a link is marked with
1.755 \begin{center}
1.756 - \includegraphics[width=0.5cm]{flag-vymlink.png}
1.757 + \includegraphics[width=0.5cm]{images/flag-vymlink.png}
1.758 \end{center}
1.759 -Clicking this flag in the toolbar or in the context menu of a branch
1.760 -will open the map in another tab (see \ref{tabs} for working with
1.761 -multiple maps). To delete an existing link, just press the "Cancel"
1.762 -button.
1.763 +Clicking this flag beside the branch heading, in the toolbar or in the context menu of a branch will open the map in another tab (see \ref{tabs} for working with
1.764 +multiple maps). To delete an existing link, just right click the branch and select "Delete \vym link".
1.765 +
1.766 +In the context menu there is also an option to open all vymlinks found
1.767 +in the selected subtree of the map. That's useful to simultanously open
1.768 +a collection of related maps.
1.769
1.770 Technical note: Internally \vym uses absolute paths, to avoid opening
1.771 several tabs containing the same map. When a map is saved, this path is
1.772 @@ -486,101 +630,154 @@
1.773 % Scrolling
1.774
1.775 \section{Noteeditor} \label {noteeditor}
1.776 -If you want to save more text in a branch e.g. a complete email, a
1.777 +If you want to attach more text to a branch e.g. a complete email, a
1.778 cooking recipe, or the whole source code of a software project, you can
1.779 -use the noteeditor. Since version 1.4.7 \vym supports formatted text in
1.780 -the noteeditor.
1.781 +use the noteeditor.
1.782 + \maximage{images/noteeditor.png}
1.783 +This editor displays text associated with a branch selected in the mapeditor. The noteeditor
1.784 +shows different background colours depending on whether text is associated with a selected branch.
1.785
1.786 -\subsubsection*{States}
1.787 +\subsection{States}
1.788 Before you can type or paste text into it, you have
1.789 -to select a branch in the mapeditor. Note that the background color
1.790 +to select a branch in the mapeditor. Note that the background colour
1.791 of the noteeditor indicates its state:
1.792 \begin{itemize}
1.793 - \item black: no branch selected
1.794 \item grey: no text entered yet
1.795 - \item white: text is already available
1.796 + \item white: some text has been entered
1.797 \end{itemize}
1.798 -To show you in the mapeditor itself that there is a note with more
1.799 -information for a particular branch, a little note flag will appear next
1.800 -to the heading of the branch. See the lower branch on the right side:
1.801 -\begin{center}
1.802 - \includegraphics[width=8cm]{branches-flags.png}
1.803 -\end{center}
1.804 +In the mapeditor itself, to signal that there is a note with more
1.805 +information for a particular branch, a little "note" flag will appear next
1.806 +to the heading of the branch. This is illustrated in the lower branch on the right hand side:
1.807 + \maximage{images/branches-flags.png}
1.808
1.809 -\subsubsection*{Import and export notes}
1.810 -The note is always saved automatically within the \vym file itself.
1.811 +\subsection{Import and export notes}
1.812 +The note is always saved automatically within the \vym map itself.
1.813 Nevertheless sometimes it is nice to import a note from an external file
1.814 -or write it. Use "File\ra~Import" and "File\ra~Export" to do so.
1.815 +or write it. In the Note Editor use "File\ra~Import" and "File\ra~Export" to do so.
1.816
1.817 -\subsubsection*{Edit and print note}
1.818 +\subsection{Edit and print note}
1.819 Editing works like in any simple texteditor, including undo and redo
1.820 functions. You can delete the complete note by clicking the
1.821 trashcan. Only the note itself is printed by clicking the printer icon.
1.822
1.823 -When pasting into the editor using the X11 copy\&paste mechanism, the
1.824 -editor will create a paragraph for each new line. Usually this is not
1.825 -wanted, so there you can convert all paragraphs into linebreaks by using
1.826 -Edit~\ra~Remove~Paragraphs or \key{ALT-X}.
1.827 +\subsection{RichText: Colours, paragraphs and formatted text}
1.828 +\vym supports formatted text (QT Rich Text) in the noteeditor since
1.829 +version 1.4.7. Colours and text attributes (e.g. italic, bold) can be
1.830 +set with the buttons above the text.
1.831 +%The text itself is divided into
1.832 +%paragraphs. For each paragraph the format can be set (e.g. centered,
1.833 +%right). A paragraph is ended when a \key{Return} is entered. If you just
1.834 +%want to begin a new line, press \key{CTRL-Return}.
1.835
1.836 -\subsubsection*{Fonts}
1.837 -The noteeditor is ment to be used for simple notes, not really as full
1.838 -featured text editor. Because of many requests \vym supports now
1.839 +\subsection{Fonts and how to switch them quickly}
1.840 +The noteeditor is designed to be used for simple notes, not really as a full
1.841 +featured word processor. Because of many requests \vym supports
1.842 formatted text in the noteeditor\footnote{
1.843 \vym uses the QRichtText format, which is basically a subset of the
1.844 formatting provided in HTML.}
1.845 -Two default fonts are supported which can be set in the Settings menu.
1.846 +Two default fonts are supported which can be set in the Settings menu
1.847 +(see \ref{settings}).
1.848 One is a fixed width font, the other has variable width. The fixed font
1.849 is usually used for emails, source code etc.\ while the variable font is
1.850 used for simple notes, where one doesn't need fixed character widths.
1.851 Both fonts can easily switched using the following symbol from the
1.852 toolbar:
1.853 \begin{center}
1.854 - \includegraphics[width=0.5cm]{formatfixedfont.png}
1.855 + \includegraphics[width=0.5cm]{images/formatfixedfont.png}
1.856 \end{center}
1.857 -In the Settings menu both fonts can be set and also which font should be
1.858 -used for default.
1.859 +In the Settings menu both fonts can be set. The default font can also be toggled between the fixed and variable font by selecting or deselecting the "fixed font is default" menu item.
1.860
1.861 Additionally to the default fonts any font installed on your system can
1.862 be used. Please note, that the chosen font also will be used for HTML
1.863 -exports, so you should only use fonts which are available generally.
1.864 +exports, so if youy VYM mind map could ever be exported to a web or intranet page you should only use fonts which are available generally.
1.865
1.866 -\subsubsection*{Colors and formatted text}
1.867 -Colors and text attributes (e.g. italic, bold) can
1.868 -be set with the buttons above the text.
1.869 -The text itself is divided in paragraphs. For each paragraph the format
1.870 -can be set (e.g. centered, right). A paragraph is ended when a
1.871 -\key{Return} is entered. If you just want to begin a new line, press
1.872 -\key{CTRL-Return}.
1.873 -
1.874 -\subsubsection*{Finding text}
1.875 +\subsection{Find text}
1.876 The noteeditor itself has no Find function, use Find in the mapeditor,
1.877 which will also search all notes (see \ref{findwindow}).
1.878
1.879 -\subsubsection*{Pasting text into note editor}
1.880 +\subsection{Paste text into note editor}
1.881 Often you will paste text into the editor from another application e.g.
1.882 an email. Normally \vym will generate a new paragraph for each new line.
1.883 This usually is not what you want, so you can choose from the menu
1.884
1.885 -\paragraph{Edit \ra Convert Paragraphs:}
1.886 -This turns paragraphs in selected text (or all text, if nothing is
1.887 -selected) into linebreaks. This is especially useful for snippets of
1.888 -source code.
1.889 -
1.890 -\paragraph{Edit \ra Join Lines:}
1.891 -Tries to format text, so that empty lines are used to delimit
1.892 -paragraphs. This is done for selected text (or all text, if nothing is
1.893 -selected). Especially useful for text like emails, meeting minutes etc.
1.894
1.895 \section{Hello world}
1.896 -\vym can export its maps in various formats and can import data from
1.897 -outside (though import is still limited at the moment).
1.898 +This section is about how \vym can interact with other applications.
1.899 +Many applications can now read and write their data using XML, the
1.900 +eXtensible Markup Language. \vym also uses XML to save its maps, see
1.901 +\ref{fileformat} for a more detailed description.
1.902
1.903 -\subsection{Export}
1.904 -The format in which the map will be exported can be chosen with
1.905 +So if you make use of another application that understands XML, chances are good that someone
1.906 +could write import/export filters for \vym. Volunteers are always
1.907 +welcome ;-)
1.908 +
1.909 +\subsection{Import} \label{import}
1.910 +
1.911 +\subsubsection*{KDE Bookmarks}
1.912 +The integrated bookmark editor in KDE (Konqueror etc.) is somewhat limited, so why not
1.913 +use \vym to maintain the bookmark mess? To create a new map containing
1.914 +your current KDE bookmarks just choose
1.915 \begin{itemize}
1.916 - \item File \ra Export \ra {\em format}
1.917 + \item File \ra Import\ra KDE Bookmarks
1.918 \end{itemize}
1.919 -\vym offers both HTML and ASCII export.
1.920 +
1.921 +\subsubsection*{Mind Manager}
1.922 +\vym has currently a very basic import filter to convert maps created by
1.923 +{\em Mind Manager}\footnote{Mind Manager is a commercial i.e. non free, software application by Mindjet for Windows and the Mac. Both names are registered trademarks by Mindjet. For more information see their website at
1.924 +\href{http://mindjet.com}{http://mindjet.com}} into \vym maps. Notes and
1.925 +pictures are not converted at the moment. You can import files with
1.926 +\begin{itemize}
1.927 + \item File \ra Import\ra Mind Manager
1.928 +\end{itemize}
1.929 +
1.930 +
1.931 +\subsubsection*{Directory structure}
1.932 +\vym can read a directory structure. This is mainly for
1.933 +testing \vym e.g. to easily create huge maps used for benchmarks (yes,
1.934 +there is still room to optimize \vym ;-)
1.935 +
1.936 +
1.937 +
1.938 +
1.939 +\subsection{Export} \label{export}
1.940 +\label{hideexport}
1.941 +Often you may not want to export the whole map, but just parts of it. For
1.942 +example you may have additional info you want to talk about in a
1.943 +presentation, while those parts should not be visible to the audience.
1.944 +To achieve this you can "hide" parts of the map during exports by
1.945 +setting the "hide in export" flag.
1.946 +\begin{center}
1.947 + \includegraphics[width=0.5cm]{images/flag-hideexport.png}
1.948 +\end{center}
1.949 +You can toggle this flag in the toolbar or by pressing \key{H}.
1.950 +Note that there is a global option in the settings menu (
1.951 +\ref{settings}) to toggle the use of this flag. By default the flag is
1.952 +enabled.
1.953 +
1.954 +\subsubsection*{Open Office}
1.955 +Open Office beginning with version~2 uses the so called "Open Document Format", which can be written by \vym. The options are
1.956 +currently limited, but it possible to export presentations which can be
1.957 +opened in Open Office Impress. By selecting
1.958 +\begin{itemize}
1.959 + \item File \ra Export\ra Open Office
1.960 +\end{itemize}
1.961 +you get a file dialogue where you can choose the output file and the
1.962 +file type:
1.963 + \maximage{images/export-oo.png}
1.964 +The file types represent various templates, which can be created with
1.965 +some manual work from an existing Open Office document. The structure of
1.966 +\vym map is then inserted into a template.
1.967 +There are some limitations at the moment:
1.968 +\begin{itemize}
1.969 + \item \vym can't take care of page lengths, so you have to check and
1.970 + probably reedit in Open Office to avoid text running over the end of
1.971 + a page
1.972 + \item Images and flags are not used at the moment
1.973 + \item Notes are just written as plain text, without RichText
1.974 + \item The full range of templates are not available in all distributions.
1.975 +\end{itemize}
1.976 +Some of the templates make use of {\em sections} i.e sections insert the
1.977 +headings of mainbranches as chapters for sections into the presentation.
1.978
1.979 \subsubsection*{Image}
1.980 \vym supports all image formats which are natively supported by the
1.981 @@ -592,26 +789,52 @@
1.982
1.983 \subsubsection*{ASCII}
1.984 Exporting an image as text is somewhat experimental at the moment. Later
1.985 -this will probably done using stylesheets. So the output may change in
1.986 +this will probably be done using stylesheets. So the output may change in
1.987 future versions of \vym.
1.988
1.989 -\subsubsection*{HTML}
1.990 -Before a map is exported as HTML, it will be first written as XML into a
1.991 +\subsubsection*{\LaTeX}
1.992 +\vym can generate an input file for \LaTeX. Currently this is considered
1.993 +as experimental, there are no options (yet).
1.994 +By selecting
1.995 +\begin{itemize}
1.996 + \item File \ra Export\ra \LaTeX
1.997 +\end{itemize}
1.998 +you will be asked in a file dialog for the name of the output file. This
1.999 +file may then be included in a \LaTeX document using command:
1.1000 +\begin{verbatim}
1.1001 + \include{inputfile.tex}
1.1002 +\end{verbatim}
1.1003 +
1.1004 +\subsubsection*{KDE Bookmarks}
1.1005 +\vym will overwrite the KDE bookmarks file and then try to notify
1.1006 +running Konquerors via DCOP of the changed file. \vym does not create a
1.1007 +backup!
1.1008 +\begin{itemize}
1.1009 + \item File \ra Export \ra KDE Bookmarks
1.1010 +\end{itemize}
1.1011 +
1.1012 +
1.1013 +\subsubsection*{XHTML (Webpages)}
1.1014 +
1.1015 +This is the format to use if you wish to create a webpage. To see an example
1.1016 +visit the \vym homepage:
1.1017 +\href{http://www.InSilmaril.de/vym}{www.InSilmaril.de/vym}
1.1018 +
1.1019 +Some explanation on how this works:
1.1020 +Before a map is exported as XHTML, it will be first written as XML into a
1.1021 directory (see \ref{xmlexport}). Then the external program {\tt
1.1022 -xsltproc}\footnote{On SUSE Linux {\tt xsltproc} is installed by
1.1023 +xsltproc}\footnote{On SUSE Linux and some other distributions {\tt xsltproc} is installed by
1.1024 default.}
1.1025 will be called to process the XML file and generate HTML code.
1.1026 -%A script then will transform the XML
1.1027 -%version.
1.1028 -A dialog allows to set various options:
1.1029 +A dialog allows the user to set various options:
1.1030 \begin{itemize}
1.1031 \item {\bf Include image:} If set, \vym will creat an image map at
1.1032 the top of the HTML output. Clicking on a branch in the map will
1.1033 jump to the corresponding section in the output.
1.1034
1.1035 \item {\bf Colored headings:}
1.1036 - If set to yes, \vym will color the headings in the text part with the
1.1037 - same colors like in the map.
1.1038 + If set to yes, \vym will colour the headings in the text part with the
1.1039 + same colours used in the \vym map.
1.1040 \item {\bf Show Warnings:}
1.1041 If set to yes, \vym will ask before overwriting data.
1.1042 \item {\bf Show output:}
1.1043 @@ -621,285 +844,616 @@
1.1044 Additionally the paths to the CSS and XSL stylesheets can be set. By
1.1045 default on SUSE~Linux they will be in {\tt /usr/share/vym/styles}.
1.1046
1.1047 -%\paragraph{WIKI style:} This is very useful for easy design of webpages.
1.1048 -%Here is a short overview:
1.1049 -%\begin{verbatim}
1.1050 -%Lines:
1.1051 -% + Big headlines start with the '+' character.
1.1052 -% - Small headlines start with the '-' character.
1.1053 -% Normal text doesn't have any starting notation.
1.1054 -% ! Notes start with an exclamation.
1.1055 -% . Indented text starts with a dot.
1.1056 -% ? Questions start with a question-mark, and
1.1057 -% = Answers starts with the equal-sign.
1.1058 -% * Points for a item-list
1.1059 -% # clues
1.1060 -%
1.1061 -%Links:
1.1062 -% use '{...}' or '{(vym homepage) http://www.insilmaril.de/vym/}'
1.1063 -% for external links.
1.1064 -%
1.1065 -%Markup:
1.1066 -% |This is bold| text, while
1.1067 -% |/this text is italic|,
1.1068 -% |*this is pre-formatted|, and
1.1069 -% |!this is a note|
1.1070 -%\end{verbatim}
1.1071 -%
1.1072 -%\paragraph{Show output:} This is used for debugging. \vym uses an
1.1073 -%the external script {\tt vym2html.sh} to preprocess the XML-data. Then
1.1074 -%\vym calls {\tt xsltproc} to generate the HTML page by using various
1.1075 -%{\tt .xsl} stylesheets and {\tt wireframe.css}. If you run into problems
1.1076 -%here, changing paths in {\tt $\sim$/.qt/vymrc} might help.
1.1077
1.1078 \subsubsection*{XML} \label{xmlexport}
1.1079 -The map is written into a directory both as an image and as XML. The
1.1080 +The map is written into a directory both as an image and as an XML file. The
1.1081 directory is set in a file dialog. If the directory is not empty, you
1.1082 -will be questioned if you risk to overwrite its contents.
1.1083 +will be warned and offered choices if you are at risk of overwriting existing contents.
1.1084
1.1085 It is possible to export different maps into the same directory. Each
1.1086 file generated will have the map's name as prefix, e.g. {\tt todo.vym}
1.1087 becomes {\tt todo.xml}, {\tt todo.png}, {\tt todo-image-1.png} and so
1.1088 -on. This is useful if e.g. for a website several combined maps have to
1.1089 -be stored in the same directory.
1.1090 +on. This is useful if, for example, a website comprises several combined maps that have to be stored in the same directory.
1.1091
1.1092 -\subsection{Import}
1.1093 -At the moment \vym can read a directory structure. This is mainly for
1.1094 -testing \vym e.g. to easily create huge maps used for benchmarks (yes,
1.1095 -there is still room to optimize \vym ;-)
1.1096 +\subsubsection*{Export a part of a map}
1.1097 +Select a branch you want to export together with its children, then open
1.1098 +the context menu and choose {\em Save Selection}. This will create a
1.1099 +file with the suffix {\tt .vyp}, which is an abbreviation for \lq vym
1.1100 +part\rq.
1.1101
1.1102 -Many other applications meanwhile can export their data using XML, so
1.1103 -volunteers to write import filters are welcome.
1.1104
1.1105 -\subsection{File format}
1.1106 -\vym maps usually have the postfix "{\tt .vym}" and represent a
1.1107 -compressed archive of data. If you want to have a
1.1108 -closer look into the data structure, just uncompress the map manually
1.1109 -using
1.1110 +\section{Advanced Editing}
1.1111 +
1.1112 +\subsection{Properties of an object}
1.1113 +For any branch you can open a satellite window (see \ref{satellite}):
1.1114 +the {\em property window}:
1.1115 +\begin{center}
1.1116 + \includegraphics[width=8cm]{images/propwindow.png}
1.1117 + \label{propwindow}
1.1118 +\end{center}
1.1119 +%FIXME create screenshot
1.1120 +%FIXME explain the tabs
1.1121 +
1.1122 +\begin{itemize}
1.1123 + \item Frame
1.1124 + \item Link (see \ref{hideunselected})
1.1125 + \item Layout (see \ref{incimg})
1.1126 +\end{itemize}
1.1127 +
1.1128 +\subsection{Changing the history: Undo and Redo}
1.1129 +\vym keeps track of all changes done in a map. The default number of
1.1130 +changes which can be undone is~75. The complete history can be seen in
1.1131 +the {\em historywindow}:
1.1132 + \maximage{images/historywindow.png}
1.1133 + \label{historywindow}
1.1134 +A single step back be undone or redone with \key{CTRL-Z} or \key{CTRL-Y},
1.1135 +or by using the buttons in the toolbar or the {\em historywindow}.
1.1136 +Inside the {\em historywindow}, you can click on a line to unwind all
1.1137 +actions done until that point in time -- or redo all changes by clicking
1.1138 +on the last line.
1.1139 +
1.1140 +\hint{
1.1141 + You can "paste from the past": Go back in time by e.g. with
1.1142 + \key{CTRL-Z}, then copy to clipboard by pressing \key{CTRL-C}.
1.1143 +
1.1144 + Now do all actions again, e.g. by \key{CTRL-Y} or clicking on the
1.1145 + last action in {\em historywindow}. Now paste from the past with
1.1146 + \key{CTRL-V}.
1.1147 +}
1.1148 +
1.1149 +\subsection{Macros} \label{macros}
1.1150 +Macros have been added to \vym in version~1.9.0.
1.1151 +So far they have a preliminary character, maybe they are going to be
1.1152 +replaced by full-featured scripting functionality later (though the
1.1153 +commands will be more or less the same).
1.1154 +
1.1155 +Each function key
1.1156 +\key{F1} to \key{F12} holds a macro, which is executed on the current
1.1157 +selection if the key is pressed. The default macros change the colour of
1.1158 +a subtree or set the frame of a branch:
1.1159 +\begin{center}
1.1160 + \includegraphics[width=8cm]{images/macros.png}
1.1161 +\end{center}
1.1162 +Each macro is a \vym script, which is executed when the associated key
1.1163 +is pressed. The default location of the scripts can be changed in the
1.1164 +Settings menu. More information on using scripts in \vym is found in
1.1165 +[\ref{settings})
1.1166 +appendix~\ref{scripts}.
1.1167 +
1.1168 +\subsection{Bookmarks} \label{bookmarks}
1.1169 +\subsubsection*{Open new tabs instead of new windows}
1.1170 +If you use konqueror as your browser, \vym will remember the konqueror session which
1.1171 +was opened first by \vym. You can also press \key{Ctrl} and click to
1.1172 +open the link in a new tab.
1.1173 +
1.1174 +\vym can also open a new tab in Mozilla or Firefox using the remote
1.1175 +command\footnote{\href{http://www.mozilla.org/unix/remote.html}{http://www.mozilla.org/unix/remote.html}}
1.1176 +of these browsers.
1.1177 +
1.1178 +\subsubsection*{Drag and Drop}
1.1179 +If you want to keep bookmarks in a map, select a branch where you want
1.1180 +to add the bookmark, then simply drag the URL from your browser to the
1.1181 +map. Also you could use an existing heading as URL: Right click onto the
1.1182 +branch and select "Use heading for URL".
1.1183 +
1.1184 +
1.1185 +\subsubsection*{Directly access bookmark lists of a browser}
1.1186 +Please see the sections \ref{import} and \ref{export} about
1.1187 +Import and Export filters.
1.1188 +
1.1189 +\subsubsection*{Special URLs}
1.1190 +\vym can turn an existing heading of a branch into an URL. Currently
1.1191 +this works for Bugentries in the Novell Bugtracking system: Open the
1.1192 +context menu of a branch (usually by right-clicking it) and select
1.1193 +\begin{itemize}
1.1194 + \item Create URL to Bugzilla
1.1195 +\end{itemize}
1.1196 +The URL will be build from the number in the heading.
1.1197 +
1.1198 +\subsection{Associating images with a branch} \label{incimg}
1.1199 +The default setting for an image is for it to float "freely". Images can be
1.1200 +positioned anywhere on the canvas, but may end up in the same place as other
1.1201 +parts of the map obscuring that part of the map.
1.1202 +
1.1203 +The solution is to insert or include them "into" a branch. This can be done via
1.1204 +the property window (see \ref{propwindow}):
1.1205 +\begin{itemize}
1.1206 + \item Include images horizontally
1.1207 + \item Include images vertically
1.1208 +\end{itemize}
1.1209 +The image is still positioned relative to its parent branch, but the
1.1210 +heading and border of the branch frame adapt to the floating image, see below:
1.1211 + \maximage{images/includeImages.png}
1.1212 +
1.1213 +\subsection{Modifier Modes}
1.1214 +Modifiers are for example the \key{Shift}- the \key{Ctrl}- ot the \key{Alt}-keys. When
1.1215 +pressed while applying mouse actions, they will cause \vym to use
1.1216 +a "modified" version of the action which usually would be done.
1.1217 +
1.1218 +%\key{Ctrl} or \key{Alt}is pressed while releasing the branch, it will be
1.1219 +%added above/below the target, not as child of the target.
1.1220 +
1.1221 +Without a modifier key pressed, the first mouse click on a branch just selects
1.1222 +it. For the behaviour of the \key{Ctrl} modifier there are several
1.1223 +options, which can be set from the modifier toolbar:
1.1224 +\begin{center}
1.1225 + \includegraphics[width=3cm]{images/modmodes.png}
1.1226 +\end{center}
1.1227 +The default mode is to copy the colour from the clicked branch to the already
1.1228 +selected branch. The figure above shows the toolbar with the default modifier
1.1229 +selected. The second modifier
1.1230 +let's you easily copy a whole branch with a single click. The third
1.1231 +modifier lets you create links between branches called {\em xLinks}.
1.1232 +They will be explained in the next section \ref{xlinks}.
1.1233 +
1.1234 +\subsection{Hide links of unselected objects} \label{hidelink}
1.1235 +Sometimes it would be useful to position a branch freely, just like a
1.1236 +mainbranch or an image. This is possible for all
1.1237 +branches, you can use a mainbranch and hide its connecting link to the
1.1238 +mapcenter or hide the link between a child branch and its parent. This can be used e.g. for legends or a collection of vymLinks
1.1239 +pointing to other maps:
1.1240 +\begin{center}
1.1241 + \includegraphics[width=9cm]{images/hiddenlink.png}
1.1242 +\end{center}
1.1243 +To hide the link between a branch and its parent open the
1.1244 +\ref{propwindow} and check "Hide link if object is not selected" on
1.1245 +"Link" tab.
1.1246 +
1.1247 +
1.1248 +\subsection{XLinks} \label{xlinks}
1.1249 +So far all the data in the \vym map has been treelike. Using xLinks you
1.1250 +can link one branch to any other, just like attaching a rope between two
1.1251 +branches in a real tree. This is especially useful in complex maps,
1.1252 +where you want to have crossreferences which can not be displayed on the same
1.1253 +visible area of the {\em mapeditor} window. The following example map still fits on one screen, but shows how data can be crosslinked. In the graphics there is a link from a task (prepare a presentation) to general information:
1.1254 + \maximage{images/xlink.png}
1.1255 +Note that a xLink which points to a branch that is not visible (because
1.1256 +it is scrolled), is just shown as a little horizontal arrow. In the
1.1257 +screenshot above have a look at the \lq Tuesday\rq\ branch.
1.1258 +
1.1259 +\subsubsection*{Create a xLink}
1.1260 +Choose the link mode from the modifier toolbar (by clicking the toolbar icon or pressing
1.1261 +\key{L}). Select the branch, where the xLink should start. Press the
1.1262 +modifier key \key{Ctrl} and then click on the selected branch where the
1.1263 +link should start and drag the mouse pointer to the branch where the link is to end. (The link is drawn to follow the mouse pointer). When you release the mouse over a branch the xLink becomes permanent.
1.1264 +
1.1265 +\subsubsection*{Modify or delete a xLink}
1.1266 +First select a branch at either end of the xLink. Then open the context
1.1267 +menu and select \lq Edit xLink\rq. A submenu contains all the xLinks of
1.1268 +the branch (if there are any). They are named like the branches, where
1.1269 +they end. Choose one and the xLink dialogue opens, where you can set
1.1270 +colour, width and also delete the xLink.
1.1271 +
1.1272 +\subsubsection*{Follow a xLink}
1.1273 +In a complex \vym map it sometimes comes in handy to be able to jump to the other end
1.1274 +of a xLink. You can do this by opening the context menu of the branch
1.1275 +and clicking on \lq Goto xLink\rq and selecting the xLink you want to
1.1276 +follow.
1.1277 +
1.1278 +
1.1279 +
1.1280 +\subsection{Adding and removing branches}
1.1281 +The context menu of a branch shows some more ways to add and delete data
1.1282 +e.g. you can delete a branch while keeping its children. The children become
1.1283 +linked to the parent of the previously removed branch.
1.1284 +Similar branches can be inserted into existing maps. For keyboard
1.1285 +shortcuts also have a look at the context menu.
1.1286 +
1.1287 +\subsection{Adding a whole map or a part of a map}
1.1288 +Select a branch where you want to add a previously saved map ({\tt
1.1289 +.vym})or a part of a map ({\tt .vyp}) , then open the context menu and
1.1290 +choose {\em Add \ra Add Map (Insert)}. For the import you can choose
1.1291 +between {\em Add Map (Insert)} and {\em Add Map (Replace)}: The imported
1.1292 +data will be added after the selected branch.
1.1293 +
1.1294 +
1.1295 +\section{\vym on Mac OS X}
1.1296 +\subsection{Overview}
1.1297 +Basically there are two ways to run \vym on Macs:
1.1298 +\subsubsection*{Qt Mac Edition:}
1.1299 + \vym here provides the well known Mac look and feel. \vym is
1.1300 + available as Mac OS X application package in contained in a disk
1.1301 + image ({\tt vym.dmg}. It has been compiled and tested in
1.1302 + Mac~OS~10.4. This package includes runtime libraries of Qt by
1.1303 + Trolltech.
1.1304 +
1.1305 +\subsubsection*{X11 version} \vym can also be run using the Linux
1.1306 +version, but then menus and handling will also be those of the Linux
1.1307 +version e.g. The menu bar will look different.
1.1308 +
1.1309 +\subsection {Contextmenu and special keys}
1.1310 +Most Macs unfortunatly just have a single mouse button. In order to show
1.1311 +the context menu which usually would be opened with the right mouse
1.1312 +button, you can click while pressing the \key{kommand}-key.
1.1313 +
1.1314 +Especially on Laptops some of the keys usually used on PC keyboards seem
1.1315 +to be missing. The QT-Mac Edition of \vym has its own keyboard
1.1316 +shortcuts. To find the shortcuts just have a look at all the menu
1.1317 +entries, the shortcut is visible next to an entry. Toolbar buttons also
1.1318 +may have shortcuts, just position the mouse pointer over a button and
1.1319 +wait for the little help window to appear.
1.1320 +
1.1321 +\subsection {Viewing external links}
1.1322 +\vym on Mac uses the system call {\tt /usr/bin/open} to view links.
1.1323 +Mac~OS determines automatically if the link is a pdf or www page and
1.1324 +opens the right browser.
1.1325 +
1.1326 +
1.1327 +\newpage
1.1328 +
1.1329 +\begin{appendix}
1.1330 +
1.1331 +\section{\vym initialisation process and configuration}
1.1332 +\subsection {Settings menu}
1.1333 + The {\em Settings} menu allows to configure \vym to your needs:
1.1334 +
1.1335 +\subsubsection*{Set application to open PDF files} Choose a PDF
1.1336 + viewer like {\tt acrobat} or {\tt konqueror} which is installed on
1.1337 + your system.
1.1338 +
1.1339 +\subsubsection*{Set application to open external links}
1.1340 + Choose your favourite webbrowser here.
1.1341 +
1.1342 +\subsubsection*{Set path for macros}
1.1343 + Set the default search path for macros, which will be executed when
1.1344 + you press one of the function keys. Each key corresponds to a file
1.1345 + ({\tt macro-1.vys..macro12.vys}) in the search path.
1.1346 +
1.1347 +\subsubsection*{Set number of undo levels}
1.1348 + Sets the number of undo/redo levels. The default setting is
1.1349 + 75~levels.
1.1350 +
1.1351 +\subsubsection*{Autosave and autosave time}
1.1352 + Automatic saving of modified maps can be toggled on or off. The
1.1353 + autosave time is entered in seconds.
1.1354 +
1.1355 +\subsubsection*{Write backup on save}
1.1356 + When saving a map called {\tt example.vym}, \vym will rename the
1.1357 + existing file to {\tt example.vym\~{}} before writing the {\tt
1.1358 + example.vym} itself.
1.1359 +
1.1360 +\subsubsection*{Edit branch after adding it}
1.1361 + If set, the heading of a new branch will be edited immediatly after
1.1362 + adding the branch.
1.1363 +
1.1364 +\subsubsection*{Select branch after adding it}
1.1365 + If set, a new branch will be selected immediatly after adding it.
1.1366 + When you "brainstorm" on a given keyword, you don't want to go
1.1367 + deeper and deeper into details, but keep the focus on the keyword.
1.1368 + So the default setting here is to {\em not} select the freshly added
1.1369 + branch.
1.1370 +
1.1371 +\subsubsection*{Select existing heading}
1.1372 + If set and you begin to edit the heading of a branch, the heading text in
1.1373 + the dialog will be selected. Usefully to copy\&paste to other
1.1374 + applications.
1.1375 +
1.1376 +\subsubsection*{Delete key}
1.1377 + If set, the \key{Delete} is enabled to, well, delete objects. This
1.1378 + can be switched off to avoid confusing with the nearby
1.1379 + \key{Insert}-key on PC keyboards.
1.1380 +
1.1381 +\subsubsection*{Exclusive flags}
1.1382 + If set, some of the standard flags can only be used exclusively,
1.1383 + e.g.~the smileys.
1.1384 +
1.1385 +\subsubsection*{Use hide flags}
1.1386 + If set, every branch which also has the hide flag set (see
1.1387 + \ref{hideexport}) will be hidden in exports.
1.1388 +
1.1389 +\subsection{Configuration file}
1.1390 +On startup \vym will look for a configuration for user specific settings
1.1391 +like window positions, toolbars etc. If this file does not already
1.1392 +exist, it will be created. The file is located in the users home
1.1393 +directory. The exact position depends on the platform:
1.1394 +\begin{center}
1.1395 +\begin{tabular}{cl}
1.1396 + {\bf Platform} & {\bf Configuration file} \\ \hline
1.1397 + Linux & {\tt $\sim$/.config/InSilmaril/vym.conf } \\
1.1398 + Mac OS X & {\tt /Users/NAME/Library/Preferences/com.insilmaril.vym.plist } \\
1.1399 +\end{tabular}
1.1400 +\end{center}
1.1401 +The file can be edited manually, or on Mac~OS~X with Property List
1.1402 +Editor (installed with xtools).
1.1403 +
1.1404 +\subsection{Path to ressources}
1.1405 +\vym will try to find its ressources (images, stylesheets, filters,
1.1406 +etc.) in the following places:
1.1407 +\begin{enumerate}
1.1408 + \item Path given by the environment variable {\tt VYMHOME}.
1.1409 + \item If called with the local option (see \ref{options} below),
1.1410 + \vym will look for its data in the current directory.
1.1411 + \item {\tt /usr/share/vym}
1.1412 + \item {\tt /usr/local/share/vym}
1.1413 +\end{enumerate}
1.1414 +
1.1415 +\subsection{Command line options} \label{options}
1.1416 +\vym has the following options:
1.1417 +\begin{center}
1.1418 +\begin{tabular}{cccp{8cm}}\\
1.1419 +\bf Option & \bf Comment & \bf Argument & \bf Description \\ \hline
1.1420 +v & version & & Show version and codename of \vym\\
1.1421 +l & local & & Use local paths to stylesheets, translations, icons,
1.1422 + etc. instead of system paths. Useful for testing\\
1.1423 +h & help & & Show help\\
1.1424 +r & run & filename & Load and run script\\
1.1425 +q & quit & & Quit immediatly after startup. Useful for benchmarks.\\
1.1426 +\end{tabular}
1.1427 +\end{center}
1.1428 +You can also give several filenames at the commandline to let \vym open
1.1429 +several maps at once.
1.1430 +
1.1431 +
1.1432 +\section{Scripts} \label{scripts} %FIXME
1.1433 +
1.1434 +TODO: This section of the \vym manual is not complete yet, sorry.
1.1435 +
1.1436 +\subsection{Example scripts}
1.1437 +\subsubsection{Export a set of maps}
1.1438 +\begin{code}
1.1439 +\# Simple vym script to export images of various maps simultanously
1.1440 +exportImage ();
1.1441 +\end{code}
1.1442 +The script above can be used to export all maps in a directory
1.1443 +automatically. If the script is named {\tt export-image.vys}, call \vym with
1.1444 +\begin{code}
1.1445 +\$ vym --quit --run export-image.vys *.vym
1.1446 +\end{code}
1.1447 +
1.1448 +
1.1449 +\section{Contributing to \vym}
1.1450 +So far I'd say I have written 98\% of the code on my own. No surprise,
1.1451 +that \vym exactly fits my own needs. Nevertheless I would like to
1.1452 +encourage all users of \vym to contribute. Maybe not only with feature
1.1453 +requests, but also with code, new import/export filters, translations
1.1454 +etc. In this appendix I'll try to show how easy it is to expand the
1.1455 +things you can do already with \vym. I really look forward to hear from
1.1456 +you!
1.1457 +
1.1458 +\subsection{Getting help}
1.1459 +
1.1460 +\subsubsection*{Frequently asked questions}
1.1461 +Please refer to the FAQ available on the \vym website:
1.1462 +\begin{center}
1.1463 +\href{http://www.InSilmaril.de/vym/faq.html}{http://www.InSilmaril.de/vym/faq.html}
1.1464 +\end{center}
1.1465 +
1.1466 +\subsubsection*{Mailinglists}
1.1467 +There are two mailinglists: {\tt vym-forum} is the \vym users forum to
1.1468 +discuss various questions, while {\tt vym-devel} is intended for people
1.1469 +interested in contributing to \vym. You can view the archives and
1.1470 +subscribe at
1.1471 +\begin{center}
1.1472 +\href{https://sourceforge.net/mail/?group_id=127802}{https://sourceforge.net/mail/?group\_id=127802}
1.1473 +\end{center}
1.1474 +
1.1475 +\subsubsection*{Contacting the author}\label{author}
1.1476 +Especially for support questions please try the mailinglists first. If
1.1477 +everything else fails you can contact the author Uwe Drechsel at
1.1478 +\begin{center}
1.1479 +\href{mailto:vym@InSilmaril.de}{vym@InSilmaril.de}
1.1480 +\end{center}
1.1481 +
1.1482 +
1.1483 +
1.1484 +\subsection{How to report bugs}
1.1485 +Though Sourceforge has its own bugreporting system, I'd rather prefer if
1.1486 +you contact me directly (see \ref{author}) or even better: You can file
1.1487 +a bugreport in Bugzilla, the bugtracking system of openSUSE:
1.1488 +\begin{center}
1.1489 +\href{http://en.opensuse.org/Submit_a_bug}{http://en.opensuse.org/Submit\_a\_bug}
1.1490 +\end{center}
1.1491 +I build \vym regulary for openSUSE, so you may report it against a
1.1492 +recent version there, even if you use another Operating System.
1.1493 +Please don't forget to tell me what you are using:
1.1494 +\begin{itemize}
1.1495 + \item the exact steps needed to reproduce the bug
1.1496 + \item the version and build date of \vym (see the Help \ra About
1.1497 + \vym)
1.1498 + \item hardware and Operating System
1.1499 +\end{itemize}
1.1500 +
1.1501 +\subsection{Compiling from the sources}
1.1502 +\subsubsection{Getting the sources} \label{getsources}
1.1503 +You find the latest version of \vym at the project site:
1.1504 +\begin{center}
1.1505 +\href{https://sourceforge.net/projects/vym/}{https://sourceforge.net/projects/vym/}
1.1506 +\end{center}
1.1507 +There you can check them out of the source repository (CVS):\\
1.1508 +
1.1509 \begin{verbatim}
1.1510 - unzip vymfile.vym
1.1511 -\end{verbatim}
1.1512 -A directory named {\tt vymfile} will be created containing further
1.1513 -directories both for {\tt images} and {\tt flags}. In the {\tt vymfile}
1.1514 -directory you will find the map itself, usually named {\tt vymfile.xml}.
1.1515 -
1.1516 -This file can be loaded directly into \vym, it does not have to be
1.1517 -compressed. If you want to compress all the data yourself, use
1.1518 -\begin{verbatim}
1.1519 - cd vymfile
1.1520 - zip -r vymfile.vym .
1.1521 +cvs -d:pserver:anonymous@cvs.sf.net:/cvsroot/vym checkout code
1.1522 \end{verbatim}
1.1523
1.1524 +\subsubsection{The Qt toolkit}
1.1525 +Qt is C++ toolkit for multiplatform GUI and application development. It
1.1526 +provides single-source portability across MS~Windows, Mac~OS~X, Linux
1.1527 +and all major commercial Unix variants. Qt is also available for
1.1528 +embedded devices. Qt is a Trolltech product. For more information see
1.1529 +\begin{center}
1.1530 +\href{http://www.trolltech.com/qt/}{www.trolltech.com/qt}
1.1531 +\end{center}
1.1532 +
1.1533 +
1.1534 +\subsubsection{Compiling \vym }
1.1535 +Make sure you have installed your Qt environment properly, see the Qt
1.1536 +documentation for details. You need to have the Qt command {\tt qmake}
1.1537 +in your {\tt PATH}-environment, then run
1.1538 +\begin{code}
1.1539 +\$ qmake
1.1540 +$ make
1.1541 +$ make install
1.1542 +\end{code}
1.1543 +The last command {\tt make install} needs root-permissions. Of course it
1.1544 +may be omitted, if you just want to test \vym.
1.1545 +
1.1546 +%\subsubsection*{Compiling \vym on Macs}
1.1547 +%FIXME
1.1548 +
1.1549 +\subsection{\vym file format} \label{fileformat}
1.1550 +\vym maps usually have the suffix "{\tt .vym}" and represent a
1.1551 +compressed archive of data. If you want to have a
1.1552 +closer look into the data structure map called "mapname.vym",
1.1553 +just uncompress the map manually using
1.1554 +\begin{code}
1.1555 +\$ unzip mapname.vym
1.1556 +\end{code}
1.1557 +This will create directories named {\tt images} and {\tt flags} in your
1.1558 +current directory and also the map itself, usually named {\tt
1.1559 +mapname.xml}.
1.1560 +The XML structure of \vym is pretty self explaining, just have a look at
1.1561 +{\tt mapname.xml}.
1.1562 +
1.1563 +This XML file can be loaded directly into \vym, it does not have to be
1.1564 +compressed. If you want to compress all the data yourself, use
1.1565 +\begin{code}
1.1566 +\$ zip -r mapname.vym .
1.1567 +\end{code}
1.1568 +to compress all data in your current directory.
1.1569 +
1.1570 +\subsection{New features}
1.1571 +There are lots of features which might find their way into \vym.
1.1572 +Together with \vym you should have received a directory with several
1.1573 +example maps. You find them by clicking Help \ra Open~vym~example~maps.
1.1574 +There you will find the map {\tt vym-projectplan.vym}. It lists quite a
1.1575 +lot of things to be done in future. If you have more ideas, contact the
1.1576 +development team at {\tt vym-devel@lists.sourceforge.net}.
1.1577 +
1.1578 +
1.1579 +\subsection{New languages support}
1.1580 +In order to add a new language to \vym you need
1.1581 +the sources (see \ref{getsources}) and
1.1582 +an installation of Trolltechs QT. A part of QT are the development
1.1583 +tools, from those tools especially the translation tool "Linguist" is
1.1584 +needed.
1.1585 +
1.1586 +In some Linux distributions the development tools are in an extra package, e.g. on SUSE LINUX you should have installed:
1.1587 +\begin{code}
1.1588 +libqt4-devel.rpm
1.1589 +libqt4-devel-doc.rpm
1.1590 +libqt4-devel-tools.rpm
1.1591 +\end{code}
1.1592 +If you don't have QT in your system, you can get it from
1.1593 + \href{http://www.trolltech.com}{http://www.trolltech.com} Once you
1.1594 + are able to compile vym yourself, you can translate the text in vym
1.1595 + itself by performing the following steps:
1.1596 +\begin{itemize}
1.1597 + \item Let's assume now your encoding is "NEW" instead of for example
1.1598 + "de" for german or "en" for english
1.1599 +
1.1600 + \item Copy the file {\tt lang/vym\_en.ts} to l{\tt ang/vym\_NEW.ts} (The code
1.1601 + itself contains the english version.)
1.1602 +
1.1603 + \item Add {\tt lang/vym\_NEW.ts} to the TRANSLATIONS section of vym.pro
1.1604 +
1.1605 + \item Run Linguist on {\tt vym\_NEW.ts} and do the translation
1.1606 +
1.1607 + \item Run {\tt lrelease} to create {\tt vym\_NEW.qm}
1.1608 +
1.1609 + \item Do a make install to install the new vym and check your translation
1.1610 +\end{itemize}
1.1611 +
1.1612 +If you feel brave, you can also translate the manual. It is written in
1.1613 +LaTeX, you just have to change the file tex/vym.tex. (Linguist and QT
1.1614 +are not needed, but it is useful to know how to work with LaTeX and esp.
1.1615 +pdflatex to create the PDF.)
1.1616 +
1.1617 +Please mail me every translation you have done. I can also give you a
1.1618 +developer access to the project, if you want to provide translations
1.1619 +regulary.
1.1620 +
1.1621 +\subsection{New export/import filters}
1.1622 +\vym supports various kinds of filters. Data can be written directly,
1.1623 +inserted into templates or it can be written as XML data and then
1.1624 +processed by XSL transformations.
1.1625 +
1.1626 +Most of the import/export functionality is available in the classes
1.1627 +ImportBase and ExportBase and subclasses. All of them can be found in
1.1628 +{\tt imports.h} and {\tt exports.h}.
1.1629 +
1.1630 +\subsubsection*{Direct import/export}
1.1631 +An example for a direct export is the XML export. This method touches
1.1632 +the implementation of nearly every object of \vym, so whenever possible
1.1633 +you should better use a XSL transformation instead.
1.1634 +
1.1635 +If you still want to know how it is done, start looking at
1.1636 +{\tt MapEditor::saveToDir} in {\tt mapeditor.cpp}.
1.1637 +
1.1638 +\subsubsection*{Templates}
1.1639 +Templates have been introduced to export to opendoc format used e.g. by
1.1640 +Open~Office. While I read the spec ($>$ 500 pages) about the format\footnote{
1.1641 +\href{http://www.oasis-open.org/}{http://www.oasis-open.org/}}\
1.1642 +I had the feeling that I did not want to write the export from scratch.
1.1643 +It would be too complex to adapt the styles to your own wishes, e.g. the
1.1644 +layout.
1.1645 +
1.1646 +Instead I analyzed existing Open~Office documents. I found out that
1.1647 +there are lots of redundant bits of information in a standard
1.1648 +presentation, for example each list item is contained in its own list.
1.1649 +In the end I came up with the default presentation style, which still
1.1650 +could be simplified, just in case you have free time\ldots
1.1651 +
1.1652 +The existing templates are still work in progress, before you spend too
1.1653 +much time developing your own style, please contact me. Basically the
1.1654 +following steps are needed to build your own style:
1.1655 +\begin{enumerate}
1.1656 + \item Create an example in Open Office. Use a title, authors name,
1.1657 + page heading etc.\ which you can easily grep for in the output file.
1.1658 +
1.1659 + \item Unzip the Open Office document into a directory.
1.1660 +
1.1661 + \item The main file is called {\tt content.xml}. All data is in one
1.1662 + single line. You can split the XML tags using the script {\tt
1.1663 + scripts/niceXML}, which is part of the \vym distribution.
1.1664 +
1.1665 + \item Copy the output of {\tt niceXML} to {\tt
1.1666 + content-template.xml}.
1.1667 +
1.1668 + \item Looking closer you will find lots of unused definitions, for
1.1669 + example of styles. You can delete or simply ignore them.
1.1670 +
1.1671 + \item Try to find your title, authors name. \vym will replace the
1.1672 + following strings while exporting:
1.1673 + \begin{center}
1.1674 + \begin{tabular}{lp{4cm}}
1.1675 + {\tt <!-- INSERT TITLE -->} & title of map \\
1.1676 + {\tt <!-- INSERT AUTHOR--> } & author \\
1.1677 + {\tt <!-- INSERT COMMENT -->} & comment \\
1.1678 + {\tt <!-- INSERT PAGES-->} & content of map \\
1.1679 + \end{tabular}
1.1680 + \end{center}
1.1681 + The content itself is generated in a similar way by inserting lists
1.1682 + into {\tt page-template}. Here the following substitutions are made:
1.1683 + \begin{center}
1.1684 + \begin{tabular}{lp{7cm}}
1.1685 + {\tt <!-- INSERT PAGE HEADING-->} & heading of a page
1.1686 + (mainbranch or child of mainbranch, depending on the use of
1.1687 + sections) \\
1.1688 + {\tt <!-- INSERT LIST --> } & all children of the branch above \\
1.1689 + \end{tabular}
1.1690 + \end{center}
1.1691 +\end{enumerate}
1.1692 +Currently images are exported and notes just will appear as text
1.1693 +without formatting and colours.
1.1694 +
1.1695 +
1.1696 +
1.1697 +
1.1698 +\subsubsection*{XSL Transformation}
1.1699 +\vym uses XSL transformations while exporting (e.g. XHTML) and importing
1.1700 +data (e.g. KDE bookmarks). There is a little code needed to provide the
1.1701 +GUI, the rest is done using the {\tt .xsl} stylesheet and calling the
1.1702 +{\tt xsltproc} processor, which is part of libxslt, the XSLT
1.1703 +C library for GNOME.
1.1704 +
1.1705 +\end{appendix}
1.1706 +\end{document}
1.1707
1.1708 %TODO
1.1709 %\subsubsection{Menus}
1.1710 %\subsubsection{Keyboard shortcuts}
1.1711 %Where does vym save its settings? -> ~/.qt/vymrc
1.1712
1.1713 -\section{History of \vym}
1.1714 -\subsection{Future}
1.1715 -There are lots of features which might find their way into \vym.
1.1716 -Together with \vym you should have received a directory with example
1.1717 -maps e.g. on SUSE~LINUX this is
1.1718 -\begin{center}
1.1719 - {\tt /usr/share/doc/packages/vym/demos}
1.1720 -\end{center}
1.1721 -where you find the map {\tt todo.vym}. It lists quite a lot of things to
1.1722 -be done in future. If you have more ideas, contact the author at
1.1723 -{\tt vym@insilmaril.de}.
1.1724 -
1.1725 -\subsection{Past}
1.1726 -\begin{center}
1.1727 -\begin{longtable}{|lcp{8cm}l|} \hline
1.1728 -Version & & Comment & Date \\ \hline \hline \endhead
1.1729 - \hline \endfoot
1.1730 -1.6.0 & - & Added saving of xhtml settings in map& 2004-12-14 \\
1.1731 -1.5.2 & - & Added Import of maps with two modes:
1.1732 - add/replace & 2004-12-13 \\
1.1733 - & - & Added export of part of maps & \\
1.1734 - & - & Added joining of paragraphs in text editor & \\
1.1735 - & - & Optimized undo: Only relevant parts are saved, which
1.1736 - dramatically improves e.g. moving branches up/down
1.1737 - in most maps & \\
1.1738 - & - & Bugfix: QTextEdit generates invalid XML code, which
1.1739 - could lead to a parse error, if font name contains a \& & \\
1.1740 - & - & Bugfix: Wrong order of mainbranches in Export & \\
1.1741 - & - & Bugfix: zip archive was not deleted before save, which
1.1742 - could lead to much bigger files, e.g.
1.1743 - when working on older \vym maps or deleted images& \\
1.1744 - & - & Bugfix: Printing in Texteditor & \\
1.1745 - & - & Bugfix: Wrong URLs in xhtml output & \\
1.1746 - & - & Bugfix: Segfault fixed at Cursor left/right in empty map& \\
1.1747 -1.5.1 & - & More options in xhtml export: external scripts & 2004-10-01 \\
1.1748 -1.5.0 & - & Public release of all changes since 1.4.1 & 2004-09-26 \\
1.1749 - & - & New function to replace paragraphs in note editor
1.1750 - by linebreaks, this makes pasted text much nicer& \\
1.1751 - & - & New option to toggle exporting of of floatimages& \\
1.1752 - & - & z-plane of floatimages can be set (manually only)& \\
1.1753 - & - & Bugfix: Wrong ordering of branches, if mainbranch is
1.1754 - exactly left of center& \\
1.1755 -1.4.7 & - & New Export to HTML by Thomas Schraitle. & 2004-09.24 \\
1.1756 - & - & Bugfix: vymLink& \\
1.1757 - & - & Bugfix: spaces and dots in filenames & \\
1.1758 - & - & Bugfix: Error message if xsltproc is not installed& \\
1.1759 -1.4.6 & - & New file format: notes are saved as part of the .xml file
1.1760 - & 2004-09-15 \\
1.1761 - & - & Note Editor supports Rich Text now.&\\
1.1762 - & - & Parser now also nows {\tt standardflag} (all letters
1.1763 - lowercase)&\\
1.1764 -1.4.5 & - & Correct handling of font size in Heading & 2004-08-23 \\
1.1765 -1.4.4 & - & Selecting with cursor now works between subtrees & 2004-07-29 \\
1.1766 - & - & Bugfix: vymLink was set to temporary dir in 1.4.3 & \\
1.1767 - & - & Bugfix: & \\
1.1768 -1.4.3 & - & Optimisation: Reduced canvas objects by only
1.1769 - creating objects for used flags & 2004-07-19 \\
1.1770 - & - & Better visualization of moving branch above/below target&\\
1.1771 - & - & Find Window informs with dialog, if the search failed&\\
1.1772 - & - & System Flags are clickable now &\\
1.1773 - & - & Reworked CSS and XST stylsheets (comments, indent, browser
1.1774 - compatibility) &\\
1.1775 - & - & vymLinks are shown in statusbar &\\
1.1776 - & - & current directory is save &\\
1.1777 - & - & Rewritten load/save to improve multimap handling and
1.1778 - unzipped files&\\
1.1779 - & - & Bugfix: vymLinks don't get deleted
1.1780 - when Cancel is pressed &\\
1.1781 - & - & Bugfix: Fixed a bunch of bugs in XSL for HTML export& \\
1.1782 - & - & Bugfix: More toolbar buttons disabled, if action not
1.1783 - possible& \\
1.1784 - & - & Bugfix: Renaming .vymfile now works&\\
1.1785 - & - & Bugfix: mapChanged set when toggling flags&\\
1.1786 - & - & Bugfix: CTRL-N was used twice &\\
1.1787 - & - & Bugfix: Del didn't work on floatimage &\\
1.1788 -1.4.2 & - & Bugfix: Float image could not be deleted& \\
1.1789 -1.4.1 & - & Bugfix: Color of branch not saved & 2004-05-25 \\
1.1790 - & - & Bugfix: wrong path at HTML export & \\
1.1791 - & - & Bugfix: map is not save with special characters in path& \\
1.1792 -1.4.0 & - & Ask for confirmation before opening
1.1793 - a map in multiple editors & 2004-05-17 \\
1.1794 - & - & Save state of note editor (visible/minimized)& \\
1.1795 - & - & Export to HTML & \\
1.1796 - & - & Author and Comment is saved in map & \\
1.1797 - & - & Stats are shown in Edit MapInfo & \\
1.1798 - & - & Changes for OS X port (QCursor, QContextMenuEvent) & \\
1.1799 - & - & Bugfix: Fonts from note editor are save now &\\
1.1800 - & - & Bugfix: invisible image when parent is scrolled &\\
1.1801 - & - & Bugfix: Segfault pressing "enter" for floatimage &\\
1.1802 - & - & Bugfix: Images can't be outside of exported area
1.1803 - anymore.& \\
1.1804 - & - & Bugfix: Filenames with blanks & \\
1.1805 - & - & Bugfix: Old maplink is shown when editing maplink& \\
1.1806 - & - & Bugfix: always show cursor while editing heading & \\
1.1807 -1.3.5 & - & Export map to dir & 2004-04-16 \\
1.1808 - & - & Export to any of QTs image formats & \\
1.1809 - & - & Also right side of selection is always visible now.& \\
1.1810 -1.3.4 & - & Load last maps in file menu & 2004-04-07 \\
1.1811 - & - & save last image path for loading & \\
1.1812 - & - & Also export standard flags to dir. & \\
1.1813 -1.3.3 & - & Enabled <br> in headings as manual linebreak & 2004-03-26 \\
1.1814 - & - & Heading can be copied to URL &\\
1.1815 - & - & Bugfix: GIFs are automatically converted to PNG now&\\
1.1816 -1.3.2 & - & Add and move branches above/below selection, Texteditor copy all,& 2004-03-26 \\
1.1817 -1.3.1 & - & Export to directory, changed naming in .vym& 2004-03-25 \\
1.1818 -1.3.0 & - & Bugfix: Check if map can be saved at all& 2004-03-23 \\
1.1819 -1.2.12 & - & Select image format before saving image & 2004-03-22 \\
1.1820 -1.2.11 & - & Selecting mainbranches by up/down & 2004-03-18 \\
1.1821 - & - & Export ASCII (experimental) & \\
1.1822 - & - & Each map can be saved individually at quit & \\
1.1823 - & - & Bugfix: Opening VymLink crashes QT & \\
1.1824 - & - & Bugfix: 50\% less objects on canvas & \\
1.1825 - & - & Bugfix: Ignoring LANG, now always written as UTF8&\\
1.1826 -1.2.10 & - & Sort Mainbranches by angle to y-axis& 2004-03-16 \\
1.1827 - & - & Import directory structure & \\
1.1828 - & - & Fix: Set FrameType of MapCenter while loading map &\\
1.1829 -1.2.9 & - & Jump to another vym map & 2004-03-12 \\
1.1830 - & - & Mainbranches are alwas ordered clockwise & \\
1.1831 -1.2.8 & - & Change frame types in context menu & 2004-03-03 \\
1.1832 -1.2.7 & - & Copy / Paste and save Floatimages & 2004-02-25 \\
1.1833 -1.2.6 & - & Closing vym in KDE now asks for save, too & 2004-02-24 \\
1.1834 - & - & Context menu for branches & \\
1.1835 - & - & Selection is saved in .vym file & \\
1.1836 -1.2.5 & - & URLs to external links can be added & 2004-02-18 \\
1.1837 - & - & All actions are deactived if not possible & \\
1.1838 -1.2.4 & - & Images: Can be loaded, saved, relinked to other parents
1.1839 -& 2004-02-16 \\
1.1840 -1.2.3 & - & Zoom: Reset and finer steps shrinking/enlarging & 2004-01-27 \\
1.1841 -1.2.2 & - & Editing of links (style and color) & 2004-01-27 \\
1.1842 -1.2.1 & - & Bugfix: LineEdit when adding branch has correct position
1.1843 - again. & 2004-01-27 \\
1.1844 -1.2.0 & - & Scrolled parts are automatically unscrolled when
1.1845 - selected and scrolled again later. & 2004-01-23 \\
1.1846 - & - & Bugfix: Save flag is updated when multiple maps are opened& \\
1.1847 - & - & Bugfix: Moving of branches is faster and more accurat
1.1848 - when adding to mapcenter& \\
1.1849 -1.1.7 & - & Bugfix: Remember filename of note in noteeditor & 2003-12-04 \\
1.1850 -1.1.6 & - & Find Text also in Notes. & 2003-12-02 \\
1.1851 -1.1.5 & - & Bugfix: Correct setting and positioning when relinking branches & 2003-11-07 \\
1.1852 -1.1.4 & - & Scroll mode added (folding of subtrees). & 2003-11-03 \\
1.1853 - & - & Bugfix: Wrong position of linedit in zoomed view& \\
1.1854 -1.1.3 & - & Added clear button in find window, bugfixes & 2003-10-09 \\
1.1855 -1.1.2 & - & Links can be colored with color of heading & 2003-10-07 \\
1.1856 -1.1.1 & - & Improved visualization of linking to new branch& 2003-09-26 \\
1.1857 -1.1.0 & - & Find Function & 2003-09-25 \\
1.1858 - & - & Selection always stays in view & \\ \hline
1.1859 -1.0.1 & - & Find function scrolls to result now & 2003-09-18\\
1.1860 - & - & Bugfix: Adding branch with midmouse & \\
1.1861 - & - & Bugfix: multiple repositioning of map,
1.1862 - when noteeditor was changed (speedup) & \\
1.1863 - & - & New Linestyles (still hardcoded) & \\ \hline
1.1864 -1.0.0 & - & First public stable release & 2003-09-16 \\ \hline
1.1865 -0.9.0 & - & added quick color picker (CTRL + Left Mouse) & ? \\ \hline
1.1866 -0.8.0 & - & added automatic canvas resizer, removed manual resizing of
1.1867 - canvas & \\
1.1868 -
1.1869 - & - & added settings option to paste text into new branch & \\
1.1870 - & - & simplified code & \\
1.1871 - & - & Added heart flag & \\
1.1872 - & - & Choose and switch between fixed and variable width fonts& \\
1.1873 - & - & note editor & \\
1.1874 - & - & Fixed segfault caused by undo and a call of updateNoteFlag of
1.1875 - note editor & \\
1.1876 - & - & Added settings menu to configure autoselect \& autoedit mode & \\
1.1877 - & - & autoedit \& autoselect mode & \\
1.1878 - & - & Fixed ugly display problem with QT Palette (Klaas Freitag)& \\
1.1879 - & - & Reduced temporary directories from 4 to 1 & \\
1.1880 - & - & Added wordwrap in printing of notes & \\
1.1881 - & - & New toolbar buttons in texteditor & \\
1.1882 - & - & Set background color & \\
1.1883 - & - & Fixed bug: Flags in toolbar not updated when selecting map center & \\ \hline
1.1884 -0.7.0 & - & No more segfault, when an object is deleted while being edited & \\
1.1885 - & - & Keep focus constant when zooming in/out & \\
1.1886 - & - & Export as png graphic & \\
1.1887 - & - & Keep Center of map where it is while zooming & \\
1.1888 - & - & Added Standard Flags (Smiley, Hook, Stopsign, ...) & \\
1.1889 - & - & MDI: Multi Document Interface enables working on several
1.1890 - maps simultanously & \\
1.1891 - & - & Enabled creating a new map via argument on commandline & \\
1.1892 - & - & Changed file extension from .mmap to .vym & \\
1.1893 - & - & noteeditor changes color, if empty or nothing is selected & \\
1.1894 - & - & Changes in NoteEditor window are recognized by main window,
1.1895 - too, thus preventing loosing data when quitting the program. & \\ \hline
1.1896 -0.6.0 & - & New rendering engine: Faster, no flickering & \\ \hline
1.1897 -0.5.0 & - & Changed printing to use maximum space on paper& \\
1.1898 - & - & Note editor is hidden, too, when mapeditor is minimized& \\
1.1899 - & - & New (compressed) file format& \\ \hline
1.1900 -0.4.0 & - & Size of map is saved& \\
1.1901 - & - & Multi Line Headings & \\
1.1902 - & - & Reworked Rendering Engine: Much faster now.& \\
1.1903 - & - & Reworked Undo: Much faster now.& \\
1.1904 - & - & Enabled moving of map center& \\
1.1905 - & - & Multi-line headings & \\ \hline
1.1906 -0.3.0 & - & Introduced Undo& \\
1.1907 - & - & Fixed some bugs & \\ \hline
1.1908 -0.2.0 & - & Moving view of map improved:& \\
1.1909 - & - & New handling (acrobat reader style)& \\
1.1910 - & - & New mousepointer& \\
1.1911 - & - & Several tools to color a map& \\ \hline
1.1912 -0.1.0 & - & Inital version, basic map layout & \\
1.1913 - & - & Data is stored in XML& \\
1.1914 -\end{longtable}
1.1915 -\end{center}
1.1916 -
1.1917
1.1918 % INDEX
1.1919 % mapeditor
1.1920 @@ -921,7 +1475,12 @@
1.1921 % reorder
1.1922 % scroll
1.1923 % fold
1.1924 +% vymlink
1.1925 +% xlink
1.1926 +% modMode
1.1927 +% context menu
1.1928 +% Mac OS X
1.1929
1.1930
1.1931
1.1932 -\end{document}
1.1933 \ No newline at end of file
1.1934 +\end{document}