Differences

This shows you the differences between two versions of the page.

--- on-line_resources:faq:latex [2011/07/21 09:53]
giunta
+++ on-line_resources:faq:latex [2019/04/04 16:18]
giunta [SISSA Computing FAQ: about LATEX]
@@ Line 1: / Line 1: @@
 ====== SISSA Computing FAQ: about LATEX ======
 It sometimes happens that you need a new version of some macro package or font; the correct approach is to create a private installation of (La)TeX which includes the new stuff you need.
+There are two options: the [[on-line_resources:faq:latex#tex_live_package_manager_tlmgr|TeX Live package manager]] or the [[on-line_resources:faq:latex#manual_mode|manual mode]]
+===== TeX Live package manager (tlmgr) =====
+<note important>To use the TeX Live package manager, you have to load the ''texlive'' module first </note>
+Before using ''tlmgr'' in user mode, you have to set up the user tree with the //init-usertree// action:
+  tlmgr init-usertree
+This command creates a directory named ''texmf'' in your home directory.
+Then, you have to use the //install// action: it checks if the package and all dependencies are already installed in the system installation.  If this is not the case, it installs the package and all dependencies into the user tree (~/texmf).
+==== Example ====
+If you need to install the package ''memorygraphs'', you have to use the command ''tlmgr --user-mode install memorygraphs''
+<code>
+$ tlmgr --user-mode install memorygraphs
+...
+tlmgr: package repository http://ctan.mirror.garr.it/mirrors/CTAN/systems/texlive/tlnet (verified)
+[1/1, ??:??/??:??] install: memorygraphs [189k]
+running mktexlsr ...
+done running mktexlsr.
+tlmgr: package log updated: /u/j/janedoe/texmf/web2c/tlmgr.log
+</code>
+===== Manual mode =====
 Create in your home directory a subdirectory named ''texmf'', using the following command:
@@ Line 9: / Line 38: @@
 Install your new package (or whatever) in a directory structure like this:
-^File extension^Directory^
+^File extension^Directory^Description^
-|.sty, .cls or .fd|~/texmf/tex/latex/<package_name>/|
+|.sty, .cls or .fd|~/texmf/tex/latex/<package_name>/|Style file, Document class file or Font Definition files|
-|.mf|~/texmf/fonts/source/public/<font_name>/|
+|.mf|~/texmf/fonts/source/public/<font_name>/|METAFONT outline|
-|.tfm|~/texmf/fonts/tfm/public/<font_name>/|
+|.tfm|~/texmf/fonts/tfm/public/<font_name>/|TeX Font Metrics for METAFONT and Type 1 fonts|
-|.vf|~/texmf/fonts/vf/public/<font_name>/|
+|.vf|~/texmf/fonts/vf/public/<font_name>/|TeX virtual fonts|
-|.afm|~/texmf/fonts/afm/public/<font_name>/|
+|.afm|~/texmf/fonts/afm/public/<font_name>/|Adobe Font Metrics for Type 1 fonts|
-|.pfb|~/texmf/fonts/type1/public/<font_name>/|
+|.pfb|~/texmf/fonts/type1/public/<font_name>/|PostScript Type 1 outline|
-|.ttf|~/texmf/fonts/truetype/public/<font_name>/|
+|.ttf|~/texmf/fonts/truetype/public/<font_name>/|TrueType font|
-|.otf|~/texmf/fonts/opentype/public/<font_name>/|
+|.otf|~/texmf/fonts/opentype/public/<font_name>/|OpenType font|
+|.bst|~/texmf/bibtex/bst/<package_name>/|BibTeX style|
 where:
@@ Line 26: / Line 56: @@
 and generate an index of that tree
-  texhash ~/texmf
+  mktexlsr ~/texmf
 You can use this approach for updates to packages installed in the SISSA workstations, as well as for installing new versions of things.
-=== Reference ===
+==== Reference ====
 [[http://www.tex.ac.uk/cgi-bin/texfaq2html?label=privinst]]
 [[http://www.tex.ac.uk/cgi-bin/texfaq2html?label=install-where]]
 [[http://www.tex.ac.uk/tex-archive/tds/tds.html]]
 [[http://www.tug.org/texinfohtml/kpathsea.html#Supported-file-formats]]