We recommend installing Links using the OPAM tool, available from opam.ocaml.org.
Links requires at least OCaml 4.06.0 to build and install. Therefore you should first install the minimum (or greater) required version of OCaml:
$ opam switch install 4.06.0
If you wish to use Links' database functionality, you should first install PostgreSQL, the supported DBMS.
You can then install Links simply by issuing the command:
$ opam install postgresql links
Alternatively, if you don't have PostgreSQL installed then do:
$ opam install links
This will put Links and its files into your OPAM switch. The
$OPAM_SWITCH_PREFIX points to your current
active switch. Links files install to several locations inside an OPAM
- The executable is called
linxand goes into
- The example Links programs go into
- Links configuration file goes into
Links supports running applications via a standalone application server.
Examples (without a database)
To run the examples that don't use the database with the Links application server issue the following command:
$ linx --path=$OPAM_SWITCH_PREFIX/share/links/examples --path=$OPAM_SWITCH_PREFIX/share/links/examples/games $OPAM_SWITCH_PREFIX/share/links/examples/webserver/examples-nodb.links
(This version just displays the source code for examples that use the database.)
The default port is 8080, so you should now be able to access the examples by pointing your browser at:
Examples (with a database)
To run the examples using the Links application server issue the following command:
$ linx -m --path=$OPAM_SWITCH_PREFIX/share/links/examples --path=$OPAM_SWITCH_PREFIX/share/links/examples/games --path=$OPAM_SWITCH_PREFIX/share/links/examples/dictionary $OPAM_SWITCH_PREFIX/share/links/examples/webserver/examples.links
--pathoption tells Links to look for source files in the following directories under
- Finally examples/webserver/examples.links is the file to run, which imports the example modules and sets up the application server.
But first you need to do a few things.
By default Links uses a config file inside
--config=/custom/config/fileoption to use a different configuration file.
To use database examples you need to add a database configuration to the config file:
The database user fred should exist. With postgres, perhaps the easiest way to do this is to tie fred to your unix username and then no separate authentication is required.
Create appropriate databases. If you are using postgres and you have tied your username to the database as described in 2) then you can use the scripts in examples/dbsetup.
$ cd examples/dbsetup ./createdbs ./populatedbs
Otherwise you can adapt them to your particular database set up.
Postgres data dumps for the larger databases (citations and dictionary) can be obtained from a separate repository: https://github.com/links-lang/links-data.
For convenience you may want to add the
path to the config file
Then simply issue the following command to run the database examples application:
$ linx $OPAM_SWITCH_PREFIX/share/links/examples/webserver/examples.links
Some (outdated) documentation can be built by running the Makefile in the doc directory.
Some very incomplete documentation is available on the links wiki: