TeX Live

From Gentoo Wiki
Jump to: navigation, search
External resources

TeX Live is a complete TeX distribution with several programs to create professional documents.

Contents

Installation

Install app-text/texlive:

General flags → Information about USE flags
USE flag Default Recommended Description
cjk No No Adds support for Multi-byte character languages (Chinese, Japanese, Korean)
doc No Yes Adds extra documentation (API, Javadoc, etc). It is recommended to enable per package instead of globally
dvi2tty No Yes Add support for dev-tex/dvi2tty to preview dvi-files on text-only devices
dvipdfm No Yes Add support for app-text/dvipdfm to convert DVI files to PDF
extra No Add support for extra TeXLive packages
games No Add typesetting support for games (chess, etc.) (dev-texlive/texlive-games)
graphics No Yes Add support for several graphics packages (pgf, tikz,...)
music No Add support for music typesetting (dev-texlive/texlive-music)
png No Yes Adds support for libpng (PNG images)
pstricks No Yes Add pstricks packages (dev-texlive/texlive-pstricks)
science No Yes Add typesetting support for natural and computer sciences (dev-texlive/texlive-science)
truetype No Yes Adds support for FreeType and/or FreeType2 fonts
xml No Add support for XML files
X No Adds support for X11


Compiler flags → Information about USE flags
USE flag Default Recommended Description
jadetex No Add support for app-text/jadetex (for processing tex files produced by the TeX backend of Jade)
luatex No Add extra support for luatex
xetex No Add support for XeTeX macros (dev-texlive/texlive-xetex)


Misc flags → Information about USE flags
USE flag Default Recommended Description
context No Add support for the ConTeXt format (dev-texlive/texlive-context)
detex No Add support for dev-tex/detex, a filter program that removes the LaTeX (or TeX) control sequences
humanities No Add LaTeX support for the humanities (dev-texlive/texlive-humanities)
omega No Add omega packages (dev-texlive/texlive-omega)
pdfannotextractor No Add dev-tex/pdfannotextractor support, for extracting annotations from PDF files.
publishers No Add support for publishers (dev-texlive/texlive-publishers)
tex4ht No Add support for dev-tex/tex4ht (for converting (La)TeX to (X)HTML, XML and OO.org)
xindy No Add support for app-text/xindy, a flexible indexing system
root # emerge --ask texlive

Usage

Most of the time you will use TeX Live through the editor of your choice. Here a list of the different compiler to translate a .tex document into .pdf.

LaTeX:

user $ pdflatex mydocument.tex

XeTeX:

user $ xelatex mydocument.tex

LuaTeX:

user $ luatex mydocument.tex

Editors

There are several you can choose from in Gentoo. To list a few pure TeX editors:

  • app-editors/kile - KDE based editor, which lets you write in LaTeX code and then compile the document
  • app-office/texmaker - Qt based editor, which lets you write in LaTeX code and then compile the document
  • app-editors/gummi - GTK based editor, which lets you write in LaTeX code and then compile the document
  • app-editors/latexila - Gnome based editor, which lets you write in LaTeX code and then compile the document
  • app-office/lyx - Qt based WYSIWYM editor, you type directly into the LaTeX document and can edit LaTeX code afterwards
  • app-editors/texworks - Qt based editor, suggested editor by the UK-TUG which lets you write in LaTeX code and then compile the document. Can be found in the betagarden overlay as live ebuild.
  • This is by far not a complete list.

Most of the editors support LaTeX syntax highlighting like Vim, app-editors/emacs (which supports compilation and previewing), app-editors/gedit or dev-util/geany and most development IDE's provide some plugins like dev-util/eclipse-sdk and dev-util/netbeans.

Programs with LaTeX support

eselect pdftex

Gentoo would automatically clean out any previous version during upgrade. If you intentionally install several versions into different slots, there is a script that enables you to easily switch between them:

root # emerge --ask app-admin/eselect-pdftex

You can list available distributions with the following command:

root # eselect pdftex list

To set the distribution:

root # eselect pdftex set 1

texdoc

Shows the original TeX documentation by keywords. For example everything about article:

user $ texdoc article

This should open your default pdf viewer and show you the documentation.
In order to use texdoc, you need to have the doc USE flag enabled for TeX Live and any module you want to have documentation about. To enable the doc USE flag on any TeX Live module automatically, you could use a wildcard:

root # echo dev-texlive/* doc >> /etc/portage/package.use

A full list of installed TeX modules can be shown with the following command:

root # qlist -C -I texlive

To enable the doc USE flag only for certain modules, add them to /etc/portage/package.use. A quick way of adding them all:

root # qlist -C -I texlive | sed 's/$/ doc/' >> /etc/portage/package.use
Note
Afterwards you can edit the USE flags for each module in /etc/portage/package.use individually

External resources

Personal tools
Namespaces

Variants
Actions
Gentoo Websites logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Navigation
Toolbox
Categories