Compiling TeXmacs from the source code

On this page, we explain how to compile TeXmacs from the source code on Unix-like system, including MacOS and Windows with Mingw or Cygwin. In the case of Windows, you may first want to install the appropriate build environment and follow our instructions for compilation under Windows.

1.Verify the TeXmacs dependencies

Before you install TeXmacs on your system, you have to make sure that the other programs on which TeXmacs depends, namely:

Qt

A cross-platform library for the development of user interfaces.

Guile

The GNU implementation of Scheme, which is used as an extension language.

Freetype2

A library for font rendering.

Some other softwares that you might wish to install for more functionality and better performance are Ghostscript, Aspell, Libiconv, Netpbm and ImageMagick.

2.Download and unpack the source code

Download the latest version

Download the latest version of the source code, or the latest stable version, cd into the directory where you wish to compile TeXmacs and type

tar -zxvf TeXmacs-1.0.7.19-src.tar.gz

All files will be unpacked into the directory TeXmacs-1.0.7.19-src, which is the 'installation directory'.

Download the current development version

Since TeXmacs-1.0.7.1, the development of TeXmacs is done using the Subversion concurrent versioning system. In order to download the current SVN version of TeXmacs in read-only mode, you should do

    svn co svn://svn.savannah.gnu.org/texmacs/trunk/src

Notice that you may also browse the current TeXmacs sources on the web. The TeXmacs website and other things are also maintained by SVN; just replace src by web or misc in the above checkout.

In order to commit changes by SVN, you first need a user account on Savannah and send a request to join the TeXmacs developers team. You may then check out and commit changes as described on the subversion page for TeXmacs. You may also use Savannah in order to submit patches to TeXmacs. A Git mirror of the main Subversion repository is maintained at Gitorious.

3.Compile, install and run

TeXmacs supports the standard GNU compilation and installation procedure. Assuming that you logged yourself in as root, cd into the installation directory and type

./configure
make
make install

The first command examines your particular system configuration. The second command launches the compilation. The last command installs TeXmacs in /usr/local.

If everything works fine, you should be able to run TeXmacs by

texmacs &

If this does not work, you should make sure that /usr/local/bin is in your PATH. Depending on your shell, you can ensure this by typing

export PATH=/usr/local/bin:$PATH

or

setenv PATH /usr/local/bin:$PATH

4.Configuration and build options

If you cannot log yourself in as root, or if you want to install TeXmacs elsewhere than in /usr/local, then you should use

./configure --prefix=[target directory]

instead of ./configure. In this case, TeXmacs will be installed in [target directory] and you will have to set your PATH accordingly, as to contain [target directory]/bin.

The configuration method

./configure --disable-qt

allows you to build the historical X11 version of TeXmacs instead of the Qt-based version. For more configuration options, type ./configure –help.

By default, we build TeXmacs using dynamically linked libraries. If you rather want to build the static version, use

make STATIC_TEXMACS

For more build methods, please look at the Makefile.

5.Happy TeXmacs-ing!

If you like the program, then please consider donating money or services to us. Of course, you may also contribute yourself. In case of problems, please subscribe to the texmacs-dev or texmacs-users mailing lists and ask your questions there. You may also directly contact us, but you might need to be more patient.