Portraits et images

From GeneWeb
Jump to: navigation, search
150px-Geographylogo svg.png Language: English • français

GeneWeb gère deux sortes d'images : les portraits, qui sont affichés sur la page personnelle, et les images qui peuvent être insérées dans les notes pour affichage direct, ou via un lien http. Ces images peuvent aussi être complétées par des liens http vers des images conservées sur des sites distants. Avec la version 7 de GeneWeb, un mécanisme supplémentaire propose l'affichage en mode "carrousel" d'une série d'images associées à la personne (copies d'actes d'état-civil, portraits à différentes époques, ...).

Portraits

Les portraits sont conservés dans le dossier images/mabase/ associé à la base (versions 6 et inférieures) ou dans le dossier documents/portraits/ (version 7). Le nom du fichier est composé à partir des informations d'état-civil sous la forme prenom.occurence.nom_compose dans lesquels les majuscules et accents ont été supprimés et les espaces remplacés par des "soulignés" (_). Ce nom est construit automatiquement par GeneWeb lors de l'envoi du portrait, et est tenu à jour lors de toute opérations de mise à jour ou de fusion. Les formats de fichiers acceptés sont actuellement .jpg, .gif et .png.

Carrousel

(Version 7 seulement)

Les images du carrousel sont conservées dans un dossier spécifique associé à la personne et portant le même nom que le portrait (documents/images/prenom.occurence.nom_compose). Dans ce dossier on trouvera à la fois des fichiers images, et pour chaque image, un fichier associé portant le même nom avec l'extension .txt et contenant un commentaire relatif à l'image. La première ligne du fichier est considérée comme un titre, et la seconde comme une indication de la source de l'image. Ces images sont affichées en mode carrousel via un bouton de la barre de menu en tête de page.

Autres images

Les autres images gérées directement par le serveur GeneWeb sont conservées dans le dossier src/mabase/images (version § et inférieures) ou documents/ (version 7). Dans ce dernier cas (version 7) les sous dossiers sont autorisés.

Au delà des formats images autorisés (.pdf, .gif et .png), ce dossier peut contenir des documents au format .pdf ou .html qui peuvent être affichés par appel de liens http. À l'inverse des images "classiques", elles ne peuvent pas être insérées directement dans une note avec une balise <img SRC="...">.


Insérer des images dans les notes

Les notes individuelles et générales peuvent contenir des liens ou des redirections vers des images. Voici les diverses possibilités offertes par la combinaison de HTML et GeneWeb :

  • lien textuel vers une image : <a href="%sm=IM;s=image.jpg">lien textuel</a>
Le fichier image.jpg est recherchée dans le répertoire bases/src/basename/images.
  • image directe : <img src="%sm=IM;s=image.jpg" title="mouseover description" alt="alternative description">
  • image bouton : <a href="%sm=IM;s=full-image.jpg"><img src="%sm=IM;s=thumb-image.jpg"></a>
  • lien textuel vers une image : <a href="%sm=SRC;v=file">lien textuel vers une image</a>
  • (version 7) on pourra remplacer m=IM par m=DOC et m=SRC;v=file par m=DOC;s=file.txt

Dans le cas du lien textuel vers une image, GeneWeb examine dans un premier lieu le fichier .txt désigné dans lequel on trouvera, en plus d'un texte éventuel, un ou plusieurs appels directs vers une ou plusieurs images. Ce mécanisme en deux étapes permet entre autres les images associées à une "image map" (voir l'exemple ci-dessous) et le remplacement des macros telles que %s par la valeur appropriée pour atteindre votre serveur. Le nom du fichier fourni doit inclure l’extension (.jpg, .png ou gif).

Une information de style peut être ajoutée selon le besoin.

m=IM vs m=IMH

La commande m=IMH offre un service équivalent à m=IM, mais encapsule le résultat dans une page HTML autonome.

Le tag HTML img doit être présent dans la liste des tags acceptés par GeneWeb mémorisés dans le fichier bases/tags.txt.

Exemple d’image contenant une « image map »

Dans le cas des images avec « image map », permettant de désigner dans l’image des zones cliquables, la commande GeneWeb n’est plus m=IMH mais m=SRC, et le paramètre v= désigne un fichier .txt qui réside dans le dossier bases/src/mabase/. Attention, pour le paramètre v=, il ne faut pas fournir l’extension .txt!! Dans le fichier .txt désigné, on trouvera du code HTML et quelques macros GeneWeb comme le montre l’exemple qui suit :

Contenu du fichier bases/src/mybase/grande-ile.txt

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<title>
Grande Ile
</title>
<html>
%rcss
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

<table border="1" width="100%" height="60">
<tr align="left">
<td width="100%" height="16" bgcolor="#008080"><p align="center">
<font face="Garamond" color="#FFFFFFF"><big><big><strong><big>
La Grande Ile</font></big></strong></big></big></font>
</td>
</tr>
</table>
<p><img SRC="%sm=IM;s=grande-ile.jpg" usemap="#test-chausey" border="0"> <br>
<font size="-1"><em>(Carte construite à partir de celle disponible sur le site réalisé par P. Marques)
</em></font>
<hr>
</p>
En déplaçant le curseur sur les lieux significatifs de l’île, vous verrez apparaître son nom et un clic emmène vers une description plus détaillée et des photos.

<map name="test-chausey">
	<area shape="poly" coords="206,272,212,255,241,254,240,291,217,290" href="%sm=NG;n=le+vieux+fort" alt="Le Vieux Fort">
	<area shape="poly" coords="132,75,170,78,168,110,132,111" href="%sm=NG;n=le+semaphore" alt="Le S̩maphore">
	<area shape="rect" coords="345,307,433,347" href="%sm=SRC;v=plan-pointe-du-phare">
	<area shape="rect" coords="359,194,485,213" href="%sp=la+maison;n=pilet">
</map>
</body>
</html>

Appel de ce fichier dans les notes d’une personne :

<a href="%sm=SRC;v=grande-ile">une photo cliquable de l’île</a>

Cet appel recherche le fichier bases/src/mybase/grande-ile.txt traite les macros GeneWeb et envoie l’ensemble à votre navigateur. Celui-ci détecte la demande

<img SRC="%sm=IM;s=grande-ile.jpg" usemap="#test-chausey" border="0">

qui a été transformée en

<img SRC="localhost:2317/mabase?sm=IM;s=grande-ile.jpg" usemap="#test-chausey" border="0">

Cette image fait appel au tag HTML <usemap #test-chausey> qui définit des zones de l’image auxquelles sont associées des URL (avec un outil comme Mapedit par exemple). Là encore, avant d’envoyer le résultat à votre navigateur, GeneWeb aura transformé les lignes

<area shape="rect" coords="345,307,433,347" href="%sm=SRC;v=plan-pointe-du-phare">

en

<area shape="rect" coords="345,307,433,347" href="localhost:23127/mabase?m=SRC;v=plan-pointe-du-phare">

et un clic sur la zone définie provoquera un nouvel appel à GeneWeb (chaque ligne du <usemap> appelle une image (m=SRC) ou une page personnelle (m=NG ou p=prenom;n=nom) différente).

Notez que grâce au traitement effectué par GeneWeb et la macro %s, ces fichiers et la base correspondante peuvent s’exécuter sur n’importe quel serveur, local ou distant.


Manuel GeneWeb

Rembrandt Old Man Reading a Book.jpg

Utiliser et gérer une base généalogique

Annexe technique