Utilisation des templates

Le serveur gwd produit le code HTML affiché par votre navigateur à partir d'instructions conservées dans un fichier texte. Des examples de tels fichiers sont :

• welcome.txt la page d'accueil de votre base lorsque vous vous connectez à localhost:2317/basename
• perso.txt la page qui affiche les données spécifiques d'un individu
• updfam.txt la page contenant le formulaire de saisie des éléments d'une famille

Un ensemble de fichiers constituant une interface utilisateur cohérente s'appelle un "template".

Les templates sont invoqués en ajoutant (avec un bouton cliquable si disponible, ou manuellement si non) le texte templ=templ_name; dans l'URL qui apparait et haut de votre navigateur. GeneWeb se "souviendra" de cette demande de template et insèrera le code correspondant dans toutes les URL à suivre (la variable templ fait partie des variables d'environnement de gwd).

Les fichiers d'un template sont stockés dans un dossier appelé geneweb/gw/etc/template_name.

Quand gwd a besoin d'un fichier, il le recherche successivement et dans cet ordre dans les endroits suivants :

bdir/etc/base/
gw/etc/template_name/
gw/etc/

où -bdir est la valeur du paramètre -bd de gwd, et gw est le dossier dans lequel réside gwd.

Vous pouvez par conséquent vous limiter à l'édition d'un seul fichier, les autres seront trouvés dans les dossiers par défaut.

Perso.txt

Le fichier perso.txt offre un moyen de personnalisation supplémentaire. Le code ci-dessous est auto-explicatif.

%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;

Pour la pluspart des sous modules, plusieurs alternatives sont disponibles, et vous pouvez éditer perso.txt selon votre convenance.

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

Ceci peut aussi être fait avec un ensemble de paramètres dans le fichier base.gwf.

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

Avec und ernier paramètre précisant le nombre total de sous-modules :

perso_module_tplnb=8

Examples

Chaque sous-module produit les résultats ci-dessous :

Fichier	Example
etat_civil	File:etatcivil.jpg Personal data.
parent_simple	File:parent simple.jpg Parents (simple).
parent_evolue	File:parent evolue.jpg Parents (more complex).
parent_complet	File:parent complet.jpg Parents (full).
parent_photo	File:parent photo.jpg Parents (with photo).
union_simple	File:union simple.jpg Union (simple).
union_evolue	File:union evolue.jpg Union (more complex).
union_complet	File:union complet.jpg Union (full).
union_photo	File:parent complet.jpg Union (with photo).
freresoeur_simple	File:freresoeur simple.jpg Brothers and sisters (simple).
freresoeur_complet	File:freresoeur complet.jpg Brothers and sisters (full).
famille	File:famille.jpg Family.
relations	File:relations.jpg Relations.
notes	File:notes.jpg Notes.
sources	File:sources.jpg Sources.
timeline	File:timeline.jpg Timeline.
arbre_3gen_v	File:arbre nav3.jpg Tree, vertical, 3 generations.
arbre_nav3_photo	File:arbre nav3photos.jpg Tree, vertical, 3 generations with photos.
arbre_4gen_v	File:arbre nav4.jpg Tree, vertical, 4 generations.
arbre_5gen_h	File:arbre nav5h.jpg Tree, horizontal, 5 generations.