Links into GeneWeb
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
serveris the IP address or DNS name of the server hostion the GeneWeb daemon:
portis the TCP port on which the daemon is listening, the default value being 2317 for bases access with gwd and 2316 for management with gwsetup (these two parameters may be changed at launch time of these two programs); and lastly
basethe name of the GeneWeb base.
The semi-colon 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 querying a person for some more details);
p=first_name;n=last_name;oc=occurenceif there are several homonyms;
i=1234GeneWeb 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=yesin the .gwf |configuration file of your base, which will prevent the use of internal ids for URL construction;
;opt=no_indexto 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.
This last remark applies to all GeneWeb queries, particularly those about parental relationship where many individuals are referenced.
Origine of a person, opt=from
;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.
;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
;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