Module GVExport : Différence entre versions
(→Using) |
|||
(12 révisions intermédiaires par 2 utilisateurs non affichées) | |||
Ligne 1 : | Ligne 1 : | ||
− | '''ATTENTION ! ce module est proposé par un tiers et n'est pas entretenu par l'équipe de développement de PhpgedView ! l'équipe de PhpGedView vous précise donc que tout bug qui serait causé par l'implémentation de ce module ne pourra pas | + | '''ATTENTION ! ce module est proposé par un tiers et n'est pas entretenu par l'équipe de développement de PhpgedView ! l'équipe de PhpGedView vous précise donc que tout bug qui serait causé par l'implémentation de ce module ne pourra pas être résolu par l'équipe. |
Cependant, le développeur de ce type de modules est membre du forum de PhpGedView, et pouvez donc le contacter directement sur le forum en cas de problème.''' | Cependant, le développeur de ce type de modules est membre du forum de PhpGedView, et pouvez donc le contacter directement sur le forum en cas de problème.''' | ||
Ligne 10 : | Ligne 10 : | ||
==Comment obtenir le module GVExport== | ==Comment obtenir le module GVExport== | ||
Vous pouvez télécharger la dernière version de GVExport sur le site personnel de Ferenc Kurucz.<br> | Vous pouvez télécharger la dernière version de GVExport sur le site personnel de Ferenc Kurucz.<br> | ||
− | Dernière version: '''0. | + | Dernière version: '''0.8.0''', 2009-02-15<br> |
+ | [http://www.diamanta.hu/_korbendallas_/gvexport/gvexport_0.8.0.zip GVExport_0.8.0] | ||
+ | |||
+ | La version 0.8.0 I a été testée uniquement avec la version PGV 4.2/4.2SVN, il est donc possible qu'elle ne fonctionne pas avec des versions antérieures de PhpGedView...... | ||
+ | |||
+ | Vous pouvez télécharger la dernière version qui a été testée sur PGV 4.1 ici:<br> | ||
[http://www.diamanta.hu/_korbendallas_/gvexport/gvexport_0.7.2.zip GVExport_0.7.2] | [http://www.diamanta.hu/_korbendallas_/gvexport/gvexport_0.7.2.zip GVExport_0.7.2] | ||
− | == | + | ==Pré requis== |
=== PGV === | === PGV === | ||
− | Bien évidemment, vous | + | |
− | + | Bien évidemment, vous devez avoir installé PhpGedView. | |
+ | (Je l'ai testée avec la 4.1.3, 4.1.4, 4.1.5, 4.1.6 SVN, 4.2, 4.2SVN) | ||
=== GraphViz === | === GraphViz === | ||
Ligne 22 : | Ligne 28 : | ||
;Linux | ;Linux | ||
− | + | Graphviz existe pour la plupart des distributions Linux: Debian, Ubuntu, Fedora. | |
Vous trouverez les liens de téléchargement ici: http://www.graphviz.org/Download..php | Vous trouverez les liens de téléchargement ici: http://www.graphviz.org/Download..php | ||
;Windows | ;Windows | ||
− | + | Graphviz existe aussi sous Windows. | |
Vous pouvez le télécharger ici: http://www.graphviz.org/Download_windows.php | Vous pouvez le télécharger ici: http://www.graphviz.org/Download_windows.php | ||
+ | |||
+ | Vous obtiendrez des informations intéressantes sur Graphviz ici: | ||
+ | |||
+ | http://doc.ubuntu-fr.org/graphviz | ||
+ | http://cyberzoide.developpez.com/graphviz/ | ||
+ | http://fr.wikipedia.org/wiki/Graphviz | ||
==Installation== | ==Installation== | ||
Ligne 49 : | Ligne 61 : | ||
==Utilisation== | ==Utilisation== | ||
− | Si l'installation s'est | + | Si l'installation s'est correctement déroulée, vous devriez alors voir apparaître sur la barre de menu une nouvelle icône appelée "Export Graphviz". |
En passant votre souris sur cette icône, vous verrez apparaître le sous-menu "Arbre tout-en-un". Il vous suffit de cliquer sur ce lien. | En passant votre souris sur cette icône, vous verrez apparaître le sous-menu "Arbre tout-en-un". Il vous suffit de cliquer sur ce lien. | ||
===Paramètres de sortie=== | ===Paramètres de sortie=== | ||
+ | |||
+ | La fenêtre d'export de l'arbre tout-en-un apparait comme suit: | ||
+ | |||
+ | [[Image: Graphviz.png|thumbs|350 px|Cliquer sur l'image pour l'agrandir]] | ||
+ | |||
;Type de fichier généré | ;Type de fichier généré | ||
Ligne 63 : | Ligne 80 : | ||
Si votre application GraphViz supporte le format de sortie PDF, je vous recommande de l'utiliser à chaque fois, parce que les temps de calcul sont sont plus faibles et parce qu'il est moins gourmand en taille mémoire. | Si votre application GraphViz supporte le format de sortie PDF, je vous recommande de l'utiliser à chaque fois, parce que les temps de calcul sont sont plus faibles et parce qu'il est moins gourmand en taille mémoire. | ||
− | ''Attention: JPG a une limite de taille de pixel de 64K pixel (à la fois en largeur et en hauteur) qui ne peut pas être modifiée, PNG n'a pas une telle limitation mais l'utilisation de la mémoire peut être extrêmement importante durant le traitement. Basé sur mon expérience, l'usage | + | ''Attention: JPG a une limite de taille de pixel de 64K pixel (à la fois en largeur et en hauteur) qui ne peut pas être modifiée, PNG n'a pas une telle limitation mais l'utilisation de la mémoire peut être extrêmement importante durant le traitement. Basé sur mon expérience, l'usage recommandé est le suivant: Largeur * Hauteur * 2 kilobits, afin que la création d'une image d'une taille de 50000x10000 pixels nécessitera environ 1GB de RAM).'' |
;Générer un fichier à télécharger | ;Générer un fichier à télécharger | ||
Si vous cochez cette option le fichier (DOT ou image) n'apparaîtra pas dans la fenêtre du navigateur, il vous faudra télécharger ce fichier et le sauvegarder sur votre ordinateur. | Si vous cochez cette option le fichier (DOT ou image) n'apparaîtra pas dans la fenêtre du navigateur, il vous faudra télécharger ce fichier et le sauvegarder sur votre ordinateur. | ||
;Ajouter des sauts de page | ;Ajouter des sauts de page | ||
Cette option n'a de sens que si vous décidez de convertir votre fichier DOT en PostScript ou PDF. Il y a quelques inconvénients, comme par exemple le fait que çà coupe les boites en leur milieu si elles se trouvent sur les côtés de la page. | Cette option n'a de sens que si vous décidez de convertir votre fichier DOT en PostScript ou PDF. Il y a quelques inconvénients, comme par exemple le fait que çà coupe les boites en leur milieu si elles se trouvent sur les côtés de la page. | ||
− | ; | + | ;Sens du graphe |
− | * | + | *Du haut vers le bas: les ancêtres sont en haut, les descendants en bas |
− | * | + | *De la gauche vers la droite: les ancêtres sont à gauche, les descendants à droite |
− | ;" | + | ;Paramètres "MCLIMIT" |
− | + | Cette option vous aide à réduire le nombre de croisements sur votre graphique. En choisissant le nombre le plus élevé cela ralentira le temps de génération du graphique. Voici quelques données basées sur mon expérience: | |
mclimit : runtime | mclimit : runtime | ||
1 : 1 sec | 1 : 1 sec | ||
Ligne 80 : | Ligne 97 : | ||
100 : 25 sec | 100 : 25 sec | ||
− | === | + | ===Préférences du diagramme=== |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | En cliquant sur "préférences", un sous menu avec les options suivantes apparaît: | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | [[Image: Graphviz_préférences.png|thumbs|350 px|Cliquer sur l'image pour l'agrandir]] | |
− | ; | + | ;Individus à inclure dans le diagramme |
+ | '''Tous'''<br> | ||
− | + | Tous les individus qui existent dans le fichier GEDCOM actif seront pris en compte dans le diagramme. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | '''Toutes les personnes reliées avec cette personne'''<br> | |
− | * | + | Le diagramme ne fera apparaître que les individus et les familles qui sont liées à la personne choisie. Vous pouvez déterminer le type de relations: |
+ | *Inclure les ascendants - Les ancêtres de l'individu sélectionné, la profondeur en terme d'ascendance peut être indiquée. | ||
==Contact== | ==Contact== | ||
Ligne 279 : | Ligne 116 : | ||
[[Category:Modules]] | [[Category:Modules]] | ||
+ | |||
+ | [[en: GVExport module]] |
Version actuelle datée du 16 février 2009 à 22:58
ATTENTION ! ce module est proposé par un tiers et n'est pas entretenu par l'équipe de développement de PhpgedView ! l'équipe de PhpGedView vous précise donc que tout bug qui serait causé par l'implémentation de ce module ne pourra pas être résolu par l'équipe. Cependant, le développeur de ce type de modules est membre du forum de PhpGedView, et pouvez donc le contacter directement sur le forum en cas de problème.
Le développeur de ce module est: Korbendallas1976 (Ferenc Kurucz)
Le module GVExport peut exporter votre arbre familial vers un fichier DOT, qui est le format de données natif de l'application GraphViz. En utilisant GraphViz vous pouvez convertir ce fichier dans des formats d'images très divers (GIF, JPG, PNG) ou dans un format PostScript, PDF etc...
Un des intérêts de ce module est de pouvoir, avec Graphviz, imprimer votre arbre généalogique sur plusieurs pages au format A4. Le logiciel fait en sorte que ces différentes pages puissant être posées les unes à côté des autres afin de reconstituer l'arbre complet sans "coupure".
Sommaire
Comment obtenir le module GVExport
Vous pouvez télécharger la dernière version de GVExport sur le site personnel de Ferenc Kurucz.
Dernière version: 0.8.0, 2009-02-15
GVExport_0.8.0
La version 0.8.0 I a été testée uniquement avec la version PGV 4.2/4.2SVN, il est donc possible qu'elle ne fonctionne pas avec des versions antérieures de PhpGedView......
Vous pouvez télécharger la dernière version qui a été testée sur PGV 4.1 ici:
GVExport_0.7.2
Pré requis
PGV
Bien évidemment, vous devez avoir installé PhpGedView. (Je l'ai testée avec la 4.1.3, 4.1.4, 4.1.5, 4.1.6 SVN, 4.2, 4.2SVN)
GraphViz
Il vous faut installer Graphviz pour pouvoir exploiter les fonctions de création d'image à partir du fichier créé par le module GVExport.
- Linux
Graphviz existe pour la plupart des distributions Linux: Debian, Ubuntu, Fedora. Vous trouverez les liens de téléchargement ici: http://www.graphviz.org/Download..php
- Windows
Graphviz existe aussi sous Windows. Vous pouvez le télécharger ici: http://www.graphviz.org/Download_windows.php
Vous obtiendrez des informations intéressantes sur Graphviz ici:
http://doc.ubuntu-fr.org/graphviz http://cyberzoide.developpez.com/graphviz/ http://fr.wikipedia.org/wiki/Graphviz
Installation
Il vous suffit de dézipper le fichier téléchargé. ce fichier contient:
le fichier gvexport.php un dossier appelé gvexport
Vous installez ce fichier et ce dossier à la racine du répertoire PhpGedView/modules/ de votre installation PhpGedView.
Configuration
Dans modules/gvexport il y a un fichier config.php.
Si vous avez installé PhpgedView sur un serveur distant, il faut modifier ce fichier avec un éditeur de texte en "commentant" la ligne qui commence par $GVE_CONFIG["graphviz_bin"]. C'est à dire en mettant "//" au début de la ligne suivante:
//$GVE_CONFIG["graphviz_bin"] = "/usr/bin/dot"; // Default on Debian Linux
Cela évitera ainsi à PhpGedView de chercher à exécuter le programme graphviz sur votre serveur.
Si vous avez installé PhpGedView sur un serveur local et que vous souhaitez utiliser graphviz directement, il vous suffit alors d'indiquer l'emplacement de GraphViz sur la ligne ($GVE_CONFIG["graphviz_bin"]).
- Linux
Par défaut, le fichier config.php indique le chemin d'installation suivant pour graphviz: /usr/bin/dot
Utilisation
Si l'installation s'est correctement déroulée, vous devriez alors voir apparaître sur la barre de menu une nouvelle icône appelée "Export Graphviz". En passant votre souris sur cette icône, vous verrez apparaître le sous-menu "Arbre tout-en-un". Il vous suffit de cliquer sur ce lien.
Paramètres de sortie
La fenêtre d'export de l'arbre tout-en-un apparait comme suit:
- Type de fichier généré
Par défaut, il faut cocher la case DOT qui est le seul format disponible si vous n'avez pas installé PhpGedView et Graphviz sur votre ordinateur.
Si vous avez installé PhpGedView et Graphviz sur votre ordinateur, vous aurez la possibilité de choisir les formats JPEG, GIF, SVG, PS et PDF. PNG est le format recommandé pour obtenir une image de votre arbre. SVG est une option intéressante si vous souhaitez que l'on puisse "cliquer" sur les noms (afin d'ouvrir dans votre navugateur web la page d'informations individuelle de la personne dans PhpGedView).
Si votre application GraphViz supporte le format de sortie PDF, je vous recommande de l'utiliser à chaque fois, parce que les temps de calcul sont sont plus faibles et parce qu'il est moins gourmand en taille mémoire.
Attention: JPG a une limite de taille de pixel de 64K pixel (à la fois en largeur et en hauteur) qui ne peut pas être modifiée, PNG n'a pas une telle limitation mais l'utilisation de la mémoire peut être extrêmement importante durant le traitement. Basé sur mon expérience, l'usage recommandé est le suivant: Largeur * Hauteur * 2 kilobits, afin que la création d'une image d'une taille de 50000x10000 pixels nécessitera environ 1GB de RAM).
- Générer un fichier à télécharger
Si vous cochez cette option le fichier (DOT ou image) n'apparaîtra pas dans la fenêtre du navigateur, il vous faudra télécharger ce fichier et le sauvegarder sur votre ordinateur.
- Ajouter des sauts de page
Cette option n'a de sens que si vous décidez de convertir votre fichier DOT en PostScript ou PDF. Il y a quelques inconvénients, comme par exemple le fait que çà coupe les boites en leur milieu si elles se trouvent sur les côtés de la page.
- Sens du graphe
- Du haut vers le bas: les ancêtres sont en haut, les descendants en bas
- De la gauche vers la droite: les ancêtres sont à gauche, les descendants à droite
- Paramètres "MCLIMIT"
Cette option vous aide à réduire le nombre de croisements sur votre graphique. En choisissant le nombre le plus élevé cela ralentira le temps de génération du graphique. Voici quelques données basées sur mon expérience:
mclimit : runtime 1 : 1 sec 5 : 2 sec 20 : 5 sec 50 : 15 sec 100 : 25 sec
Préférences du diagramme
En cliquant sur "préférences", un sous menu avec les options suivantes apparaît:
- Individus à inclure dans le diagramme
Tous
Tous les individus qui existent dans le fichier GEDCOM actif seront pris en compte dans le diagramme.
Toutes les personnes reliées avec cette personne
Le diagramme ne fera apparaître que les individus et les familles qui sont liées à la personne choisie. Vous pouvez déterminer le type de relations:
- Inclure les ascendants - Les ancêtres de l'individu sélectionné, la profondeur en terme d'ascendance peut être indiquée.
Contact
Ferenc Kurucz (korbendallas1976@gmail.com)