Module GVExport

De PGVWiki
Sauter à la navigation Sauter à la recherche

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".

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:

Erreur lors de la création de la miniature : Fichier manquant
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:

Erreur lors de la création de la miniature : Fichier manquant
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)