tex/vym_fr.tex
author insilmaril
Wed, 20 May 2009 15:40:14 +0000
changeset 772 e3f722759c7e
parent 764 d0f944a540a1
permissions -rw-r--r--
Fixed segfault when closing a map
insilmaril@764
     1
%% LyX 1.6.2 created this file.  For more info, see http://www.lyx.org/.
insilmaril@719
     2
%% Do not edit unless you really know what you are doing.
insilmaril@719
     3
\documentclass[12pt,french,a4paper]{article}
insilmaril@719
     4
\usepackage[T1]{fontenc}
insilmaril@719
     5
\usepackage[utf8]{inputenc}
insilmaril@719
     6
\setcounter{secnumdepth}{2}
insilmaril@719
     7
\setcounter{tocdepth}{2}
insilmaril@719
     8
\usepackage{array}
insilmaril@719
     9
\usepackage{graphicx}
insilmaril@719
    10
insilmaril@719
    11
\makeatletter
insilmaril@719
    12
insilmaril@719
    13
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% LyX specific LaTeX commands.
insilmaril@719
    14
%% Special footnote code from the package 'stblftnt.sty'
insilmaril@719
    15
%% Author: Robin Fairbairns -- Last revised Dec 13 1996
insilmaril@719
    16
\let\SF@@footnote\footnote
insilmaril@719
    17
\def\footnote{\ifx\protect\@typeset@protect
insilmaril@719
    18
    \expandafter\SF@@footnote
insilmaril@719
    19
  \else
insilmaril@719
    20
    \expandafter\SF@gobble@opt
insilmaril@719
    21
  \fi
insilmaril@719
    22
}
insilmaril@719
    23
\expandafter\def\csname SF@gobble@opt \endcsname{\@ifnextchar[%]
insilmaril@719
    24
  \SF@gobble@twobracket
insilmaril@719
    25
  \@gobble
insilmaril@719
    26
}
insilmaril@719
    27
\edef\SF@gobble@opt{\noexpand\protect
insilmaril@719
    28
  \expandafter\noexpand\csname SF@gobble@opt \endcsname}
insilmaril@719
    29
\def\SF@gobble@twobracket[#1]#2{}
insilmaril@719
    30
%% Because html converters don't know tabularnewline
insilmaril@719
    31
\providecommand{\tabularnewline}{\\}
insilmaril@719
    32
insilmaril@719
    33
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% User specified LaTeX commands.
insilmaril@719
    34
insilmaril@719
    35
insilmaril@719
    36
insilmaril@719
    37
\usepackage{hyperref}
insilmaril@719
    38
insilmaril@719
    39
insilmaril@719
    40
%\usepackage{longtable}
insilmaril@719
    41
insilmaril@719
    42
insilmaril@719
    43
\setlength{\headheight}{0cm}
insilmaril@719
    44
\setlength{\headsep}{0cm}
insilmaril@719
    45
\setlength{\topskip}{0cm}
insilmaril@719
    46
\setlength{\topmargin}{-0.5cm}
insilmaril@719
    47
insilmaril@719
    48
\setlength{\parskip}{1.5ex}
insilmaril@719
    49
\setlength{\parindent}{0cm}
insilmaril@719
    50
\setlength{\oddsidemargin}{0cm}
insilmaril@719
    51
\setlength{\textwidth}{16cm}
insilmaril@719
    52
\setlength{\textheight}{27cm}
insilmaril@719
    53
insilmaril@719
    54
\newlength{\maximgwidth}
insilmaril@719
    55
\setlength{\maximgwidth}{14cm}
insilmaril@719
    56
\newcommand{\maximage}[1]{	
insilmaril@719
    57
\begin{center}
insilmaril@719
    58
\includegraphics[width=\maximgwidth]{#1} 
insilmaril@719
    59
\end{center}
insilmaril@719
    60
}
insilmaril@719
    61
\newcommand{\hint}[1]{
insilmaril@719
    62
\begin{center} 
insilmaril@719
    63
\begin{tabular}{|rp{12cm}|} \hline
insilmaril@719
    64
{\bf Astuce }:& #1\\	\hline
insilmaril@719
    65
\end{tabular}
insilmaril@719
    66
\marginpar{\Huge !} 
insilmaril@719
    67
\end{center} 
insilmaril@719
    68
}
insilmaril@719
    69
insilmaril@719
    70
\newcommand{\vym}{{\sc vym }}
insilmaril@719
    71
\newcommand{\ra}{$\longrightarrow$}
insilmaril@719
    72
\newcommand{\la}{$\longleftarrow$}
insilmaril@719
    73
\newcommand{\ua}{$\uparrow$}
insilmaril@719
    74
\newcommand{\da}{$\downarrow$}
insilmaril@719
    75
\newcommand{\key}[1]{[#1]}
insilmaril@719
    76
insilmaril@719
    77
%\newenvironment{code}[1]{ \verbatim #1}{\endverbatim  }
insilmaril@719
    78
insilmaril@719
    79
\hypersetup{bookmarks, bookmarksopen,
insilmaril@719
    80
  pdftitle={VYM - a tool for visual thinking },
insilmaril@719
    81
  pdfauthor={Uwe Drechsel},    
insilmaril@719
    82
  pdfsubject={map},
insilmaril@719
    83
  pdfkeywords={map, tool},
insilmaril@719
    84
  pdfpagemode={UseOutlines},                                 
insilmaril@719
    85
  bookmarksopenlevel={1},   
insilmaril@719
    86
  colorlinks={true},     
insilmaril@719
    87
  linkcolor={blue},
insilmaril@719
    88
  urlcolor={green},
insilmaril@719
    89
  citecolor={red}} 
insilmaril@719
    90
insilmaril@764
    91
\makeatother
insilmaril@764
    92
insilmaril@719
    93
\usepackage{babel}
insilmaril@719
    94
\addto\extrasfrench{\providecommand{\og}{\leavevmode\flqq~}\providecommand{\fg}{\ifdim\lastskip>\z@\unskip\fi~\frqq}}
insilmaril@719
    95
insilmaril@719
    96
\begin{document}
insilmaril@719
    97
insilmaril@764
    98
\title{\includegraphics[width=8cm,bb = 0 0 200 100, draft, type=eps]{images/vym-logo-new.png}
insilmaril@764
    99
\\
insilmaril@719
   100
 VYM \\
insilmaril@719
   101
 -- \\
insilmaril@719
   102
View Your Mind\\
insilmaril@764
   103
 {\small Version 1.12.0}\\
insilmaril@719
   104
{\small (version française)}}
insilmaril@719
   105
insilmaril@719
   106
insilmaril@719
   107
\author{\textcopyright Uwe Drechsel }
insilmaril@719
   108
insilmaril@719
   109
\maketitle
insilmaril@719
   110
\newpage{}
insilmaril@719
   111
insilmaril@719
   112
\tableofcontents{}
insilmaril@719
   113
insilmaril@719
   114
\newpage{}
insilmaril@719
   115
insilmaril@719
   116
insilmaril@719
   117
\section*{Remerciements}
insilmaril@719
   118
insilmaril@719
   119
Beaucoup de gens m'ont envoyé leurs impressions et leurs idées et
insilmaril@719
   120
tout cela m'a aidé à faire \vym meilleur. Merci à tous !
insilmaril@719
   121
insilmaril@719
   122
Pour ce manuel, je remercie particulièrement :
insilmaril@719
   123
\begin{itemize}
insilmaril@719
   124
\item {\em Peter Adamson} pour un grand nombre de retours et pour la
insilmaril@719
   125
relecture de mon anglais très imparfait,
insilmaril@719
   126
\item L'équite du {\em AClibre (Academia y Conocimiento Libre)} en Colombie
insilmaril@719
   127
pour leur traduction du manuel en espagnol : 
insilmaril@719
   128
insilmaril@719
   129
insilmaril@719
   130
\begin{center}
insilmaril@719
   131
\begin{tabular}{|p{7cm}|p{5.5cm}|}
insilmaril@719
   132
\hline 
insilmaril@719
   133
Encargado  & Actividad \tabularnewline
insilmaril@719
   134
\hline 
insilmaril@719
   135
\begin{itemize}
insilmaril@719
   136
\item Vanessa Carolina Gutiérrez Sanchez 
insilmaril@719
   137
\item Erika Tatiana Luque Melo 
insilmaril@719
   138
\item Jeffrey Steve Borbón Sanabria 
insilmaril@719
   139
\item John Edisson Ortiz Román 
insilmaril@719
   140
\end{itemize}
insilmaril@719
   141
 & \begin{itemize}
insilmaril@719
   142
\item Traducciónl 
insilmaril@719
   143
\item Revisión y correcciones varias 
insilmaril@719
   144
\item Estructuración y exporte 
insilmaril@719
   145
\item Revisión y correcciones varias 
insilmaril@719
   146
\end{itemize}
insilmaril@719
   147
\tabularnewline
insilmaril@719
   148
\hline
insilmaril@719
   149
\end{tabular}
insilmaril@719
   150
\par\end{center}
insilmaril@719
   151
insilmaril@719
   152
\end{itemize}
insilmaril@719
   153
\newpage{}
insilmaril@719
   154
insilmaril@719
   155
insilmaril@719
   156
\section*{Note du traducteur}
insilmaril@719
   157
insilmaril@719
   158
Correspondances entre les mots de la version originale en anglais
insilmaril@719
   159
et la version française. Certains mots trop spécifiques à \vym  ont
insilmaril@719
   160
été gardés en anglais.
insilmaril@719
   161
insilmaril@719
   162
insilmaril@719
   163
\subsection*{traduits}
insilmaril@719
   164
\begin{description}
insilmaril@719
   165
\item [{ancre}] \emph{anchor }
insilmaril@719
   166
\item [{canevas}] \emph{layout }
insilmaril@719
   167
\item [{carte}] \emph{map }
insilmaril@719
   168
\item [{défaire/refaire}] \emph{undo/redo }
insilmaril@719
   169
\item [{emoticon}] \emph{smiley }
insilmaril@719
   170
\item [{escamotage}] \emph{folding }
insilmaril@719
   171
\item [{fils}] \emph{child }
insilmaril@719
   172
\item [{indicateur}] \emph{flag }
insilmaril@719
   173
\item [{menu~de~contexte}] \emph{context menu} 
insilmaril@719
   174
\item [{menu~des~préférences}] \emph{settings menu }
insilmaril@719
   175
\item [{mode~modificateur}] \emph{modifier (CTRL) }
insilmaril@719
   176
\item [{navigateur}] \emph{webbrowser }
insilmaril@719
   177
\item [{onglets}] \emph{bookmark }
insilmaril@719
   178
\item [{patrons}] \emph{frame }
insilmaril@719
   179
\item [{titre}] \emph{heading }
insilmaril@719
   180
\item [{signets}] \emph{bookmark }
insilmaril@719
   181
\item [{sous-arbre}] \emph{jeu de branches en dessous}
insilmaril@719
   182
\item [{barre~de~travail}] \emph{toolbars}
insilmaril@719
   183
\end{description}
insilmaril@719
   184
insilmaril@719
   185
\subsection*{non traduits}
insilmaril@719
   186
\begin{description}
insilmaril@719
   187
\item [{mapeditor}] fenêtre d'édition de la carte 
insilmaril@719
   188
\item [{mapcenter}] milieu du mapeditor 
insilmaril@719
   189
\item [{noteeditor}] fenêtre d'édition des notes
insilmaril@719
   190
\item 
insilmaril@719
   191
\end{description}
insilmaril@719
   192
\clearpage 
insilmaril@719
   193
insilmaril@719
   194
insilmaril@719
   195
\section{Introduction}
insilmaril@719
   196
insilmaril@719
   197
insilmaril@719
   198
\subsection{Qu'est-ce qu'une carte \vym ?}
insilmaril@719
   199
insilmaril@719
   200
Une carte \vym (on abrégera sous le nom de {\em carte}) est une
insilmaril@719
   201
structure en forme d'arbre : \maximage{images/example1_fr.png}
insilmaril@719
   202
De telles cartes peuvent être faites à la main sur une feuille de
insilmaril@719
   203
papier ou en brouillon et aident à structurer vos pensées. Alors qu'une
insilmaril@719
   204
structure en forme d'arbre comme sur l'image ci-dessus peut être tracée
insilmaril@719
   205
à la main, \vym offre des possibilités supplémentaires.
insilmaril@719
   206
insilmaril@719
   207
\vym n'est pas un logiciel de dessin supplémentaire, mais un outil
insilmaril@719
   208
pour mémoriser et modifier l'information de façon intuitive. Par exemple,
insilmaril@719
   209
vous pouvez réorganiser des parties de la carte en appuyant sur une
insilmaril@719
   210
touche ou ajouter des informations comme un email complet simplement
insilmaril@719
   211
par un clic de souris.
insilmaril@719
   212
insilmaril@719
   213
Un fois que vous avez fini de rassembler et d'organiser vos idées
insilmaril@719
   214
vous pouvez générer des sorties ---basées sur une {\em carte}---
insilmaril@719
   215
sous divers formats incluant une présentation dans Open-Office.
insilmaril@719
   216
insilmaril@719
   217
\hint{Vous trouverez la carte ci-dessus et les autres en cliquant
insilmaril@719
   218
:
insilmaril@719
   219
insilmaril@719
   220
\begin{center}
insilmaril@719
   221
Help \ra Open vym examples 
insilmaril@719
   222
\par\end{center}
insilmaril@719
   223
insilmaril@719
   224
dans la barre de menu.}
insilmaril@719
   225
insilmaril@719
   226
insilmaril@719
   227
\subsection{Pourquoi utiliser des {\em cartes}? l'Espace, le Temps et votre
insilmaril@719
   228
cerveau}
insilmaril@719
   229
insilmaril@719
   230
insilmaril@719
   231
\subsubsection*{Espace}
insilmaril@719
   232
insilmaril@719
   233
Une {\em carte} peut concentrer un contenu très complexe sur un
insilmaril@719
   234
petit espace comme une feuille de papier. Cela aide les deux côtés
insilmaril@719
   235
de votre cerveau : le côté logique et le côté créatif (par exemple
insilmaril@719
   236
en utilisant des dessins, des couleurs et des mots clé, souvent appelés
insilmaril@719
   237
{\em ancres}. C'est une technique pour aider à organiser votre
insilmaril@719
   238
façon de penser et stimuler votre créativité : cela vous aide en développant,
insilmaril@719
   239
classant et mémorisant vos idées.
insilmaril@719
   240
insilmaril@719
   241
insilmaril@719
   242
\subsubsection*{Temps}
insilmaril@719
   243
insilmaril@719
   244
Parce que vous utilisez des mots clé et des dessins, c'est plus rapide
insilmaril@719
   245
que les bonnes vieilles \og notes \fg. Votre cerveau mémorise les
insilmaril@719
   246
choses par association avec d'autres choses -- une {\em carte}
insilmaril@719
   247
utilise ces connexions et stimule de nouvelles associations.
insilmaril@719
   248
insilmaril@719
   249
insilmaril@719
   250
\subsubsection*{Votre cerveau}
insilmaril@719
   251
insilmaril@719
   252
En 1960 le professeur \textsc{Roger Sperry} découvre que les deux
insilmaril@719
   253
hémisphères du cerveau humain s'occupent de domaines différents mais
insilmaril@719
   254
{\em peuvent } faire les mêmes choses : 
insilmaril@719
   255
insilmaril@719
   256
\begin{center}
insilmaril@719
   257
\begin{tabular}{|p{5.5cm}|p{5.5cm}|}
insilmaril@719
   258
\hline 
insilmaril@719
   259
Côté gauche  & Côté droit\tabularnewline
insilmaril@719
   260
\hline 
insilmaril@719
   261
\begin{itemize}
insilmaril@719
   262
\item expression verbale et écrite,
insilmaril@719
   263
\item nombres,
insilmaril@719
   264
\item pensée logique, 
insilmaril@719
   265
\item analyse et détails,
insilmaril@719
   266
\item science,
insilmaril@719
   267
\item pensée linéaire,
insilmaril@719
   268
\item concept de temps.
insilmaril@719
   269
\end{itemize}
insilmaril@719
   270
 & \begin{itemize}
insilmaril@719
   271
\item langage du corps, 
insilmaril@719
   272
\item pensée visuelle, rêves éveillés,
insilmaril@719
   273
\item intuition et émotion,
insilmaril@719
   274
\item capacité de synthèse,
insilmaril@719
   275
\item créativité,
insilmaril@719
   276
\item art, musique, danse, 
insilmaril@719
   277
\item pensée non linéaire, relation entre les choses,
insilmaril@719
   278
\item conscience spatiale.
insilmaril@719
   279
\end{itemize}
insilmaril@719
   280
\tabularnewline
insilmaril@719
   281
\hline
insilmaril@719
   282
\end{tabular}
insilmaril@719
   283
\par\end{center}
insilmaril@719
   284
insilmaril@719
   285
Dans notre société des sciences occidentales, nous avons appris à
insilmaril@719
   286
relier principalement le côté gauche de notre cerveau, le côté \og
insilmaril@719
   287
rationel \fg{}. Dans d'autres cultures, comme celles des vieilles
insilmaril@719
   288
cultures indiennes ou d'autres \og vieilles\fg{} cultures, l'autre
insilmaril@719
   289
côté (le droit) est plus important. Les {\em cartes} sont juste
insilmaril@719
   290
un moyen de stimuler l'autre coté et d'utiliser les capacités supplémentaires
insilmaril@719
   291
dont nous disposons tous.
insilmaril@719
   292
insilmaril@719
   293
insilmaril@719
   294
\subsection{Où puis-je utiliser une {\em carte}?}
insilmaril@719
   295
insilmaril@719
   296
Voici quelques exemples et comment vous pouvez utiliser ces {\em
insilmaril@719
   297
cartes} : 
insilmaril@719
   298
\begin{itemize}
insilmaril@719
   299
\item pour préparer des articles, des papiers, des livres, des discussions,
insilmaril@719
   300
etc, 
insilmaril@719
   301
\item pour trier des idées complexes, 
insilmaril@719
   302
\item pour mémoriser des faits, des noms de personnes, du vocabulaire, etc, 
insilmaril@719
   303
\item pour trier des emails, des fichiers et les signets de votre ordinateur, 
insilmaril@719
   304
\item la préparation d'un exposé, 
insilmaril@719
   305
\item des séances de remue-méninges pour résoudre des problèmes, 
insilmaril@719
   306
\item pour enregistrer les tâches lors de l'organisation d'un projet. 
insilmaril@719
   307
\end{itemize}
insilmaril@719
   308
insilmaril@719
   309
\subsection{Ce que vous ne pouvez pas faire avec une {\em carte}...}
insilmaril@719
   310
insilmaril@719
   311
Une {\em carte} tracée par quelqu'un montre la façon de penser
insilmaril@719
   312
de son auteur. Elle n'a pas à être juste ou fausse, elle n'est pas
insilmaril@719
   313
criticable.\og C'est ce que c'est \fg{}(\textsc{F.~Lehmann}).
insilmaril@719
   314
L'outil est d'une très utile à son créateur mais d'un usage très limité
insilmaril@719
   315
pour les autres.
insilmaril@719
   316
insilmaril@719
   317
Cependant quand un groupe s'investit dans la création d'une {\em
insilmaril@719
   318
carte}, tout le groupe bénéficie de son utilisation. Quand un professeur
insilmaril@719
   319
développe une {\em carte} avec un groupe d'élèves pendant un cours
insilmaril@719
   320
ou quand un chef de projet recueille les informations d'un groupe
insilmaril@719
   321
de spcialistes pour l'aider à \og{}{\em encarter}\fg{} les
insilmaril@719
   322
tâches nécessaires pour réaliser ce projet.
insilmaril@719
   323
insilmaril@719
   324
%\section{Tutorials}
insilmaril@719
   325
%TODO
insilmaril@719
   326
insilmaril@719
   327
insilmaril@719
   328
insilmaril@719
   329
\subsection{Ressources internet}
insilmaril@719
   330
insilmaril@719
   331
Un bon point de départ est d'en apprendre plus sur les {\em cartes
insilmaril@719
   332
heuristiques} dans Wikipedia : 
insilmaril@719
   333
\begin{itemize}
insilmaril@719
   334
\item Anglais : \href{http://en.wikipedia.org/wiki/Mind_map}{http://en.wikipedia.org/wiki/Mind\_map} 
insilmaril@719
   335
\item Allemand : \href{http://de.wikipedia.org/wiki/Mindmap}{http://de.wikipedia.org/wiki/Mindmap} 
insilmaril@719
   336
\item Français : \href{http://fr.wikipedia.org/wiki/Mindmap}{http://fr.wikipedia.org/wiki/Mindmap}
insilmaril@719
   337
(N.d.T.)
insilmaril@719
   338
\end{itemize}
insilmaril@719
   339
insilmaril@719
   340
\section{Le Concept de \vym }
insilmaril@719
   341
insilmaril@719
   342
%TODO may add a general introduction here...
insilmaril@719
   343
insilmaril@719
   344
insilmaril@719
   345
insilmaril@719
   346
\subsection{La fenêtre principale et ses satellites}
insilmaril@719
   347
insilmaril@719
   348
\label{satellite} \vym vient avec plusieurs fenêtres, celle centrale
insilmaril@719
   349
est le {\em mapeditor}. D'autres fenêtres, chacune avec une fonction
insilmaril@719
   350
particulière peut être ouverte et installée à côté de la fenêtre principale%
insilmaril@719
   351
\footnote{L'avantage des fenêtres séparées par rapport à une seule est une plus
insilmaril@719
   352
grande flexibilité dans leur position. Par exemple j'utilise le {\em
insilmaril@719
   353
noteeditor} \og derrière \fg{} le {\em mapeditor}. Sur Linux
insilmaril@719
   354
mon gestionnaire de fenêtres (KDE) me permet de rentrer du texte dans
insilmaril@719
   355
un petit coin visible du {\em noteeditor} sans cliquer dessus avec
insilmaril@719
   356
la souris. Je positionne la souris sur la fenêtre pour y concentrer
insilmaril@719
   357
le focus, un concept utile aussi lorsqu'on travaille avec \href{http://www.gimp.org}{http://www.gimp.org}. %
insilmaril@719
   358
}. L'image en dessous montre le {\em mapeditor} avec le {\em noteeditor} souvent
insilmaril@719
   359
utilisé : \maximage{images/windows_fr.png} La plupart du temps
insilmaril@719
   360
vous travaillerez dans le {\em mapeditor} en ajoutant des nouvelles
insilmaril@719
   361
branches, en les déplaçant et en les réarrangeant. Les diverses manières
insilmaril@719
   362
de le faire sont expliquées dans \ref{mapeditor}. Vous pouvez enregistrer
insilmaril@719
   363
des informations complémentaires par exemple le contenu d'un email
insilmaril@719
   364
facilement dans une {\em branche}: copiez et collez dans le {\em
insilmaril@719
   365
noteeditor}. La façon de travailler avec des notes est expliqué dans
insilmaril@719
   366
\ref{noteeditor}.
insilmaril@719
   367
insilmaril@719
   368
Les fenêtres auxiliaires sont : 
insilmaril@719
   369
\begin{itemize}
insilmaril@719
   370
\item Noteeditor (voir \ref{noteeditor}) 
insilmaril@719
   371
\item Fenêtre historique (voir \ref{historywindow}) 
insilmaril@719
   372
\item Fenêtre des propriétés des branches (voir \ref{propwindow}) 
insilmaril@719
   373
\end{itemize}
insilmaril@719
   374
insilmaril@719
   375
\subsection{Menus et menus de contexte}
insilmaril@719
   376
insilmaril@719
   377
En haut de chaque fenêtre se trouve la barre de menus. Certaines options
insilmaril@719
   378
sont sans doute similaires à celles d'autres applications. Notez que
insilmaril@719
   379
beaucoup (et sans doute plus) sont disponibles à travers les {\em
insilmaril@719
   380
menus de contexte}. Ceux-ci sont disponibles si vous appuyez sur
insilmaril@719
   381
bouton droite de la souris en pointant un objet (sur Mac~OS~X Command-Click).
insilmaril@719
   382
insilmaril@719
   383
insilmaril@719
   384
insilmaril@719
   385
insilmaril@719
   386
\subsection{Barres de travail}
insilmaril@719
   387
insilmaril@719
   388
Les barres de travail dans les fenêtres permettent un accès rapide
insilmaril@719
   389
à beaucoup de fonctions et affichent l'état des objets sélectionnés
insilmaril@719
   390
dans la carte. Par exemple une branche peut avoir certains {\em
insilmaril@719
   391
indicateurs} positionnés, ils sont aussi positionnés dans la barre
insilmaril@719
   392
de travail.
insilmaril@719
   393
insilmaril@719
   394
\hint{Vous pouvez repositionner toutes les barres de travail en les
insilmaril@719
   395
déplaçant simplement par la poignée. Par exemple vous pouvez déplacer
insilmaril@719
   396
le menu de travail des indicateurs de sa position d'origine en haut
insilmaril@719
   397
du mapeditor pour une position verticale sur le côté droit, ou le
insilmaril@719
   398
remettre dans sa position originale. Il est possible de cacher certains
insilmaril@719
   399
menus de travail en pointant sa poignée et en cliquant sur le bouton
insilmaril@719
   400
droit de la souris.}
insilmaril@719
   401
insilmaril@719
   402
insilmaril@719
   403
\subsection{Cartes}
insilmaril@719
   404
insilmaril@719
   405
Chaque {\em carte} a son centre {\em mapcenter}. Ce centre a
insilmaril@719
   406
des branches partant dans tous les sens comme celles d'un arbre. Chaque
insilmaril@719
   407
branche peut aussi avoir d'autres branches. \maximage{images/branches_fr.png}
insilmaril@719
   408
Nous appellerons un branche directement connectée au mapcenter une
insilmaril@719
   409
{\em branche principale} car elle détermine la position des autres
insilmaril@719
   410
branches \og fils \fg{}.
insilmaril@719
   411
insilmaril@719
   412
Le mapcenter et les branches ont un {\em titre}. C'est le texte
insilmaril@719
   413
que vous voyez dans le mapeditor. C'est ordinairement un ou plusieurs
insilmaril@719
   414
mots clé, permettant de comprendre facilement toute la carte.
insilmaril@719
   415
insilmaril@719
   416
Dans la barre de menus au-dessous du  mapeditor on voit des symboles
insilmaril@719
   417
variés. \maximage{images/default-flags.png} Nous les appellerons
insilmaril@719
   418
{\em indicateurs}. Ils sont utilisés pour marquer les branches
insilmaril@719
   419
dans la {\em carte}, par exemple si quelque chose est important
insilmaril@719
   420
ou douteux. Il y a aussi des indicateurs positionnés automatiquement
insilmaril@719
   421
par \vym pour des informations supplémentaires, par exemple qu'une
insilmaril@719
   422
note est attachée à une branche particulière.
insilmaril@719
   423
insilmaril@719
   424
Par défaut certains de ces indicateurs sont affichés uniquement quand
insilmaril@719
   425
l'indicateur \og pouce vers le haut \fg{} est positionné. Ils ne
insilmaril@719
   426
le sont plus lorsque l'indicateur \og pouce en bas \fg{} est positionné.
insilmaril@719
   427
Vous pouvez changer ce comportement par défaut dans le menu des préférences
insilmaril@719
   428
(voir \ref{settings}).
insilmaril@719
   429
insilmaril@719
   430
insilmaril@719
   431
\section{Mapeditor}
insilmaril@719
   432
insilmaril@719
   433
\label{mapeditor} 
insilmaril@719
   434
insilmaril@719
   435
insilmaril@719
   436
\subsection{Commencer une nouvelle carte}
insilmaril@719
   437
insilmaril@719
   438
Au démarrage de \vym deux fenêtres vont s'ouvrir : le {\em mapeditor}
insilmaril@719
   439
et le {\em noteditor}. Vous travaillerez avec les deux fenêtres
insilmaril@719
   440
mais pour l'instant nous n'avons besoin que du mapeditor.
insilmaril@719
   441
insilmaril@719
   442
Sélectionner le milieu de la carte \og NEW MAP \fg{} dans le milieu
insilmaril@719
   443
du mapeditor en cliquant le bouton gauche de la souris. Il va s'allumer
insilmaril@719
   444
en jaune pour montrer qu'il est sélectionné. Il y a plusieurs moyens
insilmaril@719
   445
d'ajouter une nouvelle branche au centre :
insilmaril@719
   446
\begin{itemize}
insilmaril@719
   447
\item avec la souris : ouvrir le menu du contexte en cliquant le bouton
insilmaril@719
   448
droit de la souris (CTRL-Click sur Mac) sur le milieu de la carte
insilmaril@719
   449
et choisir \og Add\ra Add branch as child \fg{} (ajouter une branche
insilmaril@719
   450
comme fils).
insilmaril@719
   451
\item Appuyer sur les touches \key{Ins} ou \key{A} 
insilmaril@719
   452
\end{itemize}
insilmaril@719
   453
Une nouvelle branche va apparaître et vous pouvez taper le titre de
insilmaril@719
   454
la branche. Terminer l'ajout en appuyant sur \key{Enter}. %tipp
insilmaril@719
   455
Quelquefois il est pratique d'ajouter une nouvelle branche au-dessus
insilmaril@719
   456
ou au-dessous de la branche courante en faisant au choix :
insilmaril@719
   457
\begin{itemize}
insilmaril@719
   458
\item Touche \key{Shift-A} pour ajouter un branche au-dessus de celle
insilmaril@719
   459
sélectionnée,
insilmaril@719
   460
\item Touche \key{Ctrl-A} pour ajouter une branche en dessous.
insilmaril@719
   461
\end{itemize}
insilmaril@719
   462
Il est aussi possible d'ajouter une branche qui soit le \og père \fg{}
insilmaril@719
   463
de la branche courante, c'est à dire insérer {\em devant}  la branche
insilmaril@719
   464
courante. Cela peut-être fait par le menu de contexte.
insilmaril@719
   465
insilmaril@719
   466
\hint{Pour effacer une branche appuyer sur \key{CTRL-X}. Si cela
insilmaril@719
   467
est validé dans le menu des préférences (voir \ref{settings}), vous
insilmaril@719
   468
pouvez aussi utiliser la touche \key{Del}.}
insilmaril@719
   469
insilmaril@719
   470
insilmaril@719
   471
\subsection{Circuler dans une carte}
insilmaril@719
   472
insilmaril@719
   473
insilmaril@719
   474
\subsubsection*{Sélectionner des branches}
insilmaril@719
   475
insilmaril@719
   476
Pour sélectionner des branches vous pouvez utiliser le bouton gauche
insilmaril@719
   477
de la souris ou les flèches de direction. Suivant l'{\em orientation}
insilmaril@719
   478
du départ de la branche utiliser la touche \key{\la} ou \key{\ra}
insilmaril@719
   479
pour se déplacer plus près de la racine ou plus profondément dans
insilmaril@719
   480
les branches. Dans un jeu de branches que nous appellerons {\em
insilmaril@719
   481
sous-arbre}, vous pouvez utiliser \key{\ua} et \key{\da} pour
insilmaril@719
   482
monter et descendre. Vous pouvez aussi utilisez \key{Home} et \key{End}
insilmaril@719
   483
pour sélectionner la première ou la dernière branche.
insilmaril@719
   484
insilmaril@719
   485
insilmaril@719
   486
\subsubsection*{Déplacer la partie visible de la carte}
insilmaril@719
   487
insilmaril@719
   488
À force d'ajouter des branches, la carte peut devenir plus grande
insilmaril@719
   489
que la fenêtre du mapeditor. Vous pouvez utiliser les ascenseurs à
insilmaril@719
   490
droite et en bas de la fenêtre pour déplacer la vue. C'est plus facile
insilmaril@719
   491
en utilisant le bouton gauche de la souris. Cliquez n'importe où sur
insilmaril@719
   492
la {\em surface active de la fenêtre} : choisissez un espace libre
insilmaril@719
   493
entre des branches. Le pointeur de la souris va se transformer en
insilmaril@719
   494
main, maintenant déplacez la souris pour voir la partie désirée.
insilmaril@719
   495
insilmaril@719
   496
Si vous sélectionnez les branches en utilisant les flèches, la carte
insilmaril@719
   497
va se déplacer pour que la branche sélectionnée soit toujours visible.
insilmaril@719
   498
insilmaril@719
   499
insilmaril@719
   500
\subsubsection*{Zoomer la carte}
insilmaril@719
   501
insilmaril@719
   502
Lorsqu'on travaille sur des grandes cartes, la fonction {\em zoom}
insilmaril@719
   503
devient pratique. Vous pouvez utiliser :
insilmaril@719
   504
\begin{itemize}
insilmaril@719
   505
\item à partir du menu : View \ra Zoom in, View \ra Zoom out, View \ra
insilmaril@719
   506
reset Zoom. 
insilmaril@764
   507
\item la barre de fonction~\includegraphics[width=3cm,bb = 0 0 200 100, draft, type=eps]{images/zoom-buttons.png} 
insilmaril@719
   508
\end{itemize}
insilmaril@719
   509
Cliquer sur la loupe avec la croix rouge ré-affiche la carte à sa
insilmaril@719
   510
taille originale.
insilmaril@719
   511
insilmaril@719
   512
insilmaril@719
   513
\subsubsection*{Fonction de recherche}
insilmaril@719
   514
insilmaril@719
   515
\label{findwindow} Avec une grande carte, une fonction de recherche
insilmaril@719
   516
devient nécessaire. Ouvrir la fenêtre de recherche :
insilmaril@719
   517
insilmaril@719
   518
\begin{center}
insilmaril@764
   519
\includegraphics[width=6cm,bb = 0 0 200 100, draft, type=eps]{images/find-window.png} 
insilmaril@719
   520
\par\end{center}
insilmaril@719
   521
insilmaril@719
   522
La fonction va rechercher le texte dans toutes les branches et dans
insilmaril@719
   523
les notes associées. À chaque fois que vous appuyez sur le bouton
insilmaril@719
   524
\og Find \fg{} il va rechercher la prochaine occurrence qui est
insilmaril@719
   525
sélectionnée automatiquement. Si la recherche échoue, un court mess
insilmaril@719
   526
sage \og Nothing found \fg{} (rien trouvé) va apparaître en bas
insilmaril@719
   527
dans la {\em barre de status} du mapeditor.
insilmaril@719
   528
insilmaril@719
   529
insilmaril@719
   530
\subsubsection*{\label{hideunselected}Garder la visibilité, cacher une partie de
insilmaril@719
   531
la carte}
insilmaril@719
   532
insilmaril@719
   533
Une très grande arborescence (une branche avec une centaine d'enfants
insilmaril@719
   534
par exemple) rend difficile la vue d'ensemble de la carte. Vous pouvez
insilmaril@719
   535
cacher les enfants en les {\em enroulant}. Cette fonction est souvent
insilmaril@719
   536
appelée {\em escamotage} (folding). Pensez que tout le sous-arbre
insilmaril@719
   537
est dessiné sur un rouleau de papier. Vous pouvez le dérouler ou l'enrouler
insilmaril@719
   538
pour ne voir que la première ligne.
insilmaril@719
   539
insilmaril@719
   540
Pour escamoter ou ré-afficher une branche et ses fils vous pouvez
insilmaril@719
   541
au choix : 
insilmaril@719
   542
\begin{itemize}
insilmaril@719
   543
\item appuyez sur \key{Scroll Lock} ou \key{S},
insilmaril@719
   544
\item appuyer sur le bouton milieu de la souris,
insilmaril@719
   545
\item choisir l'icône sur le menu de travail.
insilmaril@719
   546
\end{itemize}
insilmaril@719
   547
Si vous sélectionnez une branche cachée --par la fonction de recherche
insilmaril@719
   548
ou en utilisant les flèches de direction par exemple-- elle va devenir
insilmaril@719
   549
provisoirement visible. Cela est montré comme un défilement avec une
insilmaril@719
   550
petite loupe. Si la partie \og dé-cachée \fg{} n'est plus nécessaire,
insilmaril@719
   551
elle est de nouveau cachée automatiquement. Il est possible de rendre
insilmaril@719
   552
toutes les branches visibles en utilisant le menu \og Edit\ra Unscroll
insilmaril@719
   553
all scrolled branches \fg{}.
insilmaril@719
   554
insilmaril@719
   555
Vous pouvez cacher des parties de la carte pour l'exporter dans une
insilmaril@719
   556
page web ou pour une présentation par exemple voir \ref{hideexport}
insilmaril@719
   557
pour plus de détails.
insilmaril@719
   558
insilmaril@719
   559
insilmaril@719
   560
\subsection{Modifier et déplacer les branches}
insilmaril@719
   561
insilmaril@719
   562
insilmaril@719
   563
\subsubsection*{Modifier le titre}
insilmaril@719
   564
insilmaril@719
   565
On peut éditer le titre en sélectionnant la branche puis au choix
insilmaril@719
   566
:
insilmaril@719
   567
\begin{itemize}
insilmaril@719
   568
\item appuyer sur \key{Enter} 
insilmaril@719
   569
\item ou \key{F2} 
insilmaril@719
   570
\item faire un double clic avec le bouton gauche de la souris.
insilmaril@719
   571
\end{itemize}
insilmaril@719
   572
Écrivez votre nouveau titre (ou éditez le) puis appuyez sur \key{Enter}
insilmaril@719
   573
pour valider.
insilmaril@719
   574
insilmaril@719
   575
insilmaril@719
   576
\subsubsection*{Déplacer une branche}
insilmaril@719
   577
insilmaril@719
   578
Le moyen le plus simple de déplacer une branche est de la sélectionner
insilmaril@719
   579
avec le bouton gauche de la souris et de la déplacer à sa destination
insilmaril@719
   580
en maintenant le bouton enfoncé. Suivant la branche elle sera :
insilmaril@719
   581
\begin{itemize}
insilmaril@719
   582
\item déplacée vers la destination,
insilmaril@719
   583
\item {\em liée } à un nouveau {\em parent} (mapcenter ou branche) 
insilmaril@719
   584
\end{itemize}
insilmaril@719
   585
Si vous déplacez la branche au dessus d'une autre ou du mapcenter,
insilmaril@719
   586
vous pourrez constater que le lien le connectant à l'ancien parent
insilmaril@719
   587
va être changé pour aller au nouveau situé sous le curseur de la souris.
insilmaril@719
   588
Si vous relâchez alors le bouton, la branche va être reliée.
insilmaril@719
   589
insilmaril@719
   590
Si vous relâchez le bouton n'importe où, le résultat dépendra du type
insilmaril@719
   591
de branche que vous déplacez :
insilmaril@719
   592
\begin{itemize}
insilmaril@719
   593
\item Une branche principale directement connectée au mapcenter. Il va rester
insilmaril@719
   594
à sa nouvelle position,
insilmaril@719
   595
\item Une autre branche \og ordinaire \fg{} va rejoindre sa position d'origine.
insilmaril@719
   596
\end{itemize}
insilmaril@719
   597
Vous pouvez ainsi facilement réarranger la disposition des branches
insilmaril@719
   598
principales pour qu'elles ne recouvrent pas leurs branches filles.
insilmaril@719
   599
Il y a un autre avantage à déplacer les branches, surtout si vous
insilmaril@719
   600
voulez {\em réorganiser} un sous-arbre. Vous pouvez monter ou descendre
insilmaril@719
   601
une branche par l'action suivante au choix :
insilmaril@719
   602
\begin{itemize}
insilmaril@719
   603
\item appuyer sur \key{Page Up} ou \key{Page Down},
insilmaril@719
   604
\item sélectionner Edit \ra Move branch,
insilmaril@764
   605
\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
   606
\end{itemize}
insilmaril@719
   607
%tipp
insilmaril@719
   608
Il y a un autre moyen de déplacer des branches : si vous appuyez sur
insilmaril@719
   609
\key{Shift} or \key{Ctrl} en bougeant la souris, la branche va
insilmaril@719
   610
être ajoutée au-dessus ou au-dessous de la branche sur laquelle la
insilmaril@719
   611
souris est. Cela peut être utilisé pour classer les branches dans
insilmaril@719
   612
une carte.
insilmaril@719
   613
insilmaril@719
   614
insilmaril@719
   615
\subsection{Des couleurs et des images : utiliser le côté droit de votre cerveau}
insilmaril@719
   616
insilmaril@719
   617
insilmaril@719
   618
\subsubsection*{Changer la couler d'un titre}
insilmaril@719
   619
insilmaril@719
   620
Vous pouvez utiliser des couleurs pour mettre plus d'informations
insilmaril@719
   621
sur la carte par exemple mettre du rouge, du vert et d'autres couleurs
insilmaril@719
   622
pour montrer la priorité des tâches. Pour ce faire : 
insilmaril@719
   623
\begin{itemize}
insilmaril@719
   624
\item utiliser le menu et choisir : Format \ra Set Color 
insilmaril@719
   625
\item utiliser la barre de menu :
insilmaril@719
   626
insilmaril@719
   627
insilmaril@719
   628
\begin{center}
insilmaril@764
   629
\includegraphics[width=3cm,bb = 0 0 200 100, draft, type=eps]{images/color-buttons.png} 
insilmaril@719
   630
\par\end{center}
insilmaril@719
   631
insilmaril@719
   632
\end{itemize}
insilmaril@719
   633
Le premier bouton (noir dans la figure ci-dessus) montre la couleur
insilmaril@719
   634
courante. Cliquer dessus vous permet de choisir une autre couleur.
insilmaril@719
   635
Vous pouvez \og piquer \fg{} la couleur d'une autre branche en la
insilmaril@719
   636
sélectionnant et en utilisant le bouton \og pipette \fg{}. Les deux
insilmaril@719
   637
icônes avec une palette colorent la branche sélectionnée avec la couleur
insilmaril@719
   638
courante. Alors que la première ne colore que la sélection, la deuxième
insilmaril@719
   639
colore tous les fils de la branche sélectionnée.
insilmaril@719
   640
insilmaril@719
   641
%tipp
insilmaril@719
   642
Une autre fonction très utile est le \og copier couleur \fg{} en
insilmaril@719
   643
utilisant la souris : sélectionner une branche qui doit avoir la nouvelle
insilmaril@719
   644
couleur appuyez \key{Ctrl} et simultanément cliquez avec le bouton
insilmaril@719
   645
gauche sur une autre branche pour copier sa couleur dans la branche
insilmaril@719
   646
sélectionnée. Tout le sous-arbre sera coloré. Si vous ne voulez colorer
insilmaril@719
   647
que la sélection appuyez sur \key{Shift} au lieu de \key{Ctrl}.
insilmaril@719
   648
insilmaril@719
   649
insilmaril@719
   650
\subsubsection*{Utiliser les indicateurs}
insilmaril@719
   651
insilmaril@719
   652
\vym possède des indicateurs variés. Ils sont visibles dans la barre
insilmaril@719
   653
de menu en haut de la mapeditor. (Note : Comme toutes les barres de
insilmaril@719
   654
menu, vous pouvez les déplacer sur le côté droit ou gauche ou même
insilmaril@719
   655
les détacher. Prenez la ligne pointillée à gauche de la barre de menu
insilmaril@719
   656
avec le bouton gauche de la souris.) \maximage{images/default-flags.png}
insilmaril@719
   657
Si vous avez une branche sélectionnée, vous pouvez positionner n'importe
insilmaril@719
   658
quel indicateur en les cliquant sur la barre de menu. Les boutons
insilmaril@719
   659
de la barre de menu changent d'état et reflètent l'état des indicateurs
insilmaril@719
   660
de la branche sélectionnée. Ainsi pour effacer un indicateur d'une
insilmaril@719
   661
branche, sélectionnez la branche et cliquez sur le bouton de la barre
insilmaril@719
   662
de menu enfonce.
insilmaril@719
   663
insilmaril@719
   664
Pour l'instant \vym utilise deux sortes d'indicateurs : les {\em
insilmaril@719
   665
Indicateurs Standard} et les {\em Indicateurs Système}. Les indicateurs
insilmaril@719
   666
standard sont ceux que l'on voit dans la barre de menu. Les Indicateurs
insilmaril@719
   667
Système sont positionnés par \vym pour indiquer qu'il y a par exemple
insilmaril@719
   668
de l'information supplémentaire dans une note (plus d'information
insilmaril@719
   669
dans \ref{noteeditor}). Dans des versions futures de \vym il pourra
insilmaril@719
   670
y avoir une autre sorte d'indicateurs éditables par l'utilisateur.
insilmaril@719
   671
insilmaril@719
   672
insilmaril@719
   673
\subsubsection*{Images}
insilmaril@719
   674
insilmaril@719
   675
Le moyen le plus simple pour ajouter une image à une branche est de
insilmaril@719
   676
la déplaçer par exemple à partir d'un navigateur dans le mapeditor
insilmaril@719
   677
pendant qu'elle branche est sélectionnée.
insilmaril@719
   678
insilmaril@719
   679
Vous pouvez aussi ajouter une image en ouvrant le menu contextuel
insilmaril@719
   680
d'une branche. Cliquez à droite sur la branche sélectionnée, choisissez
insilmaril@719
   681
\og Add Image \fg{}. Une fenêtre de dialogue vous permet de la choisir.%
insilmaril@719
   682
\footnote{Les formats d'images supportés sont : PNG, BMP, XBM, XPM et PNM. Sont
insilmaril@719
   683
aussi supportables JPEG, MNG et GIF, si spécialement configuré pendant
insilmaril@719
   684
la compilation dans  SUSE LINUX).%
insilmaril@719
   685
} Quand une image est sélectionnée dans le dialogue, un aperçu est
insilmaril@719
   686
affiché. Il est possible de sélectionner plusieurs images.
insilmaril@719
   687
insilmaril@719
   688
Vous pouvez placer l'image où vous voulez, vous n'avez qu'à la déplacer
insilmaril@719
   689
avec la souris en appuyant sur le bouton gauche. Pour la lier à une
insilmaril@719
   690
autre branche, appuyer sur la touche \key{Shift} en la déplaçant.
insilmaril@719
   691
Pour l'effacer appuyer sur la touche \key{Del}.
insilmaril@719
   692
insilmaril@719
   693
Si vous cliquez à droite sur une image, un menu de contexte s'ouvre
insilmaril@719
   694
qui vous permet de sélectionner un des multiples format d'image. Puis
insilmaril@719
   695
une fenêtre s'affiche pour sauver l'image.
insilmaril@719
   696
insilmaril@719
   697
\hint{On utilise cela  pour \og exporter \fg{} l'image, l'image
insilmaril@719
   698
sera sauvegardée dans la carte elle-même. Vous pouvez aussi copier-coller
insilmaril@719
   699
des images mais il n'est pas possible de lui ajouter des objets. Les
insilmaril@719
   700
images sont considérées comme des \og particularités supplémentaires%
insilmaril@719
   701
\footnote{extra feature (N.d.T.)%
insilmaril@719
   702
} \fg{}. Elles pourraient rendre le travail avec la carte beaucoup
insilmaril@719
   703
plus complexe par exemple en liant des images à des images.}
insilmaril@719
   704
insilmaril@719
   705
L'option \og Use for export \fg{} contrôle la sortie des exportations
insilmaril@719
   706
par exemple en HTML : si positionné à NON, l'image n'apparaîtra pas
insilmaril@719
   707
dans le {\em texte} de la sortie. C'est utile pour les grandes
insilmaril@719
   708
images ou si des images sont utilisées comme trames comme par exemple
insilmaril@719
   709
le nuage autour d'une partie de la carte. Elle n'apparaîtront pas
insilmaril@719
   710
au milieu du texte.
insilmaril@719
   711
insilmaril@719
   712
Pour le moment le support des images est provisoire : les images sont
insilmaril@719
   713
sauvées avec les autres données de la carte dans le fichier \texttt{.vym}.
insilmaril@719
   714
Des versions futures incluront plus de possibilités comme le redimensionnement
insilmaril@719
   715
des images et changer sa transparence et l'inclure dans le fond de
insilmaril@719
   716
la carte), etc.
insilmaril@719
   717
insilmaril@719
   718
insilmaril@719
   719
\subsubsection*{Trames}
insilmaril@719
   720
insilmaril@719
   721
Une trame peut être ajoutée à une branche dans la {\em fenêtre des
insilmaril@719
   722
propriétés} (voir \ref{propwindow}). Vous pouvez aussi utiliser
insilmaril@719
   723
des images comme trames. Regardez la carte de démonstration \texttt{todo.vym}
insilmaril@719
   724
comme exemple, où le mapcenter est un nuage. Vous pouvez utiliser
insilmaril@719
   725
un programme de dessin externe comme\texttt{ gimp} pour créer une
insilmaril@719
   726
image, de préférence avec un canal de transparence, ainsi vous pouvez
insilmaril@719
   727
créer des trames qui n'ont pas de bord rectangulaire, comme un nuage.
insilmaril@719
   728
insilmaril@719
   729
insilmaril@719
   730
\subsection{Conception du fond des cartes et des liens de connections}
insilmaril@719
   731
insilmaril@719
   732
La conception du fond d'une carte et aussi des liens reliant les diverses
insilmaril@719
   733
parties de la carte peuvent être changés par :
insilmaril@719
   734
\begin{itemize}
insilmaril@719
   735
\item la sélection du format à partir du menu,
insilmaril@719
   736
\item en cliquant à droite sur le fond de la carte, ce qui ouvre un menu
insilmaril@719
   737
de contexte.
insilmaril@719
   738
\end{itemize}
insilmaril@719
   739
insilmaril@719
   740
\subsubsection*{Trame de fond}
insilmaril@719
   741
insilmaril@719
   742
La couleur est choisie (et aussi affichée) par \og Set background
insilmaril@719
   743
colour \fg{}. Vous pouvez aussi choisir une image de fond d'écran
insilmaril@719
   744
quoique cela ne soit pas recommandé. Travailler sur la carte devient
insilmaril@719
   745
lent et l'image ne peut être positionnée librement.
insilmaril@719
   746
insilmaril@719
   747
insilmaril@719
   748
\subsubsection*{Couleur des liaisons}
insilmaril@719
   749
insilmaril@719
   750
Les liaisons reliant les branches peuvent être colorées de deux façons
insilmaril@719
   751
: 
insilmaril@719
   752
\begin{itemize}
insilmaril@719
   753
\item utiliser la même couleur pour le titre et la ligne représentant la
insilmaril@719
   754
liaison,
insilmaril@719
   755
\item utiliser {\em une} couleur pour toutes les liaisons et choisir
insilmaril@719
   756
des couleurs différentes pour les titres. La couleur par défaut des
insilmaril@719
   757
liaisons des branches est bleu.
insilmaril@719
   758
\end{itemize}
insilmaril@719
   759
Cette dernière couleur peut être choisie par \og Set link colour \fg{}.
insilmaril@719
   760
Positionner ou invalider l'option \og Use colour of heading for link \fg{}
insilmaril@719
   761
pour basculer entre deux choix dans votre dessin.
insilmaril@719
   762
insilmaril@719
   763
insilmaril@719
   764
\subsubsection*{Style de liaison}
insilmaril@719
   765
insilmaril@719
   766
\vym offre quatre styles différents pour l'apparence des liaisons
insilmaril@719
   767
:
insilmaril@719
   768
\begin{itemize}
insilmaril@719
   769
\item ligne,
insilmaril@719
   770
\item parabole,
insilmaril@719
   771
\item grosse ligne,
insilmaril@719
   772
\item parabole épaisse.
insilmaril@719
   773
\end{itemize}
insilmaril@719
   774
Les styles \og épais \fg{} ne sont actifs que pour les liaisons
insilmaril@719
   775
partant du mapcenter, les liaisons pour le reste de la carte sont
insilmaril@719
   776
toujours \og fines \fg{}.
insilmaril@719
   777
insilmaril@719
   778
insilmaril@719
   779
\subsection{Liens à d'autres documents et aux pages web}
insilmaril@719
   780
insilmaril@719
   781
\vym admet deux types de liens externes :
insilmaril@719
   782
\begin{itemize}
insilmaril@719
   783
\item document qui va être ouvert dans un navigateur externe,
insilmaril@719
   784
\item carte \vym, qui sera ouverte par \vym lui-même.
insilmaril@719
   785
\end{itemize}
insilmaril@719
   786
En supplément aux liens externes, il y en a d'autres internes, reliant
insilmaril@719
   787
une branche à une autre sur la même carte. Elles sont appelées {\em
insilmaril@719
   788
XLinks} et sont expliquées à la section ~\ref{xlinks}.
insilmaril@719
   789
insilmaril@719
   790
insilmaril@719
   791
\subsubsection*{navigateur}
insilmaril@719
   792
insilmaril@719
   793
Les navigateurs modernes comme \texttt{konqueror et Firefox} sont
insilmaril@719
   794
capables d'afficher des types de fichiers variés locaux ou sur Internet.
insilmaril@719
   795
Pour saisir l'~URL d'un document appuyez sur la touche \key{U}
insilmaril@719
   796
ou cliquez à droite sur une branche pour ouvrir le menu contextuel
insilmaril@719
   797
puis choisir \og References\ra Edit URL \fg{}. Si vous voulez ouvrir
insilmaril@719
   798
une fenêtre de dialogue pour choisir plus facilement un fichier local
insilmaril@719
   799
tapez ~\key{SHIFT-U}.
insilmaril@719
   800
insilmaril@719
   801
Lorsqu'une URL a été entrée, un petit globe apparaît dans la branche.
insilmaril@719
   802
On cliquant sur ce globe ou dans le menu contextuel, le navigateur%
insilmaril@719
   803
\footnote{Le navigateur peut être changé dans le menu Settings (voir \ref{settings}).%
insilmaril@719
   804
} externe sera lancé :
insilmaril@719
   805
insilmaril@719
   806
\begin{center}
insilmaril@764
   807
\includegraphics[width=0.5cm,bb = 0 0 200 100, draft, type=eps]{images/flag-url.png} 
insilmaril@719
   808
\par\end{center}
insilmaril@719
   809
insilmaril@719
   810
Pour plus d'informations sur le travail avec les signets et les navigateurs
insilmaril@719
   811
voir \ref{bookmarks}.
insilmaril@719
   812
insilmaril@719
   813
Dans le menu de contexte, il y a une option pour ouvrir toutes les
insilmaril@719
   814
URL trouvées dans le sous-arbre de la branche sélectionnée. C'est
insilmaril@719
   815
très pratique pour ouvrir tout un jeu de liens dans le navigateur
insilmaril@719
   816
surtout si celui-ci dispose d'index (comme \texttt{konqueror}%
insilmaril@719
   817
\footnote{ou \texttt{firefox} (N. d. T.)%
insilmaril@719
   818
}).
insilmaril@719
   819
insilmaril@719
   820
insilmaril@719
   821
\subsubsection*{carte \vym }
insilmaril@719
   822
insilmaril@719
   823
Pour lier une branche à une autre carte \vym  cliquer à droite sur
insilmaril@719
   824
une branche et choisir : \og Édit \vym links \fg{}. Une fenêtre
insilmaril@719
   825
de dialogue sur les fichiers s'ouvre pour vous permettre de choisir
insilmaril@719
   826
le fichier voulu. Une branche avec un lien est marquée par :
insilmaril@719
   827
insilmaril@719
   828
\begin{center}
insilmaril@764
   829
\includegraphics[width=0.5cm,bb = 0 0 200 100, draft, type=eps]{images/flag-vymlink.png} 
insilmaril@719
   830
\par\end{center}
insilmaril@719
   831
insilmaril@719
   832
Cliquer sur cet indicateur, dans la barre de menu ou dans le menu
insilmaril@719
   833
de contexte va ouvrir cette carte dans un autre onglet. (voir \ref{tabs}
insilmaril@719
   834
pour le travail sur plusieurs cartes). Pour effacer un lien existant,
insilmaril@719
   835
cliquer à droite sur la branche et choisir \og Delete \vym link \fg{}.
insilmaril@719
   836
insilmaril@719
   837
Dans le menu contextuel, il y a aussi une option pour ouvrir tous
insilmaril@719
   838
les liens vers des fichiers \vym  du sous-arbre de la branche sélectionnée
insilmaril@719
   839
dans la carte. C'est utile pour ouvrir simultanément une collection
insilmaril@719
   840
de cartes en relation avec la carte courante.
insilmaril@719
   841
insilmaril@719
   842
Note technique : en interne \vym utilise des chemins absolus, pour
insilmaril@719
   843
éviter d'ouvrir plusieurs fois la même carte. Quand la carte est sauvegardée,
insilmaril@719
   844
le chemin est converti en relatif (par exemple \texttt{/home/user/vym.map}
insilmaril@719
   845
devient\texttt{ ./vym.map}. Cela rend aisé d'utiliser des cartes différentes
insilmaril@719
   846
sur plusieurs ordinateurs et de les exporter en HTML pour plus tard.
insilmaril@719
   847
insilmaril@719
   848
insilmaril@719
   849
\subsection{cartes multiples}
insilmaril@719
   850
insilmaril@719
   851
\label{tabs} Vous pouvez travailler sur plusieurs cartes en même
insilmaril@719
   852
temps. Chaque nouvelle carte est ouverte dans un {\em onglet}.
insilmaril@719
   853
Les onglets des cartes disponibles sont situés en haut du mapeditor.
insilmaril@719
   854
Vous pouvez utiliser les fonctions couper-copier-coller pour transférer
insilmaril@719
   855
des données d'une carte à l'autre.
insilmaril@719
   856
insilmaril@719
   857
%todo
insilmaril@719
   858
insilmaril@719
   859
insilmaril@719
   860
%TODO
insilmaril@719
   861
%\subsubsection{Menus}
insilmaril@719
   862
%\subsubsection{Keyboard shortcuts}
insilmaril@719
   863
insilmaril@719
   864
insilmaril@719
   865
% Settings
insilmaril@719
   866
% Images
insilmaril@719
   867
% Copy & Paste
insilmaril@719
   868
% Working with tabs (multiple maps)
insilmaril@719
   869
% Exporting
insilmaril@719
   870
% Scrolling
insilmaril@719
   871
insilmaril@719
   872
insilmaril@719
   873
insilmaril@719
   874
\section{Noteeditor}
insilmaril@719
   875
insilmaril@719
   876
\label{noteeditor}Si vous voulez mettre plus de texte sur une branche
insilmaril@719
   877
(par exemple un email complet ou une recette de cuisine ou une palanquée
insilmaril@719
   878
de code source) vous pouvez utiliser le noteeditor. \maximage{images/noteeditor_fr.png}
insilmaril@719
   879
Cet éditeur affiche le texte associé à la branche sélectionnée dans
insilmaril@719
   880
le mapeditor. 
insilmaril@719
   881
insilmaril@719
   882
insilmaril@719
   883
\subsection{États}
insilmaril@719
   884
insilmaril@719
   885
Avant de pouvoir écrire ou mettre du texte dans le noteeditor, vous
insilmaril@719
   886
devez sélectionner une branche dans le mapeditor. La couleur du fond
insilmaril@719
   887
du noteeditor indique son état : 
insilmaril@719
   888
\begin{itemize}
insilmaril@719
   889
\item gris : pas de texte,
insilmaril@719
   890
\item blanc : du texte existe.
insilmaril@719
   891
\end{itemize}
insilmaril@719
   892
Dans le mapeditor, pour signaler qu'il y a une note avec plus d'informations
insilmaril@719
   893
pour une branche particulière, un petit indicateur \og note \fg{}
insilmaril@719
   894
apparaît dans l'entête de la branche. Regardez dans la branche en
insilmaril@719
   895
bas à droite de la carte suivante :\maximage{images/branches-flags_fr.png}
insilmaril@719
   896
insilmaril@719
   897
insilmaril@719
   898
\subsection{Importer et exporter des notes }
insilmaril@719
   899
insilmaril@719
   900
Une note est automatiquement sauvée dans la carte \vym. Il est agréable
insilmaril@719
   901
d'importer une note à partir d'un fichier externe ou d'écrire cette
insilmaril@719
   902
note dans un fichier externe. Dans le noteeditor utiliser \og File\ra~Import \fg{}
insilmaril@719
   903
et \og File\ra~Export \fg{} pour l'import-export.
insilmaril@719
   904
insilmaril@719
   905
insilmaril@719
   906
\subsection{Éditer et imprimer une note}
insilmaril@719
   907
insilmaril@719
   908
L'édition fonctionne comme un éditeur de texte classique, incluant
insilmaril@719
   909
les fonctions annule-recommence. Vous pouvez effacer entièrement la
insilmaril@719
   910
note en cliquant sur la corbeille. En cliquant sur le bouton d'impression
insilmaril@719
   911
seule la note et imprimée.
insilmaril@719
   912
insilmaril@719
   913
insilmaril@719
   914
\subsection{RichText: couleurs, paragraphes et texte formatté}
insilmaril@719
   915
insilmaril@719
   916
\vym supporte le texte formatté (QT Rich Text) dans le noteeditor
insilmaril@719
   917
depuis la version 1.4.7. Les couleurs et les attributs de texte (par
insilmaril@719
   918
exemple italique, gras) sont positionnés avec les boutons au-dessus
insilmaril@719
   919
du texte. Le texte lui-même est divisé en paragraphes. Pour chaque
insilmaril@719
   920
paragraphe l'alignement peut être spécifié (par exemple centré ou
insilmaril@719
   921
à droite). Un paragraphe est terminé par appui sur la touche \key{Return}.
insilmaril@719
   922
Si vous voulez juste commencer une nouvelle ligne tapez \key{CTRL-Return}.
insilmaril@719
   923
insilmaril@719
   924
insilmaril@719
   925
\subsection{Les fontes et comment les changer rapidement}
insilmaril@719
   926
insilmaril@719
   927
Le noteeditor est fait pour éditer de petites notes, ce n'est pas
insilmaril@719
   928
un traitement de texte complet. Suite à beaucoup de demandes, \vym
insilmaril@719
   929
supporte le texte formatté dans le noteeditor%
insilmaril@719
   930
\footnote{\vym utilise le format QRichtText, qui est un sous-ensemble du formattage
insilmaril@719
   931
fourni en HTML.%
insilmaril@719
   932
}. Deux fontes par défaut sont installées qui peuvent être choisies
insilmaril@719
   933
par le \og Settings menu \fg{} (voir \ref{settings}). Une fonte
insilmaril@719
   934
à chasse fixe, l'autre variable. La fonte à chasse fixe est utilisée
insilmaril@719
   935
pour les emails, le code source, etc l'autre pour les simples notes.
insilmaril@719
   936
Les deux fontes peuvent être facilement commutées en cliquant sur
insilmaril@719
   937
le bouton suivant dans la barre de menu :
insilmaril@719
   938
insilmaril@719
   939
\begin{center}
insilmaril@764
   940
\includegraphics[width=0.5cm,bb = 0 0 200 100, draft, type=eps]{images/formatfixedfont.png} 
insilmaril@719
   941
\par\end{center}
insilmaril@719
   942
insilmaril@719
   943
Dans le \og Settings menu \fg{} les deux fontes peuvent être choisies.
insilmaril@719
   944
La fonte par défaut peut aussi être changée en sélectionnant ou désélectionnant
insilmaril@719
   945
\og fixed font is default \fg{}.
insilmaril@719
   946
insilmaril@719
   947
En supplément toute fonte installée sur votre système peut être utilisée.
insilmaril@719
   948
Notez que la fonte choisie sera aussi utilisée pour les exports HTML,
insilmaril@719
   949
si vous voulez exporter votre carte \vym  l'intranet ou sur le web,
insilmaril@719
   950
vous devrez utiliser des fontes disponibles partout.
insilmaril@719
   951
insilmaril@719
   952
insilmaril@719
   953
\subsection{Recherche de texte}
insilmaril@719
   954
insilmaril@719
   955
Le noteeditor n'a pas sa propre fonction de recherche, utiliser \og Find \fg{}
insilmaril@719
   956
dans le mapeditor qui recherche également dans toutes les notes (voir
insilmaril@719
   957
\ref{findwindow}).
insilmaril@719
   958
insilmaril@719
   959
insilmaril@719
   960
\subsection{Coller du texte dans le noteeditor}
insilmaril@719
   961
insilmaril@719
   962
Vous voulez souvent coller du texte dans le noteeditor à partir d'une
insilmaril@719
   963
autre application par exemple un email. Normalement \vym va créer
insilmaril@719
   964
un nouveau paragraphe pour chaque ligne. Si ce n'est pas ce que voulez
insilmaril@719
   965
vous pouvez choisir à partir de la barre de menu
insilmaril@719
   966
insilmaril@719
   967
insilmaril@719
   968
\section{Hello world%
insilmaril@719
   969
\footnote{\og bonjour monde \fg{} ou comment faire une carte de base%
insilmaril@719
   970
}}
insilmaril@719
   971
insilmaril@719
   972
Cette section décrit comment \vym réagit au contact d'autres applications.
insilmaril@719
   973
Maintenant beaucoup d'applications lisent et écrivent leurs données
insilmaril@719
   974
en XML, le \og eXtensible Markup Language \fg{}. \vym utilise aussi
insilmaril@719
   975
XML pour sauver ses cartes, voir \ref{fileformat} pour une description
insilmaril@719
   976
plus détaillée.
insilmaril@719
   977
insilmaril@719
   978
Si vous utilisez une autre application qui utilise le XML, il est
insilmaril@719
   979
possible de faire un filtre d'import-export pour \vym. Les volontaires
insilmaril@719
   980
sont accueillis avec plaisir ;-)
insilmaril@719
   981
insilmaril@719
   982
insilmaril@719
   983
\subsection{Import}
insilmaril@719
   984
insilmaril@719
   985
\label{import}
insilmaril@719
   986
insilmaril@719
   987
insilmaril@719
   988
\subsubsection*{Signets KDE }
insilmaril@719
   989
insilmaril@719
   990
L'éditeur de signets intégrés à KDE (Konqueror etc.) est limité, ainsi
insilmaril@719
   991
pourquoi ne pas utiliser \vym pour gérer les signets? Pour créer
insilmaril@719
   992
une nouvelle carte contenant contenant les signets courants choisir
insilmaril@719
   993
: \og File \ra Import\ra KDE Bookmarks \fg{}
insilmaril@719
   994
insilmaril@719
   995
insilmaril@719
   996
\subsubsection*{Mind Manager}
insilmaril@719
   997
insilmaril@719
   998
\vym a pour l'instant un filtre d'importation rudimentaire pour convertir
insilmaril@719
   999
les cartes créées par {\em Mind Manager}%
insilmaril@719
  1000
\footnote{Mind Manager est un logiciel commercial c'est à dire non libre. Il
insilmaril@719
  1001
est développée par Mindjet pour Windows et le Mac. Les deux sont des
insilmaril@719
  1002
marques enregistrées par Mindjet. Pour plus d'informations voir leur
insilmaril@719
  1003
site web \href{http://mindjet.com}{http://mindjet.com}%
insilmaril@719
  1004
} en cartes \vym. Les notes et les images ne sont pas converties pour
insilmaril@719
  1005
l'instant. Vous pouvez importer des fichiers avec : \og File \ra
insilmaril@719
  1006
Import\ra Mind Manager \fg{}.
insilmaril@719
  1007
insilmaril@719
  1008
insilmaril@719
  1009
\subsubsection*{Structure et répertoires}
insilmaril@719
  1010
insilmaril@719
  1011
\vym peut lire une structure de répertoires. C'est pour tester \vym,
insilmaril@719
  1012
par exemple pour créer facilement de très grandes cartes utilisées
insilmaril@719
  1013
pour les essais (oui il y a encore de la place pour optimiser \vym
insilmaril@719
  1014
;-)
insilmaril@719
  1015
insilmaril@719
  1016
insilmaril@719
  1017
\subsection{Export}
insilmaril@719
  1018
insilmaril@719
  1019
\label{export} \label{hideexport} Souvent vous ne voulez pas exporter
insilmaril@719
  1020
la carte entière, juste une partie. Par exemple, vous pouvez avoir
insilmaril@719
  1021
une information supplémentaire dont vous voulez parler dans une présentation,
insilmaril@719
  1022
alors que ces parties ne seront pas visibles pendant la présentation.
insilmaril@719
  1023
Pour y arriver, vous pouvez \og cacher \fg{} des parties de la carte
insilmaril@719
  1024
pendant les exports en positionnant l'indicateur \og hide in export \fg{}. 
insilmaril@719
  1025
insilmaril@719
  1026
\begin{center}
insilmaril@764
  1027
\includegraphics[width=0.5cm,bb = 0 0 200 100, draft, type=eps]{images/flag-hideexport.png} 
insilmaril@719
  1028
\par\end{center}
insilmaril@719
  1029
insilmaril@719
  1030
Vous pouvez basculer cet indicateur à partir de la barre de menu ou
insilmaril@719
  1031
en tapant \key{H}. Notez qu'il y a une option globale dans le menu
insilmaril@719
  1032
de préférences( \ref{settings}) pour basculer l'utilisation de cet
insilmaril@719
  1033
indicateur. Par défaut cet indicateur est validé.
insilmaril@719
  1034
insilmaril@719
  1035
insilmaril@719
  1036
\subsubsection*{Open Office}
insilmaril@719
  1037
insilmaril@719
  1038
À partir de la version 2 Open utilise le \og Open Document Format \fg{},
insilmaril@719
  1039
qui peut être écrit par \vym. Les options sont actuellement limitées.
insilmaril@719
  1040
Il est possible d'exporter des présentations qui peuvent être ouvertes
insilmaril@719
  1041
par Open Office Impress. En sélectionnant : \og File \ra Export\ra
insilmaril@719
  1042
Open Office \fg{}.
insilmaril@719
  1043
insilmaril@719
  1044
Vous obtenez une fenêtre de dialogue où vous pouvez choisir le fichier
insilmaril@719
  1045
de sortie et le type de fichier : \maximage{images/export-oo.png}
insilmaril@719
  1046
Les types de fichiers représentent différents types de patrons, qui
insilmaril@719
  1047
peuvent être créés à partir d'un document Open Office avec un peu
insilmaril@719
  1048
de travail manuel. La structure de la carte \vym est alors insérée
insilmaril@719
  1049
dans ce patron. Il y a pour l'instant quelque limitations :
insilmaril@719
  1050
\begin{itemize}
insilmaril@719
  1051
\item \vym ne peut gérer la longueur des pages, vous devez tester et sans
insilmaril@719
  1052
doute re-éditer le document Open Office pour éviter que le texte ne
insilmaril@719
  1053
continue après la fin de la page,
insilmaril@719
  1054
\item images et les indicateurs ne sont pas utilisés pour le moment,
insilmaril@719
  1055
\item les notes sont écrites en texte brut , sans RichText 
insilmaril@719
  1056
\item la gamme complète des patrons n'est pas disponible dans toutes les
insilmaril@719
  1057
distributions.
insilmaril@719
  1058
\end{itemize}
insilmaril@719
  1059
Certains patrons utilisent des {\em sections} c'est à dire qu'ils
insilmaril@719
  1060
insèrent le titre des branches principales comme des titres de section
insilmaril@719
  1061
dans la présentation.
insilmaril@719
  1062
insilmaril@719
  1063
insilmaril@719
  1064
\subsubsection*{Image}
insilmaril@719
  1065
insilmaril@719
  1066
\vym supporte tous les formats d'image qui sont nativement supportés
insilmaril@719
  1067
par le QT~toolkit : BMP, JPEG, PBM, PGM, PNG, PPN, XPM et XBM. Pour
insilmaril@719
  1068
utilisation sur les sites web ou envoyer des images par email, PNG
insilmaril@719
  1069
est un bon compromis taille/qualité. \vym utilise les options par
insilmaril@719
  1070
défaut de Qt pour comprimer les images.
insilmaril@719
  1071
insilmaril@719
  1072
insilmaril@719
  1073
\subsubsection*{ASCII}
insilmaril@719
  1074
insilmaril@719
  1075
L'exportation en image est expérimental en ce moment. Plus tard cela
insilmaril@719
  1076
sans doute fait avec des feuilles de style. La forme de la sortie
insilmaril@719
  1077
risque de changer dans de futures versions de \vym.
insilmaril@719
  1078
insilmaril@719
  1079
insilmaril@764
  1080
\subsubsection*{\protect\LaTeX{}}
insilmaril@719
  1081
insilmaril@719
  1082
\vym peut générer un fichier d'entrée pour \LaTeX{}. C'est actuellement
insilmaril@719
  1083
en développement, il n'y a pas d'option. En sélectionnant : \og File
insilmaril@719
  1084
\ra Export\ra \LaTeX{} \fg{}.
insilmaril@719
  1085
insilmaril@719
  1086
Vous allez ouvrir une fenêtre de dialogue pour le nom du fichier de
insilmaril@719
  1087
sortie. Cette feuille peut ensuite être inclue dans un document en
insilmaril@719
  1088
utilisant la commande : \begin{verbatim} \include{inputfile} \end{verbatim}
insilmaril@719
  1089
insilmaril@719
  1090
insilmaril@719
  1091
\subsubsection*{Bookmarks KDE }
insilmaril@719
  1092
insilmaril@719
  1093
\vym va écraser le fichier des bookmarks KDE puis tenter de le notifier
insilmaril@719
  1094
à Konqueror en fonctionnement puis essayera de le notifier via DCOP
insilmaril@719
  1095
que le fichier a changé. \emph{\vym ne crée pas de sauvegarde ! } Accessible
insilmaril@719
  1096
par le menu : \og File \ra Export \ra KDE Bookmarks \fg{}.
insilmaril@719
  1097
insilmaril@719
  1098
insilmaril@719
  1099
\subsubsection*{XHTML (Webpages)}
insilmaril@719
  1100
insilmaril@719
  1101
C'est le format à utiliser si vous voulez créer une page web. Pour
insilmaril@719
  1102
voir un exemple visitez la page d'entrée de \vym : \href{http://www.InSilmaril.de/vym}{www.InSilmaril.de/vym}
insilmaril@719
  1103
insilmaril@719
  1104
Quelque explications sur son fonctionnement : avant d'exporter une
insilmaril@719
  1105
carte en XHTML, elle est d'abord écrite en XML dans un répertoire
insilmaril@719
  1106
(voir \ref{xmlexport}). Puis le programme externe \texttt{xsltproc}%
insilmaril@719
  1107
\footnote{Sur la distribution SUSE Linux et quelques autres distributions \texttt{xsltproc}
insilmaril@719
  1108
est installé par défaut.%
insilmaril@719
  1109
} va être appelé pour traiter le fichier XML et générer le code HTML.
insilmaril@719
  1110
Un dialogue permet à l'utilisateur de positionner diverses options
insilmaril@719
  1111
:
insilmaril@719
  1112
\begin{description}
insilmaril@719
  1113
\item [{Include}] \textbf{image:} si positionné, \vym va créer une une
insilmaril@719
  1114
image de la carte au début de la sortie HTML. Cliquer sur une branche
insilmaril@719
  1115
va faire sauter à la section correspondante de la sortie.
insilmaril@719
  1116
\item [{Colored}] \textbf{headings:} Si positionné à OUI, \vym va mettre
insilmaril@719
  1117
les titres en couleur dans la partie texte avec les mêmes couleurs
insilmaril@719
  1118
que celles utilisées dans la carte \vym. 
insilmaril@719
  1119
\item [{Show}] \textbf{warnings:} Si positionné, \vym va demander avant
insilmaril@719
  1120
d'écrire les données.
insilmaril@719
  1121
\item [{Show}] \textbf{output:} Cela est utilisé principalement pour le
insilmaril@719
  1122
dégogage. On va voir comment s'effectue le traitement du fichier XML
insilmaril@719
  1123
en appelant le programme externe \texttt{xsltproc}. 
insilmaril@719
  1124
\end{description}
insilmaril@719
  1125
En complément les chemins des feuilles de styles CSS et XSL peuvent
insilmaril@719
  1126
être indiqués. Par défaut sur SUSE~Linux elles sont dans : \texttt{/usr/share/vym/styles}%
insilmaril@719
  1127
\footnote{N.dT. idem pour la version 1.10.0 sur Debian Etch%
insilmaril@719
  1128
}.
insilmaril@719
  1129
insilmaril@719
  1130
insilmaril@719
  1131
\subsubsection*{XML}
insilmaril@719
  1132
insilmaril@719
  1133
\label{xmlexport} La carte est écrite dans un répertoire à la fois
insilmaril@719
  1134
comme une image et comme un fichier XML. Le répertoire est choisi
insilmaril@719
  1135
dans une fenêtre de dialogue. Si le répertoire n'est pas vide, vous
insilmaril@719
  1136
allez être averti et on va vous prévenir que vous risquez d'écraser
insilmaril@719
  1137
des fichiers.
insilmaril@719
  1138
insilmaril@719
  1139
Il est possible d'exporter des cartes différentes dans le même répertoire.
insilmaril@719
  1140
Chaque fichier généré va avoir le nom de la carte comme préfixe, par
insilmaril@719
  1141
exemple e.g. \texttt{todo.vym} devient \texttt{todo.xml}, \texttt{todo.png},
insilmaril@719
  1142
\texttt{todo-image-1.png} et ainsi de suite. C'est utile si par exemple
insilmaril@719
  1143
un site web comporte des cartes liées qui doivent être rangées dans
insilmaril@719
  1144
le même répertoire.
insilmaril@719
  1145
insilmaril@719
  1146
insilmaril@719
  1147
\subsubsection*{Export d'une partie d'une carte}
insilmaril@719
  1148
insilmaril@719
  1149
Sélectionnez la branche que vous voulez exporter avec ses fils, puis
insilmaril@719
  1150
ouvrez le menu contextuel et choisissez {\em Save Selection}. Cela
insilmaril@719
  1151
va créer un fichier avec le suffixe \texttt{.vyp}, qui est une abréviation
insilmaril@719
  1152
de \og vym part \fg{}.
insilmaril@719
  1153
insilmaril@719
  1154
insilmaril@719
  1155
\section{Édition avancée}
insilmaril@719
  1156
insilmaril@719
  1157
insilmaril@719
  1158
\subsection{Propriétés d'un objet}
insilmaril@719
  1159
insilmaril@719
  1160
Pour chacune des branches vous pouvez ouvrir une fenêtre auxiliaire
insilmaril@719
  1161
(voir \ref{satellite}): la {\em property window%
insilmaril@719
  1162
\footnote{fenêtre des propriétés%
insilmaril@719
  1163
}}: 
insilmaril@719
  1164
insilmaril@719
  1165
\begin{center}
insilmaril@764
  1166
\includegraphics[width=8cm,bb = 0 0 200 100, draft, type=eps]{images/propwindow.png}
insilmaril@764
  1167
\label{propwindow} 
insilmaril@719
  1168
\par\end{center}
insilmaril@719
  1169
insilmaril@719
  1170
%FIXME create screenshot
insilmaril@719
  1171
%FIXME explain the tabs
insilmaril@719
  1172
insilmaril@719
  1173
\begin{itemize}
insilmaril@719
  1174
\item trame,
insilmaril@719
  1175
\item lien (voir \ref{hideunselected}) 
insilmaril@719
  1176
\item Layout (voir \ref{incimg}) 
insilmaril@719
  1177
\end{itemize}
insilmaril@719
  1178
insilmaril@719
  1179
\subsection{Revoir l'histoire : défaire et refaire %
insilmaril@719
  1180
\footnote{Undo and Redo%
insilmaril@719
  1181
}}
insilmaril@719
  1182
insilmaril@719
  1183
\vym garde la trace de tous les changements faits à une carte. Le
insilmaril@719
  1184
nombre de modifications qui peuvent être défaites est de 75 par défaut.
insilmaril@719
  1185
L'historique complet peut être vu dans la {\em fenêtre d'historique}:
insilmaril@719
  1186
\maximage{images/historywindow.png} \label{historywindow} un simple
insilmaril@719
  1187
pas en arrière peut être défait ou refait en tapant \key{CTRL-Z}
insilmaril@719
  1188
ou \key{CTRL-Y}, ou en utilisant les boutons de la barre de menu
insilmaril@719
  1189
ou la {\em fenêtre d'historique}. Dans la {\em fenêtre d'historique},
insilmaril@719
  1190
vous pouvez cliquer sur une ligne pour détailler toutes les actions
insilmaril@719
  1191
faites jusqu'à ce moment, ou refaire toutes les actions en cliquant
insilmaril@719
  1192
sur la dernière ligne.
insilmaril@719
  1193
insilmaril@719
  1194
\hint{ Vous pouvez \og coller à partir du passé \fg{} : aller en
insilmaril@719
  1195
arrière dans le temps avec la touche \key{CTRL-Z}, puis copier dans
insilmaril@719
  1196
le tampon en tapant \key{CTRL-C}.
insilmaril@719
  1197
insilmaril@719
  1198
Maintenant pour refaire toutes les actions, par exemple en tapant
insilmaril@719
  1199
sur la touche \key{CTRL-Y} ou en cliquant sur la dernière action
insilmaril@719
  1200
dans la {\em fenêtre d'historique}. Maintenant collez à partir
insilmaril@719
  1201
du passé avec la touche \key{CTRL-V}. }
insilmaril@719
  1202
insilmaril@719
  1203
insilmaril@719
  1204
\subsection{Macros}
insilmaril@719
  1205
insilmaril@719
  1206
\label{macros} Les macros ont été ajoutées à \vym à la version~1.9.0.
insilmaril@719
  1207
Jusqu'à présent elles sont provisoires, elles vont peut-être être
insilmaril@719
  1208
remplacées par un langage de script plus performant (les commandes
insilmaril@719
  1209
seront approximativement les mêmes).
insilmaril@719
  1210
insilmaril@719
  1211
Chaque touche de fonction (touches \key{F1} à \key{F12}) contient
insilmaril@719
  1212
une macro, qui est exécutée sur la sélection courante lorsque la touche
insilmaril@719
  1213
est enfoncée. Les macros par défaut changent la couleur d'un sous
insilmaril@719
  1214
arbre ou positionnent la trame d'une branche : 
insilmaril@719
  1215
insilmaril@719
  1216
\begin{center}
insilmaril@764
  1217
\includegraphics[width=8cm,bb = 0 0 200 100, draft, type=eps]{images/macros_fr.png} 
insilmaril@719
  1218
\par\end{center}
insilmaril@719
  1219
insilmaril@719
  1220
Chaque macro est un script \vym qui est exécuté lorsque la touche
insilmaril@719
  1221
correspondante est appuyée. L'emplacement par défaut des macros peut
insilmaril@719
  1222
être changé dans le \og Settings menu \fg{}. Plus d'informations
insilmaril@719
  1223
sur l'utilisation des scripts dans \vym peut être trouvé en appendice~\ref{scripts}.
insilmaril@719
  1224
insilmaril@719
  1225
insilmaril@719
  1226
\subsection{Signets}
insilmaril@719
  1227
insilmaril@719
  1228
\label{bookmarks} 
insilmaril@719
  1229
insilmaril@719
  1230
insilmaril@719
  1231
\subsubsection*{Ouvrir des nouveaux signets au lieu de nouvelles fenêtres}
insilmaril@719
  1232
insilmaril@719
  1233
Si vous utilisez \texttt{konqueror} comme navigateur, \vym peut se
insilmaril@719
  1234
rappeler de la session de \texttt{konqueror }qui était ouverte en
insilmaril@719
  1235
premier par \vym. Vous pouvez appuyer sur les touches \key{Ctrl}
insilmaril@719
  1236
et cliquer pour ouvrir le lien dans un nouvel onglet.
insilmaril@719
  1237
insilmaril@719
  1238
\vym peut aussi ouvrir une nouvel onglet dans Mozilla ou Firefox
insilmaril@719
  1239
en utilisant la commande à distance %
insilmaril@719
  1240
\footnote{(remote command) à \href{http://www.mozilla.org/unix/remote.html}{http://www.mozilla.org/unix/remote.html}%
insilmaril@719
  1241
} de ces navigateurs.
insilmaril@719
  1242
insilmaril@719
  1243
insilmaril@719
  1244
\subsubsection*{Copier/coller}
insilmaril@719
  1245
insilmaril@719
  1246
Si vous voulez mettre vos bookmarks dans une carte, sélectionnez une
insilmaril@719
  1247
branche où vous voulez ajouter le bookmark, puis collez simplement
insilmaril@719
  1248
l'URL dans la carte à partir de votre navigateur. Vous pouvez aussi
insilmaril@719
  1249
utiliser un titre existant comme URL : cliquez à droite sur la branche
insilmaril@719
  1250
et sélectionnez : \og Use heading for URL \fg{}.
insilmaril@719
  1251
insilmaril@719
  1252
insilmaril@719
  1253
\subsubsection*{Accès direct à la liste des bookmarks d'un navigateur}
insilmaril@719
  1254
insilmaril@719
  1255
Voir les sections \ref{import} et \ref{export} sur les filtres d'import-export.
insilmaril@719
  1256
insilmaril@719
  1257
insilmaril@719
  1258
\subsubsection*{URL spéciales}
insilmaril@719
  1259
insilmaril@719
  1260
\vym peut convertir un titre d'une branche existante en URL. Cela
insilmaril@719
  1261
marche pour Bugentries dans le système Novell Bugtracking : ouvrez
insilmaril@719
  1262
le menu de contexte d'une branche (en cliquant à droite) et sélectionnez
insilmaril@719
  1263
: \og Create URL to Bugzilla \fg{}.
insilmaril@719
  1264
insilmaril@719
  1265
L'URL sera créé à partir du titre.
insilmaril@719
  1266
insilmaril@719
  1267
insilmaril@719
  1268
\subsection{Associer des images à une branche}
insilmaril@719
  1269
insilmaril@719
  1270
\label{incimg} La configuration par défaut d'une image est de flotter
insilmaril@719
  1271
\og librement \fg{}. Les images peuvent être positionnées n'importe
insilmaril@719
  1272
où dans le canevas cachant la partie correspondante de la carte.
insilmaril@719
  1273
insilmaril@719
  1274
La solution est de l'insérer ou de l'inclure \og dans \fg{} une
insilmaril@719
  1275
branche. Cela est fait au travers de la fenêtre de propriétés (voir
insilmaril@719
  1276
\ref{propwindow}) par les menus : 
insilmaril@719
  1277
\begin{itemize}
insilmaril@719
  1278
\item include images horizontally 
insilmaril@719
  1279
\item include images vertically 
insilmaril@719
  1280
\end{itemize}
insilmaril@719
  1281
L'images est positionnée relativement à sa branche mère, mais le titre
insilmaril@719
  1282
et la bordure s'adapte à l'image flottante, voir en dessous : \maximage{images/includeImages_fr.png}
insilmaril@719
  1283
insilmaril@719
  1284
insilmaril@719
  1285
\subsection{Mode modificateur}
insilmaril@719
  1286
insilmaril@719
  1287
Les modificateurs sont par exemple la touche \key{Shift}, \key{Ctrl}
insilmaril@719
  1288
ou \key{Alt}. Quand on appuie dessus pendant une action de la souris,
insilmaril@719
  1289
\vym va effectuer une action différente de celle habituelle.
insilmaril@719
  1290
insilmaril@719
  1291
%\key{Ctrl} or \key{Alt}is pressed while releasing the branch, it will be
insilmaril@719
  1292
%added above/below the target, not as child of the target.
insilmaril@719
  1293
insilmaril@719
  1294
insilmaril@719
  1295
Sans appuyer sur un modificateur, le premier clic sur la souris sélectionne
insilmaril@719
  1296
une branche. Le comportement avec le modificateur \key{Ctrl} est
insilmaril@719
  1297
sujet à à plusieurs options, qui peuvent être positionnées dans la
insilmaril@719
  1298
barre de menu :
insilmaril@719
  1299
insilmaril@719
  1300
\begin{center}
insilmaril@764
  1301
\includegraphics[width=3cm,bb = 0 0 200 100, draft, type=eps]{images/modmodes.png} 
insilmaril@719
  1302
\par\end{center}
insilmaril@719
  1303
insilmaril@719
  1304
Le mode par défaut est de copier la couleur de la branche cliquée
insilmaril@719
  1305
vers la branche sélectionnée. La figure au-dessus montre la barre
insilmaril@719
  1306
de menu avec le modificateur par défaut sélectionné. Le deuxième modificateur
insilmaril@719
  1307
vous permet de couper une branche complète avec un simple clic. Le
insilmaril@719
  1308
troisième modificateur vous permet de créer des liens entre branches
insilmaril@719
  1309
appelés {\em xLinks}. Cela est expliqué dans la section suivante
insilmaril@719
  1310
\ref{xlinks}.
insilmaril@719
  1311
insilmaril@719
  1312
insilmaril@719
  1313
\subsection{Cacher les liens d'objets non sélectionnés}
insilmaril@719
  1314
insilmaril@719
  1315
\label{hidelink} Il est pratique de positionner librement une branche,
insilmaril@719
  1316
comme une branche principale ou une image. Cela est possible pour
insilmaril@719
  1317
toutes les branches, vous pouvez utiliser une branche principale et
insilmaril@719
  1318
cacher ses liens de connexion au centre de la carte ou cacher le lien
insilmaril@719
  1319
entre une branche fils et son parent. C'est utile par exemple pour
insilmaril@719
  1320
les légendes ou pour une collection de liens \vym  pointant vers
insilmaril@719
  1321
d'autres cartes : 
insilmaril@719
  1322
insilmaril@719
  1323
\begin{center}
insilmaril@764
  1324
\includegraphics[width=9cm,bb = 0 0 200 100, draft, type=eps]{images/hiddenlink_fr.png} 
insilmaril@719
  1325
\par\end{center}
insilmaril@719
  1326
insilmaril@719
  1327
Pour cacher le lien entre la branche et son parent ouvrir la fenêtre
insilmaril@719
  1328
de propriétés et sélectionner \og Hide link if object is not selected \fg{}
insilmaril@719
  1329
sur l'onglet \og Link \fg{}.
insilmaril@719
  1330
insilmaril@719
  1331
insilmaril@719
  1332
\subsection{XLinks}
insilmaril@719
  1333
insilmaril@719
  1334
\label{xlinks} Jusqu'à maintenant les données dans la carte \vym
insilmaril@719
  1335
étaient sous forme d'arbre. En utilisant les xLinks vous pouvez lier
insilmaril@719
  1336
une branche à n'importe quelle autre, comme en attachant une corde
insilmaril@719
  1337
entre deux branches dans un vrai arbre. C'est très pratique dans des
insilmaril@719
  1338
cartes compliquées, où vous avez des renvois qui ne peuvent être affichés
insilmaril@719
  1339
dans la même zone visible de la fenêtre du {\em mapeditor}. La
insilmaril@719
  1340
carte suivante tient sur un écran, mais montre comment les données
insilmaril@719
  1341
peuvent être reliées. Dans le graphisme il y a un lien à partir d'une
insilmaril@719
  1342
tâche (prepare a presentation) à l'information générale : \maximage{images/xlink_fr.png}
insilmaril@719
  1343
Notez qu'un xLink qui pointe sur une branche non visible (parce qu'elle
insilmaril@719
  1344
est \og enroulée \fg{}), est montrée par une flèche horizontale.
insilmaril@719
  1345
Regardez la branche \lq Tuesday\rq dans la capture d'écran ci-dessus.
insilmaril@719
  1346
insilmaril@719
  1347
insilmaril@719
  1348
\subsubsection*{Créer un xLink}
insilmaril@719
  1349
insilmaril@719
  1350
Choisir le type de lien à partir de la barre de modifier (en cliquant
insilmaril@719
  1351
l'icône de la barre de menu ou en tapant \key{L}). Sélectionner
insilmaril@719
  1352
la branche d'où le xLink doit partir. Appuyer sur le modifier \key{Ctrl}
insilmaril@719
  1353
puis cliquez la branche et amenez le curseur de la souris où le lien
insilmaril@719
  1354
doit se terminer. Un lien est tracé qui suit le pointeur de la souris.
insilmaril@719
  1355
Le lien devient permanent quand vous relâchez le bouton de la souris
insilmaril@719
  1356
.
insilmaril@719
  1357
insilmaril@719
  1358
insilmaril@719
  1359
\subsubsection*{Modifier ou effacer un xLink}
insilmaril@719
  1360
insilmaril@719
  1361
Sélectionner une extrémité du xLink. Ouvrir le menu contextuel et
insilmaril@719
  1362
sélectionnez \og  Edit xLink \fg{}. Un sous menu contenant tous
insilmaril@719
  1363
les xLinks de la branche apparaît. Sélectionnez en un et la fenêtre
insilmaril@719
  1364
de dialogue xLink dialogue s'ouvre, où vous pouvez sélectionner la
insilmaril@719
  1365
couleur, la largeur et aussi effacer le xLink.
insilmaril@719
  1366
insilmaril@719
  1367
insilmaril@719
  1368
\subsubsection*{Suivre un xLink}
insilmaril@719
  1369
insilmaril@719
  1370
Dans une carte \vym compliquée il est commode de sauter à l'autre
insilmaril@719
  1371
extrémité d'un xLink. Vous pouvez le faire en ouvrant le menu contextuel
insilmaril@719
  1372
et en cliquant \og  Goto xLink \fg{} puis en sélectionnant le xLink
insilmaril@719
  1373
qui vous intéresse.
insilmaril@719
  1374
insilmaril@719
  1375
insilmaril@719
  1376
\subsection{Ajouter et supprimer des branches}
insilmaril@719
  1377
insilmaril@719
  1378
Le menu contextuel d'une branche montre quelques moyens supplémentaires
insilmaril@719
  1379
pour ajouter ou supprimer des données. Vous pouvez supprimer une branche
insilmaril@719
  1380
tout en gardant ses enfants. Les enfants sont alors liés au parent
insilmaril@719
  1381
de la branche supprimée (son \og grand-parent \fg{}). Des branches
insilmaril@719
  1382
identiques peuvent être ajoutées à des cartes existantes. Pour les
insilmaril@719
  1383
raccourcis clavier regarder également dans le menu contextuel.
insilmaril@719
  1384
insilmaril@719
  1385
insilmaril@719
  1386
\subsection{Ajouter une carte complète ou une partie}
insilmaril@719
  1387
insilmaril@719
  1388
Sélectionner la branche où vous voulez ajouter une carte sauvée précédemment
insilmaril@719
  1389
(\texttt{.vym}) ou une partie de carte (\texttt{.vyp}), puis ouvrez
insilmaril@719
  1390
le menu contextuel et choisissez {\em Add \ra Add Map (Insert)}.
insilmaril@719
  1391
Pour l'importation vous pouvez choisir entre {\em Add Map (Insert)}
insilmaril@719
  1392
ou {\em Add Map (Replace)}: les données importées vont être ajoutées
insilmaril@719
  1393
à la branche sélectionnée.
insilmaril@719
  1394
insilmaril@719
  1395
insilmaril@719
  1396
\section{\vym sur Mac OS X}
insilmaril@719
  1397
insilmaril@719
  1398
insilmaril@719
  1399
\subsection{Vue d'ensemble}
insilmaril@719
  1400
insilmaril@719
  1401
Il y a deux moyens de faire fonctionner \vym sur les Macs : 
insilmaril@719
  1402
insilmaril@719
  1403
insilmaril@719
  1404
\subsubsection*{Qt Mac Edition:}
insilmaril@719
  1405
insilmaril@719
  1406
\vym a là une l'apparence bien connue de Mac. \vym est disponible
insilmaril@719
  1407
comme paquet d'application Mac OS X dans une image disque (\texttt{vym.dmg}).
insilmaril@719
  1408
Il a été compilé et testé sur Mac~OS~10.4. Ce paquet inclut les
insilmaril@719
  1409
librairies Qt de Trolltech.
insilmaril@719
  1410
insilmaril@719
  1411
insilmaril@719
  1412
\subsubsection*{version X11 }
insilmaril@719
  1413
insilmaril@719
  1414
\vym peut aussi être lancé dans sa version Linux, mais les menus
insilmaril@719
  1415
et l'utilisation seront ceux de Linux c'est à dire que les barres
insilmaril@719
  1416
de menu sont différentes.
insilmaril@719
  1417
insilmaril@719
  1418
insilmaril@719
  1419
\subsection{Menu de contexte et touches spéciales}
insilmaril@719
  1420
insilmaril@719
  1421
La majorité des Macs n'a malheureusement qu'un bouton de souris. Pour
insilmaril@719
  1422
pour voir le menu contextuel qui normalement est ouvert avec un clic
insilmaril@719
  1423
droit, vous devez cliquer en appuyant sur la touche \key{command}.
insilmaril@719
  1424
insilmaril@719
  1425
Surtout sur les portables quelques touches utilisées sur les PC sont
insilmaril@719
  1426
manquantes. La version de \vym avec QT-Mac a ses propres raccourcis
insilmaril@719
  1427
clavier. Pour les trouver regardez les entrées des menus, les raccourcis
insilmaril@719
  1428
visibles à côté de cette entrée. Les boutons de la barre de menu peuvent
insilmaril@719
  1429
aussi avoir des raccourcis, positionnez le curseur de la souris sur
insilmaril@719
  1430
un bouton et la fenêtre d'aide apparaîtra.
insilmaril@719
  1431
insilmaril@719
  1432
insilmaril@719
  1433
\subsection{Voir des liens externes}
insilmaril@719
  1434
insilmaril@719
  1435
\vym sur Mac utilise le système d'appel \texttt{/usr/bin/open} pour
insilmaril@719
  1436
voir les liens. Mac~OS détermine automatiquement si le lien est un
insilmaril@719
  1437
pdf ou une page web et ouvre le bon visionneur.
insilmaril@719
  1438
insilmaril@719
  1439
\appendix \newpage{}
insilmaril@719
  1440
insilmaril@719
  1441
insilmaril@719
  1442
\section{\label{settings}\vym : processus d'initialisation et de configuration}
insilmaril@719
  1443
insilmaril@719
  1444
insilmaril@719
  1445
\subsection{Menu des préférences (Settings menu)}
insilmaril@719
  1446
insilmaril@719
  1447
Le {\em Menu des préférences } vous permet de configurer \vym
insilmaril@719
  1448
suivant vos besoins :
insilmaril@719
  1449
insilmaril@719
  1450
insilmaril@719
  1451
\subsubsection*{Choisir l'application pour ouvrir les fichiers PDF }
insilmaril@719
  1452
insilmaril@719
  1453
Choisir un visionneur PDF installé sur votre système.
insilmaril@719
  1454
insilmaril@719
  1455
insilmaril@719
  1456
\subsubsection*{Choisir le navigateur (vers les liens externes)}
insilmaril@719
  1457
insilmaril@719
  1458
Choisissez votre navigateur favori.
insilmaril@719
  1459
insilmaril@719
  1460
insilmaril@719
  1461
\subsubsection*{Positionner le chemin pour les macros}
insilmaril@719
  1462
insilmaril@719
  1463
Le chemin par défaut pour exécuter les macros correspondantes quand
insilmaril@719
  1464
vous appuyez sur une des touches de fonction. Chaque touche correspond
insilmaril@719
  1465
à un fichier (\texttt{macro-1.vys..macro12.vys}) dans le chemin de
insilmaril@719
  1466
recherche.
insilmaril@719
  1467
insilmaril@719
  1468
insilmaril@719
  1469
\subsubsection*{Niveaux défaire/refaire}
insilmaril@719
  1470
insilmaril@719
  1471
Fixer le nombre de défaire/refaire. Par défaut :75.
insilmaril@719
  1472
insilmaril@719
  1473
insilmaril@719
  1474
\subsubsection*{Sauvegarde automatique et temps entre sauvegardes}
insilmaril@719
  1475
insilmaril@719
  1476
La sauvegarde automatique des cartes peut être désactivée. Le temps
insilmaril@764
  1477
entre sauvegardes est indiqué en secondes. 
insilmaril@764
  1478
insilmaril@764
  1479
Quand la sauvegarde d'une carte est demandée \texttt{example.vym},
insilmaril@764
  1480
\vym  renomme le fichier existant en \texttt{example.vym\textasciitilde{}}
insilmaril@764
  1481
avant d'écrire le fichier \texttt{example.vym.}
insilmaril@719
  1482
insilmaril@719
  1483
insilmaril@719
  1484
\subsubsection*{Éditer la branche après l'avoir créée}
insilmaril@719
  1485
insilmaril@719
  1486
Si positionné, le titre de la nouvelle branche va être édité immédiatement
insilmaril@719
  1487
après avoir été créé.
insilmaril@719
  1488
insilmaril@719
  1489
insilmaril@719
  1490
\subsubsection*{Sélectionner la branche après l'avoir créé}
insilmaril@719
  1491
insilmaril@719
  1492
Si positionné, la nouvelle branche va être sélectionnée après avoir
insilmaril@719
  1493
été créée. Quand vous réfléchissez sur un mot donné, vous ne voulez
insilmaril@719
  1494
pas aller dans les détails, mais garder l'attention sur ce mot. Le
insilmaril@719
  1495
choix par défaut est de {\em ne pas}  sélectionner la nouvelle branche
insilmaril@719
  1496
créée.
insilmaril@719
  1497
insilmaril@719
  1498
insilmaril@719
  1499
\subsubsection*{Sélectionner la branche existante}
insilmaril@719
  1500
insilmaril@719
  1501
Si positionné et que vous commencez à éditer le titre de la branche,
insilmaril@719
  1502
le texte du titre va être sélectionné. Pratique pour copier/coller
insilmaril@719
  1503
dans d'autres applications.
insilmaril@719
  1504
insilmaril@719
  1505
insilmaril@719
  1506
\subsubsection*{Touche effacement}
insilmaril@719
  1507
insilmaril@719
  1508
Si positionné, la touche \key{Delete} est validée pour détruire
insilmaril@719
  1509
les objets. Attention aux confusions avec la touche \key{Insert}sur
insilmaril@719
  1510
les claviers de PC.
insilmaril@719
  1511
insilmaril@719
  1512
insilmaril@719
  1513
\subsubsection*{Indicateurs exclusif}
insilmaril@719
  1514
insilmaril@719
  1515
Si positionné quelques indicateurs peuvent être exclusifs, par exemple
insilmaril@719
  1516
les émoticons.
insilmaril@719
  1517
insilmaril@719
  1518
insilmaril@719
  1519
\subsubsection*{Autoriser l'indicateur caché}
insilmaril@719
  1520
insilmaril@719
  1521
Si positionné, chaque branche qui a l'indicateur caché associé (voir
insilmaril@719
  1522
\ref{hideexport}) ne sera pas présente dans les exports.
insilmaril@719
  1523
insilmaril@719
  1524
insilmaril@719
  1525
\subsection{Fichier de configuration}
insilmaril@719
  1526
insilmaril@719
  1527
Au démarrage, \vym va regarder un fichier de configuration spécifique
insilmaril@719
  1528
à l'utilisateur contenant ses réglages personnels comme la position
insilmaril@719
  1529
des fenêtres, les menus de travail, etc. Si ce fichier n'existe pas,
insilmaril@719
  1530
il sera créé. Le fichier est localisé dans la racine du répertoire
insilmaril@719
  1531
de l'utilisateur. Sa position exacte dépend de la plate-forme :
insilmaril@719
  1532
insilmaril@719
  1533
\begin{center}
insilmaril@719
  1534
\begin{tabular}{cl}
insilmaril@719
  1535
\textbf{Plate-forme}  & \textbf{Fichier de configuration }\tabularnewline
insilmaril@719
  1536
\hline 
insilmaril@719
  1537
Linux  & \texttt{$\sim$/.config/InSilmaril/vym.conf}  \tabularnewline
insilmaril@719
  1538
Mac OS X  & \texttt{/Users/NAME/Library/Preferences/com.insilmaril.vym.plist}
insilmaril@719
  1539
 \tabularnewline
insilmaril@719
  1540
\end{tabular}
insilmaril@719
  1541
\par\end{center}
insilmaril@719
  1542
insilmaril@719
  1543
Le fichier peut être édité manuellement ou sur Mac~OS~X avec le
insilmaril@719
  1544
Property List Editor (installé avec xtools).
insilmaril@719
  1545
insilmaril@719
  1546
insilmaril@719
  1547
\subsection{Chemin vers les ressources}
insilmaril@719
  1548
insilmaril@719
  1549
\vym va essayer de trouver ses ressources (images, feuilles de style,
insilmaril@719
  1550
filtres, etc) aux endroits suivants :
insilmaril@719
  1551
\begin{enumerate}
insilmaril@719
  1552
\item chemin donné par la variable d'environnement\texttt{ VYMHOME}. 
insilmaril@719
  1553
\item Si appelé avec l'option {\em local}  (voir \ref{options} en dessous),
insilmaril@719
  1554
\vym va chercher ses ressource dans le répertoire courant.
insilmaril@719
  1555
\item \texttt{/usr/share/vym} 
insilmaril@719
  1556
\item \texttt{/usr/local/share/vym} 
insilmaril@719
  1557
\end{enumerate}
insilmaril@719
  1558
insilmaril@719
  1559
\subsection{Options de la ligne de commande}
insilmaril@719
  1560
insilmaril@719
  1561
\label{options} \vym a les options suivantes lors de l'appel en
insilmaril@719
  1562
ligne de commande%
insilmaril@719
  1563
\footnote{chaque option doit être précédé du \og - \fg{} classique (N.d.T.)%
insilmaril@719
  1564
} :
insilmaril@719
  1565
insilmaril@719
  1566
\begin{center}
insilmaril@719
  1567
\begin{tabular}{cccp{8cm}}
insilmaril@719
  1568
 &  &  & \tabularnewline
insilmaril@719
  1569
\textbf{Option } & \textbf{Résumé } & \textbf{Argument } & \textbf{Description }\tabularnewline
insilmaril@719
  1570
\hline 
insilmaril@719
  1571
v  & version  &  & indiquer la version et le nom de code de \vym\tabularnewline
insilmaril@719
  1572
l  & local  &  & Utiliser les chemins locaux pour les feuilles de style,les traductions,
insilmaril@719
  1573
les icônes, etc.
insilmaril@719
  1574
insilmaril@719
  1575
Pratique pour les tests\tabularnewline
insilmaril@719
  1576
h  & aide  &  & montrer l'aide\tabularnewline
insilmaril@719
  1577
r  & lancement  & fichier  & charger et lancer un script\tabularnewline
insilmaril@719
  1578
q  & quitter  &  & quitter après le démarrage. Utile pour les benchmarks.\tabularnewline
insilmaril@719
  1579
\end{tabular}
insilmaril@719
  1580
\par\end{center}
insilmaril@719
  1581
insilmaril@719
  1582
Vous pouvez aussi donner plusieurs noms de fichiers dans la ligne
insilmaril@719
  1583
de commande pour laisser \vym ouvrir plusieurs cartes à la fois.
insilmaril@719
  1584
insilmaril@719
  1585
insilmaril@719
  1586
\section{Scripts}
insilmaril@719
  1587
insilmaril@719
  1588
\label{scripts} %FIXME
insilmaril@719
  1589
insilmaril@719
  1590
insilmaril@719
  1591
TODO: désolé cette section du manuel de \vym est provisoire.
insilmaril@719
  1592
insilmaril@719
  1593
insilmaril@719
  1594
\subsection{Exemple de scripts}
insilmaril@719
  1595
insilmaril@719
  1596
insilmaril@719
  1597
\subsubsection{Exporter un jeu de cartes}
insilmaril@719
  1598
insilmaril@719
  1599
\begin{verbatim} \# Simple vym script to export images of various
insilmaril@719
  1600
maps simultanously exportImage (); \end{verbatim} Le script au-dessus
insilmaril@719
  1601
peut être utilisé pour exporter automatiquement toutes les cartes
insilmaril@719
  1602
d'un répertoire. Si le script a pour nom \texttt{export-image.vys},
insilmaril@719
  1603
appeler \vym avec\begin{verbatim} vym --quit --run export-image.vys
insilmaril@719
  1604
{*}.vym \end{verbatim}
insilmaril@719
  1605
insilmaril@719
  1606
insilmaril@719
  1607
\section{Aider \vym}
insilmaril@719
  1608
insilmaril@719
  1609
J'ai écrit personnellement 98\% du code moi-même. Aucune surprise
insilmaril@719
  1610
: \vym correspond exactement à mes besoins. Néanmoins j'encourage
insilmaril@719
  1611
tous les utilisateurs de \vym à contribuer. Peut-être pas seulement
insilmaril@719
  1612
avec des demandes d'extensions, mais aussi avec du code, de nouveaux
insilmaril@719
  1613
filtres import/export, des traductions, etc. Dans cet appendice, je
insilmaril@719
  1614
vais essayer de montrer combien il est facile de développer avec \vym.
insilmaril@719
  1615
J'attends vraiment de vos nouvelles au sujet de vos futures extensions
insilmaril@719
  1616
!
insilmaril@719
  1617
insilmaril@719
  1618
insilmaril@719
  1619
\section{Obtenir de l'aide}
insilmaril@719
  1620
insilmaril@719
  1621
insilmaril@719
  1622
\subsection*{Foire Aux Questions}
insilmaril@719
  1623
insilmaril@719
  1624
Pointer la FAQ disponible sur le site de \vym (en anglais) :
insilmaril@719
  1625
insilmaril@719
  1626
\begin{center}
insilmaril@719
  1627
\href{http://www.InSilmaril.de/vym/faq.html}{http://www.InSilmaril.de/vym/faq.html} 
insilmaril@719
  1628
\par\end{center}
insilmaril@719
  1629
insilmaril@719
  1630
insilmaril@719
  1631
\subsection*{Mailinglists}
insilmaril@719
  1632
insilmaril@719
  1633
Il y a deux mailinglists: 
insilmaril@719
  1634
\begin{itemize}
insilmaril@719
  1635
\item \texttt{vym-forum} est le forum des utilisateurs \vym pour discuter
insilmaril@719
  1636
de points divers, 
insilmaril@719
  1637
\item \texttt{vym-devel} est fait pour les gens qui veulent contribuer à
insilmaril@719
  1638
\vym. 
insilmaril@719
  1639
\end{itemize}
insilmaril@719
  1640
Vous pouvez voir les archives et vous inscrire à :
insilmaril@719
  1641
insilmaril@719
  1642
\begin{center}
insilmaril@719
  1643
\href{https://sourceforge.net/mail/?group_id=127802}{https://sourceforge.net/mail/?group\_id=127802} 
insilmaril@719
  1644
\par\end{center}
insilmaril@719
  1645
insilmaril@719
  1646
insilmaril@719
  1647
\subsection*{Contacter l'auteur}
insilmaril@719
  1648
insilmaril@719
  1649
\label{author} En premier essayer les mailinglists. Pour tout autre
insilmaril@719
  1650
problème contacter l'auteur Uwe Drechsel à :
insilmaril@719
  1651
insilmaril@719
  1652
\begin{center}
insilmaril@719
  1653
\href{mailto:vym@InSilmaril.de}{vym@InSilmaril.de} 
insilmaril@719
  1654
\par\end{center}
insilmaril@719
  1655
insilmaril@719
  1656
insilmaril@719
  1657
\section{Comment reporter un bug}
insilmaril@719
  1658
insilmaril@719
  1659
Quoique Sourceforge ait son propre système de rapport de bugs, je
insilmaril@719
  1660
préfère que vous me contactiez directement (voir \ref{author}) ou
insilmaril@719
  1661
encore mieux : vous pouvez mettre un rapport de bug dans Bugzilla,
insilmaril@719
  1662
le système de rapport de bugs de openSUSE : 
insilmaril@719
  1663
insilmaril@719
  1664
\begin{center}
insilmaril@719
  1665
\href{http://en.opensuse.org/Submit_a_bug}{http://en.opensuse.org/Submit\_a\_bug} 
insilmaril@719
  1666
\par\end{center}
insilmaril@719
  1667
insilmaril@719
  1668
Je construis \vym régulièrement pour openSUSE, vous pouvez faire
insilmaril@719
  1669
un rapport pour une autre version , même si vous utilisez un autre
insilmaril@719
  1670
système d'exploitation. N'oubliez pas de me dire lequel vous utilisez
insilmaril@719
  1671
:
insilmaril@719
  1672
\begin{itemize}
insilmaril@719
  1673
\item les manipulations exactes pour reproduire le bug,
insilmaril@719
  1674
\item la version et la date de construction de \vym (voir l'aide Help \ra
insilmaril@719
  1675
About \vym) 
insilmaril@719
  1676
\item le matériel et le système d'exploitation
insilmaril@719
  1677
\end{itemize}
insilmaril@719
  1678
insilmaril@719
  1679
\section{Compiler à partir des sources }
insilmaril@719
  1680
insilmaril@719
  1681
insilmaril@719
  1682
\subsection{Obtenir les sources}
insilmaril@719
  1683
insilmaril@719
  1684
\label{getsources} Vous pouvez trouver la dernière version de \vym
insilmaril@719
  1685
sur le site du projet :
insilmaril@719
  1686
insilmaril@719
  1687
\begin{center}
insilmaril@719
  1688
\href{https://sourceforge.net/projects/vym/}{https://sourceforge.net/projects/vym/} 
insilmaril@719
  1689
\par\end{center}
insilmaril@719
  1690
insilmaril@719
  1691
Là vous pouvez les extraire à partir à partir du dépot des source
insilmaril@719
  1692
(CVS):\\
insilmaril@719
  1693
insilmaril@719
  1694
insilmaril@719
  1695
\begin{verbatim} cvs -d:pserver:anonymous@cvs.sf.net:/cvsroot/vym
insilmaril@719
  1696
checkout code \end{verbatim}
insilmaril@719
  1697
insilmaril@719
  1698
insilmaril@719
  1699
\subsection{le toolkit Qt }
insilmaril@719
  1700
insilmaril@719
  1701
Qt est une trousse à outils C++ multiplateforme pour les GUI%
insilmaril@719
  1702
\footnote{GUI Graphical User Interface interface graphique pour l'utilisateur
insilmaril@719
  1703
(N.d.T.)%
insilmaril@719
  1704
} et le développent d'applications. Il fournit une portabilité avec
insilmaril@719
  1705
le même source sur MS~Windows, Mac~OS~X, Linux et toutes les versions
insilmaril@719
  1706
principales commerciales d'Unix. Qt est aussi disponible pour les
insilmaril@719
  1707
systèmes embarqués. Qt est un produit de la société Trolltech. Pour
insilmaril@719
  1708
plus d'informations voir :
insilmaril@719
  1709
insilmaril@719
  1710
\begin{center}
insilmaril@719
  1711
\href{http://www.trolltech.com/qt/}{www.trolltech.com/qt} 
insilmaril@719
  1712
\par\end{center}
insilmaril@719
  1713
insilmaril@719
  1714
insilmaril@719
  1715
\subsection{Compiler \vym }
insilmaril@719
  1716
insilmaril@719
  1717
Assurez vous que vous avez installé l'environnement QT proprement,
insilmaril@719
  1718
voir la documentation pour les détails. Vous devez avoir la commande
insilmaril@719
  1719
Qt\texttt{ qmake} dans votre variable d'environnement \texttt{PATH},
insilmaril@719
  1720
pusi lancez \begin{verbatim} \$ qmake $make$ make install \end{verbatim}
insilmaril@719
  1721
La dernière commande \texttt{make install} a besoin des droits root.
insilmaril@719
  1722
Elle n'est pas nécessaire si vous voulez juste tester \vym.
insilmaril@719
  1723
insilmaril@719
  1724
%\subsubsection*{Compiling \vym on Macs}
insilmaril@719
  1725
%FIXME
insilmaril@719
  1726
insilmaril@719
  1727
insilmaril@719
  1728
insilmaril@719
  1729
\subsection{format des fichiers de \vym }
insilmaril@719
  1730
insilmaril@719
  1731
\label{fileformat}Les cartes \vym ont un suffixe \texttt{\og .vym} \fg{}
insilmaril@719
  1732
et représentent une archive compressée des données. Si vous voulez
insilmaril@719
  1733
avoir une vue plus précise de la structure des données dans la carte
insilmaril@719
  1734
\og mapname.vym \fg{}, décompressez la en lançant la commande :
insilmaril@719
  1735
\begin{verbatim} \$ unzip mapname.vym \end{verbatim} Cela va créer
insilmaril@719
  1736
les répertoires \texttt{images} et\texttt{ flags} dans votre répertoire
insilmaril@719
  1737
courant et aussi la carte elle-même, normalement appelée \texttt{mapname.xml}.
insilmaril@719
  1738
La structure XML de \vym s'explique d'elle-même, jetez un \oe il
insilmaril@719
  1739
sur le fichier \texttt{mapname.xml}.
insilmaril@719
  1740
insilmaril@719
  1741
Ce fichier XML peut être chargé directement dans \vym, il n'a pas
insilmaril@719
  1742
besoin d'être compressé. Si vous voulez compresser toutes les données
insilmaril@719
  1743
vous-même faites \begin{verbatim} \$ zip -r mapname.vym . \end{verbatim}
insilmaril@719
  1744
pour compresser toutes vos données dans le répertoire courant.
insilmaril@719
  1745
insilmaril@719
  1746
insilmaril@719
  1747
\subsection{Nouvelles fonctionnalités}
insilmaril@719
  1748
insilmaril@719
  1749
Il y a beaucoup de nouvelles fonctionnalités qui sont installées dans
insilmaril@719
  1750
\vym. Avec \vym vous avez reçu un répertoire avec un bon nombre
insilmaril@719
  1751
d'exemples de cartes. Vous les trouverez en cliquant Help \ra Open~vym~example~maps.
insilmaril@719
  1752
Vous y trouverez la carte \texttt{vym-projectplan.vym}. Elle liste
insilmaril@719
  1753
une foule de choses qui seront faites dans le futur. Si vous avez
insilmaril@719
  1754
d'autres idées, contactez l'équipe de développement à \texttt{vym-devel@lists.sourceforge.net}.
insilmaril@719
  1755
insilmaril@719
  1756
insilmaril@719
  1757
\subsection{support pour de nouvelles langues}
insilmaril@719
  1758
insilmaril@719
  1759
Pour pouvoir ajouter une nouvelle langue à \vym, vous devez disposer
insilmaril@719
  1760
des sources (voir \ref{getsources}) et de l'installation de Trolltechs
insilmaril@719
  1761
QT. une partie de QT sont des outils de développement, et particulièrement
insilmaril@719
  1762
l'outil de traduction \og Linguist \fg{} qui est nécessaire.
insilmaril@719
  1763
insilmaril@719
  1764
Dans quelques distributions Linux, les outils de développement sont
insilmaril@719
  1765
un paquetage spécial, par exemple sur SUSE LINUX vous devez avoir
insilmaril@719
  1766
installé : \begin{verbatim} libqt4-devel.rpm libqt4-devel-doc.rpm
insilmaril@719
  1767
libqt4-devel-tools.rpm \end{verbatim} Si vous n'avez pas QT de base
insilmaril@719
  1768
sur votre système, vous pouvez l'obtenir à : \href{http://www.trolltech.com}{http://www.trolltech.com}
insilmaril@719
  1769
Une fois que vous êtes capable de compiler, vous pouvez traduire le
insilmaril@719
  1770
texte dans \vym  lui-même en faisant les actions suivantes :
insilmaril@719
  1771
\begin{itemize}
insilmaril@719
  1772
\item supposons que nous voulons traduire une nouvelle langue \og NEW \fg{}
insilmaril@719
  1773
au lieu de \og de \fg{} en allemand ou \og en \fg{} en anglais,
insilmaril@719
  1774
\item copier le fichier \texttt{lang/vym\_en.ts} to l\texttt{ang/vym\_NEW.ts}
insilmaril@719
  1775
(Le code lui-même contient la version anglaise),
insilmaril@719
  1776
\item ajouter \texttt{lang/vym\_NEW.ts} dans la section TRANSLATIONS de
insilmaril@719
  1777
vym.pro,
insilmaril@719
  1778
\item lancer Linguist sur \texttt{vym\_NEW.ts} et faire la traduction,
insilmaril@719
  1779
\item lancer \texttt{lrelease} pour créer \texttt{vym\_NEW.qm.}
insilmaril@719
  1780
\item faire un make install pour installer le nouveau \vym  et tester la
insilmaril@719
  1781
traduction
insilmaril@719
  1782
\end{itemize}
insilmaril@719
  1783
Si vous vous sentez courageux, vous pouvez traduire le manuel. Il
insilmaril@719
  1784
est écrit en \LaTeX{}, vous devez juste changer le fichier \texttt{/tex/vym.tex}.
insilmaril@719
  1785
(Linguist et QT ne sont pas nécessaires, mais il est utile de savoir
insilmaril@719
  1786
comment travailler avec \LaTeX{} et pdflatex pour créer le PDF.)
insilmaril@719
  1787
insilmaril@719
  1788
S'il vous plaît envoyez moi la traduction que vous avez faite. Je
insilmaril@719
  1789
peux aussi vous donner une accès de développeur au projet, si vous
insilmaril@719
  1790
voulez fournir régulièrement des traductions.
insilmaril@719
  1791
insilmaril@719
  1792
insilmaril@719
  1793
\subsection{Nouveaux filtres d'export/import }
insilmaril@719
  1794
insilmaril@719
  1795
\vym supporte des types de filtres variés. Les données peuvent être
insilmaril@719
  1796
écrites directement, insérées dans des patrons ou peuvent être écrites
insilmaril@719
  1797
en données XML et  ensuite être travaillées par des transformations
insilmaril@719
  1798
XSL.
insilmaril@719
  1799
insilmaril@719
  1800
La plupart des fonctionnalités d'import-export est disponible dans
insilmaril@719
  1801
les classes ImportBase, ExportBase et les classes dérivées. Le tout
insilmaril@719
  1802
se trouve dans \texttt{les fichiers imports.h} et \texttt{exports.h}.
insilmaril@719
  1803
insilmaril@719
  1804
insilmaril@719
  1805
\subsection*{import/export direct}
insilmaril@719
  1806
insilmaril@719
  1807
Un exemple pour l'export direct est l'export XML. Cette méthode touche
insilmaril@719
  1808
l'implémentation de pratiquement tous les objets de \vym, aussi autant
insilmaril@719
  1809
que possible utilisez une transformation XSL à la place.
insilmaril@719
  1810
insilmaril@719
  1811
Si vous voulez savoir comment cela est fait, commencez à regarder
insilmaril@719
  1812
\texttt{MapEditor::saveToDir} in \texttt{mapeditor.cpp}.
insilmaril@719
  1813
insilmaril@719
  1814
insilmaril@719
  1815
\subsection*{patrons}
insilmaril@719
  1816
insilmaril@719
  1817
Les patrons ont été introduits pour exporter dans le format opendoc
insilmaril@719
  1818
utilisé par Open~Office. Pendant que je lisais la spécification du
insilmaril@719
  1819
format (plus de 500 pages),%
insilmaril@719
  1820
\footnote{ \href{http://www.oasis-open.org/}{http://www.oasis-open.org/}%
insilmaril@719
  1821
} j'avais le sentiment que je ne voulais pas écrire l'export à partir
insilmaril@719
  1822
de rien. Cela serait trop difficile pour adapter les styles à vos
insilmaril@719
  1823
propres besoins par exemple le canevas.
insilmaril@719
  1824
insilmaril@719
  1825
En analysant un document Open~Office existant, je trouvais qu'il
insilmaril@719
  1826
y avait un grand nombre d'informations redondantes dans une présentation
insilmaril@719
  1827
standard, par exemple chaque Item d'une liste est contenu dans sa
insilmaril@719
  1828
propre liste. À la fin j'en arrivai à un style de présentation par
insilmaril@719
  1829
défaut, qui peut encore être simplifié, si j'ai du temps de libre
insilmaril@719
  1830
\ldots{}
insilmaril@719
  1831
insilmaril@719
  1832
Les patrons existants sont encore en évolution, avant de développer
insilmaril@719
  1833
votre propre style contactez moi. De base les étapes suivantes sont
insilmaril@719
  1834
nécessaires pour que vous construisiez votre propre style :
insilmaril@719
  1835
\begin{enumerate}
insilmaril@719
  1836
\item créer un exemple dans Open Office. Utilisez un titre, les noms de
insilmaril@719
  1837
auteurs, les entêtes de page, etc que vous pourrez facilement piquer
insilmaril@719
  1838
dans le fichier de sortie,
insilmaril@719
  1839
\item décompressez le document Open Office dans un répertoire,
insilmaril@719
  1840
\item le fichier principal est appelé\texttt{ content.xml}. Toutes les données
insilmaril@719
  1841
sont sur une seule ligne. Vous pouvez exploser les marques XML en
insilmaril@719
  1842
utilisant le script \texttt{scripts/niceXML}, qui fait partie de la
insilmaril@719
  1843
distribution de \vym. 
insilmaril@719
  1844
\item copiez la sortie de \texttt{niceXML} dans \texttt{content-template.xml}.
insilmaril@719
  1845
\item en regardant dans le détail , vous trouverez nombre de définitions
insilmaril@719
  1846
inutilisées, par exemple les styles. Vous pouvez les effacer ou simplement
insilmaril@719
  1847
les ignorer.
insilmaril@719
  1848
\item Essayez de trouver votre titre, le nom de auteurs. \vym va remplacer
insilmaril@719
  1849
les chaînes suivantes lors de l'export :
insilmaril@719
  1850
insilmaril@719
  1851
insilmaril@719
  1852
\begin{center}
insilmaril@719
  1853
\begin{tabular}{lp{4cm}}
insilmaril@719
  1854
\texttt{<!-{}- INSERT TITLE -{}->}  & titre de la carte \tabularnewline
insilmaril@719
  1855
\texttt{<!-{}- INSERT AUTHOR-{}->}   & auteur\tabularnewline
insilmaril@719
  1856
\texttt{<!-{}- INSERT COMMENT -{}->}  & commentaire\tabularnewline
insilmaril@719
  1857
\texttt{<!-{}- INSERT PAGES-{}->}  & contenu de la carte \tabularnewline
insilmaril@719
  1858
\end{tabular}
insilmaril@719
  1859
\par\end{center}
insilmaril@719
  1860
insilmaril@719
  1861
Le contenu lui-même est généré d'une manière similaire en insérant
insilmaril@719
  1862
des listes dans \texttt{page-template}. Les remplacements suivants
insilmaril@719
  1863
sont effectues :
insilmaril@719
  1864
insilmaril@719
  1865
\begin{center}
insilmaril@719
  1866
\begin{tabular}{lp{7cm}}
insilmaril@719
  1867
\texttt{<!-{}- INSERT PAGE HEADING-{}->}  & entête de la page (branche principale ou fils, dépendant de l'utilisation
insilmaril@719
  1868
des sections) \tabularnewline
insilmaril@719
  1869
\texttt{<!-{}- INSERT LIST -{}->}   & tous les fils de la branche du dessus\tabularnewline
insilmaril@719
  1870
\end{tabular}
insilmaril@719
  1871
\par\end{center}
insilmaril@719
  1872
insilmaril@719
  1873
\end{enumerate}
insilmaril@719
  1874
Actuellement les images sont exportées et les notes vont apparaître
insilmaril@719
  1875
comme du texte sans mise au format ni couleur.
insilmaril@719
  1876
insilmaril@719
  1877
insilmaril@719
  1878
\subsection*{XSL Transformation}
insilmaril@719
  1879
insilmaril@719
  1880
\vym utilise des transformations XSL pour l'exportation (par exemple
insilmaril@719
  1881
en XHTML) et pour l'importation des données(par exemple les bookmarks
insilmaril@719
  1882
KDE). Il faut écrire un peu de code pour fournir le GUI, le reste
insilmaril@719
  1883
est fait en utilisant la feuille de style \texttt{.xsl} et en appelant
insilmaril@719
  1884
le processeur \texttt{xsltproc, }qui fait partie de libxslun, la librairie
insilmaril@719
  1885
C XSLT pour GNOME.
insilmaril@719
  1886
\end{document}