Tex - Revision history

Chandlerswift: Fix link to texlive package spec

2025-07-18T06:49:09Z

Fix link to texlive package spec

← Older revision		Revision as of 06:49, 18 July 2025
Line 125:		Line 125:
	<code>nix-env -iA nixpkgs.texlive.combined.scheme-full</code>		<code>nix-env -iA nixpkgs.texlive.combined.scheme-full</code>

	If you are looking for a smaller package, you need to go the [https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/tools/typesetting/tex/texlive/~~pkgs~~.nix Nixpkg's package specification] and search for the scheme-name. For each scheme the list of packages is listed there. Since the inclusion of packages is organized hierarchically, this will require some digging. (TODO: Is there a nix-command to find out?)		If you are looking for a smaller package, you need to go the [https://raw.githubusercontent.com/NixOS/nixpkgs/refs/heads/master/pkgs/tools/typesetting/tex/texlive/tlpdb.nix Nixpkg's package specification] and search for the scheme-name. For each scheme the list of packages is listed there. Since the inclusion of packages is organized hierarchically, this will require some digging. (TODO: Is there a nix-command to find out?)

	[[Category:Languages]]		[[Category:Languages]]

imported>IgorM: Added category, formatting

2023-09-27T09:35:26Z

Added category, formatting

← Older revision		Revision as of 09:35, 27 September 2023
Line 32:		Line 32:
	The (pretty verbose) output will look similar to:		The (pretty verbose) output will look similar to:

	<~~pre~~>		<syntaxhighlight lang=console>
	$ pdflatex minimal.tex		$ pdflatex minimal.tex
	This is pdfTeX, Version 3.14159265-2.6-1.40.21 (TeX Live 2019/NixOS.org)		This is pdfTeX, Version 3.14159265-2.6-1.40.21 (TeX Live 2019/NixOS.org)
Line 47:		Line 47:
	Output written on minimal.pdf (1 page, 12502 bytes).		Output written on minimal.pdf (1 page, 12502 bytes).
	Transcript written on minimal.log.		Transcript written on minimal.log.
	</~~pre~~>		</syntaxhighlight>

	Well done, you created your first PDF document on Nixos using TeX.		Well done, you created your first PDF document on Nixos using TeX.
Line 90:		Line 90:
	Example code:		Example code:

			<syntaxhighlight lang=nix>
	pkgs.texlive.combine {		pkgs.texlive.combine {
	scheme-medium = pkgs.texlive.scheme-medium // {		scheme-medium = pkgs.texlive.scheme-medium // {
Line 114:		Line 114:
	")]; };		")]; };
	}		}
			</syntaxhighlight>


Line 125:		Line 126:

	If you are looking for a smaller package, you need to go the [https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/tools/typesetting/tex/texlive/pkgs.nix Nixpkg's package specification] and search for the scheme-name. For each scheme the list of packages is listed there. Since the inclusion of packages is organized hierarchically, this will require some digging. (TODO: Is there a nix-command to find out?)		If you are looking for a smaller package, you need to go the [https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/tools/typesetting/tex/texlive/pkgs.nix Nixpkg's package specification] and search for the scheme-name. For each scheme the list of packages is listed there. Since the inclusion of packages is organized hierarchically, this will require some digging. (TODO: Is there a nix-command to find out?)

			[[Category:Languages]]

imported>7c6f434c: Add an example of overriding a package version

2022-02-25T16:53:13Z

Add an example of overriding a package version

← Older revision		Revision as of 16:53, 25 February 2022
Line 83:		Line 83:

	You might want to review [https://github.com/NixOS/nixpkgs/issues/17748]		You might want to review [https://github.com/NixOS/nixpkgs/issues/17748]

			=== Removing packages from a collection ===

			If you want to package and install a fresher version of some TeXLive package, you might experience a collision with a package from a scheme or a collection you have installed as a whole. To resolve this issue, remove the package by pname from pkgs.

			Example code:


			pkgs.texlive.combine {
			scheme-medium = pkgs.texlive.scheme-medium // {
			pkgs = pkgs.lib.filter
			(x: (x.pname != "apxproof"))
			pkgs.texlive.scheme-medium.pkgs;
			};

			apxproof = { pkgs = [(pkgs.runCommand "apxproof" {
			src = pkgs.fetchurl {
			url = "https://raw.githubusercontent.com/PierreSenellart/apxproof/1ac14c47b8351b693ca05eec73dca1332a517ac9/apxproof.sty";
			sha256 = "sha256-XSgtXsOwhMu2Wo4hVp8ZfaPWgjEEg3EBn5/BhD3xkMA=";
			};
			passthru = {
			pname = "apxproof";
			version = "1.2.3";
			tlType = "run";
			};
			}
			"
			mkdir -p $out/tex/latex/apxproof/
			cp $src $out/tex/latex/apxproof/apxproof.sty
			")]; };
			}


	== Frequently asked questions FAQ ==		== Frequently asked questions FAQ ==

imported>Tomberek at 05:35, 24 September 2021

2021-09-24T05:35:42Z

← Older revision		Revision as of 05:35, 24 September 2021
Line 90:		Line 90:
	As noted on [[TexLive]] there are several schemas available. If you know exactly which packages you are going to need you can follow the recipe on the [[TexLive]] page. Installing the Full-schema is always an option to be sure that you have everything you need, like so:		As noted on [[TexLive]] there are several schemas available. If you know exactly which packages you are going to need you can follow the recipe on the [[TexLive]] page. Installing the Full-schema is always an option to be sure that you have everything you need, like so:

	<code>nix-env -iA ~~nixos~~.texlive.combined.scheme-full</code>		<code>nix-env -iA nixpkgs.texlive.combined.scheme-full</code>

	If you are looking for a smaller package, you need to go the [https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/tools/typesetting/tex/texlive/pkgs.nix Nixpkg's package specification] and search for the scheme-name. For each scheme the list of packages is listed there. Since the inclusion of packages is organized hierarchically, this will require some digging. (TODO: Is there a nix-command to find out?)		If you are looking for a smaller package, you need to go the [https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/tools/typesetting/tex/texlive/pkgs.nix Nixpkg's package specification] and search for the scheme-name. For each scheme the list of packages is listed there. Since the inclusion of packages is organized hierarchically, this will require some digging. (TODO: Is there a nix-command to find out?)

imported>Tomberek at 05:35, 24 September 2021

2021-09-24T05:35:09Z

← Older revision		Revision as of 05:35, 24 September 2021
Line 26:		Line 26:
	A good starting point is to install the TeX-Live basic setup:		A good starting point is to install the TeX-Live basic setup:

	<code>nix-env -iA ~~nixos~~.texlive.combined.scheme-basic</code>		<code>nix-env -iA nixpkgs.texlive.combined.scheme-basic</code>

	After installation, the command <code>pdflatex</code> should be available. Save the minimal example above in a file called minimal.tex and compile it with <code>pdflatex minimal.tex</code>		After installation, the command <code>pdflatex</code> should be available. Save the minimal example above in a file called minimal.tex and compile it with <code>pdflatex minimal.tex</code>

imported>StefanSchroeder: added zathura as an option to view pdfs

2020-10-16T20:54:55Z

added zathura as an option to view pdfs

← Older revision		Revision as of 20:54, 16 October 2020
Line 63:		Line 63:
	<code>pdflatex sample2e</code>		<code>pdflatex sample2e</code>

	You can then use any PDF viewer to display it, e.g. <code>evince</code> in GNOME, <code>okular</code> in KDE, <code>xpdf</code> lightweight X11-viewer.		You can then use any PDF viewer to display it, e.g. <code>evince</code> in GNOME, <code>okular</code> in KDE, <code>xpdf</code> or <code>zathura</code> lightweight X11-viewer.

	=== Using Texlive packages ===		=== Using Texlive packages ===

	If you need many different packages or find that you are missing packages, consider to install the		If you need many different packages or find that you are missing packages, consider to install the
	package '''nixpkgs.texlive.combined.scheme-full''', but be aware that it is pretty huge (~~1-2~~ GB).		package '''nixpkgs.texlive.combined.scheme-full''', but be aware that it is pretty huge (about 5 GB).

	If you don't want to install the Full scheme, but still need a collection of specific ~~pacckages~~, follow the instructions on the [[TexLive]] page.		If you don't want to install the Full scheme, but still need a collection of specific packages, follow the instructions on the [[TexLive]] page.

	=== Using CTAN packages ===		=== Using CTAN packages ===

imported>StefanSchroeder: Added pdf viewer apps.

2020-10-09T09:45:29Z

Added pdf viewer apps.

← Older revision		Revision as of 09:45, 9 October 2020
Line 50:		Line 50:

	Well done, you created your first PDF document on Nixos using TeX.		Well done, you created your first PDF document on Nixos using TeX.

	~~If you need many different packages or find that you are missing packages, consider to install the~~
	~~package '''nixpkgs.texlive.combined.scheme-full''', but be aware that it is pretty huge (1-2 GB).~~

	== Next steps ==		== Next steps ==
Line 66:		Line 63:
	<code>pdflatex sample2e</code>		<code>pdflatex sample2e</code>

			You can then use any PDF viewer to display it, e.g. <code>evince</code> in GNOME, <code>okular</code> in KDE, <code>xpdf</code> lightweight X11-viewer.

	=== Using Texlive packages ===		=== Using Texlive packages ===

	If you ~~have installed~~ the '~~Full~~' scheme, ~~all TeXLive packages should already~~ be ~~installed~~.		If you need many different packages or find that you are missing packages, consider to install the
			package '''nixpkgs.texlive.combined.scheme-full''', but be aware that it is pretty huge (1-2 GB).

			If you don't want to install the Full scheme, but still need a collection of specific pacckages, follow the instructions on the [[TexLive]] page.

	=== Using CTAN packages ===		=== Using CTAN packages ===

imported>StefanSchroeder: Add more getting started material

2020-10-09T08:57:50Z

Add more getting started material

← Older revision		Revision as of 08:57, 9 October 2020
Line 9:		Line 9:
	TeX-documents are not What-you-see-is-what-you-get, but written in plain text, containing tags, commands and functions that instruct the TeX-engine how to lay out the text (or figures or anything else) on the page.		TeX-documents are not What-you-see-is-what-you-get, but written in plain text, containing tags, commands and functions that instruct the TeX-engine how to lay out the text (or figures or anything else) on the page.

	A minimal TeX-document ~~might look like~~ this:		A minimal TeX-document can be created on the commandline using this shell-snippet:

	<pre>		<pre>
			cat > minimal.tex <<'EOF'
	\documentclass{article}		\documentclass{article}
	\begin{document}		\begin{document}
	Hello, Nix.		Hello, Nix.
	\end{document}		\end{document}
			EOF
	</pre>		</pre>

Line 54:		Line 56:
	== Next steps ==		== Next steps ==

	~~Use Texlive packages~~. ~~TODO~~		From here on, we will assume that the "Full" scheme is installed.

	~~Use CTAN packages TODO~~		Let's fetch an a little more complex example:

	~~Use~~ home-made packages. ~~TODO~~		<code>curl -O https://raw.githubusercontent.com/latex3/latex2e/master/base/sample2e.tex</code>

			and process it

			<code>pdflatex sample2e</code>


			=== Using Texlive packages ===

			If you have installed the 'Full' scheme, all TeXLive packages should already be installed.

			=== Using CTAN packages ===

			If you want to use a CTAN-package that is not in TeXLive, you will have to adapt any of the
			derivations that you can find in these issues, e.g. [https://github.com/NixOS/nixpkgs/issues/21334] (eqexam) or
			or [https://github.com/NixOS/nixpkgs/issues/21577] (classico)
			or [https://github.com/NixOS/nixpkgs/issues/54451] (res). Please note that the most common reason
			why packages are not in TeXLive is that they might be released under a non-free license.

			=== Using home-made packages ===

			You might want to review [https://github.com/NixOS/nixpkgs/issues/17748]

	== Frequently asked questions FAQ ==		== Frequently asked questions FAQ ==

imported>StefanSchroeder: italicised question in FAQ section

2020-10-08T13:28:02Z

italicised question in FAQ section

← Older revision		Revision as of 13:28, 8 October 2020
Line 62:		Line 62:
	== Frequently asked questions FAQ ==		== Frequently asked questions FAQ ==

	How do I figure out which Texlive-schema to install?		''How do I figure out which Texlive-schema to install?''

	As noted on [[TexLive]] there are several schemas available. If you know exactly which packages you are going to need you can follow the recipe on the [[TexLive]] page. Installing the Full-schema is always an option to be sure that you have everything you need, like so:		As noted on [[TexLive]] there are several schemas available. If you know exactly which packages you are going to need you can follow the recipe on the [[TexLive]] page. Installing the Full-schema is always an option to be sure that you have everything you need, like so:

imported>StefanSchroeder: Added FAQ section.

2020-10-08T13:22:39Z

Added FAQ section.

← Older revision		Revision as of 13:22, 8 October 2020
Line 59:		Line 59:

	Use home-made packages. TODO		Use home-made packages. TODO

			== Frequently asked questions FAQ ==

			How do I figure out which Texlive-schema to install?

			As noted on [[TexLive]] there are several schemas available. If you know exactly which packages you are going to need you can follow the recipe on the [[TexLive]] page. Installing the Full-schema is always an option to be sure that you have everything you need, like so:

			<code>nix-env -iA nixos.texlive.combined.scheme-full</code>

			If you are looking for a smaller package, you need to go the [https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/tools/typesetting/tex/texlive/pkgs.nix Nixpkg's package specification] and search for the scheme-name. For each scheme the list of packages is listed there. Since the inclusion of packages is organized hierarchically, this will require some digging. (TODO: Is there a nix-command to find out?)