Difference between revisions of "templates/fr"
(→Examples) |
(Explain new method for perso module selection) |
||
| Line 25: | Line 25: | ||
Vous pouvez par conséquent vous limiter à l'édition d'un seul fichier, les autres seront trouvés dans les dossiers par défaut. | Vous pouvez par conséquent vous limiter à l'édition d'un seul fichier, les autres seront trouvés dans les dossiers par défaut. | ||
| + | |||
| + | == Modules de personnalisation == | ||
| + | |||
| + | La version 7 de GeneWeb offre nouvelle manière pour personnaliser l'aspect de la page personnelle. | ||
| + | Cette solution repose sur l'existence d'une liste de modules définis dans le fichier de configuration {{c|base.gwf}} en associant chaque module à une lettre entre {{c|a}} et {{c|z}}. | ||
| + | |||
| + | perso_module_a=personnal_data | ||
| + | perso_module_b=parents | ||
| + | perso_module_c=siblings | ||
| + | |||
| + | Associée à ces modules, la variable {{c|1=p_mod=}} définira l'ordre dans lequel ces modules seront affichés, et pour chacun d'eux une valeur d'option comprise entre 0 et 9, et qui pourra mofifier le comportement du module. | ||
| + | Par exemple le vecteur | ||
| + | p_mod=c1a2b3 | ||
| + | affichera d'abord le module {{c|siblings}} avec l'option 1, puis le module {{c|personnal_data}} avec l'option 2 et enfin le module {{c|parents}} avec l'option 3. | ||
| + | |||
| + | Le fichier de configuration par défaut {{c|a.gwf}} donne la liste des modules actuellement disponibles, sachant qu'il est toujours possible pour un utilisateur de rajouter ses propres modules qu'il conservera dans le dossier | ||
| + | {{c|bases/etc/perso_modules/nouveau_module.txt}} | ||
| + | |||
==Perso.txt== | ==Perso.txt== | ||
Revision as of 23:22, 17 November 2016
 Language: |
English • français |
|---|
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 contextuelles 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.
Modules de personnalisation
La version 7 de GeneWeb offre nouvelle manière pour personnaliser l'aspect de la page personnelle.
Cette solution repose sur l'existence d'une liste de modules définis dans le fichier de configuration base.gwf en associant chaque module à une lettre entre a et z.
perso_module_a=personnal_data perso_module_b=parents perso_module_c=siblings
Associée à ces modules, la variable p_mod= définira l'ordre dans lequel ces modules seront affichés, et pour chacun d'eux une valeur d'option comprise entre 0 et 9, et qui pourra mofifier le comportement du module.
Par exemple le vecteur
p_mod=c1a2b3
affichera d'abord le module siblings avec l'option 1, puis le module personnal_data avec l'option 2 et enfin le module parents avec l'option 3.
Le fichier de configuration par défaut a.gwf donne la liste des modules actuellement disponibles, sachant qu'il est toujours possible pour un utilisateur de rajouter ses propres modules qu'il conservera dans le dossier
bases/etc/perso_modules/nouveau_module.txt
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 plupart 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 un dernier 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 | |
| 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 | File:Timeline.jpg Timeline. |
| arbre_3gen_v | |
| arbre_nav3_photo | |
| arbre_4gen_v | |
| arbre_5gen_h |
Manuel GeneWeb
- Télécharger et installer GeneWeb sous GNU/Linux, Mac OS X, Microsoft Windows, FreeBSD ou en mode CGI derrière un serveur web.
- Comprendre le principe du serveur GeneWeb, les homonymes, la consanguinité.
Utiliser et gérer une base généalogique
- Importer un fichier Gedcom
.gedou GeneWeb.gwavec gwsetup ou en lignes de commandes. - Mettre à jour les données (ajouter/modifier/supprimer personnes et familles), fusionner les doublons, saisir des dates.
- Utiliser la syntaxe wikitext, les macros, les raccourcis claviers.
- Nettoyer, restaurer, renommer, sauvegarder, archiver une base.
- Fusionner plusieurs bases et diviser une base.
Annexe technique
- Personnaliser avec CSS, entête et pieds de page, templates, lexique et déclinaisons.
- Fichier de configuration
.gwf(pour templm), mots de passe pour amis et magiciens et restrictions d'accès à une base. - Ajouter une image dans les notes.
- Autres commentaires pour les experts.
