Difference between revisions of "gwd"

From GeneWeb
Jump to: navigation, search
m (Addresse of a base)
(a.gwf > # Access by key, when set to "yes", generates HTML requests with "n=first+name;p=surname;oc=number" instead of (shorter) "i=integer")
Line 17: Line 17:
 
== Links to persons ==
 
== Links to persons ==
 
Within GeneWeb, persons can be identified through two main methods: names and id
 
Within GeneWeb, persons can be identified through two main methods: names and id
* {{c|1=p=first_name;n=last_name}} (exact match) (see [[query_person|querying a person]] for some more details);
+
* {{c|1=p=first_name;n=last_name}} (exact match) (see [[search|search a person]] for some more details);
* {{c|1=p=first_name;n=last_name;oc=occurence}} if there are several homonyms;
+
* {{c|1=p=first_name;n=last_name;oc=occurrence}} if there are several [[namesake|homonyms]];
 
* {{c|1=i=1234}} GeneWeb internal id.
 
* {{c|1=i=1234}} GeneWeb internal id.
  
 
=== access_by_key and opt=no_index ===
 
=== access_by_key and opt=no_index ===
 
GeneWeb id numbers are unique across a base, but may change over time after [[clean|cleanup]] for instance.
 
GeneWeb id numbers are unique across a base, but may change over time after [[clean|cleanup]] for instance.
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 pérrè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érrènes.
  
 
Obtaining permanent links is achieved through two methods:
 
Obtaining permanent links is achieved through two methods:
* use option {{c|1=access_by_key=yes}} <!-- No rather than yes??--> in the .gwf [[configuration||configuration file]] of your base, which will prevent the use of internal ids for URL construction;
+
* use option {{c|1=access_by_key=yes}} in the [[configuration|.gwf configuration file]] of your base, which will prevent the use of internal ids for URL construction;
* add {{c|1=;opt=no_index}} to the URL containing id numbers. GeneWeb will return a new URL where id numbers will be replaced by their first_name, last_name, occurence equivalent.
+
* add {{c|1=;opt=no_index}} to the URL containing id numbers. GeneWeb will return a new URL where id numbers will be replaced by their first_name, last_name, occurrence equivalent.
  
 
This last remark applies to all GeneWeb queries, particularly those about parental relationship where many individuals are referenced.
 
This last remark applies to all GeneWeb queries, particularly those about parental relationship where many individuals are referenced.

Revision as of 00:22, 22 October 2015

150px-Geographylogo svg.png Language: English

This section describes the syntax of links to pages of a GeneWeb base as they appear in the URL window of your browser. It may be useful both to GeneWeb users, and to persons who, without knowledge of GeneWeb, may want to insert in some of their web documents a link to a page produced by a GeneWeb server that they may have found on the Web.

Addresse of a base

The address of a GeneWeb base has the form

http://server:port/base?

where:

  • server is the IP address or DNS name of the server hostion the GeneWeb daemon:
  • port is the TCP port on which the daemon is listening, the default value being 2317 for base access with gwd and 2316 for management with gwsetup (these two parameters may be changed at launch time of these two programs);
  • base the name of the GeneWeb base.

The question mark is the delimiter between the base name and the gwd query parameters.

Links to persons

Within GeneWeb, persons can be identified through two main methods: names and id

  • p=first_name;n=last_name (exact match) (see search a person for some more details);
  • p=first_name;n=last_name;oc=occurrence if there are several homonyms;
  • i=1234 GeneWeb internal id.

access_by_key and opt=no_index

GeneWeb id numbers are unique across a base, but may change over time after cleanup for instance. 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érrènes.

Obtaining permanent links is achieved through two methods:

  • use option access_by_key=yes in the .gwf configuration file of your base, which will prevent the use of internal ids for URL construction;
  • add ;opt=no_index to the URL containing id numbers. GeneWeb will return a new URL where id numbers will be replaced by their first_name, last_name, occurrence equivalent.

This last remark applies to all GeneWeb queries, particularly those about parental relationship where many individuals are referenced.

Origine of a person, opt=from

The ;opt=from option is used to determine which source file a particular person's data comes from. See merging bases for details. This information appears in italic after the family os the person, and is visible only to wizards.

Cancel GeneWeb links, cgl=on/off

Use the ;cgl=off (cancel geneweb links) option to cancel GeneWeb links in a given page. This may be useful for printing, or to do a copy/paste operation of a page into some other document where you don not want to transport the various GeneWeb links.

Names for one person, opt=misc

The ;opt=misc option will display at the end of the page all the first_name last_name alias combinations considered valit-d to invoque a particular person.

Hidden titles, all_titles

all_titles=on;