# HG changeset patch # User insilmaril # Date 1121111757 0 # Node ID 8cdfa8dda71e81fbb03d54f37af2b831a8f30a1e # Parent e0f6a21cc6d6733deed8f2b5ca69f124c28e9762 Version 1.6.10: Updated documentation diff -r e0f6a21cc6d6 -r 8cdfa8dda71e demos/time-management.vym Binary file demos/time-management.vym has changed diff -r e0f6a21cc6d6 -r 8cdfa8dda71e demos/todo.vym Binary file demos/todo.vym has changed diff -r e0f6a21cc6d6 -r 8cdfa8dda71e exportxhtmldialog.ui --- a/exportxhtmldialog.ui Fri Jul 08 08:06:36 2005 +0000 +++ b/exportxhtmldialog.ui Mon Jul 11 19:55:57 2005 +0000 @@ -155,130 +155,6 @@ - - - buttonGroup2_2 - - - - 3 - 3 - 0 - 0 - - - - Stylesheets - - - - layout19 - - - - 9 - 24 - 562 - 31 - - - - - unnamed - - - - textLabel1_2 - - - CSS: - - - AlignVCenter|AlignRight - - - - - lineEditCSS - - - - - browseCSSButton - - - - 0 - 0 - 0 - 0 - - - - Browse - - - - - - - layout20 - - - - 9 - 64 - 562 - 31 - - - - - unnamed - - - - textLabel2 - - - XSL: - - - AlignVCenter|AlignRight - - - - - lineEditXSL - - - - - browseXSLButton - - - - 0 - 0 - 0 - 0 - - - - Browse - - - - - - - - groupBox2 - - - groupBox2 - - layout6 @@ -287,8 +163,120 @@ unnamed + + + browsePostExportButton + + + + 0 + 0 + 0 + 0 + + + + Browse + + + + + textLabel1_3 + + + + 1 + 5 + 0 + 0 + + + + Before export: + + + AlignVCenter|AlignRight + + + + + lineEditXSL + + + + + browseXSLButton + + + + 0 + 0 + 0 + 0 + + + + Browse + + + + + lineEditPreScript + + + + + browsePreExportButton + + + + 0 + 0 + 0 + 0 + + + + Browse + + + + + textLabel2_3 + + + Stylesheets: + + + + + browseCSSButton + + + + 0 + 0 + 0 + 0 + + + + Browse + + + textLabel1_2 + + + CSS: + + + AlignVCenter|AlignRight + + + + textLabel2_2 @@ -309,65 +297,33 @@ AlignVCenter|AlignRight - + - lineEditPreScript + lineEditCSS - + - browsePreExportButton - - - - 0 - 0 - 0 - 0 - + textLabel2 - Browse - - - - - textLabel1_3 - - - - 1 - 5 - 0 - 0 - - - - Before export: + XSL: AlignVCenter|AlignRight - + lineEditPostScript - + - browsePostExportButton - - - - 0 - 0 - 0 - 0 - + textLabel1_4 - Browse + Scripts: @@ -385,7 +341,7 @@ 20 - 40 + 60 diff -r e0f6a21cc6d6 -r 8cdfa8dda71e lang/vym_en.ts --- a/lang/vym_en.ts Fri Jul 08 08:06:36 2005 +0000 +++ b/lang/vym_en.ts Mon Jul 11 19:55:57 2005 +0000 @@ -1,5 +1,36 @@ + EditXLinkDialog + + Edit XLink + + + + XLink width: + + + + Set color of heading + + + + XLink color: + + + + Use as default: + + + + Delete XLink + + + + Ok + + + + ExportHTMLDialog Export HTML @@ -101,10 +132,6 @@ - Stylesheets - - - CSS: @@ -113,10 +140,6 @@ - Scripts - - - Before export: @@ -183,6 +206,14 @@ didn't exit normally + + Stylesheets: + + + + Scripts: + + ExtraInfoDialog @@ -479,10 +510,6 @@ - Save selction - - - Save selection @@ -519,10 +546,6 @@ - No link available - - - &Format @@ -668,10 +691,6 @@ - Use modifier to draw links - - - &Settings @@ -822,15 +841,6 @@ - The map - - - - does not exist. - Do you want to create a new one? - - - Create @@ -976,98 +986,76 @@ Please use Settings-> + + Add a branch by inserting and making selection its child + + + + Add branch (insert) + + + + Remove only branch and keep its childs + + + + Remove only branch + + + + Remove childs of branch + + + + Remove childs + + + + Use modifier to copy + + + + Add + + + + Remove + + + + Edit XLink + + + + Goto XLink + + + + This map does not exist: + + + + + +Do you want to create a new one? + + + + Use modifier to draw xLinks + + + + Use exclusive flags in flag toolbars + + + + Enable exclusive flags + + MapEditor - Note - - - - WWW Document (external) - - - - Link to another vym map - - - - subtree is scrolled - - - - subtree is temporary scrolled - - - - Take care! - - - - Really? - - - - ok! - - - - Not ok! - - - - This won't work! - - - - Good - - - - Bad - - - - Time critical - - - - Idea! - - - - Important - - - - Unimportant - - - - I like this - - - - I do not like this - - - - I just love... - - - - Dangerous - - - - This will help - - - - New Map - - - Critical Parse Error @@ -1080,10 +1068,6 @@ - Critcal save error - - - VYM - Export (ASCII) @@ -1179,6 +1163,120 @@ VYM - Choose directory structur to import + + Note + Systemflag + + + + WWW Document (external) + Systemflag + + + + Link to another vym map + Systemflag + + + + subtree is scrolled + Systemflag + + + + subtree is temporary scrolled + Systemflag + + + + Take care! + Standardflag + + + + Really? + Standardflag + + + + ok! + Standardflag + + + + Not ok! + Standardflag + + + + This won't work! + Standardflag + + + + Good + Standardflag + + + + Bad + Standardflag + + + + Time critical + Standardflag + + + + Idea! + Standardflag + + + + Important + Standardflag + + + + Unimportant + Standardflag + + + + I like this + Standardflag + + + + I do not like this + Standardflag + + + + I just love... + Standardflag + + + + Dangerous + Standardflag + + + + This will help + Standardflag + + + + New Map + Heading of mapcenter in new map + + + + Critcal Save error + + QObject diff -r e0f6a21cc6d6 -r 8cdfa8dda71e mainwindow.cpp --- a/mainwindow.cpp Fri Jul 08 08:06:36 2005 +0000 +++ b/mainwindow.cpp Mon Jul 11 19:55:57 2005 +0000 @@ -761,18 +761,18 @@ QAction *a; actionGroupModModes=new QActionGroup ( this, "formatLinkStyles"); actionGroupModModes->setExclusive (true); - a= new QAction( tr( "Use modifier to color branches" ), QPixmap(modecolor_xpm), tr( "Linkstyle Line" ), Key_J, actionGroupModModes, "modModeColor" ); + a= new QAction( tr( "Use modifier to color branches" ), QPixmap(modecolor_xpm), 0, Key_J, actionGroupModModes, "modModeColor" ); a->setToggleAction(true); a->addTo (tb); a->setOn(true); actionModModeColor=a; - a= new QAction( tr( "Use modifier to copy" ), QPixmap(modecopy_xpm), tr( "Linkstyle Line" ), Key_K, actionGroupModModes, "modModeCopy" ); + a= new QAction( tr( "Use modifier to copy" ), QPixmap(modecopy_xpm), 0, Key_K, actionGroupModModes, "modModeCopy" ); a->setToggleAction(true); a->addTo (tb); actionModModeCopy=a; - a= new QAction( tr( "Use modifier to draw links" ), QPixmap(modelink_xpm), tr( "Linkstyle Line" ), Key_L, actionGroupModModes, "modModeLink" ); + a= new QAction( tr( "Use modifier to draw xLinks" ), QPixmap(modelink_xpm), 0, Key_L, actionGroupModModes, "modModeLink" ); a->setToggleAction(true); a->addTo (tb); actionModModeLink=a; @@ -832,7 +832,7 @@ a->addTo( menu ); actionSettingsUseDelKey=a; - a= new QAction( tr( "Use groups in flag toolbars" ), QPixmap(), tr( "Enable flag groups" ), 0, this, "flaggroups" ); + a= new QAction( tr( "Use exclusive flags in flag toolbars" ), QPixmap(), tr( "Enable exclusive flags" ), 0, this, "flaggroups" ); a->setToggleAction(true); a->setOn ( settings.readBoolEntry ("/vym/mapeditor/editmode/useFlagGroups",true) ); a->addTo( menu ); @@ -2375,6 +2375,7 @@ "http:/www.InSilmaril.de/vym" "
  • Credits " "
      " + "
    • Jakob Hilmer for image drag and drop patch
    • " "
    • Thomas Schraitle for the stylesheet used for XHTML-export
    • " "
    • Clemens Kraus for stylesheets and script used for HTML-export " "(www.clemens-kraus.de)
    • " diff -r e0f6a21cc6d6 -r 8cdfa8dda71e mapeditor.cpp --- a/mapeditor.cpp Fri Jul 08 08:06:36 2005 +0000 +++ b/mapeditor.cpp Mon Jul 11 19:55:57 2005 +0000 @@ -2407,9 +2407,9 @@ if (bo->countXLinks()==0) { branchLinksContextMenu->clear(); - branchLinksContextMenu->insertItem ("No link available"); + branchLinksContextMenu->insertItem ("No xLink available"); branchLinksContextMenuDup->clear(); - branchLinksContextMenuDup->insertItem ("No link available"); + branchLinksContextMenuDup->insertItem ("No xLink available"); } else { @@ -3407,6 +3407,7 @@ event->accept(true); return; } + } event->ignore(); @@ -3435,8 +3436,7 @@ } } -void -MapEditor::addFloatImage(const QPixmap &img) +void MapEditor::addFloatImage(const QPixmap &img) { if (selection && (typeid(*selection) == typeid(BranchObj)) || diff -r e0f6a21cc6d6 -r 8cdfa8dda71e tex/vym.tex --- a/tex/vym.tex Fri Jul 08 08:06:36 2005 +0000 +++ b/tex/vym.tex Mon Jul 11 19:55:57 2005 +0000 @@ -69,30 +69,35 @@ 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} +basically {\em can} do the same): +\begin{center} +\begin{tabular}{|p{5.5cm}|p{5.5cm}|} \hline + Left side & Right side \\ \hline + \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} & + \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} \\ \hline +\end{tabular} +\end{center} 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 @@ -118,7 +123,16 @@ %\section{Tutorials} %TODO -\section{Concept} +\subsection{Internet Ressources} +A good starting point to learn more about maps in general is Wikipedia: +\begin{itemize} + \item English: + \href{http://en.wikipedia.org/wiki/Mind_map}{http://en.wikipedia.org/wiki/Mind\_map} + \item German: + \href{http://de.wikipedia.org/wiki/Mindmap}{http://de.wikipedia.org/wiki/Mindmap} +\end{itemize} + +\subsection{Concept of \vym} %TODO may add a general introduction here... @@ -350,8 +364,11 @@ 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 +The easiest way to add an image to a branch is by dragging it e.g. from a +webbrowser to the mapeditor while a branch is selected there. + +You can also add a image to a branch by opening the context menu of the +branch 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 @@ -495,10 +512,9 @@ \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. +use the noteeditor. -\subsubsection*{States} +\subsection{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: @@ -514,12 +530,12 @@ \includegraphics[width=8cm]{branches-flags.png} \end{center} -\subsubsection*{Import and export notes} +\subsection{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} +\subsection{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. @@ -529,7 +545,7 @@ wanted, so there you can convert all paragraphs into linebreaks by using Edit~\ra~Remove~Paragraphs or \key{ALT-X}. -\subsubsection*{Fonts} +\subsection{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{ @@ -551,29 +567,30 @@ 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}. +\subsection{Colors and formatted text} +\vym supports formatted text (QT Rich Text) in the noteeditor since +version 1.4.7. 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} +\subsection{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} +\subsection{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 +\subsection{Advanced actions} +\subsubsection{Edit \ra Convert subsubsections:} +This turns subsubsections 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:} +\subsubsection{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. @@ -713,10 +730,75 @@ choose between {\em Import Add} and {\em Import Replace}: The imported data will be added after the selection resp. replace the selection. -%TODO -%\subsubsection{Menus} -%\subsubsection{Keyboard shortcuts} -%Where does vym save its settings? -> ~/.qt/vymrc + +\section{Advanced Editing} +\vym offers a few shortcuts to let you work more quickly and literally +to connect any branches directly. +\subsection{Modifier Modes} +Modifiers are for example the \key{Shift}- or the \key{Alt}-keys. When +pressed while doing actions with the mouse, they will cause \vym to use +a "modified" action. E.g. you can move branches with mouse. If +\key{Ctrl} or \key{Alt}is pressed while releasing the branch, it will be +added above/below the target, not as child of the target. + +Without a modifier pressed, the first click on a branch just selects +it. For the behaviour of the \key{Ctrl} modifier there are several +options, which can be set from the modifier toolbar: +\begin{center} + \includegraphics[width=3cm]{modmodes.png} +\end{center} +The default is to copy the color from the clicked branch to the already +selected branch. In the toolbar shown above the default modifier is +selected, namely to copy the color of a branch. The second modifier +let's you easily copy a whole branch with a single click. The third +modifier lets you create {\em xLinks}, which will be explained in the +next section. + +\subsection{XLinks} +So far all the data in the \vym map has been treelike. Using xLinks you +can link one branch to any other, just like attaching a rope between two +branches in a real tree. This is especially useful in complex maps, +where you want to have crossreferences which don't fit on the same +visible area, which fits on your screen. The following example, which is +part of the \vym package, 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]{xlink.png} +\end{center} +Note that a xLink which points to a branch that is not visible (because +it is scrolled), is just show as a little horizontal arrow. In the +screenshot above have a look at the \lq Tuesday\rq\ branch. + +\subsubsection{Create a xLink} +Choose the link mode from the modifier toolbar (by clicking or pressing +\key{L}). Select the branch, where the xLink should start. Press the +modifier key \key{Ctr} and simultanously click on the branch where the +link should end. (The link is already drawn before you release the mouse +key). If you release the mouse over a branch the xLink becomes +permanent. + +\subsubsection{Modify or delete a xLink} +Open the context menu of a branch and select \lq Edit xLink\rq. A +submenu contains all the xLinks of the branch (if there are any). They +are named like the branches, where they end. Choose one and +the xLink dialogue opens, where you can set color, width and also delete +the xLink. + +\subsubsection{Follow a xLink} +In a complext \vym map it sometimes comes handy to jump to the other end +of a xLink. You can do this by opening the context menu of the branch +and clicking on \lq Goto xLink\rq and selecting the xLink you want to +follow. + + + +\subsection{Adding and removing links} +The context menu of a branch shows some more ways to add and delete data +e.g. you can delete a branch while keeping its childs. The childs become +linked to the parent of the previously removed branch. +Similar branches can be inserted into existing maps. For keyboard +shortcuts also have a look at the context menu. \section{\vym on Mac OS X} @@ -732,7 +814,29 @@ handling will also be those of the Linux version e.g. The menu bar will look different. -%TODO Concept on Mac context menu, shortcuts... +\subsection {Contextmenu and special keys} +Most Macs unfortunatly just have a single mouse button. In order to show +the context menu which usually would be opened with the right mouse +button, you can click while pressing the \key{kommand}-key. + +Especially on Laptops some of the keys usually used on PC keyboards seem +to be missing. The QT-Mac Edition of \vym has its own keyboard +shortcuts. To find the shortcuts just have a look at all the menu +entries, the shortcut is visible next to an entry. Toolbar buttons also +may have shortcuts, just position the mouse pointer over a button and +wait for the little help window to appear. + +\subsection {Viewing external links} +\vym on Mac uses the system call {\tt /usr/bin/open} to view links. +Mac~OS determines automatically if the link is a pdf or www page and +opens the right browser. + +\subsection{Compiling \vym on Macs} +Please refer to the documentation available on the internet: +\begin{center} +\href{http://www.InSilmaril.de/vym/faq.html}{http://www.InSilmaril.de/vym/faq.html} +\end{center} +\end{document} \section{History of \vym} \subsection{Future} @@ -971,6 +1075,11 @@ \end{longtable} \end{center} +%TODO +%\subsubsection{Menus} +%\subsubsection{Keyboard shortcuts} +%Where does vym save its settings? -> ~/.qt/vymrc + % INDEX % mapeditor @@ -994,9 +1103,10 @@ % fold % vymlink % xlink +% modMode % context menu % Mac OS X -\end{document} \ No newline at end of file +\end{document} diff -r e0f6a21cc6d6 -r 8cdfa8dda71e version.h --- a/version.h Fri Jul 08 08:06:36 2005 +0000 +++ b/version.h Mon Jul 11 19:55:57 2005 +0000 @@ -1,7 +1,7 @@ #ifndef VERSION_H #define VERSION_H -#define __VYM_VERSION__ "1.6.9" -#define __BUILD_DATE__ "July 04, 2005" +#define __VYM_VERSION__ "1.6.10" +#define __BUILD_DATE__ "July 11, 2005" #endif