Difference between revisions of "gwd/fr"

From GeneWeb
Jump to: navigation, search
(gwd launch (fr))
m (Lancement du serveur gwd)
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
{{DISPLAYTITLE:Créer des requêtes pour le serveur GeneWeb}}
 
{{DISPLAYTITLE:Créer des requêtes pour le serveur GeneWeb}}
 
{{languages|gwd}}
 
{{languages|gwd}}
Le programme '''gwd''' est le '''serveur GeneWeb''' qui accepte les requêtes et renvoie des résultats. Son interface est entièrement orientée web: il fonctionne comme un serveur HTTP.
+
{{toc right}}
 +
 
 +
Le programme '''gwd''' est le '''serveur GeneWeb''' qui accepte les requêtes utilisateur et renvoie des résultats. Son interface est entièrement orientée web : il fonctionne comme un serveur HTTP.
  
 
Tous les paramètres de requête sont directement disponibles dans la fenêtre d’URL de votre navigateur web pour construire des liens vers des pages GeneWeb.
 
Tous les paramètres de requête sont directement disponibles dans la fenêtre d’URL de votre navigateur web pour construire des liens vers des pages GeneWeb.
  
Elle s'adresse aussi bien aux utilisateurs de GeneWeb qu'à ceux qui, sans connaître GeneWeb, désirent mettre des liens directs vers des pages GeneWeb trouvées sur la toile.
+
Elle s’adresse aussi bien aux utilisateurs de GeneWeb qu’à ceux qui, sans connaître GeneWeb, désirent mettre des liens directs vers des pages GeneWeb trouvées sur la toile.
  
 
== Page d’accueil d’une base de données GeneWeb ==
 
== Page d’accueil d’une base de données GeneWeb ==
 
La page d’accueil d’une base de données GeneWeb est la plupart du temps de la forme {{c|<nowiki>http://serveur:port/base</nowiki>}} où :
 
La page d’accueil d’une base de données GeneWeb est la plupart du temps de la forme {{c|<nowiki>http://serveur:port/base</nowiki>}} où :
 
* {{c|serveur}} est l’adresse IP ou le DNS de la machine hébergeant le serveur GeneWeb ;
 
* {{c|serveur}} est l’adresse IP ou le DNS de la machine hébergeant le serveur GeneWeb ;
* {{c|port}} le port TCP du serveur, par défaut 2317 pour l’accès aux bases et 2316 pour [[gwsetup/fr|gwsetup]] (ces deux paramètres sont configurables au [[man#Démarrer un serveur GeneWeb (gwd)|lancement de gwd]] et gwsetup), et enfin  
+
* {{c|port}} le port TCP du serveur, par défaut 2317 pour l’accès aux bases et 2316 pour [[gwsetup/fr|gwsetup]] (ces deux paramètres sont configurables au [[#Lancement du serveur gwd|lancement de gwd]] et gwsetup), et enfin  
 
* {{c|base}} le nom de la base de données GeneWeb.
 
* {{c|base}} le nom de la base de données GeneWeb.
  
Line 17: Line 19:
 
== Lancement du serveur gwd ==
 
== Lancement du serveur gwd ==
  
Le serveur '''gwd''' de GeneWeb se comporte comme un serveur web qui reçoit des requêtes sur le port TCP 2317 par défault, de al même manière qu'uns erveur web tel que Apache les reçoit sur le port 80 ou 8080.  
+
Le serveur '''gwd''' de GeneWeb se comporte comme un serveur web qui reçoit des requêtes sur le port TCP 2317 par défaut, de la même manière qu’un serveur web tel que Apache les reçoit sur le port 80 ou 8080.  
Gwd reçoit des URL qui suivent une syntaxe précise (see below) décrivant les commandes qui doivent être exécutées.  Les résultats sont renvoyés sous la forme de texte, et si l'URL a été envoyée par un navigateur web ou n'importe quel programme respectant le protocole HTTP, celui-ci interprétera  comme tu code HTML.
+
Gwd reçoit des URL qui suivent une syntaxe précise décrivant les commandes qui doivent être exécutées.  Les résultats sont renvoyés sous la forme de texte, et si l’URL a été envoyée par un navigateur web ou n’importe quel programme respectant le protocole HTTP, celui-ci interprétera  comme du code HTML.
 +
 
 +
A noter que les paramètres {{c|-allowed_tags}}, {{c|-auth}} et {{c|-log}}, pointent vers des fichiers qui peuvent être déplacés et renommés; Le nom des fichiers peut être absolu ou relatif en fonction de votre configuration et de la manière dont gwd a été lancé. Le ou les fichiers associés à {{c|-add_lexicon}}, pour les lexiques supplémentaires, doivent être placés dans un des dossiers {{c|lang}}!
  
 
  Usage: gwd [options] where options are:
 
  Usage: gwd [options] where options are:
   -hd <dir>
+
   -a <ADDRESS>           Select a specific address (default = any address of this computer).
      Directory where the directory lang is installed.
+
  -add_lexicon <FILE>    Add file as lexicon.
   -bd <dir>
+
  -allowed_tags <FILE>  HTML tags which are allowed to be displayed. One tag per line in file.
      Directory where the databases are installed.
+
  -auth <FILE>          Authorization file to restrict access.
   -wd <dir>
+
                        The file must hold lines of the form "user:password".
      Directory for socket communication (Windows) and access count.
+
   -bd <DIR>             Directory where the databases are installed.
   -cgi
+
   -blang                Select the user browser language if any.
      Force [[CGI|CGI mode]].
+
  -cache_langs          Lexicon languages to be cached.
   -images_url <url>
+
   -cgi                   Force CGI mode.
      URL for GeneWeb images (default: gwd send them)
+
   -conn_tmout <SEC>     Connection timeout (default 120s; 0 means no limit).
   -images_dir <dir>
+
   -daemon                Unix daemon mode.
      Same than previous but directory name relative to current
+
  -debug                Enable debug mode
   -a <address>
+
  -digest                Use Digest authorization scheme (more secure on passwords)
      Select a specific address (default = any address of this computer)
+
  -friend <PASSWD>       Set a friend password.
   -p <number>
+
  -hd <DIR>              Directory where the directory lang is installed.
      Select a port number (default = 2317); > 1024 for normal users.
+
  -images_dir <DIR>      Same than previous but directory name relative to current.
   -setup_link
+
   -images_url <URL>     URL for GeneWeb images (default: gwd send them).
      Display a link to local [[Gwsetup|gwsetup]] in bottom of pages.
+
   -lang <LANG>           Set a default language (default: fr).
  -allowed_tags <file>
+
   -log <FILE>            Log trace to this file. Use "-" or "<stdout>" to redirect output to stdout
      [[Tags|HTML tags]] which are allowed to be displayed. One tag per line in file.
+
                        or "<stderr>" to output log to stderr.
  -wizard <passwd>
+
   -log_level <N>        Send messages with severity <= <N> to syslog (default: 7).
      Set a wizard [[password]]: access to all dates and updating.
+
   -login_tmout <SEC>    Login timeout for entries with passwords in CGI mode (default 1800s).
   -friend <passwd>
+
   -max_clients <NUM>     Max number of clients treated at the same time (default: no limit) (not cgi).
      Set a friend [[password]]: access to all dates.
+
  -min_disp_req          Minimum number of requests in robot trace (default: 6).
   -wjf
+
   -no_host_address      Force no reverse host by address.
      Wizard just friend (permanently)
+
  -nolock                Do not lock files before writing.
   -lang <lang>
+
   -only <ADDRESS>        Only inet address accepted.
      Set a default [[Lexicon#Language codes|language]] (default: fr).
+
   -p <NUMBER>           Select a port number (default = 2317).
   -blang
+
  -plugin <PLUGIN>.cmxs  load a safe plugin.
      Select the user browser language if any.
+
                        Combine with -force to enable for every base.
   -only <address>
+
                        Combine with -unsafe to allow unverified plugins. e.g. "-plugin -unsafe -force".
       Only inet address accepted.
+
   -plugins <DIR>        load all plugins in <DIR>.
   -auth <file>
+
                        Combine with -force to enable for every base.
      Authorization file to restrict [[access]]. The file must hold lines
+
                        Combine with -unsafe to allow unverified plugins. e.g. "-plugins -unsafe -force".
      of the form "user:password".
+
   -redirect <ADDR>       Send a message to say that this service has been redirected to <ADDR>.
   -no_host_address
+
   -robot_xcl <CNT>,<SEC> Exclude connections when more than <CNT> requests in <SEC> seconds.
      Force no reverse host by address
+
   -setup_link            Display a link to local gwsetup in bottom of pages.
  -digest
+
   -trace_failed_passwd   Print the failed passwords in log (except if option -digest is set).  
      Use Digest authorization scheme (more secure on passwords)
+
   -wd <DIR>             Directory for socket communication (Windows) and access count.
  -add_lexicon <lexicon>
+
   -wizard <PASSWD>       Set a wizard password.
      Add file as [[lexicon]].
+
  -wjf                  Wizard just friend (permanently).
   -log <file>
+
   -help                  Display this list of options
      Redirect log trace to this file.
+
   --help                Display this list of options
   -robot_xcl <cnt>,<sec>
+
 
      Exclude connections when more than <cnt> requests in <sec> seconds.
+
Note : quand GeneWeb est lancé avec {{c|-debug}}, il ajoute dans le document html renvoyé des commentaires de début/fin donnant le cheminom complet des fichiers inclus comme dans :
   -min_disp_req
+
&#60;!-- begin include /Users/Henri/Genea/GeneWeb/GeneWeb-7.0h-Mac/gw/plugins/welcome/assets/etc/welcome.txt --&#62;
      Minimum number of requests in robot trace (default: 6)
+
  -login_tmout <sec>
+
      Login timeout for entries with passwords in CGI mode (default 1800s)
+
  -redirect <addr>
+
      Send a message to say that this service has been redirected to <addr>
+
   -trace_failed_passwd
+
      Print the failed passwords in log (except if option -digest is set)
+
  -nolock
+
      Do not lock files before writing.
+
   -max_clients <num>
+
      Max number of clients treated at the same time (default: no limit)
+
      (not cgi).
+
   -conn_tmout <sec>
+
      Connection timeout (default 120s; 0 means no limit)
+
   -daemon
+
      Unix daemon mode.
+
   -chwd <comm>
+
      Call command when wdoc changed
+
  
 
== Requêtes au serveur gwd ==
 
== Requêtes au serveur gwd ==
Line 91: Line 77:
 
Il est parfois nécessaire d’éditer l’URL manuellement pour obtenir l’effet souhaité parce que certains paramètres ne sont pas disponibles à la sélection ou au clic sur toutes les pages de l’interface.
 
Il est parfois nécessaire d’éditer l’URL manuellement pour obtenir l’effet souhaité parce que certains paramètres ne sont pas disponibles à la sélection ou au clic sur toutes les pages de l’interface.
  
La requite en elle-même est la somme de tous les paramètres de requite ajouté à la fin de l'URL après le point d’interrogation. Le server gwd analyse les différents paramètres et renvoie une page spécifique. En fonction de la situation, le caractère délimitant les paramètres dans les URLs peut être {{c|;}} ou {{c|&}}. Les deux peuvent être utilisés en même temps.
+
La requête en elle-même est la somme de tous les paramètres de requête ajoutés à la fin de l’URL après le point d’interrogation. Le serveur gwd analyse les différents paramètres et renvoie une page spécifique. En fonction de la situation, le caractère délimitant les paramètres dans les URLs peut-être {{c|;}} ou {{c|&}}. Les deux peuvent être utilisés en même temps.
  
 
Les résultats sont renvoyés sous forme de texte. Si vous envoyez l’URL depuis un navigateur (elle peut également être envoyée de n’importe quel programme compatible HTTP), alors le texte sera traité comme du code HTML.
 
Les résultats sont renvoyés sous forme de texte. Si vous envoyez l’URL depuis un navigateur (elle peut également être envoyée de n’importe quel programme compatible HTTP), alors le texte sera traité comme du code HTML.
  
 
== Liens vers les individus, access_by_key et opt=no_index ==
 
== Liens vers les individus, access_by_key et opt=no_index ==
Il y a deux façon d’identifier un individu, soit avec le prénom et nom, soit avec son numéro id dans la base :
+
Il y a deux façons d’identifier un individu, soit avec le prénom et nom, soit avec son numéro id dans la base :
 
* {{c|1=p=prénom;n=nom}} trouve une personne avec prénom et nom ([[search/fr|correspondance exacte]]) ;
 
* {{c|1=p=prénom;n=nom}} trouve une personne avec prénom et nom ([[search/fr|correspondance exacte]]) ;
 
* {{c|1=p=prénom;n=nom;oc=1}} en spécifiant le numéro d’occurrence pour les cas d’[[namesake/fr|homonymies]] ;
 
* {{c|1=p=prénom;n=nom;oc=1}} en spécifiant le numéro d’occurrence pour les cas d’[[namesake/fr|homonymies]] ;
 
* {{c|1=i=1234}} trouve l’individu avec le numéro id 1234 dans la base.
 
* {{c|1=i=1234}} trouve l’individu avec le numéro id 1234 dans la base.
  
Les numéros d’id des individus sont modifiés par la commande {{c|gwc}} si vous faites un [[clean/fr|nettoyage]] de la base. <!-- et par la commandes ged2gwb dans le cas d’un import depuis un nouveau fichier GEDCOM  ?? --> Ils ne sont donc pas perrènes.
+
Les numéros d’id des individus sont modifiés par la commande {{c|gwc}} si vous faites un [[clean/fr|nettoyage]] de la base. <!-- et par la commande ged2gwb dans le cas d’un import depuis un nouveau fichier GEDCOM  ?? --> Ils ne sont donc pas pérennes.
  
 
Pour obtenir des liens permanents, il y a deux solutions :
 
Pour obtenir des liens permanents, il y a deux solutions :
 
* utiliser l’option {{c|1=access_by_key=yes}} dans le [[configuration/fr|fichier de configuration de votre base (.gwf)]] de manière à remplacer les adresses courtes avec les numéros id par des adresses de type p=prénom;n=nom;(oc=#;). S’il est égal à 0, oc= n’est pas précisé.
 
* utiliser l’option {{c|1=access_by_key=yes}} dans le [[configuration/fr|fichier de configuration de votre base (.gwf)]] de manière à remplacer les adresses courtes avec les numéros id par des adresses de type p=prénom;n=nom;(oc=#;). S’il est égal à 0, oc= n’est pas précisé.
* en ajoutant le paramètre {{c|1=opt=no_index}} à une adresse, GeneWeb renvoie l’adresse à utiliser avec des clés uniques mais volumineuses des individus de type {{c|1=p=firstname;n=lastname;oc=occurence}} à la place des numéros id.
+
* en ajoutant le paramètre {{c|1=opt=no_index}} à une adresse, GeneWeb renvoie l’adresse à utiliser avec des clés uniques mais volumineuses des individus de type {{c|1=p=firstname;n=lastname;oc=occurrence}} à la place des numéros id.
  
 
[[File:Winnie-no-index.png|thumb|800px|center|Lien à utiliser sans numéros {{c|1=i=}}, obtenu en ajoutant {{c|1=opt=no_index}} dans l’URL.]]
 
[[File:Winnie-no-index.png|thumb|800px|center|Lien à utiliser sans numéros {{c|1=i=}}, obtenu en ajoutant {{c|1=opt=no_index}} dans l’URL.]]
  
Ces remarques s'appliquent à toutes les requêtes de GeneWeb, particulièrement à celles affichant les liens de parenté où il est fréquent de trouver plusieurs personnes codées par leur numéro.
+
Ces remarques s’appliquent à toutes les requêtes de GeneWeb, particulièrement à celles affichant les liens de parenté où il est fréquent de trouver plusieurs personnes codées par leur numéro.
  
 
== Graphe acyclique orienté, implexes, dag=on ==
 
== Graphe acyclique orienté, implexes, dag=on ==
 
[[File:Winnie-dag-on.png|thumb|600px|right|Arbre ascendants avec {{c|1=dag=on}}: les ancêtres en commun sont fusionnés.]]
 
[[File:Winnie-dag-on.png|thumb|600px|right|Arbre ascendants avec {{c|1=dag=on}}: les ancêtres en commun sont fusionnés.]]
 
{{c|1=dag=on}} ([https://fr.wikipedia.org/wiki/Graphe_orienté_acyclique ''directed acyclic graph'']) sur les arbres ascendants et descendants permet de fusionner les  
 
{{c|1=dag=on}} ([https://fr.wikipedia.org/wiki/Graphe_orienté_acyclique ''directed acyclic graph'']) sur les arbres ascendants et descendants permet de fusionner les  
[https://fr.wikipedia.org/wiki/Implexe ''implexes''] du graphe c’est-à-dire qu’il n'y aura plus de chemins redondants.
+
[https://fr.wikipedia.org/wiki/Implexe ''implexes''] du graphe c’est-à-dire qu’il n’y aura plus de chemins redondants.
  
 
== Origine d’un individu, opt=from ==
 
== Origine d’un individu, opt=from ==
L’option {{c|1=opt=from}} permet de retrouver de quel fichier source l’individu provient. Voir à ce sujet l’article sur la [[merge/fr|fusion des bases]]. L'information apparait après la famille de cet individu, et n'est visible que pour les magiciens.
+
L’option {{c|1=opt=from}} permet de retrouver de quel fichier source l’individu provient. Voir à ce sujet l’article sur la [[merge/fr|fusion des bases]]. L’information apparait après la famille de cet individu, et n’est visible que pour les magiciens.
  
 
== Annuler les liens GeneWeb, cgl=on ==
 
== Annuler les liens GeneWeb, cgl=on ==
L’options {{c|1=cgl=on}} ('''''c'''ancel '''g'''eneweb '''l'''inks'') annule les liens GeneWeb existant sur la page ce qui peut être utile pour une impression ou pour masquer des liens vers des données privées.
+
L’option {{c|1=cgl=on}} ('''''c'''ancel '''g'''eneweb '''l'''inks'') annule les liens GeneWeb existant sur la page ce qui peut être utile pour une impression ou pour masquer des liens vers des données privées.
  
 
== Noms d’un individus, opt=misc ==
 
== Noms d’un individus, opt=misc ==
L’option {{c|1=opt=misc}} permet d'obtenir les différentes appellations par lesquelles un individu sera accessible par la recherche. L'information apparait à la fin de sa page personnelle.
+
L’option {{c|1=opt=misc}} permet d’obtenir les différentes appellations par lesquelles un individu sera accessible par la recherche. L’information apparait à la fin de sa page personnelle.
  
 
== Titres cachés all_titles ==
 
== Titres cachés all_titles ==
 
{{c|1=all_titles=on}}
 
{{c|1=all_titles=on}}
  
== Rafraichissement des pages modifiée, escache ==
+
== Rafraichissement des pages modifiées, escache ==
 
{{c|1=escache=0}}
 
{{c|1=escache=0}}
  

Latest revision as of 19:25, 1 January 2022

150px-Geographylogo svg.png Language: English • français

Le programme gwd est le serveur GeneWeb qui accepte les requêtes utilisateur et renvoie des résultats. Son interface est entièrement orientée web : il fonctionne comme un serveur HTTP.

Tous les paramètres de requête sont directement disponibles dans la fenêtre d’URL de votre navigateur web pour construire des liens vers des pages GeneWeb.

Elle s’adresse aussi bien aux utilisateurs de GeneWeb qu’à ceux qui, sans connaître GeneWeb, désirent mettre des liens directs vers des pages GeneWeb trouvées sur la toile.

Page d’accueil d’une base de données GeneWeb

La page d’accueil d’une base de données GeneWeb est la plupart du temps de la forme http://serveur:port/base où :

  • serveur est l’adresse IP ou le DNS de la machine hébergeant le serveur GeneWeb ;
  • port le port TCP du serveur, par défaut 2317 pour l’accès aux bases et 2316 pour gwsetup (ces deux paramètres sont configurables au lancement de gwd et gwsetup), et enfin
  • base le nom de la base de données GeneWeb.

Pour faciliter la navigation, gwd démarre en ouvrant la page d’accueil welcome.txt sur laquelle de multiples champs de textes et boutons cliquables fournissent un moyen pratique de construire des requêtes complexes.

Lancement du serveur gwd

Le serveur gwd de GeneWeb se comporte comme un serveur web qui reçoit des requêtes sur le port TCP 2317 par défaut, de la même manière qu’un serveur web tel que Apache les reçoit sur le port 80 ou 8080. Gwd reçoit des URL qui suivent une syntaxe précise décrivant les commandes qui doivent être exécutées. Les résultats sont renvoyés sous la forme de texte, et si l’URL a été envoyée par un navigateur web ou n’importe quel programme respectant le protocole HTTP, celui-ci interprétera comme du code HTML.

A noter que les paramètres -allowed_tags, -auth et -log, pointent vers des fichiers qui peuvent être déplacés et renommés; Le nom des fichiers peut être absolu ou relatif en fonction de votre configuration et de la manière dont gwd a été lancé. Le ou les fichiers associés à -add_lexicon, pour les lexiques supplémentaires, doivent être placés dans un des dossiers lang!

Usage: gwd [options] where options are:
 -a <ADDRESS>           Select a specific address (default = any address of this computer).
 -add_lexicon <FILE>    Add file as lexicon.
 -allowed_tags <FILE>   HTML tags which are allowed to be displayed. One tag per line in file.
 -auth <FILE>           Authorization file to restrict access. 
                        The file must hold lines of the form "user:password".
 -bd <DIR>              Directory where the databases are installed.
 -blang                 Select the user browser language if any.
 -cache_langs           Lexicon languages to be cached.
 -cgi                   Force CGI mode.
 -conn_tmout <SEC>      Connection timeout (default 120s; 0 means no limit).
 -daemon                Unix daemon mode.
 -debug                 Enable debug mode
 -digest                Use Digest authorization scheme (more secure on passwords)
 -friend <PASSWD>       Set a friend password.
 -hd <DIR>              Directory where the directory lang is installed.
 -images_dir <DIR>      Same than previous but directory name relative to current.
 -images_url <URL>      URL for GeneWeb images (default: gwd send them).
 -lang <LANG>           Set a default language (default: fr).
 -log <FILE>            Log trace to this file. Use "-" or "<stdout>" to redirect output to stdout 
                        or "<stderr>" to output log to stderr.
 -log_level <N>         Send messages with severity <= <N> to syslog (default: 7).
 -login_tmout <SEC>     Login timeout for entries with passwords in CGI mode (default 1800s).
 -max_clients <NUM>     Max number of clients treated at the same time (default: no limit) (not cgi).
 -min_disp_req          Minimum number of requests in robot trace (default: 6).
 -no_host_address       Force no reverse host by address.
 -nolock                Do not lock files before writing.
 -only <ADDRESS>        Only inet address accepted.
 -p <NUMBER>            Select a port number (default = 2317).
 -plugin <PLUGIN>.cmxs  load a safe plugin.
                        Combine with -force to enable for every base.
                        Combine with -unsafe to allow unverified plugins. e.g. "-plugin -unsafe -force".
 -plugins <DIR>         load all plugins in <DIR>.
                        Combine with -force to enable for every base.
                        Combine with -unsafe to allow unverified plugins. e.g. "-plugins -unsafe -force".
 -redirect <ADDR>       Send a message to say that this service has been redirected to <ADDR>.
 -robot_xcl <CNT>,<SEC> Exclude connections when more than <CNT> requests in <SEC> seconds.
 -setup_link            Display a link to local gwsetup in bottom of pages.
 -trace_failed_passwd   Print the failed passwords in log (except if option -digest is set). 
 -wd <DIR>              Directory for socket communication (Windows) and access count.
 -wizard <PASSWD>       Set a wizard password.
 -wjf                   Wizard just friend (permanently).
 -help                  Display this list of options
 --help                 Display this list of options

Note : quand GeneWeb est lancé avec -debug, il ajoute dans le document html renvoyé des commentaires de début/fin donnant le cheminom complet des fichiers inclus comme dans :

<!-- begin include /Users/Henri/Genea/GeneWeb/GeneWeb-7.0h-Mac/gw/plugins/welcome/assets/etc/welcome.txt -->

Requêtes au serveur gwd

Les requêtes au serveur gwd sont des URLs chargées de paramètres. Le point d’interrogation ? marque la séparation entre l’adresse de base et la requête au serveur : http://serveur:port/base?requête

Il est parfois nécessaire d’éditer l’URL manuellement pour obtenir l’effet souhaité parce que certains paramètres ne sont pas disponibles à la sélection ou au clic sur toutes les pages de l’interface.

La requête en elle-même est la somme de tous les paramètres de requête ajoutés à la fin de l’URL après le point d’interrogation. Le serveur gwd analyse les différents paramètres et renvoie une page spécifique. En fonction de la situation, le caractère délimitant les paramètres dans les URLs peut-être ; ou &. Les deux peuvent être utilisés en même temps.

Les résultats sont renvoyés sous forme de texte. Si vous envoyez l’URL depuis un navigateur (elle peut également être envoyée de n’importe quel programme compatible HTTP), alors le texte sera traité comme du code HTML.

Liens vers les individus, access_by_key et opt=no_index

Il y a deux façons d’identifier un individu, soit avec le prénom et nom, soit avec son numéro id dans la base :

  • p=prénom;n=nom trouve une personne avec prénom et nom (correspondance exacte) ;
  • p=prénom;n=nom;oc=1 en spécifiant le numéro d’occurrence pour les cas d’homonymies ;
  • i=1234 trouve l’individu avec le numéro id 1234 dans la base.

Les numéros d’id des individus sont modifiés par la commande gwc si vous faites un nettoyage de la base. Ils ne sont donc pas pérennes.

Pour obtenir des liens permanents, il y a deux solutions :

  • utiliser l’option access_by_key=yes dans le fichier de configuration de votre base (.gwf) de manière à remplacer les adresses courtes avec les numéros id par des adresses de type p=prénom;n=nom;(oc=#;). S’il est égal à 0, oc= n’est pas précisé.
  • en ajoutant le paramètre opt=no_index à une adresse, GeneWeb renvoie l’adresse à utiliser avec des clés uniques mais volumineuses des individus de type p=firstname;n=lastname;oc=occurrence à la place des numéros id.
Lien à utiliser sans numéros i=, obtenu en ajoutant opt=no_index dans l’URL.

Ces remarques s’appliquent à toutes les requêtes de GeneWeb, particulièrement à celles affichant les liens de parenté où il est fréquent de trouver plusieurs personnes codées par leur numéro.

Graphe acyclique orienté, implexes, dag=on

Arbre ascendants avec dag=on: les ancêtres en commun sont fusionnés.

dag=on (directed acyclic graph) sur les arbres ascendants et descendants permet de fusionner les implexes du graphe c’est-à-dire qu’il n’y aura plus de chemins redondants.

Origine d’un individu, opt=from

L’option opt=from permet de retrouver de quel fichier source l’individu provient. Voir à ce sujet l’article sur la fusion des bases. L’information apparait après la famille de cet individu, et n’est visible que pour les magiciens.

Annuler les liens GeneWeb, cgl=on

L’option cgl=on (cancel geneweb links) annule les liens GeneWeb existant sur la page ce qui peut être utile pour une impression ou pour masquer des liens vers des données privées.

Noms d’un individus, opt=misc

L’option opt=misc permet d’obtenir les différentes appellations par lesquelles un individu sera accessible par la recherche. L’information apparait à la fin de sa page personnelle.

Titres cachés all_titles

all_titles=on

Rafraichissement des pages modifiées, escache

escache=0


Manuel GeneWeb

Rembrandt Old Man Reading a Book.jpg

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

Annexe technique