Tex: Difference between revisions

imported>StefanSchroeder
m italicised question in FAQ section
imported>StefanSchroeder
Add more getting started material
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 ==