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.
Build status
Linux | macOS | Windows (mingw64) | |
---|---|---|---|
OCaml 4.05 | - | - | |
OCaml 4.06 | - | - | |
OCaml 4.07 | - | - | |
OCaml 4.08 | - | - | |
OCaml 4.09 | |||
OCaml 4.10 | - | - |
Documentation
The documentation is available online: http://geneweb.tuxfamily.org/
Installation
Using opam:
opam pin add geneweb-bin -k git https://github.com/geneweb/geneweb --no-action
opam depext geneweb-bin
opam install geneweb-bin
Getting involved
We encourage you to participate in this open source project. We love pull requests, bugs reports, ideas...
- Documentation: http://geneweb.tuxfamily.org/wiki/GeneWeb
- Mailing list: https://groups.yahoo.com/neo/groups/GeneWeb/info
- IRC: irc://irc.freenode.net/geneweb
- Git: https://github.com/geneweb/geneweb
- Forum: http://www.geneanet.org/forum/GeneWeb-85
- Facebook group: http://www.facebook.com/geneweb
- Wikipedia: https://en.wikipedia.org/wiki/GeneWeb
Contributor guidelines
Install dependencies
$ opam install camlp5 cppo dune jingoo markup ounit uucp unidecode
Build instructions
- Run the configuration script
$ ocaml ./configure.ml
- 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.
Copyright
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 file for details.