Difference between revisions of "Debian installation"

From Wiki
Jump to navigation Jump to search
(use .debs instead of building from source)
 
(63 intermediate revisions by 14 users not shown)
Line 1: Line 1:
== Use TeXLive packages ==
+
{{note|Releases of Debian (or any other distribution for that matter) usually contain way too old TeX distributions for ConTeXt MKIV (but should work fine for MKII). If you want to live on bleeding edge, consider using the packages from Debian/unstable, [[ConTeXt Standalone]], or at least install the latest version of [[TeX Live]] with [[TLContrib]] manually.}}
 
 
The context packages depend on [http://www.tug.org/texlive TeXLive], so if you are using the Debian teTeX packages (e.g. see whether tetex-base is installed by doing "dpkg -l tetex-base"), it's time to make the change to TeXLive.  You'll have to do it eventually since teTeX 3.0 will be its last upstream release.  So if not now, when?
 
 
 
The directions for using TeXLive are at http://www.tug.org/texlive/debian.html
 
 
 
Make sure you install the texlive-metapost package if you do not have it already.
 
 
 
 
 
 
 
== Install a [[Latin Modern]] font update ==
 
 
 
Do
 
<code>
 
  # apt-get install lmodern cm-super
 
</code>
 
  
 
== Install the ConTeXt packages ==
 
== Install the ConTeXt packages ==
  
Norbert Preining has produced reliable, complete ConTeXt packages for Debian, and they use very recent versions of ConTeXt (as of this writing, which is 2007.01.05, the latest package has the 2007.01.02 version of ConTeXt).  Here's how to use them.  Add these two lines to your /etc/apt/sources.list :
+
The status of ConTeXt in Debian/unstable is currently up to date with TeX Live 2021, and includes all the necessary bits and pieces, plus the modules shipped in TeX Live.
 
 
  deb <nowiki>http://www.tug.org/texlive/Debian/</nowiki> context/
 
  deb-src <nowiki>http://www.tug.org/texlive/Debian/</nowiki> context/
 
  
 +
If you are running Debian sid or later, then the <code>context</code> and <code>context-modules</code> packages should already be visible.
 
Then do
 
Then do
  
  apt-get update
+
aptitude update
  apt-get install context context-nonfree context-doc-nonfree
+
aptitude install context context-modules
 
 
and apt will download and install the latest ConTeXt packages.
 
 
 
== Steps to finish a first context upgrade ==
 
 
 
The Debian tetex-3.0 package (and probably the vanilla tetex-3.0) in combination with <tt>texexec</tt> puts user-generated format files in <tt>~/.texmf-var/web2c/<i>engine</i></tt> where <i>engine</i> is typically <tt>pdfetex</tt>.  (If you don't have such a directory, and you are using the default tetex configuration, tell the mailing list so that this installation information can be corrected!)
 
 
 
The default <tt>tetex</tt> setup doesn't know about such locations (it doesn't know what it should), and it instead knows about other locations (it knows what it shouldn't).  Here is how to fix both problems.
 
 
 
=== Older context formats ===
 
 
 
There may be older context formats lying around, and the path searching code may find these older ones instead of the new ones lovingy made by <tt>texexec</tt>.
 
 
 
==== Deleting the older context formats ====
 
 
 
So you need delete the older ones.  But where are they?
 
 
 
When I ran <tt>texexec</tt>, it made <tt>cont-en.fmt</tt>, <tt>cont-nl.fmt</tt>, and <tt>mptopdf.fmt</tt> in <tt>~/.texmf-var/web2c/pdfetex/</tt> and they were shadowed by the older versions: <tt>~/.texmf-var/web2c/cont-en.fmt</tt>, etc.  So I deleted the older ones. 
 
 
 
If you cannot find them, use <tt>kpsewhich cont-en.fmt</tt> (and similarly for the other formats).  Run the <tt>kpsewhich</tt> from a 'typical' directory (e.g. your home directory), rather than from <tt>~/.texmf-var/web2c/pdfetex/</tt> (adjust for your engine), otherwise it will find the newly created formats before any others.
 
 
 
==== Stopping fmtutil from making context-related formats ====
 
 
 
But how did the older ones get there?  <tt>fmtutil</tt>
 
 
 
And will it happen again?  Yes, though perhaps rarely (the most frustrating kind of bug).  At the next upgrade of <tt>tetex</tt>, which happens frequenty on Debian, the installation scripts will rerun <tt>fmtutil</tt> as root.  That probably won't cause you trouble because the formats generated will go in a system-wide format directory (e.g. in <tt>/var/lib/texmf/web2c/</tt>), and your new ones will override them once you finish these steps. 
 
 
 
However, if you, as an ordinary user, run <tt>texconfig</tt>, say to change your own default paper size from <tt>letter</tt> to <tt>a4</tt>, then <tt>tetex</tt> will regenerate all formats for you and put them in your format location <tt>~/.texmf-var/web2c/</tt> (without using the engine subdirectory).  And you're in the soup again.
 
 
 
So stop <tt>fmtutil</tt> from making any context-related formats, and let <tt>texexec</tt> handle it.  On standard <tt>tetex</tt> setups, you'd edit <tt>fmtutil.cnf</tt> (probaby in <tt>/var/lib/texmf/web2c/</tt>), but on Debian systems, that file is autogenerated from configlets (tiny pieces of a config file) living in <tt>/etc/texmf/fmt.d/</tt>. 
 
 
 
As <tt>root</tt>:
 
  
  emacs -nw /etc/texmf/fmt.d/01tetex.cnf
+
* The final version in debian bullseye (aka debian stable 11.2) is 2020.03.10.20200331-1
 +
* In ''unstable'' is a version that is from the TeX Live 2021
  
(or choose your favorite editor). Comment out (with a <tt>#!</tt>) the lines for <tt>mptopdf</tt>, <tt>metafun</tt>, <tt>cont-en</tt>, and any other <tt>cont-*</tt> formats not already commented out.  Now generate a new system-wide configuration file:
+
=== Install latest unstable context .deb package ===
  
  update-fmtutil
+
<tt>unstable</tt> means ''(mature) development'', the version number may changes. The software is ''stable''
  
=== Finding the new formats ===
+
1. Download the two .deb-s
 +
http://packages.debian.org/unstable/all/context/download
 +
http://packages.debian.org/unstable/all/context-modules/download
  
The path searching code will not find the newer formats because the code doesn't search subdirectories of <tt>web2c/</tt>. The simple fix, telling it to search all subdirectories, does not work: Context may use several different engines, e.g. <tt>pdfetex</tt> or <tt>xetex</tt>, each with a set of formats, and you want <tt>texexec</tt> to find the correct set. If it searches all subdirectories, it will use the first set that it happens to run across, which may not match the engine that you use. Instead the searches should look in the subdirectory chosen according to the <i>engine</i>.   
+
2. run as root (the version number might have increased a bit)
 +
  dpkg --install context_2021.03.05.20220211-1_all.deb
 +
  mtxrun --generate
  
To specify this kind of search, you'd normally edit <tt>texmf.cnf</tt> directly, but Debian uses configlets for itSo edit (still as root) the <tt>TEXFORMATS</tt> line in <tt>/etc/texmf/texmf.d/45TeXinputs.cnf</tt> to include this magic:
+
3. run as user
 +
  mtxrun --generate
  
  TEXFORMATS = .;$TEXMF/web2c/{$engine,}
+
Step 2. is currently still necessary, but soon an update of tex-common will run mtxrun --generate automatically when packages have changed (like mktexlsr), and there will be no need to run this anymore.
 
 
It says to look first in the <i>engine</i> subdirectory, then in the <tt>web2c</tt> directory itself.  Now generate a new <tt>texmf.cnf</tt> configuration file (still as root):
 
  
  update-texmf
+
Step 3. needs to be done only when you have files in TEXMFHOME or you change things there.
  
That step generates a new <tt>/etc/texmf/texmf.cnf</tt>, which Debian symlinks from its standard tetex location <tt>/usr/share/texmf/web2c/texmf.cnf</tt>.  With luck, you are done.  In the next section you will check whether everything is working by running <tt>texexec --version</tt> (as yourself, not as root!).
+
You have now a system wide context-installation!
  
== Finished! ==
+
== See also ==
  
That should do it! The output of <code>texexec --version</code> (run as you, not as root) is hopefully like this:
+
{{Installation navbox}}
<code>
 
TeXExec 5.4.3 - ConTeXt / PRAGMA ADE 1997-2005
 
              texexec : TeXExec 5.4.3 - ConTeXt / PRAGMA ADE 1997-2005
 
              texutil : TeXUtil 9.0.0 - ConTeXt / PRAGMA ADE 1992-2004
 
                  tex : pdfeTeXk, 3.141592-1.30.4-2.2 (Web2C 7.5.5)
 
              context : ver: 2005.10.27
 
              cont-en : ver: 2005.10.27  fmt: 2005.11.1  mes: english
 
</code>
 
  
 
[[Category:Installation]]
 
[[Category:Installation]]
See also the [[Debian TeXlive install]] page.
 

Latest revision as of 00:46, 14 February 2022


NOTE: Releases of Debian (or any other distribution for that matter) usually contain way too old TeX distributions for ConTeXt MKIV (but should work fine for MKII). If you want to live on bleeding edge, consider using the packages from Debian/unstable, ConTeXt Standalone, or at least install the latest version of TeX Live with TLContrib manually.

Install the ConTeXt packages

The status of ConTeXt in Debian/unstable is currently up to date with TeX Live 2021, and includes all the necessary bits and pieces, plus the modules shipped in TeX Live.

If you are running Debian sid or later, then the context and context-modules packages should already be visible. Then do

aptitude update
aptitude install context context-modules
  • The final version in debian bullseye (aka debian stable 11.2) is 2020.03.10.20200331-1
  • In unstable is a version that is from the TeX Live 2021

Install latest unstable context .deb package

unstable means (mature) development, the version number may changes. The software is stable

1. Download the two .deb-s http://packages.debian.org/unstable/all/context/download http://packages.debian.org/unstable/all/context-modules/download

2. run as root (the version number might have increased a bit)

dpkg --install context_2021.03.05.20220211-1_all.deb
mtxrun --generate

3. run as user

mtxrun --generate

Step 2. is currently still necessary, but soon an update of tex-common will run mtxrun --generate automatically when packages have changed (like mktexlsr), and there will be no need to run this anymore.

Step 3. needs to be done only when you have files in TEXMFHOME or you change things there.

You have now a system wide context-installation!

See also