TeXLive

From TorontoMathWiki

Jump to: navigation, search

Contents

Status

  • Current version of TeXLive is TL'2013.

On coxeter

Intro

Until August 2013 I (Victor) was responsible for maintaining it on coxeter. Usually I ran updates at nights (they require only few minutes usually).

Setting up:

  • Open in your home directory .tcshrc or .cshrc or .bashrc (dunno what you have) and add to the path
/usr/local/texlive/current/bin/x86_64-linux 

before /usr/bin

(it is symlink to /usr/local/texlive/2013/bin/x86_64-linux)

    • If your path is not set in this file you can insert in it
setenv PATH "/usr/local/texlive/current/bin/x86_64-linux:${PATH}"
    • If you have a reference to TeXLive < 2013 just modify it
    • Now if you log again commands tex, latex, pdftex, pdflatex and other companion commands would call TeXLive 2013.

Remark In its infinite wisdom RedHat Linux instead of adding directory containing TeX executables to the path created symlinks from /usr/bin.

Asymptote

In TL2012 asy did not run as it had problems with some libraries on coveter. Not anymore in TL2013! Current version 2.23 (not 1.47 supplied by RHEL)

Using:

  • Exactly as before, except more packages is available and they are newer (and updating); but there is a new feature synctex. Running from terminal
 % pdflatex -synctex=1

(or latex, tex, pdftex) you activate it. If your viewer and editor are synctex compatible, special click (Command-click with TeXShop on MacOSX) on some place on the source show the corresponding place in the output and v.v.

  • The easiest way to activate all new features with TeXShop is to trash ~/Library/TeXShop (it will regenerate); however you may have special scripts and think how preserve them.
    • Remark: on Lion (Mac OSX 10.7+) ~/Library/ is hidden.

Getting help:

Getting help is much easier:

  • Type in xterm (or terminal)
 % texdoc <name>

and the corresponding help file will be found (or if there is no exact matched texdoc will attempt to guess) and the corresponding viewer will be launched to display it.

 % texdoc texdoc 

gives you help for texdoc itself; and texdoc has few useful switches

 % texdoc -m
 % texdoc -l
 % texdoc -s
    • You can customize which viewers should be used for pdf, dvi, ps, html etc files (now almost all docs are in pdf):

In you home directory make subdirectory texmf and in it make subsubdirectory texdoc; create here file texdoc.cnf looking for

/usr/local/texlive/20101/texmf/texdoc/texdoc.cnf

for inspiration (it is self-explanatory)

  • Alternative help system: type in xterm
% texdoctk</p>

Remark:

  • It can happen that some package is not in TeXLive. There could be many reasons (from "TeXLive team missed it" to "there are legitimate reasons not to put it"). You can ask me: I will ask TL team (they listens users requests) and if they can they will put it in TL; if they cannot they will explain why and then I will put this package manually into /texmf-local TDS tree (explanations below)

Installing:

Updating:

  • type in terminal as a root:
% tlmgr update --all

or

% sudo tlmgr update --all

and enter password when prompted.

  • Be patient: it may take some time depending on the magnitude of update and server load.
  • It may request to run
% tlmgr update --self

or

% sudo  tlmgr update --self

before advancing further For more details type:</p>

% tlmgr --help

or

% texdoc tlmgr
  • There are actions and options which do not require root user and they could be useful for anyone (actions search, show):
% tlmgr show pgf

(for example)

  • On Mac OSX 10.5+one can use TeXLive Utility (in /Applications/TeX folder)

Installing extra packages

(which are not part of TeXLive) There are two ways to install:

  • TL201x installs everything into /usr/local/texlive/201x and you should not install anything else there.

As root user for everyone:

You may install into texmf-local TDS (TeX Directory Structure) tree; TL installer creates but not populates it:

% cd /usr/local/texlive/texmf-local

and put LaTeX .sty and .def files into directories created in

/usr/local/texlive/texmf-local/tex/latex

while document files for them into corresponding directories in

/usr/local/texlive/texmf-local/doc/latex

(but you need to understand what you are doing, read instructions, especially if distribution is not in tds form). Finally run

% sudo texhash

(actually texhash is an alias to mktexlsr)

As an ordinary user for yourself:

(works on coxeter too) Exactly as a root but into your personal TDS:

~/texmf

on generic Unix/Linux and into

~/Library/texmf

on MacOSX where it is a good idea to create a symlink

~/texmf ->  ~/Library/texmf 

(some general Unix software compiled for MacOSX may want it)

  • You do not need to run texhash.

X11 Gui:

To enable texdoctk and tlmgr --gui one need Tk.pm (Perl module). On MacOSX find /Applications/TeX/Utilities/TeX Live Manager/Tk-804.028.pkg which is installer; on other systems you need to compile it from the source

Using:

exactly as on coxeter but on your platform nice front ends may be available (not discussing them)

Personal tools