Skip to content

Latest commit

 

History

History
75 lines (50 loc) · 2.2 KB

INSTALL.md

File metadata and controls

75 lines (50 loc) · 2.2 KB
Raw

How to Install HTMLDOC from Source

To compile HTMLDOC you'll need C and C++ compilers (clang and gcc are fine) along with the following libraries:

  • FLTK 1.1.x or higher for GUI support
  • CUPS 2.2 or higher for HTTP/HTTPS support
  • libjpeg (7 or higher) or libjpeg-turbo for JPEG support
  • libpng 1.6 or higher for PNG support
  • zlib 1.1 or higher

Windows

Visual Studio + Advanced Installer solutions are included in the "vcnet" directory. The Visual Studio solution uses NuGet packages for all of the dependent libraries, and the current version of Advanced Installer is required to build the installer (MSI) target.

We highly recommend building and installing the HTMLDOC MSI target, as it takes care of registering the installation location with Windows. If you want to install the software by hand, create a directory for the software and copy the HTMLDOC executable, the "fonts" directory, the "data" directory, and the "doc" directory to it so that it looks like this:

C:\Install\Dir\
    htmldoc.exe
    data\
        ... data files ...
    doc\
        ... doc files ...
    fonts\
        ... fonts files ...

Then create the following registry entries with REGEDIT:

HKEY_LOCAL_MACHINE\Software\HTMLDOC\doc = C:\install\dir\doc
HKEY_LOCAL_MACHINE\Software\HTMLDOC\data = C:\install\dir

Linux, macOS, and Other UNIX Platforms

To compile the software under UNIX you first need to run the "configure" script in the source directory. Usually this is just:

./configure

Then run "make" to build the software and generate the documentation:

make

Finally, run "make install" (typically as root) to install the software:

sudo make install

Ubuntu and Debian Notes

You should install the following packages:

sudo apt-get install build-essential autoconf libfltk1.3-dev \
    libcups2-dev libjpeg-dev libpng-dev pkg-config zlib1g-dev

CentOS, Fedora, and RHEL Notes

Install the following packages to get full functionality:

sudo dnf install autoconf fltk-devel cups-devel libjpeg-devel \
	libpng-devel pkgconfig zlib-devel