README

   1 Ocsigen server & Eliom
   2
   3 ------------------------------------------------------------------
   4
   5 Requirements:
   6 =============
   7
   8 Compilers:
   9
  10  * ocaml and camlp4  (need version >= 3.12)
  11  * js_of_ocaml       (need version >= 1.0.6, with deriving-ocsigen support)
  12  * a C compiler      (tested with gcc-4.4.5)
  13  * ocamlduce         [optionnal]
  14
  15 Libraries:
  16
  17  * findlib
  18  * ocsigenserver     (need version >= 2.0)
  19  * tyxml             (need version >= 2.0)
  20  * react             (tested with 0.9.2)
  21  * deriving-ocsigen  (need version >= 0.2-ocsigen)
  22                        See: https://github.com/hnrgrgr/deriving
  23  * ocamlssl          (tested with 0.4.4)
  24  * calendar          (tested with 2.01.1)
  25
  26  [optionnal]
  27  * tyxml.duce        (when building with ocamlduce support)
  28
  29 If OCaml 3.12 and the needed libraries (findlib/react/lwt...) are not
  30 installed on your computer and not available on your favorite linux
  31 distribution, you may use the Ocsigen bunble GODI to install them
  32 automatically, see:
  33
  34   http://ocsigen.org/install#bundle
  35   http://godi.camlcity.org/godi/index.html
  36
  37 To run the native code version of ocsigen server, you may need to
  38 generate cmxs files for the libraries you need, if they are not
  39 included in your distribution, see:
  40
  41   http://ocsigen.org/ocsigenserver/manual/misc
  42
  43 ------------------------------------------------------------------
  44
  45 Build instructions:
  46 ===================
  47
  48  * run "sh configure [options]" to generate 'Makefile.config'
  49  - For the full list of options, run "sh configure --help".
  50
  51  * verify that 'Makefile.config' suits to your needs.
  52
  53  * run "make" to compile
  54  * run "make install" as root to install
  55
  56  * [optional] run "make doc" to build the ocamldoc
  57  * [optional] run "make install.doc" as root to install the ocamldoc
  58
  59  * run "make uninstall" to uninstall (almost) everything
  60
  61 ------------------------------------------------------------------
  62
  63 Local testings:
  64 ===============
  65
  66  * run "make run.local" of "make run.opt.local"
  67    in the ocsigen source directory.
  68
  69  * open http://localhost:8080/miniwiki in your browser
  70
  71  * if it does not work, look at the logs (see 'local/var/log/' in the
  72    ocsgigen source directory) or run ocsigen with options -v or -V
  73    (verbose and debug mode).
  74
  75  * sources for this example may be found in the directory
  76    'examples/miniwiki'. For a full tutorial, see:
  77
  78       http://ocsigen.org/tutorial
  79
  80     For testsuite, see:
  81
  82       http://localhost:8080/
  83
  84 ------------------------------------------------------------------
  85
  86 Authors:
  87 ========
  88
  89 Vincent Balat
  90  (project leader, Web server, Ocsigenmod, Eliom, Eliom client, Staticmod, XHTML syntax extension, documentation, Ocsimore, extension mechanism, Ocsidbm, Ocsipersist with DBM, ...)
  91 Jérôme Vouillon
  92 (Lwt, Web server, js_of_ocaml, O'Closure, ...)
  93 Boris Yakobowski
  94 (Ocsimore, module Extendconfiguration, Ocsigen server...)
  95 Benjamin Canou
  96 (O'Browser)
  97 Jérémie Dimino
  98 (Lwt)
  99 Raphaël Proust
 100 (Ocsforge, Eliom client, Comet)
 101 Stéphane Glondu
 102 (Configuration file, Findlib integration, access control, HTTP authentication, Debian package, ...)
 103 Gabriel Kerneis
 104 (XHTML syntax extension for OCaml 3.10, Ocsipersist with SQLite, CGI module, forms in Eliom, deflatemod, ...)
 105 Denis Berthod
 106 (HTTP protocol, Web server)
 107 Grégoire Henry
 108 (safe unmarshalling of client data)
 109 Pierre Chambart
 110 (Comet)
 111 Jaap Boender
 112 (Ocsimore, NetBSD and Godi packages)
 113 Gabriel Scherer
 114 (Macaque)
 115 Gabriel Cardoso
 116 (O'Closure)
 117 Jean-Henri Granarolo
 118 (Ocsforge)
 119 Simon Castellan
 120 (HTML5, OpenID, SVG)
 121 Piero Furiesi
 122 (Ocsimore)
 123 Thorsten Ohl
 124 (most of the functions generating XHTML (xML and xHTML modules))
 125 Mauricio Fernandez
 126 (Xhtmlcompact, static linking of extensions and Eliom modules)
 127 Nataliya Guts
 128 (Web server, HTTPS)
 129 Archibald Pontier
 130 (Atom, Pubsubhubbub)
 131 Jérôme Velleine
 132 (CGI module)
 133 Charles Oran
 134 (O'Closure)
 135 Pierre Clairambault
 136 (Lwt_lib, Gentoo package, configure script, ...)
 137 Cécile Herbelin
 138  (HTML5, Benchmarks)