Installing TEX Live 2013 on Salix OS 14.0.

1 via ISO Image

By gaucho Updated 31 Dec. 2013

Contents
1 2 3 Why Install TEX Live instead of teTEX? Overview of the Process Pre-Installation 2 2 3

3.1
4

Mount the ISO Image on the Temporary Mount Point . . . . . . . Using the Installers Text Mode . . . . . . . . . . . . . . . . . . . Duration of Installation . . . . . . . . . . . . . . . . . . . . . . . .

4
4

Installation Proper

4.1 4.2
5 6

5 6
6 7

Finishing the Installation Post-Installation Conguration

6.1 6.2
7 8 9

Seing the PATH Variable . . . . . . . . . . . . . . . . . . . . . . . Font Conguration for XTEX . . . . . . . . . . . . . . . . . . . . .

7 8
9 10 10

Testing the Installation Deleting the TL ISO Image Additional Goodies to Install

9.1 9.2 9.3 9.4

Editors . . . . . . . . . . . . . . . . . . . . . Fonts . . . . . . . . . . . . . . . . . . . . . . Conguring Texmaker to Display DVI Files A Conguring Geany for L TEX Use . . . . . . .
Abstract

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

10 10 11 11

Installing T EX Live 2013 on Salix OS 14.0.1

ese are notes I made during my installation of TEX Live (hereaer abbreviated TL), using a TL .iso le downloaded from a CTAN mirror on the Internet. I successfully installed TL 2013 on Salix OS 14.0.1 (Xfce and Openbox beta2 versions). is method uses an ISO le which you download to your /home folder, and will then install directlywithout the need for burning it to a DVD. Installing from an ISO disk image is more environmentally friendly than using a one-o optical disc. is procedure is also useful on computers lacking network access (or on netbooks without an optical drive), by saving the .iso le on a USB ash drive and then transferring the ISO to the host computer. e instructions are not 100% complete, so I recommend that you read the TL documentation available on TUGs website in conjunction with this document. I would also like to thank user rsamurti (R.S. Ananda Murthy) for the TL How-to he posted on the Zenwalk Wiki. His article provided some useful tips which I incorporated into this procedure. Disclaimer : Although this procedure may contain a few errors or inaccuracies, it worked for me and I hope it will work for you, too. I do not believe this installation method will break your system; I have been using TEX Live on two dierent Salix systems, and havent experienced any crashes / glitches. Furthermore, the TL installer adopts a distro-neutral, plain vanilla approach. However, please understand that this how-to is presented as is with absolutely no guarantees.

1 Why Install TEX Live instead of teTEX?

omas Esser, the author of teTEX, stopped maintaining it several years ago. teTEX was ocially declared obsolete on 30 Mar. 2007, and moved to the obsolete tree on CTAN. TEX Live is the recommended replacement for teTEX. If you want a more current TEX installation, with a comprehensive collection of add-on packages, and have approximately 2.5 GB of free hard disk space, it is worth the extra eort to install TL.

2 Overview of the Process

In a nutshell, what you will do is to run the built-in install script from the TL ISO and then modify your PATH to make the TL binaries available to your user
e Zenwalk Wiki is currently being revised, so I cannot furnish a valid link to his previous instructions. http://www.mail-archive.com/ctan-ann@dante.de/msg01091.html CTAN (the Comprehensive TEX Archive Network) is the ocial repository where TEX-related material and soware can be found for download.

Installing T EX Live 2013 on Salix OS 14.0.1 account. e general steps are as follows: Download a TL .iso image. Verify its md5sum and sha1sum to ensure that the download is not corrupted. Note: e ISO is a very large le2.4 GB in sizeso be prepared that the download will take a while if you have a non-broadband Internet connection. Save the le to an appropriate location in your /home directory. (In my case, I created a folder named TeX Live 2013 and saved it there). Remove tetex and tetex-doc packages, if you have them installed. Follow the instructions as outlined below to install TL and then do postinstallation conguration and testing.

3 Pre-Installation
First, you need to clean up any existing TEX installations. If you previously installed the tetex and tetex-doc packages, completely remove them with the Gslapt Package Manager. Create a temporary mount point for the TL ISO disk image. Open up a Terminal / Console within your regular user account, issue the command su - and type roots password to acquire root user privileges.
# mkdir /mnt/iso

N.B.: at pound sign (#) as the command prompt is your verication that you are logged in as the root user. It helps to visualize the mount point as a clothes hanger, and the le (our ISO le) as the clothesif you want to hang up your clothes, you need a hanger.
N.B. thats a hyphen used as the command argument. If you want to become the root user, and use its environment variables, you must type su As a comparison, if you just issue the command su (without a hyphen), you will become root but your non-root ( /home) environment variables will remain in place. Also known as the number sign, hash mark and octothorpe, depending on which part of the world you live in. anks to user HacK_MiNDeD for this analogy. For more information, see his article How to Mount ISOs on Linux Using Terminal. 6 Apr. 2011. http://www.hackerslane.com/2011/ how-to-mount-isos-on-linux-using-terminal/

Installing T EX Live 2013 on Salix OS 14.0.1

3.1 Mount the ISO Image on the Temporary Mount Point

Now you can follow these steps: Navigate to the directory where your TL ISO le is located, for example:
# cd /home/david/"TeX Live 2013" root@salix:/home/david/TeX Live 2013# ls texlive2013-20130530.iso*

Note: You need to surround the directory name with quotation marks in order to let the bash shell know that the interword spaces are part of the directory name. Point to the ISO image and tell Linux to mount it on our newly created mount point:
# mount -o loop texlive2013-20130530.iso /mnt/iso

A gloss of this command is:

mount [option flag] [set up loop device] [source] [target directory]
loop: A loop device is a pseudo-device that makes a le accessible as a block device. Loop devices are oen used for CD ISO images. Mounting a le containing a lesystem via such a loop mount makes the les within that lesystem accessible. You will not be able to mount the ISO without the loop function. ese preliminary steps will allow us to run the TL install script shortly.

4 Installation Proper
In general, we will use the ick Install instructions from TUGs website as a guideline:
-o loop Your TL .iso le. e temporary mount point we just created. How to: Mount an ISO image under Linux, NixCra, 11 Dec. 2008. cyberciti.biz/tips/how-to-mount-iso-image-under-linux.html.

http://www.

Installing T EX Live 2013 on Salix OS 14.0.1

http://www.tug.org/texlive/quickinstall.html TEX Live ick Install.

e full-length guide (for TEX Live 2013) can be read here:

http://www.tug.org/texlive/doc/texlive-en/texlive-en.html Berry, Karl, ed. e TEX Live Guide 2013. May 2013.

All commands below were issued by / (root) rather than a normal user. Follow these steps: Navigate to your newly created directory / mount point:
# cd /mnt/iso

Issue the ls (list) command to show you the directorys contents:

root@salix:/mnt/iso# ls LICENSE.CTAN archive/ install-tl-advanced.bat* release-texlive.txt tlpkg/ LICENSE.TL autorun.inf install-tl.bat* source/ README index.html readme-html.dir/ texlive-doc/ README.usergroups install-tl* readme-txt.dir/ tl-tray-menu.exe*

4.1

Using the Installers Text Mode

We will use the Installers text mode to install TL 2013. Now you are ready to run the installer script (install-tl). Type
./install-tl

(Do not forget the initial period (.) before the forward slash). From the text menu, select the o command, then p, to change the default paper size (if you are a North American who uses leer-size paper rather than A4. A4 is commonly used in Europe and in most locations outside North America). Type the leer r to return to the main menu.

Installing T EX Live 2013 on Salix OS 14.0.1 If you wish to bypass the need for manually changing the PATH, as discussed in Section 6.1, you have the option here of selecting Create symlinks in system directories. I have never tried this option myself, but two A members of the L TEX Community Forum noted that it works and that it will auto-congure your PATH. Type the leer i (for i(nstall)) to begin the installation.

4.2 Duration of Installation

On my desktop PC, it took 6 minutes to completely install the TL packages. Installation time was approximately 16 minutes on my netbook. e script will install 2691 packages in alphabetical order, beginning with 12many and 2up, and ending with zxjafont and zxjatype. At the end of the installation, you should see this message:
TeX Live is a joint project of the TeX user groups around the world; please consider supporting it by joining the group best for you. The list of user groups is on the web at http://tug.org/usergroups.html. Add /usr/local/texlive/2013/texmf-dist/doc/man to MANPATH, if not dynamically found. Add /usr/local/texlive/2013/texmf-dist/doc/info to INFOPATH. Most importantly, add /usr/local/texlive/2013/bin/i386-linux to your PATH for current and future sessions. Welcome to TeX Live! Logfile: /usr/local/texlive/2013/install-tl.log

5 Finishing the Installation

Aer the install script nishes, you should now unmount the ISO le:
# cd # umount /mnt/iso

N.B.: e command is umount (unmount without the rst leer n).

I would like to thank members frabjous and sommerfee for clarifying this. AMD Athlon II X2 240 (Regor) 2.8 GHz, 4 GB RAM. HP Mini 210 with Intel Atom N455 CPU, 1.66 GHz, 2 GB RAM.

Installing T EX Live 2013 on Salix OS 14.0.1 Next, remove the directory you created at the beginning of the installation process.
# rmdir /mnt/iso

Be careful to not delete the /mnt directory, as it is one of Linuxs standard subdirectories.

6 Post-Installation Configuration
6.1 Seing the PATH Variable
When installation is complete, you must add the TEX Live binary directory to your PATH, if you did not select the option to Create symlinks in system directories when you began the installation process. (See Subsection 4.1 for details). I found that the method posted in the Zenwalk Wiki worked well. Its author, rsamurti (R.S. Ananda Murthy), proposes creating a small shell script and placing it in the /etc/profile.d directory. Heres how we accomplish that: From within your regular user account, use your favorite text editor (e.g., Geany, nano, vi, Emacs) to create a le called texlive.sh Paste these two lines into it, and save the le in your /home directory:
export PATH=$PATH:/usr/local/texlive/2013/bin/i386-linux export MANPATH=$MANPATH:/usr/local/texlive/2013/texmf-dist/doc/man

Make texlive.sh executable by typing this command:

$ chmod a+x texlive.sh

Become root ( su - ) and move the texlive.sh le into the /etc/profile.d directory:
# mv texlive.sh /etc/profile.d

A change in the PATH variable does not take eect immediately, so log out of your account, completely reboot your system and log back in.

Installing T EX Live 2013 on Salix OS 14.0.1 Finally, issue the command: # texhash
david[~]$ su Password: root@salix:~# texhash texhash: Updating /usr/local/texlive/2013/../texmf-local/ls-R... texhash: Updating /usr/local/texlive/2013/texmf-config/ls-R... texhash: Updating /usr/local/texlive/2013/texmf-dist/ls-R... texhash: Updating /usr/local/texlive/2013/texmf-var/ls-R... texhash: Done.

Check your PATH to verify that it now includes the TL binaries:

david[~]$ echo $PATH /usr/local/bin:/usr/bin:/bin:/usr/games:/usr/lib/java/jre/bin:/usr/lib/qt/bin: /usr/local/texlive/2013/bin/i386-linux:.

6.2 Font Configuration for XETEX

When tested according to the TL Web documentation, I got an error message saying ``Invalid fontname `Latin Modern Roman/ICU' ... '' So I needed to congure my system so that XTEX could nd the fonts shipped with TEX Live. is is accomplished by conguring the texlive-fontconfig.conf le. In TL 2013, this le resides within the directory:
/usr/local/texlive/2013/texmf-var/fonts/conf/

As root user, you will be copying this le to the /etc/fonts/conf.d directory and simultaneously renaming the le 13-texlive.conf.
root@salix:~# cd /usr/local/texlive/2013/texmf-var/fonts/conf root@salix:/usr/local/texlive/2013/texmf-var/fonts/conf# ls conf/ texlive-fontconfig.conf root@salix:/usr/local/texlive/2013/texmf-var/fonts/conf# cp texlive-fontconfig.conf /etc/fonts/conf.d/13-texlive.conf

Now you must run the fc-cache -fv command:

# fc-cache -fv

It returns the following results: 8

Installing T EX Live 2013 on Salix OS 14.0.1

[ ... ] /usr/local/texlive/2013/texmf-dist/fonts/type1/wadalab/mr2j: caching, new cache contents: 23 fonts, 0 dirs /usr/local/texlive/2013/texmf-dist/fonts/type1/wadalab/mrj: caching, new cache contents: 34 fonts, 0 dirs /var/cache/fontconfig: cleaning cache directory /root/.fontconfig: not cleaning non-existent cache directory fc-cache: succeeded

If we test the XTEX font conguration now (from our regular user account), it should pass and produce a PDF le:
david[~]$ xetex opentype-info.tex This is XeTeX, Version 3.1415926-2.5-0.9999.3 (TeX Live 2013) restricted \write18 enabled. entering extended mode (/usr/local/texlive/2013/texmf-dist/tex/xetex/xetexfontinfo/opentype-info.tex [1] [2] ) Output written on opentype-info.pdf (2 pages). Transcript written on opentype-info.log.

7 Testing the Installation

All the tests suggested in the TL online guide passed. Some sample tests are:
$ tex --version TeX 3.1415926 (TeX Live 2013) kpathsea version 6.1.1 Copyright 2013 D.E. Knuth. There is NO warranty. Redistribution of this software is covered by the terms of both the TeX copyright and the Lesser GNU General Public License. For more information about these matters, see the file named COPYING and the TeX source. Primary author of TeX: D.E. Knuth. $ $ $ $ latex sample2e.tex xdvi sample2e.dvi pdflatex sample2e.tex atril sample2e.pdf

Installing T EX Live 2013 on Salix OS 14.0.1 Note: TL 2013 installs the xdvi viewer as part of its default routine. Apparently, Atril requires a plug-in to display DVI les. I received an error message when I tried opening a DVI with Atril. Section 9.3 provides info on changing Texmakers conguration so that it uses xdvi instead of Atril.

8 Deleting the TL ISO Image

Once you have veried that the base TL system is working properly, to save disk space you will probably want to delete the ISO le and its directory:
$ rm -Rf "TeX Live 2013"

9 Additional Goodies to Install

You might consider installing these programs / packages to have a more pleasant experience using TEX and its friends.

9.1 Editors
A Texmaker A L TEX editor with a friendly, easy-to-use GUI. e version available

(via Sourcery) in the Salix repos is 4.0.4.

TeXworks Another TEX editor with a user-friendly GUI, modeled on Dick Kochs

TeXShop for Mac OS X. You can use Sourcery to install version 0.4.4. Note: You rst need to install the hunspell package via Gslapt for TeXworks to build successfully.
A and has a L TEX plugin available. (See Subsection 9.4 for additional tips).

Geany Although it lacks some of Texmakers bells and whistles, it is quite capable

9.2 Fonts
Fonts are a subjective area, but Ive found that installing some dierent fonts can spice up your typographic life.
gentium-font An attractive, open-source serif typeface designed by Victor Gaultney. Works well with documents in XTEX (or LibreOffice). (This paragraph uses the Gentium typeface).
e xdvi binary is located in /usr/local/texlive/2013/bin/i386-linux/. Unable to open document. File type TeX DVI document (application/x-dvi) is not supported.

10

Installing T EX Live 2013 on Salix OS 14.0.1

linux-libertine-fonts Another nice open-source serif typeface, designed by Philipp

Poll as an alternative to Times Roman. (is documents primary font is Linux Libertine.)
SIL fonts SIL International has several nice fonts which are freely download-

able: Charis SIL (similar to Bitstream Charter), Doulos SIL (very similar to Times / Times New Roman) and Andika (a sans serif font designed especially for literacy use).
How quickly daft jumping zebras vex. (Charis SIL sample)

How quickly daft jumping zebras vex. (Doulos SIL sample)

How quickly daft jumping zebras vex. (Andika sample)

It is simple to manually install fonts from outside Salixs repositories. If you wish to install a particular font for all users, then move / copy it into the /usr/share/fonts/TTF directory. If you want it available for your user only, place it in the /.fonts directory. When you nish, you must update the font database by becoming root user and typing the command # fc-cache -fv.

9.3 Configuring Texmaker to Display DVI Files

In order to get Texmaker to display DVIs with the xdvi viewer, you need to make a change in its Conguration options:
Options > Configure Texmaker > Commands tab > Dvi Viewer: xdvi %.dvi Figure 1 is a screenshot of this conguration.
A 9.4 Configuring Geany for L TEX Use

anks to some online tips I found, it is possible to further customize Geany for A use with L TEX. Figure 2 illustrates where such custom commands are added. Under Build > Set Build Commands:
LaTeX > DVI LaTeX > PDF Clean rm "%e".log "%e".aux Make Make Custom Target Make Object XeLaTeX xelatex --file-line-error-style "%f"

11

Installing T EX Live 2013 on Salix OS 14.0.1

Figure 1: Options for conguring Texmaker.

12

Installing T EX Live 2013 on Salix OS 14.0.1 Note: In order to use Geanys Preview feature, you will rst have to install the xterm package.

A Figure 2: Adding extra L TEX-related options to Geany.

I hope this compilation will be helpful for anyone considering installing TL 2013 on their system. Good Luck and Happy TEXing in 2014!

A Typeset with XTEX using the L TEX macro package.

13