Beyond Linux® From Scratch - Version 7.9

Chapter 55. Typesetting

xindy-2.5.1

Introduction to xindy

Xindy is an index processor that can be used to generate book-like indexes for arbitrary document-preparation systems. This includes systems such as TeX and LaTeX, the roff-family, SGML/XML-based systems (e.g., HTML) that process some kind of text and generate indexing information.

This package is known to build and work properly using an LFS-7.9 platform.

Package Information

Xindy Dependencies

Required

Clisp-2.49, texlive-20150521

User Notes: http://wiki.linuxfromscratch.org/blfs/wiki/xindy

Installation of xindy

Install xindy by running the following commands: 

export TEXARCH=$(uname -m | sed -e 's/i.86/i386/' -e 's/$/-linux/') &&
sed -i "s/ grep -v '^;'/ awk NF/" make-rules/inputenc/Makefile.in &&
./configure --prefix=/opt/texlive/2015              \
            --bindir=/opt/texlive/2015/bin/$TEXARCH \
            --datarootdir=/opt/texlive/2015         \
            --includedir=/usr/include               \
            --libdir=/opt/texlive/2015/texmf-dist   \
            --mandir=/opt/texlive/2015/texmf-dist/doc/man &&
make LC_ALL=POSIX

This package does not have a testsuite.

Now, as the root user: 

make install

Command Explanations

--prefix=, --bindir=, --datarootdir=, --infodir=, --mandir= ... : these switches ensure that the files installed from source will overwrite any corresponding files previously installed by install-tl-unx so that the alternative methods of installing texlive are consistent..

sed -i "s/ grep -v '^;'/ awk NF/" ...: The build sorts files in latin{1..3} encodings to create latin.xdy, and unicode versions of these to create utf8.xdy after using grep -v '^;' to remove blank lines. With grep-2.23 any data not in the expected encoding is treated as binary, resulting in a useless file. This command uses an alternative way of removing blank lines.

--includedir=/usr/include: This parameter ensures that the kpathsea headers from texlive-20150521 will be found.

make LC_ALL=POSIX: with the current version of coreutils it is essential to build xindy in the POSIX (or C) locale because in a UTF-8 locale the file latin.xdy will contain only a heading and then a line 'Binary file (standard input) matches' instead of the many lines of lisp merge-rule commands it ought to contain.

Contents

Installed Programs: tex2xindy, texindy, xindy
Installed Libraries: None
Installed Directory: /opt/texlive/2015/texmf-dist/xindy

Short Descriptions

tex2xindy

transforms a LaTeX index file into a xindy raw index file.

texindy

is a wrapper for xindy that turns on many LaTeX conventions by default.

xindy

creates a sorted and tagged index from a raw LaTeX index.

Last updated on 2016-02-27 13:58:54 -0800