diff options
author | Staszek Wawrykiewicz <staw@gust.org.pl> | 2008-08-01 00:14:56 +0000 |
---|---|---|
committer | Staszek Wawrykiewicz <staw@gust.org.pl> | 2008-08-01 00:14:56 +0000 |
commit | a8eac6a36ef58fba7c52a5220b7ebf9ccf6c87e6 (patch) | |
tree | e74368e102bdc0ca1df27904cc8eda3b3dac5a93 /Master/texmf-doc/source | |
parent | 227fe545ce6b2ea9f7c61ca1c2776898522a59f7 (diff) |
texlive-pl doc update
git-svn-id: svn://tug.org/texlive/trunk@9963 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-doc/source')
-rw-r--r-- | Master/texmf-doc/source/texlive/texlive-pl/Makefile | 4 | ||||
-rw-r--r-- | Master/texmf-doc/source/texlive/texlive-pl/live4ht.cfg | 13 | ||||
-rw-r--r-- | Master/texmf-doc/source/texlive/texlive-pl/tex-livep.sty | 45 | ||||
-rw-r--r-- | Master/texmf-doc/source/texlive/texlive-pl/tex4ht.env | 259 | ||||
-rwxr-xr-x[-rw-r--r--] | Master/texmf-doc/source/texlive/texlive-pl/texlive-pl.tex (renamed from Master/texmf-doc/source/texlive/texlive-pl/live.tex) | 3080 |
5 files changed, 1383 insertions, 2018 deletions
diff --git a/Master/texmf-doc/source/texlive/texlive-pl/Makefile b/Master/texmf-doc/source/texlive/texlive-pl/Makefile index 2150e5b54d4..4da95d76a4f 100644 --- a/Master/texmf-doc/source/texlive/texlive-pl/Makefile +++ b/Master/texmf-doc/source/texlive/texlive-pl/Makefile @@ -1,10 +1,10 @@ # $Id$ # Makefile for TeX Live documentation. Public domain. -doc = live +doc = texlive-pl all: pdf html -env = TEXINPUTS=../../general/texlive-common:; export TEXINPUTS; +env = TEXINPUTS=../texlive-common:../texlive-en:; export TEXINPUTS; pdf: rm -f *.aux *.toc *.lof *.lot *.xref* *.tmp *.out diff --git a/Master/texmf-doc/source/texlive/texlive-pl/live4ht.cfg b/Master/texmf-doc/source/texlive/texlive-pl/live4ht.cfg index 0fcd5cd1318..8912182767f 100644 --- a/Master/texmf-doc/source/texlive/texlive-pl/live4ht.cfg +++ b/Master/texmf-doc/source/texlive/texlive-pl/live4ht.cfg @@ -4,9 +4,8 @@ % html specifies the main output format. % info for extra debugging info in the log files. -% better approach is to have html in one piece (including footnotes). -% also the newest TeX4ht could produce UTF-8 output (-utf8 option) -%\Preamble{charset=utf-8,html,info,fn-in} +% have html in one piece (including footnotes). +%\Preamble{charset=iso-8559-2,html,info,fn-in} \Preamble{html,info,fn-in} % add extra stylesheet @@ -14,7 +13,12 @@ <link rel="stylesheet" type="text/css" href="\jobname.css" />\Hnewline <link rel="stylesheet" type="text/css" href="tex-live.css" />\Hnewline }} - +% use png graphics as-is +\Configure{graphics*} + {png} + {\Needs{""}% + \Picture[pict]{\csname Gin@base\endcsname.png}% + } % or LaTeX complains it is missing. \begin{document} @@ -45,4 +49,3 @@ \def\finishliteral#1{#1\egroup} \let\filename=\dirname \fi - diff --git a/Master/texmf-doc/source/texlive/texlive-pl/tex-livep.sty b/Master/texmf-doc/source/texlive/texlive-pl/tex-livep.sty index 074088963b0..07e43d26558 100644 --- a/Master/texmf-doc/source/texlive/texlive-pl/tex-livep.sty +++ b/Master/texmf-doc/source/texlive/texlive-pl/tex-livep.sty @@ -1,9 +1,8 @@ -% $Id$ % TeX Live documentation style. Written by many people over many years. % Public domain. % \NeedsTeXFormat{LaTeX2e}[1995/12/01] -\ProvidesPackage{tex-livep}[2005/09/24 v1.5 TeX Live documentation style] +\ProvidesPackage{tex-livep}[2008/07/31 v1.6 TeX Live documentation style] % \RequirePackage{alltt} \RequirePackage{array} @@ -25,7 +24,8 @@ % for a proper \acro command (even in the context of the definition in % ltugboat -- \DRC overrides without checking) \RequirePackage{relsize} -\DeclareRobustCommand{\acro}[1]{\textsmaller{#1}\@} +%\DeclareRobustCommand{\acro}[1]{\textsmaller{#1}\@} +\def\acro#1{\textscale{.9}{#1}\@} % \RequirePackage{fancyvrb} \DefineVerbatimEnvironment{verbatim}{Verbatim}{fontsize=\normalsize} @@ -56,8 +56,10 @@ \renewcommand{\topfraction}{0.85} \renewcommand{\floatpagefraction}{0.86} \renewcommand{\textfraction}{0.1} +\renewcommand{\abovecaptionskip}{4pt} \renewcommand{\belowcaptionskip}{4pt} -\setcounter{tocdepth}{2} +\setcounter{tocdepth}{3} +\setcounter{secnumdepth}{3} \setcounter{topnumber}{5} \setcounter{totalnumber}{5} % @@ -79,14 +81,16 @@ \newcommand*{\envname}[1]{\texttt{#1}}% environment variable name \newcommand{\code}[1]{\texttt{#1}} \newcommand{\file}[1]{\texttt{#1}} -\newcommand{\prog}[1]{\texttt{#1}} +\newcommand{\prog}[1]{\textsf{#1}}% same as \cmdname \newcommand{\samp}[1]{`\texttt{#1}'} \newcommand{\var}[1]{{\sl #1}}% not \textsl, for roman not typewriter slanted. \newcommand{\ttvar}[1]{\texttt{\var{#1}}} % % underlined command input. -\def\Ucom#1{% - \uline{\rule[-.2\baselineskip]{0pt}{.9\baselineskip}\ttfamily #1}} +%\def\Ucom#1{% +% \uline{\rule[-.2\baselineskip]{0pt}{.9\baselineskip}\ttfamily #1}} +% bold command input +\def\Ucom#1{{\bfseries\ttfamily #1}} % \CDref is for url's with a #, where we need to write the target url and % displayed url separately in the input, due to catcode madness. @@ -132,6 +136,7 @@ \def\GFtoDVI{\cmdname{GFtoDVI}\null} \def\GFtoPK{\cmdname{GFtoPK}\null} \def\GFtype{\cmdname{GFtype}} +\def\GUI{\acro{GUI}\xspace} \def\KPS{Kpathsea} \def\La{La} \def\OMEGA{$\Omega$} @@ -145,7 +150,7 @@ \def\teTeX{\textrm{te}\TeX\xspace} \def\TeXLive{\TeX{} Live\xspace} \def\TFtoPL{\cmdname{TFtoPL}\null} -\def\TK{\textsf{\TeX\ Collection}} +\def\TK{\TeX\ Collection} \let\TL=\TeXLive \def\TypeI{Type~1} \def\VFtoVP{\cmdname{VFtoVP}\null} @@ -153,16 +158,18 @@ \def\Thanh{H\`an~Th\^e\llap{\raise 0.5ex\hbox{\'{}}}~Th\`anh} \def\XEmTeX{\textrm{XEm}\TeX\xspace} \def\XEmacs{\textrm{XEmacs}\xspace} +\def\XeTeX{Xe\TeX\xspace} \def\Webc{Web2C} \providecommand*{\CD}{\acro{CD}\xspace} \providecommand*{\CTAN}{\acro{CTAN}\xspace} \providecommand*{\DVD}{\acro{DVD}\xspace} +\providecommand*{\GNU}{\acro{GNU}\xspace} \providecommand*{\HTML}{\acro{HTML}\xspace} \providecommand*{\MacOSX}{Mac\,\acro{OS\,X}\xspace} \providecommand*{\PS}{Post\-Script\xspace} \providecommand*{\TDS}{\acro{TDS}\xspace} \providecommand*{\dvi}{\acro{DVI}\xspace} -\providecommand*{\web}{\texttt{web}\xspace} +\providecommand*{\web}{\texttt{WEB}\xspace} % Include an image. % #1 - name of image (pictures/#1.jpg, always .jpg please) @@ -177,6 +184,15 @@ \fi \\[5mm] } + +\def\tlpng#1#2{% + \ifnum \Status=2 % html, want relative path in output + \includegraphics[bb=0 0 1 1]{#1.png}% + \else % not html, handled by TEXINPUTS in Makefile + \includegraphics[width=#2]{#1.png}% + \fi +} + % % description-like environment that uses tt instead of bf, and doesn't % go to the left margin. Without the \hfil, get an underfull box. @@ -248,11 +264,12 @@ \or % \Status = 1 \typeout{TeX Live documentation in PDF format} - \RequirePackage[%unicode=true, % doesn't work in some PDF viewers :( - breaklinks,colorlinks,linkcolor=hypercolor,citecolor=hypercolor, - pagecolor=hypercolor,urlcolor=hypercolor, - filecolor=hypercolor, - bookmarksopen,pdfstartview={FitBH -320000},hyperindex] + \RequirePackage[breaklinks, + colorlinks,linkcolor=hypercolor,citecolor=hypercolor, + urlcolor=hypercolor,filecolor=hypercolor, + bookmarksopen, + %pdfstartview={FitBH -320000}, % fails with acrobat7 + hyperindex] {hyperref} \SingleColumntrue \newenvironment{multicols}[1]{}{} diff --git a/Master/texmf-doc/source/texlive/texlive-pl/tex4ht.env b/Master/texmf-doc/source/texlive/texlive-pl/tex4ht.env deleted file mode 100644 index d6368769d1a..00000000000 --- a/Master/texmf-doc/source/texlive/texlive-pl/tex4ht.env +++ /dev/null @@ -1,259 +0,0 @@ -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% tex4ht.env / .tex4ht (unix) 2005-05-17-01:25 % -% Copyright (C) 1997--2005 Eitan M. Gurari % -% % -% This work may be distributed and/or modified under the % -% conditions of the LaTeX Project Public License, either % -% version 1.3 of this license or (at your option) any % -% later version. The latest version of this license is % -% in % -% http://www.latex-project.org/lppl.txt % -% and version 1.3 or later is part of all distributions % -% of LaTeX version 2003/12/01 or later. % -% % -% This work has the LPPL maintenance status "maintained".% -% % -% This Current Maintainer of this work % -% is Eitan M. Gurari. % -% % -% gurari@cse.ohio-state.edu % -% http://www.cse.ohio-state.edu/~gurari % -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% Notes: % -% 1. Empty lines might be harmful % -% 2. Tagged script segments <tag>...</tag> are scanned only if % -% their names are specified within -ctag switches of tex4ht.c % -% and t4ht.c. When -c switches are not supplied, a -cdefault % -% is implicitly assumed. % -% The tags <tag> and </tag>, but not their bodies, are % -% ignored if they are not located at the start of their lines. % -% 3. Place this file in your work directory and/or root directory % -% and/or in directory `xxx' of your choice. In the latest case, % -% compile tex4ht.c and t4ht.c with `#define ENVFILE xxx', or % -% provide the address of the file to tex4ht and t4ht throught % -% the -e switch % -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% -% * Replace `path', and possibly what follows, with appropriate % -% content % -% * A path may start with: % -% ~ for environment variable HOME % -% ~~ for environment variable TEX4HTTFM % -% * A ! requests recursive search into subdirectories % -% * Multiple t and i entries are allowed % -% * When supported by kpathsea % -% + t entries are ignored % -% + the path before /ht-fonts/ is ignored in i records that don't % -% represent real addresses % -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% -tpath/tex/texmf/fonts/tfm/! -% -<default> -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/iso8859/2/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/ascii/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/alias/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/mozilla/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/unicode/! -</default> - -<mozhtf> -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/mozilla/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/unicode/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/ascii/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/alias/! -</mozhtf> - -<iso2htf> -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/iso8859/2/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/ascii/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/unicode/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/alias/! -</iso2htf> - -<iso5htf> -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/iso8859/5/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/ascii/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/unicode/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/alias/! -</iso5htf> - -<iso7htf> -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/iso8859/7/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/ascii/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/unicode/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/alias/! -</iso7htf> - - -<iso15htf> -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/iso8859/15/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/ascii/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/unicode/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/alias/! -</iso15htf> - -<koi8rhtf> -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/koi/8r/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/ascii/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/unicode/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/alias/! -</koi8rhtf> - -<symhtf> -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/symbol/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/unicode/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/ascii/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/alias/! -</symhtf> - -<win1251htf> -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/win/1251/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/unicode/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/ascii/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/alias/! -</win1251htf> - -<unihtf> -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/unicode/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/ascii/! -i~/tex4ht.dir/texmf/tex4ht/ht-fonts/alias/! -</unihtf> - -% -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% dvi-to-xxx % -% choose one G-script % -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% dvips options % -% magnification: -x mag (e.g., -x 1200) % -% page size: -T x,y (e.g., -T 14in,14in) % -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% - <convert> - G.png - Gdvips -E -q -Ppdf -f %%1 -pp %%2 > zz%%4.ps - Ggs -sDEVICE=pngalpha -sOutputFile=%%3 -r110x110 -dEPSCrop -dBackgroundColor=16#ffffff -dTextAlphaBits=2 -dGraphicsAlphaBits=2 -q -dbatch -dNOPAUSE zz%%4.ps -c quit - Grm zz%%4.ps -G.svg -Gdvips -Ppdf -mode ibmvga -D 110 -f %%1 -pp %%2 > zz%%4.eps -Gpstoedit -f svg zz%%4.eps %%3 -%-------------------% - Gdvips -Ppdf -mode ibmvga -D 110 -f %%1 -pp %%2 > zz%%4.ps - Ggs -sDEVICE=ppm -sOutputFile=zz%%4.ppm -r110x110 -dTextAlphaBits=2 -dGraphicsAlphaBits=2 -q -dbatch -dNOPAUSE zz%%4.ps -c quit - Gconvert zz%%4.ppm -crop 0x0 +page -density 110x110 -transparent '#FFFFFF' zz%%4.png - Gperl png2svgGDI.pl zz%%4.png - Gperl svgGDI.pl zz%%4.svg %%3 - Grm zz%%4.ps - Grm zz%%4.ppm - Grm zz%%4.png - Grm zz%%4.svg -G. -Gdvips -E -Ppdf -mode ibmvga -D 110 -f %%1 -pp %%2 > zz%%4.ps -Gconvert zz%%4.ps -trim +repage -density 110x110 -transparent '#FFFFFF' %%3 -Grm zz%%4.ps -%--------- alternative instructions for old versions of convert -% Gconvert zz%%4.ps -trim -density 110x110 -transparent "#FFFFFF" %%3 -% Gconvert zz%%4.ps -crop 0x0 +repage -density 110x110 -transparent "#FFFFFF" %%3 -% Gconvert zz%%4.ps -crop 0x0 +page -density 110x110 -transparent "#FFFFFF" %%3 -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% - </convert> -<netpbm> -Gdvips -Ppdf -mode ibmvga -D 110 -f %%1 -pp %%2 > zz%%4.ps -Ggs -sDEVICE=ppm -r110 -sOutputFile=zz%%4.ppm -q -dbatch -dTextAlphaBits=4 -dGraphicsAlphaBits=4 -dNOPAUSE zz%%4.ps -c quit -Gmv zz%%4.ppm temp.ppm -Gpnmcrop temp.ppm > zz%%4.ppm -Gppmtopng -interlace -transparent 1,1,1 zz%%4.ppm > %%3 -Grm zz%%4.ps -Grm zz%%4.ppm -Grm temp.ppm -% Gppmtogif -interlace -transparent 1,1,1 zz%%4.ppm > %%3 -</netpbm> -<dvipng> -G.png -Gdvipng -T tight -x 1400 -D 72 -bg Transparent -pp %%2:%%2 %%1 -o %%3 -G.gif -Gdvipng -T tight -x 1400 -D 72 -bg Transparent -pp -gif %%2:%%2 %%1 -o %%3 -G. -Gdvips -Ppdf -mode ibmvga -D 110 -f > zz%%4.ps -Gconvert -crop 0x0 -density 110x110 -transparent '#FFFFFF' zz%%4.ps %%3 -Grm zz%%4.ps -</dvipng> - -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% Default scripts, shifted rightward 1 pos -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% - s--- needs --- %%1.idv[%%2] ==> %%3 --- - b--- characters --- - g.png -% empty bitmaps % - Ecopy empty.png %%1%%2 -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% - % -% -% * Address for an automatically created bookkeeping file % -% * Ignored under kpathsea % -% * The work directory is assumed for a default % - l~/tex4ht.dir/tex4ht.fls -% -% t4ht -d%%2 % -Mmv %%1 %%2%%3 -Ccp %%1 %%2%%3 -% t4ht -d%%2 -m%%1 % -Achmod %%1 %%2%%3 -% removed protection % -S* -% -<validatehtml> - .html xmllint --noout --valid --html %%1.html -</validatehtml> -<validate> - .xml xmllint --noout --valid %%1.xml - .html xmllint --noout --valid %%1.html - .css mycssparser %%1.css -</validate> - % -<oo> -%%% openoffice % -.4os mkdir sxw-%%0.dir -.4os mkdir sxw-%%0.dir/Pictures -.4os mv %%1.4os sxw-%%0.dir/settings.xml -.4os mv %%0.xml sxw-%%0.dir/content.xml -% % -.4om mkdir sxw-%%0.dir/%%1 -.4om mv %%1.4om sxw-%%0.dir/%%1/content.xml -.4om cp sxw-%%0.dir/settings.xml sxw-%%0.dir/%%1/settings.xml -% % -.4of mkdir sxw-%%0.dir/META-INF -.4of mv %%1.4of sxw-%%0.dir/META-INF/manifest.xml -% % -.4ot mv %%1.4ot sxw-%%0.dir/meta.xml -.4oy mv %%1.4oy sxw-%%0.dir/styles.xml -.4og cp -r %%1 sxw-%%0.dir/Pictures/%%1 -%-- sxw -- % -.4ox cd sxw-%%0.dir; zip -r %%0.sxw * ; cd .. -% % -.4ox mv sxw-%%0.dir/%%0.sxw . -% % -.4ox rm %%1.4ox -.4ox rm -r -f sxw-%%0.dir -%-- odt -- % -.4od cd sxw-%%0.dir; zip -r %%0.odt * ; cd .. -% % -.4od mv sxw-%%0.dir/%%0.odt . -% % -.4od rm %%1.4od -.4od rm -r -f sxw-%%0.dir -%%% end openoffice % -</oo> -% -<javahelp> -.jhm java -jar ${HOME}/jh2.0/javahelp/bin/jhindexer.jar -db %%0-doc/%%1-jhs %%1*.html -</javahelp> -<javahelp1> -.jhm java -jar ${HOME}/jh1.1.3/javahelp/bin/jhindexer.jar -db %%0-doc/%%1-jhs %%1*.html -</javahelp1> - -% end of file % - diff --git a/Master/texmf-doc/source/texlive/texlive-pl/live.tex b/Master/texmf-doc/source/texlive/texlive-pl/texlive-pl.tex index 271d9340563..84dba6dc6c3 100644..100755 --- a/Master/texmf-doc/source/texlive/texlive-pl/live.tex +++ b/Master/texmf-doc/source/texlive/texlive-pl/texlive-pl.tex @@ -1,11 +1,12 @@ % iso8859-2 -% $Id: live.tex, v. 31 2007/02/03 +% $Id: live.tex, v. 32 2008/07/29 % TeX Live documentation. % Originally written by Sebastian Rahtz and Michel Goossens, % now maintained by Karl Berry and others. % Polish translation and additions by Staszek Wawrykiewicz et al. % Public domain. % ---- +% UWAGA dla recenzentów/tłumaczy: %%! to moje komentarze (StaW) \documentclass{article} \let\tldocenglish=0 % for live4ht.cfg \def\La{La} @@ -34,44 +35,49 @@ %% ----- \begin{document} -\title{{\huge \textit{Przewodnik po \protect\TL}\\\strut} - {\LARGE \textsf\TK{} 2007} +\title{{\huge \textit{Przewodnik po \protect\TL}\\[1ex]} + {\LARGE \textsf\TL{} 2008} } \author{Redakcja: Karl Berry \\[3mm] \url{http://tug.org/texlive/} } -\date{Styczeń 2007} +\date{Lipiec 2008} \maketitle -%\thispagestyle{empty} % no need for page number -%\newpage -%\clearpage % however (SW) \begin{multicols}{2} \tableofcontents -\listoftables +%\listoftables \end{multicols} %-------------------------- \section{Wstęp}\label{sec:intro} + +\subsection{\TeX\ Live i \TeX\ Collection} Niniejsza dokumentacja opisuje oprogramowanie \TL{} -- -dystrybucję \TeX-a/\LaTeX-a dla systemów \acro{GNU}/Linux, różnych -wersji Unix -(w~tym \MacOSX{}) oraz Windows. (Uwaga: dystrybucja jest mało przydatna dla -starszych systemów Mac i~\acro{MS-DOS}.) \TL{} zawiera skompilowane -programy \TeX{}, \LaTeXe{}, \mbox{\MF}, \MP, +dystrybucji \TeX-a i programów pomocniczych dla +systemów \acro{GNU}/Linux, różnych wersji Unix (w~tym \MacOSX{}) +oraz Windows. + +\TL{} można otrzymać ściągając go z~sieci bądź na płytce \DVD \TK{}, która +jest dostarczana przez Grupy Użytkowników Systemu \TeX{} swoim członkom. +Część \ref{sec:tl-coll-dists} omawia pokrótce zawartość tej płytki. +Zarówno \TL{}, jak i \TK{} powstały zbiorowym wysiłkiem Grup. +Tu omówimy głównie samą dystrybucję \TL. + +\TL{} zawiera skompilowane programy \TeX{}, \LaTeXe{}, \mbox{\MF}, \MP, \BibTeX{} i~wiele innych oraz bogaty zestaw pakietów makr o~wielorakim zastosowaniu, a także fonty i~dokumentacje, umożliwiające skład publikacji -w~wielu językach. \TL{} wchodzi w~skład \TK{} -(kolekcji opisanej w~skrócie poniżej), utworzonej wspólnym wysiłkiem grup -użytkowników systemu \TeX. +w~wielu językach. -Nowsze wersje pakietów można znaleźć na serwerach \acro{CTAN}, np. +Pakiety zawarte w \TL{} są regularnie aktualizowane z serwerów \acro{CTAN}: \url{http://www.ctan.org}. -Lista najważniejszych zmian, jakie dokonano w~tej edycji \TL{} -znajduje się w~części~\ref{sec:tlcurrent}, na str.~\pageref{sec:tlcurrent}. +Lista najważniejszych zmian, jakie dokonano w~tej edycji \TL{}, +znajduje się + w~części~\ref{sec:tlcurrent}, na str.~\pageref{sec:tlcurrent}. + %w~części~\ref{sec:history}, na str.~\pageref{sec:history}. Nie opisujemy tu, czym jest system \TeX{}, a~jedynie kwestie instalacji i~konfiguracji oprogramowania \TL. @@ -79,50 +85,47 @@ Początkujący użytkownicy mogą zapoznać się z~podstawowymi pojęciami np. w~artykule {\it Przewodnik po systemie \TeX\/}: \OnCD{texmf-doc/doc/polish/tex-virtual-academy-pl/cototex.html}. -\subsection{Podstawy użycia \protect\TL{}} -\label{sec:basic} +\subsection{Obsługiwane systemy operacyjne} +\label{sec:os_support} -Z~\TL{} można korzystać na kilka sposobów: +\TL{} zawiera oprogramowanie dla wielu platform linuksowych i uniksowych, +w~tym \MacOSX. Załączone pliki źródłowe pozwalają na zainstalowanie +na dodatkowych platformach. -\begin{enumerate} -\item uruchamiać wszystkie programy bezpośrednio z~płytki \DVD{} -(patrz rozdział~\ref{sec:multiple-dist} na str.~\pageref{sec:multiple-dist}); -na dysku twardym znajdą się jedynie niezbędne pliki konfiguracyjne -i~chociaż wydajność będzie mniejsza niż w~wypadku instalacji na twardym dysku, -instalacja taka będzie w pełni funkcjonalna. - -\item zainstalować część lub cały system na lokalnym twardym dysku; - jest to najczęstsze wykorzystanie \TL; wymagane jest - co najmniej 100 megabajtów, ponad 300 megabajtów dla instalacji - zalecanej i~conajmniej 700 megabajtów dla instalacji kompletnej - (kompletne repozytorium DVD wraz ze wszystkimi fontami to kilka gigabajtów). - -% tego niestety nie obsługujemy -\item doinstalować wybrane pakiety do istniejącego systemu \TeX{} - lub systemu \TL{} zainstalowanego wcześniej. -\end{enumerate} +Jeśli chodzi o Windows, tylko wersje 2000 i nowsze są obsługiwane. Zaniechano +wsparcia dla Windows9x, ME oraz NT, co pozwoliło na uniknięcie specjalnej +(i~pracochłonnej) obsługi tych systemów w~porównaniu z~Linux/Unix. +Wprawdzie brak jest oprogramowania na wersje 64-bitowe, ale aplikacje +32-bitowe powinny na nich działać. -\noindent Szczegóły procedur instalacyjnych podane zostaną dalej -w~rozdziałach poświęconych konkretnym systemom operacyjnym, niemniej jednak -podamy tu skrócony przepis: +W części \ref{sec:tl-coll-dists} omówiono alternatywne rozwiązania +dla Windows oraz \MacOSX. -\begin{itemize*} +\subsection{Podstawy instalacji \protect\TL{}} +\label{sec:basic} -\item głównym skryptem instalacyjnym dla systemów Unix i~\MacOSX{} jest -\texttt{install-tl.sh}; użytkownicy Linuksa mogą wypróbować -\texttt{setuptl/tlpmgui-\var{<platforma>}}, -nowy program instalacyjny o interfejsie graficznym. Bardziej szczegółowe -informacje na ten temat można znaleźć w rozdziale \ref{sec:win-install} -na str.~\pageref{sec:win-install}. +\TL{} można zainstalować z \DVD{} lub internetu. Program instalacyjny +jest niewielki i pozwala pobrać z sieci wszystkie potrzebne pakiety. +Jest to wygodna alternatywa, gdy potrzebujemy jedynie części oprogramowania +\TL. -\item pojedyncze pakiety instalujemy za pomocą skryptu -\texttt{install-pkg.sh}; (Po wykonaniu instalacji za pomocą \texttt{tlpmgui}, -program można użyć ponownie do dodania lub usunięcia pojedynczych pakietów -lub kolekcji.) +Posiadając płytkę \DVD{} możemy nie tylko zaistalować \TL{} na twardym dysku, +ale i~uruchomić programy bezpośrednio z~płytki (a~nawet z~obrazu +\DVD{}, jeśli nasz system pozwala na jego zamontowanie). -\item programem instalacyjnym dla Windows jest \texttt{tlpmgui.exe}. -Program ten może być użyty wielokrotnie do dodawania bądź usuwania pakietów, -a~także do zarządzania instalacją (patrz część~\ref{sec:win-install} i~\ref{sec:win-managing}). +Szczegóły procedur instalacyjnych podane zostaną dalej w~odpowiednich +rozdziałach, tu podamy jedynie skrócony przepis: + +\begin{itemize*} + \item program instalacyjny \filename{install-tl} posiada dwa tryby działania: +tekstowy (domyślny dla Unix/Linux) i graficzny (tzw. \GUI, domyślny dla +Windows); użyty tryb można wymusić podając parametr \code{-gui} bądź +\code{-no-gui}; + +\item jednym z~instalowanych programów jest \prog{tlmgr} (menedżer \TL{}), +który także może być uruchomiony w~trybie tekstowym bądź graficznym; pozwala +on doinstalować lub usunąć pakiety, aktualizować je z~sieci, a także +wykonać różne czynności konfiguracyjne. \end{itemize*} @@ -130,7 +133,7 @@ a~także do zarządzania instalacją (patrz część~\ref{sec:win-install} i~\ref{sec: \label{sec:help} Społeczność \TeX-owa jest bardzo aktywna i~pomocna, stąd też większość -poważnych zapytań nie zostanie pozostawiona bez odpowiedzi. Przed zadaniem +poważnych zapytań nie będzie pozostawiona bez odpowiedzi. Przed zadaniem pytania warto je uprzednio dobrze przemyśleć i~sformułować, ponieważ respondenci to wolontariusze, wśród których znaleźć się mogą mniej lub bardziej doświadczeni użytkownicy. @@ -143,16 +146,17 @@ Oto lista źródeł pomocy, w~kolejności przez nas rekomendowanej: \begin{description} \item [\TeX{} \acro{FAQ}] \TeX-owy \acro{FAQ} jest obszernym zbiorem odpowiedzi na wszelkie rodzaje pytań, od najprostszych do najbardziej -zaawansowanych. Jest on załączony na \TL{} w~katalogu \OnCD{texmf-doc/doc/english/FAQ-en}, -a~także dostępny w~sieci: \url{http://faq.tug.org}. Proponujemy +zaawansowanych. Jest on załączony na \TL{} w~katalogu +\OnCD{texmf-doc/doc/english/FAQ-en}, +a~także dostępny w~sieci: \url{http://www.tex.ac.uk/faq}. Proponujemy tam najpierw zajrzeć. Uruchomiono też serwis \acro{FAQ} w~języku polskim: \url{http://faq.gust.org.pl}. \item [\TeX{} Catalogue] Jeśli poszukujemy konkretnego pakietu, fontu, programu itp., polecamy \TeX{} Catalogue. Jest to obszerne zestawienie -wszelkich tematów dotyczących \TeX-a. Patrz: -\OnCD{texmf-doc/doc/english/catalogue} -lub \url{http://www.ctan.org/tex-archive/help/Catalogue}. +wszelkich pakietów dotyczących \TeX-a. Patrz: + %\OnCD{texmf-doc/doc/english/catalogue} lub + \url{http://www.ctan.org/help/Catalogue/}. \item [\TeX{} Web Resources] Strona \url{http://tug.org/interest.html} zawiera wiele odsyłaczy, w~szczególności do książek, podręczników @@ -198,120 +202,118 @@ systemu \TeX! Omówimy tutaj strukturę i~zawartość dystrybucji \TL{}, a~także \TK{} -- płytki \DVD, w~skład której wchodzi \TL. -\subsection{Rozmaitość dystrybucji: \protect\pkgname{live}, - \protect\pkgname{inst}, \protect\pkgname{protext}} -\label{sec:multiple-dist} +\subsection{The \protect\TeX\protect\ Collection: \TL, pro\TeX{}t, Mac\TeX} +\label{sec:tl-coll-dists} -Ograniczona pojemność formatu \acro{CD-ROM} zmusiła nas -do podzielenia \TK{} na następujące dystrybucje: +The \TK{} \DVD{} zawiera: \begin{description} -\item [live] kompletny system na \acro{DVD}, z możliwością uruchamiania -bezpośrednio z~płyty (zbyt obszerny aby się zmieścił na \acro{CD-ROM}); -płytka zawiera ponadto zrzut zawartości archiwów \CTAN{}, niezależne -od \TL{} dystrybucje \pkgname{protext} (dla Windows), Mac\TeX\ (dla \MacOSX) -oraz wybór dodatkowych pakietów w~katalogu \texttt{texmf-extra}. -Płytka \DVD{} otrzymała nazwę \TK. +\item [\TL] kompletny system na \acro{DVD}, z możliwością uruchamiania +bezpośrednio z~płyty bądź instalacji na twardym dysku; -\CTAN, \pkgname{protext}, Mac\TeX{} i~\texttt{texmf-extra} nie spełniają -przyjętych dla \TL{} wymogów dotyczących swobody kopiowania, wobec -tego należy ten fakt uwzględnić przy redystrybucji bądź modyfikacji zawartości -wymienionych katalogów. +\item [Mac\TeX] dla systemu \MacOSX; posiada on własny program instalacyjny +i dodatkowe programy dla tego systemu; strona domowa projektu: +\url{http://www.tug.org/mactex/}; -\item [inst(alowany)] kompletny system na \CD, gdzie wszystkie pakiety -zostały skompresowane; płytka ta nie nadaje się do bezpośredniego -uruchamiania programów, a~jedynie instalacji na twardym dysku. - -\item [protext] dystrybucja dla Windows, oparta na dystrybucji \MIKTEX +\item [pro\TeX{}t] dystrybucja dla Windows, oparta na dystrybucji \MIKTEX{} rozszerzonej o~dodatkowe narzędzia; całkowicie niezależna od \TL; -\ProTeXt\ posiada własny, łatwy w~obsłudze program instalacyjny i~również -może być uruchamiany bezpośrednio z~płytki. Strona domowa projektu -to \url{http://tug.org/protext}. \ProTeXt\ dostarczono na \pkgname{live} -\DVD oraz na odrębnym nośniku~\CD. - -%\item [demo] dystrybucja na \CD-ie, pozwalająca zarówno na uruchamianie -%bezpośrednio z~nośnika, jak i~zainstalowanie na dysku; wersja ta jest nieco -%uboższa od wersji pełnej: brak tu bardzo obszernego zestawu \acro{CJK} -%(wsparcie dla języków: chińskiego, japońskiego i~koreańskiego) oraz równie -%obszernych pakietów rzadziej używanych fontów (cm-super i~cbtype1), -%znajdziemy tu jedynie programy dla systemów Linux, MacOSX i~Windows. +\ProTeXt\ posiada własny, łatwy w~obsłudze program instalacyjny; + %i~również może być uruchamiany bezpośrednio z~płytki. + strona domowa projektu: \url{http://tug.org/protext}; -\end{description} +\item [CTAN] zrzut zawartości archiwów \CTAN{}; -Poszczególne dystrybucje są rozpoznawalne po nazwie pliku -\texttt{00\var{typ}.TL}, znajdującego się w~głównym katalogu każdej z~płytek. +\item [\texttt{texmf-extra}] katalog z wybranymi pakietami dodatkowymi. -Każda z~grup użytkowników systemu \TeX{} może rozpowszechniać dowolną -płytkę wedle własnych potrzeb i~uznania. (\acro{TUG} dostarcza swoim -członkom wszystkie trzy płytki). +\end{description} + +\CTAN, \pkgname{protext}, i~\texttt{texmf-extra} nie spełniają przyjętych dla +\TL{} wymogów dotyczących swobody kopiowania, wobec tego należy ten fakt +uwzględnić przy redystrybucji bądź modyfikacji zawartości wymienionych +katalogów. -\subsection{Główne katalogi} +\subsection{Główne katalogi \TL} \label{sec:tld} Poniżej wymieniono ważniejsze podkatalogi głównego katalogu dystrybucji \TL. Na płytce \pkgname{live} \DVD cała dystrybucja \TL{} została -umieszczona w katalogu \dirname{texlive2007}, nie zaś w~katalogu głównym +umieszczona w katalogu \dirname{texlive}, nie zaś w~katalogu głównym (poniżej traktujemy go jako katalog główny we wszystkich odniesieniach dotyczących \TL). -\smallskip -\begingroup - \renewcommand{\arraystretch}{1.3} % open up interrow spacing -\begin{tabular}{>{\ttfamily}lp{.78\hsize}} -bin & wykonywalne programy \TeX-owe, zorganizowane w~podkatalogach według - platform systemowych; \\ - %MacOSX & programy pomocnicze dla użytkowników MacOSX (patrz - % część~\ref{sec:mac-install} na str.~\pageref{sec:mac-install}); \\ -setuptl & programy instalacyjne dla Linuksa i~Windows; \\ -source & źródła wszystkich programów, włącznie z~głównymi dystrybucjami - \Webc{} \TeX-a i~\MF{}-a; są one umieszczone w~skompresowanym programem - bzip2 archiwum tar; \\ -support & różne programy pomocnicze związane z~\TeX-em, które \emph{nie} +\begin{ttdescription} +\item[bin] wykonywalne programy \TeX-owe, zorganizowane w~podkatalogach + według platform systemowych; + +\item[readme.html] krótki wstęp z użytecznymi odnośnikami; + +\item[source] źródła wszystkich programów, włącznie z~głównymi dystrybucjami + \Webc{} \TeX-a i~\MF{}-a; + +\item[support] różne programy pomocnicze związane z~\TeX-em, które \emph{nie} są domyślnie instalowane; dla użytkowników systemów Windows dołączono ponadto szereg programów (edytory, ,,shelle TeX-owe''), których zwykle brak w~typowej instalacji - Windows (programy te mogą być szczególnie przydatne dla początkujących); \\ -texmf & drzewo katalogów plików pomocniczych i~dokumentacji dla - \emph{programów} - (patrz: \texttt{TEXMFMAIN} w~następnej części);\\ -texmf-dist & główne drzewo katalogów formatów i~pakietów (zawiera makra, - fonty i~dokumentacje; patrz: - \texttt{TEXMDIST} w~następnej części);\\ -texmf-doc & drzewo samodzielnych dokumentacji (m.in. podręczniki itp.), - niezwiązane z~konkretnymi pakietami, zorganizowane wg. języków. \\ -texmf-var & drzewo dla plików generowanych automatycznie - (patrz: \texttt{TEXMFSYSVAR} w~następnej części);\\ -\end{tabular} -\endgroup + Windows (programy te mogą być szczególnie przydatne dla początkujących); + +\item[texmf] drzewo katalogów plików pomocniczych i~dokumentacji dla + \emph{programów} (patrz: \texttt{TEXMFMAIN} w~następnej części); + +\item[texmf-dist] główne drzewo katalogów formatów i~pakietów (zawiera makra, + fonty i~dokumentacje; patrz: \texttt{TEXMDIST} w~następnej części); + +\item[texmf-doc] drzewo samodzielnych dokumentacji (m.in. podręczniki itp.), + niezwiązane z~konkretnymi pakietami, zorganizowane wg. języków. + +\item[tlpkg] skrypty, programy i inne dane potrzebne do instalacji; + katalog zawiera także ,,prywatne'' dla \TL{} kopie Perl i Ghostscript + dla Windows (nie kolidują one z posiadanymi przez użytkownika podobnymi + programami i działają tylko w ramach instalacji); poza tym dołączono + szybki i wygodny program do podglądu plików postscriptowych (a także PDF) + -- PsView dla Windows. +\end{ttdescription} -\smallskip Prócz podkatalogów wymienionych powyżej, katalog główny zawiera skrypty instalacyjne oraz pliki \filename{README}, w~formacie tekstowym lub HTML, w~kilku językach (również polskim). Katalog \dirname{texmf-doc} zawiera, jak wspomniano wyżej, dokumentacje -ogólne, np. podręczniki (także w~wersjach językowych, jak np. niniejsza -dokumentacja). Dokumentacje programów (man, info) znajdują się w~katalogu -\dirname{texmf/doc}, zaś dokumentacje pakietów makr, fontów i~formatów w~katalogu \dirname{texmf-dist/doc}. Znalezienie konkretnej +ogólne, np. podręczniki (także po polsku). Dokumentacje programów (man, info) znajdują się w~katalogu +\dirname{texmf/doc}, zaś dokumentacje pakietów makr, fontów i~formatów +w~katalogu \dirname{texmf-dist/doc}. Znalezienie konkretnej dokumentacji w~dowolnym z~wymienionych katalogów ułatwi skorzystanie z~programów \cmdname{texdoc} lub \cmdname{texdoctk}. Pomocnym może być także plik \OnCD{doc.html}, który znajdziemy w~głównym katalogu. +Niniejsza dokumentacja w~kilku językach znajduje się w katalogu +\dirname{texmf-doc}: + +\begin{itemize*} +\item{uproszczony chiński:} \OnCD{texmf-doc/doc/chinese/texlive-zh-cn} +\item{czeski/słowacki:} \OnCD{texmf-doc/doc/czechslovak/texlive-cz} +\item{angielski:} \OnCD{texmf-doc/doc/english/texlive-en} +\item{francuski:} \OnCD{texmf-doc/doc/french/texlive-fr} +\item{niemiecki:} \OnCD{texmf-doc/doc/german/texlive-de} +\item{polski:} \OnCD{texmf-doc/doc/polish/texlive-pl} +\item{rosyjski:} \OnCD{texmf-doc/doc/russian/texlive-ru} +\end{itemize*} + \subsection{Predefiniowane drzewa katalogów texmf} \label{sec:texmftrees} W tej części wymieniono wszystkie predefiniowane zmienne specyfikujące drzewa katalogów texmf, wykorzystywane przez system, a~także ich przeznaczenie. Uruchomienie polecenia \texttt{texconfig -conf} pokaże wartości tych zmiennych, dzięki czemu łatwo odnaleźć +conf} pokaże wartości tych zmiennych, dzięki czemu łatwo odnaleźć, które katalogi w~naszej instalacji są przypisane do konkretnych zmiennych. \begin{ttdescription} \item [TEXMFMAIN] Drzewo katalogów zawierające podstawowe dla dystrybucji elementy systemu, jak skrypty (np. \verb+web2c/mktexdir+), - pliki pool i~inne pliki pomocnicze. -\item [TEXMFDIST] Drzewo katalogów gromadzące pakiety makr, fontów itp., + i~inne pliki pomocnicze oraz ich dokumentacje (nie zawiera zatem + pakietów makr ani formatów). +\item [TEXMFDIST] Drzewo katalogów zawierające pakiety makr, fontów itp., tak jak są one oryginalnie dystrybuowane; drzewo to może być współdzielone z~dowolną dystybucją. \item [TEXMFLOCAL] Drzewo katalogów, które administratorzy mogą wykorzystać @@ -319,29 +321,73 @@ które katalogi w~naszej instalacji są przypisane do konkretnych zmiennych. użytkowników serwera. \item [TEXMFHOME] Drzewo katalogów dla prywatnych makr, fontów itp. użytkownika. Rozwinięcie tej zmiennej zależy domyślnie od wartości przypisanej - zmiennej systemowej \verb+$HOME+. -\item [TEXMFCONFIG] Drzewo katalogów wykorzystywane przez narzędzia te\TeX-a + zmiennej systemowej \verb+$HOME+ (w Windows \verb+%USERPROFILE%+). +\item [TEXMFCONFIG] Drzewo katalogów wykorzystywane przez narzędzia \verb+texconfig+, \verb+updmap+ oraz \verb+fmtutil+ do przechowywania - danych konfiguracyjnych (domyślnie w~ramach \verb+$HOME+). + danych konfiguracyjnych (domyślnie w~ramach \envname{TEXMFHOME}). \item [TEXMFSYSCONFIG] Drzewo katalogów wykorzystywane przez narzędzia - te\TeX-a \verb+texconfig-sys+, \verb+updmap-sys+ oraz \verb+fmtutil-sys+ + \verb+texconfig-sys+, \verb+updmap-sys+ oraz \verb+fmtutil-sys+ do przechowywania danych konfiguracyjnych dla całej instalacji. \item [TEXMFVAR] Drzewo katalogów wykorzystywane przez \verb+texconfig+, \verb+updmap+ i \verb+fmtutil+ do przechowywania wygenerowanych plików - formatów i map fontowych (domyślnie w~ramach \verb+$HOME+). + formatów i map fontowych (domyślnie w~ramach \envname{TEXMFHOME}). \item [TEXMFSYSVAR] Drzewo katalogów wykorzystywane przez - \verb+texconfig-sys+, \verb+updmap-sys+ and \verb+fmtutil-sys+ - do przechowywania wygenerowanych plików formatów i~map fontowych - dla całej instalacji. + \verb+texconfig-sys+, \verb+updmap-sys+ and \verb+fmtutil-sys+, a~także + przez program \verb+tlmgr+ do przechowywania wygenerowanych plików + formatów i~map fontowych dla całej instalacji. \end{ttdescription} -Więcej informacji na temat \texttt{texconfig} znajdziemy -w~części~\ref{sec:texconfig}, na str.~\pageref{sec:texconfig}. + %Więcej informacji na temat \texttt{texconfig} znajdziemy + %w~części~\ref{sec:texconfig}, na str.~\pageref{sec:texconfig}. + +\noindent +Domyślny układ katalogów: +\begin{description} + \item[ogólnosystemowy katalog instalacji] może zawierać kilka wydań \TL{}: + \begin{ttdescription} + \item[2007] poprzednie wydanie. + \begin{ttdescription} + \item [...] + \end{ttdescription} + \item[2008] wydanie aktualne. + \begin{ttdescription} + \item [bin] ~ + \begin{ttdescription} + \item [i386-linux] programy dla \GNU/Linux + \item [...] + \item [universal-darwin] programy dla \MacOSX + \item [win32] programy dla Windows + \end{ttdescription} + \item [texmf] określany zmienną \envname{TEXMFMAIN}. + \item [texmf-dist] \envname{TEXMFDIST} + \item [texmf-doc] \envname{TEXMFDOC} + \item [texmf-var] \envname{TEXMFSYSVAR} + \item [texmf-config] \envname{TEXMFSYSCONFIG} + \end{ttdescription} + \item [texmf-local] \envname{TEXMFLOCAL}, katalog zachowywany + od wydania do wydania. + \end{ttdescription} + \item[katalog domowy użytkownika] (\texttt{\$HOME} lub + \texttt{\%USERPROFILE\%}) + \begin{ttdescription} + \item[.texlive2007] prywatne pliki konfiguracyjne + poprzedniego wydania; + \item[.texlive2008] prywatne pliki konfiguracyjne + dla bieżącego wydania; + \begin{ttdescription} + \item [texmf-var] \envname{TEXMFVAR} + \item [texmf-config] \envname{TEXMFCONFIG} + \end{ttdescription} + \item[texmf] \envname{TEXMFHOME} prywatne makra/fonty itp. + \end{ttdescription} +\end{description} \subsection{Rozszerzenia \protect\TeX-a} \label{sec:tex-extensions} -\TL{} zawiera trzy rozszerzenia standardowego \TeX-a: +Standardowy \TeX{} został zamrożony, ale jest i będzie w~przyszłości dostępny +w dystrybucji. \TL{} zawiera ponadto kilka wersji rozszerzonych +standardowego \TeX-a: \begin{description} \item [\eTeX] wersja \label{text:etex} programu \TeX{}, która zawiera @@ -349,21 +395,29 @@ dodatkowo niewielki, lecz silny zestaw nowych poleceń wbudowanych (dotyczących głównie rozwijania makr, leksemów znakowych, interpretacji znaczników itp.) oraz rozszerzenie \TeXXeT{} dla składu od prawej do lewej. W~trybie domyślnym \eTeX{} jest w~100\% zgodny ze -standardowym programem \TeX. Więcej szczegółów znaleźć można na \CD, +standardowym programem \TeX. Więcej szczegółów znaleźć można w~\OnCD{texmf-dist/doc/etex/base/etex_man.pdf}. -\item [pdf\TeX] program umożliwiajšcy zapis zarówno -w~formacie Acrobat PDF, jak i~\dvi{}. Podręczniki znajdziemy -w~katalogu \OnCD{texmf/doc/pdftex/manual/}, zaś przykład -wykorzystania w~pliku \OnCD{texmf/doc/pdftex/manual/samplepdf/samplepdf.tex}. -Jest on domyślnym programem dla większości formatów (prócz plain \TeX). -Należy zaznaczyć, iż rozszerzenia oferowane przez \eTeX-a zostały obecnie wbudowane -na stałe w~program \textsf{pdftex}. Nie ma więc rozróżnienia na ,,maszyny'' -\textsf{pdftex} i \textsf{pdfetex}, jak to miało miejsce w~poprzednich wersjach -programów i~w~poprzednich dystrybucjach TeX Live. - -\item [Xe\TeX] umożliwia kodowanie tekstów w Unicode oraz -fontów OpenType (także tych dostępnych w~systemie), przy czym stosuje +\item [pdf\TeX] program zbudowany na rozszerzeniu \eTeX, umożliwiający +tworzenie plików zarówno w~formacie PDF, jak i~\dvi{}. Jest on domyślnym +programem dla większości formatów (prócz plain \TeX). Nie ma więc +rozróżnienia na ,,maszyny'' \textsf{pdftex} i \textsf{pdfetex}, jak to miało +miejsce w~poprzednich wersjach programów i~w~poprzednich dystrybucjach \TL. +Podręczniki znajdziemy w~katalogu \OnCD{texmf/doc/pdftex/manual/}, zaś +przykład wykorzystania w~pliku +\OnCD{texmf/doc/pdftex/manual/samplepdf/samplepdf.tex}. + +\item [Lua\TeX] jest docelowo sukcesorem pdf\TeX-a, z którym ma być +zgodny wstecz. Powinien także zastąpić Aleph (patrz niżej). Załączony +interpreter Lua (patrz strona domowa \url{http://www.lua.org/}) +pozwala na eleganckie rozwiązanie wielu trudnych problemów \TeX-a. +Program \filename{texlua} posiada funkcjonalność samodzielnego +interpretera Lua i~w~ten sposób jest wykorzystywany w \TL{} do wielu zadań. +Patrz \url{http://www.luatex.org/} i na \DVD{} +\OnCD{texmf-dist/doc/luatex/luatexref-t.pdf}. + +\item [Xe\TeX] umożliwia kodowanie tekstów w Unicode oraz korzystanie +z~fontów OpenType (także tych dostępnych w~systemie), przy czym stosuje biblioteki obce, patrz \OnCD{texmf-dist/doc/xetex/XeTeX-reference.pdf} lub \url{http://scripts.sil.org/xetex}. @@ -374,11 +428,13 @@ z~większością tekstów spotykanych na świecie. Wspomaga także dynamicznie ładowane tzw. ,,procesy tłumaczenia \OMEGA'' (\acro{OTP}), co pozwala użytkownikowi definiować złożone transformacje wykonywane na dowolnych strumieniach wejściowych. Więcej szczegółów znaleźć można na \CD: -\OnCD{texmf-dist/doc/omega/base/doc-1.8.tex} (dokumentacja niezbyt aktualna). +\OnCD{texmf-dist/doc/omega/base/doc-1.8.tex} (dokumentacja niezbyt aktualna; +sam program też od dawna nie jest aktualizowany). \item [Aleph] łączy rozszerzenia \OMEGA\ i~\eTeX; powstał jako niezależny projekt z~potrzeby stabilnej ,,używalności'' programu Omega, w~sytuacji -gdy ten jest ciągle w~fazie eksperymentalnej. +gdy ten jest ciągle w~fazie eksperymentalnej. Minimalna dokumentacja: +\OnCD{texmf-dist/doc/aleph/base}. \end{description} @@ -408,25 +464,26 @@ w~dystrybucji \TL{}: do wspomnianego wyżej programu pdf\TeX{} (pakiety \pkgname{ps4pdf} i~\pkgname{pdftricks} dostarczają kolejnych możliwości); -\item [psselect, psnup, \ldots] narzędzia manipulacji na plikach \PS-owych; +\item [psselect, psnup, \ldots] narzędzia manipulacji na plikach +postscriptowych; \item [lacheck] kontrola syntaktyki plików \LaTeX-owych; -\item [texexec] program uruchomieniowy dla Con\TeX{}t; +\item [texexec, texmfstart] programy uruchomieniowe dla Con\TeX{}t; -\item [tex4ht] konwerter \TeX{} do HTML. +\item [tex4ht] konwerter \TeX{} do HTML i XML. \end{cmddescription} -%% zostawiam tę część, choć wyleciała z wersji oryginalnej!!! 27.08.2003 +%%! zostawiam tę część, choć wyleciała z wersji oryginalnej!!! 27.08.2003 \subsection[Pakiety i ich zestawy]{Pakiety i ich zestawy} \label{packages} Zawartość drzew \texttt{texmf} na \TL{} została do celów instalacji zorganizowana w~szereg ,,zestawów'' (\emph{collections}), z~których każdy posiada zbiór ,,pakietów'' (\emph{packages}; jest ich obecnie -ponad 1500). Normalna instalacja pozwala użytkownikowi skopiować -z~\CD{} (\DVD{}) na twardy dysk jeden lub więcej zestawów, jest też jednak +ponad 2500). Normalna instalacja pozwala użytkownikowi skopiować +z~\DVD{} na twardy dysk jeden lub więcej zestawów, jest też jednak możliwe zainstalowanie jedynie pojedynczego pakietu. Zestawy pozwalają lepiej dobrać instalowane składniki, a~także określić @@ -435,9 +492,7 @@ dla większości zastosowań, to ,,basic''. Zestawy ,,latex'' i~,,pdftex'' są rekomendowane dla większości użytkowników. Pozostałe zestawy są opcjonalne. -Oto dostępne zestawy (zdefiniowane w~plikach XML o~nazwach poprzedzonych -członem \texttt{collection-}, umieszczonych -w~podkatalogu \texttt{texmf/tpm/}) i~krótki opis ich zawartości: +Oto dostępne zestawy i~krótki opis ich zawartości: \begin{description} \item[basic] podstawowe programy, pakiety makr i~fontów systemu \TeX{}, @@ -492,8 +547,8 @@ w~podkatalogu \texttt{texmf/tpm/}) i~krótki opis ich zawartości: %\item[langnorwegian] norweski; %\item[langother] wzorce przenoszenia wyrazów dla innych języków; \item[langpolish] zawiera polskie pakiety: makra do tworzenia formatu MeX, - pakiety \texttt{platex}, \texttt{mwcls}, fonty, makra dodatkowe, przydatne dla - polskich użytkowników, dokumentacje w~języku polskim; + pakiety \texttt{polski}, \texttt{mwcls}, fonty, makra dodatkowe, + przydatne dla polskich użytkowników, dokumentacje w~języku polskim; %\item[langportuguese] portugalski; %\item[langspanish] hiszpański; %\item[langswedish] szwedzki; @@ -518,644 +573,609 @@ w~podkatalogu \texttt{texmf/tpm/}) i~krótki opis ich zawartości: \item[publishers] pakiety makr pochodzące od różnych wydawnictw; \item[t1utils] narzędzia do fontów w~formacie Type~1; \item[texbooks] przykłady i~inne materiały autorstwa D.E.~Knutha; -\item[ttfutils] narzędzia do konwersji fontów True Type; - %\item[xemacs] dodatkowe programy wspomagające dla Windows (zaawansowany - % edytor XEmacs -- zintegrowane środowisko do pracy z~\TeX{}em, Perl, programy - % konwersji grafiki, itp.); +\item[ttfutils] narzędzia do konwersji fontów True Type. \end{description} %-------------------------- -Katalog \texttt{texmf/lists/} (wykorzystywany podczas instalacji) +%%! koniec pozostawionej sekcji 27.08.2003 + +Plik \texttt{tlpdb/texlive.tlpdb} (wykorzystywany podczas instalacji) zawiera spis wszystkich plików w~każdym pakiecie. -%% koniec pozostawionej sekcji 27.08.2003 +\subsection{Fonty w \protect\TL} +\label{sec:tl-fonts} -\section{Instalacja i~użytkowanie w systemach Unix} -\label{sec:unix-install} +\TL{} zawiera wiele wysokiej jakości fontów skalowanych. Patrz +\url{http://tug.org/fonts} oraz +\OnCD{texmf-doc/english/free-math-fonts-survey}. -Jak już wspomniano w~części ~\ref{sec:basic} na str.~\pageref{sec:basic}, -\TL{} można używać na trzy sposoby: +%==== -\begin{enumerate} -\item zamontować płytę (\emph{mount}) \CD{} w~systemie plików, - uruchomić skrypt \texttt{install-tl.sh} i~wybrać opcję \verb|<R>| - (\textit{do not install files, set up to run off CD-ROM/DVD} -- - bez instalacji plików, dostosuj do uruchamiania z~\CD/DVD). Pozwala to - na uruchamianie wszystkich programów bezpośrednio z~płytki; na dysku twardym - znajdą się jedynie niezbędne pliki konfiguracyjne. -\item zainstalować część lub cały system na lokalnym twardym dysku. -\item doinstalować wybrane pakiety do istniejącego systemu \TeX{} - lub systemu \TL{} zainstalowanego wcześniej. -\end{enumerate} +\section{Instalacja} +\label{sec:install} -\noindent Każda z~tych metod jest dokładniej opisana w~dalszych rozdziałach. - -%%-- ramka z ostrzeżeniem -\ifSingleColumn \begin{figure}[ht]\noindent \fi -\begin{warningbox} -\textbf{Uwaga: } \CD{} i~\DVD{} - %wchodzące w~skład \TK{} - są w~formacie -ISO 9660 (High Sierra), z~rozszerzeniami Rock Ridge (i~Joliet dla Windows). -Aby skorzystać z~wszystkich zalet płytki pod Unixem, twój system operacyjny powinien -obsługiwać rozszerzenie Rock Ridge. Prosimy zapoznać się z~dokumentacją -komendy \cmdname{mount} w~twoim systemie aby sprawdzić, czy to jest możliwe. -Jeżeli używasz wielu różnych maszyn w~sieci lokalnej, zobacz czy możesz -zamontować \CD{}/\DVD{} na tej, która pozwala na użycie Rock Ridge. - -\leavevmode\quad -Współczesne systemy operacyjne - %Linux, FreeBSD, Sun i~\acro{SGI} - powinny umieć bez problemów korzystać z~\CD{}/\DVD. - %Będziemy wdzięczni za wszelkie wskazówki od użytkowników innych systemów, - %którym udało się skorzystać z~niniejszych płytek, z~których to wskazówek - %moglibyśmy skorzystać w~przyszłych wersjach tej dokumentacji. - Dalsze kroki opisane są przy założeniu, że udało się zamontować \CD{}/\DVD{} -w~pełnej zgodności z~Rock Ridge. -\end{warningbox} -\ifSingleColumn\end{figure}\fi - - -\subsection{Uruchamianie \protect\TL{} z~płytki (Unix)} - -\def\runlive{% text repeated in windows section - %Na \CD-ie \texttt{demo} zawarto programy jedynie dla systemów - %Linux, \MacOSX oraz Windows. - Aby korzystać bezpośrednio z~nośnika w~systemach Unix należy użyć - płyty \pkgname{live} \DVD. -} +\subsection{Start instalacji} +\label{sec:inst-start} -\def\startinst{% repeated in other subsections - Najpierw należy zamontować \CD{} lub \DVD{} -- postać polecenia jest zależna -od konkretnej platformy, poniższe działa w~Linux, choć nazwa urządzenia -(tu: \filename{/dev/cdrom}) może się różnić. W~przykładach podajemy -\texttt{>} jako znak zgłoszenia powłoki, zaś to, co wpisuje użytkownik, -jest \Ucom{\texttt{podkreślone}}. -\begin{alltt} -> \Ucom{mount -t iso9660 /dev/cdrom /mnt/cdrom} -\end{alltt} +Instalację \TL{} uruchamiamy skryptem \filename{install-tl} +(\filename{install-tl.bat} dla Windows) z płytki \TK{} \DVD{} +bądź dostępnym w~pakiecie instalacyjnym pobranym z sieci. -\noindent następnie zmieniamy katalog bieżący na katalog montowania: -\begin{alltt} -> \Ucom{cd /mnt/cdrom} -\end{alltt} +\begin{description} +\item [Instalator z sieci:] z archiwum \CTAN, z katalogu +\dirname{systems/texlive/tlnet} +(\url{http://mirror.ctan.org/systems/texlive/tlnet} automatycznie +przekierowuje do najbliższej kopii \CTAN) należy pobrać plik +\filename{install-tl.zip} (dla Unix i Windows), lub znacznie mniejszy +\filename{install-unx.tar.gz} (tylko dla Unix). Po rozpakowaniu, +w katalogu \dirname{install-tl/} znajdziemy skrypty instalacyjne +\filename{install-tl} i \filename{install-tl.bat}. + +\item [\TeX{} Collection \DVD:] po zamontowaniu płytki należy +zmienić katalog bieżący na \dirname{texlive} (w Windows program +instalacyjny powinien uruchomić się automatycznie). \DVD{} otrzymamy +w ramach członkowstwa w dowolnej Grupie Użytkowników Systemu \TeX{} +lub zamówimy (np. w Polsce \url{http://www.gust.org.pl}). +\end{description} -\noindent W~systemie \MacOSX katalog ten znajduje się zwykle w~ramach -\dirname{/Volumes} zaś nośnik montowany jest automatycznie. -} +Dalsze kroki omówiono dokładniej w kolejnych częściach. -\def\installtlsh{ -\noindent Uruchamiamy skrypt instalacyjny \filename{install-tl.sh}: -\begin{alltt} -> \Ucom{sh install-tl.sh} +\subsubsection{Unix} -Welcome to TeX Live... +\noindent +Poniżej \texttt{>} oznacza prompt systemu; to, co wpisuje użytkownik, +zaznaczono \Ucom{\texttt{pogrubieniem}}. W systemach zgodnych z Unix +należy wykonać w oknie terminala: +\begin{alltt} +> \Ucom{cd /path/to/installer} +> \Ucom{perl install-tl} \end{alltt} +(można także uruchomić \Ucom{perl /path/to/installer/install-tl} lub +\Ucom{./install-tl}; w dalszej części nie będziemy powtarzać wszelkich +możliwych kombinacji). -Po komunikatach powitalnych i ukazaniu się głównego menu z -listą opcji, program oczekuje wprowadzenia polecenia -poprzez naciśnięcie wybranego znaku wyświetlonego obok opcji -oraz klawisza Enter (nie należy -wpisywać znaków \verb|<>|; wielkie i~małe litery są tożsame, w~przykładach -podajemy małe litery). -} - -\runlive -\startinst -\installtlsh - -Dla uruchamiania bezpośrednio z~płytki wybieramy najpierw opcję -\Ucom{d}, następnie podopcję \Ucom{1}, która pozwoli nam określić -katalog na generowane przez \TeX-a pliki (fonty, formaty, pliki -konfiguracyjne do modyfikacji ustawień). Jeśli odpowiadają nam ustawienia -domyślne (\dirname{/usr/local/texlive/2007}), możemy pominąć poniższy -fragment. -W~naszym przykładzie użyjemy \dirname{/opt/texlive2007}: +Dla uruchomienia w~trybie graficzny (\GUI) wymagane jest posiadania +w~systemie modułu \dirname{Perl/TK}: \begin{alltt} -Enter command: \Ucom{d} -Current directories setup: -<1> TEXDIR: /usr/local/texlive/2007 -..... -Enter command: \Ucom{1} -New value for TEXDIR [/usr/local/texlive/TeX]: \Ucom{/opt/texlive2007} -..... -Enter command: \Ucom{r} +> \Ucom{perl install-tl -gui} \end{alltt} -\noindent wciśnięcie klawisza \Ucom{r} powoduje powrót do głównego menu, -gdzie wybieramy opcję uruchamiania bezpośrednio z~nośnika, bez instalacji -właściwej na dysku: +Kompletny wykaz dostępnych opcji otrzymamy uruchamiając: \begin{alltt} -Enter command: \Ucom{r} -Preparing destination directories... -..... -Welcome to the TeX Live system! -> +> \Ucom{perl install-tl -help} \end{alltt} - -Następnie należy uaktualnić zmienną \texttt{PATH}, dołączając do niej -katalog zawierający binaria dla danej architektury, -a~także ustawić zmienną \envname{TEXMFSYSVAR} na podany powyżej katalog. Dla -powłoki zgodnej z~Bourne shell (\cmdname{sh}, \cmdname{bash}, \cmdname{ksh}) -możemy dopisać do pliku \filename{$HOME/.profile}: + +\textbf{Uwaga dotycząca uprawnień w UNIX:} aktualna podczas instalacji +wartość \code{umask} będzie respektowana przez program instalacyjny. +Jeśli więc chcemy, aby instalacja była dostępna dla innych, musimy +ustawić wartość np. \code{umask 002}. Więcej informacji na temat +\code{umask} znajdziemy w podręczniku systemowym. + +\begin{figure}[tb] +\begin{boxedverbatim} +======================> TeX Live installation procedure <===================== + +=======> Note: Letters/digits in <angle brackets> indicate menu items <======= +=======> for commands or configurable options <======= + + + Detected platform: Intel x86 with GNU/Linux + + <B> binary systems: 1 out of 16 + + <S> Installation scheme (scheme-full) + + Customizing installation scheme: + <C> standard collections + <L> language collections + 83 collections out of 84, disk space required: 1666 MB + + <D> directories: + TEXDIR (the main TeX directory): + !! default location: /usr/local/texlive/2008 + !! is not writable, please select a different one! + TEXMFLOCAL (directory for site-wide local files): + /usr/local/texlive/texmf-local + TEXMFSYSVAR (directory for variable and automatically generated data): + /usr/local/texlive/2008/texmf-var + TEXMFSYSCONFIG (directory for local config): + /usr/local/texlive/2008/texmf-config + TEXMFHOME (directory for user-specific files): + ~/texmf + + <O> options: + [ ] use letter size instead of A4 by default + [X] create all format files + [X] install macro/font doc tree + [X] install macro/font source tree + [ ] create symlinks in standard directories + + <V> Install for running from DVD + +Other actions: + <I> start installation to HD + <H> help + <Q> quit + +Enter command: +\end{boxedverbatim} +\caption{Główny ekran instalatora w trybie tekstowym (\GNU/Linux)}\label{fig:text-main} +\end{figure} + +\begin{figure}[tb] +\tlpng{install-w32-main}{\linewidth} +\caption{Główny ekran instalatora \GUI{} (Windows)}\label{fig:gui-main} +\end{figure} + +\subsubsection{Mac\,OS\,X} + +Jak wspomniano w części \ref{sec:tl-coll-dists}, dla \MacOSX +przygotowano odrębną dystrybucję Mac\TeX\ (\url{http://tug.org/mactex}). +Dla Mac\TeX\ należy użyć dedykowanego mu programu instalacyjnego, ponieważ +dokonuje on specyficznych ustawień systemu, w szczególności pozwala +na łatwe przełączanie pomiędzy różnymi dystrybucjami \TeX-a dla +\MacOSX: Mac\TeX, gw\TeX, Fink, MacPorts,\ldots + +Mac\TeX\ jest oparty na \TL{} i główne drzewa katalogów są dokładnie te +same, jedynie dodawane są katalogi zawierające specyficzne dla systemu +\MacOSX\ dokumentacje i aplikacje. + +\subsubsection{Windows} + +Gdy używamy instalatora pobranego z sieci (bądź program ten nie uruchamia się +automatycznie po włożeniu \DVD{} do napędu), należy uruchomić +\filename{install-tl.bat} (np. podwójnym kliknięciem myszy). +Można to uczynić także z linii poleceń -- gdy katalog zawierający ten plik +jest bieżącym, wystarczy uruchomić: \begin{alltt} -PATH=/mnt/cdrom/bin/\var{archname}:$PATH; export PATH -TEXMFSYSVAR=/opt/texlive2007/texmf-var; export TEXMFSYSVAR +> \Ucom{install-tl} \end{alltt} -\noindent gdzie \emph{archname} oznacza konkretną platformę. -W~tabeli~\ref{tab:archlist} zamieszczono spis obsługiwanych systemów -operacyjnych i~odpowiednich dla nich nazw podkatalogów. - %Należy pamiętać, że \emph{demo} \CD{} - %zawiera jedynie binaria dla Windows, Linux dla Intel i~Mac~OSX. - %Dla innych systemów Unix należy zastosować drugi \CD{} bądź \DVD{}. - %W~nazwie podkatalogu możemy pominąć numer wersji, np. - %\dirname{sparc-solaris} jest dowiązaniem do \dirname{sparc-solaris2.7}. - -Dla powłok zgodnych z C shell (\cmdname{csh}, \cmdname{tcsh}), -należy dopisać do pliku \filename{$HOME/.cshrc}: +W linii poleceń można też podać ścieżkę do programu, np.: \begin{alltt} -setenv PATH /mnt/cdrom/bin/\var{archname}:$PATH -setenv TEXMFSYSVAR /opt/texlive2007/texmf-var +> \Ucom{D:\bs{}texlive\bs{}install-tl} \end{alltt} +dla \TK\ \DVD, zakładając, że \dirname{D:} jest napędem \DVD. -\noindent gdzie \emph{archname} -- jak wyżej. - -%\noindent Then log out, log back in, and test your installation -%(see section~\ref{sec:test-install}, \p.\pageref{sec:test-install}). - -\def\textruntexconfig{% -Po zakończeniu instalacji i~ustawieniu zmiennych systemowych warto -uruchomić \cmdname{texconfig} lub \cmdname{texconfig-sys} aby dostroić -instalację do własnych potrzeb -(patrz część~\ref{sec:texconfig}, str.~\pageref{sec:texconfig}). -} -\textruntexconfig - -\begin{table*}[ht] -\caption[Obsługiwane systemy operacyjne]{Obsługiwane systemy operacyjne} -\label{tab:archlist} -\begin{tabular}{>{\ttfamily}ll} -alpha-linux & HP Alpha GNU/Linux \\ -%alphaev5-osf4.0d & HP Alphaev5 OSF \\ -hppa-hpux & HP9000 HPUX \\ % HP9000? -i386-darwin & Intel x86 \MacOSX \\ -i386-freebsd & Intel x86 FreeBSD \\ -i386-linux & Intel x86 GNU/Linux \\ -i386-openbsd & Intel x86 OpenBSD \\ -i386-solaris & Intel x86 Solaris \\ -mips-irix & SGI IRIX \\ -powerpc-aix & IBM RS/6000 AIX \\ -powerpc-darwin & PowerPC \MacOSX \\ -powerpc-linux & PowerPC GNU/Linux \\ -sparc-linux & Sun Sparc GNU/Linux \\ -sparc-solaris & Sun Sparc Solaris \\ -win32 & Windows (32-bit) \\ -x86\_64-linux & x86 64-bit GNU/Linux \\ -\hline -\end{tabular} -\end{table*} - -%Wydawałoby się, że potrzeba wygenerowania fontów czy zmiana konfiguracji -%może spowodować problemy, ponieważ nie można zmieniać plików na \CD. -%Można jednak posiadać na dysku drugie, równoległe drzewo -%\TeX-owe, w~którym można dokonywać zmian. Drzewo takie jest przeszukiwane -%przed głównym drzewem \CD. -%Domyślną lokalizacją jest \path|texmf-var| na \CD{} (katalog, -%który faktycznie nie istnieje!), wobec tego \emph{należy} -%ją zmienić poprzez deklarację zmiennej środowiska \texttt{VARTEXMF}. -% -%Przykładowo, użytkownicy \emph{sh} lub \emph{bash} na Intel PC z~systemem -%Linux mogą zamontować \CD{} \TL{} w~katalogu \file{/mnt/cdrom} za pomocą -%polecenia: -% -%\begin{alltt} -%>> \Ucom{mount -t iso9660 /dev/cdrom /mnt/cdrom} -%\end{alltt} -% -%Po zmianie katalogu bieżącego na główny katalog \CD{} -%należy uruchomić skrypt: -% -%\begin{alltt} -%>> \Ucom{sh install-tl.sh} -%\end{alltt} -%Odpowiednie pliki pomocnicze zostaną zainstalowane na twardym dysku po -%wybraniu opcji \verb|<R>| -%(\emph{do not install files, set up to run off CD-ROM} -- -%bez instalacji pików, dostosuj do uruchamiania z~\CD). -% -%Struktura oprogramowania \Webc{} oznacza, że można uruchamiać programy -%przez zwykłe dodanie do zmiennej \texttt{PATH} odpowiedniego podkatalogu -%katalogu \path|bin| na \CD. Potrzebne pliki będą znajdowane bez dalszych -%problemów. -% -%W~razie wątpliwości najlepiej zwrócić się do lokalnego guru systemowego -%o~pomoc przy instalowaniu \CD{} i~w~wyborze katalogu dla systemu \TeX. - -Po ponownym uruchomieniu sesji polski użytkownik może użyć bezpośrednio m.in. -polecenia \texttt{mex} (spolonizowany format plain), -\texttt{platex} (\LaTeX{} z~polskimi i~anglo\dywiz amerykańskimi wzorcami -przenoszenia wyrazów) oraz ich wersji dla programu \texttt{pdfTeX} (tworzącego -pliki PDF), odpowiednio: \texttt{pdfmex} i~\texttt{pdfplatex}. Potrzebne -pliki formatów zostaną wygenerowane automatycznie podczas pierwszego -uruchomienia danego polecenia i~zapisane w~lokalnym katalogu. Katalog ten, -domyślnie \dirname{/usr/local/texlive/2007/texmf-var/}, a~w~naszym przykładzie -\dirname{/usr/local/texlive/texmf-var/}, zawiera pliki konfiguracyjne, -które mogą być modyfikowane przez użytkownika. W~konfigurowaniu pomocne jest -uruchomienie skryptu \cmdname{texconfig}, opisanego -w~części~\ref{sec:texconfig}. - -%------------------------------------------------ -\subsection{Instalacja \protect\TeX\ \protect Live na twardym dysku} -\label{sec:unix-install-disk} - -Instalacja części lub całości dystrybucji na twardym dysku wymaga -zamontowania płyty \CD{} (lub \DVD) w~systemie, przejścia do jego katalogu -głównego i~uruchomienia skryptu instalacyjnego: +Instalacja w trybie tekstowym wymaga podania: \begin{alltt} -> \Ucom{sh install-tl.sh} +> \Ucom{install-tl -no-gui} \end{alltt} -(W niektórych systemach Unix może zajść potrzeba użycia \cmdname{sh5} -lub \cmdname{bash}.) - -\textbf{Uwaga:} dla systemów Linux załączono w niniejszej edycji \TL{} -alternatywny program instalacyjny \texttt{setuptl/tlpmgui\var{platforma}} -(uruchamiany w~XWindow). Posiada on podobną funkcjonalność jak skrypt -\cmdname{install-tl.sh}, ale po zainstalowaniu może być także ponownie -używany do dodawania lub usuwania pakietów bądź kolekcji oraz do podstawowych -zadań konfiguracyjnych. Program został zlokalizowany dla kilku języków. -Przydatne informacje można znaleźć w rozdziale \ref{sec:win-install} na -str.~\pageref{sec:win-install}. - -\noindent Skrypt \cmdname{install-tl.sh} przeszukuje listy -zestawów i~pakietów z~\CD{} oraz próbuje odgadnąć, z~jakim systemem -komputerowym ma do czynienia. - -Następnie pokaże on główną stronę konfiguracyjną - %(tab.~\ref{tab:main-menu-options}), - umożliwiającą wybór: - -% I prefer here description instead of the table (SW) -\begin{description} -\item \verb|<P>| \emph{Current platform} (systemu operacyjnego, dla którego - chcemy dokonać instalacji, na wypadek gdyby zawiodła automatyczna detekcja); -\item \verb|<B>| \emph{Binary architectures} (dodatkowo instalowanych - binariów dla innych platform, np. na serwerze, z~którego będą korzystać - użytkownicy innych systemów); -\item \verb|<S>| \emph{Installation scheme} (predefiniowanego zestawu - instalacyjnego, np. \emph{full} -- pełnego, \emph{medium} -- - wystarczającego do większości zastosowań, \emph{basic} -- podstawowego; - mamy tu też do wyboru zestaw - proponowany polskim użytkownikom: \emph{GUST scheme}); -\item \verb|<C>| \emph{Standard collections} (zestawów, których wybór - pomaga zmodyfikować dany schemat instalacji); -\item \verb|<L>| \emph{Language collections} (zestawów dla obsługiwanych - języków); -\item \verb|<D>| \emph{Installation directories} (katalogu bazowego na - dysku, przeznaczonego na instalację); -\item \verb|<O>| ustawienia trybu pracy niektórych programów. -\end{description} - -Po wybraniu opcji |<C>| -- \emph{Standard collections}, wyświetlone zostaną -dostępne zestawy. Każdy zestaw zawiera szereg pakietów: makr, fontów itp. -Zaznaczenie zestawu do zaistalowania polega na wciśnięciu odpowiedniego -klawisza, ponowne naciśnięcie tego samego klawisza wyłącza zaznaczenie -(uwaga: wielkie i małe litery są rozróżniane!). - -Po wybraniu opcji |<L>| -- \emph{Language collections}, -wyświetlone zostaną dostępne zestawy dla różnych języków. -Zawierają one najczęściej wzorce przenoszenia wyrazów, czasami -dodatkowe pakiety makr i fontów. Aby zainstalować polskie pakiety -(fonty, makra, dokumentacje), należy w~tym menu wybrać klawisz -odpowiadający opcji \texttt{Polish}. - -Po powrocie do głównego menu można dodatkowo wybrać inne opcje. I~tak: - -\smallskip\noindent -\verb|<D>| \emph{directories} pozwala zmienić domyślne katalogi -instalacji, przypisane zmiennym wewnętrznym: \label{text:instdir} - -\vskip-5pt -\begin{ttdescription} -\item [TEXDIR] katalog bazowy, w~ramach którego zostaną zainstalowane wszystkie - pliki; domyślnie jest to \dirname{/usr/local/texlive/2007}, ale można - go zmienić np. na \dirname{/opt/texlive2007}. - -W systemie \MacOSX{} dostępne programy integrujące oprogramowanie \TeX-owe - %(frontends ???) - %(\emph{TeXShop}, \emph{ITeXMac}, \ldots) - korzystają z~domyślnej -lokalizacji \teTeX{}, czyli \dirname{/usr/local/teTeX}. Wobec czego -użytkownicy Mac dla instalacji \TL{} powinni rozważyć wybór -katalogu \dirname{/usr/local/teTeX} zamiast \dirname{/usr/local/texlive/2007}. - -\item [TEXMFLOCAL] katalog przeznaczony na lokalne pliki makr i~fontów -użytkownika, a~także indywidualne, nie związane z~dystrybucją, uzupełnienia -instalacji; domyślnie jest to \dirname{/usr/local/texlive/texmf-local}. -(Katalog ten jest niezależny od opisanego wyżej katalogu bazowego, ponieważ -jest przeznaczony na lokalnie dodawane makra czy fonty.) - -\item [TEXMFSYSVAR] katalog, który przechowuje pliki generowane przez system - (np. formaty) - (patrz część~\ref{sec:texconfig}, str.~\pageref{sec:texconfig}); - domyślnie \dirname{TEXDIR/texmf-var}. - Istnieje ponadto \envname{TEXMFSYSCONFIG}, katalog dla - aktualnie używanych plików konfiguracyjnych, modyfikowanych - najczęściej przez program \cmdname{texconfig}. -\end{ttdescription} - -\noindent -\verb|<O>| \emph{Other options} -- inne opcje: - -\begin{ttdescription} -\item [a] \emph{alternate directory for generated fonts} -- pozwala określić - katalog dla generowanych fontów (np. jeżeli chcemy zainstalować główny pakiet - w~trybie ,,tylko do odczytu'' - (\emph{read-only})); domyślnie fonty generowane są - w~katalogu określonym przez zmienną \envname{TEXMFVAR}. - -\item [l] \emph{create symbolic links in standard directories} -- pozwala - określić - czy utworzyć dowiązania symboliczne (\emph{links}) dla stron \cmdname{man}, - \acro{GNU} \cmdname{info} i~programów w~standardowych katalogach systemu - operacyjnego, np. \dirname{/usr/local/man}, \dirname{/usr/local/info} oraz - \dirname{/usr/local/bin}. - Wymagane do tego są, oczywiście, uprawnienia administratora. - -\item [d] \emph{do not install font/macro doc tree} -- pozwala pominąć - instalowanie dokumentacji fontów bądź makr, np. dla zaoszczędzenia miejsca - na dysku. - -\item [s] \emph{do not install font/macro source tree} -- - pozwala pominąć instalowanie plików źródłowych fontów bądź makr (dostępnych - np. w~postaci plików \texttt{.dtx}), które nie są wykorzystywane - do bieżącej pracy; - -\end{ttdescription} - -Po zakończeniu ustawień i~po powrocie go głównego menu, -można rozpocząć instalację (klawisz~\Ucom{I}). -Program instalacyjny, uwzględniając wybrane zestawy i~systemy, sprawdzi -spisy plików na \CD{}/\DVD, stworzy listę plików do skopiowania, po czym -skopiuje je na twardy dysk. - -Po instalacji \textbf{należy} dodać do zmiennej \texttt{PATH} właściwy -podkatalog \texttt{bin} instalacji \TeX-a, uaktywnić tę zmienną i~można -już zacząć pracę. - %Jeśli zajdzie potrzeba, można przenieść binaria wyżej o~jeden poziom, - %np. z~\dirname{/usr/local/bin/i386-linux} do \dirname{/usr/local/bin}; - %jednakże po tym należy wyedytować plik \dirname{texmf/web2c/texmf.cnf} - %i~zmienić linię znajdującą się blisko początku pliku: - %\begin{verbatim} - % TEXMFMAIN = $SELFAUTOPARENT - %\end{verbatim} - %na - %\begin{verbatim} - % TEXMFMAIN = $SELFAUTODIR - %\end{verbatim} - %Jeśli przeniesiemy całość instalacji do innego katalogu, należy dokładnie - %to określić, modyfikując zmienną \envname{TEXMFMAIN} w~pliku - %\texttt{texmf.cnf}, a~także ustawiając \envname{TEXMFCNF} na - %\dirname{$TEXMFMAIN/texmf/web2c}. - -\textruntexconfig - -Jeśli w używanym przez nas systemie Linux/Unix działa polecenie \cmdname{manpath} -(sprawdzimy to uruchamiając \code{man manpath}), to wszystkim -użytkownikom systemu można udostępnić elektroniczny poręcznik \TL\ dla -standardowego uruchomiania polecenia \cmdname{man}. W tym celu należy -zmodyfikować plik \filename{/etc/manpath.config} (wymagane są do tego -uprawnienia administratora systemu). -Poniższy wpis w pliku \filename{/etc/manpath.config} pozwoli programowi -\cmdname{man} odnaleźć strony podręcznika (strony \cmdname{man}) \TL\ -w~drzewie instalacji \TL\ (także ścieżka do programów może wymagać -dopasowania do konkretnej architektury systemu): - -\begin{verbatim} -MANPATH_MAP /usr/local/texlive/2007/bin/i386-linux \ - /usr/local/texlive/2007/texmf/doc/man -\end{verbatim} - -%------------------------------------------------ -\subsubsection{Instalacja nieinteraktywna} -\label{sec:noninteractive-install} - -Katalogi domyślne można zastąpić specyfikując odpowiednio zmienne -środowiskowe i~następnie wykonać instalację nieinteraktywną,~np.: +Wszystkie dostępne opcje wyświetlimy uruchamiając: \begin{alltt} -> \Ucom{TEXLIVE_INSTALL_PREFIX=/opt/texlive} -> \Ucom{export TEXLIVE_INSTALL_PREFIX} -> \Ucom{echo i | sh install-tl.sh} +> \Ucom{install-tl -help} \end{alltt} -Zmienna środowiskowa \envname{TEXLIVE\_INSTALL\_PREFIX} określa inny niż -domyślny (\dirname{/usr/local/texlive}) katalog instalacyjny, pozostawiając -wszystkie inne parametry bez zmian, tak więc powyższe polecenia spowodują, że -instalacja zostanie wykonana w katalogu \dirname{/opt/texlive/2007}. - -W standardowy dla systemów Unix sposób, końcowe \Ucom{echo i} można zastąpić -dowolnym zestawem poleceń przy pomocy \texttt{here} \texttt{dokument}, -zatem dowolna sekwencja poleceń może być zawarta w~skrypcie. - -Poniżej lista wszystkich możliwych nadpisań : - -\begin{ttdescription} -\item [TEXLIVE\_INSTALL\_PREFIX] - nadpisuje \dirname{/usr/local/texlive}. -\item [TEXLIVE\_INSTALL\_TEXDIR] - nadpisuje \dirname{\$TEXLIVE_INSTALL_PREFIX}/2007. -\item [TEXLIVE\_INSTALL\_TEXMFLOCAL] - nadpisuje \dirname{\$TEXLIVE_INSTALL_PREFIX/texmf-var}. -\item [TEXLIVE\_INSTALL\_TEXMFSYSVAR] - nadpisuje \dirname{\$TEXLIVE_INSTALL_TEXDIR/texmf-var}. -\item [TEXLIVE\_INSTALL\_TEXMFHOME] - nadpisuje \dirname{\$HOME/texmf}. -\end{ttdescription} - -Zamiast powyższych zmiennych środowiskowych byłoby lepiej zastosować -\filename{configure} z~opcjami, co jest standardowym sposobem dla -stylu \acro{GNU}. Ochotnicy do wykonania takiej pracy są mile widziani! - +\subsubsection{Instalator w trybie tekstowym} + +Rysunek \ref{fig:text-main} przedstawia główny ekran programu +\filename{install-tl} w trybie tekstowym w~systemie Unix. +W tym trybie nie używamy ani klawiszy kursora, ani myszy, +tylko wyłącznie klawiszy cyfr i liter (uwaga: duże i małe litery są +rozróżniane!). Wybraną opcję zatwierdzamy klawiszem Enter. +Instalator w trybie tekstowym jest dlatego tak prosty, by działał na +możliwie wielu platformach, nawet wyposażonych w~ubogie biblioteki Perla +(dla Windows załączono taki podzbiór dystrybucji Perla). + +\subsubsection{Instalator w trybie graficznym} + +Rysunek \ref{fig:gui-main} pokazuje instalator w trybie graficznym +(zrzut ekranu w systemie Windows). + +\subsection{Podczas instalacji} +\label{sec:runinstall} + +Program instalacyjny z założenia jest na tyle prosty, aby szczegółowe +wyjaśnienia były zbędne. Podamy jednak kilka uwag dotyczących różnych opcji +i~dostępnych podmenu. + +\subsubsection{Menu: binary systems (tylko Unix)} +\label{sec:binary} + +\begin{figure}[tbh] +\begin{boxedverbatim} +Available sets of binaries: (Dostępne zestawy programów dla:) +=============================================================================== + + a [ ] alpha-linux DEC Alpha with GNU/Linux + b [ ] amd64-freebsd x86_64 with FreeBSD + c [ ] hppa-hpux HP-UX + d [ ] i386-freebsd Intel x86 with FreeBSD + e [X] i386-linux Intel x86 with GNU/Linux + f [ ] i386-openbsd Intel x86 with OpenBSD + g [ ] i386-solaris Intel x86 with Sun Solaris + h [ ] mips-irix SGI IRIX + i [ ] powerpc-aix PowerPC with AIX + j [ ] powerpc-linux PowerPC with GNU/Linux + k [ ] sparc-linux Sparc with GNU/Linux + l [ ] sparc-solaris Sparc with Solaris + m [ ] universal-darwin universal binaries for MacOSX/Darwin + o [ ] win32 Windows + p [ ] x86_64-linux x86_64 with GNU/Linux +\end{boxedverbatim} +\caption{Wybór platformy (systemu operacyjnego)}\label{fig:bin-text} +\end{figure} + +Rysunek \ref{fig:bin-text} pokazuje (w trybie tekstowym) wybór platformy +(systemu operacyjnego). +Domyśnie tylko programy dla bieżącej platformy są instalowane, +ale menu to pozwala wybrać także zestaw dla innych platform. Może być to +przydatne do instalacji na serwerze i współdzielenia zasobów w sieci +dla różnych systemów operacyjnych bądź dla instalacji + %\textit{dual-boot} + dla kilku systemów na tej samej maszynie. + +\subsubsection{Wybór tego, co ma być zainstalowane} +\label{sec:components} + +\begin{figure}[tbh] +\begin{boxedverbatim} +Select a scheme: (Wybór schematu do instalacji:) +=============================================================================== + + a [ ] TeX Live basic scheme + b [ ] TeX Live scheme for ConTeXt + c [X] TeX Live full scheme + d [ ] GUST TeX Live scheme + e [ ] GUTenberg TeX Live scheme + f [ ] TeX Live medium scheme + g [ ] TeX Live minimal scheme + h [ ] TeX Live for Omega users + i [ ] teTeX scheme + j [ ] XML typesetting scheme +\end{boxedverbatim} +\caption{Menu: wybór schematów}\label{fig:scheme-text} +\end{figure} + +Rysunek \ref{fig:scheme-text} pokazuje menu ,,Wybór schematów''. Schematy to +obszerne zestawy pakietów przeznaczone do wstępnego wyboru instalowanych +komponentów. Mamy tu schematy dla podstawowej (\optname{basic}), +typowej (\optname{medium}) i~pełnej instalacji (\optname{full}; jest ona +domyślna), pozostałe przygotowano z~myślą o~wybranych grupach +użytkowników (np.~GUST i~GUTenberg przygotowały schematy dla swoich +członków), lub zastosowaniach (np.~XML lub Omega). + +\begin{figure}[tbh] +\tlpng{stdcoll}{.7\linewidth} +\caption{Menu Standars Collections (Kolekcje standardowe) (Linux)}\label{fig:collections-gui} +\end{figure} + +Wstępnie wybrane schematy można modyfikować. W skład ,schematów'' wchodzą +tzw. ,,kolekcje'', które można wybrać w~kolejnych menu +,,Kolekcje standardowe'' i~,,Kolekcje językowe'' +(rysunek \ref{fig:collections-gui}). +Kolekcje stanowią niższy poziom i składają się z ,,pakietów''. Dopiero +pakiety zawierają właściwe pliki makr, fontów itp. Jeśli chcemy dodać +lub usunąć pakiet, po instalacji właściwej użyjemy programu \prog{tlmgr} +(patrz \ref{sec:tlmgr}). + +\subsubsection{Katalogi} +\label{sec:directories} + +Domyślny układ katalogów opisano w części~\ref{sec:texmftrees} na +str.~\pageref{sec:texmftrees}. Położenie domyślne całej instalacji +(\dirname{TEXDIR}) różni się w~Windows (|%PROGRAMFILES%\texlive\2008|) +i~w~Unix (\dirname{/usr/local/texlive/2008}). + +Głównym powodem dla którego zmieniamy domyślne położenie \dirname{TEXDIR} +może być brak uprawnień. Nie musimy być administratorem systemu do +zainstalowania \TL, ale musimy posiadać uprawnienia do zapisu w docelowym +katalogu. Logicznym altenatywą może być wtedy instalacja w~katalogu domowym, +szczególnie wtedy, gdy będziemy jedynym użytkownikiem. Stosujemy tu zapis +,,|~|'' do zaznaczenia takiego wyboru, np. `|~/texlive/2008|'. Zalecamy +stosowanie katalogu z rokiem wydania, co pozwoli na instalację obok siebie +różnych wydań \TL{}. + %%! przegadane, na razie olewam (SW) + %(You may wish to make a + %version-independent name such as \dirname{/usr/local/texlive-cur} via a + %symbolic link, which you can then update after testing the new release.) + +Zmiana \dirname{TEXDIR} w programie instalacyjnym zmieni także położenie +\dirname{TEXMFLOCAL}, \dirname{TEXMFSYSVAR} i \dirname{TEXMFSYSCONFIG}. + +\dirname{TEXMFHOME} jest zalecanym położeniem dla prywatnych makr i fontów +użytkownika. Domyślnym katalogiem jest |~/texmf|. W odróżnieniu od +\dirname{TEXDIR}, znak |~| jest zachowywany w generowanych plikach +konfiguracyjnych, ponieważ w wygodny sposób odnosi się do katalogu domowego +podczas każdego uruchamiania programów. Znak ten rozwijany jest do zmiennej +\dirname{$HOME} w~Unix i~\verb|%USERPROFILE%| w~Windows. + +\subsubsection{Opcje} +\label{sec:options} + +\begin{figure}[tbh] +\begin{boxedverbatim} +<P> use letter size instead of A4 by default: [ ] +<F> create all format files: [X] +<D> install font/macro doc tree: [X] +<S> install font/macro source tree: [X] +<L> create symlinks in standard directories: [ ] + binaries to: + manpages to: + info to: +\end{boxedverbatim} +\caption{Menu: Options (Opcje) w Unix}\label{fig:options-text} +\end{figure} + +Rysunek \ref{fig:options-text} pokazuje menu (w trybie tekstowym) +z dodatkowymi opcjami. Warto tu wspomnieć o trzech z nich: -%------------------------------------------------ -\subsection{Instalacja pojedynczych pakietów z~\protect\TL{} -na twardym dysku} -\TL{} można używać zarówno do aktualizacji istniejącej instalacji, -jak i~do dodawania składników do instalacji wcześniejszej. -Główny program instalacyjny przeznaczony jest do użycia tylko za pierwszym -razem (nie dotyczy to wpomnianego wcześniej \cmdname{tlpmgui}), natomiast -później należy używać znajdującego się na \CD{} (\DVD) skryptu -\texttt{install-pkg.sh}. -Uruchamia się go przez zamontowanie nośnika, przejście do katalogu -punktu montowania i~wydanie polecenia: +\begin{description} +\item[use letter size instead of A4 by default] (użyj domyślnego formatu +papieru letter zamiast A4): pozwala określić domyślny format papieru +dla wielu programów. Oczywiście format papieru można specyfikować potem +dla każdego dokumentu. + +\item[create all format files] (generuj wszystkie pliki formatów): +wprawdzie zbędne formaty zajmują miejsce na dysku, zalecane jest +pozostawienie tej opcji włączonej; gdy tego nie zrobimy, formaty będą +generowane automatycznie w~razie potrzeby w prywatnych katalogach +\dirname{TEXMFVAR} użytkowników, ale nie będą odświeżane, gdy w instalacji +zaktualizowane zostaną np. programy bądź wzorce przenoszenia; w skutek tego +formaty mogą być niezgodne. + +\item[create symlinks in standard directories] (utwórz dowiązania w +standardowych katalogach, tylko Unix): opcja ta pozwala uniknąć ustawiania +zmiennych środowiska po instalacji (\envname{PATH}, \envname{MANPATH} i +\envname{INFOPATH}), ale użycie nie jest zalecane, bo może powodować kolizje +z już zainstalowanym w systemie środowiskiem \TeX; może być ona przydatna +jedynie wtedy, gdy w standardowych katalogach (np. \dirname{/usr/local/bin}) +nie ma jakichkolwiek programów \TeX-owych. +\end{description} +Gdy dokonano już wszystkich potrzebnych ustawień, można rozpocząć instalację +(klawisz ,,I''). Po instalacji proszę zajrzeć do części +\ref{sec:postinstall}, bo być może jeszcze jakieś kroki będą potrzebne. + +\subsubsection{Uruchamianie bezpośrednio z DVD{} (tylko w trybie tekstowym)} +\label{sec:fromdvd} + +Należy wybrać opcję ,,|V|'', co zmieni menu na przedstawione na +rys.~~\ref{fig:main-fromdvd}. +\begin{figure}[tbh] +\begin{boxedverbatim} +======================> TeX Live installation procedure <===================== + +=======> Note: Letters/digits in <angle brackets> indicate menu items <======= +=======> for commands or configurable options <======= + + <D> directories: + TEXDIRW (Writable root): + !! default location: /usr/local/texlive/2008 + !! is not writable, please select a different one! + TEXMFLOCAL (directory for site-wide local files): + /usr/local/texlive/texmf-local + TEXMFSYSVAR (directory for variable and automatically generated data): + /usr/local/texlive/2008/texmf-var + TEXMFSYSCONFIG (directory for local config): + /usr/local/texlive/2008/texmf-config + TEXMFHOME (directory for user-specific files): + ~/texmf + + <O> options: + [ ] use letter size instead of A4 by default + [X] create all format files + + <V> set up for installing to hard disk + +Other actions: + <I> start installation for running from DVD + <H> help + <Q> quit +\end{boxedverbatim} +\caption{Menu główne dla uruchamiania z~\optname{DVD}}% +\label{fig:main-fromdvd} +\end{figure} + +Proszę zauważyć zmiany: znikły wszystkie opcje dotyczące wyboru pakietów, +sekcja dotycząca katalogów pokazuje teraz \dirname{TEXDIRW} -- katalog z +prawami do zapisu. Pozwoli to na uruchamianie wszystkich programów +bezpośrednio z~płytki; na dysku twardym znajdą się (w odpowiednich +katalogach) jedynie niezbędne pliki konfiguracyjne. + +Ponieważ struktura katalogów różni się nieco od domyślnej, niezbędne będą +pewne czynności konfiguracyjne, omówione w~części~\ref{sec:postinstall}. + +Z powodu pilniejszych prac i braku czasu opcja ta nie znalazła się +niestety w instalatorze \GUI, ale jest dostępna dla wszystkich systemów. +Użytkownicy Windows powinni zatem uruchomić program z linii poleceń, +jak opisano to w~części~\ref{sec:cmdline}. + +W rozdziale \ref{sec:portable-unix} opisano jeszcze inny, przenośny sposób +uruchamiania \TL, który nie wymaga zmian w~konfiguracji systemu +(a~nawet nie pozwala na nie). + +\subsection{Parametry instalacji z linii poleceń} +\label{sec:cmdline} + +Uruchom \begin{alltt} -> \Ucom{sh install-pkg.sh \emph{opcje}} +> \Ucom{install-tl -help} \end{alltt} - -Skrypt posiada dziewięć parametrów; pierwsze cztery pozwalają wybrać: -pojedynczy pakiet do instalacji, cały zestaw (np. \texttt{mathextra}), -nazwę katalogu zamontowanego \CD, oraz nazwę katalogu zawierającego -pliki ze spisami zawartości pakietów (zwykle te dwa ostatnie ustawiane -są automatycznie): +aby wyświetlić wszystkie dostępne parametry. + % Either |-| or |--| can be used to introduce option names. + Najbardziej interesujące to: \begin{ttdescription} -\item [-{}-package=\var{pkgname}] pojedynczy pakiet do zainstalowania; - -\item [-{}-collection=\var{colname}] pojedynczy zestaw do zainstalowania; - -\item [-{}-cddir=\var{dir}] katalog źródłowy (domyślnie jest to katalog - bieżący, z~którego uruchomiono skrypt); - -\item [-{}-listdir=\var{dir}] katalog ze spisami plików (domyślnie - \dirname{./texmf/tpm/lists}). - +\item[-gui] użyj programu w wersji graficznej (\GUI), jeśli to możliwe; + wymagane jest posiadanie modułu Perl/Tk + (\url{http://tug.org/texlive/distro.html#perltk}); + gdy jest on niedostępny, program instalacyjny uruchomiony zostanie + w trybie tekstowym; +\item[-no-gui] wymusza tryb tekstowy, np. w Windows potrzebny jest on + dla przygotowania do uruchamiania bezpośrednio z~\DVD; +\item[-lang {\sl LL}] pozwala wybrać język komunikatów, + \textsl{LL} oznacza tu dwuliterowy kod języka; aktualnie dostępne są: + angielski (\texttt{en}, domyślny), niemiecki (\texttt{de}), francuski + (\texttt{fr}), holenderski (\texttt{nl}), polski (\texttt{pl}), + słoweński (\texttt{sl}) i wietnamski (\texttt{vi}); program samoczynnie + włącza język, ale jeśli jest to niemożliwe, komunikaty i menu będą + wyświetlane w języku angielskim; +\item[-profile {\sl profile}] program instalacyjny zapisuje plik + \filename{texlive.profile} w katalogu \dirname{2008/tlpkg}, co pozwala + wykorzystać go dla powielenia wszystkich wyborów i ustawień w kolejnych + instalacjach; + %%! zbędny przykład, patrz wer. oryg. (SW) +\item [-location {\sl url/path}] pozwala określić inne niż domyślne źródło + instalacji (patrz poniżej). \end{ttdescription} -Proces instalacji jest określony dokładniej przez pięć kolejnych parametrów: -pierwsze dwa pozwalają wyłączyć z~instalacji dokumentacje i~pliki źródłowe, -trzeci wyłącza domyślne uruchamianie na koniec skryptu \texttt{mktexlsr}, -przebudowującego bazę danych o~plikach, czwarty uruchamia na koniec -skrypt konfiguracyjny \code{texconfig init}, zaś piąty powoduje jedynie -wypisanie plików, które miałyby być zainstalowane: - -\begin{tabular}{ll} -\texttt{-{}-nodoc} & \\ -\texttt{-{}-nosrc} & \\ -\texttt{-{}-nohash} & \\ -\texttt{-{}-config} & \\ -\texttt{-{}-listonly} & \\ -\end{tabular} - -Można także określić, czy zamiast instalować pliki, skrypt powinien -utworzyć z~nich w~wybranej lokalizacji archiwum \cmdname{tar}: - -\begin{tabular}{ll} -\texttt{-{}-archive=}\var{nazwa} & \\ -\end{tabular} - -Dodatkowa opcja \texttt{-{}-verbose} pozwala wyświetlić podczas uruchomienia -bardziej szczegółowe komunikaty. - -Tak więc, jeżeli chcielibyśmy tylko zobaczyć przed zainstalowaniem, -jakie pliki tworzą pakiet \pkgname{fancyhdr}, nasze polecenie wyglądałoby -następująco: - -\begin{alltt} -\ifSingleColumn> \Ucom{sh install-pkg.sh -{}-package=fancyhdr -{}-listonly} -\else> \Ucom{sh install-pkg.sh -{}-package=fancyhdr \bs} -> \Ucom{-{}-listonly} -\fi{} -texmf/source/latex/fancyhdr/README -texmf/doc/latex/fancyhdr/fancyhdr.pdf -..... -\end{alltt} -Oto inne przykłady użycia: -\begin{itemize} -\item zainstaluj \LaTeX-owy pakiet \texttt{natbib}: -\begin{alltt} -> \Ucom{sh install-pkg.sh -{}-package=natbib} -\end{alltt} -\item zainstaluj \LaTeX-owy pakiet \texttt{alg} bez plików źródłowych -i~bez dokumentacji: -\begin{alltt} -\ifSingleColumn> \Ucom{sh install-pkg.sh -{}-package=alg -{}-nosrc -{}-nodoc} -\else> \Ucom{sh install-pkg.sh -{}-package=alg \bs} -> \Ucom{-{}-nosrc -{}-nodoc} -\fi\end{alltt} -\item zainstaluj wszystkie pakiety dostępne w~zestawie -dodatkowych makr dla plain \TeX: -\begin{alltt} -> \Ucom{sh install-pkg.sh -{}-collection=plainextra} -\end{alltt} -\item spakuj wszystkie pliki wymagane dla PSTricks -do~pliku \cmdname{tar}, w~katalogu \dirname{/tmp}: -\begin{alltt} -\ifSingleColumn> \Ucom{sh install-pkg.sh -{}-package=pstricks -{}-archive=/tmp/pstricks.tar} -\else -> \Ucom{sh install-pkg.sh -{}-package=pstricks \bs} -> \Ucom{-{}-archive=/tmp/pstricks.tar} -\fi\end{alltt} -\end{itemize} - -% tłumaczenie: jbl (18.01.2007) -\section{Po zakończeniu instalowania} +\subsubsection{Parametr \optname{location}} +\label{sec:location} + +Wartością przypisaną \optname{location} może być adres w sieci +(rozpoczynający się od \texttt{ftp:}, \texttt{http:} lub \texttt{file:/}), +lub pełna ścieżka. Jeśli podany argument wskazuje na lokalny dysk +(ścieżka bądź adres \texttt{file:/}), automatycznie zostanie dostosowany +typ instalacji (ze skompresowanych plików bądź nie): gdy dostępny będzie +katalog \dirname{archive}, zawierający pliki \filename{.tar.lzma}, wybrana +zostanie instalacja z tych plików, nawet jeśli dostępne będą równolegle +katalogi z plikami nieskompresowanymi. + +%%! póki co, brak czasu na takie szczegóły (SW) +%%! When giving an \texttt{http:} or \texttt{ftp:} location, trailing +%%! `\texttt{/}' characters and/or a trailing `\texttt{/tlpkg}' component +%%! are ignored. For example, you could choose a particular \CTAN\ mirror +%%! with something like: +%%! \url{http://ctan.example.org/tex-archive/texlive/tlnet/2008}, +%%! substituting of course a proper hostname and its particular top-level +%%! \CTAN\ path (the list of \CTAN\ mirrors is maintained at +%%! \url{http://ctan.org/mirrors}) for |ctan.example.org/tex-archive|. The +%%! default is to pick a mirror automatically, using +%%! \url{http://mirror.ctan.org}; in any case, the chosen host is used for +%%! the entire download. + +\subsection{Czynności poinstalacyjne} \label{sec:postinstall} -W każdym systemie operacyjnym, po zakończeniu głównej procedury instalacyjnej, -pozostaje wykonanie dopasowania systemu do lokalnych potrzeb i przeprowadzenie -kilku podstawowych testów. - -Innym rodzajem czynności poinstalacyjnych jest uzyskanie pakietów, fontów -lub programów, które nie zostały dostarczone z \TL{}. Podstawową zasadą jest -instalowanie takich dodatków w drzewie \envname{TEXMFLOCAL} -(jeśli instalacja została wykonana na lokalnym dysku twardym) lub drzewie -\envname{TEXMFSYSVAR} (jeśli \TeX{} jest użytkowany z płyty DVD); por. -opcja ``Installation directories'' na str.~\pageref{text:instdir}. - -Niestety, w szczegółach poszczególne procedury instalacyjne mogą się znacznie -różnić, więc nie podejmiemy tu próby ich opisania. Podamy jedynie kilka -odnośników do dokumentacji zewnętrznej: -\begin{itemize*} -\item -\url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instpackages} -\item -\url{http://www.ctan.org/installationadvice} -\item -\url{http://www.ctan.org/tex-archive/info/beginlatex/html/chapter5.html#pkginst} -\item -\url{http://www.ctan.org/tex-archive/info/Type1fonts} w szczególności są -tam szczegółowe informacje o instalowaniu fontów. -\end{itemize*} - -\subsection{Program texconfig} -\label{sec:texconfig} - Po zakończeniu instalacji i~uaktywnieniu modyfikacji zmiennej systemowej -\envname{PATH}, można użyć programu \cmdname{texconfig}, do skonfigurowania -systemu według własnych potrzeb. Program ten może być w~każdej chwili -uruchomiony do zmiany ustawień, w~trybie in\-ter\-fej\-su pełnoekranowego lub -z~linii poleceń. Program \cmdname{texconfig} powinien być używany do -wszelkich zmian, takich jak deklaracja używanych drukarek czy przebudowywanie -bazy danych o~plikach. Obydwa tryby pracy posiadają tekst pomocy, opisujący -dostępne możliwości. - -Przykłady użycia z~wiersza poleceń: - -\begin{ttdescription} -\item [texconfig dvips paper letter] ustawienie formatu papieru na ,,letter'' - dla programu \cmdname{dvips}; -\item [texconfig xdvi letter] jak wyżej, ale dla programu \cmdname{xdvi}; -\item [texconfig rehash] aktualizacja wszystkich baz danych instalacji - systemu \TeX; -\item [texconfig faq] wyświetla \acro{FAQ} dystrybucji \teTeX{} - (na dystrybucji tej oparto \TL); -\item [texconfig help] wyświetla dostępne opcje skryptu. - -\end{ttdescription} - -Skrypt \cmdname{texconfig} pozwala na zmianę jedynie najważniejszych -ustawień. Głównym plikiem konfiguracyjnym jest \filename{texmf.cnf}. -Zlokalizujemy go uruchamiając polecenie \samp{kpsewhich texmf.cnf}. -Plik ten zawiera sporo użytecznych komentarzy, wyjaśniających -reguły ustawień domyślnych, a także podaje przykłady ustawień alternatywnych. - -Polecenie \cmdname{texconfig} zapisuje pliki w~katalogu użytkownika, na -przykład (\dirname{$HOME/.texlive2007}). Jeśli instalujemy system dla wielu -użytkowników, powinniśmy zatem uruchomić polecenie \cmdname{texconfig-sys}. - -Podobnie rzecz ma się ze skryptami \cmdname{updmap} oraz \cmdname{fmtutil}; -także i~one zapisują pliki w~\dirname{$HOME/.texliveRRRR}. Aby zmienić -globalne ustawienia, wygenerować mapy fontowe bądź formaty, należy użyć -poleceń \cmdname{updmap-sys} i~\cmdname{fmtutil-sys}. W~przypadku instalacji -dla wielu użytkowników warto wygenerować wspólne pliki formatów (polecenie -\texttt{fmtutil-sys --missing}), dzięki czemu uniknie się generowania tychże -przez każdego użytkownika. - -Zmienne specyfikujące katalogi modyfikowane przez powyższe polecenia -opisano w części\ref{sec:tld} na str.~\pageref{sec:tld}. -Uruchomienie polecenia \cmdname{texconfig conf} wyświetli aktualnie -używane katalogi, zaś zmiana ustawień możliwa jest poprzez modyfikację -pliku \texttt{texmf.cnf}. +Część ta nie dotyczy Windows, dla których program instalacyjny przeprowadza +całą konfigurację, włącznie z menu systemowym i ikonami na pulpicie. +Dla użytkowników innych systemów mogą być przydatne poniższe uwagi. + +\subsubsection{Gdy zastosujemy dowiązania symboliczne} + +Użycie opisanej w części~\ref{sec:options} opcji tworzenia dowiązań +symbolicznych w standardowych katalogach nie wymaga zmian w zmiennych +środowiska systemowego. + +\subsubsection{Zmienne środowiska dla Unix} +\label{sec:env} + +Po instalacji wymagane jest dodanie ścieżki do programów \TL{} do zmiennej +\envname{PATH}. Każda dostępna platforma ma własny podkatalog w ramach +\dirname{TEXDIR/bin}. Listę platform i odpowiadających im katalogów +przedstawiono na rys.~\ref{fig:bin-text}. + +Aby wykorzystać systemowe przeglądarki dokumentacji \prog{man} i \prog{info}, +należy również dodać odpowiednie katalogi do ich ścieżek przeszukiwania. + +Dla powłoki zgodnej z~Bourne shell (\cmdname{sh}, \cmdname{bash}, +\cmdname{ksh}) możemy dopisać do pliku \filename{$HOME/.profile}: + +\begin{sverbatim} +PATH=/usr/local/texlive/2008/bin/i386-linux:$PATH; export PATH +MANPATH=/usr/local/texlive/2008/texmf/doc/man:$MANPATH; export MANPATH +INFOPATH=/usr/local/texlive/2008/texmf/doc/info:$INFOPATH; export INFOPATH +\end{sverbatim} + +Dla csh lub tcsh należy zmodyfikować plik \filename{$HOME/.cshrc}, np: + +\begin{sverbatim} +setenv PATH /usr/local/texlive/2008/bin/i386-linux:$PATH +setenv MANPATH /usr/local/texlive/2008/texmf/doc/man:$MANPATH +setenv INFOPATH /usr/local/texlive/2008/texmf/doc/info:$INFOPATH +\end{sverbatim} + +%%! ??? (SW) +%%! Of course, you may well already have settings somewhere in your ``dot'' +%%! files, and so then the \TL\ directories should simply be merged in as +%%! appropriate. + +%%! ??? (SW) +%%! \subsubsection{Environment variables: global configuration} +%%! \label{sec:envglobal} +%%! +%%! If you want to make these changes globally, or for a user newly added to +%%! the system, then you are on your own; there is just too much variation +%%! between systems in how and where these things are configured. +%%! +%%! Our two hints are: 1)~you may want to check for a file +%%! \filename{/etc/manpath.config} and, if present, add lines such as +%%! +%%! \begin{sverbatim} +%%! MANPATH_MAP /usr/local/texlive/2008/bin/i386-linux \ +%%! /usr/local/texlive/2008/texmf/doc/man +%%! \end{sverbatim} +%%! +%%! And 2)~check for a file \filename{/etc/environment} which may define the +%%! search path and other default environment variables. + +\subsubsection{Gdy uruchamiamy z DVD} + +Programy \TL{} korzystają z pliku \filename{texmf.cnf} do znalezienia +potrzebnych danych w różnych drzewach katalogów. Plik \filename{texmf.cnf} +znajdywany jest w całej serii położeń względem położenia samych programów, +ale zasada ta nie działa, gdy uruchamiamy programy bezpośrednio z~\DVD. +Wynika to z faktu, że niektóre pliki są zapisywane na twardym dysku (\DVD{} +jest medium tylko do odczytu) i tracą tym samym predefiniowane względne +położenie. Wymagane jest zatem zdefiowanie w środowisku zmiennej +\envname{TEXMFCNF}, która wskaże położenie \filename{texmf.cnf}. Nadal jest +potrzebna modyfikacja zmiennej \envname{PATH}, jak to już opisano wyżej. + +Na zakończenie instalacji program powinien pokazać komunikat informujący +jaką wartość należy przypisać zmiennej \envname{TEXMFCNF}. Gdybyśmy +to przeoczyli, wartością tą jest \dirname{$TEXMFSYSVAR/web2c}, czyli dla +domyślnych ustawień (\dirname{/usr/local/texlive/2008/texmf-var/web2c}) +potrzebujemy deklaracji: +\begin{sverbatim} +TEXMFCNF=/usr/local/texlive/2008/texmf-var/web2c; export TEXMFCNF +\end{sverbatim} +lub, dla [t]csh: +\begin{sverbatim} +setenv TEXMFCNF /usr/local/texlive/2008/texmf-var/web2c +\end{sverbatim} + +\subsubsection{\ConTeXt{} Mark IV} + +Tak zwany ,,stary'' \ConTeXt{} działa jak dotychczas. Nowy \ConTeXt{} +,,Mark~IV'' wymaga ręcznego dostrojenia, patrz: +\url{http://wiki.contextgarden.net/Running_Mark_IV}. + +\subsubsection{Integracja lokalnych i prywatnych pakietów makr} +\label{sec:local-personal-macros} + +Jak już wspomniano w~części~\ref{sec:texmftrees}, \dirname{TEXMFLOCAL} +(domyślnie \dirname{/usr/local/texlive/texmf-local} lub +\verb|C:\Program Files\texlive\texmf-local|) przeznaczony jest na lokalne +(np. w~danej sieci komputerowej) fonty oraz pakiety makr. Z~kolei +\dirname{TEXMFHOME} (domyślnie \dirname{$HOME/texmf} lub +\verb|%USERPROFILE%\texmf|) jest przeznaczony na prywatne makra i fonty +użytkownika. W zamierzeniu oba katalogi powinny być zachowywane przy +instalacji nowszych wersji \TL{} i~ich zawartość ma być automatycznie +,,widziana'' przez kolejne wydania. Zalecamy zatem, by nie +przedefiniowywać \dirname{TEXMFLOCAL}, co pozwoli uniknąć ręcznych +konfiguracji w~przyszłości. + +W obu drzewach katalogów pliki powinny być umieszczane w~odpowiednich +podkatalogach, zgodnie z~zaleceniami TDS (patrz: \url{http://tug.org/tds}, +także plik \filename{texmf/web2c/texmf.cnf}). Przykładowo pliki klas lub +makr \LaTeX-a powinny być umieszczane w~katalogu +\dirname{TEXMFLOCAL/tex/latex/} lub \dirname{TEXMFHOME/tex/latex/} +(lub ich podkatalogach). + +\dirname{TEXMFLOCAL} po zmianie zawartości wymaga odświeżenia bazy danych +poleceniem \cmdname{mktexlsr} lub poprzez użycie przycisku ,,Odśwież bazy +danych'' w~graficznej wersji programu \prog{tlmgr}. + +\subsubsection{Integracja fontów z innych źródeł} + +Jest to, niestety, mocno zagmatwany temat, wymagający sporej wiedzy +użytkownika. Warto najpierw zapoznać się jakie fonty mamy dostępne bezpłatnie +(patrz część~~\ref{sec:tl-fonts}). + +Zwrócimy tu uwagę na możliwą alternatywę w~postaci \XeTeX (patrz +częśc~\ref{sec:tex-extensions}), który pozwala użyć fontów systemowych +bez potrzeby instalowania ich dla \TeX-a. \subsection{Testowanie instalacji} \label{sec:test-install} @@ -1163,34 +1183,35 @@ pliku \texttt{texmf.cnf}. Po zainstalowaniu \TL{} warto sprawdzić czy programy działają prawidłowo. Opiszemy tu podstawowe procedury testujące funkcjonowanie systemu w~systemach Unix. W~\MacOSX{} i~Windows najczęściej użyjemy -środowiska graficznego (\acro{GUI}), ale reguły będą podobne. +środowiska graficznego (\GUI), ale reguły będą podobne. \begin{enumerate} \item Sprawdzamy najpierw czy uruchamia się program \cmdname{tex}: \begin{alltt} > \Ucom{tex -{}-version} -TeX 3.141592 (Web2C 7.5.5) -kpathsea version 3.5.3 -Copyright (C) 1997-2004 D.E. Knuth. -..... +TeX 3.1415926 (Web2C 7.5.7) +kpathsea version 3.5.7 +... \end{alltt} Jeśli uruchomienie zakończy się komunikatem \emph{command not found}, -oznacza to, że nieprawidłowo zadeklarowano zmienną \envname{PATH}. +oznacza to, że nieprawidłowo zadeklarowano zmienną \envname{PATH} +(patrz deklaracje zmiennych środowiska na str.~\pageref{sec:env}). \item Następnie przetwarzamy prosty plik \LaTeX-owy: \begin{alltt} > \Ucom{latex sample2e.tex} -This is pdfeTeXk, Version 3.141592... +This is pdfeTeXk, Version 3.1415926... ..... -Output written on sample2e.dvi (3 pages, 7496 bytes). +Output written on sample2e.dvi (3 pages, 7484 bytes). Transcript written on sample2e.log. \end{alltt} Gdy program nie znajduje \filename{sample2e.tex} (bądź innych wymaganych plików), może to oznaczać, że nadal działają ustawienia zmiennych środowiska bądź pliki konfiguracyjne z~poprzedniej instalacji. Dogłębną analizę gdzie są przeszukiwane i~znajdywane pliki umożliwia -diagnostyka opisana w~części \ref{sec:Debugging} na str.~\pageref{sec:Debugging}. +diagnostyka opisana w~części \ref{sec:debugging} na +str.~\pageref{sec:debugging}. \item Podgląd wyniku składu: \begin{alltt} @@ -1198,12 +1219,12 @@ diagnostyka opisana w~części \ref{sec:Debugging} na str.~\pageref{sec:Debugging} \end{alltt} Polecenie to wymaga uruchomionego środowiska graficznego X~Window. Dla MS Windows analogicznym poleceniem jest \cmdname{dviout}. - %! - % You should see a new window with a nice document explaining some of the - %basics of \LaTeX{}. (Well worth reading, by the way if you're new to the - %system.) You do have to be running under X for \cmdname{xdvi} to work; if - %you're not, or your \envname{DISPLAY} environment variable is set - %incorrectly, you'll get an error \samp{Can't open display}. + %%! + %%! You should see a new window with a nice document explaining some of the + %%! basics of \LaTeX{}. (Well worth reading, by the way if you're new to the + %%! system.) You do have to be running under X for \cmdname{xdvi} to work; if + %%! you're not, or your \envname{DISPLAY} environment variable is set + %%! incorrectly, you'll get an error \samp{Can't open display}. \item Przetwarzanie wyniku składu do \PS{} w~celu wyświetlenia lub wydruku: \begin{alltt} @@ -1227,6 +1248,10 @@ na \TL. Przed samodzielną instalacją warto odwiedzić strony, odpowiednio: \url{http://www.gnu.org/software/gv} i~\url{http://www.foolabs.com/xpdf}. W~sieci dostępny jest także bezpłatny program Adobe Reader (\url{http://www.adobe.com}). +W~systemie Windows domyślnie instalowany jest program \cmdname{psv} +(PS\_View), pozwalający przeglądać pliki \cmdname{.ps} i~\cmdname{.pdf}. +Program ten można też zainstalować samodzielnie w~systemach Linux +(w~katalogu \dirname{support/} znajdziemy plik \filename{psview-5.09t.zip}). \item Inne przydatne pliki testowe: @@ -1238,8 +1263,8 @@ bezpłatny program Adobe Reader (\url{http://www.adobe.com}). \item [testfont.tex] jak wyżej, ale zamiast \LaTeX-a wymaga jedynie plain \TeX{}; \item [story.tex] najbardziej kanoniczny przykład dla plain \TeX{}; - na zakończenie przetwarzania uruchomionego poleceniem \Ucom{tex story}, - po ukazaniu się \code{*}, należy wpisać \Ucom{\bs bye}. + na zakończenie przetwarzania uruchomionego poleceniem \samp{tex story}, + po ukazaniu się \code{*}, należy wpisać \samp{\bs bye}. \end{ttdescription} \end{enumerate} @@ -1249,261 +1274,294 @@ Początkującym użytkownikom polecamy stronę Petera Flynna \textsl{Formatting Information}, dostępny pod adresem \url{http://www.ctan.org/tex-archive/documentation/beginlatex}. -%-------------- -\section{Instalacja dla systemu \MacOSX{}} -\label{sec:mac-install} - -Na komputerach Macintosh \TL{} działa jedynie pod systemem operacyjnym -\MacOSX (starsze systemy z~działającym systemem \TeX{} mogą -korzystać z~makr, fontów i~dokumentacji o~ile zainstalujemy rozszerzenie -Joliet dostępne na \url{http://www.tempel.org/joliet}). - -\noindent Instalacja pod \MacOSX{} może być wykonana na dwa sposoby. - -W 2005 r. rekomendowana jest instalacja Mac\TeX, nowej dystrybucji -dostępnej na \pkgname{live} \DVD{} w~katalogu \dirname{mactex/}. -Zawiera ona własny program instalacyjny pełnej dystrybucji systemu \TeX, -która jest kombinacją te\TeX-a, \TL{} i~dodatkowych programów oraz -dokumentacji. Szczegóły na temat projektu Mac\TeX{} znajdują się na stronie: -\url{http://tug.org/mactex}. - -Jeśli wolimy, w~\MacOSX{} można także zaistalować \TL, wykorzystując -skrypty \filename{install*}. Wymagane jest do tego posiadanie powłoki -\cmdname{bash}. Od wersji \MacOSX{} 10.2 \cmdname{bash} jest standardowo -dostępny, a~więc instalujemy podobnie jak opisano to powyżej w~części -\ref{sec:unix-install} na str.~\pageref{sec:unix-install}. Wcześniejsze -wersje systemu operacyjnego wymagają aktualizacji, czyli pobrania z~sieci -powłoki \cmdname{bash}. - -%% Mac & bash notes removed 17.11.2004 -% -%\subsection{Środowiska pracy w~\MacOSX{}} -% -%Na komputerach Macintosh używamy zwykle \TeX-a w~środowisku pracy -%obejmującym wiersz poleceń, edytor, program do podglądu itp. -%Mamy do wyboru kilka takich środowisk: -% -%\begin{cmddescription} -%\item [TeXShop] dostępny na \TL{} w~pliku -%\filename{./MacOSX/texshop.dmg}. Szczegółowe informacje można znaleźć -%na stronie \url{http://www.uoregon.edu/~koch/texshop/texshop.html}. -% -%\item [ITeXMac] dostępny na \TL{} w~pliku -%\filename{./MacOSX/iTeXMac-*.dmg}. Patrz też -%\url{http://itexmac.sourceforge.net}. -% -%\item [Mac-emacs] implementacja Emacs dla \MacOSX{} zintegrowana -%z~\pkgname{AucTeX}. Patrz też -%\url{http://www.cs.man.ac.uk/~franconi/mac-emacs}. -% -%\end{cmddescription} -% -%Powyższe środowiska stosują \dirname{/usr/local/teTeX} jako domyślną -%lokalizację oprogramowania \TeX-owego, wobec tego instalację należy -%wykonać w~tym katalogu (bądź zmienić konfigurację środowiska). - -\subsection{Strona kodowa Macintosh CE} -Piszący po polsku użytkownicy \MacOSX{} mają do wyboru stosowanie dwóch -8-bit\-owych stron kodowych: -\begin{description} -\item[iso8859-2] -- co wiąże się z~wykorzystywaniem standardowego - oprogramowania uniksowego (Cocoa używa wyłącznie unikodu), jak na przykład - Emacsa. -\item[Mac CE] -- co pozwala na stosowanie tradycyjnego (Carbon) oprogramowania - jak np.~BBEdit. Weźmy pod uwagę ten przypadek. -\end{description} +\section{Instalacje sieciowe} +\label{sec:netinstall} + +\TL{} zaprojektowano tak, aby mogło korzystać z~niego wielu +użytkowników, nawet w~różnych systemach operacyjnych w~sieci. +Dzięki standardowej strukturze katalogów nie ma potrzeby konfiguracji +i~określania konkretnych ścieżek: położenie plików wymaganych przez programy +\TL{} jest zdefiniowane jako względne wobec samych programów. Można to +zobaczyć w~pliku \filename{$TEXMFMAIN/web2c/texmf.cnf}, który zawiera np. +takie wiersze: +\begin{sverbatim} +TEXMFMAIN = $SELFAUTOPARENT/texmf +... +TEXMFLOCAL = $SELFAUTOPARENT/../texmf-local +\end{sverbatim} +W konsekwencji oznacza to, że dla różnych systemów bądź użytkowników +wystarczy dodać do ich ścieżek przeszukiwania tylko ścieżkę do programów +\TL{}. -\TL{} zawiera w~standardowych pakietach \LaTeX-a -plik \verb|macce.def|, który pozwala wczytywać polski tekst -z~wykorzystaniem pakietu \verb|inputenc|: +Możliwa jest zatem np. instalacja lokalna \TL{}, po czym przeniesienie +całej struktury w~inne miejsce w~sieci. + +Użytkownicy Windows mogą mieć także inne wymagania. +W~katalogu \dirname{texmf-doc/source/texlive/texlive-common/w32client} +znajdziemy przykładowy skrypt \filename{install-w32client}, który +pozwala dostosować istniejącą instalację \TL{} dla potrzeb sieci +(włącznie z~utworzeniem skrótów w~menu systemowym). Wystarczy uruchomić +w~tym katalogu \filename{install-w32client.bat}. + +W części~\ref{sec:kpathsea} dowiemy się więcej o~konfigurowaniu \TL{} +i~zasadach przeszukiwania ścieżek. + +%%! 2 sekcje tłumaczył Kocio (Andrzej Borzyszkowski), przeredagował StaW +\section{Maksymalnie przenośny \protect\TL{} na DVD i~USB} +\label{sec:portable-unix} + +Opcja ,,uruchom z~\DVD{}'', opisana w~rozdziale~\ref{sec:fromdvd}, jest +wprzydatna, jeśli działamy na swoim własnym systemie. Gdy gościmy na cudzym +systemie, prawdopodobnie wolelibyśmy wybrać inną możliwość, bez zbędnych +skutków ubocznych. + +W~głównym katalogu \TL{} \DVD (w~podkatalogu \dirname{texlive} \TK{} \DVD) +znajdziemy skrypt uniksowy \filename{tl-portable} oraz widowsowy +\filename{tl-portable.bat}, które uruchamiają terminal z~ustawieniami +odpowiednimi do bezpośredniego dostępu do \TL{} na \DVD. + +Gdy skrypt ten jest wykonywany po raz pierwszy, generowane są pewne pliki +w~podkatalogu \dirname{~/.tlportable2008}, co zabierze kilka chwil. +W~kolejnych wywołaniach skrypt rozpoczyna działanie niemal natychmiast. + +Reszta systemu nie jest świadoma istnienia \TL. Jeśli chcemy aby nasz edytor +mógł współpracować z~\TL, musimy uruchomić go z~drugiej, +równoległej, sesji \filename{tl-portable}. + +Można również użyć \filename{tl-portable} do wywołania \TL{} z~pendrajwa +\acro(USB). W~takim przypadku należy skopiować wszystkie pliki najwyższego +poziomu oraz zawartość (co najmniej) katalogów \dirname{bin}, +\dirname{texmf}, \dirname{texmf-dist} i~\dirname{tlpkg} na pendrajw. Zajmie +to trochę czasu! Jeśli kopiujemy na pendrajw \acro{USB} sformatowany +z~systemem plików \acro{FAT}32, należy upewnić się, że dowiązania symboliczne +są zastępowane plikami (polecenie \code{cp -L}). Katalog +\dirname{texmf-local} na pendrajwie również będzie używany. + +Następnie wywołamy \filename{tl-portable} z~katalogu głównego pendrajwa +W~tym przypadku skrypt zauważy, że pendrajw można zapisywać i~użyje go do +zapisania wygenerowanych plików. Można zapisać tę zawartość z~powrotem do +\DVD() jeśli np. jest to wygodniejsze do przekazania innym. + +\section{\cmdname{tlmgr}: zarządzanie instalacją} +\label{sec:tlmgr} + +\begin{figure}[tb] +\tlpng{tlmgr-gui}{\linewidth} +\caption{\prog{tlmgr} w~trybie graficznym. Lista pokietów\slash +kolekcji\slash schematów pokaże się dopiero po naciśnięciu klawisza +,,Ładuj'' (Load).}\label{fig:tlmgr-gui} +\end{figure} + +\begin{figure}[tb] +\tlpng{tlmgr-config}{\linewidth} +\caption{\texttt{tlmgr} w~trybie graficznym: zakładka +konfiguracji}\label{fig:tlmgr-config} +\end{figure} + +Instalator instaluje program o~nazwie \prog{tlmgr} służący do dalszego +zarządzania \TL{} po pierwotnej instalacji. Programy \prog{updmap}, +\prog{fmtutil} oraz \prog{texconfig} są nadal dostępne i będą utrzymywane +w~przeszłości, jednakże obecnie polecanym interfejsem jest \prog{tlmgr}. Jego +możliwości obejmują: -\verb|\usepackage[macce]{inputenc}| +\begin{itemize*} +\item pokazanie listy schematów, kolekcji i~pakietów; +\item instalowanie, aktualizacja, kopie zapasowe, odtwarzanie oraz usuwanie + pojedynczych pakietów (opcjonalnie~-- z~uwzględnieniem zależności pomiędzy + pakietami); +\item wyszczególnianie oraz dodawanie architektur (platform systemowych); +\item zmiana opcji instalacji, takich jak rozmiar papieru czy zmiana + położenia źródła instalacji (patrz część~\ref{sec:location}). +\end{itemize*} +\textit{Ostrzeżenie:} \prog{tlmgr} nie był zaprojektowany ani testowany + z~instalacjami, które są wywoływane bezpośrednio z~\DVD. -Ponadto mamy tablice przekodowań dla Mac~CE, niewymagające stosowania -pakietu \verb|\inputenc|. Zamiast niego wystarczy wpisać w~pierwszym wierszu -pliku deklarację: +\subsection{\cmdname{tlmgr} -- tryb graficzny (GUI)} +\prog{tlmgr} może być uruchomiony w~trybie graficznym za pomocą polecenia +\begin{alltt} +> \Ucom{tlmgr -gui} +\end{alltt} +zaś w~systemie Windows poprzez wybór menu: \texttt{Start} \verb+->+ +\texttt{Programy} \verb+->+ \texttt{TeX Live 2008} \verb+->+ \texttt{TeX Live +Manager}. Po kliknięciu przycisku ,,Ładuj'' wyświetla listę dostępnych +oraz listę zainstalowanych pakietów (te ostatnie poprzedzone są ,,(i)''). +Zakładamy oczywiście, że źródła instalacji są poprawne i~są dostępne. -\verb|%& --translate-file=macce-pl| +Rysunek~\ref{fig:tlmgr-config} przedstawia zakładkę konfiguracji. -%-------------------------- -\section{Instalacja i~użytkowanie pod Windows} -\label{sec:win-install} - -Niniejsze wydanie \TL{} zawiera program instalacyjny dla Windows -- -\cmdname{tlpmgui.exe}. Program ten posiada podobne opcje -jak instalator dla systemów Unix: pozwala wybrać schemat, poszczególne -kolekcje, katalogi dla instalacji, a~więc ma funcjonalność opisaną -już w~części~\ref{sec:unix-install-disk} na -str.~\pageref{sec:unix-install-disk}. Dodatkowo, po instalacji właściwej, -możliwe jest dodawanie bądź usuwanie pakietów a~także wykonywanie -najważniejszych czynności administracyjnych, jak aktualizacja bazy danych -instalacji, generowanie formatów czy map fontowych. -Możliwe jest także przygotowanie systemu operacyjnego do uruchamiania -programów bezpośrednio z~\DVD. - -\cmdname{tlpmgui} wykorzystuje jako ,,silnik'' program \cmdname{tlpm}. - -Oprogramowanie dla Windows w~\TL{} jest oparte o~zaktualizowane programy, -zapożyczone (dzięki uprzejmości Akira Kakuto) z~dystrybucji W32TEX. Zawiera -ono także niektóre starsze (ale nadal działające) programy, które napisał -Fabrice Popineau, szczególnie zaś nową przeglądarkę plików \texttt{dvi}, -\textsf{dviout}, autorstwa Toshio Oshimy. - -\TL{} może być instalowany w systemach Windows 98, \acro{ME}, -\acro{NT}, \acro{2K} lub \acro{XP}. - -\textbf{Uwaga:} Użytkownicy Win9.x powinni zadbać aby system posiadał -wystarczający obszar dla nowych zmiennych środowiskowych. W~tym celu -przed instalacją należy dopisać do pliku \verb|C:\config.sys| wiersz -\texttt{SHELL=<path>COMMAND.COM /E:4096 /P} i~ponownie uruchomić komputer. - -\subsection{Instalacja \protect\TeX\protect\ Live na twardym dysku} - -Po włożeniu płyty do napędu \acro{CD}, autostart powinien uruchomić program -\cmdname{tlpmgui}. Jeśli to nie nastąpi, kliknij menu \guiseq{Start\arw -Uruchom} i~wybierz \verb|<litera CD-ROM>:\setuptl\tplmgui.exe| (lub -\verb|<litera DVD>:\texlive\setuptl\tplmgui.exe| jeśli instalujesz -z~płyty \TeX{} Collection DVD), a~następnie kliknij OK. - -Ukaże się okno instalatora zatytułowane \guiseq{Program instalacji -i~konfiguracji TeX Live}. Zawiera ono następujące sekcje: \guiseq{Modyfikacja -schematów}, \guiseq{Instalacja}, \guiseq{Wybierz schemat}, \guiseq{Wybierz -system}, \guiseq{Katalogi} i~\guiseq{Opcje}. - -\textbf{Uwaga:} domyślnie \cmdname{tlpmgui} próbuje wykryć, czy nie mamy -już instalacji \TeX-a. Jeśli znajdzie w~ścieżce specyfikowanej przez zmienną -\texttt{PATH} program \cmdname{tex}, uruchomi się w trybie administracji -(dodawania/usuwania pakietów i czynności konfiguracyjnych; patrz niżej). -Tryb instalacji można wymusić uruchamiając \texttt{tlpmgui --install-mode}, -ale parametr ten powinien być stosowany gdy dokładnie wiemy, co chcemy zrobić. -Zaleca się uprzednie usunięcie starej (bądź uszkodzonej) instalacji, -w szczególności wszystkich zmiennych systemowych odnoszących się do systemu -\TeX. -Dodatkowym parametrem wywołania jest \texttt{--debug}, który powoduje -wyświetlanie nazw i zawartości wszystkich plików tworzonych i zapisywanych -przez \cmdname{tlpmgui}. -Podczas pracy informacje diagnostyczne zapisywane są w pliku log, który -po zakończeniu pracy \cmdname{tlpmgui} jest usuwany wraz z wszystkimi plikami -tymczasowymi. - -W~sekcji \guiseq{Katalogi}, obok przycisku \guiseq{CD/DVD} powinien być -wyświetlony dysk instalacyjny, np. \texttt{F:/} (lub \texttt{F:/texlive/} -dla DVD). Jeśli tak nie jest, -naciśnij przycisk \guiseq{CD/DVD} i~wybierz napęd \acro{CD} z~TeX Live CD -(lub katalog \texttt{texlive} na \TeX{} Collection DVD). - -Za pomocą przycisku \guiseq{TLroot} możesz wybrać katalog, w~którym chcesz -zainstalować \TL. Wybrany katalog zostanie wpisany do zmiennej środowiskowej -\texttt{TLroot} do późniejszego użycia. - %Przyciski \guiseq{TEXMFTEMP} -%i~\guiseq{TEXMFCNF} wskazują relatywne do \guiseq{TLRoot} katalogi (pod -%koniec instalacji zostaną przypisane zmiennym środowiskowym -%\texttt{TEXMFTEMP} i~\texttt{TEXMFCNF}). Katalogi te są automatycznie -%aktualizowane przy zmianie TLroot. - -W~sekcji \guiseq{Wybierz schemat} należy wybrać odpowiedni schemat -instalacyjny \TL{} przez naciśnięcie jednego z~dostępnych przycisków -radiowych (np. \guiseq{scheme-gust}). Przy nazwie każdego schematu znajduje się -przycisk \guiseq{Informacje}, po naciśnięciu którego wyświetlana jest lista -kolekcji zawarta w~wybranym schemacie. - -Schematy to obszerne zestawy pakietów przeznaczone do wstępnego wyboru -instalowanych komponentów. Mamy do wyboru schematy dla podstawowej, -przeciętnej i~pełnej instalacji, pozostałe przygotowano z~myślą o~wybranych -grupach użytkowników (np.~GUST i~GUTenberg przygotowały schematy dla swoich -członków) lub zastosowaniach (np.~XML lub Omega). Wstępnie wybrane schematy -można modyfikować. Dodatkowe kolekcje można wybrać w~sekcji -\guiseq{Modyfikacja schematów}. Na przykład po naciśnięciu przycisku -\guiseq{Wybierz} obok \guiseq{Kolekcji standardowych} można wybrać dodatkowe -kolekcje, takie jak Metapost, Omega lub dokumentacje w~różnych językach. -Wybór zaznaczamy haczykiem. - -Kolekcja \guiseq{Wintools} jest zaznaczona domyślnie. Zawiera ona szereg -niewielkich, acz przydatnych programów, zwykle nieobecnych w~Windows, m.in. -konwertery grafiki \cmdname{sam2p}, \cmdname{jpeg2ps}, \cmdname{tiff2png}, -programy (de)kompresji plików (\cmdname{bzip2}, \cmdname{gzip}, -\cmdname{unzip}), a~także \cmdname{wget} wymagany przez nowe narzędzie: -\cmdname{getnonfreefonts}. - -W~sekcji \guiseq{Modyfikacja schematów}, po przyciśnięciu przycisku -\guiseq{Wybierz} przy \guiseq{Kolekcjach języków}, otwiera się okno, w~którym -można wybrać do zainstalowania dodatkowe kolekcje z~pakietami dla obsługi -konkretnych języków. Wybór zaznaczamy haczykiem. - -Właściwa instalacja rozpoczyna się po naciśnięciu przycisku -\guiseq{Instaluj}. - -\textbf{Uwaga:} \guiseq{Perl} i~\guiseq{Ghostscript} są instalowane tylko -na życzenie. Są one wymagane przez wiele programów, ale można zrezygnować -z~ich instalacji, gdy są już zainstalowane i~wiesz, co robisz. -Ustawiane są także zmienne środowiskowe \verb|PERL5LIB| i~\verb|GS_LIB|, -a~także do \verb|PATH| dodawana jest ścieżka do programów Ghostscipta. -W~każdym razie \guiseq{Perl} i~\guiseq{Ghostscript} powinny być -obecne w~systemie. - -Ponieważ \TL{} wymaga pewnych czynności konfiguracyjnych, zaczekaj cierpliwie -aż do pojawienia się komunikatu o~pomyślnym zakończeniu instalacji. - -Do menu \guiseq{Start\arw Programy\arw TeXLive2007} dodawany jest skrót -do \cmdname{tlpmgui}, a~także \cmdname{dviout}, o ile został zainstalowany -(uruchomienie \cmdname{dviout} bez pliku \cmdname{.dvi} -spowoduje jego automatyczne skonfigurowanie). - -Jeśli to będzie konieczne (Win9x/WinME), będziesz poproszony o~ponowne -uruchomienie komputera. - -\subsection{Uruchomienie z DVD} - -Przy uruchomieniu z DVD mamy dodatkową zakładkę \guiseq{Uruchom z DVD}. -Pozwala ona przygotować \TL{} do pracy wprost z dysku \acro{DVD} bez -instalacji. Po naciśnięciu przycisku \guiseq{Ustaw} dodawane są zmienne -środowiskowe i~generowane są formaty na dysku lokalnym. -Od tej chwili można korzystać z~\TL, pamiętając tylko o~włożeniu płyty -do napędu DVD. - -%\smallskip {\small\noindent -%Bardziej zaawansowani użytkownicy (szczególnie ci, którzy chcą -%uruchamiać programy z~wiersza poleceń i~samodzielnie modyfikować -%ustawienia programów) mogą przygotować system, wykorzystując -%plik wsadowy \cmdname{mkloctex.bat} (katalog \dirname{bin/win32/}). -%Po skopiowaniu pliku na dysk twardy należy go uruchomić z~wiersza poleceń -%(okno DOS/CMD), podając dwa parametry: literę \CD{} i~literę dysku twardego, -%na którym chcemy utworzyć pomocnicze drzewko \TeX-owe. -%Po zapoznaniu się z~końcowymi komunikatami wyświetlanymi -%przez program, zalecane jest wykonanie sugerowanych tam czynności. -% -%} +\subsection{Przykładowe wywołania \cmdname{tlmgr} z~linii poleceń} + +Poniższy przykład dodaje kilka pakietów, włącznie z nowym ,,silnikiem'', +z~innego niż domyślne położenia źródła instalacji: + +\begin{alltt} +> \Ucom{tlmgr -location http://172.16.18.1/tldev install collection-xetex xkeyval} +\end{alltt} +Generuje on poniższy wynik: +\begin{fverbatim} +install: collection-xetex +install: arabxetex +install: euenc +install: bidi +install: fontspec +install: fontwrap +install: ifxetex +install: philokalia +install: polyglossia +install: xecyr +install: xecyr.i386-linux +install: xepersian +install: xetex +install: xetexconfig +install: xetex.i386-linux +running post install action for xetex +install: xetex-def +install: xetex-pstricks +install: xetexfontinfo +install: xltxtra +install: xunicode +install: xkeyval +running mktexlsr +mktexlsr: Updating /usr/local/texlive/2008/texmf/ls-R... +mktexlsr: Updating /usr/local/texlive/2008/texmf-config/ls-R... +mktexlsr: Updating /usr/local/texlive/2008/texmf-dist/ls-R... +mktexlsr: Updating /usr/local/texlive/2008/texmf-doc/ls-R... +mktexlsr: Updating /usr/local/texlive/2008/../texmf-local/ls-R... +mktexlsr: Updating /usr/local/texlive/2008/texmf-var/ls-R... +mktexlsr: Done. +regenerating fmtutil.cnf +running fmtutil-sys --missing +... +Transcript written on xelatex.log. +fmtutil: /usr/local/texlive/2008/texmf-var/web2c/xetex/xelatex.fmt installed. +\end{fverbatim} +Jak widać, \prog{tlmgr} instaluje zależne pakiety i~dba o~niezbędne czynności +poinstalacyjne, włącznie z~aktualizacją bazy danych nazw plików i~powtórnym +wygenerowaniem formatów (w przykładzie wygenerowaliśmy nowy format dla +\XeTeX). + +Poniższy przykład prezentuje instalację nowego języka oraz uruchamia powtórne +wygenerowanie formatów: +\begin{alltt} +> \Ucom{tlmgr install collection-langdutch} +\end{alltt} +Aby wyświetlić informację o~pakiecie, należy uruchomić np.: +\begin{alltt} +> \Ucom{tlmgr show collection-wintools} +\end{alltt} +co daje w~wyniku +\begin{fverbatim} +Package: collection-wintools +Category: Collection +ShortDesc: Windows support programs +LongDesc: Utilities for Windows, since they are not readily available there: + gzip, chktex, jpeg2ps, unzip, wget, xpdf. +Installed: Yes +\end{fverbatim} +Aktualizacja całej instalacji do najnowszej, dostępnej wersji: +\begin{alltt} +> \Ucom{tlmgr update -all} +\end{alltt} +Aby uniknąć zdenerwowania, proponujemy zacząć od: +\begin{alltt} +> \Ucom{tlmgr update -all -dry-run} +\end{alltt} +albo +\begin{alltt} +> \Ucom{tlmgr update -list} +\end{alltt} +Pełną dokumentację programu pokaże polecenie: +\begin{alltt} +> \Ucom{tlmgr -help} +\end{alltt} + +\section{Uwagi dotyczące Windows} +\label{sec:windows} + +\TL\ ma tylko jeden program instalacyjny, działający zarówno w~Unix, +jak i~w~Windows. Stworzenie takiego programu było możliwe dopieo +po zaniechaniu wsparcia dla starszych wersji Windows. Obecnie +\TL\ może być instalowany tylko w~Windows 2000 i~nowszych. + +\subsection{Cechy specyficzne dla Windows} +\label{sec:winfeatures} + +W systemie Windows program instalacyjny wykonuje kilka dodatkowych czynności: +\begin{description} +\item[Menu i skróty.] W menu systemowym instalowane jest podmenu ,,\TL'', +które zawiera kilka pozycji dla programów działających w~trybie graficznym +(\prog{tlmgr}, \prog{texdoctk}, PS\_View -- przeglądarka plików +postscriptowych) oraz dokumentacji. Dla PS\_View tworzony jest także +skrót (ikona) na pulpicie, umożliwiający ,,przeciąganie\dywiz upuszczanie'' +na ikonie plików postscriptowych. +\item[Automatyczne ustawienie zmiennych środowiska.] +Po instalacji nie są wymagane żadne ,,ręczne'' zmiany ustawień. +\item[Odinstalowanie.] Program instalacyjny rejestruje instalację +w~menu ,,Dodaj/Usuń programy'' w~Panelu sterowania; odinstalowanie zatem +odbywa się w~standardowy dla Windows sposób. +\end{description} \subsection{Programy pomocnicze dla Windows} -\label{sec:win-xemtex} + +\begin{figure}[tb] +\tlpng{psview}{.6\linewidth} +\caption{PS\_View: umożliwia bardzo duże powiększenia!}\label{fig:psview} +\end{figure} Aby instalacja była kompletna, \TL{} wymaga kilku pomocniczych programów, które nie są dostarczane wraz z~systemem Windows. Wiele skryptów napisano w~języku Perl, ponadto wiele narzędzi wymaga programu Ghostscript (interpretera języka PostScript) do rasteryzacji bądź konwersji plików. Przydatne są także w~wielu wypadkach -różne programy do obróbki grafiki. Wreszcie~-- posiadanie edytora +różne programy do obróbki grafiki. Ponadto posiadanie edytora zorientowanego na środowisko \TeX{} znacznie ułatwi pracę. Wszystkie takie programy dla Windows dosyć łatwo znaleźć w~sieci, -ale ponieważ jest ich spory wybór, postanowiliśmy te najbardziej godne -polecenia umieścić w~dystrybucji \TL: -\begin{itemize*} -\item \cmdname{Ghostscript} 8.54; -\item minimalną dystrybucję \cmdname{Perl} 5.8, wystarczającą do - uruchomienia wszystkich, zawartych na \TL{} skryptów perlowych; - %\item \cmdname{ImageMagick} 5.5.6 - %\item \cmdname{ISpell} -- korektor pisowni - %\item zaawansowany edytor \textsf{XEmacs} 21.5.14 wraz z~kolekcją - %pakietów do wspomagania pracy w~środowisku programów \TeX-owych. -\item win-tools -- zestaw kilku przydatnych programów (\texttt{bzip2}, -\texttt{gzip}, \texttt{jpeg2ps} i~\texttt{tiff2png}) -\end{itemize*} +ale ponieważ jest ich spory wybór, postanowiliśmy te najbardziej istotne +umieścić w~dystrybucji \TL: +\begin{description} +\item[Perl i Ghostscript.] Oba te programy są niezbędne do +prawidłowego działania \TL, dołączyliśmy zatem \cmdname{Ghostscript} 8.62 +i~minimalną dystrybucję \cmdname{Perl} 5.8, wystarczającą do +uruchomienia wszystkich, zawartych w~TL{} skryptów perlowych; +oba programy zostały ,,ukryte'', to znaczy tylko programy \TL, które +z~nich korzystają, ,,wiedzą'' gdzie je znaleźć; tym samym nie powinny one +kolidować z~ewentualnie zainstalowanymi w~systemie programami Perl +i~Ghostscript; +\item[narzędzia uruchamiane z~linii poleceń] -- zestaw kilku przydatnych + programów + %(\texttt{bzip2}, %% NIE MA!! (SW) + (\texttt{gzip}, \texttt{unzip}, \texttt{jpeg2ps} i~\texttt{tiff2png}) + a~także kilka narzędzi z~zestawu \cmdname{xpdf}, uruchamianych z~linii + poleceń (sam \cmdname{xpdf} nie jest dostępny dla Windows, ale + można pobrać z~internetu opartą na nim przeglądarkę \acro{PDF}: + \url{http://blog.kowalczyk.info/software/sumatrapdf}); +\item[\texttt{fc-cache}] -- program rejestrujący dla \XeTeX{} fonty + systemowe lub dostarczane w~dystrybucji \TL{} fonty OpenType; +\item[PS\_View] -- nowy program podglądu plików postscriptowych (a~także + plików \acro{PDF}), patrz rys.~\ref{fig:psview}. +\end{description} +\begin{description} +\item[katalog \texttt{support,}] wspomniany już w~części~\ref{sec:tld}, + zawiera różne programy, które mogą być użyteczne w~środowisku \TeX-owym + (np. edytory/środowiska dla \TeX-a); programy te \emph{nie są} uwzględniane + podczas instalacji samego \TL, należy je więc samodzielnie zainstalować. +\end{description} + +\subsection{Program Dviout} + +Obecne wydanie \TL{} niestety nie oferuje preinstalowanego programu +do podglądu plików \acro{DVI} dla Windows, ale można samodzielnie +zainstalować doskonały \prog{dviout}, autorstwa Toshio Oshimy. +Znajdziemy go w~katalogu \path{support/dviout/}, zawierający również +krótki plik \filename{README} omawiający jak zaistalować i~skonfigurować +\prog{dviout} dla \TL. Przed instalacją zalecamy przeczytać najpierw +informacje tam zawarte. -Programy \textsf{Perl} i~\textsf{Ghostscript} są instalowane na życzenie, -ponieważ są wymagane do uruchamiania wielu ważnych narzędzi. -Nie ma jednak potrzeby instalowania obu tych programów, jeśli -mamy je już dostępne w~systemie. +Pierwsze uruchomienie \verb+dviout+ zazwyczaj automatycznie generuje wymagane +fonty ekranowe. Po kilku sesjach komunikaty dotyczące generowania fontów +staną się rzadsze. Więcej informacji można znaleźć w~bardzo dobrym +on-line help programu. Poniżej zamieszczono listę miejsc, skąd można pobrać programy pomocnicze: @@ -1511,18 +1569,20 @@ Poniżej zamieszczono listę miejsc, skąd można pobrać programy pomocnicze: \item[Ghostscript] \url{http://www.cs.wisc.edu/~ghost/} \item[Perl] \url{http://www.activestate.com/} (uzupełniające, przydatne pakiety należy pobrać z~zasobów CPAN \url{http://cpan.org}) -\item[ImageMagick] bogaty zestaw narzędzi do wsadowego przetwarzania +\item[ImageMagick] -- bogaty zestaw narzędzi do wsadowego przetwarzania plików graficznych (\url{http://www.imagemagick.com}) -\item[NetPBM] zamiast \textsf{ImageMagick} do przetwarzania i~konwersji plików - graficznych możemy użyć NetPBM (\url{http://netpbm.sourceforge.net/}) -\item[Edytory dla systemu \TeX{}] mamy tutaj spory wybór, zależny od +\item[NetPBM] --- do przetwarzania i~konwersji plików graficznych możemy + użyć alternatywnego dla \textsf{ImageMagick} programu NetPBM + (\url{http://netpbm.sourceforge.net/}) +\item[Edytory dla systemu \TeX{}] -- mamy tutaj spory wybór, zależny od indywidualnych preferencji użytkownika: \begin{itemize*} - \item \cmdname{GNU Emacs} w~wersji zintegrowanej z \textsf{AucTeX} - (\url{ftp://alpha.gnu.org/gnu/auctex}) + \item \cmdname{GNU Emacs} -- w~wersji zintegrowanej z \textsf{AucTeX} + dostępny jest w~\TL{} w~katalogu \path{support/} + (\url{ftp://alpha.gnu.org/gnu/auctex}) % http://www.gnu.org/software/emacs/windows/ntemacs.html}) - \item \cmdname{XEmacs} -- bardziej przyjazna wersja dla Windows - (\url{http://www.xemacs.org/}) +% \item \cmdname{XEmacs} -- bardziej przyjazna wersja dla Windows +% (\url{http://www.xemacs.org/}) \item \cmdname{WinShell} -- prosty edytor/shell, dostępny na \TL w~katalogu \dirname{support/WinShell} (\url{http://www.winshell.de}) \item \cmdname{WinEdt} -- bogaty edytor dla \TeX-a, dostępny jako @@ -1540,374 +1600,85 @@ Poniżej zamieszczono listę miejsc, skąd można pobrać programy pomocnicze: \end{itemize*} \end{description} -Możemy zainstalować z~sieci także inne narzędzia, których zabrakło na -\TL{} z~powodów licencyjnych. Przykładem jest tu \cmdname{GSView}, -wygodny program wykorzystujący \cmdname{Ghostscript} do wyświetlania -i~drukowania plików PS/PDF. Dostępny jest on m.in. -na \url{http://www.cs.wisc.edu/~ghost/gsview/}, a~także na każdym serwerze -\acro{CTAN}. - -\section[Zarządzanie systemem \protect\TL{} w~Windows]{Zarządzanie - systemem \protect\TL{} w~Windows} -\label{sec:win-managing} - -Po zainstalowaniu \TL{} można użyć \texttt{tlpmgui} razem z~\TL{} CD (lub \TeX{} -Collection DVD) do zmian i~administracji Twoją instalacją. -Skrót do \texttt{tlpmgui} dostępny jest w~menu \guiseq{Start\arw Programy\arw -TeXLive2007}. Okno programu zawiera tym razem następujące zakładki: -\guiseq{Dodawanie pakietów}, \guiseq{Usuwanie pakietów}, \guiseq{Zarządzanie -instalacją} i~\guiseq{Odinstalowanie}. - -\subsection{Dodawanie/usuwanie pakietów} - -Zakładki \guiseq{Dodawanie pakietów} lub \guiseq{Usuwanie pakietów} posiadają -następującą funkcjonalność: - -\begin{itemize} -\item W~sekcji \guiseq{Przyciski} naciśnięcie przycisku \guiseq{Szukaj} -wypełnia/odświeża zawartość sekcji \guiseq{Wybierz pakiety do...} czyli -kolekcje i~pakiety do instalacji lub usunięcia. - -Podczas dodawania porównywana jest lista wszystkich pakietów z~\acro{CD} (lub -\acro{DVD}) z~listą uprzednio zainstalowanych. Wyświetlane są tylko -niezainstalowane pakiety. - -Przy usuwaniu wyświetlane są tylko już zainstalowane pakiety. - -Proszę zwrócić uwagę, że w~obu zakładkach wyświetlane są najpierw kolekcje, -a~następnie pojedyncze pakiety. - -\item Wybierz pakiet przez kliknięcie na jego nazwie. Zostanie on -podświetlony. Po naciśnięciu przycisku \guiseq{Informacje} wyświetlany będzie -po prawej krótki opis. Dla wielokrotnego wyboru zaznaczaj kolejne elementy na -liście, klikając na nie przy uprzednio przyciśniętym klawiszu Ctrl lub Shift. -Można zaznaczać również przyciskając lewy klawisz myszy i~przeciągając mysz -w~dół albo w~górę. - -\item Naciśnij przycisk \guiseq{Instaluj} lub \guiseq{Usuń} w~sekcji -\guiseq{Przyciski} by wykonać odpowiednie polecenie. -\end{itemize} - -\subsection{Konfigurowanie i inne zadania administracyjne} - -Polecenia dostępne w~zakładce \guiseq{Zarządzanie instalacją} są pomocne -przy wykonywaniu czynności po dodaniu pakietów językowych, fontów czy -formatów, a~także przy odświeżaniu bazy danych instalacji, czy ręcznym -dodawaniu pakietów (bez pomocy \texttt{tlpmgui}). - -Możemy tu wykonać następujące czynności: - -\begin{itemize} -\item Odświeżenie bazy danych \filename{ls-R} -\item Tworzenie formatów (wszystkich lub brakujących) -\item Edycja \filename{language.dat} -\item Edycja \filename{fmtutil.cnf} -\item Edycja \filename{updmap.cfg} -\end{itemize} - -Uwaga: okno Edycja\dots{} można zamknąć przyciskiem \guiseq{Anuluj} lub -\guiseq{Gotowe}; w~tym drugim wypadku zostaną odbudowane pliki formatów -(bądź mapy fontowe, gdy edytowano \filename{updmap.cfg}), a~następnie zostaną -odświeżone bazy danych instalacji (pliki \filename{ls-R}). - -Więcej informacji na temat indywidualnej konfiguracji zawarto -w~części~\ref{sec:persconf}, na str.~\pageref{sec:persconf}. - -\subsection{Odinstalowanie \protect\TL{}} - -Zakładka \guiseq{Odinstalowanie} udostępnia polecenie, którego działanie nie -jest warte opisu i~nie wiadomo komu jest ono potrzebne\dots :-) - -\textbf{Uwaga:} katalogi \path|texmf-local| (zawierający prywatne fonty, makra -itp.) oraz \path|setuptl| (zawierający \texttt{tlpmgui} i~związane z~nim -pliki) nie są usuwane podczas odinstalowania. Katalogi te należy usunąć -samodzielnie. - -\subsection{Dodawanie własnych pakietów do instalacji} - -Gdy zamierzamy dodać pakiety, których brak w~dystrybucji -\TL, warto instalować je w~katalogu -specyfikowanym przez zmienną \envname{\$TEXMFLOCAL}. W~ten sposób -zabezpieczymy te pakiety podczas aktualizacji/wymiany oprogramowania -\TL{}. - -Katalog wskazywany przez \envname{\$TEXMFLOCAL} jest początkowo pusty. -Przykładowo: dodajemy pakiet dla Maple (przetwarzanie symboliczne); -pliki stylów należy skopiować do katalogu -\path|...\texmf-local\tex\latex\maple\| \ -zaś pliki dokumentacji do katalogu -\path|...\texmf-local\doc\latex\maple\| - -Na zakończenie należy \textbf{koniecznie} zaktualizować bazę danych -instalacji \texttt{ls-R}: albo poprzez wybór z~menu programu \texttt{tlpmgui}, -albo przez uruchomienie z~linii poleceń \file{mktexlsr}. - -\subsection{Uruchamianie \texttt{tlmp.exe} z linii poleceń} - -Program \cmdname{tlpm.exe} jest intensywnie używany jako ,,silnik'' -\cmdname{tlpmgui}. Może być uruchamiany samodzielnie z~linii poleceń -i~posiada wiele użytecznych opcji, które można wyświetlić po uruchomieniu: -\begin{verbatim} -tlpm --help -\end{verbatim} - -Więcej informacji i~przykładów użycia można znaleźć -w~pliku \path|tlpm.readme| (katalog \path|setuptl|). - -\subsection{Instalacja sieciowa} - Biblioteka \KPS{} - %(patrz rozdział \ref{}) - rozpoznaje nazwy UNC, wobec tego -możemy ich użyć dla specyfikacji drzew katalogów TEXMF udostępnianych w~sieci -komputerowej. Wszystkie pliki z~wyjątkiem zawartych w~katalogu -\texttt{bin/win32} mogą być współdzielone z~instalacjami \teTeX{} lub \TL{} -systemów Unix/Linux. Oznacza to, że można użyć Samby do zamontowania serwera -NT dla stacji roboczej Unix lub odwrotnie: serwer np. Linux może udostępniać -zasoby dla stacji Windows. - -\noindent Dostępne są następujące możliwości: - \begin{itemize} -\item Instalacja całego oprogramowania na serwerze. Wystarczy dodać - binaria dla wymaganych systemów w~podkatalogach \texttt{bin}, np. - \texttt{bin/win32} i~\texttt{bin/i386-linux}, następnie należy ustawić główne - zmienne środowiska. W~Windows można użyć nazw UNC dla wskazania odpowiednich - katalogów. -\item Instalacja lokalnych kopii binariów i~plików formatów. W~tym wypadku - należy przypisać zmienną \envname{\$TEXMFMAIN} do katalogu dostępnego - na zdalnej maszynie (w~sieci), a~zmienną \envname{\$VARTEXMF} - do katalogu, który będzie przechowywał lokalne pliki konfiguracyjne - i~inne generowane pliki. -\end{itemize} - -\subsection{Różnice w~stosunku do standardowego \Webc{} w~systemach Win32} -Programy \Webc{} działające w~systemach Win32 posiadają szczególne cechy, -o~których warto wspomnieć: - -\begin{description} - %\item[\KPS{}] -- tablice haszowe, tworzone w~\TL{} przez bibliotekę - % \KPS{}, są bardzo duże. Aby skrócić czas uruchamiania dowolnego programu, - % wykorzystującego \KPS{}, tablice haszowe zostają umieszczone w~pamięci - % współdzielonej przez procesy. W~ten sposób zmniejszono znacznie czas - % uruchamiania programów wywoływanych kolejno, jeden przez drugi - % (np. \texttt{tex} wywołujący \texttt{mpost} wywołujący \texttt{tex}). - % Zmianę tę ukryto przed użytkownikiem, z~wyjątkiem sytuacji, gdy - % zostanie użyta opcja~\texttt{-1} dla diagnostyki działania \KPS; - % można wtedy śledzić wykorzystanie pamięci współdzielonej. - \item[\cmdname{kpsecheck}] -- program ten oferuje kilka opcji - uzupełniających dla programu \cmdname{kpsewhich}. - Pozwala na wylistowanie wszystkich plików, które występują wielokrotnie - w~dostępnych drzewach katalogów texmf. Może to być przydatne, choć - często możemy otrzymywać niepożądane komunikaty o~dziesiątkach plików typu - \texttt{README}. Warto tu wspomnieć, że takie pliki powodują - ,,zapychanie'' się mechanizmu haszowego \KPS{}; na szczęście biblioteka ta - nigdy ich nie wyszukuje. Aby tego uniknąć, należy użyć opcji - \texttt{-multiple-occurences} wraz z~dwiema innymi, pozwalającymi - podać wzorce nazw do pominięcia lub włączenia w~procesie przeszukiwania - (można podać kilka wzorców). - - \cmdname{kpsecheck} raportuje także stan pamięci współdzielonej: używanej - i~nieużywanej. Warto czasem o~tym wiedzieć, gdyż pokazywany - status ,,pamięć w~użyciu'' może oznaczać, że działa kilka procesów - i~efekt wykonania polecenia \cmdname{mktexlsr} zostanie każdorazowo - opóźniony do czasu, aż nie będzie pracował żaden program korzystający - z~\KPS{}. - - \cmdname{kpsecheck} pozwala także określić położenie programu -Ghostscript. W~systemach Win32 łatwiej jest wielu programom skorzystać -z~biblioteki DLL programu Ghostscript i~znaleźć ją na podstawie rejestrów -systemowych, niż na podstawie zmodyfikowanej przez użytkownika zmiennej -\envname{PATH} (ponadto zmienne środowiskowe, szczególnie w~starszych - wersjach systemu Windows, mają dość ograniczoną pojemność). -\item[\Webc{}] -- programy dla Windows posiadają jedną dodatkową opcję - nieobecną w~wersjach kompilowanych dla Unix: - \begin{itemize} - % \item \texttt{-halt-on-error} pozwala zatrzymać przetwarzanie - % na pierwszym napotkanym błędzie; - % \item \texttt{-job-time} ustawia czas tworzonych plików na taki sam - % jak pliku przetwarzanego; - % \item \texttt{-time-statistics} wyświetla statystyki dotyczące czasu - % przetwarzania; - \item \path|-proctimes| wyświetla statystyki dotyczące czasu przetwarzania; - warto tu wspomnieć, że systemy Win9x, nie będąc prawdziwymi systemami - wielozadaniowymi, nie mają prawidłowo działającego pomiaru czasu dla - krótkotrwałych procesów, wobec tego wyświetlane wartości są jedynie - przybliżone; w~NT/2K/XP wyniki są bardziej dokładne; w~Win32 brak - polecenia \texttt{time} znanego z~systemów Unix. - \end{itemize} -\end{description} - - -\subsection{Konfiguracja indywidualna} -\label{sec:persconf} -\subsubsection{Dvips} - -Plik konfiguracyjny \verb+config.ps+ programu Dvips znajduje się -w~katalogu \path|C:\TeXlive2007\texmf-var\dvips\config\|. -Plik ten można otworzyć w~dowolnym edytorze (np. w~\cmdname{WinShell}) -po to, aby zmienić niektóre parametry działania Dvips. Najważniejsze z~nich -zgrupowano w~blokach deklaracji: - -\begin{description} -\item [fonty] -- można zmienić domyślne parametry generowania fontów -przez \MF{}-a dla danej drukarki (parametr \texttt{M}) i~rozdzielczość -(parametry \texttt{D}, \texttt{X}, \texttt{Y}). Standardowo -fonty generowane są dla drukarek laserowych, zgodnych z~Hewlett Packard -(tryb ljfour), w~rozdzielczości 600~dpi. Domyślnie ustawiono wykorzystanie -fontów CM (oraz PL) w~ich wersji obwiedniowej (Type~1), wobec tego -Dvips nie powinien odwoływać się zbyt często do programu -\cmdname{mktexpk}. -\item[drukarka] -- parametr `o' określa nazwę portu/przekierowania wydruku. -Gdy nie wpisano nazwy drukarki (portu), wynik pracy będzie -zapisywany w~pliku PostScriptowym \verb+.ps+. Drukarkę specyfikujemy -jednym z~poniższych sposobów: -\begin{verbatim} -o lpt1: -% o | lpr -S server -P myprinter -% o \\server\myprinter -\end{verbatim} - %\item[mapy fontowe] -- do standardowej mapy fontowej \verb+psfonts.map+ - % (wiersz: \verb+p psfonts.map+) możemy dołączyć dodatkowe mapy fontowe, - % np.: - %\begin{verbatim} - %p +bsr.map - %p +hoekwater.map - %\end{verbatim} - %parametr \verb+p+ musi znajdować się w~pierwszej kolumnie; nazwy plików - %z~dołączanymi mapami poprzedzamy znakiem \texttt{+}; zbędne mapy - %można wyłączyć, wstawiając na początku wiersza znak komentarza (\texttt{\%}). - %Wymienione w~przykładzie mapy dotyczą dołączania wersji obwiedniowej fontów - %CM produkcji Blue Sky Research (bsr.map) i~dodatkowych fontów logo, wasy, - %stmaryrd, wykonanych przez Taco Hoekwatera (hoekwater.map). -\item[papier] -- domyślnie Dvips tworzy dokumenty dla formatu A4. - Zmiana formatu (np. na US Letter) wymaga przeniesienia jego definicji - na początek bloku deklaracji formatów (blok ten rozpoczynają wiersze - ze znakiem \texttt{@}). Na początek bloku trzeba więc przenieść wiersze: -\begin{verbatim} -@ letterSize 8.5in 11in -@ letter 8.5in 11in -@+ %%BeginPaperSize: Letter -@+ letter -@+ %%EndPaperSize -\end{verbatim} -\end{description} - -\textbf{Uwaga:} obecna dystrybucja \TL{} posiada ułatwioną -procedurę automatycznej aktualizacji map fontowych dla Dvips -i~Pdftex, wykonywaną przez program \cmdname{updmap}. -Po dodaniu pakietów z~fontami należy zmodyfikować plik \verb+updmap.cfg+ -w~katalogu \path|$VARTEXMF/web2c|, a~następnie uruchomić program -\verb+updmap+. Obie czynności wykonuje odpowiednie menu programu -\guiseq{tlpmgui}. - -\subsubsection{PdfTeX} -Konfiguracja programu pdf(la)tex wymaga modyfikacji pliku\\ -\verb+C:\TeXlive2007\texmf-var\generic\config\pdftexconfig.tex+\\ - %W pliku tym możemy deklarować dodatkowe mapy fontowe wczytywane przez - %program, choć obecnie tworzone są one automatycznie - %przez program \cmdname{updmap} (patrz ,,Uwaga'' zamieszczona powyżej). - %Stosowana jest tu nieco - %inna notacja niż w~\verb+config.ps+: - %\begin{verbatim} - %map pdftex.map - %map +lw35.map - %%map +rawfonts.map - %\end{verbatim} - Można tu ustawić parametry pracy programu \texttt{pdftex}: -rozmiar papieru, stopień kompresji itp. Na przykład rozmiar strony dla -formatu letter ustawia się następująco: -\begin{alltt} -\bs{}pdfpagewidth=8.5 true in -\bs{}pdfpageheight=11 true in -\end{alltt} - -\subsubsection{Xe\TeX} -Xe\TeX{} dla Windows jest kompilowany wraz z fontconfig 2.4.2. -Plikiem konfiguracyjnym fontconfig jest \verb+fonts.conf+, -zaś szczegóły jego modyfikacji znajdziemy w~samym pliku, w~katalogu -wskazanym przez polecenie \texttt{kpsewhich --var-value=FONTCONFIG\_PATH}. - -\subsubsection{GSView} -Począwszy od wersji zgodnej z~Ghostscript 6.50, GSView jest niestety -programem \textit{shareware}, wobec tego nie mógł znaleźć się na \CD. - -Parametry pracy programu są ustawiane m.in. w~menu \verb+Media+. -W~podmenu \texttt{Display Settings} można poprawić (kosztem szybkości pracy) -sposób wyświetlania: parametry \texttt{Text Alpha} -i~\texttt{Graphics Alpha} należy ustawić na 4~bity. -W~menu \verb+Media+ można też określić rozmiar papieru i~jego orientację. - -Uwagi dotyczące drukowania zawarto poniżej, w~podrozdziale~\ref{printing}. - -% \subsubsection{WinDvi} -% \label{sec:windvi} -% Program \file{tlpmgui.exe} ustawia skojarzenie plików \verb+.dvi+ -% z~uruchamianiem programu \file{Windvi}, ale nie tworzy dla tego programu -% ikony na pulpicie. W~miarę potrzeby należy zatem wykonać to samodzielnie bądź -% uruchamiać program z~linii poleceń lub menu edytora (po jego odpowiednim -% skonfigurowaniu). -% -% W~menu \texttt{View} -% \verb+->+\texttt{Options} można ustawić niektóre parametry pracy Windvi, -% np. możliwość uruchamiania programów zewnętrznych (\texttt{Allow shell}), -% automatyczne odświeżanie zmienionego pliku .dvi (\texttt{Autoscan}), -% tryb pracy \MF{}-a i~rozdzielczość generowanych fontów (\texttt{MF mode} -% i~\texttt{Pixels per inch}), współpracę z~Ghostscriptem (\texttt{Postscript}) -% itp. Po zakończeniu pracy programu parametry zapisywane są -% w~pliku \verb+$HOME/windvi.cnf+ (lub \verb+Moje dokumenty/windvi.cnf+). -% Położenie tego pliku można ustalić po uruchomieniu z~wiersza poleceń: -% \begin{verbatim} -% c:\>kpsewhich --expand-var $HOME/windvi.cnf -% \end{verbatim} -% W~wypadku błędnego ustawienia parametrów pracy Windvi plik konfiguracyjny -% wystarczy skasować. - -\subsection{Testowanie} - -Ogólne wskazówki dotyczące weryfikacji instalacji zawarto -w~części~\ref{sec:test-install}, na str.~\pageref{sec:test-install}. -Tutaj omówimy jedynie kwestie specyficzne dla Windows. - -Dla szybkiej kontroli poprawności instalacji należy uruchomić -edytor i~otworzyć plik \verb+sample2e.tex+ -(znajduje się on w~katalogu \path|C:\TeXLive2007\texmf\tex\latex\base\|). -Na belce z~narzędziami wybrać z~menu \guiseq{Command\arw LaTeX} (XEmacs) -lub wcisnąć ikonę uruchamiania programu \verb+latex+ (WinShell). -Następnie wybrać z~menu \guiseq{Command\arw View DVI} (XEmacs), lub -wcisnąć ikonę podglądu DVI (WinShell). Pierwsze uruchomienie \verb+dviout+ -zazwyczaj automatycznie generuje wymagane fonty ekranowe. Po kilku sesjach -komunikaty dotyczące generowania fontów staną się rzadsze. - %Warto ponadto wypróbować uruchamianie Dvips i~GSView z~programu - %\cmdname{WinShell}. - -\textbf{Wskazówka:} jeśli program \verb+latex+ nie może znaleźć pliku -do przetwarzania, naciśnięcie \textbf{Ctrl-Z} spowoduje natychmiastowe -zakończenie jego pracy. - -\subsection{Drukowanie}\label{printing} - Drukowanie bezpośrednio z~programu \verb+dviout+ odbywa się z~wykorzystaniem -uniwersalnego sterownika druku systemu Windows. Z~definicji powinien być on -zgodny z~większością drukarek, jednakże ma on tendencję do tworzenia -olbrzymich plików kolejek (spool) i~niektóre (starsze) wersje Windows po -prostu tego nie akceptują. Zaletą sterownika jest jedynie możliwość obsługi -grafik BMP i~WFM. Stosując metodę druku via sterownik Windows należy -prawidłowo ustawić parametry rozdzielczości, w~przeciwnym wypadku otrzymany -wydruk może być przeskalowany (np. drukując w~rozdzielczości 600dpi na -drukarce 300dpi otrzymamy niespodziewanie 1/4 zamierzonego rozmiaru wydruku). - -Drukowanie znacznie szybsze i~bardziej niezawodne zapewni konwersja pliku -\verb+.dvi+ do \verb+.ps+ programem Dvips i~wykorzystanie GSView. Z~menu -\verb+Plik+ należy wybrać \verb+Drukuj+, co wyświetli okno dialogowe -z~szeregiem opcji. Gdy mamy drukarkę PostScriptową, należy wybrać -\texttt{PostScript printer}. Drukowanie na drukarkach bez interpretera -PostScript wymaga zaznaczenia opcji \texttt{Ghostscript device} -(w~sekcji ,,Print Method'' okna) i~wybrania przyciskiem po prawej stronie -odpowiedniego urządzenia. +%Możemy zainstalować z~sieci także inne narzędzia, których zabrakło na +%\TL{} z~powodów licencyjnych. Przykładem jest tu \cmdname{GSView}, +%wygodny program wykorzystujący \cmdname{Ghostscript} do wyświetlania +%i~drukowania plików PS/PDF. Dostępny jest on m.in. +%na \url{http://www.cs.wisc.edu/~ghost/gsview/}, a~także na każdym serwerze +%\acro{CTAN}. + +\subsection{User Profile to inaczej Home (katalog domowy)} +\label{sec:winhome} + +Odpowiednikiem uniksowego katalogu domowego użytkownika (HOME) jest +w~Windows katalog określany zmienną \verb|%USERPROFILE%|. W~Windows +2000 i~XP jest to zazwyczaj katalog +\verb|C:\Documents and Settings\<nazwa_użytkownika>|, zaś w~Widows Vista +\verb|C:\Users\<nazwa_użytkownika>|. W~pliku konfiguracyjnym +\filename{texmf.cnf} i~bibliotekach \KPS{} znak \verb|~| +jest prawidłowo rozwijany do odpowiedniej zmiennej zarówno w~Windows, jak +i~w~Unix. + +\subsection{Rejestr Windows} +\label{sec:registry} + +W systemie Windows prawie wszystkie dane konfiguracyjne przechowywane są +w~tzw. rejestrze. Zawiera on hierachicznie zorganizowane klucze, w~ramach +kilku kluczy głównych. Najbardziej istotne dla programów instalacyjnych +są klucze \path{HKEY_CURRENT_USER} oraz \path{HKEY_LOCAL_MACHINE} +(w~skrócie \path{HKCU} i \path{HKLM}). Część \path{HKCU} dotyczy katalogów +domowych użytkowników (patrz~\ref{sec:winhome}), zaś \path{HKLM} podkatalogów +systemowych (w~katalogu Windows). + +Informacje o~ustawieniach systemu mogą być czasem uzyskane ze zmiennych +środowiska, ale inne informacje, np. położenie tzw. skrótów, wymaga odwołania +się do rejestru. Także zapis zmiennych środowiska na stałe wymaga dostępu do +rejestru. + +\subsection{Uprawnienia w Windows} +\label{sec:winpermissions} + +%%! UWAGA SW: cała ta część jest mocno niejasna w oryginale. Tłumaczyłem +%%! ją mając na uwadze ogólny sens, w niektórych miejscach doprecyzowując +%%! sformułowania. Ale i tak jest, wg mnie, do bani :-) + +W nowszych wersjach Windows istnieje wyraźne rozróżnienie pomiędzy +zwykłymi użytkownikami i~administratorami, przy czym tylko ci ostatni mają +pełną swobodę dostępu do całości systemu. + %%! ??? + %In practice, though, you could better describe + %these classes of users as unprivileged users and normal users: being an + %administrator is the rule, not the exception. + Dokonaliśmy wielu starań, aby umożliwić instalację \TL{} także bez + posiadania uprawnień administratora. + +Jeśli osoba instalująca jest administratorem, skróty są tworzone dla +wszystkich użytkowników, także zmienne środowiska są ustawiane dla całego +systemu. W~przeciwnym wypadku skróty i~menu są tworzone tylko dla konkretnego +użytkownika zaś tworzone zmienne środowiska także dotyczą zwykłych +użytkowników. Jako admistrator możemy zainstalować \TL{} tylko dla +użytkowników; należy wtedy dla uruchomienia \prog{install-tl} użyć parametru +\optname{-non-admin}. + +Bez względu na status użytkownika domyślnym katalogiem głównym instalacji +jest katalog w~ramach \verb|%PROGRAMFILES%|. Program instalacyjny zawsze +sprawdza czy ten katalog jest dostępny do zapisu dla aktualnego użytkownika. + +Problem może pojawić się wtedy, gdy użytkownik instalujący \TL{} nie jest +administratorem, a~programy \TeX-owe już są w~ścieżce przeszukiwania. +Wynikowa ścieżka zawiera wtedy ścieżkę systemową, do której dodano ścieżkę +do programów użytkownika, w konsekwencji nowo instalowane programy nie będą +znajdywane. Jako obejście tego problemu program instalacyjny tworzy +skrót do okna z~wierszem poleceń, w~którym ścieżka do nowych programów \TL{} +ma priorytet. W~ten sposób, po uruchomieniu tego skrótu, będzie można +korzystać z~\TL. + +%%% Zostawione z poprzedniej wersji tylko w polskiej wersji! -%%% \subsection{\cmdname{WinShell}}\label{sec:winshell} -Jeśli nie decydujemy się na rozbudowany (ale i~bardzo silny) edytor -XEmacs, możemy samodzielnie zainstalować prosty i~łatwy w~obsłudze +Jeśli nie decydujemy się na instalaję rozbudowanego (ale i~bardzo silnego) +edytora Emacs, możemy samodzielnie zainstalować prosty i~łatwy w~obsłudze edytor WinShell. Znajdziemy go na płytkach w~katalogu \dirname{support/winshell}. Wystarczy dwukrotnie kliknąć klawiszem myszy na znajdującym się tam pliku \texttt{.exe}. @@ -1924,34 +1695,20 @@ Aby skonfigurować uruchamianie programów otwieramy menu \texttt{Options} \verb+->+ \texttt{Program Calls}. \begin{itemize}\itemsep 0pt -\item W zakładce DVIWin, w~polu ,,exe-file'', powinno być już wpisane -\texttt{dviout.exe}. -\item W zakładce Ghostview należy sprawdzić, czy prawidłowo podano -ścieżkę dla gsview32.exe:\\ -\hspace*{1em} \verb+C:\ghostgum\gsview\gsview32.exe+ (dla wersji 3.6 -i~nowszych). +\item W zakładce DVIWin, w~polu ,,exe-file'', należy wpisać +\texttt{dviout.exe} (o~ile go wcześniej zaistalowaliśmy). +\item W zakładce Ghostview należy wpisać psv.bat. + %sprawdzić, czy prawidłowo podano + %ścieżkę dla gsview32.exe:\\ + %\hspace*{1em} \verb+C:\ghostgum\gsview\gsview32.exe+ (dla wersji 3.6 + %i~nowszych). \end{itemize} -Wciskając przycisk \texttt{OK} zatwierdzamy zmiany. +Po wciśnięciu przycisku \texttt{OK} zatwierdzamy zmiany. Instalacja programu ustawia w~Windows skojarzenie plików \texttt{.tex} z~uruchamianiem \cmdname{WinShell}. Dopóki nie zamierzamy korzystać z~innego edytora (jak WinEdt lub Emacs) jest to poprawne. -%\cmdname{WinShell} niestety nie posiada wbudowanej korekty pisowni, -%niemniej jednak po zainstalowaniu zestawu \path|extrabin| -%mamy do dyspozycji program \cmdname{Ispell} (program korekty pisowni, znany -%z~systemów Unix). Ponieważ znajduje się on w~ścieżce przypisanej -%zmiennej PATH, \verb+ispell.exe+ może być uruchamiany z~linii -%poleceń (okno DOS). Informację -%o~Ispell można znaleźć~w: \OnCD{texmf/doc/html/manpages/ispell.html} -%Na \CD{} dostępny jest słownik Ispell dla języka polskiego; -%typowe uruchamianie programu: \verb+ispell -t -b -d polish-win plik.tex+ -%powoduje wczytanie słownika w~kodowaniu Windows cp1250. -% -%Ispell można uruchamiać z poziomu \cmdname{WinShell}; -%w~podrozdziale~\ref{winshell:ispell} opisano jak dodać uruchamianie polecenia -%do menu edytora. - \cmdname{WinShell} posiada pomoc, dostępną po naciśnięciu symbolu $\textbf{\underbar{?}}$ na belce z~narzędziami. @@ -1976,7 +1733,10 @@ zamknąć, wykorzystując całą szerokość ekranu dla edytowanego pliku. \label{winshell:print} Ikona Dvips belki narzędziowej uruchamia program, który wynik pracy zapisuje zwykle w~pliku \verb+.ps+. Oglądanie i/lub drukowanie takiego pliku -wymaga uruchomienia GSView. \cmdname{WinShell} pozwala zdefiniować +wymaga uruchomienia + %GSView. + PS\_View. + \cmdname{WinShell} pozwala zdefiniować wygodne wywołanie polecenia dvips, które wynik przetwarzania wyśle od razu do drukarki posiadającej interpreter PostScript. Przykładowo, dla drukarki o~nazwie \texttt{vclw}, postępowanie będzie następujące: @@ -2014,223 +1774,6 @@ only), ,,Tylko tekst'' lub ,,Tekst i~obrazek''; najprościej wybrać Uruchamianie polecenia zostało zdefiniowane. Aby drukować bezpośrednio na drukarce wystarczy teraz nacisnąć guzik z~napisem ,,Drukuj''. -%\subsubsection{Dodanie Ispell do \cmdname{WinShell}} -%\label{winshell:ispell} -%\begin{enumerate} -%\item Deklaracja polecenia Ispell: -%\begin{itemize} -%\item otworzyć \cmdname{WinShell}, wybrać menu \texttt{Opcje} \verb+->+ -% \texttt{Wywołanie programów} \verb+->+ \texttt{User defined}. -%\item wybrać \texttt{Tool 1} (lub \texttt{Tool 2}, jeśli \texttt{Tool 1} -% zostało już użyte) i~wypełnić pola po lewej stronie okna:\vspace{-3pt} -%\begin{quote} -% Name: \verb+Ispell+\\ -% exe file: \verb+ispell+\\ -% cmd-line: \verb+ -t -d polish-win %c.tex+\\ -% skasować zaznaczenie okienek ,,najpierw LaTeX'' i ,,najpierw DVIPS'' -%\end{quote}%\vspace{-12pt} -%\item nacisnąć \texttt{OK}. -%\end{itemize} -%\item Dodanie polecenia ,,Ispell'' do belki narzędziowej -% -- analogicznie jak powyżej, dla polecenia ,,Drukuj''. -%\end{enumerate} -% Gdy mamy otwarty dokument \TeX-owy, naciśnięcie guzika ,,Ispell'' uruchomi -%w~odrębnym oknie program Ispell, który rozpocznie sprawdzanie pisowni. -%Niepoprawne (lub nieznane) słowo zostanie wyświetlone, poniżej pojawi -%się kontekst i~czasem sugestie jak naprawić błąd (naciśnięcie klawisza -%cyfry umieszczonej obok sugerowanego słowa dokona zamiany -%błędnie napisanego słowa). Inne reakcje na błąd są wyświetlane -%u~dołu ekranu, np. naciśnięcie klawisza spacji ignoruje dany błąd i~wznawia -%wyszukiwanie. Więcej informacji na temat Ispell można znaleźć -%w:~\verb+C:\Program Files\TeXlive\texmf\doc\html\manpages\ispell.html+. -% -%Uwaga: poprawione słowa nie ukażą się w~oknie \cmdname{WinShell} -%dopóki plik nie zostanie zamknięty (przez naciśnięcie X w~prawym górnym -%rogu okna edytora) i~ponownie otwarty (z~menu Plik). - -\subsection{Wskazówki dla użytkowników Win32} - -\subsubsection{Różne wcielenia Win32} -To, co nazywamy Win32 nie jest właściwie systemem operacyjnym a~jedynie -zbiorem funkcji, z~których wiele (ok. 12000) można użyć do pisania -programów dla różnych systemów operacyjnych rodziny Windows. Spotykamy -różne wersje Windows: -\begin{itemize} -\item Win95 i Win98, które \emph{nie są prawdziwymi systemami -wielozadaniowymi i~wielowątkowymi}. Są to ostatnie (na szczęście) -metamorfozy systemu DOS, co można sprawdzić podczas startu systemu, -wymuszając ładowanie tylko wiersza poleceń: polecenie \texttt{ver} -zwróci wtedy np. napis ,,MS-DOS 7.0''. -\item NT, nowy system operacyjny, napisany od podstaw, wyposażony - w~prawdziwe możliwości wielozadaniowości i~inne zaawansowane cechy. -\item Windows 2000, oparty na NT, z~wszystkimi cechami zewnętrznymi - Win98. -\item Windows XP, występujący w~odmianach Home i~Pro, -obecnie najpopularniejszy system operacyjny Windows -% jest ostatnim krokiem połączenia cech obu linii produktów Win9x i~NT. % ? -\item Windows 2003 Server, odmiana zaprojektowana do zastosowań serwerowych. -\item Windows Vista, najnowszy system operacyjny rodziny Windows. -\end{itemize} - -Win9x mają możliwość uruchamiania jednocześnie programów 16- -i~32-bi\-to\-wych, ale ponieważ sam system nie jest w~całości -napisany dla trybu 32-bi\-to\-wego i~nie posiada ochrony pamięci, programy -16-bi\-to\-we mogą nadpisywać część pamięci wykorzystywanej przez system! -Niektóre elementy systemu, jak GDI (\emph{Graphical Device Interface}) -zarządzają w~sposób ograniczony zasobami (bitmapy, fonty itp.) -gdy wszystkie uruchomione programy jednocześnie korzystają z~tych zasobów. -Wszystkie nagłówki bitmap dostępnych w~tym samym czasie nie mogą przekroczyć -granicy 64KB. Jest to przyczyna spotykanego często gwałtownego spadku -wydajności systemu i~jego zawieszania. - -NT i nowsze nie posiadają takich ograniczeń. Są to systemy w~pełni -wielozadaniowe i~z~ochroną pamięci. Wydają się bardziej stabilne, -ponieważ lepiej zarządzają pamięcią, posiadają lepszy system plików itp. - -Uwaga: nie testowaliśmy dystrybucji TeX Live na wszystkich odmianach -systemu Windows. - -\subsubsection{Wiersz poleceń} - Wielu użytkowników może zadać pytanie: ,,po co używać wiersza poleceń -w~systemie Windows?''. Dobre pytanie! Problem ma naturę bardziej ogólną. -Otóż nie wszystkie zadania daje się wykonać jedynie przy użyciu interfejsu -graficznego (\acro{GUI}). Wiersz poleceń dostarcza wielu możliwości rasowego -programowania (zakładając posiadanie przyzwoitego interpretera poleceń). - -\TeX{} jest programem działającym \emph{wsadowo} (\emph{batch}), -a~nie interakcyjnie: wylicza najlepszy wygląd każdej strony, rozwiązuje -odesłania itp. Taki charakter pracy możliwy jest jedynie podczas -globalnego przetwarzania dokumentu, nie ma tu możliwości interakcji. -Oznacza to, że program \TeX{} powinien być używany z~linii poleceń. -W~istocie nie jest to takie złe. Programy działające wsadowo, przeznaczone -do skomplikowanych zadań, są zwykle lepiej opracowane i~pozbawione błędów, -ponieważ nie są związane z~graficznym interfejsem. Do uruchamiania -takich programów można zawsze opracować interfejs graficzny, przekazujący -zadanie do wykonania i~inne parametry. Przykładem takiego właśnie działania -może być graficzny edytor (patrz punkt \ref{sec:winshell}). - -Niemniej jednak częste są sytuacje, gdy przydaje się możliwość uruchamiania -programów bezpośrednio z~linii poleceń, np. diagnostyka błędów w~wypadku -wystąpienia problemów (patrz punkt \ref{sec:Debugging} na -str.~\pageref{sec:Debugging}). - -\begin{description} -\item[Win9x] linia poleceń dostępna jest z~menu \texttt{Start->Programy->Tryb - MS~DOS} albo \texttt{Start->Uruchom}: należy tu wpisać \texttt{command.com}. -\item[NT, 2K, XP] dostęp do linii poleceń z menu \texttt{Start->Akcesoria-> - Command Prompt}; można także w~menu \texttt{Start->Uruchom} - wpisać \texttt{cmd.exe} co uruchomi interpreter poleceń (wyjaśnia to, - dlaczego trudno w~systemach opartych na NT mówić o~,,oknie DOS''). -\end{description} - -\subsubsection{Separatory ścieżek} -API Win32 obsługuje zarówno \texttt{/}, jak i~\path|\| jako separatory ścieżek. -Niestety interpretery poleceń obsługują wyłącznie \path|\|, a~więc -odwołując się do programu w~linii poleceń możemy użyć tylko tego znaku -(wynika to z~potrzeby kompatybilności: znak \texttt{/} używany jest często -jako prefiks dodatkowego parametru). -Gdy nazwa ścieżki jest używana przez program, oba separatory mogą być -stosowane wymiennie, a~nawet mieszane. - -Nie należy się dziwić gdy często spotkamy ścieżki pisane w~konwencji Unix -(a~więc separowane znakiem \texttt{/}). Windows-\TL{} jest implementacją -\Webc{} i~z~zasady musi być zgodny między różnymi platformami. Dlatego -właśnie np. wszystkie pliki konfiguracyjne stosują konwencję uniksową -notacji ścieżek. - -\subsubsection{System plików} -\label{sec:clusters} - Najgorszą cechą Win9x z~punktu widzenia systemu \TeX{} jest prawdopodobnie -system plików zwany FAT. \TeX{} używa bardzo wielu niewielkich plików -(1--3KB) i~na współczesnych dyskach o~wielkiej pojemności każdy taki plik -potrafi faktycznie zająć nawet 32KB. Wykorzystanie dysku jest więc bardzo nieefektywne -zaś instalacja wszystkich plików z~\CD{} może w~rzeczywistości zająć wielokrotnie więcej miejsca niż łączna objętość plików. - -Bardziej nowoczesne systemy plików, takie jak NTFS, dostępne są w~nowszych -wersjach Windows są pozbawione ujemnych cech FAT: minimalna jednostka -alokacji dla pliku to zwykle 4KB, choć w~systemie NTFS można ją zredukować -nawet do 512 bajtów. - -\subsubsection{Jak dodać katalog do zmiennej PATH} -Większość programów korzysta ze zmiennych, którym można przypisać pewne -wartości. Zestaw takich przypisań (par: zmienna\dywiz wartość) -nazywamy środowiskiem. Każdy uruchomiony program korzysta z~kopii -środowiska i~może w~ramach tej kopii zmieniać przypisania niektórych -zmiennych (nie są one dostępne dla innych uruchomionych równolegle -programów). Instalator systemu \TeX\ dla Win32 konieczną konfigurację -środowiska przeprowadza automatycznie. Warto jednak wiedzieć, -jak konfigurować środowisko ręcznie. - -\texttt{PATH} jest specjalną zmienną wykorzystywaną do lokalizowania programów -w~systemie. Poszczególne wersje Windows mają różne procedury deklarowania -\texttt{PATH}: - -\begin{description} -\item[Windows 95/98] zmienna PATH jest tu deklarowana w~pliku - \texttt{autoexec.bat} (znajduje się on w~głównym katalogu dysku startowego). - Po wczytaniu pliku do edytora (np. Notatnik, WinShell) należy - odszukać wiersz z~napisem \texttt{PATH=} i~z~szeregiem ścieżek - oddzielanych separatorem \texttt{;} (średnik). Można dopisać kolejne ścieżki - wskazujące położenie programów, np. -\begin{verbatim} -PATH=c:\windows;c:\windows\system;c:\TeXLive2007\bin\win32 -\end{verbatim} - Proszę zauważyć, że ścieżki zawierające spację wymagają ujęcia w~parę - znaków \verb+"+. Poczynione zmiany będą aktywne po restarcie systemu. -\item[Windows ME] należy uruchomić specjalny program - \path|c:\windows\system\msconfig.exe| i~wybrać opcję ,,Środowisko'' - (\emph{Environment}). Po dodaniu lub modyfikacji zmiennej należy ponownie - uruchomić system. -\item[Windows NT/2K/XP] należy wybrać menu \texttt{Start -> Settings -> - Panel Sterowania}, w~opcji ,,System'' otworzyć zakładkę ,,Zaawansowane'', - następnie przycisk ,,Zmienne środowiskowe'' - i~tu modyfikować deklaracje zmiennych, zgodnie z~posiadanymi uprawnieniami. - Istniejącą zmienną \texttt{PATH} modyfikujemy - naciskając lewy klawisz myszy na napisie \texttt{PATH}. Pole ,,Wartość'' - (Value) pokaże listę katalogów rozdzielonych separatorem \texttt{;}. - Należy tu dopisać katalog zawierający programy środowiska \TeX-owego - (np. \path|c:\TeXLive2007\bin\win32|). - Gdy brak jest zmiennej \texttt{PATH}, należy kliknąć pole ,,Zmienna'', - wpisać \texttt{PATH}, przenieść kursor do pola ,,Wartość'' i~wpisać tu - odpowiedni katalog. - - Uwaga: przed zamknięciem okna dialogowego należy zatwierdzić zmiany - przyciskiem ,,Zastosuj''. -\end{description} -Dokonane zmiany można sprawdzić otwierając konsolę i~uruchamiając polecenie: -\begin{verbatim} -set NAZWA_ZMIENNEJ -\end{verbatim} -co wyświetli aktualnie aktywne wartości dla danej zmiennej. - -\subsubsection{,,Maszyny'' \TeX{}} -Z dokumentacji \Webc{} można wyczytać, że różnie nazwane programy -wykorzystują tę samą ,,maszynę'', np. \texttt{tex.exe} i~\texttt{latex.exe} -są dokładnymi kopiami tego samego programu, ale uruchamiają się -z~różnymi plikami formatu, zgodnie z~nazwą podaną w~wywołaniu. - -W~systemach Unix cecha ta jest zaimplementowana poprzez tzw. dowiązanie -symboliczne, co pozwala na zaoszczędzenie wiele miejsca na dysku: ten sam -program uruchamiany jest z~wieloma formatami. - -Interfejs aplikacji systemów Windows (API) nie zna pojęcia dowiązania. -Aby niepotrzebnie nie zajmować miejsca na dysku, zastosowano tu pomysł -umieszczenia głównej ,,maszyny'' \TeX{} w~pliku dynamicznie wiązanej -biblioteki (DLL). Z~kolei programy uruchomieniowe (.exe) umieszczono -w~niewielkich plikach, przekazujących przez nazwę parametr wywołania -(nazwę formatu). Na dysku znajdziemy zatem: -\begin{alltt} -2006-11-23 07:06 2 560 latex.exe -2007-01-06 23:54 1 073 664 pdftex.dll -2006-01-28 08:05 2 560 pdftex.exe -\end{alltt} -Każdy z~tych \emph{identycznych} programów (\texttt{latex.exe}, -\texttt{mex.exe} itp.) korzysta ze wspólnego pliku \texttt{pdftex.dll}. -Podobne rozwiązanie zastosowano dla grupy programów \texttt{mktex*.exe}, -z~których każdy jest powiązany z~biblioteką \texttt{mktex.dll}. -W~dystrybucji dostępny jest program \texttt{irun.exe}, który tworzy -w~systemach Win32 odpowiedniki dowiązań systemu Unix. - \subsection{W razie problemów} \label{troubleshooting} @@ -2265,8 +1808,6 @@ W ten sposób można skierować zarówno stderr jak i stdout do tego samego pliku. \begin{tabular}{ll} \path|kpsewhich -expand-path $SELFAUTOPARENT| & \path|c:/TeX| \\ \path|kpsewhich -expand-path $TEXMF| & \path|c:/TeX/texmf....| \\ - \path|kpsewhich -expand-path $TEXMFCNF| & - \path|.;c:/TeX/texmf-var/web2c;| \\ \path|kpsewhich -expand-var $TEXINPUTS| & \path|.;c:/TeX/texmf/tex//| \end{tabular} } @@ -2282,33 +1823,15 @@ które określono w texmf.cnf. \end{tabular} } -Jeśli sprawdzenia nie wykazały odstępstw, \TeX{} i programy towarzyszące powinny -działać. Jeśli tak nie jest, należy poeksperymentować z opcją \path|-debug=n| -programu \path|kpsewhich| i zweryfikować wszystkie uzyskane wartości. Po -zidentyfikowaniu problemu warto go zgłosić. +Jeśli sprawdzenia nie wykazały odstępstw, \TeX{} i programy towarzyszące +powinny działać. Jeśli tak nie jest, należy poeksperymentować z opcją +\path|-debug=n| programu \path|kpsewhich| i zweryfikować wszystkie uzyskane +wartości. Po zidentyfikowaniu problemu warto go zgłosić. \end{itemize} %Należy użyć programu \cmdname{kpsewhich}, który jest narzędziem %do diagnostyki wszelkich problemów związanych ze znajdowaniem plików -%(patrz część~\ref{sec:Debugging} na str.~\pageref{sec:Debugging}). - -\subsubsection{Co zrobić gdy instalacja nadal nie działa prawidłowo?} - -Należy odpowiedzieć sobie na szereg pytań: -\begin{enumerate} -\item czy program \file{tex.exe} jest w~ścieżce wymienionej w~zmiennej - \envname{PATH}? -\item czy zmienna \envname{TEXMFCNF} jest prawidłowo ustawiona - (standardowo \path|c:/TeXLive2007/texmf-var/web2c|)? -\item diagnostyka błędów omówiona została w~części~\ref{sec:Debugging}. -\item opis znanych problemów i~ewentualne rozwiązania oraz poprawki można - znaleźć pod adresem \url{http://www.tug.org/tex-live.html}. -\end{enumerate} - -Oprogramowanie zawarte na \TL{} jest bardzo złożone i~składa się -z~ponad 250 programów i~około 40000 plików różnego pochodzenia. Niesłychanie -trudno przewidzieć wszystkie możliwe przyczyny problemów, niemniej jednak -dołożymy wszelkich starań aby pomóc je rozwiązać. +%(patrz część~\ref{sec:debugging} na str.~\pageref{sec:debugging}). %-------------------------- % don't use \Webc so the \uppercase in the headline works. @@ -2389,6 +1912,7 @@ plik \file{ls-R}, zawierający pozycje określające nazwę i~względną ścieżkę dla wszystkich plików zawartych w~tym katalogu. \subsection{Przeszukiwanie ścieżek przez Kpathsea} +\label{sec:kpathsea} Opiszemy najpierw ogólny mechanizm przeszukiwania ścieżek przez bibliotekę \KPS{}. @@ -2477,7 +2001,7 @@ Oto kolejność, w~jakiej \KPS{} ich używa: \end{enumerate} \noindent Każdą z~tych wartości dla danej ścieżki przeszukiwania można zobaczyć, używając opcji diagnostyki błędów (patrz ,,Diagnostyka błędów'' na -stronie~\pageref{sec:Debugging}). +stronie~\pageref{sec:debugging}). \subsubsection{Pliki konfiguracyjne} @@ -2905,7 +2429,7 @@ zawieruszyła się zła wersja jakiegoś pliku; \cmdname{kpsewhich} pokaże tylko pierwszy napotkany plik. \subsubsection{Diagnostyka błędów} -\label{sec:Debugging} +\label{sec:debugging} Czasami niezbędne są informacje o~tym, jak program radzi sobie z~odniesieniami do plików. Aby dało się to wykonywać w~wygodny sposób, @@ -3096,6 +2620,7 @@ powyższe parametry stanowią praktyczny kompromis, pozwalając na pewną elastyczność. %%==== +%\begin{comment} %% nie wiem czemu rezygnować z tej części (SW) \section{Budowa systemu na nowej platformie Uniksowej}\label{sec:build} Jeżeli mamy do czynienia z~platformą, dla której nie są dostarczone binaria, trzeba będzie skompilować \TeX-a oraz towarzyszące mu programy. @@ -3164,7 +2689,7 @@ skryptu \cmdname{configure} należy użyć parametru \verb|--disable-multiplatform|. Więcej dostępnych parametrów (np. pomijanie pakietów opcjonalnych, takich -jak \OMEGA\ czy \eTeX) można zobaczyć uruchamiając +jak \OMEGA) można zobaczyć uruchamiając \texttt{./configure -{}-help}. \subsection{Uruchamianie \textsf{make}} @@ -3185,10 +2710,10 @@ Zanim stwierdzimy, że wszystko jest w~porządku, warto sprawdzić czy w~pliku \acro{GNU} \cmdname{make} zawsze używa sekwencji \samp{***}) i~czy utworzone zostały wszystkie binaria: \begin{alltt} -> \Ucom{cd /usr/local/TeX/bin/i586-pc-linux-gnu} +> \Ucom{cd \var{TEXDIR}/bin/\var{archname}} > \Ucom{ls | wc} \end{alltt} -Oczekiwanym rezultatem jest 242. Polecenie \texttt{make world} jest +Oczekiwanym rezultatem jest ponad 200. Polecenie \texttt{make world} jest równoważne z~\texttt{make all install strip}. Jeśli do uruchamiania \texttt{make install} potrzebne są specjalne uprawnienia, można uruchomić dwie oddzielne sesje \cmdname{make}: @@ -3205,68 +2730,79 @@ właśnie zainstalowane binaria (np.\ z~\envname{MANPATH} i~\envname{INFOPATH} i~dołączyć do nich odpowiednie nazwy podkatalogów, tj.\ \dirname{$TEXDIR/man} oraz \dirname{$TEXDIR/info}. +Patrz część~\ref{sec:postinstall} (str.~\pageref{sec:postinstall}). -Program \cmdname{texconfig} pozwala na ustawienie domyślnych wzorców -przenoszenia wyrazów, rozmiaru papieru, poleceń do druku, trybu \MF{}-a itd. -Polecenia tego używać można interaktywnie. Aby zobaczyć jakie funkcje program -udostępnia, wystarczy napisać: -\begin{alltt} -> \Ucom{texconfig help} -\end{alltt} - -Przykładowo, jeżeli nie używamy formatu A4, możemy ustawić jako format -domyślny ,,lettersize'' pisząc: -\begin{alltt} -> \Ucom{texconfig dvips paper letter} -> \Ucom{texconfig xdvi paper us} -\end{alltt} +Jeśli zechcesz udostępnić skompilowane przez siebie programy, skontaktuj +się z~nami; chętnie umieścimy je na stronie \TL. +%\end{comment} %-------------------------- -\section{Podziękowania}\label{sec:acknowl} +\section{Podziękowania} %\label{sec:acknowl} \TL{} jest wspólnym dziełem praktycznie wszystkich grup \TeX-owych. -Niniejsza edycja \TL{} została opracowana pod kierownictwem Sebastiana -Rahtza i~Karla Berry, przy głównym współudziale: +Niniejsza edycja \TL{} została opracowana pod kierownictwem Karla Berry'ego, +przy głównym współudziale: \begin{itemize*} \item angielskiej, niemieckiej, holenderskiej i polskiej grup \TeX-owych (odpowiednio \acro{TUG}, \acro{DANTE} e.V., \acro{NTG}, i~\acro{GUST}), które wspólnie zapewniają potrzebną infrastrukturę techniczną i~organizacyjną. Dołącz do swojej grupy \TeX-owej!; -\item zespołu \acro{CTAN}, który dystrybuuje obrazy \TL{} i~udostępnia wspólną - infrastrukturę służącą aktualizacji pakietów, od której zależy \TL{}; -\item Petera Breitenlohnera i zespołu \eTeX-owego, którzy stworzyli stabilną - podstawę przyszłych wersji \TeX-a; +\item zespołu \acro{CTAN} (w~szczególności Robina Fairbairnsa, Jima + Hef{}ferona i~Rainera Sch\"opfa), który dystrybuuje obrazy \TL{} i~udostępnia + wspólną infrastrukturę służącą aktualizacji pakietów, od której zależy \TL{}; +\item Petera Breitenlohnera i zespołu \eTeX, którzy stworzyli stabilną + podstawę przyszłych wersji \TeX-a (Peter dodatkowo służy nieustanną pomocą + w~wykorzystaniu narzędzi autotools w~\TL); \item Thomasa Essera, autora wspaniałego \teTeX-a, bez którego \TL{} z~całą pewnością by nie powstał, i~którego stała - pomoc umożliwiła uczynienie z~tej dystrybucji coraz lepszego produktu; + pomoc umożliwiła rozwój tej dystrybucji; \item Michaela Goossensa, który był współautorem pierwotnej dokumentacji; \item Eitana Gurari, autora programu \TeX4ht{} (wykorzystanego do tworzenia niniejszej dokumentacji w~wersji \HTML), który niezmordowanie - pracował nad jego ulepszaniem i~błyskawicznie wykonywał poprawki; + pracował nad jego ulepszaniem i~błyskawicznie dostarczał poprawki; \item Hansa Hagena, który dostosowywał \ConTeXt\ do potrzeb \TL; \item \Thanh{}a, Martina Schr\"odera i~pdf\TeX\ teamu za ciągłe ulepszanie możliwości \TeX-a; -\item Taco Hoekwatera, za wznowienie rozwoju nad MetaPost i~samego \TeX-a; +\item Hartmuta Henkela, za znaczny udział w~rozwoju pdf\TeX, Lua\TeX{} + i~innych programów; +\item Taco Hoekwatera, za wznowienie rozwoju MetaPosta i~prace nad + (Lua)\TeX-em, także za pomoc w~integracji \ConTeXt\ w~\TL; \item Pawła Jackowskiego, który wykonał instalator dla Windows \cmdname{tlpm} - i~Tomka Łuczaka, twórcy \cmdname{tlpmgui}; -\item Akira Kakuto, za zaktualizowanie binarów dla Windows, które są częścią - jego dystrybucji \acro{W32TEX} - (\url{http://www.fsci.fuk.kindai.ac.jp/kakuto/win32-ptex/}); -\item Jonathana Kew i jego pracodawcy \acro{SIL}, za poważną nową ścieżkę - rozwojową, którą jest Xe\TeX{} oraz za wysiłek włożony w~zintegrowanie - programu z~\TL; -\item Reinharda Kotuchy za pomoc w~olbrzymim wysiłku aktualizowania pakietów - w~\TL, jak również za skrypt \texttt{getnonfreefonts} i~za wiele innych - prac; + i~Tomka Łuczaka, twórcy \cmdname{tlpmgui}, programy te były wykorzystane + w~poprzednich edycjach; +\item Akira Kakuto, za dostarczenie programów dla Windows, które pochodzą + z~dystrybucji \acro{W32TEX} + (\url{http://www.fsci.fuk.kindai.ac.jp/kakuto/win32-ptex/}), ale są + stale dostosowywane i~aktualizowane dla potrzeb \TL; +\item Jonathana Kew i firmy \acro{SIL}, za poważną nową ścieżkę + rozwojową, którą jest Xe\TeX{}, oraz za wysiłek włożony w~zintegrowanie + programu z~\TL, jak również za początkowe prace nad instalatorem dla + Mac\TeX; +\item Dicka Kocha, za pielęgnację Mac\TeX-a (\url{http://tug.org/mactex}) + w~ścisłym połączeniu z~\TL i~bardzo sympatyczną współpracę; +\item Reinharda Kotuchy, za ważny udział w~stworzeniu nowej infrastruktury + i~programu instalacyjnego dla \TL{} 2008, upór w~ujednoliceniu działania + \TL{} w~Windows i~Unix, jak również za skrypt + \texttt{getnonfreefonts} i~za wiele innych prac; +\item Siep Kroonenberg, także za udział w~stworzeniu nowej infrastruktury + i~programu instalacyjnego dla \TL{} 2008 (szczególnie dla Windows) + oraz za ogrom pracy włożonej w~aktualizację tej dokumentacji; \item Petra Ol\shac{}\aac{}ka, który koordynował i~sprawdzał przygotowanie czeskich i~słowackich pakietów; \item Toshio Oshimy, za jego przeglądarkę \cmdname{dviout} dla Windows; +\item Manuela P\'egouri\'e-Gonnarda, za pomoc w~aktualizacji pakietów + i~prace nad \cmdname{tldoc}. \item Fabrice'a Popineau, który pierwszy stworzył wersje oprogramowania dla Windows; -\item Norberta Preininga za pomoc w budowaniu infrastruktury \TL{} - i~aktualizacji pakietów, koordynowanie, wraz z~Frankiem K\"usterem, - debianowej wersji \TL{}, oraz za wiele sugestii ulepszeń; +\item Norberta Preininga, głównego architekta infrastruktury i~programu + instalacyjnego \TL{} 2008, także za aktualizację pakietów, koordynowanie + (wraz z~Frankiem K\"usterem) debianowej wersji \TL{}, oraz za wiele + sugestii ulepszeń; +\item Sebastiana Rahtza, za stworzenie \TL{} i~kierowanie projektem przez + wiele lat; +\item Vladimira Volovicha, za wyjątkową pomoc w~rozwiązywaniu problemów + przenośności i~szczególnie za umożliwienie dołączenia \cmdname{xindy}; \item Staszka Wawrykiewicza, głównego testującego \TL{} w~różnych systemach, który ponadto koordynował przygotowanie wszystkich polskich dodatków (fontów, programów instalacyjnych i~wielu innych); @@ -3278,25 +2814,32 @@ Rahtza i~Karla Berry, przy głównym współudziale: \end{itemize*} Binaria dla różnych platform skompilowali: -Hartmut Henkel (\pkgname{x86\_64-linux}), +Tigran Aivazian (\pkgname{x86\_64-linux}), +Tim Arnold (\pkgname{hppa-hpux}), +Randy Au (\pkgname{amd64-freebsd}), +Edd Barrett (\pkgname{i386-openbsd}), +Karl Berry (\pkgname{i386-linux}), +Akira Kakuto (\pkgname{win32}), +Dick Koch (\pkgname{universal-darwin}), Manfred Lotz (\pkgname{i386-freebsd}), -%Maksym Polyakov (\pkgname{sparc-solaris}), -Akira Kakuto i~Fabrice Popineau (\pkgname{win32}), -Norbert Prei\-ning (\pkgname{alpha-linux}), -Vladimir Volovich (\pkgname{powerpc-aix}, \pkgname{sparc-linux} - i~\pkgname{sparc-solaris}), - %Staszek Wawrykiewicz - Karl Berry (\pkgname{i386-linux}), -Olaf Weber (\pkgname{mips-irix}), -Gerben Wierda (\pkgname{i386-darwin}, \pkgname{powerpc-darwin}). +Norbert Preining (\pkgname{alpha-linux}), +Arthur Reutenauer (\pkgname{sparc-linux}), +Thomas Schmitz (\pkgname{powerpc-linux}), +Apostolos Syropoulos (\pkgname{i386-solaris}), +Vladimir Volovich (\pkgname{powerpc-aix}, \pkgname{sparc-solaris}), +Olaf Weber (\pkgname{mips-irix}). +Informacje na temat procesu budowy \TL{} można znaleźć na stonie: +\url{http://tug.org/texlive/build.html}. Aktualizacje i~tłumaczenia dokumentacji wykonali: -Karl Berry (angielski), -Daniel Flipo \& Fabrice Popineau (francuski), -G\"unter Partosch \& Hartmut Henkel (niemiecki), -Petr Sojka \& Jan Busa (czeski\slash słowacki), +Siep Kroonenberg i~Karl Berry (angielski), +Daniel Flipo (francuski), +Klaus H\"oppner (niemiecki), +Petr Sojka i~Jan Busa (czeski\slash słowacki), Boris Veytsman (rosyjski), Staszek Wawrykiewicz (polski). +Na stronie \url{http://tug.org/texlive/doc.html} znajdziemy ewentualne +aktualizacje tej dokumentacji. Oczywiście, najważniejsze podziękowania należą się Donaldowi Knuthowi za stworzenie systemu \TeX{} i~ofiarowanie go nam wszystkim. @@ -3417,7 +2960,7 @@ Jak przy każdej kolejnej wersji, w~2004 roku uaktualniono wiele pakietów i~programów. Poniżej wymieniamy najbardziej istotne zmiany. \begin{itemize} -\item Gdy mamy już lokalnie zaistalowane fonty, które korzystają z~własnych +\item Gdy mamy już lokalnie zainstalowane fonty, które korzystają z~własnych plików \filename{.map} i/lub \filename{.enc}, \emph{należy} przenieść te pliki w~nowe miejsce w~strukturze \filename{texmf/}. @@ -3596,7 +3139,7 @@ pojawiło się nieco zmian w~konfiguracji: konfiguracyjnych w~głównych drzewach katalogów systemu. Dotychczasowe skrypty \cmdname{texconfig}, \cmdname{updmap} i~\cmdname{fmtutil} modyfikują obecnie pliki użytkownika w~katalogu \dirname{$HOME/.texlive2005}. - (Patrz część~\ref{sec:texconfig}, str.~\pageref{sec:texconfig}). + %(Patrz część~\ref{sec:texconfig}, str.~\pageref{sec:texconfig}). \item Nowe zmienne środowiskowe \envname{TEXMFCONFIG} i~\envname{TEXMFSYSCONFIG} wskazują położenie drzew katalogów z~plikami @@ -3608,7 +3151,7 @@ pojawiło się nieco zmian w~konfiguracji: \envname{TEXMFCONFIG} i~\envname{TEXMFSYSCONFIG} muszą być zgodne. (Patrz część~\ref{sec:texmftrees}, str.~\pageref{sec:texmftrees}.) -\item W~wydaniu zeszłorocznym przy produkowaniu wynikowego pliku DVI +\item W~wydaniu z~poprzedniego roku przy produkowaniu wynikowego pliku DVI \verb|\pdfoutput| i~podobne polecenia pozostawały niezdefiniowane, mimo że używany był program \cmdname{pdfetex}. Zgodnie z~obietnicą, w~tym roku zarzuciliśmy to rozwiązanie, którego celem było zapewnienie @@ -3618,8 +3161,8 @@ pojawiło się nieco zmian w~konfiguracji: który działa zarówno z~plain \TeX-em jak i~\LaTeX-em, albo zapożyczyć zastosowane w~nim rozwiązania. -\item W~wydaniu zeszłorocznym zmieniliśmy większość formatów tak, aby na - wyjściu 8-bitowe znaki były reprezentowane przez same siebie (por. +\item W~wydaniu z~poprzedniego roku zmieniliśmy większość formatów tak, aby + na wyjściu 8-bitowe znaki były reprezentowane przez same siebie (por. poprzednia część). Nowy plik TCX o~nazwie \filename{empty.tcx} pozwala w~łatwy sposób uzyskać w~razie potrzeby oryginalną notację (\verb|^^|), np.: @@ -3645,9 +3188,8 @@ latex --translate-file=empty.tcx twojplik.tex \end{itemize} \subsection{Edycja 2007} -\label{sec:tlcurrent} -Największą nowością edycji lat 2006 i~2007 jest Xe\TeX{}, +Największą nowością edycji lat 2006 i~2007 był Xe\TeX{}, w~postaci programów \texttt{xetex} i~\texttt{xelatex}; patrz \OnCD{texmf-dist/doc/xetex/XeTeX-reference.pdf} lub \url{http://scripts.sil.org/xetex}. @@ -3657,40 +3199,102 @@ dalszy rozwój (\url{http://tug.org/metapost/articles}); to samo dotyczy pdf\TeX-a (\url{http://tug.org/applications/pdftex}). Pliki formatów (pdf)TeX-a (\filename{.fmt}) oraz analogiczne dla MetaPosta -i~Meta\-Fonta są obecnie zapisywane w~podkatalogach \dirname{texmf/web2c}, -choć sam ten katalog jest nadal przeszukiwany. Podkatalogi te mają nazwę -zgodną z~zastosowanym podczas generowania ,,silnikiem'', np. -\filename{tex}, \filename{pdftex} lub \filename{xetex}. Zmiana ta nie powinna -być zauważalna w~typowym użyciu. +i~Meta\-Fonta są od tej edycji zapisywane w~podkatalogach +\dirname{texmf/web2c}, choć sam ten katalog jest nadal przeszukiwany. +Podkatalogi te mają nazwę zgodną z~zastosowanym podczas generowania +,,silnikiem'', np. \filename{tex}, \filename{pdftex} lub \filename{xetex}. +Zmiana ta nie powinna być zauważalna w~typowym użyciu. Program \texttt{tex} (plain) już nie analizuje pierwszego wiersza rozpoczynającego się znakami \texttt{\%\&} aby ustalić jaki ma wczytać format. Jest to zatem czysty, Knuthowy \TeX. \LaTeX\ i~wszystkie pozostałe formaty nadal analizują pierwszy wiersz z~\texttt{\%\&}. -Skrypty instalacyjne akcepują obecnie kilka zmiennych środowiska, co -umożliwia instalowanie wsadowe (nieinteraktywne) -- patrz -rozdział~\ref{sec:noninteractive-install}. - Oczywiście, jak zwykle, w~okresie od ostatniego wydania wykonano setki innych aktualizacji pakietów i programów. Kolejne aktualizacje można znaleźć tradycyjnie na \acro{CTAN} (\url{http://www.ctan.org}). Drzewo źródłowe \TL{} jest obecnie przechowywane w~Subversion. Przeglądanie -umożliwia standardowy interfejs www, a jego adres jest opublikowany -na stronie \url{http://tug.org.pl/texlive}. +umożliwia standardowy interfejs www, a jego adres zamieszczono na stronie +\url{http://tug.org.pl/texlive}. Mimo iż nie widać efektów tej zmiany w końcowej dystrybucji, mamy nadzieję, że będzie to stabilne repozytorium oprogramowania dla rozwoju \TL{} w~nadchodzących latach. -Na koniec, w~maju 2006~r. Thomas Esser ogłosił, że zaprzestaje aktualizowania +W~maju 2006~r. Thomas Esser ogłosił, że zaprzestaje aktualizowania dystrybucji te\TeX{} (\url{http://tug.org/tetex}). W wyniku tego znacznie -wzrosło zainteresowanie \TL-em, szczególnie wśród dystrybutorów +wzrosło zainteresowanie \TL, szczególnie wśród dystrybutorów \acro{GNU}/Linux-a. (W \TL{} zdefiniowano w przybliżeniu równoważny, nowy schemat instalacyjny pod nazwą \texttt{tetex}.) Mamy nadzieję, że w~przyszłości doprowadzi to do takich ulepszeń w~otoczeniu \TeX-owym, na których wszyscy skorzystają. +\medskip \noindent +Końcowa uwaga, dotycząca przeszłości: wszystkie wydania \TL{}, wraz +z~dodatkowymi materiałami (np. okładkami płytek), są dostępne na stronie: +\url{ftp://tug.org/historic/systems/texlive}. + +\subsection{Wydanie obecne} +\label{sec:tlcurrent} + +W 2008 roku cała infrastruktura \TL{} została przeprojektowana +i~przeprogramowana. Informacja dotycząca instalacji jest przechowywana +obecnie w~zwykłym pliku tekstowym \filename{tlpkg/texlive.tlpdb}. + +Po zainstalowaniu \TL{} wreszcie jest możliwa jego aktualizacja z~internetu, +podobnie jak od paru lat umożliwia to dystrybucja MiK\TeX. Zamierzamy +regularnie aktualizować pakiety, w miarę jak będą się pojawiać na serwerach +\CTAN. + +W~tym wydaniu pojawił się nowy ,,silnik'', Lua\TeX\ +(\url{http://luatex.org}). Prócz nowych, elastycznych możliwości +dotyczących składu, udostępnia on doskonały język skryptowy do +zastosowania zarówno w~dokumentach \TeX-owych, jak i~poza nimi. + +Wsparcie dla Windows i~platform opartych na Unix zostało obecnie znacznie +bardziej zunifikowane. W~szczególności większość skryptów perlowych i~Lua +dostępna jest teraz także dla Windows (zastosowano ,,wewnętrzny'' Perl, +dostarczany wraz z~\TL). + +Pojawił się nowy skrypt \cmdname{tlmgr} (patrz część~\ref{sec:tlmgr}), który +staje się głównym narzędziem do zarządzania \TL{} po jego instalacji. +Umożliwia on aktualizację pakietów wraz z~niezbędnymi wtedy czynnościami, +jak regenerowanie formatów, aktualizacja map fontowych itp. + +Wraz z pojawieniem się \cmdname{tlmgr}, niektóre funkcje \cmdname{texconfig} +zostały zablokowane (edycja plików konfiguracyjnych formatów i~wzorców +przenoszenia). + +Program \cmdname{xindy} do tworzenia skorowidzów +(\url{http://xindy.sourceforge.net/}) jest obecnie dostępny dla większości +platform. + +Narzędzie \cmdname{kpsewhich} może obecnie raportować wszystkie wyniki +przeszukiwania danego pliku (parametr \optname{--all}), jak również +ograniczyć wyszukiwanie do jednego katalogu (parametr \optname{--subdir}). + +Program \cmdname{dvipdfmx} posiada obecnie funkcję \cmdname{extractbb} +ekstrakcji informacji o~prostokącie ograniczającym (\textit{bounding box}); +jest to jedna z~ostatnich cech przejętych od dawniej używanego programu +\cmdname{dvipdfm} (który jest nadal dostępny). + +Usunięto aliasy fontów \filename{Times-Roman}, \filename{Helvetica}, itd. +Różne pakiety korzystały z~nich w~nieoczekiwany sposób (np. spodziewając +się, że fonty te będą miały różne kodowanie). Nie ma obecnie dobrego sposobu +na rozwiązanie tych sprzeczności. + +Usunięto format \pkgname{platex}, by uniknąć konfliktu nazwy z~używanym od +wielu lat japońskim pakietem \pkgname{platex}; pakiet \pkgname{polski} (czyli +dawny \pkgname{platex}) jest obecnie wystarczającym wsparciem polonizacyjnym +dla \LaTeX-a. + +Usunięto pliki \filename{.pool}, które są obecnie wkompilowane w~programy, +co ułatwi ich aktualizację. + +Włączono także do tego wydania ostatnie zmiany dokonane przez +Donalda Knutha (tzw. ,,\TeX\ tuneup of 2008''); patrz: +\url{http://tug.org/TUGboat/Articles/tb29-2/tb92knut.pdf}. + \subsection{Przyszłe wersje} \emph{Niniejsza dystrybucja nie jest doskonała!} Planujemy kontynuowanie @@ -3700,10 +3304,10 @@ instalacyjne oraz (oczywiście) stale ulepszany i~poprawiany katalog makr i~fontów. Zadanie to jest wykonywane przez ciężko pracujących ochotników, poświęcających na to wiele swojego wolnego czasu. Wiele jeszcze pozostało do zrobienia. Jeżeli możesz pomóc, nie zastanawiaj się i~przyłącz się do nas. +Patrz: \url{http://tug.org/texlive/contribute.html}. Prosimy o~przesyłanie poprawek, sugestii i~uzupełnień oraz deklaracji -pomocy w~opracowywaniu kolejnych edycji na adres:\hfill\null - % +pomocy w~opracowywaniu kolejnych edycji na adres: %\hfill\null \begin{quote} \email{tex-live@tug.org} \\ \url{http://tug.org/texlive} |