Geneweb bases folder

Language:	English

The bases folder is by default a subfolder of the GeneWeb distribution named bases that contains all your personnal data: the genealogical databases themselves with their notes, images, authentification files, template personalisation, etc. It can be moved or renamed according to your preferences.

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

• distribution: details all the other files and subfolders out of bases folder, like the programs or template files.
  • 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
        • modules
          • 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 fully 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
  • bases: The folder containing the GeneWeb databases
    • mybase.gwb: folder of the genealogical database called mybase
      • documents: image/txt/pdf/html files, subdirectories allowed
        • portraits: portraits images
          • first_name.occurence.last_name.jpg
          • other_first_name.occurence.last_name.jpg
        • others: other images associated with a person
          • first_name.occurence.last_name: other images associated with a person
            • otherimage.jpg: images called with m=DOC&s=others/%keydir;/otherimage.jpg
            • otherimage.txt: comment associated with otherimage (%keydir_img_notes;)
        • old: portraits images saved after rename or delete (same structure as others)
        • myimage.jpg: images called with m=IMG or m=IMH (m=IM kept for backward compatibility)
        • 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
      • etc: configurations files and personnalized variants of template files, used in priority over the generic gw/etc files (see templates)
        • modules: personnalized variants of modules files
          • module_xx.txt
        • templatex: personnal variant of templatex files
        • mybase.conf (mybase-config.txt?): configuration/parameters file (old .gwf)
        • mybase.count (mybase-counts.txt?): access counts
        • mybase-f.auth (mybase-friend-auth.txt?): example of password file for friends (friend_passwd_file= in mybase.conf)
        • mybase-w.auth (mybase-wizard-auth.txt?): example of password file for wizards (wizard_passwd_file= in mybase.conf)
        • particles.txt (mybase-particles.txt?): particles list for this base.
        • hed.txt and trl.txt: base specific header/trailer files
      • lang: local complements to the language lexicon
      • history_d: folder with all diff files (this folder may be located elsewhere according to history_path= in mybase.conf)
        • a
        • b
        • …
        • history(.txt?): history of modifications
      • notes_d: folder with all the notes
        • notes(.txt?): summary/index of all the notes
      • … base, base.acc, cache_info […] names.inx, notes_links, patches (all 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
    • comm.log (log.txt?): 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)
  • 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).