You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
gentoo-overlay/eclass/latex-package.eclass

253 lines
7.2 KiB

# Copyright 1999-2022 Gentoo Authors
# Distributed under the terms of the GNU General Public License v2
# @ECLASS: latex-package.eclass
# @MAINTAINER:
# TeX team <tex@gentoo.org>
# @AUTHOR:
# Matthew Turk <satai@gentoo.org>
# Martin Ehmsen <ehmsen@gentoo.org>
# @SUPPORTED_EAPIS: 7 8
# @BLURB: An eclass for easy installation of LaTeX packages
# @DESCRIPTION:
# This eClass is designed to be easy to use and implement. The vast majority of
# LaTeX packages will only need to define SRC_URI (and sometimes S) for a
# successful installation. If fonts need to be installed, then the variable
# SUPPLIER must also be defined.
#
# However, those packages that contain subdirectories must process each
# subdirectory individually. For example, a package that contains directories
# DIR1 and DIR2 must call latex-package_src_compile() and
# latex-package_src_install() in each directory, as shown here:
#
# src_compile() {
# cd ${S}
# cd DIR1
# latex-package_src_compile
# cd ..
# cd DIR2
# latex-package_src_compile
# }
#
# src_install() {
# cd ${S}
# cd DIR1
# latex-package_src_install
# cd ..
# cd DIR2
# latex-package_src_install
# }
#
# The eClass automatically takes care of rehashing TeX's cache (ls-lR) after
# installation and after removal, as well as creating final documentation from
# TeX files that come with the source. Note that we break TeX layout standards
# by placing documentation in /usr/share/doc/${PN}
#
# For examples of basic installations, check out dev-tex/aastex and
# dev-tex/leaflet .
#
# NOTE: The CTAN "directory grab" function creates files with different MD5
# signatures EVERY TIME. For this reason, if you are grabbing from the CTAN,
# you must either grab each file individually, or find a place to mirror an
# archive of them. (iBiblio)
case ${EAPI} in
7) inherit eapi8-dosym ;;
8) ;;
*) die "${ECLASS}: EAPI ${EAPI:-0} not supported" ;;
esac
if [[ -z ${_LATEX_PACKAGE_ECLASS} ]]; then
_LATEX_PACKAGE_ECLASS=1
RDEPEND="virtual/latex-base"
BDEPEND="${RDEPEND}
>=sys-apps/texinfo-4.2-r5"
HOMEPAGE="http://www.tug.org/"
# @ECLASS_VARIABLE: TEXMF
# @DESCRIPTION:
# Top-level installation path.
TEXMF="/usr/share/texmf-site"
# @ECLASS_VARIABLE: SUPPLIER
# @DESCRIPTION:
# This refers to the font supplier; it should be overridden (see eclass
# DESCRIPTION above)
SUPPLIER="misc"
# @ECLASS_VARIABLE: LATEX_DOC_ARGUMENTS
# @DESCRIPTION:
# When compiling documentation (.tex/.dtx), this variable will be passed
# to pdflatex as additional argument (e.g. -shell-escape). This variable
# must be set after inherit, as it gets automatically cleared otherwise.
LATEX_DOC_ARGUMENTS=""
# @FUNCTION: latex-package_src_doinstall
# @USAGE: [ module ]
# @DESCRIPTION:
# [module] can be one or more of: sh, sty, cls, fd, clo, def, cfg, dvi, ps, pdf,
# tex, dtx, tfm, vf, afm, pfb, ttf, bst, styles, doc, fonts, bin, or all.
# If [module] is not given, all is assumed.
# It installs the files found in the current directory to the standard locations
# for a TeX installation
latex-package_src_doinstall() {
debug-print-function "${FUNCNAME}" "$@"
# Avoid generating font cache outside of the sandbox
export VARTEXFONTS="${T}/fonts"
# This actually follows the directions for a "single-user" system
# at http://www.ctan.org/installationadvice/ modified for gentoo.
[[ -z ${1} ]] && latex-package_src_install all
while [[ ${1} ]]; do
case ${1} in
"sh")
while IFS= read -r -d '' i; do
dobin "${i}"
done < <(find -maxdepth 1 -type f -name "*.${1}" -print0)
;;
"sty" | "cls" | "fd" | "clo" | "def" | "cfg")
while IFS= read -r -d '' i; do
insinto "${TEXMF}/tex/latex/${PN}"
doins "${i}"
done < <(find -maxdepth 1 -type f -name "*.${1}" -print0)
;;
"dvi" | "ps" | "pdf")
while IFS= read -r -d '' i; do
insinto /usr/share/doc/${PF}
doins "${i}"
local dosym=dosym
[[ ${EAPI} == 7 ]] && dosym=dosym8
${dosym} -r "/usr/share/doc/${PF}/$(basename "${i}")" \
"${TEXMF}/doc/latex/${PN}/${i}"
docompress -x "/usr/share/doc/${PF}/$(basename "${i}")"
done < <(find -maxdepth 1 -type f -name "*.${1}" -print0)
;;
"tex" | "dtx")
if ! in_iuse doc || use doc ; then
while IFS= read -r -d '' i; do
[[ -n ${LATEX_PACKAGE_SKIP} ]] &&
has "${i##*/}" ${LATEX_PACKAGE_SKIP} &&
continue
einfo "Making documentation: ${i}"
# some macros need compiler called twice, do it here.
set -- pdflatex ${LATEX_DOC_ARGUMENTS} \
--halt-on-error --interaction=nonstopmode "${i}"
if "${@}"; then
"${@}"
else
einfo "pdflatex failed, trying texi2dvi"
texi2dvi -q -c --language=latex "${i}" || die
fi
done < <(find -maxdepth 1 -type f -name "*.${1}" -print0)
fi
;;
"tfm" | "vf" | "afm")
while IFS= read -r -d '' i; do
insinto "${TEXMF}/fonts/${1}/${SUPPLIER}/${PN}"
doins "${i}"
done < <(find -maxdepth 1 -type f -name "*.${1}" -print0)
;;
"pfb")
while IFS= read -r -d '' i; do
insinto "${TEXMF}/fonts/type1/${SUPPLIER}/${PN}"
doins "${i}"
done < <(find -maxdepth 1 -type f -name "*.pfb" -print0)
;;
"ttf")
while IFS= read -r -d '' i; do
insinto "${TEXMF}/fonts/truetype/${SUPPLIER}/${PN}"
doins "${i}"
done < <(find -maxdepth 1 -type f -name "*.ttf" -print0)
;;
"bst")
while IFS= read -r -d '' i; do
insinto "${TEXMF}/bibtex/bst/${PN}"
doins "${i}"
done < <(find -maxdepth 1 -type f -name "*.bst" -print0)
;;
"styles")
latex-package_src_doinstall sty cls fd clo def cfg bst
;;
"doc")
latex-package_src_doinstall tex dtx dvi ps pdf
;;
"fonts")
latex-package_src_doinstall tfm vf afm pfb ttf
;;
"bin")
latex-package_src_doinstall sh
;;
"all")
latex-package_src_doinstall styles fonts bin doc
;;
esac
shift
done
}
# @FUNCTION: latex-package_src_compile
# @DESCRIPTION:
# Calls latex for each *.ins in the current directory in order to generate the
# relevant files that will be installed
latex-package_src_compile() {
debug-print-function "${FUNCNAME}" "$@"
while IFS= read -r -d '' i; do
einfo "Extracting from ${i}"
latex --halt-on-error --interaction=nonstopmode "${i}" || die
done < <(find -maxdepth 1 -type f -name "*.ins" -print0)
}
# @FUNCTION: latex-package_src_install
# @DESCRIPTION:
# Installs the package
latex-package_src_install() {
debug-print-function "${FUNCNAME}" "$@"
latex-package_src_doinstall all
einstalldocs
}
# @FUNCTION: latex-package_pkg_postinst
# @DESCRIPTION:
# Calls latex-package_rehash to ensure the TeX installation is consistent with
# the kpathsea database
latex-package_pkg_postinst() {
debug-print-function "${FUNCNAME}" "$@"
latex-package_rehash
}
# @FUNCTION: latex-package_pkg_postrm
# @DESCRIPTION:
# Calls latex-package_rehash to ensure the TeX installation is consistent with
# the kpathsea database
latex-package_pkg_postrm() {
debug-print-function "${FUNCNAME}" "$@"
latex-package_rehash
}
# @FUNCTION: latex-package_rehash
# @DESCRIPTION:
# Rehashes the kpathsea database, according to the current TeX installation
latex-package_rehash() {
debug-print-function "${FUNCNAME}" "$@"
texmf-update
}
fi
EXPORT_FUNCTIONS src_compile src_install pkg_postinst pkg_postrm