diff -r 000000000000 -r 29e72e3aeb92 tex/vym.tex --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/tex/vym.tex Sun Jan 30 12:59:04 2005 +0000 @@ -0,0 +1,927 @@ +\documentclass{article} +\usepackage{a4} +\usepackage[latin1]{inputenc} +\usepackage{verbatim} +\usepackage{hyperref} +\usepackage{graphicx} +\usepackage{longtable} + + +%\input{udmath} + + +\hypersetup{bookmarks, bookmarksopen, + pdftitle={VYM - a tool for visual thinking }, + pdfauthor={Uwe Drechsel}, + pdfsubject={map}, + pdfkeywords={map, tool}, + pdfpagemode={UseOutlines}, + bookmarksopenlevel={1}, + colorlinks={true}, + linkcolor={blue}, + urlcolor={green}, + 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{VYM \\ -- \\View Your Mind} +\author{\textcopyright Uwe Drechsel } +%\date{September 26, 2002} + +\maketitle + +\tableofcontents + +\newpage + +\section{Introduction} +\subsection{What is a \vym map?} +A \vym map (in short words {\em map}) is a tree like structure: +\begin{center} + \includegraphics[width=12cm]{example1.png} +\end{center} +Such maps can be drawn by hand on paper or a flip chart and help to +structure your thoughs. While a tree like structure like above can be +drawn by hand or any drawing software \vym offers +much more features to work with such maps. \vym is not another drawing +software, but a tool to store and modify information in an intuitive +way. For example you can reorder parts of the map by pressing a key or +add various information like a complete email by a simple mouse click. + +\subsection{Why should I use maps? Time, Space and your Brain.} +\subsubsection*{Space} +A map can concentrate a very complex content on little space e.g. a +piece of paper. It helps to use both sides of your brain: the logical +side and also your creative side (e.g. by using pictures, colors and +keywords in a map, so called {\em anchors}). It is a technique to +organize the way you think: It can help you by developing, sorting and +memorizing your thoughts. + +\subsubsection*{Time} +Because you just use keywords and drawings, it is much faster than good +old fashioned notes. Your brain memorizes things by associating them to +other things -- a map makes use of those connections and stimulates +new asccociations. + +\subsubsection*{Your Brain} +In 1960 the Prof. {\sc Roger Sperry} discovered that both hemispheres +of the human brain have different tasks (of course both of them +basically {\em can} do the same): The left side is specialised in +\begin{itemize} + \item verbal speech and writing + \item numbers + \item logical thinking + \item analyzing and details + \item science + \item linear thinking + \item concept of time +\end{itemize} +while the right side of the human brain is specialised in +\begin{itemize} + \item body language + \item visual thinking, day dreams + \item intuition and emotion + \item overview of things + \item creativity + \item art, music, dancing + \item non-linear thinking, connecting things + \item spatial awareness +\end{itemize} +In our science oriented society we have learned to mainly rely on our +left side of the brain, the "rational" one. In other cultures, +especially like the native americans and other "old" cultures, the right +side is much more important. maps are just one way to stimulate the +other side and make use of additional ressources we all have. + + +\subsection{Where could I use a map?} +Here are some examples, how you can use those maps +\begin{itemize} + \item to prepare articles, papers, books, talks, \ldots + \item to sort complex data + \item to memorize facts, persons, vocabulary, \ldots + \item to sort emails, files and bookmarks on your computer + \item to moderate conferences +\end{itemize} + +\subsection{What you shouldn't do with a map...} +A map drawn by somebody shows the way the author thinks. There is +no right or wrong in the way it is drawn, so there is no way to critize +it. "It is, what it is" ({\sc F.~Lehmann}). + +%\section{Tutorials} +%TODO + +\section{Concept} + +%TODO may add a general introduction here... + +\vym uses two windows: an editor for the map itself and another one for +notes, which are part of the map. Let's call them {\em mapeditor} and +{\em noteeditor}: +\begin{center} + \includegraphics[width=8cm]{windows.png} +\end{center} +Usually 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 +information e.g. the content of a email easily in a {\em branch}: Just +type or copy\&paste it into the {\em noteeditor}. Working with notes is +explained in \ref{noteeditor} + +The map itself has always a {\em mapcenter}. The +mapcenter has {\em branches} just like the trunk of a tree. Each branch +in turn may have branches again. +\begin{center} + \includegraphics[width=10cm]{branches.png} +\end{center} +We will call a branch directly connected to the mapcenter a {\em +mainbranch}, because it determines the position of all its child +branches. + +The mapcenter and the branches all have a {\em heading}. This is the +text you see in the mapeditor. Usually it should just be one or a few +words, so that one can easily keep track of the whole map. + + +In the toolbar above the mapeditor you see various symbols. +\begin{center} + \includegraphics[width=8cm]{default-flags.png} +\end{center} +These are called {\em flags} and can be used to mark branches in the +map, e.g. if something is important or questionable. +There are also more flags set by \vym automatically to show additional +information, e.g. when a exists for a particular branch. + +\section{Mapeditor} \label {mapeditor} +\subsection{Start a new map} +After \vym is started two windows will open: the mapeditor and the +noteditor. Usually you will work in both windows, but at the moment we +will just need the mapeditor. + +Select the mapcenter "New map" in the middle of the mapeditor by +left-clicking with the mouse. It will turn yellow to show that is +selected. There are two ways to add a new branch to the center: +\begin{itemize} + \item Main menu on top of mapeditor window: + Edit \ra Add new Branch + \item Press \key{Ins} +\end{itemize} +A new branch will appear and you will be able to type the heading of the +branch. Finish adding the new branch by pressing \key{Enter}. +%tipp +Sometimes it comes handy to add a new branch above or below the current +one. Use \key{Ins} together with \key{Shift} or \key{Ctrl}. + +\subsection{Navigate through a map} +\subsubsection*{Select branches} +To select branches you can use the left button of your mouse or also the +arrow keys. Depending on the {\em orientation} of a branch type +\key{\la} or \key{\ra} to get nearer to the mapcenter or deeper +down into the branches. Within a set of branches, let's call them a +{\em subtree}, you can use \key{\ua} and \key{\da} to go up and down. You can +also use \key{Pos1} and \key{End} to select the first and last branch. + + +\subsubsection*{Zoom a map} +While adding more and more branches the size of the map may become +bigger than the mapeditor window. You can use the scrollbars on the +right and the bottom of your mapeditor window to scroll, but it is +easier to just scroll using the left mouse button: Click onto the {\em +canvas} itself, the empty space somewhere between the branches. The +mouse pointer will change from an arrow to a hand, now move the visible +part of the map to show the desired part. + +If you select branches using the arrow keys, the map will scroll +to ensure that the selected branch is always visible. + +Working with huge maps, the {\em zoom}-function comes in handy: You can +use +\begin{itemize} + \item from the menu View \ra Zoom + \item the toolbar buttons + \begin{center} + \includegraphics[width=3cm]{zoom-buttons.png} + \end{center} +\end{itemize} +The crossed magnifying lens resets the zoomed view to its original size. + + +\subsubsection*{Find Function} \label{findwindow} +With huge maps there is the need to have a +find function. Choose Edit \ra Find to open the Find Window: +\begin{center} + \includegraphics[width=6cm]{find-window.png} +\end{center} +The text you enter here will be searched in all the headings and also in +notes. Everytime you press the "Find"-button it will look for the next +occurence, which then will be selected automatically. If the search +fails, there will appear a short message "Nothing found" or a few +seconds in the {\em statusbar} on the bottom of the mapeditor. + +\subsubsection*{Scroll a part of the map} +A very big subtree of a map e.g. a branch with hundreds of childs makes +it very hard to keep an overview over the whole map. You can hide all +the childs of a branch by {\em scrolling} it -- this function is also +often called {\em folding}. Think of the whole subtree as painted onto a +big newspaper. You can scroll the paper to a small roll, leaving just +the headline readable. + +To scroll or unscroll a branch and its childs, press the +\begin{itemize} + \item \key{Scroll} key or + \item press the middle-mouse button or + \item choose the little scroll from the toolbar. +\end{itemize} +If you select parts of a scrolled branch e.g. using the find function or +by using the arrow-keys, it will unscroll temporary. This is shown as a +scroll with a little hour glass. If the temporary unscrolled part is not +longer needed, it will be hidden again automatically. It is also +possible to unscroll all branches using "Edit\ra Unscroll all scrolled +branches". + + + +\subsection{Modify and move branches} +\subsubsection*{Modify the heading of a branch} +You can edit the heading by selecting the branch and then +\begin{itemize} + \item pressing \key{Enter} + \item double-clicking with left mouse. +\end{itemize} +Just type the new heading (or edit the old one) and press \key{Enter}. + +\subsubsection*{Move a branch} +The easiest way to move a branch is to select it with left-mouse and +drag it to the destination while keeping the mouse button pressed. +Depending on the branch it will be +\begin{itemize} + \item moved to the destination or + \item {\em linked} to a new {\em parent} (mapcenter or branch) +\end{itemize} +If you drag the branch over another one or over the mapcenter, you will +notice that the link connecting it to the old parent will be changed to +lead to the new parent which is now under your mousepointer. +If you release the button now, the branch will be relinked. + +If you release the button in the middle of nowhere, the result will +depend on the type of branch you are releasing: +\begin{itemize} + \item A mainbranch is directly connected to the mapcenter. + It will stay on its new position. + \item An ordinary branch will "jump" back to its original position. +\end{itemize} +Thus you can easily rearrange the layout of the mainbranches to avoid +overlapping of their subtrees. +There is another convenient way to move branches, especially if you want +to {\em reorder} a subtree: You can move a branch up or down in a +subtree by +\begin{itemize} + \item pressing \key{\ua} and \key {\da} + \item selecting Edit \ra Move branch + \item clicking on the toolbar buttons: + \begin{center} + \includegraphics[width=1.5cm]{move-buttons.png} + \end{center} +\end{itemize} +%tipp +There is yet another way to move branches: If you press \key{Shift} or +\key{Ctrl} while moving with the mouse, the branch will be added above +or below the one the mouse pointer is over. This helps also to reorder a +map. + +\subsection{The right side of your brain - colors and images} +\subsubsection*{Change color of a heading} +You can also use colors to put more information into a map, e.g. use +red, green and more colors to prioritize tasks. Again you can +\begin{itemize} + \item use the menu and choose e.g Format \rq Set Color + \item use the toolbar + \begin{center} + \includegraphics[width=3cm]{color-buttons.png} + \end{center} +\end{itemize} +The first button (black in the graphic above) shows the actual color. +Clicking on it let's you choose another color. You can also "pick" +another color by selecting a branch with the desired color and using the +"pick color" button. Both of the buttons showing a bucket actually put +the current color to the selected branch. While the first one just +colors the heading of the selection, the last one also colors all the +childs of the selected branch. + +%tipp +A very useful function is the "copy color" using the mouse: Select the +branch which should get the new color, then press \key{Ctrl} and +simultanously click with left-mouse on another branch to copy its color +to the first one. Here the childs of the selection also will get the new +color, if you just want to color the selection itself, additionally +press \key{Shift}. + +\subsubsection*{Use flags} +\vym provides various flags. You see them in the toolbar on top of the +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]{default-flags.png} +\end{center} +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. + +Presently \vym uses two kinds of flags: {\em System Flags} and {\em +Standard Flags}. The standard flags are those shown in the toolbar. +System flags are set by \vym to indicate e.g. that there is additional +information in a note (more on this in \ref{noteeditor}). Later versions +of \vym may have another kind of flags, which may be edited by the user. + +\subsubsection*{Images} +You can add a image to a branch or the mapcenter by clicking with the +right-mouse button. A context menu will open, choose "Add Image". A +dialog window lets you choose the image to load. +\footnote{Supported image types are: PNG, BMP, XBM, XPM and PNM. It may + also support JPEG, MNG and GIF, if specially configured during + compilation (as done when \vym is part of SUSE LINUX).} +While an image is selected in the dialog, you can see a preview of the +image. + +You can position the image anywhere you want, just drag it with left +mouse. To relink it to another branch, press \key{Shift} while moving +it. To delete it, press \key{Del}. + +If you right-click onto an image, a context menu will open which let's +you first choose one of several image formats. Then a file dialog opens +to save the image. Hint: This is used to "export" the image, it will be +saved anyway in the map itself! You can also cut and +copy images, but it is not possible to add objects to an image\footnote{ + Images are regarded as "extra feature". It would make working with + the map much more complex if e.g. images could be linked to images.} + +The option \lq{\bf Use for export} \rq controls the output of exports +e.g. to HTML: If set to no, the image won't appear in the {\em text} +part of the output. This is useful for large images or if images are +used as a kind of frame e.g. the famous cloud symbol around a part of +the map. Those shouldn't appear in the middle of the text. + +At the moment image support is preliminary: Images will be saved +together with all the other data of a map in the {\tt .vym}-file. +Later versions will include more functionality like resizing the images, +changing its z-value (put it into background) etc. + +\subsubsection*{Frames} +A frame can be added to a branch by clicking with the +right-mouse button. A context menu will open, where you can choose the +frame. At the moment just a rectangle resp. "No Frame" will be offered, +nevertheless you can use images as frames. Have a look at the demo map +{\tt todo.vym} as an example, where the mapcenter is a cloud. You can +use an external drawing program like {\tt gimp} to create an image, +preferable with an transparency channel, so that you can design frames +which don't use a rectangular borderline, just like the cloud. + + +\subsection{Background design} +The design of the background of a map and also of the links connecting +various parts of the map can be changed by +\begin{itemize} + \item Selecting Format from the menu + \item Right clicking onto the canvas, which will open a context menu +\end{itemize} + +\subsubsection*{Background color} +The color is set (and also displayed) as "Set background color". + +\subsubsection*{Link color} +Links connecting branches can be colored in one of the following ways: +\begin{itemize} + \item use the color of the heading of the branch the links is + \item use {\em one} color for all links. The default color is blue. + leading to. +\end{itemize} +The latter can be set with "Set link color". Check or uncheck the "Use +color of heading for link" option to choose one of the two designs for +your map. + +\subsubsection*{Link style} +\vym offers four different styles for the appearences of links: +\begin{itemize} + \item Line + \item Parabel + \item Thick Line + \item Thick Parabel +\end{itemize} +The "thick" styles only draw links starting at mapcenter thick, the rest +of the map is always painted "thin". + + +\subsection{Link to other documents} +Presently \vym supports two kind of links: +\begin{itemize} + \item Document, which will be opened in an external webbrowser + \item \vym map, which will be opened in \vym itself +\end{itemize} + +\subsubsection*{Webbrowser} +Modern Webbrowsers like {\tt konqueror} are able to display various +types of files, both local or in the internet. To enter the URL of +any document, right-click onto a branch or use the Edit Menu +and choose "Edit URL". Enter the path to your document (or copy and +paste it from your browser). Examples for valid paths are: +\begin{verbatim} + http://www.insilmaril.de/vym/index.html + file:/usr/share/doc/packages/vym/doc/vym.pdf +\end{verbatim} +If an URL was entered, a little globe will appear in the branch. By +clicking on the globe in the toolbar or the context menu an external +browser\footnote{ + The browser can be changed in the Settings Menu.} +will be started. +\begin{center} + \includegraphics[width=0.5cm]{flag-url.png} +\end{center} +If you want to keep bookmarks in a map, you may want to copy the heading +as URL: Right click onto the branch and select "Use heading for URL". + +\subsubsection*{\vym map} +To link to to another map right click on a branch or choose "Edit \ra +Enter \vym link". A file dialog opens where you can choose the map. A +branch with a link is marked with +\begin{center} + \includegraphics[width=0.5cm]{flag-vymlink.png} +\end{center} +Clicking this flag in the toolbar or in the context menu of a branch +will open the map in another tab (see \ref{tabs} for working with +multiple maps). To delete an existing link, just press the "Cancel" +button. + +Technical note: Internally \vym uses absolute paths, to avoid opening +several tabs containing the same map. When a map is saved, this path is +converted to a relative one (e.g. {\tt /home/user/vym.map} might become +{\tt ./vym.map}. This makes it fairly easy to use multiple maps on +different computers or export them to HTML in future. + +\subsection{Multiple maps} \label{tabs} +You can work on multiple maps at the same time. Each new map is opened +in another {\em tab}. The available tabs are shown just above the +mapeditor. You can use the normal cut/copy/paste functions to +copy data from one map to another. + +%todo + +%TODO +%\subsubsection{Menus} +%\subsubsection{Keyboard shortcuts} + +% Settings +% Images +% Copy & Paste +% Working with tabs (multiple maps) +% Exporting +% Scrolling + +\section{Noteeditor} \label {noteeditor} +If you want to save more text in a branch e.g. a complete email, a +cooking recipe, or the whole source code of a software project, you can +use the noteeditor. Since version 1.4.7 \vym supports formatted text in +the noteeditor. + +\subsubsection*{States} +Before you can type or paste text into it, you have +to select a branch in the mapeditor. Note that the background color +of the noteeditor indicates its state: +\begin{itemize} + \item black: no branch selected + \item grey: no text entered yet + \item white: text is already available +\end{itemize} +To show you in the mapeditor itself 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. See the lower branch on the right side: +\begin{center} + \includegraphics[width=8cm]{branches-flags.png} +\end{center} + +\subsubsection*{Import and export notes} +The note is always saved automatically within the \vym file itself. +Nevertheless sometimes it is nice to import a note from an external file +or write it. Use "File\ra~Import" and "File\ra~Export" to do so. + +\subsubsection*{Edit and print note} +Editing works like in any simple texteditor, including undo and redo +functions. You can delete the complete note by clicking the +trashcan. Only the note itself is printed by clicking the printer icon. + +When pasting into the editor using the X11 copy\&paste mechanism, the +editor will create a paragraph for each new line. Usually this is not +wanted, so there you can convert all paragraphs into linebreaks by using +Edit~\ra~Remove~Paragraphs or \key{ALT-X}. + +\subsubsection*{Fonts} +The noteeditor is ment to be used for simple notes, not really as full +featured text editor. Because of many requests \vym supports now +formatted text in the noteeditor\footnote{ + \vym uses the QRichtText format, which is basically a subset of the + formatting provided in HTML.} +Two default fonts are supported which can be set in the Settings menu. +One is a fixed width font, the other has variable width. The fixed font +is usually used for emails, source code etc.\ while the variable font is +used for simple notes, where one doesn't need fixed character widths. +Both fonts can easily switched using the following symbol from the +toolbar: +\begin{center} + \includegraphics[width=0.5cm]{formatfixedfont.png} +\end{center} +In the Settings menu both fonts can be set and also which font should be +used for default. + +Additionally to the default fonts any font installed on your system can +be used. Please note, that the chosen font also will be used for HTML +exports, so you should only use fonts which are available generally. + +\subsubsection*{Colors and formatted text} +Colors and text attributes (e.g. italic, bold) can +be set with the buttons above the text. +The text itself is divided in paragraphs. For each paragraph the format +can be set (e.g. centered, right). A paragraph is ended when a +\key{Return} is entered. If you just want to begin a new line, press +\key{CTRL-Return}. + +\subsubsection*{Finding text} +The noteeditor itself has no Find function, use Find in the mapeditor, +which will also search all notes (see \ref{findwindow}). + +\subsubsection*{Pasting text into note editor} +Often you will paste text into the editor from another application e.g. +an email. Normally \vym will generate a new paragraph for each new line. +This usually is not what you want, so you can choose from the menu + +\paragraph{Edit \ra Convert Paragraphs:} +This turns paragraphs in selected text (or all text, if nothing is +selected) into linebreaks. This is especially useful for snippets of +source code. + +\paragraph{Edit \ra Join Lines:} +Tries to format text, so that empty lines are used to delimit +paragraphs. This is done for selected text (or all text, if nothing is +selected). Especially useful for text like emails, meeting minutes etc. + +\section{Hello world} +\vym can export its maps in various formats and can import data from +outside (though import is still limited at the moment). + +\subsection{Export} +The format in which the map will be exported can be chosen with +\begin{itemize} + \item File \ra Export \ra {\em format} +\end{itemize} +\vym offers both HTML and ASCII export. + +\subsubsection*{Image} +\vym supports all image formats which are natively supported by the +QT~toolkit: +BMP, JPEG, PBM, PGM, PNG, PPN, XPM, and XBM. +For use in websites and for sending images by email PNG is a good +recommodation regarding quality and size of the image. \vym uses QTs +default options for compressing the images. + +\subsubsection*{ASCII} +Exporting an image as text is somewhat experimental at the moment. Later +this will probably done using stylesheets. So the output may change in +future versions of \vym. + +\subsubsection*{HTML} +Before a map is exported as HTML, it will be first written as XML into a +directory (see \ref{xmlexport}). Then the external program {\tt +xsltproc}\footnote{On SUSE Linux {\tt xsltproc} is installed by +default.} +will be called to process the XML file and generate HTML code. +%A script then will transform the XML +%version. +A dialog allows to set various options: +\begin{itemize} + \item {\bf Include image:} If set, \vym will creat an image map at + the top of the HTML output. Clicking on a branch in the map will + jump to the corresponding section in the output. + + \item {\bf Colored headings:} + If set to yes, \vym will color the headings in the text part with the + same colors like in the map. + \item {\bf Show Warnings:} + If set to yes, \vym will ask before overwriting data. + \item {\bf Show output:} + This is useful mainly for debugging. It will show how the processing of + the XML file works by calling the external {\tt xsltproc}. +\end{itemize} +Additionally the paths to the CSS and XSL stylesheets can be set. By +default on SUSE~Linux they will be in {\tt /usr/share/vym/styles}. + +%\paragraph{WIKI style:} This is very useful for easy design of webpages. +%Here is a short overview: +%\begin{verbatim} +%Lines: +% + Big headlines start with the '+' character. +% - Small headlines start with the '-' character. +% Normal text doesn't have any starting notation. +% ! Notes start with an exclamation. +% . Indented text starts with a dot. +% ? Questions start with a question-mark, and +% = Answers starts with the equal-sign. +% * Points for a item-list +% # clues +% +%Links: +% use '{...}' or '{(vym homepage) http://www.insilmaril.de/vym/}' +% for external links. +% +%Markup: +% |This is bold| text, while +% |/this text is italic|, +% |*this is pre-formatted|, and +% |!this is a note| +%\end{verbatim} +% +%\paragraph{Show output:} This is used for debugging. \vym uses an +%the external script {\tt vym2html.sh} to preprocess the XML-data. Then +%\vym calls {\tt xsltproc} to generate the HTML page by using various +%{\tt .xsl} stylesheets and {\tt wireframe.css}. If you run into problems +%here, changing paths in {\tt $\sim$/.qt/vymrc} might help. + +\subsubsection*{XML} \label{xmlexport} +The map is written into a directory both as an image and as XML. The +directory is set in a file dialog. If the directory is not empty, you +will be questioned if you risk to overwrite its contents. + +It is possible to export different maps into the same directory. Each +file generated will have the map's name as prefix, e.g. {\tt todo.vym} +becomes {\tt todo.xml}, {\tt todo.png}, {\tt todo-image-1.png} and so +on. This is useful if e.g. for a website several combined maps have to +be stored in the same directory. + +\subsection{Import} +At the moment \vym can read a directory structure. This is mainly for +testing \vym e.g. to easily create huge maps used for benchmarks (yes, +there is still room to optimize \vym ;-) + +Many other applications meanwhile can export their data using XML, so +volunteers to write import filters are welcome. + +\subsection{File format} +\vym maps usually have the postfix "{\tt .vym}" and represent a +compressed archive of data. If you want to have a +closer look into the data structure, just uncompress the map manually +using +\begin{verbatim} + unzip vymfile.vym +\end{verbatim} +A directory named {\tt vymfile} will be created containing further +directories both for {\tt images} and {\tt flags}. In the {\tt vymfile} +directory you will find the map itself, usually named {\tt vymfile.xml}. + +This file can be loaded directly into \vym, it does not have to be +compressed. If you want to compress all the data yourself, use +\begin{verbatim} + cd vymfile + zip -r vymfile.vym . +\end{verbatim} + + +%TODO +%\subsubsection{Menus} +%\subsubsection{Keyboard shortcuts} +%Where does vym save its settings? -> ~/.qt/vymrc + +\section{History of \vym} +\subsection{Future} +There are lots of features which might find their way into \vym. +Together with \vym you should have received a directory with example +maps e.g. on SUSE~LINUX this is +\begin{center} + {\tt /usr/share/doc/packages/vym/demos} +\end{center} +where you find the map {\tt todo.vym}. It lists quite a lot of things to +be done in future. If you have more ideas, contact the author at +{\tt vym@insilmaril.de}. + +\subsection{Past} +\begin{center} +\begin{longtable}{|lcp{8cm}l|} \hline +Version & & Comment & Date \\ \hline \hline \endhead + \hline \endfoot +1.6.0 & - & Added saving of xhtml settings in map& 2004-12-14 \\ +1.5.2 & - & Added Import of maps with two modes: + add/replace & 2004-12-13 \\ + & - & Added export of part of maps & \\ + & - & Added joining of paragraphs in text editor & \\ + & - & Optimized undo: Only relevant parts are saved, which + dramatically improves e.g. moving branches up/down + in most maps & \\ + & - & Bugfix: QTextEdit generates invalid XML code, which + could lead to a parse error, if font name contains a \& & \\ + & - & Bugfix: Wrong order of mainbranches in Export & \\ + & - & Bugfix: zip archive was not deleted before save, which + could lead to much bigger files, e.g. + when working on older \vym maps or deleted images& \\ + & - & Bugfix: Printing in Texteditor & \\ + & - & Bugfix: Wrong URLs in xhtml output & \\ + & - & Bugfix: Segfault fixed at Cursor left/right in empty map& \\ +1.5.1 & - & More options in xhtml export: external scripts & 2004-10-01 \\ +1.5.0 & - & Public release of all changes since 1.4.1 & 2004-09-26 \\ + & - & New function to replace paragraphs in note editor + by linebreaks, this makes pasted text much nicer& \\ + & - & New option to toggle exporting of of floatimages& \\ + & - & z-plane of floatimages can be set (manually only)& \\ + & - & Bugfix: Wrong ordering of branches, if mainbranch is + exactly left of center& \\ +1.4.7 & - & New Export to HTML by Thomas Schraitle. & 2004-09.24 \\ + & - & Bugfix: vymLink& \\ + & - & Bugfix: spaces and dots in filenames & \\ + & - & Bugfix: Error message if xsltproc is not installed& \\ +1.4.6 & - & New file format: notes are saved as part of the .xml file + & 2004-09-15 \\ + & - & Note Editor supports Rich Text now.&\\ + & - & Parser now also nows {\tt standardflag} (all letters + lowercase)&\\ +1.4.5 & - & Correct handling of font size in Heading & 2004-08-23 \\ +1.4.4 & - & Selecting with cursor now works between subtrees & 2004-07-29 \\ + & - & Bugfix: vymLink was set to temporary dir in 1.4.3 & \\ + & - & Bugfix: & \\ +1.4.3 & - & Optimisation: Reduced canvas objects by only + creating objects for used flags & 2004-07-19 \\ + & - & Better visualization of moving branch above/below target&\\ + & - & Find Window informs with dialog, if the search failed&\\ + & - & System Flags are clickable now &\\ + & - & Reworked CSS and XST stylsheets (comments, indent, browser + compatibility) &\\ + & - & vymLinks are shown in statusbar &\\ + & - & current directory is save &\\ + & - & Rewritten load/save to improve multimap handling and + unzipped files&\\ + & - & Bugfix: vymLinks don't get deleted + when Cancel is pressed &\\ + & - & Bugfix: Fixed a bunch of bugs in XSL for HTML export& \\ + & - & Bugfix: More toolbar buttons disabled, if action not + possible& \\ + & - & Bugfix: Renaming .vymfile now works&\\ + & - & Bugfix: mapChanged set when toggling flags&\\ + & - & Bugfix: CTRL-N was used twice &\\ + & - & Bugfix: Del didn't work on floatimage &\\ +1.4.2 & - & Bugfix: Float image could not be deleted& \\ +1.4.1 & - & Bugfix: Color of branch not saved & 2004-05-25 \\ + & - & Bugfix: wrong path at HTML export & \\ + & - & Bugfix: map is not save with special characters in path& \\ +1.4.0 & - & Ask for confirmation before opening + a map in multiple editors & 2004-05-17 \\ + & - & Save state of note editor (visible/minimized)& \\ + & - & Export to HTML & \\ + & - & Author and Comment is saved in map & \\ + & - & Stats are shown in Edit MapInfo & \\ + & - & Changes for OS X port (QCursor, QContextMenuEvent) & \\ + & - & Bugfix: Fonts from note editor are save now &\\ + & - & Bugfix: invisible image when parent is scrolled &\\ + & - & Bugfix: Segfault pressing "enter" for floatimage &\\ + & - & Bugfix: Images can't be outside of exported area + anymore.& \\ + & - & Bugfix: Filenames with blanks & \\ + & - & Bugfix: Old maplink is shown when editing maplink& \\ + & - & Bugfix: always show cursor while editing heading & \\ +1.3.5 & - & Export map to dir & 2004-04-16 \\ + & - & Export to any of QTs image formats & \\ + & - & Also right side of selection is always visible now.& \\ +1.3.4 & - & Load last maps in file menu & 2004-04-07 \\ + & - & save last image path for loading & \\ + & - & Also export standard flags to dir. & \\ +1.3.3 & - & Enabled
in headings as manual linebreak & 2004-03-26 \\ + & - & Heading can be copied to URL &\\ + & - & Bugfix: GIFs are automatically converted to PNG now&\\ +1.3.2 & - & Add and move branches above/below selection, Texteditor copy all,& 2004-03-26 \\ +1.3.1 & - & Export to directory, changed naming in .vym& 2004-03-25 \\ +1.3.0 & - & Bugfix: Check if map can be saved at all& 2004-03-23 \\ +1.2.12 & - & Select image format before saving image & 2004-03-22 \\ +1.2.11 & - & Selecting mainbranches by up/down & 2004-03-18 \\ + & - & Export ASCII (experimental) & \\ + & - & Each map can be saved individually at quit & \\ + & - & Bugfix: Opening VymLink crashes QT & \\ + & - & Bugfix: 50\% less objects on canvas & \\ + & - & Bugfix: Ignoring LANG, now always written as UTF8&\\ +1.2.10 & - & Sort Mainbranches by angle to y-axis& 2004-03-16 \\ + & - & Import directory structure & \\ + & - & Fix: Set FrameType of MapCenter while loading map &\\ +1.2.9 & - & Jump to another vym map & 2004-03-12 \\ + & - & Mainbranches are alwas ordered clockwise & \\ +1.2.8 & - & Change frame types in context menu & 2004-03-03 \\ +1.2.7 & - & Copy / Paste and save Floatimages & 2004-02-25 \\ +1.2.6 & - & Closing vym in KDE now asks for save, too & 2004-02-24 \\ + & - & Context menu for branches & \\ + & - & Selection is saved in .vym file & \\ +1.2.5 & - & URLs to external links can be added & 2004-02-18 \\ + & - & All actions are deactived if not possible & \\ +1.2.4 & - & Images: Can be loaded, saved, relinked to other parents +& 2004-02-16 \\ +1.2.3 & - & Zoom: Reset and finer steps shrinking/enlarging & 2004-01-27 \\ +1.2.2 & - & Editing of links (style and color) & 2004-01-27 \\ +1.2.1 & - & Bugfix: LineEdit when adding branch has correct position + again. & 2004-01-27 \\ +1.2.0 & - & Scrolled parts are automatically unscrolled when + selected and scrolled again later. & 2004-01-23 \\ + & - & Bugfix: Save flag is updated when multiple maps are opened& \\ + & - & Bugfix: Moving of branches is faster and more accurat + when adding to mapcenter& \\ +1.1.7 & - & Bugfix: Remember filename of note in noteeditor & 2003-12-04 \\ +1.1.6 & - & Find Text also in Notes. & 2003-12-02 \\ +1.1.5 & - & Bugfix: Correct setting and positioning when relinking branches & 2003-11-07 \\ +1.1.4 & - & Scroll mode added (folding of subtrees). & 2003-11-03 \\ + & - & Bugfix: Wrong position of linedit in zoomed view& \\ +1.1.3 & - & Added clear button in find window, bugfixes & 2003-10-09 \\ +1.1.2 & - & Links can be colored with color of heading & 2003-10-07 \\ +1.1.1 & - & Improved visualization of linking to new branch& 2003-09-26 \\ +1.1.0 & - & Find Function & 2003-09-25 \\ + & - & Selection always stays in view & \\ \hline +1.0.1 & - & Find function scrolls to result now & 2003-09-18\\ + & - & Bugfix: Adding branch with midmouse & \\ + & - & Bugfix: multiple repositioning of map, + when noteeditor was changed (speedup) & \\ + & - & New Linestyles (still hardcoded) & \\ \hline +1.0.0 & - & First public stable release & 2003-09-16 \\ \hline +0.9.0 & - & added quick color picker (CTRL + Left Mouse) & ? \\ \hline +0.8.0 & - & added automatic canvas resizer, removed manual resizing of + canvas & \\ + + & - & added settings option to paste text into new branch & \\ + & - & simplified code & \\ + & - & Added heart flag & \\ + & - & Choose and switch between fixed and variable width fonts& \\ + & - & note editor & \\ + & - & Fixed segfault caused by undo and a call of updateNoteFlag of + note editor & \\ + & - & Added settings menu to configure autoselect \& autoedit mode & \\ + & - & autoedit \& autoselect mode & \\ + & - & Fixed ugly display problem with QT Palette (Klaas Freitag)& \\ + & - & Reduced temporary directories from 4 to 1 & \\ + & - & Added wordwrap in printing of notes & \\ + & - & New toolbar buttons in texteditor & \\ + & - & Set background color & \\ + & - & Fixed bug: Flags in toolbar not updated when selecting map center & \\ \hline +0.7.0 & - & No more segfault, when an object is deleted while being edited & \\ + & - & Keep focus constant when zooming in/out & \\ + & - & Export as png graphic & \\ + & - & Keep Center of map where it is while zooming & \\ + & - & Added Standard Flags (Smiley, Hook, Stopsign, ...) & \\ + & - & MDI: Multi Document Interface enables working on several + maps simultanously & \\ + & - & Enabled creating a new map via argument on commandline & \\ + & - & Changed file extension from .mmap to .vym & \\ + & - & noteeditor changes color, if empty or nothing is selected & \\ + & - & Changes in NoteEditor window are recognized by main window, + too, thus preventing loosing data when quitting the program. & \\ \hline +0.6.0 & - & New rendering engine: Faster, no flickering & \\ \hline +0.5.0 & - & Changed printing to use maximum space on paper& \\ + & - & Note editor is hidden, too, when mapeditor is minimized& \\ + & - & New (compressed) file format& \\ \hline +0.4.0 & - & Size of map is saved& \\ + & - & Multi Line Headings & \\ + & - & Reworked Rendering Engine: Much faster now.& \\ + & - & Reworked Undo: Much faster now.& \\ + & - & Enabled moving of map center& \\ + & - & Multi-line headings & \\ \hline +0.3.0 & - & Introduced Undo& \\ + & - & Fixed some bugs & \\ \hline +0.2.0 & - & Moving view of map improved:& \\ + & - & New handling (acrobat reader style)& \\ + & - & New mousepointer& \\ + & - & Several tools to color a map& \\ \hline +0.1.0 & - & Inital version, basic map layout & \\ + & - & Data is stored in XML& \\ +\end{longtable} +\end{center} + + +% INDEX +% mapeditor +% noteditor +% branch +% mapcenter +% heading +% flag +% orientation +% zoom +% orientation +% Toolbar +% Zoom +% Find +% statusbar +% link +% mainbranch +% subtree +% reorder +% scroll +% fold + + + +\end{document} \ No newline at end of file