# The Guide Officiel de &kdissert;

## Introduction

&kdissert; est un programme pour la création de cartes mentales contenant du texte, des images, des commentaires et des hyperliens, ainsi que la transformation de ces cartes en documents tels que rapports ou présentations. &kdissert; permet dès maintenant de créer des documents LaTeX (présentations utilisant Beamer ou Prosper, des rapports ou articles au format pdf), des documents OpenOffice.org texte, html et texte brut. Ce programme peut s'avérer très utiles pour des étudiants, mais aussi pour des professeurs, des hommes d'affaires ainsi que tout ceux qui ont besoin de créer des présentations très rapidement.

## Utiliser kdissert

Il est recommandé de suivre le parcours suivant :

- Commencer par ajouter des objets sur la carte - en ajouter autant que possible

- Se mettre en mode lien puis commencer à relier les idées

- Effacer les objets en trop, équilibrer l'arbre (3-4 objets par branche en moyenne, pas plus de 5 niveaux de parenté)

- Ajouter du texte et des images aux objets de la carte - plus il y en a, mieux c'est (des images surtout, en particulier pour les rapports)

- Se mettre en mode tri, puis ordonner les branches par ordre de pertinence

- Générer les documents et travailler sur ceux-ci (LaTeX, OpenOffice, ..)

## Démarrage rapide sur &kdissert;

Tout d'abord, il vous faut créer une carte mentale de vos idées en utilisant la vue carte mentale (premier onglet à gauche sur l'interface de kdissert). Il est recommandé de maximiser la fenetre pour prendre le maximum d'espace. Ensuite, effectuez un clic droit sur la vue carte mentale (au milieu) et créez une racine.

Un double-clic sur la vue carte mentale permet aussi de créer un nouvel objet. Un ou des objets sélectionnés peuvent etre effacés par l'emploi de la touche "suppr". Les racines (objets déconnectés) sont de couleur jaune, tandis que les feuilles (objets connectés) sont en vert.

Utilisez le mode sélection (icone avec un curseur) pour entrer dans le mode sélection. Vous pouvez maintenant sélectionner des objets et les donner plus d'espace pour de nouveaux objets (utilisez les touches flèches tout en tenant le bouton gauche de la souris enfoncé). Lors d'un glisser-déplacer, une zone de sélection apparait pour permettre de sélectionner d'un coup un grand nombre d'items. Ceux-ci peuvent aussi etre saisis en maintenant la touche "shift" enfoncée et en cliquant sur les items voulus.

Utilisez le mode connection (icone avec un plus) pour connecter un objet à des parents ou à une racine. Pour cela, cliquez sur un objet, et en maintenant le bouton gauche de la souris enfoncé, amenez l'extrémité du fil qui apparaît au-dessus de l'objet cible. Les connections peuvent partir de n'importe quel objet, mais doivent arriver sur un objet non connecté (couleur jaune).

Pour utiliser les générateurs de documents efficacement, il est nécessaire de donner des priorités sur les branches de l'arbre. Pour cela, utilisez le mode triage (icone avec des nombres) puis cliquez sur un objet. Des nombres (pastilles jaunes) vont apparaître sur ses ramifications. Il suffit alors de cliquer séquentiellement sur ces pastilles pour changer l'ordre des branches.

Les générateurs de documents sont de puissants outils permettant de réutiliser l'information portée par la carte. Ceux-ci sont accessible à travers le menu Outils. Les instructions nécessaires à l'utilisation des documents générés sont fournies dans le dialogue qui s'affiche, lisez-les attentivement.

Il est enfin possible de prendre une image de la carte obtenue en choisissant l'option d'export accessible dans le menu Outils. L'image obtenue est au format PNG, celle-ci peut etre réutilisée par la plupart des outils graphiques.

## Fonctionnalités avancé

Il est possible d"entrer le résumé d"un objet directement dans la vue carte mentale lorsqu"un objet est séléctionné Lorsqu"aucun objet n'est séléctionné, le dernier l"est automatiquement

L"action de la molette de la souris sur des objets séléctionnés en maintenant la touche control enfoncée permet d'accroitre ou de diminier la taille de la fonte employé pour ceux-ci.

En mode sélection, un double clic en maintenant la touche control enfoncée permet de déconnecter un objet de son parent. En cliquant sur deux objets diffé en maintenant la touche control enfoncée, il est possible de les lier (dans l"ordre parent vers futur enfant).

Le mode déplacement (icone avec une loupe) peut s'avérer utile pour la manipulation de grandes cartes. Pour l'utiliser, cliquez sur la vue carte mentale, et bougez la souris tout en maintenant le bouton gauche enfoncé pour effectuer une translation de la vue.

Pour changer entre les modes sélection, connection, tri et loupe plus rapidement, les raccourcis par défaut sont les suivants : 'f' pour sélection, 'd' pour connection, 's' pour tri et 'a' pour déplacement. Ces raccourcis peuvent etre changés à travers l'éditeur de raccourcis, disponible dans le menu 'options'.

La représentation linéaire peut etre employée pour voir l'arbre à plat. Le glisser-déplacer ainsi que certaines actions sont déjà implémentées : effacer (touche suppr), descendre dans la hiérarchie (touche o), monter dans la hiérarchie (touche p).

Les générateurs de documents utilisent en principe la racine de l'arbre contenant le plus grand nombre de 'feuilles'.

Pour centrer la vue sur la racine de l'arbre le plus important, il suffit d'utiliser le raccourci 'ctrl+h'.

Afin de donner plus de sens à la carte, il est possible de changer les couleurs et les polices. Les menus nécessaires sont accessibles après un clic droit sur un objet sélectionné (vue linéaire ou carte mentale). Ceci s"applique ausssi aux groupes d'objets sélectionnés.

Maintenir la touche control enfoncée tout en bougeant la molette de la souris pour augmenter la taille d'un item sous le pointeur, ou d'un groupe d"objets sélectionnés

Maintenir la touche control enfoncée en mode ajout de liens afin d'ajouter des références. Celles-ci sont utilisées dans les générateurs LaTeX article et book. Pour enlever une référence, il suffit d'effectuer un clic droit sur celle-ci, puis de choisir le sous-menu déconnecter.

Il est possible de parcourir la carte à l'aide des raccourcis control+flèches. Des objets séléctionnés peuvent être déplacés en utilisant les raccourcis alt+flèches.

Utilisez le petit carré en haut à droite des fenêtre encastrées pour les faire rester. Les raccourcis F2 et F3 permettent de mettre le focus sur la carte et sur l'encastrement pour l'édition de texte respectivement.

Le glisser-déplacer de texte sur la vue carte ou sur les objets de la carte est permis.

## Options

Les options de kdissert pour les nouveaux documents ne sont appliquées qu"à la création de ceux-ci. Pour changer les options du document ouvert, utilisez le sous-menu Edition, Propriétés du document.

La police par défaut représente la police utilisée par les accessoires de la carte (disques montrant l'ordre des items), ainsi que la police initiale des objets. La police des objets est sauvegardée dans les documents. Ainsi pour changer la police pour tous les objets, il faut d'abord tous les sélectionner puis appliquer une nouvelle police (sélection des objets dans la vue carte mentale, clic-droit sur un des objets, puis choisir la nouvelle police).

La taille des vignette représente la taille des images visibles sur la vue carte mentale lorsque des objets disposent d'une image. L'affichage de ces vignettes peut etre désactivé en décochant la case à cocher appropriée.

## Guide pour les futurs développeurs de &kdissert;

Afin de démarrer sur kdissert, il est fortement conseillé de lire les fichiers README, ROADMAP et HACKING incudes dans la distribution source de kdissert. Contrairement à la plupart des projets kde, le systè est basé sur scons et bksys, qui est bien plus compréhensible et utilisable que tous les autres. Plusieurs essais (échecs) ont été faits afin d'utiliser qmake, mais scons semble vraiment être la meilleure solution.

Pour créer de nouveaux plugins pour kdissert, il est recommandé de prendre un des générateurs existants dans src/templates (par exemple : kdissasciidoc), de changer le nom (en gardant le préfixe "kdiss"), puis de s'en inspirer pour créer une librairie. Les fichiers .h et .cpp devront etre modifiés (copiez-les puis changez les noms). Le contenu du fichier SConscript devra etre adapté.

Une archive de type tar.gz nommée "kdissPLUGIN.tar.gz" est requise pour le fonctionnement du plugin. Celui-ci ne fonctionnera pas si son archive est absente. Il est aussi recommandé d'inclure un fichier README dans cette archive.

## Questions et réponses

&reporting.bugs; &updating.documentation;

Je n'arrive pas à créer de nouvel objet sur la carte ?

Un double-clic gauche ou un clic droit ...

Comment enlever une référence ?

Un clic-droit sur la référence, puis déconnecter, référence.

La fonctionnalité XXX n'est pas disponible ?

Le programme n'est pas terminé. Vous etes invité à y participer, pour cela, consultez les fichiers ROADMAP et HACKING situé dans la distribution contenant le code source du programme.

## Credits and License

&kdissert;

Programme copyright 2003, 2004, 2005 Thomas Nagy tnagy2^8@yahoo.fr

&underGPL;

Documentation copyright 2004, 2005 Thomas Nagy tnagy2^8@yahoo.fr

&underFDL;

## Installation

### Comment obtenir &kdissert;

La page du projet kdissert est accessible ici Lorsque celle-ci est indisponible, une copie se trouve ici

### Requis

Afin d'utiliser &kdissert;, &kde; 3.2 est requis (3.2 minimum) ainsi que python 2.3 pour la compilation

Les librairies requises peuvent etre retrouvées sur Le site ftp du projet KDE.

### Compilation and Installation

Si vous disposez de SCons, utilisez : scons; scons install

Dans le cas contraire : ./unpack_local_scons.sh; make; make install

&documentation.index;