Installing LaTeX on Gentoo
In this document I am going to write exactly what I did to install TeX Live and the Garamond font so that I could compile the CV on this website.
Installing LaTeX (TeX Live)
Well, this was easy:
emerge texlive-latex
Next I installed some fonts, texlive-fontsrecommended is not
strictly required here but texlive-fontsextra is required for
mathdesign. Finally dvipdfm is required to convert
a DVI file generated with the latex command into a
PDF believe it or not!
emerge texlive-fontsrecommended emerge texlive-fontsextra emerge dvipdfm
When I talk about compilation I mean that I have tried to create a
.dvi file from my .tex source. I do this by running
the command:
latex cv.tex
The compilation failed at this point with an error message stating that it could
not find sectsty.sty...
! LaTeX Error: File `sectsty.sty' not found.
This is apparently available in
texlive-latexextra, unfortunately that has a lot of dependencies
(including ruby) which I did not want on my system.
Installing sectsty.sty as the Current User
Note: The texmf directory I refer to in the
following sections can be
overridden by changing the environment variable $TEXMFHOME. You can what the
correct directory is by running this command: kpsewhich
-var-value=TEXMFHOME.
I remembered in the deep dark past that I had a problem like this before and
remembered that I could install some files in ~/texmf so I went off in
search of sectsty.sty. Naturally that file is not available, you have
to compile it from a .ins file, download the three files from CTAN into
a temporary directory and run this:
latex sectsty.ins
You don't need the .pdf really but it tells you about the package
As the comments say it just preprocesses the file and creates a .sty
for you to put into your texmf directory.
In your home directory make the directory texmf and in this
make the directories tex/latex/sectsty and put
sectsty.sty in the top level.
mkdir -p ~/texmf/tex/latex/sectsty cp sectsty.sty ~/texmf/tex/latex/sectsty/
Compilation will work now with latex you will not be able to
make a PDF though because you have not got the right fonts.
Cannot find font file ugmr8a.pfb grep: ugmr8y.log: No such file or directory mktexpk: `gsftopk ugmr8y 1244' failed to make ugmr8y.1244pk. kpathsea: Appending font creation commands to missfont.log. ugmr8y: Can't locate a Type 1, TTF, PK, or virtual font file
To correct this we need to install the Garamond font
Installing Garamond
This was the most difficult part, I had no clue and the documentation is really not good :-(
It turns out that this is quite simple. Most of the hard work has been done for you already, it just requires a little reorganisation. Below is a list of the files in the correct directories, I downloaded these from CTAN:
# the texmf directory for Garamond doc/ doc/fonts/ doc/fonts/urw/ doc/fonts/urw/garamond.txt dvips/ dvips/config/ dvips/config/ugm.map fonts/ fonts/vf/ fonts/vf/urw/ fonts/vf/urw/garamond/ fonts/vf/urw/garamond/ugmri8c.vf fonts/vf/urw/garamond/ugmri8t.vf fonts/vf/urw/garamond/ugmm8c.vf fonts/vf/urw/garamond/ugmm8t.vf fonts/vf/urw/garamond/ugmr8c.vf fonts/vf/urw/garamond/ugmr8t.vf fonts/vf/urw/garamond/ugmmi8c.vf fonts/vf/urw/garamond/ugmmi8t.vf fonts/afm/ fonts/afm/urw/ fonts/afm/urw/garamond/ fonts/afm/urw/garamond/ugmm8a.afm fonts/afm/urw/garamond/ugmmi8a.afm fonts/afm/urw/garamond/ugmri8a.afm fonts/afm/urw/garamond/ugmr8a.afm fonts/map/ fonts/map/vtex/ fonts/map/vtex/ugm.ali fonts/map/dvips/ fonts/map/dvips/ugm/ fonts/map/dvips/ugm/ugm.map fonts/tfm/ fonts/tfm/urw/ fonts/tfm/urw/garamond/ fonts/tfm/urw/garamond/ugmm8a.tfm fonts/tfm/urw/garamond/ugmm8c.tfm fonts/tfm/urw/garamond/ugmm8r.tfm fonts/tfm/urw/garamond/ugmm8t.tfm fonts/tfm/urw/garamond/ugmmi8a.tfm fonts/tfm/urw/garamond/ugmmi8c.tfm fonts/tfm/urw/garamond/ugmmi8r.tfm fonts/tfm/urw/garamond/ugmmi8t.tfm fonts/tfm/urw/garamond/ugmri8a.tfm fonts/tfm/urw/garamond/ugmri8c.tfm fonts/tfm/urw/garamond/ugmri8r.tfm fonts/tfm/urw/garamond/ugmri8t.tfm fonts/tfm/urw/garamond/ugmr8a.tfm fonts/tfm/urw/garamond/ugmr8c.tfm fonts/tfm/urw/garamond/ugmr8r.tfm fonts/tfm/urw/garamond/ugmr8t.tfm fonts/type1/ fonts/type1/urw/ fonts/type1/urw/garamond/ fonts/type1/urw/garamond/ugmm8a.pfb fonts/type1/urw/garamond/ugmm8a.pfm fonts/type1/urw/garamond/ugmmi8a.pfb fonts/type1/urw/garamond/ugmmi8a.pfm fonts/type1/urw/garamond/ugmri8a.pfb fonts/type1/urw/garamond/ugmri8a.pfm fonts/type1/urw/garamond/ugmr8a.pfb fonts/type1/urw/garamond/ugmr8a.pfm tex/ tex/latex/ tex/latex/ugm/ tex/latex/ugm/ts1ugm.fd tex/latex/ugm/t1ugm.fd
Most of the structure is contained within ugm.zip and the rest I
deciphered from http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instt1font.
I should say that I too like the easy way out and so I have provided these
files in a nice easy to use compressed tarball in the downloads section.
Once you have extracted the files in your texmf directory run the
updmap utility:
ben@riker ~ $ updmap copy //etc/texmf/web2c/updmap.cfg => /home/ben/.texlive/texmf-config/web2c/updmap.cfg Config file: "/home/ben/.texlive/texmf-config/web2c/updmap.cfg" dvips output dir: "/home/ben/.texlive/texmf-var/fonts/map/dvips/updmap" pdftex output dir: "/home/ben/.texlive/texmf-var/fonts/map/pdftex/updmap" /usr/bin/updmap is creating new map files using the following configuration: LW35 font names : URWkb prefer outlines : true texhash enabled : true download standard fonts (dvips) : false download standard fonts (pdftex) : true Scanning for LW35 support files [ 3 files] Scanning for MixedMap entries [ 25 files] Scanning for Map entries [119 files] Generating output for ps2pk... Generating output for dvips... Generating output for pdftex... Files generated: /home/ben/.texlive/texmf-var/fonts/map/dvips/updmap: 11489 2012-08-16 19:56:16 builtin35.map 15960 2012-08-16 19:56:16 download35.map 484889 2012-08-16 19:56:16 psfonts_pk.map 698019 2012-08-16 19:56:16 psfonts_t1.map 702484 2012-08-16 19:56:16 ps2pk.map 14 2012-08-16 19:56:17 psfonts.map -> psfonts_t1.map /home/ben/.texlive/texmf-var/fonts/map/pdftex/updmap: 702491 2012-08-16 19:56:17 pdftex_dl14.map 700917 2012-08-16 19:56:17 pdftex_ndl14.map 15 2012-08-16 19:56:17 pdftex.map -> pdftex_dl14.map Transcript written on "/home/ben/.texlive/texmf-var/web2c/updmap.log". /usr/bin/updmap: Updating ls-R files.
You thought you had finished didn't you? Well, try running dvipdfm
now and it may fail... this is because gsftopk is trying to create
glyphs to be used in your PDF but to do that it needs the gs command
from ghostscript, so... emerge ghostscript-gpl.
kpathsea: Running mktexpk --mfmode / --bdpi 600 --mag 0+540/600 --dpi 540 ugmr8y mktexpk: Running gsftopk ugmr8y 540 gsftopk(k) version 1.19.2/905
Now it will work!
dvipdfm cv.dvi
Downloads
References
- A TrueType Garamond Font.
- Modified Garamond Font.
- Installing Fonts.
- More details on installing fonts.
- Installing fonts in home directory.
- Another LaTeX CV I will leave this as an excerise for the reader :-).