aboutsummaryrefslogtreecommitdiff
path: root/infra/libkookie/nixpkgs/doc/languages-frameworks/texlive.xml
diff options
context:
space:
mode:
authorMx Kookie <kookie@spacekookie.de>2020-12-09 18:55:19 +0000
committerMx Kookie <kookie@spacekookie.de>2020-12-09 18:55:19 +0000
commit80d90d9b204f7c17912740f9f414fe5d59f293ba (patch)
tree5f2065a06e724270610760d59d01c6888b375a46 /infra/libkookie/nixpkgs/doc/languages-frameworks/texlive.xml
parent3a31a84c7d3e589035ad08499206aac44a81f424 (diff)
parent83cbad92d73216bb0d9187c56cce0b91f9121d5a (diff)
Merge commit '83cbad92d73216bb0d9187c56cce0b91f9121d5a' into main
Diffstat (limited to 'infra/libkookie/nixpkgs/doc/languages-frameworks/texlive.xml')
-rw-r--r--infra/libkookie/nixpkgs/doc/languages-frameworks/texlive.xml152
1 files changed, 0 insertions, 152 deletions
diff --git a/infra/libkookie/nixpkgs/doc/languages-frameworks/texlive.xml b/infra/libkookie/nixpkgs/doc/languages-frameworks/texlive.xml
deleted file mode 100644
index 141c46e5a623..000000000000
--- a/infra/libkookie/nixpkgs/doc/languages-frameworks/texlive.xml
+++ /dev/null
@@ -1,152 +0,0 @@
-<section xmlns="http://docbook.org/ns/docbook"
- xmlns:xlink="http://www.w3.org/1999/xlink"
- xml:id="sec-language-texlive">
- <title>TeX Live</title>
-
- <para>
- Since release 15.09 there is a new TeX Live packaging that lives entirely under attribute <varname>texlive</varname>.
- </para>
-
- <section xml:id="sec-language-texlive-users-guide">
- <title>User's guide</title>
-
- <itemizedlist>
- <listitem>
- <para>
- For basic usage just pull <varname>texlive.combined.scheme-basic</varname> for an environment with basic LaTeX support.
- </para>
- </listitem>
- <listitem>
- <para>
- It typically won't work to use separately installed packages together. Instead, you can build a custom set of packages like this:
-<programlisting>
-texlive.combine {
- inherit (texlive) scheme-small collection-langkorean algorithms cm-super;
-}
-</programlisting>
- There are all the schemes, collections and a few thousand packages, as defined upstream (perhaps with tiny differences).
- </para>
- </listitem>
- <listitem>
- <para>
- By default you only get executables and files needed during runtime, and a little documentation for the core packages. To change that, you need to add <varname>pkgFilter</varname> function to <varname>combine</varname>.
-<programlisting>
-texlive.combine {
- # inherit (texlive) whatever-you-want;
- pkgFilter = pkg:
- pkg.tlType == "run" || pkg.tlType == "bin" || pkg.pname == "cm-super";
- # elem tlType [ "run" "bin" "doc" "source" ]
- # there are also other attributes: version, name
-}
-</programlisting>
- </para>
- </listitem>
- <listitem>
- <para>
- You can list packages e.g. by <command>nix repl</command>.
-<programlisting>
-<prompt>$ </prompt>nix repl
-<prompt>nix-repl> </prompt>:l &lt;nixpkgs>
-<prompt>nix-repl> </prompt>texlive.collection-<keycap function="tab" />
-</programlisting>
- </para>
- </listitem>
- <listitem>
- <para>
- Note that the wrapper assumes that the result has a chance to be useful. For example, the core executables should be present, as well as some core data files. The supported way of ensuring this is by including some scheme, for example <varname>scheme-basic</varname>, into the combination.
- </para>
- </listitem>
- </itemizedlist>
- </section>
-
- <section xml:id="sec-language-texlive-custom-packages">
- <title>Custom packages</title>
- <para>
- 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 <varname>tlType</varname> attribute. Here is a (very verbose) example:
-<programlisting><![CDATA[
-with import <nixpkgs> {};
-
-let
- foiltex_run = stdenvNoCC.mkDerivation {
- pname = "latex-foiltex";
- version = "2.1.4b";
- passthru.tlType = "run";
-
- srcs = [
- (fetchurl {
- url = "http://mirrors.ctan.org/macros/latex/contrib/foiltex/foiltex.dtx";
- sha256 = "07frz0krpz7kkcwlayrwrj2a2pixmv0icbngyw92srp9fp23cqpz";
- })
- (fetchurl {
- url = "http://mirrors.ctan.org/macros/latex/contrib/foiltex/foiltex.ins";
- sha256 = "09wkyidxk3n3zvqxfs61wlypmbhi1pxmjdi1kns9n2ky8ykbff99";
- })
- ];
-
- unpackPhase = ''
- runHook preUnpack
-
- for _src in $srcs; do
- cp "$_src" $(stripHash "$_src")
- done
-
- runHook postUnpack
- '';
-
- nativeBuildInputs = [ texlive.combined.scheme-small ];
-
- dontConfigure = true;
-
- buildPhase = ''
- runHook preBuild
-
- # Generate the style files
- latex foiltex.ins
-
- runHook postBuild
- '';
-
- installPhase = ''
- runHook preInstall
-
- path="$out/tex/latex/foiltex"
- mkdir -p "$path"
- cp *.{cls,def,clo} "$path/"
-
- runHook postInstall
- '';
-
- meta = with lib; {
- description = "A LaTeX2e class for overhead transparencies";
- license = licenses.unfreeRedistributable;
- maintainers = with maintainers; [ veprbl ];
- platforms = platforms.all;
- };
- };
- foiltex = { pkgs = [ foiltex_run ]; };
-
- latex_with_foiltex = texlive.combine {
- inherit (texlive) scheme-small;
- inherit foiltex;
- };
-in
- runCommand "test.pdf" {
- nativeBuildInputs = [ latex_with_foiltex ];
- } ''
-cat >test.tex <<EOF
-\documentclass{foils}
-
-\title{Presentation title}
-\date{}
-
-\begin{document}
-\maketitle
-\end{document}
-EOF
- pdflatex test.tex
- cp test.pdf $out
-''
-]]></programlisting>
- </para>
- </section>
-</section>