Difference between revisions of "OCaml"
m (titre) |
(→ GeneWeb 7: insécable superfétatoire) |
||
Line 13: | Line 13: | ||
== Under Windows using Cygwin == | == Under Windows using Cygwin == | ||
This has been tested on Windows 7 x64 and x86: | This has been tested on Windows 7 x64 and x86: | ||
− | === | + | === GeneWeb 7 === |
If you have [https://en.wikipedia.org/wiki/Windows_PowerShell Windows Powershell], this [https://gist.github.com/a2line/f134c88c80eafcf0411b38e32a0a7128 batch script] will download/compile/install Cygwin/Opam/OCaml/Camlp5/Ocamfind/GeneWeb for you. Copy/paste on the command line with administrator rights: | If you have [https://en.wikipedia.org/wiki/Windows_PowerShell Windows Powershell], this [https://gist.github.com/a2line/f134c88c80eafcf0411b38e32a0a7128 batch script] will download/compile/install Cygwin/Opam/OCaml/Camlp5/Ocamfind/GeneWeb for you. Copy/paste on the command line with administrator rights: | ||
<pre>powershell.exe -Command (new-object System.Net.WebClient).DownloadFile('https://gist.github.com/a2line/f134c88c80eafcf0411b38e32a0a7128/raw/','opamwin.bat') | <pre>powershell.exe -Command (new-object System.Net.WebClient).DownloadFile('https://gist.github.com/a2line/f134c88c80eafcf0411b38e32a0a7128/raw/','opamwin.bat') |
Revision as of 15:01, 10 September 2016
Compiling GeneWeb requires the installation of OCaml and Camlp5.
Installing OCaml and Camlp5 through OPAM (OCaml preferred package manager) allows the installation of the two versions of OCaml needed for GeneWeb:
- Old GeneWeb versions (lower than 7.00) should be compiled with OCaml version 3.12.1.
- Starting at version 7.00, GeneWeb must be compiled with OCaml >4.02.
Camlp5 must be installed for each version of the compiler.
If your base has been built under an old version, it won't be compatible with bases built with new version: one should recover through the .gw format to migrate from one to the other.
When Ocaml and camlp5 are installed, you can clone GeneWeb repository to compile GeneWeb.
Under Windows using Cygwin
This has been tested on Windows 7 x64 and x86:
GeneWeb 7
If you have Windows Powershell, this batch script will download/compile/install Cygwin/Opam/OCaml/Camlp5/Ocamfind/GeneWeb for you. Copy/paste on the command line with administrator rights:
powershell.exe -Command (new-object System.Net.WebClient).DownloadFile('https://gist.github.com/a2line/f134c88c80eafcf0411b38e32a0a7128/raw/','opamwin.bat') opamwin
Without Powershell, you have to download the batch file opamwin.bat and the right Cygwin setup x64 or x86 manually then just launch the script from the command line.
Under Linux
This has been tested on a Debian in november 2015 (debian-8.2.0-i386-netinst.iso).
GeneWeb 7
To install Opam/OCaml (4.02.3)/Camlp5 (6.14)/ocamlfind (1.6.2):
apt-get install opam opam init opam update opam switch 4.02.3 opam install -y camlp5 ocamlfind eval 'opam config env'
If ocamfind install fails with opam, try installing pkg-config before with apt-get install pkg-config
, then retry.
GeneWeb <6.08
To build previous versions of GeneWeb you need to switch to OCaml 3.12.1 with Opam:
opam switch 3.12.1 opam install -y camlp5 ocamlfind eval 'opam config env'
When using Opam on old sources, we need to replace the path to Camlp5 CAMLP5D=+camlp5
in tools/Makefile.inc
with a sed command after configuring Makefile:
./configure sed -i 's|CAMLP5D=+camlp5|CAMLP5D=~/.opam/3.12.1/lib/camlp5|' tools/Makefile.inc make make distrib
You can check the path to Camlp5 with ocamlfind query camlp5
, for this exemple camlp5 lib is in /root/.opam/3.12.1/lib/camlp5/
.
Building like this was succesfull with 6.08-alpha, 6.05 and 6.04-src.tgz from geneweb.org (see #30).
Clone repository and compile GeneWeb
GeneWeb uses the version control software Git. Its repository is hosted on Github at https://github.com/geneweb/geneweb. To compile GeneWeb, you need OCaml.
git clone https://github.com/geneweb/geneweb git pull ./configure && make && make distrib
If GeneWeb compilation fails, look at continuous integration tools to see if lastest build is passing on your plateform.
GeneWeb Manual
- Download and install GeneWeb program under GNU/Linux, Mac OS X, Microsoft Windows, FreeBSD; on Mac OS X, Linux or Windows using Docker; or in CGI mode behind a web server.
- Understand GeneWeb server, homonym, consanguinity.
Use and manage genealogical databases
- Import Gedcom
.ged
or GeneWeb.gw
files with gwsetup or in command-line. - Update datas (add/remove individuals and families), merge duplicates, type dates.
- Use wikitext syntax, macros, keyboard shortcuts.
- Clean, recover, rename, save, archive a database.
- Merge and split multiples databases.
Technical annex
- Personalize CSS, header and trailer, templates, lexicon and declension.
- Configuration file
.gwf
(for templm), wizard notes, passwords for friends/wizards and access restrictions to databases. - Add images in notes, further remarks for experts.