Difference between revisions of "image/fr"

From GeneWeb
Jump to: navigation, search
 
(17 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:Insérer des images dans les notes}}
+
{{DISPLAYTITLE:Portraits et images}}
 
{{languages|Images}}
 
{{languages|Images}}
  
Les notes individuelles, et les notes générales de la bas peuvent des liens vers des images contenir ou directement des images. Voici les diverses possibilités offertes pas la combinaison de HTML et GeneWeb :
+
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 ==
  
* lien textuel vers une image : {{c|1=<a href="%sm=IMH;s=image.jpg">lien textuel</a>}}
+
Les portraits sont conservés dans le dossier {{c|images/mabase/}} associé à la base (versions 6 et inférieures) ou dans le dossier {{c|documents/portraits/}} (version 7). Le nom du fichier est composé à partir des informations d'état-civil sous la forme {{c|prenom.occurence.nom_compose}} dans lesquels les majuscules et accents ont été supprimés et les espaces remplacés par des "soulignés" ({{c|_}}). 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.<!-- et suppression?? --> Les formats de fichiers acceptés sont actuellement {{c|.jpg}}, {{c|.gif}} et {{c|.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 ({{c|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 {{c|.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 {{c|src/mabase/images}} <!-- (version § et inférieures) ou {{c|documents/}} (version 7). Dans ce dernier cas (version 7) les sous dossiers sont autorisés-->.
 +
 
 +
Au delà des formats images autorisés ({{c|.pdf}}, {{c|.gif}} et {{c|.png}}), ce dossier peut contenir des documents au format {{c|.pdf}} ou {{c|.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 : {{c|1=<a href="%sm=IM;s=image.jpg">lien textuel</a>}}
 +
: Le fichier {{c|image.jpg}} est recherchée dans le répertoire {{c|bases/src/basename/images}}.
 
* image directe : <code><img src="%sm=IM;s=image.jpg" title="mouseover description" alt="alternative description"></code>
 
* image directe : <code><img src="%sm=IM;s=image.jpg" title="mouseover description" alt="alternative description"></code>
* image boutton : <code><a href="%sm=IMH;s=full-image.jpg"><img src="%sm=IM;s=thumb-image.jpg"></a></code>
+
* image bouton : <code><a href="%sm=IM;s=full-image.jpg"><img src="%sm=IM;s=thumb-image.jpg"></a></code>
* lien textuel vers une image map: <code><a href="%sm=SRC;v=file">lien textuel vers une image</a></code>
+
* lien textuel vers une image : <code><a href="%sm=SRC;v=file">lien textuel vers une image</a></code>
 +
* (version 7) on pourra remplacer <code>m=IM</code> par <code>m=DOC</code> et <code>m=SRC;v=file</code> par <code>m=DOC;s=file.txt</code>
 +
 
 +
Dans le cas du lien textuel vers une image, GeneWeb examine dans un premier lieu le fichier {{c|.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/fr|macros]] telles que {{c|%s}} par la valeur appropriée pour atteindre votre serveur. Le nom du fichier fourni doit inclure l’extension ({{c|.jpg}}, {{c|.png}} ou {{c|gif}}).
 +
 
 +
Une information de style peut être ajoutée selon le besoin.
  
GeneWeb remplacera les [[Macros/fr|macros]] telles que {{c|%s}} par la valeur appropriée pour atteindre votre serveur, et le paramètre de {{c|1=s=}} pointe vers le dossier {{c|bases/src/mabase/images/}} où se trouve l'image recherchée. Le nom du fichier fourni doit inclure l'extension ({{c|.jpg}}, {{c|.png}}).
+
<!-- expliquer la différence entre IM et IMH -->
 +
=== m=IM vs m=IMH ===
 +
La commande {{c|1=m=IMH}} offre un service équivalent à {{c|1=m=IM}}, mais encapsule le résultat dans une page HTML autonome.
  
 
Le tag HTML {{c|img}} doit être présent dans la liste des [[tags/fr|tags]] acceptés par GeneWeb mémorisés dans le fichier {{c|bases/tags.txt}}.
 
Le tag HTML {{c|img}} doit être présent dans la liste des [[tags/fr|tags]] acceptés par GeneWeb mémorisés dans le fichier {{c|bases/tags.txt}}.
  
== Examlpe d'Image contenant une "image map" ==
+
== Exemple d’image contenant une « image map » ==
  
Dans le cas des images avec "image maps", permettant de désigner dans l'image des zones cliquables, la commande GeneWeb n'est plus {{c|1=m=IMH}} mais {{c|1=m=SRC}}, et le paramètre  {{c|1=v=}} désigne un fichier {{c|.txt}} qui réside dans le dossier {{c|bases/src/mabase/}}. Attention, pour le paramètre  {{c|1=v=}}, il ne faut pas fournir l'extension {{c|.txt}}!!
+
Dans le cas des images avec « image map », permettant de désigner dans l’image des zones cliquables, la commande GeneWeb n’est plus {{c|1=m=IMH}} mais {{c|1=m=SRC}}, et le paramètre  {{c|1=v=}} désigne un fichier {{c|.txt}} qui réside dans le dossier {{c|bases/src/mabase/}}. Attention, pour le paramètre  {{c|1=v=}}, il ne faut pas fournir l’extension {{c|.txt}}!!
Dans le fichier {{c|.txt}} désigné, on trouvera du code HTML et quelques macros GeneWeb comme le monrte l'exemple qui suit :
+
Dans le fichier {{c|.txt}} désigné, on trouvera du code HTML et quelques macros GeneWeb comme le montre l’exemple qui suit :
  
 
Contenu du fichier {{c|bases/src/mybase/grande-ile.txt}}
 
Contenu du fichier {{c|bases/src/mybase/grande-ile.txt}}
Line 43: Line 71:
 
<hr>
 
<hr>
 
</p>
 
</p>
En déplaçant le curseur sur les lieux significatifs de l'île, vous verrez (peut être!) apparaitre son nom, et un click vous emmènera vers une description plus détaillée et des photos.
+
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">
 
<map name="test-chausey">
Line 55: Line 83:
 
</pre>  
 
</pre>  
  
Appel de ce fichier dans les notes d'un personnage :
+
Appel de ce fichier dans les notes d’une personne :
  <a href="%sm=SRC;v=grande-ile">une photo cliquable de l'ile</a>
+
  <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
+
Cet appel recherche le fichier {{c|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">
 
  <img SRC="%sm=IM;s=grande-ile.jpg" usemap="#test-chausey" border="0">
 
qui a été transformée en
 
qui a été transformée en
 
  <img SRC="localhost:2317/mabase?sm=IM;s=grande-ile.jpg" usemap="#test-chausey" border="0">
 
  <img SRC="localhost:2317/mabase?sm=IM;s=grande-ile.jpg" usemap="#test-chausey" border="0">
  
Cette image fait appel au tag HTML <nowiki><usemap #test-chausey></nowiki> 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
+
Cette image fait appel au tag HTML {{c|<nowiki><usemap #test-chausey></nowiki>}} 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">
 
  <area shape="rect" coords="345,307,433,347" href="%sm=SRC;v=plan-pointe-du-phare">
 
en
 
en
 
  <area shape="rect" coords="345,307,433,347" href="localhost:23127/mabase?m=SRC;v=plan-pointe-du-phare">
 
  <area shape="rect" coords="345,307,433,347" href="localhost:23127/mabase?m=SRC;v=plan-pointe-du-phare">
et un click sur la zone définie provoquera un nouvel appel à GeneWeb (une nouvelle image en l'occurence, mais les autres lignes du <ni-owiki><usemap></nowiki> appellent des personnages.
+
et un clic sur la zone définie provoquera un nouvel appel à GeneWeb (chaque ligne du {{c|<nowiki><usemap></nowiki>}} appelle une image ({{c|1=m=SRC}}) ou une page personnelle ({{c|1=m=NG}} ou {{c|1=p=prenom;n=nom}}) différente).
 +
 
 +
Notez que grâce au traitement effectué par GeneWeb et la macro {{c|%s}}, ces fichiers et la base correspondante peuvent s’exécuter sur n’importe quel serveur, local ou distant.
 +
 
 +
{{manuel}}
  
Notez que grâce au traitement effectué par GeneWeb, et la macro{{c|%s}}, ces fichiers, et la base correspondantes peuvent s'exécute sur n'importe quel serveur, local ou distant!!
+
[[Category:Manuel]]

Latest revision as of 16:47, 31 December 2020

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

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.


Autres images

Les autres images gérées directement par le serveur GeneWeb sont conservées dans le dossier src/mabase/images .

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