Popularity
3.7
Growing
Activity
8.9
Declining
152
24
66

Programming language: OCaml
Tags: Misc/Other    
Latest version: v7.0.0

GeneWeb alternatives and similar software solutions

Based on the "Misc/Other" category

Do you think we are missing an alternative of GeneWeb or a related project?

Add another 'Misc/Other' Software solution

README

GeneWeb

GeneWeb is an open source genealogy software written in OCaml. It comes with a Web interface and can be used off-line or as a Web service.

Releases build status

Linux macOS FreeBSD Windows (mingw64)
OCaml 4.09 l409 m409 f409 win-409

Documentation

The documentation is available online: http://geneweb.tuxfamily.org/

Installation (for users)

WARNING: before installing a new version of GeneWeb, it is highly recommended to save your bases into .gw formated files.

When installing a version of GeneWeb with the "pre-release" qualifier, you are participating to the collective test effort (thanks for your contribution). You should keep aside the previous version you were using, and refrain from extensive updates or additions in your bases until the "release" qualifier is effective.

Any problem you encounter or issue you want to raise should be entered on the issue page of the GitHub repository (https://github.com/geneweb/geneweb/issues)

Download the file corresponding to your environment from the releases page.

Extract the distribution folder and place it at the location of your choice. You may alse rename it. Its content is as follows (this example is for a Mac distribution. Other distributions are very similar):

drwxr-xr-x  13 Henri  staff     416 10 jul 08:34 .
drwxr-xr-x  44 Henri  staff    1408 10 jul 16:14 ..
-rw-r--r--   1 Henri  staff  160427 10 jul 08:34 CHANGES.txt
-rw-r--r--   1 Henri  staff   18007 10 jul 08:34 LICENSE.txt
-rw-r--r--   1 Henri  staff    1053 10 jul 08:34 LISEZMOI.txt
-rw-r--r--   1 Henri  staff     950 10 jul 08:34 README.txt
-rw-r--r--   1 Henri  staff   10780 10 jul 08:34 START.htm
drwxr-xr-x   2 Henri  staff      64 10 jul 08:34 bases
-rwxr-xr-x   1 Henri  staff    1632 10 jul 08:34 geneweb.command
drwxr-xr-x  21 Henri  staff     672 10 jul 08:34 gw
-rwxr-xr-x   1 Henri  staff      67 10 jul 08:34 gwd.command
-rwxr-xr-x   1 Henri  staff      71 10 jul 08:34 gwsetup.command

Starting the GeneWeb servers may depend on your specific environment.

Windows

TBD

MacOS

Apple provides a security mechanism preventing users from executing application which are not provided by authenticated developpers. Such applications cannot be started by double-clicking on their icons. Apple provides a two step mechanism circumventing this security:

  • right-click on the application icon (gwd and gwsetup). This will pop-up a window mentioning the security issue, and providing an "open" button. Click on this button to open the application. Ignore the resulting messages as no parameters were provided.
  • once gwd and gwsetup have been started in this fashion, they will be white-listed on your machine and subsequent opens will succeed.

After white-listing gwd and gwsetup, double click on the geneweb.command file which will launch both servers with appropriate parameters. With the configuration provided in this launch command the bases are located in the bases folder. You may reorganize your folder structure (and launch command) as described in the documentation at http://geneweb.tuxfamily.org/

Linux

Quite similar to the MacOS solution, without the security check. xxx.command files have an equivalent xxx.sh variant.

Resources

Contribute

See [Contributor guidelines](CONTRIBUTING.md).

Installation (for developpers)

See [AppVeyor](appveyor.yml) or [Travis CI](.travis.yml) scripts.

Build instructions

  1. Run the configuration script $ ocaml ./configure.ml
  2. Build the distibution $ make clean distrib

You can have a description of available configuration options using

$ ocaml ./configure.ml --help

Building the API

The API uses the Google Protocol Buffer to exchange information encoded as pb, json, xml.

Install protoc, and these extra dependencies:

$ opam install ocurl piqi piqilib redis redis-sync yojson

Then, tell the configure script to enable API.

$ ocaml ./configure.ml --api

Coding style

  • Try to keep the same coding style as the existing one.
  • New code should not contain any trailing whitespace.
  • Each pull request should have a single clear purpose. If it containes multiple unrelated changes, those changes should be split into separate pull requests.
  • If the PR needs to be update, push force.
  • When submitting a new feature/function, write documentation and tests if it is relevant.

All files marked in this distribution are Copyright (c) 1998-2016 INRIA (Institut National de Recherche en Informatique et Automatique) and distributed under the GNU GENERAL PUBLIC LICENSE. See [LICENSE](LICENSE) file for details.

Complete builds status

Linux macOS FreeBSD Windows (mingw64)
OCaml 4.05 l405 - - -
OCaml 4.06 l406 - - -
OCaml 4.07 l407 - - -
OCaml 4.08 l408 - - -
OCaml 4.09 l409 m409 f409 win-409
OCaml 4.10 l410 - - -


*Note that all licence references and agreements mentioned in the GeneWeb README section above are relevant to that project's source code only.