diff options
author | Vincenzo Mantova <1962985+xworld21@users.noreply.github.com> | 2023-03-11 20:57:23 +0000 |
---|---|---|
committer | Vincenzo Mantova <1962985+xworld21@users.noreply.github.com> | 2023-04-02 13:00:52 +0100 |
commit | 57b2634ac1242bd8d34b6c78396b217c65418755 (patch) | |
tree | 0c9d12ec54e31e272ab6a15b551a9959b80dad64 /doc | |
parent | 59661dafb04b95b4e6d5933bfa2332949de46bbe (diff) |
texlive.combine: document how to create custom packages with pkgs and tlDeps attributes
Diffstat (limited to 'doc')
-rw-r--r-- | doc/languages-frameworks/texlive.section.md | 16 |
1 files changed, 11 insertions, 5 deletions
diff --git a/doc/languages-frameworks/texlive.section.md b/doc/languages-frameworks/texlive.section.md index e790e217cac0d..72ab14126bedc 100644 --- a/doc/languages-frameworks/texlive.section.md +++ b/doc/languages-frameworks/texlive.section.md @@ -40,17 +40,24 @@ Since release 15.09 there is a new TeX Live packaging that lives entirely under ## Custom packages {#sec-language-texlive-custom-packages} +You may find that you need to use an external TeX package. A derivation for such package has to provide the contents of the "texmf" directory in its output and provide the appropriate `tlType` attribute (one of `"run"`, `"bin"`, `"doc"`, `"source"`). Dependencies on other TeX packages can be listed in the attribute `tlDeps`. -You may find that you need to use an external TeX package. A derivation for such package has to provide contents of the "texmf" directory in its output and provide the `tlType` attribute. Here is a (very verbose) example: +Such derivation must then be listed in the attribute `pkgs` of an attribute set passed to `texlive.combine`, for instance by passing `extraPkgs = { pkgs = [ custom_package ]; };`. Within Nixpkgs, `pkgs` should be part of the derivation itself, allowing users to call `texlive.combine { inherit (texlive) scheme-small; inherit some_tex_package; }`. + +Here is a (very verbose) example where the attribute `pkgs` is attached to the derivation itself, which requires creating a fixed point. See also the packages `auctex`, `eukleides`, `mftrace` for more examples. ```nix with import <nixpkgs> {}; let - foiltex_run = stdenvNoCC.mkDerivation { + foiltex = stdenvNoCC.mkDerivation (finalAttrs: { pname = "latex-foiltex"; version = "2.1.4b"; - passthru.tlType = "run"; + passthru = { + pkgs = [ finalAttrs.finalPackage ]; + tlDeps = with texlive; [ latex ]; + tlType = "run"; + }; srcs = [ (fetchurl { @@ -102,8 +109,7 @@ let maintainers = with maintainers; [ veprbl ]; platforms = platforms.all; }; - }; - foiltex = { pkgs = [ foiltex_run ]; }; + }); latex_with_foiltex = texlive.combine { inherit (texlive) scheme-small; |