Talk:manual

Some themes to introduce and discuss and unstructured questions

• define more clearly the notions of page, form, zone, data capture field, tick-marks, buttons, radio buttons, pull-down menus ...
• explain that the pages/forms/zones are built from template files, and are "programmables"

To that extent, all templates do not adhere to the same hierarchy of pages/forms/sequences.

Identify the basic template to be discussed and adhere to its hierarchy

• Prepare sub-sections for experts
• talk about places, occupations, sources dictionaries and their use
• Talk, and/or discuss in CHANGES.txt the big new features appearing in version 7
• Introduce very early the bases and gw folders and explain that most, if not all files will be prefixed by one or the other

Similar discussion about bd, hd, ..--and the likes

• get gwd and gwserver to follow more similar rules (both should use the same -bd argument !!)
• so far so good!!

23:42, 30 October 2015 (CET)

Terminology

When discussing GeneWeb, we will use across the documentation the following terms:

• GeneWeb: the service as a whole
• gwd, gwc, gwu, gwsetup: the specific program executing some task. each program ahs specific control parameters

• Pages/page: a HTML page returned by GeneWeb and displayed by your browser
• Form/formulaire: a page specialized in data capture
• Zone/zone: a form may be divided into several zones (father, mither, child, ...)
• Field/champ: a one line ou multi-line area where typing is possible
• Tick-mark/case à cocher: a field with yes/no meaning
• Radio-button/bouton-radio: a set of tick-marks with only one active at a time
• Pull-down menu/menu déroulant: a multiple choice menu
• Buttons/boutons: a clickable area with a label trigering some action

Early description of folders

Once installed on your computer or server, GeneWeb files are organized into two main folders:

• bases where the data specific to your base is stored
• gw where the various executable programs of GeneWeb are located

Experts may organize these folders in several ways, some of which being discussed in the documentation The basic installation of GeneWeb organises these two folders next to each other under a main folder typically called geneweb which can itself be located at the place of your liking on your machine In the remainder of the documentation, we will refer to these two folders as bases and gw independently of their exact location on your machine. For instance, if you have installed geneweb under /Users/Myname/Genealogy/geneweb then

bases

will in fact designate

 /Users/Myname/Genealogy/geneweb/bases

will

Filename extensions

In the documentation, filename extensions will always include a "." as in .gw or .gwf

User interface

GeneWeb offers a very powerful and very flexible User Interface design mechanism based on template files. This documentation is based on the default set of templates. Significant differences between earlier versions of GeneWeb and GeneWeb version 7.xx will be highlighted when necessary.

The new top of page manu tool bar needs a little bit of cleaning:

• there are 5 areas: Person, Family, Ascendants/Descendants, Relations, Various
• Each area shows a "default" action, and a pull-down menu, possibly cascaded

It seems to me that the default action should always be repeated in the pull down menu Would it be hard to have some config file letting the user choose which of the actions is the default?

In base.gwf:

menubar_asc_desc=ancestors  # choose which one you want as the default button in the menubar
#menubar_asc_desc=descendants

In menubar.txt

%if;(bvar.menubar_asc_desc = "ancestors")
     %if;has_parents;
         <li><a href="%prefix;m=A;%access;">[*ancestors]</a></li>
     %end;
%if;(bvar.menubar_asc_desc = "descendants")
     %if;has_children;
         <li><a href="%prefix;m=D;%access;">[*descendants]</a></li>
     %end;
%end;

Just a thought!!

List of GeneWeb data capture commands

Reference to these actions should be consistent across the doc

Persons

• Update person/Modifier personne (MOD_IND)
• Send image/Envoyer image (SND_IMAGE)
• Merge persons/Fusionner personnes (MRG)
• Delete person/Supprimer personne (DEL_IND)

Families

• Update family/Modifier famille (MOD_FAM)
• Add family/Ajouter famille (ADD_FAM) in fact ADD family does "Update family" on a blank family !!
• Add child/Ajouter enfant (MOD_FAM#child) idem MOD_FAM. Le #child est absent dans le template, et par défaut une zone enfant devrait être rajouté à la fin !!!
• Change children names/Changer le nom des enfants (CHG_CHN)
• Merge families/Fusionner familles (MRG_FAM°
• Delete family/Supprimer famille (DEL_FAM)