Geneweb bases folder

Language:	English

The folder of the databases should contain the same information structure as in the case of an installation on a personal computer. Its location is, by default, within the distribution folder with the name /bases, but it can be located elsewhere and named otherwise according to your preferences. Similarly, the choice of names for your bases and .auth files is unconstrained.

In each of the etc, images, lang and src folders, sub-folders carrying the name of the base mybase.gwb hold the specific data for each base.

• distribution (details the description of the program folder gw/, only bases/ is described here)
  • bases: The folder containing the GeneWeb databases
    • mybase.gwb: folder of the genealogical database called mybase
    • mybase.gwf: associated .gwf configuration/parameters file
    • mybase-f.auth example of password file for friends (friend_passwd_file=)
    • mybase-w.auth example of password file for wizards (wizard_passwd_file=)
    • mybase2.gwb: folder of a second genealogical database mybase2
    • mybase2.gwf/auth configuration files associated to mybase2, etc.
    • cnt: holding the robot file, locks, and memorising the access counts for each base
      • actlog: file temporary storing the tokens needed for login in CGI mode
      • robot list IP address of robots
      • mybase.txt access counts for mybase
      • mybase.lck lock file for mybase
    • etc: used in priority over the generic gw/etc files (see templates)
      • mybase: template folders for mybase
        • perso_module
          • module_xx.txt
        • header.txt base specific header file
        • trl.txt base specific trailer file
      • mybase2: idem
    • images
      • mybase: portraits images for mybase
        • first_name.occurence.last_name.jpg
        • other_first_name.occurence.last_name.jpg
      • mybase2: idem
    • lang: containing some base specific language related template text files (lexicon for instance)
      • mybase
      • mybase2
    • src
      • mybase
        • images: images called with m=IMH
          • myimage.jpg
        • file1.txt: text file called with m=SRC
      • mybase2: idem
  • gw
  • […] gwd/gwsetup launch scripts, README, etc.

Bases folder in GeneWeb 7

This section of the documentation is not yet implemented. The current version of GeneWeb v7 adheres to the old folder structure.

GeneWeb 7 simplifies the archival of databases regrouping all the files needed for a single database under the same folder. With this configuration, it becomes far simpler to use archival tools such as tar, zip or rar to store a single database folder in an archive (see save for details and comments).

• distribution (details the description of the program folder gw/, only bases/ is described here)
  • bases: The folder containing the GeneWeb databases
    • comm.log: execution log of the last base creation with a gwc command
    • perso_lexicon.txt: UTF-8 personnal complementary lexicon (loaded with -add_lexicon at gwd start)
    • tags.txt: alternate list of authorized HTML tags (loaded with -allowed_tags at gwd start)
    • mybase.gwb: folder of the genealogical database called mybase
      • params.gwf: associated .gwf configuration/parameters file
      • mybase-f.auth: example of password file for friends (friend_passwd_file= in params.gwf)
      • mybase-w.auth: example of password file for wizards (wizard_passwd_file= in params.gwf)
      • counts.txt: access counts
      • history: history of modifications
      • particles.txt: particles list for this base.
      • documents: image/txt/pdf/html files, subdirs allowed
        • mytext.txt: text files called with m=TXT or m=SRC
        • mydoc.pdf: PDF files called with m=PDF
        • mypage.html: HTML pages called with m=HTM
        • myimage.jpg: images called with m=IMG or m=IMH (m=IM kept for backward compatibility)
      • etc: personnalized variants of template files, used in priority over the generic gw/etc files (see templates)
        • perso_module: personnalized variants of perso_modules files
          • module_xx.txt
        • templatex: personnal variant of templatex files
        • hed.txt: base specific header file
        • trl.txt: base specific trailer file
      • history_d: folder with all diff files (this folder may be located elsewhere according to history_path= in params.gwf)
      • portraits: portraits images
        • first_name.occurence.last_name.jpg
        • other_first_name.occurence.last_name.jpg
      • […] base, base.acc, cache_info […] names.inx, notes_links, patches (internal files and folders of the database)
    • mybase2.gwb: folder of a second genealogical database mybase2
      • […] the organisation is the same for each database see description for mybase.gwb folder above
    • cnt: holding the robot file, locks, and memorising the access counts for each base
      • actlog: file temporary storing the tokens needed for login in CGI mode
      • mybase.lck: lock file for mybase
      • robot: list IP addresses of detected robots
  • gw
  • […] gwd/gwsetup launch scripts, CHANGES.txt, README, etc.

Note that with this configuration, all personnalization happens in files stored in the base folder. A new release of GeneWeb may be installed safely by copying the new gw folder and possibly new copies of gwd/gwsetup launch scripts, CHANGES.txt, README, etc (the last two lines of the tree above).