Difference between revisions of "templates"
m (t.) |
|||
Line 103: | Line 103: | ||
!File name!! Example | !File name!! Example | ||
|- | |- | ||
− | |etat_civil||| [[File: | + | |etat_civil||| [[File:Etatcivil.jpg|thumb|500px|center|Personal data.]] |
|- | |- | ||
− | |parent_simple|| [[File: | + | |parent_simple|| [[File:Parent_simple.jpg|thumb|500px|center|Parents (simple).]] |
|- | |- | ||
− | |parent_evolue|| [[File: | + | |parent_evolue|| [[File:Parent_evolue.jpg|thumb|500px|center|Parents (more complex).]] |
|- | |- | ||
− | |parent_complet|| [[File: | + | |parent_complet|| [[File:Parent_complet.jpg|thumb|500px|center|Parents (full).]] |
|- | |- | ||
− | |parent_photo|| [[File: | + | |parent_photo|| [[File:Parent_photo.jpg|thumb|500px|center|Parents (with photo).]] |
|- | |- | ||
− | |union_simple|| [[File: | + | |union_simple|| [[File:Union_simple.jpg|thumb|500px|center|Union (simple).]] |
|- | |- | ||
− | |union_evolue|| [[File: | + | |union_evolue|| [[File:Union_evolue.jpg|thumb|500px|center|Union (more complex).]] |
|- | |- | ||
− | |union_complet|| [[File: | + | |union_complet|| [[File:Union_complet.jpg|thumb|500px|center|Union (full).]] |
|- | |- | ||
− | |union_photo|| [[File: | + | |union_photo|| [[File:Union_photo.jpg|thumb|500px|center|Union (with photo).]] |
|- | |- | ||
− | |freresoeur_simple|| [[File: | + | |freresoeur_simple|| [[File:Freresoeur_simple.jpg|thumb|500px|center|Brothers and sisters (simple).]] |
|- | |- | ||
− | |freresoeur_complet|| [[File: | + | |freresoeur_complet|| [[File:Freresoeur_complet.jpg|thumb|500px|center|Brothers and sisters (full).]] |
|- | |- | ||
− | |famille|| [[File: | + | |famille|| [[File:Famille.jpg|thumb|500px|center|Family.]] |
|- | |- | ||
− | |relations|| [[File: | + | |relations|| [[File:Relations.jpg|thumb|500px|center|Relations.]] |
|- | |- | ||
− | |notes|| [[File: | + | |notes|| [[File:Notes.jpg|thumb|500px|center|Notes.]] |
|- | |- | ||
− | |sources|| [[File: | + | |sources|| [[File:Sources.jpg|thumb|500px|center|Sources.]] |
|- | |- | ||
− | |timeline|| [[File: | + | |timeline|| [[File:Timeline.jpg|thumb|500px|center|Timeline.]] |
|- | |- | ||
− | |arbre_3gen_v|| [[File: | + | |arbre_3gen_v|| [[File:Arbre_nav3.jpg|thumb|500px|center|Tree, vertical, 3 generations.]] |
|- | |- | ||
− | |arbre_nav3_photo|| [[File: | + | |arbre_nav3_photo|| [[File:Arbre_nav3photos.jpg|thumb|500px|center|Tree, vertical, 3 generations with photos.]] |
|- | |- | ||
− | |arbre_4gen_v|| [[File: | + | |arbre_4gen_v|| [[File:Arbre_nav4.jpg|thumb|500px|center|Tree, vertical, 4 generations.]] |
|- | |- | ||
− | |arbre_5gen_h|| [[File: | + | |arbre_5gen_h|| [[File:Arbre_nav5h.jpg|thumb|500px|center|Tree, horizontal, 5 generations.]] |
|} | |} | ||
Revision as of 14:26, 5 May 2016
Language: | English • français |
---|
The gwd server produces the HTML code displayed by the client browser according to instructions stored into text files. Examples of such files are:
- welcome.txt the welcome page shown when you connect to
localhost:2317/basename
. - perso.txt the page that displays one individual of the base.
- updfam.txt the page containing the form to update a family.
A template is a set of such files organized into a coherent user interface. Template files are stored in folders named geneweb/gw/etc/template_name
.
Templates are invoqued by adding (through a clickable button if available, or manually if not) templ=templ_name;
in the URL at the top of your browser. GeneWeb will "remember" this request for a template use and will automatically add the appropriate text in all subsequent URL requests.
When executing its tasks, gwd will search for the needed files in several folders in the following sequence:
bdir/etc/base/ gw/etc/template_name/ gw/etc/
where -bdir
is the value of the -bd
parameter of gwd, and gw
is the folder in which sits gwd.
As a result, you may limit your editing to the file whose content you want to change. All the other files will be found in the default folder.
See the experts section for further discussion on template programming.
Perso.txt
The file perso.txt offers an additional customization level by providing several options for the display of personal data. The code below is somewhat self explanatory:
%import;perso_utils %include.perso_header; %if;(bvar.perso_module_tplnb="" or bvar.perso_module_tplnb=0) %apply;show_templ("perso_module/etat_civil") %apply;show_templ("perso_module/parent_simple") %apply;show_templ("perso_module/union_simple") %apply;show_templ("perso_module/freresoeur_simple") %apply;show_templ("perso_module/relations") %apply;show_templ("perso_module/timeline") %apply;show_templ("perso_module/notes") %apply;show_templ("perso_module/sources") %apply;show_templ("perso_module/arbre_3gen_v_photo") %else; %for;i;0;bvar.perso_module_tplnb; %apply;get_templ(i) %end; %end;
For most of the modules, several alternatives are available and can be selected by editing the appropriate line. here is the current content of the perso_modules folder:
drwxr-xr-x 23 Henri staff 782 1 oct 22:26 . drwxr-xr-x 64 Henri staff 2176 15 oct 23:56 .. -rw-r--r-- 1 Henri staff 3979 1 oct 22:26 arbre_3gen_v.txt -rw-r--r-- 1 Henri staff 12691 1 oct 22:26 arbre_3gen_v_photo.txt -rw-r--r-- 1 Henri staff 10477 1 oct 22:26 arbre_4gen_v.txt -rw-r--r-- 1 Henri staff 19592 1 oct 22:26 arbre_5gen_h.txt -rw-r--r-- 1 Henri staff 2303 1 oct 22:26 etat_civil.txt -rw-r--r-- 1 Henri staff 7283 1 oct 22:26 famille.txt -rw-r--r-- 1 Henri staff 2964 1 oct 22:26 freresoeur_complet.txt -rw-r--r-- 1 Henri staff 2972 1 oct 22:26 freresoeur_simple.txt -rw-r--r-- 1 Henri staff 1636 1 oct 22:26 notes.txt -rw-r--r-- 1 Henri staff 785 1 oct 22:26 parent_complet.txt -rw-r--r-- 1 Henri staff 431 1 oct 22:26 parent_evolue.txt -rw-r--r-- 1 Henri staff 1653 1 oct 22:26 parent_photo.txt -rw-r--r-- 1 Henri staff 271 1 oct 22:26 parent_simple.txt -rw-r--r-- 1 Henri staff 1877 1 oct 22:26 relations.txt -rw-r--r-- 1 Henri staff 360 1 oct 22:26 sources.txt -rw-r--r-- 1 Henri staff 1099 1 oct 22:26 timeline.txt -rw-r--r-- 1 Henri staff 7374 1 oct 22:26 union_complet.txt -rw-r--r-- 1 Henri staff 3636 1 oct 22:26 union_evolue.txt -rw-r--r-- 1 Henri staff 2532 1 oct 22:26 union_photo.txt -rw-r--r-- 1 Henri staff 1861 1 oct 22:26 union_simple.txt
Changing the content of perso.txt can be achieved through a set of parameters stored in the .gwf
file where the value of the parameter is the name of the desired module:
perso_module_0=etat_civil perso_module_1=parent_simple perso_module_2=union_simple perso_module_3=freresoeur_simple perso_module_4=relations perso_module_5=notes perso_module_6=sources perso_module_7=arbre_3gen_v_photo
One must add a last parameter specifying the total number of sub-templates
perso_module_tplnb=8
Examples
The result corresponding to each choice is as follows:
File name | Example |
---|---|
etat_civil | |
parent_simple | |
parent_evolue | |
parent_complet | |
parent_photo | |
union_simple | |
union_evolue | |
union_complet | |
union_photo | |
freresoeur_simple | |
freresoeur_complet | |
famille | |
relations | |
notes | |
sources | |
timeline | |
arbre_3gen_v | |
arbre_nav3_photo | |
arbre_4gen_v | |
arbre_5gen_h |
GeneWeb Manual
- Download and install GeneWeb program under GNU/Linux, Mac OS X, Microsoft Windows, FreeBSD; on Mac OS X, Linux or Windows using Docker; or in CGI mode behind a web server.
- Understand GeneWeb server, homonym, consanguinity.
Use and manage genealogical databases
- Import Gedcom
.ged
or GeneWeb.gw
files with gwsetup or in command-line. - Update datas (add/remove individuals and families), merge duplicates, type dates.
- Use wikitext syntax, macros, keyboard shortcuts.
- Clean, recover, rename, save, archive a database.
- Merge and split multiples databases.
Technical annex
- Personalize CSS, header and trailer, templates, lexicon and declension.
- Configuration file
.gwf
(for templm), wizard notes, passwords for friends/wizards and access restrictions to databases. - Add images in notes, further remarks for experts.