TeX Live

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

Emerge
Install :

Upgrading
When users try to upgrade TeXLive, they'll meet a failure due to "hard blocking". Here are a solution to overcome it and the reasons behind it.

Solution
First you need to unmerge some packages in :

Now you can upgrade:

Or simply pull in "world":

Why this workaround?
Some packages (see below) do "hard blocking". For example, hard-blocks, i.e., older versions of itself. Hard-blocked packages can't be installed simultaneously, even temporarily. But as of 2017, portage can't resolve hard blocks automatically, and users must handle them manually. They are hard instead of normal blocks because of some file moves. 

Thus, to upgrade, users must first unmerge it manually using the above procedure.

Some more details
Although some language packs have only 2012 versions (e.g. ), even for them the above solution (re-emerging them afterwards) works, too. It's because blocking in an ebuild file is in fact one-sided, unlike normal dependency, which is checked at "emerge --depclean": Assume contains, and  has no dependency. Then:


 * if you already have, then "emerge virtual/src" will fail. However,
 * even if you already have, "emerge cat/dest" is allowed.

Hard blocking is specified in ebuilds by the operator. As of 2017, the only ebuilds using the operator (in our context) are, , and. Packages blocked by them are these three themselves plus.

Usage
Most of the time users will implement TeX Live through the editor of choice. The following is a list of compilers capable of translating a document into  file:

LaTeX:

XeTeX:

LuaTeX:

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

Most editors support LaTeX syntax highlighting like Vim, emacs (which supports compilation and previewing), gedit or gleany and most development IDE's provide some plugins like.

Programs with LaTeX support

 * - has a LaTeX plugin to display mathematical formulae.
 * - has a LaTeX plugin for inserting formulae in mind maps.

Find the Gentoo package that contains a tex package
contains a program to search for the Gentoo package containing a TeX package. For example, texmfind bbm.sty returns.

eselect pdftex
Gentoo would automatically clean out any previous version during upgrade. In order to intentionally install several versions into different slots a script exists that enables easy switching:

List available distributions with the following command:

To set the distribution:

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

This should open the default PDF viewer with the documentation.

In order to use the command, the   USE flag enabled for TeX Live and any other module which users would like documentation available.

To enable the  USE flag on any TeX Live module automatically, use a wildcard:

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

To enable the  USE flag only for certain modules, add them to. A quick way of adding them all is by running this command:

External resources

 * Wikibooks LaTeX