Difference between revisions of "gwu"

From GeneWeb
Jump to: navigation, search
m
 
(7 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:Exporter un fichier GW avec gwu}}
+
{{DISPLAYTITLE:Exporting a GW file with gwu}}
{{languages|man-gwu}}
+
{{languages|gwu}}
 
__NOTOC__
 
__NOTOC__
  
La commande '''gwu''' permet d’afficher le contenu de la base sous forme de texte.
+
The command '''gwu''' will export a textual file following the [[GWformat|GW file format]] from a GeneWeb base (see the [[save|save]] page for details and caveats).
 
+
En redirigeant cet affichage vers un fichier, cela peut constituer une sauvegarde de votre base.
+
 
+
Si votre base s’appelle « dupont », et que vous pouvez la sauvegarder dans le fichier « toto.gw », tapez :
+
  
 
  gwu dupont > toto.gw
 
  gwu dupont > toto.gw
  
En sauvegardant dans des fichiers différents, après avoir fait des modifications, vous pourrez ainsi comparer différentes versions de votre base, et voir les modifications faites, en utilisant une commande de comparaisons de fichiers. Ceci est particulièrement intéressant si quelqu’un d’autre a fait des modifications dans votre base.
+
If you save a base into successive files after sets of modifications, you have the possibility of comparing the results with standards tools such as {{c|diff}}.
  
C’est enfin une méthode pour reconstituer votre base quand vous prenez une nouvelle version de GeneWeb, dans le cas où la représention interne des bases a changé.
+
The GW file format is the ''preferred'' method for [[save|archiving]] a base, and the <u>''required''</u> method to [[recover|transfer]] a base from one version of GeneWeb to another.
 
+
Pour reconstituer votre base, vous devez utiliser la commande gwc. Le fichier sauvegardé doit avoir obligatoirement l’extension ".gw". Pour fabriquer une base de nom « durand » à partir du fichier « toto.gw » ci-dessus, tapez :
+
  
 
  gwc toto.gw -o durand
 
  gwc toto.gw -o durand
<pre>
+
 
Usage: ./gwu [options] <base_file>
+
Usage: ./gwu [options] <base_file>
If both options -a and -d are used, intersection is assumed.
+
If both options -a and -d are used, intersection is assumed.
If several options -s are used, union is assumed.
+
If several options -s are used, union is assumed.
Options are:
+
Options are:
 
   -o <file>    output file name (else stdout)
 
   -o <file>    output file name (else stdout)
 
   -odir <dir>  create files from original name in directory (else on -o file)
 
   -odir <dir>  create files from original name in directory (else on -o file)
 
   -mem        save memory space, but slower
 
   -mem        save memory space, but slower
 +
  -isolated    extract isolated persons present in the base (witnesses, god parents, ...).
 +
    Works only if all the base is being extracted
 
   -a "<1st_name>" [num] "<surname>" : select ancestors of...
 
   -a "<1st_name>" [num] "<surname>" : select ancestors of...
 
   -d "<1st_name>" [num] "<surname>" : select descendants of...
 
   -d "<1st_name>" [num] "<surname>" : select descendants of...
 
   -ad "<1st_name>" [num] "<surname>" : select ancestors of...
 
   -ad "<1st_name>" [num] "<surname>" : select ancestors of...
    and all their descendants (has no effect if -a and/or -d used,
+
    and all their descendants (has no effect if -a and/or -d are used,
    option -nsp is forced).
+
    option -nsp is forced).
 
   -aws "<1st_name>" [num] "<surname>" : select ancestors with siblings
 
   -aws "<1st_name>" [num] "<surname>" : select ancestors with siblings
 
   -s "<surname>" : select this surname (option usable several times)
 
   -s "<surname>" : select this surname (option usable several times)
Line 55: Line 51:
 
     displays them to standard output) if the size of these groups is less
 
     displays them to standard output) if the size of these groups is less
 
     than 21. The present option changes this limit.
 
     than 21. The present option changes this limit.
</pre>
+
 
 +
 
 +
{{manual}}
 +
 
 +
[[Category:Manual]]

Latest revision as of 07:06, 6 July 2021

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


The command gwu will export a textual file following the GW file format from a GeneWeb base (see the save page for details and caveats).

gwu dupont > toto.gw

If you save a base into successive files after sets of modifications, you have the possibility of comparing the results with standards tools such as diff.

The GW file format is the preferred method for archiving a base, and the required method to transfer a base from one version of GeneWeb to another.

gwc toto.gw -o durand
Usage: ./gwu [options] <base_file>
If both options -a and -d are used, intersection is assumed.
If several options -s are used, union is assumed.
Options are:
 -o <file>    output file name (else stdout)
 -odir <dir>  create files from original name in directory (else on -o file)
 -mem         save memory space, but slower
 -isolated    extract isolated persons present in the base (witnesses, god parents, ...).
    Works only if all the base is being extracted
 -a "<1st_name>" [num] "<surname>" : select ancestors of...
 -d "<1st_name>" [num] "<surname>" : select descendants of...
 -ad "<1st_name>" [num] "<surname>" : select ancestors of...
    and all their descendants (has no effect if -a and/or -d are used,
    option -nsp is forced).
 -aws "<1st_name>" [num] "<surname>" : select ancestors with siblings
 -s "<surname>" : select this surname (option usable several times)
 -maxlev "<level>" : maximum level of generations of descendants
 -nsp : no spouses' parents (for options -s and -d)
 -nn : no (database) notes
 -nopicture : Don't extract individual picture.
 -c <num> :
    When a person is born less than <num> years ago, it is not exported unless
    it is Public. All the spouses and descendants are also censored.
 -old_gw : Do not export additional fields (for backward compatibility: < 7.00)
 -raw raw output (without possible utf-8 conversion)
 -v verbose
 -sep "1st_name.num surname" :
    To use together with the option "-odir": separate this person and
    all his ancestors and descendants sharing the same surname. All the
    concerned families are displayed on standard output instead of their
    associated files. This option can be used several times.
 -sep_only_file <file> :
    With option "-sep", tells to separate only groups of that file.
 -sep_limit <num> :
    When using the option "-sep", groups of families can become isolated
    in the files. Gwu reconnects them to the separated families (i.e.
    displays them to standard output) if the size of these groups is less
    than 21. The present option changes this limit.



GeneWeb Manual

Rembrandt Old Man Reading a Book.jpg

Use and manage genealogical databases

Technical annex