Difference between revisions of "shortcuts"

From GeneWeb
Jump to: navigation, search
(Shortcuts (en) pass 1)
 
m (A2 moved page Shortcuts to shortcuts: minuscule)
 
(33 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
{{DISPLAYTITLE:GeneWeb keyboard shortcuts}}
 
{{DISPLAYTITLE:GeneWeb keyboard shortcuts}}
{{languages|shortcurts}}
+
{{languages|shortcuts}}
 
{{toc right}}
 
{{toc right}}
 +
Some GeneWeb commands are accessible through '''keyboard shortcuts'''.
  
Most GeneWeb commands are accessible through a keyboard shortcut. Note that some browsers may take precedence over GeneWeb and have their own shortcuts taking precedence over those of GeneWeb. Sometimes, the lowercase shortcut is superseeded, but the uppercase one remains active.
+
Shortcuts are defined using [http://www.w3schools.com/tags/att_global_accesskey.asp HTML accesskey attribute] those are commonly reached using {{key|Alt}} modifier key but it is not always the case, for example for Macintosh it is {{keys|Ctrl|Alt}}. Be careful with this because for convenience, this page only uses the syntaxe {{keys|Alt|key}}.
 +
The section [[#Browsers behaviour|Browsers behaviour]] below discusses this point in more details.  
  
As for typing, uppercase is obtained by pressing simultaneouslya letter and the {{keys|Maj}} key. Le letetr {{c|A}} is obtained by holding the keys {{keys|Maj|a}}.
+
As for typing, a letter in uppercase is obtained by maintaining {{keys|Shift}} then typing the letter : a shortcut written {{keys|Alt|A}} means the keys {{keys|Alt|Shift|a}}.
  
== Raccourcis claviers ==
+
Note that some browsers may take precedence over GeneWeb and have their own shortcuts taking precedence over those of GeneWeb. Sometimes, the lowercase shortcut is superseded, but the uppercase one remains active.
  
These shortcuts, defined in GeneWeb version 5.02 may not be active anymore with version 7.xx. To be verified!!
+
== Keyboard shortcuts ==
 +
These shortcuts, defined in GeneWeb version 5.02, are active with all templates.
  
 
Personal page :
 
Personal page :
* Search for a path between individuals : {{keys|Alt|R}} = {{keys|Alt|Maj|r}}.
+
* {{keys|Alt|U}}: Update submenu.
* Update : {{keys|Alt|U}} (Update).
+
** {{keys|Alt|P}}: [[Update#Modify a person|Update person]].
** Update family : {{keys|Alt|F}} (seulement la première relation).
+
** {{keys|Alt|A}}: Add family/relation/marriage.
** Update person : {{keys|Alt|P}}.
+
** {{keys|Alt|F}}: [[Update#Modify a family|Update family]] (the first relation).
** Add mariage : {{keys|Alt|A}}.
+
* {{keys|Alt|R}}: Search for relation between individuals.
  
Paths between persons :
+
Paths between persons:
* {{c|1=//}} Display a section : {{keys|Alt|/}} (ne fonctionne pas sur les arbres).
+
* {{keys|Alt|/}}: Display a section {{c|1=//}} ((possibly {{keys|Alt|:}} on some keyboards), does not work with trees).
* {{c|>>}} Next path : {{keys|Alt|>}}.
+
* {{keys|Alt|>}}: Next path {{c|>>}} (possibly {{keys|Alt|<}} on some keyboards).
* Return to the welcome pagel (?, a href=%prefix) : {{keys|Alt|T}}.
+
* {{keys|Alt|T}}: Return to the welcome page (?, a href=%prefix).
  
Message du forum :
+
Forum essages:
* Retour à la racine : {{keys|Alt|F}}  
+
* {{keys|Alt|F}}: Return to the forum main page.
* Message suivant : {{keys|Alt|N}}.
+
* {{keys|Alt|N}}: Next message.
* Message précédent : {{key|Alt|P}}.
+
* {{keys|Alt|P}}: Previous message.
* ?? : {{keys|Alt|1}}.
+
* {{keys|Alt|1}}: Open most recent message (active only on the forum main page).
  
 
== Templm additional shortcuts==
 
== Templm additional shortcuts==
The following shortcuts are active within the templm template
+
The following shortcuts are active within the [[templm]] [[templates|template]].
  
=== With the Alt key ===
+
* {{keys|Alt|W}}: Position cursor on the Surname search field.
* Search (if available at the bottom of the page) : {{keys|Alt|²}}.
+
* {{keys|Alt|X}}: Adjust the number of generations (in lists and trees).
  
 
==== Personal page ====
 
==== Personal page ====
*Add parents : {{keys|Alt|L}}.
+
*{{keys|Alt|Z}}: Activate [[#Direct shortcuts|Direct shortcuts]].
*Update second family : {{keys|Alt|G}}.
+
*{{keys|Alt|L}}: Add parents.
*Update third family : {{keys|Alt|H}}.
+
*{{keys|Alt|A}}: Add family.
*Allow [[#Direct shortcuts|direct shortcuts]] : {{keys|Alt|W}}.
+
*{{keys|Alt|F}}: Update family.
 +
*{{keys|Alt|G}}: Update second family.
 +
*{{keys|Alt|H}}: Update third family.
 +
*{{keys|Alt|Y}}: Display ascending tree, twice for descending tree.
 +
*{{keys|Alt|D}}: Show difference with previous revision (if exists).
 +
*{{keys|Alt|S}}: Navigate with current individual as reference Sosa.
  
==== Update a person form ====
 
*Position cursor on the profession field: {{keys|Alt|P}}.
 
*Position the cursor on a specific zone (first field): {{keys|Alt|#}} where # is the zone number:
 
** {{keys|Alt|1}} person ;
 
** {{keys|Alt|2}} birth ;
 
** {{keys|Alt|3}} baptism ;
 
** {{keys|Alt|4}} death ;
 
** {{keys|Alt|5}} inhumation ;
 
** {{keys|Alt|6}} titles ;
 
** {{keys|Alt|7}} relations ;
 
** {{keys|Alt|8}} notes.
 
*Quick selection of « Deceased » rapidement : {{keys|Alt|4}} (death field) then {{key|+}}.
 
  
==== Update a family form ====
+
=== Forms ===
*Go to a specific zone : {{keys|Alt|#}} where # is the zone number:
+
Shortcuts allow navigation and editing in children, witness and event lists. They operate when the cursor is positionned on the first field or each item (sex or occurence number for childrens and witness, {{c|#}} for events):
** {{keys|Alt|1}} family ;
+
*{{key|R}} : move up ;
** {{keys|Alt|2}} mariage ;
+
*{{key|D}} : move down ;
** {{keys|Alt|3}} witness ;
+
*{{key|H}} : move cursor up ;
** {{keys|Alt|4}} children.
+
*{{key|B}}: move cursor down ;
*Quick navigation between first-name/last-name/sex/dates (family and children zones):  
+
*{{key|A}} : add ;
**{{keys|Alt|<}} 
+
*{{key|I}} : insert ;
**{{keys|Alt|>}} 
+
*{{key|X}} : remove ;
**{{keys|Alt|_}}
+
**{{key|*}} (simpler capture of dates with numerical keypad).
+
  
=== Direct shortcuts ===
+
==== Update a person ====
 +
*{{keys|Alt|P}}: Position cursor on the profession field.
 +
*{{keys|Alt|O}}: Modify event ordering .
 +
*{{keys|Alt|#}}: Position the cursor on a specific zone (first field) where # is the zone number.
 +
** {{keys|Alt|1}}: person.
 +
** {{keys|Alt|2}}: birth date.
 +
** {{keys|Alt|3}}: death.
 +
** {{keys|Alt|4}}: add event; {{key|+}} will select « Deceased ».
 +
** {{keys|Alt|5}}: notes.
 +
** {{keys|Alt|6}}: add relation.
 +
** {{keys|Alt|7}}: titles.
  
If javaScript is available on your machine, it is possible to use direct shortcuts without having to press the key {{key|Alt}}.
+
==== Update a family ====
To allow for these direct shortcuts, one must have the cursor positioned in the empty box at the upper right (to the left of {{c|÷}}) as is the case when opening an personnal page. {{keys|Alt|W}} positions the cursor on this box if it is not already there.
+
positioning the mouse over this box will display a help menu.
+
  
* Personal pahe, direct acces:
+
* {{keys|Alt|1}}: position cursor on father first name.
** same as above, without the {{keys|Alt}} key, both upper and lower case:
+
* {{keys|Alt|2}}: add child.
*** {{key|²}} : search ;
+
* {{keys|Alt|3}}: position cursor on union date.
*** {{key|P}} ou {{key|p}} : update person ;
+
* {{keys|Alt|4}}: add event.
*** {{key|F}} ou {{key|f}} : update first spouse ;
+
* {{keys|Alt|5}}: position cursor on note for union.
*** {{key|G}} ou {{key|g}} : update second spouse ;
+
* {{keys|Alt|6}}: position cursor on family sources.
*** {{key|H}} ou {{key|h}} : update third spouse ;
+
* {{keys|Alt|O}}: change events ordering.
*** {{key|L}} ou {{key|l}} : add parents ;
+
 
*** {{key|A}} ou {{key|a}} : add family ;
+
=== Direct shortcuts ===
*** {{key|Y}} ou {{key|y}} : ascending or descending tree ;
+
If JavaScript is available on your machine, it is possible to use direct shortcuts without having to use modifier key(s).
** select a close relation and open his/her update page :
+
To allow for these direct shortcuts, the cursor must be positioned in the empty box to the left of the surname field of search at the upper right (as it is the case when opening a personal page). {{keys|Alt|Z}} positions the cursor on this box if it is not already there.
*** {{key|2}} ou {{key|é}} : father ;
+
Positioning the mouse over this box will display a help menu with list of available shortcuts.
*** {{key|3}} ou {{key|"}} : mother ;
+
 
*** {{key|4}} ou {{key|'}} : father's father ;
+
* Personal page, direct access:
*** {{key|5}} ou {{key|(}} : father's mother ;
+
** Same as above, without the modifier(s) key(s), both upper and lower case:
*** {{key|6}} ou {{key|-}} : mother's father ;
+
*** {{key|W}} or {{key|w}}: Position the cursor on the surname field of search.
*** {{key|7}} ou {{key|è}} : mother's mother ;
+
*** {{key|L}} or {{key|l}}: Add parents.
*** {{key|1}} ou {{key|&}} : navigate between siblings (brothers and sisters)
+
*** {{key|A}} or {{key|a}}: Add family.
*** {{key|0}} ou {{key|à}} : navigate between spouses ;
+
*** {{key|P}} or {{key|p}}: Update person.
*** {{key|8}} ou {{key|_}} : navigate between children ;
+
*** {{key|F}} or {{key|f}}: Update first spouse (if exists).
*** {{key|9}} ou {{key|ç}} : navigate between Sosa ;
+
*** {{key|G}} or {{key|g}}: Update second spouse (if exists).
*** {{key|Entrée}} : accède à la fiche de l’invidivu sélectionné ;
+
*** {{key|H}} or {{key|h}}: Update third spouse (if exists).
*** {{key|P}} ou {{key|p}} : open the update form of the selected eprson.
+
*** {{key|S}} or {{key|s}}: Navigate with individual as reference Sosa.
 +
*** {{key|Y}} or {{key|y}}: Show ascending tree, twice for descending tree.
 +
*** {{key|D}} or {{key|d}}: Show difference with previous revision (if exists).
 +
*** {{key|R}} or {{key|r}}: Search for a relation between individuals.
 +
** Select a close relation and open his/her update page:
 +
*** {{key|0}} or {{key|à}}: navigate between spouses.
 +
*** {{key|1}} or {{key|&}}: navigate between siblings (brothers and sisters)
 +
*** {{key|2}} or {{key|é}}: father.
 +
*** {{key|3}} or {{key|"}}: mother.
 +
*** {{key|4}} or {{key|'}}: father's father.
 +
*** {{key|5}} or {{key|(}}: father's mother.
 +
*** {{key|6}} or {{key|-}}: mother's father.
 +
*** {{key|7}} or {{key|è}}: mother's mother.
 +
*** {{key|8}} or {{key|_}}: navigate between children.
 +
*** {{key|9}} or {{key|ç}}: navigate to children with Sosa.
 +
::: once the person has been selected :
 +
*** {{key|Enter}}: opens its personal page.
 +
*** {{key|P}} or {{key|p}}: open its update person form.
  
 
By default, selected children are those from the first family. To select children of the other families, one must first navigate to the right spouse. For instance, to update the third child of the third spouse, one will enter: {{key|0}} {{key|0}} {{key|0}} {{key|8}} {{key|8}} {{key|8}} {{key|P}} (or {{key|à}} {{key|à}} {{key|à}} {{key|ç}} {{key|ç}} {{key|ç}} {{key|p}}).  
 
By default, selected children are those from the first family. To select children of the other families, one must first navigate to the right spouse. For instance, to update the third child of the third spouse, one will enter: {{key|0}} {{key|0}} {{key|0}} {{key|8}} {{key|8}} {{key|8}} {{key|P}} (or {{key|à}} {{key|à}} {{key|à}} {{key|ç}} {{key|ç}} {{key|ç}} {{key|p}}).  
  
These shortcuts are adjusted for the [https://fr.wikipedia.org/wiki/french AZERTY keyboard layout], if they do not work to your liking with your browser, you may edit the file {{git|hd/etc/templm|js_perso_accesskey.txt}} in folder {{c|gw/etc/templm/}}.
+
These shortcuts are adjusted for the [https://fr.wikipedia.org/wiki/french AZERTY keyboard layout], if they do not work to your liking with your your browser or keyboard layout, you may edit the files {{git|hd/etc/templm|js_perso_accesskey.txt}} and {{git|hd/etc/templm|js_perso_accesskey.js}} in folder {{c|gw/etc/templm/}}.
 +
 
 +
== Browsers behaviour ==
 +
 
 +
The main browsers (Chrome, Firefox, IE, Opera, Safari) have a slightly different behaviour, between themselves and according to the platform on which they execute.
 +
Some experimentation  and parameter setting should allow you to fully benefit from the shkeyboard shortcuts available in GeneWeb.
 +
 
 +
* Depending on your browser, it may be necessary to authorize the opening of '''pop-ups''' for your own machine known as '''localhost'''. If pop-ups are blocked on your browser, you will be warned and given the opportunity to authorize pop-ups. You can also set the appropriate parameter through the preference or parameters window.
 +
 +
* Depending on the platform (Linux, OSX, Windows), the keys activating keyboard shortcuts may vary:.
 +
 
 +
{|class="wikitable" style="border-width: 10px; text-align:left;"
 +
!Platform!!Shortcut activation
 +
|-
 +
|Linux||{{keys|Alt}}
 +
|-
 +
|OSX||{{keys|Ctrl|Alt}}
 +
|-
 +
|Windows||{{keys|Alt}}
 +
|-
 +
|}
 +
 
 +
* Depending on your browser (at least for Firefox on OSX), keyboard shortcuts may be become inactive while you are entering data on a form field. This behaviour may be changed through some parametrisation.
 +
** On Firefox under OSX :
 +
*** Open the parameters page : about:config ;
 +
*** Select parameter '''ui.key.contentAccess''' and assign value 2 ;
 +
*** In this new configuration, keyboard shortcuts activation is obtained with {{keys|Ctrl}} ;
 +
 
 +
Some esperimentation should allow you to verify and adjust your environment. As wizard, you should observe the following behaviour:
 +
* Open a personnal page ;
 +
* {{keys|Alt|P}} opens a new browser tab with the person modification form ;
 +
* {{keys|Alt|1}} positions the cursor on the first name field ;
 +
* {{keys|Alt|P}} positions the cursor on teh occupation field ;
 +
* Keys {{keys|Cut}}, {{keys|Paste}}, {{keys|Undo}}, ... of your environment should remain active ;
 +
 
 +
{{manual}}
 +
 
 +
[[Category:Manual]]

Latest revision as of 14:24, 22 April 2016

150px-Geographylogo svg.png Language: English • français

Some GeneWeb commands are accessible through keyboard shortcuts.

Shortcuts are defined using HTML accesskey attribute those are commonly reached using Alt modifier key but it is not always the case, for example for Macintosh it is Ctrl + Alt. Be careful with this because for convenience, this page only uses the syntaxe Alt + key. The section Browsers behaviour below discusses this point in more details.

As for typing, a letter in uppercase is obtained by maintaining Shift then typing the letter : a shortcut written Alt + A means the keys Alt + Shift + a.

Note that some browsers may take precedence over GeneWeb and have their own shortcuts taking precedence over those of GeneWeb. Sometimes, the lowercase shortcut is superseded, but the uppercase one remains active.

Keyboard shortcuts

These shortcuts, defined in GeneWeb version 5.02, are active with all templates.

Personal page :

  • Alt + U: Update submenu.
  • Alt + R: Search for relation between individuals.

Paths between persons:

  • Alt + /: Display a section // ((possibly Alt + : on some keyboards), does not work with trees).
  • Alt + >: Next path >> (possibly Alt + < on some keyboards).
  • Alt + T: Return to the welcome page (?, a href=%prefix).

Forum essages:

  • Alt + F: Return to the forum main page.
  • Alt + N: Next message.
  • Alt + P: Previous message.
  • Alt + 1: Open most recent message (active only on the forum main page).

Templm additional shortcuts

The following shortcuts are active within the templm template.

  • Alt + W: Position cursor on the Surname search field.
  • Alt + X: Adjust the number of generations (in lists and trees).

Personal page

  • Alt + Z: Activate Direct shortcuts.
  • Alt + L: Add parents.
  • Alt + A: Add family.
  • Alt + F: Update family.
  • Alt + G: Update second family.
  • Alt + H: Update third family.
  • Alt + Y: Display ascending tree, twice for descending tree.
  • Alt + D: Show difference with previous revision (if exists).
  • Alt + S: Navigate with current individual as reference Sosa.


Forms

Shortcuts allow navigation and editing in children, witness and event lists. They operate when the cursor is positionned on the first field or each item (sex or occurence number for childrens and witness, # for events):

  • R : move up ;
  • D : move down ;
  • H : move cursor up ;
  • B : move cursor down ;
  • A : add ;
  • I : insert ;
  • X : remove ;

Update a person

  • Alt + P: Position cursor on the profession field.
  • Alt + O: Modify event ordering .
  • Alt + #: Position the cursor on a specific zone (first field) where # is the zone number.
    • Alt + 1: person.
    • Alt + 2: birth date.
    • Alt + 3: death.
    • Alt + 4: add event; + will select « Deceased ».
    • Alt + 5: notes.
    • Alt + 6: add relation.
    • Alt + 7: titles.

Update a family

  • Alt + 1: position cursor on father first name.
  • Alt + 2: add child.
  • Alt + 3: position cursor on union date.
  • Alt + 4: add event.
  • Alt + 5: position cursor on note for union.
  • Alt + 6: position cursor on family sources.
  • Alt + O: change events ordering.

Direct shortcuts

If JavaScript is available on your machine, it is possible to use direct shortcuts without having to use modifier key(s). To allow for these direct shortcuts, the cursor must be positioned in the empty box to the left of the surname field of search at the upper right (as it is the case when opening a personal page). Alt + Z positions the cursor on this box if it is not already there. Positioning the mouse over this box will display a help menu with list of available shortcuts.

  • Personal page, direct access:
    • Same as above, without the modifier(s) key(s), both upper and lower case:
      • W or w: Position the cursor on the surname field of search.
      • L or l: Add parents.
      • A or a: Add family.
      • P or p: Update person.
      • F or f: Update first spouse (if exists).
      • G or g: Update second spouse (if exists).
      • H or h: Update third spouse (if exists).
      • S or s: Navigate with individual as reference Sosa.
      • Y or y: Show ascending tree, twice for descending tree.
      • D or d: Show difference with previous revision (if exists).
      • R or r: Search for a relation between individuals.
    • Select a close relation and open his/her update page:
      • 0 or à: navigate between spouses.
      • 1 or &: navigate between siblings (brothers and sisters)
      • 2 or é: father.
      • 3 or ": mother.
      • 4 or ': father's father.
      • 5 or (: father's mother.
      • 6 or -: mother's father.
      • 7 or è: mother's mother.
      • 8 or _: navigate between children.
      • 9 or ç: navigate to children with Sosa.
once the person has been selected :
      • Enter: opens its personal page.
      • P or p: open its update person form.

By default, selected children are those from the first family. To select children of the other families, one must first navigate to the right spouse. For instance, to update the third child of the third spouse, one will enter: 0 0 0 8 8 8 P (or à à à ç ç ç p).

These shortcuts are adjusted for the AZERTY keyboard layout, if they do not work to your liking with your your browser or keyboard layout, you may edit the files js_perso_accesskey.txt and js_perso_accesskey.js in folder gw/etc/templm/.

Browsers behaviour

The main browsers (Chrome, Firefox, IE, Opera, Safari) have a slightly different behaviour, between themselves and according to the platform on which they execute. Some experimentation and parameter setting should allow you to fully benefit from the shkeyboard shortcuts available in GeneWeb.

  • Depending on your browser, it may be necessary to authorize the opening of pop-ups for your own machine known as localhost. If pop-ups are blocked on your browser, you will be warned and given the opportunity to authorize pop-ups. You can also set the appropriate parameter through the preference or parameters window.
  • Depending on the platform (Linux, OSX, Windows), the keys activating keyboard shortcuts may vary:.
Platform Shortcut activation
Linux Alt
OSX Ctrl + Alt
Windows Alt
  • Depending on your browser (at least for Firefox on OSX), keyboard shortcuts may be become inactive while you are entering data on a form field. This behaviour may be changed through some parametrisation.
    • On Firefox under OSX :
      • Open the parameters page : about:config ;
      • Select parameter ui.key.contentAccess and assign value 2 ;
      • In this new configuration, keyboard shortcuts activation is obtained with Ctrl ;

Some esperimentation should allow you to verify and adjust your environment. As wizard, you should observe the following behaviour:

  • Open a personnal page ;
  • Alt + P opens a new browser tab with the person modification form ;
  • Alt + 1 positions the cursor on the first name field ;
  • Alt + P positions the cursor on teh occupation field ;
  • Keys Cut, Paste, Undo, ... of your environment should remain active ;

GeneWeb Manual

Rembrandt Old Man Reading a Book.jpg

Use and manage genealogical databases

Technical annex