Skip to content

Commit

Permalink
Updated installation instructions and status.
Browse files Browse the repository at this point in the history
  • Loading branch information
JanWielemaker committed Jul 12, 2024
1 parent 79899af commit 586d351
Showing 1 changed file with 18 additions and 28 deletions.
46 changes: 18 additions & 28 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,36 +13,22 @@ perform the steps below. Installation and usage is tested on Ubuntu
and Fedora. This should work on most Unix-like machines.
Installation on Windows requires more creativity though.



## Installation

1. Install a recent version of Serd. One way of doing this
on Ubuntu is: `sudo apt install libserd-0-0 serdi`

The currently installed version can be found by the command `serdi
-v`. The minimum version of Serd is 0.28.0 (see `hdt-cpp/README.md` or
the `before_install` rule in `hdt-cpp/.travis.yml`).

If that isn't available, it can be installed and built by:
```bash
curl -s http://download.drobilla.net/serd-0.30.0.tar.bz2 | tar -xj && \
cd serd-0.30.0 && \
python2 ./waf configure && \
python2 ./waf && \
sudo ./waf install;
```
### Installing dependencies

You may wish to specify `--prefix=/usr/local` or `--prefix=$HOME/.local`
to `waf configure`.
In addition to the usual development tools such `make` and a C compiler
we need GNU automake and related tools and the RDF base libraries `serd`
and `raptor2`. Below are the dependencies for `apt` based Linux systems
and `rpm` based systems.

You can uninstall by `python2 ./waf uninstall`
For Debian/Ubuntu based systems

2. Install Raptor2.
apt-get install libtool automake autoconf libserd-dev libraptor2-dev

On Fedora: `sudo dnf install raptor2-devel`
For Fedora

On Ubuntu: `sudo apt-get install libraptor2-dev`
dnf install aclocal automake libtool serd-devel raptor2-devel

3. After the prerequisites are installed, the HDT library can be
installed from within Prolog using the following command:
Expand All @@ -51,8 +37,6 @@ You can uninstall by `python2 ./waf uninstall`
?- pack_install(hdt).
```



## Usage

If the installation went well, you can load the HDT library with the following command:
Expand All @@ -62,8 +46,14 @@ If the installation went well, you can load the HDT library with the following c
?- [library(hdt)].
```



## Status

Usable, but still experimental.
The [HDT](https://www.rdfhdt.org/) format is attractive for accessing
large amounts of _background_ RDF data. HDT is the basis for several
companies that provide RDF technology at scale. Unfortunately the public
version of the software is poorly maintained.

This pack is based on our [fork of the
hdt-cpp](https://github.com/JanWielemaker/hdt-cpp). The fork is mostly
the work of Peter Ludemann, fixing several issues with modern C++ and
libraries.

0 comments on commit 586d351

Please sign in to comment.