Index of /ctan/support/intex/
Name | Last Modified | Size | Type |
../ | | - | Directory |
bin/ | 2013-Mar-12 11:00:32 | - | Directory |
dist/ | 2013-Mar-12 11:00:43 | - | Directory |
doc/ | 2013-Mar-12 11:00:41 | - | Directory |
latex/ | 2013-Mar-12 11:00:32 | - | Directory |
lib/ | 2013-Mar-12 08:49:44 | - | Directory |
src/ | 2013-Mar-12 11:00:35 | - | Directory |
AUTHORS | 2013-Mar-12 08:49:44 | 0.1K | application/octet-stream |
COPYING | 2013-Mar-12 08:49:44 | 34.3K | application/octet-stream |
ChangeLog | 2013-Mar-12 09:20:59 | 15.9K | application/octet-stream |
INSTALL | 2013-Mar-12 08:49:44 | 9.2K | application/octet-stream |
MANIFEST | 2013-Mar-12 11:00:41 | 0.4K | application/octet-stream |
MANIFEST.in | 2013-Mar-12 08:49:44 | 0.1K | application/octet-stream |
Makefile | 2013-Mar-12 11:00:32 | 23.4K | text/x-makefile;charset=utf-8 |
Makefile.am | 2013-Mar-12 08:49:44 | 1.2K | application/octet-stream |
Makefile.in | 2013-Mar-12 10:59:53 | 23.0K | application/octet-stream |
NEWS | 2013-Mar-12 08:49:44 | 0.0K | application/octet-stream |
README | 2013-Mar-12 10:01:25 | 3.6K | text/plain;charset=utf-8 |
README.md | 2013-Mar-12 10:01:25 | 3.6K | text/markdown;charset=utf-8 |
RELEASE | 2013-Mar-12 09:22:44 | 0.1K | application/octet-stream |
TODO | 2013-Mar-12 08:49:44 | 2.0K | application/octet-stream |
aclocal.m4 | 2013-Mar-12 08:49:44 | 30.1K | application/octet-stream |
config.log | 2013-Mar-12 11:00:32 | 6.4K | text/plain;charset=utf-8 |
config.status | 2013-Mar-12 11:00:32 | 25.8K | application/octet-stream |
configure | 2013-Mar-12 09:22:30 | 105.0K | application/octet-stream |
configure.ac | 2013-Mar-12 08:49:44 | 0.4K | application/vnd.nokia.n-gage.ac+xml |
install_latest_release.sh | 2013-Mar-12 08:49:44 | 0.1K | application/x-sh |
pack_next_release.sh | 2013-Mar-12 08:49:44 | 0.1K | application/x-sh |
release.sh | 2013-Mar-12 08:49:44 | 0.1K | application/x-sh |
rewritten.itx | 2013-Mar-12 08:49:44 | 2.8K | application/octet-stream |
setup.cfg | 2013-Mar-12 11:00:32 | 0.2K | application/octet-stream |
setup.cfg.in | 2013-Mar-12 08:49:44 | 0.2K | application/octet-stream |
setup.py | 2013-Mar-12 11:00:32 | 2.1K | application/octet-stream |
setup.py.in | 2013-Mar-12 08:49:44 | 2.1K | application/octet-stream |
template.itx | 2013-Mar-12 08:49:44 | 0.2K | application/octet-stream |
test.itx | 2013-Mar-12 08:49:44 | 5.9K | application/octet-stream |
InTeX for LaTeX
===============
About
-----
InTeX is a package that adds functionality to LaTeX that eases
typesetting and indexing of phrases, acronyms, and proper names in a
consistent manner throughout documents of arbitrary length.
`mkintex(1)` is a preprocessor that interprets index entries specified
in `.itx` files and generates appropriate entries for LaTeX and `makeindex(1)`.
Installation
------------
From source:
$ git clone https://github.com/mtr/intex.git
$ cd intex
$ automake --add-missing
$ autoconf
$ configure
$ make
Create a deb package:
$ make deb
Install deb package:
$ dpkg --install dist/intex_1.8.0-1_all.deb
Or, you may also install directly from source:
$ make install # might need a sudo
For furhter information about how to install this package, please consult the
file INSTALL, located in the top directory of the package.
Usage
-----
The `mkintex(1)` command takes the following options:
--version
show program's version number and exit
-h, --help
show this help message and exit
-D, --debug
whether or not to output debug information
-V, --verbose
whether or not to output verbose information
-I, --only-build-index
only build the internal model of the index
-O <file>, --ito-file=<file>
output the new internal InTeX information to <file> (default:
none)
-o <file>, --index-file=<file>
output the new indexing information to <file> (default: none)
-a <file>, --acrodef-output=<file>
output acronym definitions to <file> (default: none)
-p <file>, --persondef-output=<file>
output (person) name definitions to <file> (default: none)
Examples
--------
Let us assume that you have already written a `latex(1)` document,
named `<document_name>.tex`, that uses the `InTeX(5)` package.
Furthermore, we assume that you have defined a set of concepts,
acronyms, and proper nouns for indexing in a file named
`<document_name>.itx`. Then, to run this program the standard way,
first process the document with `latex(1)` (or `pdflatex(1)`) by
issuing the command
latex <document_name>
This will process the document once and generate both a DVI file
(`<document_name>.dvi`)---or a PDF file (`<document_name>.pdf`)---and
an auxiliary file (`<document_name>.aux`).
Next, run the `mkintex(1)` program
mkintex <document_name> --index-file=<document_name>.rix
that will use as input both `<document_name>.aux` and
`<document_name>.itx` to produce two new output files. The first file
is `<document_name>.ito`, which will be used by `latex(1)` in
following compilations of `<document_name>.tex`, and
`<document_name>.rix`, which will be used by `makeindex(1)` to produce
a proper index for LaTeX to typeset:
makeindex -o intex.rid intex.rix
After that, we have to run `latex(1)` again to generate a version of the
document with the defined concepts, acronyms, and proper names properly
typeset and indexed:
latex <document_name>
Please note that in the examples above, `<document_name>` is the name
of the main LaTeX document, without the `.tex` ending.
For more information and examples of how to use the `InTeX(5)`
`LaTeX(1)` package, please see the file
[latex/intex.pdf](https://github.com/mtr/intex/blob/master/latex/intex.pdf?raw=true).
You may also consult the `mkintex(1)` man page.
Licensing
---------
For information about this package's license, please see the file
COPYING in the top directory of the package.
-- Martin Thorsen Ranang, 2013-03-12