bases

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 called with m=IM&i=index
          • first_name.occurence.last_name.jpg
          • other_first_name.occurence.last_name.jpg
          • saved: saved portraits called with m=IMS&i=index
        • images: other images associated with a person shown in a carrousel
          • first_name.occurence.last_name: other images associated with a person
            • otherimage.jpg: images called with m=IM&i=index&s=otherimage.jpg
            • otherimage.txt: comment associated with otherimage
            • saved: saved images and comments called with m=IMS&i=index&s=otherimage.jpg
        • myimage.jpg: images called with m=DOC&s=myimage.jpg or m=IM&s=myimage.jpg
        • mytext.txt: text files called with m=DOC&s=mytext.txt or m=SRC&v=mytext
        • mydoc.pdf: PDF files called with m=DOC&s=mydoc.pdf
        • mypage.html: HTML pages called with m=DOC&s=mypage.html
        • src:
          • mydoc.txt: txt files called with m=DOC&s=mydoc.txt or m=SRC&v=mydoc
          • lg: language specific txt files
      • 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: 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: folder with all the notes and linked pages
        • notes.txt: (reserved name) main notes for the base, displayed in the welcome page
        • linked_page.txt: other "linked_page" obtained with [[[linked_page/text]]]
      • … 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).