From unknown Tue Jun 17 22:08:31 2025 X-Loop: help-debbugs@gnu.org Subject: [bug#54220] [PATCH] doc: Add "Using TeX and LaTeX" chapter. Resent-From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Original-Sender: "Debbugs-submit" Resent-CC: rekado@elephly.net, mail@nicolasgoaziou.fr, bauermann@kolabnow.com, guix-patches@gnu.org Resent-Date: Wed, 02 Mar 2022 09:57:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 54220 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 54220@debbugs.gnu.org Cc: Ludovic =?UTF-8?Q?Court=C3=A8s?= , Ricardo Wurmus , Nicolas Goaziou , Thiago Jung Bauermann X-Debbugs-Original-To: guix-patches@gnu.org X-Debbugs-Original-Xcc: Ricardo Wurmus , Nicolas Goaziou , Thiago Jung Bauermann Received: via spool by submit@debbugs.gnu.org id=B.164621497728075 (code B ref -1); Wed, 02 Mar 2022 09:57:01 +0000 Received: (at submit) by debbugs.gnu.org; 2 Mar 2022 09:56:17 +0000 Received: from localhost ([127.0.0.1]:39128 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nPLiS-0007Ik-KG for submit@debbugs.gnu.org; Wed, 02 Mar 2022 04:56:17 -0500 Received: from lists.gnu.org ([209.51.188.17]:39964) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nPLiQ-0007Ic-FN for submit@debbugs.gnu.org; Wed, 02 Mar 2022 04:56:15 -0500 Received: from eggs.gnu.org ([209.51.188.92]:41530) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nPLiQ-000389-6d for guix-patches@gnu.org; Wed, 02 Mar 2022 04:56:14 -0500 Received: from [2001:470:142:3::e] (port=54766 helo=fencepost.gnu.org) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nPLiP-0002vq-OS; Wed, 02 Mar 2022 04:56:13 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:Date:Subject:To:From:in-reply-to: references; bh=fUBnh3uBE3R4vs0rtLej1xzUKYGQl+YFrU8kJepPTBg=; b=CGdhgR9V6h24/8 WU+Nt+JWYHwnEN4qvJ3BVd6o8KOuyqW5SzBWG5ejnhiuHAPWIdeIAbFZ4bOmT4o/FiOdbFbDldsEV 72uAa1c6ByON2SdQS8n6Fv4MIk81+B5/CjHCx6hImFa/RDuHzZHxzUnRP1o9wVvq7vydEdYOm0fqu 0qLNzf8GlJOYX2POd+esbJyfUlUA/sAaRKv7ECHRmwDVhLJ2BxOvUX68Qk3cxlMYXbyWC4m0MsS7n zQXSK4XR1MYsqV9ulfb2u8vyXfxfNCfw+TdjhXbxwb19kLPCxyuVWmQhHrXM+0ZSosS2Gg0d8i0fx dmj3jO3A5tzswRIVxuvw==; Received: from 91-160-117-201.subs.proxad.net ([91.160.117.201]:50044 helo=gnu.org) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nPLiP-0006yN-73; Wed, 02 Mar 2022 04:56:13 -0500 From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Date: Wed, 2 Mar 2022 10:55:50 +0100 Message-Id: <20220302095550.17700-1-ludo@gnu.org> X-Mailer: git-send-email 2.34.0 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) * doc/guix.texi (Using TeX and LaTeX): New node. --- doc/guix.texi | 141 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 141 insertions(+) Hello! This patch documents the current state of TeX/LaTeX packaging and tips and tricks to get things done with the modular package set. I’m writing this as an eternal TeX/LaTeX newbie (and as a Lout refugee!) not completely familiar with the intricacies of TeX Live packaging, so this section might need corrections and improvements. It’s a top-level chapter, because I couldn’t find any better place, but I think it’s fine. Thoughts? Ludo’. diff --git a/doc/guix.texi b/doc/guix.texi index 1e8b23ad7e..1c11cc8d5a 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -175,6 +175,7 @@ Weblate} (@pxref{Translating Guix}). * Home Configuration:: Configuring the home environment. * Documentation:: Browsing software user manuals. * Installing Debugging Files:: Feeding the debugger. +* Using TeX and LaTeX:: Typesetting. * Security Updates:: Deploying security fixes quickly. * Bootstrapping:: GNU/Linux built from scratch. * Porting:: Targeting another platform or kernel. @@ -38622,6 +38623,146 @@ Note that there can be packages for which @option{--with-debug-info} will not have the desired effect. @xref{Package Transformation Options, @option{--with-debug-info}}, for more information. +@node Using TeX and LaTeX +@chapter Using @TeX{} and @LaTeX{} + +@cindex @TeX{} packages +@cindex @LaTeX{} packages +Guix provides packages for the @TeX{} and @LaTeX{} typesetting systems, +taken from the @uref{https://www.tug.org/texlive/, @TeX{} Live +distribution}. However, because @TeX{} Live is so huge and because +finding your way in this maze is tricky, we thought that you, dear user, +would welcome guidance on how to deploy the relevant packages so you can +compile your @TeX{} and @LaTeX{} documents. + +@TeX{} Live currently comes in two flavors in Guix: + +@itemize +@item +The ``monolithic'' @code{texlive} package: it comes with @emph{every +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 +commands---@command{pdflatex}, @command{dvips}, @command{luatex}, +@command{mf}, etc.---together with individual packages that provide just +the features you need---@code{texlive-latex-listings} for the +@code{listings} package, @code{texlive-hyperref} for @code{hyperref}, +@code{texlive-beamer} for Beamer, @code{texlive-latex-pgf} for PGF/TikZ, +and so on. +@end itemize + +We recommend using the modular package set because it is much less +resource-hungry. To build your documents, you would use commands such +as: + +@example +guix shell texlive-base texlive-latex-wrapfig \ + texlive-hyperref 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: + +@lisp +(specifications->manifest + '("rubber" + + "texlive-base" + "texlive-latex-wrapfig" + + "texlive-microtype" + "texlive-latex-listings" "texlive-hyperref" + + ;; PGF/TikZ + "texlive-latex-pgf" + + ;; Additional fonts. + "texlive-cm-super" "texlive-amsfonts" + "texlive-times" "texlive-helvetic" "texlive-courier")) +@end lisp + +You can then pass it to any command with the @option{-m} option: + +@example +guix shell -m manifest.scm -- pdflatex doc.tex +@end example + +@xref{Invoking guix package, @option{--manifest}}, 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. + +The main difficulty here is that using the modular package set forces +you to select precisely the packages that you need. You can use +@command{guix search}, but finding the right package can prove to be +tedious. When a package is missing, @command{pdflatex} and similar +commands fail with an obscure message along the lines of: + +@example +doc.tex: File `tikz.sty' not found. +doc.tex:7: Emergency stop. +@end example + +@noindent +or, for a missing font: + +@example +kpathsea: Running mktexmf phvr7t +! I can't find file `phvr7t'. +@end example + +How do you determine what the missing package is? In the first case, +you'll find the answer by running: + +@example +$ guix search texlive tikz +name: texlive-latex-pgf +version: 59745 +@dots{} +@end example + +In the second case, @command{guix search} turns up nothing. Instead, +you can search the @TeX{} Live package database using the @command{tlmgr} +command: + +@example +$ guix shell texlive-base -- tlmgr info phvr7t +tlmgr: cannot find package phvr7t, searching for other matches: + +Packages containing `phvr7t' in their title/description: + +Packages containing files matching `phvr7t': +helvetic: + texmf-dist/fonts/tfm/adobe/helvetic/phvr7t.tfm + texmf-dist/fonts/tfm/adobe/helvetic/phvr7tn.tfm + texmf-dist/fonts/vf/adobe/helvetic/phvr7t.vf + texmf-dist/fonts/vf/adobe/helvetic/phvr7tn.vf +tex4ht: + texmf-dist/tex4ht/ht-fonts/alias/adobe/helvetic/phvr7t.htf +@end example + +The file is available in the @TeX{} Live @code{helvetic} package, which is +known in Guix as @code{texlive-helvetic}. Quite a ride, but we found +it! + +There is one important limitation though: Guix currently provides a +subset of the @TeX{} Live packages. If you stumble upon a missing +package, you can try and import it (@pxref{Invoking guix import}): + +@example +guix import texlive @var{package} +@end example + +@quotation Note +@TeX{} Live packaging is still very much work in progress, but you can +help! @xref{Contributing}, for more information. +@end quotation + @node Security Updates @chapter Security Updates base-commit: a53ea46bfc219a2c184fbf3ce8f3e3ba3f539a7d -- 2.34.0 From unknown Tue Jun 17 22:08:31 2025 X-Loop: help-debbugs@gnu.org Subject: [bug#54220] [PATCH] doc: Add "Using TeX and LaTeX" chapter. Resent-From: Ricardo Wurmus Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Wed, 02 Mar 2022 10:27:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 54220 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: Ludovic =?UTF-8?Q?Court=C3=A8s?= Cc: 54220@debbugs.gnu.org, mail@nicolasgoaziou.fr, bauermann@kolabnow.com X-Debbugs-Original-Cc: debbugs-submit@debbugs.gnu.org, Nicolas Goaziou , 54220@debbugs.gnu.org, Thiago Jung Bauermann Received: via spool by 54220-submit@debbugs.gnu.org id=B54220.164621680731147 (code B ref 54220); Wed, 02 Mar 2022 10:27:01 +0000 Received: (at 54220) by debbugs.gnu.org; 2 Mar 2022 10:26:47 +0000 Received: from localhost ([127.0.0.1]:39171 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nPMBy-00086H-Vp for submit@debbugs.gnu.org; Wed, 02 Mar 2022 05:26:47 -0500 Received: from sender4-of-o51.zoho.com ([136.143.188.51]:21186) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nPMBx-000866-7V; Wed, 02 Mar 2022 05:26:45 -0500 ARC-Seal: i=1; a=rsa-sha256; t=1646216791; cv=none; d=zohomail.com; s=zohoarc; b=lwzNlMdj3Nenr1gT432kobOmyz6muFWA7JIhv10BFhddS/xIxLVv8Ku9oAlvjsPwYMzwISfP25rutgFBSEECNOKxOcMLpmJxLOesGLgHJpmT2QXI+yCCJFqO2KE9oeXBmj29Dav+Y+Ffm1r8lA7Vhw3XcRqrap+QWMHS5DxhYts= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1646216791; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:MIME-Version:Message-ID:References:Subject:To; bh=FAq4IWrAoLIZ6gpoGKrw7OpqyAR6opb/zS4PRbqTX90=; b=lieoeQ1CeOoZ7CpKl8ssEeW8uZ7tiWU9OI/XToixiD6fpoQ4YLzWjbzXTUpJaaDedukUkeUcxzxiOesOQSxVDMqEEE3qWa7fN5m69lM2rksVZbrPZb7AqOc0OAvD3rfptyoZNBH8cnrNNfUl5LfPzr4G0J6haLrFKWqVWv6FuxY= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass header.i=elephly.net; spf=pass smtp.mailfrom=rekado@elephly.net; dmarc=pass header.from= DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; t=1646216791; s=zoho; d=elephly.net; i=rekado@elephly.net; h=References:From:To:Cc:Subject:Date:In-reply-to:Message-ID:MIME-Version:Content-Type:Content-Transfer-Encoding; bh=FAq4IWrAoLIZ6gpoGKrw7OpqyAR6opb/zS4PRbqTX90=; b=DRBSGSB/HvRJrO+4czjDuQp7oL+L+TGRoelwG6DQZldJsQSRB96FmSoaixjStf3x F0hWWs9NdCJjTMYHsy3pRNMsb59L20ReLwHtRxSQ73Ki78bnAvYlQy7MJ5kIS2SRCf3 8fePuni6fBAlcYESrS7DzHdwm9wqq7uJLKyZkSZY= Received: from localhost (p54ad4e6f.dip0.t-ipconnect.de [84.173.78.111]) by mx.zohomail.com with SMTPS id 1646216790075227.5879534750386; Wed, 2 Mar 2022 02:26:30 -0800 (PST) References: <20220302095550.17700-1-ludo@gnu.org> User-agent: mu4e 1.6.10; emacs 28.0.50 From: Ricardo Wurmus Date: Wed, 02 Mar 2022 11:12:46 +0100 In-reply-to: <20220302095550.17700-1-ludo@gnu.org> X-URL: https://elephly.net X-PGP-Key: https://elephly.net/rekado.pubkey X-PGP-Fingerprint: BCA6 89B6 3655 3801 C3C6 2150 197A 5888 235F ACAC Message-ID: <87pmn41wh9.fsf@elephly.net> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-ZohoMailClient: External X-Spam-Score: -0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Ludovic Court=C3=A8s writes: > * doc/guix.texi (Using TeX and LaTeX): New node. Perfect! > It=E2=80=99s a top-level chapter, because I couldn=E2=80=99t find any bet= ter place, but > I think it=E2=80=99s fine. Hmm, maybe in (possibly renamed) =E2=80=9CApplication Setup=E2=80=9D? > +@cindex @TeX{} packages > +@cindex @LaTeX{} packages > +Guix provides packages for the @TeX{} and @LaTeX{} typesetting systems, > +taken from the @uref{https://www.tug.org/texlive/, @TeX{} Live > +distribution}. However, because @TeX{} Live is so huge and because > +finding your way in this maze is tricky, we thought that you, dear user, > +would welcome guidance on how to deploy the relevant packages so you can > +compile your @TeX{} and @LaTeX{} documents. Why single out TeX in particular? TeX Live also includes ConTeXt, Xe(La)TeX, Lua(La)TeX etc. I guess LaTeX is the most widely known and TeX is the common basis of them all, so maybe that=E2=80=99s good enough a reason. > +the features you need---@code{texlive-latex-listings} for the > +@code{listings} package, @code{texlive-hyperref} for @code{hyperref}, > +@code{texlive-beamer} for Beamer, @code{texlive-latex-pgf} for PGF/TikZ, I=E2=80=99d very much like to avoid giving the old names visibility. =E2=80=9Ctexlive-latex-listings=E2=80=9D is old as is =E2=80=9Ctexlive-late= x-pgf=E2=80=9D. It really should be =E2=80=9Ctexlive-listings=E2=80=9D and =E2=80=9Ctexlive-pgf=E2=80= =9D. Previously I had not been aware of the tlpdb, so these packages were literally just an arbitrary slice of the TeX Live SVN repository and thus had to be named according to the directory name to disambiguate the package providing =E2=80=9Ctex/generic/foo=E2=80=9D from the one providing =E2=80=9Ctex/latex= /foo=E2=80=9D. With the svn-multi fetch method we were finally able to fully specify the source for any given TeX Live package by selecting more than one SVN location. Together with the tlpdb, which specifies all locations for a given packgae name, this allowed us to finally include *all* expected files in =E2=80=9Ctexlive-=E2=80=9D packages, and thus removing the need for disambiguation through package name infixes. In short: I=E2=80=99d prefer to deprecate all old names and only mention th= e new names in the documentation to avoid confusion. > +@xref{Invoking guix package, @option{--manifest}}, 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. Working on it! > +@example > +$ guix shell texlive-base -- tlmgr info phvr7t > +tlmgr: cannot find package phvr7t, searching for other matches: > + > +Packages containing `phvr7t' in their title/description: > + > +Packages containing files matching `phvr7t': > +helvetic: > + texmf-dist/fonts/tfm/adobe/helvetic/phvr7t.tfm > + texmf-dist/fonts/tfm/adobe/helvetic/phvr7tn.tfm > + texmf-dist/fonts/vf/adobe/helvetic/phvr7t.vf > + texmf-dist/fonts/vf/adobe/helvetic/phvr7tn.vf > +tex4ht: > + texmf-dist/tex4ht/ht-fonts/alias/adobe/helvetic/phvr7t.htf > +@end example > + > +The file is available in the @TeX{} Live @code{helvetic} package, which = is > +known in Guix as @code{texlive-helvetic}. Quite a ride, but we found > +it! Perfect! Thank you! --=20 Ricardo From unknown Tue Jun 17 22:08:31 2025 X-Loop: help-debbugs@gnu.org Subject: [bug#54220] [PATCH] doc: Add "Using TeX and LaTeX" chapter. Resent-From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Wed, 02 Mar 2022 11:41:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 54220 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: Ricardo Wurmus Cc: mail@nicolasgoaziou.fr, 54220@debbugs.gnu.org, bauermann@kolabnow.com Received: via spool by 54220-submit@debbugs.gnu.org id=B54220.164622123723609 (code B ref 54220); Wed, 02 Mar 2022 11:41:01 +0000 Received: (at 54220) by debbugs.gnu.org; 2 Mar 2022 11:40:37 +0000 Received: from localhost ([127.0.0.1]:39259 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nPNLQ-00068i-W9 for submit@debbugs.gnu.org; Wed, 02 Mar 2022 06:40:37 -0500 Received: from hera.aquilenet.fr ([185.233.100.1]:59346) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nPNLO-00068S-Lb for 54220@debbugs.gnu.org; Wed, 02 Mar 2022 06:40:35 -0500 Received: from localhost (localhost [127.0.0.1]) by hera.aquilenet.fr (Postfix) with ESMTP id 303228EC; Wed, 2 Mar 2022 12:40:28 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at aquilenet.fr Received: from hera.aquilenet.fr ([127.0.0.1]) by localhost (hera.aquilenet.fr [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id UvZZSypxvYoQ; Wed, 2 Mar 2022 12:40:26 +0100 (CET) Received: from ribbon (unknown [IPv6:2a01:e0a:1d:7270:af76:b9b:ca24:c465]) by hera.aquilenet.fr (Postfix) with ESMTPSA id 412BE35D; Wed, 2 Mar 2022 12:40:26 +0100 (CET) From: Ludovic =?UTF-8?Q?Court=C3=A8s?= References: <20220302095550.17700-1-ludo@gnu.org> <87pmn41wh9.fsf@elephly.net> Date: Wed, 02 Mar 2022 12:40:25 +0100 In-Reply-To: <87pmn41wh9.fsf@elephly.net> (Ricardo Wurmus's message of "Wed, 02 Mar 2022 11:12:46 +0100") Message-ID: <877d9c37me.fsf_-_@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spamd-Bar: / Authentication-Results: hera.aquilenet.fr; none X-Rspamd-Server: hera X-Rspamd-Queue-Id: 303228EC X-Spamd-Result: default: False [-0.10 / 15.00]; ARC_NA(0.00)[]; RCVD_VIA_SMTP_AUTH(0.00)[]; FROM_HAS_DN(0.00)[]; RCPT_COUNT_THREE(0.00)[4]; TO_DN_SOME(0.00)[]; TO_MATCH_ENVRCPT_ALL(0.00)[]; MIME_GOOD(-0.10)[text/plain]; FROM_EQ_ENVFROM(0.00)[]; MIME_TRACE(0.00)[0:+]; RCVD_COUNT_TWO(0.00)[2]; RCVD_TLS_ALL(0.00)[]; MID_RHS_MATCH_FROM(0.00)[] X-Spam-Score: 1.0 (+) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.0 (/) Hi! Ricardo Wurmus skribis: > Ludovic Court=C3=A8s writes: [...] >> It=E2=80=99s a top-level chapter, because I couldn=E2=80=99t find any be= tter place, but >> I think it=E2=80=99s fine. > > Hmm, maybe in (possibly renamed) =E2=80=9CApplication Setup=E2=80=9D? =E2=80=9CApplication Setup=E2=80=9D is about configuration on a foreign dis= tro, so I don=E2=80=99t think it=E2=80=99s the right place. Perhaps we need a more general chapter on using things under Guix, where we could also have (say) a =E2=80=9CWorking with Python=E2=80=9D section, a= nd perhaps we could move =E2=80=9CInstalling Debugging Files=E2=80=9D there? I thought I= =E2=80=99d leave that for later. >> +@cindex @TeX{} packages >> +@cindex @LaTeX{} packages >> +Guix provides packages for the @TeX{} and @LaTeX{} typesetting systems, >> +taken from the @uref{https://www.tug.org/texlive/, @TeX{} Live >> +distribution}. However, because @TeX{} Live is so huge and because >> +finding your way in this maze is tricky, we thought that you, dear user, >> +would welcome guidance on how to deploy the relevant packages so you can >> +compile your @TeX{} and @LaTeX{} documents. > > Why single out TeX in particular? You mean LaTeX, right? > TeX Live also includes ConTeXt, Xe(La)TeX, Lua(La)TeX etc. I guess > LaTeX is the most widely known and TeX is the common basis of them > all, so maybe that=E2=80=99s good enough a reason. Yeah, I think to most people it=E2=80=99s all the same :-) and LaTeX is by = far the most famous one. Maybe we could phrase it differently, like =E2=80=9CUsing TeX, LaTeX, and Related Tools=E2=80=9D? >> +the features you need---@code{texlive-latex-listings} for the >> +@code{listings} package, @code{texlive-hyperref} for @code{hyperref}, >> +@code{texlive-beamer} for Beamer, @code{texlive-latex-pgf} for PGF/TikZ, > > I=E2=80=99d very much like to avoid giving the old names visibility. > =E2=80=9Ctexlive-latex-listings=E2=80=9D is old as is =E2=80=9Ctexlive-la= tex-pgf=E2=80=9D. It really > should be =E2=80=9Ctexlive-listings=E2=80=9D and =E2=80=9Ctexlive-pgf=E2= =80=9D. [...] Yeah, I can rename at least these two packages in a first patch (I will have to check the number of rebuilds) and adjust the text to refer to the new names. >> +@xref{Invoking guix package, @option{--manifest}}, 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. > > Working on it! Yay! > Perfect! Thanks, I=E2=80=99m glad it makes sense! Ludo=E2=80=99. From unknown Tue Jun 17 22:08:31 2025 X-Loop: help-debbugs@gnu.org Subject: [bug#54220] [PATCH] doc: Add "Using TeX and LaTeX" chapter. Resent-From: Ricardo Wurmus Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Wed, 02 Mar 2022 12:14:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 54220 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: Ludovic =?UTF-8?Q?Court=C3=A8s?= Cc: mail@nicolasgoaziou.fr, 54220@debbugs.gnu.org, bauermann@kolabnow.com Received: via spool by 54220-submit@debbugs.gnu.org id=B54220.164622324127087 (code B ref 54220); Wed, 02 Mar 2022 12:14:01 +0000 Received: (at 54220) by debbugs.gnu.org; 2 Mar 2022 12:14:01 +0000 Received: from localhost ([127.0.0.1]:39296 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nPNrk-00072p-Do for submit@debbugs.gnu.org; Wed, 02 Mar 2022 07:14:00 -0500 Received: from sender4-of-o51.zoho.com ([136.143.188.51]:21178) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nPNrh-00072f-Uc for 54220@debbugs.gnu.org; Wed, 02 Mar 2022 07:13:58 -0500 ARC-Seal: i=1; a=rsa-sha256; t=1646223222; cv=none; d=zohomail.com; s=zohoarc; b=L89SMux66ffx4aUvLU4nCB5cScwIpMz+BtLIBJlWCbsQV5n6zw4FQpOwBDdQ8KI0zju1aHf/7PRudwIqU3lq4/DISqlgfave1lI9hQsDobc/mBbudvrBGUgTYvcMPSgtMFWarq1nnoPuyWXq639ZX49QDN2K7ORTR6rafKz/FaY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1646223222; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:MIME-Version:Message-ID:References:Subject:To; bh=mYHh7MI2BgfPuC34G3sYN+uhLidKxe5jQsi/SkPZYCc=; b=kWwP32bMzsi3WUSjU7PmFqTTDRbnQMlZ1xMlJga4c08K/ZT9M+gEZyY23jX1DTm8r/Ti8oxWgy/Xvott3+LDUptmhvDwpeyod0P9BTVrprgfqYhTsidjQWB/8zGZ5KVsx9BSoWZ5304DxXNxZ0lMWKObu9Z0Deim1AXD/PE6P04= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass header.i=elephly.net; spf=pass smtp.mailfrom=rekado@elephly.net; dmarc=pass header.from= DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; t=1646223222; s=zoho; d=elephly.net; i=rekado@elephly.net; h=References:From:To:Cc:Subject:Date:In-reply-to:Message-ID:MIME-Version:Content-Type:Content-Transfer-Encoding; bh=mYHh7MI2BgfPuC34G3sYN+uhLidKxe5jQsi/SkPZYCc=; b=Cgx3pF1+6Um0JJdu7t2f2W17jc4fI4M1xgqzxDPuHcE4LDOaTveBD8FdjU05ieM/ 6igckCwqzKXdPPhlgq5V5nhpRY0WGxfHEhW+JiRZVUFKVTdaFLwX7cVjtZaXfF/3w5Q t4v0rpfHT8KSCavWMedy1jiFYszMSyEUfE0B6wqw= Received: from localhost (p54ad4e6f.dip0.t-ipconnect.de [84.173.78.111]) by mx.zohomail.com with SMTPS id 1646223220509498.5634129328407; Wed, 2 Mar 2022 04:13:40 -0800 (PST) References: <20220302095550.17700-1-ludo@gnu.org> <87pmn41wh9.fsf@elephly.net> <877d9c37me.fsf_-_@gnu.org> User-agent: mu4e 1.6.10; emacs 28.0.50 From: Ricardo Wurmus Date: Wed, 02 Mar 2022 13:11:05 +0100 In-reply-to: <877d9c37me.fsf_-_@gnu.org> X-URL: https://elephly.net X-PGP-Key: https://elephly.net/rekado.pubkey X-PGP-Fingerprint: BCA6 89B6 3655 3801 C3C6 2150 197A 5888 235F ACAC Message-ID: <87lexs1rin.fsf@elephly.net> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-ZohoMailClient: External X-Spam-Score: -0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Ludovic Court=C3=A8s writes: >>> It=E2=80=99s a top-level chapter, because I couldn=E2=80=99t find any b= etter place, but >>> I think it=E2=80=99s fine. >> >> Hmm, maybe in (possibly renamed) =E2=80=9CApplication Setup=E2=80=9D? > > =E2=80=9CApplication Setup=E2=80=9D is about configuration on a foreign d= istro, so I > don=E2=80=99t think it=E2=80=99s the right place. > > Perhaps we need a more general chapter on using things under Guix, where > we could also have (say) a =E2=80=9CWorking with Python=E2=80=9D section,= and perhaps we > could move =E2=80=9CInstalling Debugging Files=E2=80=9D there? I thought= I=E2=80=99d leave that > for later. Sounds good. >>> +@cindex @TeX{} packages >>> +@cindex @LaTeX{} packages >>> +Guix provides packages for the @TeX{} and @LaTeX{} typesetting systems, >>> +taken from the @uref{https://www.tug.org/texlive/, @TeX{} Live >>> +distribution}. However, because @TeX{} Live is so huge and because >>> +finding your way in this maze is tricky, we thought that you, dear use= r, >>> +would welcome guidance on how to deploy the relevant packages so you c= an >>> +compile your @TeX{} and @LaTeX{} documents. >> >> Why single out TeX in particular? > > You mean LaTeX, right? Heh, see: that shows how subjective it is :) No, I did mean TeX, because in my experience it is extremely uncommon to use TeX directly. >> TeX Live also includes ConTeXt, Xe(La)TeX, Lua(La)TeX etc. I guess >> LaTeX is the most widely known and TeX is the common basis of them >> all, so maybe that=E2=80=99s good enough a reason. > > Yeah, I think to most people it=E2=80=99s all the same :-) and LaTeX is b= y far > the most famous one. > > Maybe we could phrase it differently, like =E2=80=9CUsing TeX, LaTeX, and > Related Tools=E2=80=9D? Nah, it=E2=80=99s fine. By the time I wrote the last sentence you quoted a= bove I had convinced myself that it=E2=80=99s fine to mention TeX (because it=E2= =80=99s the foundation) and LaTeX (because it=E2=80=99s the most popular). >>> +the features you need---@code{texlive-latex-listings} for the >>> +@code{listings} package, @code{texlive-hyperref} for @code{hyperref}, >>> +@code{texlive-beamer} for Beamer, @code{texlive-latex-pgf} for PGF/Tik= Z, >> >> I=E2=80=99d very much like to avoid giving the old names visibility. >> =E2=80=9Ctexlive-latex-listings=E2=80=9D is old as is =E2=80=9Ctexlive-l= atex-pgf=E2=80=9D. It really >> should be =E2=80=9Ctexlive-listings=E2=80=9D and =E2=80=9Ctexlive-pgf=E2= =80=9D. > > [...] > > Yeah, I can rename at least these two packages in a first patch (I will > have to check the number of rebuilds) and adjust the text to refer to > the new names. Thanks. --=20 Ricardo From unknown Tue Jun 17 22:08:31 2025 X-Loop: help-debbugs@gnu.org Subject: [bug#54220] [PATCH] doc: Add "Using TeX and LaTeX" chapter. Resent-From: zimoun Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Wed, 02 Mar 2022 13:43:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 54220 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: Ricardo Wurmus Cc: Ludovic =?UTF-8?Q?Court=C3=A8s?= , Nicolas Goaziou , 54220@debbugs.gnu.org, Thiago Jung Bauermann Received: via spool by 54220-submit@debbugs.gnu.org id=B54220.164622856311527 (code B ref 54220); Wed, 02 Mar 2022 13:43:01 +0000 Received: (at 54220) by debbugs.gnu.org; 2 Mar 2022 13:42:43 +0000 Received: from localhost ([127.0.0.1]:39398 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nPPFb-0002zr-0I for submit@debbugs.gnu.org; Wed, 02 Mar 2022 08:42:43 -0500 Received: from mail-io1-f44.google.com ([209.85.166.44]:43799) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nPPFZ-0002zf-IA for 54220@debbugs.gnu.org; Wed, 02 Mar 2022 08:42:42 -0500 Received: by mail-io1-f44.google.com with SMTP id m185so1786613iof.10 for <54220@debbugs.gnu.org>; Wed, 02 Mar 2022 05:42:41 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc:content-transfer-encoding; bh=mTCPqRfk6k47sLwH+jG7jbo7JKa9GhFu+geGddqtr2M=; b=mP/CcZcJYpGpY1eEry7I7zyFpwD8MlmYi8tMwEDotsAgB4W9zvT34Q/ZL6LuIyaFb6 WCscOLviT42txYvNyTB1bovBZJ6PQO3ZBXwHEyEzJcF7dVsbS7qVfzf+FMXNd7TQJMK/ kvu/o6UBdklMa5xroW5vz9p2AanUQOt2alziGq5iTE8DVqagYaB/xGz8ALJ/5lzrP5jM IC49GUDc/toyZjSMLYqh17J36S/E5NsRztzsIPqllTaD24UjhNrpzx+OUxBeINpAIrt4 xhIWWBRNSftm5qjo3gEp3GTgfCH0yQea2SjV4KNXAmrf10ugBwK9egnOsfZPuXu5pGHT R+aQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc:content-transfer-encoding; bh=mTCPqRfk6k47sLwH+jG7jbo7JKa9GhFu+geGddqtr2M=; b=6T4m414Pw+CGxYl24uSHbnOs9GAMbMbtttBZDBMqTMgb6VfefLSP/6t5zcJxKSYNLB ulcpifSQYULGF0sWGP/pOxe94CPAnflUwQnrZqm6j49j50UVriocDBeVRPXLraPeMYU7 CyhEN45u0TXQgl+C4vC4cFBF6hpMgqX2iqFto8Xb8aSg3OFQ1KMEp4UD28umd1OYgsR6 J4b2j/RRH57CjFnMi2tGqCQuLPvthAE+wUsqxDt62Jw28vvmSFytsNRnwOs1rBeRrQMz b6pQdBDCCpURkkYj1y6fvT20mOvWNvsc/euSRGD3CFkJEblKBFqj0GzXcZwd7cd3KODP ifdA== X-Gm-Message-State: AOAM532GyC0mk7BjDCPNJeFEFoBFqh53Z/UN3hucOSA6XacvtCfaYzw+ 0lXWcSmcS09LPFBJA6XX7oAbR0KVeS1asheCTGg= X-Google-Smtp-Source: ABdhPJzy3cyHiQHOf9OfkJk431vtSEtgdsovJ7YEs2GBCusJcPAn+i8YVDQ30qKF+ZKAgp9LBZdiXkHFYuABPJ7O5o0= X-Received: by 2002:a02:cd91:0:b0:314:2535:6f75 with SMTP id l17-20020a02cd91000000b0031425356f75mr24451427jap.307.1646228555714; Wed, 02 Mar 2022 05:42:35 -0800 (PST) MIME-Version: 1.0 References: <20220302095550.17700-1-ludo@gnu.org> <87pmn41wh9.fsf@elephly.net> In-Reply-To: <87pmn41wh9.fsf@elephly.net> From: zimoun Date: Wed, 2 Mar 2022 14:42:24 +0100 Message-ID: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Spam-Score: -0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Hi, Cool! It is better than pinging Ricardo on IRC. ;-) On Wed, 2 Mar 2022 at 11:27, Ricardo Wurmus wrote: > > It=E2=80=99s a top-level chapter, because I couldn=E2=80=99t find any b= etter place, but > > I think it=E2=80=99s fine. > > Hmm, maybe in (possibly renamed) =E2=80=9CApplication Setup=E2=80=9D? This section starts with: When using Guix on top of GNU/Linux distribution other than Guix System=E2=80=94a so-called foreign distro=E2=80=94a few additional = steps are needed to get everything in place. Here are some of them. and the TeX/LaTeX is not foreign distro specific. Therefore, some tweaks are necessary to clearly state what is foreign-distro specific and what is generic with Guix. > > +@cindex @TeX{} packages > > +@cindex @LaTeX{} packages > > +Guix provides packages for the @TeX{} and @LaTeX{} typesetting systems= , > > +taken from the @uref{https://www.tug.org/texlive/, @TeX{} Live > > +distribution}. However, because @TeX{} Live is so huge and because > > +finding your way in this maze is tricky, we thought that you, dear use= r, > > +would welcome guidance on how to deploy the relevant packages so you c= an > > +compile your @TeX{} and @LaTeX{} documents. > > Why single out TeX in particular? TeX Live also includes ConTeXt, > Xe(La)TeX, Lua(La)TeX etc. I guess LaTeX is the most widely known and > TeX is the common basis of them all, so maybe that=E2=80=99s good enough = a > reason. I propose "and LaTeX" -> "and variants". Or something along that. And probably adds a list with all the variant since it is not straightforward to know how to get these TeX system variants. Cheers, simon From unknown Tue Jun 17 22:08:31 2025 X-Loop: help-debbugs@gnu.org Subject: [bug#54220] [PATCH] doc: Add "Using TeX and LaTeX" chapter. Resent-From: zimoun Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Wed, 02 Mar 2022 13:47:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 54220 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: Ricardo Wurmus Cc: Ludovic =?UTF-8?Q?Court=C3=A8s?= , 54220@debbugs.gnu.org, Nicolas Goaziou , Thiago Jung Bauermann Received: via spool by 54220-submit@debbugs.gnu.org id=B54220.164622877311877 (code B ref 54220); Wed, 02 Mar 2022 13:47:02 +0000 Received: (at 54220) by debbugs.gnu.org; 2 Mar 2022 13:46:13 +0000 Received: from localhost ([127.0.0.1]:39402 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nPPIz-00035V-HT for submit@debbugs.gnu.org; Wed, 02 Mar 2022 08:46:13 -0500 Received: from mail-io1-f45.google.com ([209.85.166.45]:43792) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nPPIx-00035G-Ux for 54220@debbugs.gnu.org; Wed, 02 Mar 2022 08:46:12 -0500 Received: by mail-io1-f45.google.com with SMTP id m185so1797966iof.10 for <54220@debbugs.gnu.org>; Wed, 02 Mar 2022 05:46:11 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=yAdGxdZXlnk+aZbbbot1AzSZpxKfvQx+XKOgmN2EJTw=; b=cdE3jvLj4oJronH2jEotbrxA15C2HOijCgKxnXEXYUhtEF3MeZYBvsJv5pN9vU2IOX aaIez9K6Jw+xYt4FMoRgZKXyGB8vYjvwt8PorG5m4WZFKSs9Z46vOn+KSVvPMMJZrH5S NwM6ubdLfqAPHKfYNQTOakQ4UXUX/T3ixQNsPeM/HbHgE/f1couVk7iHu9KAjzGwmJHu 1s2yGK6cYzFHtrDLInUieyeiUPWSGnZC2ImQadKWQayEr9R8EbiWYJ/XKhHTrzGstocP s5bwJYGaw7dNhYhDaxznxIfTBFDKoPbGIdltrho9edHlq6YdNmkx8DYb39ohzCgiYYsX qcAg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=yAdGxdZXlnk+aZbbbot1AzSZpxKfvQx+XKOgmN2EJTw=; b=hA8wtxiwL+fk6caQH1Z0z9QuDZ/LofxLRqPLWfFOIq+b69YHpFkoytQtT7d9O9fkZw /TsC9Q3kpYE+qL9paLUKyrJb5qm/2Al9r+FOJY6tj1fkxaIq3QCbrw2GrdwUeff2YOSD tgYU7L9kIQ33+oGxJx3/7Pc7lKeseBEbo2zIkpMdsFWQ9Gpy27dKAXIrMUFsRoyASbuj W0v56Wz3e2/+7dt/V+hR8QqtD67rM6KQM0T3UgV2BmMGjs0zcqOBFE6s7UTbAJtJdz6Y C5+GYszckBJn/eSTdzZqPGKrUUEv8MPTayX7hXd5Vu+gbUcSUbuJmRYvvkV4BwcF02G6 BXKg== X-Gm-Message-State: AOAM531qm4/n/i+fzv2yYvtnAwuhRLeIKFhYaFL/CMe+n++pcythT58f IpfzdIrWIofBCdxB7RcfsZmrIwiwntjRxCPV0yo= X-Google-Smtp-Source: ABdhPJyaKa0uchjE4VpQ7H2ljqm/eW8x6ffQBAdoVEtjat88EavrrEgr5wEcMAT9CQcya+d9TMYqwqP6ZS6GhRumTC0= X-Received: by 2002:a02:cd91:0:b0:314:2535:6f75 with SMTP id l17-20020a02cd91000000b0031425356f75mr24461508jap.307.1646228766453; Wed, 02 Mar 2022 05:46:06 -0800 (PST) MIME-Version: 1.0 References: <20220302095550.17700-1-ludo@gnu.org> <87pmn41wh9.fsf@elephly.net> <877d9c37me.fsf_-_@gnu.org> <87lexs1rin.fsf@elephly.net> In-Reply-To: <87lexs1rin.fsf@elephly.net> From: zimoun Date: Wed, 2 Mar 2022 14:45:55 +0100 Message-ID: Content-Type: text/plain; charset="UTF-8" X-Spam-Score: -0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) On Wed, 2 Mar 2022 at 14:31, Ricardo Wurmus wrote: > >> Why single out TeX in particular? > > > > You mean LaTeX, right? > > Heh, see: that shows how subjective it is :) No, I did mean TeX, because > in my experience it is extremely uncommon to use TeX directly. I propose to use "TeX system or its variants" and provides elsewhere in the text the list of these variants (ConTeX, LuaTeX, etc.) and in future patch provides more explanations on how to use these variants. Cheers, simon From unknown Tue Jun 17 22:08:31 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Ludovic =?UTF-8?Q?Court=C3=A8s?= Subject: bug#54220: closed (Re: bug#54220: [PATCH] doc: Add "Using TeX and LaTeX" chapter.) Message-ID: References: <87y21syzru.fsf_-_@gnu.org> <20220302095550.17700-1-ludo@gnu.org> X-Gnu-PR-Message: they-closed 54220 X-Gnu-PR-Package: guix-patches X-Gnu-PR-Keywords: patch Reply-To: 54220@debbugs.gnu.org Date: Wed, 02 Mar 2022 18:30:03 +0000 Content-Type: multipart/mixed; boundary="----------=_1646245803-8467-1" This is a multi-part message in MIME format... ------------=_1646245803-8467-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #54220: [PATCH] doc: Add "Using TeX and LaTeX" chapter. which was filed against the guix-patches package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 54220@debbugs.gnu.org. --=20 54220: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D54220 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1646245803-8467-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 54220-done) by debbugs.gnu.org; 2 Mar 2022 18:29:03 +0000 Received: from localhost ([127.0.0.1]:40724 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nPTih-0002AL-Lg for submit@debbugs.gnu.org; Wed, 02 Mar 2022 13:29:03 -0500 Received: from hera.aquilenet.fr ([185.233.100.1]:40232) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nPTif-00029m-KU for 54220-done@debbugs.gnu.org; Wed, 02 Mar 2022 13:29:02 -0500 Received: from localhost (localhost [127.0.0.1]) by hera.aquilenet.fr (Postfix) with ESMTP id 14580B3C; Wed, 2 Mar 2022 19:28:55 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at aquilenet.fr Received: from hera.aquilenet.fr ([127.0.0.1]) by localhost (hera.aquilenet.fr [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id YrUrrVP6jGOl; Wed, 2 Mar 2022 19:28:54 +0100 (CET) Received: from ribbon (91-160-117-201.subs.proxad.net [91.160.117.201]) by hera.aquilenet.fr (Postfix) with ESMTPSA id C43E7264; Wed, 2 Mar 2022 19:28:53 +0100 (CET) From: =?utf-8?Q?Ludovic_Court=C3=A8s?= To: Ricardo Wurmus Subject: Re: bug#54220: [PATCH] doc: Add "Using TeX and LaTeX" chapter. References: <20220302095550.17700-1-ludo@gnu.org> <87pmn41wh9.fsf@elephly.net> <877d9c37me.fsf_-_@gnu.org> <87lexs1rin.fsf@elephly.net> Date: Wed, 02 Mar 2022 19:28:53 +0100 In-Reply-To: <87lexs1rin.fsf@elephly.net> (Ricardo Wurmus's message of "Wed, 02 Mar 2022 13:11:05 +0100") Message-ID: <87y21syzru.fsf_-_@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spamd-Bar: + X-Spam-Level: * X-Rspamd-Server: hera Authentication-Results: hera.aquilenet.fr; none X-Rspamd-Queue-Id: 14580B3C X-Spamd-Result: default: False [1.40 / 15.00]; ARC_NA(0.00)[]; RCVD_VIA_SMTP_AUTH(0.00)[]; FREEMAIL_CC(0.00)[nicolasgoaziou.fr,debbugs.gnu.org,kolabnow.com,gmail.com]; FROM_HAS_DN(0.00)[]; TO_DN_SOME(0.00)[]; FREEMAIL_ENVRCPT(0.00)[gmail.com]; TO_MATCH_ENVRCPT_ALL(0.00)[]; TAGGED_RCPT(0.00)[]; MIME_GOOD(-0.10)[text/plain]; RCPT_COUNT_FIVE(0.00)[5]; FROM_EQ_ENVFROM(0.00)[]; MIME_TRACE(0.00)[0:+]; RCVD_COUNT_TWO(0.00)[2]; RCVD_TLS_ALL(0.00)[]; MID_RHS_MATCH_FROM(0.00)[]; SUSPICIOUS_RECIPS(1.50)[] X-Spam-Score: 1.0 (+) X-Debbugs-Envelope-To: 54220-done Cc: zimoun , 54220-done@debbugs.gnu.org, mail@nicolasgoaziou.fr, bauermann@kolabnow.com X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.0 (/) Ricardo Wurmus skribis: > Ludovic Court=C3=A8s writes: [...] >>> Why single out TeX in particular? >> >> You mean LaTeX, right? > > Heh, see: that shows how subjective it is :) No, I did mean TeX, because > in my experience it is extremely uncommon to use TeX directly. Ah! I mentioned TeX because technically it=E2=80=99s the basis of everythi= ng. > Nah, it=E2=80=99s fine. By the time I wrote the last sentence you quoted= above > I had convinced myself that it=E2=80=99s fine to mention TeX (because it= =E2=80=99s the > foundation) and LaTeX (because it=E2=80=99s the most popular). Alright. I went ahead and pushed an updated version as f0efa6afc5f180f778eb320631a71f42bf1b211f. I kept the section title, but explicitly mentioned ConTeXt and LuaTeX in the first paragraph. This is a starting point anyway, so everyone please feel free to update it as you see fit or when things change. Thanks for the quick feedback! Ludo=E2=80=99. ------------=_1646245803-8467-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 2 Mar 2022 09:56:17 +0000 Received: from localhost ([127.0.0.1]:39128 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nPLiS-0007Ik-KG for submit@debbugs.gnu.org; Wed, 02 Mar 2022 04:56:17 -0500 Received: from lists.gnu.org ([209.51.188.17]:39964) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nPLiQ-0007Ic-FN for submit@debbugs.gnu.org; Wed, 02 Mar 2022 04:56:15 -0500 Received: from eggs.gnu.org ([209.51.188.92]:41530) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nPLiQ-000389-6d for guix-patches@gnu.org; Wed, 02 Mar 2022 04:56:14 -0500 Received: from [2001:470:142:3::e] (port=54766 helo=fencepost.gnu.org) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nPLiP-0002vq-OS; Wed, 02 Mar 2022 04:56:13 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:Date:Subject:To:From:in-reply-to: references; bh=fUBnh3uBE3R4vs0rtLej1xzUKYGQl+YFrU8kJepPTBg=; b=CGdhgR9V6h24/8 WU+Nt+JWYHwnEN4qvJ3BVd6o8KOuyqW5SzBWG5ejnhiuHAPWIdeIAbFZ4bOmT4o/FiOdbFbDldsEV 72uAa1c6ByON2SdQS8n6Fv4MIk81+B5/CjHCx6hImFa/RDuHzZHxzUnRP1o9wVvq7vydEdYOm0fqu 0qLNzf8GlJOYX2POd+esbJyfUlUA/sAaRKv7ECHRmwDVhLJ2BxOvUX68Qk3cxlMYXbyWC4m0MsS7n zQXSK4XR1MYsqV9ulfb2u8vyXfxfNCfw+TdjhXbxwb19kLPCxyuVWmQhHrXM+0ZSosS2Gg0d8i0fx dmj3jO3A5tzswRIVxuvw==; Received: from 91-160-117-201.subs.proxad.net ([91.160.117.201]:50044 helo=gnu.org) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nPLiP-0006yN-73; Wed, 02 Mar 2022 04:56:13 -0500 From: =?UTF-8?q?Ludovic=20Court=C3=A8s?= To: guix-patches@gnu.org Subject: [PATCH] doc: Add "Using TeX and LaTeX" chapter. Date: Wed, 2 Mar 2022 10:55:50 +0100 Message-Id: <20220302095550.17700-1-ludo@gnu.org> X-Mailer: git-send-email 2.34.0 MIME-Version: 1.0 X-Debbugs-Cc: Ricardo Wurmus , Nicolas Goaziou , Thiago Jung Bauermann Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: submit Cc: =?UTF-8?q?Ludovic=20Court=C3=A8s?= X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) * doc/guix.texi (Using TeX and LaTeX): New node. --- doc/guix.texi | 141 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 141 insertions(+) Hello! This patch documents the current state of TeX/LaTeX packaging and tips and tricks to get things done with the modular package set. I’m writing this as an eternal TeX/LaTeX newbie (and as a Lout refugee!) not completely familiar with the intricacies of TeX Live packaging, so this section might need corrections and improvements. It’s a top-level chapter, because I couldn’t find any better place, but I think it’s fine. Thoughts? Ludo’. diff --git a/doc/guix.texi b/doc/guix.texi index 1e8b23ad7e..1c11cc8d5a 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -175,6 +175,7 @@ Weblate} (@pxref{Translating Guix}). * Home Configuration:: Configuring the home environment. * Documentation:: Browsing software user manuals. * Installing Debugging Files:: Feeding the debugger. +* Using TeX and LaTeX:: Typesetting. * Security Updates:: Deploying security fixes quickly. * Bootstrapping:: GNU/Linux built from scratch. * Porting:: Targeting another platform or kernel. @@ -38622,6 +38623,146 @@ Note that there can be packages for which @option{--with-debug-info} will not have the desired effect. @xref{Package Transformation Options, @option{--with-debug-info}}, for more information. +@node Using TeX and LaTeX +@chapter Using @TeX{} and @LaTeX{} + +@cindex @TeX{} packages +@cindex @LaTeX{} packages +Guix provides packages for the @TeX{} and @LaTeX{} typesetting systems, +taken from the @uref{https://www.tug.org/texlive/, @TeX{} Live +distribution}. However, because @TeX{} Live is so huge and because +finding your way in this maze is tricky, we thought that you, dear user, +would welcome guidance on how to deploy the relevant packages so you can +compile your @TeX{} and @LaTeX{} documents. + +@TeX{} Live currently comes in two flavors in Guix: + +@itemize +@item +The ``monolithic'' @code{texlive} package: it comes with @emph{every +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 +commands---@command{pdflatex}, @command{dvips}, @command{luatex}, +@command{mf}, etc.---together with individual packages that provide just +the features you need---@code{texlive-latex-listings} for the +@code{listings} package, @code{texlive-hyperref} for @code{hyperref}, +@code{texlive-beamer} for Beamer, @code{texlive-latex-pgf} for PGF/TikZ, +and so on. +@end itemize + +We recommend using the modular package set because it is much less +resource-hungry. To build your documents, you would use commands such +as: + +@example +guix shell texlive-base texlive-latex-wrapfig \ + texlive-hyperref 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: + +@lisp +(specifications->manifest + '("rubber" + + "texlive-base" + "texlive-latex-wrapfig" + + "texlive-microtype" + "texlive-latex-listings" "texlive-hyperref" + + ;; PGF/TikZ + "texlive-latex-pgf" + + ;; Additional fonts. + "texlive-cm-super" "texlive-amsfonts" + "texlive-times" "texlive-helvetic" "texlive-courier")) +@end lisp + +You can then pass it to any command with the @option{-m} option: + +@example +guix shell -m manifest.scm -- pdflatex doc.tex +@end example + +@xref{Invoking guix package, @option{--manifest}}, 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. + +The main difficulty here is that using the modular package set forces +you to select precisely the packages that you need. You can use +@command{guix search}, but finding the right package can prove to be +tedious. When a package is missing, @command{pdflatex} and similar +commands fail with an obscure message along the lines of: + +@example +doc.tex: File `tikz.sty' not found. +doc.tex:7: Emergency stop. +@end example + +@noindent +or, for a missing font: + +@example +kpathsea: Running mktexmf phvr7t +! I can't find file `phvr7t'. +@end example + +How do you determine what the missing package is? In the first case, +you'll find the answer by running: + +@example +$ guix search texlive tikz +name: texlive-latex-pgf +version: 59745 +@dots{} +@end example + +In the second case, @command{guix search} turns up nothing. Instead, +you can search the @TeX{} Live package database using the @command{tlmgr} +command: + +@example +$ guix shell texlive-base -- tlmgr info phvr7t +tlmgr: cannot find package phvr7t, searching for other matches: + +Packages containing `phvr7t' in their title/description: + +Packages containing files matching `phvr7t': +helvetic: + texmf-dist/fonts/tfm/adobe/helvetic/phvr7t.tfm + texmf-dist/fonts/tfm/adobe/helvetic/phvr7tn.tfm + texmf-dist/fonts/vf/adobe/helvetic/phvr7t.vf + texmf-dist/fonts/vf/adobe/helvetic/phvr7tn.vf +tex4ht: + texmf-dist/tex4ht/ht-fonts/alias/adobe/helvetic/phvr7t.htf +@end example + +The file is available in the @TeX{} Live @code{helvetic} package, which is +known in Guix as @code{texlive-helvetic}. Quite a ride, but we found +it! + +There is one important limitation though: Guix currently provides a +subset of the @TeX{} Live packages. If you stumble upon a missing +package, you can try and import it (@pxref{Invoking guix import}): + +@example +guix import texlive @var{package} +@end example + +@quotation Note +@TeX{} Live packaging is still very much work in progress, but you can +help! @xref{Contributing}, for more information. +@end quotation + @node Security Updates @chapter Security Updates base-commit: a53ea46bfc219a2c184fbf3ce8f3e3ba3f539a7d -- 2.34.0 ------------=_1646245803-8467-1--