Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
on-line_resources:faq:latex [2011/07/21 10:03] giunta |
on-line_resources:faq:latex [2021/05/14 14:50] (current) giunta [TeX Live package manager (tlmgr)] |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ====== SISSA Computing FAQ: about LATEX ====== | ====== 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. | + | 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 for the first time, 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). | ||
| + | |||
| + | tlmgr --user-mode install pkg | ||
| + | |||
| + | ==== Use an updated version of TeX Live ==== | ||
| + | |||
| + | To use an updated version of ''Tex Live'', create missing //backup// folder in your user tree : | ||
| + | |||
| + | mkdir -p ~texmf/tlpkg/backups | ||
| + | |||
| + | Update the repository: | ||
| + | |||
| + | tlmgr --usermode option repository ctan | ||
| + | |||
| + | and finally update all your Tex packages: | ||
| + | |||
| + | tlmgr --usermode update --all | ||
| + | ==== Example ==== | ||
| + | |||
| + | Load ''texlive'' module: | ||
| + | |||
| + | $ module load texlive | ||
| + | |||
| + | Compile a tex file: | ||
| + | |||
| + | <code> | ||
| + | $ latex example.tex | ||
| + | ... | ||
| + | |||
| + | ! LaTeX Error: File `memorygraphs.sty' not found. | ||
| + | |||
| + | Type X to quit or <RETURN> to proceed | ||
| + | </code> | ||
| + | |||
| + | Search which package contains //memorygraphs.sty// file: | ||
| + | |||
| + | <code> | ||
| + | $ tlmgr search --global --all memorygraphs.sty | ||
| + | ... | ||
| + | memorygraphs: | ||
| + | texmf-dist/tex/latex/memorygraphs/memorygraphs.sty | ||
| + | </code> | ||
| + | |||
| + | If it is the first time you use ''tlmgr'', set up the user tree with the command ''tlmgr init-usertree'' | ||
| + | |||
| + | $ tlmgr init-usertree | ||
| + | |||
| + | You need to install the package ''memorygraphs'', using 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: | Create in your home directory a subdirectory named ''texmf'', using the following command: | ||
| Line 9: | Line 81: | ||
| Install your new package (or whatever) in a directory structure like this: | 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: | where: | ||
| Line 30: | Line 103: | ||
| You can use this approach for updates to packages installed in the SISSA workstations, as well as for installing new versions of things. | 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=privinst]] | ||