# HG changeset patch
# User insilmaril
# Date 1182179419 0
# Node ID 218b0e2c8bfd718831d1fdfe51f5a73359e17766
# Parent ed8f21a839d74be8d27722709be2506f0527ce5c
1.8.73 - beta testing
diff -r ed8f21a839d7 -r 218b0e2c8bfd tex/vym.tex
--- a/tex/vym.tex Mon Jun 18 15:10:19 2007 +0000
+++ b/tex/vym.tex Mon Jun 18 15:10:19 2007 +0000
@@ -1,11 +1,44 @@
-\documentclass{article}
-\usepackage{a4}
-\usepackage[latin1]{inputenc}
+\documentclass[12pt,a4paper]{article}
+\usepackage[utf8]{inputenc}
\usepackage{verbatim}
\usepackage{hyperref}
\usepackage{graphicx}
%\usepackage{longtable}
+\setlength{\headheight}{0cm}
+\setlength{\headsep}{0cm}
+\setlength{\topskip}{0cm}
+\setlength{\topmargin}{-0.5cm}
+
+\setlength{\parskip}{1.5ex}
+\setlength{\parindent}{0cm}
+\setlength{\oddsidemargin}{0cm}
+\setlength{\textwidth}{16cm}
+\setlength{\textheight}{27cm}
+
+\newlength{\maximgwidth}
+\setlength{\maximgwidth}{14cm}
+\newcommand{\maximage}[1]{
+ \begin{center}
+ \includegraphics[width=\maximgwidth]{#1}
+ \end{center}
+}
+\newcommand{\hint}[1]{
+ \begin{center}
+ \begin{tabular}{|rp{12cm}|} \hline
+
+ {\bf Hint}:& #1\\ \hline
+ \end{tabular}
+ \end{center}
+}
+
+\newcommand{\vym}{{\sc vym }}
+\newcommand{\ra}{$\longrightarrow$}
+\newcommand{\la}{$\longleftarrow$}
+\newcommand{\ua}{$\uparrow$}
+\newcommand{\da}{$\downarrow$}
+\newcommand{\key}[1]{[#1]}
+
\hypersetup{bookmarks, bookmarksopen,
pdftitle={VYM - a tool for visual thinking },
pdfauthor={Uwe Drechsel},
@@ -19,13 +52,6 @@
citecolor={red}}
-\newcommand{\vym}{{\sc vym }}
-\newcommand{\ra}{$\longrightarrow$}
-\newcommand{\la}{$\longleftarrow$}
-\newcommand{\ua}{$\uparrow$}
-\newcommand{\da}{$\downarrow$}
-\newcommand{\key}[1]{[#1]}
-
\begin{document}
\title{
\includegraphics[width=8cm]{images/vym-logo-new.png}
@@ -45,9 +71,7 @@
\section{Introduction}
\subsection{What is a \vym map?}
A \vym map (abbreviated below as {\em map}) is a tree like structure:
-\begin{center}
- \includegraphics[width=12cm]{images/example1.png}
-\end{center}
+\maximage{images/example1.png}
Such maps can be drawn by hand on a sheet of paper or flip chart and help to
structure your thoughts. While a tree like structure like the illustration above can be
drawn manually \vym offers much more features to work with such maps.
@@ -57,7 +81,11 @@
email by a simple mouse click.
Once you have finished collecting and organising your ideas, you can
-easily generate a variety of outputs including for example a presentation in Open~Office based on a {\em map}.
+easily generate a variety of outputs including for example a
+presentation in Open~Office based on a {\em map}.
+
+\hint{You find the map shown above and others by clicking \begin{center}Help \ra Open vym
+examples\end{center} in the menu bar.}
\subsection{Why should I use {\em maps}? Time, Space and your Brain.}
\subsubsection*{Space}
@@ -160,9 +188,7 @@
}.
The image below shows the {\em mapeditor}
together with the often used {\em noteeditor}:
-\begin{center}
- \includegraphics[width=8cm]{images/windows.png}
-\end{center}
+\maximage{images/windows.png}
Most of the time you will work in the {\em mapeditor} by just adding new
branches, moving around and reordering them. The various ways to do this
will be explained in \ref{mapeditor}. You can store additional
@@ -191,19 +217,18 @@
branch may show certain {\em flags}, the corresponding flags are also
set in the toolbar.
-Note that you can reposition all toolbars by simply grabbing and
+\hint {You can reposition all toolbars by simply grabbing and
dragging them with the toolbar handle to a new position. For example you
can move the flags-toolbar from its original horizontal position on top
of the mapeditor to a vertical position on the right side. Or just
insert it again at its original position. Also hiding some of the
-toolbars is possible by right-clicking on the toolbar handle.
+toolbars is possible by right-clicking on the toolbar handle.}
\subsection{Maps}
The {\em map} itself has always a {\em mapcenter}. The
-mapcenter has {\em branches} radiating out from the centre just like the trunk of a tree. Each branch in turn may have branches again.
-\begin{center}
- \includegraphics[width=10cm]{images/branches.png}
-\end{center}
+mapcenter has {\em branches} radiating out from the centre just like the trunk
+of a tree. Each branch in turn may have branches again.
+ \maximage{images/branches.png}
We will call a branch directly connected to the mapcenter a {\em
mainbranch}, because it determines the position of all its child
branches.
@@ -214,9 +239,7 @@
In the toolbar above the mapeditor you see various symbols.
-\begin{center}
- \includegraphics[width=8cm]{images/default-flags.png}
-\end{center}
+ \maximage{images/default-flags.png}
These are called {\em flags} and can be used to mark branches in the
{\em map}, e.g. if something is important or questionable.
There are also more flags set by \vym automatically to show additional
@@ -246,14 +269,17 @@
Sometimes it comes in handy to be able to add a new branch above or below the current
one.
\begin{itemize}
- \item Use \key{Shift-Ins} to add a branch above the selected one or...
- \item \key{Ctrl-Ins} to add one below.
+ \item Use \key{Shift-A} to add a branch above the selected one or...
+ \item \key{Ctrl-A} to add one below.
\end{itemize}
It is also
possible to add a branch in such a way, that the current selection
becomes the child of the new branch, which is like inserting it {\em
before} the selection. This can be done using the context menu.
+\hint{To delete a branch press \key{CTRL-X}. If enabled in the Settings
+menu, you can also use the \key{Del} key.}
+
\subsection{Navigate through a map}
\subsubsection*{Select branches}
To select branches you can use the left button of your mouse or also the
@@ -400,9 +426,7 @@
mapeditor window. (Note: Like all toolbars you can also move them to the
left or the right side of the window or even detach them. Just grab the
very left "dotted" part of the toolbar with your left-mouse button.)
-\begin{center}
- \includegraphics[width=8cm]{images/default-flags.png}
-\end{center}
+ \maximage{images/default-flags.png}
If you have a branch selected, you can set any number of flags by
clicking them in the toolbar. The toolbar buttons change their state and
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.
@@ -574,9 +598,7 @@
If you want to attach more text to a branch e.g. a complete email, a
cooking recipe, or the whole source code of a software project, you can
use the noteeditor.
-\begin{center}
- \includegraphics[width=8cm]{images/noteeditor.png}
-\end{center}
+ \maximage{images/noteeditor.png}
This editor displays text associated with a branch selected in the mapeditor. The noteeditor
shows different background colours depending on whether text is associated with a selected branch.
@@ -591,9 +613,7 @@
In the mapeditor itself, to signal that there is a note with more
information for a particular branch, a little "note" flag will appear next
to the heading of the branch. This is illustrated in the lower branch on the right hand side:
-\begin{center}
- \includegraphics[width=8cm]{images/branches-flags.png}
-\end{center}
+ \maximage{images/branches-flags.png}
\subsection{Import and export notes}
The note is always saved automatically within the \vym map itself.
@@ -705,9 +725,7 @@
\end{itemize}
you get a file dialogue where you can choose the output file and the
file type:
-\begin{center}
- \includegraphics[width=12cm]{images/export-oo.png}
-\end{center}
+ \maximage{images/export-oo.png}
The file types represent various templates, which can be created with
some manual work from an existing Open Office document. The structure of
\vym map is then inserted into a template.
@@ -828,16 +846,23 @@
\vym keeps track of all changes done in a map. The default number of
changes which can be undone is~75. The complete history can be seen in
the {\em historywindow}:
-\begin{center}
- \includegraphics[width=8cm]{images/historywindow.png}
+ \maximage{images/historywindow.png}
\label{historywindow}
-\end{center}
A single step back be undone or redone with \key{CTRL-Z} or \key{CTRL-Y},
or by using the buttons in the toolbar or the {\em historywindow}.
Inside the {\em historywindow}, you can click on a line to unwind all
actions done until that point in time -- or redo all changes by clicking
on the last line.
+\hint{
+ You can "paste from the past": Go back in time by e.g. with
+ \key{CTRL-Z}, then copy to clipboard by pressing \key{CTRL-C}.
+
+ Now do all actions again, e.g. by \key{CTRL-Y} or clicking on the
+ last action in {\em historywindow}. Now paste from the past with
+ \key{CTRL-V}.
+}
+
\subsection{Macros} \label{macros}
Macros have been added to \vym in version~1.9.0. Each function key
\key{F1} to \key{F12} holds a macro, which is executed on the current
@@ -894,9 +919,7 @@
\end{itemize}
The image is still positioned relative to its parent branch, but the
heading and border of the branch frame adapt to the floating image, see below:
-\begin{center}
- \includegraphics[width=11cm]{images/includeImages.png}
-\end{center}
+ \maximage{images/includeImages.png}
\subsection{Modifier Modes}
Modifiers are for example the \key{Shift}- the \key{Ctrl}- ot the \key{Alt}-keys. When
@@ -939,9 +962,7 @@
branches in a real tree. This is especially useful in complex maps,
where you want to have crossreferences which can not be displayed on the same
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:
-\begin{center}
- \includegraphics[width=12cm]{images/xlink.png}
-\end{center}
+ \maximage{images/xlink.png}
Note that a xLink which points to a branch that is not visible (because
it is scrolled), is just shown as a little horizontal arrow. In the
screenshot above have a look at the \lq Tuesday\rq\ branch.
@@ -987,8 +1008,7 @@
\subsubsection*{QT Mac Edition:}
\vym here provides the well known Mac look and feel. \vym is
available as zipped Mac OS X application. It has been compiled and
- tested in Mac~OS~10.3, but should also work on Tiger. It is using
- the Mac version of Trolltechs QT library.
+ tested in Mac~OS~10.4. It is using the Mac version of Trolltechs QT library.
\subsubsection*{X11}
\vym can also be run using the Linux version, but then menus and
handling will also be those of the Linux version e.g. The menu bar