diff options
author | Nicolas Goaziou <mail@nicolasgoaziou.fr> | 2023-06-27 15:11:18 +0200 |
---|---|---|
committer | Nicolas Goaziou <mail@nicolasgoaziou.fr> | 2023-07-18 18:16:40 +0200 |
commit | 350562e9f4da628312239c291ba399a2172bdadb (patch) | |
tree | 0a03cd88d7fe59b4c009e46e1bfc9f9893773dcc /doc | |
parent | 81ccfeb928f796e8036859a003dac2a4b5eec566 (diff) | |
download | guix-patches-350562e9f4da628312239c291ba399a2172bdadb.tar guix-patches-350562e9f4da628312239c291ba399a2172bdadb.tar.gz |
doc: Update TeX Live related documentation.
* doc/guix.texi (Invoking guix import): "texlive.tlpdb" is located in
TEXLIVE-SCRIPTS package.
(Using TeX and LaTeX): Mention collections and schemes as a starting point.
Illustrate it with an updated example. Update tiny TODO list. Fix call to
"tlmgr".
Diffstat (limited to 'doc')
-rw-r--r-- | doc/guix.texi | 57 |
1 files changed, 30 insertions, 27 deletions
diff --git a/doc/guix.texi b/doc/guix.texi index 2c460cbc08..1d8ebcd72f 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -14088,9 +14088,10 @@ TeX packages that are part of the @uref{https://www.tug.org/texlive/, TeX Live distribution}. Information about the package is obtained from the TeX Live package -database, a plain text file that is included in the @code{texlive-bin} -package. The source code is downloaded from possibly multiple locations -in the SVN repository of the Tex Live project. +database, a plain text file that is included in the +@code{texlive-scripts} package. The source code is downloaded from +possibly multiple locations in the SVN repository of the Tex Live +project. The command command below imports metadata for the @code{fontspec} TeX package: @@ -45406,14 +45407,19 @@ single @TeX{} Live package} (more than 7,000 of them), but it is huge (more than 4@tie{}GiB for a single package!). @item -The ``modular'' @code{texlive-} packages: you install -@code{texlive-base}, which provides core functionality and the main +The ``modular'' @samp{texlive-} packages: you start off with +a combination of @TeX{} Live @dfn{collections} and +@dfn{schemes}---``meta-packages'' such as +@code{texlive-collection-fontsrecommended}, or +@code{texlive-collection-context}, that provide the set of packages +needed in this particular domain, schemes being the name for collections +of such collections. This grants you core functionality and the main commands---@command{pdflatex}, @command{dvips}, @command{luatex}, -@command{mf}, etc.---together with individual packages that provide just -the features you need---@code{texlive-listings} for the -@code{listings} package, @code{texlive-hyperref} for @code{hyperref}, -@code{texlive-beamer} for Beamer, @code{texlive-pgf} for PGF/TikZ, -and so on. +@command{mf}, etc. You can then complete your selection with additional +collections or individual packages that provide just the features you +need---@code{texlive-listings} for the @code{listings} package, +@code{texlive-beamer} for Beamer, @code{texlive-pgf} for PGF/TikZ, and +so on. @end itemize We recommend using the modular package set because it is much less @@ -45421,29 +45427,29 @@ resource-hungry. To build your documents, you would use commands such as: @example -guix shell texlive-base texlive-wrapfig \ - texlive-hyperref texlive-cm-super -- pdflatex doc.tex +guix shell texlive-scheme-basic texlive-cm-super -- pdflatex doc.tex @end example You can quickly end up with unreasonably long command lines though. The -solution is to instead write a manifest, for example like this one: +solution is to instead write a manifest, for example like this one, +which would probably be a reasonable starting point for a French +@LaTeX{} user: @lisp (specifications->manifest '("rubber" - "texlive-base" - "texlive-wrapfig" + "texlive-scheme-basic" + "texlive-collection-latexrecommended" + "texlive-collection-fontsrecommended" - "texlive-microtype" - "texlive-listings" "texlive-hyperref" + "texlive-babel-french" ;; PGF/TikZ "texlive-pgf" - ;; Additional fonts. - "texlive-cm-super" "texlive-amsfonts" - "texlive-times" "texlive-helvetic" "texlive-courier")) + ;; Additional font. + "texlive-kpfonts")) @end lisp You can then pass it to any command with the @option{-m} option: @@ -45452,12 +45458,9 @@ You can then pass it to any command with the @option{-m} option: guix shell -m manifest.scm -- pdflatex doc.tex @end example -@xref{Writing Manifests}, for more on -manifests. In the future, we plan to provide packages for @TeX{} Live -@dfn{collections}---``meta-packages'' such as @code{fontsrecommended}, -@code{humanities}, or @code{langarabic} that provide the set of packages -needed in this particular domain. That will allow you to list fewer -packages. +@xref{Writing Manifests}, for more on manifests. In the future, we plan +to provide more collections and schemes. That will allow you to list +fewer packages. The main difficulty here is that using the modular package set forces you to select precisely the packages that you need. You can use @@ -45493,7 +45496,7 @@ you can search the @TeX{} Live package database using the @command{tlmgr} command: @example -$ guix shell texlive-base -- tlmgr info phvr7t +$ guix shell texlive-bin -- tlmgr info phvr7t tlmgr: cannot find package phvr7t, searching for other matches: Packages containing `phvr7t' in their title/description: |