(→‎Recent "langukenglish" errors: remove outdated section: /usr/share/texmf-var/arch/tlpkg/TeXLive/Arch.pm is not provided by any package)

(47 intermediate revisions by 25 users not shown)

Line 1:

Line 1:

[[Category:TeX]]

[[Category:TeX]]

−

[[it:TeXLive]]

+

[[fa:LaTeX]]

−

[[zh-CN:TeXLive]]

+

[[it:TeX Live]]

−

{{Article summary start}}

+

[[ja:TeX Live]]

−

{{Article summary text|Introduce how install and use TeX Live.}}

+

[[zh-cn:TeX Live]]

−

{{Article summary heading|Related}}

+

{{Related articles start}}

−

{{Article summary wiki|TeX Live FAQ}}

+

{{Related|TeX Live FAQ}}

−

{{Article summary wiki|TeX Live and CJK}}

+

{{Related|TeX Live and CJK}}

−

{{Article summary wiki|LaTeX}}

+

{{Related|Ooolatex}}

−

{{Article summary end}}

+

{{Related|List of applications/Documents#Scientific_documents}}

−

[http://www.tug.org/texlive/ TeX Live] is an "easy way to get up and running with the [[Wikipedia:TeX|TeX]] document production system. It provides a comprehensive TeX system with binaries for most flavors of Unix, including GNU/Linux, and also Windows. It includes all the major TeX-related programs, macro packages, and fonts that are free software, including support for many languages around the world."

+

{{Related articles end}}

+

[https://www.tug.org/texlive/ TeX Live] is an "easy way to get up and running with the [[Wikipedia:TeX|TeX]] document production system. It provides a comprehensive TeX system with binaries for most flavors of Unix, including GNU/Linux, and also Windows. It includes all the major TeX-related programs, macro packages, and fonts that are free software, including support for many languages around the world."

−

For more information see: [[:Category:TeX]]

+

TeX Live is one of the most popular distributions for [[Wikipedia:LaTeX|LaTeX]], [[Wikipedia:ConTeXt|ConTeXt]] and friends.

== Installation ==

== Installation ==

−

The TeX Live packages are arranged into two groups in the [[Official Repositories|official repositories]]:

+

The TeX Live packages are arranged into two groups in the [[official repositories]]:

* {{grp|texlive-most}} includes TeX Live applications.

* {{grp|texlive-most}} includes TeX Live applications.

* {{grp|texlive-lang}} provides various character sets and non-English features.

* {{grp|texlive-lang}} provides various character sets and non-English features.

Installing TeX Live manually honors the Arch Way in that it gives you much more control and lets you understand the process. It's the only way you can get a full-featured LaTeX distribution under 100 MB that fits your needs without install a thousand of packages you will never use.

+

See the [https://en.wikibooks.org/wiki/LaTeX/Installation#Custom_installation_with_TeX_Live LaTeX Wikibook] and [https://tug.org/texlive/doc/texlive-en/texlive-en.html#x1-140003 TeX Live Guide]. For programs that require TeX Live to be installed (e.g. kile) you can use the {{AUR|texlive-dummy}} package.

−

A detailed guide for TeX Live network install can be found on the [http://en.wikibooks.org/wiki/LaTeX/Installation#Custom_installation_with_TeX_Live LaTeX Wikibook].

+

== Usage ==

−

Information about making TeX Live network install : http://tug.org/texlive/doc/texlive-en/texlive-en.html#x1-140003

+

You can test your installation with

−

A [https://bbs.archlinux.org/viewtopic.php?id=109427 discussion] of the pros and cons of making the TeX Live network install.

+

$ tex '\empty Hello world!\bye'

+

$ pdftex '\empty Hello world!\bye'

−

For all those programs that require texlive to be installed (e.g. kile) you can use the {{AUR|texlive-dummy}} package from AUR.

+

You should get a DVI or a PDF file accordingly.

+

+

You will probably want a [[List of applications/Documents#Scientific_documents|TeX editor]].

* {{App|ShareLaTeX|An open source online LaTeX editor. You can either run your own local version where you can host, edit, collaborate in real-time, and compile your LaTeX documents, or simply use the version hosted on the official website.|https://www.sharelatex.com/|}}

Find more on the [https://en.wikibooks.org/wiki/LaTeX/Installation#Online_solutions LaTeX wikibook].

== Important information ==

== Important information ==

+

* The {{Pkg|biber}} utility used to handle biblatex bibliography is provided as a separate package.

−

* The way to handle font mappings for updmap has been improved in Sept. 2009, and installation should now be much more reliable than in the past. In the meanwhile, if you encounter error messages about unavailable map file, simply remove them by hand from the {{ic|updmap.cfg}} file (ideally using {{Ic|updmap-sys --edit}}). You can also run {{Ic|updmap-sys --syncwithtrees}} to automatically comment out outdated map lines from the config file.

+

* The way to handle font mappings for updmap was improved in September 2009, and installation should now be much more reliable than in the past. In the meantime, if you encounter error messages about unavailable map files, simply remove them by hand from the {{ic|updmap.cfg}} file (ideally using {{Ic|updmap-sys --edit}}). You can also run {{Ic|updmap-sys --syncwithtrees}} to automatically comment out outdated map lines from the config file.

−

* The ConTeXt formats (for MKII and MKIV) are not automatically generated upon installation. See [http://wiki.contextgarden.net '''the ConTeXT wiki'''] for instructions on how to do this.

+

* The ConTeXt formats (for MKII and MKIV) are not automatically generated upon installation. See [http://wiki.contextgarden.net the ConTeXT wiki] for instructions on how to do this.

−

* The packages containing the documentation and sources are available in the [community] repository. You can also consult it online at http://tug.org/texlive/Contents/live/doc.html or on CTAN.

+

* The packages containing the documentation and sources are '''no longer available''' in official repositories. You can locally build them with [[#TeXLive Local Manager|tllocalmgr]]. You can also consult documentation online at https://tug.org/texlive/Contents/live/doc.html or on CTAN. Another possibility is using the online documentation at {{ic|<nowiki>http://texdoc.net/pkg/packagename</nowiki>}} which resolves to the relevant pdf for {{ic|packagename}}, similar to the command line tool {{ic|texdoc}} (which is useless without locally installed documentation).

* TeX Live (upstream) now provides a tool for incremental updates of CTAN packages. On that basis, we also plan to update our packages on a regular basis (we have written tools that almost automate that task).

* TeX Live (upstream) now provides a tool for incremental updates of CTAN packages. On that basis, we also plan to update our packages on a regular basis (we have written tools that almost automate that task).

−

* Some tools and utilities included in TeX Live rely on {{Pkg|ghostscript}}, {{Pkg|perl}}, and {{Pkg|ruby}}.

+

* Some tools and utilities included in TeX Live rely on {{Pkg|ghostscript}}, {{Pkg|perl}}, {{Pkg|python2}}, and {{Pkg|ruby}}.

−

* For help and information about TeX Live see: http://tug.org/texlive/doc.html and http://tug.org/texlive/doc/texlive-en/texlive-en.html

+

* For help and information about TeX Live see: https://tug.org/texlive/doc.html and https://tug.org/texlive/doc/texlive-en/texlive-en.html

* System-wide configuration files are under {{ic|/usr/share/texmf-config}}. User-specific ones should be put under {{ic|~/.texlive/texmf-config}}. {{Ic|$TEXMFHOME}} is {{ic|~/texmf}} and {{Ic|$TEXMFVAR}} is {{ic|~/.texlive/texmf-var}}.

* System-wide configuration files are under {{ic|/usr/share/texmf-config}}. User-specific ones should be put under {{ic|~/.texlive/texmf-config}}. {{Ic|$TEXMFHOME}} is {{ic|~/texmf}} and {{Ic|$TEXMFVAR}} is {{ic|~/.texlive/texmf-var}}.

Line 83:

Line 103:

===Paper Size===

===Paper Size===

−

North American users are advised to run

+

If you would like to set the default page size to something other than A4 (such as "Letter"), run the following command:

$ texconfig

$ texconfig

−

in order to set the default page size to "Letter", as opposed to A4, the current default. This command is also capable of changing other useful settings. Not changing this setting can result in slightly flawed output, as the right margin will be bigger than the left.

+

This command is also capable of changing other useful settings.

===Error with "formats not generated" upon update===

===Error with "formats not generated" upon update===

−

See [https://bugs.archlinux.org/task/16467 this bug report]. ('''Note that if you do not use the experimental engine ''LuaTeX'', you can ignore this.''') This situation typically occurs when the configuration files {{ic|language.def}} and/or {{ic|language.dat}} for hyphenation patterns contain references to files from earlier releases of {{Ic|texlive-core}}, in particular to the latest experimental hyphenation patterns for German, whose file name changes frequently. Currently they should point to {{ic|dehyph{n,t}-x-2009-06-19.tex}}.

See [https://bugs.archlinux.org/task/16467 this bug report]. ('''Note that if you do not use the experimental engine ''LuaTeX'', you can ignore this.''') This situation typically occurs when the configuration files {{ic|language.def}} and/or {{ic|language.dat}} for hyphenation patterns contain references to files from earlier releases of {{Ic|texlive-core}}, in particular to the latest experimental hyphenation patterns for German, whose file name changes frequently. Currently they should point to {{ic|dehyph{n,t}-x-2009-06-19.tex}}.

Line 97:

Line 116:

===Fonts===

===Fonts===

−

By default, the fonts that come with the various TeX Live packages are not automatically available to Fontconfig. If you want to use them with, say XeTeX or [[LibreOffice]], the easiest approach is to make symlinks as follows:

By default, the fonts that come with the various TeX Live packages are not automatically available to Fontconfig. If you want to use them with, say XeTeX or [[LibreOffice]], the easiest approach is to make symlinks as follows:

The TeXLive Local Manager is a utility provided by Firmicus which allows to conveniently manage a TeX Live installation on Arch Linux.

The TeXLive Local Manager is a utility provided by Firmicus which allows to conveniently manage a TeX Live installation on Arch Linux.

−

See {{AUR|texlive-localmanager-git}} in the [[Arch User Repository|AUR]].

+

See {{AUR|texlive-localmanager-git}} in the [[AUR]].

Usage: tllocalmgr

Usage: tllocalmgr

Line 168:

Line 185:

--mirror CTAN mirror to use (default is mirror.ctan.org)

--mirror CTAN mirror to use (default is mirror.ctan.org)

--nocolor #TODO

--nocolor #TODO

−

−

=== Recent "langukenglish" errors ===

−

For issues involving this error when trying to run {{ic|tllocalmgr}} commands,

−

Can't get object for collection-langukenglish at /usr/bin/tllocalmgr line 103

−

See ary0's solution at the AUR: {{AUR|texlive-localmanager}}. In summary, edit {{ic|/usr/share/texmf-var/arch/tlpkg/TeXLive/Arch.pm}} and remove "langukenglish" from the section of the file shown here:

TeX Live (and teTeX) uses its own directory indexes (files named {{ic|ls-R}}), and you need to refresh them after you copy something into one of the TeX trees. Or TeX can not see them. Magic command:

TeX Live (and teTeX) uses its own directory indexes (files named {{ic|ls-R}}), and you need to refresh them after you copy something into one of the TeX trees. Or TeX can not see them. Magic command:

−

mktexlsr

+

{{bc|# mktexlsr}}

or

or

−

texhash

+

{{bc|# texhash}}

or

or

−

texconfig[-sys] rehash

+

{{bc|# texconfig[-sys] rehash}}

A command line program to search through these indexes is

A command line program to search through these indexes is

kpsewhich

kpsewhich

Hence you can check that TeX can find a particular file by running

Hence you can check that TeX can find a particular file by running

−

kpsewhich <filename>

+

kpsewhich <filename.sty>

−

The output should be full path to that file.

+

The output should be the full path to that file.

+

+

Alternatively, sty files that are intended only for a particular user should go in the {{ic|~/texmf/}} tree. For instance, the latex package wrapfig consists of the file {{ic|wrapfig.sty}} and would go in {{ic|~/texmf/tex/latex/wrapfig/wrapfig.sty}}. There is no need to run {{ic|mktexlsr}} or equivalent because {{ic|~/texmf}} is searched every time tex is run.

=== Manual Installation ===

=== Manual Installation ===

Line 196:

Line 205:

=== Using PKGBUILDs ===

=== Using PKGBUILDs ===

−

To install a LaTeX package on a global level, you should use a [[PKGBUILD]] for the sake of simplifying maintenance. Look at this example.

+

To install a LaTeX package on a global level, you should use a [[PKGBUILD]] for the sake of simplifying maintenance. Examples can be found in the [[AUR]], e.g. {{AUR|texlive-gantt}}.

If you have the very specific problem of babelbib not having the latest language definitions that you need, and you do not want to recompile everything, you can get them manually from https://www.tug.org/texlive/devsrc/Master/texmf-dist/tex/latex/babelbib/ and put them in {{ic|/usr/share/texmf-dist/tex/latex/babelbib/}}. For example:

Latest revision as of 08:07, 20 October 2016

TeX Live is an "easy way to get up and running with the TeX document production system. It provides a comprehensive TeX system with binaries for most flavors of Unix, including GNU/Linux, and also Windows. It includes all the major TeX-related programs, macro packages, and fonts that are free software, including support for many languages around the world."

TeX Live is one of the most popular distributions for LaTeX, ConTeXt and friends.

Installation

texlive-lang provides various character sets and non-English features.

The essential package texlive-core contains the basic texmf-dist tree, while texlive-bin contains the binaries, libraries, and the texmf tree. texlive-core is based on the “medium” install scheme of the upstream distribution. All other packages are based on the eponymous collections in TeX Live. To determine which CTAN packages are included in each package, lookup the files:

ShareLaTeX — An open source online LaTeX editor. You can either run your own local version where you can host, edit, collaborate in real-time, and compile your LaTeX documents, or simply use the version hosted on the official website.

Important information

The biber utility used to handle biblatex bibliography is provided as a separate package.

The way to handle font mappings for updmap was improved in September 2009, and installation should now be much more reliable than in the past. In the meantime, if you encounter error messages about unavailable map files, simply remove them by hand from the updmap.cfg file (ideally using updmap-sys --edit). You can also run updmap-sys --syncwithtrees to automatically comment out outdated map lines from the config file.

The ConTeXt formats (for MKII and MKIV) are not automatically generated upon installation. See the ConTeXT wiki for instructions on how to do this.

The packages containing the documentation and sources are no longer available in official repositories. You can locally build them with tllocalmgr. You can also consult documentation online at https://tug.org/texlive/Contents/live/doc.html or on CTAN. Another possibility is using the online documentation at http://texdoc.net/pkg/packagename which resolves to the relevant pdf for packagename, similar to the command line tool texdoc (which is useless without locally installed documentation).

TeX Live (upstream) now provides a tool for incremental updates of CTAN packages. On that basis, we also plan to update our packages on a regular basis (we have written tools that almost automate that task).

System-wide configuration files are under /usr/share/texmf-config. User-specific ones should be put under ~/.texlive/texmf-config. $TEXMFHOME is ~/texmf and $TEXMFVAR is ~/.texlive/texmf-var.

A skeleton of a local texmf tree is at /usr/local/share/texmf: this directory is writable for members of the group tex.

Paper Size

If you would like to set the default page size to something other than A4 (such as "Letter"), run the following command:

$ texconfig

This command is also capable of changing other useful settings.

Error with "formats not generated" upon update

See this bug report. (Note that if you do not use the experimental engine LuaTeX, you can ignore this.) This situation typically occurs when the configuration files language.def and/or language.dat for hyphenation patterns contain references to files from earlier releases of texlive-core, in particular to the latest experimental hyphenation patterns for German, whose file name changes frequently. Currently they should point to dehyph{n,t}-x-2009-06-19.tex.

To solve this, you need to either remove these files: /usr/share/texmf-config/tex/generic/config/language.{def,dat}
or update them using the newest version under: /usr/share/texmf/tex/generic/config/language.{def,dat}
and then run

# fmtutil-sys --missing

Fonts

By default, the fonts that come with the various TeX Live packages are not automatically available to Fontconfig. If you want to use them with, say XeTeX or LibreOffice, the easiest approach is to make symlinks as follows:

Note: This may cause conflicts with XeTeX/XeLaTeX if the same fonts are (separately) available to both TeX and Fontconfig, i.e. if multiple copies of the same font are available on the search path.

TeXLive Local Manager

The TeXLive Local Manager is a utility provided by Firmicus which allows to conveniently manage a TeX Live installation on Arch Linux.
See texlive-localmanager-gitAUR in the AUR.

Usage: tllocalmgr
tllocalmgr [options] [command] [args]
Running tllocalmgr alone starts the TeXLive local manager shell
for Arch Linux. This shell is capable of command-line completion!
There you can look at the available updates with the command 'status'
and you can install individual CTAN packages using 'install' or 'update'
under $TEXMFLOCAL. This is done by creating a package texlive-local-<pkg>
and installing it with pacman. Note that this won’t interfere with your
standard texlive installation, but files under $TEXMFLOCAL will take
precedence.
Here are the commands available in the shell:
Commands:
status -- Current status of TeXLive installation
shortinfo * -- Print a one-liner description of CTAN packages
info * -- Print info on CTAN packages
update * -- Locally update CTAN packages
install * -- Locally install new CTAN packages
installdoc * -- Locally install documentation of CTAN packages
installsrc * -- Locally install sources of CTAN packages
listfiles * -- List all files in CTAN packages
search * -- Search info on CTAN packages
searchfiles * -- Search for files in CTAN packages
texhash -- Refresh the TeX file database
clean -- Clean local build tree
help -- Print helpful information
quit -- Quit tllocalmgr
The commands followed by * take one of more package names as arguments.
Note that these can be completed automatically by pressing TAB.
You can also run tllocalmgr as a standard command-line program, with
one of the above commands as argument, then the corresponding task will
be performed and the program will exit (except when the command is 'status').
tllocalmgr accepts the following options:
Options: --help Shows this help
--version Show the version number
--forceupdate Force updating the TeXLive database
--skipupdate Skip updating the TeXLive database
--localsearch Search only installed packages
--location #TODO?
--mirror CTAN mirror to use (default is mirror.ctan.org)
--nocolor #TODO

Install .sty files

TeX Live (and teTeX) uses its own directory indexes (files named ls-R), and you need to refresh them after you copy something into one of the TeX trees. Or TeX can not see them. Magic command:

# mktexlsr

or

# texhash

or

# texconfig[-sys] rehash

A command line program to search through these indexes is

kpsewhich

Hence you can check that TeX can find a particular file by running

kpsewhich <filename.sty>

The output should be the full path to that file.

Alternatively, sty files that are intended only for a particular user should go in the ~/texmf/ tree. For instance, the latex package wrapfig consists of the file wrapfig.sty and would go in ~/texmf/tex/latex/wrapfig/wrapfig.sty. There is no need to run mktexlsr or equivalent because ~/texmf is searched every time tex is run.

Manual Installation

Normally, new .sty files go in /usr/share/texmf-dist/tex/latex/<package name>/*. Create this directory if you do not have it. This directory will automatically be searched when *tex is executed. Further discussion can be found here: https://bbs.archlinux.org/viewtopic.php?id=85757

Using PKGBUILDs

To install a LaTeX package on a global level, you should use a PKGBUILD for the sake of simplifying maintenance. Examples can be found in the AUR, e.g. texlive-ganttAUR.