Links into GeneWeb

From GeneWeb
Revision as of 16:09, 21 October 2015 by Henri83 (Talk | contribs) (Links (en) pass 1)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
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 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
  • base the 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=occurence 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, 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

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;