How to load latex .sty files from a subdirectory?
I believe this thread here:
- LaTeX Community • View topic - Including tex files
talks about precisely the same thing: so it seems, the only alternatives are either using TEXINPUTS
environment variable; or using the import package. (note, there is a variant on the import
package on ...Including tex files pg 3.)
A bit more about TEXINPUTS:
- TeX Frequently Asked Questions -- “Temporary” installation of (La)TeX files
- Setting TeX Environment Variable Paths
- Environment Variables for Running LaTeX
- TeX (and Variations) for Writing Math - math.umn.edu (see 'TeX Inputs')
- Installing LaTeX packages - TeX search paths
Hope this helps;
Cheers!
EDIT: I hoped that one could set the TEXINPUTS path directly in the tex file (by using \write18
-- and note, some versions of LaTeX use --enable-write18
, mine uses -shell-escape
to enable \write18
; see also this) - but it seems it is not possible:
"... This isn't possible. ... The environment variable of the child process is set, but this hasn't an effect to its parent process (TeX)." (Re: Setting the environmental variable TEXINPUTS within latex - comp.text.tex).
... so, now I just call pdflatex
in my Linux bash
like this:
TEXINPUTS=.//:$TEXINPUTS pdflatex ./myfile.tex
and then it will resolve directly \usepackage{mypackage}
in the myfile.tex
file - even if mypackage.sty
is in a subdirectory, say ./subdir/mypackage.sty
.
As you discovered, putting the package in a subdirectory (say, ./sty/prettythesis.sty
with respect to your main .tex
file at ./
), and calling the package via
\usepackage{sty/prettythesis}
will successfully load the package, but it will produce the warning
sty/prettythesis.sty: You have requested package `sty/prettythesis',
but the package provides `prettythesis'. (page 1)
If all you want is to get rid of this warning, and you're OK with minor modifications in the .sty
file, then you can simply change the package name that it reports, by changing the \ProvidesPackage
command to
\ProvidesPackage{sty/prettythesis}
This can be inconvenient if you're going to be moving it around loads, but the modifications load isn't too bad either.
Even better, if what you have in there is a specific, modified version of a standard TeX package (like, say, this patch of natbib), then the change in the package name clearly indicates what package it's providing, and if you reuse the file then it will (most likely) re-raise a warning to prompt you into making sure that you know what you're doing.
Simply put line below before the call to pdflatex (or latex) in your makefile or build script:
export TEXINPUTS=".:./sty:"
Then reference your package as:
\usepackage{prettythesis}
You can do it in your TeX file without changing your system's environment (do not forget the trailing slash /
with each directory):
\makeatletter
\def\input@path{{../one-directory/}{../another-directory/}}
\makeatother
\documentclass{myclass}
\usepackage{mypackage}
This way, though, may be not recommended for portability. As other answers mention, the "correct" way is to set the TEXINPUTS
variable in your system environment before you call latex; in Windows it is (you can place it in a batch file):
set TEXINPUTS=../one-directory/;../another-directory/;%TEXINPUTS%
pdflatex myfile.tex