# 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