
insilmaril@764: %% LyX 1.6.2 created this file.  For more info, see http://www.lyx.org/.
insilmaril@719: %% Do not edit unless you really know what you are doing.
insilmaril@719: \documentclass[12pt,french,a4paper]{article}
insilmaril@719: \usepackage[T1]{fontenc}
insilmaril@719: \usepackage[utf8]{inputenc}
insilmaril@719: \setcounter{secnumdepth}{2}
insilmaril@719: \setcounter{tocdepth}{2}
insilmaril@719: \usepackage{array}
insilmaril@719: \usepackage{graphicx}
insilmaril@719: 
insilmaril@719: \makeatletter
insilmaril@719: 
insilmaril@719: %%%%%%%%%%%%%%%%%%%%%%%%%%%%%% LyX specific LaTeX commands.
insilmaril@719: %% Special footnote code from the package 'stblftnt.sty'
insilmaril@719: %% Author: Robin Fairbairns -- Last revised Dec 13 1996
insilmaril@719: \let\SF@@footnote\footnote
insilmaril@719: \def\footnote{\ifx\protect\@typeset@protect
insilmaril@719:     \expandafter\SF@@footnote
insilmaril@719:   \else
insilmaril@719:     \expandafter\SF@gobble@opt
insilmaril@719:   \fi
insilmaril@719: }
insilmaril@719: \expandafter\def\csname SF@gobble@opt \endcsname{\@ifnextchar[%]
insilmaril@719:   \SF@gobble@twobracket
insilmaril@719:   \@gobble
insilmaril@719: }
insilmaril@719: \edef\SF@gobble@opt{\noexpand\protect
insilmaril@719:   \expandafter\noexpand\csname SF@gobble@opt \endcsname}
insilmaril@719: \def\SF@gobble@twobracket[#1]#2{}
insilmaril@719: %% Because html converters don't know tabularnewline
insilmaril@719: \providecommand{\tabularnewline}{\\}
insilmaril@719: 
insilmaril@719: %%%%%%%%%%%%%%%%%%%%%%%%%%%%%% User specified LaTeX commands.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \usepackage{hyperref}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: %\usepackage{longtable}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \setlength{\headheight}{0cm}
insilmaril@719: \setlength{\headsep}{0cm}
insilmaril@719: \setlength{\topskip}{0cm}
insilmaril@719: \setlength{\topmargin}{-0.5cm}
insilmaril@719: 
insilmaril@719: \setlength{\parskip}{1.5ex}
insilmaril@719: \setlength{\parindent}{0cm}
insilmaril@719: \setlength{\oddsidemargin}{0cm}
insilmaril@719: \setlength{\textwidth}{16cm}
insilmaril@719: \setlength{\textheight}{27cm}
insilmaril@719: 
insilmaril@719: \newlength{\maximgwidth}
insilmaril@719: \setlength{\maximgwidth}{14cm}
insilmaril@719: \newcommand{\maximage}[1]{	
insilmaril@719: \begin{center}
insilmaril@719: \includegraphics[width=\maximgwidth]{#1} 
insilmaril@719: \end{center}
insilmaril@719: }
insilmaril@719: \newcommand{\hint}[1]{
insilmaril@719: \begin{center} 
insilmaril@719: \begin{tabular}{|rp{12cm}|} \hline
insilmaril@719: {\bf Astuce }:& #1\\	\hline
insilmaril@719: \end{tabular}
insilmaril@719: \marginpar{\Huge !} 
insilmaril@719: \end{center} 
insilmaril@719: }
insilmaril@719: 
insilmaril@719: \newcommand{\vym}{{\sc vym }}
insilmaril@719: \newcommand{\ra}{$\longrightarrow$}
insilmaril@719: \newcommand{\la}{$\longleftarrow$}
insilmaril@719: \newcommand{\ua}{$\uparrow$}
insilmaril@719: \newcommand{\da}{$\downarrow$}
insilmaril@719: \newcommand{\key}[1]{[#1]}
insilmaril@719: 
insilmaril@719: %\newenvironment{code}[1]{ \verbatim #1}{\endverbatim  }
insilmaril@719: 
insilmaril@719: \hypersetup{bookmarks, bookmarksopen,
insilmaril@719:   pdftitle={VYM - a tool for visual thinking },
insilmaril@719:   pdfauthor={Uwe Drechsel},    
insilmaril@719:   pdfsubject={map},
insilmaril@719:   pdfkeywords={map, tool},
insilmaril@719:   pdfpagemode={UseOutlines},                                 
insilmaril@719:   bookmarksopenlevel={1},   
insilmaril@719:   colorlinks={true},     
insilmaril@719:   linkcolor={blue},
insilmaril@719:   urlcolor={green},
insilmaril@719:   citecolor={red}} 
insilmaril@719: 
insilmaril@764: \makeatother
insilmaril@764: 
insilmaril@719: \usepackage{babel}
insilmaril@719: \addto\extrasfrench{\providecommand{\og}{\leavevmode\flqq~}\providecommand{\fg}{\ifdim\lastskip>\z@\unskip\fi~\frqq}}
insilmaril@719: 
insilmaril@719: \begin{document}
insilmaril@719: 
insilmaril@764: \title{\includegraphics[width=8cm,bb = 0 0 200 100, draft, type=eps]{images/vym-logo-new.png}
insilmaril@764: \\
insilmaril@719:  VYM \\
insilmaril@719:  -- \\
insilmaril@719: View Your Mind\\
insilmaril@764:  {\small Version 1.12.0}\\
insilmaril@719: {\small (version française)}}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \author{\textcopyright Uwe Drechsel }
insilmaril@719: 
insilmaril@719: \maketitle
insilmaril@719: \newpage{}
insilmaril@719: 
insilmaril@719: \tableofcontents{}
insilmaril@719: 
insilmaril@719: \newpage{}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \section*{Remerciements}
insilmaril@719: 
insilmaril@719: Beaucoup de gens m'ont envoyé leurs impressions et leurs idées et
insilmaril@719: tout cela m'a aidé à faire \vym meilleur. Merci à tous !
insilmaril@719: 
insilmaril@719: Pour ce manuel, je remercie particulièrement :
insilmaril@719: \begin{itemize}
insilmaril@719: \item {\em Peter Adamson} pour un grand nombre de retours et pour la
insilmaril@719: relecture de mon anglais très imparfait,
insilmaril@719: \item L'équite du {\em AClibre (Academia y Conocimiento Libre)} en Colombie
insilmaril@719: pour leur traduction du manuel en espagnol : 
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \begin{center}
insilmaril@719: \begin{tabular}{|p{7cm}|p{5.5cm}|}
insilmaril@719: \hline 
insilmaril@719: Encargado  & Actividad \tabularnewline
insilmaril@719: \hline 
insilmaril@719: \begin{itemize}
insilmaril@719: \item Vanessa Carolina Gutiérrez Sanchez 
insilmaril@719: \item Erika Tatiana Luque Melo 
insilmaril@719: \item Jeffrey Steve Borbón Sanabria 
insilmaril@719: \item John Edisson Ortiz Román 
insilmaril@719: \end{itemize}
insilmaril@719:  & \begin{itemize}
insilmaril@719: \item Traducciónl 
insilmaril@719: \item Revisión y correcciones varias 
insilmaril@719: \item Estructuración y exporte 
insilmaril@719: \item Revisión y correcciones varias 
insilmaril@719: \end{itemize}
insilmaril@719: \tabularnewline
insilmaril@719: \hline
insilmaril@719: \end{tabular}
insilmaril@719: \par\end{center}
insilmaril@719: 
insilmaril@719: \end{itemize}
insilmaril@719: \newpage{}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \section*{Note du traducteur}
insilmaril@719: 
insilmaril@719: Correspondances entre les mots de la version originale en anglais
insilmaril@719: et la version française. Certains mots trop spécifiques à \vym  ont
insilmaril@719: été gardés en anglais.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection*{traduits}
insilmaril@719: \begin{description}
insilmaril@719: \item [{ancre}] \emph{anchor }
insilmaril@719: \item [{canevas}] \emph{layout }
insilmaril@719: \item [{carte}] \emph{map }
insilmaril@719: \item [{défaire/refaire}] \emph{undo/redo }
insilmaril@719: \item [{emoticon}] \emph{smiley }
insilmaril@719: \item [{escamotage}] \emph{folding }
insilmaril@719: \item [{fils}] \emph{child }
insilmaril@719: \item [{indicateur}] \emph{flag }
insilmaril@719: \item [{menu~de~contexte}] \emph{context menu} 
insilmaril@719: \item [{menu~des~préférences}] \emph{settings menu }
insilmaril@719: \item [{mode~modificateur}] \emph{modifier (CTRL) }
insilmaril@719: \item [{navigateur}] \emph{webbrowser }
insilmaril@719: \item [{onglets}] \emph{bookmark }
insilmaril@719: \item [{patrons}] \emph{frame }
insilmaril@719: \item [{titre}] \emph{heading }
insilmaril@719: \item [{signets}] \emph{bookmark }
insilmaril@719: \item [{sous-arbre}] \emph{jeu de branches en dessous}
insilmaril@719: \item [{barre~de~travail}] \emph{toolbars}
insilmaril@719: \end{description}
insilmaril@719: 
insilmaril@719: \subsection*{non traduits}
insilmaril@719: \begin{description}
insilmaril@719: \item [{mapeditor}] fenêtre d'édition de la carte 
insilmaril@719: \item [{mapcenter}] milieu du mapeditor 
insilmaril@719: \item [{noteeditor}] fenêtre d'édition des notes
insilmaril@719: \item 
insilmaril@719: \end{description}
insilmaril@719: \clearpage 
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \section{Introduction}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Qu'est-ce qu'une carte \vym ?}
insilmaril@719: 
insilmaril@719: Une carte \vym (on abrégera sous le nom de {\em carte}) est une
insilmaril@719: structure en forme d'arbre : \maximage{images/example1_fr.png}
insilmaril@719: De telles cartes peuvent être faites à la main sur une feuille de
insilmaril@719: papier ou en brouillon et aident à structurer vos pensées. Alors qu'une
insilmaril@719: structure en forme d'arbre comme sur l'image ci-dessus peut être tracée
insilmaril@719: à la main, \vym offre des possibilités supplémentaires.
insilmaril@719: 
insilmaril@719: \vym n'est pas un logiciel de dessin supplémentaire, mais un outil
insilmaril@719: pour mémoriser et modifier l'information de façon intuitive. Par exemple,
insilmaril@719: vous pouvez réorganiser des parties de la carte en appuyant sur une
insilmaril@719: touche ou ajouter des informations comme un email complet simplement
insilmaril@719: par un clic de souris.
insilmaril@719: 
insilmaril@719: Un fois que vous avez fini de rassembler et d'organiser vos idées
insilmaril@719: vous pouvez générer des sorties ---basées sur une {\em carte}---
insilmaril@719: sous divers formats incluant une présentation dans Open-Office.
insilmaril@719: 
insilmaril@719: \hint{Vous trouverez la carte ci-dessus et les autres en cliquant
insilmaril@719: :
insilmaril@719: 
insilmaril@719: \begin{center}
insilmaril@719: Help \ra Open vym examples 
insilmaril@719: \par\end{center}
insilmaril@719: 
insilmaril@719: dans la barre de menu.}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Pourquoi utiliser des {\em cartes}? l'Espace, le Temps et votre
insilmaril@719: cerveau}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Espace}
insilmaril@719: 
insilmaril@719: Une {\em carte} peut concentrer un contenu très complexe sur un
insilmaril@719: petit espace comme une feuille de papier. Cela aide les deux côtés
insilmaril@719: de votre cerveau : le côté logique et le côté créatif (par exemple
insilmaril@719: en utilisant des dessins, des couleurs et des mots clé, souvent appelés
insilmaril@719: {\em ancres}. C'est une technique pour aider à organiser votre
insilmaril@719: façon de penser et stimuler votre créativité : cela vous aide en développant,
insilmaril@719: classant et mémorisant vos idées.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Temps}
insilmaril@719: 
insilmaril@719: Parce que vous utilisez des mots clé et des dessins, c'est plus rapide
insilmaril@719: que les bonnes vieilles \og notes \fg. Votre cerveau mémorise les
insilmaril@719: choses par association avec d'autres choses -- une {\em carte}
insilmaril@719: utilise ces connexions et stimule de nouvelles associations.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Votre cerveau}
insilmaril@719: 
insilmaril@719: En 1960 le professeur \textsc{Roger Sperry} découvre que les deux
insilmaril@719: hémisphères du cerveau humain s'occupent de domaines différents mais
insilmaril@719: {\em peuvent } faire les mêmes choses : 
insilmaril@719: 
insilmaril@719: \begin{center}
insilmaril@719: \begin{tabular}{|p{5.5cm}|p{5.5cm}|}
insilmaril@719: \hline 
insilmaril@719: Côté gauche  & Côté droit\tabularnewline
insilmaril@719: \hline 
insilmaril@719: \begin{itemize}
insilmaril@719: \item expression verbale et écrite,
insilmaril@719: \item nombres,
insilmaril@719: \item pensée logique, 
insilmaril@719: \item analyse et détails,
insilmaril@719: \item science,
insilmaril@719: \item pensée linéaire,
insilmaril@719: \item concept de temps.
insilmaril@719: \end{itemize}
insilmaril@719:  & \begin{itemize}
insilmaril@719: \item langage du corps, 
insilmaril@719: \item pensée visuelle, rêves éveillés,
insilmaril@719: \item intuition et émotion,
insilmaril@719: \item capacité de synthèse,
insilmaril@719: \item créativité,
insilmaril@719: \item art, musique, danse, 
insilmaril@719: \item pensée non linéaire, relation entre les choses,
insilmaril@719: \item conscience spatiale.
insilmaril@719: \end{itemize}
insilmaril@719: \tabularnewline
insilmaril@719: \hline
insilmaril@719: \end{tabular}
insilmaril@719: \par\end{center}
insilmaril@719: 
insilmaril@719: Dans notre société des sciences occidentales, nous avons appris à
insilmaril@719: relier principalement le côté gauche de notre cerveau, le côté \og
insilmaril@719: rationel \fg{}. Dans d'autres cultures, comme celles des vieilles
insilmaril@719: cultures indiennes ou d'autres \og vieilles\fg{} cultures, l'autre
insilmaril@719: côté (le droit) est plus important. Les {\em cartes} sont juste
insilmaril@719: un moyen de stimuler l'autre coté et d'utiliser les capacités supplémentaires
insilmaril@719: dont nous disposons tous.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Où puis-je utiliser une {\em carte}?}
insilmaril@719: 
insilmaril@719: Voici quelques exemples et comment vous pouvez utiliser ces {\em
insilmaril@719: cartes} : 
insilmaril@719: \begin{itemize}
insilmaril@719: \item pour préparer des articles, des papiers, des livres, des discussions,
insilmaril@719: etc, 
insilmaril@719: \item pour trier des idées complexes, 
insilmaril@719: \item pour mémoriser des faits, des noms de personnes, du vocabulaire, etc, 
insilmaril@719: \item pour trier des emails, des fichiers et les signets de votre ordinateur, 
insilmaril@719: \item la préparation d'un exposé, 
insilmaril@719: \item des séances de remue-méninges pour résoudre des problèmes, 
insilmaril@719: \item pour enregistrer les tâches lors de l'organisation d'un projet. 
insilmaril@719: \end{itemize}
insilmaril@719: 
insilmaril@719: \subsection{Ce que vous ne pouvez pas faire avec une {\em carte}...}
insilmaril@719: 
insilmaril@719: Une {\em carte} tracée par quelqu'un montre la façon de penser
insilmaril@719: de son auteur. Elle n'a pas à être juste ou fausse, elle n'est pas
insilmaril@719: criticable.\og C'est ce que c'est \fg{}(\textsc{F.~Lehmann}).
insilmaril@719: L'outil est d'une très utile à son créateur mais d'un usage très limité
insilmaril@719: pour les autres.
insilmaril@719: 
insilmaril@719: Cependant quand un groupe s'investit dans la création d'une {\em
insilmaril@719: carte}, tout le groupe bénéficie de son utilisation. Quand un professeur
insilmaril@719: développe une {\em carte} avec un groupe d'élèves pendant un cours
insilmaril@719: ou quand un chef de projet recueille les informations d'un groupe
insilmaril@719: de spcialistes pour l'aider à \og{}{\em encarter}\fg{} les
insilmaril@719: tâches nécessaires pour réaliser ce projet.
insilmaril@719: 
insilmaril@719: %\section{Tutorials}
insilmaril@719: %TODO
insilmaril@719: 
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Ressources internet}
insilmaril@719: 
insilmaril@719: Un bon point de départ est d'en apprendre plus sur les {\em cartes
insilmaril@719: heuristiques} dans Wikipedia : 
insilmaril@719: \begin{itemize}
insilmaril@719: \item Anglais : \href{http://en.wikipedia.org/wiki/Mind_map}{http://en.wikipedia.org/wiki/Mind\_map} 
insilmaril@719: \item Allemand : \href{http://de.wikipedia.org/wiki/Mindmap}{http://de.wikipedia.org/wiki/Mindmap} 
insilmaril@719: \item Français : \href{http://fr.wikipedia.org/wiki/Mindmap}{http://fr.wikipedia.org/wiki/Mindmap}
insilmaril@719: (N.d.T.)
insilmaril@719: \end{itemize}
insilmaril@719: 
insilmaril@719: \section{Le Concept de \vym }
insilmaril@719: 
insilmaril@719: %TODO may add a general introduction here...
insilmaril@719: 
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{La fenêtre principale et ses satellites}
insilmaril@719: 
insilmaril@719: \label{satellite} \vym vient avec plusieurs fenêtres, celle centrale
insilmaril@719: est le {\em mapeditor}. D'autres fenêtres, chacune avec une fonction
insilmaril@719: particulière peut être ouverte et installée à côté de la fenêtre principale%
insilmaril@719: \footnote{L'avantage des fenêtres séparées par rapport à une seule est une plus
insilmaril@719: grande flexibilité dans leur position. Par exemple j'utilise le {\em
insilmaril@719: noteeditor} \og derrière \fg{} le {\em mapeditor}. Sur Linux
insilmaril@719: mon gestionnaire de fenêtres (KDE) me permet de rentrer du texte dans
insilmaril@719: un petit coin visible du {\em noteeditor} sans cliquer dessus avec
insilmaril@719: la souris. Je positionne la souris sur la fenêtre pour y concentrer
insilmaril@719: le focus, un concept utile aussi lorsqu'on travaille avec \href{http://www.gimp.org}{http://www.gimp.org}. %
insilmaril@719: }. L'image en dessous montre le {\em mapeditor} avec le {\em noteeditor} souvent
insilmaril@719: utilisé : \maximage{images/windows_fr.png} La plupart du temps
insilmaril@719: vous travaillerez dans le {\em mapeditor} en ajoutant des nouvelles
insilmaril@719: branches, en les déplaçant et en les réarrangeant. Les diverses manières
insilmaril@719: de le faire sont expliquées dans \ref{mapeditor}. Vous pouvez enregistrer
insilmaril@719: des informations complémentaires par exemple le contenu d'un email
insilmaril@719: facilement dans une {\em branche}: copiez et collez dans le {\em
insilmaril@719: noteeditor}. La façon de travailler avec des notes est expliqué dans
insilmaril@719: \ref{noteeditor}.
insilmaril@719: 
insilmaril@719: Les fenêtres auxiliaires sont : 
insilmaril@719: \begin{itemize}
insilmaril@719: \item Noteeditor (voir \ref{noteeditor}) 
insilmaril@719: \item Fenêtre historique (voir \ref{historywindow}) 
insilmaril@719: \item Fenêtre des propriétés des branches (voir \ref{propwindow}) 
insilmaril@719: \end{itemize}
insilmaril@719: 
insilmaril@719: \subsection{Menus et menus de contexte}
insilmaril@719: 
insilmaril@719: En haut de chaque fenêtre se trouve la barre de menus. Certaines options
insilmaril@719: sont sans doute similaires à celles d'autres applications. Notez que
insilmaril@719: beaucoup (et sans doute plus) sont disponibles à travers les {\em
insilmaril@719: menus de contexte}. Ceux-ci sont disponibles si vous appuyez sur
insilmaril@719: bouton droite de la souris en pointant un objet (sur Mac~OS~X Command-Click).
insilmaril@719: 
insilmaril@719: 
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Barres de travail}
insilmaril@719: 
insilmaril@719: Les barres de travail dans les fenêtres permettent un accès rapide
insilmaril@719: à beaucoup de fonctions et affichent l'état des objets sélectionnés
insilmaril@719: dans la carte. Par exemple une branche peut avoir certains {\em
insilmaril@719: indicateurs} positionnés, ils sont aussi positionnés dans la barre
insilmaril@719: de travail.
insilmaril@719: 
insilmaril@719: \hint{Vous pouvez repositionner toutes les barres de travail en les
insilmaril@719: déplaçant simplement par la poignée. Par exemple vous pouvez déplacer
insilmaril@719: le menu de travail des indicateurs de sa position d'origine en haut
insilmaril@719: du mapeditor pour une position verticale sur le côté droit, ou le
insilmaril@719: remettre dans sa position originale. Il est possible de cacher certains
insilmaril@719: menus de travail en pointant sa poignée et en cliquant sur le bouton
insilmaril@719: droit de la souris.}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Cartes}
insilmaril@719: 
insilmaril@719: Chaque {\em carte} a son centre {\em mapcenter}. Ce centre a
insilmaril@719: des branches partant dans tous les sens comme celles d'un arbre. Chaque
insilmaril@719: branche peut aussi avoir d'autres branches. \maximage{images/branches_fr.png}
insilmaril@719: Nous appellerons un branche directement connectée au mapcenter une
insilmaril@719: {\em branche principale} car elle détermine la position des autres
insilmaril@719: branches \og fils \fg{}.
insilmaril@719: 
insilmaril@719: Le mapcenter et les branches ont un {\em titre}. C'est le texte
insilmaril@719: que vous voyez dans le mapeditor. C'est ordinairement un ou plusieurs
insilmaril@719: mots clé, permettant de comprendre facilement toute la carte.
insilmaril@719: 
insilmaril@719: Dans la barre de menus au-dessous du  mapeditor on voit des symboles
insilmaril@719: variés. \maximage{images/default-flags.png} Nous les appellerons
insilmaril@719: {\em indicateurs}. Ils sont utilisés pour marquer les branches
insilmaril@719: dans la {\em carte}, par exemple si quelque chose est important
insilmaril@719: ou douteux. Il y a aussi des indicateurs positionnés automatiquement
insilmaril@719: par \vym pour des informations supplémentaires, par exemple qu'une
insilmaril@719: note est attachée à une branche particulière.
insilmaril@719: 
insilmaril@719: Par défaut certains de ces indicateurs sont affichés uniquement quand
insilmaril@719: l'indicateur \og pouce vers le haut \fg{} est positionné. Ils ne
insilmaril@719: le sont plus lorsque l'indicateur \og pouce en bas \fg{} est positionné.
insilmaril@719: Vous pouvez changer ce comportement par défaut dans le menu des préférences
insilmaril@719: (voir \ref{settings}).
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \section{Mapeditor}
insilmaril@719: 
insilmaril@719: \label{mapeditor} 
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Commencer une nouvelle carte}
insilmaril@719: 
insilmaril@719: Au démarrage de \vym deux fenêtres vont s'ouvrir : le {\em mapeditor}
insilmaril@719: et le {\em noteditor}. Vous travaillerez avec les deux fenêtres
insilmaril@719: mais pour l'instant nous n'avons besoin que du mapeditor.
insilmaril@719: 
insilmaril@719: Sélectionner le milieu de la carte \og NEW MAP \fg{} dans le milieu
insilmaril@719: du mapeditor en cliquant le bouton gauche de la souris. Il va s'allumer
insilmaril@719: en jaune pour montrer qu'il est sélectionné. Il y a plusieurs moyens
insilmaril@719: d'ajouter une nouvelle branche au centre :
insilmaril@719: \begin{itemize}
insilmaril@719: \item avec la souris : ouvrir le menu du contexte en cliquant le bouton
insilmaril@719: droit de la souris (CTRL-Click sur Mac) sur le milieu de la carte
insilmaril@719: et choisir \og Add\ra Add branch as child \fg{} (ajouter une branche
insilmaril@719: comme fils).
insilmaril@719: \item Appuyer sur les touches \key{Ins} ou \key{A} 
insilmaril@719: \end{itemize}
insilmaril@719: Une nouvelle branche va apparaître et vous pouvez taper le titre de
insilmaril@719: la branche. Terminer l'ajout en appuyant sur \key{Enter}. %tipp
insilmaril@719: Quelquefois il est pratique d'ajouter une nouvelle branche au-dessus
insilmaril@719: ou au-dessous de la branche courante en faisant au choix :
insilmaril@719: \begin{itemize}
insilmaril@719: \item Touche \key{Shift-A} pour ajouter un branche au-dessus de celle
insilmaril@719: sélectionnée,
insilmaril@719: \item Touche \key{Ctrl-A} pour ajouter une branche en dessous.
insilmaril@719: \end{itemize}
insilmaril@719: Il est aussi possible d'ajouter une branche qui soit le \og père \fg{}
insilmaril@719: de la branche courante, c'est à dire insérer {\em devant}  la branche
insilmaril@719: courante. Cela peut-être fait par le menu de contexte.
insilmaril@719: 
insilmaril@719: \hint{Pour effacer une branche appuyer sur \key{CTRL-X}. Si cela
insilmaril@719: est validé dans le menu des préférences (voir \ref{settings}), vous
insilmaril@719: pouvez aussi utiliser la touche \key{Del}.}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Circuler dans une carte}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Sélectionner des branches}
insilmaril@719: 
insilmaril@719: Pour sélectionner des branches vous pouvez utiliser le bouton gauche
insilmaril@719: de la souris ou les flèches de direction. Suivant l'{\em orientation}
insilmaril@719: du départ de la branche utiliser la touche \key{\la} ou \key{\ra}
insilmaril@719: pour se déplacer plus près de la racine ou plus profondément dans
insilmaril@719: les branches. Dans un jeu de branches que nous appellerons {\em
insilmaril@719: sous-arbre}, vous pouvez utiliser \key{\ua} et \key{\da} pour
insilmaril@719: monter et descendre. Vous pouvez aussi utilisez \key{Home} et \key{End}
insilmaril@719: pour sélectionner la première ou la dernière branche.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Déplacer la partie visible de la carte}
insilmaril@719: 
insilmaril@719: À force d'ajouter des branches, la carte peut devenir plus grande
insilmaril@719: que la fenêtre du mapeditor. Vous pouvez utiliser les ascenseurs à
insilmaril@719: droite et en bas de la fenêtre pour déplacer la vue. C'est plus facile
insilmaril@719: en utilisant le bouton gauche de la souris. Cliquez n'importe où sur
insilmaril@719: la {\em surface active de la fenêtre} : choisissez un espace libre
insilmaril@719: entre des branches. Le pointeur de la souris va se transformer en
insilmaril@719: main, maintenant déplacez la souris pour voir la partie désirée.
insilmaril@719: 
insilmaril@719: Si vous sélectionnez les branches en utilisant les flèches, la carte
insilmaril@719: va se déplacer pour que la branche sélectionnée soit toujours visible.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Zoomer la carte}
insilmaril@719: 
insilmaril@719: Lorsqu'on travaille sur des grandes cartes, la fonction {\em zoom}
insilmaril@719: devient pratique. Vous pouvez utiliser :
insilmaril@719: \begin{itemize}
insilmaril@719: \item à partir du menu : View \ra Zoom in, View \ra Zoom out, View \ra
insilmaril@719: reset Zoom. 
insilmaril@764: \item la barre de fonction~\includegraphics[width=3cm,bb = 0 0 200 100, draft, type=eps]{images/zoom-buttons.png} 
insilmaril@719: \end{itemize}
insilmaril@719: Cliquer sur la loupe avec la croix rouge ré-affiche la carte à sa
insilmaril@719: taille originale.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Fonction de recherche}
insilmaril@719: 
insilmaril@719: \label{findwindow} Avec une grande carte, une fonction de recherche
insilmaril@719: devient nécessaire. Ouvrir la fenêtre de recherche :
insilmaril@719: 
insilmaril@719: \begin{center}
insilmaril@764: \includegraphics[width=6cm,bb = 0 0 200 100, draft, type=eps]{images/find-window.png} 
insilmaril@719: \par\end{center}
insilmaril@719: 
insilmaril@719: La fonction va rechercher le texte dans toutes les branches et dans
insilmaril@719: les notes associées. À chaque fois que vous appuyez sur le bouton
insilmaril@719: \og Find \fg{} il va rechercher la prochaine occurrence qui est
insilmaril@719: sélectionnée automatiquement. Si la recherche échoue, un court mess
insilmaril@719: sage \og Nothing found \fg{} (rien trouvé) va apparaître en bas
insilmaril@719: dans la {\em barre de status} du mapeditor.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{\label{hideunselected}Garder la visibilité, cacher une partie de
insilmaril@719: la carte}
insilmaril@719: 
insilmaril@719: Une très grande arborescence (une branche avec une centaine d'enfants
insilmaril@719: par exemple) rend difficile la vue d'ensemble de la carte. Vous pouvez
insilmaril@719: cacher les enfants en les {\em enroulant}. Cette fonction est souvent
insilmaril@719: appelée {\em escamotage} (folding). Pensez que tout le sous-arbre
insilmaril@719: est dessiné sur un rouleau de papier. Vous pouvez le dérouler ou l'enrouler
insilmaril@719: pour ne voir que la première ligne.
insilmaril@719: 
insilmaril@719: Pour escamoter ou ré-afficher une branche et ses fils vous pouvez
insilmaril@719: au choix : 
insilmaril@719: \begin{itemize}
insilmaril@719: \item appuyez sur \key{Scroll Lock} ou \key{S},
insilmaril@719: \item appuyer sur le bouton milieu de la souris,
insilmaril@719: \item choisir l'icône sur le menu de travail.
insilmaril@719: \end{itemize}
insilmaril@719: Si vous sélectionnez une branche cachée --par la fonction de recherche
insilmaril@719: ou en utilisant les flèches de direction par exemple-- elle va devenir
insilmaril@719: provisoirement visible. Cela est montré comme un défilement avec une
insilmaril@719: petite loupe. Si la partie \og dé-cachée \fg{} n'est plus nécessaire,
insilmaril@719: elle est de nouveau cachée automatiquement. Il est possible de rendre
insilmaril@719: toutes les branches visibles en utilisant le menu \og Edit\ra Unscroll
insilmaril@719: all scrolled branches \fg{}.
insilmaril@719: 
insilmaril@719: Vous pouvez cacher des parties de la carte pour l'exporter dans une
insilmaril@719: page web ou pour une présentation par exemple voir \ref{hideexport}
insilmaril@719: pour plus de détails.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Modifier et déplacer les branches}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Modifier le titre}
insilmaril@719: 
insilmaril@719: On peut éditer le titre en sélectionnant la branche puis au choix
insilmaril@719: :
insilmaril@719: \begin{itemize}
insilmaril@719: \item appuyer sur \key{Enter} 
insilmaril@719: \item ou \key{F2} 
insilmaril@719: \item faire un double clic avec le bouton gauche de la souris.
insilmaril@719: \end{itemize}
insilmaril@719: Écrivez votre nouveau titre (ou éditez le) puis appuyez sur \key{Enter}
insilmaril@719: pour valider.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Déplacer une branche}
insilmaril@719: 
insilmaril@719: Le moyen le plus simple de déplacer une branche est de la sélectionner
insilmaril@719: avec le bouton gauche de la souris et de la déplacer à sa destination
insilmaril@719: en maintenant le bouton enfoncé. Suivant la branche elle sera :
insilmaril@719: \begin{itemize}
insilmaril@719: \item déplacée vers la destination,
insilmaril@719: \item {\em liée } à un nouveau {\em parent} (mapcenter ou branche) 
insilmaril@719: \end{itemize}
insilmaril@719: Si vous déplacez la branche au dessus d'une autre ou du mapcenter,
insilmaril@719: vous pourrez constater que le lien le connectant à l'ancien parent
insilmaril@719: va être changé pour aller au nouveau situé sous le curseur de la souris.
insilmaril@719: Si vous relâchez alors le bouton, la branche va être reliée.
insilmaril@719: 
insilmaril@719: Si vous relâchez le bouton n'importe où, le résultat dépendra du type
insilmaril@719: de branche que vous déplacez :
insilmaril@719: \begin{itemize}
insilmaril@719: \item Une branche principale directement connectée au mapcenter. Il va rester
insilmaril@719: à sa nouvelle position,
insilmaril@719: \item Une autre branche \og ordinaire \fg{} va rejoindre sa position d'origine.
insilmaril@719: \end{itemize}
insilmaril@719: Vous pouvez ainsi facilement réarranger la disposition des branches
insilmaril@719: principales pour qu'elles ne recouvrent pas leurs branches filles.
insilmaril@719: Il y a un autre avantage à déplacer les branches, surtout si vous
insilmaril@719: voulez {\em réorganiser} un sous-arbre. Vous pouvez monter ou descendre
insilmaril@719: une branche par l'action suivante au choix :
insilmaril@719: \begin{itemize}
insilmaril@719: \item appuyer sur \key{Page Up} ou \key{Page Down},
insilmaril@719: \item sélectionner Edit \ra Move branch,
insilmaril@764: \item appuyer sur les icônes de la barre de menu : \includegraphics[width=1.5cm,bb = 0 0 200 100, draft, type=eps]{images/move-buttons.png} 
insilmaril@719: \end{itemize}
insilmaril@719: %tipp
insilmaril@719: Il y a un autre moyen de déplacer des branches : si vous appuyez sur
insilmaril@719: \key{Shift} or \key{Ctrl} en bougeant la souris, la branche va
insilmaril@719: être ajoutée au-dessus ou au-dessous de la branche sur laquelle la
insilmaril@719: souris est. Cela peut être utilisé pour classer les branches dans
insilmaril@719: une carte.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Des couleurs et des images : utiliser le côté droit de votre cerveau}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Changer la couler d'un titre}
insilmaril@719: 
insilmaril@719: Vous pouvez utiliser des couleurs pour mettre plus d'informations
insilmaril@719: sur la carte par exemple mettre du rouge, du vert et d'autres couleurs
insilmaril@719: pour montrer la priorité des tâches. Pour ce faire : 
insilmaril@719: \begin{itemize}
insilmaril@719: \item utiliser le menu et choisir : Format \ra Set Color 
insilmaril@719: \item utiliser la barre de menu :
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \begin{center}
insilmaril@764: \includegraphics[width=3cm,bb = 0 0 200 100, draft, type=eps]{images/color-buttons.png} 
insilmaril@719: \par\end{center}
insilmaril@719: 
insilmaril@719: \end{itemize}
insilmaril@719: Le premier bouton (noir dans la figure ci-dessus) montre la couleur
insilmaril@719: courante. Cliquer dessus vous permet de choisir une autre couleur.
insilmaril@719: Vous pouvez \og piquer \fg{} la couleur d'une autre branche en la
insilmaril@719: sélectionnant et en utilisant le bouton \og pipette \fg{}. Les deux
insilmaril@719: icônes avec une palette colorent la branche sélectionnée avec la couleur
insilmaril@719: courante. Alors que la première ne colore que la sélection, la deuxième
insilmaril@719: colore tous les fils de la branche sélectionnée.
insilmaril@719: 
insilmaril@719: %tipp
insilmaril@719: Une autre fonction très utile est le \og copier couleur \fg{} en
insilmaril@719: utilisant la souris : sélectionner une branche qui doit avoir la nouvelle
insilmaril@719: couleur appuyez \key{Ctrl} et simultanément cliquez avec le bouton
insilmaril@719: gauche sur une autre branche pour copier sa couleur dans la branche
insilmaril@719: sélectionnée. Tout le sous-arbre sera coloré. Si vous ne voulez colorer
insilmaril@719: que la sélection appuyez sur \key{Shift} au lieu de \key{Ctrl}.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Utiliser les indicateurs}
insilmaril@719: 
insilmaril@719: \vym possède des indicateurs variés. Ils sont visibles dans la barre
insilmaril@719: de menu en haut de la mapeditor. (Note : Comme toutes les barres de
insilmaril@719: menu, vous pouvez les déplacer sur le côté droit ou gauche ou même
insilmaril@719: les détacher. Prenez la ligne pointillée à gauche de la barre de menu
insilmaril@719: avec le bouton gauche de la souris.) \maximage{images/default-flags.png}
insilmaril@719: Si vous avez une branche sélectionnée, vous pouvez positionner n'importe
insilmaril@719: quel indicateur en les cliquant sur la barre de menu. Les boutons
insilmaril@719: de la barre de menu changent d'état et reflètent l'état des indicateurs
insilmaril@719: de la branche sélectionnée. Ainsi pour effacer un indicateur d'une
insilmaril@719: branche, sélectionnez la branche et cliquez sur le bouton de la barre
insilmaril@719: de menu enfonce.
insilmaril@719: 
insilmaril@719: Pour l'instant \vym utilise deux sortes d'indicateurs : les {\em
insilmaril@719: Indicateurs Standard} et les {\em Indicateurs Système}. Les indicateurs
insilmaril@719: standard sont ceux que l'on voit dans la barre de menu. Les Indicateurs
insilmaril@719: Système sont positionnés par \vym pour indiquer qu'il y a par exemple
insilmaril@719: de l'information supplémentaire dans une note (plus d'information
insilmaril@719: dans \ref{noteeditor}). Dans des versions futures de \vym il pourra
insilmaril@719: y avoir une autre sorte d'indicateurs éditables par l'utilisateur.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Images}
insilmaril@719: 
insilmaril@719: Le moyen le plus simple pour ajouter une image à une branche est de
insilmaril@719: la déplaçer par exemple à partir d'un navigateur dans le mapeditor
insilmaril@719: pendant qu'elle branche est sélectionnée.
insilmaril@719: 
insilmaril@719: Vous pouvez aussi ajouter une image en ouvrant le menu contextuel
insilmaril@719: d'une branche. Cliquez à droite sur la branche sélectionnée, choisissez
insilmaril@719: \og Add Image \fg{}. Une fenêtre de dialogue vous permet de la choisir.%
insilmaril@719: \footnote{Les formats d'images supportés sont : PNG, BMP, XBM, XPM et PNM. Sont
insilmaril@719: aussi supportables JPEG, MNG et GIF, si spécialement configuré pendant
insilmaril@719: la compilation dans  SUSE LINUX).%
insilmaril@719: } Quand une image est sélectionnée dans le dialogue, un aperçu est
insilmaril@719: affiché. Il est possible de sélectionner plusieurs images.
insilmaril@719: 
insilmaril@719: Vous pouvez placer l'image où vous voulez, vous n'avez qu'à la déplacer
insilmaril@719: avec la souris en appuyant sur le bouton gauche. Pour la lier à une
insilmaril@719: autre branche, appuyer sur la touche \key{Shift} en la déplaçant.
insilmaril@719: Pour l'effacer appuyer sur la touche \key{Del}.
insilmaril@719: 
insilmaril@719: Si vous cliquez à droite sur une image, un menu de contexte s'ouvre
insilmaril@719: qui vous permet de sélectionner un des multiples format d'image. Puis
insilmaril@719: une fenêtre s'affiche pour sauver l'image.
insilmaril@719: 
insilmaril@719: \hint{On utilise cela  pour \og exporter \fg{} l'image, l'image
insilmaril@719: sera sauvegardée dans la carte elle-même. Vous pouvez aussi copier-coller
insilmaril@719: des images mais il n'est pas possible de lui ajouter des objets. Les
insilmaril@719: images sont considérées comme des \og particularités supplémentaires%
insilmaril@719: \footnote{extra feature (N.d.T.)%
insilmaril@719: } \fg{}. Elles pourraient rendre le travail avec la carte beaucoup
insilmaril@719: plus complexe par exemple en liant des images à des images.}
insilmaril@719: 
insilmaril@719: L'option \og Use for export \fg{} contrôle la sortie des exportations
insilmaril@719: par exemple en HTML : si positionné à NON, l'image n'apparaîtra pas
insilmaril@719: dans le {\em texte} de la sortie. C'est utile pour les grandes
insilmaril@719: images ou si des images sont utilisées comme trames comme par exemple
insilmaril@719: le nuage autour d'une partie de la carte. Elle n'apparaîtront pas
insilmaril@719: au milieu du texte.
insilmaril@719: 
insilmaril@719: Pour le moment le support des images est provisoire : les images sont
insilmaril@719: sauvées avec les autres données de la carte dans le fichier \texttt{.vym}.
insilmaril@719: Des versions futures incluront plus de possibilités comme le redimensionnement
insilmaril@719: des images et changer sa transparence et l'inclure dans le fond de
insilmaril@719: la carte), etc.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Trames}
insilmaril@719: 
insilmaril@719: Une trame peut être ajoutée à une branche dans la {\em fenêtre des
insilmaril@719: propriétés} (voir \ref{propwindow}). Vous pouvez aussi utiliser
insilmaril@719: des images comme trames. Regardez la carte de démonstration \texttt{todo.vym}
insilmaril@719: comme exemple, où le mapcenter est un nuage. Vous pouvez utiliser
insilmaril@719: un programme de dessin externe comme\texttt{ gimp} pour créer une
insilmaril@719: image, de préférence avec un canal de transparence, ainsi vous pouvez
insilmaril@719: créer des trames qui n'ont pas de bord rectangulaire, comme un nuage.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Conception du fond des cartes et des liens de connections}
insilmaril@719: 
insilmaril@719: La conception du fond d'une carte et aussi des liens reliant les diverses
insilmaril@719: parties de la carte peuvent être changés par :
insilmaril@719: \begin{itemize}
insilmaril@719: \item la sélection du format à partir du menu,
insilmaril@719: \item en cliquant à droite sur le fond de la carte, ce qui ouvre un menu
insilmaril@719: de contexte.
insilmaril@719: \end{itemize}
insilmaril@719: 
insilmaril@719: \subsubsection*{Trame de fond}
insilmaril@719: 
insilmaril@719: La couleur est choisie (et aussi affichée) par \og Set background
insilmaril@719: colour \fg{}. Vous pouvez aussi choisir une image de fond d'écran
insilmaril@719: quoique cela ne soit pas recommandé. Travailler sur la carte devient
insilmaril@719: lent et l'image ne peut être positionnée librement.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Couleur des liaisons}
insilmaril@719: 
insilmaril@719: Les liaisons reliant les branches peuvent être colorées de deux façons
insilmaril@719: : 
insilmaril@719: \begin{itemize}
insilmaril@719: \item utiliser la même couleur pour le titre et la ligne représentant la
insilmaril@719: liaison,
insilmaril@719: \item utiliser {\em une} couleur pour toutes les liaisons et choisir
insilmaril@719: des couleurs différentes pour les titres. La couleur par défaut des
insilmaril@719: liaisons des branches est bleu.
insilmaril@719: \end{itemize}
insilmaril@719: Cette dernière couleur peut être choisie par \og Set link colour \fg{}.
insilmaril@719: Positionner ou invalider l'option \og Use colour of heading for link \fg{}
insilmaril@719: pour basculer entre deux choix dans votre dessin.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Style de liaison}
insilmaril@719: 
insilmaril@719: \vym offre quatre styles différents pour l'apparence des liaisons
insilmaril@719: :
insilmaril@719: \begin{itemize}
insilmaril@719: \item ligne,
insilmaril@719: \item parabole,
insilmaril@719: \item grosse ligne,
insilmaril@719: \item parabole épaisse.
insilmaril@719: \end{itemize}
insilmaril@719: Les styles \og épais \fg{} ne sont actifs que pour les liaisons
insilmaril@719: partant du mapcenter, les liaisons pour le reste de la carte sont
insilmaril@719: toujours \og fines \fg{}.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Liens à d'autres documents et aux pages web}
insilmaril@719: 
insilmaril@719: \vym admet deux types de liens externes :
insilmaril@719: \begin{itemize}
insilmaril@719: \item document qui va être ouvert dans un navigateur externe,
insilmaril@719: \item carte \vym, qui sera ouverte par \vym lui-même.
insilmaril@719: \end{itemize}
insilmaril@719: En supplément aux liens externes, il y en a d'autres internes, reliant
insilmaril@719: une branche à une autre sur la même carte. Elles sont appelées {\em
insilmaril@719: XLinks} et sont expliquées à la section ~\ref{xlinks}.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{navigateur}
insilmaril@719: 
insilmaril@719: Les navigateurs modernes comme \texttt{konqueror et Firefox} sont
insilmaril@719: capables d'afficher des types de fichiers variés locaux ou sur Internet.
insilmaril@719: Pour saisir l'~URL d'un document appuyez sur la touche \key{U}
insilmaril@719: ou cliquez à droite sur une branche pour ouvrir le menu contextuel
insilmaril@719: puis choisir \og References\ra Edit URL \fg{}. Si vous voulez ouvrir
insilmaril@719: une fenêtre de dialogue pour choisir plus facilement un fichier local
insilmaril@719: tapez ~\key{SHIFT-U}.
insilmaril@719: 
insilmaril@719: Lorsqu'une URL a été entrée, un petit globe apparaît dans la branche.
insilmaril@719: On cliquant sur ce globe ou dans le menu contextuel, le navigateur%
insilmaril@719: \footnote{Le navigateur peut être changé dans le menu Settings (voir \ref{settings}).%
insilmaril@719: } externe sera lancé :
insilmaril@719: 
insilmaril@719: \begin{center}
insilmaril@764: \includegraphics[width=0.5cm,bb = 0 0 200 100, draft, type=eps]{images/flag-url.png} 
insilmaril@719: \par\end{center}
insilmaril@719: 
insilmaril@719: Pour plus d'informations sur le travail avec les signets et les navigateurs
insilmaril@719: voir \ref{bookmarks}.
insilmaril@719: 
insilmaril@719: Dans le menu de contexte, il y a une option pour ouvrir toutes les
insilmaril@719: URL trouvées dans le sous-arbre de la branche sélectionnée. C'est
insilmaril@719: très pratique pour ouvrir tout un jeu de liens dans le navigateur
insilmaril@719: surtout si celui-ci dispose d'index (comme \texttt{konqueror}%
insilmaril@719: \footnote{ou \texttt{firefox} (N. d. T.)%
insilmaril@719: }).
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{carte \vym }
insilmaril@719: 
insilmaril@719: Pour lier une branche à une autre carte \vym  cliquer à droite sur
insilmaril@719: une branche et choisir : \og Édit \vym links \fg{}. Une fenêtre
insilmaril@719: de dialogue sur les fichiers s'ouvre pour vous permettre de choisir
insilmaril@719: le fichier voulu. Une branche avec un lien est marquée par :
insilmaril@719: 
insilmaril@719: \begin{center}
insilmaril@764: \includegraphics[width=0.5cm,bb = 0 0 200 100, draft, type=eps]{images/flag-vymlink.png} 
insilmaril@719: \par\end{center}
insilmaril@719: 
insilmaril@719: Cliquer sur cet indicateur, dans la barre de menu ou dans le menu
insilmaril@719: de contexte va ouvrir cette carte dans un autre onglet. (voir \ref{tabs}
insilmaril@719: pour le travail sur plusieurs cartes). Pour effacer un lien existant,
insilmaril@719: cliquer à droite sur la branche et choisir \og Delete \vym link \fg{}.
insilmaril@719: 
insilmaril@719: Dans le menu contextuel, il y a aussi une option pour ouvrir tous
insilmaril@719: les liens vers des fichiers \vym  du sous-arbre de la branche sélectionnée
insilmaril@719: dans la carte. C'est utile pour ouvrir simultanément une collection
insilmaril@719: de cartes en relation avec la carte courante.
insilmaril@719: 
insilmaril@719: Note technique : en interne \vym utilise des chemins absolus, pour
insilmaril@719: éviter d'ouvrir plusieurs fois la même carte. Quand la carte est sauvegardée,
insilmaril@719: le chemin est converti en relatif (par exemple \texttt{/home/user/vym.map}
insilmaril@719: devient\texttt{ ./vym.map}. Cela rend aisé d'utiliser des cartes différentes
insilmaril@719: sur plusieurs ordinateurs et de les exporter en HTML pour plus tard.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{cartes multiples}
insilmaril@719: 
insilmaril@719: \label{tabs} Vous pouvez travailler sur plusieurs cartes en même
insilmaril@719: temps. Chaque nouvelle carte est ouverte dans un {\em onglet}.
insilmaril@719: Les onglets des cartes disponibles sont situés en haut du mapeditor.
insilmaril@719: Vous pouvez utiliser les fonctions couper-copier-coller pour transférer
insilmaril@719: des données d'une carte à l'autre.
insilmaril@719: 
insilmaril@719: %todo
insilmaril@719: 
insilmaril@719: 
insilmaril@719: %TODO
insilmaril@719: %\subsubsection{Menus}
insilmaril@719: %\subsubsection{Keyboard shortcuts}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: % Settings
insilmaril@719: % Images
insilmaril@719: % Copy & Paste
insilmaril@719: % Working with tabs (multiple maps)
insilmaril@719: % Exporting
insilmaril@719: % Scrolling
insilmaril@719: 
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \section{Noteeditor}
insilmaril@719: 
insilmaril@719: \label{noteeditor}Si vous voulez mettre plus de texte sur une branche
insilmaril@719: (par exemple un email complet ou une recette de cuisine ou une palanquée
insilmaril@719: de code source) vous pouvez utiliser le noteeditor. \maximage{images/noteeditor_fr.png}
insilmaril@719: Cet éditeur affiche le texte associé à la branche sélectionnée dans
insilmaril@719: le mapeditor. 
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{États}
insilmaril@719: 
insilmaril@719: Avant de pouvoir écrire ou mettre du texte dans le noteeditor, vous
insilmaril@719: devez sélectionner une branche dans le mapeditor. La couleur du fond
insilmaril@719: du noteeditor indique son état : 
insilmaril@719: \begin{itemize}
insilmaril@719: \item gris : pas de texte,
insilmaril@719: \item blanc : du texte existe.
insilmaril@719: \end{itemize}
insilmaril@719: Dans le mapeditor, pour signaler qu'il y a une note avec plus d'informations
insilmaril@719: pour une branche particulière, un petit indicateur \og note \fg{}
insilmaril@719: apparaît dans l'entête de la branche. Regardez dans la branche en
insilmaril@719: bas à droite de la carte suivante :\maximage{images/branches-flags_fr.png}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Importer et exporter des notes }
insilmaril@719: 
insilmaril@719: Une note est automatiquement sauvée dans la carte \vym. Il est agréable
insilmaril@719: d'importer une note à partir d'un fichier externe ou d'écrire cette
insilmaril@719: note dans un fichier externe. Dans le noteeditor utiliser \og File\ra~Import \fg{}
insilmaril@719: et \og File\ra~Export \fg{} pour l'import-export.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Éditer et imprimer une note}
insilmaril@719: 
insilmaril@719: L'édition fonctionne comme un éditeur de texte classique, incluant
insilmaril@719: les fonctions annule-recommence. Vous pouvez effacer entièrement la
insilmaril@719: note en cliquant sur la corbeille. En cliquant sur le bouton d'impression
insilmaril@719: seule la note et imprimée.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{RichText: couleurs, paragraphes et texte formatté}
insilmaril@719: 
insilmaril@719: \vym supporte le texte formatté (QT Rich Text) dans le noteeditor
insilmaril@719: depuis la version 1.4.7. Les couleurs et les attributs de texte (par
insilmaril@719: exemple italique, gras) sont positionnés avec les boutons au-dessus
insilmaril@719: du texte. Le texte lui-même est divisé en paragraphes. Pour chaque
insilmaril@719: paragraphe l'alignement peut être spécifié (par exemple centré ou
insilmaril@719: à droite). Un paragraphe est terminé par appui sur la touche \key{Return}.
insilmaril@719: Si vous voulez juste commencer une nouvelle ligne tapez \key{CTRL-Return}.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Les fontes et comment les changer rapidement}
insilmaril@719: 
insilmaril@719: Le noteeditor est fait pour éditer de petites notes, ce n'est pas
insilmaril@719: un traitement de texte complet. Suite à beaucoup de demandes, \vym
insilmaril@719: supporte le texte formatté dans le noteeditor%
insilmaril@719: \footnote{\vym utilise le format QRichtText, qui est un sous-ensemble du formattage
insilmaril@719: fourni en HTML.%
insilmaril@719: }. Deux fontes par défaut sont installées qui peuvent être choisies
insilmaril@719: par le \og Settings menu \fg{} (voir \ref{settings}). Une fonte
insilmaril@719: à chasse fixe, l'autre variable. La fonte à chasse fixe est utilisée
insilmaril@719: pour les emails, le code source, etc l'autre pour les simples notes.
insilmaril@719: Les deux fontes peuvent être facilement commutées en cliquant sur
insilmaril@719: le bouton suivant dans la barre de menu :
insilmaril@719: 
insilmaril@719: \begin{center}
insilmaril@764: \includegraphics[width=0.5cm,bb = 0 0 200 100, draft, type=eps]{images/formatfixedfont.png} 
insilmaril@719: \par\end{center}
insilmaril@719: 
insilmaril@719: Dans le \og Settings menu \fg{} les deux fontes peuvent être choisies.
insilmaril@719: La fonte par défaut peut aussi être changée en sélectionnant ou désélectionnant
insilmaril@719: \og fixed font is default \fg{}.
insilmaril@719: 
insilmaril@719: En supplément toute fonte installée sur votre système peut être utilisée.
insilmaril@719: Notez que la fonte choisie sera aussi utilisée pour les exports HTML,
insilmaril@719: si vous voulez exporter votre carte \vym  l'intranet ou sur le web,
insilmaril@719: vous devrez utiliser des fontes disponibles partout.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Recherche de texte}
insilmaril@719: 
insilmaril@719: Le noteeditor n'a pas sa propre fonction de recherche, utiliser \og Find \fg{}
insilmaril@719: dans le mapeditor qui recherche également dans toutes les notes (voir
insilmaril@719: \ref{findwindow}).
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Coller du texte dans le noteeditor}
insilmaril@719: 
insilmaril@719: Vous voulez souvent coller du texte dans le noteeditor à partir d'une
insilmaril@719: autre application par exemple un email. Normalement \vym va créer
insilmaril@719: un nouveau paragraphe pour chaque ligne. Si ce n'est pas ce que voulez
insilmaril@719: vous pouvez choisir à partir de la barre de menu
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \section{Hello world%
insilmaril@719: \footnote{\og bonjour monde \fg{} ou comment faire une carte de base%
insilmaril@719: }}
insilmaril@719: 
insilmaril@719: Cette section décrit comment \vym réagit au contact d'autres applications.
insilmaril@719: Maintenant beaucoup d'applications lisent et écrivent leurs données
insilmaril@719: en XML, le \og eXtensible Markup Language \fg{}. \vym utilise aussi
insilmaril@719: XML pour sauver ses cartes, voir \ref{fileformat} pour une description
insilmaril@719: plus détaillée.
insilmaril@719: 
insilmaril@719: Si vous utilisez une autre application qui utilise le XML, il est
insilmaril@719: possible de faire un filtre d'import-export pour \vym. Les volontaires
insilmaril@719: sont accueillis avec plaisir ;-)
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Import}
insilmaril@719: 
insilmaril@719: \label{import}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Signets KDE }
insilmaril@719: 
insilmaril@719: L'éditeur de signets intégrés à KDE (Konqueror etc.) est limité, ainsi
insilmaril@719: pourquoi ne pas utiliser \vym pour gérer les signets? Pour créer
insilmaril@719: une nouvelle carte contenant contenant les signets courants choisir
insilmaril@719: : \og File \ra Import\ra KDE Bookmarks \fg{}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Mind Manager}
insilmaril@719: 
insilmaril@719: \vym a pour l'instant un filtre d'importation rudimentaire pour convertir
insilmaril@719: les cartes créées par {\em Mind Manager}%
insilmaril@719: \footnote{Mind Manager est un logiciel commercial c'est à dire non libre. Il
insilmaril@719: est développée par Mindjet pour Windows et le Mac. Les deux sont des
insilmaril@719: marques enregistrées par Mindjet. Pour plus d'informations voir leur
insilmaril@719: site web \href{http://mindjet.com}{http://mindjet.com}%
insilmaril@719: } en cartes \vym. Les notes et les images ne sont pas converties pour
insilmaril@719: l'instant. Vous pouvez importer des fichiers avec : \og File \ra
insilmaril@719: Import\ra Mind Manager \fg{}.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Structure et répertoires}
insilmaril@719: 
insilmaril@719: \vym peut lire une structure de répertoires. C'est pour tester \vym,
insilmaril@719: par exemple pour créer facilement de très grandes cartes utilisées
insilmaril@719: pour les essais (oui il y a encore de la place pour optimiser \vym
insilmaril@719: ;-)
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Export}
insilmaril@719: 
insilmaril@719: \label{export} \label{hideexport} Souvent vous ne voulez pas exporter
insilmaril@719: la carte entière, juste une partie. Par exemple, vous pouvez avoir
insilmaril@719: une information supplémentaire dont vous voulez parler dans une présentation,
insilmaril@719: alors que ces parties ne seront pas visibles pendant la présentation.
insilmaril@719: Pour y arriver, vous pouvez \og cacher \fg{} des parties de la carte
insilmaril@719: pendant les exports en positionnant l'indicateur \og hide in export \fg{}. 
insilmaril@719: 
insilmaril@719: \begin{center}
insilmaril@764: \includegraphics[width=0.5cm,bb = 0 0 200 100, draft, type=eps]{images/flag-hideexport.png} 
insilmaril@719: \par\end{center}
insilmaril@719: 
insilmaril@719: Vous pouvez basculer cet indicateur à partir de la barre de menu ou
insilmaril@719: en tapant \key{H}. Notez qu'il y a une option globale dans le menu
insilmaril@719: de préférences( \ref{settings}) pour basculer l'utilisation de cet
insilmaril@719: indicateur. Par défaut cet indicateur est validé.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Open Office}
insilmaril@719: 
insilmaril@719: À partir de la version 2 Open utilise le \og Open Document Format \fg{},
insilmaril@719: qui peut être écrit par \vym. Les options sont actuellement limitées.
insilmaril@719: Il est possible d'exporter des présentations qui peuvent être ouvertes
insilmaril@719: par Open Office Impress. En sélectionnant : \og File \ra Export\ra
insilmaril@719: Open Office \fg{}.
insilmaril@719: 
insilmaril@719: Vous obtenez une fenêtre de dialogue où vous pouvez choisir le fichier
insilmaril@719: de sortie et le type de fichier : \maximage{images/export-oo.png}
insilmaril@719: Les types de fichiers représentent différents types de patrons, qui
insilmaril@719: peuvent être créés à partir d'un document Open Office avec un peu
insilmaril@719: de travail manuel. La structure de la carte \vym est alors insérée
insilmaril@719: dans ce patron. Il y a pour l'instant quelque limitations :
insilmaril@719: \begin{itemize}
insilmaril@719: \item \vym ne peut gérer la longueur des pages, vous devez tester et sans
insilmaril@719: doute re-éditer le document Open Office pour éviter que le texte ne
insilmaril@719: continue après la fin de la page,
insilmaril@719: \item images et les indicateurs ne sont pas utilisés pour le moment,
insilmaril@719: \item les notes sont écrites en texte brut , sans RichText 
insilmaril@719: \item la gamme complète des patrons n'est pas disponible dans toutes les
insilmaril@719: distributions.
insilmaril@719: \end{itemize}
insilmaril@719: Certains patrons utilisent des {\em sections} c'est à dire qu'ils
insilmaril@719: insèrent le titre des branches principales comme des titres de section
insilmaril@719: dans la présentation.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Image}
insilmaril@719: 
insilmaril@719: \vym supporte tous les formats d'image qui sont nativement supportés
insilmaril@719: par le QT~toolkit : BMP, JPEG, PBM, PGM, PNG, PPN, XPM et XBM. Pour
insilmaril@719: utilisation sur les sites web ou envoyer des images par email, PNG
insilmaril@719: est un bon compromis taille/qualité. \vym utilise les options par
insilmaril@719: défaut de Qt pour comprimer les images.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{ASCII}
insilmaril@719: 
insilmaril@719: L'exportation en image est expérimental en ce moment. Plus tard cela
insilmaril@719: sans doute fait avec des feuilles de style. La forme de la sortie
insilmaril@719: risque de changer dans de futures versions de \vym.
insilmaril@719: 
insilmaril@719: 
insilmaril@764: \subsubsection*{\protect\LaTeX{}}
insilmaril@719: 
insilmaril@719: \vym peut générer un fichier d'entrée pour \LaTeX{}. C'est actuellement
insilmaril@719: en développement, il n'y a pas d'option. En sélectionnant : \og File
insilmaril@719: \ra Export\ra \LaTeX{} \fg{}.
insilmaril@719: 
insilmaril@719: Vous allez ouvrir une fenêtre de dialogue pour le nom du fichier de
insilmaril@719: sortie. Cette feuille peut ensuite être inclue dans un document en
insilmaril@719: utilisant la commande : \begin{verbatim} \include{inputfile} \end{verbatim}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Bookmarks KDE }
insilmaril@719: 
insilmaril@719: \vym va écraser le fichier des bookmarks KDE puis tenter de le notifier
insilmaril@719: à Konqueror en fonctionnement puis essayera de le notifier via DCOP
insilmaril@719: que le fichier a changé. \emph{\vym ne crée pas de sauvegarde ! } Accessible
insilmaril@719: par le menu : \og File \ra Export \ra KDE Bookmarks \fg{}.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{XHTML (Webpages)}
insilmaril@719: 
insilmaril@719: C'est le format à utiliser si vous voulez créer une page web. Pour
insilmaril@719: voir un exemple visitez la page d'entrée de \vym : \href{http://www.InSilmaril.de/vym}{www.InSilmaril.de/vym}
insilmaril@719: 
insilmaril@719: Quelque explications sur son fonctionnement : avant d'exporter une
insilmaril@719: carte en XHTML, elle est d'abord écrite en XML dans un répertoire
insilmaril@719: (voir \ref{xmlexport}). Puis le programme externe \texttt{xsltproc}%
insilmaril@719: \footnote{Sur la distribution SUSE Linux et quelques autres distributions \texttt{xsltproc}
insilmaril@719: est installé par défaut.%
insilmaril@719: } va être appelé pour traiter le fichier XML et générer le code HTML.
insilmaril@719: Un dialogue permet à l'utilisateur de positionner diverses options
insilmaril@719: :
insilmaril@719: \begin{description}
insilmaril@719: \item [{Include}] \textbf{image:} si positionné, \vym va créer une une
insilmaril@719: image de la carte au début de la sortie HTML. Cliquer sur une branche
insilmaril@719: va faire sauter à la section correspondante de la sortie.
insilmaril@719: \item [{Colored}] \textbf{headings:} Si positionné à OUI, \vym va mettre
insilmaril@719: les titres en couleur dans la partie texte avec les mêmes couleurs
insilmaril@719: que celles utilisées dans la carte \vym. 
insilmaril@719: \item [{Show}] \textbf{warnings:} Si positionné, \vym va demander avant
insilmaril@719: d'écrire les données.
insilmaril@719: \item [{Show}] \textbf{output:} Cela est utilisé principalement pour le
insilmaril@719: dégogage. On va voir comment s'effectue le traitement du fichier XML
insilmaril@719: en appelant le programme externe \texttt{xsltproc}. 
insilmaril@719: \end{description}
insilmaril@719: En complément les chemins des feuilles de styles CSS et XSL peuvent
insilmaril@719: être indiqués. Par défaut sur SUSE~Linux elles sont dans : \texttt{/usr/share/vym/styles}%
insilmaril@719: \footnote{N.dT. idem pour la version 1.10.0 sur Debian Etch%
insilmaril@719: }.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{XML}
insilmaril@719: 
insilmaril@719: \label{xmlexport} La carte est écrite dans un répertoire à la fois
insilmaril@719: comme une image et comme un fichier XML. Le répertoire est choisi
insilmaril@719: dans une fenêtre de dialogue. Si le répertoire n'est pas vide, vous
insilmaril@719: allez être averti et on va vous prévenir que vous risquez d'écraser
insilmaril@719: des fichiers.
insilmaril@719: 
insilmaril@719: Il est possible d'exporter des cartes différentes dans le même répertoire.
insilmaril@719: Chaque fichier généré va avoir le nom de la carte comme préfixe, par
insilmaril@719: exemple e.g. \texttt{todo.vym} devient \texttt{todo.xml}, \texttt{todo.png},
insilmaril@719: \texttt{todo-image-1.png} et ainsi de suite. C'est utile si par exemple
insilmaril@719: un site web comporte des cartes liées qui doivent être rangées dans
insilmaril@719: le même répertoire.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Export d'une partie d'une carte}
insilmaril@719: 
insilmaril@719: Sélectionnez la branche que vous voulez exporter avec ses fils, puis
insilmaril@719: ouvrez le menu contextuel et choisissez {\em Save Selection}. Cela
insilmaril@719: va créer un fichier avec le suffixe \texttt{.vyp}, qui est une abréviation
insilmaril@719: de \og vym part \fg{}.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \section{Édition avancée}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Propriétés d'un objet}
insilmaril@719: 
insilmaril@719: Pour chacune des branches vous pouvez ouvrir une fenêtre auxiliaire
insilmaril@719: (voir \ref{satellite}): la {\em property window%
insilmaril@719: \footnote{fenêtre des propriétés%
insilmaril@719: }}: 
insilmaril@719: 
insilmaril@719: \begin{center}
insilmaril@764: \includegraphics[width=8cm,bb = 0 0 200 100, draft, type=eps]{images/propwindow.png}
insilmaril@764: \label{propwindow} 
insilmaril@719: \par\end{center}
insilmaril@719: 
insilmaril@719: %FIXME create screenshot
insilmaril@719: %FIXME explain the tabs
insilmaril@719: 
insilmaril@719: \begin{itemize}
insilmaril@719: \item trame,
insilmaril@719: \item lien (voir \ref{hideunselected}) 
insilmaril@719: \item Layout (voir \ref{incimg}) 
insilmaril@719: \end{itemize}
insilmaril@719: 
insilmaril@719: \subsection{Revoir l'histoire : défaire et refaire %
insilmaril@719: \footnote{Undo and Redo%
insilmaril@719: }}
insilmaril@719: 
insilmaril@719: \vym garde la trace de tous les changements faits à une carte. Le
insilmaril@719: nombre de modifications qui peuvent être défaites est de 75 par défaut.
insilmaril@719: L'historique complet peut être vu dans la {\em fenêtre d'historique}:
insilmaril@719: \maximage{images/historywindow.png} \label{historywindow} un simple
insilmaril@719: pas en arrière peut être défait ou refait en tapant \key{CTRL-Z}
insilmaril@719: ou \key{CTRL-Y}, ou en utilisant les boutons de la barre de menu
insilmaril@719: ou la {\em fenêtre d'historique}. Dans la {\em fenêtre d'historique},
insilmaril@719: vous pouvez cliquer sur une ligne pour détailler toutes les actions
insilmaril@719: faites jusqu'à ce moment, ou refaire toutes les actions en cliquant
insilmaril@719: sur la dernière ligne.
insilmaril@719: 
insilmaril@719: \hint{ Vous pouvez \og coller à partir du passé \fg{} : aller en
insilmaril@719: arrière dans le temps avec la touche \key{CTRL-Z}, puis copier dans
insilmaril@719: le tampon en tapant \key{CTRL-C}.
insilmaril@719: 
insilmaril@719: Maintenant pour refaire toutes les actions, par exemple en tapant
insilmaril@719: sur la touche \key{CTRL-Y} ou en cliquant sur la dernière action
insilmaril@719: dans la {\em fenêtre d'historique}. Maintenant collez à partir
insilmaril@719: du passé avec la touche \key{CTRL-V}. }
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Macros}
insilmaril@719: 
insilmaril@719: \label{macros} Les macros ont été ajoutées à \vym à la version~1.9.0.
insilmaril@719: Jusqu'à présent elles sont provisoires, elles vont peut-être être
insilmaril@719: remplacées par un langage de script plus performant (les commandes
insilmaril@719: seront approximativement les mêmes).
insilmaril@719: 
insilmaril@719: Chaque touche de fonction (touches \key{F1} à \key{F12}) contient
insilmaril@719: une macro, qui est exécutée sur la sélection courante lorsque la touche
insilmaril@719: est enfoncée. Les macros par défaut changent la couleur d'un sous
insilmaril@719: arbre ou positionnent la trame d'une branche : 
insilmaril@719: 
insilmaril@719: \begin{center}
insilmaril@764: \includegraphics[width=8cm,bb = 0 0 200 100, draft, type=eps]{images/macros_fr.png} 
insilmaril@719: \par\end{center}
insilmaril@719: 
insilmaril@719: Chaque macro est un script \vym qui est exécuté lorsque la touche
insilmaril@719: correspondante est appuyée. L'emplacement par défaut des macros peut
insilmaril@719: être changé dans le \og Settings menu \fg{}. Plus d'informations
insilmaril@719: sur l'utilisation des scripts dans \vym peut être trouvé en appendice~\ref{scripts}.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Signets}
insilmaril@719: 
insilmaril@719: \label{bookmarks} 
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Ouvrir des nouveaux signets au lieu de nouvelles fenêtres}
insilmaril@719: 
insilmaril@719: Si vous utilisez \texttt{konqueror} comme navigateur, \vym peut se
insilmaril@719: rappeler de la session de \texttt{konqueror }qui était ouverte en
insilmaril@719: premier par \vym. Vous pouvez appuyer sur les touches \key{Ctrl}
insilmaril@719: et cliquer pour ouvrir le lien dans un nouvel onglet.
insilmaril@719: 
insilmaril@719: \vym peut aussi ouvrir une nouvel onglet dans Mozilla ou Firefox
insilmaril@719: en utilisant la commande à distance %
insilmaril@719: \footnote{(remote command) à \href{http://www.mozilla.org/unix/remote.html}{http://www.mozilla.org/unix/remote.html}%
insilmaril@719: } de ces navigateurs.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Copier/coller}
insilmaril@719: 
insilmaril@719: Si vous voulez mettre vos bookmarks dans une carte, sélectionnez une
insilmaril@719: branche où vous voulez ajouter le bookmark, puis collez simplement
insilmaril@719: l'URL dans la carte à partir de votre navigateur. Vous pouvez aussi
insilmaril@719: utiliser un titre existant comme URL : cliquez à droite sur la branche
insilmaril@719: et sélectionnez : \og Use heading for URL \fg{}.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Accès direct à la liste des bookmarks d'un navigateur}
insilmaril@719: 
insilmaril@719: Voir les sections \ref{import} et \ref{export} sur les filtres d'import-export.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{URL spéciales}
insilmaril@719: 
insilmaril@719: \vym peut convertir un titre d'une branche existante en URL. Cela
insilmaril@719: marche pour Bugentries dans le système Novell Bugtracking : ouvrez
insilmaril@719: le menu de contexte d'une branche (en cliquant à droite) et sélectionnez
insilmaril@719: : \og Create URL to Bugzilla \fg{}.
insilmaril@719: 
insilmaril@719: L'URL sera créé à partir du titre.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Associer des images à une branche}
insilmaril@719: 
insilmaril@719: \label{incimg} La configuration par défaut d'une image est de flotter
insilmaril@719: \og librement \fg{}. Les images peuvent être positionnées n'importe
insilmaril@719: où dans le canevas cachant la partie correspondante de la carte.
insilmaril@719: 
insilmaril@719: La solution est de l'insérer ou de l'inclure \og dans \fg{} une
insilmaril@719: branche. Cela est fait au travers de la fenêtre de propriétés (voir
insilmaril@719: \ref{propwindow}) par les menus : 
insilmaril@719: \begin{itemize}
insilmaril@719: \item include images horizontally 
insilmaril@719: \item include images vertically 
insilmaril@719: \end{itemize}
insilmaril@719: L'images est positionnée relativement à sa branche mère, mais le titre
insilmaril@719: et la bordure s'adapte à l'image flottante, voir en dessous : \maximage{images/includeImages_fr.png}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Mode modificateur}
insilmaril@719: 
insilmaril@719: Les modificateurs sont par exemple la touche \key{Shift}, \key{Ctrl}
insilmaril@719: ou \key{Alt}. Quand on appuie dessus pendant une action de la souris,
insilmaril@719: \vym va effectuer une action différente de celle habituelle.
insilmaril@719: 
insilmaril@719: %\key{Ctrl} or \key{Alt}is pressed while releasing the branch, it will be
insilmaril@719: %added above/below the target, not as child of the target.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: Sans appuyer sur un modificateur, le premier clic sur la souris sélectionne
insilmaril@719: une branche. Le comportement avec le modificateur \key{Ctrl} est
insilmaril@719: sujet à à plusieurs options, qui peuvent être positionnées dans la
insilmaril@719: barre de menu :
insilmaril@719: 
insilmaril@719: \begin{center}
insilmaril@764: \includegraphics[width=3cm,bb = 0 0 200 100, draft, type=eps]{images/modmodes.png} 
insilmaril@719: \par\end{center}
insilmaril@719: 
insilmaril@719: Le mode par défaut est de copier la couleur de la branche cliquée
insilmaril@719: vers la branche sélectionnée. La figure au-dessus montre la barre
insilmaril@719: de menu avec le modificateur par défaut sélectionné. Le deuxième modificateur
insilmaril@719: vous permet de couper une branche complète avec un simple clic. Le
insilmaril@719: troisième modificateur vous permet de créer des liens entre branches
insilmaril@719: appelés {\em xLinks}. Cela est expliqué dans la section suivante
insilmaril@719: \ref{xlinks}.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Cacher les liens d'objets non sélectionnés}
insilmaril@719: 
insilmaril@719: \label{hidelink} Il est pratique de positionner librement une branche,
insilmaril@719: comme une branche principale ou une image. Cela est possible pour
insilmaril@719: toutes les branches, vous pouvez utiliser une branche principale et
insilmaril@719: cacher ses liens de connexion au centre de la carte ou cacher le lien
insilmaril@719: entre une branche fils et son parent. C'est utile par exemple pour
insilmaril@719: les légendes ou pour une collection de liens \vym  pointant vers
insilmaril@719: d'autres cartes : 
insilmaril@719: 
insilmaril@719: \begin{center}
insilmaril@764: \includegraphics[width=9cm,bb = 0 0 200 100, draft, type=eps]{images/hiddenlink_fr.png} 
insilmaril@719: \par\end{center}
insilmaril@719: 
insilmaril@719: Pour cacher le lien entre la branche et son parent ouvrir la fenêtre
insilmaril@719: de propriétés et sélectionner \og Hide link if object is not selected \fg{}
insilmaril@719: sur l'onglet \og Link \fg{}.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{XLinks}
insilmaril@719: 
insilmaril@719: \label{xlinks} Jusqu'à maintenant les données dans la carte \vym
insilmaril@719: étaient sous forme d'arbre. En utilisant les xLinks vous pouvez lier
insilmaril@719: une branche à n'importe quelle autre, comme en attachant une corde
insilmaril@719: entre deux branches dans un vrai arbre. C'est très pratique dans des
insilmaril@719: cartes compliquées, où vous avez des renvois qui ne peuvent être affichés
insilmaril@719: dans la même zone visible de la fenêtre du {\em mapeditor}. La
insilmaril@719: carte suivante tient sur un écran, mais montre comment les données
insilmaril@719: peuvent être reliées. Dans le graphisme il y a un lien à partir d'une
insilmaril@719: tâche (prepare a presentation) à l'information générale : \maximage{images/xlink_fr.png}
insilmaril@719: Notez qu'un xLink qui pointe sur une branche non visible (parce qu'elle
insilmaril@719: est \og enroulée \fg{}), est montrée par une flèche horizontale.
insilmaril@719: Regardez la branche \lq Tuesday\rq dans la capture d'écran ci-dessus.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Créer un xLink}
insilmaril@719: 
insilmaril@719: Choisir le type de lien à partir de la barre de modifier (en cliquant
insilmaril@719: l'icône de la barre de menu ou en tapant \key{L}). Sélectionner
insilmaril@719: la branche d'où le xLink doit partir. Appuyer sur le modifier \key{Ctrl}
insilmaril@719: puis cliquez la branche et amenez le curseur de la souris où le lien
insilmaril@719: doit se terminer. Un lien est tracé qui suit le pointeur de la souris.
insilmaril@719: Le lien devient permanent quand vous relâchez le bouton de la souris
insilmaril@719: .
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Modifier ou effacer un xLink}
insilmaril@719: 
insilmaril@719: Sélectionner une extrémité du xLink. Ouvrir le menu contextuel et
insilmaril@719: sélectionnez \og  Edit xLink \fg{}. Un sous menu contenant tous
insilmaril@719: les xLinks de la branche apparaît. Sélectionnez en un et la fenêtre
insilmaril@719: de dialogue xLink dialogue s'ouvre, où vous pouvez sélectionner la
insilmaril@719: couleur, la largeur et aussi effacer le xLink.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Suivre un xLink}
insilmaril@719: 
insilmaril@719: Dans une carte \vym compliquée il est commode de sauter à l'autre
insilmaril@719: extrémité d'un xLink. Vous pouvez le faire en ouvrant le menu contextuel
insilmaril@719: et en cliquant \og  Goto xLink \fg{} puis en sélectionnant le xLink
insilmaril@719: qui vous intéresse.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Ajouter et supprimer des branches}
insilmaril@719: 
insilmaril@719: Le menu contextuel d'une branche montre quelques moyens supplémentaires
insilmaril@719: pour ajouter ou supprimer des données. Vous pouvez supprimer une branche
insilmaril@719: tout en gardant ses enfants. Les enfants sont alors liés au parent
insilmaril@719: de la branche supprimée (son \og grand-parent \fg{}). Des branches
insilmaril@719: identiques peuvent être ajoutées à des cartes existantes. Pour les
insilmaril@719: raccourcis clavier regarder également dans le menu contextuel.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Ajouter une carte complète ou une partie}
insilmaril@719: 
insilmaril@719: Sélectionner la branche où vous voulez ajouter une carte sauvée précédemment
insilmaril@719: (\texttt{.vym}) ou une partie de carte (\texttt{.vyp}), puis ouvrez
insilmaril@719: le menu contextuel et choisissez {\em Add \ra Add Map (Insert)}.
insilmaril@719: Pour l'importation vous pouvez choisir entre {\em Add Map (Insert)}
insilmaril@719: ou {\em Add Map (Replace)}: les données importées vont être ajoutées
insilmaril@719: à la branche sélectionnée.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \section{\vym sur Mac OS X}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Vue d'ensemble}
insilmaril@719: 
insilmaril@719: Il y a deux moyens de faire fonctionner \vym sur les Macs : 
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Qt Mac Edition:}
insilmaril@719: 
insilmaril@719: \vym a là une l'apparence bien connue de Mac. \vym est disponible
insilmaril@719: comme paquet d'application Mac OS X dans une image disque (\texttt{vym.dmg}).
insilmaril@719: Il a été compilé et testé sur Mac~OS~10.4. Ce paquet inclut les
insilmaril@719: librairies Qt de Trolltech.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{version X11 }
insilmaril@719: 
insilmaril@719: \vym peut aussi être lancé dans sa version Linux, mais les menus
insilmaril@719: et l'utilisation seront ceux de Linux c'est à dire que les barres
insilmaril@719: de menu sont différentes.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Menu de contexte et touches spéciales}
insilmaril@719: 
insilmaril@719: La majorité des Macs n'a malheureusement qu'un bouton de souris. Pour
insilmaril@719: pour voir le menu contextuel qui normalement est ouvert avec un clic
insilmaril@719: droit, vous devez cliquer en appuyant sur la touche \key{command}.
insilmaril@719: 
insilmaril@719: Surtout sur les portables quelques touches utilisées sur les PC sont
insilmaril@719: manquantes. La version de \vym avec QT-Mac a ses propres raccourcis
insilmaril@719: clavier. Pour les trouver regardez les entrées des menus, les raccourcis
insilmaril@719: visibles à côté de cette entrée. Les boutons de la barre de menu peuvent
insilmaril@719: aussi avoir des raccourcis, positionnez le curseur de la souris sur
insilmaril@719: un bouton et la fenêtre d'aide apparaîtra.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Voir des liens externes}
insilmaril@719: 
insilmaril@719: \vym sur Mac utilise le système d'appel \texttt{/usr/bin/open} pour
insilmaril@719: voir les liens. Mac~OS détermine automatiquement si le lien est un
insilmaril@719: pdf ou une page web et ouvre le bon visionneur.
insilmaril@719: 
insilmaril@719: \appendix \newpage{}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \section{\label{settings}\vym : processus d'initialisation et de configuration}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Menu des préférences (Settings menu)}
insilmaril@719: 
insilmaril@719: Le {\em Menu des préférences } vous permet de configurer \vym
insilmaril@719: suivant vos besoins :
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Choisir l'application pour ouvrir les fichiers PDF }
insilmaril@719: 
insilmaril@719: Choisir un visionneur PDF installé sur votre système.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Choisir le navigateur (vers les liens externes)}
insilmaril@719: 
insilmaril@719: Choisissez votre navigateur favori.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Positionner le chemin pour les macros}
insilmaril@719: 
insilmaril@719: Le chemin par défaut pour exécuter les macros correspondantes quand
insilmaril@719: vous appuyez sur une des touches de fonction. Chaque touche correspond
insilmaril@719: à un fichier (\texttt{macro-1.vys..macro12.vys}) dans le chemin de
insilmaril@719: recherche.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Niveaux défaire/refaire}
insilmaril@719: 
insilmaril@719: Fixer le nombre de défaire/refaire. Par défaut :75.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Sauvegarde automatique et temps entre sauvegardes}
insilmaril@719: 
insilmaril@719: La sauvegarde automatique des cartes peut être désactivée. Le temps
insilmaril@764: entre sauvegardes est indiqué en secondes. 
insilmaril@764: 
insilmaril@764: Quand la sauvegarde d'une carte est demandée \texttt{example.vym},
insilmaril@764: \vym  renomme le fichier existant en \texttt{example.vym\textasciitilde{}}
insilmaril@764: avant d'écrire le fichier \texttt{example.vym.}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Éditer la branche après l'avoir créée}
insilmaril@719: 
insilmaril@719: Si positionné, le titre de la nouvelle branche va être édité immédiatement
insilmaril@719: après avoir été créé.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Sélectionner la branche après l'avoir créé}
insilmaril@719: 
insilmaril@719: Si positionné, la nouvelle branche va être sélectionnée après avoir
insilmaril@719: été créée. Quand vous réfléchissez sur un mot donné, vous ne voulez
insilmaril@719: pas aller dans les détails, mais garder l'attention sur ce mot. Le
insilmaril@719: choix par défaut est de {\em ne pas}  sélectionner la nouvelle branche
insilmaril@719: créée.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Sélectionner la branche existante}
insilmaril@719: 
insilmaril@719: Si positionné et que vous commencez à éditer le titre de la branche,
insilmaril@719: le texte du titre va être sélectionné. Pratique pour copier/coller
insilmaril@719: dans d'autres applications.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Touche effacement}
insilmaril@719: 
insilmaril@719: Si positionné, la touche \key{Delete} est validée pour détruire
insilmaril@719: les objets. Attention aux confusions avec la touche \key{Insert}sur
insilmaril@719: les claviers de PC.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Indicateurs exclusif}
insilmaril@719: 
insilmaril@719: Si positionné quelques indicateurs peuvent être exclusifs, par exemple
insilmaril@719: les émoticons.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection*{Autoriser l'indicateur caché}
insilmaril@719: 
insilmaril@719: Si positionné, chaque branche qui a l'indicateur caché associé (voir
insilmaril@719: \ref{hideexport}) ne sera pas présente dans les exports.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Fichier de configuration}
insilmaril@719: 
insilmaril@719: Au démarrage, \vym va regarder un fichier de configuration spécifique
insilmaril@719: à l'utilisateur contenant ses réglages personnels comme la position
insilmaril@719: des fenêtres, les menus de travail, etc. Si ce fichier n'existe pas,
insilmaril@719: il sera créé. Le fichier est localisé dans la racine du répertoire
insilmaril@719: de l'utilisateur. Sa position exacte dépend de la plate-forme :
insilmaril@719: 
insilmaril@719: \begin{center}
insilmaril@719: \begin{tabular}{cl}
insilmaril@719: \textbf{Plate-forme}  & \textbf{Fichier de configuration }\tabularnewline
insilmaril@719: \hline 
insilmaril@719: Linux  & \texttt{$\sim$/.config/InSilmaril/vym.conf}  \tabularnewline
insilmaril@719: Mac OS X  & \texttt{/Users/NAME/Library/Preferences/com.insilmaril.vym.plist}
insilmaril@719:  \tabularnewline
insilmaril@719: \end{tabular}
insilmaril@719: \par\end{center}
insilmaril@719: 
insilmaril@719: Le fichier peut être édité manuellement ou sur Mac~OS~X avec le
insilmaril@719: Property List Editor (installé avec xtools).
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Chemin vers les ressources}
insilmaril@719: 
insilmaril@719: \vym va essayer de trouver ses ressources (images, feuilles de style,
insilmaril@719: filtres, etc) aux endroits suivants :
insilmaril@719: \begin{enumerate}
insilmaril@719: \item chemin donné par la variable d'environnement\texttt{ VYMHOME}. 
insilmaril@719: \item Si appelé avec l'option {\em local}  (voir \ref{options} en dessous),
insilmaril@719: \vym va chercher ses ressource dans le répertoire courant.
insilmaril@719: \item \texttt{/usr/share/vym} 
insilmaril@719: \item \texttt{/usr/local/share/vym} 
insilmaril@719: \end{enumerate}
insilmaril@719: 
insilmaril@719: \subsection{Options de la ligne de commande}
insilmaril@719: 
insilmaril@719: \label{options} \vym a les options suivantes lors de l'appel en
insilmaril@719: ligne de commande%
insilmaril@719: \footnote{chaque option doit être précédé du \og - \fg{} classique (N.d.T.)%
insilmaril@719: } :
insilmaril@719: 
insilmaril@719: \begin{center}
insilmaril@719: \begin{tabular}{cccp{8cm}}
insilmaril@719:  &  &  & \tabularnewline
insilmaril@719: \textbf{Option } & \textbf{Résumé } & \textbf{Argument } & \textbf{Description }\tabularnewline
insilmaril@719: \hline 
insilmaril@719: v  & version  &  & indiquer la version et le nom de code de \vym\tabularnewline
insilmaril@719: l  & local  &  & Utiliser les chemins locaux pour les feuilles de style,les traductions,
insilmaril@719: les icônes, etc.
insilmaril@719: 
insilmaril@719: Pratique pour les tests\tabularnewline
insilmaril@719: h  & aide  &  & montrer l'aide\tabularnewline
insilmaril@719: r  & lancement  & fichier  & charger et lancer un script\tabularnewline
insilmaril@719: q  & quitter  &  & quitter après le démarrage. Utile pour les benchmarks.\tabularnewline
insilmaril@719: \end{tabular}
insilmaril@719: \par\end{center}
insilmaril@719: 
insilmaril@719: Vous pouvez aussi donner plusieurs noms de fichiers dans la ligne
insilmaril@719: de commande pour laisser \vym ouvrir plusieurs cartes à la fois.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \section{Scripts}
insilmaril@719: 
insilmaril@719: \label{scripts} %FIXME
insilmaril@719: 
insilmaril@719: 
insilmaril@719: TODO: désolé cette section du manuel de \vym est provisoire.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Exemple de scripts}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsubsection{Exporter un jeu de cartes}
insilmaril@719: 
insilmaril@719: \begin{verbatim} \# Simple vym script to export images of various
insilmaril@719: maps simultanously exportImage (); \end{verbatim} Le script au-dessus
insilmaril@719: peut être utilisé pour exporter automatiquement toutes les cartes
insilmaril@719: d'un répertoire. Si le script a pour nom \texttt{export-image.vys},
insilmaril@719: appeler \vym avec\begin{verbatim} vym --quit --run export-image.vys
insilmaril@719: {*}.vym \end{verbatim}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \section{Aider \vym}
insilmaril@719: 
insilmaril@719: J'ai écrit personnellement 98\% du code moi-même. Aucune surprise
insilmaril@719: : \vym correspond exactement à mes besoins. Néanmoins j'encourage
insilmaril@719: tous les utilisateurs de \vym à contribuer. Peut-être pas seulement
insilmaril@719: avec des demandes d'extensions, mais aussi avec du code, de nouveaux
insilmaril@719: filtres import/export, des traductions, etc. Dans cet appendice, je
insilmaril@719: vais essayer de montrer combien il est facile de développer avec \vym.
insilmaril@719: J'attends vraiment de vos nouvelles au sujet de vos futures extensions
insilmaril@719: !
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \section{Obtenir de l'aide}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection*{Foire Aux Questions}
insilmaril@719: 
insilmaril@719: Pointer la FAQ disponible sur le site de \vym (en anglais) :
insilmaril@719: 
insilmaril@719: \begin{center}
insilmaril@719: \href{http://www.InSilmaril.de/vym/faq.html}{http://www.InSilmaril.de/vym/faq.html} 
insilmaril@719: \par\end{center}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection*{Mailinglists}
insilmaril@719: 
insilmaril@719: Il y a deux mailinglists: 
insilmaril@719: \begin{itemize}
insilmaril@719: \item \texttt{vym-forum} est le forum des utilisateurs \vym pour discuter
insilmaril@719: de points divers, 
insilmaril@719: \item \texttt{vym-devel} est fait pour les gens qui veulent contribuer à
insilmaril@719: \vym. 
insilmaril@719: \end{itemize}
insilmaril@719: Vous pouvez voir les archives et vous inscrire à :
insilmaril@719: 
insilmaril@719: \begin{center}
insilmaril@719: \href{https://sourceforge.net/mail/?group_id=127802}{https://sourceforge.net/mail/?group\_id=127802} 
insilmaril@719: \par\end{center}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection*{Contacter l'auteur}
insilmaril@719: 
insilmaril@719: \label{author} En premier essayer les mailinglists. Pour tout autre
insilmaril@719: problème contacter l'auteur Uwe Drechsel à :
insilmaril@719: 
insilmaril@719: \begin{center}
insilmaril@719: \href{mailto:vym@InSilmaril.de}{vym@InSilmaril.de} 
insilmaril@719: \par\end{center}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \section{Comment reporter un bug}
insilmaril@719: 
insilmaril@719: Quoique Sourceforge ait son propre système de rapport de bugs, je
insilmaril@719: préfère que vous me contactiez directement (voir \ref{author}) ou
insilmaril@719: encore mieux : vous pouvez mettre un rapport de bug dans Bugzilla,
insilmaril@719: le système de rapport de bugs de openSUSE : 
insilmaril@719: 
insilmaril@719: \begin{center}
insilmaril@719: \href{http://en.opensuse.org/Submit_a_bug}{http://en.opensuse.org/Submit\_a\_bug} 
insilmaril@719: \par\end{center}
insilmaril@719: 
insilmaril@719: Je construis \vym régulièrement pour openSUSE, vous pouvez faire
insilmaril@719: un rapport pour une autre version , même si vous utilisez un autre
insilmaril@719: système d'exploitation. N'oubliez pas de me dire lequel vous utilisez
insilmaril@719: :
insilmaril@719: \begin{itemize}
insilmaril@719: \item les manipulations exactes pour reproduire le bug,
insilmaril@719: \item la version et la date de construction de \vym (voir l'aide Help \ra
insilmaril@719: About \vym) 
insilmaril@719: \item le matériel et le système d'exploitation
insilmaril@719: \end{itemize}
insilmaril@719: 
insilmaril@719: \section{Compiler à partir des sources }
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Obtenir les sources}
insilmaril@719: 
insilmaril@719: \label{getsources} Vous pouvez trouver la dernière version de \vym
insilmaril@719: sur le site du projet :
insilmaril@719: 
insilmaril@719: \begin{center}
insilmaril@719: \href{https://sourceforge.net/projects/vym/}{https://sourceforge.net/projects/vym/} 
insilmaril@719: \par\end{center}
insilmaril@719: 
insilmaril@719: Là vous pouvez les extraire à partir à partir du dépot des source
insilmaril@719: (CVS):\\
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \begin{verbatim} cvs -d:pserver:anonymous@cvs.sf.net:/cvsroot/vym
insilmaril@719: checkout code \end{verbatim}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{le toolkit Qt }
insilmaril@719: 
insilmaril@719: Qt est une trousse à outils C++ multiplateforme pour les GUI%
insilmaril@719: \footnote{GUI Graphical User Interface interface graphique pour l'utilisateur
insilmaril@719: (N.d.T.)%
insilmaril@719: } et le développent d'applications. Il fournit une portabilité avec
insilmaril@719: le même source sur MS~Windows, Mac~OS~X, Linux et toutes les versions
insilmaril@719: principales commerciales d'Unix. Qt est aussi disponible pour les
insilmaril@719: systèmes embarqués. Qt est un produit de la société Trolltech. Pour
insilmaril@719: plus d'informations voir :
insilmaril@719: 
insilmaril@719: \begin{center}
insilmaril@719: \href{http://www.trolltech.com/qt/}{www.trolltech.com/qt} 
insilmaril@719: \par\end{center}
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Compiler \vym }
insilmaril@719: 
insilmaril@719: Assurez vous que vous avez installé l'environnement QT proprement,
insilmaril@719: voir la documentation pour les détails. Vous devez avoir la commande
insilmaril@719: Qt\texttt{ qmake} dans votre variable d'environnement \texttt{PATH},
insilmaril@719: pusi lancez \begin{verbatim} \$ qmake $make$ make install \end{verbatim}
insilmaril@719: La dernière commande \texttt{make install} a besoin des droits root.
insilmaril@719: Elle n'est pas nécessaire si vous voulez juste tester \vym.
insilmaril@719: 
insilmaril@719: %\subsubsection*{Compiling \vym on Macs}
insilmaril@719: %FIXME
insilmaril@719: 
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{format des fichiers de \vym }
insilmaril@719: 
insilmaril@719: \label{fileformat}Les cartes \vym ont un suffixe \texttt{\og .vym} \fg{}
insilmaril@719: et représentent une archive compressée des données. Si vous voulez
insilmaril@719: avoir une vue plus précise de la structure des données dans la carte
insilmaril@719: \og mapname.vym \fg{}, décompressez la en lançant la commande :
insilmaril@719: \begin{verbatim} \$ unzip mapname.vym \end{verbatim} Cela va créer
insilmaril@719: les répertoires \texttt{images} et\texttt{ flags} dans votre répertoire
insilmaril@719: courant et aussi la carte elle-même, normalement appelée \texttt{mapname.xml}.
insilmaril@719: La structure XML de \vym s'explique d'elle-même, jetez un \oe il
insilmaril@719: sur le fichier \texttt{mapname.xml}.
insilmaril@719: 
insilmaril@719: Ce fichier XML peut être chargé directement dans \vym, il n'a pas
insilmaril@719: besoin d'être compressé. Si vous voulez compresser toutes les données
insilmaril@719: vous-même faites \begin{verbatim} \$ zip -r mapname.vym . \end{verbatim}
insilmaril@719: pour compresser toutes vos données dans le répertoire courant.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Nouvelles fonctionnalités}
insilmaril@719: 
insilmaril@719: Il y a beaucoup de nouvelles fonctionnalités qui sont installées dans
insilmaril@719: \vym. Avec \vym vous avez reçu un répertoire avec un bon nombre
insilmaril@719: d'exemples de cartes. Vous les trouverez en cliquant Help \ra Open~vym~example~maps.
insilmaril@719: Vous y trouverez la carte \texttt{vym-projectplan.vym}. Elle liste
insilmaril@719: une foule de choses qui seront faites dans le futur. Si vous avez
insilmaril@719: d'autres idées, contactez l'équipe de développement à \texttt{vym-devel@lists.sourceforge.net}.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{support pour de nouvelles langues}
insilmaril@719: 
insilmaril@719: Pour pouvoir ajouter une nouvelle langue à \vym, vous devez disposer
insilmaril@719: des sources (voir \ref{getsources}) et de l'installation de Trolltechs
insilmaril@719: QT. une partie de QT sont des outils de développement, et particulièrement
insilmaril@719: l'outil de traduction \og Linguist \fg{} qui est nécessaire.
insilmaril@719: 
insilmaril@719: Dans quelques distributions Linux, les outils de développement sont
insilmaril@719: un paquetage spécial, par exemple sur SUSE LINUX vous devez avoir
insilmaril@719: installé : \begin{verbatim} libqt4-devel.rpm libqt4-devel-doc.rpm
insilmaril@719: libqt4-devel-tools.rpm \end{verbatim} Si vous n'avez pas QT de base
insilmaril@719: sur votre système, vous pouvez l'obtenir à : \href{http://www.trolltech.com}{http://www.trolltech.com}
insilmaril@719: Une fois que vous êtes capable de compiler, vous pouvez traduire le
insilmaril@719: texte dans \vym  lui-même en faisant les actions suivantes :
insilmaril@719: \begin{itemize}
insilmaril@719: \item supposons que nous voulons traduire une nouvelle langue \og NEW \fg{}
insilmaril@719: au lieu de \og de \fg{} en allemand ou \og en \fg{} en anglais,
insilmaril@719: \item copier le fichier \texttt{lang/vym\_en.ts} to l\texttt{ang/vym\_NEW.ts}
insilmaril@719: (Le code lui-même contient la version anglaise),
insilmaril@719: \item ajouter \texttt{lang/vym\_NEW.ts} dans la section TRANSLATIONS de
insilmaril@719: vym.pro,
insilmaril@719: \item lancer Linguist sur \texttt{vym\_NEW.ts} et faire la traduction,
insilmaril@719: \item lancer \texttt{lrelease} pour créer \texttt{vym\_NEW.qm.}
insilmaril@719: \item faire un make install pour installer le nouveau \vym  et tester la
insilmaril@719: traduction
insilmaril@719: \end{itemize}
insilmaril@719: Si vous vous sentez courageux, vous pouvez traduire le manuel. Il
insilmaril@719: est écrit en \LaTeX{}, vous devez juste changer le fichier \texttt{/tex/vym.tex}.
insilmaril@719: (Linguist et QT ne sont pas nécessaires, mais il est utile de savoir
insilmaril@719: comment travailler avec \LaTeX{} et pdflatex pour créer le PDF.)
insilmaril@719: 
insilmaril@719: S'il vous plaît envoyez moi la traduction que vous avez faite. Je
insilmaril@719: peux aussi vous donner une accès de développeur au projet, si vous
insilmaril@719: voulez fournir régulièrement des traductions.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection{Nouveaux filtres d'export/import }
insilmaril@719: 
insilmaril@719: \vym supporte des types de filtres variés. Les données peuvent être
insilmaril@719: écrites directement, insérées dans des patrons ou peuvent être écrites
insilmaril@719: en données XML et  ensuite être travaillées par des transformations
insilmaril@719: XSL.
insilmaril@719: 
insilmaril@719: La plupart des fonctionnalités d'import-export est disponible dans
insilmaril@719: les classes ImportBase, ExportBase et les classes dérivées. Le tout
insilmaril@719: se trouve dans \texttt{les fichiers imports.h} et \texttt{exports.h}.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection*{import/export direct}
insilmaril@719: 
insilmaril@719: Un exemple pour l'export direct est l'export XML. Cette méthode touche
insilmaril@719: l'implémentation de pratiquement tous les objets de \vym, aussi autant
insilmaril@719: que possible utilisez une transformation XSL à la place.
insilmaril@719: 
insilmaril@719: Si vous voulez savoir comment cela est fait, commencez à regarder
insilmaril@719: \texttt{MapEditor::saveToDir} in \texttt{mapeditor.cpp}.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection*{patrons}
insilmaril@719: 
insilmaril@719: Les patrons ont été introduits pour exporter dans le format opendoc
insilmaril@719: utilisé par Open~Office. Pendant que je lisais la spécification du
insilmaril@719: format (plus de 500 pages),%
insilmaril@719: \footnote{ \href{http://www.oasis-open.org/}{http://www.oasis-open.org/}%
insilmaril@719: } j'avais le sentiment que je ne voulais pas écrire l'export à partir
insilmaril@719: de rien. Cela serait trop difficile pour adapter les styles à vos
insilmaril@719: propres besoins par exemple le canevas.
insilmaril@719: 
insilmaril@719: En analysant un document Open~Office existant, je trouvais qu'il
insilmaril@719: y avait un grand nombre d'informations redondantes dans une présentation
insilmaril@719: standard, par exemple chaque Item d'une liste est contenu dans sa
insilmaril@719: propre liste. À la fin j'en arrivai à un style de présentation par
insilmaril@719: défaut, qui peut encore être simplifié, si j'ai du temps de libre
insilmaril@719: \ldots{}
insilmaril@719: 
insilmaril@719: Les patrons existants sont encore en évolution, avant de développer
insilmaril@719: votre propre style contactez moi. De base les étapes suivantes sont
insilmaril@719: nécessaires pour que vous construisiez votre propre style :
insilmaril@719: \begin{enumerate}
insilmaril@719: \item créer un exemple dans Open Office. Utilisez un titre, les noms de
insilmaril@719: auteurs, les entêtes de page, etc que vous pourrez facilement piquer
insilmaril@719: dans le fichier de sortie,
insilmaril@719: \item décompressez le document Open Office dans un répertoire,
insilmaril@719: \item le fichier principal est appelé\texttt{ content.xml}. Toutes les données
insilmaril@719: sont sur une seule ligne. Vous pouvez exploser les marques XML en
insilmaril@719: utilisant le script \texttt{scripts/niceXML}, qui fait partie de la
insilmaril@719: distribution de \vym. 
insilmaril@719: \item copiez la sortie de \texttt{niceXML} dans \texttt{content-template.xml}.
insilmaril@719: \item en regardant dans le détail , vous trouverez nombre de définitions
insilmaril@719: inutilisées, par exemple les styles. Vous pouvez les effacer ou simplement
insilmaril@719: les ignorer.
insilmaril@719: \item Essayez de trouver votre titre, le nom de auteurs. \vym va remplacer
insilmaril@719: les chaînes suivantes lors de l'export :
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \begin{center}
insilmaril@719: \begin{tabular}{lp{4cm}}
insilmaril@719: \texttt{<!-{}- INSERT TITLE -{}->}  & titre de la carte \tabularnewline
insilmaril@719: \texttt{<!-{}- INSERT AUTHOR-{}->}   & auteur\tabularnewline
insilmaril@719: \texttt{<!-{}- INSERT COMMENT -{}->}  & commentaire\tabularnewline
insilmaril@719: \texttt{<!-{}- INSERT PAGES-{}->}  & contenu de la carte \tabularnewline
insilmaril@719: \end{tabular}
insilmaril@719: \par\end{center}
insilmaril@719: 
insilmaril@719: Le contenu lui-même est généré d'une manière similaire en insérant
insilmaril@719: des listes dans \texttt{page-template}. Les remplacements suivants
insilmaril@719: sont effectues :
insilmaril@719: 
insilmaril@719: \begin{center}
insilmaril@719: \begin{tabular}{lp{7cm}}
insilmaril@719: \texttt{<!-{}- INSERT PAGE HEADING-{}->}  & entête de la page (branche principale ou fils, dépendant de l'utilisation
insilmaril@719: des sections) \tabularnewline
insilmaril@719: \texttt{<!-{}- INSERT LIST -{}->}   & tous les fils de la branche du dessus\tabularnewline
insilmaril@719: \end{tabular}
insilmaril@719: \par\end{center}
insilmaril@719: 
insilmaril@719: \end{enumerate}
insilmaril@719: Actuellement les images sont exportées et les notes vont apparaître
insilmaril@719: comme du texte sans mise au format ni couleur.
insilmaril@719: 
insilmaril@719: 
insilmaril@719: \subsection*{XSL Transformation}
insilmaril@719: 
insilmaril@719: \vym utilise des transformations XSL pour l'exportation (par exemple
insilmaril@719: en XHTML) et pour l'importation des données(par exemple les bookmarks
insilmaril@719: KDE). Il faut écrire un peu de code pour fournir le GUI, le reste
insilmaril@719: est fait en utilisant la feuille de style \texttt{.xsl} et en appelant
insilmaril@719: le processeur \texttt{xsltproc, }qui fait partie de libxslun, la librairie
insilmaril@719: C XSLT pour GNOME.
insilmaril@719: \end{document}




