Manuel d'utilisation d'OT2
Cette rubrique va vous permettre d'installer OT2 en moins de 5 minutes.
Pour télécharger OT2, vous devez aller sur le
site sourceforge, l'adresse des téléchargements
est :
Vous aurez alors le choix entre différentes versions d'OT2.
Choisissez la dernière. Au moment de la rédaction
de ce document il s'agît de la version : 1.0.1. Nous allons
donc choisir ce fichier qui se nomme ot2-win-1.0.1-setup.exe,
le votre aura un nom similaire. Nous allons maintenant pouvoir
l'installer.
L'installation est simple : double-cliquez sur le fichier que vous
venez de télécharger et répondez aux
questions. L'installateur se chargera du reste.
Vous devez maintenant créer un dossier pour stocker
toutes les données afférentes à votre
collection. Dans la suite de ce doc, ce dossier sera appelé macollection. Nous allons
maintenant pouvoir exécuter le logiciel pour la
première fois.
Pour exécuter OT2, lancer le programme en double-cliquant
sur le fichier ot2.exe ou choississez Ot2 dans le menu application du
menu démarrer. Lors de la première
exécution du logiciel, vous allez devoir configurer quelques
paramètres,
une fenêtre de dialogue s'ouvre donc pour vous informer que
vous allez devoir répondre aux questions suivantes que nous
allons détailler ensemble. Cliquer sur le bouton suivant
pour accéder à l'écran
présenté sur la figure 1.
Figure:
L'écran de configuration de base
 |
- La première question est le nom que vous voulez
donner à votre collection. Pour la suite du document, nous
l'appelerons bonsai.
- La seconde permet de donner le chemin du dossier
où seront stockées toutes les données
de votre collection. Dans notre cas, nous choisirons le dossier macollection , en cliquant sur
le bouton choisir, il
faudra naviguer jusqu'à trouver le bon nom de dossier comme
le montre la figure 2
- La dernière question concerne le choix de votre
éditeur graphique, c'est à dire le logiciel que
vous utilisez pour modifier des photos. Sous windows, il peut s'agir de
Photoshop, Photofiltre, Paint,
etc. Si vous n'en avez aucun, ne pascocher la case correspondante comme
sur la figure 1. Sinon
utiliser le bouton choisir,
pour sélectionner le fichier exécutable de votre
éditeur, nous préciserons ceci dans la suite du
document. A ce stade votre logiciel est opérationnel.
Figure 2:
Choix du dossier macollection
 |
Vous venez de terminer la configuration du programme.
L'écran ressemble donc à la photo 3. La fenêtre principale
est divisée en deux, la partie gauche comporte quatre
onglets : Arbres,
évènements, photos, pots. Nous
allons d'abord nous occuper de cette partie.
Figure:
Fenêtre principale du programme
 |
Lors de son initialisation, la base de donnée a
créé un arbre "test". Comme ce nom a peu de
chances de vous plaire, modifions-le ensemble. Avec le bouton droit de
la souris, cliquez sur la rangée qui en présente
le résumé. Un menu surgit,
sélectionnez l'élément Modifier les données de l'arbre.
Un dialogue comme celui présenté sur la figure 4 apparaît. Les champs
marqués d'une croix rouge doivent impérativement
être remplis avant que le bouton Accepter
soit actif. Choisissez les valeurs qui vous conviennent, l'ensemble ne
devrait pas poser de difficultés sauf
éventuellement l'intitulé dérivation
dans le type d'origine. Nous y reviendrons plus loin dans ce doc. En ce
qui nous concerne, nous avons juste changé le nom de test en mon
bâton et l'espèce en Acer palmatum. Cliquez sur le
bouton Accepter. Le
dialogue se ferme et les données de l'arbre dans l'onglet arbres se mettent à
jour.
Figure:
Dialogue pour la création ou la modification d'un arbre
 |
L'ajout d'un nouvel arbre se fait de manière similaire :
cliquer sur le bouton Ajouter un
arbre, remplir les champs du dialogue, cliquer sur Accepter. Le
résumé correspondant à l'arbre que
vous venez d'ajouter apparaît.
Avant de commencer, une petite précision : lors de
l'installation, nous avons choisi le dossier macollection
comme devant contenir nos données. Lors de l'initialisation
du programme, des éléments ont
été ajoutés, voir capture
d'écran de la figure 5.
Figure 5:
Structure du dossier macollection
 |
Le fichier bonsai.otq
correspond à la base de données où
sont gardés tous les renseignements concernant votre
collection. Le dossier arrivages
est justement prévu, même si ce n'est pas
obligatoire, pour y mettre les photos que l'on veut rajouter
à la collection. Glissons y donc une photo de mon bâton, cliquons
encore du bouton droit de la souris sur le
résumé, et choisissons Ajouter
une photo.
Une fenêtre de dialogue s'ouvre; appuyons sur le bouton Choisir : le dialogue de choix
de fichier s'ouvre dans le dossier arrivages,
choisissons le fichier qui nous intéresse (si la photo n'est
pas dans ce dossier vous pouvez naviguer librement dans votre disque
dur pour le trouver), Accepter.
Le dialogue d'ajout de photo ressemble alors à la figure 6.
Figure 6:
Dialogue d'ajout d'une photo
 |
Les champs marqués d'une croix rouge sont obligatoires,
lorsque le dialogue est lancé comme nous l'avons fait, deux
de ces champs, Type
et Référence
sont pré-remplis et ne peuvent pas être
modifiés. Pour l'instant, ne cochons pas l'option Utiliser la photo comme défaut.
Le rôle de ce choix est expliqué plus loin. Le
dialogue comporte aussi une liste d'option de redimensionnement. Il
n'est pas obligatoire de redimensionner, mais l'utilisation de photos
trop lourdes peut ralentir sensiblement l'affichage. À vous
de trouver le compromis qui correspond à votre ordinateur.
Notez aussi que par défaut, une copie de la photo non
redimensionnée est faite : vous ne perdez donc pas
d'information lors de cette opération. Appuyons sur Accepter.
Vous observez alors qu'une photo réduite s'affiche
alors automatiquement dans le résumé
correspondant à mon
bâton. Si vous cliquez sur l'onglet photos, vous constatez qu'il a
aussi été mis à jour et qu'une
vignette de la photo s'affiche dans la liste.
Si vous explorer les sous dossiers du dossier macollection, vous constatez
alors :
- Que le dossier arrivages
est vide,
- que le dossier images
contient la photo redimensionnée qui sera utilisé
pour l'affichage dans le programme,
- que le dossier originaux
contient la photo...originale et
- que le dossier vignettes
contient un fichier du type thu_ +
nomdemaphoto. Ce sont ces fichiers qui sont
utilisés pour l'affichage dans les listes.
Un évènement
est quelque chose qui arrive à votre arbre : le plus souvent
cela sera un travail,mais cela peut aussi être une maladie,
une exposition etc. Pour des raisons pédagogiques, nous
allons ajouter deux évènements à mon bâton.
Cliquons donc encore du bouton droit sur le
résumé, et choisissons Ajouter
un évènement. Le dialogue
correspondant s'ouvre (Figure 7.
Figure:
Dialogue d'ajout d'évènement
 |
Comme d'habitude, les champs marqués d'une croix rouge
doivent être remplis. Lorsque le dialogue est
lancé ainsi, le champ Appliqué
à est prérempli et ne
peut-être modifié. Toujours pour des raisons
pédagogiques, nous allons ajouter un
évènement fait dans le passé, par
exemple un rempotage fait au printemps précédent.
Ajustons donc la date Prévu
pour à une date passée, par
exemple le 1mars 2005, sans oublier que suite à un bug, il
faut taper à la main les chiffres des années et
non pas utiliser les flèches. Cochons aussi l'option Marquer comme fait et mettons-y
la même date que plus haut. Cliquons sur Accepter.
Recommençons le même processus. Cette fois-ci,
nous allons fixer un évènement dans le futur.
Cette fois, ce sera une exposition de quartier, la 
.
2007, l'arbre ne sera pas prêt, 2008, c'est un peu
tôt, va pour 2009. Il ne faut donc pas cocher la case Marquer comme fait. Cliquons sur
Accepter. Le
deuxième évènement
a été enregistré.
Cliquons maintenant sur l'onglet évènements.
Les résumés des deux
évènements s'affichent. Modifions le choix Tous les évènements
dans le menu déroulant en haut à droite du texte Voir par l'une ou l'autre des
possibilités et observons les différences. Sont
considérés comme imminents les
évènements devant être
réalisés dans moins d'un mois. Vous pouvez aussi
imprimer cette liste pour l'emmener au jardin.
Revenons à l'onglet arbres,
Si nous double-cliquons sur le résumé , un nouvel
onglet s'ouvre dans la partie droite de la fenêtre qui
récapitule par ordre chronologique l'ensemble des
informations que nous avons insérées concernant
cet arbre. La même possibilité est accessible par
un clic droit sur le résumé, suivi du choix Voir l'historique.Un clic droit
sur les éléments affichés vous
présente la possibilité de différentes
actions. Je vous laisse expérimenter par vous
même, notamment le menu Voir
la photo en grand.
L'essai de ce programme ne vous a pas convaincu et vous souhaitez vous
en débarrasser. Notez que l'auteur de ce logiciel serait
intéressé de savoir pourquoi, afin de
l'améliorer. Son adresse courriel est dans la
fenêtre de dialogue A
propos d'OT2.
Dans le menu application choisir OT2->désinstaller
OT2. Le répertoire contenant l'application et
les préférences stockées dans le
registre seront complètement effacées, mais pas
le dossier contenant votre collection.
Il suffit de supprimer le dossier contenant le programme. Pour une
suppression des préférences, il faut supprimer le
dossier /.config/logodenn.com, par exemple par
rm -rf ~/.config/logodenn.com
Voilà, les principaux éléments de
l'utilisation d'OT2 vous ont été
présentés et vous devriez être capable
de l'utiliser. Par la suite, ce doc va présenter en
détail chaque aspect du programme.
Cette partie s'adresse plus spécifiquement à ceux
qui souhaitent participer au développement d'OT2 ou aux
utilisateurs de GNU/Linux.
2.1
Compiler sous GNU/Linux
- Installer les outils de compilation gcc, gcc-c++
et mysql-server vous souhaitez utiliser mySql comme gestionnaire de
base de données.
- Ensuite, installer les versions les plus
récentes possibles de QT4, en incluant les
bibliothèques pour le sql. Sur un système de type
Debian, il
s'agît donc des paquets : libqt4-core,libqt4-gui, libqt4-sql,
qt4-dev-tools et libqt4-dev.
Sous fedora core 6, il s'agît de qt4, qt4-devel, qt4-mysql.
Alternativement, vous pouvez
télécharger la dernière version depuis
le site de Trolltech et la compiler vous même (c'est long) en
tapant :
#./configure -qt-sql-mysql -qt-sql-sqlite
Sur mon système Ubuntu 6.06, j'ai en plus besoin de rajouter
-I/usr/include/mysql/
Taper ensuite,
#make
puis, comme super-utilisateur,
#make install
- Décompresser les sources d'OT2, aller dans le
dossier ot2 et
#rm src/Makefile
Si vous ne souhaitez pas compiler avec le support de mySql,
éditez le fichier src/src.pro et commentez le passage :
unix{
LIBS += -lmysqlclient
}
en mettant des "#" au début de chaque ligne.
Dans le cas contraire, -il faut remplacer la
dernière ligne du fichier src/base_mysql.sql par : CREATE
TABLE ttd_version(Id int(11) NOT NULL, major int(11), minor int(11),
PRIMARY KEY (Id) ) TYPE=MyISAM et si votre système est du
type fedora core, avec les bibliothèques mySql dans
/usr/lib/mysql au lieu de /usr/lib/, modifiez le paragraphe
comme suit :
unix{
LIBS += -mysql/lmysqlclient
}"
- Tapez ensuite
#cd src
#qmake-qt4 -o Makefile ot2.pro
#make
- L'exécutable est créé dans
le dossier ../bin/.
Il n'y a pas de make install
pour l'instant. Les binaires d'OT2 contenant tout ce qui est
nécessaire pour son exécution, vous pouvez le
mettre où vous le souhaitez.
- Configuration du programme.
- démarrer mysql :
# service mysqld start (fedora core) ou #/etc/init.d/mysql start (Debian)
-
attribuer un mot de passe à l'utilisateur root su serveur
mysql : # mysqladmin -u root password 'new-password' - créer
votre base de donnée : # mysqladmin -h localhost -u root
-ppassword create votre_base.
- Se connecter à mysqld : # mysql -h localhost -u
root -p********** ( les étoiles sont votre mdp attention pas
d'espace entre -p e le mdp).
- Créer un utilisateur pour notre base :
mysql>
use mysql mysql> INSERT INTO user (Host, User, Password,
Select_priv) VALUES ('', 'votre_user', password('********'), 'Y');
mysql> GRANT ALL PRIVILEGES ON votre_base.* TO votre_user;
mysql> FLUSH PRIVILEGES;
- Vous pouvez maintenant quittez le serveur mysql :
mysql> quit
- recharger la table des droits :
# mysqladmin -u root -p***********
reload
- démarrer OT2 : $ votre_chemin/bin/ot2
- modifier les paramètres de conf de connexion :
cliquez
sur edition => préférences =>
Utiliser un serveur mysql
remplir avec les infos
précédemment créées
L'essentiel de la gestion des arbres a été
présenté dans le chapître
Démarrage rapide. Nous allons juste revenir sur certaines
particularités ou fonction avancées.
Supposons que vous disposiez de semis en grand nombre. Au
début, vous allez souhaiter les suivre tous ensemble, puis,
les arbres grandissant et se différenciant, il sera
intéressant de les individualiser. OT2 vous permet de le
faire tout en conservant l'historique des opérations
effectuées alors que l'arbre n'était pas
individualisé.
Pour ce faire, créez votre lot en appuyant sur le
bouton Ajouter un arbre,
entrez le nombre d'arbres de votre lot. Quand vous voulez
individualiser votre arbre, vous lancez de nouveau le dialogue de
création d'un arbre et vous choississez dérivation dans le
type d'origine. À ce moment, le menu arbre
d'origine devient actif. Choisissez votre lot de semis
comme origine, complétez le dialogue et appuyez sur accepter. Le nombre d'arbres
dans votre lot de semis a diminué du nombre que vous avez
entré pour le nouvel arbre et si vous regardez l'historique
du nouvel arbre, vous constaterez qu'il contient les informations
- du lot de semis de la création de celui-ci
jusqu'à la création de l'arbre,
- de l'arbre uniquement après sa
création.
Une des possibilités très pratiques d'OT2 est de
pouvoir exporter les données de votre collection sous forme
de pages HTML. Pour cela, créez dans l'explorateur un
dossier vide. Ensuite, dans le menu Fichiern
choisir Exporter les
données en HTML. Un petit dialogue s'ouvre
alors; indiquer dans Emplacement du
dossier le dossier que vous venez de créer.
Optionnellement, vous pouvez indiquer une photo servant
d'arrière plan ou une feuille de style. Une feuille de
style, appelée styles
est proposée dans le dossier de l'application.
Très sincères remerciements à tous
ceux qui ont bien voulu me faire part de leurs critiques, conseils et
rapports de bugs, notamment Yves (Khazaar) et Petit-Arbre de http://www.parlonsbonsai.com,
Anthony (totospv) de http://www.edgbonsai-fr.com,
Yves Veau, Peter Goettsche et Yohann Desquerre.
******************Fin provisoire du doc*********************
Manuel d'utilisation d'OT2
This document was generated using the
LaTeX2HTML
translator Version 2002-2-1 (1.71)
Copyright © 1993, 1994, 1995, 1996,
Nikos
Drakos, Computer Based Learning Unit, University of Leeds.
Copyright © 1997, 1998, 1999,
Ross Moore,
Mathematics Department, Macquarie University, Sydney.
The command line arguments were:
latex2html -html_version
4.0,unicode -split 0 -show_section_numbers doc_fr.tex
The translation was initiated by alain on 2006-08-09
alain
2006-08-09
